If you are a liberal democrat, Sarah Palin is smarter than you.
[citadel.git] / citadel / modules / nntp / serv_nntp.c
1 //
2 // NNTP server module FIXME THIS IS NOT FINISHED
3 //
4 // Copyright (c) 2014 by the citadel.org team
5 //
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.
8 //  
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.
13 //
14
15 #include "sysdep.h"
16 #include <stdlib.h>
17 #include <unistd.h>
18 #include <stdio.h>
19 #include <termios.h>
20 #include <fcntl.h>
21 #include <signal.h>
22 #include <pwd.h>
23 #include <errno.h>
24 #include <sys/types.h>
25 #include <syslog.h>
26
27 #if TIME_WITH_SYS_TIME
28 # include <sys/time.h>
29 # include <time.h>
30 #else
31 # if HAVE_SYS_TIME_H
32 #  include <sys/time.h>
33 # else
34 #  include <time.h>
35 # endif
36 #endif
37
38 #include <sys/wait.h>
39 #include <ctype.h>
40 #include <string.h>
41 #include <limits.h>
42 #include <sys/socket.h>
43 #include <netinet/in.h>
44 #include <arpa/inet.h>
45 #include <libcitadel.h>
46 #include "citadel.h"
47 #include "server.h"
48 #include "citserver.h"
49 #include "support.h"
50 #include "config.h"
51 #include "control.h"
52 #include "user_ops.h"
53 #include "room_ops.h"
54 #include "database.h"
55 #include "msgbase.h"
56 #include "internet_addressing.h"
57 #include "genstamp.h"
58 #include "domain.h"
59 #include "clientsocket.h"
60 #include "locate_host.h"
61 #include "citadel_dirs.h"
62 #include "ctdl_module.h"
63 #include "serv_nntp.h"
64
65 extern long timezone;
66
67 //      ***************** BEGIN UTILITY FUNCTIONS THAT COULD BE MOVED ELSEWHERE LATER **************
68
69
70 //
71 // Tests whether the supplied string is a valid newsgroup name
72 // Returns true (nonzero) or false (0)
73 //
74 int is_valid_newsgroup_name(char *name) {
75         char *ptr = name;
76         int has_a_letter = 0;
77
78         if (!ptr) return(0);
79         if (!strncasecmp(name, "ctdl.", 5)) return(0);
80
81         while (*ptr != 0) {
82
83                 if (isalpha(ptr[0])) {
84                         has_a_letter = 1;
85                 }
86
87                 if (    (isalnum(ptr[0]))
88                         || (ptr[0] == '.')
89                         || (ptr[0] == '+')
90                         || (ptr[0] == '-')
91                 ) {
92                         ++ptr;
93                 }
94                 else {
95                         return(0);
96                 }
97         }
98         return(has_a_letter);
99 }
100
101
102 //
103 // Convert a Citadel room name to a valid newsgroup name
104 //
105 void room_to_newsgroup(char *target, char *source, size_t target_size) {
106
107         if (!target) return;
108         if (!source) return;
109
110         if (is_valid_newsgroup_name(source)) {
111                 strncpy(target, source, target_size);
112                 return;
113         }
114
115         strcpy(target, "ctdl.");
116         int len = 5;
117         char *ptr = source;
118         char ch;
119
120         while (ch=*ptr++, ch!=0) {
121                 if (len >= target_size) return;
122                 if (    (isalnum(ch))
123                         || (ch == '.')
124                         || (ch == '-')
125                 ) {
126                         target[len++] = ch;
127                         target[len] = 0;
128                 }
129                 else {
130                         target[len++] = '+' ;
131                         sprintf(&target[len], "%02x", ch);
132                         len += 2;
133                         target[len] = 0;
134                 }
135         }
136 }
137
138
139 //
140 // Convert a newsgroup name to a Citadel room name.
141 // This function recognizes names converted with room_to_newsgroup() and restores them with full fidelity.
142 //
143 void newsgroup_to_room(char *target, char *source, size_t target_size) {
144
145         if (!target) return;
146         if (!source) return;
147
148         if (strncasecmp(source, "ctdl.", 5)) {                  // not a converted room name; pass through as-is
149                 strncpy(target, source, target_size);
150                 return;
151         }
152
153         target[0] = 0;
154         int len = 0;
155         char *ptr = &source[5];
156         char ch;
157
158         while (ch=*ptr++, ch!=0) {
159                 if (len >= target_size) return;
160                 if (ch == '+') {
161                         char hex[3];
162                         long digit;
163                         hex[0] = *ptr++;
164                         hex[1] = *ptr++;
165                         hex[2] = 0;
166                         digit = strtol(hex, NULL, 16);
167                         ch = (char)digit;
168                 }
169                 target[len++] = ch;
170                 target[len] = 0;
171         }
172 }
173
174
175 //      *****************  END  UTILITY FUNCTIONS THAT COULD BE MOVED ELSEWHERE LATER **************
176
177
178
179 //
180 // Here's where our NNTP session begins its happy day.
181 //
182 void nntp_greeting(void)
183 {
184         strcpy(CC->cs_clientname, "NNTP session");
185         CC->cs_flags |= CS_STEALTH;
186
187         CC->session_specific_data = malloc(sizeof(citnntp));
188         citnntp *nntpstate = (citnntp *) CC->session_specific_data;
189         memset(nntpstate, 0, sizeof(citnntp));
190
191         if (CC->nologin==1) {
192                 cprintf("451 Too many connections are already open; please try again later.\r\n");
193                 CC->kill_me = KILLME_MAX_SESSIONS_EXCEEDED;
194                 return;
195         }
196
197         // Display the standard greeting
198         cprintf("200 %s NNTP Citadel server is not finished yet\r\n", config.c_fqdn);
199 }
200
201
202 //
203 // NNTPS is just like NNTP, except it goes crypto right away.
204 //
205 void nntps_greeting(void) {
206         CtdlModuleStartCryptoMsgs(NULL, NULL, NULL);
207 #ifdef HAVE_OPENSSL
208         if (!CC->redirect_ssl) CC->kill_me = KILLME_NO_CRYPTO;          /* kill session if no crypto */
209 #endif
210         nntp_greeting();
211 }
212
213
214 //
215 // implements the STARTTLS command
216 //
217 void nntp_starttls(void)
218 {
219         char ok_response[SIZ];
220         char nosup_response[SIZ];
221         char error_response[SIZ];
222
223         sprintf(ok_response, "382 Begin TLS negotiation now\r\n");
224         sprintf(nosup_response, "502 Can not initiate TLS negotiation\r\n");
225         sprintf(error_response, "580 Internal error\r\n");
226         CtdlModuleStartCryptoMsgs(ok_response, nosup_response, error_response);
227 }
228
229
230 //
231 // Implements the CAPABILITY command
232 //
233 void nntp_capabilities(void)
234 {
235         cprintf("101 Capability list:\r\n");
236         cprintf("IMPLEMENTATION Citadel v%d.%02d\r\n", (REV_LEVEL/100), (REV_LEVEL%100));
237         cprintf("VERSION 2\r\n");
238         cprintf("READER\r\n");
239         cprintf("MODE-READER\r\n");
240         cprintf("LIST ACTIVE NEWSGROUPS\r\n");
241 #ifdef HAVE_OPENSSL
242         cprintf("STARTTLS\r\n");
243 #endif
244         if (!CC->logged_in) {
245                 cprintf("AUTHINFO USER\r\n");
246         }
247         cprintf(".\r\n");
248 }
249
250
251 // 
252 // Implements the QUIT command
253 //
254 void nntp_quit(void)
255 {
256         cprintf("221 Goodbye...\r\n");
257         CC->kill_me = KILLME_CLIENT_LOGGED_OUT;
258 }
259
260
261 //
262 // Cleanup hook for this module
263 //
264 void nntp_cleanup(void)
265 {
266         /* nothing here yet */
267 }
268
269
270 //
271 // Implements the AUTHINFO USER command (RFC 4643)
272 //
273 void nntp_authinfo_user(const char *username)
274 {
275         int a = CtdlLoginExistingUser(NULL, username);
276         switch (a) {
277         case login_already_logged_in:
278                 cprintf("482 Already logged in\r\n");
279                 return;
280         case login_too_many_users:
281                 cprintf("481 Too many users are already online (maximum is %d)\r\n", config.c_maxsessions);
282                 return;
283         case login_ok:
284                 cprintf("381 Password required for %s\r\n", CC->curr_user);
285                 return;
286         case login_not_found:
287                 cprintf("481 %s not found\r\n", username);
288                 return;
289         default:
290                 cprintf("502 Internal error\r\n");
291         }
292 }
293
294
295 //
296 // Implements the AUTHINFO PASS command (RFC 4643)
297 //
298 void nntp_authinfo_pass(const char *buf)
299 {
300         int a;
301
302         a = CtdlTryPassword(buf, strlen(buf));
303
304         switch (a) {
305         case pass_already_logged_in:
306                 cprintf("482 Already logged in\r\n");
307                 return;
308         case pass_no_user:
309                 cprintf("482 Authentication commands issued out of sequence\r\n");
310                 return;
311         case pass_wrong_password:
312                 cprintf("481 Authentication failed\r\n");
313                 return;
314         case pass_ok:
315                 cprintf("281 Authentication accepted\r\n");
316                 return;
317         }
318 }
319
320
321 //
322 // Implements the AUTHINFO extension (RFC 4643) in USER/PASS mode
323 //
324 void nntp_authinfo(const char *cmd) {
325
326         if (!strncasecmp(cmd, "authinfo user ", 14)) {
327                 nntp_authinfo_user(&cmd[14]);
328         }
329
330         else if (!strncasecmp(cmd, "authinfo pass ", 14)) {
331                 nntp_authinfo_pass(&cmd[14]);
332         }
333
334         else {
335                 cprintf("502 command unavailable\r\n");
336         }
337 }
338
339
340 //
341 // Utility function to fetch the current list of message numbers in a room
342 //
343 struct nntp_msglist nntp_fetch_msglist(struct ctdlroom *qrbuf) {
344         struct nntp_msglist nm;
345         struct cdbdata *cdbfr;
346
347         cdbfr = cdb_fetch(CDB_MSGLISTS, &qrbuf->QRnumber, sizeof(long));
348         if (cdbfr != NULL) {
349                 nm.msgnums = (long*)cdbfr->ptr;
350                 cdbfr->ptr = NULL;
351                 nm.num_msgs = cdbfr->len / sizeof(long);
352                 cdbfr->len = 0;
353                 cdb_free(cdbfr);
354         } else {
355                 nm.num_msgs = 0;
356                 nm.msgnums = NULL;
357         }
358         return(nm);
359 }
360
361
362 //
363 // Output a room name (newsgroup name) in formats required for LIST and NEWGROUPS command
364 //
365 void output_roomname_in_list_format(struct ctdlroom *qrbuf, int which_format, char *wildmat_pattern) {
366         char n_name[1024];
367         struct nntp_msglist nm;
368         long low_water_mark = 0;
369         long high_water_mark = 0;
370
371         room_to_newsgroup(n_name, qrbuf->QRname, sizeof n_name);
372
373         if ((wildmat_pattern != NULL) && (!IsEmptyStr(wildmat_pattern))) {
374                 if (!wildmat(n_name, wildmat_pattern)) {
375                         return;
376                 }
377         }
378
379         nm = nntp_fetch_msglist(qrbuf);
380         if ((nm.num_msgs > 0) && (nm.msgnums != NULL)) {
381                 low_water_mark = nm.msgnums[0];
382                 high_water_mark = nm.msgnums[nm.num_msgs - 1];
383         }
384
385         // Only the mandatory formats are supported
386         switch(which_format) {
387         case NNTP_LIST_ACTIVE:
388                 // FIXME we have hardcoded "n" for "no posting allowed" -- fix when we add posting
389                 cprintf("%s %ld %ld n\r\n", n_name, high_water_mark, low_water_mark);
390                 break;
391         case NNTP_LIST_NEWSGROUPS:
392                 cprintf("%s %s\r\n", n_name, qrbuf->QRname);
393                 break;
394         }
395
396         if (nm.msgnums != NULL) {
397                 free(nm.msgnums);
398         }
399 }
400
401
402 //
403 // Called once per room by nntp_newgroups() to qualify and possibly output a single room
404 //
405 void nntp_newgroups_backend(struct ctdlroom *qrbuf, void *data)
406 {
407         int ra;
408         int view;
409         time_t thetime = *(time_t *)data;
410
411         CtdlRoomAccess(qrbuf, &CC->user, &ra, &view);
412
413         /*
414          * The "created after <date/time>" heuristics depend on the happy coincidence
415          * that for a very long time we have used a unix timestamp as the room record's
416          * generation number (QRgen).  When this module is merged into the master
417          * source tree we should rename QRgen to QR_create_time or something like that.
418          */
419
420         if (ra & UA_KNOWN) {
421                 if (qrbuf->QRgen >= thetime) {
422                         output_roomname_in_list_format(qrbuf, NNTP_LIST_ACTIVE, NULL);
423                 }
424         }
425 }
426
427
428 //
429 // Implements the NEWGROUPS command
430 //
431 void nntp_newgroups(const char *cmd) {
432         /*
433          * HACK: this works because the 5XX series error codes from citadel
434          * protocol will also be considered error codes by an NNTP client
435          */
436         if (CtdlAccessCheck(ac_logged_in_or_guest)) return;
437
438
439         char stringy_date[16];
440         char stringy_time[16];
441         char stringy_gmt[16];
442         struct tm tm;
443         time_t thetime;
444
445         extract_token(stringy_date, cmd, 1, ' ', sizeof stringy_date);
446         extract_token(stringy_time, cmd, 2, ' ', sizeof stringy_time);
447         extract_token(stringy_gmt, cmd, 3, ' ', sizeof stringy_gmt);
448
449         memset(&tm, 0, sizeof tm);
450         if (strlen(stringy_date) == 6) {
451                 sscanf(stringy_date, "%2d%2d%2d", &tm.tm_year, &tm.tm_mon, &tm.tm_mday);
452                 tm.tm_year += 100;
453         }
454         else {
455                 sscanf(stringy_date, "%4d%2d%2d", &tm.tm_year, &tm.tm_mon, &tm.tm_mday);
456                 tm.tm_year -= 1900;
457         }
458         tm.tm_mon -= 1;         // tm_mon is zero based (0=January)
459         tm.tm_isdst = (-1);     // let the C library figure out whether DST is in effect
460         sscanf(stringy_time, "%2d%2d%2d", &tm.tm_hour, &tm.tm_min ,&tm.tm_sec);
461         thetime = mktime(&tm);
462         if (!strcasecmp(stringy_gmt, "GMT")) {
463                 tzset();
464                 thetime += timezone;
465         }
466
467
468         cprintf("231 list of new newsgroups follows\r\n");
469         CtdlGetUser(&CC->user, CC->curr_user);
470         CtdlForEachRoom(nntp_newgroups_backend, &thetime);
471         cprintf(".\r\n");
472 }
473
474
475 //
476 // Called once per room by nntp_list() to qualify and possibly output a single room
477 //
478 void nntp_list_backend(struct ctdlroom *qrbuf, void *data)
479 {
480         int ra;
481         int view;
482         struct nntp_list_data *nld = (struct nntp_list_data *)data;
483
484         CtdlRoomAccess(qrbuf, &CC->user, &ra, &view);
485         if (ra & UA_KNOWN) {
486                 output_roomname_in_list_format(qrbuf, nld->list_format, nld->wildmat_pattern);
487         }
488 }
489
490
491 //
492 // Implements the LIST commands
493 //
494 void nntp_list(const char *cmd) {
495         //
496         // HACK: this works because the 5XX series error codes from citadel
497         // protocol will also be considered error codes by an NNTP client
498         //
499         if (CtdlAccessCheck(ac_logged_in_or_guest)) return;
500
501         char list_format[64];
502         char wildmat_pattern[1024];
503         struct nntp_list_data nld;
504
505         extract_token(list_format, cmd, 1, ' ', sizeof list_format);
506         extract_token(wildmat_pattern, cmd, 2, ' ', sizeof wildmat_pattern);
507
508         if (strlen(wildmat_pattern) > 0) {
509                 nld.wildmat_pattern = wildmat_pattern;
510         }
511         else {
512                 nld.wildmat_pattern = NULL;
513         }
514
515         if ( (strlen(cmd) < 6) || (!strcasecmp(list_format, "ACTIVE")) ) {
516                 nld.list_format = NNTP_LIST_ACTIVE;
517         }
518         else if (!strcasecmp(list_format, "NEWSGROUPS")) {
519                 nld.list_format = NNTP_LIST_NEWSGROUPS;
520         }
521         else {
522                 cprintf("501 syntax error , unsupported list format\r\n");
523                 return;
524         }
525
526         cprintf("215 list of newsgroups follows\r\n");
527         CtdlGetUser(&CC->user, CC->curr_user);
528         CtdlForEachRoom(nntp_list_backend, &nld);
529         cprintf(".\r\n");
530 }
531
532
533 //
534 // Implement HELP command.
535 //
536 void nntp_help(void) {
537         cprintf("100 This is the Citadel NNTP service.\r\n");
538         cprintf("RTFM http://www.ietf.org/rfc/rfc3977.txt\r\n");
539         cprintf(".\r\n");
540 }
541
542
543 //
544 // back end for the LISTGROUP command , called for each message number
545 //
546 void nntp_listgroup_backend(long msgnum, void *userdata) {
547
548         struct listgroup_range *lr = (struct listgroup_range *)userdata;
549
550         // check range if supplied
551         if (msgnum < lr->lo) return;
552         if ((lr->hi != 0) && (msgnum > lr->hi)) return;
553
554         cprintf("%ld\r\n", msgnum);
555 }
556
557
558 //
559 // Implements the GROUP and LISTGROUP commands
560 //
561 void nntp_group(const char *cmd) {
562         //
563         // HACK: this works because the 5XX series error codes from citadel
564         // protocol will also be considered error codes by an NNTP client
565         //
566         if (CtdlAccessCheck(ac_logged_in_or_guest)) return;
567
568         citnntp *nntpstate = (citnntp *) CC->session_specific_data;
569         char verb[16];
570         char requested_group[1024];
571         char message_range[256];
572         char range_lo[256];
573         char range_hi[256];
574         char requested_room[ROOMNAMELEN];
575         char augmented_roomname[ROOMNAMELEN];
576         int c = 0;
577         int ok = 0;
578         int ra = 0;
579         struct ctdlroom QRscratch;
580         int msgs, new;
581         long oldest,newest;
582         struct listgroup_range lr;
583
584         extract_token(verb, cmd, 0, ' ', sizeof verb);
585         extract_token(requested_group, cmd, 1, ' ', sizeof requested_group);
586         extract_token(message_range, cmd, 2, ' ', sizeof message_range);
587         extract_token(range_lo, message_range, 0, '-', sizeof range_lo);
588         extract_token(range_hi, message_range, 1, '-', sizeof range_hi);
589         lr.lo = atoi(range_lo);
590         lr.hi = atoi(range_hi);
591
592         /* In LISTGROUP mode we can specify an empty name for 'currently selected' */
593         if ((!strcasecmp(verb, "LISTGROUP")) && (IsEmptyStr(requested_group))) {
594                 room_to_newsgroup(requested_group, CC->room.QRname, sizeof requested_group);
595         }
596
597         /* First try a regular match */
598         newsgroup_to_room(requested_room, requested_group, sizeof requested_room);
599         c = CtdlGetRoom(&QRscratch, requested_room);
600
601         /* Then try a mailbox name match */
602         if (c != 0) {
603                 CtdlMailboxName(augmented_roomname, sizeof augmented_roomname, &CC->user, requested_room);
604                 c = CtdlGetRoom(&QRscratch, augmented_roomname);
605                 if (c == 0) {
606                         safestrncpy(requested_room, augmented_roomname, sizeof(requested_room));
607                 }
608         }
609
610         /* If the room exists, check security/access */
611         if (c == 0) {
612                 /* See if there is an existing user/room relationship */
613                 CtdlRoomAccess(&QRscratch, &CC->user, &ra, NULL);
614
615                 /* normal clients have to pass through security */
616                 if (ra & UA_KNOWN) {
617                         ok = 1;
618                 }
619         }
620
621         /* Fail here if no such room */
622         if (!ok) {
623                 cprintf("411 no such newsgroup\r\n");
624                 return;
625         }
626
627
628         /*
629          * CtdlUserGoto() formally takes us to the desired room, happily returning
630          * the number of messages and number of new messages.
631          */
632         memcpy(&CC->room, &QRscratch, sizeof(struct ctdlroom));
633         CtdlUserGoto(NULL, 0, 0, &msgs, &new, &oldest, &newest);
634         cprintf("211 %d %ld %ld %s\r\n", msgs, oldest, newest, requested_group);
635
636         // If this is a GROUP command, set the "current article number" to zero, and then stop here.
637         if (!strcasecmp(verb, "GROUP")) {
638                 nntpstate->current_article_number = oldest;
639                 return;
640         }
641
642         // If we get to this point we are running a LISTGROUP command.  Fetch those message numbers.
643         CtdlForEachMessage(MSGS_ALL, 0L, NULL, NULL, NULL, nntp_listgroup_backend, &lr);
644         cprintf(".\r\n");
645 }
646
647
648 //
649 // Implements the MODE command
650 //
651 void nntp_mode(const char *cmd) {
652
653         char which_mode[16];
654
655         extract_token(which_mode, cmd, 1, ' ', sizeof which_mode);
656
657         if (!strcasecmp(which_mode, "reader")) {
658                 cprintf("201 Reader mode FIXME implement posting and change to 200\r\n");
659         }
660         else {
661                 cprintf("501 unknown mode\r\n");
662         }
663 }
664
665
666 //
667 // Implements the ARTICLE, HEAD, BODY, and STAT commands.
668 // (These commands all accept the same parameters; they differ only in how they output the retrieved message.)
669 //
670 void nntp_article(const char *cmd) {
671         /*
672          * HACK: this works because the 5XX series error codes from citadel
673          * protocol will also be considered error codes by an NNTP client
674          */
675         if (CtdlAccessCheck(ac_logged_in_or_guest)) return;
676
677         citnntp *nntpstate = (citnntp *) CC->session_specific_data;
678         char which_command[16];
679         int acmd = 0;
680         char requested_article[256];
681         long requested_msgnum = 0;
682         char *lb, *rb = NULL;
683         int must_change_currently_selected_article = 0;
684
685         // We're going to store one of these values in the variable 'acmd' so that
686         enum {
687                 ARTICLE,
688                 HEAD,
689                 BODY,
690                 STAT
691         };
692
693         extract_token(which_command, cmd, 0, ' ', sizeof which_command);
694
695         if (!strcasecmp(which_command, "article")) {
696                 acmd = ARTICLE;
697         }
698         else if (!strcasecmp(which_command, "head")) {
699                 acmd = HEAD;
700         }
701         else if (!strcasecmp(which_command, "body")) {
702                 acmd = BODY;
703         }
704         else if (!strcasecmp(which_command, "stat")) {
705                 acmd = STAT;
706         }
707         else {
708                 cprintf("500 I'm afraid I can't do that.\r\n");
709                 return;
710         }
711
712         // Which NNTP command was issued, determines whether we will fetch headers, body, or both.
713         int                     headers_only = HEADERS_ALL;
714         if (acmd == HEAD)       headers_only = HEADERS_FAST;
715         else if (acmd == BODY)  headers_only = HEADERS_NONE;
716         else if (acmd == STAT)  headers_only = HEADERS_FAST;
717
718         // now figure out what the client is asking for.
719         extract_token(requested_article, cmd, 1, ' ', sizeof requested_article);
720         lb = strchr(requested_article, '<');
721         rb = strchr(requested_article, '>');
722         requested_msgnum = atol(requested_article);
723
724         // If no article number or message-id is specified, the client wants the "currently selected article"
725         if (IsEmptyStr(requested_article)) {
726                 if (nntpstate->current_article_number < 1) {
727                         cprintf("420 No current article selected\r\n");
728                         return;
729                 }
730                 requested_msgnum = nntpstate->current_article_number;
731                 must_change_currently_selected_article = 1;
732                 // got it -- now fall through and keep going
733         }
734
735         // If the requested article is numeric, it maps directly to a message number.  Good.
736         else if (requested_msgnum > 0) {
737                 must_change_currently_selected_article = 1;
738                 // good -- fall through and keep going
739         }
740
741         // If the requested article has angle brackets, the client wants a specific message-id.
742         // We don't know how to do that yet.
743         else if ( (lb != NULL) && (rb != NULL) && (lb < rb) ) {
744                 must_change_currently_selected_article = 0;
745                 cprintf("500 FIXME I don't know how to fetch by message-id yet.\r\n");
746                 return;
747         }
748
749         // Anything else is noncompliant gobbledygook and should die in a car fire.
750         else {
751                 must_change_currently_selected_article = 0;
752                 cprintf("500 syntax error\r\n");
753                 return;
754         }
755
756         // At this point we know the message number of the "article" being requested.
757         // We have an awesome API call that does all the heavy lifting for us.
758         char *fetched_message_id = NULL;
759         CC->redirect_buffer = NewStrBufPlain(NULL, SIZ);
760         int fetch = CtdlOutputMsg(requested_msgnum,
761                         MT_RFC822,              // output in RFC822 format ... sort of
762                         headers_only,           // headers, body, or both?
763                         0,                      // don't do Citadel protocol responses
764                         1,                      // CRLF newlines
765                         NULL,                   // teh whole thing, not just a section
766                         0,                      // no flags yet ... maybe new ones for Path: etc ?
767                         NULL,
768                         NULL,
769                         &fetched_message_id     // extract the message ID from the message as we go...
770         );
771         StrBuf *msgtext = CC->redirect_buffer;
772         CC->redirect_buffer = NULL;
773
774         if (fetch != om_ok) {
775                 cprintf("423 no article with that number\r\n");
776                 FreeStrBuf(&msgtext);
777                 return;
778         }
779
780         // RFC3977 6.2.1.2 specifes conditions under which the "currently selected article"
781         // MUST or MUST NOT be set to the message we just referenced.
782         if (must_change_currently_selected_article) {
783                 nntpstate->current_article_number = requested_msgnum;
784         }
785
786         // Now give the client what it asked for.
787         if (acmd == ARTICLE) {
788                 cprintf("220 %ld <%s>\r\n", requested_msgnum, fetched_message_id);
789         }
790         if (acmd == HEAD) {
791                 cprintf("221 %ld <%s>\r\n", requested_msgnum, fetched_message_id);
792         }
793         if (acmd == BODY) {
794                 cprintf("222 %ld <%s>\r\n", requested_msgnum, fetched_message_id);
795         }
796         if (acmd == STAT) {
797                 cprintf("223 %ld <%s>\r\n", requested_msgnum, fetched_message_id);
798                 FreeStrBuf(&msgtext);
799                 return;
800         }
801
802         client_write(SKEY(msgtext));
803         cprintf(".\r\n");                       // this protocol uses a dot terminator
804         FreeStrBuf(&msgtext);
805         if (fetched_message_id) free(fetched_message_id);
806 }
807
808
809 // 
810 // Main command loop for NNTP server sessions.
811 //
812 void nntp_command_loop(void)
813 {
814         StrBuf *Cmd = NewStrBuf();
815         char cmdname[16];
816
817         time(&CC->lastcmd);
818         if (CtdlClientGetLine(Cmd) < 1) {
819                 syslog(LOG_CRIT, "NNTP: client disconnected: ending session.\n");
820                 CC->kill_me = KILLME_CLIENT_DISCONNECTED;
821                 FreeStrBuf(&Cmd);
822                 return;
823         }
824         syslog(LOG_DEBUG, "NNTP: %s\n", ((!strncasecmp(ChrPtr(Cmd), "AUTHINFO", 8)) ? "AUTHINFO ..." : ChrPtr(Cmd)));
825         extract_token(cmdname, ChrPtr(Cmd), 0, ' ', sizeof cmdname);
826
827         // Rumpelstiltskin lookups are *awesome*
828
829         if (!strcasecmp(cmdname, "quit")) {
830                 nntp_quit();
831         }
832
833         else if (!strcasecmp(cmdname, "help")) {
834                 nntp_help();
835         }
836
837         else if (!strcasecmp(cmdname, "capabilities")) {
838                 nntp_capabilities();
839         }
840
841         else if (!strcasecmp(cmdname, "starttls")) {
842                 nntp_starttls();
843         }
844
845         else if (!strcasecmp(cmdname, "authinfo")) {
846                 nntp_authinfo(ChrPtr(Cmd));
847         }
848
849         else if (!strcasecmp(cmdname, "newgroups")) {
850                 nntp_newgroups(ChrPtr(Cmd));
851         }
852
853         else if (!strcasecmp(cmdname, "list")) {
854                 nntp_list(ChrPtr(Cmd));
855         }
856
857         else if (!strcasecmp(cmdname, "group")) {
858                 nntp_group(ChrPtr(Cmd));
859         }
860
861         else if (!strcasecmp(cmdname, "listgroup")) {
862                 nntp_group(ChrPtr(Cmd));
863         }
864
865         else if (!strcasecmp(cmdname, "mode")) {
866                 nntp_mode(ChrPtr(Cmd));
867         }
868
869         else if (
870                         (!strcasecmp(cmdname, "article"))
871                         || (!strcasecmp(cmdname, "head"))
872                         || (!strcasecmp(cmdname, "body"))
873                         || (!strcasecmp(cmdname, "stat"))
874                 ) {
875                 nntp_article(ChrPtr(Cmd));
876         }
877
878         else {
879                 cprintf("500 I'm afraid I can't do that.\r\n");
880         }
881
882         FreeStrBuf(&Cmd);
883 }
884
885
886 //      ****************************************************************************
887 //                            MODULE INITIALIZATION STUFF
888 //      ****************************************************************************
889
890
891 //
892 // This cleanup function blows away the temporary memory used by
893 // the NNTP server.
894 //
895 void nntp_cleanup_function(void)
896 {
897         /* Don't do this stuff if this is not an NNTP session! */
898         if (CC->h_command_function != nntp_command_loop) return;
899
900         syslog(LOG_DEBUG, "Performing NNTP cleanup hook\n");
901         citnntp *nntpstate = (citnntp *) CC->session_specific_data;
902         if (nntpstate != NULL) {
903                 free(nntpstate);
904                 nntpstate = NULL;
905         }
906 }
907
908 const char *CitadelServiceNNTP="NNTP";
909
910 CTDL_MODULE_INIT(nntp)
911 {
912         if (!threading)
913         {
914                 CtdlRegisterServiceHook(119,                    // FIXME config.c_nntp_port,
915                                         NULL,
916                                         nntp_greeting,
917                                         nntp_command_loop,
918                                         NULL, 
919                                         CitadelServiceNNTP);
920
921 #ifdef HAVE_OPENSSL
922                 CtdlRegisterServiceHook(563,                    // FIXME config.c_nntps_port,
923                                         NULL,
924                                         nntps_greeting,
925                                         nntp_command_loop,
926                                         NULL,
927                                         CitadelServiceNNTP);
928 #endif
929
930                 CtdlRegisterCleanupHook(nntp_cleanup);
931                 CtdlRegisterSessionHook(nntp_cleanup_function, EVT_STOP, PRIO_STOP + 250);
932         }
933         
934         /* return our module name for the log */
935         return "nntp";
936 }