include/unistd.h

   1 /* Copyright (C) 1991-2006, 2007, 2008, 2009 Free Software Foundation, Inc.
   2    This file is part of the GNU C Library.
   3
   4    The GNU C Library is free software; you can redistribute it and/or
   5    modify it under the terms of the GNU Lesser General Public
   6    License as published by the Free Software Foundation; either
   7    version 2.1 of the License, or (at your option) any later version.
   8
   9    The GNU C Library is distributed in the hope that it will be useful,
  10    but WITHOUT ANY WARRANTY; without even the implied warranty of
  11    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12    Lesser General Public License for more details.
  13
  14    You should have received a copy of the GNU Lesser General Public
  15    License along with the GNU C Library; if not, write to the Free
  16    Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
  17    02111-1307 USA.  */
  18
  19 /*
  20  *      POSIX Standard: 2.10 Symbolic Constants         <unistd.h>
  21  */
  22
  23 #ifndef _UNISTD_H
  24 #define _UNISTD_H       1
  25
  26 #include <features.h>
  27
  28 __BEGIN_DECLS
  29
  30 /* These may be used to determine what facilities are present at compile time.
  31    Their values can be obtained at run time from `sysconf'.  */
  32
  33 #ifdef __USE_XOPEN2K8
  34 /* POSIX Standard approved as ISO/IEC 9945-1 as of September 2008.  */
  35 # define _POSIX_VERSION 200809L
  36 #elif defined __USE_XOPEN2K
  37 /* POSIX Standard approved as ISO/IEC 9945-1 as of December 2001.  */
  38 # define _POSIX_VERSION 200112L
  39 #elif defined __USE_POSIX199506
  40 /* POSIX Standard approved as ISO/IEC 9945-1 as of June 1995.  */
  41 # define _POSIX_VERSION 199506L
  42 #elif defined __USE_POSIX199309
  43 /* POSIX Standard approved as ISO/IEC 9945-1 as of September 1993.  */
  44 # define _POSIX_VERSION 199309L
  45 #else
  46 /* POSIX Standard approved as ISO/IEC 9945-1 as of September 1990.  */
  47 # define _POSIX_VERSION 199009L
  48 #endif
  49
  50 /* These are not #ifdef __USE_POSIX2 because they are
  51    in the theoretically application-owned namespace.  */
  52
  53 #ifdef __USE_XOPEN2K8
  54 # define __POSIX2_THIS_VERSION  200809L
  55 /* The utilities on GNU systems also correspond to this version.  */
  56 #elif defined __USE_XOPEN2K
  57 /* The utilities on GNU systems also correspond to this version.  */
  58 # define __POSIX2_THIS_VERSION  200112L
  59 #elif defined __USE_POSIX199506
  60 /* The utilities on GNU systems also correspond to this version.  */
  61 # define __POSIX2_THIS_VERSION  199506L
  62 #else
  63 /* The utilities on GNU systems also correspond to this version.  */
  64 # define __POSIX2_THIS_VERSION  199209L
  65 #endif
  66
  67 /* The utilities on GNU systems also correspond to this version.  */
  68 #define _POSIX2_VERSION __POSIX2_THIS_VERSION
  69
  70 /* If defined, the implementation supports the
  71    C Language Bindings Option.  */
  72 #define _POSIX2_C_BIND  __POSIX2_THIS_VERSION
  73
  74 /* If defined, the implementation supports the
  75    C Language Development Utilities Option.  */
  76 #define _POSIX2_C_DEV   __POSIX2_THIS_VERSION
  77
  78 /* If defined, the implementation supports the
  79    Software Development Utilities Option.  */
  80 #define _POSIX2_SW_DEV  __POSIX2_THIS_VERSION
  81
  82 #if 0 /* uClibc does not provide the utility */
  83 /* If defined, the implementation supports the
  84    creation of locales with the localedef utility.  */
  85 #define _POSIX2_LOCALEDEF       __POSIX2_THIS_VERSION
  86 #endif
  87
  88 /* X/Open version number to which the library conforms.  It is selectable.  */
  89 #ifdef __USE_XOPEN2K8
  90 # define _XOPEN_VERSION 700
  91 #elif defined __USE_XOPEN2K
  92 # define _XOPEN_VERSION 600
  93 #elif defined __USE_UNIX98
  94 # define _XOPEN_VERSION 500
  95 #else
  96 # define _XOPEN_VERSION 4
  97 #endif
  98
  99 /* Commands and utilities from XPG4 are available.  */
 100 #define _XOPEN_XCU_VERSION      4
 101
 102 /* We are compatible with the old published standards as well.  */
 103 #define _XOPEN_XPG2     1
 104 #define _XOPEN_XPG3     1
 105 #define _XOPEN_XPG4     1
 106
 107 /* The X/Open Unix extensions are available.  */
 108 #define _XOPEN_UNIX     1
 109
 110 /* Encryption is present.  */
 111 #define _XOPEN_CRYPT    1
 112
 113 /* The enhanced internationalization capabilities according to XPG4.2
 114    are present.  */
 115 #define _XOPEN_ENH_I18N 1
 116
 117 /* The legacy interfaces are also available.  */
 118 #define _XOPEN_LEGACY   1
 119
 120
 121 /* Get values of POSIX options:
 122
 123    If these symbols are defined, the corresponding features are
 124    always available.  If not, they may be available sometimes.
 125    The current values can be obtained with `sysconf'.
 126
 127    _POSIX_JOB_CONTROL           Job control is supported.
 128    _POSIX_SAVED_IDS             Processes have a saved set-user-ID
 129                                 and a saved set-group-ID.
 130    _POSIX_REALTIME_SIGNALS      Real-time, queued signals are supported.
 131    _POSIX_PRIORITY_SCHEDULING   Priority scheduling is supported.
 132    _POSIX_TIMERS                POSIX.4 clocks and timers are supported.
 133    _POSIX_ASYNCHRONOUS_IO       Asynchronous I/O is supported.
 134    _POSIX_PRIORITIZED_IO        Prioritized asynchronous I/O is supported.
 135    _POSIX_SYNCHRONIZED_IO       Synchronizing file data is supported.
 136    _POSIX_FSYNC                 The fsync function is present.
 137    _POSIX_MAPPED_FILES          Mapping of files to memory is supported.
 138    _POSIX_MEMLOCK               Locking of all memory is supported.
 139    _POSIX_MEMLOCK_RANGE         Locking of ranges of memory is supported.
 140    _POSIX_MEMORY_PROTECTION     Setting of memory protections is supported.
 141    _POSIX_MESSAGE_PASSING       POSIX.4 message queues are supported.
 142    _POSIX_SEMAPHORES            POSIX.4 counting semaphores are supported.
 143    _POSIX_SHARED_MEMORY_OBJECTS POSIX.4 shared memory objects are supported.
 144    _POSIX_THREADS               POSIX.1c pthreads are supported.
 145    _POSIX_THREAD_ATTR_STACKADDR Thread stack address attribute option supported.
 146    _POSIX_THREAD_ATTR_STACKSIZE Thread stack size attribute option supported.
 147    _POSIX_THREAD_SAFE_FUNCTIONS Thread-safe functions are supported.
 148    _POSIX_THREAD_PRIORITY_SCHEDULING
 149                                 POSIX.1c thread execution scheduling supported.
 150    _POSIX_THREAD_PRIO_INHERIT   Thread priority inheritance option supported.
 151    _POSIX_THREAD_PRIO_PROTECT   Thread priority protection option supported.
 152    _POSIX_THREAD_PROCESS_SHARED Process-shared synchronization supported.
 153    _POSIX_PII                   Protocol-independent interfaces are supported.
 154    _POSIX_PII_XTI               XTI protocol-indep. interfaces are supported.
 155    _POSIX_PII_SOCKET            Socket protocol-indep. interfaces are supported.
 156    _POSIX_PII_INTERNET          Internet family of protocols supported.
 157    _POSIX_PII_INTERNET_STREAM   Connection-mode Internet protocol supported.
 158    _POSIX_PII_INTERNET_DGRAM    Connectionless Internet protocol supported.
 159    _POSIX_PII_OSI               ISO/OSI family of protocols supported.
 160    _POSIX_PII_OSI_COTS          Connection-mode ISO/OSI service supported.
 161    _POSIX_PII_OSI_CLTS          Connectionless ISO/OSI service supported.
 162    _POSIX_POLL                  Implementation supports `poll' function.
 163    _POSIX_SELECT                Implementation supports `select' and `pselect'.
 164
 165    _XOPEN_REALTIME              X/Open realtime support is available.
 166    _XOPEN_REALTIME_THREADS      X/Open realtime thread support is available.
 167    _XOPEN_SHM                   Shared memory interface according to XPG4.2.
 168
 169    _XBS5_ILP32_OFF32            Implementation provides environment with 32-bit
 170                                 int, long, pointer, and off_t types.
 171    _XBS5_ILP32_OFFBIG           Implementation provides environment with 32-bit
 172                                 int, long, and pointer and off_t with at least
 173                                 64 bits.
 174    _XBS5_LP64_OFF64             Implementation provides environment with 32-bit
 175                                 int, and 64-bit long, pointer, and off_t types.
 176    _XBS5_LPBIG_OFFBIG           Implementation provides environment with at
 177                                 least 32 bits int and long, pointer, and off_t
 178                                 with at least 64 bits.
 179
 180    If any of these symbols is defined as -1, the corresponding option is not
 181    true for any file.  If any is defined as other than -1, the corresponding
 182    option is true for all files.  If a symbol is not defined at all, the value
 183    for a specific file can be obtained from `pathconf' and `fpathconf'.
 184
 185    _POSIX_CHOWN_RESTRICTED      Only the super user can use `chown' to change
 186                                 the owner of a file.  `chown' can only be used
 187                                 to change the group ID of a file to a group of
 188                                 which the calling process is a member.
 189    _POSIX_NO_TRUNC              Pathname components longer than
 190                                 NAME_MAX generate an error.
 191    _POSIX_VDISABLE              If defined, if the value of an element of the
 192                                 `c_cc' member of `struct termios' is
 193                                 _POSIX_VDISABLE, no character will have the
 194                                 effect associated with that element.
 195    _POSIX_SYNC_IO               Synchronous I/O may be performed.
 196    _POSIX_ASYNC_IO              Asynchronous I/O may be performed.
 197    _POSIX_PRIO_IO               Prioritized Asynchronous I/O may be performed.
 198
 199    Support for the Large File Support interface is not generally available.
 200    If it is available the following constants are defined to one.
 201    _LFS64_LARGEFILE             Low-level I/O supports large files.
 202    _LFS64_STDIO                 Standard I/O supports large files.
 203    */
 204
 205 #include <bits/posix_opt.h>
 206 /* keep it after posix_opt.h, it overwrites based on uClibc's config options */
 207 #include <bits/uClibc_posix_opt.h>
 208
 209 /* Get the environment definitions from Unix98.  */
 210 #ifdef __USE_UNIX98
 211 # include <bits/environments.h>
 212 #endif
 213
 214 /* Standard file descriptors.  */
 215 #define STDIN_FILENO    0       /* Standard input.  */
 216 #define STDOUT_FILENO   1       /* Standard output.  */
 217 #define STDERR_FILENO   2       /* Standard error output.  */
 218
 219
 220 /* All functions that are not declared anywhere else.  */
 221
 222 #include <bits/types.h>
 223
 224 #ifndef __ssize_t_defined
 225 typedef __ssize_t ssize_t;
 226 # define __ssize_t_defined
 227 #endif
 228
 229 #define __need_size_t
 230 #define __need_NULL
 231 #include <stddef.h>
 232
 233 #if defined __USE_XOPEN || defined __USE_XOPEN2K
 234 /* The Single Unix specification says that some more types are
 235    available here.  */
 236 # ifndef __gid_t_defined
 237 typedef __gid_t gid_t;
 238 #  define __gid_t_defined
 239 # endif
 240
 241 # ifndef __uid_t_defined
 242 typedef __uid_t uid_t;
 243 #  define __uid_t_defined
 244 # endif
 245
 246 # ifndef __off_t_defined
 247 #  ifndef __USE_FILE_OFFSET64
 248 typedef __off_t off_t;
 249 #  else
 250 typedef __off64_t off_t;
 251 #  endif
 252 #  define __off_t_defined
 253 # endif
 254 # if defined __USE_LARGEFILE64 && !defined __off64_t_defined
 255 typedef __off64_t off64_t;
 256 #  define __off64_t_defined
 257 # endif
 258
 259 # ifndef __useconds_t_defined
 260 typedef __useconds_t useconds_t;
 261 #  define __useconds_t_defined
 262 # endif
 263
 264 # ifndef __pid_t_defined
 265 typedef __pid_t pid_t;
 266 #  define __pid_t_defined
 267 # endif
 268 #endif  /* X/Open */
 269
 270 #if defined __USE_MISC || defined __USE_XOPEN_EXTENDED
 271 # ifndef __intptr_t_defined
 272 typedef __intptr_t intptr_t;
 273 #  define __intptr_t_defined
 274 # endif
 275 #endif
 276
 277 #if defined __USE_BSD || defined __USE_XOPEN
 278 # ifndef __socklen_t_defined
 279 typedef __socklen_t socklen_t;
 280 #  define __socklen_t_defined
 281 # endif
 282 #endif
 283
 284 /* Values for the second argument to access.
 285    These may be OR'd together.  */
 286 #define R_OK    4               /* Test for read permission.  */
 287 #define W_OK    2               /* Test for write permission.  */
 288 #define X_OK    1               /* Test for execute permission.  */
 289 #define F_OK    0               /* Test for existence.  */
 290
 291 /* Test for access to NAME using the real UID and real GID.  */
 292 extern int access (__const char *__name, int __type) __THROW __nonnull ((1));
 293
 294 #if 0 /*def __USE_GNU*/
 295 /* Test for access to NAME using the effective UID and GID
 296    (as normal file operations use).  */
 297 extern int euidaccess (__const char *__name, int __type)
 298      __THROW __nonnull ((1));
 299
 300 /* An alias for `euidaccess', used by some other systems.  */
 301 extern int eaccess (__const char *__name, int __type)
 302      __THROW __nonnull ((1));
 303 #endif
 304
 305 #ifdef __USE_ATFILE
 306 /* Test for access to FILE relative to the directory FD is open on.
 307    If AT_EACCESS is set in FLAG, then use effective IDs like `eaccess',
 308    otherwise use real IDs like `access'.  */
 309 extern int faccessat (int __fd, __const char *__file, int __type, int __flag)
 310      __THROW __nonnull ((2)) __wur;
 311 #endif /* Use GNU.  */
 312
 313
 314 /* Values for the WHENCE argument to lseek.  */
 315 #ifndef _STDIO_H                /* <stdio.h> has the same definitions.  */
 316 # define SEEK_SET       0       /* Seek from beginning of file.  */
 317 # define SEEK_CUR       1       /* Seek from current position.  */
 318 # define SEEK_END       2       /* Seek from end of file.  */
 319 #endif
 320
 321 #if defined __USE_BSD && !defined L_SET
 322 /* Old BSD names for the same constants; just for compatibility.  */
 323 # define L_SET          SEEK_SET
 324 # define L_INCR         SEEK_CUR
 325 # define L_XTND         SEEK_END
 326 #endif
 327
 328
 329 /* Move FD's file position to OFFSET bytes from the
 330    beginning of the file (if WHENCE is SEEK_SET),
 331    the current position (if WHENCE is SEEK_CUR),
 332    or the end of the file (if WHENCE is SEEK_END).
 333    Return the new file position.  */
 334 #ifndef __USE_FILE_OFFSET64
 335 extern __off_t lseek (int __fd, __off_t __offset, int __whence) __THROW;
 336 libc_hidden_proto(lseek)
 337 #else
 338 # ifdef __REDIRECT_NTH
 339 extern __off64_t __REDIRECT_NTH (lseek,
 340                                  (int __fd, __off64_t __offset, int __whence),
 341                                  lseek64);
 342 # else
 343 #  define lseek lseek64
 344 # endif
 345 #endif
 346 #ifdef __USE_LARGEFILE64
 347 extern __off64_t lseek64 (int __fd, __off64_t __offset, int __whence)
 348      __THROW;
 349 libc_hidden_proto(lseek64)
 350 #endif
 351
 352 /* Close the file descriptor FD.
 353
 354    This function is a cancellation point and therefore not marked with
 355    __THROW.  */
 356 extern int close (int __fd);
 357 libc_hidden_proto(close)
 358
 359 /* Read NBYTES into BUF from FD.  Return the
 360    number read, -1 for errors or 0 for EOF.
 361
 362    This function is a cancellation point and therefore not marked with
 363    __THROW.  */
 364 extern ssize_t read (int __fd, void *__buf, size_t __nbytes) __wur;
 365 libc_hidden_proto(read)
 366
 367 /* Write N bytes of BUF to FD.  Return the number written, or -1.
 368
 369    This function is a cancellation point and therefore not marked with
 370    __THROW.  */
 371 extern ssize_t write (int __fd, __const void *__buf, size_t __n) __wur;
 372 libc_hidden_proto(write)
 373
 374 #ifdef __USE_UNIX98
 375 # ifndef __USE_FILE_OFFSET64
 376 /* Read NBYTES into BUF from FD at the given position OFFSET without
 377    changing the file pointer.  Return the number read, -1 for errors
 378    or 0 for EOF.
 379
 380    This function is a cancellation point and therefore not marked with
 381    __THROW.  */
 382 extern ssize_t pread (int __fd, void *__buf, size_t __nbytes,
 383                       __off_t __offset) __wur;
 384
 385 /* Write N bytes of BUF to FD at the given position OFFSET without
 386    changing the file pointer.  Return the number written, or -1.
 387
 388    This function is a cancellation point and therefore not marked with
 389    __THROW.  */
 390 extern ssize_t pwrite (int __fd, __const void *__buf, size_t __n,
 391                        __off_t __offset) __wur;
 392 # else
 393 #  ifdef __REDIRECT
 394 extern ssize_t __REDIRECT (pread, (int __fd, void *__buf, size_t __nbytes,
 395                                    __off64_t __offset),
 396                            pread64) __wur;
 397 extern ssize_t __REDIRECT (pwrite, (int __fd, __const void *__buf,
 398                                     size_t __nbytes, __off64_t __offset),
 399                            pwrite64) __wur;
 400 #  else
 401 #   define pread pread64
 402 #   define pwrite pwrite64
 403 #  endif
 404 # endif
 405
 406 # ifdef __USE_LARGEFILE64
 407 /* Read NBYTES into BUF from FD at the given position OFFSET without
 408    changing the file pointer.  Return the number read, -1 for errors
 409    or 0 for EOF.  */
 410 extern ssize_t pread64 (int __fd, void *__buf, size_t __nbytes,
 411                         __off64_t __offset) __wur;
 412 /* Write N bytes of BUF to FD at the given position OFFSET without
 413    changing the file pointer.  Return the number written, or -1.  */
 414 extern ssize_t pwrite64 (int __fd, __const void *__buf, size_t __n,
 415                          __off64_t __offset) __wur;
 416 # endif
 417 #endif
 418
 419 /* Create a one-way communication channel (pipe).
 420    If successful, two file descriptors are stored in PIPEDES;
 421    bytes written on PIPEDES[1] can be read from PIPEDES[0].
 422    Returns 0 if successful, -1 if not.  */
 423 extern int pipe (int __pipedes[2]) __THROW __wur;
 424 libc_hidden_proto(pipe)
 425
 426 #if defined __UCLIBC_LINUX_SPECIFIC__ && defined __USE_GNU
 427 /* Same as pipe but apply flags passed in FLAGS to the new file
 428    descriptors.  */
 429 extern int pipe2 (int __pipedes[2], int __flags) __THROW __wur;
 430 libc_hidden_proto(pipe2)
 431 #endif
 432
 433 /* Schedule an alarm.  In SECONDS seconds, the process will get a SIGALRM.
 434    If SECONDS is zero, any currently scheduled alarm will be cancelled.
 435    The function returns the number of seconds remaining until the last
 436    alarm scheduled would have signaled, or zero if there wasn't one.
 437    There is no return value to indicate an error, but you can set `errno'
 438    to 0 and check its value after calling `alarm', and this might tell you.
 439    The signal may come late due to processor scheduling.  */
 440 extern unsigned int alarm (unsigned int __seconds) __THROW;
 441 libc_hidden_proto(alarm)
 442
 443 /* Make the process sleep for SECONDS seconds, or until a signal arrives
 444    and is not ignored.  The function returns the number of seconds less
 445    than SECONDS which it actually slept (thus zero if it slept the full time).
 446    If a signal handler does a `longjmp' or modifies the handling of the
 447    SIGALRM signal while inside `sleep' call, the handling of the SIGALRM
 448    signal afterwards is undefined.  There is no return value to indicate
 449    error, but if `sleep' returns SECONDS, it probably didn't work.
 450
 451    This function is a cancellation point and therefore not marked with
 452    __THROW.  */
 453 extern unsigned int sleep (unsigned int __seconds);
 454 libc_hidden_proto(sleep)
 455
 456 #if (defined __USE_BSD || defined __USE_XOPEN_EXTENDED) \
 457         && defined __UCLIBC_SUSV3_LEGACY__
 458 /* Set an alarm to go off (generating a SIGALRM signal) in VALUE
 459    microseconds.  If INTERVAL is nonzero, when the alarm goes off, the
 460    timer is reset to go off every INTERVAL microseconds thereafter.
 461    Returns the number of microseconds remaining before the alarm.  */
 462 extern __useconds_t ualarm (__useconds_t __value, __useconds_t __interval)
 463      __THROW;
 464
 465 /* Sleep USECONDS microseconds, or until a signal arrives that is not blocked
 466    or ignored.
 467
 468    This function is a cancellation point and therefore not marked with
 469    __THROW.  */
 470 extern int usleep (__useconds_t __useconds);
 471 #endif
 472
 473
 474 /* Suspend the process until a signal arrives.
 475    This always returns -1 and sets `errno' to EINTR.
 476
 477    This function is a cancellation point and therefore not marked with
 478    __THROW.  */
 479 extern int pause (void);
 480
 481
 482 /* Change the owner and group of FILE.  */
 483 extern int chown (__const char *__file, __uid_t __owner, __gid_t __group)
 484      __THROW __nonnull ((1)) __wur;
 485 libc_hidden_proto(chown)
 486
 487 #if defined __USE_BSD || defined __USE_XOPEN_EXTENDED
 488 /* Change the owner and group of the file that FD is open on.  */
 489 extern int fchown (int __fd, __uid_t __owner, __gid_t __group) __THROW __wur;
 490
 491
 492 /* Change owner and group of FILE, if it is a symbolic
 493    link the ownership of the symbolic link is changed.  */
 494 extern int lchown (__const char *__file, __uid_t __owner, __gid_t __group)
 495      __THROW __nonnull ((1)) __wur;
 496
 497 #endif /* Use BSD || X/Open Unix.  */
 498
 499 #ifdef __USE_ATFILE
 500 /* Change the owner and group of FILE relative to the directory FD is open
 501    on.  */
 502 extern int fchownat (int __fd, __const char *__file, __uid_t __owner,
 503                      __gid_t __group, int __flag)
 504      __THROW __nonnull ((2)) __wur;
 505 #endif /* Use GNU.  */
 506
 507 /* Change the process's working directory to PATH.  */
 508 extern int chdir (__const char *__path) __THROW __nonnull ((1)) __wur;
 509 libc_hidden_proto(chdir)
 510
 511 #if defined __USE_BSD || defined __USE_XOPEN_EXTENDED
 512 /* Change the process's working directory to the one FD is open on.  */
 513 extern int fchdir (int __fd) __THROW __wur;
 514 libc_hidden_proto(fchdir)
 515 #endif
 516
 517 /* Get the pathname of the current working directory,
 518    and put it in SIZE bytes of BUF.  Returns NULL if the
 519    directory couldn't be determined or SIZE was too small.
 520    If successful, returns BUF.  In GNU, if BUF is NULL,
 521    an array is allocated with `malloc'; the array is SIZE
 522    bytes long, unless SIZE == 0, in which case it is as
 523    big as necessary.  */
 524 extern char *getcwd (char *__buf, size_t __size) __THROW __wur;
 525 libc_hidden_proto(getcwd)
 526
 527 #ifdef  __USE_GNU
 528 /* Return a malloc'd string containing the current directory name.
 529    If the environment variable `PWD' is set, and its value is correct,
 530    that value is used.  */
 531 extern char *get_current_dir_name (void) __THROW;
 532 #endif
 533
 534 #if 0 /*defined __USE_BSD || defined __USE_XOPEN_EXTENDED*/
 535 /* Put the absolute pathname of the current working directory in BUF.
 536    If successful, return BUF.  If not, put an error message in
 537    BUF and return NULL.  BUF should be at least PATH_MAX bytes long.  */
 538 extern char *getwd (char *__buf)
 539      __THROW __nonnull ((1)) __attribute_deprecated__ __wur;
 540 #endif
 541
 542
 543 /* Duplicate FD, returning a new file descriptor on the same file.  */
 544 extern int dup (int __fd) __THROW __wur;
 545
 546 /* Duplicate FD to FD2, closing FD2 and making it open on the same file.  */
 547 extern int dup2 (int __fd, int __fd2) __THROW;
 548 libc_hidden_proto(dup2)
 549
 550 /* NULL-terminated array of "NAME=VALUE" environment variables.  */
 551 extern char **__environ;
 552 #ifdef __USE_GNU
 553 extern char **environ;
 554 #endif
 555
 556
 557 /* Replace the current process, executing PATH with arguments ARGV and
 558    environment ENVP.  ARGV and ENVP are terminated by NULL pointers.  */
 559 extern int execve (__const char *__path, char *__const __argv[],
 560                    char *__const __envp[]) __THROW __nonnull ((1));
 561 libc_hidden_proto(execve)
 562
 563 #if 0 /*def __USE_XOPEN2K8*/
 564 /* Execute the file FD refers to, overlaying the running program image.
 565    ARGV and ENVP are passed to the new program, as for `execve'.  */
 566 extern int fexecve (int __fd, char *__const __argv[], char *__const __envp[])
 567      __THROW;
 568 #endif
 569
 570
 571 /* Execute PATH with arguments ARGV and environment from `environ'.  */
 572 extern int execv (__const char *__path, char *__const __argv[])
 573      __THROW __nonnull ((1));
 574 libc_hidden_proto(execv)
 575
 576 /* Execute PATH with all arguments after PATH until a NULL pointer,
 577    and the argument after that for environment.  */
 578 extern int execle (__const char *__path, __const char *__arg, ...)
 579      __THROW __nonnull ((1));
 580 libc_hidden_proto(execle)
 581
 582 /* Execute PATH with all arguments after PATH until
 583    a NULL pointer and environment from `environ'.  */
 584 extern int execl (__const char *__path, __const char *__arg, ...)
 585      __THROW __nonnull ((1));
 586 libc_hidden_proto(execl)
 587
 588 /* Execute FILE, searching in the `PATH' environment variable if it contains
 589    no slashes, with arguments ARGV and environment from `environ'.  */
 590 extern int execvp (__const char *__file, char *__const __argv[])
 591      __THROW __nonnull ((1));
 592 libc_hidden_proto(execvp)
 593
 594 /* Execute FILE, searching in the `PATH' environment variable if
 595    it contains no slashes, with all arguments after FILE until a
 596    NULL pointer and environment from `environ'.  */
 597 extern int execlp (__const char *__file, __const char *__arg, ...)
 598      __THROW __nonnull ((1));
 599 libc_hidden_proto(execlp)
 600
 601
 602 #if defined __USE_MISC || defined __USE_XOPEN
 603 /* Add INC to priority of the current process.  */
 604 extern int nice (int __inc) __THROW __wur;
 605 #endif
 606
 607
 608 /* Terminate program execution with the low-order 8 bits of STATUS.  */
 609 extern void _exit (int __status) __attribute__ ((__noreturn__));
 610 libc_hidden_proto(_exit)
 611
 612
 613 /* Get the `_PC_*' symbols for the NAME argument to `pathconf' and `fpathconf';
 614    the `_SC_*' symbols for the NAME argument to `sysconf';
 615    and the `_CS_*' symbols for the NAME argument to `confstr'.  */
 616 #include <bits/confname.h>
 617
 618 /* Get file-specific configuration information about PATH.  */
 619 extern long int pathconf (__const char *__path, int __name)
 620      __THROW __nonnull ((1));
 621
 622 /* Get file-specific configuration about descriptor FD.  */
 623 extern long int fpathconf (int __fd, int __name) __THROW;
 624
 625 /* Get the value of the system variable NAME.  */
 626 extern long int sysconf (int __name) __THROW;
 627 libc_hidden_proto(sysconf)
 628
 629 #ifdef  __USE_POSIX2
 630 /* Get the value of the string-valued system variable NAME.  */
 631 extern size_t confstr (int __name, char *__buf, size_t __len) __THROW;
 632 #endif
 633
 634
 635 /* Get the process ID of the calling process.  */
 636 extern __pid_t getpid (void) __THROW;
 637 libc_hidden_proto(getpid)
 638
 639 /* Get the process ID of the calling process's parent.  */
 640 extern __pid_t getppid (void) __THROW;
 641
 642 /* Get the process group ID of the calling process.
 643    This function is different on old BSD. */
 644 #ifndef __FAVOR_BSD
 645 extern __pid_t getpgrp (void) __THROW;
 646 #else
 647 # ifdef __REDIRECT_NTH
 648 extern __pid_t __REDIRECT_NTH (getpgrp, (__pid_t __pid), __getpgid);
 649 # else
 650 #  define getpgrp __getpgid
 651 # endif
 652 #endif
 653
 654 /* Get the process group ID of process PID.  */
 655 extern __pid_t __getpgid (__pid_t __pid) __THROW;
 656 #ifdef __USE_XOPEN_EXTENDED
 657 extern __pid_t getpgid (__pid_t __pid) __THROW;
 658 #endif
 659
 660
 661 /* Set the process group ID of the process matching PID to PGID.
 662    If PID is zero, the current process's process group ID is set.
 663    If PGID is zero, the process ID of the process is used.  */
 664 extern int setpgid (__pid_t __pid, __pid_t __pgid) __THROW;
 665 libc_hidden_proto(setpgid)
 666
 667 #if defined __USE_SVID || defined __USE_BSD || defined __USE_XOPEN_EXTENDED
 668 /* Both System V and BSD have `setpgrp' functions, but with different
 669    calling conventions.  The BSD function is the same as POSIX.1 `setpgid'
 670    (above).  The System V function takes no arguments and puts the calling
 671    process in its on group like `setpgid (0, 0)'.
 672
 673    New programs should always use `setpgid' instead.
 674
 675    The default in GNU is to provide the System V function.  The BSD
 676    function is available under -D_BSD_SOURCE.  */
 677
 678 # ifndef __FAVOR_BSD
 679
 680 /* Set the process group ID of the calling process to its own PID.
 681    This is exactly the same as `setpgid (0, 0)'.  */
 682 extern int setpgrp (void) __THROW;
 683
 684 # else
 685
 686 /* Another name for `setpgid' (above).  */
 687 #  ifdef __REDIRECT_NTH
 688 extern int __REDIRECT_NTH (setpgrp, (__pid_t __pid, __pid_t __pgrp), setpgid);
 689 #  else
 690 #   define setpgrp setpgid
 691 #  endif
 692
 693 # endif /* Favor BSD.  */
 694 #endif  /* Use SVID or BSD.  */
 695
 696 /* Create a new session with the calling process as its leader.
 697    The process group IDs of the session and the calling process
 698    are set to the process ID of the calling process, which is returned.  */
 699 extern __pid_t setsid (void) __THROW;
 700 libc_hidden_proto(setsid)
 701
 702 #ifdef __USE_XOPEN_EXTENDED
 703 /* Return the session ID of the given process.  */
 704 extern __pid_t getsid (__pid_t __pid) __THROW;
 705 libc_hidden_proto(getsid)
 706 #endif
 707
 708 /* Get the real user ID of the calling process.  */
 709 extern __uid_t getuid (void) __THROW;
 710 libc_hidden_proto(getuid)
 711
 712 /* Get the effective user ID of the calling process.  */
 713 extern __uid_t geteuid (void) __THROW;
 714 libc_hidden_proto(geteuid)
 715
 716 /* Get the real group ID of the calling process.  */
 717 extern __gid_t getgid (void) __THROW;
 718 libc_hidden_proto(getgid)
 719
 720 /* Get the effective group ID of the calling process.  */
 721 extern __gid_t getegid (void) __THROW;
 722 libc_hidden_proto(getegid)
 723
 724 /* If SIZE is zero, return the number of supplementary groups
 725    the calling process is in.  Otherwise, fill in the group IDs
 726    of its supplementary groups in LIST and return the number written.  */
 727 extern int getgroups (int __size, __gid_t __list[]) __THROW __wur;
 728 libc_hidden_proto(getgroups)
 729
 730 #if 0 /*def     __USE_GNU*/
 731 /* Return nonzero iff the calling process is in group GID.  */
 732 extern int group_member (__gid_t __gid) __THROW;
 733 #endif
 734
 735 /* Set the user ID of the calling process to UID.
 736    If the calling process is the super-user, set the real
 737    and effective user IDs, and the saved set-user-ID to UID;
 738    if not, the effective user ID is set to UID.  */
 739 extern int setuid (__uid_t __uid) __THROW;
 740
 741 #if defined __USE_BSD || defined __USE_XOPEN_EXTENDED
 742 /* Set the real user ID of the calling process to RUID,
 743    and the effective user ID of the calling process to EUID.  */
 744 extern int setreuid (__uid_t __ruid, __uid_t __euid) __THROW;
 745 libc_hidden_proto(setreuid)
 746 #endif
 747
 748 #if defined __USE_BSD || defined __USE_XOPEN2K
 749 /* Set the effective user ID of the calling process to UID.  */
 750 extern int seteuid (__uid_t __uid) __THROW;
 751 libc_hidden_proto(seteuid)
 752 #endif /* Use BSD.  */
 753
 754 /* Set the group ID of the calling process to GID.
 755    If the calling process is the super-user, set the real
 756    and effective group IDs, and the saved set-group-ID to GID;
 757    if not, the effective group ID is set to GID.  */
 758 extern int setgid (__gid_t __gid) __THROW;
 759
 760 #if defined __USE_BSD || defined __USE_XOPEN_EXTENDED
 761 /* Set the real group ID of the calling process to RGID,
 762    and the effective group ID of the calling process to EGID.  */
 763 extern int setregid (__gid_t __rgid, __gid_t __egid) __THROW;
 764 libc_hidden_proto(setregid)
 765 #endif
 766
 767 #if defined __USE_BSD || defined __USE_XOPEN2K
 768 /* Set the effective group ID of the calling process to GID.  */
 769 extern int setegid (__gid_t __gid) __THROW;
 770 #endif /* Use BSD.  */
 771
 772 #ifdef __USE_GNU
 773 /* Fetch the real user ID, effective user ID, and saved-set user ID,
 774    of the calling process.  */
 775 extern int getresuid (__uid_t *__ruid, __uid_t *__euid, __uid_t *__suid)
 776      __THROW;
 777
 778 /* Fetch the real group ID, effective group ID, and saved-set group ID,
 779    of the calling process.  */
 780 extern int getresgid (__gid_t *__rgid, __gid_t *__egid, __gid_t *__sgid)
 781      __THROW;
 782
 783 #if defined __UCLIBC_LINUX_SPECIFIC__
 784 /* Set the real user ID, effective user ID, and saved-set user ID,
 785    of the calling process to RUID, EUID, and SUID, respectively.  */
 786 extern int setresuid (__uid_t __ruid, __uid_t __euid, __uid_t __suid)
 787      __THROW;
 788 libc_hidden_proto(setresuid)
 789 #endif
 790
 791 /* Set the real group ID, effective group ID, and saved-set group ID,
 792    of the calling process to RGID, EGID, and SGID, respectively.  */
 793 extern int setresgid (__gid_t __rgid, __gid_t __egid, __gid_t __sgid)
 794      __THROW;
 795 libc_hidden_proto(setresgid)
 796 #endif
 797
 798
 799 #if defined __UCLIBC_HAS_STUBS__ || defined __ARCH_USE_MMU__
 800 /* Clone the calling process, creating an exact copy.
 801    Return -1 for errors, 0 to the new process,
 802    and the process ID of the new process to the old process.  */
 803 extern __pid_t fork (void) __THROW;
 804 # ifdef _LIBC
 805 extern __typeof(fork) __libc_fork;
 806 libc_hidden_proto(fork)
 807 # endif
 808 #endif
 809
 810 #if defined __USE_BSD || defined __USE_XOPEN_EXTENDED
 811 /* Clone the calling process, but without copying the whole address space.
 812    The calling process is suspended until the new process exits or is
 813    replaced by a call to `execve'.  Return -1 for errors, 0 to the new process,
 814    and the process ID of the new process to the old process.  */
 815 extern __pid_t vfork (void) __THROW;
 816 libc_hidden_proto(vfork)
 817 #endif /* Use BSD. */
 818
 819 #if 0 /* psm: seems unused , exit-thread.S is not compiled */
 820 /* Special exit function which only terminates the current thread.  */
 821 extern void __exit_thread (int val) __attribute__ ((__noreturn__));
 822 #endif
 823
 824 /* Return the pathname of the terminal FD is open on, or NULL on errors.
 825    The returned storage is good only until the next call to this function.  */
 826 extern char *ttyname (int __fd) __THROW;
 827
 828 /* Store at most BUFLEN characters of the pathname of the terminal FD is
 829    open on in BUF.  Return 0 on success, otherwise an error number.  */
 830 extern int ttyname_r (int __fd, char *__buf, size_t __buflen)
 831      __THROW __nonnull ((2)) __wur;
 832 libc_hidden_proto(ttyname_r)
 833
 834 /* Return 1 if FD is a valid descriptor associated
 835    with a terminal, zero if not.  */
 836 extern int isatty (int __fd) __THROW;
 837 libc_hidden_proto(isatty)
 838
 839 #if 0 /*defined __USE_BSD \
 840     || (defined __USE_XOPEN_EXTENDED && !defined __USE_UNIX98)*/
 841 /* Return the index into the active-logins file (utmp) for
 842    the controlling terminal.  */
 843 extern int ttyslot (void) __THROW;
 844 #endif
 845
 846
 847 /* Make a link to FROM named TO.  */
 848 extern int link (__const char *__from, __const char *__to)
 849      __THROW __nonnull ((1, 2)) __wur;
 850
 851 #ifdef __USE_ATFILE
 852 /* Like link but relative paths in TO and FROM are interpreted relative
 853    to FROMFD and TOFD respectively.  */
 854 extern int linkat (int __fromfd, __const char *__from, int __tofd,
 855                    __const char *__to, int __flags)
 856      __THROW __nonnull ((2, 4)) __wur;
 857 #endif
 858
 859 #if defined __USE_BSD || defined __USE_XOPEN_EXTENDED || defined __USE_XOPEN2K
 860 /* Make a symbolic link to FROM named TO.  */
 861 extern int symlink (__const char *__from, __const char *__to)
 862      __THROW __nonnull ((1, 2)) __wur;
 863
 864 /* Read the contents of the symbolic link PATH into no more than
 865    LEN bytes of BUF.  The contents are not null-terminated.
 866    Returns the number of characters read, or -1 for errors.  */
 867 extern ssize_t readlink (__const char *__restrict __path,
 868                          char *__restrict __buf, size_t __len)
 869      __THROW __nonnull ((1, 2)) __wur;
 870 libc_hidden_proto(readlink)
 871 #endif /* Use BSD.  */
 872
 873 #ifdef __USE_ATFILE
 874 /* Like symlink but a relative path in TO is interpreted relative to TOFD.  */
 875 extern int symlinkat (__const char *__from, int __tofd,
 876                       __const char *__to) __THROW __nonnull ((1, 3)) __wur;
 877
 878 /* Like readlink but a relative PATH is interpreted relative to FD.  */
 879 extern ssize_t readlinkat (int __fd, __const char *__restrict __path,
 880                            char *__restrict __buf, size_t __len)
 881      __THROW __nonnull ((2, 3)) __wur;
 882 #endif
 883
 884 /* Remove the link NAME.  */
 885 extern int unlink (__const char *__name) __THROW __nonnull ((1));
 886 libc_hidden_proto(unlink)
 887
 888 #ifdef __USE_ATFILE
 889 /* Remove the link NAME relative to FD.  */
 890 extern int unlinkat (int __fd, __const char *__name, int __flag)
 891      __THROW __nonnull ((2));
 892 #endif
 893
 894 /* Remove the directory PATH.  */
 895 extern int rmdir (__const char *__path) __THROW __nonnull ((1));
 896 libc_hidden_proto(rmdir)
 897
 898
 899 /* Return the foreground process group ID of FD.  */
 900 extern __pid_t tcgetpgrp (int __fd) __THROW;
 901 libc_hidden_proto(tcgetpgrp)
 902
 903 /* Set the foreground process group ID of FD set PGRP_ID.  */
 904 extern int tcsetpgrp (int __fd, __pid_t __pgrp_id) __THROW;
 905
 906
 907 /* Return the login name of the user.
 908
 909    This function is a possible cancellation points and therefore not
 910    marked with __THROW.  */
 911 extern char *getlogin (void);
 912 libc_hidden_proto(getlogin)
 913 #if defined __USE_REENTRANT || defined __USE_POSIX199506
 914 /* Return at most NAME_LEN characters of the login name of the user in NAME.
 915    If it cannot be determined or some other error occurred, return the error
 916    code.  Otherwise return 0.
 917
 918    This function is a possible cancellation points and therefore not
 919    marked with __THROW.  */
 920 extern int getlogin_r (char *__name, size_t __name_len) __nonnull ((1));
 921 #endif
 922
 923 #if 0 /*def     __USE_BSD*/
 924 /* Set the login name returned by `getlogin'.  */
 925 extern int setlogin (__const char *__name) __THROW __nonnull ((1));
 926 #endif
 927
 928
 929 #ifdef  __USE_POSIX2
 930 /* Get definitions and prototypes for functions to process the
 931    arguments in ARGV (ARGC of them, minus the program name) for
 932    options given in OPTS.  */
 933 # define __need_getopt
 934 /* keep this for uClibc in bits/, we need it when GNU_GETOPT is disabled */
 935 # include <bits/getopt.h>
 936 #endif
 937
 938
 939 #if defined __USE_BSD || defined __USE_UNIX98
 940 /* Put the name of the current host in no more than LEN bytes of NAME.
 941    The result is null-terminated if LEN is large enough for the full
 942    name and the terminator.  */
 943 extern int gethostname (char *__name, size_t __len) __THROW __nonnull ((1));
 944 libc_hidden_proto(gethostname)
 945 #endif
 946
 947
 948 #if defined __USE_BSD || (defined __USE_XOPEN && !defined __USE_UNIX98)
 949 /* Set the name of the current host to NAME, which is LEN bytes long.
 950    This call is restricted to the super-user.  */
 951 extern int sethostname (__const char *__name, size_t __len)
 952      __THROW __nonnull ((1)) __wur;
 953
 954 /* Set the current machine's Internet number to ID.
 955    This call is restricted to the super-user.  */
 956 extern int sethostid (long int __id) __THROW __wur;
 957
 958
 959 #if defined __UCLIBC_BSD_SPECIFIC__ || defined _LIBC
 960 /* Get and set the NIS (aka YP) domain name, if any.
 961    Called just like `gethostname' and `sethostname'.
 962    The NIS domain name is usually the empty string when not using NIS.  */
 963 extern int getdomainname (char *__name, size_t __len)
 964      __THROW __nonnull ((1)) __wur;
 965 libc_hidden_proto(getdomainname)
 966 #endif
 967 #if defined __UCLIBC_BSD_SPECIFIC__
 968 extern int setdomainname (__const char *__name, size_t __len)
 969      __THROW __nonnull ((1)) __wur;
 970 #endif
 971
 972
 973 #if defined __UCLIBC_LINUX_SPECIFIC__
 974 /* Revoke access permissions to all processes currently communicating
 975    with the control terminal, and then send a SIGHUP signal to the process
 976    group of the control terminal.  */
 977 extern int vhangup (void) __THROW;
 978 #endif
 979
 980 #if 0
 981 /* Revoke the access of all descriptors currently open on FILE.  */
 982 extern int revoke (__const char *__file) __THROW __nonnull ((1)) __wur;
 983
 984
 985 /* Enable statistical profiling, writing samples of the PC into at most
 986    SIZE bytes of SAMPLE_BUFFER; every processor clock tick while profiling
 987    is enabled, the system examines the user PC and increments
 988    SAMPLE_BUFFER[((PC - OFFSET) / 2) * SCALE / 65536].  If SCALE is zero,
 989    disable profiling.  Returns zero on success, -1 on error.  */
 990 extern int profil (unsigned short int *__sample_buffer, size_t __size,
 991                    size_t __offset, unsigned int __scale)
 992      __THROW __nonnull ((1));
 993 #endif
 994
 995
 996 /* Turn accounting on if NAME is an existing file.  The system will then write
 997    a record for each process as it terminates, to this file.  If NAME is NULL,
 998    turn accounting off.  This call is restricted to the super-user.  */
 999 extern int acct (__const char *__name) __THROW;
1000
1001
1002 /* Successive calls return the shells listed in `/etc/shells'.  */
1003 extern char *getusershell (void) __THROW;
1004 extern void endusershell (void) __THROW; /* Discard cached info.  */
1005 libc_hidden_proto(endusershell)
1006 extern void setusershell (void) __THROW; /* Rewind and re-read the file.  */
1007 libc_hidden_proto(setusershell)
1008
1009
1010 /* Put the program in the background, and dissociate from the controlling
1011    terminal.  If NOCHDIR is zero, do `chdir ("/")'.  If NOCLOSE is zero,
1012    redirects stdin, stdout, and stderr to /dev/null.  */
1013 extern int daemon (int __nochdir, int __noclose) __THROW __wur;
1014 #endif /* Use BSD || X/Open.  */
1015
1016
1017 #if defined __USE_BSD || (defined __USE_XOPEN && !defined __USE_XOPEN2K)
1018 /* Make PATH be the root directory (the starting point for absolute paths).
1019    This call is restricted to the super-user.  */
1020 extern int chroot (__const char *__path) __THROW __nonnull ((1)) __wur;
1021
1022 /* Prompt with PROMPT and read a string from the terminal without echoing.
1023    Uses /dev/tty if possible; otherwise stderr and stdin.  */
1024 extern char *getpass (__const char *__prompt) __nonnull ((1));
1025 #endif /* Use BSD || X/Open.  */
1026
1027
1028 #if defined __USE_BSD || defined __USE_XOPEN || defined __USE_XOPEN2K
1029 /* Make all changes done to FD actually appear on disk.
1030
1031    This function is a cancellation point and therefore not marked with
1032    __THROW.  */
1033 extern int fsync (int __fd);
1034 #endif /* Use BSD || X/Open || Unix98.  */
1035
1036
1037 #if defined __USE_BSD || defined __USE_XOPEN_EXTENDED
1038
1039 /* Return identifier for the current host.  */
1040 extern long int gethostid (void);
1041
1042 /* Make all changes done to all files actually appear on disk.  */
1043 extern void sync (void) __THROW;
1044
1045
1046 /* Return the number of bytes in a page.  This is the system's page size,
1047    which is not necessarily the same as the hardware page size.  */
1048 extern int getpagesize (void)  __THROW __attribute__ ((__const__));
1049 libc_hidden_proto(getpagesize)
1050
1051
1052 /* Return the maximum number of file descriptors
1053    the current process could possibly have.  */
1054 extern int getdtablesize (void) __THROW;
1055 libc_hidden_proto(getdtablesize)
1056
1057
1058 /* Truncate FILE to LENGTH bytes.  */
1059 # ifndef __USE_FILE_OFFSET64
1060 extern int truncate (__const char *__file, __off_t __length)
1061      __THROW __nonnull ((1)) __wur;
1062 libc_hidden_proto(truncate)
1063 # else
1064 #  ifdef __REDIRECT_NTH
1065 extern int __REDIRECT_NTH (truncate,
1066                            (__const char *__file, __off64_t __length),
1067                            truncate64) __nonnull ((1)) __wur;
1068 #  else
1069 #   define truncate truncate64
1070 #  endif
1071 # endif
1072 # ifdef __USE_LARGEFILE64
1073 extern int truncate64 (__const char *__file, __off64_t __length)
1074      __THROW __nonnull ((1)) __wur;
1075 # endif
1076
1077 #endif /* Use BSD || X/Open Unix.  */
1078
1079 #if defined __USE_BSD || defined __USE_XOPEN_EXTENDED || defined __USE_XOPEN2K
1080
1081 /* Truncate the file FD is open on to LENGTH bytes.  */
1082 # ifndef __USE_FILE_OFFSET64
1083 extern int ftruncate (int __fd, __off_t __length) __THROW __wur;
1084 libc_hidden_proto(ftruncate)
1085 # else
1086 #  ifdef __REDIRECT_NTH
1087 extern int __REDIRECT_NTH (ftruncate, (int __fd, __off64_t __length),
1088                            ftruncate64) __wur;
1089 #  else
1090 #   define ftruncate ftruncate64
1091 #  endif
1092 # endif
1093 # ifdef __USE_LARGEFILE64
1094 extern int ftruncate64 (int __fd, __off64_t __length) __THROW __wur;
1095 libc_hidden_proto(ftruncate64)
1096 # endif
1097
1098 #endif /* Use BSD || X/Open Unix || POSIX 2003.  */
1099
1100
1101 #if defined __USE_MISC || defined __USE_XOPEN_EXTENDED
1102
1103 /* Set the end of accessible data space (aka "the break") to ADDR.
1104    Returns zero on success and -1 for errors (with errno set).  */
1105 extern int brk (void *__addr) __THROW __wur;
1106 libc_hidden_proto(brk)
1107
1108 /* Increase or decrease the end of accessible data space by DELTA bytes.
1109    If successful, returns the address the previous end of data space
1110    (i.e. the beginning of the new space, if DELTA > 0);
1111    returns (void *) -1 for errors (with errno set).  */
1112 extern void *sbrk (intptr_t __delta) __THROW;
1113 libc_hidden_proto(sbrk)
1114 #endif
1115
1116
1117 #ifdef __USE_MISC
1118 /* Invoke `system call' number SYSNO, passing it the remaining arguments.
1119    This is completely system-dependent, and not often useful.
1120
1121    In Unix, `syscall' sets `errno' for all errors and most calls return -1
1122    for errors; in many systems you cannot pass arguments or get return
1123    values for all system calls (`pipe', `fork', and `getppid' typically
1124    among them).
1125
1126    In Mach, all system calls take normal arguments and always return an
1127    error code (zero for success).  */
1128 extern long int syscall (long int __sysno, ...) __THROW;
1129
1130 #endif  /* Use misc.  */
1131
1132
1133 #if (defined __USE_MISC || defined __USE_XOPEN_EXTENDED) && !defined F_LOCK
1134 /* NOTE: These declarations also appear in <fcntl.h>; be sure to keep both
1135    files consistent.  Some systems have them there and some here, and some
1136    software depends on the macros being defined without including both.  */
1137
1138 /* `lockf' is a simpler interface to the locking facilities of `fcntl'.
1139    LEN is always relative to the current file position.
1140    The CMD argument is one of the following.
1141
1142    This function is a cancellation point and therefore not marked with
1143    __THROW.  */
1144
1145 # define F_ULOCK 0      /* Unlock a previously locked region.  */
1146 # define F_LOCK  1      /* Lock a region for exclusive use.  */
1147 # define F_TLOCK 2      /* Test and lock a region for exclusive use.  */
1148 # define F_TEST  3      /* Test a region for other processes locks.  */
1149
1150 # ifndef __USE_FILE_OFFSET64
1151 extern int lockf (int __fd, int __cmd, __off_t __len) __wur;
1152 libc_hidden_proto(lockf)
1153 # else
1154 #  ifdef __REDIRECT
1155 extern int __REDIRECT (lockf, (int __fd, int __cmd, __off64_t __len),
1156                        lockf64) __wur;
1157 #  else
1158 #   define lockf lockf64
1159 #  endif
1160 # endif
1161 # ifdef __USE_LARGEFILE64
1162 extern int lockf64 (int __fd, int __cmd, __off64_t __len) __wur;
1163 # endif
1164 #endif /* Use misc and F_LOCK not already defined.  */
1165
1166
1167 #ifdef __USE_GNU
1168
1169 /* Evaluate EXPRESSION, and repeat as long as it returns -1 with `errno'
1170    set to EINTR.  */
1171
1172 # define TEMP_FAILURE_RETRY(expression) \
1173   (__extension__                                                              \
1174     ({ long int __result;                                                     \
1175        do __result = (long int) (expression);                                 \
1176        while (__result == -1L && errno == EINTR);                             \
1177        __result; }))
1178 #endif
1179
1180 #if (defined __USE_POSIX199309 || defined __USE_UNIX98) \
1181         && defined __UCLIBC_HAS_REALTIME__
1182 /* Synchronize at least the data part of a file with the underlying
1183    media.  */
1184 extern int fdatasync (int __fildes);
1185 #endif /* Use POSIX199309 */
1186
1187
1188 /* XPG4.2 specifies that prototypes for the encryption functions must
1189    be defined here.  */
1190 #ifdef  __USE_XOPEN
1191 # if defined __UCLIBC_HAS_CRYPT__
1192 /* Encrypt at most 8 characters from KEY using salt to perturb DES.  */
1193 extern char *crypt (__const char *__key, __const char *__salt)
1194      __THROW __nonnull ((1, 2));
1195
1196 /* Encrypt data in BLOCK in place if EDFLAG is zero; otherwise decrypt
1197    block in place.  */
1198 extern void encrypt (char *__block, int __edflag) __THROW __nonnull ((1));
1199 # endif /* __UCLIBC_HAS_CRYPT__ */
1200
1201
1202 /* Swab pairs bytes in the first N bytes of the area pointed to by
1203    FROM and copy the result to TO.  The value of TO must not be in the
1204    range [FROM - N + 1, FROM - 1].  If N is odd the first byte in FROM
1205    is without partner.  */
1206 extern void swab (__const void *__restrict __from, void *__restrict __to,
1207                   ssize_t __n) __THROW __nonnull ((1, 2));
1208 #endif
1209
1210
1211 /* The Single Unix specification demands this prototype to be here.
1212    It is also found in <stdio.h>.  */
1213 #ifdef __USE_XOPEN
1214 /* Return the name of the controlling terminal.  */
1215 extern char *ctermid (char *__s) __THROW;
1216 #endif
1217
1218
1219 /* Define some macros helping to catch buffer overflows.  */
1220 #if __USE_FORTIFY_LEVEL > 0 && defined __extern_always_inline
1221 # include <bits/unistd.h>
1222 #endif
1223
1224 __END_DECLS
1225
1226
1227 #ifdef _LIBC
1228 #ifndef smallint_type /* if arch didn't override it in bits/wordsize.h */
1229 #define smallint_type int
1230 #endif
1231 typedef signed smallint_type smallint;
1232 typedef unsigned smallint_type smalluint;
1233 extern size_t __pagesize attribute_hidden;
1234 #endif
1235
1236
1237 #endif /* unistd.h  */