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);
88int access(const char *, int);
89unsigned int alarm(unsigned int);
90int chdir(const char *);
91#if defined(_POSIX_C_SOURCE) || defined(_XOPEN_SOURCE)
92int chown(const char *, uid_t, gid_t) __RENAME(__posix_chown);
93#else
94int chown(const char *, uid_t, gid_t);
95#endif /* defined(_POSIX_C_SOURCE) || defined(_XOPEN_SOURCE) */
96int close(int);
97size_t confstr(int, char *, size_t);
98#ifndef __CUSERID_DECLARED
99#define __CUSERID_DECLARED
100/* also declared in stdio.h */
101char *cuserid(char *); /* obsolete */
102#endif /* __CUSERID_DECLARED */
103int dup(int);
104int dup2(int, int);
105int execl(const char *, const char *, ...) __null_sentinel;
106int execle(const char *, const char *, ...);
107int execlp(const char *, const char *, ...) __null_sentinel;
108int execv(const char *, char * const *);
109int execve(const char *, char * const *, char * const *);
110int execvp(const char *, char * const *);
111pid_t fork(void);
112long fpathconf(int, int);
113#if __SSP_FORTIFY_LEVEL == 0
114char *getcwd(char *, size_t);
115#endif
116gid_t getegid(void);
117uid_t geteuid(void);
118gid_t getgid(void);
119int getgroups(int, gid_t []);
120__aconst char *getlogin(void);
121int getlogin_r(char *, size_t);
122pid_t getpgrp(void);
123pid_t getpid(void);
124pid_t getppid(void);
125uid_t getuid(void);
126int isatty(int);
127int link(const char *, const char *);
128long pathconf(const char *, int);
129int pause(void);
130int pipe(int *);
131#if __SSP_FORTIFY_LEVEL == 0
132ssize_t read(int, void *, size_t);
133#endif
134int rmdir(const char *);
135int setgid(gid_t);
136int setpgid(pid_t, pid_t);
137pid_t setsid(void);
138int setuid(uid_t);
139unsigned int sleep(unsigned int);
140long sysconf(int);
141pid_t tcgetpgrp(int);
142int tcsetpgrp(int, pid_t);
143__aconst char *ttyname(int);
144int unlink(const char *);
145ssize_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)
153int getopt(int, char * const [], const char *);
154
155extern char *optarg; /* getopt(3) external variables */
156extern int opterr;
157extern int optind;
158extern 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
167ssize_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)
176int gethostname(char *, size_t);
177int setegid(gid_t);
178int 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
187off_t lseek(int, off_t, int);
188int 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)
196int 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)
206int fdatasync(int);
207int 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)
216int ttyname_r(int, char *, size_t);
217#ifndef __PTHREAD_ATFORK_DECLARED
218#define __PTHREAD_ATFORK_DECLARED
219int 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)
227int chroot(const char *);
228int 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 *);
237int encrypt(char *, int);
238char *getpass(const char *);
239#endif
240#if defined(_XOPEN_SOURCE) || (_POSIX_C_SOURCE - 0) >= 200809L || \
241 defined(_NETBSD_SOURCE)
242pid_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_
252typedef __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
261int brk(void *);
262int fchdir(int);
263#if defined(_XOPEN_SOURCE)
264int fchown(int, uid_t, gid_t) __RENAME(__posix_fchown);
265#else
266int fchown(int, uid_t, gid_t);
267#endif
268int getdtablesize(void);
269long gethostid(void);
270__pure int
271 getpagesize(void); /* legacy */
272pid_t getpgid(pid_t);
273#if defined(_XOPEN_SOURCE)
274int lchown(const char *, uid_t, gid_t) __RENAME(__posix_lchown);
275#else
276int lchown(const char *, uid_t, gid_t);
277#endif
278int lockf(int, int, off_t);
279void *sbrk(intptr_t);
280/* XXX prototype wrong! */
281int setpgrp(pid_t, pid_t); /* obsoleted by setpgid() */
282int setregid(gid_t, gid_t);
283int setreuid(uid_t, uid_t);
284void swab(const void * __restrict, void * __restrict, ssize_t);
285int symlink(const char *, const char *);
286void sync(void);
287useconds_t ualarm(useconds_t, useconds_t);
288int usleep(useconds_t);
289#ifndef __LIBC12_SOURCE__
290pid_t vfork(void) __RENAME(__vfork14) __returns_twice;
291#endif
292
293#ifndef __AUDIT__
294char *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)
304ssize_t pread(int, void *, size_t, off_t);
305ssize_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)
313int linkat(int, const char *, int, const char *, int);
314int renameat(int, const char *, int, const char *);
315int faccessat(int, const char *, int, int);
316int fchownat(int, const char *, uid_t, gid_t, int);
317ssize_t readlinkat(int, const char *, char *, size_t);
318int symlinkat(const char *, int, const char *);
319int unlinkat(int, const char *, int);
320int 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)
328int getentropy(void *, size_t);
329#ifndef __LIBC12_SOURCE__
330int dup3(int, int, int) __RENAME(__dup3100);
331#endif
332int pipe2(int *, int);
333#endif
334
335/*
336 * Implementation-defined extensions
337 */
338#if defined(_NETBSD_SOURCE)
339int acct(const char *);
340int closefrom(int);
341int des_cipher(const char *, char *, long, int);
342int des_setkey(const char *);
343void endusershell(void);
344int exect(const char *, char * const *, char * const *);
345int execvpe(const char *, char * const *, char * const *);
346int execlpe(const char *, const char *, ...);
347int fchroot(int);
348int fdiscard(int, off_t, off_t);
349int fsync_range(int, int, off_t, off_t);
350int getdomainname(char *, size_t);
351int getgrouplist(const char *, gid_t, gid_t *, int *);
352int getgroupmembership(const char *, gid_t, gid_t *, int, int *);
353mode_t getmode(const void *, mode_t);
354char *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
367char *getpass_r(const char *, char *, size_t);
368int getpeereid(int, uid_t *, gid_t *);
369__aconst char *getusershell(void);
370int initgroups(const char *, gid_t);
371int iruserok(uint32_t, int, const char *, const char *);
372int issetugid(void);
373long lpathconf(const char *, int);
374int mkstemps(char *, int);
375int nfssvc(int, void *);
376int profil(char *, size_t, unsigned long, unsigned int);
377#ifndef __PSIGNAL_DECLARED
378#define __PSIGNAL_DECLARED
379/* also in signal.h */
380void psignal(int, const char *);
381#endif /* __PSIGNAL_DECLARED */
382int rcmd(char **, int, const char *, const char *, const char *, int *);
383int reboot(int, char *);
384int revoke(const char *);
385int rresvport(int *);
386int ruserok(const char *, int, const char *, const char *);
387int setdomainname(const char *, size_t);
388int setgroups(int, const gid_t *);
389int sethostid(long);
390int sethostname(const char *, size_t);
391int setlogin(const char *);
392void *setmode(const char *);
393int setrgid(gid_t);
394int setruid(uid_t);
395void setusershell(void);
396void 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 */
402int swapctl(int, void *, int);
403int swapon(const char *); /* obsoleted by swapctl() */
404int syscall(int, ...);
405quad_t __syscall(quad_t, ...);
406int undelete(const char *);
407
408#if 1 /*INET6*/
409int rcmd_af(char **, int, const char *,
410 const char *, const char *, int *, int);
411int rresvport_af(int *, int);
412int rresvport_af_addr(int *, int, void *);
413int 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 */
419extern const char *const *sys_siglist __RENAME(__sys_siglist14);
420#endif /* __SYS_SIGLIST_DECLARED */
421extern int optreset; /* getopt(3) external variable */
422extern char *suboptarg; /* getsubopt(3) external variable */
423#endif
424
425#ifdef _LIBC_INTERNAL
426pid_t __fork(void);
427pid_t __locked_fork(int *) __weak;
428#endif
429
430__END_DECLS
431#endif /* !_UNISTD_H_ */