master
1/* $NetBSD: unistd.h,v 1.163.2.1 2024/10/09 13:12:40 martin 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 setegid(gid_t);
177int seteuid(uid_t);
178#endif
179
180/*
181 * The following three syscalls are also defined in <sys/types.h>
182 * We protect them against double declarations.
183 */
184#ifndef __OFF_T_SYSCALLS_DECLARED
185#define __OFF_T_SYSCALLS_DECLARED
186off_t lseek(int, off_t, int);
187int truncate(const char *, off_t);
188/*
189 * IEEE Std 1003.1b-93,
190 * also found in X/Open Portability Guide >= Issue 4 Version 2
191 */
192#if (_POSIX_C_SOURCE - 0) >= 199309L || \
193 (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
194 (_XOPEN_SOURCE - 0) >= 500 || defined(_NETBSD_SOURCE)
195int ftruncate(int, off_t);
196#endif
197#endif /* __OFF_T_SYSCALLS_DECLARED */
198
199
200/*
201 * IEEE Std 1003.1b-93, adopted in X/Open CAE Specification Issue 5 Version 2
202 */
203#if (_POSIX_C_SOURCE - 0) >= 199309L || (_XOPEN_SOURCE - 0) >= 500 || \
204 defined(_NETBSD_SOURCE)
205int fdatasync(int);
206int fsync(int);
207#endif
208
209
210/*
211 * IEEE Std 1003.1c-95, also adopted by X/Open CAE Spec Issue 5 Version 2
212 */
213#if (_POSIX_C_SOURCE - 0) >= 199506L || (_XOPEN_SOURCE - 0) >= 500 || \
214 defined(_REENTRANT) || defined(_NETBSD_SOURCE)
215int ttyname_r(int, char *, size_t);
216#ifndef __PTHREAD_ATFORK_DECLARED
217#define __PTHREAD_ATFORK_DECLARED
218int pthread_atfork(void (*)(void), void (*)(void), void (*)(void));
219#endif
220#endif
221
222/*
223 * X/Open Portability Guide, all issues
224 */
225#if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
226int chroot(const char *);
227int nice(int);
228#endif
229
230
231/*
232 * X/Open Portability Guide >= Issue 4
233 */
234#if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
235__aconst char *crypt(const char *, const char *);
236int encrypt(char *, int);
237char *getpass(const char *);
238#endif
239#if defined(_XOPEN_SOURCE) || (_POSIX_C_SOURCE - 0) >= 200809L || \
240 defined(_NETBSD_SOURCE)
241pid_t getsid(pid_t);
242#endif
243
244
245/*
246 * X/Open Portability Guide >= Issue 4 Version 2
247 */
248#if (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
249 (_XOPEN_SOURCE - 0) >= 500 || defined(_NETBSD_SOURCE)
250#ifndef _BSD_INTPTR_T_
251typedef __intptr_t intptr_t;
252#define _BSD_INTPTR_T_
253#endif
254
255#define F_ULOCK 0
256#define F_LOCK 1
257#define F_TLOCK 2
258#define F_TEST 3
259
260int brk(void *);
261int fchdir(int);
262#if defined(_XOPEN_SOURCE)
263int fchown(int, uid_t, gid_t) __RENAME(__posix_fchown);
264#else
265int fchown(int, uid_t, gid_t);
266#endif
267int getdtablesize(void);
268long gethostid(void);
269int gethostname(char *, size_t);
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#endif
330
331
332/*
333 * Implementation-defined extensions
334 */
335#if defined(_NETBSD_SOURCE)
336int acct(const char *);
337int closefrom(int);
338int des_cipher(const char *, char *, long, int);
339int des_setkey(const char *);
340int dup3(int, int, int);
341void endusershell(void);
342int exect(const char *, char * const *, char * const *);
343int execvpe(const char *, char * const *, char * const *);
344int execlpe(const char *, const char *, ...);
345int fchroot(int);
346int fdiscard(int, off_t, off_t);
347int fsync_range(int, int, off_t, off_t);
348int getdomainname(char *, size_t);
349int getgrouplist(const char *, gid_t, gid_t *, int *);
350int getgroupmembership(const char *, gid_t, gid_t *, int, int *);
351mode_t getmode(const void *, mode_t);
352char *getpassfd(const char *, char *, size_t, int *, int, int);
353#define GETPASS_NEED_TTY 0x001 /* Fail if we cannot set tty */
354#define GETPASS_FAIL_EOF 0x002 /* Fail on EOF */
355#define GETPASS_BUF_LIMIT 0x004 /* beep on buffer limit */
356#define GETPASS_NO_SIGNAL 0x008 /* don't make ttychars send signals */
357#define GETPASS_NO_BEEP 0x010 /* don't beep */
358#define GETPASS_ECHO 0x020 /* echo characters as they are typed */
359#define GETPASS_ECHO_STAR 0x040 /* echo '*' for each character */
360#define GETPASS_7BIT 0x080 /* mask the high bit each char */
361#define GETPASS_FORCE_LOWER 0x100 /* lowercase each char */
362#define GETPASS_FORCE_UPPER 0x200 /* uppercase each char */
363#define GETPASS_ECHO_NL 0x400 /* echo a newline if successful */
364
365char *getpass_r(const char *, char *, size_t);
366int getpeereid(int, uid_t *, gid_t *);
367__aconst char *getusershell(void);
368int initgroups(const char *, gid_t);
369int iruserok(uint32_t, int, const char *, const char *);
370int issetugid(void);
371long lpathconf(const char *, int);
372int mkstemps(char *, int);
373int nfssvc(int, void *);
374int pipe2(int *, int);
375int profil(char *, size_t, unsigned long, unsigned int);
376#ifndef __PSIGNAL_DECLARED
377#define __PSIGNAL_DECLARED
378/* also in signal.h */
379void psignal(int, const char *);
380#endif /* __PSIGNAL_DECLARED */
381int rcmd(char **, int, const char *, const char *, const char *, int *);
382int reboot(int, char *);
383int revoke(const char *);
384int rresvport(int *);
385int ruserok(const char *, int, const char *, const char *);
386int setdomainname(const char *, size_t);
387int setgroups(int, const gid_t *);
388int sethostid(long);
389int sethostname(const char *, size_t);
390int setlogin(const char *);
391void *setmode(const char *);
392int setrgid(gid_t);
393int setruid(uid_t);
394void setusershell(void);
395void strmode(mode_t, char *);
396#ifndef __STRSIGNAL_DECLARED
397#define __STRSIGNAL_DECLARED
398/* backwards-compatibility; also in string.h */
399__aconst char *strsignal(int);
400#endif /* __STRSIGNAL_DECLARED */
401int swapctl(int, void *, int);
402int swapon(const char *); /* obsoleted by swapctl() */
403int syscall(int, ...);
404quad_t __syscall(quad_t, ...);
405int undelete(const char *);
406
407#if 1 /*INET6*/
408int rcmd_af(char **, int, const char *,
409 const char *, const char *, int *, int);
410int rresvport_af(int *, int);
411int rresvport_af_addr(int *, int, void *);
412int iruserok_sa(const void *, int, int, const char *, const char *);
413#endif
414
415#ifndef __SYS_SIGLIST_DECLARED
416#define __SYS_SIGLIST_DECLARED
417/* also in signal.h */
418extern const char *const *sys_siglist __RENAME(__sys_siglist14);
419#endif /* __SYS_SIGLIST_DECLARED */
420extern int optreset; /* getopt(3) external variable */
421extern char *suboptarg; /* getsubopt(3) external variable */
422#endif
423
424__END_DECLS
425#endif /* !_UNISTD_H_ */