xref: /netbsd-src/external/ibm-public/postfix/dist/src/global/domain_list.c (revision d25ffa98a4bfca1fe272f3c182496ec9934faac7)
1 /*	$NetBSD: domain_list.c,v 1.1.1.1 2009/06/23 10:08:45 tron Exp $	*/
2 
3 /*++
4 /* NAME
5 /*	domain_list 3
6 /* SUMMARY
7 /*	match a host or domain name against a pattern list
8 /* SYNOPSIS
9 /*	#include <domain_list.h>
10 /*
11 /*	DOMAIN_LIST *domain_list_init(flags, pattern_list)
12 /*	int	flags;
13 /*	const char *pattern_list;
14 /*
15 /*	int	domain_list_match(list, name)
16 /*	DOMAIN_LIST *list;
17 /*	const char *name;
18 /*
19 /*	void domain_list_free(list)
20 /*	DOMAIN_LIST *list;
21 /* DESCRIPTION
22 /*	This is a convenience wrapper around the match_list module.
23 /*
24 /*	This module implements tests for list membership of a host or
25 /*	domain name.
26 /*
27 /*	Patterns are separated by whitespace and/or commas. A pattern
28 /*	is either a string, a file name (in which case the contents
29 /*	of the file are substituted for the file name) or a type:name
30 /*	lookup table specification.
31 /*
32 /*	A host name matches a domain list when its name appears in the
33 /*	list of domain patterns, or when any of its parent domains appears
34 /*	in the list of domain patterns. The matching process is case
35 /*	insensitive. In order to reverse the result, precede a
36 /*	pattern with an exclamation point (!).
37 /*
38 /*	domain_list_init() performs initializations. The first argument
39 /*	is the bit-wise OR of zero or more of the following:
40 /* .RS
41 /* .IP MATCH_FLAG_PARENT
42 /*      The hostname pattern foo.com matches itself and any name below
43 /*      the domain foo.com. If this flag is cleared, foo.com matches itself
44 /*	only, and .foo.com matches any name below the domain foo.com.
45 /* .RE
46 /*	Specify MATCH_FLAG_NONE to request none of the above.
47 /*	The second argument is a list of domain patterns, or the name of
48 /*	a file containing domain patterns.
49 /*
50 /*	domain_list_match() matches the specified host or domain name
51 /*	against the specified pattern list.
52 /*
53 /*	domain_list_free() releases storage allocated by domain_list_init().
54 /* DIAGNOSTICS
55 /*	Fatal error: unable to open or read a domain_list file; invalid
56 /*	domain_list pattern.
57 /* SEE ALSO
58 /*	match_list(3) generic list matching
59 /*	match_ops(3) match hosts by name or by address
60 /* LICENSE
61 /* .ad
62 /* .fi
63 /*	The Secure Mailer license must be distributed with this software.
64 /* AUTHOR(S)
65 /*	Wietse Venema
66 /*	IBM T.J. Watson Research
67 /*	P.O. Box 704
68 /*	Yorktown Heights, NY 10598, USA
69 /*--*/
70 
71 /* System library. */
72 
73 #include <sys_defs.h>
74 
75 /* Utility library. */
76 
77 #include <match_list.h>
78 
79 /* Global library. */
80 
81 #include "domain_list.h"
82 
83 #ifdef TEST
84 
85 #include <msg.h>
86 #include <stdlib.h>
87 #include <unistd.h>
88 #include <vstream.h>
89 #include <msg_vstream.h>
90 
91 static void usage(char *progname)
92 {
93     msg_fatal("usage: %s [-v] patterns hostname", progname);
94 }
95 
96 int     main(int argc, char **argv)
97 {
98     DOMAIN_LIST *list;
99     char   *host;
100     int     ch;
101 
102     msg_vstream_init(argv[0], VSTREAM_ERR);
103 
104     while ((ch = GETOPT(argc, argv, "v")) > 0) {
105 	switch (ch) {
106 	case 'v':
107 	    msg_verbose++;
108 	    break;
109 	default:
110 	    usage(argv[0]);
111 	}
112     }
113     if (argc != optind + 2)
114 	usage(argv[0]);
115     list = domain_list_init(MATCH_FLAG_PARENT, argv[optind]);
116     host = argv[optind + 1];
117     vstream_printf("%s: %s\n", host, domain_list_match(list, host) ?
118 		   "YES" : "NO");
119     vstream_fflush(VSTREAM_OUT);
120     domain_list_free(list);
121     return (0);
122 }
123 
124 #endif
125