efcaed9e48b3a84f25c621fdad02678815808984
[citadel.git] / citadel / citserver.c
1 /* 
2  * $Id$
3  *
4  * Main source module for the Citadel server
5  *
6  */
7
8 #include "sysdep.h"
9 #include <stdlib.h>
10 #include <unistd.h>
11 #include <stdio.h>
12 #include <fcntl.h>
13 #include <signal.h>
14 #include <sys/types.h>
15 #include <sys/stat.h>
16
17
18 #if TIME_WITH_SYS_TIME
19 # include <sys/time.h>
20 # include <time.h>
21 #else
22 # if HAVE_SYS_TIME_H
23 #  include <sys/time.h>
24 # else
25 #  include <time.h>
26 # endif
27 #endif
28
29 #if HAVE_BACKTRACE
30 #include <execinfo.h>
31 #endif
32
33 #include <ctype.h>
34 #include <string.h>
35 #include <dirent.h>
36 #include <errno.h>
37 #include <limits.h>
38 #include <netdb.h>
39 #include <sys/types.h>
40 #include <sys/socket.h>
41 #include <netinet/in.h>
42 #include <arpa/inet.h>
43 #include <libcitadel.h>
44 #include "citadel.h"
45 #include "server.h"
46 #include "sysdep_decls.h"
47 #include "threads.h"
48 #include "citserver.h"
49 #include "config.h"
50 #include "database.h"
51 #include "housekeeping.h"
52 #include "user_ops.h"
53 #include "msgbase.h"
54 #include "support.h"
55 #include "locate_host.h"
56 #include "room_ops.h"
57 #include "file_ops.h"
58 #include "policy.h"
59 #include "control.h"
60 #include "euidindex.h"
61
62 #ifndef HAVE_SNPRINTF
63 #include "snprintf.h"
64 #endif
65
66 #include "ctdl_module.h"
67
68
69 struct CitContext *ContextList = NULL;
70 struct CitContext* next_session = NULL;
71 char *unique_session_numbers;
72 int ScheduledShutdown = 0;
73 time_t server_startup_time;
74 int panic_fd;
75
76 /**
77  * \brief print the actual stack frame.
78  */
79 void cit_backtrace(void)
80 {
81 #ifdef HAVE_BACKTRACE
82         void *stack_frames[50];
83         size_t size, i;
84         char **strings;
85
86
87         size = backtrace(stack_frames, sizeof(stack_frames) / sizeof(void*));
88         strings = backtrace_symbols(stack_frames, size);
89         for (i = 0; i < size; i++) {
90                 if (strings != NULL)
91                         lprintf(1, "%s\n", strings[i]);
92                 else
93                         lprintf(1, "%p\n", stack_frames[i]);
94         }
95         free(strings);
96 #endif
97 }
98
99 /**
100  * \brief print the actual stack frame.
101  */
102 void cit_panic_backtrace(int SigNum)
103 {
104 #ifdef HAVE_BACKTRACE
105         void *stack_frames[10];
106         size_t size, i;
107         char **strings;
108
109         printf("caught signal 11\n");
110         size = backtrace(stack_frames, sizeof(stack_frames) / sizeof(void*));
111         strings = backtrace_symbols(stack_frames, size);
112         for (i = 0; i < size; i++) {
113                 if (strings != NULL)
114                         lprintf(1, "%s\n", strings[i]);
115                 else
116                         lprintf(1, "%p\n", stack_frames[i]);
117         }
118         free(strings);
119 #endif
120         exit(-1);
121 }
122
123 /*
124  * Various things that need to be initialized at startup
125  */
126 void master_startup(void) {
127         struct timeval tv;
128         unsigned int seed;
129         FILE *urandom;
130         struct ctdlroom qrbuf;
131         
132         lprintf(CTDL_DEBUG, "master_startup() started\n");
133         time(&server_startup_time);
134
135         lprintf(CTDL_INFO, "Opening databases\n");
136         open_databases();
137
138         ctdl_thread_internal_init_tsd();
139         
140         CtdlThreadAllocTSD();
141         
142         check_ref_counts();
143
144         lprintf(CTDL_INFO, "Creating base rooms (if necessary)\n");
145         create_room(config.c_baseroom,  0, "", 0, 1, 0, VIEW_BBS);
146         create_room(AIDEROOM,           3, "", 0, 1, 0, VIEW_BBS);
147         create_room(SYSCONFIGROOM,      3, "", 0, 1, 0, VIEW_BBS);
148         create_room(config.c_twitroom,  0, "", 0, 1, 0, VIEW_BBS);
149
150         /* The "Local System Configuration" room doesn't need to be visible */
151         if (lgetroom(&qrbuf, SYSCONFIGROOM) == 0) {
152                 qrbuf.QRflags2 |= QR2_SYSTEM;
153                 lputroom(&qrbuf);
154         }
155
156         /* Aide needs to be public postable, else we're not RFC conformant. */
157         if (lgetroom(&qrbuf, AIDEROOM) == 0) {
158                 qrbuf.QRflags2 |= QR2_SMTP_PUBLIC;
159                 lputroom(&qrbuf);
160         }
161
162         lprintf(CTDL_INFO, "Seeding the pseudo-random number generator...\n");
163         urandom = fopen("/dev/urandom", "r");
164         if (urandom != NULL) {
165                 fread(&seed, sizeof seed, 1, urandom);
166                 fclose(urandom);
167         }
168         else {
169                 gettimeofday(&tv, NULL);
170                 seed = tv.tv_usec;
171         }
172         srandom(seed);
173
174         lprintf(CTDL_INFO, "Initializing ipgm secret\n");
175         get_config();
176         config.c_ipgm_secret = rand();
177         put_config();
178
179         lprintf(CTDL_DEBUG, "master_startup() finished\n");
180 }
181
182
183 /*
184  * Cleanup routine to be called when the server is shutting down.
185  */
186 void master_cleanup(int exitcode) {
187         struct CleanupFunctionHook *fcn;
188         static int already_cleaning_up = 0;
189
190         if (already_cleaning_up) while(1) sleep(1);
191         already_cleaning_up = 1;
192
193         /* Run any cleanup routines registered by loadable modules */
194         for (fcn = CleanupHookTable; fcn != NULL; fcn = fcn->next) {
195                 (*fcn->h_function_pointer)();
196         }
197
198         /* Close the AdjRefCount queue file */
199         AdjRefCount(-1, 0);
200
201         /* Do system-dependent stuff */
202         sysdep_master_cleanup();
203         
204         /* Close databases */
205         lprintf(CTDL_INFO, "Closing databases\n");
206         close_databases();
207
208 #ifdef DEBUG_MEMORY_LEAKS
209         dump_heap();
210 #endif
211
212         /* If the operator requested a halt but not an exit, halt here. */
213         if (shutdown_and_halt) {
214                 lprintf(CTDL_NOTICE, "citserver: Halting server without exiting.\n");
215                 fflush(stdout); fflush(stderr);
216                 while(1) {
217                         sleep(32767);
218                 }
219         }
220         
221         release_control();
222
223         /* Now go away. */
224         lprintf(CTDL_NOTICE, "citserver: Exiting with status %d\n", exitcode);
225         fflush(stdout); fflush(stderr);
226         
227         if (restart_server != 0)
228                 exit(1);
229         exit(exitcode);
230 }
231
232
233
234 /*
235  * Terminate a session.
236  */
237 void RemoveContext (struct CitContext *con)
238 {
239         if (con==NULL) {
240                 lprintf(CTDL_ERR,
241                         "WARNING: RemoveContext() called with NULL!\n");
242                 return;
243         }
244         lprintf(CTDL_DEBUG, "RemoveContext() session %d\n", con->cs_pid);
245
246         /* Run any cleanup routines registered by loadable modules.
247          * Note: We have to "become_session()" because the cleanup functions
248          *       might make references to "CC" assuming it's the right one.
249          */
250         become_session(con);
251         PerformSessionHooks(EVT_STOP);
252         become_session(NULL);
253
254         /* Now handle all of the administrivia. */
255         lprintf(CTDL_DEBUG, "Calling logout(%d)\n", con->cs_pid);
256         logout(con);
257
258         lprintf(CTDL_NOTICE, "[%3d] Session ended.\n", con->cs_pid);
259
260         /* If the client is still connected, blow 'em away. */
261         lprintf(CTDL_DEBUG, "Closing socket %d\n", con->client_socket);
262         close(con->client_socket);
263
264         lprintf(CTDL_DEBUG, "Done with RemoveContext()\n");
265 }
266
267
268
269
270
271 /*
272  * cmd_info()  -  tell the client about this server
273  */
274 void cmd_info(void) {
275         cprintf("%d Server info:\n", LISTING_FOLLOWS);
276         cprintf("%d\n", CC->cs_pid);
277         cprintf("%s\n", config.c_nodename);
278         cprintf("%s\n", config.c_humannode);
279         cprintf("%s\n", config.c_fqdn);
280         cprintf("%s\n", CITADEL);
281         cprintf("%d\n", REV_LEVEL);
282         cprintf("%s\n", config.c_site_location);
283         cprintf("%s\n", config.c_sysadm);
284         cprintf("%d\n", SERVER_TYPE);
285         cprintf("%s\n", config.c_moreprompt);
286         cprintf("1\n"); /* 1 = yes, this system supports floors */
287         cprintf("1\n"); /* 1 = we support the extended paging options */
288         cprintf("%s\n", CC->cs_nonce);
289         cprintf("1\n"); /* 1 = yes, this system supports the QNOP command */
290
291 #ifdef HAVE_LDAP
292         cprintf("1\n"); /* 1 = yes, this server is LDAP-enabled */
293 #else
294         cprintf("0\n"); /* 1 = no, this server is not LDAP-enabled */
295 #endif
296
297         if (config.c_auth_mode == AUTHMODE_NATIVE) {
298                 cprintf("%d\n", config.c_disable_newu);
299         }
300         else {
301                 cprintf("1\n"); /* "create new user" does not work with non-native auth modes */
302         }
303
304         cprintf("%s\n", config.c_default_cal_zone);
305
306         /* Output load averages */
307         cprintf("%f\n", CtdlThreadLoadAvg);
308         cprintf("%f\n", CtdlThreadWorkerAvg);
309         cprintf("%d\n", CtdlThreadGetCount());
310
311         /* Does this server support Sieve mail filtering? */
312 #ifdef HAVE_LIBSIEVE
313         cprintf("1\n");         /* yes */
314 #else
315         cprintf("0\n");         /* no */
316 #endif
317
318         cprintf("%d\n", config.c_enable_fulltext);
319         
320         cprintf("000\n");
321 }
322
323
324 /*
325  * returns an asterisk if there are any instant messages waiting,
326  * space otherwise.
327  */
328 char CtdlCheckExpress(void) {
329         if (CC->FirstExpressMessage == NULL) {
330                 return(' ');
331         }
332         else {
333                 return('*');
334         }
335 }
336
337 void cmd_time(void)
338 {
339    time_t tv;
340    struct tm tmp;
341    
342    tv = time(NULL);
343    localtime_r(&tv, &tmp);
344    
345    /* timezone and daylight global variables are not portable. */
346 #ifdef HAVE_STRUCT_TM_TM_GMTOFF
347    cprintf("%d %ld|%ld|%d\n", CIT_OK, (long)tv, tmp.tm_gmtoff, tmp.tm_isdst);
348 #else
349    cprintf("%d %ld|%ld|%d\n", CIT_OK, (long)tv, timezone, tmp.tm_isdst);
350 #endif
351 }
352
353
354 /*
355  * Check originating host against the public_clients file.  This determines
356  * whether the client is allowed to change the hostname for this session
357  * (for example, to show the location of the user rather than the location
358  * of the client).
359  */
360 int is_public_client(void)
361 {
362         char buf[1024];
363         char addrbuf[1024];
364         FILE *fp;
365         int i;
366         char *public_clientspos;
367         char *public_clientsend;
368         char *paddr = NULL;
369         struct stat statbuf;
370         static time_t pc_timestamp = 0;
371         static char public_clients[SIZ];
372         static char public_clients_file[SIZ];
373
374 #define LOCALHOSTSTR "127.0.0.1"
375
376         snprintf(public_clients_file, 
377                          sizeof public_clients_file,
378                          "%s/public_clients",
379                          ctdl_etc_dir);
380
381         /*
382          * Check the time stamp on the public_clients file.  If it's been
383          * updated since the last time we were here (or if this is the first
384          * time we've been through the loop), read its contents and learn
385          * the IP addresses of the listed hosts.
386          */
387         if (stat(public_clients_file, &statbuf) != 0) {
388                 /* No public_clients file exists, so bail out */
389                 lprintf(CTDL_WARNING, "Warning: '%s' does not exist\n", 
390                                 public_clients_file);
391                 return(0);
392         }
393
394         if (statbuf.st_mtime > pc_timestamp) {
395                 begin_critical_section(S_PUBLIC_CLIENTS);
396                 lprintf(CTDL_INFO, "Loading %s\n", public_clients_file);
397
398                 public_clientspos = &public_clients[0];
399                 public_clientsend = public_clientspos + SIZ;
400                 safestrncpy(public_clientspos, LOCALHOSTSTR, sizeof public_clients);
401                 public_clientspos += sizeof(LOCALHOSTSTR) - 1;
402                 
403                 if (hostname_to_dotted_quad(addrbuf, config.c_fqdn) == 0) {
404                         *(public_clientspos++) = '|';
405                         paddr = &addrbuf[0];
406                         while (!IsEmptyStr (paddr) && 
407                                (public_clientspos < public_clientsend))
408                                 *(public_clientspos++) = *(paddr++);
409                 }
410
411                 fp = fopen(public_clients_file, "r");
412                 if (fp != NULL) 
413                         while ((fgets(buf, sizeof buf, fp)!=NULL) &&
414                                (public_clientspos < public_clientsend)){
415                                 char *ptr;
416                                 ptr = buf;
417                                 while (!IsEmptyStr(ptr)) {
418                                         if (*ptr == '#') {
419                                                 *ptr = 0;
420                                                 break;
421                                         }
422                                 else ptr++;
423                                 }
424                                 ptr--;
425                                 while (ptr>buf && isspace(*ptr)) {
426                                         *(ptr--) = 0;
427                                 }
428                                 if (hostname_to_dotted_quad(addrbuf, buf) == 0) {
429                                         *(public_clientspos++) = '|';
430                                         paddr = addrbuf;
431                                         while (!IsEmptyStr(paddr) && 
432                                                (public_clientspos < public_clientsend)){
433                                                 *(public_clientspos++) = *(paddr++);
434                                         }
435                                 }
436                         }
437                 fclose(fp);
438                 pc_timestamp = time(NULL);
439                 end_critical_section(S_PUBLIC_CLIENTS);
440         }
441
442         lprintf(CTDL_DEBUG, "Checking whether %s is a local or public client\n",
443                 CC->cs_addr);
444         for (i=0; i<num_parms(public_clients); ++i) {
445                 extract_token(addrbuf, public_clients, i, '|', sizeof addrbuf);
446                 if (!strcasecmp(CC->cs_addr, addrbuf)) {
447                         lprintf(CTDL_DEBUG, "... yes it is.\n");
448                         return(1);
449                 }
450         }
451
452         /* No hits.  This is not a public client. */
453         lprintf(CTDL_DEBUG, "... no it isn't.\n");
454         return(0);
455 }
456
457
458 /*
459  * the client is identifying itself to the server
460  */
461 void cmd_iden(char *argbuf)
462 {
463         int dev_code;
464         int cli_code;
465         int rev_level;
466         char desc[128];
467         char from_host[128];
468         struct in_addr addr;
469         int do_lookup = 0;
470
471         if (num_parms(argbuf)<4) {
472                 cprintf("%d usage error\n", ERROR + ILLEGAL_VALUE);
473                 return;
474         }
475
476         dev_code = extract_int(argbuf,0);
477         cli_code = extract_int(argbuf,1);
478         rev_level = extract_int(argbuf,2);
479         extract_token(desc, argbuf, 3, '|', sizeof desc);
480
481         safestrncpy(from_host, config.c_fqdn, sizeof from_host);
482         from_host[sizeof from_host - 1] = 0;
483         if (num_parms(argbuf)>=5) extract_token(from_host, argbuf, 4, '|', sizeof from_host);
484
485         CC->cs_clientdev = dev_code;
486         CC->cs_clienttyp = cli_code;
487         CC->cs_clientver = rev_level;
488         safestrncpy(CC->cs_clientname, desc, sizeof CC->cs_clientname);
489         CC->cs_clientname[31] = 0;
490
491         if (!IsEmptyStr(from_host)) {
492                 if (CC->is_local_socket) do_lookup = 1;
493                 else if (is_public_client()) do_lookup = 1;
494         }
495
496         if (do_lookup) {
497                 lprintf(CTDL_DEBUG, "Looking up hostname '%s'\n", from_host);
498                 if ((addr.s_addr = inet_addr(from_host)) != -1) {
499                         locate_host(CC->cs_host, sizeof CC->cs_host,
500                                 CC->cs_addr, sizeof CC->cs_addr,
501                                 &addr);
502                 }
503                 else {
504                         safestrncpy(CC->cs_host, from_host, sizeof CC->cs_host);
505                         CC->cs_host[sizeof CC->cs_host - 1] = 0;
506                 }
507         }
508
509         lprintf(CTDL_NOTICE, "Client %d/%d/%01d.%02d (%s) from %s\n",
510                 dev_code,
511                 cli_code,
512                 (rev_level / 100),
513                 (rev_level % 100),
514                 desc,
515                 CC->cs_host);
516         cprintf("%d Ok\n",CIT_OK);
517 }
518
519
520 /*
521  * display system messages or help
522  */
523 void cmd_mesg(char *mname)
524 {
525         FILE *mfp;
526         char targ[256];
527         char buf[256];
528         char buf2[256];
529         char *dirs[2];
530         DIR *dp;
531         struct dirent *d;
532
533         extract_token(buf, mname, 0, '|', sizeof buf);
534
535         dirs[0] = strdup(ctdl_message_dir);
536         dirs[1] = strdup(ctdl_hlp_dir);
537
538         snprintf(buf2, sizeof buf2, "%s.%d.%d",
539                 buf, CC->cs_clientdev, CC->cs_clienttyp);
540
541         /* If the client requested "?" then produce a listing */
542         if (!strcmp(buf, "?")) {
543                 cprintf("%d %s\n", LISTING_FOLLOWS, buf);
544                 dp = opendir(dirs[1]);
545                 if (dp != NULL) {
546                         while (d = readdir(dp), d != NULL) {
547                                 if (d->d_name[0] != '.') {
548                                         cprintf(" %s\n", d->d_name);
549                                 }
550                         }
551                         closedir(dp);
552                 }
553                 cprintf("000\n");
554                 free(dirs[0]);
555                 free(dirs[1]);
556                 return;
557         }
558
559         /* Otherwise, look for the requested file by name. */
560         else {
561                 mesg_locate(targ, sizeof targ, buf2, 2, (const char **)dirs);
562                 if (IsEmptyStr(targ)) {
563                         snprintf(buf2, sizeof buf2, "%s.%d",
564                                                         buf, CC->cs_clientdev);
565                         mesg_locate(targ, sizeof targ, buf2, 2,
566                                                         (const char **)dirs);
567                         if (IsEmptyStr(targ)) {
568                                 mesg_locate(targ, sizeof targ, buf, 2,
569                                                         (const char **)dirs);
570                         }       
571                 }
572         }
573
574         free(dirs[0]);
575         free(dirs[1]);
576
577         if (IsEmptyStr(targ)) {
578                 cprintf("%d '%s' not found.  (Searching in %s and %s)\n",
579                         ERROR + FILE_NOT_FOUND,
580                         mname,
581                         ctdl_message_dir,
582                         ctdl_hlp_dir
583                 );
584                 return;
585         }
586
587         mfp = fopen(targ, "r");
588         if (mfp==NULL) {
589                 cprintf("%d Cannot open '%s': %s\n",
590                         ERROR + INTERNAL_ERROR, targ, strerror(errno));
591                 return;
592         }
593         cprintf("%d %s\n", LISTING_FOLLOWS,buf);
594
595         while (fgets(buf, (sizeof buf - 1), mfp) != NULL) {
596                 buf[strlen(buf)-1] = 0;
597                 do_help_subst(buf);
598                 cprintf("%s\n",buf);
599         }
600
601         fclose(mfp);
602         cprintf("000\n");
603 }
604
605
606 /*
607  * enter system messages or help
608  */
609 void cmd_emsg(char *mname)
610 {
611         FILE *mfp;
612         char targ[256];
613         char buf[256];
614         char *dirs[2];
615         int a;
616
617         unbuffer_output();
618
619         if (CtdlAccessCheck(ac_aide)) return;
620
621         extract_token(buf, mname, 0, '|', sizeof buf);
622         for (a=0; !IsEmptyStr(&buf[a]); ++a) {          /* security measure */
623                 if (buf[a] == '/') buf[a] = '.';
624         }
625
626         dirs[0] = strdup(ctdl_message_dir);
627         dirs[1] = strdup(ctdl_hlp_dir);
628
629         mesg_locate(targ, sizeof targ, buf, 2, (const char**)dirs);
630         free(dirs[0]);
631         free(dirs[1]);
632
633         if (IsEmptyStr(targ)) {
634                 snprintf(targ, sizeof targ, 
635                                  "%s/%s",
636                                  ctdl_hlp_dir, buf);
637         }
638
639         mfp = fopen(targ,"w");
640         if (mfp==NULL) {
641                 cprintf("%d Cannot open '%s': %s\n",
642                         ERROR + INTERNAL_ERROR, targ, strerror(errno));
643                 return;
644         }
645         cprintf("%d %s\n", SEND_LISTING, targ);
646
647         while (client_getln(buf, sizeof buf), strcmp(buf, "000")) {
648                 fprintf(mfp, "%s\n", buf);
649         }
650
651         fclose(mfp);
652 }
653
654
655 /* Don't show the names of private rooms unless the viewing
656  * user also knows the rooms.
657  */
658 void GenerateRoomDisplay(char *real_room,
659                         struct CitContext *viewed,
660                         struct CitContext *viewer) {
661
662         int ra;
663
664         strcpy(real_room, viewed->room.QRname);
665         if (viewed->room.QRflags & QR_MAILBOX) {
666                 strcpy(real_room, &real_room[11]);
667         }
668         if (viewed->room.QRflags & QR_PRIVATE) {
669                 CtdlRoomAccess(&viewed->room, &viewer->user, &ra, NULL);
670                 if ( (ra & UA_KNOWN) == 0) {
671                         strcpy(real_room, "<private room>");
672                 }
673         }
674
675         if (viewed->cs_flags & CS_CHAT) {
676                 while (strlen(real_room) < 14) {
677                         strcat(real_room, " ");
678                 }
679                 strcpy(&real_room[14], "<chat>");
680         }
681
682 }
683
684 /*
685  * Convenience function.
686  */
687 int CtdlAccessCheck(int required_level) {
688
689         if (CC->internal_pgm) return(0);
690         if (required_level >= ac_internal) {
691                 cprintf("%d This is not a user-level command.\n",
692                         ERROR + HIGHER_ACCESS_REQUIRED);
693                 return(-1);
694         }
695
696         if ((required_level >= ac_logged_in) && (CC->logged_in == 0)) {
697                 cprintf("%d Not logged in.\n", ERROR + NOT_LOGGED_IN);
698                 return(-1);
699         }
700
701         if (CC->user.axlevel >= 6) return(0);
702         if (required_level >= ac_aide) {
703                 cprintf("%d This command requires Aide access.\n",
704                         ERROR + HIGHER_ACCESS_REQUIRED);
705                 return(-1);
706         }
707
708         if (is_room_aide()) return(0);
709         if (required_level >= ac_room_aide) {
710                 cprintf("%d This command requires Aide or Room Aide access.\n",
711                         ERROR + HIGHER_ACCESS_REQUIRED);
712                 return(-1);
713         }
714
715         /* shhh ... succeed quietly */
716         return(0);
717 }
718
719
720
721 /*
722  * Terminate another running session
723  */
724 void cmd_term(char *cmdbuf)
725 {
726         int session_num;
727         struct CitContext *ccptr;
728         int found_it = 0;
729         int allowed = 0;
730
731         session_num = extract_int(cmdbuf, 0);
732         if (session_num == CC->cs_pid) {
733                 cprintf("%d You can't kill your own session.\n", ERROR + ILLEGAL_VALUE);
734                 return;
735         }
736
737         lprintf(CTDL_DEBUG, "Locating session to kill\n");
738         begin_critical_section(S_SESSION_TABLE);
739         for (ccptr = ContextList; ccptr != NULL; ccptr = ccptr->next) {
740                 if (session_num == ccptr->cs_pid) {
741                         found_it = 1;
742                         if ((ccptr->user.usernum == CC->user.usernum)
743                            || (CC->user.axlevel >= 6)) {
744                                 allowed = 1;
745                                 ccptr->kill_me = 1;
746                         }
747                         else {
748                                 allowed = 0;
749                         }
750                 }
751         }
752         end_critical_section(S_SESSION_TABLE);
753
754         if (found_it) {
755                 if (allowed) {
756                         cprintf("%d Session terminated.\n", CIT_OK);
757                 }
758                 else {
759                         cprintf("%d You are not allowed to do that.\n",
760                                 ERROR + HIGHER_ACCESS_REQUIRED);
761                 }
762         }
763         else {
764                 cprintf("%d No such session.\n", ERROR + ILLEGAL_VALUE);
765         }
766 }
767
768
769
770
771
772 /* 
773  * get the paginator prompt
774  */
775 void cmd_more(void) {
776         cprintf("%d %s\n", CIT_OK, config.c_moreprompt);
777 }
778
779 /*
780  * echo 
781  */
782 void cmd_echo(char *etext)
783 {
784         cprintf("%d %s\n", CIT_OK, etext);
785 }
786
787
788
789 /* 
790  * identify as internal program
791  */
792 void cmd_ipgm(char *argbuf)
793 {
794         int secret;
795
796         secret = extract_int(argbuf, 0);
797
798         /* For security reasons, we do NOT allow this command to run
799          * over the network.  Local sockets only.
800          */
801         if (!CC->is_local_socket) {
802                 sleep(5);
803                 cprintf("%d Authentication failed.\n",
804                         ERROR + PASSWORD_REQUIRED);
805         }
806         else if (secret == config.c_ipgm_secret) {
807                 CC->internal_pgm = 1;
808                 strcpy(CC->curr_user, "<internal program>");
809                 CC->cs_flags = CC->cs_flags|CS_STEALTH;
810                 cprintf("%d Authenticated as an internal program.\n", CIT_OK);
811         }
812         else {
813                 sleep(5);
814                 cprintf("%d Authentication failed.\n",
815                         ERROR + PASSWORD_REQUIRED);
816                 lprintf(CTDL_ERR, "Warning: ipgm authentication failed.\n");
817                 CC->kill_me = 1;
818         }
819
820         /* Now change the ipgm secret for the next round.
821          * (Disabled because it breaks concurrent scripts.  The fact that
822          * we no longer accept IPGM over the network should be sufficient
823          * to prevent brute-force attacks.  If you don't agree, uncomment
824          * this block.)
825         get_config();
826         config.c_ipgm_secret = rand();
827         put_config();
828         */
829 }
830
831
832 /*
833  * Shut down the server
834  */
835 void cmd_down(char *argbuf) {
836         char *Reply ="%d Shutting down server.  Goodbye.\n";
837
838         if (CtdlAccessCheck(ac_aide)) return;
839
840         if (!IsEmptyStr(argbuf))
841         {
842                 int state = CIT_OK;
843                 restart_server = extract_int(argbuf, 0);
844                 
845                 if (restart_server > 0)
846                         Reply = "%d Restarting server.  See you soon.\n";
847                 if ((restart_server > 0) && !running_as_daemon)
848                 {
849                         lprintf(CTDL_ERR, "The user requested restart, but not running as deamon! Geronimooooooo!\n");
850                         Reply = "%d Warning, not running in deamon mode. maybe we will come up again, but don't lean on it.\n";
851                         state = ERROR;
852                 }
853                 cprintf(Reply, state);
854         }
855         else
856         {
857                 cprintf(Reply, CIT_OK + SERVER_SHUTTING_DOWN);
858         }
859         CtdlThreadStopAll();
860 }
861
862 /*
863  * Halt the server without exiting the server process.
864  */
865 void cmd_halt(void) {
866
867         if (CtdlAccessCheck(ac_aide)) return;
868
869         cprintf("%d Halting server.  Goodbye.\n", CIT_OK);
870         CtdlThreadStopAll();
871         shutdown_and_halt = 1;
872 }
873
874 /*
875  * Schedule or cancel a server shutdown
876  */
877 void cmd_scdn(char *argbuf)
878 {
879         int new_state;
880         int state = CIT_OK;
881         char *Reply = "%d %d\n";
882
883         if (CtdlAccessCheck(ac_aide)) return;
884
885         new_state = extract_int(argbuf, 0);
886         if ((new_state == 2) || (new_state == 3))
887         {
888                 restart_server = 1;
889                 if (!running_as_daemon)
890                 {
891                         lprintf(CTDL_ERR, "The user requested restart, but not running as deamon! Geronimooooooo!\n");
892                         Reply = "%d %d Warning, not running in deamon mode. maybe we will come up again, but don't lean on it.\n";
893                         state = ERROR;
894                 }
895
896                 restart_server = extract_int(argbuf, 0);
897                 new_state -= 2;
898         }
899         if ((new_state == 0) || (new_state == 1)) {
900                 ScheduledShutdown = new_state;
901         }
902         cprintf(Reply, state, ScheduledShutdown);
903 }
904
905
906 /*
907  * Set or unset asynchronous protocol mode
908  */
909 void cmd_asyn(char *argbuf)
910 {
911         int new_state;
912
913         new_state = extract_int(argbuf, 0);
914         if ((new_state == 0) || (new_state == 1)) {
915                 CC->is_async = new_state;
916         }
917         cprintf("%d %d\n", CIT_OK, CC->is_async);
918 }
919
920
921 /*
922  * Generate a "nonce" for APOP-style authentication.
923  *
924  * RFC 1725 et al specify a PID to be placed in front of the nonce.
925  * Quoth BTX: That would be stupid.
926  */
927 void generate_nonce(struct CitContext *con) {
928         struct timeval tv;
929
930         memset(con->cs_nonce, NONCE_SIZE, 0);
931         gettimeofday(&tv, NULL);
932         memset(con->cs_nonce, NONCE_SIZE, 0);
933         snprintf(con->cs_nonce, NONCE_SIZE, "<%d%ld@%s>",
934                 rand(), (long)tv.tv_usec, config.c_fqdn);
935 }
936
937
938
939
940 /*
941  * Back-end function for starting a session
942  */
943 void begin_session(struct CitContext *con)
944 {
945         socklen_t len;
946         struct sockaddr_in sin;
947
948         /* 
949          * Initialize some variables specific to our context.
950          */
951         con->logged_in = 0;
952         con->internal_pgm = 0;
953         con->download_fp = NULL;
954         con->upload_fp = NULL;
955         con->FirstExpressMessage = NULL;
956         time(&con->lastcmd);
957         time(&con->lastidle);
958         strcpy(con->lastcmdname, "    ");
959         strcpy(con->cs_clientname, "(unknown)");
960         strcpy(con->curr_user, NLI);
961         *con->net_node = '\0';
962         *con->fake_username = '\0';
963         *con->fake_hostname = '\0';
964         *con->fake_roomname = '\0';
965         generate_nonce(con);
966         safestrncpy(con->cs_host, config.c_fqdn, sizeof con->cs_host);
967         safestrncpy(con->cs_addr, "", sizeof con->cs_addr);
968         con->cs_host[sizeof con->cs_host - 1] = 0;
969         len = sizeof sin;
970         if (!CC->is_local_socket) {
971                 if (!getpeername(con->client_socket, (struct sockaddr *) &sin, &len)) {
972                         locate_host(con->cs_host, sizeof con->cs_host,
973                                 con->cs_addr, sizeof con->cs_addr,
974                                 &sin.sin_addr
975                         );
976                 }
977         }
978         else {
979                 strcpy(con->cs_host, "");
980         }
981         con->cs_flags = 0;
982         con->upload_type = UPL_FILE;
983         con->dl_is_net = 0;
984
985         con->nologin = 0;
986         if ((config.c_maxsessions > 0)&&(num_sessions > config.c_maxsessions)) {
987                 con->nologin = 1;
988         }
989
990         if (!CC->is_local_socket) {
991                 lprintf(CTDL_NOTICE, "Session started from %s [%s].\n", con->cs_host, con->cs_addr);
992         }
993         else {
994                 lprintf(CTDL_NOTICE, "Session started via local socket.\n");
995         }
996
997         /* Run any session startup routines registered by loadable modules */
998         PerformSessionHooks(EVT_START);
999 }
1000
1001
1002 void citproto_begin_session() {
1003         if (CC->nologin==1) {
1004                 cprintf("%d %s: Too many users are already online (maximum is %d)\n",
1005                         ERROR + MAX_SESSIONS_EXCEEDED,
1006                         config.c_nodename, config.c_maxsessions
1007                 );
1008                 CC->kill_me = 1;
1009         }
1010         else {
1011                 cprintf("%d %s Citadel server ready.\n",
1012                         CIT_OK, config.c_nodename);
1013         }
1014 }
1015
1016
1017
1018
1019 /*
1020  * This loop recognizes all server commands.
1021  */
1022 void do_command_loop(void) {
1023         char cmdbuf[SIZ];
1024         const char *old_name = NULL;
1025         
1026         old_name = CtdlThreadName("do_command_loop");
1027         
1028         time(&CC->lastcmd);
1029         memset(cmdbuf, 0, sizeof cmdbuf); /* Clear it, just in case */
1030         if (client_getln(cmdbuf, sizeof cmdbuf) < 1) {
1031                 lprintf(CTDL_ERR, "Client disconnected: ending session.\n");
1032                 CC->kill_me = 1;
1033                 CtdlThreadName(old_name);
1034                 return;
1035         }
1036
1037         /* Log the server command, but don't show passwords... */
1038         if ( (strncasecmp(cmdbuf, "PASS", 4))
1039            && (strncasecmp(cmdbuf, "SETP", 4)) ) {
1040                 lprintf(CTDL_INFO, "%s\n", cmdbuf);
1041         }
1042         else {
1043                 lprintf(CTDL_INFO, "<password command sent>\n");
1044         }
1045
1046         buffer_output();
1047
1048         /*
1049          * Let other clients see the last command we executed, and
1050          * update the idle time, but not NOOP, QNOP, PEXP, GEXP, RWHO, or TIME.
1051          */
1052         if ( (strncasecmp(cmdbuf, "NOOP", 4))
1053            && (strncasecmp(cmdbuf, "QNOP", 4))
1054            && (strncasecmp(cmdbuf, "PEXP", 4))
1055            && (strncasecmp(cmdbuf, "GEXP", 4))
1056            && (strncasecmp(cmdbuf, "RWHO", 4))
1057            && (strncasecmp(cmdbuf, "TIME", 4)) ) {
1058                 strcpy(CC->lastcmdname, "    ");
1059                 safestrncpy(CC->lastcmdname, cmdbuf, sizeof(CC->lastcmdname));
1060                 time(&CC->lastidle);
1061         }
1062         
1063         CtdlThreadName(cmdbuf);
1064                 
1065         if ((strncasecmp(cmdbuf, "ENT0", 4))
1066            && (strncasecmp(cmdbuf, "MESG", 4))
1067            && (strncasecmp(cmdbuf, "MSGS", 4)))
1068         {
1069            CC->cs_flags &= ~CS_POSTING;
1070         }
1071                    
1072         if (!strncasecmp(cmdbuf, "NOOP", 4)) {
1073                 cprintf("%d%cok\n", CIT_OK, CtdlCheckExpress() );
1074         }
1075         
1076         else if (!strncasecmp(cmdbuf, "XYZZY", 5)) {
1077                 cprintf("%d Nothing happens.\n", CIT_OK);
1078         }
1079         
1080         else if (!strncasecmp(cmdbuf, "QNOP", 4)) {
1081                 /* do nothing, this command returns no response */
1082         }
1083
1084         else if (!strncasecmp(cmdbuf,"QUIT",4)) {
1085                 cprintf("%d Goodbye.\n", CIT_OK);
1086                 CC->kill_me = 1;
1087         }
1088
1089         else if (!strncasecmp(cmdbuf,"ASYN",4)) {
1090                 cmd_asyn(&cmdbuf[5]);
1091         }
1092
1093         else if (!strncasecmp(cmdbuf,"LOUT",4)) {
1094                 if (CC->logged_in) logout(CC);
1095                 cprintf("%d logged out.\n", CIT_OK);
1096         }
1097
1098         else if (!strncasecmp(cmdbuf,"USER",4)) {
1099                 cmd_user(&cmdbuf[5]);
1100         }
1101
1102         else if (!strncasecmp(cmdbuf,"PASS",4)) {
1103                 cmd_pass(&cmdbuf[5]);
1104         }
1105
1106         else if (!strncasecmp(cmdbuf,"NEWU",4)) {
1107                 cmd_newu(&cmdbuf[5]);
1108         }
1109
1110         else if (!strncasecmp(cmdbuf,"CREU",4)) {
1111                 cmd_creu(&cmdbuf[5]);
1112         }
1113
1114         else if (!strncasecmp(cmdbuf,"SETP",4)) {
1115                 cmd_setp(&cmdbuf[5]);
1116         }
1117
1118         else if (!strncasecmp(cmdbuf,"LRMS",4)) {
1119                 cmd_lrms(&cmdbuf[5]);
1120         }
1121
1122         else if (!strncasecmp(cmdbuf,"LKRA",4)) {
1123                 cmd_lkra(&cmdbuf[5]);
1124         }
1125
1126         else if (!strncasecmp(cmdbuf,"LKRN",4)) {
1127                 cmd_lkrn(&cmdbuf[5]);
1128         }
1129
1130         else if (!strncasecmp(cmdbuf,"LKRO",4)) {
1131                 cmd_lkro(&cmdbuf[5]);
1132         }
1133
1134         else if (!strncasecmp(cmdbuf,"LZRM",4)) {
1135                 cmd_lzrm(&cmdbuf[5]);
1136         }
1137
1138         else if (!strncasecmp(cmdbuf,"LPRM",4)) {
1139                 cmd_lprm(&cmdbuf[5]);
1140         }
1141
1142         else if (!strncasecmp(cmdbuf,"GETU",4)) {
1143                 cmd_getu();
1144         }
1145
1146         else if (!strncasecmp(cmdbuf,"SETU",4)) {
1147                 cmd_setu(&cmdbuf[5]);
1148         }
1149
1150         else if (!strncasecmp(cmdbuf,"GOTO",4)) {
1151                 cmd_goto(&cmdbuf[5]);
1152         }
1153
1154         else if (!strncasecmp(cmdbuf,"MSGS",4)) {
1155                 cmd_msgs(&cmdbuf[5]);
1156         }
1157
1158         else if (!strncasecmp(cmdbuf,"WHOK",4)) {
1159                 cmd_whok();
1160         }
1161
1162         else if (!strncasecmp(cmdbuf,"RDIR",4)) {
1163                 cmd_rdir();
1164         }
1165
1166         else if (!strncasecmp(cmdbuf,"EUID",4)) {
1167                 cmd_euid(&cmdbuf[5]);
1168         }
1169
1170         else if (!strncasecmp(cmdbuf,"MSG0",4)) {
1171                 cmd_msg0(&cmdbuf[5]);
1172         }
1173
1174         else if (!strncasecmp(cmdbuf,"MSG2",4)) {
1175                 cmd_msg2(&cmdbuf[5]);
1176         }
1177
1178         else if (!strncasecmp(cmdbuf,"MSG3",4)) {
1179                 cmd_msg3(&cmdbuf[5]);
1180         }
1181
1182         else if (!strncasecmp(cmdbuf,"MSG4",4)) {
1183                 cmd_msg4(&cmdbuf[5]);
1184         }
1185
1186         else if (!strncasecmp(cmdbuf,"MSGP",4)) {
1187                 cmd_msgp(&cmdbuf[5]);
1188         }
1189
1190         else if (!strncasecmp(cmdbuf,"OPNA",4)) {
1191                 cmd_opna(&cmdbuf[5]);
1192         }
1193
1194         else if (!strncasecmp(cmdbuf,"DLAT",4)) {
1195                 cmd_dlat(&cmdbuf[5]);
1196         }
1197
1198         else if (!strncasecmp(cmdbuf,"INFO",4)) {
1199                 cmd_info();
1200         }
1201
1202         else if (!strncasecmp(cmdbuf,"SLRP",4)) {
1203                 cmd_slrp(&cmdbuf[5]);
1204         }
1205
1206         else if (!strncasecmp(cmdbuf,"INVT",4)) {
1207                 cmd_invt_kick(&cmdbuf[5],1);
1208         }
1209
1210         else if (!strncasecmp(cmdbuf,"KICK",4)) {
1211                 cmd_invt_kick(&cmdbuf[5],0);
1212         }
1213
1214         else if (!strncasecmp(cmdbuf,"GETR",4)) {
1215                 cmd_getr();
1216         }
1217
1218         else if (!strncasecmp(cmdbuf,"SETR",4)) {
1219                 cmd_setr(&cmdbuf[5]);
1220         }
1221
1222         else if (!strncasecmp(cmdbuf,"GETA",4)) {
1223                 cmd_geta();
1224         }
1225
1226         else if (!strncasecmp(cmdbuf,"SETA",4)) {
1227                 cmd_seta(&cmdbuf[5]);
1228         }
1229
1230         else if (!strncasecmp(cmdbuf,"ENT0",4)) {
1231                 cmd_ent0(&cmdbuf[5]);
1232         }
1233
1234         else if (!strncasecmp(cmdbuf,"RINF",4)) {
1235                 cmd_rinf();
1236         }
1237
1238         else if (!strncasecmp(cmdbuf,"DELE",4)) {
1239                 cmd_dele(&cmdbuf[5]);
1240         }
1241
1242         else if (!strncasecmp(cmdbuf,"KILL",4)) {
1243                 cmd_kill(&cmdbuf[5]);
1244         }
1245
1246         else if (!strncasecmp(cmdbuf,"CRE8",4)) {
1247                 cmd_cre8(&cmdbuf[5]);
1248         }
1249
1250         else if (!strncasecmp(cmdbuf,"MOVE",4)) {
1251                 cmd_move(&cmdbuf[5]);
1252         }
1253
1254         else if (!strncasecmp(cmdbuf,"FORG",4)) {
1255                 cmd_forg();
1256         }
1257
1258         else if (!strncasecmp(cmdbuf,"MESG",4)) {
1259                 cmd_mesg(&cmdbuf[5]);
1260         }
1261
1262         else if (!strncasecmp(cmdbuf,"EMSG",4)) {
1263                 cmd_emsg(&cmdbuf[5]);
1264         }
1265
1266         else if (!strncasecmp(cmdbuf,"GNUR",4)) {
1267                 cmd_gnur();
1268         }
1269
1270         else if (!strncasecmp(cmdbuf,"VALI",4)) {
1271                 cmd_vali(&cmdbuf[5]);
1272         }
1273
1274         else if (!strncasecmp(cmdbuf,"EINF",4)) {
1275                 cmd_einf(&cmdbuf[5]);
1276         }
1277
1278         else if (!strncasecmp(cmdbuf,"LIST",4)) {
1279                 cmd_list(&cmdbuf[5]);
1280         }
1281
1282         else if (!strncasecmp(cmdbuf,"CHEK",4)) {
1283                 cmd_chek();
1284         }
1285
1286         else if (!strncasecmp(cmdbuf,"DELF",4)) {
1287                 cmd_delf(&cmdbuf[5]);
1288         }
1289
1290         else if (!strncasecmp(cmdbuf,"MOVF",4)) {
1291                 cmd_movf(&cmdbuf[5]);
1292         }
1293
1294         else if (!strncasecmp(cmdbuf,"NETF",4)) {
1295                 cmd_netf(&cmdbuf[5]);
1296         }
1297
1298         else if (!strncasecmp(cmdbuf,"OPEN",4)) {
1299                 cmd_open(&cmdbuf[5]);
1300         }
1301
1302         else if (!strncasecmp(cmdbuf,"CLOS",4)) {
1303                 cmd_clos();
1304         }
1305
1306         else if (!strncasecmp(cmdbuf,"UOPN",4)) {
1307                 cmd_uopn(&cmdbuf[5]);
1308         }
1309
1310         else if (!strncasecmp(cmdbuf,"UCLS",4)) {
1311                 cmd_ucls(&cmdbuf[5]);
1312         }
1313
1314         else if (!strncasecmp(cmdbuf,"READ",4)) {
1315                 cmd_read(&cmdbuf[5]);
1316         }
1317
1318         else if (!strncasecmp(cmdbuf,"WRIT",4)) {
1319                 cmd_writ(&cmdbuf[5]);
1320         }
1321
1322         else if (!strncasecmp(cmdbuf,"QUSR",4)) {
1323                 cmd_qusr(&cmdbuf[5]);
1324         }
1325
1326         else if (!strncasecmp(cmdbuf,"ECHO",4)) {
1327                 cmd_echo(&cmdbuf[5]);
1328         }
1329
1330         else if (!strncasecmp(cmdbuf,"OIMG",4)) {
1331                 cmd_oimg(&cmdbuf[5]);
1332         }
1333
1334         else if (!strncasecmp(cmdbuf,"MORE",4)) {
1335                 cmd_more();
1336         }
1337
1338         else if (!strncasecmp(cmdbuf,"NDOP",4)) {
1339                 cmd_ndop(&cmdbuf[5]);
1340         }
1341
1342         else if (!strncasecmp(cmdbuf,"NUOP",4)) {
1343                 cmd_nuop(&cmdbuf[5]);
1344         }
1345
1346         else if (!strncasecmp(cmdbuf,"LFLR",4)) {
1347                 cmd_lflr();
1348         }
1349
1350         else if (!strncasecmp(cmdbuf,"CFLR",4)) {
1351                 cmd_cflr(&cmdbuf[5]);
1352         }
1353
1354         else if (!strncasecmp(cmdbuf,"KFLR",4)) {
1355                 cmd_kflr(&cmdbuf[5]);
1356         }
1357
1358         else if (!strncasecmp(cmdbuf,"EFLR",4)) {
1359                 cmd_eflr(&cmdbuf[5]);
1360         }
1361
1362         else if (!strncasecmp(cmdbuf,"IDEN",4)) {
1363                 cmd_iden(&cmdbuf[5]);
1364         }
1365
1366         else if (!strncasecmp(cmdbuf,"IPGM",4)) {
1367                 cmd_ipgm(&cmdbuf[5]);
1368         }
1369
1370         else if (!strncasecmp(cmdbuf,"TERM",4)) {
1371                 cmd_term(&cmdbuf[5]);
1372         }
1373
1374         else if (!strncasecmp(cmdbuf,"DOWN",4)) {
1375                 cmd_down(&cmdbuf[5]);
1376         }
1377
1378         else if (!strncasecmp(cmdbuf,"HALT",4)) {
1379                 cmd_halt();
1380         }
1381
1382         else if (!strncasecmp(cmdbuf,"SCDN",4)) {
1383                 cmd_scdn(&cmdbuf[5]);
1384         }
1385
1386         else if (!strncasecmp(cmdbuf, "UIMG", 4)) {
1387                 cmd_uimg(&cmdbuf[5]);
1388         }
1389
1390         else if (!strncasecmp(cmdbuf, "TIME", 4)) {
1391                 cmd_time();
1392         }
1393
1394         else if (!strncasecmp(cmdbuf, "AGUP", 4)) {
1395                 cmd_agup(&cmdbuf[5]);
1396         }
1397
1398         else if (!strncasecmp(cmdbuf, "ASUP", 4)) {
1399                 cmd_asup(&cmdbuf[5]);
1400         }
1401
1402         else if (!strncasecmp(cmdbuf, "GPEX", 4)) {
1403                 cmd_gpex(&cmdbuf[5]);
1404         }
1405
1406         else if (!strncasecmp(cmdbuf, "SPEX", 4)) {
1407                 cmd_spex(&cmdbuf[5]);
1408         }
1409
1410         else if (!strncasecmp(cmdbuf, "CONF", 4)) {
1411                 cmd_conf(&cmdbuf[5]);
1412         }
1413
1414         else if (!strncasecmp(cmdbuf, "SEEN", 4)) {
1415                 cmd_seen(&cmdbuf[5]);
1416         }
1417
1418         else if (!strncasecmp(cmdbuf, "GTSN", 4)) {
1419                 cmd_gtsn(&cmdbuf[5]);
1420         }
1421
1422         else if (!strncasecmp(cmdbuf, "VIEW", 4)) {
1423                 cmd_view(&cmdbuf[5]);
1424         }
1425
1426         else if (!strncasecmp(cmdbuf, "ISME", 4)) {
1427                 cmd_isme(&cmdbuf[5]);
1428         }
1429
1430         else if (!strncasecmp(cmdbuf, "RENU", 4)) {
1431                 cmd_renu(&cmdbuf[5]);
1432         }
1433
1434         else if (!DLoader_Exec_Cmd(cmdbuf)) {
1435                 cprintf("%d Unrecognized or unsupported command.\n", ERROR + CMD_NOT_SUPPORTED);
1436         }
1437
1438         unbuffer_output();
1439
1440         /* Run any after-each-command routines registered by modules */
1441         PerformSessionHooks(EVT_CMD);
1442         CtdlThreadName(old_name);
1443 }
1444
1445
1446 /*
1447  * This loop performs all asynchronous functions.
1448  */
1449 void do_async_loop(void) {
1450         PerformSessionHooks(EVT_ASYNC);
1451 }