Formerly ../stdio/vfprintf.c.~8~
[kopensolaris-gnu/glibc.git] / posix / unistd.h
1 /* Copyright (C) 1991, 1992 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 Library General Public License as
6 published by the Free Software Foundation; either version 2 of the
7 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 Library General Public License for more details.
13
14 You should have received a copy of the GNU Library General Public
15 License along with the GNU C Library; see the file COPYING.LIB.  If
16 not, write to the Free Software Foundation, Inc., 675 Mass Ave,
17 Cambridge, MA 02139, USA.  */
18
19 /*
20  *      POSIX Standard: 2.10 Symbolic Constants         <unistd.h>
21  */
22
23 #ifndef _UNISTD_H
24
25 #define _UNISTD_H       1
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 /* POSIX Standard approved as IEEE Std 1003.1 as of August, 1988.  */
34 #define _POSIX_VERSION  199009L
35
36 /* These are not #ifdef __USE_POSIX2 because they are
37    in the theoretically application-owned namespace.  */
38
39 #define _POSIX2_C_VERSION       199912L /* Invalid until 1003.2 is done.  */
40
41 /* If defined, the implementation supports the
42    C Language Bindings Option.  */
43 #define _POSIX2_C_BIND  1
44
45 /* If defined, the implementation supports the
46    C Language Development Utilities Option.  */
47 #define _POSIX2_C_DEV   1
48
49 /* If defined, the implementation supports the
50    Software Development Utilities Option.  */
51 #define _POSIX2_SW_DEV  1
52
53
54 /* Get values of POSIX options:
55
56    If these symbols are defined, the corresponding features are
57    always available.  If not, they may be available sometimes.
58    The current values can be obtained with `sysconf'.
59
60    _POSIX_JOB_CONTROL   Job control is supported.
61    _POSIX_SAVED_IDS     Processes have a saved set-user-ID
62                         and a saved set-group-ID.
63
64    If any of these symbols is defined as -1, the corresponding option is not
65    true for any file.  If any is defined as other than -1, the corresponding
66    option is true for all files.  If a symbol is not defined at all, the value
67    for a specific file can be obtained from `pathconf' and `fpathconf'.
68
69    _POSIX_CHOWN_RESTRICTED      Only the super user can use `chown' to change
70                                 the owner of a file.  `chown' can only be used
71                                 to change the group ID of a file to a group of
72                                 which the calling process is a member.
73    _POSIX_NO_TRUNC              Pathname components longer than
74                                 NAME_MAX generate an error.
75    _POSIX_VDISABLE              If defined, if the value of an element of the
76                                 `c_cc' member of `struct termios' is
77                                 _POSIX_VDISABLE, no character will have the
78                                 effect associated with that element.
79    */
80
81 #include <posix_opt.h>
82
83
84 /* Standard file descriptors.  */
85 #define STDIN_FILENO    0       /* Standard input.  */
86 #define STDOUT_FILENO   1       /* Standard output.  */
87 #define STDERR_FILENO   2       /* Standard error output.  */
88
89
90 /* All functions that are not declared anywhere else.  */
91
92 #include <gnu/types.h>
93
94 #ifndef ssize_t
95 #define ssize_t __ssize_t
96 #endif
97
98 #define __need_size_t
99 #include <stddef.h>
100
101
102 /* Values for the second argument to access.
103    These may be OR'd together.  */
104 #define R_OK    4               /* Test for read permission.  */
105 #define W_OK    2               /* Test for write permission.  */
106 #define X_OK    1               /* Test for execute permission.  */
107 #define F_OK    0               /* Test for existence.  */
108
109 /* Test for access to NAME.  */
110 extern int __access __P ((__const char *__name, int __type));
111 extern int access __P ((__const char *__name, int __type));
112
113 #ifdef  __OPTIMIZE__
114 #define access(name, type)      __access((name), (type))
115 #endif /* Optimizing.  */
116
117
118 /* Values for the WHENCE argument to lseek.  */
119 #ifndef _STDIO_H                /* <stdio.h> has the same definitions.  */
120 #define SEEK_SET        0       /* Seek from beginning of file.  */
121 #define SEEK_CUR        1       /* Seek from current position.  */
122 #define SEEK_END        2       /* Seek from end of file.  */
123 #endif
124
125 /* Move FD's file position to OFFSET bytes from the
126    beginning of the file (if WHENCE is SEEK_SET),
127    the current position (if WHENCE is SEEK_CUR),
128    or the end of the file (if WHENCE is SEEK_END).
129    Return the new file position.  */
130 extern __off_t __lseek __P ((int __fd, __off_t __offset, int __whence));
131 extern __off_t lseek __P ((int __fd, __off_t __offset, int __whence));
132
133 /* Close the file descriptor FD.  */
134 extern int __close __P ((int __fd));
135 extern int close __P ((int __fd));
136
137 /* Read NBYTES into BUF from FD.  Return the
138    number read, -1 for errors or 0 for EOF.  */
139 extern ssize_t __read __P ((int __fd, __ptr_t __buf, size_t __nbytes));
140 extern ssize_t read __P ((int __fd, __ptr_t __buf, size_t __nbytes));
141
142 /* Write N bytes of BUF to FD.  Return the number written, or -1.  */
143 extern ssize_t __write __P ((int __fd, __const __ptr_t __buf, size_t __n));
144 extern ssize_t write __P ((int __fd, __const __ptr_t __buf, size_t __n));
145
146 #ifdef  __OPTIMIZE__
147 #define lseek(fd, offset, whence)       __lseek((fd), (offset), (whence))
148 #define close(fd)                       __close(fd)
149 #define read(fd, buf, n)                __read((fd), (buf), (n))
150 #define write(fd, buf, n)               __write((fd), (buf), (n))
151 #endif /* Optimizing.  */
152
153
154 /* Create a one-way communication channel (pipe).
155    If successul, two file descriptors are stored in PIPEDES;
156    bytes written on PIPEDES[1] can be read from PIPEDES[0].
157    Returns 0 if successful, -1 if not.  */
158 extern int __pipe __P ((int __pipedes[2]));
159 extern int pipe __P ((int __pipedes[2]));
160
161 #ifdef __OPTIMIZE__
162 #define pipe(pipedes)   __pipe(pipedes)
163 #endif /* Optimizing.  */
164
165 /* Schedule an alarm.  In SECONDS seconds, the process will get a SIGALRM.
166    If SECONDS is zero, any currently scheduled alarm will be cancelled.
167    The function returns the number of seconds remaining until the last
168    alarm scheduled would have signaled, or zero if there wasn't one.
169    There is no return value to indicate an error, but you can set `errno'
170    to 0 and check its value after calling `alarm', and this might tell you.
171    The signal may come late due to processor scheduling.  */
172 extern unsigned int alarm __P ((unsigned int __seconds));
173
174 /* Make the process sleep for SECONDS seconds, or until a signal arrives
175    and is not ignored.  The function returns the number of seconds less
176    than SECONDS which it actually slept (thus zero if it slept the full time).
177    If a signal handler does a `longjmp' or modifies the handling of the
178    SIGALRM signal while inside `sleep' call, the handling of the SIGALRM
179    signal afterwards is undefined.  There is no return value to indicate
180    error, but if `sleep' returns SECONDS, it probably didn't work.  */
181 extern unsigned int sleep __P ((unsigned int __seconds));
182
183
184 /* Suspend the process until a signal arrives.
185    This always returns -1 and sets `errno' to EINTR.  */
186 extern int pause __P ((void));
187
188
189 /* Change the owner and group of FILE.  */
190 extern int __chown __P ((__const char *__file,
191                          __uid_t __owner, __gid_t __group));
192 extern int chown __P ((__const char *__file,
193                        __uid_t __owner, __gid_t __group));
194
195 #ifdef __OPTIMIZE__
196 #define chown(file, owner, group)       __chown((file), (owner), (group))
197 #endif /* Optimizing.  */
198
199 #ifdef  __USE_BSD
200 /* Change the owner and group of the file that FD is open on.  */
201 extern int __fchown __P ((int __fd,
202                           __uid_t __owner, __gid_t __group));
203 extern int fchown __P ((int __fd,
204                         __uid_t __owner, __gid_t __group));
205 #ifdef __OPTIMIZE__
206 #define fchown(fd, owner, group)        __fchown((fd), (owner), (group))
207 #endif /* Optimizing.  */
208 #endif /* Use BSD.  */
209
210 /* Change the process's working directory to PATH.  */
211 extern int __chdir __P ((__const char *__path));
212 extern int chdir __P ((__const char *__path));
213
214 #ifdef __OPTIMIZE__
215 #define chdir(path)     __chdir(path)
216 #endif /* Optimizing.  */
217
218 /* Get the pathname of the current working directory,
219    and put it in SIZE bytes of BUF.  Returns NULL if the
220    directory couldn't be determined or SIZE was too small.
221    If successful, returns BUF.  In GNU, if BUF is NULL,
222    an array is allocated with `malloc'; the array is SIZE
223    bytes long, unless SIZE <= 0, in which case it is as
224    big as necessary.  */
225 extern char *getcwd __P ((char *__buf, size_t __size));
226
227 #ifdef  __USE_GNU
228 /* Return a malloc'd string containing the current directory name.
229    If the environment variable `PWD' is set, and its value is correct,
230    that value is used.  */
231 extern char *get_current_dir_name __P ((void));
232 #endif
233
234 #ifdef  __USE_BSD
235 /* Put the absolute pathname of the current working directory in BUF.
236    If successful, return BUF.  If not, put an error message in
237    BUF and return NULL.  BUF should be at least PATH_MAX bytes long.  */
238 extern char *getwd __P ((char *__buf));
239 #endif
240
241
242 /* Duplicate FD, returning a new file descriptor on the same file.  */
243 extern int __dup __P ((int __fd));
244 extern int dup __P ((int __fd));
245
246 #ifdef __OPTIMIZE__
247 #define dup(fd) __dup(fd)
248 #endif /* Optimizing.  */
249
250 /* Duplicate FD to FD2, closing FD2 and making it open on the same file.  */
251 extern int __dup2 __P ((int __fd, int __fd2));
252 extern int dup2 __P ((int __fd, int __fd2));
253
254 #ifdef __OPTIMIZE__
255 #define dup2(fd, fd2)   __dup2((fd), (fd2))
256 #endif /* Optimizing.  */
257
258 /* NULL-terminated array of "NAME=VALUE" environment variables.  */
259 extern char **__environ;
260 extern char **environ;
261
262
263 /* Replace the current process, executing PATH with arguments ARGV and
264    environment ENVP.  ARGV and ENVP are terminated by NULL pointers.  */
265 extern int __execve __P ((__const char *__path, char *__const __argv[],
266                           char *__const __envp[]));
267 extern int execve __P ((__const char *__path, char *__const __argv[],
268                         char *__const __envp[]));
269
270 #define execve  __execve
271
272 /* Execute PATH with arguments ARGV and environment from `environ'.  */
273 extern int execv __P ((__const char *__path, char *__const __argv[]));
274
275 /* Execute PATH with all arguments after PATH until a NULL pointer,
276    and the argument after that for environment.  */
277 extern int execle __P ((__const char *__path, __const char *__arg,...));
278
279 /* Execute PATH with all arguments after PATH until
280    a NULL pointer and environment from `environ'.  */
281 extern int execl __P ((__const char *__path, __const char *__arg,...));
282
283 /* Execute FILE, searching in the `PATH' environment variable if it contains
284    no slashes, with arguments ARGV and environment from `environ'.  */
285 extern int execvp __P ((__const char *__file, char *__const __argv[]));
286
287 /* Execute FILE, searching in the `PATH' environment variable if
288    it contains no slashes, with all arguments after FILE until a
289    NULL pointer and environment from `environ'.  */
290 extern int execlp __P ((__const char *__file, __const char *arg,...));
291
292
293 #ifndef __NORETURN
294 #ifdef  __GNUC__
295 /* The `volatile' keyword tells GCC that a function never returns.  */
296 #define __NORETURN      __volatile
297 #else /* Not GCC.  */
298 #define __NORETURN
299 #endif /* GCC.  */
300 #endif /* __NORETURN not defined.  */
301
302 /* Terminate program execution with the low-order 8 bits of STATUS.  */
303 extern __NORETURN void _exit __P ((int __status));
304
305
306 /* Values for the NAME argument to `pathconf' and `fpathconf'.
307    These correspond to the _POSIX_* symbols above, but for
308    specific files or file descriptors.  */
309 #define _PC_LINK_MAX            0
310 #define _PC_MAX_CANON           1
311 #define _PC_MAX_INPUT           2
312 #define _PC_NAME_MAX            3
313 #define _PC_PATH_MAX            4
314 #define _PC_PIPE_BUF            5
315 #define _PC_CHOWN_RESTRICTED    6
316 #define _PC_NO_TRUNC            7
317 #define _PC_VDISABLE            8
318
319 /* Get file-specific configuration information about PATH.  */
320 extern long int __pathconf __P ((__const char *__path, int __name));
321 extern long int pathconf __P ((__const char *__path, int __name));
322
323 /* Get file-specific configuration about descriptor FD.  */
324 extern long int __fpathconf __P ((int __fd, int __name));
325 extern long int fpathconf __P ((int __fd, int __name));
326
327 #define pathconf        __pathconf
328 #define fpathconf       __fpathconf
329
330
331 /* Values for the argument to `sysconf'.
332    These correspond to the _POSIX_* symbols in <posix_limits.h> and above,
333    but may vary at run time.  */
334 enum
335 {
336   _SC_ARG_MAX,
337   _SC_CHILD_MAX,
338   _SC_CLK_TCK,
339   _SC_NGROUPS_MAX,
340   _SC_OPEN_MAX,
341   _SC_STREAM_MAX,
342   _SC_TZNAME_MAX,
343   _SC_JOB_CONTROL,
344   _SC_SAVED_IDS,
345   _SC_VERSION,
346
347   /* Values for the argument to `sysconf'
348      corresponding to _POSIX2_* symbols.  */
349   _SC_BC_BASE_MAX,
350   _SC_BC_DIM_MAX,
351   _SC_BC_SCALE_MAX,
352   _SC_BC_STRING_MAX,
353   _SC_COLL_WEIGHTS_MAX,
354   _SC_EQUIV_CLASS_MAX,
355   _SC_EXPR_NEST_MAX,
356   _SC_LINE_MAX,
357   _SC_RE_DUP_MAX,
358
359   _SC_2_VERSION,
360   _SC_2_C_BIND,
361   _SC_2_C_DEV,
362   _SC_2_FORT_DEV,
363   _SC_2_FORT_RUN,
364   _SC_2_SW_DEV,
365   _SC_2_LOCALEDEF
366 };
367
368
369 /* Get the value of the system variable NAME.  */
370 extern long int __sysconf __P ((int __name));
371 extern long int sysconf __P ((int __name));
372
373 #ifdef __OPTIMIZE__
374 #define sysconf(name)   __sysconf(name)
375 #endif /* Optimizing.  */
376
377
378 #ifdef  __USE_POSIX2
379 /* Values for the argument to `confstr'.  */
380 #define _CS_PATH        0       /* The default search path.  */
381
382 /* Get the value of the string-valued system variable NAME.  */
383 extern size_t confstr __P ((int __name, char *__buf, size_t __len));
384 #endif
385
386
387 /* Get the process ID of the calling process.  */
388 extern __pid_t __getpid __P ((void));
389 extern __pid_t getpid __P ((void));
390
391 /* Get the process ID of the calling process's parent.  */
392 extern __pid_t __getppid __P ((void));
393 extern __pid_t getppid __P ((void));
394
395 #ifdef  __OPTIMIZE__
396 #define getpid()        __getpid()
397 #define getppid()       __getppid()
398 #endif /* Optimizing.  */
399
400 /* Get the process group ID of process PID.  */
401 extern __pid_t __getpgrp __P ((__pid_t __pid));
402
403 #ifndef __FAVOR_BSD
404 /* Get the process group ID of the calling process.  */
405 extern __pid_t getpgrp __P ((void));
406 #else /* Favor BSD.  */
407 #define getpgrp(pid)    __getpgrp(pid)
408 #endif
409
410 /* Set the process group ID of the process matching PID to PGID.
411    If PID is zero, the current process's process group ID is set.
412    If PGID is zero, the process ID of the process is used.  */
413 extern int __setpgrp __P ((__pid_t __pid, __pid_t __pgid));
414 extern int setpgid __P ((__pid_t __pid, __pid_t __pgid));
415
416 #ifdef __OPTIMIZE__
417 #define setpgid(pid, pgid)      __setpgrp((pid), (pgid))
418 #endif /* Optimizing.  */
419
420 #ifdef  __USE_BSD
421 /* Set the process group of PID to PGRP.  */
422 extern int setpgrp __P ((__pid_t __pid, __pid_t __pgrp));
423
424 #ifdef  __OPTIMIZE__
425 #define setpgrp(pid, pgrp)      setpgid((pid), (pgrp))
426 #endif /* Optimizing.  */
427 #endif /* Use BSD.  */
428
429 /* Create a new session with the calling process as its leader.
430    The process group IDs of the session and the calling process
431    are set to the process ID of the calling process, which is returned.  */
432 extern __pid_t __setsid __P ((void));
433 extern __pid_t setsid __P ((void));
434
435 #ifdef __OPTIMIZE__
436 #define setsid()        __setsid()
437 #endif /* Optimizing.  */
438
439 /* Get the real user ID of the calling process.  */
440 extern __uid_t __getuid __P ((void));
441 extern __uid_t getuid __P ((void));
442
443 #ifdef __OPTIMIZE__
444 #define getuid()        __getuid()
445 #endif /* Optimizing.  */
446
447 /* Get the effective user ID of the calling process.  */
448 extern __uid_t __geteuid __P ((void));
449 extern __uid_t geteuid __P ((void));
450
451 #ifdef __OPTIMIZE__
452 #define geteuid()       __geteuid()
453 #endif /* Optimizing.  */
454
455 /* Get the real group ID of the calling process.  */
456 extern __gid_t __getgid __P ((void));
457 extern __gid_t getgid __P ((void));
458
459 #ifdef __OPTIMIZE__
460 #define getgid()        __getgid()
461 #endif /* Optimizing.  */
462
463 /* Get the effective group ID of the calling process.  */
464 extern __gid_t __getegid __P ((void));
465 extern __gid_t getegid __P ((void));
466
467 #ifdef __OPTIMIZE__
468 #define getegid()       __getegid()
469 #endif /* Optimizing.  */
470
471 /* If SIZE is zero, return the number of supplementary groups
472    the calling process is in.  Otherwise, fill in the group IDs
473    of its supplementary groups in LIST and return the number written.  */
474 extern int __getgroups __P ((int __size, __gid_t __list[]));
475 extern int getgroups __P ((int __size, __gid_t __list[]));
476
477 /* Set the user ID of the calling process to UID.
478    If the calling process is the super-user, set the real
479    and effective user IDs, and the saved set-user-ID to UID;
480    if not, the effective user ID is set to UID.  */
481 extern int __setuid __P ((__uid_t __uid));
482 extern int setuid __P ((__uid_t __uid));
483
484 #ifdef __OPTIMIZE__
485 #define setuid(uid)     __setuid(uid)
486 #endif /* Optimizing.  */
487
488 #ifdef  __USE_BSD
489 /* Set the real user ID of the calling process to RUID,
490    and the effective user ID of the calling process to EUID.  */
491 extern int __setreuid __P ((__uid_t __ruid, __uid_t __euid));
492 extern int setreuid __P ((__uid_t __ruid, __uid_t __euid));
493
494 #ifdef __OPTIMIZE__
495 #define setreuid(ruid, euid)    __setreuid((ruid), (euid))
496 #endif /* Optimizing.  */
497
498 /* Set the effective user ID of the calling process to UID.  */
499 extern int seteuid __P ((__uid_t __uid));
500 #endif /* Use BSD.  */
501
502 /* Set the group ID of the calling process to GID.
503    If the calling process is the super-user, set the real
504    and effective group IDs, and the saved set-group-ID to GID;
505    if not, the effective group ID is set to GID.  */
506 extern int __setgid __P ((__gid_t __gid));
507 extern int setgid __P ((__gid_t __gid));
508
509 #ifdef __OPTIMIZE__
510 #define setgid(gid)     __setgid(gid)
511 #endif /* Optimizing.  */
512
513 #ifdef  __USE_BSD
514 /* Set the real group ID of the calling process to RGID,
515    and the effective group ID of the calling process to EGID.  */
516 extern int __setregid __P ((__gid_t __rgid, __gid_t __egid));
517 extern int setregid __P ((__gid_t __rgid, __gid_t __egid));
518
519 #ifdef  __OPTIMIZE__
520 #define setregid(rgid, egid)    __setregid((rgid), (egid))
521 #endif /* Optimizing.  */
522
523 /* Set the effective user ID of the calling process to UID.  */
524 extern int seteuid __P ((__uid_t __uid));
525 #endif /* Use BSD.  */
526
527
528 /* Clone the calling process, creating an exact copy.
529    Return -1 for errors, 0 to the new process,
530    and the process ID of the new process to the old process.  */
531 extern __pid_t __fork __P ((void));
532 extern __pid_t fork __P ((void));
533
534 #define fork    __fork
535
536 #ifdef  __USE_BSD
537 /* Clone the calling process, but without copying the whole address space.
538    The the calling process is suspended until the the new process exits or is
539    replaced by a call to `execve'.  Return -1 for errors, 0 to the new process,
540    and the process ID of the new process to the old process.  */
541 extern __pid_t __vfork __P ((void));
542 extern __pid_t vfork __P ((void));
543
544 #define vfork   __vfork
545 #endif /* Use BSD. */
546
547
548 /* Return the pathname of the terminal FD is open on, or NULL on errors.
549    The returned storage is good only until the next call to this function.  */
550 extern char *ttyname __P ((int __fd));
551
552 /* Return 1 if FD is a valid descriptor associated
553    with a terminal, zero if not.  */
554 extern int __isatty __P ((int __fd));
555 extern int isatty __P ((int __fd));
556
557 #ifdef  __OPTIMIZE__
558 #define isatty(fd)      __isatty(fd)
559 #endif /* Optimizing.  */
560
561
562 /* Make a link to FROM named TO.  */
563 extern int __link __P ((__const char *__from, __const char *__to));
564 extern int link __P ((__const char *__from, __const char *__to));
565 #define link    __link
566
567 #ifdef  __USE_BSD
568 /* Make a symbolic link to FROM named TO.  */
569 extern int __symlink __P ((__const char *__from, __const char *__to));
570 extern int symlink __P ((__const char *__from, __const char *__to));
571
572 #ifdef __OPTIMIZE__
573 #define symlink(from, to)       __symlink((from), (to))
574 #endif /* Optimizing.  */
575
576 /* Read the contents of the symbolic link PATH into no more than
577    LEN bytes of BUF.  The contents are not null-terminated.
578    Returns the number of characters read, or -1 for errors.  */
579 extern int __readlink __P ((__const char *__path, char *__buf, size_t __len));
580 extern int readlink __P ((__const char *__path, char *__buf, size_t __len));
581
582 #ifdef __OPTIMIZE__
583 #define readlink(path, buf, len)        __readlink((path), (buf), (len))
584 #endif /* Optimizing.  */
585 #endif /* Use BSD.  */
586
587 /* Remove the link NAME.  */
588 extern int __unlink __P ((__const char *__name));
589 extern int unlink __P ((__const char *__name));
590
591 #ifdef  __OPTIMIZE__
592 #define unlink(name)    __unlink(name)
593 #endif /* Optimizing.  */
594
595 /* Remove the directory PATH.  */
596 extern int __rmdir __P ((__const char *__path));
597 extern int rmdir __P ((__const char *__path));
598
599 #ifdef __OPTIMIZE__
600 #define rmdir(path)     __rmdir(path)
601 #endif /* Optimizing.  */
602
603
604 /* Return the foreground process group ID of FD.  */
605 extern __pid_t tcgetpgrp __P ((int __fd));
606
607 /* Set the foreground process group ID of FD set PGRP_ID.  */
608 extern int tcsetpgrp __P ((int __fd, __pid_t __pgrp_id));
609
610
611 /* Return the login name of the user.  */
612 extern char *getlogin __P ((void));
613
614 #ifdef  __USE_BSD
615 /* Set the login name returned by `getlogin'.  */
616 extern int setlogin __P ((__const char *__name));
617 #endif
618
619
620 #ifdef  __USE_POSIX2
621 /* Process the arguments in ARGV (ARGC of them, minus
622    the program name) for options given in OPTS.
623
624    If `opterr' is zero, no messages are generated
625    for invalid options; it defaults to 1.
626    `optind' is the current index into ARGV.
627    `optarg' is the argument corresponding to the current option.
628    Return the option character from OPTS just read.
629    Return -1 when there are no more options.
630    For unrecognized options, or options missing arguments,
631    `optopt' is set to the option letter, and '?' is returned.
632
633    The OPTS string is a list of characters which are recognized option
634    letters, optionally followed by colons, specifying that that letter
635    takes an argument, to be placed in `optarg'.
636
637    If a letter in OPTS is followed by two colons, its argument is optional.
638    This behavior is specific to the GNU `getopt'.
639
640    The argument `--' causes premature termination of argument scanning,
641    explicitly telling `getopt' that there are no more options.
642
643    If OPTS begins with `--', then non-option arguments
644    are treated as arguments to the option '\0'.
645    This behavior is specific to the GNU `getopt'.  */
646 extern int getopt __P ((int __argc, char *__const * __argv,
647                         __const char *__opts));
648 extern int opterr;
649 extern int optind;
650 extern int optopt;
651 extern char *optarg;
652 #endif
653
654
655 #ifdef  __USE_BSD
656
657 /* Put the name of the current host in no more than LEN bytes of NAME.
658    The result is null-terminated if LEN is large enough for the full
659    name and the terminator.  */
660 extern int __gethostname __P ((char *__name, size_t __len));
661 extern int gethostname __P ((char *__name, size_t __len));
662
663 #ifdef  __OPTIMIZE__
664 #define gethostname(name, len)  __gethostname((name), (len))
665 #endif
666
667 /* Set the name of the current host to NAME, which is LEN bytes long.
668    This call is restricted to the super-user.  */
669 extern int sethostname __P ((__const char *__name, size_t __len));
670
671 /* Return the current machine's Internet number.  */
672 extern long int gethostid __P ((void));
673
674 /* Set the current machine's Internet number to ID.
675    This call is restricted to the super-user.  */
676 extern int sethostid __P ((long int __id));
677
678
679 /* Return the number of bytes in a page.  This is the system's page size,
680    which is not necessarily the same as the hardware page size.  */
681 extern size_t __getpagesize __P ((void));
682 extern size_t getpagesize __P ((void));
683
684 #ifdef  __OPTIMIZE__
685 #define getpagesize()   __getpagesize()
686 #endif /* Optimizing.  */
687
688
689 /* Return the maximum number of file descriptors
690    the current process could possibly have.  */
691 extern int __getdtablesize __P ((void));
692 extern int getdtablesize __P ((void));
693
694 #ifdef __OPTIMIZE__
695 #define getdtablesize() __getdtablesize()
696 #endif
697
698
699 /* Make all changes done to FD actually appear on disk.  */
700 extern int fsync __P ((int __fd));
701
702 /* Make all changes done to all files actually appear on disk.  */
703 extern int sync __P ((void));
704
705
706 /* Revoke access permissions to all processes currently communicating
707    with the control terminal, and then send a SIGHUP signal to the process
708    group of the control terminal.  */
709 extern int vhangup __P ((void));
710
711
712 /* Turn accounting on if NAME is an existing file.  The system will then write
713    a record for each process as it terminates, to this file.  If NAME is NULL,
714    turn accounting off.  This call is restricted to the super-user.  */
715 extern int acct __P ((__const char *__name));
716
717 /* Make PATH be the root directory (the starting point for absolute paths).
718    This call is restricted to the super-user.  */
719 extern int chroot __P ((__const char *__path));
720
721 /* Make the block special device PATH available to the system for swapping.
722    This call is restricted to the super-user.  */
723 extern int swapon __P ((__const char *__path));
724
725 /* Reboot or halt the system.  */
726 extern int reboot __P ((int __howto));
727
728
729 /* Successive calls return the shells listed in `/etc/shells'.  */
730 extern char *getusershell __P ((void));
731 extern void endusershell __P ((void)); /* Discard cached info.  */
732 extern void setusershell __P ((void)); /* Rewind and re-read the file.  */
733
734 /* Prompt with PROMPT and read a string from the terminal without echoing.
735    Uses /dev/tty if possible; otherwise stderr and stdin.  */
736 extern char *getpass __P ((const char *__prompt));
737
738 #endif /* Use BSD.  */
739
740
741 __END_DECLS
742
743 #endif /* unistd.h  */