citadel/include/citadel_ipc.h

   1 /* $Id$ */
   2
   3 #define UDS                     "_UDS_"
   4 #ifdef __CYGWIN__
   5 #define DEFAULT_HOST            "localhost"
   6 #else
   7 #define DEFAULT_HOST            UDS
   8 #endif
   9 #define DEFAULT_PORT            "citadel"
  10
  11 #include "sysdep.h"
  12 #ifdef HAVE_PTHREAD_H
  13 #include <pthread.h>
  14 #endif
  15 #ifdef HAVE_OPENSSL
  16 #include <openssl/ssl.h>
  17 #include <openssl/err.h>
  18 #include <openssl/rand.h>
  19 #endif
  20
  21 #include "server.h"
  22
  23 #ifdef __cplusplus
  24 extern "C" {
  25 #endif
  26
  27 /* Quick and dirty hack; we don't want to use malloc() in C++ */
  28 #ifdef __cplusplus
  29 #define ialloc(t)       new t()
  30 #define ifree(o)        delete o
  31 #else
  32 #define ialloc(t)       malloc(sizeof(t))
  33 #define ifree(o)        free(o);
  34 #endif
  35
  36 struct CtdlServInfo {
  37         int pid;
  38         char nodename[32];
  39         char humannode[64];
  40         char fqdn[64];
  41         char software[64];
  42         int rev_level;
  43         char site_location[64];
  44         char sysadm[64];
  45         char moreprompt[256];
  46         int ok_floors;
  47         int paging_level;
  48         int supports_qnop;
  49         int supports_ldap;
  50         int newuser_disabled;
  51         char default_cal_zone[256];
  52         double load_avg;
  53         double worker_avg;
  54         int thread_count;
  55         int has_sieve;
  56         int fulltext_enabled;
  57         char svn_revision[256];
  58 };
  59
  60 /* This class is responsible for the server connection */
  61 typedef struct _CtdlIPC {
  62         /* The server info for this connection */
  63         struct CtdlServInfo ServInfo;
  64
  65 #if defined(HAVE_OPENSSL)
  66         /* NULL if not encrypted, non-NULL otherwise */
  67         SSL *ssl;
  68 #endif
  69 #if defined(HAVE_PTHREAD_H)
  70         /* Fast mutex, call CtdlIPC_lock() or CtdlIPC_unlock() to use */
  71         pthread_mutex_t mutex;
  72 #endif
  73         /* -1 if not connected, >= 0 otherwise */
  74         int sock;
  75         /* 1 if server is local, 0 otherwise or if not connected */
  76         int isLocal;
  77         /* 1 if a download is open on the server, 0 otherwise */
  78         int downloading;
  79         /* 1 if an upload is open on the server, 0 otherwise */
  80         int uploading;
  81         /* Time the last command was sent to the server */
  82         time_t last_command_sent;
  83         /* Our buffer for linebuffered read. */
  84         char *Buf;
  85         size_t BufSize;
  86         size_t BufUsed;
  87         char *BufPtr;
  88         /* Callback for update on whether the IPC is locked */
  89         void (*network_status_cb)(int state);
  90 } CtdlIPC;
  91
  92 /* C constructor */
  93 CtdlIPC* CtdlIPC_new(int argc, char **argv, char *hostbuf, char *portbuf);
  94 /* C destructor */
  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);
 102
 103 struct ctdlipcroom {
 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 */
 116         char RRcurrentview;             /* The user's current view for this room */
 117         char RRdefaultview;             /* The default view for this room */
 118 };
 119
 120
 121 struct parts {
 122         struct parts *next;
 123         char number[16];                /* part number */
 124         char name[PATH_MAX];            /* Name */
 125         char filename[PATH_MAX];        /* Suggested filename */
 126         char mimetype[SIZ];             /* MIME type */
 127         char disposition[SIZ];          /* Content disposition */
 128         unsigned long length;           /* Content length */
 129 };
 130
 131
 132 struct ctdlipcmessage {
 133         char msgid[SIZ];                /* Original message ID */
 134         char path[SIZ];                 /* Return path to sender */
 135         char zaps[SIZ];                 /* Message ID that this supersedes */
 136         char subject[SIZ];              /* Message subject */
 137         char email[SIZ];                /* Email address of sender */
 138         char author[SIZ];               /* Sender of message */
 139         char recipient[SIZ];            /* Recipient of message */
 140         char room[SIZ];                 /* Originating room */
 141         char node[SIZ];                 /* Short nodename of origin system */
 142         char hnod[SIZ];                 /* Humannode of origin system */
 143         struct parts *attachments;      /* Available attachments */
 144         char *text;                     /* Message text */
 145         int type;                       /* Message type */
 146         time_t time;                    /* Time message was posted */
 147         char nhdr;                      /* Suppress message header? */
 148         char anonymous;                 /* An anonymous message */
 149         char mime_chosen[SIZ];          /* Chosen MIME part to output */
 150         char content_type[SIZ];         /* How would you like that? */
 151         char references[SIZ];           /* Thread references */
 152 };
 153
 154
 155 struct ctdlipcfile {
 156         char remote_name[PATH_MAX];     /* Filename on server */
 157         char local_name[PATH_MAX];      /* Filename on client */
 158         char description[80];           /* Description on server */
 159         FILE *local_fd;                 /* Open file on client */
 160         size_t size;                    /* Size of file in octets */
 161         unsigned int upload:1;          /* uploading? 0 if downloading */
 162         unsigned int complete:1;        /* Transfer has finished? */
 163 };
 164
 165
 166 struct ctdlipcmisc {
 167         long newmail;                   /* Number of new Mail messages */
 168         char needregis;                 /* Nonzero if user needs to register */
 169         char needvalid;                 /* Nonzero if users need validation */
 170 };
 171
 172 enum RoomList {
 173         SubscribedRooms,
 174         SubscribedRoomsWithNewMessages,
 175         SubscribedRoomsWithNoNewMessages,
 176         UnsubscribedRooms,
 177         AllAccessibleRooms,
 178         AllPublicRooms
 179 };
 180 #define AllFloors -1
 181 enum MessageList {
 182         AllMessages,
 183         OldMessages,
 184         NewMessages,
 185         LastMessages,
 186         FirstMessages,
 187         MessagesGreaterThan,
 188         MessagesLessThan
 189 };
 190 enum MessageDirection {
 191         ReadReverse = -1,
 192         ReadForward = 1
 193 };
 194
 195 /* Shared Diffie-Hellman parameters */
 196 #define DH_P            "1A74527AEE4EE2568E85D4FB2E65E18C9394B9C80C42507D7A6A0DBE9A9A54B05A9A96800C34C7AA5297095B69C88901EEFD127F969DCA26A54C0E0B5C5473EBAEB00957D2633ECAE3835775425DE66C0DE6D024DBB17445E06E6B0C78415E589B8814F08531D02FD43778451E7685541079CFFB79EF0D26EFEEBBB69D1E80383"
 197 #define DH_G            "2"
 198 #define DH_L            1024
 199 #define CIT_CIPHERS     "ALL:RC4+RSA:+SSLv2:+TLSv1:!MD5:@STRENGTH"      /* see ciphers(1) */
 200
 201 int CtdlIPCNoop(CtdlIPC *ipc);
 202 int CtdlIPCEcho(CtdlIPC *ipc, const char *arg, char *cret);
 203 int CtdlIPCQuit(CtdlIPC *ipc);
 204 int CtdlIPCLogout(CtdlIPC *ipc);
 205 int CtdlIPCTryLogin(CtdlIPC *ipc, const char *username, char *cret);
 206 int CtdlIPCTryPassword(CtdlIPC *ipc, const char *passwd, char *cret);
 207 int CtdlIPCTryApopPassword(CtdlIPC *ipc, const char *response, char *cret);
 208 int CtdlIPCCreateUser(CtdlIPC *ipc, const char *username, int selfservice,
 209                 char *cret);
 210 int CtdlIPCChangePassword(CtdlIPC *ipc, const char *passwd, char *cret);
 211 int CtdlIPCKnownRooms(CtdlIPC *ipc, enum RoomList which, int floor,
 212                 struct march **listing, char *cret);
 213 int CtdlIPCGetConfig(CtdlIPC *ipc, struct ctdluser **uret, char *cret);
 214 int CtdlIPCSetConfig(CtdlIPC *ipc, struct ctdluser *uret, char *cret);
 215 int CtdlIPCGotoRoom(CtdlIPC *ipc, const char *room, const char *passwd,
 216                 struct ctdlipcroom **rret, char *cret);
 217 int CtdlIPCGetMessages(CtdlIPC *ipc, enum MessageList which, int whicharg,
 218                 const char *mtemplate, unsigned long **mret, char *cret);
 219 int CtdlIPCGetSingleMessage(CtdlIPC *ipc, long msgnum, int headers, int as_mime,
 220                 struct ctdlipcmessage **mret, char *cret);
 221 int CtdlIPCWhoKnowsRoom(CtdlIPC *ipc, char **listing, char *cret);
 222 int CtdlIPCServerInfo(CtdlIPC *ipc, char *cret);
 223 /* int CtdlIPCReadDirectory(CtdlIPC *ipc, struct ctdlipcfile **files, char *cret); */
 224 int CtdlIPCReadDirectory(CtdlIPC *ipc, char **listing, char *cret);
 225 int CtdlIPCSetLastRead(CtdlIPC *ipc, long msgnum, char *cret);
 226 int CtdlIPCInviteUserToRoom(CtdlIPC *ipc, const char *username, char *cret);
 227 int CtdlIPCKickoutUserFromRoom(CtdlIPC *ipc, const char *username, char *cret);
 228 int CtdlIPCGetRoomAttributes(CtdlIPC *ipc, struct ctdlroom **qret, char *cret);
 229 int CtdlIPCSetRoomAttributes(CtdlIPC *ipc, int forget, struct ctdlroom *qret,
 230                 char *cret);
 231 int CtdlIPCGetRoomAide(CtdlIPC *ipc, char *cret);
 232 int CtdlIPCSetRoomAide(CtdlIPC *ipc, const char *username, char *cret);
 233 int CtdlIPCPostMessage(CtdlIPC *ipc, int flag, int *subject_required,
 234                                            struct ctdlipcmessage *mr,
 235                                            char *cret);
 236 int CtdlIPCRoomInfo(CtdlIPC *ipc, char **iret, char *cret);
 237 int CtdlIPCDeleteMessage(CtdlIPC *ipc, long msgnum, char *cret);
 238 int CtdlIPCMoveMessage(CtdlIPC *ipc, int copy, long msgnum,
 239                 const char *destroom, char *cret);
 240 int CtdlIPCDeleteRoom(CtdlIPC *ipc, int for_real, char *cret);
 241 int CtdlIPCCreateRoom(CtdlIPC *ipc, int for_real, const char *roomname,
 242                 int type, const char *password, int floor, char *cret);
 243 int CtdlIPCForgetRoom(CtdlIPC *ipc, char *cret);
 244 int CtdlIPCSystemMessage(CtdlIPC *ipc, const char *message, char **mret,
 245                 char *cret);
 246 int CtdlIPCNextUnvalidatedUser(CtdlIPC *ipc, char *cret);
 247 int CtdlIPCGetUserRegistration(CtdlIPC *ipc, const char *username, char **rret,
 248                 char *cret);
 249 int CtdlIPCValidateUser(CtdlIPC *ipc, const char *username, int axlevel,
 250                 char *cret);
 251 int CtdlIPCSetRoomInfo(CtdlIPC *ipc, int for_real, const char *info,
 252                 char *cret);
 253 int CtdlIPCUserListing(CtdlIPC *ipc, char *searchstring, char **list, char *cret);
 254 int CtdlIPCSetRegistration(CtdlIPC *ipc, const char *info, char *cret);
 255 int CtdlIPCMiscCheck(CtdlIPC *ipc, struct ctdlipcmisc *chek, char *cret);
 256 int CtdlIPCDeleteFile(CtdlIPC *ipc, const char *filename, char *cret);
 257 int CtdlIPCMoveFile(CtdlIPC *ipc, const char *filename, const char *destroom,
 258                 char *cret);
 259 int CtdlIPCNetSendFile(CtdlIPC *ipc, const char *filename,
 260                 const char *destnode, char *cret);
 261 int CtdlIPCOnlineUsers(CtdlIPC *ipc, char **listing, time_t *stamp, char *cret);
 262 int CtdlIPCFileDownload(CtdlIPC *ipc, const char *filename, void **buf,
 263                 size_t resume,
 264                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 265                 char *cret);
 266 int CtdlIPCAttachmentDownload(CtdlIPC *ipc, long msgnum, const char *part,
 267                 void **buf,
 268                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 269                 char *cret);
 270 int CtdlIPCImageDownload(CtdlIPC *ipc, const char *filename, void **buf,
 271                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 272                 char *cret);
 273 int CtdlIPCFileUpload(CtdlIPC *ipc, const char *save_as, const char *comment,
 274                 const char *path,
 275                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 276                 char *cret);
 277 int CtdlIPCImageUpload(CtdlIPC *ipc, int for_real, const char *path,
 278                 const char *save_as,
 279                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 280                 char *cret);
 281 int CtdlIPCQueryUsername(CtdlIPC *ipc, const char *username, char *cret);
 282 int CtdlIPCFloorListing(CtdlIPC *ipc, char **listing, char *cret);
 283 int CtdlIPCCreateFloor(CtdlIPC *ipc, int for_real, const char *name,
 284                 char *cret);
 285 int CtdlIPCDeleteFloor(CtdlIPC *ipc, int for_real, int floornum, char *cret);
 286 int CtdlIPCEditFloor(CtdlIPC *ipc, int floornum, const char *floorname,
 287                 char *cret);
 288 int CtdlIPCIdentifySoftware(CtdlIPC *ipc, int developerid, int clientid,
 289                 int revision, const char *software_name, const char *hostname,
 290                 char *cret);
 291 int CtdlIPCSendInstantMessage(CtdlIPC *ipc, const char *username,
 292                 const char *text, char *cret);
 293 int CtdlIPCGetInstantMessage(CtdlIPC *ipc, char **listing, char *cret);
 294 int CtdlIPCEnableInstantMessageReceipt(CtdlIPC *ipc, int mode, char *cret);
 295 int CtdlIPCSetBio(CtdlIPC *ipc, char *bio, char *cret);
 296 int CtdlIPCGetBio(CtdlIPC *ipc, const char *username, char **listing,
 297                 char *cret);
 298 int CtdlIPCListUsersWithBios(CtdlIPC *ipc, char **listing, char *cret);
 299 int CtdlIPCStealthMode(CtdlIPC *ipc, int mode, char *cret);
 300 int CtdlIPCTerminateSession(CtdlIPC *ipc, int sid, char *cret);
 301 int CtdlIPCTerminateServerNow(CtdlIPC *ipc, char *cret);
 302 int CtdlIPCTerminateServerScheduled(CtdlIPC *ipc, int mode, char *cret);
 303 int CtdlIPCEnterSystemMessage(CtdlIPC *ipc, const char *filename, const char *text,
 304                 char *cret);
 305 int CtdlIPCChangeHostname(CtdlIPC *ipc, const char *hostname, char *cret);
 306 int CtdlIPCChangeRoomname(CtdlIPC *ipc, const char *roomname, char *cret);
 307 int CtdlIPCChangeUsername(CtdlIPC *ipc, const char *username, char *cret);
 308 time_t CtdlIPCServerTime(CtdlIPC *ipc, char *crert);
 309 int CtdlIPCAideGetUserParameters(CtdlIPC *ipc, const char *who,
 310                                  struct ctdluser **uret, char *cret);
 311 int CtdlIPCAideSetUserParameters(CtdlIPC *ipc, const struct ctdluser *uret, char *cret);
 312 int CtdlIPCRenameUser(CtdlIPC *ipc, char *oldname, char *newname, char *cret);
 313 int CtdlIPCGetMessageExpirationPolicy(CtdlIPC *ipc, int which,
 314                 struct ExpirePolicy **policy, char *cret);
 315 int CtdlIPCSetMessageExpirationPolicy(CtdlIPC *ipc, int which,
 316                 struct ExpirePolicy *policy, char *cret);
 317 int CtdlIPCGetSystemConfig(CtdlIPC *ipc, char **listing, char *cret);
 318 int CtdlIPCSetSystemConfig(CtdlIPC *ipc, const char *listing, char *cret);
 319 int CtdlIPCGetSystemConfigByType(CtdlIPC *ipc, const char *mimetype,
 320                 char **listing, char *cret);
 321 int CtdlIPCSetSystemConfigByType(CtdlIPC *ipc, const char *mimetype,
 322                const char *listing, char *cret);
 323 int CtdlIPCGetRoomNetworkConfig(CtdlIPC *ipc, char **listing, char *cret);
 324 int CtdlIPCSetRoomNetworkConfig(CtdlIPC *ipc, const char *listing, char *cret);
 325 int CtdlIPCRequestClientLogout(CtdlIPC *ipc, int session, char *cret);
 326 int CtdlIPCSetMessageSeen(CtdlIPC *ipc, long msgnum, int seen, char *cret);
 327 int CtdlIPCStartEncryption(CtdlIPC *ipc, char *cret);
 328 int CtdlIPCDirectoryLookup(CtdlIPC *ipc, const char *address, char *cret);
 329 int CtdlIPCSpecifyPreferredFormats(CtdlIPC *ipc, char *cret, char *formats);
 330 int CtdlIPCInternalProgram(CtdlIPC *ipc, int secret, char *cret);
 331 int CtdlIPCMessageBaseCheck(CtdlIPC *ipc, char **mret, char *cret);
 332
 333 /* ************************************************************************** */
 334 /*             Stuff below this line is not for public consumption            */
 335 /* ************************************************************************** */
 336
 337 INLINE void CtdlIPC_lock(CtdlIPC *ipc);
 338 INLINE void CtdlIPC_unlock(CtdlIPC *ipc);
 339 char *CtdlIPCReadListing(CtdlIPC *ipc, char *dest);
 340 int CtdlIPCSendListing(CtdlIPC *ipc, const char *listing);
 341 size_t CtdlIPCPartialRead(CtdlIPC *ipc, void **buf, size_t offset,
 342                 size_t bytes, char *cret);
 343 int CtdlIPCEndUpload(CtdlIPC *ipc, int discard, char *cret);
 344 int CtdlIPCWriteUpload(CtdlIPC *ipc, FILE *uploadFP,
 345                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 346                 char *cret);
 347 int CtdlIPCEndDownload(CtdlIPC *ipc, char *cret);
 348 int CtdlIPCReadDownload(CtdlIPC *ipc, void **buf, size_t bytes, size_t resume,
 349                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 350                 char *cret);
 351 int CtdlIPCHighSpeedReadDownload(CtdlIPC *ipc, void **buf, size_t bytes,
 352                 size_t resume,
 353                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 354                 char *cret);
 355 int CtdlIPCGenericCommand(CtdlIPC *ipc, const char *command,
 356                 const char *to_send, size_t bytes_to_send, char **to_receive,
 357                 size_t *bytes_to_receive, char *proto_response);
 358
 359 /* Internals */
 360 int starttls(CtdlIPC *ipc);
 361 void setCryptoStatusHook(void (*hook)(char *s));
 362 void CtdlIPC_SetNetworkStatusCallback(CtdlIPC *ipc, void (*hook)(int state));
 363 /* This is all Ford's doing.  FIXME: figure out what it's doing */
 364 extern int (*error_printf)(char *s, ...);
 365 void setIPCDeathHook(void (*hook)(void));
 366 void setIPCErrorPrintf(int (*func)(char *s, ...));
 367 void connection_died(CtdlIPC* ipc, int using_ssl);
 368 int CtdlIPC_getsockfd(CtdlIPC* ipc);
 369 char CtdlIPC_get(CtdlIPC* ipc);
 370
 371 #ifdef __cplusplus
 372 }
 373 #endif