5 #define DEFAULT_HOST "localhost"
7 #define DEFAULT_HOST UDS
9 #define DEFAULT_PORT "citadel"
16 #include <openssl/ssl.h>
17 #include <openssl/err.h>
18 #include <openssl/rand.h>
27 /* Quick and dirty hack; we don't want to use malloc() in C++ */
29 #define ialloc(t) new t()
30 #define ifree(o) delete o
32 #define ialloc(t) malloc(sizeof(t))
33 #define ifree(o) free(o);
43 char site_location[64];
51 char default_cal_zone[256];
57 char svn_revision[256];
60 /* This class is responsible for the server connection */
61 typedef struct _CtdlIPC {
62 /* The server info for this connection */
63 struct CtdlServInfo ServInfo;
65 #if defined(HAVE_OPENSSL)
66 /* NULL if not encrypted, non-NULL otherwise */
69 #if defined(HAVE_PTHREAD_H)
70 /* Fast mutex, call CtdlIPC_lock() or CtdlIPC_unlock() to use */
71 pthread_mutex_t mutex;
73 /* -1 if not connected, >= 0 otherwise */
75 /* 1 if server is local, 0 otherwise or if not connected */
77 /* 1 if a download is open on the server, 0 otherwise */
79 /* 1 if an upload is open on the server, 0 otherwise */
81 /* Time the last command was sent to the server */
82 time_t last_command_sent;
83 /* Our buffer for linebuffered read. */
88 /* Callback for update on whether the IPC is locked */
89 void (*network_status_cb)(int state);
93 CtdlIPC* CtdlIPC_new(int argc, char **argv, char *hostbuf, char *portbuf);
95 void CtdlIPC_delete(CtdlIPC* ipc);
96 /* Convenience destructor; also nulls out caller's pointer */
97 void CtdlIPC_delete_ptr(CtdlIPC** pipc);
98 /* Read a line from server, discarding newline, for chat, will go away */
99 void CtdlIPC_chat_recv(CtdlIPC* ipc, char *buf);
100 /* Write a line to server, adding newline, for chat, will go away */
101 void CtdlIPC_chat_send(CtdlIPC* ipc, const char *buf);
104 char RRname[ROOMNAMELEN]; /* Name of room */
105 long RRunread; /* Number of unread messages */
106 long RRtotal; /* Total number of messages in room */
107 char RRinfoupdated; /* Nonzero if info was updated */
108 unsigned RRflags; /* Various flags (see LKRN) */
109 unsigned RRflags2; /* Various flags (see LKRN) */
110 long RRhighest; /* Highest message number in room */
111 long RRlastread; /* Highest message user has read */
112 char RRismailbox; /* Is this room a mailbox room? */
113 char RRaide; /* User can do aide commands in room */
114 long RRnewmail; /* Number of new mail messages */
115 char RRfloor; /* Which floor this room is on */
121 char number[16]; /* part number */
122 char name[PATH_MAX]; /* Name */
123 char filename[PATH_MAX]; /* Suggested filename */
124 char mimetype[SIZ]; /* MIME type */
125 char disposition[SIZ]; /* Content disposition */
126 unsigned long length; /* Content length */
130 struct ctdlipcmessage {
131 char msgid[SIZ]; /* Original message ID */
132 char path[SIZ]; /* Return path to sender */
133 char zaps[SIZ]; /* Message ID that this supersedes */
134 char subject[SIZ]; /* Message subject */
135 char email[SIZ]; /* Email address of sender */
136 char author[SIZ]; /* Sender of message */
137 char recipient[SIZ]; /* Recipient of message */
138 char room[SIZ]; /* Originating room */
139 char node[SIZ]; /* Short nodename of origin system */
140 char hnod[SIZ]; /* Humannode of origin system */
141 struct parts *attachments; /* Available attachments */
142 char *text; /* Message text */
143 int type; /* Message type */
144 time_t time; /* Time message was posted */
145 char nhdr; /* Suppress message header? */
146 char anonymous; /* An anonymous message */
147 char mime_chosen[SIZ]; /* Chosen MIME part to output */
148 char content_type[SIZ]; /* How would you like that? */
153 char remote_name[PATH_MAX]; /* Filename on server */
154 char local_name[PATH_MAX]; /* Filename on client */
155 char description[80]; /* Description on server */
156 FILE *local_fd; /* Open file on client */
157 size_t size; /* Size of file in octets */
158 unsigned int upload:1; /* uploading? 0 if downloading */
159 unsigned int complete:1; /* Transfer has finished? */
164 long newmail; /* Number of new Mail messages */
165 char needregis; /* Nonzero if user needs to register */
166 char needvalid; /* Nonzero if users need validation */
171 SubscribedRoomsWithNewMessages,
172 SubscribedRoomsWithNoNewMessages,
187 enum MessageDirection {
192 /* Shared Diffie-Hellman parameters */
193 #define DH_P "1A74527AEE4EE2568E85D4FB2E65E18C9394B9C80C42507D7A6A0DBE9A9A54B05A9A96800C34C7AA5297095B69C88901EEFD127F969DCA26A54C0E0B5C5473EBAEB00957D2633ECAE3835775425DE66C0DE6D024DBB17445E06E6B0C78415E589B8814F08531D02FD43778451E7685541079CFFB79EF0D26EFEEBBB69D1E80383"
196 #define CIT_CIPHERS "ALL:RC4+RSA:+SSLv2:+TLSv1:!MD5:@STRENGTH" /* see ciphers(1) */
198 int CtdlIPCNoop(CtdlIPC *ipc);
199 int CtdlIPCEcho(CtdlIPC *ipc, const char *arg, char *cret);
200 int CtdlIPCQuit(CtdlIPC *ipc);
201 int CtdlIPCLogout(CtdlIPC *ipc);
202 int CtdlIPCTryLogin(CtdlIPC *ipc, const char *username, char *cret);
203 int CtdlIPCTryPassword(CtdlIPC *ipc, const char *passwd, char *cret);
204 int CtdlIPCTryApopPassword(CtdlIPC *ipc, const char *response, char *cret);
205 int CtdlIPCCreateUser(CtdlIPC *ipc, const char *username, int selfservice,
207 int CtdlIPCChangePassword(CtdlIPC *ipc, const char *passwd, char *cret);
208 int CtdlIPCKnownRooms(CtdlIPC *ipc, enum RoomList which, int floor,
209 struct march **listing, char *cret);
210 int CtdlIPCGetConfig(CtdlIPC *ipc, struct ctdluser **uret, char *cret);
211 int CtdlIPCSetConfig(CtdlIPC *ipc, struct ctdluser *uret, char *cret);
212 int CtdlIPCGotoRoom(CtdlIPC *ipc, const char *room, const char *passwd,
213 struct ctdlipcroom **rret, char *cret);
214 int CtdlIPCGetMessages(CtdlIPC *ipc, enum MessageList which, int whicharg,
215 const char *mtemplate, unsigned long **mret, char *cret);
216 int CtdlIPCGetSingleMessage(CtdlIPC *ipc, long msgnum, int headers, int as_mime,
217 struct ctdlipcmessage **mret, char *cret);
218 int CtdlIPCWhoKnowsRoom(CtdlIPC *ipc, char **listing, char *cret);
219 int CtdlIPCServerInfo(CtdlIPC *ipc, char *cret);
220 /* int CtdlIPCReadDirectory(CtdlIPC *ipc, struct ctdlipcfile **files, char *cret); */
221 int CtdlIPCReadDirectory(CtdlIPC *ipc, char **listing, char *cret);
222 int CtdlIPCSetLastRead(CtdlIPC *ipc, long msgnum, char *cret);
223 int CtdlIPCInviteUserToRoom(CtdlIPC *ipc, const char *username, char *cret);
224 int CtdlIPCKickoutUserFromRoom(CtdlIPC *ipc, const char *username, char *cret);
225 int CtdlIPCGetRoomAttributes(CtdlIPC *ipc, struct ctdlroom **qret, char *cret);
226 int CtdlIPCSetRoomAttributes(CtdlIPC *ipc, int forget, struct ctdlroom *qret,
228 int CtdlIPCGetRoomAide(CtdlIPC *ipc, char *cret);
229 int CtdlIPCSetRoomAide(CtdlIPC *ipc, const char *username, char *cret);
230 int CtdlIPCPostMessage(CtdlIPC *ipc, int flag, int *subject_required,
231 const struct ctdlipcmessage *mr,
233 int CtdlIPCRoomInfo(CtdlIPC *ipc, char **iret, char *cret);
234 int CtdlIPCDeleteMessage(CtdlIPC *ipc, long msgnum, char *cret);
235 int CtdlIPCMoveMessage(CtdlIPC *ipc, int copy, long msgnum,
236 const char *destroom, char *cret);
237 int CtdlIPCDeleteRoom(CtdlIPC *ipc, int for_real, char *cret);
238 int CtdlIPCCreateRoom(CtdlIPC *ipc, int for_real, const char *roomname,
239 int type, const char *password, int floor, char *cret);
240 int CtdlIPCForgetRoom(CtdlIPC *ipc, char *cret);
241 int CtdlIPCSystemMessage(CtdlIPC *ipc, const char *message, char **mret,
243 int CtdlIPCNextUnvalidatedUser(CtdlIPC *ipc, char *cret);
244 int CtdlIPCGetUserRegistration(CtdlIPC *ipc, const char *username, char **rret,
246 int CtdlIPCValidateUser(CtdlIPC *ipc, const char *username, int axlevel,
248 int CtdlIPCSetRoomInfo(CtdlIPC *ipc, int for_real, const char *info,
250 int CtdlIPCUserListing(CtdlIPC *ipc, char *searchstring, char **list, char *cret);
251 int CtdlIPCSetRegistration(CtdlIPC *ipc, const char *info, char *cret);
252 int CtdlIPCMiscCheck(CtdlIPC *ipc, struct ctdlipcmisc *chek, char *cret);
253 int CtdlIPCDeleteFile(CtdlIPC *ipc, const char *filename, char *cret);
254 int CtdlIPCMoveFile(CtdlIPC *ipc, const char *filename, const char *destroom,
256 int CtdlIPCNetSendFile(CtdlIPC *ipc, const char *filename,
257 const char *destnode, char *cret);
258 int CtdlIPCOnlineUsers(CtdlIPC *ipc, char **listing, time_t *stamp, char *cret);
259 int CtdlIPCFileDownload(CtdlIPC *ipc, const char *filename, void **buf,
261 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
263 int CtdlIPCAttachmentDownload(CtdlIPC *ipc, long msgnum, const char *part,
265 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
267 int CtdlIPCImageDownload(CtdlIPC *ipc, const char *filename, void **buf,
268 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
270 int CtdlIPCFileUpload(CtdlIPC *ipc, const char *save_as, const char *comment,
272 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
274 int CtdlIPCImageUpload(CtdlIPC *ipc, int for_real, const char *path,
276 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
278 int CtdlIPCQueryUsername(CtdlIPC *ipc, const char *username, char *cret);
279 int CtdlIPCFloorListing(CtdlIPC *ipc, char **listing, char *cret);
280 int CtdlIPCCreateFloor(CtdlIPC *ipc, int for_real, const char *name,
282 int CtdlIPCDeleteFloor(CtdlIPC *ipc, int for_real, int floornum, char *cret);
283 int CtdlIPCEditFloor(CtdlIPC *ipc, int floornum, const char *floorname,
285 int CtdlIPCIdentifySoftware(CtdlIPC *ipc, int developerid, int clientid,
286 int revision, const char *software_name, const char *hostname,
288 int CtdlIPCSendInstantMessage(CtdlIPC *ipc, const char *username,
289 const char *text, char *cret);
290 int CtdlIPCGetInstantMessage(CtdlIPC *ipc, char **listing, char *cret);
291 int CtdlIPCEnableInstantMessageReceipt(CtdlIPC *ipc, int mode, char *cret);
292 int CtdlIPCSetBio(CtdlIPC *ipc, char *bio, char *cret);
293 int CtdlIPCGetBio(CtdlIPC *ipc, const char *username, char **listing,
295 int CtdlIPCListUsersWithBios(CtdlIPC *ipc, char **listing, char *cret);
296 int CtdlIPCStealthMode(CtdlIPC *ipc, int mode, char *cret);
297 int CtdlIPCTerminateSession(CtdlIPC *ipc, int sid, char *cret);
298 int CtdlIPCTerminateServerNow(CtdlIPC *ipc, char *cret);
299 int CtdlIPCTerminateServerScheduled(CtdlIPC *ipc, int mode, char *cret);
300 int CtdlIPCEnterSystemMessage(CtdlIPC *ipc, const char *filename, const char *text,
302 int CtdlIPCChangeHostname(CtdlIPC *ipc, const char *hostname, char *cret);
303 int CtdlIPCChangeRoomname(CtdlIPC *ipc, const char *roomname, char *cret);
304 int CtdlIPCChangeUsername(CtdlIPC *ipc, const char *username, char *cret);
305 time_t CtdlIPCServerTime(CtdlIPC *ipc, char *crert);
306 int CtdlIPCAideGetUserParameters(CtdlIPC *ipc, const char *who,
307 struct ctdluser **uret, char *cret);
308 int CtdlIPCAideSetUserParameters(CtdlIPC *ipc, const struct ctdluser *uret, char *cret);
309 int CtdlIPCRenameUser(CtdlIPC *ipc, char *oldname, char *newname, char *cret);
310 int CtdlIPCGetMessageExpirationPolicy(CtdlIPC *ipc, int which,
311 struct ExpirePolicy **policy, char *cret);
312 int CtdlIPCSetMessageExpirationPolicy(CtdlIPC *ipc, int which,
313 struct ExpirePolicy *policy, char *cret);
314 int CtdlIPCGetSystemConfig(CtdlIPC *ipc, char **listing, char *cret);
315 int CtdlIPCSetSystemConfig(CtdlIPC *ipc, const char *listing, char *cret);
316 int CtdlIPCGetSystemConfigByType(CtdlIPC *ipc, const char *mimetype,
317 char **listing, char *cret);
318 int CtdlIPCSetSystemConfigByType(CtdlIPC *ipc, const char *mimetype,
319 const char *listing, char *cret);
320 int CtdlIPCGetRoomNetworkConfig(CtdlIPC *ipc, char **listing, char *cret);
321 int CtdlIPCSetRoomNetworkConfig(CtdlIPC *ipc, const char *listing, char *cret);
322 int CtdlIPCRequestClientLogout(CtdlIPC *ipc, int session, char *cret);
323 int CtdlIPCSetMessageSeen(CtdlIPC *ipc, long msgnum, int seen, char *cret);
324 int CtdlIPCStartEncryption(CtdlIPC *ipc, char *cret);
325 int CtdlIPCDirectoryLookup(CtdlIPC *ipc, const char *address, char *cret);
326 int CtdlIPCSpecifyPreferredFormats(CtdlIPC *ipc, char *cret, char *formats);
327 int CtdlIPCInternalProgram(CtdlIPC *ipc, int secret, char *cret);
328 int CtdlIPCMessageBaseCheck(CtdlIPC *ipc, char **mret, char *cret);
330 /* ************************************************************************** */
331 /* Stuff below this line is not for public consumption */
332 /* ************************************************************************** */
334 INLINE void CtdlIPC_lock(CtdlIPC *ipc);
335 INLINE void CtdlIPC_unlock(CtdlIPC *ipc);
336 char *CtdlIPCReadListing(CtdlIPC *ipc, char *dest);
337 int CtdlIPCSendListing(CtdlIPC *ipc, const char *listing);
338 size_t CtdlIPCPartialRead(CtdlIPC *ipc, void **buf, size_t offset,
339 size_t bytes, char *cret);
340 int CtdlIPCEndUpload(CtdlIPC *ipc, int discard, char *cret);
341 int CtdlIPCWriteUpload(CtdlIPC *ipc, FILE *uploadFP,
342 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
344 int CtdlIPCEndDownload(CtdlIPC *ipc, char *cret);
345 int CtdlIPCReadDownload(CtdlIPC *ipc, void **buf, size_t bytes, size_t resume,
346 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
348 int CtdlIPCHighSpeedReadDownload(CtdlIPC *ipc, void **buf, size_t bytes,
350 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
352 int CtdlIPCGenericCommand(CtdlIPC *ipc, const char *command,
353 const char *to_send, size_t bytes_to_send, char **to_receive,
354 size_t *bytes_to_receive, char *proto_response);
357 int starttls(CtdlIPC *ipc);
358 void setCryptoStatusHook(void (*hook)(char *s));
359 void CtdlIPC_SetNetworkStatusCallback(CtdlIPC *ipc, void (*hook)(int state));
360 /* This is all Ford's doing. FIXME: figure out what it's doing */
361 extern int (*error_printf)(char *s, ...);
362 void setIPCDeathHook(void (*hook)(void));
363 void setIPCErrorPrintf(int (*func)(char *s, ...));
364 void connection_died(CtdlIPC* ipc, int using_ssl);
365 int CtdlIPC_getsockfd(CtdlIPC* ipc);
366 char CtdlIPC_get(CtdlIPC* ipc);