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