2 * Server functions which handle file transfers and room directories.
4 * Copyright (c) 1987-2015 by the citadel.org team
6 * This program is open source software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License version 3.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
16 #include <libcitadel.h>
19 #include "ctdl_module.h"
20 #include "citserver.h"
27 * Server command to delete a file from a room's directory
29 void cmd_delf(char *filename)
34 if (CtdlAccessCheck(ac_room_aide))
37 if ((CC->room.QRflags & QR_DIRECTORY) == 0) {
38 cprintf("%d No directory in this room.\n",
43 if (IsEmptyStr(filename)) {
44 cprintf("%d You must specify a file name.\n",
45 ERROR + FILE_NOT_FOUND);
48 for (a = 0; !IsEmptyStr(&filename[a]); ++a) {
49 if ( (filename[a] == '/') || (filename[a] == '\\') ) {
53 snprintf(pathname, sizeof pathname,
56 CC->room.QRdirname, filename);
59 cprintf("%d File '%s' deleted.\n", CIT_OK, pathname);
62 cprintf("%d File '%s' not found.\n",
63 ERROR + FILE_NOT_FOUND, pathname);
71 * move a file from one room directory to another
73 void cmd_movf(char *cmdbuf)
75 char filename[PATH_MAX];
76 char pathname[PATH_MAX];
77 char newpath[PATH_MAX];
78 char newroom[ROOMNAMELEN];
81 struct ctdlroom qrbuf;
83 extract_token(filename, cmdbuf, 0, '|', sizeof filename);
84 extract_token(newroom, cmdbuf, 1, '|', sizeof newroom);
86 if (CtdlAccessCheck(ac_room_aide)) return;
88 if ((CC->room.QRflags & QR_DIRECTORY) == 0) {
89 cprintf("%d No directory in this room.\n",
94 if (IsEmptyStr(filename)) {
95 cprintf("%d You must specify a file name.\n",
96 ERROR + FILE_NOT_FOUND);
100 for (a = 0; !IsEmptyStr(&filename[a]); ++a) {
101 if ( (filename[a] == '/') || (filename[a] == '\\') ) {
105 snprintf(pathname, sizeof pathname, "./files/%s/%s",
106 CC->room.QRdirname, filename);
107 if (access(pathname, 0) != 0) {
108 cprintf("%d File '%s' not found.\n",
109 ERROR + FILE_NOT_FOUND, pathname);
113 if (CtdlGetRoom(&qrbuf, newroom) != 0) {
114 cprintf("%d '%s' does not exist.\n", ERROR + ROOM_NOT_FOUND, newroom);
117 if ((qrbuf.QRflags & QR_DIRECTORY) == 0) {
118 cprintf("%d '%s' is not a directory room.\n",
119 ERROR + NOT_HERE, qrbuf.QRname);
122 snprintf(newpath, sizeof newpath, "./files/%s/%s", qrbuf.QRdirname,
124 if (link(pathname, newpath) != 0) {
125 cprintf("%d Couldn't move file: %s\n", ERROR + INTERNAL_ERROR,
131 /* this is a crude method of copying the file description */
132 snprintf(buf, sizeof buf,
133 "cat ./files/%s/filedir |grep \"%s\" >>./files/%s/filedir",
134 CC->room.QRdirname, filename, qrbuf.QRdirname);
136 cprintf("%d File '%s' has been moved.\n", CIT_OK, filename);
141 * This code is common to all commands which open a file for downloading,
142 * regardless of whether it's a file from the directory, an image, a network
143 * spool file, a MIME attachment, etc.
144 * It examines the file and displays the OK result code and some information
145 * about the file. NOTE: this stuff is Unix dependent.
147 void OpenCmdResult(char *filename, const char *mime_type)
153 fstat(fileno(CC->download_fp), &statbuf);
154 CC->download_fp_total = statbuf.st_size;
155 filesize = (long) statbuf.st_size;
156 modtime = (time_t) statbuf.st_mtime;
158 cprintf("%d %ld|%ld|%s|%s\n",
159 CIT_OK, filesize, (long)modtime, filename, mime_type);
164 * open a file for downloading
166 void cmd_open(char *cmdbuf)
169 char pathname[PATH_MAX];
172 extract_token(filename, cmdbuf, 0, '|', sizeof filename);
174 if (CtdlAccessCheck(ac_logged_in)) return;
176 if ((CC->room.QRflags & QR_DIRECTORY) == 0) {
177 cprintf("%d No directory in this room.\n",
182 if (IsEmptyStr(filename)) {
183 cprintf("%d You must specify a file name.\n",
184 ERROR + FILE_NOT_FOUND);
187 if (strstr(filename, "../") != NULL)
189 cprintf("%d syntax error.\n",
190 ERROR + ILLEGAL_VALUE);
194 if (CC->download_fp != NULL) {
195 cprintf("%d You already have a download file open.\n",
196 ERROR + RESOURCE_BUSY);
200 for (a = 0; !IsEmptyStr(&filename[a]); ++a) {
201 if ( (filename[a] == '/') || (filename[a] == '\\') ) {
206 snprintf(pathname, sizeof pathname,
209 CC->room.QRdirname, filename);
210 CC->download_fp = fopen(pathname, "r");
212 if (CC->download_fp == NULL) {
213 cprintf("%d cannot open %s: %s\n",
214 ERROR + INTERNAL_ERROR, pathname, strerror(errno));
218 OpenCmdResult(filename, "application/octet-stream");
224 void cmd_oimg(char *cmdbuf)
227 char pathname[PATH_MAX];
228 char MimeTestBuf[32];
229 struct ctdluser usbuf;
230 char which_user[USERNAME_SIZE];
235 extract_token(filename, cmdbuf, 0, '|', sizeof filename);
237 if (IsEmptyStr(filename)) {
238 cprintf("%d You must specify a file name.\n",
239 ERROR + FILE_NOT_FOUND);
243 if (CC->download_fp != NULL) {
244 cprintf("%d You already have a download file open.\n",
245 ERROR + RESOURCE_BUSY);
249 if (!strcasecmp(filename, "_userpic_")) {
250 extract_token(which_user, cmdbuf, 1, '|', sizeof which_user);
251 if (CtdlGetUser(&usbuf, which_user) != 0) {
252 cprintf("%d No such user.\n",
253 ERROR + NO_SUCH_USER);
256 snprintf(pathname, sizeof pathname,
260 } else if (!strcasecmp(filename, "_floorpic_")) {
261 which_floor = extract_int(cmdbuf, 1);
262 snprintf(pathname, sizeof pathname,
264 ctdl_image_dir, which_floor);
265 } else if (!strcasecmp(filename, "_roompic_")) {
266 assoc_file_name(pathname, sizeof pathname, &CC->room, ctdl_image_dir);
268 for (a = 0; !IsEmptyStr(&filename[a]); ++a) {
269 filename[a] = tolower(filename[a]);
270 if ( (filename[a] == '/') || (filename[a] == '\\') ) {
274 if (strstr(filename, "../") != NULL)
276 cprintf("%d syntax error.\n",
277 ERROR + ILLEGAL_VALUE);
281 snprintf(pathname, sizeof pathname,
287 CC->download_fp = fopen(pathname, "rb");
288 if (CC->download_fp == NULL) {
289 strcat(pathname, ".gif");
290 CC->download_fp = fopen(pathname, "rb");
292 if (CC->download_fp == NULL) {
293 cprintf("%d Cannot open %s: %s\n",
294 ERROR + FILE_NOT_FOUND, pathname, strerror(errno));
297 rv = fread(&MimeTestBuf[0], 1, 32, CC->download_fp);
299 cprintf("%d Cannot access %s: %s\n",
300 ERROR + FILE_NOT_FOUND, pathname, strerror(errno));
304 rewind (CC->download_fp);
305 OpenCmdResult(pathname, GuessMimeType(&MimeTestBuf[0], 32));
309 * open a file for uploading
311 void cmd_uopn(char *cmdbuf)
315 extract_token(CC->upl_file, cmdbuf, 0, '|', sizeof CC->upl_file);
316 extract_token(CC->upl_mimetype, cmdbuf, 1, '|', sizeof CC->upl_mimetype);
317 extract_token(CC->upl_comment, cmdbuf, 2, '|', sizeof CC->upl_comment);
319 if (CtdlAccessCheck(ac_logged_in)) return;
321 if ((CC->room.QRflags & QR_DIRECTORY) == 0) {
322 cprintf("%d No directory in this room.\n",
327 if (IsEmptyStr(CC->upl_file)) {
328 cprintf("%d You must specify a file name.\n",
329 ERROR + FILE_NOT_FOUND);
333 if (CC->upload_fp != NULL) {
334 cprintf("%d You already have a upload file open.\n",
335 ERROR + RESOURCE_BUSY);
339 for (a = 0; !IsEmptyStr(&CC->upl_file[a]); ++a) {
340 if ( (CC->upl_file[a] == '/') || (CC->upl_file[a] == '\\') ) {
341 CC->upl_file[a] = '_';
344 snprintf(CC->upl_path, sizeof CC->upl_path,
347 CC->room.QRdirname, CC->upl_file);
348 snprintf(CC->upl_filedir, sizeof CC->upl_filedir,
353 CC->upload_fp = fopen(CC->upl_path, "r");
354 if (CC->upload_fp != NULL) {
355 fclose(CC->upload_fp);
356 CC->upload_fp = NULL;
357 cprintf("%d '%s' already exists\n",
358 ERROR + ALREADY_EXISTS, CC->upl_path);
362 CC->upload_fp = fopen(CC->upl_path, "wb");
363 if (CC->upload_fp == NULL) {
364 cprintf("%d Cannot open %s: %s\n",
365 ERROR + INTERNAL_ERROR, CC->upl_path, strerror(errno));
368 cprintf("%d Ok\n", CIT_OK);
374 * open an image file for uploading
376 void cmd_uimg(char *cmdbuf)
378 int is_this_for_real;
383 if (num_parms(cmdbuf) < 2) {
384 cprintf("%d Usage error.\n", ERROR + ILLEGAL_VALUE);
388 is_this_for_real = extract_int(cmdbuf, 0);
389 extract_token(CC->upl_mimetype, cmdbuf, 1, '|', sizeof CC->upl_mimetype);
390 extract_token(basenm, cmdbuf, 2, '|', sizeof basenm);
391 if (CC->upload_fp != NULL) {
392 cprintf("%d You already have an upload file open.\n",
393 ERROR + RESOURCE_BUSY);
397 strcpy(CC->upl_path, "");
399 for (a = 0; !IsEmptyStr(&basenm[a]); ++a) {
400 basenm[a] = tolower(basenm[a]);
401 if ( (basenm[a] == '/') || (basenm[a] == '\\') ) {
406 if (CC->user.axlevel >= AxAideU) {
407 snprintf(CC->upl_path, sizeof CC->upl_path,
413 if (!strcasecmp(basenm, "_userpic_")) {
414 snprintf(CC->upl_path, sizeof CC->upl_path,
420 if ((!strcasecmp(basenm, "_floorpic_"))
421 && (CC->user.axlevel >= AxAideU)) {
422 which_floor = extract_int(cmdbuf, 2);
423 snprintf(CC->upl_path, sizeof CC->upl_path,
429 if ((!strcasecmp(basenm, "_roompic_")) && (is_room_aide())) {
430 assoc_file_name(CC->upl_path, sizeof CC->upl_path, &CC->room, ctdl_image_dir);
433 if (IsEmptyStr(CC->upl_path)) {
434 cprintf("%d Higher access required.\n",
435 ERROR + HIGHER_ACCESS_REQUIRED);
439 if (is_this_for_real == 0) {
440 cprintf("%d Ok to send image\n", CIT_OK);
444 CC->upload_fp = fopen(CC->upl_path, "wb");
445 if (CC->upload_fp == NULL) {
446 cprintf("%d Cannot open %s: %s\n",
447 ERROR + INTERNAL_ERROR, CC->upl_path, strerror(errno));
450 cprintf("%d Ok\n", CIT_OK);
451 CC->upload_type = UPL_IMAGE;
456 * close the download file
458 void cmd_clos(char *cmdbuf)
462 if (CC->download_fp == NULL) {
463 cprintf("%d You don't have a download file open.\n",
464 ERROR + RESOURCE_NOT_OPEN);
468 fclose(CC->download_fp);
469 CC->download_fp = NULL;
471 if (CC->dl_is_net == 1) {
473 snprintf(buf, sizeof buf,
480 cprintf("%d Ok\n", CIT_OK);
487 void abort_upl(CitContext *who)
489 if (who->upload_fp != NULL) {
490 fclose(who->upload_fp);
491 who->upload_fp = NULL;
492 unlink(CC->upl_path);
499 * close the upload file
501 void cmd_ucls(char *cmd)
504 char upload_notice[512];
507 if (CC->upload_fp == NULL) {
508 cprintf("%d You don't have an upload file open.\n", ERROR + RESOURCE_NOT_OPEN);
512 fclose(CC->upload_fp);
513 CC->upload_fp = NULL;
515 if ((!strcasecmp(cmd, "1")) && (CC->upload_type != UPL_FILE)) {
516 cprintf("%d Upload completed.\n", CIT_OK);
518 if (CC->upload_type == UPL_NET) {
519 char final_filename[PATH_MAX];
520 snprintf(final_filename, sizeof final_filename,
528 if (link(CC->upl_path, final_filename) == 0) {
529 syslog(LOG_INFO, "UCLS: updoaded %s\n",
531 unlink(CC->upl_path);
534 syslog(LOG_ALERT, "Cannot link %s to %s: %s\n",
535 CC->upl_path, final_filename, strerror(errno)
540 /* FIXME ... here we need to trigger a network run */
543 CC->upload_type = UPL_FILE;
547 if (!strcasecmp(cmd, "1")) {
548 cprintf("%d File '%s' saved.\n", CIT_OK, CC->upl_path);
549 fp = fopen(CC->upl_filedir, "a");
551 fp = fopen(CC->upl_filedir, "w");
554 fprintf(fp, "%s %s %s\n", CC->upl_file,
560 /* put together an upload notice */
561 snprintf(upload_notice, sizeof upload_notice,
562 "NEW UPLOAD: '%s'\n %s\n%s\n",
566 quickie_message(CC->curr_user, NULL, NULL, CC->room.QRname,
567 upload_notice, 0, NULL);
570 cprintf("%d File '%s' aborted.\n", CIT_OK, CC->upl_path);
576 * read from the download file
578 void cmd_read(char *cmdbuf)
585 /* The client will transmit its requested offset and byte count */
586 start_pos = extract_long(cmdbuf, 0);
587 bytes = extract_int(cmdbuf, 1);
588 if ((start_pos < 0) || (bytes <= 0)) {
589 cprintf("%d you have to specify a value > 0.\n", ERROR + ILLEGAL_VALUE);
593 if (CC->download_fp == NULL) {
594 cprintf("%d You don't have a download file open.\n",
595 ERROR + RESOURCE_NOT_OPEN);
599 /* If necessary, reduce the byte count to the size of our buffer */
600 if (bytes > sizeof(buf)) {
604 rc = fseek(CC->download_fp, start_pos, 0);
606 cprintf("%d your file is smaller then %ld.\n", ERROR + ILLEGAL_VALUE, start_pos);
607 syslog(LOG_ALERT, "your file %s is smaller then %ld. [%s]\n",
614 bytes = fread(buf, 1, bytes, CC->download_fp);
616 /* Tell the client the actual byte count and transmit it */
617 cprintf("%d %d\n", BINARY_FOLLOWS, (int)bytes);
618 client_write(buf, bytes);
621 cprintf("%d %s\n", ERROR, strerror(errno));
627 * write to the upload file
629 void cmd_writ(char *cmdbuf)
637 bytes = extract_int(cmdbuf, 0);
639 if (CC->upload_fp == NULL) {
640 cprintf("%d You don't have an upload file open.\n", ERROR + RESOURCE_NOT_OPEN);
644 cprintf("%d you have to specify a value > 0.\n", ERROR + ILLEGAL_VALUE);
648 if (bytes > 100000) {
652 cprintf("%d %d\n", SEND_BINARY, bytes);
653 buf = malloc(bytes + 1);
654 client_read(buf, bytes);
655 rv = fwrite(buf, bytes, 1, CC->upload_fp);
657 syslog(LOG_EMERG, "Couldn't write: %s\n",
667 * cmd_ndop() - open a network spool file for downloading
669 void cmd_ndop(char *cmdbuf)
674 if (IsEmptyStr(CC->net_node)) {
675 cprintf("%d Not authenticated as a network node.\n",
676 ERROR + NOT_LOGGED_IN);
680 if (CC->download_fp != NULL) {
681 cprintf("%d You already have a download file open.\n",
682 ERROR + RESOURCE_BUSY);
686 snprintf(pathname, sizeof pathname,
691 /* first open the file in append mode in order to create a
692 * zero-length file if it doesn't already exist
694 CC->download_fp = fopen(pathname, "a");
695 if (CC->download_fp != NULL)
696 fclose(CC->download_fp);
699 CC->download_fp = fopen(pathname, "r");
700 if (CC->download_fp == NULL) {
701 cprintf("%d cannot open %s: %s\n",
702 ERROR + INTERNAL_ERROR, pathname, strerror(errno));
707 /* set this flag so other routines know that the download file
708 * currently open is a network spool file
712 stat(pathname, &statbuf);
713 CC->download_fp_total = statbuf.st_size;
714 cprintf("%d %ld\n", CIT_OK, (long)statbuf.st_size);
718 * cmd_nuop() - open a network spool file for uploading
720 void cmd_nuop(char *cmdbuf)
724 if (IsEmptyStr(CC->net_node)) {
725 cprintf("%d Not authenticated as a network node.\n",
726 ERROR + NOT_LOGGED_IN);
730 if (CC->upload_fp != NULL) {
731 cprintf("%d You already have an upload file open.\n",
732 ERROR + RESOURCE_BUSY);
736 snprintf(CC->upl_path, sizeof CC->upl_path,
743 CC->upload_fp = fopen(CC->upl_path, "r");
744 if (CC->upload_fp != NULL) {
745 fclose(CC->upload_fp);
746 CC->upload_fp = NULL;
747 cprintf("%d '%s' already exists\n",
748 ERROR + ALREADY_EXISTS, CC->upl_path);
752 CC->upload_fp = fopen(CC->upl_path, "w");
753 if (CC->upload_fp == NULL) {
754 cprintf("%d Cannot open %s: %s\n",
755 ERROR + INTERNAL_ERROR, CC->upl_path, strerror(errno));
759 CC->upload_type = UPL_NET;
760 cprintf("%d Ok\n", CIT_OK);
762 void files_logout_hook(void)
764 CitContext *CCC = MyContext();
767 * If there is a download in progress, abort it.
769 if (CCC->download_fp != NULL) {
770 fclose(CCC->download_fp);
771 CCC->download_fp = NULL;
775 * If there is an upload in progress, abort it.
777 if (CCC->upload_fp != NULL) {
784 * help_subst() - support routine for help file viewer
786 void help_subst(char *strbuf, char *source, char *dest)
791 while (p = pattern2(strbuf, source), (p >= 0)) {
792 strcpy(workbuf, &strbuf[p + strlen(source)]);
793 strcpy(&strbuf[p], dest);
794 strcat(strbuf, workbuf);
798 void do_help_subst(char *buffer)
802 help_subst(buffer, "^nodename", CtdlGetConfigStr("c_nodename"));
803 help_subst(buffer, "^humannode", CtdlGetConfigStr("c_humannode"));
804 help_subst(buffer, "^fqdn", CtdlGetConfigStr("c_fqdn"));
805 help_subst(buffer, "^username", CC->user.fullname);
806 snprintf(buf2, sizeof buf2, "%ld", CC->user.usernum);
807 help_subst(buffer, "^usernum", buf2);
808 help_subst(buffer, "^sysadm", CtdlGetConfigStr("c_sysadm"));
809 help_subst(buffer, "^variantname", CITADEL);
810 help_subst(buffer, "^maxsessions", CtdlGetConfigStr("c_maxsessions")); // yes it's numeric but str is ok here
811 help_subst(buffer, "^bbsdir", ctdl_message_dir);
815 typedef const char *ccharp;
817 * display system messages or help
819 void cmd_mesg(char *mname)
829 extract_token(buf, mname, 0, '|', sizeof buf);
831 dirs[0] = strdup(ctdl_message_dir);
832 dirs[1] = strdup(ctdl_hlp_dir);
834 snprintf(buf2, sizeof buf2, "%s.%d.%d",
835 buf, CC->cs_clientdev, CC->cs_clienttyp);
837 /* If the client requested "?" then produce a listing */
838 if (!strcmp(buf, "?")) {
839 cprintf("%d %s\n", LISTING_FOLLOWS, buf);
840 dp = opendir(dirs[1]);
842 while (d = readdir(dp), d != NULL) {
843 if (d->d_name[0] != '.') {
844 cprintf(" %s\n", d->d_name);
855 /* Otherwise, look for the requested file by name. */
857 mesg_locate(targ, sizeof targ, buf2, 2, (const ccharp*)dirs);
858 if (IsEmptyStr(targ)) {
859 snprintf(buf2, sizeof buf2, "%s.%d",
860 buf, CC->cs_clientdev);
861 mesg_locate(targ, sizeof targ, buf2, 2,
862 (const ccharp*)dirs);
863 if (IsEmptyStr(targ)) {
864 mesg_locate(targ, sizeof targ, buf, 2,
865 (const ccharp*)dirs);
873 if (IsEmptyStr(targ)) {
874 cprintf("%d '%s' not found. (Searching in %s and %s)\n",
875 ERROR + FILE_NOT_FOUND,
883 mfp = fopen(targ, "r");
885 cprintf("%d Cannot open '%s': %s\n",
886 ERROR + INTERNAL_ERROR, targ, strerror(errno));
889 cprintf("%d %s\n", LISTING_FOLLOWS,buf);
891 while (fgets(buf, (sizeof buf - 1), mfp) != NULL) {
892 buf[strlen(buf)-1] = 0;
903 * enter system messages or help
905 void cmd_emsg(char *mname)
915 if (CtdlAccessCheck(ac_aide)) return;
917 extract_token(buf, mname, 0, '|', sizeof buf);
918 for (a=0; !IsEmptyStr(&buf[a]); ++a) { /* security measure */
919 if (buf[a] == '/') buf[a] = '.';
922 dirs[0] = strdup(ctdl_message_dir);
923 dirs[1] = strdup(ctdl_hlp_dir);
925 mesg_locate(targ, sizeof targ, buf, 2, (const ccharp*)dirs);
929 if (IsEmptyStr(targ)) {
930 snprintf(targ, sizeof targ,
935 mfp = fopen(targ,"w");
937 cprintf("%d Cannot open '%s': %s\n",
938 ERROR + INTERNAL_ERROR, targ, strerror(errno));
941 cprintf("%d %s\n", SEND_LISTING, targ);
943 while (client_getln(buf, sizeof buf) >=0 && strcmp(buf, "000")) {
944 fprintf(mfp, "%s\n", buf);
950 /*****************************************************************************/
951 /* MODULE INITIALIZATION STUFF */
952 /*****************************************************************************/
954 CTDL_MODULE_INIT(file_ops)
957 CtdlRegisterSessionHook(files_logout_hook, EVT_LOGOUT, PRIO_LOGOUT + 8);
959 CtdlRegisterProtoHook(cmd_delf, "DELF", "Delete a file");
960 CtdlRegisterProtoHook(cmd_movf, "MOVF", "Move a file");
961 CtdlRegisterProtoHook(cmd_open, "OPEN", "Open a download file transfer");
962 CtdlRegisterProtoHook(cmd_clos, "CLOS", "Close a download file transfer");
963 CtdlRegisterProtoHook(cmd_uopn, "UOPN", "Open an upload file transfer");
964 CtdlRegisterProtoHook(cmd_ucls, "UCLS", "Close an upload file transfer");
965 CtdlRegisterProtoHook(cmd_read, "READ", "File transfer read operation");
966 CtdlRegisterProtoHook(cmd_writ, "WRIT", "File transfer write operation");
967 CtdlRegisterProtoHook(cmd_ndop, "NDOP", "Open a network spool file for download");
968 CtdlRegisterProtoHook(cmd_nuop, "NUOP", "Open a network spool file for upload");
969 CtdlRegisterProtoHook(cmd_oimg, "OIMG", "Open an image file for download");
970 CtdlRegisterProtoHook(cmd_uimg, "UIMG", "Upload an image file");
972 CtdlRegisterProtoHook(cmd_mesg, "MESG", "fetch system banners");
973 CtdlRegisterProtoHook(cmd_emsg, "EMSG", "submit system banners");
975 /* return our Subversion id for the Log */