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, "_floorpic_")) {
250 which_floor = extract_int(cmdbuf, 1);
251 snprintf(pathname, sizeof pathname, "%s/floor.%d", ctdl_image_dir, which_floor);
253 else if (!strcasecmp(filename, "_roompic_")) {
254 assoc_file_name(pathname, sizeof pathname, &CC->room, ctdl_image_dir);
257 for (a = 0; !IsEmptyStr(&filename[a]); ++a) {
258 filename[a] = tolower(filename[a]);
259 if ( (filename[a] == '/') || (filename[a] == '\\') ) {
263 if (strstr(filename, "../") != NULL)
265 cprintf("%d syntax error.\n",
266 ERROR + ILLEGAL_VALUE);
270 snprintf(pathname, sizeof pathname,
276 CC->download_fp = fopen(pathname, "rb");
277 if (CC->download_fp == NULL) {
278 strcat(pathname, ".gif");
279 CC->download_fp = fopen(pathname, "rb");
281 if (CC->download_fp == NULL) {
282 cprintf("%d Cannot open %s: %s\n",
283 ERROR + FILE_NOT_FOUND, pathname, strerror(errno));
286 rv = fread(&MimeTestBuf[0], 1, 32, CC->download_fp);
288 cprintf("%d Cannot access %s: %s\n",
289 ERROR + FILE_NOT_FOUND, pathname, strerror(errno));
293 rewind (CC->download_fp);
294 OpenCmdResult(pathname, GuessMimeType(&MimeTestBuf[0], 32));
299 * open a file for uploading
301 void cmd_uopn(char *cmdbuf)
305 extract_token(CC->upl_file, cmdbuf, 0, '|', sizeof CC->upl_file);
306 extract_token(CC->upl_mimetype, cmdbuf, 1, '|', sizeof CC->upl_mimetype);
307 extract_token(CC->upl_comment, cmdbuf, 2, '|', sizeof CC->upl_comment);
309 if (CtdlAccessCheck(ac_logged_in)) return;
311 if ((CC->room.QRflags & QR_DIRECTORY) == 0) {
312 cprintf("%d No directory in this room.\n",
317 if (IsEmptyStr(CC->upl_file)) {
318 cprintf("%d You must specify a file name.\n",
319 ERROR + FILE_NOT_FOUND);
323 if (CC->upload_fp != NULL) {
324 cprintf("%d You already have a upload file open.\n",
325 ERROR + RESOURCE_BUSY);
329 for (a = 0; !IsEmptyStr(&CC->upl_file[a]); ++a) {
330 if ( (CC->upl_file[a] == '/') || (CC->upl_file[a] == '\\') ) {
331 CC->upl_file[a] = '_';
334 snprintf(CC->upl_path, sizeof CC->upl_path,
337 CC->room.QRdirname, CC->upl_file);
338 snprintf(CC->upl_filedir, sizeof CC->upl_filedir,
343 CC->upload_fp = fopen(CC->upl_path, "r");
344 if (CC->upload_fp != NULL) {
345 fclose(CC->upload_fp);
346 CC->upload_fp = NULL;
347 cprintf("%d '%s' already exists\n",
348 ERROR + ALREADY_EXISTS, CC->upl_path);
352 CC->upload_fp = fopen(CC->upl_path, "wb");
353 if (CC->upload_fp == NULL) {
354 cprintf("%d Cannot open %s: %s\n",
355 ERROR + INTERNAL_ERROR, CC->upl_path, strerror(errno));
358 cprintf("%d Ok\n", CIT_OK);
364 * open an image file for uploading
366 void cmd_uimg(char *cmdbuf)
368 int is_this_for_real;
373 if (num_parms(cmdbuf) < 2) {
374 cprintf("%d Usage error.\n", ERROR + ILLEGAL_VALUE);
378 is_this_for_real = extract_int(cmdbuf, 0);
379 extract_token(CC->upl_mimetype, cmdbuf, 1, '|', sizeof CC->upl_mimetype);
380 extract_token(basenm, cmdbuf, 2, '|', sizeof basenm);
381 if (CC->upload_fp != NULL) {
382 cprintf("%d You already have an upload file open.\n",
383 ERROR + RESOURCE_BUSY);
387 strcpy(CC->upl_path, "");
389 for (a = 0; !IsEmptyStr(&basenm[a]); ++a) {
390 basenm[a] = tolower(basenm[a]);
391 if ( (basenm[a] == '/') || (basenm[a] == '\\') ) {
396 if (CC->user.axlevel >= AxAideU) {
397 snprintf(CC->upl_path, sizeof CC->upl_path,
403 if (!strcasecmp(basenm, "_userpic_")) {
404 snprintf(CC->upl_path, sizeof CC->upl_path,
410 if ((!strcasecmp(basenm, "_floorpic_"))
411 && (CC->user.axlevel >= AxAideU)) {
412 which_floor = extract_int(cmdbuf, 2);
413 snprintf(CC->upl_path, sizeof CC->upl_path,
419 if ((!strcasecmp(basenm, "_roompic_")) && (is_room_aide())) {
420 assoc_file_name(CC->upl_path, sizeof CC->upl_path, &CC->room, ctdl_image_dir);
423 if (IsEmptyStr(CC->upl_path)) {
424 cprintf("%d Higher access required.\n",
425 ERROR + HIGHER_ACCESS_REQUIRED);
429 if (is_this_for_real == 0) {
430 cprintf("%d Ok to send image\n", CIT_OK);
434 CC->upload_fp = fopen(CC->upl_path, "wb");
435 if (CC->upload_fp == NULL) {
436 cprintf("%d Cannot open %s: %s\n",
437 ERROR + INTERNAL_ERROR, CC->upl_path, strerror(errno));
440 cprintf("%d Ok\n", CIT_OK);
441 CC->upload_type = UPL_IMAGE;
446 * close the download file
448 void cmd_clos(char *cmdbuf)
452 if (CC->download_fp == NULL) {
453 cprintf("%d You don't have a download file open.\n",
454 ERROR + RESOURCE_NOT_OPEN);
458 fclose(CC->download_fp);
459 CC->download_fp = NULL;
461 if (CC->dl_is_net == 1) {
463 snprintf(buf, sizeof buf,
470 cprintf("%d Ok\n", CIT_OK);
477 void abort_upl(CitContext *who)
479 if (who->upload_fp != NULL) {
480 fclose(who->upload_fp);
481 who->upload_fp = NULL;
482 unlink(CC->upl_path);
489 * close the upload file
491 void cmd_ucls(char *cmd)
493 struct CitContext *CCC = CC;
495 char upload_notice[512];
498 if (CCC->upload_fp == NULL) {
499 cprintf("%d You don't have an upload file open.\n", ERROR + RESOURCE_NOT_OPEN);
503 fclose(CC->upload_fp);
504 CCC->upload_fp = NULL;
506 if ((!strcasecmp(cmd, "1")) && (CCC->upload_type != UPL_FILE)) {
507 cprintf("%d Upload completed.\n", CIT_OK);
509 if (CCC->upload_type == UPL_NET) {
510 char final_filename[PATH_MAX];
511 snprintf(final_filename, sizeof final_filename,
519 if (link(CCC->upl_path, final_filename) == 0) {
520 CTDL_syslog(LOG_INFO, "UCLS: updoaded %s",
522 unlink(CCC->upl_path);
525 CTDL_syslog(LOG_INFO, "Cannot link %s to %s: %s",
526 CCC->upl_path, final_filename, strerror(errno)
531 /* FIXME ... here we need to trigger a network run */
534 CCC->upload_type = UPL_FILE;
538 if (!strcasecmp(cmd, "1")) {
539 cprintf("%d File '%s' saved.\n", CIT_OK, CCC->upl_path);
540 fp = fopen(CCC->upl_filedir, "a");
542 fp = fopen(CCC->upl_filedir, "w");
545 fprintf(fp, "%s %s %s\n", CCC->upl_file,
551 if ((CCC->room.QRflags2 & QR2_NOUPLMSG) == 0) {
552 /* put together an upload notice */
553 snprintf(upload_notice, sizeof upload_notice,
554 "NEW UPLOAD: '%s'\n %s\n%s\n",
558 quickie_message(CCC->curr_user, NULL, NULL, CCC->room.QRname,
559 upload_notice, 0, NULL);
563 cprintf("%d File '%s' aborted.\n", CIT_OK, CCC->upl_path);
569 * read from the download file
571 void cmd_read(char *cmdbuf)
578 /* The client will transmit its requested offset and byte count */
579 start_pos = extract_long(cmdbuf, 0);
580 bytes = extract_int(cmdbuf, 1);
581 if ((start_pos < 0) || (bytes <= 0)) {
582 cprintf("%d you have to specify a value > 0.\n", ERROR + ILLEGAL_VALUE);
586 if (CC->download_fp == NULL) {
587 cprintf("%d You don't have a download file open.\n",
588 ERROR + RESOURCE_NOT_OPEN);
592 /* If necessary, reduce the byte count to the size of our buffer */
593 if (bytes > sizeof(buf)) {
597 rc = fseek(CC->download_fp, start_pos, 0);
599 struct CitContext *CCC = CC;
600 cprintf("%d your file is smaller then %ld.\n", ERROR + ILLEGAL_VALUE, start_pos);
601 CTDL_syslog(LOG_ERR, "your file %s is smaller then %ld. [%s]\n",
608 bytes = fread(buf, 1, bytes, CC->download_fp);
610 /* Tell the client the actual byte count and transmit it */
611 cprintf("%d %d\n", BINARY_FOLLOWS, (int)bytes);
612 client_write(buf, bytes);
615 cprintf("%d %s\n", ERROR, strerror(errno));
621 * write to the upload file
623 void cmd_writ(char *cmdbuf)
625 struct CitContext *CCC = CC;
632 bytes = extract_int(cmdbuf, 0);
634 if (CCC->upload_fp == NULL) {
635 cprintf("%d You don't have an upload file open.\n", ERROR + RESOURCE_NOT_OPEN);
639 cprintf("%d you have to specify a value > 0.\n", ERROR + ILLEGAL_VALUE);
643 if (bytes > 100000) {
647 cprintf("%d %d\n", SEND_BINARY, bytes);
648 buf = malloc(bytes + 1);
649 client_read(buf, bytes);
650 rv = fwrite(buf, bytes, 1, CCC->upload_fp);
652 CTDL_syslog(LOG_EMERG, "Couldn't write: %s\n",
662 * cmd_ndop() - open a network spool file for downloading
664 void cmd_ndop(char *cmdbuf)
666 struct CitContext *CCC = CC;
670 if (IsEmptyStr(CCC->net_node)) {
671 cprintf("%d Not authenticated as a network node.\n",
672 ERROR + NOT_LOGGED_IN);
676 if (CCC->download_fp != NULL) {
677 cprintf("%d You already have a download file open.\n",
678 ERROR + RESOURCE_BUSY);
682 snprintf(pathname, sizeof pathname,
687 /* first open the file in append mode in order to create a
688 * zero-length file if it doesn't already exist
690 CCC->download_fp = fopen(pathname, "a");
691 if (CCC->download_fp != NULL)
692 fclose(CCC->download_fp);
695 CCC->download_fp = fopen(pathname, "r");
696 if (CCC->download_fp == NULL) {
697 cprintf("%d cannot open %s: %s\n",
698 ERROR + INTERNAL_ERROR, pathname, strerror(errno));
703 /* set this flag so other routines know that the download file
704 * currently open is a network spool file
708 stat(pathname, &statbuf);
709 CCC->download_fp_total = statbuf.st_size;
710 cprintf("%d %ld\n", CIT_OK, (long)statbuf.st_size);
714 * cmd_nuop() - open a network spool file for uploading
716 void cmd_nuop(char *cmdbuf)
720 if (IsEmptyStr(CC->net_node)) {
721 cprintf("%d Not authenticated as a network node.\n",
722 ERROR + NOT_LOGGED_IN);
726 if (CC->upload_fp != NULL) {
727 cprintf("%d You already have an upload file open.\n",
728 ERROR + RESOURCE_BUSY);
732 snprintf(CC->upl_path, sizeof CC->upl_path,
739 CC->upload_fp = fopen(CC->upl_path, "r");
740 if (CC->upload_fp != NULL) {
741 fclose(CC->upload_fp);
742 CC->upload_fp = NULL;
743 cprintf("%d '%s' already exists\n",
744 ERROR + ALREADY_EXISTS, CC->upl_path);
748 CC->upload_fp = fopen(CC->upl_path, "w");
749 if (CC->upload_fp == NULL) {
750 cprintf("%d Cannot open %s: %s\n",
751 ERROR + INTERNAL_ERROR, CC->upl_path, strerror(errno));
755 CC->upload_type = UPL_NET;
756 cprintf("%d Ok\n", CIT_OK);
758 void files_logout_hook(void)
760 CitContext *CCC = MyContext();
763 * If there is a download in progress, abort it.
765 if (CCC->download_fp != NULL) {
766 fclose(CCC->download_fp);
767 CCC->download_fp = NULL;
771 * If there is an upload in progress, abort it.
773 if (CCC->upload_fp != NULL) {
780 * help_subst() - support routine for help file viewer
782 void help_subst(char *strbuf, char *source, char *dest)
787 while (p = pattern2(strbuf, source), (p >= 0)) {
788 strcpy(workbuf, &strbuf[p + strlen(source)]);
789 strcpy(&strbuf[p], dest);
790 strcat(strbuf, workbuf);
794 void do_help_subst(char *buffer)
798 help_subst(buffer, "^nodename", CtdlGetConfigStr("c_nodename"));
799 help_subst(buffer, "^humannode", CtdlGetConfigStr("c_humannode"));
800 help_subst(buffer, "^fqdn", CtdlGetConfigStr("c_fqdn"));
801 help_subst(buffer, "^username", CC->user.fullname);
802 snprintf(buf2, sizeof buf2, "%ld", CC->user.usernum);
803 help_subst(buffer, "^usernum", buf2);
804 help_subst(buffer, "^sysadm", CtdlGetConfigStr("c_sysadm"));
805 help_subst(buffer, "^variantname", CITADEL);
806 help_subst(buffer, "^maxsessions", CtdlGetConfigStr("c_maxsessions")); // yes it's numeric but str is ok here
807 help_subst(buffer, "^bbsdir", ctdl_message_dir);
811 typedef const char *ccharp;
813 * display system messages or help
815 void cmd_mesg(char *mname)
825 extract_token(buf, mname, 0, '|', sizeof buf);
827 dirs[0] = strdup(ctdl_message_dir);
828 dirs[1] = strdup(ctdl_hlp_dir);
830 snprintf(buf2, sizeof buf2, "%s.%d.%d",
831 buf, CC->cs_clientdev, CC->cs_clienttyp);
833 /* If the client requested "?" then produce a listing */
834 if (!strcmp(buf, "?")) {
835 cprintf("%d %s\n", LISTING_FOLLOWS, buf);
836 dp = opendir(dirs[1]);
838 while (d = readdir(dp), d != NULL) {
839 if (d->d_name[0] != '.') {
840 cprintf(" %s\n", d->d_name);
851 /* Otherwise, look for the requested file by name. */
853 mesg_locate(targ, sizeof targ, buf2, 2, (const ccharp*)dirs);
854 if (IsEmptyStr(targ)) {
855 snprintf(buf2, sizeof buf2, "%s.%d",
856 buf, CC->cs_clientdev);
857 mesg_locate(targ, sizeof targ, buf2, 2,
858 (const ccharp*)dirs);
859 if (IsEmptyStr(targ)) {
860 mesg_locate(targ, sizeof targ, buf, 2,
861 (const ccharp*)dirs);
869 if (IsEmptyStr(targ)) {
870 cprintf("%d '%s' not found. (Searching in %s and %s)\n",
871 ERROR + FILE_NOT_FOUND,
879 mfp = fopen(targ, "r");
881 cprintf("%d Cannot open '%s': %s\n",
882 ERROR + INTERNAL_ERROR, targ, strerror(errno));
885 cprintf("%d %s\n", LISTING_FOLLOWS,buf);
887 while (fgets(buf, (sizeof buf - 1), mfp) != NULL) {
888 buf[strlen(buf)-1] = 0;
899 * enter system messages or help
901 void cmd_emsg(char *mname)
911 if (CtdlAccessCheck(ac_aide)) return;
913 extract_token(buf, mname, 0, '|', sizeof buf);
914 for (a=0; !IsEmptyStr(&buf[a]); ++a) { /* security measure */
915 if (buf[a] == '/') buf[a] = '.';
918 dirs[0] = strdup(ctdl_message_dir);
919 dirs[1] = strdup(ctdl_hlp_dir);
921 mesg_locate(targ, sizeof targ, buf, 2, (const ccharp*)dirs);
925 if (IsEmptyStr(targ)) {
926 snprintf(targ, sizeof targ,
931 mfp = fopen(targ,"w");
933 cprintf("%d Cannot open '%s': %s\n",
934 ERROR + INTERNAL_ERROR, targ, strerror(errno));
937 cprintf("%d %s\n", SEND_LISTING, targ);
939 while (client_getln(buf, sizeof buf) >=0 && strcmp(buf, "000")) {
940 fprintf(mfp, "%s\n", buf);
946 /*****************************************************************************/
947 /* MODULE INITIALIZATION STUFF */
948 /*****************************************************************************/
950 CTDL_MODULE_INIT(file_ops)
953 CtdlRegisterSessionHook(files_logout_hook, EVT_LOGOUT, PRIO_LOGOUT + 8);
955 CtdlRegisterProtoHook(cmd_delf, "DELF", "Delete a file");
956 CtdlRegisterProtoHook(cmd_movf, "MOVF", "Move a file");
957 CtdlRegisterProtoHook(cmd_open, "OPEN", "Open a download file transfer");
958 CtdlRegisterProtoHook(cmd_clos, "CLOS", "Close a download file transfer");
959 CtdlRegisterProtoHook(cmd_uopn, "UOPN", "Open an upload file transfer");
960 CtdlRegisterProtoHook(cmd_ucls, "UCLS", "Close an upload file transfer");
961 CtdlRegisterProtoHook(cmd_read, "READ", "File transfer read operation");
962 CtdlRegisterProtoHook(cmd_writ, "WRIT", "File transfer write operation");
963 CtdlRegisterProtoHook(cmd_ndop, "NDOP", "Open a network spool file for download");
964 CtdlRegisterProtoHook(cmd_nuop, "NUOP", "Open a network spool file for upload");
965 CtdlRegisterProtoHook(cmd_oimg, "OIMG", "Open an image file for download");
966 CtdlRegisterProtoHook(cmd_uimg, "UIMG", "Upload an image file");
968 CtdlRegisterProtoHook(cmd_mesg, "MESG", "fetch system banners");
969 CtdlRegisterProtoHook(cmd_emsg, "EMSG", "submit system banners");
971 /* return our Subversion id for the Log */