2 * $Id: util.h,v 1.13 2009-11-05 14:38:08 franklahm Exp $
6 #define _ATALK_UTIL_H 1
12 #endif /* HAVE_UNISTD_H */
13 #include <netatalk/at.h>
14 #include <atalk/unicode.h>
16 /* exit error codes */
17 #define EXITERR_CLNT 1 /* client related error */
18 #define EXITERR_CONF 2 /* error in config files/cmd line parameters */
19 #define EXITERR_SYS 3 /* local system error */
22 extern int sys_ftruncate (int fd, off_t length);
25 extern ssize_t sys_sendfile (int __out_fd, int __in_fd, off_t *__offset,size_t __count);
28 extern const int _diacasemap[], _dialowermap[];
30 extern char **getifacelist(void);
31 extern void freeifacelist(char **);
33 #define diatolower(x) _dialowermap[(unsigned char) (x)]
34 #define diatoupper(x) _diacasemap[(unsigned char) (x)]
35 extern int atalk_aton (char *, struct at_addr *);
36 extern void bprint (char *, int);
37 extern int strdiacasecmp (const char *, const char *);
38 extern int strndiacasecmp (const char *, const char *, size_t);
39 extern pid_t server_lock (char * /*program*/, char * /*file*/,
41 extern void fault_setup (void (*fn)(void *));
42 #define server_unlock(x) (unlink(x))
45 size_t strlcpy (char *, const char *, size_t);
49 size_t strlcat (char *, const char *, size_t);
53 extern void *mod_open (const char *);
54 extern void *mod_symbol (void *, const char *);
55 extern void mod_close (void *);
56 #define mod_error() ""
57 #else /* ! HAVE_DLFCN_H */
62 #endif /* ! RTLD_NOW */
64 /* NetBSD doesn't like RTLD_NOW for dlopen (it fails). Use RTLD_LAZY.
65 * OpenBSD currently does not use the second arg for dlopen(). For
66 * future compatibility we define DL_LAZY */
68 #define mod_open(a) dlopen(a, RTLD_LAZY)
69 #elif defined(__OpenBSD__)
70 #define mod_open(a) dlopen(a, DL_LAZY)
71 #else /* ! __NetBSD__ && ! __OpenBSD__ */
72 #define mod_open(a) dlopen(a, RTLD_NOW)
73 #endif /* __NetBSD__ */
75 #ifndef DLSYM_PREPEND_UNDERSCORE
76 #define mod_symbol(a, b) dlsym(a, b)
77 #else /* ! DLSYM_PREPEND_UNDERSCORE */
78 extern void *mod_symbol (void *, const char *);
79 #endif /* ! DLSYM_PREPEND_UNDERSCORE */
80 #define mod_error() dlerror()
81 #define mod_close(a) dlclose(a)
82 #endif /* ! HAVE_DLFCN_H */
84 /******************************************************************
86 ******************************************************************/
91 * Purpose: lock a file with fctnl
95 * fd (r) File descriptor
96 * cmd (r) cmd to fcntl, only F_SETLK is usable here
97 * type (r) F_RDLCK, F_WRLCK, F_UNLCK
98 * offset (r) byte offset relative to l_whence
99 * whence (r) SEEK_SET, SEEK_CUR, SEEK_END
100 * len (r) no. of bytes (0 means to EOF)
102 * Returns: 0 on success, -1 on failure
103 * fcntl return value and errno
107 * Function called by macros to ease locking.
109 extern int lock_reg(int fd, int cmd, int type, off_t offest, int whence, off_t len);
112 * Macros: read_lock, write_lock, un_lock
114 * Purpose: lock and unlock files
118 * fd (r) File descriptor
119 * offset (r) byte offset relative to l_whence
120 * whence (r) SEEK_SET, SEEK_CUR, SEEK_END
121 * len (r) no. of bytes (0 means to EOF)
123 * Returns: 0 on success, -1 on failure
124 * fcntl return value and errno
128 * Nice locking macros.
131 #define read_lock(fd, offset, whence, len) \
132 lock_reg((fd), F_SETLK, F_RDLCK, (offset), (whence), (len))
133 #define write_lock(fd, offset, whence, len) \
134 lock_reg((fd), F_SETLK, F_WRLCK, (offset), (whence), (len))
135 #define unlock(fd, offset, whence, len) \
136 lock_reg((fd), F_SETLK, F_UNLCK, (offset), (whence), (len))
140 /******************************************************************
142 ******************************************************************/
145 * Function: setnonblock
147 * Purpose: set or unset non-blocking IO on a fd
151 * fd (r) File descriptor
152 * cmd (r) 0: disable non-blocking IO, ie block
153 * <>0: enable non-blocking IO
155 * Returns: 0 on success, -1 on failure
161 extern int setnonblock(int fd, int cmd);
164 * Function: getip_string
166 * Purpose: convert an IPv4 or IPv6 address to a static string using inet_ntop
170 * sa (r) pointer to an struct sockaddr
172 * Returns: pointer to a static string cotaining the converted address as string.
173 * On error pointers to "0.0.0.0" or "::0" are returned.
177 * IPv6 mapped IPv4 addresses are returned as IPv4 addreses eg
178 * ::ffff:10.0.0.0 is returned as "10.0.0.0".
180 extern const char *getip_string(const struct sockaddr *sa);
183 * Function: getip_string
185 * Purpose: return port number from struct sockaddr
189 * sa (r) pointer to an struct sockaddr
191 * Returns: port as unsigned int
195 extern unsigned int getip_port(const struct sockaddr *sa);
198 * Function: apply_ip_mask
200 * Purpose: apply netmask to IP (v4 or v6)
204 * ai (rw) pointer to an struct sockaddr
205 * mask (r) number of maskbits
211 * Modifies IP address in sa->sin[6]_addr-s[6]_addr. The caller is responsible
212 * for passing a value for mask that is sensible to the passed address,
213 * eg 0 <= mask <= 32 for IPv4 or 0<= mask <= 128 for IPv6. mask > 32 for
214 * IPv4 is treated as mask = 32, mask > 128 is set to 128 for IPv6.
216 extern void apply_ip_mask(struct sockaddr *ai, int maskbits);
219 * Function: compare_ip
221 * Purpose: Compare IP addresses for equality
225 * sa1 (r) pointer to an struct sockaddr
226 * sa2 (r) pointer to an struct sockaddr
228 * Returns: Addresses are converted to strings and compared with strcmp and
229 * the result of strcmp is returned.
233 * IPv6 mapped IPv4 addresses are treated as IPv4 addresses.
235 extern int compare_ip(const struct sockaddr *sa1, const struct sockaddr *sa2);