1 // Main source module for the client program.
3 // Copyright (c) 1987-2022 by the citadel.org team
5 // This program is open source software. Use, duplication, and/or
6 // disclosure are subject to the GNU General Purpose License version 3.
8 // This program is distributed in the hope that it will be useful,
9 // but WITHOUT ANY WARRANTY; without even the implied warranty of
10 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 // GNU General Public License for more details.
13 #include "textclient.h"
15 #define IFEXPERT if (userflags&US_EXPERT)
16 #define IFNEXPERT if ((userflags&US_EXPERT)==0)
17 #define IFAIDE if (axlevel>=AxAideU)
18 #define IFNAIDE if (axlevel<AxAideU)
20 int rordercmp(struct ctdlroomlisting *r1, struct ctdlroomlisting *r2);
21 march *marchptr = NULL;
22 extern char *moreprompt;
24 /* globals associated with the client program */
25 char temp[PATH_MAX]; /* Name of general-purpose temp file */
26 char temp2[PATH_MAX]; /* Name of general-purpose temp file */
27 char tempdir[PATH_MAX]; /* Name of general-purpose temp directory */
28 char printcmd[SIZ]; /* print command */
29 int editor_pid = (-1);
30 char fullname[USERNAME_SIZE];
34 char room_name[ROOMNAMELEN];
35 char *uglist[UGLISTLEN]; /* size of the ungoto list */
36 long uglistlsn[UGLISTLEN]; /* current read position for all the ungoto's. Not going to make any friends with this one. */
38 char is_mail = 0; /* nonzero when we're in a mail room */
39 char axlevel = AxDeleted; /* access level */
40 char is_room_aide = 0; /* boolean flag, 1 if room admin */
44 long usernum = 0L; /* user number */
45 time_t lastcall = 0L; /* Date/time of previous login */
47 long highest_msg_read; /* used for <A>bandon room cmd */
48 long maxmsgnum; /* used for <G>oto */
50 char rc_username[USERNAME_SIZE];
56 char curr_floor = 0; /* number of current floor */
57 char floorlist[128][SIZ]; /* names of floors */
58 int termn8 = 0; /* Set to nonzero to cause a logoff */
59 int secure; /* Set to nonzero when wire is encrypted */
61 extern char instant_msgs; /* instant messages waiting! */
62 extern int rc_ansi_color; /* ansi color value from citadel.rc */
63 extern int next_lazy_cmd;
65 CtdlIPC *ipc_for_signal_handlers; /* KLUDGE cover your eyes */
66 int enable_syslog = 0;
69 // Here is our 'clean up gracefully and exit' routine
70 void ctdl_logoff(char *file, int line, CtdlIPC * ipc, int code) {
73 if (editor_pid > 0) { /* kill the editor if it's running */
74 kill(editor_pid, SIGHUP);
77 // Free the ungoto list
78 for (lp = 0; lp < uglistsize; lp++) {
82 // Shut down the server connection ... but not if the logoff code is 3,
83 // because that means we're exiting because we already lost the server.
88 // now clean up various things
93 // Violently kill off any child processes if Citadel is the login shell.
95 kill(0 - getpgrp(), SIGTERM);
97 kill(0 - getpgrp(), SIGKILL);
99 color(ORIGINAL_PAIR); // Restore the old color settings
100 stty_ctdl(SB_RESTORE); // return the old terminal settings
101 exit(code); // exit with the proper exit code
107 * signal catching function for hangups...
109 void dropcarr(int signum) {
110 logoff(NULL, 3); /* No IPC when server's already gone! */
116 * catch SIGCONT to reset terminal modes when were are put back into the
119 void catch_sigcont(int signum) {
121 signal(SIGCONT, catch_sigcont);
125 /* general purpose routines */
128 void formout(CtdlIPC * ipc, char *name) {
129 int r; /* IPC return code */
133 r = CtdlIPCSystemMessage(ipc, name, &text, buf);
135 scr_printf("%s\n", buf);
139 fmout(screenwidth, NULL, text, NULL, 1);
145 void userlist(CtdlIPC * ipc, char *patn) {
147 char fl[64]; // a buffer this small will prevent it overrunning the column
150 int r; // IPC response code
151 char *listing = NULL;
153 r = CtdlIPCUserListing(ipc, patn, &listing, buf);
155 scr_printf("%s\n", buf);
159 scr_printf("User Name Last Visit\n");
160 scr_printf("---------------------------------------------------------------- ----------\n");
162 while (!IsEmptyStr(listing)) {
163 extract_token(buf, listing, 0, '\n', sizeof buf);
164 remove_token(listing, 0, '\n');
166 if (sigcaught == 0) {
167 extract_token(fl, buf, 0, '|', sizeof fl);
168 if (pattern(fl, patn) >= 0) {
169 scr_printf("%-64s ", fl);
170 lc = extract_long(buf, 3);
171 localtime_r(&lc, &tmbuf);
172 scr_printf("%02d/%02d/%04d\n", (tmbuf.tm_mon + 1), tmbuf.tm_mday, (tmbuf.tm_year + 1900));
182 // grab assorted info about the user...
183 void load_user_info(char *params) {
184 extract_token(fullname, params, 0, '|', sizeof fullname);
185 axlevel = extract_int(params, 1);
186 timescalled = extract_int(params, 2);
187 posted = extract_int(params, 3);
188 userflags = extract_int(params, 4);
189 usernum = extract_long(params, 5);
190 lastcall = extract_long(params, 6);
194 // Remove a room from the march list. 'floornum' is ignored unless
195 // 'roomname' is set to _FLOOR_, in which case all rooms on the requested
196 // floor will be removed from the march list.
197 void remove_march(char *roomname, int floornum) {
198 struct march *mptr, *mptr2;
200 if (marchptr == NULL)
203 if ((!strcasecmp(marchptr->march_name, roomname))
204 || ((!strcasecmp(roomname, "_FLOOR_")) && (marchptr->march_floor == floornum))) {
205 mptr = marchptr->next;
211 for (mptr = marchptr; mptr != NULL; mptr = mptr->next) {
213 if ((!strcasecmp(mptr->march_name, roomname))
214 || ((!strcasecmp(roomname, "_FLOOR_"))
215 && (mptr->march_floor == floornum))) {
217 mptr2->next = mptr->next;
228 // Locate the room on the march list which we most want to go to. Each room
229 // is measured given a "weight" of preference based on various factors.
230 char *pop_march(int desired_floor, struct march *_march) {
231 static char TheRoom[ROOMNAMELEN];
234 struct march *mptr = NULL;
236 strcpy(TheRoom, "_BASEROOM_");
240 for (mptr = _march; mptr != NULL; mptr = mptr->next) {
242 if ((strcasecmp(mptr->march_name, "_BASEROOM_")))
243 weight = weight + 10000;
244 if (mptr->march_floor == desired_floor)
245 weight = weight + 5000;
247 weight = weight + ((128 - (mptr->march_floor)) * 128);
248 weight = weight + (128 - (mptr->march_order));
250 if (weight > TheWeight) {
252 strcpy(TheRoom, mptr->march_name);
259 // jump directly to a room
260 void dotgoto(CtdlIPC * ipc, char *towhere, int display_name, int fromungoto) {
261 char aaa[SIZ], bbb[SIZ];
263 int partial_match, best_match;
265 int ugpos = uglistsize;
266 int r; /* IPC result code */
267 struct ctdlipcroom *room = NULL;
270 /* store ungoto information */
271 if (fromungoto == 0) {
272 /* sloppy slide them all down, hey it's the client, who cares. :-) */
273 if (uglistsize >= (UGLISTLEN - 1)) {
276 for (lp = 0; lp < (UGLISTLEN - 1); lp++) {
277 uglist[lp] = uglist[lp + 1];
278 uglistlsn[lp] = uglistlsn[lp + 1];
286 uglist[ugpos] = malloc(strlen(room_name) + 1);
287 strcpy(uglist[ugpos], room_name);
288 uglistlsn[ugpos] = ls;
291 /* first try an exact match */
292 r = CtdlIPCGotoRoom(ipc, towhere, "", &room, aaa);
294 newprompt("Enter room password: ", bbb, 9);
295 r = CtdlIPCGotoRoom(ipc, towhere, bbb, &room, aaa);
297 scr_printf("Wrong password.\n");
303 * If a match is not found, try a partial match.
304 * Partial matches anywhere in the string carry a weight of 1,
305 * left-aligned matches carry a weight of 2. Pick the room that
306 * has the highest-weighted match. Do not match on forgotten
310 struct march *march = NULL;
315 r = CtdlIPCKnownRooms(ipc, SubscribedRooms, AllFloors, &march, aaa);
317 /* Run the roomlist; free the data as we go */
318 struct march *mp = march; /* Current */
322 if (pattern(mp->march_name, towhere) >= 0) {
325 if (!strncasecmp(mp->march_name, towhere, strlen(towhere))) {
328 if (partial_match > best_match) {
329 strcpy(bbb, mp->march_name);
330 best_match = partial_match;
332 /* Both pointers are NULL at end of list */
339 if (IsEmptyStr(bbb)) {
340 scr_printf("No room '%s'.\n", towhere);
343 r = CtdlIPCGotoRoom(ipc, bbb, "", &room, aaa);
345 if (r / 100 != 1 && r / 100 != 2) {
346 scr_printf("%s\n", aaa);
349 strncpy(room_name, room->RRname, ROOMNAMELEN);
350 room_flags = room->RRflags;
351 room_flags2 = room->RRflags2;
352 from_floor = curr_floor;
353 curr_floor = room->RRfloor;
355 // Determine, based on the room's default view, whether an <E>nter message command will be valid here.
356 switch (room->RRdefaultview) {
359 entmsg_ok = ENTMSG_OK_YES;
362 entmsg_ok = ENTMSG_OK_BLOG;
365 entmsg_ok = ENTMSG_OK_NO;
369 remove_march(room_name, 0);
370 if (!strcasecmp(towhere, "_BASEROOM_"))
371 remove_march(towhere, 0);
373 next_lazy_cmd = 5; /* Don't read new if no new msgs */
374 if ((from_floor != curr_floor) && (display_name > 0) && (floor_mode == 1)) {
375 if (floorlist[(int) curr_floor][0] == 0)
377 scr_printf("(Entering floor: %s)\n", &floorlist[(int) curr_floor][0]);
379 if (display_name == 1) {
381 scr_printf("%s ", room_name);
385 if (display_name != 2) {
386 color(BRIGHT_YELLOW);
387 scr_printf("%d ", room->RRunread);
389 scr_printf("new of ");
390 color(BRIGHT_YELLOW);
391 scr_printf("%d ", room->RRtotal);
393 scr_printf("messages.\n");
395 highest_msg_read = room->RRlastread;
396 maxmsgnum = room->RRhighest;
397 is_mail = room->RRismailbox;
398 is_room_aide = room->RRaide;
399 ls = room->RRlastread;
401 /* read info file if necessary */
402 if (room->RRinfoupdated > 0)
405 /* check for newly arrived mail if we can FIXME use BIFF command for this
406 if (newmailcount > 0) {
408 if (newmailcount == 1) {
409 scr_printf("*** A new mail message has arrived.\n");
412 scr_printf("*** %d new mail messages have arrived.\n", newmailcount);
415 if (!IsEmptyStr(rc_gotmail_cmd)) {
416 rv = system(rc_gotmail_cmd);
418 scr_printf("*** failed to check for mail calling %s Reason %d.\n", rc_gotmail_cmd, rv);
426 snprintf(&status_line[1], screenwidth - 1, "%s | %s | %s | %s | %d new mail |",
427 (secure ? "Encrypted" : "Unencrypted"),
428 ipc->ServInfo.humannode, ipc->ServInfo.site_location, room_name, 0); // FIXME use BIFF
432 /* Goto next room having unread messages.
433 * We want to skip over rooms that the user has already been to, and take the
434 * user back to the lobby when done. The room we end up in is placed in
435 * newroom - which is set to 0 (the lobby) initially.
437 void gotonext(CtdlIPC * ipc) {
439 struct march *mptr, *mptr2;
440 char next_room[ROOMNAMELEN];
442 // Check to see if the march-mode list is already allocated.
443 // If it is, pop the first room off the list and go there.
444 if (marchptr == NULL) {
445 CtdlIPCKnownRooms(ipc, SubscribedRoomsWithNewMessages, AllFloors, &marchptr, buf);
447 // Add _BASEROOM_ to the end of the march list, so the user will end up
448 // in the system base room (usually the Lobby>) at the end of the loop.
449 mptr = (struct march *) malloc(sizeof(struct march));
451 mptr->march_order = 0;
452 mptr->march_floor = 0;
453 strcpy(mptr->march_name, "_BASEROOM_");
454 if (marchptr == NULL) {
459 while (mptr2->next != NULL)
464 // ...and remove the room we're currently in, so a <G>oto doesn't make us walk around in circles
465 remove_march(room_name, 0);
467 if (marchptr != NULL) {
468 strcpy(next_room, pop_march(curr_floor, marchptr));
471 strcpy(next_room, "_BASEROOM_");
473 remove_march(next_room, 0);
474 dotgoto(ipc, next_room, 1, 0);
478 // forget all rooms on a given floor
479 void forget_all_rooms_on(CtdlIPC * ipc, int ffloor) {
481 struct march *flist = NULL;
482 struct march *fptr = NULL;
483 struct ctdlipcroom *room = NULL;
484 int r; // IPC response code
486 scr_printf("Forgetting all rooms on %s...\n", &floorlist[ffloor][0]);
487 remove_march("_FLOOR_", ffloor);
488 r = CtdlIPCKnownRooms(ipc, AllAccessibleRooms, ffloor, &flist, buf);
490 scr_printf("Error %d: %s\n", r, buf);
494 r = CtdlIPCGotoRoom(ipc, flist->march_name, "", &room, buf);
496 r = CtdlIPCForgetRoom(ipc, buf);
498 scr_printf("Error %d: %s\n", r, buf);
511 // routine called by gotofloor() to move to a new room on a new floor
512 void gf_toroom(CtdlIPC * ipc, char *towhere, int mode) {
513 int floor_being_left;
515 floor_being_left = curr_floor;
517 if (mode == GF_GOTO) { /* <;G>oto mode */
519 dotgoto(ipc, towhere, 1, 0);
521 else if (mode == GF_SKIP) { /* <;S>kip mode */
522 dotgoto(ipc, towhere, 1, 0);
523 remove_march("_FLOOR_", floor_being_left);
525 else if (mode == GF_ZAP) { /* <;Z>ap mode */
526 dotgoto(ipc, towhere, 1, 0);
527 remove_march("_FLOOR_", floor_being_left);
528 forget_all_rooms_on(ipc, floor_being_left);
534 void gotofloor(CtdlIPC * ipc, char *towhere, int mode) {
536 int r; /* IPC response code */
538 char buf[SIZ], targ[SIZ];
540 if (floorlist[0][0] == 0)
543 for (a = 0; a < 128; ++a)
544 if (!strcasecmp(&floorlist[a][0], towhere))
548 for (a = 0; a < 128; ++a) {
549 if (!strncasecmp(&floorlist[a][0], towhere, strlen(towhere))) {
555 for (a = 0; a < 128; ++a)
556 if (pattern(towhere, &floorlist[a][0]) > 0)
560 scr_printf("No floor '%s'.\n", towhere);
563 for (mptr = marchptr; mptr != NULL; mptr = mptr->next) {
564 if ((mptr->march_floor) == tofloor) {
565 gf_toroom(ipc, mptr->march_name, mode);
570 /* Find first known room on the floor */
574 r = CtdlIPCKnownRooms(ipc, SubscribedRooms, tofloor, &mptr, buf);
576 struct march *tmp = mptr;
578 /*. . . according to room order */
580 strcpy(targ, pop_march(tofloor, mptr));
587 if (!IsEmptyStr(targ)) {
588 gf_toroom(ipc, targ, mode);
592 /* No known rooms on the floor; unzap the first one then */
596 r = CtdlIPCKnownRooms(ipc, AllAccessibleRooms, tofloor, &mptr, buf);
598 struct march *tmp = mptr;
600 /*. . . according to room order */
602 strcpy(targ, pop_march(tofloor, mptr));
609 if (!IsEmptyStr(targ)) {
610 gf_toroom(ipc, targ, mode);
613 scr_printf("There are no rooms on '%s'.\n", &floorlist[tofloor][0]);
619 * Indexing mechanism for a room list, called by gotoroomstep()
621 void room_tree_list_query(struct ctdlroomlisting *rp, char *findrmname, int findrmslot, char *rmname, int *rmslot, int *rmtotal) {
622 char roomname[ROOMNAMELEN];
623 static int cur_rmslot = 0;
630 if (rp->lnext != NULL) {
631 room_tree_list_query(rp->lnext, findrmname, findrmslot, rmname, rmslot, rmtotal);
634 if (sigcaught == 0) {
635 strcpy(roomname, rp->rlname);
637 if (rmname != NULL) {
638 if (cur_rmslot == findrmslot) {
639 strcpy(rmname, roomname);
642 if (rmslot != NULL) {
643 if (!strcmp(roomname, findrmname)) {
644 *rmslot = cur_rmslot;
650 if (rp->rnext != NULL) {
651 room_tree_list_query(rp->rnext, findrmname, findrmslot, rmname, rmslot, rmtotal);
654 if ((rmname == NULL) && (rmslot == NULL))
657 if (rmtotal != NULL) {
658 *rmtotal = cur_rmslot;
663 * step through rooms on current floor
665 void gotoroomstep(CtdlIPC * ipc, int direction, int mode) {
666 struct march *listing = NULL;
668 int r; /* IPC response code */
670 struct ctdlroomlisting *rl = NULL;
671 struct ctdlroomlisting *rp;
672 struct ctdlroomlisting *rs;
674 char rmname[ROOMNAMELEN];
678 /* Ask the server for a room list */
679 r = CtdlIPCKnownRooms(ipc, SubscribedRooms, (-1), &listing, buf);
686 for (mptr = listing; mptr != NULL; mptr = mptr->next) {
689 if (floor_mode && (mptr->march_floor != curr_floor))
693 rp = malloc(sizeof(struct ctdlroomlisting));
694 strncpy(rp->rlname, mptr->march_name, ROOMNAMELEN);
695 rp->rlflags = mptr->march_flags;
696 rp->rlfloor = mptr->march_floor;
697 rp->rlorder = mptr->march_order;
707 if (rordercmp(rp, rs) < 0) {
708 if (rs->lnext == NULL) {
717 if (rs->rnext == NULL) {
730 /* Find position of current room */
731 room_tree_list_query(NULL, NULL, 0, NULL, NULL, NULL);
732 room_tree_list_query(rl, room_name, 0, NULL, &rmslot, &rmtotal);
734 if (direction == 0) { /* Previous room */
735 /* If we're at the first room, wrap to the last room */
737 rmslot = rmtotal - 1;
743 else { /* Next room */
744 /* If we're at the last room, wrap to the first room */
745 if (rmslot == rmtotal - 1) {
753 /* Get name of next/previous room */
754 room_tree_list_query(NULL, NULL, 0, NULL, NULL, NULL);
755 room_tree_list_query(rl, NULL, rmslot, rmname, NULL, NULL);
758 room_tree_list_query(rl, NULL, 0, NULL, NULL, NULL);
760 if (mode == 0) { /* not skipping */
764 /* Free the room list */
766 mptr = listing->next;
771 dotgoto(ipc, rmname, 1, 0);
776 * step through floors on system
778 void gotofloorstep(CtdlIPC * ipc, int direction, int mode) {
781 if (floorlist[0][0] == 0)
786 if (direction == 0) { /* Previous floor */
788 tofloor = curr_floor - 1;
792 while (!floorlist[tofloor][0])
795 else { /* Next floor */
796 if (curr_floor < 127)
797 tofloor = curr_floor + 1;
801 while (!floorlist[tofloor][0] && tofloor < 127)
803 if (!floorlist[tofloor][0])
806 /* ;g works when not in floor mode so . . . */
808 scr_printf("(%s)\n", floorlist[tofloor]);
811 gotofloor(ipc, floorlist[tofloor], mode);
812 if (curr_floor != tofloor) { /* gotofloor failed */
813 curr_floor = tofloor;
814 goto empty_keep_going;
820 * Display user 'preferences'.
822 extern int rc_prompt_control;
823 void read_config(CtdlIPC * ipc) {
826 int r; /* IPC response code */
827 char _fullname[USERNAME_SIZE];
829 int _axlevel, _timescalled, _posted;
831 struct ctdluser *user = NULL;
833 /* get misc user info */
834 r = CtdlIPCGetBio(ipc, fullname, &resp, buf);
836 scr_printf("%s\n", buf);
839 extract_token(_fullname, buf, 1, '|', sizeof fullname);
840 _usernum = extract_long(buf, 2);
841 _axlevel = extract_int(buf, 3);
842 _lastcall = extract_long(buf, 4);
843 _timescalled = extract_int(buf, 5);
844 _posted = extract_int(buf, 6);
848 /* get preferences */
849 r = CtdlIPCGetConfig(ipc, &user, buf);
851 scr_printf("%s\n", buf);
856 /* show misc user info */
857 scr_printf("%s\nAccess level: %d (%s)\n"
858 "User #%ld / %d Calls / %d Posts", _fullname, _axlevel, axdefs[(int) _axlevel], _usernum, _timescalled, _posted);
859 if (_lastcall > 0L) {
860 scr_printf(" / Curr login: %s", asctime(localtime(&_lastcall)));
864 /* show preferences */
865 scr_printf("Are you an experienced Citadel user: ");
867 scr_printf("%s\n", (user->flags & US_EXPERT) ? "Yes" : "No");
869 scr_printf("Print last old message on New message request: ");
871 scr_printf("%s\n", (user->flags & US_LASTOLD) ? "Yes" : "No");
873 scr_printf("Prompt after each message: ");
875 scr_printf("%s\n", (!(user->flags & US_NOPROMPT)) ? "Yes" : "No");
877 if ((user->flags & US_NOPROMPT) == 0) {
878 scr_printf("Use 'disappearing' prompts: ");
880 scr_printf("%s\n", (user->flags & US_DISAPPEAR) ? "Yes" : "No");
883 scr_printf("Pause after each screenful of text: ");
885 scr_printf("%s\n", (user->flags & US_PAGINATOR) ? "Yes" : "No");
887 if (rc_prompt_control == 3 && (user->flags & US_PAGINATOR)) {
888 scr_printf("<N>ext and <S>top work at paginator prompt: ");
890 scr_printf("%s\n", (user->flags & US_PROMPTCTL) ? "Yes" : "No");
893 if (rc_floor_mode == RC_DEFAULT) {
894 scr_printf("View rooms by floor: ");
896 scr_printf("%s\n", (user->flags & US_FLOORS) ? "Yes" : "No");
899 if (rc_ansi_color == 3) {
900 scr_printf("Enable color support: ");
902 scr_printf("%s\n", (user->flags & US_COLOR) ? "Yes" : "No");
905 scr_printf("Be unlisted in userlog: ");
907 scr_printf("%s\n", (user->flags & US_UNLISTED) ? "Yes" : "No");
909 if (!IsEmptyStr(editor_path)) {
910 scr_printf("Always enter messages with the full-screen editor: ");
912 scr_printf("%s\n", (user->flags & US_EXTEDIT) ? "Yes" : "No");
920 * Display system statistics.
922 void system_info(CtdlIPC * ipc) {
926 int mrtg_users, mrtg_active_users;
927 char mrtg_server_uptime[40];
930 /* get #users, #active & server uptime */
931 CtdlIPCGenericCommand(ipc, "MRTG|users", NULL, 0, &resp, &bytes, buf);
932 mrtg_users = extract_int(resp, 0);
933 remove_token(resp, 0, '\n');
934 mrtg_active_users = extract_int(resp, 0);
935 remove_token(resp, 0, '\n');
936 extract_token(mrtg_server_uptime, resp, 0, '\n', sizeof mrtg_server_uptime);
940 /* get high message# */
941 CtdlIPCGenericCommand(ipc, "MRTG|messages", NULL, 0, &resp, &bytes, buf);
942 mrtg_himessage = extract_long(resp, 0);
946 /* refresh server info just in case */
947 CtdlIPCServerInfo(ipc, buf);
949 scr_printf("You are connected to %s (%s) @%s\n", ipc->ServInfo.nodename, ipc->ServInfo.humannode, ipc->ServInfo.fqdn);
950 scr_printf("running %s with text client v%.2f,\n", ipc->ServInfo.software, (float) CLIENT_VERSION / 100);
951 scr_printf("server build %s,\n", ipc->ServInfo.svn_revision, (float) CLIENT_VERSION / 100);
952 scr_printf("and located in %s.\n", ipc->ServInfo.site_location);
953 scr_printf("Connected users %d / Active users %d / Highest message #%ld\n", mrtg_users, mrtg_active_users, mrtg_himessage);
954 scr_printf("Server uptime: %s\n", mrtg_server_uptime);
955 scr_printf("Your system administrator is %s.\n", ipc->ServInfo.sysadm);
960 * forget all rooms on current floor
962 void forget_this_floor(CtdlIPC * ipc) {
963 if (curr_floor == 0) {
964 scr_printf("Can't forget this floor.\n");
967 if (floorlist[0][0] == 0) {
970 scr_printf("Are you sure you want to forget all rooms on %s? ", &floorlist[(int) curr_floor][0]);
975 gf_toroom(ipc, "_BASEROOM_", GF_ZAP);
980 * set floor mode depending on client, server, and user settings
982 void set_floor_mode(CtdlIPC * ipc) {
983 if (ipc->ServInfo.ok_floors == 0) {
984 floor_mode = 0; /* Don't use floors if the server */
986 /* doesn't support them! */
988 if (rc_floor_mode == RC_NO) { /* never use floors */
991 if (rc_floor_mode == RC_YES) { /* always use floors */
994 if (rc_floor_mode == RC_DEFAULT) { /* user choice */
995 floor_mode = ((userflags & US_FLOORS) ? 1 : 0);
1001 * Set or change the user's password
1003 int set_password(CtdlIPC * ipc) {
1008 if (!IsEmptyStr(rc_password)) {
1009 strcpy(pass1, rc_password);
1010 strcpy(pass2, rc_password);
1013 IFNEXPERT formout(ipc, "changepw");
1014 newprompt("Enter a new password: ", pass1, -19);
1015 newprompt("Enter it again to confirm: ", pass2, -19);
1019 if (!strcasecmp(pass1, pass2)) {
1020 CtdlIPCChangePassword(ipc, pass1, buf);
1021 scr_printf("%s\n", buf);
1022 offer_to_remember_password(ipc, hostbuf, portbuf, fullname, pass1);
1026 scr_printf("*** They don't match... try again.\n");
1033 * get info about the server we've connected to
1035 void get_serv_info(CtdlIPC * ipc, char *supplied_hostname) {
1038 CtdlIPCServerInfo(ipc, buf);
1039 moreprompt = ipc->ServInfo.moreprompt;
1041 /* be nice and identify ourself to the server */
1042 CtdlIPCIdentifySoftware(ipc, CLIENT_TYPE, 0, CLIENT_VERSION,
1043 (ipc->isLocal ? "local" : "Citadel text mode client"), (supplied_hostname) ? supplied_hostname :
1044 /* Look up the , in the bible if you're confused */
1045 (locate_host(ipc, buf), buf), buf);
1047 // Indicate to the server that we prefer to decode Base64 and
1048 // quoted-printable on the client side.
1049 if ((CtdlIPCSpecifyPreferredFormats(ipc, buf, "dont_decode") / 100) != 2) {
1050 scr_printf("Error %s:%d", __FILE__ , __LINE__);
1055 * Tell the server what our preferred content formats are.
1057 * Originally we preferred HTML over plain text because we can format
1058 * it to the reader's screen width, but since our HTML-to-text parser
1059 * isn't really all that great, it's probably better to just go with
1060 * the plain text when we have it available.
1062 if ((CtdlIPCSpecifyPreferredFormats(ipc, buf, "text/plain|text/html|text/x-markdown") / 100) != 2) {
1063 scr_printf("Error %s:%d", __FILE__ , __LINE__);
1070 * Session username compare function for SortOnlineUsers()
1072 int rwho_username_cmp(const void *rec1, const void *rec2) {
1075 u1 = strchr(rec1, '|');
1076 u2 = strchr(rec2, '|');
1078 return strcasecmp((u1 ? ++u1 : ""), (u2 ? ++u2 : ""));
1083 * Idle time compare function for SortOnlineUsers()
1085 int idlecmp(const void *rec1, const void *rec2) {
1088 i1 = extract_long(rec1, 5);
1089 i2 = extract_long(rec2, 5);
1100 * Sort the list of online users by idle time.
1101 * This function frees the supplied buffer, and returns a new one
1102 * to the caller. The caller is responsible for freeing the returned buffer.
1104 * If 'condense' is nonzero, multiple sessions for the same user will be
1105 * combined into one for brevity.
1107 char *SortOnlineUsers(char *listing, int condense) {
1114 rows = num_tokens(listing, '\n');
1115 sortbuf = malloc(rows * SIZ);
1116 if (sortbuf == NULL)
1118 retbuf = malloc(rows * SIZ);
1119 if (retbuf == NULL) {
1124 /* Copy the list into a fixed-record-size array for sorting */
1125 for (i = 0; i < rows; ++i) {
1126 memset(buf, 0, SIZ);
1127 extract_token(buf, listing, i, '\n', sizeof buf);
1128 memcpy(&sortbuf[i * SIZ], buf, (size_t) SIZ);
1131 /* Sort by idle time */
1132 qsort(sortbuf, rows, SIZ, idlecmp);
1134 /* Combine multiple sessions for the same user */
1136 qsort(sortbuf, rows, SIZ, rwho_username_cmp);
1138 for (i = 1; i < rows; ++i)
1140 char u1[USERNAME_SIZE];
1141 char u2[USERNAME_SIZE];
1142 extract_token(u1, &sortbuf[(i - 1) * SIZ], 1, '|', sizeof u1);
1143 extract_token(u2, &sortbuf[i * SIZ], 1, '|', sizeof u2);
1144 if (!strcasecmp(u1, u2)) {
1145 memcpy(&sortbuf[i * SIZ], &sortbuf[(i + 1) * SIZ], (rows - i - 1) * SIZ);
1151 qsort(sortbuf, rows, SIZ, idlecmp); /* idle sort again */
1154 /* Copy back to a \n delimited list */
1156 for (i = 0; i < rows; ++i) {
1157 if (!IsEmptyStr(&sortbuf[i * SIZ])) {
1158 strcat(retbuf, &sortbuf[i * SIZ]);
1160 strcat(retbuf, "\n");
1170 * Display list of users currently logged on to the server
1172 void who_is_online(CtdlIPC * ipc, int longlist) {
1173 char buf[SIZ], username[SIZ], roomname[SIZ], fromhost[SIZ];
1175 char actual_user[SIZ], actual_room[SIZ], actual_host[SIZ];
1176 char clientsoft[SIZ];
1178 time_t idletime, idlehours, idlemins, idlesecs;
1179 int last_session = (-1);
1181 char *listing = NULL;
1182 int r; /* IPC response code */
1184 if (longlist == 2) {
1190 color(BRIGHT_WHITE);
1191 scr_printf(" User Name Room ");
1192 if (screenwidth >= 80)
1193 scr_printf(" Idle From host");
1196 scr_printf(" ------------------------- --------------------");
1197 if (screenwidth >= 80)
1198 scr_printf(" ---- ------------------------");
1201 r = CtdlIPCOnlineUsers(ipc, &listing, &timenow, buf);
1202 listing = SortOnlineUsers(listing, (!longlist));
1204 while (!IsEmptyStr(listing)) {
1207 /* Get another line */
1208 extract_token(buf, listing, 0, '\n', sizeof buf);
1209 remove_token(listing, 0, '\n');
1211 extract_token(username, buf, 1, '|', sizeof username);
1212 extract_token(roomname, buf, 2, '|', sizeof roomname);
1213 extract_token(fromhost, buf, 3, '|', sizeof fromhost);
1214 extract_token(clientsoft, buf, 4, '|', sizeof clientsoft);
1215 extract_token(flags, buf, 7, '|', sizeof flags);
1217 idletime = timenow - extract_long(buf, 5);
1218 idlehours = idletime / 3600;
1219 idlemins = (idletime - (idlehours * 3600)) / 60;
1220 idlesecs = (idletime - (idlehours * 3600) - (idlemins * 60));
1222 if (idletime > rc_idle_threshold) {
1229 extract_token(actual_user, buf, 8, '|', sizeof actual_user);
1230 extract_token(actual_room, buf, 9, '|', sizeof actual_room);
1231 extract_token(actual_host, buf, 10, '|', sizeof actual_host);
1233 scr_printf(" Flags: %s\n", flags);
1234 scr_printf("Session: %d\n", extract_int(buf, 0));
1235 scr_printf(" Name: %s\n", username);
1236 scr_printf("In room: %s\n", roomname);
1237 scr_printf(" Host: %s\n", fromhost);
1238 scr_printf(" Client: %s\n", clientsoft);
1239 scr_printf(" Idle: %ld:%02ld:%02ld\n", (long) idlehours, (long) idlemins, (long) idlesecs);
1241 if ((!IsEmptyStr(actual_user) && !IsEmptyStr(actual_room) && !IsEmptyStr(actual_host))) {
1242 scr_printf("(really ");
1243 if (!IsEmptyStr(actual_user))
1244 scr_printf("<%s> ", actual_user);
1245 if (!IsEmptyStr(actual_room))
1246 scr_printf("in <%s> ", actual_room);
1247 if (!IsEmptyStr(actual_host))
1248 scr_printf("from <%s> ", actual_host);
1256 if (extract_int(buf, 0) == last_session) {
1260 color(BRIGHT_MAGENTA);
1261 scr_printf("%-3s", flags);
1263 last_session = extract_int(buf, 0);
1265 scr_printf("%-25s ", username);
1266 color(BRIGHT_MAGENTA);
1268 scr_printf("%-20s", roomname);
1270 if (screenwidth >= 80) {
1272 if (idletime > rc_idle_threshold) {
1273 /* over 1000d, must be gone fishing */
1274 if (idlehours > 23999) {
1278 else if (idlehours > 239) {
1279 scr_printf("%3ldd", idlehours / 24);
1282 else if (idlehours > 9) {
1283 scr_printf("%1ldd%02ld", idlehours / 24, idlehours % 24);
1284 /* less than 10 hours */
1287 scr_printf("%1ld:%02ld", idlehours, idlemins);
1295 fromhost[24] = '\0';
1296 scr_printf("%-24s", fromhost);
1308 void enternew(CtdlIPC * ipc, char *desc, char *buf, int maxlen) {
1310 snprintf(bbb, sizeof bbb, "Enter in your new %s: ", desc);
1311 newprompt(bbb, buf, maxlen);
1315 int shift(int argc, char **argv, int start, int count) {
1318 for (i = start; i < (argc - count); ++i) {
1319 argv[i] = argv[i + count];
1321 argc = argc - count;
1326 static void statusHook(char *s) {
1334 int main(int argc, char **argv) {
1336 char aaa[100], bbb[100]; /* general purpose variables */
1337 char argbuf[64]; /* command line buf */
1338 char *telnet_client_host = NULL;
1339 char *sptr, *sptr2; /* USed to extract the nonce */
1341 struct ctdlipcmisc chek;
1342 struct ctdluser *myself = NULL;
1343 CtdlIPC *ipc; /* Our server connection */
1344 int r; /* IPC result code */
1345 int rv = 0; /* fetch but ignore syscall return value to suppress warnings */
1349 char relhome[PATH_MAX] = "";
1350 char ctdldir[PATH_MAX] = CTDLDIR;
1352 calc_dirs_n_files(relh, home, relhome, ctdldir, 0);
1354 #ifdef HAVE_BACKTRACE
1355 bzero(¶ms, sizeof(params));
1356 params.debugLevel = ECRASH_DEBUG_VERBOSE;
1357 params.dumpAllThreads = TRUE;
1358 params.useBacktraceSymbols = 1;
1359 params.signals[0] = SIGSEGV;
1360 params.signals[1] = SIGILL;
1361 params.signals[2] = SIGBUS;
1362 params.signals[3] = SIGABRT;
1364 setIPCErrorPrintf(scr_printf);
1365 setCryptoStatusHook(statusHook);
1367 stty_ctdl(SB_SAVE); /* Store the old terminal parameters */
1368 load_command_set(); /* parse the citadel.rc file */
1369 stty_ctdl(SB_NO_INTR); /* Install the new ones */
1370 signal(SIGPIPE, dropcarr); /* Cleanup gracefully if local conn. dropped */
1371 signal(SIGTERM, dropcarr); /* Cleanup gracefully if terminated */
1372 signal(SIGCONT, catch_sigcont); /* Catch SIGCONT so we can reset terminal */
1374 signal(SIGWINCH, scr_winch); /* Window resize signal */
1378 arg_encrypt = RC_DEFAULT;
1381 // Handle command line options as if we were called like /bin/login (i.e. from in.telnetd)
1382 for (a = 0; a < argc; ++a) {
1383 if ((argc > a + 1) && (!strcmp(argv[a], "-h"))) {
1384 telnet_client_host = argv[a + 1];
1385 argc = shift(argc, argv, a, 2);
1387 if (!strcmp(argv[a], "-x")) {
1389 arg_encrypt = RC_NO;
1391 argc = shift(argc, argv, a, 1);
1393 if (!strcmp(argv[a], "-X")) {
1395 arg_encrypt = RC_YES;
1396 argc = shift(argc, argv, a, 1);
1398 fprintf(stderr, "Not compiled with encryption support");
1402 if (!strcmp(argv[a], "-p")) {
1403 // ignore this argument when called from telnetd
1404 argc = shift(argc, argv, a, 1);
1409 /* Get screen dimensions. First we go to a default of 80x24.
1410 * Then attempt to read the actual screen size from the terminal.
1412 check_screen_dims();
1414 scr_printf("Attaching to server...\n");
1415 ipc = CtdlIPC_new(argc, argv, hostbuf, portbuf);
1417 error_printf("Can't connect: %s\n", strerror(errno));
1421 CtdlIPC_SetNetworkStatusCallback(ipc, scr_wait_indicator);
1423 if (!(ipc->isLocal)) {
1424 scr_printf("Connected to %s [%s].\n", ipc->ip_hostname, ipc->ip_address);
1427 ipc_for_signal_handlers = ipc; /* KLUDGE cover your eyes */
1429 CtdlIPC_chat_recv(ipc, aaa);
1430 if (aaa[0] != '2') {
1431 scr_printf("%s\n", &aaa[4]);
1432 logoff(ipc, atoi(aaa));
1435 #ifdef HAVE_OPENSSLLLLLL
1436 /* Evaluate encryption preferences */
1437 if (arg_encrypt != RC_NO && rc_encrypt != RC_NO) {
1438 if (!ipc->isLocal || arg_encrypt == RC_YES || rc_encrypt == RC_YES) {
1439 secure = (CtdlIPCStartEncryption(ipc, aaa) / 100 == 2) ? 1 : 0;
1441 error_printf("Can't encrypt: %s\n", aaa);
1446 get_serv_info(ipc, telnet_client_host);
1447 scr_printf("%-24s\n%s\n%s\n", ipc->ServInfo.software, ipc->ServInfo.humannode, ipc->ServInfo.site_location);
1449 scr_printf(" pause next stop\n");
1450 scr_printf(" ctrl-s ctrl-o ctrl-c\n\n");
1451 formout(ipc, "hello"); /* print the opening greeting */
1454 GSTA: /* See if we have a username and password on disk */
1455 if (rc_remember_passwords) {
1456 get_stored_password(hostbuf, portbuf, fullname, password);
1457 if (!IsEmptyStr(fullname)) {
1458 r = CtdlIPCTryLogin(ipc, fullname, aaa);
1460 r = CtdlIPCTryPassword(ipc, password, aaa);
1463 load_user_info(aaa);
1467 set_stored_password(hostbuf, portbuf, "", "");
1475 if (!IsEmptyStr(rc_username)) {
1476 strcpy(fullname, rc_username);
1479 newprompt("Enter your name: ", fullname, 29);
1482 if (!strcasecmp(fullname, "new")) { /* just in case */
1483 scr_printf("Please enter the name you wish to log in with.\n");
1485 } while ((!strcasecmp(fullname, "bbs"))
1486 || (!strcasecmp(fullname, "new"))
1487 || (IsEmptyStr(fullname)));
1489 if (!strcasecmp(fullname, "off")) {
1494 /* FIXME this is a stupid way to do guest mode but it's a reasonable test harness FIXME */
1495 if ((ipc->ServInfo.guest_logins) && (!strcasecmp(fullname, "guest"))) {
1499 /* sign on to the server */
1500 r = CtdlIPCTryLogin(ipc, fullname, aaa);
1504 /* password authentication */
1505 if (!IsEmptyStr(rc_password)) {
1506 strcpy(password, rc_password);
1509 newprompt("\rPlease enter your password: ", password, -(SIZ - 1));
1512 r = CtdlIPCTryPassword(ipc, password, aaa);
1515 r = CtdlIPCTryPassword(ipc, password, aaa);
1519 load_user_info(aaa);
1520 offer_to_remember_password(ipc, hostbuf, portbuf, fullname, password);
1523 scr_printf("<< wrong password >>\n");
1524 if (!IsEmptyStr(rc_password))
1528 NEWUSR:if (IsEmptyStr(rc_password)) {
1529 scr_printf("'%s' not found.\n", fullname);
1530 scr_printf("Type 'off' if you would like to exit.\n");
1531 if (ipc->ServInfo.newuser_disabled == 1) {
1534 scr_printf("Do you want to create a new user account called '%s'? ", fullname);
1540 r = CtdlIPCCreateUser(ipc, fullname, 1, aaa);
1542 scr_printf("%s\n", aaa);
1545 load_user_info(aaa);
1547 while (set_password(ipc) != 0);
1550 enter_config(ipc, 1);
1553 /* Switch color support on or off if we're in user mode */
1554 if (rc_ansi_color == 3) {
1555 if (userflags & US_COLOR)
1561 color(BRIGHT_WHITE);
1562 scr_printf("\n%s\nAccess level: %d (%s)\n"
1563 "User #%ld / Login #%d", fullname, axlevel, axdefs[(int) axlevel], usernum, timescalled);
1564 if (lastcall > 0L) {
1565 scr_printf(" / Last login: %s", asctime(localtime(&lastcall)));
1569 r = CtdlIPCMiscCheck(ipc, &chek, aaa);
1575 scr_printf("*** You have a new private message in Mail>\n");
1577 scr_printf("*** You have %d new private messages in Mail>\n", b);
1579 if (!IsEmptyStr(rc_gotmail_cmd)) {
1580 rv = system(rc_gotmail_cmd);
1582 scr_printf("*** failed to check for mail calling %s Reason %d.\n", rc_gotmail_cmd, rv);
1586 if ((axlevel >= AxAideU) && (chek.needvalid > 0)) {
1587 scr_printf("*** Users need validation\n");
1589 if (chek.needregis > 0) {
1590 scr_printf("*** Please register.\n");
1591 formout(ipc, "register");
1595 /* Make up some temporary filenames for use in various parts of the
1596 * program. Don't mess with these once they've been set, because we
1597 * will be unlinking them later on in the program and we don't
1598 * want to delete something that we didn't create. */
1599 CtdlMakeTempFileName(temp, sizeof temp);
1600 CtdlMakeTempFileName(temp2, sizeof temp2);
1601 CtdlMakeTempFileName(tempdir, sizeof tempdir);
1603 r = CtdlIPCGetConfig(ipc, &myself, aaa);
1604 set_floor_mode(ipc);
1606 /* Enter the lobby */
1607 dotgoto(ipc, "_BASEROOM_", 1, 0);
1609 /* Main loop for the system... user is logged in. */
1614 readmsgs(ipc, LastMessages, ReadForward, 5);
1616 readmsgs(ipc, NewMessages, ReadForward, 0);
1618 /* MAIN COMMAND LOOP */
1620 mcmd = getcmd(ipc, argbuf); /* Get keyboard command */
1623 check_screen_dims(); /* get screen size */
1629 display_help(ipc, "help");
1632 entmsg(ipc, 0, ((userflags & US_EXTEDIT) ? 2 : 0), 0);
1635 entmsg(ipc, 0, 1, 0);
1638 entmsg(ipc, 0, 2, 0);
1641 entmsg(ipc, 0, ((userflags & US_EXTEDIT) ? 2 : 0), 1);
1643 case 5: /* <G>oto */
1647 case 47: /* <A>bandon */
1650 case 90: /* <.A>bandon */
1651 dotgoto(ipc, argbuf, 0, 0);
1653 case 58: /* <M>ail */
1655 dotgoto(ipc, "_MAIL_", 1, 0);
1658 if (!IsEmptyStr(argbuf)) {
1660 dotgoto(ipc, argbuf, 0, 0);
1664 if (!IsEmptyStr(argbuf)) {
1665 dotgoto(ipc, argbuf, 0, 0);
1668 case 95: /* what exactly is the numbering scheme supposed to be anyway? --Ford, there isn't one. -IO */
1669 dotungoto(ipc, argbuf);
1672 readmsgs(ipc, AllMessages, ReadForward, 0);
1675 readmsgs(ipc, LastMessages, ReadForward, 5);
1678 readmsgs(ipc, NewMessages, ReadForward, 0);
1681 readmsgs(ipc, AllMessages, ReadReverse, 0);
1684 readmsgs(ipc, OldMessages, ReadReverse, 0);
1687 readmsgs(ipc, LastMessages, ReadForward, atoi(argbuf));
1703 userlist(ipc, argbuf);
1771 cli_image_upload(ipc, "_userpic_");
1774 cli_image_upload(ipc, "_roompic_");
1781 if (argbuf[0] == 0) {
1782 strcpy(argbuf, "?");
1784 display_help(ipc, argbuf);
1788 formout(ipc, "register");
1793 scr_printf("Are you sure (y/n)? ");
1802 scr_printf("All users will be disconnected! " "Really terminate the server? ");
1805 r = CtdlIPCTerminateServerNow(ipc, aaa);
1806 scr_printf("%s\n", aaa);
1815 scr_printf("Do you really want to schedule a " "server shutdown? ");
1817 r = CtdlIPCTerminateServerScheduled(ipc, 1, aaa);
1821 ("The Citadel server will terminate when all users are logged off.\n");
1824 scr_printf("The Citadel server will not terminate.\n");
1831 network_config_management(ipc, "listrecp", "Message-by-message mailing list recipients");
1835 network_config_management(ipc, "digestrecp", "Digest mailing list recipients");
1847 who_is_online(ipc, 0);
1851 who_is_online(ipc, 1);
1855 who_is_online(ipc, 2);
1859 do_system_configuration(ipc);
1863 do_internet_configuration(ipc);
1875 enter_config(ipc, 2);
1879 enter_config(ipc, 0);
1880 set_floor_mode(ipc);
1884 enter_config(ipc, 3);
1885 set_floor_mode(ipc);
1889 gotofloor(ipc, argbuf, GF_GOTO);
1893 gotofloor(ipc, argbuf, GF_SKIP);
1897 forget_this_floor(ipc);
1929 knrooms(ipc, floor_mode);
1939 misc_server_cmd(ipc, argbuf);
1943 edit_system_message(ipc, argbuf);
1963 case 110: /* <+> Next room */
1964 gotoroomstep(ipc, 1, 0);
1967 case 111: /* <-> Previous room */
1968 gotoroomstep(ipc, 0, 0);
1971 case 112: /* <>> Next floor */
1972 gotofloorstep(ipc, 1, GF_GOTO);
1975 case 113: /* <<> Previous floor */
1976 gotofloorstep(ipc, 0, GF_GOTO);
1979 case 116: /* <.> skip to <+> Next room */
1980 gotoroomstep(ipc, 1, 1);
1983 case 117: /* <.> skip to <-> Previous room */
1984 gotoroomstep(ipc, 0, 1);
1987 case 118: /* <.> skip to <>> Next floor */
1988 gotofloorstep(ipc, 1, GF_SKIP);
1991 case 119: /* <.> skip to <<> Previous floor */
1992 gotofloorstep(ipc, 0, GF_SKIP);
2003 case 120: /* .KAnonymous */
2004 dotknown(ipc, 0, NULL);
2007 case 121: /* .KDirectory */
2008 dotknown(ipc, 1, NULL);
2011 case 122: /* .KMatch */
2012 dotknown(ipc, 2, argbuf);
2015 case 123: /* .KpreferredOnly */
2016 dotknown(ipc, 3, NULL);
2019 case 124: /* .KPrivate */
2020 dotknown(ipc, 4, NULL);
2023 case 125: /* .KRead only */
2024 dotknown(ipc, 5, NULL);
2027 case 127: /* Configure POP3 aggregation */
2028 do_pop3client_configuration(ipc);
2031 case 128: /* Configure XML/RSS feed retrieval */
2032 do_rssclient_configuration(ipc);
2038 } while (termn8 == 0);
2040 TERMN8:scr_printf("%s logged out.", fullname);
2042 color(ORIGINAL_PAIR);
2044 while (marchptr != NULL) {
2045 remove_march(marchptr->march_name, 0);
2048 scr_printf("\n\nType 'off' to disconnect, or next user...\n");
2051 if ((mcmd == 29) || (mcmd == 15)) {
2052 stty_ctdl(SB_RESTORE);
2053 formout(ipc, "goodbye");
2056 /* Free the ungoto list */
2057 for (lp = 0; lp < uglistsize; lp++) {