2 m4_dnl (part of complex test harness, not of the library)
3 m4_dnl - list of syscalls to override/log and their args
5 m4_dnl This file is part of adns, which is Copyright Ian Jackson
6 m4_dnl and contributors (see the file INSTALL for full details).
8 m4_dnl This program is free software; you can redistribute it and/or modify
9 m4_dnl it under the terms of the GNU General Public License as published by
10 m4_dnl the Free Software Foundation; either version 3, or (at your option)
11 m4_dnl any later version.
13 m4_dnl This program is distributed in the hope that it will be useful,
14 m4_dnl but WITHOUT ANY WARRANTY; without even the implied warranty of
15 m4_dnl MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 m4_dnl GNU General Public License for more details.
18 m4_dnl You should have received a copy of the GNU General Public License
19 m4_dnl along with this program; if not, write to the Free Software Foundation.
21 m4_dnl each system call has
22 m4_dnl hm_syscall(<name>,<returnvalue>,<args>)
23 m4_dnl <returnvalue> is one of
24 m4_dnl hm_rv_must must succeed and return 0
25 m4_dnl hm_rv_any any nonnegative return allowed, -1 means see errno
26 m4_dnl hm_rv_fd file descriptor is returned, -1 means see errno
27 m4_dnl hm_rv_succfail returns 0 (ok) or -1 (see errno)
28 m4_dnl hm_rv_len(<max>) returns length read, must be <=max, -1 => errno
29 m4_dnl hm_rv_wlen(<max>) returns length written, must be <=max, -1 => errno
30 m4_dnl hm_rv_fcntl syscall is fcntl, do special processing
31 m4_dnl hm_rv_select select, do special processing } default is _any
32 m4_dnl hm_rv_poll poll, do special processing } after create_nothing
33 m4_dnl <args> is list of macros for arguments, each followed by hm_na
34 m4_dnl hm_arg_nullptr(<type>,<arg>) pointer of type type, must be null
35 m4_dnl hm_arg_int(<arg>) signed integer
36 m4_dnl hm_arg_fdset_io(<arg>,<max>) fd_set, max bit set is in max
37 m4_dnl hm_arg_timeval_in_rel_null(<t>) struct timeval*, pass in, relative, may be null
38 m4_dnl hm_arg_must(<type>,<arg>,<val>) must have correct value, or abort test
39 m4_dnl hm_arg_socktype(<arg>) SOCK_STREAM or SOCK_DGRAM (an int)
40 m4_dnl hm_arg_addrfam(<arg>) a supported address family
41 m4_dnl hm_arg_ign(<type>,<arg>) input parameter ignored
42 m4_dnl hm_arg_fd(<arg>) fd
43 m4_dnl hm_arg_fcntl_cmd_arg(<ca>,<aa>) syscall is fcntl, do special processing
44 m4_dnl hm_arg_addr_in(<arg>,<len>) struct sockaddr*, length given by <len> (an int)
45 m4_dnl hm_arg_bytes_in(<objtype>,<objarg>,<lentype>,<lenarg>)
46 m4_dnl some data from caller; <objarg> is of type pointer to const <objtype>
47 m4_dnl and points to <lenarg> bytes (<lenarg> is of type <lentype>)
48 m4_dnl hm_arg_bytes_out(<objtype>,<objarg>,<lentype>,<buflenarg>)
49 m4_dnl buffer for data from syscall; <objarg> is of type pointer to const <objtype>
50 m4_dnl and points to at least <lenarg> bytes (<lenarg> is of type <lentype>)
51 m4_dnl return value from syscall is supposed to be returned length
52 m4_dnl hm_arg_addr_out(<arg>,<lenptr>) struct sockaddr*, length io at <lenptr> (an int*)
55 select, `hm_rv_select', `
57 hm_arg_fdset_io(rfds,max) hm_na
58 hm_arg_fdset_io(wfds,max) hm_na
59 hm_arg_fdset_io(efds,max) hm_na
60 hm_arg_timeval_in_rel_null(to) hm_na
66 hm_arg_pollfds_io(fds,nfds) hm_na
67 hm_arg_int(timeout) hm_na
73 hm_arg_addrfam(domain) hm_na
74 hm_arg_socktype(type) hm_na
75 hm_arg_ign(int,protocol) hm_na
79 fcntl, `hm_rv_fcntl', `
81 hm_arg_fcntl_cmd_arg(cmd,arg) hm_na
85 connect, `hm_rv_succfail', `
87 hm_arg_addr_in(addr,addrlen) hm_na
91 bind, `hm_rv_succfail', `
93 hm_arg_addr_in(addr,addrlen) hm_na
97 listen, `hm_rv_succfail', `
99 hm_arg_int(backlog) hm_na
103 sendto, `hm_rv_wlen(msglen)', `
105 hm_arg_bytes_in(void,msg,int,msglen) hm_na
106 hm_arg_must(unsigned int,flags,0) hm_na
107 hm_arg_addr_in(addr,addrlen) hm_na
111 recvfrom, `hm_rv_len(buflen)', `
113 hm_arg_bytes_out(void,buf,int,buflen) hm_na
114 hm_arg_must(unsigned int,flags,0) hm_na
115 hm_arg_addr_out(addr,addrlen) hm_na
119 read, `hm_rv_len(buflen)', `
121 hm_arg_bytes_out(void,buf,size_t,buflen) hm_na
125 write, `hm_rv_wlen(len)', `
127 hm_arg_bytes_in(void,buf,size_t,len) hm_na
130 hm_specsyscall(int, writev, `int fd, const struct iovec *vector, size_t count')
131 hm_specsyscall(int, gettimeofday, `struct timeval *tv, struct timezone *tz')
132 hm_specsyscall(int, clock_gettime, `clockid_t clk, struct timespec *ts')
133 hm_specsyscall(pid_t, getpid, `void')
134 hm_specsyscall(int, close, `int fd')
136 m4_define(hm_stdsyscall_close,`
138 close, `hm_rv_succfail', `
143 hm_specsyscall(void*, malloc, `size_t sz')
144 hm_specsyscall(void, free, `void *ptr')
145 hm_specsyscall(void*, realloc, `void *op, size_t nsz')
146 hm_specsyscall(void, exit, `int rv', NONRETURNING)
148 hm_specsyscall(FILE*, fopen, `const char *path, const char *mode')