5 Author: Pekka Riikonen <priikone@silcnet.org>
7 Copyright (C) 1997 - 2001 Pekka Riikonen
9 This program is free software; you can redistribute it and/or modify
10 it under the terms of the GNU General Public License as published by
11 the Free Software Foundation; either version 2 of the License, or
12 (at your option) any later version.
14 This program is distributed in the hope that it will be useful,
15 but WITHOUT ANY WARRANTY; without even the implied warranty of
16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17 GNU General Public License for more details.
24 /* Client entry context. When client receives information about new client
25 (it receives its ID, for example, by IDENTIFY request) we create new
26 client entry. This entry also includes the private message keys if
29 char *nickname; /* nickname */
30 char *username; /* username */
31 char *hostname; /* hostname */
32 char *server; /* SILC server name */
33 char *realname; /* Realname (userinfo) */
35 uint32 mode; /* User mode in SILC */
36 SilcClientID *id; /* The Client ID */
37 SilcCipher send_key; /* Private message key for sending */
38 SilcCipher receive_key; /* Private message key for receiving */
39 unsigned char *key; /* Set only if appliation provided the
40 key material. NULL if the library
43 int generated; /* TRUE if library generated the key */
44 SilcClientKeyAgreement ke; /* Current key agreement context or NULL */
47 /* Client and its mode on a channel */
48 typedef struct SilcChannelUserStruct {
49 SilcClientEntry client;
51 struct SilcChannelUserStruct *next;
54 /* Structure to hold one channel private key. */
56 SilcCipher cipher; /* The cipher and key */
57 SilcHmac hmac; /* The HMAC and hmac key */
58 unsigned char *key; /* The key data */
59 uint32 key_len; /* The key length */
60 } *SilcChannelPrivateKey;
62 /* Channel entry context. This is allocate for every channel client has
63 joined to. This includes for example the channel specific keys */
64 typedef struct SilcChannelEntryStruct {
74 SilcCipher channel_key; /* The channel key */
75 unsigned char *key; /* Raw key data */
77 unsigned char iv[SILC_CIPHER_MAX_IV_SIZE]; /* Current IV */
78 SilcHmac hmac; /* Current HMAC */
79 SilcDList private_keys; /* List of private keys or NULL */
80 SilcChannelPrivateKey curr_key; /* Current private key */
82 /* Old channel key is saved for a short period of time when rekey occurs
83 in case if someone is sending messages after the rekey encrypted with
84 the old key, we can still decrypt them. */
85 SilcCipher old_channel_key;
90 /* Server entry context. This represents one server. When server information
91 is resolved with INFO command the server info is saved in this context.
92 Also the connected servers are saved here. */
96 SilcServerID *server_id;
99 /* Prototypes. These are used only by the library. Application should not
100 call these directly. */
103 silc_client_add_client(SilcClient client, SilcClientConnection conn,
104 char *nickname, char *username,
105 char *userinfo, SilcClientID *id, uint32 mode);
106 void silc_client_update_client(SilcClient client,
107 SilcClientConnection conn,
108 SilcClientEntry client_entry,
109 const char *nickname,
110 const char *username,
111 const char *userinfo,
113 void silc_client_del_client_entry(SilcClient client,
114 SilcClientEntry client_entry);
115 SilcClientEntry silc_idlist_get_client(SilcClient client,
116 SilcClientConnection conn,
117 const char *nickname,
120 SilcChannelEntry silc_idlist_get_channel_by_id(SilcClient client,
121 SilcClientConnection conn,
122 SilcChannelID *channel_id,
124 void silc_client_nickname_format(SilcClient client,
125 SilcClientConnection conn,
126 SilcClientEntry client_entry);