Arrange to call dns_init() for host_find_byname() as well as for
[exim.git] / src / src / functions.h
CommitLineData
322050c2 1/* $Cambridge: exim/src/src/functions.h,v 1.28 2006/10/09 14:36:25 ph10 Exp $ */
059ec3d9
PH
2
3/*************************************************
4* Exim - an Internet mail transport agent *
5*************************************************/
6
d7d7b7b9 7/* Copyright (c) University of Cambridge 1995 - 2006 */
059ec3d9
PH
8/* See the file NOTICE for conditions of use and distribution. */
9
10
11/* Prototypes for functions that appear in various modules. Gathered together
12to avoid having a lot of tiddly little headers with only a couple of lines in
13them. However, some functions that are used (or not used) by utility programs
14are in in fact in separate headers. */
15
16
17#ifdef EXIM_PERL
18extern uschar *call_perl_cat(uschar *, int *, int *, uschar **, uschar *,
19 uschar **);
20extern void cleanup_perl(void);
21extern uschar *init_perl(uschar *);
22#endif
23
24
25#ifdef SUPPORT_TLS
26extern int tls_client_start(int, host_item *, address_item *, uschar *,
27 uschar *, uschar *, uschar *, uschar *, uschar *, int);
28extern void tls_close(BOOL);
29extern int tls_feof(void);
30extern int tls_ferror(void);
31extern int tls_getc(void);
32extern int tls_read(uschar *, size_t);
33extern int tls_server_start(uschar *);
34extern int tls_ungetc(int);
35extern int tls_write(const uschar *, size_t);
36#endif
37
38
39/* Everything else... */
40
41extern acl_block *acl_read(uschar *(*)(void), uschar **);
42extern int acl_check(int, uschar *, uschar *, uschar **, uschar **);
38a0a95f
PH
43extern tree_node *acl_var_create(uschar *);
44extern void acl_var_write(uschar *, uschar *, void *);
059ec3d9
PH
45extern uschar *auth_b64encode(uschar *, int);
46extern int auth_b64decode(uschar *, uschar **);
47extern int auth_call_pam(uschar *, uschar **);
48extern int auth_call_pwcheck(uschar *, uschar **);
49extern int auth_call_radius(uschar *, uschar **);
50extern int auth_call_saslauthd(uschar *, uschar *, uschar *, uschar *,
51 uschar **);
52extern int auth_get_data(uschar **, uschar *, int);
53extern int auth_get_no64_data(uschar **, uschar *);
54extern uschar *auth_xtextencode(uschar *, int);
55extern int auth_xtextdecode(uschar *, uschar **);
56
32d668a5 57extern int check_host(void *, uschar *, uschar **, uschar **);
059ec3d9
PH
58extern uschar **child_exec_exim(int, BOOL, int *, BOOL, int, ...);
59extern pid_t child_open_uid(uschar **, uschar **, int, uid_t *, gid_t *,
60 int *, int *, uschar *, BOOL);
61
62extern void daemon_go(void);
63extern void debug_print_argv(uschar **);
64extern void debug_print_ids(uschar *);
65extern void debug_print_string(uschar *);
66extern void debug_print_tree(tree_node *);
67extern void debug_vprintf(char *, va_list);
68extern address_item *deliver_make_addr(uschar *, BOOL);
69extern int deliver_message(uschar *, BOOL, BOOL);
70extern void deliver_msglog(const char *, ...);
71extern void deliver_set_expansions(address_item *);
72extern int deliver_split_address(address_item *);
73extern void deliver_succeeded(address_item *);
8523533c
TK
74#ifdef WITH_OLD_DEMIME
75extern int demime(uschar **);
76#endif
059ec3d9 77extern BOOL directory_make(uschar *, uschar *, int, BOOL);
fb2274d4
TK
78#ifdef EXPERIMENTAL_DOMAINKEYS
79extern BOOL dk_transport_write_message(address_item *, int, int,
80 int, uschar *, uschar *, uschar *, uschar *, rewrite_rule *,
81 int, uschar *, uschar *, uschar *, uschar *, uschar *, uschar *);
82#endif
059ec3d9
PH
83extern dns_address *dns_address_from_rr(dns_answer *, dns_record *);
84extern void dns_build_reverse(uschar *, uschar *);
85extern void dns_init(BOOL, BOOL);
86extern int dns_basic_lookup(dns_answer *, uschar *, int);
87extern int dns_lookup(dns_answer *, uschar *, int, uschar **);
33397d19 88extern int dns_special_lookup(dns_answer *, uschar *, int, uschar **);
059ec3d9
PH
89extern dns_record *dns_next_rr(dns_answer *, dns_scan *, int);
90extern uschar *dns_text_type(int);
91
92extern void enq_end(uschar *);
93extern BOOL enq_start(uschar *);
94extern void exim_exit(int);
95extern void exim_nullstd(void);
96extern void exim_setugid(uid_t, gid_t, BOOL, uschar *);
97extern int exim_tvcmp(struct timeval *, struct timeval *);
98extern void exim_wait_tick(struct timeval *, int);
99extern BOOL expand_check_condition(uschar *, uschar *, uschar *);
100extern uschar *expand_string(uschar *);
101extern uschar *expand_string_copy(uschar *);
d45b1de8 102extern int expand_string_integer(uschar *, BOOL);
059ec3d9
PH
103
104extern int filter_interpret(uschar *, int, address_item **, uschar **);
105extern BOOL filter_personal(string_item *, BOOL);
f05da2e8 106extern BOOL filter_runtest(int, uschar *, BOOL, BOOL);
059ec3d9
PH
107extern BOOL filter_system_interpret(address_item **, uschar **);
108
109extern void header_add(int, char *, ...);
110extern int header_checkname(header_line *, BOOL);
111extern BOOL header_match(uschar *, BOOL, BOOL, string_item *, int, ...);
7cd1141b 112extern int host_address_extract_port(uschar *);
059ec3d9
PH
113extern uschar *host_and_ident(BOOL);
114extern int host_aton(uschar *, int *);
115extern void host_build_hostlist(host_item **, uschar *, BOOL);
116extern ip_address_item *host_build_ifacelist(uschar *, uschar *);
117extern void host_build_log_info(void);
118extern void host_build_sender_fullhost(void);
322050c2 119extern BOOL host_find_byname(host_item *, uschar *, int, uschar **, BOOL);
059ec3d9
PH
120extern int host_find_bydns(host_item *, uschar *, int, uschar *, uschar *,
121 uschar *,uschar **, BOOL *);
122extern ip_address_item *host_find_interfaces(void);
123extern BOOL host_is_in_net(uschar *, uschar *, int);
124extern BOOL host_is_tls_on_connect_port(int);
7cd1141b 125extern int host_item_get_port(host_item *);
059ec3d9
PH
126extern void host_mask(int, int *, int);
127extern int host_name_lookup(void);
6f0c9a4f 128extern int host_nmtoa(int, int *, int, uschar *, int);
059ec3d9
PH
129extern uschar *host_ntoa(int, const void *, uschar *, int *);
130extern int host_scan_for_local_hosts(host_item *, host_item **, BOOL *);
131
132extern int ip_bind(int, int, uschar *, int);
133extern int ip_connect(int, int, uschar *, int, int);
134extern void ip_keepalive(int, uschar *, BOOL);
135extern int ip_recv(int, uschar *, int, int);
136extern int ip_socket(int, int);
137
138extern uschar *local_part_quote(uschar *lpart);
139extern void log_close_all(void);
140
8523533c
TK
141#ifdef WITH_CONTENT_SCAN
142extern int malware(uschar **);
143#endif
059ec3d9
PH
144extern int match_address_list(uschar *, BOOL, BOOL, uschar **,
145 unsigned int *, int, int, uschar **);
146extern int match_check_list(uschar **, int, tree_node **, unsigned int **,
147 int(*)(void *, uschar *, uschar **, uschar **), void *, int,
148 uschar *, uschar **);
149extern int match_isinlist(uschar *, uschar **, int, tree_node **,
150 unsigned int *, int, BOOL, uschar **);
151extern int match_check_string(uschar *, uschar *, int, BOOL, BOOL, BOOL,
152 uschar **);
153extern void md5_end(md5 *, const uschar *, int, uschar *);
154extern void md5_mid(md5 *, const uschar *);
155extern void md5_start(md5 *);
156extern void millisleep(int);
8523533c
TK
157#ifdef WITH_CONTENT_SCAN
158struct mime_boundary_context;
54cdb463
PH
159extern int mime_acl_check(uschar *acl, FILE *f,
160 struct mime_boundary_context *, uschar **, uschar **);
8523533c
TK
161extern int mime_decode(uschar **);
162extern int mime_regex(uschar **);
163#endif
059ec3d9
PH
164extern uschar *moan_check_errorcopy(uschar *);
165extern BOOL moan_skipped_syntax_errors(uschar *, error_block *, uschar *,
166 BOOL, uschar *);
167extern void moan_smtp_batch(uschar *, char *, ...);
168extern void moan_tell_someone(uschar *, address_item *, uschar *, char *,
169 ...);
170extern BOOL moan_to_sender(int, error_block *, header_line *, FILE *, BOOL);
2632889e 171extern FILE *modefopen(uschar *, char *, mode_t);
059ec3d9
PH
172
173extern uschar *parse_extract_address(uschar *, uschar **, int *, int *, int *,
174 BOOL);
175extern int parse_forward_list(uschar *, int, address_item **, uschar **,
176 uschar *, uschar *, error_block **);
177extern uschar *parse_find_address_end(uschar *, BOOL);
178extern uschar *parse_find_at(uschar *);
179extern uschar *parse_fix_phrase(uschar *, int, uschar *, int);
30dba1e6 180extern uschar *parse_message_id(uschar *, uschar **, uschar **);
46218253 181extern uschar *parse_quote_2047(uschar *, int, uschar *, uschar *, int, BOOL);
059ec3d9
PH
182
183extern BOOL queue_action(uschar *, int, uschar **, int, int);
184extern void queue_check_only(void);
185extern void queue_list(int, uschar **, int);
186extern void queue_count(void);
187extern void queue_run(uschar *, uschar *, BOOL);
188
189extern int random_number(int);
8523533c
TK
190#ifdef WITH_CONTENT_SCAN
191extern int recv_line(int, uschar *, int);
192#endif
e4a89c47
PH
193extern int rda_interpret(redirect_block *, int, uschar *, uschar *,
194 uschar *, uschar *, ugid_block *, address_item **, uschar **,
195 error_block **, int *, uschar *);
059ec3d9
PH
196extern int rda_is_filter(const uschar *);
197extern BOOL readconf_depends(driver_instance *, uschar *);
198extern void readconf_driver_init(uschar *, driver_instance **,
199 driver_info *, int, void *, int, optionlist *, int);
200extern uschar *readconf_find_option(void *);
201extern void readconf_main(void);
202extern void readconf_print(uschar *, uschar *);
203extern uschar *readconf_printtime(int);
204extern uschar *readconf_readname(uschar *, int, uschar *);
205extern int readconf_readtime(uschar *, int, BOOL);
206extern void readconf_rest(BOOL);
207extern uschar *readconf_retry_error(uschar *, uschar *, int *, int *);
208extern void receive_bomb_out(uschar *);
209extern BOOL receive_check_fs(int);
210extern BOOL receive_check_set_sender(uschar *);
211extern BOOL receive_msg(BOOL);
8e669ac1 212extern int receive_statvfs(BOOL, int *);
059ec3d9 213extern void receive_swallow_smtp(void);
8523533c
TK
214#ifdef WITH_CONTENT_SCAN
215extern int regex(uschar **);
216#endif
059ec3d9
PH
217extern BOOL regex_match_and_setup(const pcre *, uschar *, int, int);
218extern const pcre *regex_must_compile(uschar *, BOOL, BOOL);
219extern void retry_add_item(address_item *, uschar *, int);
220extern BOOL retry_check_address(uschar *, host_item *, uschar *, BOOL,
221 uschar **, uschar **);
222extern retry_config *retry_find_config(uschar *, uschar *, int, int);
223extern void retry_update(address_item **, address_item **, address_item **);
224extern uschar *rewrite_address(uschar *, BOOL, BOOL, rewrite_rule *, int);
225extern uschar *rewrite_address_qualify(uschar *, BOOL);
226extern header_line *rewrite_header(header_line *, uschar *, uschar *,
227 rewrite_rule *, int, BOOL);
228extern uschar *rewrite_one(uschar *, int, BOOL *, BOOL, uschar *,
229 rewrite_rule *);
230extern void rewrite_test(uschar *);
231extern uschar *rfc2047_decode2(uschar *, BOOL, uschar *, int, int *, int *,
232 uschar **);
233extern int route_address(address_item *, address_item **, address_item **,
234 address_item **, address_item **, int);
235extern int route_check_prefix(uschar *, uschar *);
236extern int route_check_suffix(uschar *, uschar *);
237extern BOOL route_findgroup(uschar *, gid_t *);
238extern BOOL route_finduser(uschar *, struct passwd **, uid_t *);
239extern BOOL route_find_expanded_group(uschar *, uschar *, uschar *, gid_t *,
240 uschar **);
241extern BOOL route_find_expanded_user(uschar *, uschar *, uschar *,
242 struct passwd **, uid_t *, uschar **);
243extern void route_init(void);
244extern void route_tidyup(void);
245
246extern uschar *search_find(void *, uschar *, uschar *, int, uschar *, int,
247 int, int *);
248extern int search_findtype(uschar *, int);
249extern int search_findtype_partial(uschar *, int *, uschar **, int *,
250 int *);
251extern void *search_open(uschar *, int, int, uid_t *, gid_t *);
252extern void search_tidyup(void);
253extern void set_process_info(char *, ...);
254extern void sha1_end(sha1 *, const uschar *, int, uschar *);
255extern void sha1_mid(sha1 *, const uschar *);
256extern void sha1_start(sha1 *);
e4a89c47
PH
257extern int sieve_interpret(uschar *, int, uschar *, uschar *, uschar *,
258 address_item **, uschar **);
059ec3d9
PH
259extern void sigalrm_handler(int);
260extern void smtp_closedown(uschar *);
261extern int smtp_connect(host_item *, int, int, uschar *, int, BOOL);
262extern int smtp_feof(void);
263extern int smtp_ferror(void);
264extern uschar *smtp_get_connection_info(void);
265extern BOOL smtp_get_interface(uschar *, int, address_item *, BOOL *,
266 uschar **, uschar *);
267extern BOOL smtp_get_port(uschar *, address_item *, int *, uschar *);
268extern int smtp_getc(void);
269extern int smtp_handle_acl_fail(int, int, uschar *, uschar *);
270extern BOOL smtp_read_response(smtp_inblock *, uschar *, int, int, int);
a5bd321b 271extern void smtp_respond(uschar *, int, BOOL, uschar *);
059ec3d9
PH
272extern void smtp_send_prohibition_message(int, uschar *);
273extern int smtp_setup_msg(void);
274extern BOOL smtp_start_session(void);
275extern int smtp_ungetc(int);
d7b47fd0 276extern BOOL smtp_verify_helo(void);
059ec3d9 277extern int smtp_write_command(smtp_outblock *, BOOL, char *, ...);
8523533c
TK
278#ifdef WITH_CONTENT_SCAN
279extern int spam(uschar **);
f7b63901 280extern FILE *spool_mbox(unsigned long *);
8523533c 281#endif
059ec3d9
PH
282extern BOOL spool_move_message(uschar *, uschar *, uschar *, uschar *);
283extern BOOL spool_open_datafile(uschar *);
284extern int spool_open_temp(uschar *);
285extern int spool_read_header(uschar *, BOOL, BOOL);
286extern int spool_write_header(uschar *, int, uschar **);
287extern int stdin_getc(void);
288extern int stdin_feof(void);
289extern int stdin_ferror(void);
290extern int stdin_ungetc(int);
291extern uschar *string_append(uschar *, int *, int *, int, ...);
292extern uschar *string_base62(unsigned long int);
293extern uschar *string_cat(uschar *, int *, int *, const uschar *, int);
294extern uschar *string_copy_dnsdomain(uschar *);
295extern uschar *string_copy_malloc(uschar *);
296extern uschar *string_copylc(uschar *);
297extern uschar *string_copynlc(uschar *, int);
298extern uschar *string_dequote(uschar **);
299extern BOOL string_format(uschar *, int, char *, ...);
300extern uschar *string_format_size(int, uschar *);
301extern int string_interpret_escape(uschar **);
302extern int string_is_ip_address(uschar *, int *);
303extern uschar *string_log_address(address_item *, BOOL, BOOL);
304extern uschar *string_nextinlist(uschar **, int *, uschar *, int);
305extern uschar *string_open_failed(int, char *, ...);
306extern uschar *string_printing2(uschar *, BOOL);
307extern BOOL string_vformat(uschar *, int, char *, va_list);
308extern int strcmpic(uschar *, uschar *);
309extern int strncmpic(uschar *, uschar *, int);
310extern uschar *strstric(uschar *, uschar *, BOOL);
311
312extern uschar *tod_stamp(int);
313extern BOOL transport_check_waiting(uschar *, uschar *, int, uschar *,
314 BOOL *);
315extern void transport_init(void);
316extern BOOL transport_pass_socket(uschar *, uschar *, uschar *, uschar *,
317 int);
318extern uschar *transport_rcpt_address(address_item *, BOOL);
319extern BOOL transport_set_up_command(uschar ***, uschar *, BOOL, int,
320 address_item *, uschar *, uschar **);
321extern void transport_update_waiting(host_item *, uschar *);
322extern BOOL transport_write_block(int, uschar *, int);
323extern BOOL transport_write_string(int, char *, ...);
324extern BOOL transport_write_message(address_item *, int, int, int, uschar *,
325 uschar *, uschar *, uschar *, rewrite_rule *, int);
326extern void tree_add_duplicate(uschar *, address_item *);
327extern void tree_add_nonrecipient(uschar *);
328extern void tree_add_unusable(host_item *);
329extern int tree_insertnode(tree_node **, tree_node *);
330extern tree_node *tree_search(tree_node *, uschar *);
331extern void tree_write(tree_node *, FILE *);
38a0a95f 332extern void tree_walk(tree_node *, void (*)(uschar*, uschar*, void*), void *);
059ec3d9 333
8523533c
TK
334#ifdef WITH_CONTENT_SCAN
335extern void unspool_mbox(void);
336#endif
337
4deaf07d
PH
338extern int verify_address(address_item *, FILE *, int, int, int, int,
339 uschar *, uschar *, BOOL *);
059ec3d9 340extern int verify_check_dnsbl(uschar **);
4deaf07d 341extern int verify_check_header_address(uschar **, uschar **, int, int, int,
fe5b5d0b 342 uschar *, uschar *, int, int *);
059ec3d9
PH
343extern int verify_check_headers(uschar **);
344extern int verify_check_host(uschar **);
1c41c9cc 345extern int verify_check_notblind(void);
059ec3d9
PH
346extern int verify_check_this_host(uschar **, unsigned int *, uschar*,
347 uschar *, uschar **);
348extern address_item *verify_checked_sender(uschar *);
349extern void verify_get_ident(int);
350extern BOOL verify_sender(int *, uschar **);
351extern BOOL verify_sender_preliminary(int *, uschar **);
352extern void version_init(void);
353
354/* End of functions.h */