unistd.h revision 1.153 1 /* $NetBSD: unistd.h,v 1.153 2019/09/15 23:41:00 christos Exp $ */
2
3 /*-
4 * Copyright (c) 1998, 1999, 2008 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Klaus Klein.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 * POSSIBILITY OF SUCH DAMAGE.
30 */
31
32 /*
33 * Copyright (c) 1991, 1993, 1994
34 * The Regents of the University of California. All rights reserved.
35 *
36 * Redistribution and use in source and binary forms, with or without
37 * modification, are permitted provided that the following conditions
38 * are met:
39 * 1. Redistributions of source code must retain the above copyright
40 * notice, this list of conditions and the following disclaimer.
41 * 2. Redistributions in binary form must reproduce the above copyright
42 * notice, this list of conditions and the following disclaimer in the
43 * documentation and/or other materials provided with the distribution.
44 * 3. Neither the name of the University nor the names of its contributors
45 * may be used to endorse or promote products derived from this software
46 * without specific prior written permission.
47 *
48 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
49 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
50 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
51 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
52 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
53 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
54 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
55 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
56 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
57 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
58 * SUCH DAMAGE.
59 *
60 * @(#)unistd.h 8.12 (Berkeley) 4/27/95
61 */
62
63 #ifndef _UNISTD_H_
64 #define _UNISTD_H_
65
66 #include <machine/ansi.h>
67 #include <machine/int_types.h>
68 #include <sys/cdefs.h>
69 #include <sys/featuretest.h>
70 #include <sys/types.h>
71 #include <sys/unistd.h>
72
73 #if _FORTIFY_SOURCE > 0
74 #include <ssp/unistd.h>
75 #endif
76
77 /*
78 * IEEE Std 1003.1-90
79 */
80 #define STDIN_FILENO 0 /* standard input file descriptor */
81 #define STDOUT_FILENO 1 /* standard output file descriptor */
82 #define STDERR_FILENO 2 /* standard error file descriptor */
83
84 #include <sys/null.h>
85
86 __BEGIN_DECLS
87 __dead void _exit(int);
88 int access(const char *, int);
89 unsigned int alarm(unsigned int);
90 int chdir(const char *);
91 #if defined(_POSIX_C_SOURCE) || defined(_XOPEN_SOURCE)
92 int chown(const char *, uid_t, gid_t) __RENAME(__posix_chown);
93 #else
94 int chown(const char *, uid_t, gid_t);
95 #endif /* defined(_POSIX_C_SOURCE) || defined(_XOPEN_SOURCE) */
96 int close(int);
97 size_t confstr(int, char *, size_t);
98 #ifndef __CUSERID_DECLARED
99 #define __CUSERID_DECLARED
100 /* also declared in stdio.h */
101 char *cuserid(char *); /* obsolete */
102 #endif /* __CUSERID_DECLARED */
103 int dup(int);
104 int dup2(int, int);
105 int execl(const char *, const char *, ...);
106 int execle(const char *, const char *, ...);
107 int execlp(const char *, const char *, ...);
108 int execv(const char *, char * const *);
109 int execve(const char *, char * const *, char * const *);
110 int fexecve(int, char * const *, char * const *);
111 int execvp(const char *, char * const *);
112 pid_t fork(void);
113 long fpathconf(int, int);
114 #if __SSP_FORTIFY_LEVEL == 0
115 char *getcwd(char *, size_t);
116 #endif
117 gid_t getegid(void);
118 uid_t geteuid(void);
119 gid_t getgid(void);
120 int getgroups(int, gid_t []);
121 __aconst char *getlogin(void);
122 int getlogin_r(char *, size_t);
123 pid_t getpgrp(void);
124 pid_t getpid(void);
125 pid_t getppid(void);
126 uid_t getuid(void);
127 int isatty(int);
128 int link(const char *, const char *);
129 long pathconf(const char *, int);
130 int pause(void);
131 int pipe(int *);
132 #if __SSP_FORTIFY_LEVEL == 0
133 ssize_t read(int, void *, size_t);
134 #endif
135 int rmdir(const char *);
136 int setgid(gid_t);
137 int setpgid(pid_t, pid_t);
138 pid_t setsid(void);
139 int setuid(uid_t);
140 unsigned int sleep(unsigned int);
141 long sysconf(int);
142 pid_t tcgetpgrp(int);
143 int tcsetpgrp(int, pid_t);
144 __aconst char *ttyname(int);
145 int unlink(const char *);
146 ssize_t write(int, const void *, size_t);
147
148
149 /*
150 * IEEE Std 1003.2-92, adopted in X/Open Portability Guide Issue 4 and later
151 */
152 #if (_POSIX_C_SOURCE - 0) >= 2 || defined(_XOPEN_SOURCE) || \
153 defined(_NETBSD_SOURCE)
154 int getopt(int, char * const [], const char *);
155
156 extern char *optarg; /* getopt(3) external variables */
157 extern int opterr;
158 extern int optind;
159 extern int optopt;
160 #endif
161
162 /*
163 * The Open Group Base Specifications, Issue 5; IEEE Std 1003.1-2001 (POSIX)
164 */
165 #if (_POSIX_C_SOURCE - 0) >= 200112L || (_XOPEN_SOURCE - 0) >= 500 || \
166 defined(_NETBSD_SOURCE)
167 #if __SSP_FORTIFY_LEVEL == 0
168 ssize_t readlink(const char * __restrict, char * __restrict, size_t);
169 #endif
170 #endif
171
172 /*
173 * The Open Group Base Specifications, Issue 6; IEEE Std 1003.1-2001 (POSIX)
174 */
175 #if (_POSIX_C_SOURCE - 0) >= 200112L || (_XOPEN_SOURCE - 0) >= 600 || \
176 defined(_NETBSD_SOURCE)
177 int setegid(gid_t);
178 int seteuid(uid_t);
179 #endif
180
181 /*
182 * The following three syscalls are also defined in <sys/types.h>
183 * We protect them against double declarations.
184 */
185 #ifndef __OFF_T_SYSCALLS_DECLARED
186 #define __OFF_T_SYSCALLS_DECLARED
187 off_t lseek(int, off_t, int);
188 int truncate(const char *, off_t);
189 /*
190 * IEEE Std 1003.1b-93,
191 * also found in X/Open Portability Guide >= Issue 4 Verion 2
192 */
193 #if (_POSIX_C_SOURCE - 0) >= 199309L || \
194 (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
195 (_XOPEN_SOURCE - 0) >= 500 || defined(_NETBSD_SOURCE)
196 int ftruncate(int, off_t);
197 #endif
198 #endif /* __OFF_T_SYSCALLS_DECLARED */
199
200
201 /*
202 * IEEE Std 1003.1b-93, adopted in X/Open CAE Specification Issue 5 Version 2
203 */
204 #if (_POSIX_C_SOURCE - 0) >= 199309L || (_XOPEN_SOURCE - 0) >= 500 || \
205 defined(_NETBSD_SOURCE)
206 int fdatasync(int);
207 int fsync(int);
208 #endif
209
210
211 /*
212 * IEEE Std 1003.1c-95, also adopted by X/Open CAE Spec Issue 5 Version 2
213 */
214 #if (_POSIX_C_SOURCE - 0) >= 199506L || (_XOPEN_SOURCE - 0) >= 500 || \
215 defined(_REENTRANT) || defined(_NETBSD_SOURCE)
216 int ttyname_r(int, char *, size_t);
217 #ifndef __PTHREAD_ATFORK_DECLARED
218 #define __PTHREAD_ATFORK_DECLARED
219 int pthread_atfork(void (*)(void), void (*)(void), void (*)(void));
220 #endif
221 #endif
222
223 /*
224 * X/Open Portability Guide, all issues
225 */
226 #if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
227 int chroot(const char *);
228 int nice(int);
229 #endif
230
231
232 /*
233 * X/Open Portability Guide >= Issue 4
234 */
235 #if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
236 __aconst char *crypt(const char *, const char *);
237 int encrypt(char *, int);
238 char *getpass(const char *);
239 pid_t getsid(pid_t);
240 #endif
241
242
243 /*
244 * X/Open Portability Guide >= Issue 4 Version 2
245 */
246 #if (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
247 (_XOPEN_SOURCE - 0) >= 500 || defined(_NETBSD_SOURCE)
248 #ifndef _BSD_INTPTR_T_
249 typedef __intptr_t intptr_t;
250 #define _BSD_INTPTR_T_
251 #endif
252
253 #define F_ULOCK 0
254 #define F_LOCK 1
255 #define F_TLOCK 2
256 #define F_TEST 3
257
258 int brk(void *);
259 int fchdir(int);
260 #if defined(_XOPEN_SOURCE)
261 int fchown(int, uid_t, gid_t) __RENAME(__posix_fchown);
262 #else
263 int fchown(int, uid_t, gid_t);
264 #endif
265 int getdtablesize(void);
266 long gethostid(void);
267 int gethostname(char *, size_t);
268 __pure int
269 getpagesize(void); /* legacy */
270 pid_t getpgid(pid_t);
271 #if defined(_XOPEN_SOURCE)
272 int lchown(const char *, uid_t, gid_t) __RENAME(__posix_lchown);
273 #else
274 int lchown(const char *, uid_t, gid_t);
275 #endif
276 int lockf(int, int, off_t);
277 void *sbrk(intptr_t);
278 /* XXX prototype wrong! */
279 int setpgrp(pid_t, pid_t); /* obsoleted by setpgid() */
280 int setregid(gid_t, gid_t);
281 int setreuid(uid_t, uid_t);
282 void swab(const void * __restrict, void * __restrict, ssize_t);
283 int symlink(const char *, const char *);
284 void sync(void);
285 useconds_t ualarm(useconds_t, useconds_t);
286 int usleep(useconds_t);
287 #ifndef __LIBC12_SOURCE__
288 pid_t vfork(void) __RENAME(__vfork14) __returns_twice;
289 #endif
290
291 #ifndef __AUDIT__
292 char *getwd(char *); /* obsoleted by getcwd() */
293 #endif
294 #endif /* _XOPEN_SOURCE_EXTENDED || _XOPEN_SOURCE >= 500 || _NETBSD_SOURCE */
295
296
297 /*
298 * X/Open CAE Specification Issue 5 Version 2
299 */
300 #if (_POSIX_C_SOURCE - 0) >= 200112L || (_XOPEN_SOURCE - 0) >= 500 || \
301 defined(_NETBSD_SOURCE)
302 ssize_t pread(int, void *, size_t, off_t);
303 ssize_t pwrite(int, const void *, size_t, off_t);
304 #endif /* (_POSIX_C_SOURCE - 0) >= 200112L || ... */
305
306 /*
307 * X/Open Extended API set 2 (a.k.a. C063)
308 */
309 #if (_POSIX_C_SOURCE - 0) >= 200809L || (_XOPEN_SOURCE - 0 >= 700) || \
310 defined(_NETBSD_SOURCE)
311 int linkat(int, const char *, int, const char *, int);
312 int renameat(int, const char *, int, const char *);
313 int faccessat(int, const char *, int, int);
314 int fchownat(int, const char *, uid_t, gid_t, int);
315 ssize_t readlinkat(int, const char *, char *, size_t);
316 int symlinkat(const char *, int, const char *);
317 int unlinkat(int, const char *, int);
318 int fexecve(int, char * const *, char * const *);
319 #endif
320
321
322 /*
323 * Implementation-defined extensions
324 */
325 #if defined(_NETBSD_SOURCE)
326 int acct(const char *);
327 int closefrom(int);
328 int des_cipher(const char *, char *, long, int);
329 int des_setkey(const char *);
330 int dup3(int, int, int);
331 void endusershell(void);
332 int exect(const char *, char * const *, char * const *);
333 int execvpe(const char *, char * const *, char * const *);
334 int execlpe(const char *, const char *, ...);
335 int fchroot(int);
336 int fdiscard(int, off_t, off_t);
337 int fsync_range(int, int, off_t, off_t);
338 int getdomainname(char *, size_t);
339 int getgrouplist(const char *, gid_t, gid_t *, int *);
340 int getgroupmembership(const char *, gid_t, gid_t *, int, int *);
341 mode_t getmode(const void *, mode_t);
342 char *getpassfd(const char *, char *, size_t, int *, int, int);
343 #define GETPASS_NEED_TTY 0x001 /* Fail if we cannot set tty */
344 #define GETPASS_FAIL_EOF 0x002 /* Fail on EOF */
345 #define GETPASS_BUF_LIMIT 0x004 /* beep on buffer limit */
346 #define GETPASS_NO_SIGNAL 0x008 /* don't make ttychars send signals */
347 #define GETPASS_NO_BEEP 0x010 /* don't beep */
348 #define GETPASS_ECHO 0x020 /* echo characters as they are typed */
349 #define GETPASS_ECHO_STAR 0x040 /* echo '*' for each character */
350 #define GETPASS_7BIT 0x080 /* mask the high bit each char */
351 #define GETPASS_FORCE_LOWER 0x100 /* lowercase each char */
352 #define GETPASS_FORCE_UPPER 0x200 /* uppercase each char */
353 #define GETPASS_ECHO_NL 0x400 /* echo a newline if successful */
354
355 char *getpass_r(const char *, char *, size_t);
356 int getpeereid(int, uid_t *, gid_t *);
357 __aconst char *getusershell(void);
358 int initgroups(const char *, gid_t);
359 int iruserok(uint32_t, int, const char *, const char *);
360 int issetugid(void);
361 int mkstemps(char *, int);
362 int nfssvc(int, void *);
363 int pipe2(int *, int);
364 int profil(char *, size_t, unsigned long, unsigned int);
365 #ifndef __PSIGNAL_DECLARED
366 #define __PSIGNAL_DECLARED
367 /* also in signal.h */
368 void psignal(int, const char *);
369 #endif /* __PSIGNAL_DECLARED */
370 int rcmd(char **, int, const char *, const char *, const char *, int *);
371 int reboot(int, char *);
372 int revoke(const char *);
373 int rresvport(int *);
374 int ruserok(const char *, int, const char *, const char *);
375 int setdomainname(const char *, size_t);
376 int setgroups(int, const gid_t *);
377 int sethostid(long);
378 int sethostname(const char *, size_t);
379 int setlogin(const char *);
380 void *setmode(const char *);
381 int setrgid(gid_t);
382 int setruid(uid_t);
383 void setusershell(void);
384 void strmode(mode_t, char *);
385 #ifndef __STRSIGNAL_DECLARED
386 #define __STRSIGNAL_DECLARED
387 /* backwards-compatibility; also in string.h */
388 __aconst char *strsignal(int);
389 #endif /* __STRSIGNAL_DECLARED */
390 int swapctl(int, void *, int);
391 int swapon(const char *); /* obsoleted by swapctl() */
392 int syscall(int, ...);
393 quad_t __syscall(quad_t, ...);
394 int undelete(const char *);
395
396 #if 1 /*INET6*/
397 int rcmd_af(char **, int, const char *,
398 const char *, const char *, int *, int);
399 int rresvport_af(int *, int);
400 int rresvport_af_addr(int *, int, void *);
401 int iruserok_sa(const void *, int, int, const char *, const char *);
402 #endif
403
404 #ifndef __SYS_SIGLIST_DECLARED
405 #define __SYS_SIGLIST_DECLARED
406 /* also in signal.h */
407 extern const char *const *sys_siglist __RENAME(__sys_siglist14);
408 #endif /* __SYS_SIGLIST_DECLARED */
409 extern int optreset; /* getopt(3) external variable */
410 extern char *suboptarg; /* getsubopt(3) external variable */
411 #endif
412
413 __END_DECLS
414 #endif /* !_UNISTD_H_ */
415