projects / exim.git / blame_incremental
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (non-incremental) | history | HEAD
Remove the daemon pid file when exit is due to SIGTERM. Bug 340
[exim.git] / src / src / functions.h
... / ...
CommitLineData
1/*************************************************
2* Exim - an Internet mail transport agent *
3*************************************************/
4
5/* Copyright (c) University of Cambridge 1995 - 2018 */
6/* See the file NOTICE for conditions of use and distribution. */
7
8
9/* Prototypes for functions that appear in various modules. Gathered together
10to avoid having a lot of tiddly little headers with only a couple of lines in
11them. However, some functions that are used (or not used) by utility programs
12are in in fact in separate headers. */
13#ifndef _FUNCTIONS_H_
14#define _FUNCTIONS_H_
15
16#include <sys/time.h>
17
18
19#ifdef EXIM_PERL
20extern gstring *call_perl_cat(gstring *, uschar **, uschar *,
21 uschar **) WARN_UNUSED_RESULT;
22extern void cleanup_perl(void);
23extern uschar *init_perl(uschar *);
24#endif
25
26
27#ifndef DISABLE_TLS
28extern const char *
29 std_dh_prime_default(void);
30extern const char *
31 std_dh_prime_named(const uschar *);
32
33extern uschar * tls_cert_crl_uri(void *, uschar * mod);
34extern uschar * tls_cert_ext_by_oid(void *, uschar *, int);
35extern uschar * tls_cert_issuer(void *, uschar * mod);
36extern uschar * tls_cert_not_before(void *, uschar * mod);
37extern uschar * tls_cert_not_after(void *, uschar * mod);
38extern uschar * tls_cert_ocsp_uri(void *, uschar * mod);
39extern uschar * tls_cert_serial_number(void *, uschar * mod);
40extern uschar * tls_cert_signature(void *, uschar * mod);
41extern uschar * tls_cert_signature_algorithm(void *, uschar * mod);
42extern uschar * tls_cert_subject(void *, uschar * mod);
43extern uschar * tls_cert_subject_altname(void *, uschar * mod);
44extern uschar * tls_cert_version(void *, uschar * mod);
45
46extern uschar * tls_cert_der_b64(void * cert);
47extern uschar * tls_cert_fprt_md5(void *);
48extern uschar * tls_cert_fprt_sha1(void *);
49extern uschar * tls_cert_fprt_sha256(void *);
50
51extern BOOL tls_client_start(client_conn_ctx *, smtp_connect_args *,
52 void *, tls_support *, uschar **);
53
54extern void tls_close(void *, int);
55extern BOOL tls_could_read(void);
56extern void tls_daemon_init(void);
57extern BOOL tls_dropprivs_validate_require_cipher(BOOL);
58extern BOOL tls_export_cert(uschar *, size_t, void *);
59extern int tls_feof(void);
60extern int tls_ferror(void);
61extern void tls_free_cert(void **);
62extern int tls_getc(unsigned);
63extern uschar *tls_getbuf(unsigned *);
64extern void tls_get_cache(void);
65extern BOOL tls_import_cert(const uschar *, void **);
66extern int tls_read(void *, uschar *, size_t);
67extern int tls_server_start(const uschar *, uschar **);
68extern BOOL tls_smtp_buffered(void);
69extern int tls_ungetc(int);
70extern int tls_write(void *, const uschar *, size_t, BOOL);
71extern uschar *tls_validate_require_cipher(void);
72extern void tls_version_report(FILE *);
73# ifdef USE_OPENSSL
74extern BOOL tls_openssl_options_parse(uschar *, long *);
75# endif
76extern uschar * tls_field_from_dn(uschar *, const uschar *);
77extern BOOL tls_is_name_for_cert(const uschar *, void *);
78
79# ifdef SUPPORT_DANE
80extern int tlsa_lookup(const host_item *, dns_answer *, BOOL);
81# endif
82
83#endif /*DISABLE_TLS*/
84
85
86/* Everything else... */
87
88extern acl_block *acl_read(uschar *(*)(void), uschar **);
89extern int acl_check(int, uschar *, uschar *, uschar **, uschar **);
90extern int acl_eval(int, uschar *, uschar **, uschar **);
91
92extern tree_node *acl_var_create(uschar *);
93extern void acl_var_write(uschar *, uschar *, void *);
94
95#ifdef EXPERIMENTAL_ARC
96extern void *arc_ams_setup_sign_bodyhash(void);
97extern const uschar *arc_header_feed(gstring *, BOOL);
98extern gstring *arc_sign(const uschar *, gstring *, uschar **);
99extern void arc_sign_init(void);
100extern const uschar *acl_verify_arc(void);
101extern uschar * fn_arc_domains(void);
102#endif
103
104extern void assert_no_variables(void *, int, const char *, int);
105extern int auth_call_pam(const uschar *, uschar **);
106extern int auth_call_pwcheck(uschar *, uschar **);
107extern int auth_call_radius(const uschar *, uschar **);
108extern int auth_call_saslauthd(const uschar *, const uschar *,
109 const uschar *, const uschar *, uschar **);
110extern int auth_check_serv_cond(auth_instance *);
111extern int auth_check_some_cond(auth_instance *, uschar *, uschar *, int);
112extern int auth_client_item(void *, auth_instance *, const uschar **,
113 unsigned, int, uschar *, int);
114
115
116extern int auth_get_data(uschar **, const uschar *, int);
117extern int auth_get_no64_data(uschar **, uschar *);
118extern int auth_prompt(const uschar *);
119extern int auth_read_input(const uschar *);
120extern void auth_show_supported(FILE *);
121extern uschar *auth_xtextencode(uschar *, int);
122extern int auth_xtextdecode(uschar *, uschar **);
123
124#ifdef EXPERIMENTAL_ARC
125extern gstring *authres_arc(gstring *);
126#endif
127#ifndef DISABLE_DKIM
128extern gstring *authres_dkim(gstring *);
129#endif
130#ifdef SUPPORT_DMARC
131extern gstring *authres_dmarc(gstring *);
132#endif
133extern gstring *authres_smtpauth(gstring *);
134#ifdef SUPPORT_SPF
135extern gstring *authres_spf(gstring *);
136#endif
137
138extern uschar *b64encode(const uschar *, int);
139extern int b64decode(const uschar *, uschar **);
140extern int bdat_getc(unsigned);
141extern uschar *bdat_getbuf(unsigned *);
142extern int bdat_ungetc(int);
143extern void bdat_flush_data(void);
144
145extern void bits_clear(unsigned int *, size_t, int *);
146extern void bits_set(unsigned int *, size_t, int *);
147
148extern void cancel_cutthrough_connection(BOOL, const uschar *);
149extern int check_host(void *, const uschar *, const uschar **, uschar **);
150extern uschar **child_exec_exim(int, BOOL, int *, BOOL, int, ...);
151extern pid_t child_open_uid(const uschar **, const uschar **, int,
152 uid_t *, gid_t *, int *, int *, uschar *, BOOL);
153extern BOOL cleanup_environment(void);
154extern void cutthrough_data_puts(uschar *, int);
155extern void cutthrough_data_put_nl(void);
156extern uschar *cutthrough_finaldot(void);
157extern BOOL cutthrough_flush_send(void);
158extern BOOL cutthrough_headers_send(void);
159extern BOOL cutthrough_predata(void);
160extern void release_cutthrough_connection(const uschar *);
161
162extern void daemon_go(void);
163
164#ifdef EXPERIMENTAL_DCC
165extern int dcc_process(uschar **);
166#endif
167
168extern void debug_logging_activate(uschar *, uschar *);
169extern void debug_logging_stop(void);
170extern void debug_print_argv(const uschar **);
171extern void debug_print_ids(uschar *);
172extern void debug_printf_indent(const char *, ...) PRINTF_FUNCTION(1,2);
173extern void debug_print_string(uschar *);
174extern void debug_print_tree(tree_node *);
175extern void debug_vprintf(int, const char *, va_list);
176extern void decode_bits(unsigned int *, size_t, int *,
177 uschar *, bit_table *, int, uschar *, int);
178extern void delete_pid_file(void);
179extern address_item *deliver_make_addr(uschar *, BOOL);
180extern void delivery_log(int, address_item *, int, uschar *);
181extern int deliver_message(uschar *, BOOL, BOOL);
182extern void deliver_msglog(const char *, ...) PRINTF_FUNCTION(1,2);
183extern void deliver_set_expansions(address_item *);
184extern int deliver_split_address(address_item *);
185extern void deliver_succeeded(address_item *);
186
187extern uschar *deliver_get_sender_address (uschar *id);
188extern void delivery_re_exec(int);
189
190extern BOOL directory_make(const uschar *, const uschar *, int, BOOL);
191#ifndef DISABLE_DKIM
192extern uschar *dkim_exim_query_dns_txt(const uschar *);
193extern void dkim_exim_sign_init(void);
194
195extern BOOL dkim_transport_write_message(transport_ctx *,
196 struct ob_dkim *, const uschar ** errstr);
197#endif
198extern dns_address *dns_address_from_rr(dns_answer *, dns_record *);
199extern int dns_basic_lookup(dns_answer *, const uschar *, int);
200extern void dns_build_reverse(const uschar *, uschar *);
201extern time_t dns_expire_from_soa(dns_answer *);
202extern void dns_init(BOOL, BOOL, BOOL);
203extern BOOL dns_is_aa(const dns_answer *);
204extern BOOL dns_is_secure(const dns_answer *);
205extern int dns_lookup(dns_answer *, const uschar *, int, const uschar **);
206extern void dns_pattern_init(void);
207extern int dns_special_lookup(dns_answer *, const uschar *, int, const uschar **);
208extern dns_record *dns_next_rr(const dns_answer *, dns_scan *, int);
209extern uschar *dns_text_type(int);
210extern void dscp_list_to_stream(FILE *);
211extern BOOL dscp_lookup(const uschar *, int, int *, int *, int *);
212
213extern void enq_end(uschar *);
214extern BOOL enq_start(uschar *, unsigned);
215#ifndef DISABLE_EVENT
216extern uschar *event_raise(uschar *, const uschar *, uschar *);
217extern void msg_event_raise(const uschar *, const address_item *);
218#endif
219
220extern int exim_chown_failure(int, const uschar*, uid_t, gid_t);
221extern const uschar * exim_errstr(int);
222extern void exim_exit(int, const uschar *) NORETURN;
223extern void exim_nullstd(void);
224extern void exim_setugid(uid_t, gid_t, BOOL, uschar *);
225extern void exim_underbar_exit(int);
226extern void exim_wait_tick(struct timeval *, int);
227extern int exp_bool(address_item *addr,
228 uschar *mtype, uschar *mname, unsigned dgb_opt, uschar *oname, BOOL bvalue,
229 uschar *svalue, BOOL *rvalue);
230extern BOOL expand_check_condition(uschar *, uschar *, uschar *);
231extern uschar *expand_file_big_buffer(const uschar *);
232extern uschar *expand_string(uschar *); /* public, cannot make const */
233extern const uschar *expand_cstring(const uschar *); /* ... so use this one */
234extern uschar *expand_hide_passwords(uschar * );
235extern uschar *expand_string_copy(const uschar *);
236extern int_eximarith_t expand_string_integer(uschar *, BOOL);
237extern void modify_variable(uschar *, void *);
238
239extern BOOL fd_ready(int, time_t);
240
241extern int filter_interpret(uschar *, int, address_item **, uschar **);
242extern BOOL filter_personal(string_item *, BOOL);
243extern BOOL filter_runtest(int, uschar *, BOOL, BOOL);
244extern BOOL filter_system_interpret(address_item **, uschar **);
245
246extern uschar * fn_hdrs_added(void);
247
248extern void header_add(int, const char *, ...);
249extern header_line *header_add_at_position_internal(BOOL, uschar *, BOOL, int, const char *, ...);
250extern int header_checkname(header_line *, BOOL);
251extern BOOL header_match(uschar *, BOOL, BOOL, string_item *, int, ...);
252extern int host_address_extract_port(uschar *);
253extern uschar *host_and_ident(BOOL);
254extern int host_aton(const uschar *, int *);
255extern void host_build_hostlist(host_item **, const uschar *, BOOL);
256extern ip_address_item *host_build_ifacelist(const uschar *, uschar *);
257extern void host_build_log_info(void);
258extern void host_build_sender_fullhost(void);
259extern int host_find_byname(host_item *, const uschar *, int,
260 const uschar **, BOOL);
261extern int host_find_bydns(host_item *, const uschar *, int, uschar *, uschar *,
262 uschar *, const dnssec_domains *, const uschar **, BOOL *);
263extern ip_address_item *host_find_interfaces(void);
264extern BOOL host_is_in_net(const uschar *, const uschar *, int);
265extern BOOL host_is_tls_on_connect_port(int);
266extern int host_item_get_port(host_item *);
267extern void host_mask(int, int *, int);
268extern int host_name_lookup(void);
269extern int host_nmtoa(int, int *, int, uschar *, int);
270extern uschar *host_ntoa(int, const void *, uschar *, int *);
271extern int host_scan_for_local_hosts(host_item *, host_item **, BOOL *);
272
273extern uschar *imap_utf7_encode(uschar *, const uschar *,
274 uschar, uschar *, uschar **);
275
276extern void invert_address(uschar *, uschar *);
277extern int ip_addr(void *, int, const uschar *, int);
278extern int ip_bind(int, int, uschar *, int);
279extern int ip_connect(int, int, const uschar *, int, int, const blob *);
280extern int ip_connectedsocket(int, const uschar *, int, int,
281 int, host_item *, uschar **, const blob *);
282extern int ip_get_address_family(int);
283extern void ip_keepalive(int, const uschar *, BOOL);
284extern int ip_recv(client_conn_ctx *, uschar *, int, time_t);
285extern int ip_socket(int, int);
286
287extern int ip_tcpsocket(const uschar *, uschar **, int);
288extern int ip_unixsocket(const uschar *, uschar **);
289extern int ip_streamsocket(const uschar *, uschar **, int);
290
291extern int ipv6_nmtoa(int *, uschar *);
292
293extern uschar *local_part_quote(uschar *);
294extern int log_create(uschar *);
295extern int log_create_as_exim(uschar *);
296extern void log_close_all(void);
297
298extern macro_item * macro_create(const uschar *, const uschar *, BOOL);
299extern BOOL macro_read_assignment(uschar *);
300extern uschar *macros_expand(int, int *, BOOL *);
301extern void mainlog_close(void);
302#ifdef WITH_CONTENT_SCAN
303extern int malware(const uschar *, int);
304extern int malware_in_file(uschar *);
305extern void malware_init(void);
306extern void malware_show_supported(FILE *);
307#endif
308extern int match_address_list(const uschar *, BOOL, BOOL, const uschar **,
309 unsigned int *, int, int, const uschar **);
310extern int match_address_list_basic(const uschar *, const uschar **, int);
311extern int match_check_list(const uschar **, int, tree_node **, unsigned int **,
312 int(*)(void *, const uschar *, const uschar **, uschar **), void *, int,
313 const uschar *, const uschar **);
314extern int match_isinlist(const uschar *, const uschar **, int, tree_node **,
315 unsigned int *, int, BOOL, const uschar **);
316extern int match_check_string(const uschar *, const uschar *, int, BOOL, BOOL, BOOL,
317 const uschar **);
318extern void md5_end(md5 *, const uschar *, int, uschar *);
319extern void md5_mid(md5 *, const uschar *);
320extern void md5_start(md5 *);
321extern void millisleep(int);
322#ifdef WITH_CONTENT_SCAN
323struct mime_boundary_context;
324extern int mime_acl_check(uschar *acl, FILE *f,
325 struct mime_boundary_context *, uschar **, uschar **);
326extern int mime_decode(const uschar **);
327extern ssize_t mime_decode_base64(FILE *, FILE *, uschar *);
328extern int mime_regex(const uschar **);
329extern void mime_set_anomaly(int);
330#endif
331extern uschar *moan_check_errorcopy(uschar *);
332extern BOOL moan_skipped_syntax_errors(uschar *, error_block *, uschar *,
333 BOOL, uschar *);
334extern void moan_smtp_batch(uschar *, const char *, ...) PRINTF_FUNCTION(2,3);
335extern BOOL moan_send_message(uschar *, int, error_block *eblock,
336 header_line *, FILE *, uschar *);
337extern void moan_tell_someone(uschar *, address_item *,
338 const uschar *, const char *, ...) PRINTF_FUNCTION(4,5);
339extern BOOL moan_to_sender(int, error_block *, header_line *, FILE *, BOOL);
340extern void moan_write_from(FILE *);
341extern void moan_write_references(FILE *, uschar *);
342extern FILE *modefopen(const uschar *, const char *, mode_t);
343
344extern int open_cutthrough_connection( address_item * addr );
345
346extern uschar *parse_extract_address(uschar *, uschar **, int *, int *, int *,
347 BOOL);
348extern int parse_forward_list(uschar *, int, address_item **, uschar **,
349 const uschar *, uschar *, error_block **);
350extern uschar *parse_find_address_end(uschar *, BOOL);
351extern uschar *parse_find_at(uschar *);
352extern const uschar *parse_fix_phrase(const uschar *, int, uschar *, int);
353extern uschar *parse_message_id(uschar *, uschar **, uschar **);
354extern const uschar *parse_quote_2047(const uschar *, int, uschar *, uschar *, int, BOOL);
355extern uschar *parse_date_time(uschar *str, time_t *t);
356extern int vaguely_random_number(int);
357#ifndef DISABLE_TLS
358extern int vaguely_random_number_fallback(int);
359#endif
360
361extern BOOL queue_action(uschar *, int, uschar **, int, int);
362extern void queue_check_only(void);
363extern void queue_list(int, uschar **, int);
364extern void queue_count(void);
365extern void queue_run(uschar *, uschar *, BOOL);
366
367extern int random_number(int);
368extern const uschar *rc_to_string(int);
369extern int rda_interpret(redirect_block *, int, uschar *, uschar *,
370 uschar *, uschar *, uschar *, ugid_block *, address_item **,
371 uschar **, error_block **, int *, uschar *);
372extern int rda_is_filter(const uschar *);
373extern BOOL readconf_depends(driver_instance *, uschar *);
374extern void readconf_driver_init(uschar *, driver_instance **,
375 driver_info *, int, void *, int, optionlist *, int);
376extern uschar *readconf_find_option(void *);
377extern void readconf_main(BOOL);
378extern void readconf_options_from_list(optionlist *, unsigned, const uschar *, uschar *);
379extern BOOL readconf_print(uschar *, uschar *, BOOL);
380extern uschar *readconf_printtime(int);
381extern uschar *readconf_readname(uschar *, int, uschar *);
382extern int readconf_readtime(const uschar *, int, BOOL);
383extern void readconf_rest(void);
384extern uschar *readconf_retry_error(const uschar *, const uschar *, int *, int *);
385extern void readconf_save_config(const uschar *);
386extern void read_message_body(BOOL);
387extern void receive_bomb_out(uschar *, uschar *) NORETURN;
388extern BOOL receive_check_fs(int);
389extern BOOL receive_check_set_sender(uschar *);
390extern BOOL receive_msg(BOOL);
391extern int_eximarith_t receive_statvfs(BOOL, int *);
392extern void receive_swallow_smtp(void);
393#ifdef WITH_CONTENT_SCAN
394extern int regex(const uschar **);
395#endif
396extern BOOL regex_match_and_setup(const pcre *, const uschar *, int, int);
397extern const pcre *regex_must_compile(const uschar *, BOOL, BOOL);
398extern void retry_add_item(address_item *, uschar *, int);
399extern BOOL retry_check_address(const uschar *, host_item *, uschar *, BOOL,
400 uschar **, uschar **);
401extern retry_config *retry_find_config(const uschar *, const uschar *, int, int);
402extern BOOL retry_ultimate_address_timeout(uschar *, const uschar *,
403 dbdata_retry *, time_t);
404extern void retry_update(address_item **, address_item **, address_item **);
405extern uschar *rewrite_address(uschar *, BOOL, BOOL, rewrite_rule *, int);
406extern uschar *rewrite_address_qualify(uschar *, BOOL);
407extern header_line *rewrite_header(header_line *,
408 const uschar *, const uschar *,
409 rewrite_rule *, int, BOOL);
410extern uschar *rewrite_one(uschar *, int, BOOL *, BOOL, uschar *,
411 rewrite_rule *);
412extern void rewrite_test(uschar *);
413extern uschar *rfc2047_decode2(uschar *, BOOL, uschar *, int, int *, int *,
414 uschar **);
415extern int route_address(address_item *, address_item **, address_item **,
416 address_item **, address_item **, int);
417extern int route_check_prefix(const uschar *, const uschar *);
418extern int route_check_suffix(const uschar *, const uschar *);
419extern BOOL route_findgroup(uschar *, gid_t *);
420extern BOOL route_finduser(const uschar *, struct passwd **, uid_t *);
421extern BOOL route_find_expanded_group(uschar *, uschar *, uschar *, gid_t *,
422 uschar **);
423extern BOOL route_find_expanded_user(uschar *, uschar *, uschar *,
424 struct passwd **, uid_t *, uschar **);
425extern void route_init(void);
426extern void route_show_supported(FILE *);
427extern void route_tidyup(void);
428
429extern uschar *search_find(void *, uschar *, uschar *, int, const uschar *, int,
430 int, int *);
431extern int search_findtype(const uschar *, int);
432extern int search_findtype_partial(const uschar *, int *, const uschar **, int *,
433 int *);
434extern void *search_open(uschar *, int, int, uid_t *, gid_t *);
435extern void search_tidyup(void);
436extern void set_process_info(const char *, ...) PRINTF_FUNCTION(1,2);
437extern void sha1_end(hctx *, const uschar *, int, uschar *);
438extern void sha1_mid(hctx *, const uschar *);
439extern void sha1_start(hctx *);
440extern int sieve_interpret(uschar *, int, uschar *, uschar *, uschar *,
441 uschar *, address_item **, uschar **);
442extern void sigalrm_handler(int);
443extern BOOL smtp_buffered(void);
444extern void smtp_closedown(uschar *);
445extern void smtp_command_timeout_exit(void) NORETURN;
446extern void smtp_command_sigterm_exit(void) NORETURN;
447extern void smtp_data_timeout_exit(void) NORETURN;
448extern void smtp_data_sigint_exit(void) NORETURN;
449extern void smtp_deliver_init(void);
450extern uschar *smtp_cmd_hist(void);
451extern int smtp_connect(smtp_connect_args *, const blob *);
452extern int smtp_sock_connect(host_item *, int, int, uschar *,
453 transport_instance * tb, int, const blob *);
454extern int smtp_feof(void);
455extern int smtp_ferror(void);
456extern uschar *smtp_get_connection_info(void);
457extern BOOL smtp_get_interface(uschar *, int, address_item *,
458 uschar **, uschar *);
459extern BOOL smtp_get_port(uschar *, address_item *, int *, uschar *);
460extern int smtp_getc(unsigned);
461extern uschar *smtp_getbuf(unsigned *);
462extern void smtp_get_cache(void);
463extern int smtp_handle_acl_fail(int, int, uschar *, uschar *);
464extern void smtp_log_no_mail(void);
465extern void smtp_message_code(uschar **, int *, uschar **, uschar **, BOOL);
466extern void smtp_proxy_tls(void *, uschar *, size_t, int *, int) NORETURN;
467extern BOOL smtp_read_response(void *, uschar *, int, int, int);
468extern void *smtp_reset(void *);
469extern void smtp_respond(uschar *, int, BOOL, uschar *);
470extern void smtp_notquit_exit(uschar *, uschar *, uschar *, ...);
471extern void smtp_port_for_connect(host_item *, int);
472extern void smtp_send_prohibition_message(int, uschar *);
473extern int smtp_setup_msg(void);
474extern BOOL smtp_start_session(void);
475extern int smtp_ungetc(int);
476extern BOOL smtp_verify_helo(void);
477extern int smtp_write_command(void *, int, const char *, ...) PRINTF_FUNCTION(3,4);
478#ifdef WITH_CONTENT_SCAN
479extern int spam(const uschar **);
480extern FILE *spool_mbox(unsigned long *, const uschar *, uschar **);
481#endif
482extern void spool_clear_header_globals(void);
483extern BOOL spool_move_message(uschar *, uschar *, uschar *, uschar *);
484extern int spool_open_datafile(uschar *);
485extern int spool_open_temp(uschar *);
486extern int spool_read_header(uschar *, BOOL, BOOL);
487extern int spool_write_header(uschar *, int, uschar **);
488extern int stdin_getc(unsigned);
489extern int stdin_feof(void);
490extern int stdin_ferror(void);
491extern int stdin_ungetc(int);
492
493extern void store_exit(void);
494extern gstring *string_append(gstring *, int, ...) WARN_UNUSED_RESULT;
495extern gstring *string_append_listele(gstring *, uschar, const uschar *) WARN_UNUSED_RESULT;
496extern gstring *string_append_listele_n(gstring *, uschar, const uschar *, unsigned) WARN_UNUSED_RESULT;
497extern gstring *string_append2_listele_n(gstring *, const uschar *, const uschar *, unsigned) WARN_UNUSED_RESULT;
498extern uschar *string_base62(unsigned long int);
499extern gstring *string_cat (gstring *, const uschar * ) WARN_UNUSED_RESULT;
500extern gstring *string_catn(gstring *, const uschar *, int) WARN_UNUSED_RESULT;
501extern int string_compare_by_pointer(const void *, const void *);
502extern uschar *string_copy_dnsdomain(uschar *);
503extern uschar *string_copy_malloc(const uschar *);
504extern uschar *string_dequote(const uschar **);
505extern uschar *string_format_size(int, uschar *);
506extern int string_interpret_escape(const uschar **);
507extern int string_is_ip_address(const uschar *, int *);
508#ifdef SUPPORT_I18N
509extern BOOL string_is_utf8(const uschar *);
510#endif
511extern uschar *string_nextinlist(const uschar **, int *, uschar *, int);
512extern const uschar *string_printing2(const uschar *, BOOL);
513extern uschar *string_split_message(uschar *);
514extern uschar *string_unprinting(uschar *);
515#ifdef SUPPORT_I18N
516extern uschar *string_address_utf8_to_alabel(const uschar *, uschar **);
517extern uschar *string_domain_alabel_to_utf8(const uschar *, uschar **);
518extern uschar *string_domain_utf8_to_alabel(const uschar *, uschar **);
519extern uschar *string_localpart_alabel_to_utf8(const uschar *, uschar **);
520extern uschar *string_localpart_utf8_to_alabel(const uschar *, uschar **);
521#endif
522
523#define string_format(buf, siz, fmt, ...) \
524 string_format_trc(buf, siz, US __FUNCTION__, __LINE__, fmt, __VA_ARGS__)
525extern BOOL string_format_trc(uschar *, int, const uschar *, unsigned,
526 const char *, ...) ALMOST_PRINTF(5,6);
527
528#define string_vformat(g, flgs, fmt, ap) \
529 string_vformat_trc(g, US __FUNCTION__, __LINE__, \
530 STRING_SPRINTF_BUFFER_SIZE, flgs, fmt, ap)
531extern gstring *string_vformat_trc(gstring *, const uschar *, unsigned,
532 unsigned, unsigned, const char *, va_list);
533
534#define string_open_failed(eno, fmt, ...) \
535 string_open_failed_trc(eno, US __FUNCTION__, __LINE__, fmt, __VA_ARGS__)
536extern uschar *string_open_failed_trc(int, const uschar *, unsigned,
537 const char *, ...) PRINTF_FUNCTION(4,5);
538
539extern int strcmpic(const uschar *, const uschar *);
540extern int strncmpic(const uschar *, const uschar *, int);
541extern uschar *strstric(uschar *, uschar *, BOOL);
542
543extern void tcp_init(void);
544#ifdef EXIM_TFO_PROBE
545extern void tfo_probe(void);
546#endif
547extern void tls_modify_variables(tls_support *);
548extern uschar *tod_stamp(int);
549
550extern BOOL transport_check_waiting(const uschar *, const uschar *, int, uschar *,
551 BOOL *, oicf, void*);
552extern void transport_init(void);
553extern void transport_do_pass_socket(const uschar *, const uschar *,
554 const uschar *, uschar *, int);
555extern BOOL transport_pass_socket(const uschar *, const uschar *, const uschar *, uschar *,
556 int);
557extern uschar *transport_rcpt_address(address_item *, BOOL);
558extern BOOL transport_set_up_command(const uschar ***, uschar *,
559 BOOL, int, address_item *, uschar *, uschar **);
560extern void transport_update_waiting(host_item *, uschar *);
561extern BOOL transport_write_block(transport_ctx *, uschar *, int, BOOL);
562extern void transport_write_reset(int);
563extern BOOL transport_write_string(int, const char *, ...);
564extern BOOL transport_headers_send(transport_ctx *,
565 BOOL (*)(transport_ctx *, uschar *, int));
566extern void transport_show_supported(FILE *);
567extern BOOL transport_write_message(transport_ctx *, int);
568extern void tree_add_duplicate(uschar *, address_item *);
569extern void tree_add_nonrecipient(uschar *);
570extern void tree_add_unusable(host_item *);
571extern void tree_dup(tree_node **, tree_node *);
572extern int tree_insertnode(tree_node **, tree_node *);
573extern tree_node *tree_search(tree_node *, const uschar *);
574extern void tree_write(tree_node *, FILE *);
575extern void tree_walk(tree_node *, void (*)(uschar*, uschar*, void*), void *);
576
577#ifdef WITH_CONTENT_SCAN
578extern void unspool_mbox(void);
579#endif
580#ifdef SUPPORT_I18N
581extern void utf8_version_report(FILE *);
582#endif
583
584extern int verify_address(address_item *, FILE *, int, int, int, int,
585 uschar *, uschar *, BOOL *);
586extern int verify_check_dnsbl(int, const uschar **, uschar **);
587extern int verify_check_header_address(uschar **, uschar **, int, int, int,
588 uschar *, uschar *, int, int *);
589extern int verify_check_headers(uschar **);
590extern int verify_check_header_names_ascii(uschar **);
591extern int verify_check_host(uschar **);
592extern int verify_check_notblind(BOOL);
593extern int verify_check_given_host(const uschar **, const host_item *);
594extern int verify_check_this_host(const uschar **, unsigned int *,
595 const uschar*, const uschar *, const uschar **);
596extern address_item *verify_checked_sender(uschar *);
597extern void verify_get_ident(int);
598extern BOOL verify_sender(int *, uschar **);
599extern BOOL verify_sender_preliminary(int *, uschar **);
600extern void version_init(void);
601
602extern BOOL write_chunk(transport_ctx *, uschar *, int);
603extern ssize_t write_to_fd_buf(int, const uschar *, size_t);
604
605
606#if !defined(MACRO_PREDEF) && !defined(COMPILE_UTILITY)
607/* exim_chown - in some NFSv4 setups *seemes* to be an issue with
608chown(<exim-uid>, <exim-gid>).
609
610Probably because the idmapping is broken, misconfigured or set up in
611an unusal way. (see Bug 2931). As I'm not sure, if this was a single
612case of misconfiguration, or if there are more such broken systems
613out, I try to impose as least impact as possible and for now just write
614a panic log entry pointing to the bug report. You're encouraged to
615contact the developers, if you experience this issue.
616
617fd the file descriptor (or -1 if not valid)
618name the file name for error messages or for file operations,
619 if fd is < 0
620owner the owner
621group the group
622
623returns 0 on success, -1 on failure */
624
625static inline int
626exim_fchown(int fd, uid_t owner, gid_t group, const uschar *name)
627{
628return fchown(fd, owner, group)
629 ? exim_chown_failure(fd, name, owner, group) : 0;
630}
631
632static inline int
633exim_chown(const uschar *name, uid_t owner, gid_t group)
634{
635return chown(CCS name, owner, group)
636 ? exim_chown_failure(-1, name, owner, group) : 0;
637}
638
639#endif /* !MACRO_PREDEF && !COMPILE_UTILITY */
640/******************************************************************************/
641/* String functions */
642
643#if !defined(MACRO_PREDEF)
644/*************************************************
645* Copy and save string *
646*************************************************/
647
648/* This function assumes that memcpy() is faster than strcpy().
649*/
650
651static inline uschar *
652string_copy_taint_trc(const uschar *s, BOOL tainted, const char * func, int line)
653{
654int len = Ustrlen(s) + 1;
655uschar *ss = store_get_3(len, tainted, func, line);
656memcpy(ss, s, len);
657return ss;
658}
659
660#define string_copy_taint(s, tainted) \
661 string_copy_taint_trc((s), tainted, __FUNCTION__, __LINE__)
662
663static inline uschar *
664string_copy(const uschar * s)
665{
666return string_copy_taint((s), is_tainted(s));
667}
668
669
670/*************************************************
671* Copy, lowercase and save string *
672*************************************************/
673
674/*
675Argument: string to copy
676Returns: copy of string in new store, with letters lowercased
677*/
678
679static inline uschar *
680string_copylc(const uschar *s)
681{
682uschar *ss = store_get(Ustrlen(s) + 1, is_tainted(s));
683uschar *p = ss;
684while (*s != 0) *p++ = tolower(*s++);
685*p = 0;
686return ss;
687}
688
689
690
691/*************************************************
692* Copy and save string, given length *
693*************************************************/
694
695/* It is assumed the data contains no zeros. A zero is added
696onto the end.
697
698Arguments:
699 s string to copy
700 n number of characters
701
702Returns: copy of string in new store
703
704This is an API for local_scan hence not static.
705*/
706
707static inline uschar *
708string_copyn(const uschar *s, int n)
709{
710uschar *ss = store_get(n + 1, is_tainted(s));
711Ustrncpy(ss, s, n);
712ss[n] = 0;
713return ss;
714}
715
716/*************************************************
717* Copy, lowercase, and save string, given length *
718*************************************************/
719
720/* It is assumed the data contains no zeros. A zero is added
721onto the end.
722
723Arguments:
724 s string to copy
725 n number of characters
726
727Returns: copy of string in new store, with letters lowercased
728*/
729
730static inline uschar *
731string_copynlc(uschar *s, int n)
732{
733uschar *ss = store_get(n + 1, is_tainted(s));
734uschar *p = ss;
735while (n-- > 0) *p++ = tolower(*s++);
736*p = 0;
737return ss;
738}
739
740
741# ifndef COMPILE_UTILITY
742/*************************************************
743* Copy and save string in longterm store *
744*************************************************/
745
746/* This function assumes that memcpy() is faster than strcpy().
747
748Argument: string to copy
749Returns: copy of string in new store
750*/
751
752static inline uschar *
753string_copy_perm(const uschar *s, BOOL force_taint)
754{
755int old_pool = store_pool;
756int len = Ustrlen(s) + 1;
757uschar *ss;
758
759store_pool = POOL_PERM;
760ss = store_get(len, force_taint || is_tainted(s));
761memcpy(ss, s, len);
762store_pool = old_pool;
763return ss;
764}
765# endif
766
767
768
769/* sprintf into a buffer, taint-unchecked */
770
771static inline void
772string_format_nt(uschar * buf, int siz, const char * fmt, ...)
773{
774gstring gs = { .size = siz, .ptr = 0, .s = buf };
775va_list ap;
776va_start(ap, fmt);
777(void) string_vformat(&gs, SVFMT_TAINT_NOCHK, fmt, ap);
778va_end(ap);
779}
780
781
782
783/******************************************************************************/
784/* Growable-string functions */
785
786/* Create a growable-string with some preassigned space */
787
788#define string_get_tainted(size, tainted) \
789 string_get_tainted_trc((size), (tainted), __FUNCTION__, __LINE__)
790
791static inline gstring *
792string_get_tainted_trc(unsigned size, BOOL tainted, const char * func, unsigned line)
793{
794gstring * g = store_get_3(sizeof(gstring) + size, tainted, func, line);
795g->size = size;
796g->ptr = 0;
797g->s = US(g + 1);
798return g;
799}
800
801#define string_get(size) \
802 string_get_trc((size), __FUNCTION__, __LINE__)
803
804static inline gstring *
805string_get_trc(unsigned size, const char * func, unsigned line)
806{
807return string_get_tainted_trc(size, FALSE, func, line);
808}
809
810/* NUL-terminate the C string in the growable-string, and return it. */
811
812static inline uschar *
813string_from_gstring(gstring * g)
814{
815if (!g) return NULL;
816g->s[g->ptr] = '\0';
817return g->s;
818}
819
820
821#define gstring_release_unused(g) \
822 gstring_release_unused_trc(g, __FUNCTION__, __LINE__)
823
824static inline void
825gstring_release_unused_trc(gstring * g, const char * file, unsigned line)
826{
827if (g) store_release_above_3(g->s + (g->size = g->ptr + 1), file, line);
828}
829
830
831/* sprintf-append to a growable-string */
832
833#define string_fmt_append(g, fmt, ...) \
834 string_fmt_append_f_trc(g, US __FUNCTION__, __LINE__, \
835 SVFMT_EXTEND|SVFMT_REBUFFER, fmt, __VA_ARGS__)
836
837#define string_fmt_append_f(g, flgs, fmt, ...) \
838 string_fmt_append_f_trc(g, US __FUNCTION__, __LINE__, \
839 flgs, fmt, __VA_ARGS__)
840
841static inline gstring *
842string_fmt_append_f_trc(gstring * g, const uschar * func, unsigned line,
843 unsigned flags, const char *format, ...)
844{
845va_list ap;
846va_start(ap, format);
847g = string_vformat_trc(g, func, line, STRING_SPRINTF_BUFFER_SIZE,
848 flags, format, ap);
849va_end(ap);
850return g;
851}
852
853/******************************************************************************/
854
855#define store_get_dns_answer() store_get_dns_answer_trc(CUS __FUNCTION__, __LINE__)
856
857static inline dns_answer *
858store_get_dns_answer_trc(const uschar * func, unsigned line)
859{
860return store_get_3(sizeof(dns_answer), TRUE, CCS func, line); /* use tainted mem */
861}
862
863/******************************************************************************/
864/* Routines with knowledge of spool layout */
865
866# ifndef COMPILE_UTILITY
867static inline void
868spool_pname_buf(uschar * buf, int len)
869{
870snprintf(CS buf, len, "%s/%s/input", spool_directory, queue_name);
871}
872
873static inline uschar *
874spool_dname(const uschar * purpose, uschar * subdir)
875{
876return string_sprintf("%s/%s/%s/%s",
877 spool_directory, queue_name, purpose, subdir);
878}
879# endif
880
881static inline uschar *
882spool_sname(const uschar * purpose, uschar * subdir)
883{
884return string_sprintf("%s%s%s%s%s",
885 queue_name, *queue_name ? "/" : "",
886 purpose,
887 *subdir ? "/" : "", subdir);
888}
889
890static inline uschar *
891spool_fname(const uschar * purpose, const uschar * subdir, const uschar * fname,
892 const uschar * suffix)
893{
894return string_sprintf("%s/%s/%s/%s/%s%s",
895 spool_directory, queue_name, purpose, subdir, fname, suffix);
896}
897
898static inline void
899set_subdir_str(uschar * subdir_str, const uschar * name,
900 int search_sequence)
901{
902subdir_str[0] = split_spool_directory == (search_sequence == 0)
903 ? name[5] : '\0';
904subdir_str[1] = '\0';
905}
906
907/******************************************************************************/
908static inline void
909timesince(struct timeval * diff, struct timeval * then)
910{
911gettimeofday(diff, NULL);
912diff->tv_sec -= then->tv_sec;
913if ((diff->tv_usec -= then->tv_usec) < 0)
914 {
915 diff->tv_sec--;
916 diff->tv_usec += 1000*1000;
917 }
918}
919
920static inline uschar *
921string_timediff(struct timeval * diff)
922{
923static uschar buf[sizeof("0.000s")];
924
925if (diff->tv_sec >= 5 || !LOGGING(millisec))
926 return readconf_printtime((int)diff->tv_sec);
927
928sprintf(CS buf, "%u.%03us", (uint)diff->tv_sec, (uint)diff->tv_usec/1000);
929return buf;
930}
931
932
933static inline uschar *
934string_timesince(struct timeval * then)
935{
936struct timeval diff;
937timesince(&diff, then);
938return string_timediff(&diff);
939}
940
941static inline void
942report_time_since(struct timeval * t0, uschar * where)
943{
944# ifdef MEASURE_TIMING
945struct timeval diff;
946timesince(&diff, t0);
947fprintf(stderr, "%d %s:\t%ld.%06ld\n",
948 (uint)getpid(), where, (long)diff.tv_sec, (long)diff.tv_usec);
949# endif
950}
951
952
953static inline void
954testharness_pause_ms(int millisec)
955{
956#ifndef MEASURE_TIMING
957if (f.running_in_test_harness) millisleep(millisec);
958#endif
959}
960
961#endif /* !MACRO_PREDEF */
962
963#endif /* _FUNCTIONS_H_ */
964
965/* vi: aw
966*/
967/* End of functions.h */
Unnamed repository; edit this file 'description' to name the repository.