summaryrefslogtreecommitdiffstats
path: root/src/global/mail_scan_dir.c
blob: f011536c28f3a4cd1c0f86ad71cc9619c2c1484f (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
/*++
/* NAME
/*	mail_scan_dir 3
/* SUMMARY
/*	mail queue directory scanning support
/* SYNOPSIS
/*	#include <mail_scan_dir.h>
/*
/*	char	*mail_scan_dir_next(scan)
/*	SCAN_DIR *scan;
/* DESCRIPTION
/*	The \fBmail_scan_dir_next\fR() routine is a wrapper around
/*	scan_dir_next() that understands the structure of a Postfix
/*	mail queue.  The result is a queue ID or a null pointer.
/* SEE ALSO
/*	scan_dir(3) directory scanner
/* LICENSE
/* .ad
/* .fi
/*	The Secure Mailer license must be distributed with this software.
/* AUTHOR(S)
/*	Wietse Venema
/*	IBM T.J. Watson Research
/*	P.O. Box 704
/*	Yorktown Heights, NY 10598, USA
/*--*/

/* System library. */

#include <sys_defs.h>
#include <string.h>

/* Utility library. */

#include <scan_dir.h>

/* Global library. */

#include <mail_scan_dir.h>

/* mail_scan_dir_next - return next queue file */

char   *mail_scan_dir_next(SCAN_DIR *scan)
{
    char   *name;

    /*
     * Exploit the fact that mail queue subdirectories have one-letter names,
     * so we don't have to stat() every file in sight. This is a win because
     * many dirent implementations do not return file type information.
     */
    for (;;) {
	if ((name = scan_dir_next(scan)) == 0) {
	    if (scan_dir_pop(scan) == 0)
		return (0);
	} else if (strlen(name) == 1) {
	    scan_dir_push(scan, name);
	} else {
	    return (name);
	}
    }
}