include/unistd.h

   1 /*      $NetBSD: unistd.h,v 1.135 2012/07/14 15:06:26 darrenr 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(__minix) && (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      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 #ifndef __minix
 137 int      setpgid(pid_t, pid_t);
 138 #endif /* !__minix */
 139 pid_t    setsid(void);
 140 int      setuid(uid_t);
 141 unsigned int     sleep(unsigned int);
 142 long     sysconf(int);
 143 pid_t    tcgetpgrp(int);
 144 int      tcsetpgrp(int, pid_t);
 145 __aconst char *ttyname(int);
 146 int      unlink(const char *);
 147 ssize_t  write(int, const void *, size_t);
 148
 149
 150 /*
 151  * IEEE Std 1003.2-92, adopted in X/Open Portability Guide Issue 4 and later
 152  */
 153 #if (_POSIX_C_SOURCE - 0) >= 2 || defined(_XOPEN_SOURCE) || \
 154     defined(_NETBSD_SOURCE)
 155 int      getopt(int, char * const [], const char *);
 156
 157 extern   char *optarg;                  /* getopt(3) external variables */
 158 extern   int opterr;
 159 extern   int optind;
 160 extern   int optopt;
 161 #endif
 162
 163 /*
 164  * The Open Group Base Specifications, Issue 6; IEEE Std 1003.1-2001 (POSIX)
 165  */
 166 #if (_POSIX_C_SOURCE - 0) >= 200112L || (_XOPEN_SOURCE - 0) >= 600 || \
 167     defined(_NETBSD_SOURCE)
 168 int      setegid(gid_t);
 169 int      seteuid(uid_t);
 170 #endif
 171
 172 /*
 173  * The following three syscalls are also defined in <sys/types.h>
 174  * We protect them against double declarations.
 175  */
 176 #ifndef __OFF_T_SYSCALLS_DECLARED
 177 #define __OFF_T_SYSCALLS_DECLARED
 178 off_t    lseek(int, off_t, int);
 179 int      truncate(const char *, off_t);
 180 /*
 181  * IEEE Std 1003.1b-93,
 182  * also found in X/Open Portability Guide >= Issue 4 Verion 2
 183  */
 184 #if (_POSIX_C_SOURCE - 0) >= 199309L || \
 185     (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
 186     (_XOPEN_SOURCE - 0) >= 500 || defined(_NETBSD_SOURCE)
 187 int      ftruncate(int, off_t);
 188 #endif
 189 #endif /* __OFF_T_SYSCALLS_DECLARED */
 190
 191
 192 /*
 193  * IEEE Std 1003.1b-93, adopted in X/Open CAE Specification Issue 5 Version 2
 194  */
 195 #if (_POSIX_C_SOURCE - 0) >= 199309L || (_XOPEN_SOURCE - 0) >= 500 || \
 196     defined(_NETBSD_SOURCE)
 197 #ifndef __minix
 198 int      fdatasync(int);
 199 #endif /* !__minix */
 200 int      fsync(int);
 201 #endif
 202
 203
 204 /*
 205  * IEEE Std 1003.1c-95, also adopted by X/Open CAE Spec Issue 5 Version 2
 206  */
 207 #if (_POSIX_C_SOURCE - 0) >= 199506L || (_XOPEN_SOURCE - 0) >= 500 || \
 208     defined(_REENTRANT) || defined(_NETBSD_SOURCE)
 209 int      ttyname_r(int, char *, size_t);
 210 int      pthread_atfork(void (*)(void), void (*)(void), void (*)(void));
 211 #endif
 212
 213 /*
 214  * X/Open Portability Guide, all issues
 215  */
 216 #if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
 217 int      chroot(const char *);
 218 int      nice(int);
 219 #endif
 220
 221
 222 /*
 223  * X/Open Portability Guide >= Issue 4
 224  */
 225 #if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
 226 __aconst char *crypt(const char *, const char *);
 227 int      encrypt(char *, int);
 228 char    *getpass(const char *);
 229 pid_t    getsid(pid_t);
 230 #endif
 231
 232
 233 /*
 234  * X/Open Portability Guide >= Issue 4 Version 2
 235  */
 236 #if (defined(_XOPEN_SOURCE) && defined(_XOPEN_SOURCE_EXTENDED)) || \
 237     (_XOPEN_SOURCE - 0) >= 500 || defined(_NETBSD_SOURCE)
 238 #ifndef intptr_t
 239 typedef __intptr_t      intptr_t;
 240 #define intptr_t        __intptr_t
 241 #endif
 242
 243 #define F_ULOCK         0
 244 #define F_LOCK          1
 245 #define F_TLOCK         2
 246 #define F_TEST          3
 247
 248 int      brk(void *);
 249 int      fchdir(int);
 250 #if !defined(__minix) && defined(_XOPEN_SOURCE)
 251 int      fchown(int, uid_t, gid_t) __RENAME(__posix_fchown);
 252 #else
 253 int      fchown(int, uid_t, gid_t);
 254 #endif
 255 int      getdtablesize(void);
 256 long     gethostid(void);
 257 int      gethostname(char *, size_t);
 258 __pure int
 259          getpagesize(void);             /* legacy */
 260 #ifndef __minix
 261 pid_t    getpgid(pid_t);
 262 #if defined(_XOPEN_SOURCE)
 263 int      lchown(const char *, uid_t, gid_t) __RENAME(__posix_lchown);
 264 #else
 265 int      lchown(const char *, uid_t, gid_t);
 266 #endif
 267 #endif /* !__minix */
 268 int      lockf(int, int, off_t);
 269 #if __SSP_FORTIFY_LEVEL == 0
 270 ssize_t  readlink(const char * __restrict, char * __restrict, size_t);
 271 #endif
 272 void    *sbrk(intptr_t);
 273 #ifndef __minix
 274 /* XXX prototype wrong! */
 275 int      setpgrp(pid_t, pid_t);                 /* obsoleted by setpgid() */
 276 int      setregid(gid_t, gid_t);
 277 int      setreuid(uid_t, uid_t);
 278 #endif /* !__minix */
 279 void     swab(const void * __restrict, void * __restrict, ssize_t);
 280 int      symlink(const char *, const char *);
 281 void     sync(void);
 282 useconds_t ualarm(useconds_t, useconds_t);
 283 int      usleep(useconds_t);
 284 #ifndef __LIBC12_SOURCE__
 285 pid_t    vfork(void) __RENAME(__vfork14) __returns_twice;
 286 #endif
 287
 288 #ifndef __AUDIT__
 289 char    *getwd(char *);                         /* obsoleted by getcwd() */
 290 #endif
 291 #endif /* _XOPEN_SOURCE_EXTENDED || _XOPEN_SOURCE >= 500 || _NETBSD_SOURCE */
 292
 293
 294 /*
 295  * X/Open CAE Specification Issue 5 Version 2
 296  */
 297 #if (_XOPEN_SOURCE - 0) >= 500 || defined(_NETBSD_SOURCE)
 298 ssize_t  pread(int, void *, size_t, off_t);
 299 ssize_t  pwrite(int, const void *, size_t, off_t);
 300 #endif
 301
 302 /*
 303  * X/Open Extended API set 2 (a.k.a. C063)
 304  */
 305 #if defined(_INCOMPLETE_XOPEN_C063)
 306 int     linkat(int, const char *, int, const char *, int);
 307 int     renameat(int, const char *, int, const char *);
 308 int     mkfifoat(int, const char *, mode_t);
 309 int     mknodat(int, const char *, mode_t, uint32_t);
 310 int     mkdirat(int, const char *, mode_t);
 311 int     faccessat(int, const char *, int, int);
 312 int     fchmodat(int, const char *, mode_t, int);
 313 int     fchownat(int, const char *, uid_t, gid_t, int);
 314 int     fexecve(int, char * const *, char * const *);
 315 int     readlinkat(int, const char *, char *, size_t);
 316 int     symlinkat(const char *, int, const char *);
 317 int     unlinkat(int, const char *, int);
 318 #endif
 319
 320
 321 /*
 322  * Implementation-defined extensions
 323  */
 324 #ifdef __minix
 325 int lseek64(int fd, u64_t _offset, int _whence, u64_t *_newpos);
 326 #if defined(_MINIX)
 327 #include <minix/type.h>
 328
 329 int getprocnr(void);
 330 int getnprocnr(pid_t pid);
 331 int getpprocnr(void);
 332 int _pm_findproc(char *proc_name, int *proc_nr);
 333 int mapdriver(char *label, int major, int style, int flags);
 334 pid_t getnpid(endpoint_t proc_ep);
 335 uid_t getnuid(endpoint_t proc_ep);
 336 gid_t getngid(endpoint_t proc_ep);
 337 int getnucred(endpoint_t proc_ep, struct ucred *ucred);
 338 ssize_t pread64(int fd, void *buf, size_t count, u64_t where);
 339 ssize_t pwrite64(int fd, const void *buf, size_t count, u64_t where);
 340 #endif /* __MINIX */
 341 #endif /* __minix */
 342
 343 #if defined(_NETBSD_SOURCE)
 344 #ifndef __minix
 345 int      acct(const char *);
 346 #endif /* !__minix */
 347 int      closefrom(int);
 348 int      des_cipher(const char *, char *, long, int);
 349 int      des_setkey(const char *);
 350 int      dup3(int, int, int);
 351 void     endusershell(void);
 352 int      exect(const char *, char * const *, char * const *);
 353 int      fchroot(int);
 354 int      fsync_range(int, int, off_t, off_t);
 355 int      getdomainname(char *, size_t);
 356 int      getgrouplist(const char *, gid_t, gid_t *, int *);
 357 int      getgroupmembership(const char *, gid_t, gid_t *, int, int *);
 358 mode_t   getmode(const void *, mode_t);
 359 char    *getpassfd(const char *, char *, size_t, int *, int, int);
 360 #define GETPASS_NEED_TTY        0x001   /* Fail if we cannot set tty */
 361 #define GETPASS_FAIL_EOF        0x002   /* Fail on EOF */
 362 #define GETPASS_BUF_LIMIT       0x004   /* beep on buffer limit */
 363 #define GETPASS_NO_SIGNAL       0x008   /* don't make ttychars send signals */
 364 #define GETPASS_NO_BEEP         0x010   /* don't beep */
 365 #define GETPASS_ECHO            0x020   /* echo characters as they are typed */
 366 #define GETPASS_ECHO_STAR       0x040   /* echo '*' for each character */
 367 #define GETPASS_7BIT            0x080   /* mask the high bit each char */
 368 #define GETPASS_FORCE_LOWER     0x100   /* lowercase each char */
 369 #define GETPASS_FORCE_UPPER     0x200   /* uppercase each char */
 370 #define GETPASS_ECHO_NL         0x400   /* echo a newline if successful */
 371
 372 char    *getpass_r(const char *, char *, size_t);
 373 int      getpeereid(int, uid_t *, gid_t *);
 374 int      getsubopt(char **, char * const *, char **);
 375 __aconst char *getusershell(void);
 376 int      initgroups(const char *, gid_t);
 377 int      iruserok(uint32_t, int, const char *, const char *);
 378 int      issetugid(void);
 379 int      nfssvc(int, void *);
 380 #ifndef __minix
 381 int      pipe2(int *, int);
 382 int      profil(char *, size_t, u_long, u_int);
 383 #endif /* !__minix */
 384 #ifndef __PSIGNAL_DECLARED
 385 #define __PSIGNAL_DECLARED
 386 /* also in signal.h */
 387 void     psignal(int, const char *);
 388 #endif /* __PSIGNAL_DECLARED */
 389 int      rcmd(char **, int, const char *, const char *, const char *, int *);
 390 #ifdef __minix
 391 int      reboot(int);
 392 #else
 393 int      reboot(int, char *);
 394 #endif
 395 #ifndef __minix
 396 int      revoke(const char *);
 397 #endif
 398 int      rresvport(int *);
 399 int      ruserok(const char *, int, const char *, const char *);
 400 int      setdomainname(const char *, size_t);
 401 int      setgroups(int, const gid_t *);
 402 int      sethostid(long);
 403 int      sethostname(const char *, size_t);
 404 int      setlogin(const char *);
 405 void    *setmode(const char *);
 406 int      setrgid(gid_t);
 407 int      setruid(uid_t);
 408 void     setusershell(void);
 409 void     strmode(mode_t, char *);
 410 #ifndef __STRSIGNAL_DECLARED
 411 #define __STRSIGNAL_DECLARED
 412 /* backwards-compatibility; also in string.h */
 413 __aconst char *strsignal(int);
 414 #endif /* __STRSIGNAL_DECLARED */
 415 #ifndef __minix
 416 int      swapctl(int, void *, int);
 417 int      swapon(const char *);                  /* obsoleted by swapctl() */
 418 #endif /* !__minix */
 419 int      syscall(int, ...);
 420 quad_t   __syscall(quad_t, ...);
 421 int      undelete(const char *);
 422
 423 #if 1 /*INET6*/
 424 int      rcmd_af(char **, int, const char *,
 425             const char *, const char *, int *, int);
 426 int      rresvport_af(int *, int);
 427 int      rresvport_af_addr(int *, int, void *);
 428 int      iruserok_sa(const void *, int, int, const char *, const char *);
 429 #endif
 430
 431 #ifndef __SYS_SIGLIST_DECLARED
 432 #define __SYS_SIGLIST_DECLARED
 433 /* also in signal.h */
 434 extern const char *const *sys_siglist __RENAME(__sys_siglist14);
 435 #endif /* __SYS_SIGLIST_DECLARED */
 436 extern   int optreset;          /* getopt(3) external variable */
 437 extern   char *suboptarg;       /* getsubopt(3) external variable */
 438 #endif
 439
 440 __END_DECLS
 441
 442 #ifdef __minix
 443 /* Minix expects RBT_* flags to be included with <unistd.h> */
 444 #include <sys/reboot.h>
 445 #endif
 446
 447 #endif /* !_UNISTD_H_ */