* patch #3966: Create a mh_xmalloc function to prevent mistakes when
[mmh] / uip / flist.c
1 /*
2  * flist.c -- list nmh folders containing messages
3  *         -- in a given sequence
4  *
5  * originally by
6  * David Nichols, Xerox-PARC, November, 1992
7  *
8  * Copyright (c) 1994 Xerox Corporation.
9  * Use and copying of this software and preparation of derivative works based
10  * upon this software are permitted. Any distribution of this software or
11  * derivative works must comply with all applicable United States export
12  * control laws. This software is made available AS IS, and Xerox Corporation
13  * makes no warranty about the software, its performance or its conformity to
14  * any specification.
15  *
16  *  $Id$
17  */
18
19 #include <h/mh.h>
20 #include <h/utils.h>
21
22 #define FALSE   0
23 #define TRUE    1
24
25 /*
26  * We allocate space to record the names of folders
27  * (foldersToDo array), this number of elements at a time.
28  */
29 #define MAXFOLDERS  100
30
31
32 static struct swit switches[] = {
33 #define SEQSW           0
34     { "sequence name", 0 },
35 #define ALLSW           1
36     { "all", 0 },
37 #define NOALLSW         2
38     { "noall", 0 },
39 #define RECURSE         3
40     { "recurse", 0 },
41 #define NORECURSE       4
42     { "norecurse", 0 },
43 #define SHOWZERO        5
44     { "showzero", 0 },
45 #define NOSHOWZERO      6
46     { "noshowzero", 0 },
47 #define ALPHASW         7
48     { "alpha", 0 },
49 #define NOALPHASW       8
50     { "noalpha", 0 },
51 #define FASTSW          9
52     { "fast", 0 },
53 #define NOFASTSW        10
54     { "nofast", 0 },
55 #define TOTALSW         11
56     { "total", -5 },
57 #define NOTOTALSW       12
58     { "nototal", -7 },
59 #define VERSIONSW       13
60     { "version", 0 },
61 #define HELPSW          14
62     { "help", 0 },
63     { NULL, 0 }
64 };
65
66 struct Folder {
67     char *name;                 /* name of folder */
68     int priority;
69     int error;                  /* error == 1 for unreadable folder     */
70     int nMsgs;                  /* number of messages in folder         */
71     int nSeq[NUMATTRS];         /* number of messages in each sequence  */
72     int private[NUMATTRS];      /* is given sequence, public or private */
73 };
74
75 static struct Folder *orders = NULL;
76 static int nOrders = 0;
77 static int nOrdersAlloced = 0;
78 static struct Folder *folders = NULL;
79 static int nFolders = 0;
80 static int nFoldersAlloced = 0;
81
82 /* info on folders to search */
83 static char **foldersToDo;
84 static int numfolders;
85 static int maxfolders;
86
87 /* info on sequences to search for */
88 static char *sequencesToDo[NUMATTRS];
89 static int numsequences;
90
91 static int all        = FALSE;  /* scan all folders in top level?           */
92 static int alphaOrder = FALSE;  /* want alphabetical order only             */
93 static int recurse    = FALSE;  /* show nested folders?                     */
94 static int showzero   = TRUE;   /* show folders even if no messages in seq? */
95 static int Total      = TRUE;   /* display info on number of messages in    *
96                                  * sequence found, and total num messages   */
97
98 static char curfolder[BUFSIZ];  /* name of the current folder */
99 static char *nmhdir;            /* base nmh mail directory    */
100
101 /*
102  * Type for a compare function for qsort.  This keeps
103  * the compiler happy.
104  */
105 typedef int (*qsort_comp) (const void *, const void *);
106
107 /*
108  * prototypes
109  */
110 int CompareFolders(struct Folder *, struct Folder *);
111 void GetFolderOrder(void);
112 void ScanFolders(void);
113 int AddFolder(char *, int);
114 void BuildFolderList(char *, int);
115 void BuildFolderListRecurse(char *, struct stat *, int);
116 void PrintFolders(void);
117 static int num_digits (int);
118 void AllocFolders(struct Folder **, int *, int);
119 int AssignPriority(char *);
120 static void do_readonly_folders(void);
121
122
123
124 int
125 main(int argc, char **argv)
126 {
127     char *cp, **argp;
128     char **arguments;
129     char buf[BUFSIZ];
130
131 #ifdef LOCALE
132     setlocale(LC_ALL, "");
133 #endif
134     invo_name = r1bindex(argv[0], '/');
135
136     /* read user profile/context */
137     context_read();
138
139     /*
140      * If program was invoked with name ending
141      * in `s', then add switch `-all'.
142      */
143     if (argv[0][strlen (argv[0]) - 1] == 's')
144         all = TRUE;
145
146     arguments = getarguments (invo_name, argc, argv, 1);
147     argp = arguments;
148
149     /* allocate the initial space to record the folder names */
150     numfolders = 0;
151     maxfolders = MAXFOLDERS;
152     foldersToDo = (char **) mh_xmalloc ((size_t) (maxfolders * sizeof(*foldersToDo)));
153
154     /* no sequences yet */
155     numsequences = 0;
156
157     /* parse arguments */
158     while ((cp = *argp++)) {
159         if (*cp == '-') {
160             switch (smatch(++cp, switches)) {
161             case AMBIGSW:
162                 ambigsw(cp, switches);
163                 done(1);
164             case UNKWNSW:
165                 adios(NULL, "-%s unknown", cp);
166
167             case HELPSW:
168                 snprintf(buf, sizeof(buf), "%s [+folder1 [+folder2 ...]][switches]",
169                         invo_name);
170                 print_help(buf, switches, 1);
171                 done(1);
172             case VERSIONSW:
173                 print_version(invo_name);
174                 done (1);
175
176             case SEQSW:
177                 if (!(cp = *argp++) || *cp == '-')
178                     adios (NULL, "missing argument to %s", argp[-2]);
179
180                 /* check if too many sequences specified */
181                 if (numsequences >= NUMATTRS)
182                     adios (NULL, "too many sequences (more than %d) specified", NUMATTRS);
183                 sequencesToDo[numsequences++] = cp;
184                 break;
185
186             case ALLSW:
187                 all = TRUE;
188                 break;
189             case NOALLSW:
190                 all = FALSE;
191                 break;
192
193             case SHOWZERO:
194                 showzero = TRUE;
195                 break;
196             case NOSHOWZERO:
197                 showzero = FALSE;
198                 break;
199
200             case ALPHASW:
201                 alphaOrder = TRUE;
202                 break;
203             case NOALPHASW:
204                 alphaOrder = FALSE;
205                 break;
206
207             case NOFASTSW:
208             case TOTALSW:
209                 Total = TRUE;
210                 break;
211
212             case FASTSW:
213             case NOTOTALSW:
214                 Total = FALSE;
215                 break;
216
217             case RECURSE:
218                 recurse = TRUE;
219                 break;
220             case NORECURSE:
221                 recurse = FALSE;
222                 break;
223             }
224         } else {
225             /*
226              * Check if we need to allocate more space
227              * for folder names.
228              */
229             if (numfolders >= maxfolders) {
230                 maxfolders += MAXFOLDERS;
231                 if (!(foldersToDo = (char **) realloc (foldersToDo,
232                         (size_t) (maxfolders * sizeof(*foldersToDo)))))
233                     adios (NULL, "unable to reallocate folder name storage");
234             }
235             if (*cp == '+' || *cp == '@') {
236                 foldersToDo[numfolders++] =
237                     path (cp + 1, *cp == '+' ? TFOLDER : TSUBCWF);
238             } else
239                 foldersToDo[numfolders++] = cp;
240         }
241     }
242
243     if (!context_find ("path"))
244         free (path ("./", TFOLDER));
245
246     /* get current folder */
247     strncpy (curfolder, getfolder(1), sizeof(curfolder));
248
249     /* get nmh base directory */
250     nmhdir = m_maildir ("");
251
252     /*
253      * If we didn't specify any sequences, we search
254      * for the "Unseen-Sequence" profile entry and use
255      * all the sequences defined there.  We check to
256      * make sure that the Unseen-Sequence entry doesn't
257      * contain more than NUMATTRS sequences.
258      */
259     if (numsequences == 0) {
260         if ((cp = context_find(usequence)) && *cp) {
261             char **ap, *dp;
262
263             dp = getcpy(cp);
264             ap = brkstring (dp, " ", "\n");
265             for (; ap && *ap; ap++) {
266                 if (numsequences >= NUMATTRS)
267                     adios (NULL, "too many sequences (more than %d) in %s profile entry",
268                            NUMATTRS, usequence);
269                 else
270                     sequencesToDo[numsequences++] = *ap;
271             }
272         } else {
273             adios (NULL, "no sequence specified or %s profile entry found", usequence);
274         }
275     }
276
277     GetFolderOrder();
278     ScanFolders();
279     qsort(folders, nFolders, sizeof(struct Folder), (qsort_comp) CompareFolders);
280     PrintFolders();
281     return done (0);
282 }
283
284 /*
285  * Read the Flist-Order profile entry to determine
286  * how to sort folders for output.
287  */
288
289 void
290 GetFolderOrder(void)
291 {
292     char *p, *s;
293     int priority = 1;
294     struct Folder *o;
295
296     if (!(p = context_find("Flist-Order")))
297         return;
298     for (;;) {
299         while (isspace(*p))
300             ++p;
301         s = p;
302         while (*p && !isspace(*p))
303             ++p;
304         if (p != s) {
305             /* Found one. */
306             AllocFolders(&orders, &nOrdersAlloced, nOrders + 1);
307             o = &orders[nOrders++];
308             o->priority = priority++;
309             o->name = (char *) mh_xmalloc(p - s + 1);
310             strncpy(o->name, s, p - s);
311             o->name[p - s] = 0;
312         } else
313             break;
314     }
315 }
316
317 /*
318  * Scan all the necessary folders
319  */
320
321 void
322 ScanFolders(void)
323 {
324     int i;
325
326     /*
327      * change directory to base of nmh directory
328      */
329     if (chdir (nmhdir) == NOTOK)
330         adios (nmhdir, "unable to change directory to");
331
332     if (numfolders > 0) {
333         /* Update context */
334         strncpy (curfolder, foldersToDo[numfolders - 1], sizeof(curfolder));
335         context_replace (pfolder, curfolder);/* update current folder */
336         context_save ();                     /* save the context file */
337
338         /*
339          * Scan each given folder.  If -all is given,
340          * then also scan the 1st level subfolders under
341          * each given folder.
342          */
343         for (i = 0; i < numfolders; ++i)
344             BuildFolderList(foldersToDo[i], all ? 1 : 0);
345     } else {
346         if (all) {
347             /*
348              * Do the readonly folders
349              */
350             do_readonly_folders();
351
352             /*
353              * Now scan the entire nmh directory for folders
354              */
355             BuildFolderList(".", 0);
356         } else {
357             /*
358              * Else scan current folder
359              */
360             BuildFolderList(curfolder, 0);
361         }
362     }
363 }
364
365 /*
366  * Initial building of folder list for
367  * the top of our search tree.
368  */
369
370 void
371 BuildFolderList(char *dirName, int searchdepth)
372 {
373     struct stat st;
374
375     /* Make sure we have a directory */
376     if ((stat(dirName, &st) == -1) || !S_ISDIR(st.st_mode))
377         return;
378
379     /*
380      * If base directory, don't add it to the
381      * folder list. We just recurse into it.
382      */
383     if (!strcmp (dirName, ".")) {
384         BuildFolderListRecurse (".", &st, 0);
385         return;
386     }
387
388     /*
389      * Add this folder to the list.
390      * If recursing and directory has subfolders,
391      * then build folder list for subfolders.
392      */
393     if (AddFolder(dirName, showzero) && (recurse || searchdepth) && st.st_nlink > 2)
394         BuildFolderListRecurse(dirName, &st, searchdepth - 1);
395 }
396
397 /*
398  * Recursive building of folder list
399  */
400
401 void
402 BuildFolderListRecurse(char *dirName, struct stat *s, int searchdepth)
403 {
404     char *base, *n, name[PATH_MAX];
405     int nlinks;
406     DIR *dir;
407     struct dirent *dp;
408     struct stat st;
409
410     /*
411      * Keep track of number of directories we've seen so we can
412      * stop stat'ing entries in this directory once we've seen
413      * them all.  This optimization will fail if you have extra
414      * directories beginning with ".", since we don't bother to
415      * stat them.  But that shouldn't generally be a problem.
416      */
417     nlinks = s->st_nlink;
418
419     if (!(dir = opendir(dirName)))
420         adios(dirName, "can't open directory");
421
422     /*
423      * A hack so that we don't see a
424      * leading "./" in folder names.
425      */
426     base = strcmp (dirName, ".") ? dirName : dirName + 1;
427
428     while (nlinks && (dp = readdir(dir))) {
429         if (!strcmp(dp->d_name, ".") || !strcmp(dp->d_name, "..")) {
430             nlinks--;
431             continue;
432         }
433         if (dp->d_name[0] == '.')
434             continue;
435         /* Check to see if the name of the file is a number
436          * if it is, we assume it's a mail file and skip it
437          */
438         for (n = dp->d_name; *n && isdigit(*n); n++);
439         if (!*n)
440             continue;
441         strncpy (name, base, sizeof(name) - 2);
442         if (*base)
443             strcat(name, "/");
444         strncat(name, dp->d_name, sizeof(name) - strlen(name) - 1);
445         if ((stat(name, &st) != -1) && S_ISDIR(st.st_mode)) {
446             /*
447              * Check if this was really a symbolic link pointing
448              * to a directory.  If not, then decrement link count.
449              */
450             if (lstat (name, &st) == -1)
451                 nlinks--;
452             /* Add this folder to the list */
453             if (AddFolder(name, showzero) &&
454                         (recurse || searchdepth) && st.st_nlink > 2)
455                 BuildFolderListRecurse(name, &st, searchdepth - 1);
456         }
457     }
458     closedir(dir);
459 }
460
461 /*
462  * Add this folder to our list, counting the total number of
463  * messages and the number of messages in each sequence.
464  */
465
466 int
467 AddFolder(char *name, int force)
468 {
469     int i, msgnum, nonzero;
470     int seqnum[NUMATTRS], nSeq[NUMATTRS];
471     struct Folder *f;
472     struct msgs *mp;
473
474     /* Read folder and create message structure */
475     if (!(mp = folder_read (name))) {
476         /* Oops, error occurred.  Record it and continue. */
477         AllocFolders(&folders, &nFoldersAlloced, nFolders + 1);
478         f = &folders[nFolders++];
479         f->name = getcpy(name);
480         f->error = 1;
481         f->priority = AssignPriority(f->name);
482         return 0;
483     }
484
485     for (i = 0; i < numsequences; i++) {
486         /* Convert sequences to their sequence numbers */
487         if (sequencesToDo[i])
488             seqnum[i] = seq_getnum(mp, sequencesToDo[i]);
489         else
490             seqnum[i] = -1;
491
492         /* Now count messages in this sequence */
493         nSeq[i] = 0;
494         if (mp->nummsg > 0 && seqnum[i] != -1) {
495             for (msgnum = mp->lowmsg; msgnum <= mp->hghmsg; msgnum++) {
496                 if (in_sequence(mp, seqnum[i], msgnum))
497                     nSeq[i]++;
498             }
499         }
500     }
501
502     /* Check if any of the sequence checks were nonzero */
503     nonzero = 0;
504     for (i = 0; i < numsequences; i++) {
505         if (nSeq[i] > 0) {
506             nonzero = 1;
507             break;
508         }
509     }
510
511     if (nonzero || force) {
512         /* save general folder information */
513         AllocFolders(&folders, &nFoldersAlloced, nFolders + 1);
514         f = &folders[nFolders++];
515         f->name = getcpy(name);
516         f->nMsgs = mp->nummsg;
517         f->error = 0;
518         f->priority = AssignPriority(f->name);
519
520         /* record the sequence information */
521         for (i = 0; i < numsequences; i++) {
522             f->nSeq[i] = nSeq[i];
523             f->private[i] = (seqnum[i] != -1) ? is_seq_private(mp, seqnum[i]) : 0;
524         }
525     }
526
527     folder_free (mp);   /* free folder/message structure */
528     return 1;
529 }
530
531 /*
532  * Print the folder/sequence information
533  */
534
535 void
536 PrintFolders(void)
537 {
538     char tmpname[BUFSIZ];
539     int i, j, len, has_private = 0;
540     int maxfolderlen = 0, maxseqlen = 0;
541     int maxnum = 0, maxseq = 0;
542
543     if (!Total) {
544         for (i = 0; i < nFolders; i++)
545             printf("%s\n", folders[i].name);
546         return;
547     }
548
549     /*
550      * Find the width we need for various fields
551      */
552     for (i = 0; i < nFolders; ++i) {
553         /* find the length of longest folder name */
554         len = strlen(folders[i].name);
555         if (len > maxfolderlen)
556             maxfolderlen = len;
557
558         /* If folder had error, skip the rest */
559         if (folders[i].error)
560             continue;
561
562         /* find the maximum total messages */
563         if (folders[i].nMsgs > maxnum)
564             maxnum = folders[i].nMsgs;
565
566         for (j = 0; j < numsequences; j++) {
567             /* find maximum width of sequence name */
568             len = strlen (sequencesToDo[j]);
569             if ((folders[i].nSeq[j] > 0 || showzero) && (len > maxseqlen))
570                 maxseqlen = len;
571
572             /* find the maximum number of messages in sequence */
573             if (folders[i].nSeq[j] > maxseq)
574                 maxseq = folders[i].nSeq[j];
575
576             /* check if this sequence is private in any of the folders */
577             if (folders[i].private[j])
578                 has_private = 1;
579         }
580     }
581
582     /* Now print all the folder/sequence information */
583     for (i = 0; i < nFolders; i++) {
584         for (j = 0; j < numsequences; j++) {
585             if (folders[i].nSeq[j] > 0 || showzero) {
586                 /* Add `+' to end of name of current folder */
587                 if (strcmp(curfolder, folders[i].name))
588                     snprintf(tmpname, sizeof(tmpname), "%s", folders[i].name);
589                 else
590                     snprintf(tmpname, sizeof(tmpname), "%s+", folders[i].name);
591
592                 if (folders[i].error) {
593                     printf("%-*s is unreadable\n", maxfolderlen+1, tmpname);
594                     continue;
595                 }
596
597                 printf("%-*s has %*d in sequence %-*s%s; out of %*d\n",
598                        maxfolderlen+1, tmpname,
599                        num_digits(maxseq), folders[i].nSeq[j],
600                        maxseqlen, sequencesToDo[j],
601                        !has_private ? "" : folders[i].private[j] ? " (private)" : "          ",
602                        num_digits(maxnum), folders[i].nMsgs);
603             }
604         }
605     }
606 }
607
608 /*
609  * Calculate the number of digits in a nonnegative integer
610  */
611 static int
612 num_digits (int n)
613 {
614     int ndigits = 0;
615
616     /* Sanity check */
617     if (n < 0)
618         adios (NULL, "oops, num_digits called with negative value");
619
620     if (n == 0)
621         return 1;
622
623     while (n) {
624         n /= 10;
625         ndigits++;
626     }
627
628     return ndigits;
629 }
630
631 /*
632  * Put them in priority order.
633  */
634
635 int
636 CompareFolders(struct Folder *f1, struct Folder *f2)
637 {
638     if (!alphaOrder && f1->priority != f2->priority)
639         return f1->priority - f2->priority;
640     else
641         return strcmp(f1->name, f2->name);
642 }
643
644 /*
645  * Make sure we have at least n folders allocated.
646  */
647
648 void
649 AllocFolders(struct Folder **f, int *nfa, int n)
650 {
651     if (n <= *nfa)
652         return;
653     if (*f == NULL) {
654         *nfa = 10;
655         *f = (struct Folder *) mh_xmalloc (*nfa * (sizeof(struct Folder)));
656     } else {
657         *nfa *= 2;
658         *f = (struct Folder *) realloc (*f, *nfa * (sizeof(struct Folder)));
659     }
660 }
661
662 /*
663  * Return the priority for a name.  The highest comes from an exact match.
664  * After that, the longest match (then first) assigns the priority.
665  */
666 int
667 AssignPriority(char *name)
668 {
669     int i, ol, nl;
670     int best = nOrders;
671     int bestLen = 0;
672     struct Folder *o;
673
674     nl = strlen(name);
675     for (i = 0; i < nOrders; ++i) {
676         o = &orders[i];
677         if (!strcmp(name, o->name))
678             return o->priority;
679         ol = strlen(o->name);
680         if (nl < ol - 1)
681             continue;
682         if (ol < bestLen)
683             continue;
684         if (o->name[0] == '*' && !strcmp(o->name + 1, name + (nl - ol + 1))) {
685             best = o->priority;
686             bestLen = ol;
687         } else if (o->name[ol - 1] == '*' && strncmp(o->name, name, ol - 1) == 0) {
688             best = o->priority;
689             bestLen = ol;
690         }
691     }
692     return best;
693 }
694
695 /*
696  * Do the read only folders
697  */
698
699 static void
700 do_readonly_folders (void)
701 {
702     int atrlen;
703     char atrcur[BUFSIZ];
704     register struct node *np;
705
706     snprintf (atrcur, sizeof(atrcur), "atr-%s-", current);
707     atrlen = strlen (atrcur);
708
709     for (np = m_defs; np; np = np->n_next)
710         if (ssequal (atrcur, np->n_name)
711                 && !ssequal (nmhdir, np->n_name + atrlen))
712             BuildFolderList (np->n_name + atrlen, 0);
713 }