chiark / gitweb /
Add documentation and administrivia about `disorder-gstdecode'.
[disorder] / lib / syscalls.h
1 /*
2  * This file is part of DisOrder.
3  * Copyright (C) 2004, 2005, 2007-2009, 2013 Richard Kettlewell
4  *
5  * This program is free software: you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation, either version 3 of the License, or
8  * (at your option) any later version.
9  * 
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  * 
15  * You should have received a copy of the GNU General Public License
16  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
17  */
18 /** @file lib/syscalls.h
19  * @brief Error-checking library call wrappers
20  */
21 #ifndef SYSCALLS_H
22 #define SYSCALLS_H
23
24 /* various error-handling wrappers.  Not actually all system calls! */
25
26 struct sockaddr;
27 struct sigaction;
28 struct timezone;
29
30 #include <sys/socket.h>
31 #include <signal.h>
32
33 pid_t xfork(void);
34 void xclose_guts(const char *, int, int);
35 #define xclose(fd) xclose_guts(__FILE__, __LINE__, fd)
36 void xdup2(int, int);
37 void xpipe(int *);
38 int xfcntl(int, int, long);
39 void xlisten(int, int);
40 void xshutdown(int, int);
41 void xsetsockopt(int, int, int, const void *, socklen_t);
42 int xsocket(int, int, int);
43 void xconnect(int, const struct sockaddr *, socklen_t);
44 void xsigprocmask(int how, const sigset_t *set, sigset_t *oldset);
45 void xsigaction(int sig, const struct sigaction *sa, struct sigaction *oldsa);
46 int xprintf(const char *, ...)
47   attribute((format (printf, 1, 2)));
48 void xfclose(FILE *);
49 int xnice(int);
50 void xgettimeofday(struct timeval *, struct timezone *);
51 time_t xtime(time_t *when);
52 void xgettime(clockid_t clk_id, struct timespec *tp);
53 void xnanosleep(const struct timespec *req, struct timespec *rem);
54 /* the above all call @fatal@ if the system call fails */
55
56 void nonblock(int fd);
57 void blocking(int fd);
58 void cloexec(int fd);
59 /* make @fd@ non-blocking/blocking/close-on-exec; call @fatal@ on error. */
60
61 int mustnotbeminus1(const char *what, int value);
62 /* If @value@ is -1, report an error including @what@. */
63
64 int xstrtol(long *n, const char *s, char **ep, int base);
65 int xstrtoll(long_long *n, const char *s, char **ep, int base);
66 /* like strtol() but returns errno on error, 0 on success */
67
68 #endif /* SYSCALLS_H */
69
70 /*
71 Local Variables:
72 c-basic-offset:2
73 comment-column:40
74 End:
75 */