textclient/textclient.h

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