apue.h

 /* Our own header, to be included before all standard system headers */</p><p>#ifndef _APUE_H<br />#define _APUE_H</p><p>#define _XOPEN_SOURCE 600 /* Single UNIX Specification, Version 3 */</p><p>#include <sys/types.h> /* some systems still require this */<br />#include <sys/stat.h><br />#include <sys/termios.h> /* for winsize */<br />#ifndef TIOCGWINSZ<br />#include <sys/ioctl.h><br />#endif<br />#include <stdio.h> /* for convenience */<br />#include <stdlib.h> /* for convenience */<br />#include <stddef.h> /* for offsetof */<br />#include <string.h> /* for convenience */<br />#include <unistd.h> /* for convenience */<br />#include <signal.h> /* for SIG_ERR */</p><p>#define MAXLINE 4096 /* max line length */</p><p>/*<br /> * Default file access permissions for new files.<br /> */<br />#define FILE_MODE (S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH)</p><p>/*<br /> * Default permissions for new directories.<br /> */<br />#define DIR_MODE (FILE_MODE | S_IXUSR | S_IXGRP | S_IXOTH)</p><p>typedef void Sigfunc(int); /* for signal handlers */</p><p>#if defined(SIG_IGN) && !defined(SIG_ERR)<br />#define SIG_ERR ((Sigfunc *)-1)<br />#endif</p><p>#define min(a,b) ((a) < (b) ? (a) : (b))<br />#define max(a,b) ((a) > (b) ? (a) : (b))</p><p>/*<br /> * Prototypes for our own functions.<br /> */<br />char *path_alloc(int *); /* Figure 2.15 */<br />long open_max(void); /* Figure 2.16 */<br />void clr_fl(int, int); /* Figure 3.11 */<br />void set_fl(int, int); /* Figure 3.11 */<br />void pr_exit(int); /* Figure 8.5 */<br />void pr_mask(const char *); /* Figure 10.14 */<br />Sigfunc *signal_intr(int, Sigfunc *); /* Figure 10.19 */</p><p>int tty_cbreak(int); /* Figure 18.20 */<br />int tty_raw(int); /* Figure 18.20 */<br />int tty_reset(int); /* Figure 18.20 */<br />void tty_atexit(void); /* Figure 18.20 */<br />#ifdef ECHO /* only if <termios.h> has been included */<br />struct termios *tty_termios(void); /* Figure 18.20 */<br />#endif</p><p>void sleep_us(unsigned int); /* Exercise 14.6 */<br />ssize_t readn(int, void *, size_t); /* Figure 14.29 */<br />ssize_t writen(int, const void *, size_t); /* Figure 14.29 */<br />void daemonize(const char *); /* Figure 13.1 */</p><p>int s_pipe(int *); /* Figures 17.6 and 17.13 */<br />int recv_fd(int, ssize_t (*func)(int,<br /> const void *, size_t));/* Figures 17.21 and 17.23 */<br />int send_fd(int, int); /* Figures 17.20 and 17.22 */<br />int send_err(int, int,<br /> const char *); /* Figure 17.19 */<br />int serv_listen(const char *); /* Figures 17.10 and 17.15 */<br />int serv_accept(int, uid_t *); /* Figures 17.11 and 17.16 */</p><p>int cli_conn(const char *); /* Figures 17.12 and 17.17 */<br />int buf_args(char *, int (*func)(int,<br /> char **)); /* Figure 17.32 */</p><p>int ptym_open(char *, int); /* Figures 19.8, 19.9, and 19.10 */<br />int ptys_open(char *); /* Figures 19.8, 19.9, and 19.10 */<br />#ifdef TIOCGWINSZ<br />pid_t pty_fork(int *, char *, int, const struct termios *,<br /> const struct winsize *); /* Figure 19.11 */<br />#endif</p><p>int lock_reg(int, int, int, off_t, int, off_t); /* Figure 14.5 */<br />#define read_lock(fd, offset, whence, len) /<br /> lock_reg((fd), F_SETLK, F_RDLCK, (offset), (whence), (len))<br />#define readw_lock(fd, offset, whence, len) /<br /> lock_reg((fd), F_SETLKW, F_RDLCK, (offset), (whence), (len))<br />#define write_lock(fd, offset, whence, len) /<br /> lock_reg((fd), F_SETLK, F_WRLCK, (offset), (whence), (len))<br />#define writew_lock(fd, offset, whence, len) /<br /> lock_reg((fd), F_SETLKW, F_WRLCK, (offset), (whence), (len))<br />#define un_lock(fd, offset, whence, len) /<br /> lock_reg((fd), F_SETLK, F_UNLCK, (offset), (whence), (len))</p><p>pid_t lock_test(int, int, off_t, int, off_t); /* Figure 14.6 */</p><p>#define is_read_lockable(fd, offset, whence, len) /<br /> (lock_test((fd), F_RDLCK, (offset), (whence), (len)) == 0)<br />#define is_write_lockable(fd, offset, whence, len) /<br /> (lock_test((fd), F_WRLCK, (offset), (whence), (len)) == 0)</p><p>void err_dump(const char *, ...); /* Appendix B */<br />void err_msg(const char *, ...);<br />void err_quit(const char *, ...);<br />void err_exit(int, const char *, ...);<br />void err_ret(const char *, ...);<br />void err_sys(const char *, ...);</p><p>void log_msg(const char *, ...); /* Appendix B */<br />void log_open(const char *, int, int);<br />void log_quit(const char *, ...);<br />void log_ret(const char *, ...);<br />void log_sys(const char *, ...);</p><p>void TELL_WAIT(void); /* parent/child from Section 8.9 */<br />void TELL_PARENT(pid_t);<br />void TELL_CHILD(pid_t);<br />void WAIT_PARENT(void);<br />void WAIT_CHILD(void);</p><p>#endif /* _APUE_H */</p><p>