unistd.h revision 1.169 1 /* $NetBSD: unistd.h,v 1.169 2024/11/01 18:48:17 nia 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 *, ...) __null_sentinel;
106 int execle(const char *, const char *, ...);
107 int execlp(const char *, const char *, ...) __null_sentinel;
108 int execv(const char *, char * const *);
109 int execve(const char *, char * const *, char * const *);
110 int execvp(const char *, char * const *);
111 pid_t fork(void);
112 long fpathconf(int, int);
113 #if __SSP_FORTIFY_LEVEL == 0
114 char *getcwd(char *, size_t);
115 #endif
116 gid_t getegid(void);
117 uid_t geteuid(void);
118 gid_t getgid(void);
119 int getgroups(int, gid_t []);
120 __aconst char *getlogin(void);
121 int getlogin_r(char *, size_t);
122 pid_t getpgrp(void);
123 pid_t getpid(void);
124 pid_t getppid(void);
125 uid_t getuid(void);
126 int isatty(int);
127 int link(const char *, const char *);
128 long pathconf(const char *, int);
129 int pause(void);
130 int pipe(int *);
131 #if __SSP_FORTIFY_LEVEL == 0
132 ssize_t read(int, void *, size_t);
133 #endif
134 int rmdir(const char *);
135 int setgid(gid_t);
136 int setpgid(pid_t, pid_t);
137 pid_t setsid(void);
138 int setuid(uid_t);
139 unsigned int sleep(unsigned int);
140 long sysconf(int);
141 pid_t tcgetpgrp(int);
142 int tcsetpgrp(int, pid_t);
143 __aconst char *ttyname(int);
144 int unlink(const char *);
145 ssize_t write(int, const void *, size_t);
146
147
148 /*
149 * IEEE Std 1003.2-92, adopted in X/Open Portability Guide Issue 4 and later
150 */
151 #if (_POSIX_C_SOURCE - 0) >= 2 || defined(_XOPEN_SOURCE) || \
152 defined(_NETBSD_SOURCE)
153 int getopt(int, char * const [], const char *);
154
155 extern char *optarg; /* getopt(3) external variables */
156 extern int opterr;
157 extern int optind;
158 extern int optopt;
159 #endif
160
161 /*
162 * The Open Group Base Specifications, Issue 5; IEEE Std 1003.1-2001 (POSIX)
163 */
164 #if (_POSIX_C_SOURCE - 0) >= 200112L || (_XOPEN_SOURCE - 0) >= 500 || \
165 defined(_NETBSD_SOURCE)
166 #if __SSP_FORTIFY_LEVEL == 0
167 ssize_t readlink(const char * __restrict, char * __restrict, size_t);
168 #endif
169 #endif
170
171 /*
172 * The Open Group Base Specifications, Issue 6; IEEE Std 1003.1-2001 (POSIX)
173 */
174 #if (_POSIX_C_SOURCE - 0) >= 200112L || (_XOPEN_SOURCE - 0) >= 600 || \
175 defined(_NETBSD_SOURCE)
176 int gethostname(char *, size_t);
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 Version 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 #endif
240 #if defined(_XOPEN_SOURCE) || (_POSIX_C_SOURCE - 0) >= 200809L || \
241 defined(_NETBSD_SOURCE)
242 pid_t getsid(pid_t);
243 #endif
244
245
246 /*
247 * X/Open Portability Guide >= Issue 4 Version 2
248 */
249 #if (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
250 (_XOPEN_SOURCE - 0) >= 500 || defined(_NETBSD_SOURCE)
251 #ifndef _BSD_INTPTR_T_
252 typedef __intptr_t intptr_t;
253 #define _BSD_INTPTR_T_
254 #endif
255
256 #define F_ULOCK 0
257 #define F_LOCK 1
258 #define F_TLOCK 2
259 #define F_TEST 3
260
261 int brk(void *);
262 int fchdir(int);
263 #if defined(_XOPEN_SOURCE)
264 int fchown(int, uid_t, gid_t) __RENAME(__posix_fchown);
265 #else
266 int fchown(int, uid_t, gid_t);
267 #endif
268 int getdtablesize(void);
269 long gethostid(void);
270 __pure int
271 getpagesize(void); /* legacy */
272 pid_t getpgid(pid_t);
273 #if defined(_XOPEN_SOURCE)
274 int lchown(const char *, uid_t, gid_t) __RENAME(__posix_lchown);
275 #else
276 int lchown(const char *, uid_t, gid_t);
277 #endif
278 int lockf(int, int, off_t);
279 void *sbrk(intptr_t);
280 /* XXX prototype wrong! */
281 int setpgrp(pid_t, pid_t); /* obsoleted by setpgid() */
282 int setregid(gid_t, gid_t);
283 int setreuid(uid_t, uid_t);
284 void swab(const void * __restrict, void * __restrict, ssize_t);
285 int symlink(const char *, const char *);
286 void sync(void);
287 useconds_t ualarm(useconds_t, useconds_t);
288 int usleep(useconds_t);
289 #ifndef __LIBC12_SOURCE__
290 pid_t vfork(void) __RENAME(__vfork14) __returns_twice;
291 #endif
292
293 #ifndef __AUDIT__
294 char *getwd(char *); /* obsoleted by getcwd() */
295 #endif
296 #endif /* _XOPEN_SOURCE_EXTENDED || _XOPEN_SOURCE >= 500 || _NETBSD_SOURCE */
297
298
299 /*
300 * X/Open CAE Specification Issue 5 Version 2
301 */
302 #if (_POSIX_C_SOURCE - 0) >= 200112L || (_XOPEN_SOURCE - 0) >= 500 || \
303 defined(_NETBSD_SOURCE)
304 ssize_t pread(int, void *, size_t, off_t);
305 ssize_t pwrite(int, const void *, size_t, off_t);
306 #endif /* (_POSIX_C_SOURCE - 0) >= 200112L || ... */
307
308 /*
309 * X/Open Extended API set 2 (a.k.a. C063)
310 */
311 #if (_POSIX_C_SOURCE - 0) >= 200809L || (_XOPEN_SOURCE - 0 >= 700) || \
312 defined(_NETBSD_SOURCE)
313 int linkat(int, const char *, int, const char *, int);
314 int renameat(int, const char *, int, const char *);
315 int faccessat(int, const char *, int, int);
316 int fchownat(int, const char *, uid_t, gid_t, int);
317 ssize_t readlinkat(int, const char *, char *, size_t);
318 int symlinkat(const char *, int, const char *);
319 int unlinkat(int, const char *, int);
320 int fexecve(int, char * const *, char * const *);
321 #endif
322
323 /*
324 * IEEE Std 1003.1-2024 (POSIX.1-2024)
325 */
326 #if (_POSIX_C_SOURCE - 0) >= 202405L || (_XOPEN_SOURCE - 0 >= 800) || \
327 defined(_NETBSD_SOURCE)
328 int getentropy(void *, size_t);
329 #ifndef __LIBC12_SOURCE__
330 int dup3(int, int, int) __RENAME(__dup3100);
331 #endif
332 int pipe2(int *, int);
333 #endif
334
335 /*
336 * Implementation-defined extensions
337 */
338 #if defined(_NETBSD_SOURCE)
339 int acct(const char *);
340 int closefrom(int);
341 int des_cipher(const char *, char *, long, int);
342 int des_setkey(const char *);
343 void endusershell(void);
344 int exect(const char *, char * const *, char * const *);
345 int execvpe(const char *, char * const *, char * const *);
346 int execlpe(const char *, const char *, ...);
347 int fchroot(int);
348 int fdiscard(int, off_t, off_t);
349 int fsync_range(int, int, off_t, off_t);
350 int getdomainname(char *, size_t);
351 int getgrouplist(const char *, gid_t, gid_t *, int *);
352 int getgroupmembership(const char *, gid_t, gid_t *, int, int *);
353 mode_t getmode(const void *, mode_t);
354 char *getpassfd(const char *, char *, size_t, int *, int, int);
355 #define GETPASS_NEED_TTY 0x001 /* Fail if we cannot set tty */
356 #define GETPASS_FAIL_EOF 0x002 /* Fail on EOF */
357 #define GETPASS_BUF_LIMIT 0x004 /* beep on buffer limit */
358 #define GETPASS_NO_SIGNAL 0x008 /* don't make ttychars send signals */
359 #define GETPASS_NO_BEEP 0x010 /* don't beep */
360 #define GETPASS_ECHO 0x020 /* echo characters as they are typed */
361 #define GETPASS_ECHO_STAR 0x040 /* echo '*' for each character */
362 #define GETPASS_7BIT 0x080 /* mask the high bit each char */
363 #define GETPASS_FORCE_LOWER 0x100 /* lowercase each char */
364 #define GETPASS_FORCE_UPPER 0x200 /* uppercase each char */
365 #define GETPASS_ECHO_NL 0x400 /* echo a newline if successful */
366
367 char *getpass_r(const char *, char *, size_t);
368 int getpeereid(int, uid_t *, gid_t *);
369 __aconst char *getusershell(void);
370 int initgroups(const char *, gid_t);
371 int iruserok(uint32_t, int, const char *, const char *);
372 int issetugid(void);
373 long lpathconf(const char *, int);
374 int mkstemps(char *, int);
375 int nfssvc(int, void *);
376 int profil(char *, size_t, unsigned long, unsigned int);
377 #ifndef __PSIGNAL_DECLARED
378 #define __PSIGNAL_DECLARED
379 /* also in signal.h */
380 void psignal(int, const char *);
381 #endif /* __PSIGNAL_DECLARED */
382 int rcmd(char **, int, const char *, const char *, const char *, int *);
383 int reboot(int, char *);
384 int revoke(const char *);
385 int rresvport(int *);
386 int ruserok(const char *, int, const char *, const char *);
387 int setdomainname(const char *, size_t);
388 int setgroups(int, const gid_t *);
389 int sethostid(long);
390 int sethostname(const char *, size_t);
391 int setlogin(const char *);
392 void *setmode(const char *);
393 int setrgid(gid_t);
394 int setruid(uid_t);
395 void setusershell(void);
396 void strmode(mode_t, char *);
397 #ifndef __STRSIGNAL_DECLARED
398 #define __STRSIGNAL_DECLARED
399 /* backwards-compatibility; also in string.h */
400 __aconst char *strsignal(int);
401 #endif /* __STRSIGNAL_DECLARED */
402 int swapctl(int, void *, int);
403 int swapon(const char *); /* obsoleted by swapctl() */
404 int syscall(int, ...);
405 quad_t __syscall(quad_t, ...);
406 int undelete(const char *);
407
408 #if 1 /*INET6*/
409 int rcmd_af(char **, int, const char *,
410 const char *, const char *, int *, int);
411 int rresvport_af(int *, int);
412 int rresvport_af_addr(int *, int, void *);
413 int iruserok_sa(const void *, int, int, const char *, const char *);
414 #endif
415
416 #ifndef __SYS_SIGLIST_DECLARED
417 #define __SYS_SIGLIST_DECLARED
418 /* also in signal.h */
419 extern const char *const *sys_siglist __RENAME(__sys_siglist14);
420 #endif /* __SYS_SIGLIST_DECLARED */
421 extern int optreset; /* getopt(3) external variable */
422 extern char *suboptarg; /* getsubopt(3) external variable */
423 #endif
424
425 #ifdef _LIBC_INTERNAL
426 pid_t __fork(void);
427 pid_t __locked_fork(int *) __weak;
428 #endif
429
430 __END_DECLS
431 #endif /* !_UNISTD_H_ */
432