textclient/textclient.h

   1 // Copyright (c) 1987-2020 by the citadel.org team
   2 //
   3 // This program is open source software.  Use, duplication, and/or
   4 // disclosure are subject to the GNU General Purpose License version 3.
   5 //
   6 // This program is distributed in the hope that it will be useful,
   7 // but WITHOUT ANY WARRANTY; without even the implied warranty of
   8 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   9 // GNU General Public License for more details.
  10
  11 #define UDS                     "_UDS_"
  12 #define DEFAULT_HOST            "localhost"
  13 #define DEFAULT_PORT            "504"
  14 #define CLIENT_VERSION          926
  15 #define CLIENT_TYPE             0
  16
  17 /* commands we can send to the stty_ctdl() routine */
  18 #define SB_NO_INTR              0               // set to Citadel client mode, i/q disabled
  19 #define SB_YES_INTR             1               // set to Citadel client mode, i/q enabled
  20 #define SB_SAVE                 2               // save settings
  21 #define SB_RESTORE              3               // restore settings
  22 #define SB_LAST                 4               // redo the last command sent
  23
  24 #define UGLISTLEN               100             // you get a ungoto list of this size */
  25 #define ROOMNAMELEN             128             // The size of a roomname string
  26 #define USERNAME_SIZE           64              // The size of a username string
  27 #define MAX_EDITORS             5               // number of external editors supported, must be at least 1
  28 #define NONCE_SIZE              128             // Added by <bc> to allow for APOP auth
  29
  30 #define S_KEEPALIVE             30              // How often (in seconds) to send keepalives to the server
  31
  32 #define READ_HEADER             2
  33 #define READ_MSGBODY            3
  34
  35 #define NUM_CONFIGS             72
  36
  37 #define NEXT_KEY                15
  38 #define STOP_KEY                3
  39
  40 /* citadel.rc stuff */
  41 #define RC_NO                   0               /* always no */
  42 #define RC_YES                  1               /* always yes */
  43 #define RC_DEFAULT              2               /* setting depends on user config */
  44
  45 /* keepalives */
  46 enum {
  47         KA_NO,                          /* no keepalives */
  48         KA_YES,                         /* full keepalives */
  49         KA_HALF                         /* half keepalives */
  50 };
  51
  52 /* for <;G>oto and <;S>kip commands */
  53 #define GF_GOTO         0               /* <;G>oto floor mode */
  54 #define GF_SKIP         1               /* <;S>kip floor mode */
  55 #define GF_ZAP          2               /* <;Z>ap floor mode */
  56
  57 /* Can messages be entered in this room? */
  58 #define ENTMSG_OK_NO    0               /* You may not enter messages here */
  59 #define ENTMSG_OK_YES   1               /* Go ahead! */
  60 #define ENTMSG_OK_BLOG  2               /* Yes, but warn the user about how blog rooms work */
  61
  62 /*
  63  * Colors for color() command
  64  */
  65 #define DIM_BLACK       0
  66 #define DIM_RED         1
  67 #define DIM_GREEN       2
  68 #define DIM_YELLOW      3
  69 #define DIM_BLUE        4
  70 #define DIM_MAGENTA     5
  71 #define DIM_CYAN        6
  72 #define DIM_WHITE       7
  73 #define BRIGHT_BLACK    8
  74 #define BRIGHT_RED      9
  75 #define BRIGHT_GREEN    10
  76 #define BRIGHT_YELLOW   11
  77 #define BRIGHT_BLUE     12
  78 #define BRIGHT_MAGENTA  13
  79 #define BRIGHT_CYAN     14
  80 #define BRIGHT_WHITE    15
  81 #define COLOR_PUSH      16      /* Save current color */
  82 #define COLOR_POP       17      /* Restore saved color */
  83 #define ORIGINAL_PAIR   -1      /* Default terminal colors */
  84
  85 typedef void (*sighandler_t)(int);
  86
  87
  88
  89 #include <stdlib.h>
  90 #include <unistd.h>
  91 #include <fcntl.h>
  92 #include <stdio.h>
  93 #include <ctype.h>
  94 #include <string.h>
  95 #include <time.h>
  96 #include <limits.h>
  97 #include <sys/types.h>
  98 #include <sys/wait.h>
  99 #include <sys/stat.h>
 100 #include <sys/ioctl.h>
 101 #include <termios.h>
 102 //      #include <sgtty.h>      not needed if we have termios.h
 103 #include <stdlib.h>
 104 #include <ctype.h>
 105 #include <sys/socket.h>
 106 #include <arpa/inet.h>
 107 #include <netinet/in.h>
 108 #include <netdb.h>
 109 #include <sys/un.h>
 110 #include <errno.h>
 111 #include <signal.h>
 112 #include <pwd.h>
 113 #include <stdarg.h>
 114 #include <errno.h>
 115 #include <signal.h>
 116 #include <malloc.h>
 117 #include <stdarg.h>
 118 #include <sys/select.h>
 119 #include <dirent.h>
 120 #include <libcitadel.h>
 121
 122 #include <limits.h>
 123 #ifdef HAVE_PTHREAD_H
 124 #include <pthread.h>
 125 #endif
 126 #ifdef HAVE_OPENSSL
 127 #include <openssl/ssl.h>
 128 #include <openssl/err.h>
 129 #include <openssl/rand.h>
 130 #endif
 131
 132
 133 struct CtdlServInfo {
 134         int pid;
 135         char nodename[32];
 136         char humannode[64];
 137         char fqdn[64];
 138         char software[64];
 139         int rev_level;
 140         char site_location[64];
 141         char sysadm[64];
 142         char moreprompt[256];
 143         int ok_floors;
 144         int paging_level;
 145         int supports_qnop;
 146         int supports_ldap;
 147         int newuser_disabled;
 148         char default_cal_zone[256];
 149         double load_avg;
 150         double worker_avg;
 151         int thread_count;
 152         int has_sieve;
 153         int fulltext_enabled;
 154         char svn_revision[256];
 155         int guest_logins;
 156 };
 157
 158
 159 /*
 160  * This class is responsible for the server connection
 161  */
 162 typedef struct _CtdlIPC {
 163         struct CtdlServInfo ServInfo;   /* The server info for this connection */
 164 #if defined(HAVE_OPENSSL)
 165         SSL *ssl;                       /* NULL if not encrypted, non-NULL otherwise */
 166 #endif
 167         int sock;                       /* Socket for connection to server, or -1 if not connected */
 168         int isLocal;                    /* 1 if server is local, 0 otherwise or if not connected */
 169         int downloading;                /* 1 if a download is open on the server, 0 otherwise */
 170         int uploading;                  /* 1 if an upload is open on the server, 0 otherwise */
 171         time_t last_command_sent;       /* Time the last command was sent to the server */
 172         char *Buf;                      /* Our buffer for linebuffered read. */
 173         size_t BufSize;
 174         size_t BufUsed;
 175         char *BufPtr;
 176         void (*network_status_cb)(int state);   /* Callback for update on whether the IPC is locked */
 177         char ip_hostname[256];          /* host name of server to which we are connected (if network) */
 178         char ip_address[64];            /* IP address of server to which we are connected (if network) */
 179 } CtdlIPC;
 180
 181 extern char *axdefs[];
 182 extern char *viewdefs[];
 183 extern char fullname[USERNAME_SIZE];
 184 extern unsigned room_flags;
 185 extern char room_name[ROOMNAMELEN];
 186 extern struct CtdlServInfo serv_info;
 187 extern char axlevel;
 188 extern char is_room_aide;
 189 extern unsigned userflags;
 190 extern char sigcaught;
 191 extern char editor_paths[MAX_EDITORS][SIZ];
 192 extern char printcmd[SIZ];
 193 extern char imagecmd[SIZ];
 194 extern char have_xterm;
 195 extern char rc_username[USERNAME_SIZE];
 196 extern char rc_password[32];
 197 extern char rc_floor_mode;
 198 extern time_t rc_idle_threshold;
 199 #ifdef HAVE_OPENSSL
 200 extern char rc_encrypt;                 /* from the citadel.rc file */
 201 extern char arg_encrypt;                /* from the command line */
 202 #endif
 203 #if defined(HAVE_CURSES_H) && !defined(DISABLE_CURSES)
 204 extern char rc_screen;
 205 extern char arg_screen;
 206 #endif
 207 extern char rc_alt_semantics;
 208 extern char instant_msgs;
 209 void ctdl_logoff(char *file, int line, CtdlIPC *ipc, int code);
 210 #define logoff(ipc, code)       ctdl_logoff(__FILE__, __LINE__, (ipc), (code))
 211 void formout(CtdlIPC *ipc, char *name);
 212 void sighandler(int which_sig);
 213 extern int secure;
 214 void remove_march(char *roomname, int floornum);
 215 void calc_dirs_n_files(int relh, int home, const char *relhome, char  *ctdldir, int dbg);
 216
 217 /*
 218  * This struct stores a list of rooms with new messages which the client
 219  * fetches from the server.  This allows the client to "march" through
 220  * relevant rooms without having to ask the server each time where to go next.
 221  */
 222 typedef struct ExpirePolicy ExpirePolicy;
 223 struct ExpirePolicy {
 224         int expire_mode;
 225         int expire_value;
 226 };
 227
 228 typedef struct march march;
 229 struct march {
 230         struct march *next;
 231         char march_name[ROOMNAMELEN];
 232         unsigned int march_flags;
 233         char march_floor;
 234         char march_order;
 235         unsigned int march_flags2;
 236         int march_access;
 237 };
 238
 239 /*
 240  * This is NOT the same 'struct ctdluser' from the server.
 241  */
 242 typedef struct ctdluser ctdluser;
 243 struct ctdluser {                       // User record
 244         int version;                    // Cit vers. which created this rec
 245         uid_t uid;                      // Associate with a unix account?
 246         char password[32];              // password
 247         unsigned flags;                 // See US_ flags below
 248         long timescalled;               // Total number of logins
 249         long posted;                    // Number of messages ever submitted
 250         uint8_t axlevel;                // Access level
 251         long usernum;                   // User number (never recycled)
 252         time_t lastcall;                // Date/time of most recent login
 253         int USuserpurge;                // Purge time (in days) for user
 254         char fullname[64];              // Display name (primary identifier)
 255         char emailaddrs[512];           // Internet email addresses
 256 };
 257
 258 typedef struct ctdlroom ctdlroom;
 259 struct ctdlroom {
 260         char QRname[ROOMNAMELEN];       /* Name of room                     */
 261         char QRpasswd[10];              /* Only valid if it's a private rm  */
 262         long QRroomaide;                /* User number of room aide         */
 263         long QRhighest;                 /* Highest message NUMBER in room   */
 264         time_t QRgen;                   /* Generation number of room        */
 265         unsigned QRflags;               /* See flag values below            */
 266         char QRdirname[15];             /* Directory name, if applicable    */
 267         long QRinfo;                    /* Info file update relative to msgs*/
 268         char QRfloor;                   /* Which floor this room is on      */
 269         time_t QRmtime;                 /* Date/time of last post           */
 270         struct ExpirePolicy QRep;       /* Message expiration policy        */
 271         long QRnumber;                  /* Globally unique room number      */
 272         char QRorder;                   /* Sort key for room listing order  */
 273         unsigned QRflags2;              /* Additional flags                 */
 274         int QRdefaultview;              /* How to display the contents      */
 275 };
 276
 277
 278 /* C constructor */
 279 CtdlIPC* CtdlIPC_new(int argc, char **argv, char *hostbuf, char *portbuf);
 280 /* C destructor */
 281 void CtdlIPC_delete(CtdlIPC* ipc);
 282 /* Convenience destructor; also nulls out caller's pointer */
 283 void CtdlIPC_delete_ptr(CtdlIPC** pipc);
 284 /* Read a line from server, discarding newline, for chat, will go away */
 285 void CtdlIPC_chat_recv(CtdlIPC* ipc, char *buf);
 286 /* Write a line to server, adding newline, for chat, will go away */
 287 void CtdlIPC_chat_send(CtdlIPC* ipc, const char *buf);
 288
 289 struct ctdlipcroom {
 290         char RRname[ROOMNAMELEN];       /* Name of room */
 291         long RRunread;                  /* Number of unread messages */
 292         long RRtotal;                   /* Total number of messages in room */
 293         char RRinfoupdated;             /* Nonzero if info was updated */
 294         unsigned RRflags;               /* Various flags (see LKRN) */
 295         unsigned RRflags2;              /* Various flags (see LKRN) */
 296         long RRhighest;                 /* Highest message number in room */
 297         long RRlastread;                /* Highest message user has read */
 298         char RRismailbox;               /* Is this room a mailbox room? */
 299         char RRaide;                    /* User can do aide commands in room */
 300         long RRnewmail;                 /* Number of new mail messages */
 301         char RRfloor;                   /* Which floor this room is on */
 302         char RRcurrentview;             /* The user's current view for this room */
 303         char RRdefaultview;             /* The default view for this room */
 304 };
 305
 306
 307 struct parts {
 308         struct parts *next;
 309         char number[16];                /* part number */
 310         char name[PATH_MAX];            /* Name */
 311         char filename[PATH_MAX];        /* Suggested filename */
 312         char mimetype[SIZ];             /* MIME type */
 313         char disposition[SIZ];          /* Content disposition */
 314         unsigned long length;           /* Content length */
 315 };
 316
 317
 318 struct ctdlipcmessage {
 319         char msgid[SIZ];                /* Original message ID */
 320         char path[SIZ];                 /* Return path to sender */
 321         char zaps[SIZ];                 /* Message ID that this supersedes */
 322         char subject[SIZ];              /* Message subject */
 323         char email[SIZ];                /* Email address of sender */
 324         char author[SIZ];               /* Sender of message */
 325         char recipient[SIZ];            /* Recipient of message */
 326         char room[SIZ];                 /* Originating room */
 327         struct parts *attachments;      /* Available attachments */
 328         char *text;                     /* Message text */
 329         int type;                       /* Message type */
 330         time_t time;                    /* Time message was posted */
 331         char nhdr;                      /* Suppress message header? */
 332         char anonymous;                 /* An anonymous message */
 333         char mime_chosen[SIZ];          /* Chosen MIME part to output */
 334         char content_type[SIZ];         /* How would you like that? */
 335         char references[SIZ];           /* Thread references */
 336         int is_local;                   /* Nonzero if the message originated on the local system */
 337 };
 338
 339
 340 struct ctdlipcfile {
 341         char remote_name[PATH_MAX];     /* Filename on server */
 342         char local_name[PATH_MAX];      /* Filename on client */
 343         char description[80];           /* Description on server */
 344         FILE *local_fd;                 /* Open file on client */
 345         size_t size;                    /* Size of file in octets */
 346         unsigned int upload:1;          /* uploading? 0 if downloading */
 347         unsigned int complete:1;        /* Transfer has finished? */
 348 };
 349
 350
 351 struct ctdlipcmisc {
 352         long newmail;                   /* Number of new Mail messages */
 353         char needregis;                 /* Nonzero if user needs to register */
 354         char needvalid;                 /* Nonzero if users need validation */
 355 };
 356
 357 enum RoomList {
 358         SubscribedRooms,
 359         SubscribedRoomsWithNewMessages,
 360         SubscribedRoomsWithNoNewMessages,
 361         UnsubscribedRooms,
 362         AllAccessibleRooms,
 363         AllPublicRooms
 364 };
 365 #define AllFloors -1
 366 enum MessageList {
 367         AllMessages,
 368         OldMessages,
 369         NewMessages,
 370         LastMessages,
 371         FirstMessages,
 372         MessagesGreaterThan,
 373         MessagesLessThan
 374 };
 375 enum MessageDirection {
 376         ReadReverse = -1,
 377         ReadForward = 1
 378 };
 379 extern char file_citadel_rc[PATH_MAX];
 380 extern char file_citadel_config[PATH_MAX];
 381
 382 /* Shared Diffie-Hellman parameters */
 383 #define DH_P            "F6E33BD70D475906ABCFB368DA2D1E5611D57DFDAC6A10CD78F406D6952519C74E21FFDCC5A780B9359722AACC8036E4CD24D5F5165EAC9EF226DBD9BBCF678F8DDEE86386F1BC20E291A9854A513A2CA326B411DC92E38F2ED2FEB6A3B792F13DB6550371FDBAC5ECA373BE5050CA4905431CA86088737D52B36C8D13CE9CB4EEF4C910285035E8329DD07551A80B87775676DD1067395CCEE9040C9B8BF998C528B3772B4C590A2CF18C5E58929BFCB538A62638B7437A9C68572D15287E97692B0B1EC5444D9DAB6EB062D20B79CA005EC5035065567AFD1FEF9B251D74747C6065D8C8B6B0862D1EE03F3A244C429EADE0CCC5C3A4196F5CBF5AA01A9026EFB20AA90E462BD64620278F271905EB604F38E6CFAE412EAA6C468E3B58170909BC18662FE2053224F30BE4FDB93BF9FBF969D91A5427A0665AC7BD1C43701B991094C92F7A935063055617142164F02973EB4ED86DD74D2BBAB3CD3B28F7BBD8D9F925B0FE92F7F7D0568D783F9ECE7AF96FB5AF274B586924B64639733A73ACA8F2BD1E970DF51ADDD983F7F6361A2B0DC4F086DE26D8656EC8813DE4B74D6D57BC1E690AC2FF1682B7E16938565A41D1DC64C75ADB81DA4582613FC68C0FDD327D35E2CDF20D009465303773EF3870FBDB0985EE7002A95D7912BBCC78187C29DB046763B7FABFF44EABE820F8ED0D7230AA0AF24F428F82448345BC099B"
 384 #define DH_G            "2"
 385 #define DH_L            4096
 386 #define CIT_CIPHERS     "ALL:RC4+RSA:+SSLv2:+TLSv1:!MD5:@STRENGTH"      /* see ciphers(1) */
 387
 388 int CtdlIPCNoop(CtdlIPC *ipc);
 389 int CtdlIPCEcho(CtdlIPC *ipc, const char *arg, char *cret);
 390 int CtdlIPCQuit(CtdlIPC *ipc);
 391 int CtdlIPCLogout(CtdlIPC *ipc);
 392 int CtdlIPCTryLogin(CtdlIPC *ipc, const char *username, char *cret);
 393 int CtdlIPCTryPassword(CtdlIPC *ipc, const char *passwd, char *cret);
 394 int CtdlIPCTryApopPassword(CtdlIPC *ipc, const char *response, char *cret);
 395 int CtdlIPCCreateUser(CtdlIPC *ipc, const char *username, int selfservice,
 396                 char *cret);
 397 int CtdlIPCChangePassword(CtdlIPC *ipc, const char *passwd, char *cret);
 398 int CtdlIPCKnownRooms(CtdlIPC *ipc, enum RoomList which, int floor,
 399                 struct march **listing, char *cret);
 400 int CtdlIPCGetConfig(CtdlIPC *ipc, struct ctdluser **uret, char *cret);
 401 int CtdlIPCSetConfig(CtdlIPC *ipc, struct ctdluser *uret, char *cret);
 402 int CtdlIPCGotoRoom(CtdlIPC *ipc, const char *room, const char *passwd,
 403                 struct ctdlipcroom **rret, char *cret);
 404 int CtdlIPCGetMessages(CtdlIPC *ipc, enum MessageList which, int whicharg,
 405                 const char *mtemplate, unsigned long **mret, char *cret);
 406 int CtdlIPCGetSingleMessage(CtdlIPC *ipc, long msgnum, int headers, int as_mime,
 407                 struct ctdlipcmessage **mret, char *cret);
 408 int CtdlIPCWhoKnowsRoom(CtdlIPC *ipc, char **listing, char *cret);
 409 int CtdlIPCServerInfo(CtdlIPC *ipc, char *cret);
 410 /* int CtdlIPCReadDirectory(CtdlIPC *ipc, struct ctdlipcfile **files, char *cret); */
 411 int CtdlIPCReadDirectory(CtdlIPC *ipc, char **listing, char *cret);
 412 int CtdlIPCSetLastRead(CtdlIPC *ipc, long msgnum, char *cret);
 413 int CtdlIPCInviteUserToRoom(CtdlIPC *ipc, const char *username, char *cret);
 414 int CtdlIPCKickoutUserFromRoom(CtdlIPC *ipc, const char *username, char *cret);
 415 int CtdlIPCGetRoomAttributes(CtdlIPC *ipc, struct ctdlroom **qret, char *cret);
 416 int CtdlIPCSetRoomAttributes(CtdlIPC *ipc, int forget, struct ctdlroom *qret,
 417                 char *cret);
 418 int CtdlIPCGetRoomAide(CtdlIPC *ipc, char *cret);
 419 int CtdlIPCSetRoomAide(CtdlIPC *ipc, const char *username, char *cret);
 420 int CtdlIPCPostMessage(CtdlIPC *ipc, int flag, int *subject_required,
 421                                            struct ctdlipcmessage *mr,
 422                                            char *cret);
 423 int CtdlIPCRoomInfo(CtdlIPC *ipc, char **iret, char *cret);
 424 int CtdlIPCDeleteMessage(CtdlIPC *ipc, long msgnum, char *cret);
 425 int CtdlIPCMoveMessage(CtdlIPC *ipc, int copy, long msgnum,
 426                 const char *destroom, char *cret);
 427 int CtdlIPCDeleteRoom(CtdlIPC *ipc, int for_real, char *cret);
 428 int CtdlIPCCreateRoom(CtdlIPC *ipc, int for_real, const char *roomname,
 429                 int type, const char *password, int floor, char *cret);
 430 int CtdlIPCForgetRoom(CtdlIPC *ipc, char *cret);
 431 int CtdlIPCSystemMessage(CtdlIPC *ipc, const char *message, char **mret,
 432                 char *cret);
 433 int CtdlIPCNextUnvalidatedUser(CtdlIPC *ipc, char *cret);
 434 int CtdlIPCGetUserRegistration(CtdlIPC *ipc, const char *username, char **rret,
 435                 char *cret);
 436 int CtdlIPCValidateUser(CtdlIPC *ipc, const char *username, int axlevel,
 437                 char *cret);
 438 int CtdlIPCSetRoomInfo(CtdlIPC *ipc, int for_real, const char *info,
 439                 char *cret);
 440 int CtdlIPCUserListing(CtdlIPC *ipc, char *searchstring, char **list, char *cret);
 441 int CtdlIPCSetRegistration(CtdlIPC *ipc, const char *info, char *cret);
 442 int CtdlIPCMiscCheck(CtdlIPC *ipc, struct ctdlipcmisc *chek, char *cret);
 443 int CtdlIPCDeleteFile(CtdlIPC *ipc, const char *filename, char *cret);
 444 int CtdlIPCMoveFile(CtdlIPC *ipc, const char *filename, const char *destroom, char *cret);
 445 int CtdlIPCNetSendFile(CtdlIPC *ipc, const char *filename, const char *destnode, char *cret);
 446 int CtdlIPCOnlineUsers(CtdlIPC *ipc, char **listing, time_t *stamp, char *cret);
 447 int CtdlIPCFileDownload(CtdlIPC *ipc, const char *filename, void **buf,
 448                 size_t resume,
 449                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 450                 char *cret);
 451 int CtdlIPCAttachmentDownload(CtdlIPC *ipc, long msgnum, const char *part,
 452                 void **buf,
 453                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 454                 char *cret);
 455 int CtdlIPCImageDownload(CtdlIPC *ipc, const char *filename, void **buf,
 456                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 457                 char *cret);
 458 int CtdlIPCFileUpload(CtdlIPC *ipc, const char *save_as, const char *comment,
 459                 const char *path,
 460                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 461                 char *cret);
 462 int CtdlIPCImageUpload(CtdlIPC *ipc, int for_real, const char *path,
 463                 const char *save_as,
 464                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 465                 char *cret);
 466 int CtdlIPCQueryUsername(CtdlIPC *ipc, const char *username, char *cret);
 467 int CtdlIPCFloorListing(CtdlIPC *ipc, char **listing, char *cret);
 468 int CtdlIPCCreateFloor(CtdlIPC *ipc, int for_real, const char *name, char *cret);
 469 int CtdlIPCDeleteFloor(CtdlIPC *ipc, int for_real, int floornum, char *cret);
 470 int CtdlIPCEditFloor(CtdlIPC *ipc, int floornum, const char *floorname, char *cret);
 471 int CtdlIPCIdentifySoftware(CtdlIPC *ipc, int developerid, int clientid,
 472                 int revision, const char *software_name, const char *hostname,
 473                 char *cret);
 474 int CtdlIPCSendInstantMessage(CtdlIPC *ipc, const char *username, const char *text, char *cret);
 475 int CtdlIPCGetInstantMessage(CtdlIPC *ipc, char **listing, char *cret);
 476 int CtdlIPCEnableInstantMessageReceipt(CtdlIPC *ipc, int mode, char *cret);
 477 int CtdlIPCSetBio(CtdlIPC *ipc, char *bio, char *cret);
 478 int CtdlIPCGetBio(CtdlIPC *ipc, const char *username, char **listing, char *cret);
 479 int CtdlIPCListUsersWithBios(CtdlIPC *ipc, char **listing, char *cret);
 480 int CtdlIPCStealthMode(CtdlIPC *ipc, int mode, char *cret);
 481 int CtdlIPCTerminateSession(CtdlIPC *ipc, int sid, char *cret);
 482 int CtdlIPCTerminateServerNow(CtdlIPC *ipc, char *cret);
 483 int CtdlIPCTerminateServerScheduled(CtdlIPC *ipc, int mode, char *cret);
 484 int CtdlIPCEnterSystemMessage(CtdlIPC *ipc, const char *filename, const char *text, char *cret);
 485 time_t CtdlIPCServerTime(CtdlIPC *ipc, char *crert);
 486 int CtdlIPCAideGetUserParameters(CtdlIPC *ipc, const char *who, struct ctdluser **uret, char *cret);
 487 int CtdlIPCAideGetEmailAddresses(CtdlIPC *ipc, const char *who, char *, char *cret);
 488 int CtdlIPCAideSetUserParameters(CtdlIPC *ipc, const struct ctdluser *uret, char *cret);
 489 int CtdlIPCAideSetEmailAddresses(CtdlIPC *ipc, const char *who, char *emailaddrs, char *cret);
 490 int CtdlIPCRenameUser(CtdlIPC *ipc, char *oldname, char *newname, char *cret);
 491 int CtdlIPCGetMessageExpirationPolicy(CtdlIPC *ipc, GPEXWhichPolicy which, struct ExpirePolicy **policy, char *cret);
 492 int CtdlIPCSetMessageExpirationPolicy(CtdlIPC *ipc, int which, struct ExpirePolicy *policy, char *cret);
 493 int CtdlIPCGetSystemConfig(CtdlIPC *ipc, char **listing, char *cret);
 494 int CtdlIPCSetSystemConfig(CtdlIPC *ipc, const char *listing, char *cret);
 495 int CtdlIPCGetSystemConfigByType(CtdlIPC *ipc, const char *mimetype, char **listing, char *cret);
 496 int CtdlIPCSetSystemConfigByType(CtdlIPC *ipc, const char *mimetype, const char *listing, char *cret);
 497 int CtdlIPCGetRoomNetworkConfig(CtdlIPC *ipc, char **listing, char *cret);
 498 int CtdlIPCSetRoomNetworkConfig(CtdlIPC *ipc, const char *listing, char *cret);
 499 int CtdlIPCRequestClientLogout(CtdlIPC *ipc, int session, char *cret);
 500 int CtdlIPCSetMessageSeen(CtdlIPC *ipc, long msgnum, int seen, char *cret);
 501 int CtdlIPCStartEncryption(CtdlIPC *ipc, char *cret);
 502 int CtdlIPCDirectoryLookup(CtdlIPC *ipc, const char *address, char *cret);
 503 int CtdlIPCSpecifyPreferredFormats(CtdlIPC *ipc, char *cret, char *formats);
 504 int CtdlIPCInternalProgram(CtdlIPC *ipc, int secret, char *cret);
 505
 506 /* ************************************************************************** */
 507 /*             Stuff below this line is not for public consumption            */
 508 /* ************************************************************************** */
 509
 510 char *CtdlIPCReadListing(CtdlIPC *ipc, char *dest);
 511 int CtdlIPCSendListing(CtdlIPC *ipc, const char *listing);
 512 size_t CtdlIPCPartialRead(CtdlIPC *ipc, void **buf, size_t offset, size_t bytes, char *cret);
 513 int CtdlIPCEndUpload(CtdlIPC *ipc, int discard, char *cret);
 514 int CtdlIPCWriteUpload(CtdlIPC *ipc, FILE *uploadFP,
 515                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 516                 char *cret);
 517 int CtdlIPCEndDownload(CtdlIPC *ipc, char *cret);
 518 int CtdlIPCReadDownload(CtdlIPC *ipc, void **buf, size_t bytes, size_t resume,
 519                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 520                 char *cret);
 521 int CtdlIPCHighSpeedReadDownload(CtdlIPC *ipc, void **buf, size_t bytes,
 522                 size_t resume,
 523                 void (*progress_gauge_callback)(CtdlIPC*, unsigned long, unsigned long),
 524                 char *cret);
 525 int CtdlIPCGenericCommand(CtdlIPC *ipc, const char *command,
 526                 const char *to_send, size_t bytes_to_send, char **to_receive,
 527                 size_t *bytes_to_receive, char *proto_response);
 528
 529 /* Internals */
 530 int starttls(CtdlIPC *ipc);
 531 void setCryptoStatusHook(void (*hook)(char *s));
 532 void CtdlIPC_SetNetworkStatusCallback(CtdlIPC *ipc, void (*hook)(int state));
 533 /* This is all Ford's doing.  FIXME: figure out what it's doing */
 534 extern int (*error_printf)(char *s, ...);
 535 void setIPCDeathHook(void (*hook)(void));
 536 void setIPCErrorPrintf(int (*func)(char *s, ...));
 537 void connection_died(CtdlIPC* ipc, int using_ssl);
 538 int CtdlIPC_getsockfd(CtdlIPC* ipc);
 539 char CtdlIPC_get(CtdlIPC* ipc);
 540 void CtdlIPC_lock(CtdlIPC *ipc);
 541 void CtdlIPC_unlock(CtdlIPC *ipc);
 542 char *libcitadelclient_version_string(void);
 543 void chatmode(CtdlIPC *ipc);
 544 void page_user(CtdlIPC *ipc);
 545 void quiet_mode(CtdlIPC *ipc);
 546 void stealth_mode(CtdlIPC *ipc);
 547 extern char last_paged[];
 548
 549 void determine_pwfilename(char *pwfile, size_t n);
 550 void get_stored_password(
 551                 char *host,
 552                 char *port,
 553                 char *username,
 554                 char *password);
 555 void set_stored_password(
 556                 char *host,
 557                 char *port,
 558                 char *username,
 559                 char *password);
 560 void offer_to_remember_password(CtdlIPC *ipc,
 561                 char *host,
 562                 char *port,
 563                 char *username,
 564                 char *password);
 565
 566 void load_command_set(void);
 567 void stty_ctdl(int cmd);
 568 void newprompt(char *prompt, char *str, int len);
 569 void strprompt(char *prompt, char *str, int len);
 570 int boolprompt(char *prompt, int prev_val);
 571 int intprompt(char *prompt, int ival, int imin, int imax);
 572 int fmout(int width, FILE *fpin, char *text, FILE *fpout, int subst);
 573 int getcmd(CtdlIPC *ipc, char *argbuf);
 574 void display_help(CtdlIPC *ipc, char *name);
 575 void color(int colornum);
 576 void cls(int colornum);
 577 void send_ansi_detect(void);
 578 void look_for_ansi(void);
 579 int inkey(void);
 580 void set_keepalives(int s);
 581 extern int enable_color;
 582 int yesno(void);
 583 int yesno_d(int d);
 584 void keyopt(char *);
 585 char keymenu(char *menuprompt, char *menustring);
 586 void async_ka_start(void);
 587 void async_ka_end(void);
 588 int checkpagin(int lp, unsigned int pagin, unsigned int height);
 589 char was_a_key_pressed(void);
 590
 591 #ifdef __GNUC__
 592 void pprintf(const char *format, ...) __attribute__((__format__(__printf__,1,2)));
 593 #else
 594 void pprintf(const char *format, ...);
 595 #endif
 596
 597
 598 extern char rc_url_cmd[SIZ];
 599 extern char rc_open_cmd[SIZ];
 600 extern char rc_gotmail_cmd[SIZ];
 601 extern int lines_printed;
 602 extern int rc_remember_passwords;
 603
 604 #ifndef MD5_H
 605 #define MD5_H
 606
 607 struct MD5Context {
 608         uint32_t buf[4];
 609         uint32_t bits[2];
 610         uint32_t in[16];
 611 };
 612
 613 void MD5Init(struct MD5Context *context);
 614 void MD5Update(struct MD5Context *context, unsigned char const *buf,
 615                unsigned len);
 616 void MD5Final(unsigned char digest[16], struct MD5Context *context);
 617 void MD5Transform(uint32_t buf[4], uint32_t const in[16]);
 618 char *make_apop_string(char *realpass, char *nonce, char *buffer, size_t n);
 619
 620 /*
 621  * This is needed to make RSAREF happy on some MS-DOS compilers.
 622  */
 623 #ifndef HAVE_OPENSSL
 624 typedef struct MD5Context MD5_CTX;
 625 #endif
 626
 627 #define MD5_DIGEST_LEN          16
 628 #define MD5_HEXSTRING_SIZE      33
 629
 630 #endif /* !MD5_H */
 631
 632
 633 #define MAXURLS         50      /* Max embedded URL's per message */
 634 extern int num_urls;
 635 extern char urls[MAXURLS][SIZ];
 636
 637 int ka_system(char *shc);
 638 int entmsg(CtdlIPC *ipc, int is_reply, int c, int masquerade);
 639 void readmsgs(CtdlIPC *ipc, enum MessageList c, enum MessageDirection rdir, int q);
 640 void edit_system_message(CtdlIPC *ipc, char *which_message);
 641 pid_t ka_wait(int *kstatus);
 642 void list_urls(CtdlIPC *ipc);
 643 int client_make_message(CtdlIPC *ipc,
 644                         char *filename,         /* temporary file name */
 645                         char *recipient,        /* NULL if it's not mail */
 646                         int anon_type,          /* see MES_ types in header file */
 647                         int format_type,
 648                         int mode,
 649                         char *subject,
 650                         int subject_required
 651 );
 652 void citedit(FILE *);
 653 char *load_message_from_file(FILE *src);
 654 int file_checksum(char *filename);
 655 void listzrooms(CtdlIPC *ipc);
 656 void readinfo(CtdlIPC *ipc);
 657 void forget(CtdlIPC *ipc);
 658 void entroom(CtdlIPC *ipc);
 659 void killroom(CtdlIPC *ipc);
 660 void invite(CtdlIPC *ipc);
 661 void kickout(CtdlIPC *ipc);
 662 void editthisroom(CtdlIPC *ipc);
 663 void roomdir(CtdlIPC *ipc);
 664 void download(CtdlIPC *ipc, int proto);
 665 void ungoto(CtdlIPC *ipc);
 666 void dotungoto(CtdlIPC *ipc, char *towhere);
 667 void whoknows(CtdlIPC *ipc);
 668 void enterinfo(CtdlIPC *ipc);
 669 void knrooms(CtdlIPC *ipc, int kn_floor_mode);
 670 void dotknown(CtdlIPC *ipc, int what, char *match);
 671 void load_floorlist(CtdlIPC *ipc);
 672 void create_floor(CtdlIPC *ipc);
 673 void edit_floor(CtdlIPC *ipc);
 674 void kill_floor(CtdlIPC *ipc);
 675 void enter_bio(CtdlIPC *ipc);
 676 int save_buffer(void *file, size_t filelen, const char *pathname);
 677 void destination_directory(char *dest, const char *supplied_filename);
 678 void do_edit(CtdlIPC *ipc, char *desc, char *read_cmd, char *check_cmd, char *write_cmd);
 679
 680
 681 /*
 682  * This struct holds a list of rooms for client display.
 683  * (oooh, a tree!)
 684  */
 685 struct ctdlroomlisting {
 686         struct ctdlroomlisting *lnext;
 687         struct ctdlroomlisting *rnext;
 688         char rlname[ROOMNAMELEN];
 689         unsigned rlflags;
 690         int rlfloor;
 691         int rlorder;
 692         };
 693
 694
 695 enum {
 696         LISTRMS_NEW_ONLY,
 697         LISTRMS_OLD_ONLY,
 698         LISTRMS_ALL
 699 };
 700
 701
 702 void updatels(CtdlIPC *ipc);
 703 void updatelsa(CtdlIPC *ipc);
 704 void movefile(CtdlIPC *ipc);
 705 void deletefile(CtdlIPC *ipc);
 706 void netsendfile(CtdlIPC *ipc);
 707 void entregis(CtdlIPC *ipc);
 708 void subshell(void);
 709 void upload(CtdlIPC *ipc, int c);
 710 void cli_upload(CtdlIPC *ipc);
 711 void validate(CtdlIPC *ipc);
 712 void read_bio(CtdlIPC *ipc);
 713 void cli_image_upload(CtdlIPC *ipc, char *keyname);
 714 int room_prompt(unsigned int qrflags);
 715 int val_user(CtdlIPC *ipc, char *user, int do_validate);
 716
 717 void edituser(CtdlIPC *ipc, int cmd);
 718 void interr(int errnum);
 719 int struncmp(char *lstr, char *rstr, int len);
 720 int pattern(char *search, char *patn);
 721 void enter_config(CtdlIPC* ipc, int mode);
 722 void locate_host(CtdlIPC* ipc, char *hbuf);
 723 void misc_server_cmd(CtdlIPC *ipc, char *cmd);
 724 int nukedir(char *dirname);
 725 void strproc(char *string);
 726 void back(int spaces);
 727 void progress(CtdlIPC* ipc, unsigned long curr, unsigned long cmax);
 728 int set_attr(CtdlIPC *ipc, unsigned int sval, char *prompt, unsigned int sbit, int backwards);
 729
 730 void screen_new(void);
 731 int scr_printf(char *fmt, ...);
 732 #define SCR_NOBLOCK 0
 733 #define SCR_BLOCK -1
 734 int scr_getc(int delay);
 735 int scr_putc(int c);
 736 void scr_flush(void);
 737 int scr_blockread(void);
 738 sighandler_t scr_winch(int signum);
 739 void wait_indicator(int state);
 740 void ctdl_beep(void);
 741 void scr_wait_indicator(int);
 742 extern char status_line[];
 743 extern void check_screen_dims(void);
 744 extern int screenwidth;
 745 extern int screenheight;
 746 void do_internet_configuration(CtdlIPC *ipc);
 747 void network_config_management(CtdlIPC *ipc, char *entrytype, char *comment);
 748 void do_pop3client_configuration(CtdlIPC *ipc);
 749 void do_rssclient_configuration(CtdlIPC *ipc);
 750 void do_system_configuration(CtdlIPC *ipc);
 751 extern char editor_path[PATH_MAX];
 752 extern int enable_status_line;