manual/LDP_man-pages/po4a/unistd/po/unistd.pot

   1 # SOME DESCRIPTIVE TITLE
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # This file is distributed under the same license as the PACKAGE package.
   4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   5 #
   6 #, fuzzy
   7 msgid ""
   8 msgstr ""
   9 "Project-Id-Version: PACKAGE VERSION\n"
  10 "POT-Creation-Date: 2013-08-15 19:33+0900\n"
  11 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 #. type: TH
  20 #: build/C/man2/_syscall.2:38
  21 #, no-wrap
  22 msgid "_SYSCALL"
  23 msgstr ""
  24
  25 #. type: TH
  26 #: build/C/man2/_syscall.2:38
  27 #, no-wrap
  28 msgid "2007-12-19"
  29 msgstr ""
  30
  31 #. type: TH
  32 #: build/C/man2/_syscall.2:38 build/C/man2/access.2:43 build/C/man2/alarm.2:30 build/C/man2/brk.2:29 build/C/man2/chdir.2:33 build/C/man2/chmod.2:31 build/C/man2/chown.2:38 build/C/man2/chroot.2:33 build/C/man2/close.2:35 build/C/man2/dup.2:36 build/C/man7/environ.7:34 build/C/man2/execve.2:37 build/C/man2/exit_group.2:25 build/C/man2/fcntl.2:61 build/C/man3/fexecve.3:25 build/C/man2/flock.2:35 build/C/man2/fork.2:39 build/C/man2/fsync.2:38 build/C/man2/get_thread_area.2:8 build/C/man2/getdomainname.2:29 build/C/man3/getdtablesize.3:27 build/C/man3/gethostid.3:29 build/C/man2/gethostname.2:32 build/C/man2/getpagesize.2:25 build/C/man2/gettid.2:26 build/C/man2/idle.2:32 build/C/man2/ioctl.2:41 build/C/man2/ioctl_list.2:30 build/C/man2/ioperm.2:34 build/C/man2/mincore.2:34 build/C/man2/mkdir.2:10 build/C/man2/nice.2:31 build/C/man2/pread.2:25 build/C/man2/set_thread_area.2:8 build/C/man2/setup.2:34 build/C/man2/swapon.2:37 build/C/man2/syscall.2:40 build/C/man2/syscalls.2:31 build/C/man2/sysctl.2:30 build/C/man2/sysinfo.2:14 build/C/man2/truncate.2:43 build/C/man2/umask.2:34 build/C/man2/uname.2:27 build/C/man2/uselib.2:31 build/C/man2/vfork.2:28 build/C/man2/vhangup.2:28
  33 #, no-wrap
  34 msgid "Linux"
  35 msgstr ""
  36
  37 #. type: TH
  38 #: build/C/man2/_syscall.2:38 build/C/man2/access.2:43 build/C/man2/alarm.2:30 build/C/man2/brk.2:29 build/C/man2/chdir.2:33 build/C/man2/chmod.2:31 build/C/man2/chown.2:38 build/C/man2/chroot.2:33 build/C/man2/close.2:35 build/C/man3/confstr.3:31 build/C/man3/crypt.3:36 build/C/man3/daemon.3:36 build/C/man3/des_crypt.3:14 build/C/man2/dup.2:36 build/C/man3/encrypt.3:30 build/C/man7/environ.7:34 build/C/man3/euidaccess.3:25 build/C/man3/exec.3:41 build/C/man2/execve.2:37 build/C/man2/exit_group.2:25 build/C/man2/fcntl.2:61 build/C/man3/fexecve.3:25 build/C/man2/flock.2:35 build/C/man2/fork.2:39 build/C/man3/fpathconf.3:41 build/C/man2/fsync.2:38 build/C/man3/get_nprocs_conf.3:26 build/C/man2/get_thread_area.2:8 build/C/man3/getcwd.3:32 build/C/man2/getdomainname.2:29 build/C/man3/getdtablesize.3:27 build/C/man3/gethostid.3:29 build/C/man2/gethostname.2:32 build/C/man3/getlogin.3:28 build/C/man3/getopt.3:41 build/C/man2/getpagesize.2:25 build/C/man2/gettid.2:26 build/C/man3/getumask.3:28 build/C/man3/getusershell.3:30 build/C/man2/idle.2:32 build/C/man2/ioctl.2:41 build/C/man2/ioctl_list.2:30 build/C/man2/ioperm.2:34 build/C/man3/lockf.3:28 build/C/man2/mincore.2:34 build/C/man2/mkdir.2:10 build/C/man2/nice.2:31 build/C/man2/pread.2:25 build/C/man2/set_thread_area.2:8 build/C/man2/setup.2:34 build/C/man5/shells.5:28 build/C/man3/sleep.3:26 build/C/man3/swab.3:31 build/C/man2/swapon.2:37 build/C/man2/syscall.2:40 build/C/man2/syscalls.2:31 build/C/man3/sysconf.3:27 build/C/man2/sysctl.2:30 build/C/man2/sysinfo.2:14 build/C/man3/tcgetpgrp.3:25 build/C/man2/truncate.2:43 build/C/man3/ualarm.3:24 build/C/man2/umask.2:34 build/C/man2/uname.2:27 build/C/man2/uselib.2:31 build/C/man3/usleep.3:33 build/C/man2/vfork.2:28 build/C/man2/vhangup.2:28
  39 #, no-wrap
  40 msgid "Linux Programmer's Manual"
  41 msgstr ""
  42
  43 #. type: SH
  44 #: build/C/man2/_syscall.2:39 build/C/man2/access.2:44 build/C/man2/alarm.2:31 build/C/man2/brk.2:30 build/C/man2/chdir.2:34 build/C/man2/chmod.2:32 build/C/man2/chown.2:39 build/C/man2/chroot.2:34 build/C/man2/close.2:36 build/C/man3/confstr.3:32 build/C/man3/crypt.3:37 build/C/man3/daemon.3:37 build/C/man3/des_crypt.3:15 build/C/man2/dup.2:37 build/C/man3/encrypt.3:31 build/C/man7/environ.7:35 build/C/man3/euidaccess.3:26 build/C/man3/exec.3:42 build/C/man2/execve.2:38 build/C/man2/exit_group.2:26 build/C/man2/fcntl.2:62 build/C/man3/fexecve.3:26 build/C/man2/flock.2:36 build/C/man2/fork.2:40 build/C/man3/fpathconf.3:42 build/C/man2/fsync.2:39 build/C/man3/get_nprocs_conf.3:27 build/C/man2/get_thread_area.2:9 build/C/man3/getcwd.3:33 build/C/man2/getdomainname.2:30 build/C/man3/getdtablesize.3:28 build/C/man3/gethostid.3:30 build/C/man2/gethostname.2:33 build/C/man3/getlogin.3:29 build/C/man3/getopt.3:42 build/C/man2/getpagesize.2:26 build/C/man2/gettid.2:27 build/C/man3/getumask.3:29 build/C/man3/getusershell.3:31 build/C/man2/idle.2:33 build/C/man2/ioctl.2:42 build/C/man2/ioctl_list.2:31 build/C/man2/ioperm.2:35 build/C/man3/lockf.3:29 build/C/man2/mincore.2:35 build/C/man2/mkdir.2:11 build/C/man2/nice.2:32 build/C/man2/pread.2:26 build/C/man2/set_thread_area.2:9 build/C/man2/setup.2:35 build/C/man5/shells.5:29 build/C/man3/sleep.3:27 build/C/man3/swab.3:32 build/C/man2/swapon.2:38 build/C/man2/syscall.2:41 build/C/man2/syscalls.2:32 build/C/man3/sysconf.3:28 build/C/man2/sysctl.2:31 build/C/man2/sysinfo.2:15 build/C/man3/tcgetpgrp.3:26 build/C/man2/truncate.2:44 build/C/man3/ualarm.3:25 build/C/man2/umask.2:35 build/C/man2/uname.2:28 build/C/man2/uselib.2:32 build/C/man3/usleep.3:34 build/C/man2/vfork.2:29 build/C/man2/vhangup.2:29
  45 #, no-wrap
  46 msgid "NAME"
  47 msgstr ""
  48
  49 #. type: Plain text
  50 #: build/C/man2/_syscall.2:41
  51 msgid "_syscall - invoking a system call without library support (OBSOLETE)"
  52 msgstr ""
  53
  54 #. type: SH
  55 #: build/C/man2/_syscall.2:41 build/C/man2/access.2:46 build/C/man2/alarm.2:33 build/C/man2/brk.2:32 build/C/man2/chdir.2:36 build/C/man2/chmod.2:34 build/C/man2/chown.2:41 build/C/man2/chroot.2:36 build/C/man2/close.2:38 build/C/man3/confstr.3:34 build/C/man3/crypt.3:39 build/C/man3/daemon.3:39 build/C/man3/des_crypt.3:18 build/C/man2/dup.2:39 build/C/man3/encrypt.3:33 build/C/man7/environ.7:37 build/C/man3/euidaccess.3:28 build/C/man3/exec.3:44 build/C/man2/execve.2:40 build/C/man2/exit_group.2:28 build/C/man2/fcntl.2:64 build/C/man3/fexecve.3:28 build/C/man2/flock.2:38 build/C/man2/fork.2:42 build/C/man3/fpathconf.3:44 build/C/man2/fsync.2:41 build/C/man3/get_nprocs_conf.3:29 build/C/man2/get_thread_area.2:11 build/C/man3/getcwd.3:35 build/C/man2/getdomainname.2:32 build/C/man3/getdtablesize.3:30 build/C/man3/gethostid.3:32 build/C/man2/gethostname.2:35 build/C/man3/getlogin.3:31 build/C/man3/getopt.3:45 build/C/man2/getpagesize.2:28 build/C/man2/gettid.2:29 build/C/man3/getumask.3:31 build/C/man3/getusershell.3:33 build/C/man2/idle.2:35 build/C/man2/ioctl.2:44 build/C/man2/ioperm.2:37 build/C/man3/lockf.3:31 build/C/man2/mincore.2:37 build/C/man2/mkdir.2:13 build/C/man2/nice.2:34 build/C/man2/pread.2:28 build/C/man2/set_thread_area.2:11 build/C/man2/setup.2:37 build/C/man3/sleep.3:29 build/C/man3/swab.3:34 build/C/man2/swapon.2:40 build/C/man2/syscall.2:43 build/C/man2/syscalls.2:34 build/C/man3/sysconf.3:30 build/C/man2/sysctl.2:33 build/C/man2/sysinfo.2:17 build/C/man3/tcgetpgrp.3:28 build/C/man2/truncate.2:46 build/C/man3/ualarm.3:27 build/C/man2/umask.2:37 build/C/man2/uname.2:30 build/C/man2/uselib.2:34 build/C/man3/usleep.3:36 build/C/man2/vfork.2:31 build/C/man2/vhangup.2:31
  56 #, no-wrap
  57 msgid "SYNOPSIS"
  58 msgstr ""
  59
  60 #. type: Plain text
  61 #: build/C/man2/_syscall.2:43 build/C/man2/get_thread_area.2:13 build/C/man2/set_thread_area.2:13
  62 msgid "B<#include E<lt>linux/unistd.hE<gt>>"
  63 msgstr ""
  64
  65 #. type: Plain text
  66 #: build/C/man2/_syscall.2:45
  67 msgid "A _syscall macro"
  68 msgstr ""
  69
  70 #. type: Plain text
  71 #: build/C/man2/_syscall.2:47
  72 msgid "desired system call"
  73 msgstr ""
  74
  75 #. type: SH
  76 #: build/C/man2/_syscall.2:47 build/C/man2/access.2:52 build/C/man2/alarm.2:39 build/C/man2/brk.2:64 build/C/man2/chdir.2:59 build/C/man2/chmod.2:58 build/C/man2/chown.2:67 build/C/man2/chroot.2:63 build/C/man2/close.2:44 build/C/man3/confstr.3:48 build/C/man3/crypt.3:56 build/C/man3/daemon.3:51 build/C/man3/des_crypt.3:34 build/C/man2/dup.2:52 build/C/man3/encrypt.3:56 build/C/man7/environ.7:42 build/C/man3/euidaccess.3:36 build/C/man3/exec.3:72 build/C/man2/execve.2:46 build/C/man2/exit_group.2:34 build/C/man2/fcntl.2:71 build/C/man3/fexecve.3:53 build/C/man2/flock.2:42 build/C/man2/fork.2:46 build/C/man3/fpathconf.3:52 build/C/man2/fsync.2:61 build/C/man3/get_nprocs_conf.3:35 build/C/man2/get_thread_area.2:20 build/C/man3/getcwd.3:75 build/C/man2/getdomainname.2:51 build/C/man3/getdtablesize.3:57 build/C/man3/gethostid.3:56 build/C/man2/gethostname.2:63 build/C/man3/getlogin.3:52 build/C/man3/getopt.3:79 build/C/man2/getpagesize.2:55 build/C/man2/gettid.2:38 build/C/man3/getumask.3:39 build/C/man3/getusershell.3:57 build/C/man2/idle.2:39 build/C/man2/ioctl.2:48 build/C/man2/ioctl_list.2:33 build/C/man2/ioperm.2:45 build/C/man3/lockf.3:48 build/C/man2/mincore.2:51 build/C/man2/mkdir.2:21 build/C/man2/nice.2:46 build/C/man2/pread.2:53 build/C/man2/set_thread_area.2:20 build/C/man2/setup.2:41 build/C/man5/shells.5:31 build/C/man3/sleep.3:35 build/C/man3/swab.3:41 build/C/man2/swapon.2:50 build/C/man2/syscall.2:51 build/C/man2/syscalls.2:36 build/C/man3/sysconf.3:36 build/C/man2/sysctl.2:44 build/C/man2/sysinfo.2:21 build/C/man3/tcgetpgrp.3:34 build/C/man2/truncate.2:79 build/C/man3/ualarm.3:58 build/C/man2/umask.2:43 build/C/man2/uname.2:34 build/C/man2/uselib.2:38 build/C/man3/usleep.3:67 build/C/man2/vfork.2:62 build/C/man2/vhangup.2:45
  77 #, no-wrap
  78 msgid "DESCRIPTION"
  79 msgstr ""
  80
  81 #. type: Plain text
  82 #: build/C/man2/_syscall.2:53
  83 msgid ""
  84 "The important thing to know about a system call is its prototype.  You need "
  85 "to know how many arguments, their types, and the function return type.  "
  86 "There are seven macros that make the actual call into the system easier.  "
  87 "They have the form:"
  88 msgstr ""
  89
  90 #. type: Plain text
  91 #: build/C/man2/_syscall.2:56
  92 msgid "_syscallI<X>(I<type>,I<name>,I<type1>,I<arg1>,I<type2>,I<arg2>,...)"
  93 msgstr ""
  94
  95 #. type: Plain text
  96 #: build/C/man2/_syscall.2:59
  97 msgid "where"
  98 msgstr ""
  99
 100 #. type: Plain text
 101 #: build/C/man2/_syscall.2:63
 102 msgid "I<X> is 0\\(en6, which are the number of arguments taken by the system call"
 103 msgstr ""
 104
 105 #. type: Plain text
 106 #: build/C/man2/_syscall.2:66
 107 msgid "I<type> is the return type of the system call"
 108 msgstr ""
 109
 110 #. type: Plain text
 111 #: build/C/man2/_syscall.2:69
 112 msgid "I<name> is the name of the system call"
 113 msgstr ""
 114
 115 #. type: Plain text
 116 #: build/C/man2/_syscall.2:72
 117 msgid "I<typeN> is the Nth argument's type"
 118 msgstr ""
 119
 120 #. type: Plain text
 121 #: build/C/man2/_syscall.2:75
 122 msgid "I<argN> is the name of the Nth argument"
 123 msgstr ""
 124
 125 #. type: Plain text
 126 #: build/C/man2/_syscall.2:83
 127 msgid ""
 128 "These macros create a function called I<name> with the arguments you "
 129 "specify.  Once you include the _syscall() in your source file, you call the "
 130 "system call by I<name>."
 131 msgstr ""
 132
 133 #. type: SH
 134 #: build/C/man2/_syscall.2:83 build/C/man3/getlogin.3:132 build/C/man3/getusershell.3:89 build/C/man5/shells.5:43
 135 #, no-wrap
 136 msgid "FILES"
 137 msgstr ""
 138
 139 #. type: Plain text
 140 #: build/C/man2/_syscall.2:85
 141 msgid "I</usr/include/linux/unistd.h>"
 142 msgstr ""
 143
 144 #. type: SH
 145 #: build/C/man2/_syscall.2:85 build/C/man2/access.2:156 build/C/man2/alarm.2:59 build/C/man2/brk.2:114 build/C/man2/chdir.2:125 build/C/man2/chmod.2:219 build/C/man2/chown.2:181 build/C/man2/chroot.2:134 build/C/man2/close.2:84 build/C/man3/confstr.3:127 build/C/man3/crypt.3:172 build/C/man3/daemon.3:91 build/C/man3/des_crypt.3:134 build/C/man2/dup.2:170 build/C/man3/encrypt.3:137 build/C/man3/euidaccess.3:73 build/C/man3/exec.3:199 build/C/man2/execve.2:450 build/C/man2/exit_group.2:43 build/C/man2/fcntl.2:1146 build/C/man3/fexecve.3:94 build/C/man2/flock.2:138 build/C/man2/fork.2:206 build/C/man3/fpathconf.3:169 build/C/man2/fsync.2:125 build/C/man3/get_nprocs_conf.3:48 build/C/man2/get_thread_area.2:46 build/C/man3/getcwd.3:208 build/C/man2/getdomainname.2:110 build/C/man3/getdtablesize.3:69 build/C/man3/gethostid.3:92 build/C/man2/gethostname.2:124 build/C/man3/getlogin.3:154 build/C/man3/getopt.3:318 build/C/man2/getpagesize.2:64 build/C/man2/gettid.2:58 build/C/man3/getumask.3:58 build/C/man3/getusershell.3:101 build/C/man2/idle.2:61 build/C/man2/ioctl.2:117 build/C/man2/ioperm.2:104 build/C/man3/lockf.3:154 build/C/man2/mincore.2:134 build/C/man2/mkdir.2:118 build/C/man2/nice.2:75 build/C/man2/pread.2:115 build/C/man2/set_thread_area.2:63 build/C/man2/setup.2:62 build/C/man3/sleep.3:44 build/C/man3/swab.3:72 build/C/man2/swapon.2:151 build/C/man3/sysconf.3:324 build/C/man2/sysctl.2:100 build/C/man2/sysinfo.2:83 build/C/man3/tcgetpgrp.3:109 build/C/man2/truncate.2:195 build/C/man3/ualarm.3:92 build/C/man2/umask.2:95 build/C/man2/uname.2:73 build/C/man2/uselib.2:76 build/C/man3/usleep.3:91 build/C/man2/vfork.2:159 build/C/man2/vhangup.2:63
 146 #, no-wrap
 147 msgid "CONFORMING TO"
 148 msgstr ""
 149
 150 #. type: Plain text
 151 #: build/C/man2/_syscall.2:87
 152 msgid "The use of these macros is Linux-specific, and deprecated."
 153 msgstr ""
 154
 155 #. type: SH
 156 #: build/C/man2/_syscall.2:87 build/C/man2/access.2:158 build/C/man2/alarm.2:61 build/C/man2/brk.2:122 build/C/man2/chdir.2:127 build/C/man2/chown.2:192 build/C/man2/chroot.2:139 build/C/man2/close.2:87 build/C/man3/crypt.3:177 build/C/man3/daemon.3:97 build/C/man2/dup.2:180 build/C/man3/encrypt.3:148 build/C/man3/euidaccess.3:79 build/C/man3/exec.3:205 build/C/man2/execve.2:458 build/C/man2/exit_group.2:45 build/C/man2/fcntl.2:1196 build/C/man3/fexecve.3:98 build/C/man2/flock.2:147 build/C/man2/fork.2:208 build/C/man3/fpathconf.3:171 build/C/man2/fsync.2:140 build/C/man3/get_nprocs_conf.3:50 build/C/man2/get_thread_area.2:50 build/C/man3/getcwd.3:230 build/C/man2/getdomainname.2:113 build/C/man3/getdtablesize.3:77 build/C/man3/gethostid.3:102 build/C/man2/gethostname.2:130 build/C/man3/getopt.3:350 build/C/man2/getpagesize.2:71 build/C/man2/gettid.2:62 build/C/man3/getumask.3:60 build/C/man2/ioctl.2:132 build/C/man2/ioperm.2:108 build/C/man2/mkdir.2:121 build/C/man2/nice.2:82 build/C/man2/pread.2:117 build/C/man2/set_thread_area.2:67 build/C/man2/setup.2:65 build/C/man2/swapon.2:157 build/C/man2/syscall.2:78 build/C/man2/syscalls.2:656 build/C/man2/sysctl.2:114 build/C/man3/tcgetpgrp.3:111 build/C/man2/truncate.2:208 build/C/man3/ualarm.3:100 build/C/man2/umask.2:97 build/C/man2/uname.2:82 build/C/man2/uselib.2:80 build/C/man3/usleep.3:109 build/C/man2/vfork.2:174
 157 #, no-wrap
 158 msgid "NOTES"
 159 msgstr ""
 160
 161 #. type: Plain text
 162 #: build/C/man2/_syscall.2:97
 163 msgid ""
 164 "Starting around kernel 2.6.18, the _syscall macros were removed from header "
 165 "files supplied to user space.  Use B<syscall>(2)  instead.  (Some "
 166 "architectures, notably ia64, never provided the _syscall macros; on those "
 167 "architectures, B<syscall>(2)  was always required.)"
 168 msgstr ""
 169
 170 #. type: Plain text
 171 #: build/C/man2/_syscall.2:103
 172 msgid ""
 173 "The _syscall() macros I<do not> produce a prototype.  You may have to create "
 174 "one, especially for C++ users."
 175 msgstr ""
 176
 177 #. type: Plain text
 178 #: build/C/man2/_syscall.2:124
 179 msgid ""
 180 "System calls are not required to return only positive or negative error "
 181 "codes.  You need to read the source to be sure how it will return errors.  "
 182 "Usually, it is the negative of a standard error code, for example, "
 183 "-I<EPERM>.  The _syscall() macros will return the result I<r> of the system "
 184 "call when I<r> is nonnegative, but will return -1 and set the variable "
 185 "I<errno> to -I<r> when I<r> is negative.  For the error codes, see "
 186 "B<errno>(3)."
 187 msgstr ""
 188
 189 #.  The preferred way to invoke system calls that glibc does not know
 190 #.  about yet is via
 191 #.  .BR syscall (2).
 192 #.  However, this mechanism can be used only if using a libc
 193 #.  (such as glibc) that supports
 194 #.  .BR syscall (2),
 195 #.  and if the
 196 #.  .I <sys/syscall.h>
 197 #.  header file contains the required SYS_foo definition.
 198 #.  Otherwise, the use of a _syscall macro is required.
 199 #. type: Plain text
 200 #: build/C/man2/_syscall.2:140
 201 msgid ""
 202 "When defining a system call, the argument types I<must> be passed by-value "
 203 "or by-pointer (for aggregates like structs)."
 204 msgstr ""
 205
 206 #. type: SH
 207 #: build/C/man2/_syscall.2:140 build/C/man2/chown.2:288 build/C/man3/confstr.3:129 build/C/man3/encrypt.3:150 build/C/man2/execve.2:544 build/C/man2/fork.2:239 build/C/man3/get_nprocs_conf.3:67 build/C/man3/getopt.3:376 build/C/man5/shells.5:45 build/C/man2/syscall.2:202 build/C/man2/sysctl.2:143
 208 #, no-wrap
 209 msgid "EXAMPLE"
 210 msgstr ""
 211
 212 #. type: Plain text
 213 #: build/C/man2/_syscall.2:147
 214 #, no-wrap
 215 msgid ""
 216 "#include E<lt>stdio.hE<gt>\n"
 217 "#include E<lt>stdlib.hE<gt>\n"
 218 "#include E<lt>errno.hE<gt>\n"
 219 "#include E<lt>linux/unistd.hE<gt>       /* for _syscallX macros/related "
 220 "stuff */\n"
 221 "#include E<lt>linux/kernel.hE<gt>       /* for struct sysinfo */\n"
 222 msgstr ""
 223
 224 #. type: Plain text
 225 #: build/C/man2/_syscall.2:149
 226 #, no-wrap
 227 msgid "_syscall1(int, sysinfo, struct sysinfo *, info);\n"
 228 msgstr ""
 229
 230 #. type: Plain text
 231 #: build/C/man2/_syscall.2:152
 232 #, no-wrap
 233 msgid ""
 234 "/* Note: if you copy directly from the nroff source, remember to\n"
 235 "REMOVE the extra backslashes in the printf statement. */\n"
 236 msgstr ""
 237
 238 #. type: Plain text
 239 #: build/C/man2/_syscall.2:158
 240 #, no-wrap
 241 msgid ""
 242 "int\n"
 243 "main(void)\n"
 244 "{\n"
 245 "    struct sysinfo s_info;\n"
 246 "    int error;\n"
 247 msgstr ""
 248
 249 #. type: Plain text
 250 #: build/C/man2/_syscall.2:173
 251 #, no-wrap
 252 msgid ""
 253 "    error = sysinfo(&s_info);\n"
 254 "    printf(\"code error = %d\\en\", error);\n"
 255 "    printf(\"Uptime = %lds\\enLoad: 1 min %lu / 5 min %lu / 15 min "
 256 "%lu\\en\"\n"
 257 "           \"RAM: total %lu / free %lu / shared %lu\\en\"\n"
 258 "           \"Memory in buffers = %lu\\enSwap: total %lu / free %lu\\en\"\n"
 259 "           \"Number of processes = %d\\en\",\n"
 260 "           s_info.uptime, s_info.loads[0],\n"
 261 "           s_info.loads[1], s_info.loads[2],\n"
 262 "           s_info.totalram, s_info.freeram,\n"
 263 "           s_info.sharedram, s_info.bufferram,\n"
 264 "           s_info.totalswap, s_info.freeswap,\n"
 265 "           s_info.procs);\n"
 266 "    exit(EXIT_SUCCESS);\n"
 267 "}\n"
 268 msgstr ""
 269
 270 #. type: SS
 271 #: build/C/man2/_syscall.2:174
 272 #, no-wrap
 273 msgid "Sample output"
 274 msgstr ""
 275
 276 #. type: Plain text
 277 #: build/C/man2/_syscall.2:183
 278 #, no-wrap
 279 msgid ""
 280 "code error = 0\n"
 281 "uptime = 502034s\n"
 282 "Load: 1 min 13376 / 5 min 5504 / 15 min 1152\n"
 283 "RAM: total 15343616 / free 827392 / shared 8237056\n"
 284 "Memory in buffers = 5066752\n"
 285 "Swap: total 27881472 / free 24698880\n"
 286 "Number of processes = 40\n"
 287 msgstr ""
 288
 289 #. type: SH
 290 #: build/C/man2/_syscall.2:184 build/C/man2/access.2:250 build/C/man2/alarm.2:79 build/C/man2/brk.2:164 build/C/man2/chdir.2:136 build/C/man2/chmod.2:221 build/C/man2/chown.2:336 build/C/man2/chroot.2:151 build/C/man2/close.2:125 build/C/man3/confstr.3:146 build/C/man3/crypt.3:238 build/C/man3/daemon.3:105 build/C/man3/des_crypt.3:137 build/C/man2/dup.2:207 build/C/man3/encrypt.3:174 build/C/man7/environ.7:241 build/C/man3/euidaccess.3:94 build/C/man3/exec.3:241 build/C/man2/execve.2:639 build/C/man2/exit_group.2:49 build/C/man2/fcntl.2:1297 build/C/man3/fexecve.3:106 build/C/man2/flock.2:201 build/C/man2/fork.2:244 build/C/man3/fpathconf.3:180 build/C/man2/fsync.2:162 build/C/man2/get_thread_area.2:55 build/C/man3/getcwd.3:249 build/C/man2/getdomainname.2:127 build/C/man3/getdtablesize.3:90 build/C/man3/gethostid.3:124 build/C/man2/gethostname.2:176 build/C/man3/getlogin.3:209 build/C/man3/getopt.3:514 build/C/man2/getpagesize.2:108 build/C/man2/gettid.2:71 build/C/man3/getumask.3:63 build/C/man3/getusershell.3:103 build/C/man2/ioctl.2:140 build/C/man2/ioctl_list.2:954 build/C/man2/ioperm.2:121 build/C/man3/lockf.3:156 build/C/man2/mincore.2:166 build/C/man2/mkdir.2:133 build/C/man2/nice.2:105 build/C/man2/pread.2:158 build/C/man2/set_thread_area.2:72 build/C/man5/shells.5:56 build/C/man3/sleep.3:61 build/C/man3/swab.3:74 build/C/man2/swapon.2:191 build/C/man2/syscall.2:218 build/C/man2/syscalls.2:833 build/C/man3/sysconf.3:335 build/C/man2/sysctl.2:181 build/C/man2/sysinfo.2:94 build/C/man3/tcgetpgrp.3:120 build/C/man2/truncate.2:256 build/C/man3/ualarm.3:142 build/C/man2/umask.2:118 build/C/man2/uname.2:167 build/C/man2/uselib.2:102 build/C/man3/usleep.3:142 build/C/man2/vfork.2:273 build/C/man2/vhangup.2:66
 291 #, no-wrap
 292 msgid "SEE ALSO"
 293 msgstr ""
 294
 295 #. type: Plain text
 296 #: build/C/man2/_syscall.2:188
 297 msgid "B<intro>(2), B<syscall>(2), B<errno>(3)"
 298 msgstr ""
 299
 300 #. type: SH
 301 #: build/C/man2/_syscall.2:188 build/C/man2/access.2:261 build/C/man2/alarm.2:88 build/C/man2/brk.2:169 build/C/man2/chdir.2:140 build/C/man2/chmod.2:228 build/C/man2/chown.2:342 build/C/man2/chroot.2:154 build/C/man2/close.2:132 build/C/man3/confstr.3:150 build/C/man3/crypt.3:244 build/C/man3/daemon.3:108 build/C/man3/des_crypt.3:141 build/C/man2/dup.2:211 build/C/man3/encrypt.3:179 build/C/man7/environ.7:255 build/C/man3/euidaccess.3:105 build/C/man3/exec.3:248 build/C/man2/execve.2:650 build/C/man2/exit_group.2:51 build/C/man2/fcntl.2:1318 build/C/man3/fexecve.3:108 build/C/man2/flock.2:215 build/C/man2/fork.2:255 build/C/man3/fpathconf.3:185 build/C/man2/fsync.2:171 build/C/man3/get_nprocs_conf.3:88 build/C/man2/get_thread_area.2:58 build/C/man3/getcwd.3:256 build/C/man2/getdomainname.2:131 build/C/man3/getdtablesize.3:95 build/C/man3/gethostid.3:127 build/C/man2/gethostname.2:180 build/C/man3/getlogin.3:213 build/C/man3/getopt.3:516 build/C/man2/getpagesize.2:111 build/C/man2/gettid.2:90 build/C/man3/getumask.3:65 build/C/man3/getusershell.3:105 build/C/man2/idle.2:64 build/C/man2/ioctl.2:148 build/C/man2/ioctl_list.2:956 build/C/man2/ioperm.2:125 build/C/man3/lockf.3:171 build/C/man2/mincore.2:169 build/C/man2/mkdir.2:145 build/C/man2/nice.2:112 build/C/man2/pread.2:163 build/C/man2/set_thread_area.2:74 build/C/man2/setup.2:72 build/C/man5/shells.5:59 build/C/man3/sleep.3:66 build/C/man3/swab.3:76 build/C/man2/swapon.2:195 build/C/man2/syscall.2:222 build/C/man2/syscalls.2:837 build/C/man3/sysconf.3:343 build/C/man2/sysctl.2:183 build/C/man2/sysinfo.2:96 build/C/man3/tcgetpgrp.3:124 build/C/man2/truncate.2:260 build/C/man3/ualarm.3:150 build/C/man2/umask.2:124 build/C/man2/uname.2:171 build/C/man2/uselib.2:112 build/C/man3/usleep.3:151 build/C/man2/vfork.2:279 build/C/man2/vhangup.2:69
 302 #, no-wrap
 303 msgid "COLOPHON"
 304 msgstr ""
 305
 306 #. type: Plain text
 307 #: build/C/man2/_syscall.2:195 build/C/man2/access.2:268 build/C/man2/alarm.2:95 build/C/man2/brk.2:176 build/C/man2/chdir.2:147 build/C/man2/chmod.2:235 build/C/man2/chown.2:349 build/C/man2/chroot.2:161 build/C/man2/close.2:139 build/C/man3/confstr.3:157 build/C/man3/crypt.3:251 build/C/man3/daemon.3:115 build/C/man3/des_crypt.3:148 build/C/man2/dup.2:218 build/C/man3/encrypt.3:186 build/C/man7/environ.7:262 build/C/man3/euidaccess.3:112 build/C/man3/exec.3:255 build/C/man2/execve.2:657 build/C/man2/exit_group.2:58 build/C/man2/fcntl.2:1325 build/C/man3/fexecve.3:115 build/C/man2/flock.2:222 build/C/man2/fork.2:262 build/C/man3/fpathconf.3:192 build/C/man2/fsync.2:178 build/C/man3/get_nprocs_conf.3:95 build/C/man2/get_thread_area.2:65 build/C/man3/getcwd.3:263 build/C/man2/getdomainname.2:138 build/C/man3/getdtablesize.3:102 build/C/man3/gethostid.3:134 build/C/man2/gethostname.2:187 build/C/man3/getlogin.3:220 build/C/man3/getopt.3:523 build/C/man2/getpagesize.2:118 build/C/man2/gettid.2:97 build/C/man3/getumask.3:72 build/C/man3/getusershell.3:112 build/C/man2/idle.2:71 build/C/man2/ioctl.2:155 build/C/man2/ioctl_list.2:963 build/C/man2/ioperm.2:132 build/C/man3/lockf.3:178 build/C/man2/mincore.2:176 build/C/man2/mkdir.2:152 build/C/man2/nice.2:119 build/C/man2/pread.2:170 build/C/man2/set_thread_area.2:81 build/C/man2/setup.2:79 build/C/man5/shells.5:66 build/C/man3/sleep.3:73 build/C/man3/swab.3:83 build/C/man2/swapon.2:202 build/C/man2/syscall.2:229 build/C/man2/syscalls.2:844 build/C/man3/sysconf.3:350 build/C/man2/sysctl.2:190 build/C/man2/sysinfo.2:103 build/C/man3/tcgetpgrp.3:131 build/C/man2/truncate.2:267 build/C/man3/ualarm.3:157 build/C/man2/umask.2:131 build/C/man2/uname.2:178 build/C/man2/uselib.2:119 build/C/man3/usleep.3:158 build/C/man2/vfork.2:286 build/C/man2/vhangup.2:76
 308 msgid ""
 309 "This page is part of release 3.53 of the Linux I<man-pages> project.  A "
 310 "description of the project, and information about reporting bugs, can be "
 311 "found at \\%http://www.kernel.org/doc/man-pages/."
 312 msgstr ""
 313
 314 #. type: TH
 315 #: build/C/man2/access.2:43
 316 #, no-wrap
 317 msgid "ACCESS"
 318 msgstr ""
 319
 320 #. type: TH
 321 #: build/C/man2/access.2:43
 322 #, no-wrap
 323 msgid "2013-04-16"
 324 msgstr ""
 325
 326 #. type: Plain text
 327 #: build/C/man2/access.2:46
 328 msgid "access - check real user's permissions for a file"
 329 msgstr ""
 330
 331 #. type: Plain text
 332 #: build/C/man2/access.2:49 build/C/man2/alarm.2:36 build/C/man2/close.2:41 build/C/man3/confstr.3:37 build/C/man3/crypt.3:44 build/C/man2/dup.2:42 build/C/man3/fexecve.3:31 build/C/man3/fpathconf.3:47 build/C/man3/getcwd.3:38 build/C/man3/getopt.3:48 build/C/man3/getusershell.3:36 build/C/man3/sleep.3:32 build/C/man3/sysconf.3:33 build/C/man2/sysctl.2:36 build/C/man3/ualarm.3:30 build/C/man3/usleep.3:39
 333 #, no-wrap
 334 msgid "B<#include E<lt>unistd.hE<gt>>\n"
 335 msgstr ""
 336
 337 #. type: Plain text
 338 #: build/C/man2/access.2:51
 339 #, no-wrap
 340 msgid "B<int access(const char *>I<pathname>B<, int >I<mode>B<);>\n"
 341 msgstr ""
 342
 343 #. type: Plain text
 344 #: build/C/man2/access.2:59
 345 msgid ""
 346 "B<access>()  checks whether the calling process can access the file "
 347 "I<pathname>.  If I<pathname> is a symbolic link, it is dereferenced."
 348 msgstr ""
 349
 350 #.  F_OK is defined as 0 on every system that I know of.
 351 #. type: Plain text
 352 #: build/C/man2/access.2:73
 353 msgid ""
 354 "The I<mode> specifies the accessibility check(s) to be performed, and is "
 355 "either the value B<F_OK>, or a mask consisting of the bitwise OR of one or "
 356 "more of B<R_OK>, B<W_OK>, and B<X_OK>.  B<F_OK> tests for the existence of "
 357 "the file.  B<R_OK>, B<W_OK>, and B<X_OK> test whether the file exists and "
 358 "grants read, write, and execute permissions, respectively."
 359 msgstr ""
 360
 361 #. type: Plain text
 362 #: build/C/man2/access.2:82
 363 msgid ""
 364 "The check is done using the calling process's I<real> UID and GID, rather "
 365 "than the effective IDs as is done when actually attempting an operation "
 366 "(e.g., B<open>(2))  on the file.  This allows set-user-ID programs to easily "
 367 "determine the invoking user's authority."
 368 msgstr ""
 369
 370 #. type: Plain text
 371 #: build/C/man2/access.2:88
 372 msgid ""
 373 "If the calling process is privileged (i.e., its real UID is zero), then an "
 374 "B<X_OK> check is successful for a regular file if execute permission is "
 375 "enabled for any of the file owner, group, or other."
 376 msgstr ""
 377
 378 #. type: SH
 379 #: build/C/man2/access.2:88 build/C/man2/alarm.2:54 build/C/man2/brk.2:93 build/C/man2/chdir.2:70 build/C/man2/chmod.2:153 build/C/man2/chown.2:119 build/C/man2/chroot.2:90 build/C/man2/close.2:64 build/C/man3/confstr.3:94 build/C/man3/crypt.3:120 build/C/man3/daemon.3:73 build/C/man3/des_crypt.3:106 build/C/man2/dup.2:120 build/C/man3/encrypt.3:113 build/C/man3/euidaccess.3:58 build/C/man3/exec.3:183 build/C/man2/execve.2:355 build/C/man2/exit_group.2:39 build/C/man2/fcntl.2:1051 build/C/man3/fexecve.3:67 build/C/man2/flock.2:111 build/C/man2/fork.2:173 build/C/man3/fpathconf.3:160 build/C/man2/fsync.2:108 build/C/man3/get_nprocs_conf.3:46 build/C/man2/get_thread_area.2:29 build/C/man3/getcwd.3:156 build/C/man2/getdomainname.2:75 build/C/man3/getdtablesize.3:61 build/C/man3/gethostid.3:71 build/C/man2/gethostname.2:89 build/C/man3/getlogin.3:95 build/C/man3/getopt.3:274 build/C/man2/gettid.2:50 build/C/man3/getusershell.3:85 build/C/man2/idle.2:52 build/C/man2/ioctl.2:83 build/C/man2/ioctl_list.2:107 build/C/man2/ioperm.2:82 build/C/man3/lockf.3:116 build/C/man2/mincore.2:94 build/C/man2/mkdir.2:48 build/C/man2/nice.2:56 build/C/man2/pread.2:79 build/C/man2/set_thread_area.2:44 build/C/man2/setup.2:53 build/C/man3/sleep.3:40 build/C/man3/swab.3:68 build/C/man2/swapon.2:108 build/C/man2/syscall.2:72 build/C/man3/sysconf.3:311 build/C/man2/sysctl.2:74 build/C/man2/sysinfo.2:74 build/C/man3/tcgetpgrp.3:64 build/C/man2/truncate.2:110 build/C/man3/ualarm.3:81 build/C/man2/umask.2:92 build/C/man2/uname.2:63 build/C/man2/uselib.2:48 build/C/man3/usleep.3:75 build/C/man2/vhangup.2:50
 380 #, no-wrap
 381 msgid "RETURN VALUE"
 382 msgstr ""
 383
 384 #. type: Plain text
 385 #: build/C/man2/access.2:104
 386 msgid ""
 387 "On success (all requested permissions granted, or I<mode> is B<F_OK> and the "
 388 "file exists), zero is returned.  On error (at least one bit in I<mode> asked "
 389 "for a permission that is denied, or I<mode> is B<F_OK> and the file does not "
 390 "exist, or some other error occurred), -1 is returned, and I<errno> is set "
 391 "appropriately."
 392 msgstr ""
 393
 394 #. type: SH
 395 #: build/C/man2/access.2:104 build/C/man2/chdir.2:75 build/C/man2/chmod.2:158 build/C/man2/chown.2:124 build/C/man2/chroot.2:95 build/C/man2/close.2:70 build/C/man3/confstr.3:121 build/C/man3/crypt.3:123 build/C/man2/dup.2:126 build/C/man3/encrypt.3:115 build/C/man3/euidaccess.3:66 build/C/man3/exec.3:190 build/C/man2/execve.2:361 build/C/man2/fcntl.2:1084 build/C/man3/fexecve.3:74 build/C/man2/flock.2:116 build/C/man2/fork.2:180 build/C/man2/fsync.2:113 build/C/man2/get_thread_area.2:35 build/C/man3/getcwd.3:172 build/C/man2/getdomainname.2:80 build/C/man3/getdtablesize.3:63 build/C/man3/gethostid.3:81 build/C/man2/gethostname.2:94 build/C/man3/getlogin.3:103 build/C/man2/gettid.2:52 build/C/man2/idle.2:55 build/C/man2/ioctl.2:92 build/C/man2/ioperm.2:87 build/C/man3/lockf.3:121 build/C/man2/mincore.2:101 build/C/man2/mkdir.2:53 build/C/man2/nice.2:61 build/C/man2/pread.2:89 build/C/man2/set_thread_area.2:49 build/C/man2/setup.2:56 build/C/man2/swapon.2:113 build/C/man2/sysctl.2:81 build/C/man2/sysinfo.2:79 build/C/man3/tcgetpgrp.3:86 build/C/man2/truncate.2:115 build/C/man3/ualarm.3:84 build/C/man2/uname.2:68 build/C/man2/uselib.2:53 build/C/man3/usleep.3:82 build/C/man2/vhangup.2:55
 396 #, no-wrap
 397 msgid "ERRORS"
 398 msgstr ""
 399
 400 #. type: Plain text
 401 #: build/C/man2/access.2:107
 402 msgid "B<access>()  shall fail if:"
 403 msgstr ""
 404
 405 #. type: TP
 406 #: build/C/man2/access.2:107 build/C/man2/chdir.2:81 build/C/man2/chdir.2:117 build/C/man2/chmod.2:163 build/C/man2/chown.2:129 build/C/man2/chroot.2:98 build/C/man2/execve.2:369 build/C/man2/execve.2:376 build/C/man2/execve.2:379 build/C/man2/execve.2:382 build/C/man3/getcwd.3:173 build/C/man3/gethostid.3:84 build/C/man2/mkdir.2:54 build/C/man2/truncate.2:118 build/C/man2/uselib.2:59
 407 #, no-wrap
 408 msgid "B<EACCES>"
 409 msgstr ""
 410
 411 #. type: Plain text
 412 #: build/C/man2/access.2:114
 413 msgid ""
 414 "The requested access would be denied to the file, or search permission is "
 415 "denied for one of the directories in the path prefix of I<pathname>.  (See "
 416 "also B<path_resolution>(7).)"
 417 msgstr ""
 418
 419 #. type: TP
 420 #: build/C/man2/access.2:114 build/C/man2/chdir.2:94 build/C/man2/chmod.2:175 build/C/man2/chown.2:138 build/C/man2/chroot.2:112 build/C/man2/execve.2:403 build/C/man2/mkdir.2:76 build/C/man2/truncate.2:151
 421 #, no-wrap
 422 msgid "B<ELOOP>"
 423 msgstr ""
 424
 425 #. type: Plain text
 426 #: build/C/man2/access.2:118 build/C/man2/mkdir.2:80
 427 msgid "Too many symbolic links were encountered in resolving I<pathname>."
 428 msgstr ""
 429
 430 #. type: TP
 431 #: build/C/man2/access.2:118 build/C/man2/chdir.2:98 build/C/man2/chmod.2:179 build/C/man2/chown.2:142 build/C/man2/chroot.2:116 build/C/man2/execve.2:411 build/C/man2/gethostname.2:109 build/C/man2/mkdir.2:84 build/C/man2/truncate.2:154
 432 #, no-wrap
 433 msgid "B<ENAMETOOLONG>"
 434 msgstr ""
 435
 436 #. type: Plain text
 437 #: build/C/man2/access.2:122
 438 msgid "I<pathname> is too long."
 439 msgstr ""
 440
 441 #. type: TP
 442 #: build/C/man2/access.2:122 build/C/man2/chdir.2:102 build/C/man2/chmod.2:183 build/C/man2/chown.2:146 build/C/man2/chown.2:172 build/C/man2/chroot.2:120 build/C/man2/execve.2:418 build/C/man3/getcwd.3:198 build/C/man3/getlogin.3:122 build/C/man2/mkdir.2:87 build/C/man2/swapon.2:136 build/C/man2/truncate.2:158
 443 #, no-wrap
 444 msgid "B<ENOENT>"
 445 msgstr ""
 446
 447 #. type: Plain text
 448 #: build/C/man2/access.2:127
 449 msgid "A component of I<pathname> does not exist or is a dangling symbolic link."
 450 msgstr ""
 451
 452 #. type: TP
 453 #: build/C/man2/access.2:127 build/C/man2/chdir.2:108 build/C/man2/chmod.2:189 build/C/man2/chown.2:152 build/C/man2/chroot.2:126 build/C/man2/execve.2:432 build/C/man2/mkdir.2:104 build/C/man2/sysctl.2:88 build/C/man2/truncate.2:161
 454 #, no-wrap
 455 msgid "B<ENOTDIR>"
 456 msgstr ""
 457
 458 #. type: Plain text
 459 #: build/C/man2/access.2:132 build/C/man2/mkdir.2:109
 460 msgid "A component used as a directory in I<pathname> is not, in fact, a directory."
 461 msgstr ""
 462
 463 #. type: TP
 464 #: build/C/man2/access.2:132 build/C/man2/chmod.2:198 build/C/man2/chmod.2:216 build/C/man2/chown.2:159 build/C/man2/chown.2:178 build/C/man2/mkdir.2:114 build/C/man2/truncate.2:170
 465 #, no-wrap
 466 msgid "B<EROFS>"
 467 msgstr ""
 468
 469 #. type: Plain text
 470 #: build/C/man2/access.2:135
 471 msgid "Write permission was requested for a file on a read-only file system."
 472 msgstr ""
 473
 474 #. type: Plain text
 475 #: build/C/man2/access.2:138
 476 msgid "B<access>()  may fail if:"
 477 msgstr ""
 478
 479 #. type: TP
 480 #: build/C/man2/access.2:138 build/C/man2/chdir.2:87 build/C/man2/chmod.2:168 build/C/man2/chown.2:134 build/C/man2/chroot.2:105 build/C/man2/execve.2:386 build/C/man2/fcntl.2:1106 build/C/man2/get_thread_area.2:36 build/C/man3/getcwd.3:176 build/C/man2/getdomainname.2:83 build/C/man2/gethostname.2:95 build/C/man2/ioctl.2:97 build/C/man2/mincore.2:104 build/C/man2/mkdir.2:73 build/C/man2/set_thread_area.2:53 build/C/man2/sysctl.2:82 build/C/man2/sysinfo.2:80 build/C/man2/truncate.2:124 build/C/man2/uname.2:69
 481 #, no-wrap
 482 msgid "B<EFAULT>"
 483 msgstr ""
 484
 485 #. type: Plain text
 486 #: build/C/man2/access.2:142 build/C/man2/mkdir.2:76
 487 msgid "I<pathname> points outside your accessible address space."
 488 msgstr ""
 489
 490 #. type: TP
 491 #: build/C/man2/access.2:142 build/C/man3/confstr.3:122 build/C/man2/dup.2:151 build/C/man2/execve.2:390 build/C/man2/fcntl.2:1122 build/C/man3/fexecve.3:78 build/C/man2/flock.2:126 build/C/man2/get_thread_area.2:39 build/C/man3/getcwd.3:180 build/C/man2/getdomainname.2:87 build/C/man2/getdomainname.2:99 build/C/man2/gethostname.2:99 build/C/man2/ioctl.2:101 build/C/man2/ioperm.2:88 build/C/man3/lockf.3:147 build/C/man2/mincore.2:108 build/C/man2/set_thread_area.2:50 build/C/man2/swapon.2:121 build/C/man3/tcgetpgrp.3:91 build/C/man2/truncate.2:140 build/C/man2/truncate.2:191 build/C/man3/ualarm.3:88 build/C/man3/usleep.3:87
 492 #, no-wrap
 493 msgid "B<EINVAL>"
 494 msgstr ""
 495
 496 #. type: Plain text
 497 #: build/C/man2/access.2:146
 498 msgid "I<mode> was incorrectly specified."
 499 msgstr ""
 500
 501 #. type: TP
 502 #: build/C/man2/access.2:146 build/C/man2/chdir.2:91 build/C/man2/chmod.2:172 build/C/man2/chmod.2:210 build/C/man2/chown.2:169 build/C/man2/chroot.2:109 build/C/man2/close.2:81 build/C/man2/execve.2:394 build/C/man2/fsync.2:118 build/C/man2/ioperm.2:94 build/C/man2/truncate.2:145
 503 #, no-wrap
 504 msgid "B<EIO>"
 505 msgstr ""
 506
 507 #. type: Plain text
 508 #: build/C/man2/access.2:149 build/C/man2/chdir.2:94 build/C/man2/chmod.2:175 build/C/man2/chroot.2:112 build/C/man2/close.2:84 build/C/man2/execve.2:397
 509 msgid "An I/O error occurred."
 510 msgstr ""
 511
 512 #. type: TP
 513 #: build/C/man2/access.2:149 build/C/man2/chdir.2:105 build/C/man2/chmod.2:186 build/C/man2/chown.2:149 build/C/man2/chroot.2:123 build/C/man2/execve.2:429 build/C/man2/fork.2:196 build/C/man3/getlogin.3:125 build/C/man2/ioperm.2:97 build/C/man2/mincore.2:112 build/C/man2/mincore.2:124 build/C/man2/mkdir.2:92 build/C/man2/swapon.2:141
 514 #, no-wrap
 515 msgid "B<ENOMEM>"
 516 msgstr ""
 517
 518 #. type: Plain text
 519 #: build/C/man2/access.2:152 build/C/man2/chdir.2:108 build/C/man2/chmod.2:189 build/C/man2/chown.2:152 build/C/man2/chroot.2:126 build/C/man2/execve.2:432 build/C/man2/mkdir.2:95
 520 msgid "Insufficient kernel memory was available."
 521 msgstr ""
 522
 523 #. type: TP
 524 #: build/C/man2/access.2:152 build/C/man2/execve.2:447 build/C/man2/truncate.2:173
 525 #, no-wrap
 526 msgid "B<ETXTBSY>"
 527 msgstr ""
 528
 529 #. type: Plain text
 530 #: build/C/man2/access.2:156
 531 msgid "Write access was requested to an executable which is being executed."
 532 msgstr ""
 533
 534 #. type: Plain text
 535 #: build/C/man2/access.2:158 build/C/man2/close.2:87 build/C/man2/fork.2:208 build/C/man3/swab.3:74 build/C/man2/umask.2:97
 536 msgid "SVr4, 4.3BSD, POSIX.1-2001."
 537 msgstr ""
 538
 539 #. type: Plain text
 540 #: build/C/man2/access.2:173
 541 msgid ""
 542 "B<Warning>: Using B<access>()  to check if a user is authorized to, for "
 543 "example, open a file before actually doing so using B<open>(2)  creates a "
 544 "security hole, because the user might exploit the short time interval "
 545 "between checking and opening the file to manipulate it.  B<For this reason, "
 546 "the use of this system call should be avoided>.  (In the example just "
 547 "described, a safer alternative would be to temporarily switch the process's "
 548 "effective user ID to the real ID and then call B<open>(2).)"
 549 msgstr ""
 550
 551 #. type: Plain text
 552 #: build/C/man2/access.2:180
 553 msgid ""
 554 "B<access>()  always dereferences symbolic links.  If you need to check the "
 555 "permissions on a symbolic link, use B<faccessat>(2)  with the flag "
 556 "B<AT_SYMLINK_NOFOLLOW>."
 557 msgstr ""
 558
 559 #. type: Plain text
 560 #: build/C/man2/access.2:187
 561 msgid ""
 562 "B<access>()  returns an error if any of the access types in I<mode> is "
 563 "denied, even if some of the other access types in I<mode> are permitted."
 564 msgstr ""
 565
 566 #.  HPU-UX 11 and Tru64 5.1 do this.
 567 #. type: Plain text
 568 #: build/C/man2/access.2:194
 569 msgid ""
 570 "If the calling process has appropriate privileges (i.e., is superuser), "
 571 "POSIX.1-2001 permits an implementation to indicate success for an B<X_OK> "
 572 "check even if none of the execute file permission bits are set.  Linux does "
 573 "not do this."
 574 msgstr ""
 575
 576 #. type: Plain text
 577 #: build/C/man2/access.2:202
 578 msgid ""
 579 "A file is accessible only if the permissions on each of the directories in "
 580 "the path prefix of I<pathname> grant search (i.e., execute) access.  If any "
 581 "directory is inaccessible, then the B<access>()  call will fail, regardless "
 582 "of the permissions on the file itself."
 583 msgstr ""
 584
 585 #. type: Plain text
 586 #: build/C/man2/access.2:210
 587 msgid ""
 588 "Only access bits are checked, not the file type or contents.  Therefore, if "
 589 "a directory is found to be writable, it probably means that files can be "
 590 "created in the directory, and not that the directory can be written as a "
 591 "file.  Similarly, a DOS file may be found to be \"executable,\" but the "
 592 "B<execve>(2)  call will still fail."
 593 msgstr ""
 594
 595 #. type: Plain text
 596 #: build/C/man2/access.2:216
 597 msgid ""
 598 "B<access>()  may not work correctly on NFS file systems with UID mapping "
 599 "enabled, because UID mapping is done on the server and hidden from the "
 600 "client, which checks permissions.  Similar problems can occur to FUSE "
 601 "mounts."
 602 msgstr ""
 603
 604 #. type: SH
 605 #: build/C/man2/access.2:216 build/C/man7/environ.7:203 build/C/man2/fcntl.2:1239 build/C/man3/gethostid.3:122 build/C/man3/getlogin.3:177 build/C/man3/getopt.3:369 build/C/man2/mincore.2:144 build/C/man2/pread.2:146 build/C/man3/sleep.3:46 build/C/man3/sysconf.3:326 build/C/man2/sysctl.2:135 build/C/man2/truncate.2:248 build/C/man2/vfork.2:252
 606 #, no-wrap
 607 msgid "BUGS"
 608 msgstr ""
 609
 610 #.  This behavior appears to have been an implementation accident.
 611 #. type: Plain text
 612 #: build/C/man2/access.2:239
 613 msgid ""
 614 "In kernel 2.4 (and earlier) there is some strangeness in the handling of "
 615 "B<X_OK> tests for superuser.  If all categories of execute permission are "
 616 "disabled for a nondirectory file, then the only B<access>()  test that "
 617 "returns -1 is when I<mode> is specified as just B<X_OK>; if B<R_OK> or "
 618 "B<W_OK> is also specified in I<mode>, then B<access>()  returns 0 for such "
 619 "files.  Early 2.6 kernels (up to and including 2.6.3)  also behaved in the "
 620 "same way as kernel 2.4."
 621 msgstr ""
 622
 623 #. type: Plain text
 624 #: build/C/man2/access.2:250
 625 msgid ""
 626 "In kernels before 2.6.20, B<access>()  ignored the effect of the "
 627 "B<MS_NOEXEC> flag if it was used to B<mount>(2)  the underlying file "
 628 "system.  Since kernel 2.6.20, B<access>()  honors this flag."
 629 msgstr ""
 630
 631 #. type: Plain text
 632 #: build/C/man2/access.2:261
 633 msgid ""
 634 "B<chmod>(2), B<chown>(2), B<faccessat>(2), B<open>(2), B<setgid>(2), "
 635 "B<setuid>(2), B<stat>(2), B<euidaccess>(3), B<credentials>(7), "
 636 "B<path_resolution>(7)"
 637 msgstr ""
 638
 639 #. type: TH
 640 #: build/C/man2/alarm.2:30
 641 #, no-wrap
 642 msgid "ALARM"
 643 msgstr ""
 644
 645 #. type: TH
 646 #: build/C/man2/alarm.2:30 build/C/man3/ualarm.3:24
 647 #, no-wrap
 648 msgid "2013-04-18"
 649 msgstr ""
 650
 651 #. type: Plain text
 652 #: build/C/man2/alarm.2:33
 653 msgid "alarm - set an alarm clock for delivery of a signal"
 654 msgstr ""
 655
 656 #. type: Plain text
 657 #: build/C/man2/alarm.2:38
 658 #, no-wrap
 659 msgid "B<unsigned int alarm(unsigned int >I<seconds>B<);>\n"
 660 msgstr ""
 661
 662 #. type: Plain text
 663 #: build/C/man2/alarm.2:46
 664 msgid ""
 665 "B<alarm>()  arranges for a B<SIGALRM> signal to be delivered to the calling "
 666 "process in I<seconds> seconds."
 667 msgstr ""
 668
 669 #. type: Plain text
 670 #: build/C/man2/alarm.2:50
 671 msgid "If I<seconds> is zero, any pending alarm is canceled."
 672 msgstr ""
 673
 674 #. type: Plain text
 675 #: build/C/man2/alarm.2:54
 676 msgid "In any event any previously set B<alarm>()  is canceled."
 677 msgstr ""
 678
 679 #. type: Plain text
 680 #: build/C/man2/alarm.2:59
 681 msgid ""
 682 "B<alarm>()  returns the number of seconds remaining until any previously "
 683 "scheduled alarm was due to be delivered, or zero if there was no previously "
 684 "scheduled alarm."
 685 msgstr ""
 686
 687 #. type: Plain text
 688 #: build/C/man2/alarm.2:61
 689 msgid "SVr4, POSIX.1-2001, 4.3BSD."
 690 msgstr ""
 691
 692 #. type: Plain text
 693 #: build/C/man2/alarm.2:67
 694 msgid ""
 695 "B<alarm>()  and B<setitimer>(2)  share the same timer; calls to one will "
 696 "interfere with use of the other."
 697 msgstr ""
 698
 699 #. type: Plain text
 700 #: build/C/man2/alarm.2:76
 701 msgid ""
 702 "B<sleep>(3)  may be implemented using B<SIGALRM>; mixing calls to B<alarm>()  "
 703 "and B<sleep>(3)  is a bad idea."
 704 msgstr ""
 705
 706 #. type: Plain text
 707 #: build/C/man2/alarm.2:79
 708 msgid ""
 709 "Scheduling delays can, as ever, cause the execution of the process to be "
 710 "delayed by an arbitrary amount of time."
 711 msgstr ""
 712
 713 #. type: Plain text
 714 #: build/C/man2/alarm.2:88
 715 msgid ""
 716 "B<gettimeofday>(2), B<pause>(2), B<select>(2), B<setitimer>(2), "
 717 "B<sigaction>(2), B<signal>(2), B<sleep>(3), B<time>(7)"
 718 msgstr ""
 719
 720 #. type: TH
 721 #: build/C/man2/brk.2:29
 722 #, no-wrap
 723 msgid "BRK"
 724 msgstr ""
 725
 726 #. type: TH
 727 #: build/C/man2/brk.2:29 build/C/man2/chroot.2:33 build/C/man3/getcwd.3:32 build/C/man3/gethostid.3:29
 728 #, no-wrap
 729 msgid "2010-09-20"
 730 msgstr ""
 731
 732 #. type: Plain text
 733 #: build/C/man2/brk.2:32
 734 msgid "brk, sbrk - change data segment size"
 735 msgstr ""
 736
 737 #. type: Plain text
 738 #: build/C/man2/brk.2:34 build/C/man2/chdir.2:38 build/C/man2/chown.2:43 build/C/man2/chroot.2:38 build/C/man3/daemon.3:41 build/C/man3/encrypt.3:37 build/C/man3/exec.3:46 build/C/man2/execve.2:42 build/C/man2/fork.2:44 build/C/man2/fsync.2:43 build/C/man2/getdomainname.2:34 build/C/man3/getdtablesize.3:32 build/C/man3/gethostid.3:34 build/C/man2/gethostname.2:37 build/C/man3/getlogin.3:33 build/C/man2/getpagesize.2:30 build/C/man2/idle.2:37 build/C/man3/lockf.3:33 build/C/man2/mincore.2:39 build/C/man2/nice.2:36 build/C/man2/pread.2:30 build/C/man2/setup.2:39 build/C/man2/swapon.2:42 build/C/man3/tcgetpgrp.3:30 build/C/man2/truncate.2:48 build/C/man2/uselib.2:36 build/C/man2/vfork.2:35 build/C/man2/vhangup.2:33
 739 msgid "B<#include E<lt>unistd.hE<gt>>"
 740 msgstr ""
 741
 742 #. type: Plain text
 743 #: build/C/man2/brk.2:36
 744 msgid "B<int brk(void *>I<addr>B<);>"
 745 msgstr ""
 746
 747 #. type: Plain text
 748 #: build/C/man2/brk.2:38
 749 msgid "B<void *sbrk(intptr_t >I<increment>B<);>"
 750 msgstr ""
 751
 752 #. type: Plain text
 753 #: build/C/man2/brk.2:42 build/C/man2/chdir.2:46 build/C/man2/chmod.2:44 build/C/man2/chown.2:53 build/C/man2/chroot.2:44 build/C/man3/confstr.3:44 build/C/man3/daemon.3:47 build/C/man3/exec.3:68 build/C/man3/fexecve.3:38 build/C/man2/fsync.2:51 build/C/man3/getcwd.3:49 build/C/man2/getdomainname.2:42 build/C/man3/getdtablesize.3:38 build/C/man3/gethostid.3:42 build/C/man2/gethostname.2:45 build/C/man3/getlogin.3:45 build/C/man3/getopt.3:69 build/C/man2/getpagesize.2:36 build/C/man3/getusershell.3:47 build/C/man3/lockf.3:39 build/C/man2/mincore.2:47 build/C/man2/nice.2:42 build/C/man2/pread.2:40 build/C/man2/truncate.2:58 build/C/man3/ualarm.3:37 build/C/man3/usleep.3:46 build/C/man2/vfork.2:41 build/C/man2/vhangup.2:39
 754 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
 755 msgstr ""
 756
 757 #. type: Plain text
 758 #: build/C/man2/brk.2:46
 759 msgid "B<brk>(), B<sbrk>():"
 760 msgstr ""
 761
 762 #. type: TP
 763 #: build/C/man2/brk.2:49 build/C/man3/getcwd.3:60 build/C/man3/getdtablesize.3:44 build/C/man2/getpagesize.2:42 build/C/man3/ualarm.3:43 build/C/man3/usleep.3:52 build/C/man2/vfork.2:47
 764 #, no-wrap
 765 msgid "Since glibc 2.12:"
 766 msgstr ""
 767
 768 #. type: Plain text
 769 #: build/C/man2/brk.2:56
 770 #, no-wrap
 771 msgid ""
 772 "_BSD_SOURCE || _SVID_SOURCE ||\n"
 773 "    (_XOPEN_SOURCE\\ E<gt>=\\ 500 ||\n"
 774 "        _XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED) &&\n"
 775 "    !(_POSIX_C_SOURCE\\ E<gt>=\\ 200112L || _XOPEN_SOURCE\\ E<gt>=\\ 600)\n"
 776 msgstr ""
 777
 778 #. type: Plain text
 779 #: build/C/man2/brk.2:61
 780 msgid ""
 781 "Before glibc 2.12: _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ "
 782 "500 || _XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
 783 msgstr ""
 784
 785 #. type: Plain text
 786 #: build/C/man2/brk.2:76
 787 msgid ""
 788 "B<brk>()  and B<sbrk>()  change the location of the I<program break>, which "
 789 "defines the end of the process's data segment (i.e., the program break is "
 790 "the first location after the end of the uninitialized data segment).  "
 791 "Increasing the program break has the effect of allocating memory to the "
 792 "process; decreasing the break deallocates memory."
 793 msgstr ""
 794
 795 #. type: Plain text
 796 #: build/C/man2/brk.2:83
 797 msgid ""
 798 "B<brk>()  sets the end of the data segment to the value specified by "
 799 "I<addr>, when that value is reasonable, the system has enough memory, and "
 800 "the process does not exceed its maximum data size (see B<setrlimit>(2))."
 801 msgstr ""
 802
 803 #. type: Plain text
 804 #: build/C/man2/brk.2:93
 805 msgid ""
 806 "B<sbrk>()  increments the program's data space by I<increment> bytes.  "
 807 "Calling B<sbrk>()  with an I<increment> of 0 can be used to find the current "
 808 "location of the program break."
 809 msgstr ""
 810
 811 #. type: Plain text
 812 #: build/C/man2/brk.2:102
 813 msgid ""
 814 "On success, B<brk>()  returns zero.  On error, -1 is returned, and I<errno> "
 815 "is set to B<ENOMEM>.  (But see I<Linux Notes> below.)"
 816 msgstr ""
 817
 818 #. type: Plain text
 819 #: build/C/man2/brk.2:114
 820 msgid ""
 821 "On success, B<sbrk>()  returns the previous program break.  (If the break "
 822 "was increased, then this value is a pointer to the start of the newly "
 823 "allocated memory).  On error, I<(void\\ *)\\ -1> is returned, and I<errno> "
 824 "is set to B<ENOMEM>."
 825 msgstr ""
 826
 827 #
 828 #.  .BR brk ()
 829 #.  and
 830 #.  .BR sbrk ()
 831 #.  are not defined in the C Standard and are deliberately excluded from the
 832 #.  POSIX.1-1990 standard (see paragraphs B.1.1.1.3 and B.8.3.3).
 833 #. type: Plain text
 834 #: build/C/man2/brk.2:122
 835 msgid "4.3BSD; SUSv1, marked LEGACY in SUSv2, removed in POSIX.1-2001."
 836 msgstr ""
 837
 838 #. type: Plain text
 839 #: build/C/man2/brk.2:131
 840 msgid ""
 841 "Avoid using B<brk>()  and B<sbrk>(): the B<malloc>(3)  memory allocation "
 842 "package is the portable and comfortable way of allocating memory."
 843 msgstr ""
 844
 845 #.  One sees
 846 #.  \fIint\fP (e.g., XPGv4, DU 4.0, HP-UX 11, FreeBSD 4.0, OpenBSD 3.2),
 847 #.  \fIssize_t\fP (OSF1 2.0, Irix 5.3, 6.5),
 848 #.  \fIptrdiff_t\fP (libc4, libc5, ulibc, glibc 2.0, 2.1),
 849 #.  \fIintptr_t\fP (e.g., XPGv5, AIX, SunOS 5.8, 5.9, FreeBSD 4.7, NetBSD 1.6,
 850 #.  Tru64 5.1, glibc2.2).
 851 #. type: Plain text
 852 #: build/C/man2/brk.2:141
 853 msgid ""
 854 "Various systems use various types for the argument of B<sbrk>().  Common are "
 855 "I<int>, I<ssize_t>, I<ptrdiff_t>, I<intptr_t>."
 856 msgstr ""
 857
 858 #. type: SS
 859 #: build/C/man2/brk.2:141 build/C/man2/vfork.2:213
 860 #, no-wrap
 861 msgid "Linux notes"
 862 msgstr ""
 863
 864 #. type: Plain text
 865 #: build/C/man2/brk.2:157
 866 msgid ""
 867 "The return value described above for B<brk>()  is the behavior provided by "
 868 "the glibc wrapper function for the Linux B<brk>()  system call.  (On most "
 869 "other implementations, the return value from B<brk>()  is the same; this "
 870 "return value was also specified in SUSv2.)  However, the actual Linux system "
 871 "call returns the new program break on success.  On failure, the system call "
 872 "returns the current break.  The glibc wrapper function does some work (i.e., "
 873 "checks whether the new break is less than I<addr>)  to provide the 0 and -1 "
 874 "return values described above."
 875 msgstr ""
 876
 877 #. type: Plain text
 878 #: build/C/man2/brk.2:164
 879 msgid ""
 880 "On Linux, B<sbrk>()  is implemented as a library function that uses the "
 881 "B<brk>()  system call, and does some internal bookkeeping so that it can "
 882 "return the old break value."
 883 msgstr ""
 884
 885 #. type: Plain text
 886 #: build/C/man2/brk.2:169
 887 msgid "B<execve>(2), B<getrlimit>(2), B<end>(3), B<malloc>(3)"
 888 msgstr ""
 889
 890 #. type: TH
 891 #: build/C/man2/chdir.2:33
 892 #, no-wrap
 893 msgid "CHDIR"
 894 msgstr ""
 895
 896 #. type: TH
 897 #: build/C/man2/chdir.2:33
 898 #, no-wrap
 899 msgid "2010-11-25"
 900 msgstr ""
 901
 902 #. type: Plain text
 903 #: build/C/man2/chdir.2:36
 904 msgid "chdir, fchdir - change working directory"
 905 msgstr ""
 906
 907 #. type: Plain text
 908 #: build/C/man2/chdir.2:40
 909 msgid "B<int chdir(const char *>I<path>B<);>"
 910 msgstr ""
 911
 912 #. type: Plain text
 913 #: build/C/man2/chdir.2:42
 914 msgid "B<int fchdir(int >I<fd>B<);>"
 915 msgstr ""
 916
 917 #. type: Plain text
 918 #: build/C/man2/chdir.2:49
 919 msgid "B<fchdir>():"
 920 msgstr ""
 921
 922 #. type: Plain text
 923 #: build/C/man2/chdir.2:54 build/C/man2/chmod.2:53 build/C/man2/chown.2:62 build/C/man3/gethostid.3:50 build/C/man2/truncate.2:66 build/C/man2/truncate.2:74
 924 msgid ""
 925 "_BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || _XOPEN_SOURCE\\ &&\\ "
 926 "_XOPEN_SOURCE_EXTENDED"
 927 msgstr ""
 928
 929 #. type: Plain text
 930 #: build/C/man2/chdir.2:56 build/C/man2/chmod.2:55 build/C/man2/chown.2:64 build/C/man2/pread.2:50 build/C/man2/truncate.2:68
 931 msgid "|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
 932 msgstr ""
 933
 934 #. type: Plain text
 935 #: build/C/man2/chdir.2:64
 936 msgid ""
 937 "B<chdir>()  changes the current working directory of the calling process to "
 938 "the directory specified in I<path>."
 939 msgstr ""
 940
 941 #. type: Plain text
 942 #: build/C/man2/chdir.2:70
 943 msgid ""
 944 "B<fchdir>()  is identical to B<chdir>(); the only difference is that the "
 945 "directory is given as an open file descriptor."
 946 msgstr ""
 947
 948 #. type: Plain text
 949 #: build/C/man2/chdir.2:75 build/C/man2/chmod.2:158 build/C/man2/chown.2:124 build/C/man2/chroot.2:95 build/C/man2/flock.2:116 build/C/man2/getdomainname.2:80 build/C/man2/gethostname.2:94 build/C/man2/ioperm.2:87 build/C/man3/lockf.3:121 build/C/man2/swapon.2:113 build/C/man2/sysinfo.2:79 build/C/man2/truncate.2:115 build/C/man2/uname.2:68 build/C/man2/uselib.2:53 build/C/man2/vhangup.2:55
 950 msgid ""
 951 "On success, zero is returned.  On error, -1 is returned, and I<errno> is set "
 952 "appropriately."
 953 msgstr ""
 954
 955 #. type: Plain text
 956 #: build/C/man2/chdir.2:81
 957 msgid ""
 958 "Depending on the file system, other errors can be returned.  The more "
 959 "general errors for B<chdir>()  are listed below:"
 960 msgstr ""
 961
 962 #. type: Plain text
 963 #: build/C/man2/chdir.2:87
 964 msgid ""
 965 "Search permission is denied for one of the components of I<path>.  (See also "
 966 "B<path_resolution>(7).)"
 967 msgstr ""
 968
 969 #. type: Plain text
 970 #: build/C/man2/chdir.2:91 build/C/man2/chmod.2:172 build/C/man2/chown.2:138 build/C/man2/chroot.2:109
 971 msgid "I<path> points outside your accessible address space."
 972 msgstr ""
 973
 974 #. type: Plain text
 975 #: build/C/man2/chdir.2:98 build/C/man2/chmod.2:179 build/C/man2/chown.2:142 build/C/man2/chroot.2:116
 976 msgid "Too many symbolic links were encountered in resolving I<path>."
 977 msgstr ""
 978
 979 #. type: Plain text
 980 #: build/C/man2/chdir.2:102 build/C/man2/chmod.2:183 build/C/man2/chown.2:146 build/C/man2/chroot.2:120
 981 msgid "I<path> is too long."
 982 msgstr ""
 983
 984 #. type: Plain text
 985 #: build/C/man2/chdir.2:105 build/C/man2/chmod.2:186 build/C/man2/chown.2:149 build/C/man2/chroot.2:123
 986 msgid "The file does not exist."
 987 msgstr ""
 988
 989 #. type: Plain text
 990 #: build/C/man2/chdir.2:113 build/C/man2/chroot.2:131
 991 msgid "A component of I<path> is not a directory."
 992 msgstr ""
 993
 994 #. type: Plain text
 995 #: build/C/man2/chdir.2:117
 996 msgid "The general errors for B<fchdir>()  are listed below:"
 997 msgstr ""
 998
 999 #. type: Plain text
1000 #: build/C/man2/chdir.2:121
1001 msgid "Search permission was denied on the directory open on I<fd>."
1002 msgstr ""
1003
1004 #. type: TP
1005 #: build/C/man2/chdir.2:121 build/C/man2/chmod.2:205 build/C/man2/chown.2:166 build/C/man2/close.2:71 build/C/man2/dup.2:127 build/C/man2/fcntl.2:1092 build/C/man2/flock.2:117 build/C/man2/fsync.2:114 build/C/man2/ioctl.2:93 build/C/man3/lockf.3:130 build/C/man3/tcgetpgrp.3:87 build/C/man2/truncate.2:183
1006 #, no-wrap
1007 msgid "B<EBADF>"
1008 msgstr ""
1009
1010 #. type: Plain text
1011 #: build/C/man2/chdir.2:125 build/C/man3/tcgetpgrp.3:91
1012 msgid "I<fd> is not a valid file descriptor."
1013 msgstr ""
1014
1015 #. type: Plain text
1016 #: build/C/man2/chdir.2:127
1017 msgid "SVr4, 4.4BSD, POSIX.1-2001."
1018 msgstr ""
1019
1020 #. type: Plain text
1021 #: build/C/man2/chdir.2:130
1022 msgid ""
1023 "The current working directory is the starting point for interpreting "
1024 "relative pathnames (those not starting with \\(aq/\\(aq)."
1025 msgstr ""
1026
1027 #. type: Plain text
1028 #: build/C/man2/chdir.2:136
1029 msgid ""
1030 "A child process created via B<fork>(2)  inherits its parent's current "
1031 "working directory.  The current working directory is left unchanged by "
1032 "B<execve>(2)."
1033 msgstr ""
1034
1035 #. type: Plain text
1036 #: build/C/man2/chdir.2:140
1037 msgid "B<chroot>(2), B<getcwd>(3), B<path_resolution>(7)"
1038 msgstr ""
1039
1040 #. type: TH
1041 #: build/C/man2/chmod.2:31
1042 #, no-wrap
1043 msgid "CHMOD"
1044 msgstr ""
1045
1046 #. type: TH
1047 #: build/C/man2/chmod.2:31 build/C/man2/gethostname.2:32
1048 #, no-wrap
1049 msgid "2010-09-26"
1050 msgstr ""
1051
1052 #. type: Plain text
1053 #: build/C/man2/chmod.2:34
1054 msgid "chmod, fchmod - change permissions of a file"
1055 msgstr ""
1056
1057 #. type: Plain text
1058 #: build/C/man2/chmod.2:36 build/C/man3/getumask.3:37 build/C/man2/umask.2:41
1059 msgid "B<#include E<lt>sys/stat.hE<gt>>"
1060 msgstr ""
1061
1062 #. type: Plain text
1063 #: build/C/man2/chmod.2:38
1064 msgid "B<int chmod(const char *>I<path>B<, mode_t >I<mode>B<);>"
1065 msgstr ""
1066
1067 #. type: Plain text
1068 #: build/C/man2/chmod.2:40
1069 msgid "B<int fchmod(int >I<fd>B<, mode_t >I<mode>B<);>"
1070 msgstr ""
1071
1072 #. type: Plain text
1073 #: build/C/man2/chmod.2:49
1074 msgid "B<fchmod>():"
1075 msgstr ""
1076
1077 #. type: Plain text
1078 #: build/C/man2/chmod.2:61
1079 msgid ""
1080 "These system calls change the permissions of a file.  They differ only in "
1081 "how the file is specified:"
1082 msgstr ""
1083
1084 #. type: IP
1085 #: build/C/man2/chmod.2:61 build/C/man2/chmod.2:66 build/C/man2/chown.2:70 build/C/man2/chown.2:75 build/C/man2/chown.2:79 build/C/man2/chown.2:233 build/C/man2/chown.2:238 build/C/man2/chown.2:244 build/C/man2/dup.2:62 build/C/man2/dup.2:68 build/C/man2/dup.2:101 build/C/man2/dup.2:110 build/C/man2/execve.2:124 build/C/man2/execve.2:128 build/C/man2/execve.2:131 build/C/man2/execve.2:134 build/C/man2/execve.2:137 build/C/man2/execve.2:140 build/C/man2/execve.2:143 build/C/man2/execve.2:146 build/C/man2/execve.2:149 build/C/man2/execve.2:152 build/C/man2/execve.2:156 build/C/man2/execve.2:160 build/C/man2/execve.2:169 build/C/man2/execve.2:176 build/C/man2/execve.2:181 build/C/man2/execve.2:188 build/C/man2/execve.2:195 build/C/man2/execve.2:202 build/C/man2/execve.2:209 build/C/man2/execve.2:213 build/C/man2/execve.2:216 build/C/man2/execve.2:224 build/C/man2/execve.2:228 build/C/man2/execve.2:233 build/C/man2/fork.2:52 build/C/man2/fork.2:56 build/C/man2/fork.2:58 build/C/man2/fork.2:62 build/C/man2/fork.2:68 build/C/man2/fork.2:71 build/C/man2/fork.2:74 build/C/man2/fork.2:77 build/C/man2/fork.2:82 build/C/man2/fork.2:94 build/C/man2/fork.2:101 build/C/man2/fork.2:107 build/C/man2/fork.2:114 build/C/man2/fork.2:120 build/C/man2/fork.2:125 build/C/man2/fork.2:133 build/C/man2/fork.2:142 build/C/man2/fork.2:156 build/C/man2/fork.2:165 build/C/man2/syscalls.2:87 build/C/man2/syscalls.2:90 build/C/man2/syscalls.2:96 build/C/man2/syscalls.2:112 build/C/man2/syscalls.2:118 build/C/man2/syscalls.2:124 build/C/man2/syscalls.2:130 build/C/man2/syscalls.2:137 build/C/man2/syscalls.2:692 build/C/man2/syscalls.2:713 build/C/man2/syscalls.2:724 build/C/man2/syscalls.2:731 build/C/man2/syscalls.2:742 build/C/man2/syscalls.2:754 build/C/man2/syscalls.2:775 build/C/man2/syscalls.2:783 build/C/man2/vfork.2:193 build/C/man2/vfork.2:197
1086 #, no-wrap
1087 msgid "*"
1088 msgstr ""
1089
1090 #. type: Plain text
1091 #: build/C/man2/chmod.2:66
1092 msgid ""
1093 "B<chmod>()  changes the permissions of the file specified whose pathname is "
1094 "given in I<path>, which is dereferenced if it is a symbolic link."
1095 msgstr ""
1096
1097 #. type: Plain text
1098 #: build/C/man2/chmod.2:70
1099 msgid ""
1100 "B<fchmod>()  changes the permissions of the file referred to by the open "
1101 "file descriptor I<fd>."
1102 msgstr ""
1103
1104 #. type: Plain text
1105 #: build/C/man2/chmod.2:75
1106 msgid ""
1107 "The new file permissions are specified in I<mode>, which is a bit mask "
1108 "created by ORing together zero or more of the following:"
1109 msgstr ""
1110
1111 #. type: TP
1112 #: build/C/man2/chmod.2:75
1113 #, no-wrap
1114 msgid "B<S_ISUID>  (04000)"
1115 msgstr ""
1116
1117 #. type: Plain text
1118 #: build/C/man2/chmod.2:79
1119 msgid "set-user-ID (set process effective user ID on B<execve>(2))"
1120 msgstr ""
1121
1122 #. type: TP
1123 #: build/C/man2/chmod.2:79
1124 #, no-wrap
1125 msgid "B<S_ISGID>  (02000)"
1126 msgstr ""
1127
1128 #. type: Plain text
1129 #: build/C/man2/chmod.2:89
1130 msgid ""
1131 "set-group-ID (set process effective group ID on B<execve>(2); mandatory "
1132 "locking, as described in B<fcntl>(2); take a new file's group from parent "
1133 "directory, as described in B<chown>(2)  and B<mkdir>(2))"
1134 msgstr ""
1135
1136 #. type: TP
1137 #: build/C/man2/chmod.2:89
1138 #, no-wrap
1139 msgid "B<S_ISVTX>  (01000)"
1140 msgstr ""
1141
1142 #. type: Plain text
1143 #: build/C/man2/chmod.2:93
1144 msgid "sticky bit (restricted deletion flag, as described in B<unlink>(2))"
1145 msgstr ""
1146
1147 #. type: TP
1148 #: build/C/man2/chmod.2:93
1149 #, no-wrap
1150 msgid "B<S_IRUSR>  (00400)"
1151 msgstr ""
1152
1153 #. type: Plain text
1154 #: build/C/man2/chmod.2:96
1155 msgid "read by owner"
1156 msgstr ""
1157
1158 #. type: TP
1159 #: build/C/man2/chmod.2:96
1160 #, no-wrap
1161 msgid "B<S_IWUSR>  (00200)"
1162 msgstr ""
1163
1164 #. type: Plain text
1165 #: build/C/man2/chmod.2:99
1166 msgid "write by owner"
1167 msgstr ""
1168
1169 #. type: TP
1170 #: build/C/man2/chmod.2:99
1171 #, no-wrap
1172 msgid "B<S_IXUSR>  (00100)"
1173 msgstr ""
1174
1175 #. type: Plain text
1176 #: build/C/man2/chmod.2:103
1177 msgid ""
1178 "execute/search by owner (\"search\" applies for directories, and means that "
1179 "entries within the directory can be accessed)"
1180 msgstr ""
1181
1182 #. type: TP
1183 #: build/C/man2/chmod.2:103
1184 #, no-wrap
1185 msgid "B<S_IRGRP>  (00040)"
1186 msgstr ""
1187
1188 #. type: Plain text
1189 #: build/C/man2/chmod.2:106
1190 msgid "read by group"
1191 msgstr ""
1192
1193 #. type: TP
1194 #: build/C/man2/chmod.2:106
1195 #, no-wrap
1196 msgid "B<S_IWGRP>  (00020)"
1197 msgstr ""
1198
1199 #. type: Plain text
1200 #: build/C/man2/chmod.2:109
1201 msgid "write by group"
1202 msgstr ""
1203
1204 #. type: TP
1205 #: build/C/man2/chmod.2:109
1206 #, no-wrap
1207 msgid "B<S_IXGRP>  (00010)"
1208 msgstr ""
1209
1210 #. type: Plain text
1211 #: build/C/man2/chmod.2:112
1212 msgid "execute/search by group"
1213 msgstr ""
1214
1215 #. type: TP
1216 #: build/C/man2/chmod.2:112
1217 #, no-wrap
1218 msgid "B<S_IROTH>  (00004)"
1219 msgstr ""
1220
1221 #. type: Plain text
1222 #: build/C/man2/chmod.2:115
1223 msgid "read by others"
1224 msgstr ""
1225
1226 #. type: TP
1227 #: build/C/man2/chmod.2:115
1228 #, no-wrap
1229 msgid "B<S_IWOTH>  (00002)"
1230 msgstr ""
1231
1232 #. type: Plain text
1233 #: build/C/man2/chmod.2:118
1234 msgid "write by others"
1235 msgstr ""
1236
1237 #. type: TP
1238 #: build/C/man2/chmod.2:118
1239 #, no-wrap
1240 msgid "B<S_IXOTH>  (00001)"
1241 msgstr ""
1242
1243 #. type: Plain text
1244 #: build/C/man2/chmod.2:121
1245 msgid "execute/search by others"
1246 msgstr ""
1247
1248 #. type: Plain text
1249 #: build/C/man2/chmod.2:126
1250 msgid ""
1251 "The effective UID of the calling process must match the owner of the file, "
1252 "or the process must be privileged (Linux: it must have the B<CAP_FOWNER> "
1253 "capability)."
1254 msgstr ""
1255
1256 #. type: Plain text
1257 #: build/C/man2/chmod.2:135
1258 msgid ""
1259 "If the calling process is not privileged (Linux: does not have the "
1260 "B<CAP_FSETID> capability), and the group of the file does not match the "
1261 "effective group ID of the process or one of its supplementary group IDs, the "
1262 "B<S_ISGID> bit will be turned off, but this will not cause an error to be "
1263 "returned."
1264 msgstr ""
1265
1266 #. type: Plain text
1267 #: build/C/man2/chmod.2:147
1268 msgid ""
1269 "As a security measure, depending on the file system, the set-user-ID and "
1270 "set-group-ID execution bits may be turned off if a file is written.  (On "
1271 "Linux this occurs if the writing process does not have the B<CAP_FSETID> "
1272 "capability.)  On some file systems, only the superuser can set the sticky "
1273 "bit, which may have a special meaning.  For the sticky bit, and for "
1274 "set-user-ID and set-group-ID bits on directories, see B<stat>(2)."
1275 msgstr ""
1276
1277 #. type: Plain text
1278 #: build/C/man2/chmod.2:153
1279 msgid ""
1280 "On NFS file systems, restricting the permissions will immediately influence "
1281 "already open files, because the access control is done on the server, but "
1282 "open files are maintained by the client.  Widening the permissions may be "
1283 "delayed for other clients if attribute caching is enabled on them."
1284 msgstr ""
1285
1286 #. type: Plain text
1287 #: build/C/man2/chmod.2:163
1288 msgid ""
1289 "Depending on the file system, other errors can be returned.  The more "
1290 "general errors for B<chmod>()  are listed below:"
1291 msgstr ""
1292
1293 #.  Also search permission is required on the final component,
1294 #.  maybe just to guarantee that it is a directory?
1295 #. type: Plain text
1296 #: build/C/man2/chmod.2:168 build/C/man2/chown.2:134 build/C/man2/chroot.2:105
1297 msgid ""
1298 "Search permission is denied on a component of the path prefix.  (See also "
1299 "B<path_resolution>(7).)"
1300 msgstr ""
1301
1302 #. type: Plain text
1303 #: build/C/man2/chmod.2:192 build/C/man2/chown.2:155 build/C/man2/truncate.2:164
1304 msgid "A component of the path prefix is not a directory."
1305 msgstr ""
1306
1307 #. type: TP
1308 #: build/C/man2/chmod.2:192 build/C/man2/chmod.2:213 build/C/man2/chown.2:155 build/C/man2/chown.2:175 build/C/man2/chroot.2:131 build/C/man2/execve.2:437 build/C/man2/execve.2:443 build/C/man2/fcntl.2:1141 build/C/man2/getdomainname.2:91 build/C/man3/gethostid.3:88 build/C/man2/gethostname.2:117 build/C/man2/idle.2:56 build/C/man2/ioperm.2:101 build/C/man2/mkdir.2:109 build/C/man2/nice.2:62 build/C/man2/setup.2:57 build/C/man2/swapon.2:144 build/C/man3/tcgetpgrp.3:104 build/C/man2/truncate.2:164 build/C/man2/vhangup.2:56
1309 #, no-wrap
1310 msgid "B<EPERM>"
1311 msgstr ""
1312
1313 #. type: Plain text
1314 #: build/C/man2/chmod.2:198
1315 msgid ""
1316 "The effective UID does not match the owner of the file, and the process is "
1317 "not privileged (Linux: it does not have the B<CAP_FOWNER> capability)."
1318 msgstr ""
1319
1320 #. type: Plain text
1321 #: build/C/man2/chmod.2:201 build/C/man2/chown.2:162 build/C/man2/truncate.2:173
1322 msgid "The named file resides on a read-only file system."
1323 msgstr ""
1324
1325 #. type: Plain text
1326 #: build/C/man2/chmod.2:205
1327 msgid "The general errors for B<fchmod>()  are listed below:"
1328 msgstr ""
1329
1330 #. type: Plain text
1331 #: build/C/man2/chmod.2:210
1332 msgid "The file descriptor I<fd> is not valid."
1333 msgstr ""
1334
1335 #. type: Plain text
1336 #: build/C/man2/chmod.2:213 build/C/man2/chmod.2:216 build/C/man2/chmod.2:219 build/C/man2/chown.2:175 build/C/man2/chown.2:178 build/C/man2/chown.2:181
1337 msgid "See above."
1338 msgstr ""
1339
1340 #. type: Plain text
1341 #: build/C/man2/chmod.2:221 build/C/man2/chown.2:183
1342 msgid "4.4BSD, SVr4, POSIX.1-2001."
1343 msgstr ""
1344
1345 #. type: Plain text
1346 #: build/C/man2/chmod.2:228
1347 msgid ""
1348 "B<chown>(2), B<execve>(2), B<fchmodat>(2), B<open>(2), B<stat>(2), "
1349 "B<path_resolution>(7)"
1350 msgstr ""
1351
1352 #. type: TH
1353 #: build/C/man2/chown.2:38
1354 #, no-wrap
1355 msgid "CHOWN"
1356 msgstr ""
1357
1358 #. type: TH
1359 #: build/C/man2/chown.2:38
1360 #, no-wrap
1361 msgid "2010-11-22"
1362 msgstr ""
1363
1364 #. type: Plain text
1365 #: build/C/man2/chown.2:41
1366 msgid "chown, fchown, lchown - change ownership of a file"
1367 msgstr ""
1368
1369 #. type: Plain text
1370 #: build/C/man2/chown.2:45
1371 msgid "B<int chown(const char *>I<path>B<, uid_t >I<owner>B<, gid_t >I<group>B<);>"
1372 msgstr ""
1373
1374 #. type: Plain text
1375 #: build/C/man2/chown.2:47
1376 msgid "B<int fchown(int >I<fd>B<, uid_t >I<owner>B<, gid_t >I<group>B<);>"
1377 msgstr ""
1378
1379 #. type: Plain text
1380 #: build/C/man2/chown.2:49
1381 msgid "B<int lchown(const char *>I<path>B<, uid_t >I<owner>B<, gid_t >I<group>B<);>"
1382 msgstr ""
1383
1384 #. type: Plain text
1385 #: build/C/man2/chown.2:57
1386 msgid "B<fchown>(), B<lchown>():"
1387 msgstr ""
1388
1389 #. type: Plain text
1390 #: build/C/man2/chown.2:70
1391 msgid ""
1392 "These system calls change the owner and group of a file.  They differ only "
1393 "in how the file is specified:"
1394 msgstr ""
1395
1396 #. type: Plain text
1397 #: build/C/man2/chown.2:75
1398 msgid ""
1399 "B<chown>()  changes the ownership of the file specified by I<path>, which is "
1400 "dereferenced if it is a symbolic link."
1401 msgstr ""
1402
1403 #. type: Plain text
1404 #: build/C/man2/chown.2:79
1405 msgid ""
1406 "B<fchown>()  changes the ownership of the file referred to by the open file "
1407 "descriptor I<fd>."
1408 msgstr ""
1409
1410 #. type: Plain text
1411 #: build/C/man2/chown.2:84
1412 msgid "B<lchown>()  is like B<chown>(), but does not dereference symbolic links."
1413 msgstr ""
1414
1415 #. type: Plain text
1416 #: build/C/man2/chown.2:93
1417 msgid ""
1418 "Only a privileged process (Linux: one with the B<CAP_CHOWN> capability) may "
1419 "change the owner of a file.  The owner of a file may change the group of the "
1420 "file to any group of which that owner is a member.  A privileged process "
1421 "(Linux: with B<CAP_CHOWN>)  may change the group arbitrarily."
1422 msgstr ""
1423
1424 #. type: Plain text
1425 #: build/C/man2/chown.2:99
1426 msgid "If the I<owner> or I<group> is specified as -1, then that ID is not changed."
1427 msgstr ""
1428
1429 #.  In Linux 2.0 kernels, superuser was like everyone else
1430 #.  In 2.2, up to 2.2.12, these bits were not cleared for superuser.
1431 #.  Since 2.2.13, superuser is once more like everyone else.
1432 #. type: Plain text
1433 #: build/C/man2/chown.2:119
1434 msgid ""
1435 "When the owner or group of an executable file are changed by an unprivileged "
1436 "user the B<S_ISUID> and B<S_ISGID> mode bits are cleared.  POSIX does not "
1437 "specify whether this also should happen when root does the B<chown>(); the "
1438 "Linux behavior depends on the kernel version.  In case of a "
1439 "non-group-executable file (i.e., one for which the B<S_IXGRP> bit is not "
1440 "set) the B<S_ISGID> bit indicates mandatory locking, and is not cleared by a "
1441 "B<chown>()."
1442 msgstr ""
1443
1444 #. type: Plain text
1445 #: build/C/man2/chown.2:129
1446 msgid ""
1447 "Depending on the file system, other errors can be returned.  The more "
1448 "general errors for B<chown>()  are listed below."
1449 msgstr ""
1450
1451 #. type: Plain text
1452 #: build/C/man2/chown.2:159
1453 msgid ""
1454 "The calling process did not have the required permissions (see above) to "
1455 "change owner and/or group."
1456 msgstr ""
1457
1458 #. type: Plain text
1459 #: build/C/man2/chown.2:166
1460 msgid "The general errors for B<fchown>()  are listed below:"
1461 msgstr ""
1462
1463 #. type: Plain text
1464 #: build/C/man2/chown.2:169
1465 msgid "The descriptor is not valid."
1466 msgstr ""
1467
1468 #. type: Plain text
1469 #: build/C/man2/chown.2:172
1470 msgid "A low-level I/O error occurred while modifying the inode."
1471 msgstr ""
1472
1473 #.  chown():
1474 #.  SVr4 documents EINVAL, EINTR, ENOLINK and EMULTIHOP returns, but no
1475 #.  ENOMEM.  POSIX.1 does not document ENOMEM or ELOOP error conditions.
1476 #.  fchown():
1477 #.  SVr4 documents additional EINVAL, EIO, EINTR, and ENOLINK
1478 #.  error conditions.
1479 #. type: Plain text
1480 #: build/C/man2/chown.2:192
1481 msgid ""
1482 "The 4.4BSD version can be used only by the superuser (that is, ordinary "
1483 "users cannot give away files)."
1484 msgstr ""
1485
1486 #. type: Plain text
1487 #: build/C/man2/chown.2:211
1488 msgid ""
1489 "The original Linux B<chown>(), B<fchown>(), and B<lchown>()  system calls "
1490 "supported only 16-bit user and group IDs.  Subsequently, Linux 2.4 added "
1491 "B<chown32>(), B<fchown32>(), and B<lchown32>(), supporting 32-bit IDs.  The "
1492 "glibc B<chown>(), B<fchown>(), and B<lchown>()  wrapper functions "
1493 "transparently deal with the variations across kernel versions."
1494 msgstr ""
1495
1496 #. type: Plain text
1497 #: build/C/man2/chown.2:233
1498 msgid ""
1499 "When a new file is created (by, for example, B<open>(2)  or B<mkdir>(2)), "
1500 "its owner is made the same as the file system user ID of the creating "
1501 "process.  The group of the file depends on a range of factors, including the "
1502 "type of file system, the options used to mount the file system, and whether "
1503 "or not the set-group-ID permission bit is enabled on the parent directory.  "
1504 "If the file system supports the I<-o\\ grpid> (or, synonymously I<-o\\ "
1505 "bsdgroups>)  and I<-o\\ nogrpid> (or, synonymously I<-o\\ sysvgroups>)  "
1506 "B<mount>(8)  options, then the rules are as follows:"
1507 msgstr ""
1508
1509 #. type: Plain text
1510 #: build/C/man2/chown.2:238
1511 msgid ""
1512 "If the file system is mounted with I<-o\\ grpid>, then the group of a new "
1513 "file is made the same as that of the parent directory."
1514 msgstr ""
1515
1516 #. type: Plain text
1517 #: build/C/man2/chown.2:244
1518 msgid ""
1519 "If the file system is mounted with I<-o\\ nogrpid> and the set-group-ID bit "
1520 "is disabled on the parent directory, then the group of a new file is made "
1521 "the same as the process's file system GID."
1522 msgstr ""
1523
1524 #. type: Plain text
1525 #: build/C/man2/chown.2:250
1526 msgid ""
1527 "If the file system is mounted with I<-o\\ nogrpid> and the set-group-ID bit "
1528 "is enabled on the parent directory, then the group of a new file is made the "
1529 "same as that of the parent directory."
1530 msgstr ""
1531
1532 #. type: Plain text
1533 #: build/C/man2/chown.2:260
1534 msgid ""
1535 "As at Linux 2.6.25, the I<-o\\ grpid> and I<-o\\ nogrpid> mount options are "
1536 "supported by ext2, ext3, ext4, and XFS.  File systems that don't support "
1537 "these mount options follow the I<-o\\ nogrpid> rules."
1538 msgstr ""
1539
1540 #. type: Plain text
1541 #: build/C/man2/chown.2:273
1542 msgid ""
1543 "The B<chown>()  semantics are deliberately violated on NFS file systems "
1544 "which have UID mapping enabled.  Additionally, the semantics of all system "
1545 "calls which access the file contents are violated, because B<chown>()  may "
1546 "cause immediate access revocation on already open files.  Client side "
1547 "caching may lead to a delay between the time where ownership have been "
1548 "changed to allow access for a user and the time where the file can actually "
1549 "be accessed by the user on other clients."
1550 msgstr ""
1551
1552 #. type: Plain text
1553 #: build/C/man2/chown.2:288
1554 msgid ""
1555 "In versions of Linux prior to 2.1.81 (and distinct from 2.1.46), B<chown>()  "
1556 "did not follow symbolic links.  Since Linux 2.1.81, B<chown>()  does follow "
1557 "symbolic links, and there is a new system call B<lchown>()  that does not "
1558 "follow symbolic links.  Since Linux 2.1.86, this new call (that has the same "
1559 "semantics as the old B<chown>())  has got the same syscall number, and "
1560 "B<chown>()  got the newly introduced number."
1561 msgstr ""
1562
1563 #. type: Plain text
1564 #: build/C/man2/chown.2:297
1565 msgid ""
1566 "The following program changes the ownership of the file named in its second "
1567 "command-line argument to the value specified in its first command-line "
1568 "argument.  The new owner can be specified either as a numeric user ID, or as "
1569 "a username (which is converted to a user ID by using B<getpwnam>(3)  to "
1570 "perform a lookup in the system password file)."
1571 msgstr ""
1572
1573 #. type: Plain text
1574 #: build/C/man2/chown.2:303
1575 #, no-wrap
1576 msgid ""
1577 "#include E<lt>pwd.hE<gt>\n"
1578 "#include E<lt>stdio.hE<gt>\n"
1579 "#include E<lt>stdlib.hE<gt>\n"
1580 "#include E<lt>unistd.hE<gt>\n"
1581 msgstr ""
1582
1583 #. type: Plain text
1584 #: build/C/man2/chown.2:310
1585 #, no-wrap
1586 msgid ""
1587 "int\n"
1588 "main(int argc, char *argv[])\n"
1589 "{\n"
1590 "    uid_t uid;\n"
1591 "    struct passwd *pwd;\n"
1592 "    char *endptr;\n"
1593 msgstr ""
1594
1595 #. type: Plain text
1596 #: build/C/man2/chown.2:315
1597 #, no-wrap
1598 msgid ""
1599 "    if (argc != 3 || argv[1][0] == \\(aq\\e0\\(aq) {\n"
1600 "        fprintf(stderr, \"%s E<lt>ownerE<gt> E<lt>fileE<gt>\\en\", "
1601 "argv[0]);\n"
1602 "        exit(EXIT_FAILURE);\n"
1603 "    }\n"
1604 msgstr ""
1605
1606 #. type: Plain text
1607 #: build/C/man2/chown.2:317
1608 #, no-wrap
1609 msgid "    uid = strtol(argv[1], &endptr, 10);  /* Allow a numeric string */\n"
1610 msgstr ""
1611
1612 #. type: Plain text
1613 #: build/C/man2/chown.2:324
1614 #, no-wrap
1615 msgid ""
1616 "    if (*endptr != \\(aq\\e0\\(aq) {         /* Was not pure numeric string "
1617 "*/\n"
1618 "        pwd = getpwnam(argv[1]);   /* Try getting UID for username */\n"
1619 "        if (pwd == NULL) {\n"
1620 "            perror(\"getpwnam\");\n"
1621 "            exit(EXIT_FAILURE);\n"
1622 "        }\n"
1623 msgstr ""
1624
1625 #. type: Plain text
1626 #: build/C/man2/chown.2:327
1627 #, no-wrap
1628 msgid ""
1629 "        uid = pwd-E<gt>pw_uid;\n"
1630 "    }\n"
1631 msgstr ""
1632
1633 #. type: Plain text
1634 #: build/C/man2/chown.2:332
1635 #, no-wrap
1636 msgid ""
1637 "    if (chown(argv[2], uid, -1) == -1) {\n"
1638 "        perror(\"chown\");\n"
1639 "        exit(EXIT_FAILURE);\n"
1640 "    }\n"
1641 msgstr ""
1642
1643 #. type: Plain text
1644 #: build/C/man2/chown.2:335 build/C/man2/execve.2:565 build/C/man3/getopt.3:428 build/C/man3/getopt.3:513
1645 #, no-wrap
1646 msgid ""
1647 "    exit(EXIT_SUCCESS);\n"
1648 "}\n"
1649 msgstr ""
1650
1651 #. type: Plain text
1652 #: build/C/man2/chown.2:342
1653 msgid ""
1654 "B<chmod>(2), B<fchownat>(2), B<flock>(2), B<path_resolution>(7), "
1655 "B<symlink>(7)"
1656 msgstr ""
1657
1658 #. type: TH
1659 #: build/C/man2/chroot.2:33
1660 #, no-wrap
1661 msgid "CHROOT"
1662 msgstr ""
1663
1664 #. type: Plain text
1665 #: build/C/man2/chroot.2:36
1666 msgid "chroot - change root directory"
1667 msgstr ""
1668
1669 #. type: Plain text
1670 #: build/C/man2/chroot.2:40
1671 msgid "B<int chroot(const char *>I<path>B<);>"
1672 msgstr ""
1673
1674 #. type: Plain text
1675 #: build/C/man2/chroot.2:47
1676 msgid "B<chroot>():"
1677 msgstr ""
1678
1679 #. type: TP
1680 #: build/C/man2/chroot.2:50
1681 #, no-wrap
1682 msgid "Since glibc 2.2.2:"
1683 msgstr ""
1684
1685 #. type: Plain text
1686 #: build/C/man2/chroot.2:57
1687 #, no-wrap
1688 msgid ""
1689 "_BSD_SOURCE ||\n"
1690 "    (_XOPEN_SOURCE\\ E<gt>=\\ 500 ||\n"
1691 "        _XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED) &&\n"
1692 "    !(_POSIX_C_SOURCE\\ E<gt>=\\ 200112L || _XOPEN_SOURCE\\ E<gt>=\\ 600)\n"
1693 msgstr ""
1694
1695 #. type: Plain text
1696 #: build/C/man2/chroot.2:60
1697 msgid "Before glibc 2.2.2: none"
1698 msgstr ""
1699
1700 #. type: Plain text
1701 #: build/C/man2/chroot.2:69
1702 msgid ""
1703 "B<chroot>()  changes the root directory of the calling process to that "
1704 "specified in I<path>.  This directory will be used for pathnames beginning "
1705 "with I</>.  The root directory is inherited by all children of the calling "
1706 "process."
1707 msgstr ""
1708
1709 #. type: Plain text
1710 #: build/C/man2/chroot.2:74
1711 msgid ""
1712 "Only a privileged process (Linux: one with the B<CAP_SYS_CHROOT> capability) "
1713 "may call B<chroot>()."
1714 msgstr ""
1715
1716 #. type: Plain text
1717 #: build/C/man2/chroot.2:77
1718 msgid ""
1719 "This call changes an ingredient in the pathname resolution process and does "
1720 "nothing else."
1721 msgstr ""
1722
1723 #. type: Plain text
1724 #: build/C/man2/chroot.2:83
1725 msgid ""
1726 "This call does not change the current working directory, so that after the "
1727 "call \\(aqI<.>\\(aq can be outside the tree rooted at \\(aqI</>\\(aq.  In "
1728 "particular, the superuser can escape from a \"chroot jail\" by doing:"
1729 msgstr ""
1730
1731 #. type: Plain text
1732 #: build/C/man2/chroot.2:86
1733 #, no-wrap
1734 msgid "    mkdir foo; chroot foo; cd ..\n"
1735 msgstr ""
1736
1737 #. type: Plain text
1738 #: build/C/man2/chroot.2:90
1739 msgid ""
1740 "This call does not close open file descriptors, and such file descriptors "
1741 "may allow access to files outside the chroot tree."
1742 msgstr ""
1743
1744 #. type: Plain text
1745 #: build/C/man2/chroot.2:98
1746 msgid ""
1747 "Depending on the file system, other errors can be returned.  The more "
1748 "general errors are listed below:"
1749 msgstr ""
1750
1751 #. type: Plain text
1752 #: build/C/man2/chroot.2:134
1753 msgid "The caller has insufficient privilege."
1754 msgstr ""
1755
1756 #.  SVr4 documents additional EINTR, ENOLINK and EMULTIHOP error conditions.
1757 #.  X/OPEN does not document EIO, ENOMEM or EFAULT error conditions.
1758 #. type: Plain text
1759 #: build/C/man2/chroot.2:139
1760 msgid ""
1761 "SVr4, 4.4BSD, SUSv2 (marked LEGACY).  This function is not part of "
1762 "POSIX.1-2001."
1763 msgstr ""
1764
1765 #. type: Plain text
1766 #: build/C/man2/chroot.2:145
1767 msgid ""
1768 "A child process created via B<fork>(2)  inherits its parent's root "
1769 "directory.  The root directory is left unchanged by B<execve>(2)."
1770 msgstr ""
1771
1772 #.  FIXME . eventually say something about containers,
1773 #.  virtual servers, etc.?
1774 #. type: Plain text
1775 #: build/C/man2/chroot.2:151
1776 msgid "FreeBSD has a stronger B<jail>()  system call."
1777 msgstr ""
1778
1779 #. type: Plain text
1780 #: build/C/man2/chroot.2:154
1781 msgid "B<chdir>(2), B<path_resolution>(7)"
1782 msgstr ""
1783
1784 #. type: TH
1785 #: build/C/man2/close.2:35
1786 #, no-wrap
1787 msgid "CLOSE"
1788 msgstr ""
1789
1790 #. type: TH
1791 #: build/C/man2/close.2:35
1792 #, no-wrap
1793 msgid "2007-12-28"
1794 msgstr ""
1795
1796 #. type: Plain text
1797 #: build/C/man2/close.2:38
1798 msgid "close - close a file descriptor"
1799 msgstr ""
1800
1801 #. type: Plain text
1802 #: build/C/man2/close.2:43
1803 #, no-wrap
1804 msgid "B<int close(int >I<fd>B<);>\n"
1805 msgstr ""
1806
1807 #. type: Plain text
1808 #: build/C/man2/close.2:53
1809 msgid ""
1810 "B<close>()  closes a file descriptor, so that it no longer refers to any "
1811 "file and may be reused.  Any record locks (see B<fcntl>(2))  held on the "
1812 "file it was associated with, and owned by the process, are removed "
1813 "(regardless of the file descriptor that was used to obtain the lock)."
1814 msgstr ""
1815
1816 #. type: Plain text
1817 #: build/C/man2/close.2:64
1818 msgid ""
1819 "If I<fd> is the last file descriptor referring to the underlying open file "
1820 "description (see B<open>(2)), the resources associated with the open file "
1821 "description are freed; if the descriptor was the last reference to a file "
1822 "which has been removed using B<unlink>(2)  the file is deleted."
1823 msgstr ""
1824
1825 #. type: Plain text
1826 #: build/C/man2/close.2:70
1827 msgid ""
1828 "B<close>()  returns zero on success.  On error, -1 is returned, and I<errno> "
1829 "is set appropriately."
1830 msgstr ""
1831
1832 #. type: Plain text
1833 #: build/C/man2/close.2:75
1834 msgid "I<fd> isn't a valid open file descriptor."
1835 msgstr ""
1836
1837 #. type: TP
1838 #: build/C/man2/close.2:75 build/C/man2/dup.2:143 build/C/man2/fcntl.2:1110 build/C/man2/flock.2:121 build/C/man2/truncate.2:133 build/C/man3/ualarm.3:85 build/C/man3/usleep.3:83
1839 #, no-wrap
1840 msgid "B<EINTR>"
1841 msgstr ""
1842
1843 #. type: Plain text
1844 #: build/C/man2/close.2:81
1845 msgid "The B<close>()  call was interrupted by a signal; see B<signal>(7)."
1846 msgstr ""
1847
1848 #. type: Plain text
1849 #: build/C/man2/close.2:101
1850 msgid ""
1851 "Not checking the return value of B<close>()  is a common but nevertheless "
1852 "serious programming error.  It is quite possible that errors on a previous "
1853 "B<write>(2)  operation are first reported at the final B<close>().  Not "
1854 "checking the return value when closing the file may lead to silent loss of "
1855 "data.  This can especially be observed with NFS and with disk quota."
1856 msgstr ""
1857
1858 #. type: Plain text
1859 #: build/C/man2/close.2:110
1860 msgid ""
1861 "A successful close does not guarantee that the data has been successfully "
1862 "saved to disk, as the kernel defers writes.  It is not common for a file "
1863 "system to flush the buffers when the stream is closed.  If you need to be "
1864 "sure that the data is physically stored use B<fsync>(2).  (It will depend on "
1865 "the disk hardware at this point.)"
1866 msgstr ""
1867
1868 #.  Date: Tue, 4 Sep 2007 13:57:35 +0200
1869 #.  From: Fredrik Noring <noring@nocrew.org>
1870 #.  One such race involves signals and ERESTARTSYS. If a file descriptor
1871 #.  in use by a system call is closed and then reused by e.g. an
1872 #.  independent open() in some unrelated thread, before the original system
1873 #.  call has restared after ERESTARTSYS, the original system call will
1874 #.  later restart with the reused file descriptor. This is most likely a
1875 #.  serious programming error.
1876 #. type: Plain text
1877 #: build/C/man2/close.2:125
1878 msgid ""
1879 "It is probably unwise to close file descriptors while they may be in use by "
1880 "system calls in other threads in the same process.  Since a file descriptor "
1881 "may be reused, there are some obscure race conditions that may cause "
1882 "unintended side effects."
1883 msgstr ""
1884
1885 #. type: Plain text
1886 #: build/C/man2/close.2:132
1887 msgid ""
1888 "B<fcntl>(2), B<fsync>(2), B<open>(2), B<shutdown>(2), B<unlink>(2), "
1889 "B<fclose>(3)"
1890 msgstr ""
1891
1892 #. type: TH
1893 #: build/C/man3/confstr.3:31
1894 #, no-wrap
1895 msgid "CONFSTR"
1896 msgstr ""
1897
1898 #. type: TH
1899 #: build/C/man3/confstr.3:31
1900 #, no-wrap
1901 msgid "2012-05-10"
1902 msgstr ""
1903
1904 #. type: TH
1905 #: build/C/man3/confstr.3:31 build/C/man3/daemon.3:36 build/C/man3/exec.3:41 build/C/man3/fpathconf.3:41 build/C/man3/get_nprocs_conf.3:26 build/C/man3/getcwd.3:32 build/C/man3/getlogin.3:28 build/C/man3/getopt.3:41 build/C/man3/getumask.3:28 build/C/man3/getusershell.3:30 build/C/man3/lockf.3:28 build/C/man3/sleep.3:26 build/C/man3/sysconf.3:27 build/C/man3/tcgetpgrp.3:25
1906 #, no-wrap
1907 msgid "GNU"
1908 msgstr ""
1909
1910 #. type: Plain text
1911 #: build/C/man3/confstr.3:34
1912 msgid "confstr - get configuration dependent string variables"
1913 msgstr ""
1914
1915 #. type: Plain text
1916 #: build/C/man3/confstr.3:39
1917 #, no-wrap
1918 msgid "B<size_t confstr(int >I<name>B<, char *>I<buf>B<, size_t >I<len>B<);>\n"
1919 msgstr ""
1920
1921 #. type: Plain text
1922 #: build/C/man3/confstr.3:48
1923 msgid "B<confstr>(): _POSIX_C_SOURCE\\ E<gt>=\\ 2 || _XOPEN_SOURCE"
1924 msgstr ""
1925
1926 #. type: Plain text
1927 #: build/C/man3/confstr.3:51
1928 msgid "B<confstr>()  gets the value of configuration-dependent string variables."
1929 msgstr ""
1930
1931 #. type: Plain text
1932 #: build/C/man3/confstr.3:56
1933 msgid ""
1934 "The I<name> argument is the system variable to be queried.  The following "
1935 "variables are supported:"
1936 msgstr ""
1937
1938 #. type: TP
1939 #: build/C/man3/confstr.3:56
1940 #, no-wrap
1941 msgid "B<_CS_GNU_LIBC_VERSION> (GNU C library only; since glibc 2.3.2)"
1942 msgstr ""
1943
1944 #. type: Plain text
1945 #: build/C/man3/confstr.3:60
1946 msgid ""
1947 "A string which identifies the GNU C library version on this system (e.g, "
1948 "\"glibc 2.3.4\")."
1949 msgstr ""
1950
1951 #. type: TP
1952 #: build/C/man3/confstr.3:60
1953 #, no-wrap
1954 msgid "B<_CS_GNU_LIBPTHREAD_VERSION> (GNU C library only; since glibc 2.3.2)"
1955 msgstr ""
1956
1957 #. type: Plain text
1958 #: build/C/man3/confstr.3:64
1959 msgid ""
1960 "A string which identifies the POSIX implementation supplied by this C "
1961 "library (e.g, \"NPTL 2.3.4\" or \"linuxthreads-0.10\")."
1962 msgstr ""
1963
1964 #. type: TP
1965 #: build/C/man3/confstr.3:64
1966 #, no-wrap
1967 msgid "B<_CS_PATH>"
1968 msgstr ""
1969
1970 #. type: Plain text
1971 #: build/C/man3/confstr.3:70
1972 msgid ""
1973 "A value for the B<PATH> variable which indicates where all the POSIX.2 "
1974 "standard utilities can be found."
1975 msgstr ""
1976
1977 #. type: Plain text
1978 #: build/C/man3/confstr.3:86
1979 msgid ""
1980 "If I<buf> is not NULL and I<len> is not zero, B<confstr>()  copies the value "
1981 "of the string to I<buf> truncated to I<len - 1> bytes if necessary, with a "
1982 "null byte (\\(aq\\e0\\(aq) as terminator.  This can be detected by comparing "
1983 "the return value of B<confstr>()  against I<len>."
1984 msgstr ""
1985
1986 #. type: Plain text
1987 #: build/C/man3/confstr.3:94
1988 msgid ""
1989 "If I<len> is zero and I<buf> is NULL, B<confstr>()  just returns the value "
1990 "as defined below."
1991 msgstr ""
1992
1993 #. type: Plain text
1994 #: build/C/man3/confstr.3:106
1995 msgid ""
1996 "If I<name> is a valid configuration variable, B<confstr>()  returns the "
1997 "number of bytes (including the terminating null byte)  that would be "
1998 "required to hold the entire value of that variable.  This value may be "
1999 "greater than I<len>, which means that the value in I<buf> is truncated."
2000 msgstr ""
2001
2002 #. type: Plain text
2003 #: build/C/man3/confstr.3:121
2004 msgid ""
2005 "If I<name> is a valid configuration variable, but that variable does not "
2006 "have a value, then B<confstr>()  returns 0.  If I<name> does not correspond "
2007 "to a valid configuration variable, B<confstr>()  returns 0, and I<errno> is "
2008 "set to B<EINVAL>."
2009 msgstr ""
2010
2011 #. type: Plain text
2012 #: build/C/man3/confstr.3:127
2013 msgid "If the value of I<name> is invalid."
2014 msgstr ""
2015
2016 #. type: Plain text
2017 #: build/C/man3/confstr.3:129 build/C/man3/fpathconf.3:171 build/C/man2/pread.2:117 build/C/man3/sleep.3:46 build/C/man3/sysconf.3:326 build/C/man3/tcgetpgrp.3:111
2018 msgid "POSIX.1-2001."
2019 msgstr ""
2020
2021 #. type: Plain text
2022 #: build/C/man3/confstr.3:132
2023 msgid ""
2024 "The following code fragment determines the path where to find the POSIX.2 "
2025 "system utilities:"
2026 msgstr ""
2027
2028 #. type: Plain text
2029 #: build/C/man3/confstr.3:138
2030 #, no-wrap
2031 msgid ""
2032 "char *pathbuf;\n"
2033 "size_t n;\n"
2034 msgstr ""
2035
2036 #. type: Plain text
2037 #: build/C/man3/confstr.3:144
2038 #, no-wrap
2039 msgid ""
2040 "n = confstr(_CS_PATH, NULL, (size_t) 0);\n"
2041 "pathbuf = malloc(n);\n"
2042 "if (pathbuf == NULL)\n"
2043 "    abort();\n"
2044 "confstr(_CS_PATH, pathbuf, n);\n"
2045 msgstr ""
2046
2047 #. type: Plain text
2048 #: build/C/man3/confstr.3:150
2049 msgid "B<sh>(1), B<exec>(3), B<system>(3)"
2050 msgstr ""
2051
2052 #. type: TH
2053 #: build/C/man3/crypt.3:36
2054 #, no-wrap
2055 msgid "CRYPT"
2056 msgstr ""
2057
2058 #. type: TH
2059 #: build/C/man3/crypt.3:36 build/C/man3/getusershell.3:30 build/C/man2/pread.2:25 build/C/man2/syscall.2:40
2060 #, no-wrap
2061 msgid "2013-06-21"
2062 msgstr ""
2063
2064 #. type: Plain text
2065 #: build/C/man3/crypt.3:39
2066 msgid "crypt, crypt_r - password and data encryption"
2067 msgstr ""
2068
2069 #. type: Plain text
2070 #: build/C/man3/crypt.3:42
2071 #, no-wrap
2072 msgid "B<#define _XOPEN_SOURCE>       /* See feature_test_macros(7) */\n"
2073 msgstr ""
2074
2075 #. type: Plain text
2076 #: build/C/man3/crypt.3:46
2077 #, no-wrap
2078 msgid "B<char *crypt(const char *>I<key>B<, const char *>I<salt>B<);>\n"
2079 msgstr ""
2080
2081 #. type: Plain text
2082 #: build/C/man3/crypt.3:48
2083 #, no-wrap
2084 msgid "B<#define _GNU_SOURCE>         /* See feature_test_macros(7) */\n"
2085 msgstr ""
2086
2087 #. type: Plain text
2088 #: build/C/man3/crypt.3:50
2089 #, no-wrap
2090 msgid "B<#include E<lt>crypt.hE<gt>>\n"
2091 msgstr ""
2092
2093 #. type: Plain text
2094 #: build/C/man3/crypt.3:53
2095 #, no-wrap
2096 msgid ""
2097 "B<char *crypt_r(const char *>I<key>B<, const char *>I<salt>B<,>\n"
2098 "B<              struct crypt_data *>I<data>B<);>\n"
2099 msgstr ""
2100
2101 #. type: Plain text
2102 #: build/C/man3/crypt.3:56
2103 msgid "Link with I<-lcrypt>."
2104 msgstr ""
2105
2106 #. type: Plain text
2107 #: build/C/man3/crypt.3:62
2108 msgid ""
2109 "B<crypt>()  is the password encryption function.  It is based on the Data "
2110 "Encryption Standard algorithm with variations intended (among other things) "
2111 "to discourage use of hardware implementations of a key search."
2112 msgstr ""
2113
2114 #. type: Plain text
2115 #: build/C/man3/crypt.3:65
2116 msgid "I<key> is a user's typed password."
2117 msgstr ""
2118
2119 #. type: Plain text
2120 #: build/C/man3/crypt.3:71
2121 msgid ""
2122 "I<salt> is a two-character string chosen from the set "
2123 "[B<a>\\(enB<zA>\\(enB<Z0>\\(enB<9./>].  This string is used to perturb the "
2124 "algorithm in one of 4096 different ways."
2125 msgstr ""
2126
2127 #. type: Plain text
2128 #: build/C/man3/crypt.3:82
2129 msgid ""
2130 "By taking the lowest 7 bits of each of the first eight characters of the "
2131 "I<key>, a 56-bit key is obtained.  This 56-bit key is used to encrypt "
2132 "repeatedly a constant string (usually a string consisting of all zeros).  "
2133 "The returned value points to the encrypted password, a series of 13 "
2134 "printable ASCII characters (the first two characters represent the salt "
2135 "itself).  The return value points to static data whose content is "
2136 "overwritten by each call."
2137 msgstr ""
2138
2139 #. type: Plain text
2140 #: build/C/man3/crypt.3:84
2141 msgid "Warning: The key space consists of"
2142 msgstr ""
2143
2144 #. type: Plain text
2145 #: build/C/man3/crypt.3:99
2146 msgid ""
2147 "equal 7.2e16 possible values.  Exhaustive searches of this key space are "
2148 "possible using massively parallel computers.  Software, such as B<crack>(1), "
2149 "is available which will search the portion of this key space that is "
2150 "generally used by humans for passwords.  Hence, password selection should, "
2151 "at minimum, avoid common words and names.  The use of a B<passwd>(1)  "
2152 "program that checks for crackable passwords during the selection process is "
2153 "recommended."
2154 msgstr ""
2155
2156 #. type: Plain text
2157 #: build/C/man3/crypt.3:108
2158 msgid ""
2159 "The DES algorithm itself has a few quirks which make the use of the "
2160 "B<crypt>()  interface a very poor choice for anything other than password "
2161 "authentication.  If you are planning on using the B<crypt>()  interface for "
2162 "a cryptography project, don't do it: get a good book on encryption and one "
2163 "of the widely available DES libraries."
2164 msgstr ""
2165
2166 #. type: Plain text
2167 #: build/C/man3/crypt.3:120
2168 msgid ""
2169 "B<crypt_r>()  is a reentrant version of B<crypt>().  The structure pointed "
2170 "to by I<data> is used to store result data and bookkeeping information.  "
2171 "Other than allocating it, the only thing that the caller should do with this "
2172 "structure is to set I<data-E<gt>initialized> to zero before the first call "
2173 "to B<crypt_r>()."
2174 msgstr ""
2175
2176 #. type: Plain text
2177 #: build/C/man3/crypt.3:123
2178 msgid ""
2179 "On success, a pointer to the encrypted password is returned.  On error, NULL "
2180 "is returned."
2181 msgstr ""
2182
2183 #. type: TP
2184 #: build/C/man3/crypt.3:124 build/C/man3/encrypt.3:120 build/C/man3/fexecve.3:86 build/C/man2/fork.2:200
2185 #, no-wrap
2186 msgid "B<ENOSYS>"
2187 msgstr ""
2188
2189 #.  This level of detail is not necessary in this man page. . .
2190 #.  .PP
2191 #.  When encrypting a plain text P using DES with the key K results in the
2192 #.  encrypted text C, then the complementary plain text P' being encrypted
2193 #.  using the complementary key K' will result in the complementary encrypted
2194 #.  text C'.
2195 #.  .PP
2196 #.  Weak keys are keys which stay invariant under the DES key transformation.
2197 #.  The four known weak keys 0101010101010101, fefefefefefefefe,
2198 #.  1f1f1f1f0e0e0e0e and e0e0e0e0f1f1f1f1 must be avoided.
2199 #.  .PP
2200 #.  There are six known half weak key pairs, which keys lead to the same
2201 #.  encrypted data.  Keys which are part of such key clusters should be
2202 #.  avoided.
2203 #.  Sorry, I could not find out what they are.
2204 #. "
2205 #.  .PP
2206 #.  Heavily redundant data causes trouble with DES encryption, when used in the
2207 #.  .I codebook
2208 #.  mode that
2209 #.  .BR crypt ()
2210 #.  implements.  The
2211 #.  .BR crypt ()
2212 #.  interface should be used only for its intended purpose of password
2213 #.  verification, and should not be used as part of a data encryption tool.
2214 #.  .PP
2215 #.  The first and last three output bits of the fourth S-box can be
2216 #.  represented as function of their input bits.  Empiric studies have
2217 #.  shown that S-boxes partially compute the same output for similar input.
2218 #.  It is suspected that this may contain a back door which could allow the
2219 #.  NSA to decrypt DES encrypted data.
2220 #.  .PP
2221 #.  Making encrypted data computed using crypt() publicly available has
2222 #.  to be considered insecure for the given reasons.
2223 #. type: Plain text
2224 #: build/C/man3/crypt.3:163
2225 msgid ""
2226 "The B<crypt>()  function was not implemented, probably because of "
2227 "U.S.A. export restrictions."
2228 msgstr ""
2229
2230 #. type: SH
2231 #: build/C/man3/crypt.3:163 build/C/man3/encrypt.3:124 build/C/man3/getlogin.3:140 build/C/man3/getusershell.3:93
2232 #, no-wrap
2233 msgid "ATTRIBUTES"
2234 msgstr ""
2235
2236 #. type: SS
2237 #: build/C/man3/crypt.3:164 build/C/man3/encrypt.3:125 build/C/man3/getlogin.3:141 build/C/man3/getusershell.3:94
2238 #, no-wrap
2239 msgid "Multithreading (see pthreads(7))"
2240 msgstr ""
2241
2242 #. type: Plain text
2243 #: build/C/man3/crypt.3:168
2244 msgid "The B<crypt>()  function is not thread-safe."
2245 msgstr ""
2246
2247 #. type: Plain text
2248 #: build/C/man3/crypt.3:172
2249 msgid "The B<crypt_r>()  function is thread-safe."
2250 msgstr ""
2251
2252 #. type: Plain text
2253 #: build/C/man3/crypt.3:177
2254 msgid "B<crypt>(): SVr4, 4.3BSD, POSIX.1-2001.  B<crypt_r>()  is a GNU extension."
2255 msgstr ""
2256
2257 #. type: SS
2258 #: build/C/man3/crypt.3:178 build/C/man2/gethostname.2:140
2259 #, no-wrap
2260 msgid "Glibc notes"
2261 msgstr ""
2262
2263 #. type: Plain text
2264 #: build/C/man3/crypt.3:181
2265 msgid ""
2266 "The glibc2 version of this function supports additional encryption "
2267 "algorithms."
2268 msgstr ""
2269
2270 #. type: Plain text
2271 #: build/C/man3/crypt.3:186
2272 msgid ""
2273 "If I<salt> is a character string starting with the characters \"$I<id>$\" "
2274 "followed by a string terminated by \"$\":"
2275 msgstr ""
2276
2277 #. type: Plain text
2278 #: build/C/man3/crypt.3:189
2279 msgid "$I<id>$I<salt>$I<encrypted>"
2280 msgstr ""
2281
2282 #. type: Plain text
2283 #: build/C/man3/crypt.3:198
2284 msgid ""
2285 "then instead of using the DES machine, I<id> identifies the encryption "
2286 "method used and this then determines how the rest of the password string is "
2287 "interpreted.  The following values of I<id> are supported:"
2288 msgstr ""
2289
2290 #. type: tbl table
2291 #: build/C/man3/crypt.3:201
2292 #, no-wrap
2293 msgid "ID  | Method\n"
2294 msgstr ""
2295
2296 #. type: tbl table
2297 #: build/C/man3/crypt.3:202 build/C/man2/syscall.2:157 build/C/man2/syscall.2:182
2298 #, no-wrap
2299 msgid "_\n"
2300 msgstr ""
2301
2302 #. type: tbl table
2303 #: build/C/man3/crypt.3:203
2304 #, no-wrap
2305 msgid "1   | MD5\n"
2306 msgstr ""
2307
2308 #. type: tbl table
2309 #: build/C/man3/crypt.3:204
2310 #, no-wrap
2311 msgid "2a  | Blowfish (not in mainline glibc; added in some\n"
2312 msgstr ""
2313
2314 #. type: tbl table
2315 #: build/C/man3/crypt.3:205
2316 #, no-wrap
2317 msgid "    | Linux distributions)\n"
2318 msgstr ""
2319
2320 #.  openSUSE has Blowfish, but AFAICS, this option is not supported
2321 #.  natively by glibc -- mtk, Jul 08
2322 #
2323 #.  md5 | Sun MD5
2324 #.  glibc doesn't appear to natively support Sun MD5; I don't know
2325 #.  if any distros add the support.
2326 #. type: tbl table
2327 #: build/C/man3/crypt.3:212
2328 #, no-wrap
2329 msgid "5   | SHA-256 (since glibc 2.7)\n"
2330 msgstr ""
2331
2332 #. type: tbl table
2333 #: build/C/man3/crypt.3:213
2334 #, no-wrap
2335 msgid "6   | SHA-512 (since glibc 2.7)\n"
2336 msgstr ""
2337
2338 #. type: Plain text
2339 #: build/C/man3/crypt.3:220
2340 msgid ""
2341 "So $5$I<salt>$I<encrypted> is an SHA-256 encoded password and "
2342 "$6$I<salt>$I<encrypted> is an SHA-512 encoded one."
2343 msgstr ""
2344
2345 #. type: Plain text
2346 #: build/C/man3/crypt.3:225
2347 msgid ""
2348 "\"I<salt>\" stands for the up to 16 characters following \"$I<id>$\" in the "
2349 "salt.  The encrypted part of the password string is the actual computed "
2350 "password.  The size of this string is fixed:"
2351 msgstr ""
2352
2353 #. type: tbl table
2354 #: build/C/man3/crypt.3:227
2355 #, no-wrap
2356 msgid "MD5     | 22 characters\n"
2357 msgstr ""
2358
2359 #. type: tbl table
2360 #: build/C/man3/crypt.3:228
2361 #, no-wrap
2362 msgid "SHA-256 | 43 characters\n"
2363 msgstr ""
2364
2365 #. type: tbl table
2366 #: build/C/man3/crypt.3:229
2367 #, no-wrap
2368 msgid "SHA-512 | 86 characters\n"
2369 msgstr ""
2370
2371 #. type: Plain text
2372 #: build/C/man3/crypt.3:238
2373 msgid ""
2374 "The characters in \"I<salt>\" and \"I<encrypted>\" are drawn from the set "
2375 "[B<a>\\(enB<zA>\\(enB<Z0>\\(enB<9./>].  In the MD5 and SHA implementations "
2376 "the entire I<key> is significant (instead of only the first 8 bytes in DES)."
2377 msgstr ""
2378
2379 #. type: Plain text
2380 #: build/C/man3/crypt.3:244
2381 msgid "B<login>(1), B<passwd>(1), B<encrypt>(3), B<getpass>(3), B<passwd>(5)"
2382 msgstr ""
2383
2384 #. type: TH
2385 #: build/C/man3/daemon.3:36
2386 #, no-wrap
2387 msgid "DAEMON"
2388 msgstr ""
2389
2390 #. type: TH
2391 #: build/C/man3/daemon.3:36
2392 #, no-wrap
2393 msgid "2009-12-05"
2394 msgstr ""
2395
2396 #. type: Plain text
2397 #: build/C/man3/daemon.3:39
2398 msgid "daemon - run in the background"
2399 msgstr ""
2400
2401 #. type: Plain text
2402 #: build/C/man3/daemon.3:43
2403 msgid "B<int daemon(int >I<nochdir>B<, int >I<noclose>B<);>"
2404 msgstr ""
2405
2406 #. type: Plain text
2407 #: build/C/man3/daemon.3:51
2408 msgid "B<daemon>(): _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\\ E<lt>\\ 500)"
2409 msgstr ""
2410
2411 #. type: Plain text
2412 #: build/C/man3/daemon.3:56
2413 msgid ""
2414 "The B<daemon>()  function is for programs wishing to detach themselves from "
2415 "the controlling terminal and run in the background as system daemons."
2416 msgstr ""
2417
2418 #. type: Plain text
2419 #: build/C/man3/daemon.3:64
2420 msgid ""
2421 "If I<nochdir> is zero, B<daemon>()  changes the calling process's current "
2422 "working directory to the root directory (\"/\"); otherwise, the current "
2423 "working directory is left unchanged."
2424 msgstr ""
2425
2426 #. type: Plain text
2427 #: build/C/man3/daemon.3:73
2428 msgid ""
2429 "If I<noclose> is zero, B<daemon>()  redirects standard input, standard "
2430 "output and standard error to I</dev/null>; otherwise, no changes are made to "
2431 "these file descriptors."
2432 msgstr ""
2433
2434 #.  not .IR in order not to underline _
2435 #. type: Plain text
2436 #: build/C/man3/daemon.3:91
2437 msgid ""
2438 "(This function forks, and if the B<fork>(2)  succeeds, the parent calls "
2439 "B<_exit>(2), so that further errors are seen by the child only.)  On success "
2440 "B<daemon>()  returns zero.  If an error occurs, B<daemon>()  returns -1 and "
2441 "sets I<errno> to any of the errors specified for the B<fork>(2)  and "
2442 "B<setsid>(2)."
2443 msgstr ""
2444
2445 #. type: Plain text
2446 #: build/C/man3/daemon.3:97
2447 msgid ""
2448 "Not in POSIX.1-2001.  A similar function appears on the BSDs.  The "
2449 "B<daemon>()  function first appeared in 4.4BSD."
2450 msgstr ""
2451
2452 #. type: Plain text
2453 #: build/C/man3/daemon.3:105
2454 msgid ""
2455 "The glibc implementation can also return -1 when I</dev/null> exists but is "
2456 "not a character device with the expected major and minor numbers.  In this "
2457 "case I<errno> need not be set."
2458 msgstr ""
2459
2460 #. type: Plain text
2461 #: build/C/man3/daemon.3:108
2462 msgid "B<fork>(2), B<setsid>(2)"
2463 msgstr ""
2464
2465 #. type: TH
2466 #: build/C/man3/des_crypt.3:14
2467 #, no-wrap
2468 msgid "DES_CRYPT"
2469 msgstr ""
2470
2471 #. type: TH
2472 #: build/C/man3/des_crypt.3:14
2473 #, no-wrap
2474 msgid "2007-05-18"
2475 msgstr ""
2476
2477 #. type: Plain text
2478 #: build/C/man3/des_crypt.3:18
2479 msgid ""
2480 "des_crypt, ecb_crypt, cbc_crypt, des_setparity, DES_FAILED - fast DES "
2481 "encryption"
2482 msgstr ""
2483
2484 #.  Sun version
2485 #.  .B #include <des_crypt.h>
2486 #. type: Plain text
2487 #: build/C/man3/des_crypt.3:23
2488 #, no-wrap
2489 msgid "B<#include E<lt>rpc/des_crypt.hE<gt>>\n"
2490 msgstr ""
2491
2492 #. type: Plain text
2493 #: build/C/man3/des_crypt.3:26
2494 #, no-wrap
2495 msgid ""
2496 "B<int ecb_crypt(char *>I<key>B<, char *>I<data>B<, unsigned "
2497 ">I<datalen>B<,>\n"
2498 "B<              unsigned >I<mode>B<);>\n"
2499 msgstr ""
2500
2501 #. type: Plain text
2502 #: build/C/man3/des_crypt.3:29
2503 #, no-wrap
2504 msgid ""
2505 "B<int cbc_crypt(char *>I<key>B<, char *>I<data>B<, unsigned "
2506 ">I<datalen>B<,>\n"
2507 "B<              unsigned >I<mode>B<, char *>I<ivec>B<);>\n"
2508 msgstr ""
2509
2510 #. type: Plain text
2511 #: build/C/man3/des_crypt.3:31
2512 #, no-wrap
2513 msgid "B<void des_setparity(char *>I<key>B<);>\n"
2514 msgstr ""
2515
2516 #. type: Plain text
2517 #: build/C/man3/des_crypt.3:33
2518 #, no-wrap
2519 msgid "B<int DES_FAILED(int >I<status>B<);>\n"
2520 msgstr ""
2521
2522 #. type: Plain text
2523 #: build/C/man3/des_crypt.3:63
2524 msgid ""
2525 "B<ecb_crypt>()  and B<cbc_crypt>()  implement the NBS DES (Data Encryption "
2526 "Standard).  These routines are faster and more general purpose than "
2527 "B<crypt>(3).  They also are able to utilize DES hardware if it is "
2528 "available.  B<ecb_crypt>()  encrypts in ECB (Electronic Code Book)  mode, "
2529 "which encrypts blocks of data independently.  B<cbc_crypt>()  encrypts in "
2530 "CBC (Cipher Block Chaining)  mode, which chains together successive blocks.  "
2531 "CBC mode protects against insertions, deletions and substitutions of "
2532 "blocks.  Also, regularities in the clear text will not appear in the cipher "
2533 "text."
2534 msgstr ""
2535
2536 #. type: Plain text
2537 #: build/C/man3/des_crypt.3:106
2538 msgid ""
2539 "Here is how to use these routines.  The first argument, I<key>, is the "
2540 "8-byte encryption key with parity.  To set the key's parity, which for DES "
2541 "is in the low bit of each byte, use B<des_setparity>().  The second "
2542 "argument, I<data>, contains the data to be encrypted or decrypted.  The "
2543 "third argument, I<datalen>, is the length in bytes of I<data>, which must be "
2544 "a multiple of 8.  The fourth argument, I<mode>, is formed by ORing together "
2545 "some things.  For the encryption direction OR in either B<DES_ENCRYPT> or "
2546 "B<DES_DECRYPT>.  For software versus hardware encryption, OR in either "
2547 "B<DES_HW> or B<DES_SW>.  If B<DES_HW> is specified, and there is no "
2548 "hardware, then the encryption is performed in software and the routine "
2549 "returns B<DESERR_NOHWDEVICE>.  For B<cbc_crypt>(), the argument I<ivec> is "
2550 "the 8-byte initialization vector for the chaining.  It is updated to the "
2551 "next initialization vector upon return."
2552 msgstr ""
2553
2554 #. type: TP
2555 #: build/C/man3/des_crypt.3:108
2556 #, no-wrap
2557 msgid "B<DESERR_NONE>"
2558 msgstr ""
2559
2560 #. type: Plain text
2561 #: build/C/man3/des_crypt.3:111
2562 msgid "No error."
2563 msgstr ""
2564
2565 #. type: TP
2566 #: build/C/man3/des_crypt.3:111
2567 #, no-wrap
2568 msgid "B<DESERR_NOHWDEVICE>"
2569 msgstr ""
2570
2571 #. type: Plain text
2572 #: build/C/man3/des_crypt.3:114
2573 msgid ""
2574 "Encryption succeeded, but done in software instead of the requested "
2575 "hardware."
2576 msgstr ""
2577
2578 #. type: TP
2579 #: build/C/man3/des_crypt.3:114
2580 #, no-wrap
2581 msgid "B<DESERR_HWERROR>"
2582 msgstr ""
2583
2584 #. type: Plain text
2585 #: build/C/man3/des_crypt.3:117
2586 msgid "An error occurred in the hardware or driver."
2587 msgstr ""
2588
2589 #. type: TP
2590 #: build/C/man3/des_crypt.3:117
2591 #, no-wrap
2592 msgid "B<DESERR_BADPARAM>"
2593 msgstr ""
2594
2595 #. type: Plain text
2596 #: build/C/man3/des_crypt.3:120
2597 msgid "Bad argument to routine."
2598 msgstr ""
2599
2600 #.  .BR DES_FAILED\c
2601 #.  .BR ( stat )
2602 #.  So far the Sun page
2603 #.  Some additions - aeb
2604 #. type: Plain text
2605 #: build/C/man3/des_crypt.3:131
2606 msgid ""
2607 "Given a result status I<stat>, the macro B<DES_FAILED(>I<stat>B<)> is false "
2608 "only for the first two statuses."
2609 msgstr ""
2610
2611 #. type: SH
2612 #: build/C/man3/des_crypt.3:131 build/C/man2/dup.2:165 build/C/man3/euidaccess.3:69 build/C/man3/exec.3:195 build/C/man2/exit_group.2:41 build/C/man3/fexecve.3:91 build/C/man2/get_thread_area.2:42 build/C/man2/gettid.2:54 build/C/man2/idle.2:59 build/C/man2/mincore.2:132 build/C/man2/pread.2:104 build/C/man2/set_thread_area.2:59 build/C/man2/setup.2:60
2613 #, no-wrap
2614 msgid "VERSIONS"
2615 msgstr ""
2616
2617 #. type: Plain text
2618 #: build/C/man3/des_crypt.3:134
2619 msgid ""
2620 "These routines are present in libc 4.6.27 and later, and in glibc 2.1 and "
2621 "later."
2622 msgstr ""
2623
2624 #. type: Plain text
2625 #: build/C/man3/des_crypt.3:137
2626 msgid "4.3BSD.  Not in POSIX.1-2001."
2627 msgstr ""
2628
2629 #. type: Plain text
2630 #: build/C/man3/des_crypt.3:141
2631 msgid "B<des>(1), B<crypt>(3), B<xcrypt>(3)"
2632 msgstr ""
2633
2634 #. type: TH
2635 #: build/C/man2/dup.2:36
2636 #, no-wrap
2637 msgid "DUP"
2638 msgstr ""
2639
2640 #. type: TH
2641 #: build/C/man2/dup.2:36
2642 #, no-wrap
2643 msgid "2012-02-14"
2644 msgstr ""
2645
2646 #. type: Plain text
2647 #: build/C/man2/dup.2:39
2648 msgid "dup, dup2, dup3 - duplicate a file descriptor"
2649 msgstr ""
2650
2651 #. type: Plain text
2652 #: build/C/man2/dup.2:45
2653 #, no-wrap
2654 msgid ""
2655 "B<int dup(int >I<oldfd>B<);>\n"
2656 "B<int dup2(int >I<oldfd>B<, int >I<newfd>B<);>\n"
2657 msgstr ""
2658
2659 #. type: Plain text
2660 #: build/C/man2/dup.2:49
2661 #, no-wrap
2662 msgid ""
2663 "B<#define _GNU_SOURCE>             /* See feature_test_macros(7) */\n"
2664 "B<#include E<lt>fcntl.hE<gt>>              /* Obtain O_* constant "
2665 "definitions */\n"
2666 "B<#include E<lt>unistd.hE<gt>>\n"
2667 msgstr ""
2668
2669 #. type: Plain text
2670 #: build/C/man2/dup.2:51
2671 #, no-wrap
2672 msgid "B<int dup3(int >I<oldfd>B<, int >I<newfd>B<, int >I<flags>B<);>\n"
2673 msgstr ""
2674
2675 #. type: Plain text
2676 #: build/C/man2/dup.2:55
2677 msgid "These system calls create a copy of the file descriptor I<oldfd>."
2678 msgstr ""
2679
2680 #. type: Plain text
2681 #: build/C/man2/dup.2:58
2682 msgid "B<dup>()  uses the lowest-numbered unused descriptor for the new descriptor."
2683 msgstr ""
2684
2685 #. type: Plain text
2686 #: build/C/man2/dup.2:62
2687 msgid ""
2688 "B<dup2>()  makes I<newfd> be the copy of I<oldfd>, closing I<newfd> first if "
2689 "necessary, but note the following:"
2690 msgstr ""
2691
2692 #. type: Plain text
2693 #: build/C/man2/dup.2:68
2694 msgid ""
2695 "If I<oldfd> is not a valid file descriptor, then the call fails, and "
2696 "I<newfd> is not closed."
2697 msgstr ""
2698
2699 #. type: Plain text
2700 #: build/C/man2/dup.2:79
2701 msgid ""
2702 "If I<oldfd> is a valid file descriptor, and I<newfd> has the same value as "
2703 "I<oldfd>, then B<dup2>()  does nothing, and returns I<newfd>."
2704 msgstr ""
2705
2706 #. type: Plain text
2707 #: build/C/man2/dup.2:88
2708 msgid ""
2709 "After a successful return from one of these system calls, the old and new "
2710 "file descriptors may be used interchangeably.  They refer to the same open "
2711 "file description (see B<open>(2))  and thus share file offset and file "
2712 "status flags; for example, if the file offset is modified by using "
2713 "B<lseek>(2)  on one of the descriptors, the offset is also changed for the "
2714 "other."
2715 msgstr ""
2716
2717 #. type: Plain text
2718 #: build/C/man2/dup.2:96
2719 msgid ""
2720 "The two descriptors do not share file descriptor flags (the close-on-exec "
2721 "flag).  The close-on-exec flag (B<FD_CLOEXEC>; see B<fcntl>(2))  for the "
2722 "duplicate descriptor is off."
2723 msgstr ""
2724
2725 #. type: Plain text
2726 #: build/C/man2/dup.2:101
2727 msgid "B<dup3>()  is the same as B<dup2>(), except that:"
2728 msgstr ""
2729
2730 #. type: Plain text
2731 #: build/C/man2/dup.2:110
2732 msgid ""
2733 "The caller can force the close-on-exec flag to be set for the new file "
2734 "descriptor by specifying B<O_CLOEXEC> in I<flags>.  See the description of "
2735 "the same flag in B<open>(2)  for reasons why this may be useful."
2736 msgstr ""
2737
2738 #.  FIXME . To confirm with Al Viro that this was intended, and its rationale
2739 #. type: Plain text
2740 #: build/C/man2/dup.2:120
2741 msgid "If I<oldfd> equals I<newfd>, then B<dup3>()  fails with the error B<EINVAL>."
2742 msgstr ""
2743
2744 #. type: Plain text
2745 #: build/C/man2/dup.2:126
2746 msgid ""
2747 "On success, these system calls return the new descriptor.  On error, -1 is "
2748 "returned, and I<errno> is set appropriately."
2749 msgstr ""
2750
2751 #. type: Plain text
2752 #: build/C/man2/dup.2:133
2753 msgid ""
2754 "I<oldfd> isn't an open file descriptor, or I<newfd> is out of the allowed "
2755 "range for file descriptors."
2756 msgstr ""
2757
2758 #. type: TP
2759 #: build/C/man2/dup.2:133 build/C/man2/swapon.2:114
2760 #, no-wrap
2761 msgid "B<EBUSY>"
2762 msgstr ""
2763
2764 #. type: Plain text
2765 #: build/C/man2/dup.2:143
2766 msgid ""
2767 "(Linux only) This may be returned by B<dup2>()  or B<dup3>()  during a race "
2768 "condition with B<open>(2)  and B<dup>()."
2769 msgstr ""
2770
2771 #. type: Plain text
2772 #: build/C/man2/dup.2:151
2773 msgid ""
2774 "The B<dup2>()  or B<dup3>()  call was interrupted by a signal; see "
2775 "B<signal>(7)."
2776 msgstr ""
2777
2778 #.  FIXME . To confirm with Al Viro that this was intended, and its rationale
2779 #. type: Plain text
2780 #: build/C/man2/dup.2:161
2781 msgid ""
2782 "(B<dup3>())  I<flags> contain an invalid value.  Or, I<oldfd> was equal to "
2783 "I<newfd>."
2784 msgstr ""
2785
2786 #. type: TP
2787 #: build/C/man2/dup.2:161 build/C/man2/execve.2:408 build/C/man2/fcntl.2:1132 build/C/man3/getlogin.3:105
2788 #, no-wrap
2789 msgid "B<EMFILE>"
2790 msgstr ""
2791
2792 #. type: Plain text
2793 #: build/C/man2/dup.2:165
2794 msgid ""
2795 "The process already has the maximum number of file descriptors open and "
2796 "tried to open a new one."
2797 msgstr ""
2798
2799 #. type: Plain text
2800 #: build/C/man2/dup.2:170
2801 msgid ""
2802 "B<dup3>()  was added to Linux in version 2.6.27; glibc support is available "
2803 "starting with version 2.9."
2804 msgstr ""
2805
2806 #. type: Plain text
2807 #: build/C/man2/dup.2:174
2808 msgid "B<dup>(), B<dup2>(): SVr4, 4.3BSD, POSIX.1-2001."
2809 msgstr ""
2810
2811 #.  SVr4 documents additional
2812 #.  EINTR and ENOLINK error conditions.  POSIX.1 adds EINTR.
2813 #.  The EBUSY return is Linux-specific.
2814 #. type: Plain text
2815 #: build/C/man2/dup.2:180
2816 msgid "B<dup3>()  is Linux-specific."
2817 msgstr ""
2818
2819 #. type: Plain text
2820 #: build/C/man2/dup.2:194
2821 msgid ""
2822 "The error returned by B<dup2>()  is different from that returned by "
2823 "B<fcntl(>..., B<F_DUPFD>, ...B<)> when I<newfd> is out of range.  On some "
2824 "systems B<dup2>()  also sometimes returns B<EINVAL> like B<F_DUPFD>."
2825 msgstr ""
2826
2827 #. type: Plain text
2828 #: build/C/man2/dup.2:207
2829 msgid ""
2830 "If I<newfd> was open, any errors that would have been reported at "
2831 "B<close>(2)  time are lost.  A careful programmer will not use B<dup2>()  or "
2832 "B<dup3>()  without closing I<newfd> first."
2833 msgstr ""
2834
2835 #. type: Plain text
2836 #: build/C/man2/dup.2:211
2837 msgid "B<close>(2), B<fcntl>(2), B<open>(2)"
2838 msgstr ""
2839
2840 #. type: TH
2841 #: build/C/man3/encrypt.3:30
2842 #, no-wrap
2843 msgid "ENCRYPT"
2844 msgstr ""
2845
2846 #. type: TH
2847 #: build/C/man3/encrypt.3:30
2848 #, no-wrap
2849 msgid "2013-07-22"
2850 msgstr ""
2851
2852 #. type: Plain text
2853 #: build/C/man3/encrypt.3:33
2854 msgid "encrypt, setkey, encrypt_r, setkey_r - encrypt 64-bit messages"
2855 msgstr ""
2856
2857 #. type: Plain text
2858 #: build/C/man3/encrypt.3:35 build/C/man3/encrypt.3:41
2859 msgid "B<#define _XOPEN_SOURCE> /* See feature_test_macros(7) */"
2860 msgstr ""
2861
2862 #. type: Plain text
2863 #: build/C/man3/encrypt.3:39
2864 msgid "B<void encrypt(char >I<block>B<[64], int >I<edflag>B<);>"
2865 msgstr ""
2866
2867 #. type: Plain text
2868 #: build/C/man3/encrypt.3:43
2869 msgid "B<#include E<lt>stdlib.hE<gt>>"
2870 msgstr ""
2871
2872 #. type: Plain text
2873 #: build/C/man3/encrypt.3:45
2874 msgid "B<void setkey(const char *>I<key>B<);>"
2875 msgstr ""
2876
2877 #. type: Plain text
2878 #: build/C/man3/encrypt.3:47 build/C/man3/getumask.3:33
2879 msgid "B<#define _GNU_SOURCE> /* See feature_test_macros(7) */"
2880 msgstr ""
2881
2882 #. type: Plain text
2883 #: build/C/man3/encrypt.3:49
2884 msgid "B<#include E<lt>crypt.hE<gt>>"
2885 msgstr ""
2886
2887 #. type: Plain text
2888 #: build/C/man3/encrypt.3:51
2889 msgid "B<void setkey_r(const char *>I<key>B<, struct crypt_data *>I<data>B<);>"
2890 msgstr ""
2891
2892 #. type: Plain text
2893 #: build/C/man3/encrypt.3:54
2894 msgid ""
2895 "B<void encrypt_r(char *>I<block>B<, int >I<edflag>B<, struct crypt_data "
2896 "*>I<data>B<);>"
2897 msgstr ""
2898
2899 #. type: Plain text
2900 #: build/C/man3/encrypt.3:56
2901 msgid "Each of these requires linking with I<-lcrypt>."
2902 msgstr ""
2903
2904 #. type: Plain text
2905 #: build/C/man3/encrypt.3:68
2906 msgid ""
2907 "These functions encrypt and decrypt 64-bit messages.  The B<setkey>()  "
2908 "function sets the key used by B<encrypt>().  The I<key> argument used here "
2909 "is an array of 64 bytes, each of which has numerical value 1 or 0.  The "
2910 "bytes key[n] where n=8*i-1 are ignored, so that the effective key length is "
2911 "56 bits."
2912 msgstr ""
2913
2914 #. type: Plain text
2915 #: build/C/man3/encrypt.3:80
2916 msgid ""
2917 "The B<encrypt>()  function modifies the passed buffer, encoding if I<edflag> "
2918 "is 0, and decoding if 1 is being passed.  Like the I<key> argument, also "
2919 "I<block> is a bit vector representation of the actual value that is "
2920 "encoded.  The result is returned in that same vector."
2921 msgstr ""
2922
2923 #. type: Plain text
2924 #: build/C/man3/encrypt.3:90
2925 msgid ""
2926 "These two functions are not reentrant, that is, the key data is kept in "
2927 "static storage.  The functions B<setkey_r>()  and B<encrypt_r>()  are the "
2928 "reentrant versions.  They use the following structure to hold the key data:"
2929 msgstr ""
2930
2931 #. type: Plain text
2932 #: build/C/man3/encrypt.3:105
2933 #, no-wrap
2934 msgid ""
2935 "struct crypt_data {\n"
2936 "    char     keysched[16 * 8];\n"
2937 "    char     sb0[32768];\n"
2938 "    char     sb1[32768];\n"
2939 "    char     sb2[32768];\n"
2940 "    char     sb3[32768];\n"
2941 "    char     crypt_3_buf[14];\n"
2942 "    char     current_salt[2];\n"
2943 "    long int current_saltbits;\n"
2944 "    int      direction;\n"
2945 "    int      initialized;\n"
2946 "};\n"
2947 msgstr ""
2948
2949 #. type: Plain text
2950 #: build/C/man3/encrypt.3:113
2951 msgid "Before calling B<setkey_r>()  set I<data-E<gt>initialized> to zero."
2952 msgstr ""
2953
2954 #. type: Plain text
2955 #: build/C/man3/encrypt.3:115
2956 msgid "These functions do not return any value."
2957 msgstr ""
2958
2959 #. type: Plain text
2960 #: build/C/man3/encrypt.3:120
2961 msgid ""
2962 "Set I<errno> to zero before calling the above functions.  On success, it is "
2963 "unchanged."
2964 msgstr ""
2965
2966 #. type: Plain text
2967 #: build/C/man3/encrypt.3:124
2968 msgid ""
2969 "The function is not provided.  (For example because of former USA export "
2970 "restrictions.)"
2971 msgstr ""
2972
2973 #. type: Plain text
2974 #: build/C/man3/encrypt.3:131
2975 msgid "The B<encrypt>()  and B<setkey>()  functions are not thread-safe."
2976 msgstr ""
2977
2978 #. type: Plain text
2979 #: build/C/man3/encrypt.3:137
2980 msgid "The B<encrypt_r>()  and B<setkey_r>()  functions are thread-safe."
2981 msgstr ""
2982
2983 #. type: Plain text
2984 #: build/C/man3/encrypt.3:148
2985 msgid ""
2986 "The functions B<encrypt>()  and B<setkey>()  conform to SVr4, SUSv2, and "
2987 "POSIX.1-2001.  The functions B<encrypt_r>()  and B<setkey_r>()  are GNU "
2988 "extensions."
2989 msgstr ""
2990
2991 #. type: Plain text
2992 #: build/C/man3/encrypt.3:150
2993 msgid "In glibc 2.2 these functions use the DES algorithm."
2994 msgstr ""
2995
2996 #. type: Plain text
2997 #: build/C/man3/encrypt.3:157
2998 msgid ""
2999 "You need to link with libcrypt to compile this example with glibc.  To do "
3000 "useful work the I<key[]> and I<txt[]> arrays must be filled with a useful "
3001 "bit pattern."
3002 msgstr ""
3003
3004 #. type: Plain text
3005 #: build/C/man3/encrypt.3:162
3006 #, no-wrap
3007 msgid ""
3008 "#define _XOPEN_SOURCE\n"
3009 "#include E<lt>unistd.hE<gt>\n"
3010 "#include E<lt>stdlib.hE<gt>\n"
3011 msgstr ""
3012
3013 #. type: Plain text
3014 #: build/C/man3/encrypt.3:168
3015 #, no-wrap
3016 msgid ""
3017 "int\n"
3018 "main(void)\n"
3019 "{\n"
3020 "    char key[64];      /* bit pattern for key */\n"
3021 "    char txt[64];      /* bit pattern for messages */\n"
3022 msgstr ""
3023
3024 #. type: Plain text
3025 #: build/C/man3/encrypt.3:173
3026 #, no-wrap
3027 msgid ""
3028 "    setkey(key);\n"
3029 "    encrypt(txt, 0);   /* encode */\n"
3030 "    encrypt(txt, 1);   /* decode */\n"
3031 "}\n"
3032 msgstr ""
3033
3034 #.  .BR fcrypt (3)
3035 #. type: Plain text
3036 #: build/C/man3/encrypt.3:179
3037 msgid "B<cbc_crypt>(3), B<crypt>(3), B<ecb_crypt>(3),"
3038 msgstr ""
3039
3040 #. type: TH
3041 #: build/C/man7/environ.7:34
3042 #, no-wrap
3043 msgid "ENVIRON"
3044 msgstr ""
3045
3046 #. type: TH
3047 #: build/C/man7/environ.7:34
3048 #, no-wrap
3049 msgid "2009-07-25"
3050 msgstr ""
3051
3052 #. type: Plain text
3053 #: build/C/man7/environ.7:37
3054 msgid "environ - user environment"
3055 msgstr ""
3056
3057 #. type: Plain text
3058 #: build/C/man7/environ.7:40
3059 #, no-wrap
3060 msgid "B<extern char **>I<environ>B<;>\n"
3061 msgstr ""
3062
3063 #. type: Plain text
3064 #: build/C/man7/environ.7:57
3065 msgid ""
3066 "The variable I<environ> points to an array of pointers to strings called the "
3067 "\"environment\".  The last pointer in this array has the value NULL.  (This "
3068 "variable must be declared in the user program, but is declared in the header "
3069 "file I<E<lt>unistd.hE<gt>> in case the header files came from libc4 or "
3070 "libc5, and in case they came from glibc and B<_GNU_SOURCE> was defined.)  "
3071 "This array of strings is made available to the process by the B<exec>(3)  "
3072 "call that started the process."
3073 msgstr ""
3074
3075 #. type: Plain text
3076 #: build/C/man7/environ.7:62
3077 msgid ""
3078 "By convention the strings in I<environ> have the form "
3079 "\"I<name>B<=>I<value>\".  Common examples are:"
3080 msgstr ""
3081
3082 #. type: TP
3083 #: build/C/man7/environ.7:62
3084 #, no-wrap
3085 msgid "B<USER>"
3086 msgstr ""
3087
3088 #. type: Plain text
3089 #: build/C/man7/environ.7:65
3090 msgid "The name of the logged-in user (used by some BSD-derived programs)."
3091 msgstr ""
3092
3093 #. type: TP
3094 #: build/C/man7/environ.7:65
3095 #, no-wrap
3096 msgid "B<LOGNAME>"
3097 msgstr ""
3098
3099 #. type: Plain text
3100 #: build/C/man7/environ.7:68
3101 msgid "The name of the logged-in user (used by some System-V derived programs)."
3102 msgstr ""
3103
3104 #. type: TP
3105 #: build/C/man7/environ.7:68
3106 #, no-wrap
3107 msgid "B<HOME>"
3108 msgstr ""
3109
3110 #. type: Plain text
3111 #: build/C/man7/environ.7:74
3112 msgid ""
3113 "A user's login directory, set by B<login>(1)  from the password file "
3114 "B<passwd>(5)."
3115 msgstr ""
3116
3117 #. type: TP
3118 #: build/C/man7/environ.7:74
3119 #, no-wrap
3120 msgid "B<LANG>"
3121 msgstr ""
3122
3123 #. type: Plain text
3124 #: build/C/man7/environ.7:88
3125 msgid ""
3126 "The name of a locale to use for locale categories when not overridden by "
3127 "B<LC_ALL> or more specific environment variables like B<LC_COLLATE>, "
3128 "B<LC_CTYPE>, B<LC_MESSAGES>, B<LC_MONETARY>, B<LC_NUMERIC>, B<LC_TIME>, cf.  "
3129 "B<locale>(5)."
3130 msgstr ""
3131
3132 #. type: TP
3133 #: build/C/man7/environ.7:88
3134 #, no-wrap
3135 msgid "B<PATH>"
3136 msgstr ""
3137
3138 #. type: Plain text
3139 #: build/C/man7/environ.7:103
3140 msgid ""
3141 "The sequence of directory prefixes that B<sh>(1)  and many other programs "
3142 "apply in searching for a file known by an incomplete pathname.  The prefixes "
3143 "are separated by \\(aqB<:>\\(aq.  (Similarly one has B<CDPATH> used by some "
3144 "shells to find the target of a change directory command, B<MANPATH> used by "
3145 "B<man>(1)  to find manual pages, and so on)"
3146 msgstr ""
3147
3148 #. type: TP
3149 #: build/C/man7/environ.7:103
3150 #, no-wrap
3151 msgid "B<PWD>"
3152 msgstr ""
3153
3154 #. type: Plain text
3155 #: build/C/man7/environ.7:107
3156 msgid "The current working directory.  Set by some shells."
3157 msgstr ""
3158
3159 #. type: TP
3160 #: build/C/man7/environ.7:107
3161 #, no-wrap
3162 msgid "B<SHELL>"
3163 msgstr ""
3164
3165 #. type: Plain text
3166 #: build/C/man7/environ.7:110
3167 msgid "The pathname of the user's login shell."
3168 msgstr ""
3169
3170 #. type: TP
3171 #: build/C/man7/environ.7:110
3172 #, no-wrap
3173 msgid "B<TERM>"
3174 msgstr ""
3175
3176 #. type: Plain text
3177 #: build/C/man7/environ.7:113
3178 msgid "The terminal type for which output is to be prepared."
3179 msgstr ""
3180
3181 #. type: TP
3182 #: build/C/man7/environ.7:113
3183 #, no-wrap
3184 msgid "B<PAGER>"
3185 msgstr ""
3186
3187 #. type: Plain text
3188 #: build/C/man7/environ.7:116
3189 msgid "The user's preferred utility to display text files."
3190 msgstr ""
3191
3192 #. type: TP
3193 #: build/C/man7/environ.7:116
3194 #, no-wrap
3195 msgid "B<EDITOR>/B<VISUAL>"
3196 msgstr ""
3197
3198 #.  .TP
3199 #.  .B BROWSER
3200 #.  The user's preferred utility to browse URLs. Sequence of colon-separated
3201 #.  browser commands. See http://www.catb.org/~esr/BROWSER/ .
3202 #. type: Plain text
3203 #: build/C/man7/environ.7:123
3204 msgid "The user's preferred utility to edit text files."
3205 msgstr ""
3206
3207 #. type: Plain text
3208 #: build/C/man7/environ.7:141
3209 msgid ""
3210 "Further names may be placed in the environment by the I<export> command and "
3211 "\"name=value\" in B<sh>(1), or by the I<setenv> command if you use "
3212 "B<csh>(1).  Arguments may also be placed in the environment at the point of "
3213 "an B<exec>(3).  A C program can manipulate its environment using the "
3214 "functions B<getenv>(3), B<putenv>(3), B<setenv>(3), and B<unsetenv>(3)."
3215 msgstr ""
3216
3217 #. type: Plain text
3218 #: build/C/man7/environ.7:145
3219 msgid ""
3220 "Note that the behavior of many programs and library routines is influenced "
3221 "by the presence or value of certain environment variables.  A random "
3222 "collection:"
3223 msgstr ""
3224
3225 #. type: Plain text
3226 #: build/C/man7/environ.7:151
3227 msgid ""
3228 "The variables B<LANG>, B<LANGUAGE>, B<NLSPATH>, B<LOCPATH>, B<LC_ALL>, "
3229 "B<LC_MESSAGES>, etc. influence locale handling, cf.  B<locale>(5)."
3230 msgstr ""
3231
3232 #. type: Plain text
3233 #: build/C/man7/environ.7:158
3234 msgid ""
3235 "B<TMPDIR> influences the path prefix of names created by B<tmpnam>(3)  and "
3236 "other routines, the temporary directory used by B<sort>(1)  and other "
3237 "programs, etc."
3238 msgstr ""
3239
3240 #. type: Plain text
3241 #: build/C/man7/environ.7:162
3242 msgid ""
3243 "B<LD_LIBRARY_PATH>, B<LD_PRELOAD> and other LD_* variables influence the "
3244 "behavior of the dynamic loader/linker."
3245 msgstr ""
3246
3247 #. type: Plain text
3248 #: build/C/man7/environ.7:166
3249 msgid ""
3250 "B<POSIXLY_CORRECT> makes certain programs and library routines follow the "
3251 "prescriptions of POSIX."
3252 msgstr ""
3253
3254 #. type: Plain text
3255 #: build/C/man7/environ.7:172
3256 msgid "The behavior of B<malloc>(3)  is influenced by B<MALLOC_*> variables."
3257 msgstr ""
3258
3259 #. type: Plain text
3260 #: build/C/man7/environ.7:178
3261 msgid ""
3262 "The variable B<HOSTALIASES> gives the name of a file containing aliases to "
3263 "be used with B<gethostbyname>(3)."
3264 msgstr ""
3265
3266 #. type: Plain text
3267 #: build/C/man7/environ.7:189
3268 msgid ""
3269 "B<TZ> and B<TZDIR> give timezone information used by B<tzset>(3)  and "
3270 "through that by functions like B<ctime>(3), B<localtime>(3), B<mktime>(3), "
3271 "B<strftime>(3).  See also B<tzselect>(8)."
3272 msgstr ""
3273
3274 #. type: Plain text
3275 #: build/C/man7/environ.7:193
3276 msgid ""
3277 "B<TERMCAP> gives information on how to address a given terminal (or gives "
3278 "the name of a file containing such information)."
3279 msgstr ""
3280
3281 #. type: Plain text
3282 #: build/C/man7/environ.7:196
3283 msgid ""
3284 "B<COLUMNS> and B<LINES> tell applications about the window size, possibly "
3285 "overriding the actual size."
3286 msgstr ""
3287
3288 #. type: Plain text
3289 #: build/C/man7/environ.7:201
3290 msgid ""
3291 "B<PRINTER> or B<LPDEST> may specify the desired printer to use.  See "
3292 "B<lpr>(1)."
3293 msgstr ""
3294
3295 #. type: Plain text
3296 #: build/C/man7/environ.7:203
3297 msgid "Etc."
3298 msgstr ""
3299
3300 #. type: Plain text
3301 #: build/C/man7/environ.7:208
3302 msgid ""
3303 "Clearly there is a security risk here.  Many a system command has been "
3304 "tricked into mischief by a user who specified unusual values for B<IFS> or "
3305 "B<LD_LIBRARY_PATH>."
3306 msgstr ""
3307
3308 #. type: Plain text
3309 #: build/C/man7/environ.7:241
3310 msgid ""
3311 "There is also the risk of name space pollution.  Programs like I<make> and "
3312 "I<autoconf> allow overriding of default utility names from the environment "
3313 "with similarly named variables in all caps.  Thus one uses B<CC> to select "
3314 "the desired C compiler (and similarly B<MAKE>, B<AR>, B<AS>, B<FC>, B<LD>, "
3315 "B<LEX>, B<RM>, B<YACC>, etc.).  However, in some traditional uses such an "
3316 "environment variable gives options for the program instead of a pathname.  "
3317 "Thus, one has B<MORE>, B<LESS>, and B<GZIP>.  Such usage is considered "
3318 "mistaken, and to be avoided in new programs.  The authors of I<gzip> should "
3319 "consider renaming their option to B<GZIP_OPT>."
3320 msgstr ""
3321
3322 #. type: Plain text
3323 #: build/C/man7/environ.7:255
3324 msgid ""
3325 "B<bash>(1), B<csh>(1), B<login>(1), B<sh>(1), B<tcsh>(1), B<execve>(2), "
3326 "B<clearenv>(3), B<exec>(3), B<getenv>(3), B<putenv>(3), B<setenv>(3), "
3327 "B<unsetenv>(3), B<locale>(5)"
3328 msgstr ""
3329
3330 #. type: TH
3331 #: build/C/man3/euidaccess.3:25
3332 #, no-wrap
3333 msgid "EUIDACCESS"
3334 msgstr ""
3335
3336 #. type: TH
3337 #: build/C/man3/euidaccess.3:25 build/C/man3/getopt.3:41
3338 #, no-wrap
3339 msgid "2010-11-01"
3340 msgstr ""
3341
3342 #. type: Plain text
3343 #: build/C/man3/euidaccess.3:28
3344 msgid "euidaccess, eaccess - check effective user's permissions for a file"
3345 msgstr ""
3346
3347 #. type: Plain text
3348 #: build/C/man3/euidaccess.3:32
3349 #, no-wrap
3350 msgid ""
3351 "B<#define _GNU_SOURCE>             /* See feature_test_macros(7) */\n"
3352 "B<#include E<lt>unistd.hE<gt>>\n"
3353 msgstr ""
3354
3355 #. type: Plain text
3356 #: build/C/man3/euidaccess.3:35
3357 #, no-wrap
3358 msgid ""
3359 "B<int euidaccess(const char *>I<pathname>B<, int >I<mode>B<);>\n"
3360 "B<int eaccess(const char *>I<pathname>B<, int >I<mode>B<);>\n"
3361 msgstr ""
3362
3363 #. type: Plain text
3364 #: build/C/man3/euidaccess.3:47
3365 msgid ""
3366 "Like B<access>(2), B<euidaccess>()  checks permissions and existence of the "
3367 "file identified by its argument I<pathname>.  However, whereas B<access>(2), "
3368 "performs checks using the real user and group identifiers of the process, "
3369 "B<euidaccess>()  uses the effective identifiers."
3370 msgstr ""
3371
3372 #. type: Plain text
3373 #: build/C/man3/euidaccess.3:53
3374 msgid ""
3375 "I<mode> is a mask consisting of one or more of B<R_OK>, B<W_OK>, B<X_OK> and "
3376 "B<F_OK>, with the same meanings as for B<access>(2)."
3377 msgstr ""
3378
3379 #. type: Plain text
3380 #: build/C/man3/euidaccess.3:58
3381 msgid ""
3382 "B<eaccess>()  is a synonym for B<euidaccess>(), provided for compatibility "
3383 "with some other systems."
3384 msgstr ""
3385
3386 #. type: Plain text
3387 #: build/C/man3/euidaccess.3:66
3388 msgid ""
3389 "On success (all requested permissions granted), zero is returned.  On error "
3390 "(at least one bit in I<mode> asked for a permission that is denied, or some "
3391 "other error occurred), -1 is returned, and I<errno> is set appropriately."
3392 msgstr ""
3393
3394 #. type: Plain text
3395 #: build/C/man3/euidaccess.3:69
3396 msgid "As for B<access>(2)."
3397 msgstr ""
3398
3399 #. type: Plain text
3400 #: build/C/man3/euidaccess.3:73
3401 msgid "The B<eaccess>()  function was added to glibc in version 2.4."
3402 msgstr ""
3403
3404 #.  e.g., FreeBSD 6.1.
3405 #. type: Plain text
3406 #: build/C/man3/euidaccess.3:79
3407 msgid ""
3408 "These functions are nonstandard.  Some other systems have an B<eaccess>()  "
3409 "function."
3410 msgstr ""
3411
3412 #. type: Plain text
3413 #: build/C/man3/euidaccess.3:86
3414 msgid ""
3415 "I<Warning>: Using this function to check a process's permissions on a file "
3416 "before performing some operation based on that information leads to race "
3417 "conditions: the file permissions may change between the two steps.  "
3418 "Generally, it is safer just to attempt the desired operation and handle any "
3419 "permission error that occurs."
3420 msgstr ""
3421
3422 #. type: Plain text
3423 #: build/C/man3/euidaccess.3:94
3424 msgid ""
3425 "This function always dereferences symbolic links.  If you need to check the "
3426 "permissions on a symbolic link, use B<faccessat>(2)  with the flags "
3427 "B<AT_EACCESS> and B<AT_SYMLINK_NOFOLLOW>."
3428 msgstr ""
3429
3430 #. type: Plain text
3431 #: build/C/man3/euidaccess.3:105
3432 msgid ""
3433 "B<access>(2), B<chmod>(2), B<chown>(2), B<faccessat>(2), B<open>(2), "
3434 "B<setgid>(2), B<setuid>(2), B<stat>(2), B<credentials>(7), "
3435 "B<path_resolution>(7)"
3436 msgstr ""
3437
3438 #. type: TH
3439 #: build/C/man3/exec.3:41
3440 #, no-wrap
3441 msgid "EXEC"
3442 msgstr ""
3443
3444 #. type: TH
3445 #: build/C/man3/exec.3:41
3446 #, no-wrap
3447 msgid "2010-09-25"
3448 msgstr ""
3449
3450 #. type: Plain text
3451 #: build/C/man3/exec.3:44
3452 msgid "execl, execlp, execle, execv, execvp, execvpe - execute a file"
3453 msgstr ""
3454
3455 #. type: Plain text
3456 #: build/C/man3/exec.3:48
3457 msgid "B<extern char **environ;>"
3458 msgstr ""
3459
3460 #. type: Plain text
3461 #: build/C/man3/exec.3:50
3462 msgid "B<int execl(const char *>I<path>B<, const char *>I<arg>B<, ...);>"
3463 msgstr ""
3464
3465 #. type: Plain text
3466 #: build/C/man3/exec.3:52
3467 msgid "B<int execlp(const char *>I<file>B<, const char *>I<arg>B<, ...);>"
3468 msgstr ""
3469
3470 #. type: Plain text
3471 #: build/C/man3/exec.3:54
3472 msgid "B<int execle(const char *>I<path>B<, const char *>I<arg>B<,>"
3473 msgstr ""
3474
3475 #. type: Plain text
3476 #: build/C/man3/exec.3:56
3477 msgid "B< ..., char * const >I<envp>B<[]);>"
3478 msgstr ""
3479
3480 #. type: Plain text
3481 #: build/C/man3/exec.3:58
3482 msgid "B<int execv(const char *>I<path>B<, char *const >I<argv>B<[]);>"
3483 msgstr ""
3484
3485 #. type: Plain text
3486 #: build/C/man3/exec.3:60
3487 msgid "B<int execvp(const char *>I<file>B<, char *const >I<argv>B<[]);>"
3488 msgstr ""
3489
3490 #. type: Plain text
3491 #: build/C/man3/exec.3:62
3492 msgid "B<int execvpe(const char *>I<file>B<, char *const >I<argv>B<[],>"
3493 msgstr ""
3494
3495 #. type: Plain text
3496 #: build/C/man3/exec.3:64 build/C/man2/execve.2:46
3497 msgid "B< char *const >I<envp>B<[]);>"
3498 msgstr ""
3499
3500 #. type: Plain text
3501 #: build/C/man3/exec.3:72
3502 msgid "B<execvpe>(): _GNU_SOURCE"
3503 msgstr ""
3504
3505 #. type: Plain text
3506 #: build/C/man3/exec.3:82
3507 msgid ""
3508 "The B<exec>()  family of functions replaces the current process image with a "
3509 "new process image.  The functions described in this manual page are "
3510 "front-ends for B<execve>(2).  (See the manual page for B<execve>(2)  for "
3511 "further details about the replacement of the current process image.)"
3512 msgstr ""
3513
3514 #. type: Plain text
3515 #: build/C/man3/exec.3:85
3516 msgid ""
3517 "The initial argument for these functions is the name of a file that is to be "
3518 "executed."
3519 msgstr ""
3520
3521 #. type: Plain text
3522 #: build/C/man3/exec.3:107
3523 msgid ""
3524 "The I<const char\\ *arg> and subsequent ellipses in the B<execl>(), "
3525 "B<execlp>(), and B<execle>()  functions can be thought of as I<arg0>, "
3526 "I<arg1>, \\&..., I<argn>.  Together they describe a list of one or more "
3527 "pointers to null-terminated strings that represent the argument list "
3528 "available to the executed program.  The first argument, by convention, "
3529 "should point to the filename associated with the file being executed.  The "
3530 "list of arguments I<must> be terminated by a NULL pointer, and, since these "
3531 "are variadic functions, this pointer must be cast I<(char\\ *) NULL>."
3532 msgstr ""
3533
3534 #. type: Plain text
3535 #: build/C/man3/exec.3:120
3536 msgid ""
3537 "The B<execv>(), B<execvp>(), and B<execvpe>()  functions provide an array of "
3538 "pointers to null-terminated strings that represent the argument list "
3539 "available to the new program.  The first argument, by convention, should "
3540 "point to the filename associated with the file being executed.  The array of "
3541 "pointers I<must> be terminated by a NULL pointer."
3542 msgstr ""
3543
3544 #. type: Plain text
3545 #: build/C/man3/exec.3:137
3546 msgid ""
3547 "The B<execle>()  and B<execvpe>()  functions allow the caller to specify the "
3548 "environment of the executed program via the argument I<envp>.  The I<envp> "
3549 "argument is an array of pointers to null-terminated strings and I<must> be "
3550 "terminated by a NULL pointer.  The other functions take the environment for "
3551 "the new process image from the external variable I<environ> in the calling "
3552 "process."
3553 msgstr ""
3554
3555 #. type: SS
3556 #: build/C/man3/exec.3:137
3557 #, no-wrap
3558 msgid "Special semantics for execlp() and execvp()"
3559 msgstr ""
3560
3561 #. type: Plain text
3562 #: build/C/man3/exec.3:157
3563 msgid ""
3564 "The B<execlp>(), B<execvp>(), and B<execvpe>()  functions duplicate the "
3565 "actions of the shell in searching for an executable file if the specified "
3566 "filename does not contain a slash (/) character.  The file is sought in the "
3567 "colon-separated list of directory pathnames specified in the B<PATH> "
3568 "environment variable.  If this variable isn't defined, the path list "
3569 "defaults to the current directory followed by the list of directories "
3570 "returned by I<confstr(_CS_PATH)>.  (This B<confstr>(3)  call typically "
3571 "returns the value \"/bin:/usr/bin\".)"
3572 msgstr ""
3573
3574 #. type: Plain text
3575 #: build/C/man3/exec.3:161
3576 msgid ""
3577 "If the specified filename includes a slash character, then B<PATH> is "
3578 "ignored, and the file at the specified pathname is executed."
3579 msgstr ""
3580
3581 #. type: Plain text
3582 #: build/C/man3/exec.3:163
3583 msgid "In addition, certain errors are treated specially."
3584 msgstr ""
3585
3586 #. type: Plain text
3587 #: build/C/man3/exec.3:174
3588 msgid ""
3589 "If permission is denied for a file (the attempted B<execve>(2)  failed with "
3590 "the error B<EACCES>), these functions will continue searching the rest of "
3591 "the search path.  If no other file is found, however, they will return with "
3592 "I<errno> set to B<EACCES>."
3593 msgstr ""
3594
3595 #. type: Plain text
3596 #: build/C/man3/exec.3:183
3597 msgid ""
3598 "If the header of a file isn't recognized (the attempted B<execve>(2)  failed "
3599 "with the error B<ENOEXEC>), these functions will execute the shell "
3600 "(I</bin/sh>)  with the path of the file as its first argument.  (If this "
3601 "attempt fails, no further searching is done.)"
3602 msgstr ""
3603
3604 #. type: Plain text
3605 #: build/C/man3/exec.3:190
3606 msgid ""
3607 "The B<exec>()  functions return only if an error has occurred.  The return "
3608 "value is -1, and I<errno> is set to indicate the error."
3609 msgstr ""
3610
3611 #. type: Plain text
3612 #: build/C/man3/exec.3:195
3613 msgid ""
3614 "All of these functions may fail and set I<errno> for any of the errors "
3615 "specified for B<execve>(2)."
3616 msgstr ""
3617
3618 #. type: Plain text
3619 #: build/C/man3/exec.3:199
3620 msgid "The B<execvpe>()  function first appeared in glibc 2.11."
3621 msgstr ""
3622
3623 #. type: Plain text
3624 #: build/C/man3/exec.3:201
3625 msgid "POSIX.1-2001, POSIX.1-2008."
3626 msgstr ""
3627
3628 #. type: Plain text
3629 #: build/C/man3/exec.3:205
3630 msgid "The B<execvpe>()  function is a GNU extension."
3631 msgstr ""
3632
3633 #. type: Plain text
3634 #: build/C/man3/exec.3:215
3635 msgid ""
3636 "On some other systems, the default path (used when the environment does not "
3637 "contain the variable B<PATH>) has the current working directory listed after "
3638 "I</bin> and I</usr/bin>, as an anti-Trojan-horse measure.  Linux uses here "
3639 "the traditional \"current directory first\" default path."
3640 msgstr ""
3641
3642 #. type: Plain text
3643 #: build/C/man3/exec.3:229
3644 msgid ""
3645 "The behavior of B<execlp>()  and B<execvp>()  when errors occur while "
3646 "attempting to execute the file is historic practice, but has not "
3647 "traditionally been documented and is not specified by the POSIX standard.  "
3648 "BSD (and possibly other systems) do an automatic sleep and retry if "
3649 "B<ETXTBSY> is encountered.  Linux treats it as a hard error and returns "
3650 "immediately."
3651 msgstr ""
3652
3653 #. type: Plain text
3654 #: build/C/man3/exec.3:241
3655 msgid ""
3656 "Traditionally, the functions B<execlp>()  and B<execvp>()  ignored all "
3657 "errors except for the ones described above and B<ENOMEM> and B<E2BIG>, upon "
3658 "which they returned.  They now return if any error other than the ones "
3659 "described above occurs."
3660 msgstr ""
3661
3662 #. type: Plain text
3663 #: build/C/man3/exec.3:248
3664 msgid ""
3665 "B<sh>(1), B<execve>(2), B<fork>(2), B<ptrace>(2), B<fexecve>(3), "
3666 "B<environ>(7)"
3667 msgstr ""
3668
3669 #. type: TH
3670 #: build/C/man2/execve.2:37
3671 #, no-wrap
3672 msgid "EXECVE"
3673 msgstr ""
3674
3675 #. type: TH
3676 #: build/C/man2/execve.2:37
3677 #, no-wrap
3678 msgid "2013-07-04"
3679 msgstr ""
3680
3681 #. type: Plain text
3682 #: build/C/man2/execve.2:40
3683 msgid "execve - execute program"
3684 msgstr ""
3685
3686 #. type: Plain text
3687 #: build/C/man2/execve.2:44
3688 msgid "B<int execve(const char *>I<filename>B<, char *const >I<argv>B<[], >"
3689 msgstr ""
3690
3691 #. type: Plain text
3692 #: build/C/man2/execve.2:51
3693 msgid ""
3694 "B<execve>()  executes the program pointed to by I<filename>.  I<filename> "
3695 "must be either a binary executable, or a script starting with a line of the "
3696 "form:"
3697 msgstr ""
3698
3699 #. type: Plain text
3700 #: build/C/man2/execve.2:55 build/C/man2/execve.2:267
3701 #, no-wrap
3702 msgid "B<#!> I<interpreter >[optional-arg]\n"
3703 msgstr ""
3704
3705 #. type: Plain text
3706 #: build/C/man2/execve.2:59
3707 msgid "For details of the latter case, see \"Interpreter scripts\" below."
3708 msgstr ""
3709
3710 #. type: Plain text
3711 #: build/C/man2/execve.2:68
3712 msgid ""
3713 "I<argv> is an array of argument strings passed to the new program.  By "
3714 "convention, the first of these strings should contain the filename "
3715 "associated with the file being executed.  I<envp> is an array of strings, "
3716 "conventionally of the form B<key=value>, which are passed as environment to "
3717 "the new program.  Both I<argv> and I<envp> must be terminated by a NULL "
3718 "pointer.  The argument vector and environment can be accessed by the called "
3719 "program's main function, when it is defined as:"
3720 msgstr ""
3721
3722 #. type: Plain text
3723 #: build/C/man2/execve.2:72
3724 #, no-wrap
3725 msgid "int main(int argc, char *argv[], char *envp[])\n"
3726 msgstr ""
3727
3728 #. type: Plain text
3729 #: build/C/man2/execve.2:79
3730 msgid ""
3731 "B<execve>()  does not return on success, and the text, data, bss, and stack "
3732 "of the calling process are overwritten by that of the program loaded."
3733 msgstr ""
3734
3735 #. type: Plain text
3736 #: build/C/man2/execve.2:83
3737 msgid ""
3738 "If the current program is being ptraced, a B<SIGTRAP> is sent to it after a "
3739 "successful B<execve>()."
3740 msgstr ""
3741
3742 #. type: Plain text
3743 #: build/C/man2/execve.2:98
3744 msgid ""
3745 "If the set-user-ID bit is set on the program file pointed to by I<filename>, "
3746 "and the underlying file system is not mounted I<nosuid> (the B<MS_NOSUID> "
3747 "flag for B<mount>(2)), and the calling process is not being ptraced, then "
3748 "the effective user ID of the calling process is changed to that of the owner "
3749 "of the program file.  Similarly, when the set-group-ID bit of the program "
3750 "file is set the effective group ID of the calling process is set to the "
3751 "group of the program file."
3752 msgstr ""
3753
3754 #. type: Plain text
3755 #: build/C/man2/execve.2:103
3756 msgid ""
3757 "The effective user ID of the process is copied to the saved set-user-ID; "
3758 "similarly, the effective group ID is copied to the saved set-group-ID.  This "
3759 "copying takes place after any effective ID changes that occur because of the "
3760 "set-user-ID and set-group-ID permission bits."
3761 msgstr ""
3762
3763 #. type: Plain text
3764 #: build/C/man2/execve.2:111
3765 msgid ""
3766 "If the executable is an a.out dynamically linked binary executable "
3767 "containing shared-library stubs, the Linux dynamic linker B<ld.so>(8)  is "
3768 "called at the start of execution to bring needed shared libraries into "
3769 "memory and link the executable with them."
3770 msgstr ""
3771
3772 #. type: Plain text
3773 #: build/C/man2/execve.2:120
3774 msgid ""
3775 "If the executable is a dynamically linked ELF executable, the interpreter "
3776 "named in the PT_INTERP segment is used to load the needed shared libraries.  "
3777 "This interpreter is typically I</lib/ld-linux.so.2> for binaries linked with "
3778 "glibc 2.  (For binaries linked with the old Linux libc5, the interpreter was "
3779 "typically I</lib/ld-linux.so.1>.)"
3780 msgstr ""
3781
3782 #. type: Plain text
3783 #: build/C/man2/execve.2:124
3784 msgid ""
3785 "All process attributes are preserved during an B<execve>(), except the "
3786 "following:"
3787 msgstr ""
3788
3789 #. type: Plain text
3790 #: build/C/man2/execve.2:128
3791 msgid ""
3792 "The dispositions of any signals that are being caught are reset to the "
3793 "default (B<signal>(7))."
3794 msgstr ""
3795
3796 #. type: Plain text
3797 #: build/C/man2/execve.2:131
3798 msgid "Any alternate signal stack is not preserved (B<sigaltstack>(2))."
3799 msgstr ""
3800
3801 #. type: Plain text
3802 #: build/C/man2/execve.2:134
3803 msgid "Memory mappings are not preserved (B<mmap>(2))."
3804 msgstr ""
3805
3806 #. type: Plain text
3807 #: build/C/man2/execve.2:137
3808 msgid "Attached System V shared memory segments are detached (B<shmat>(2))."
3809 msgstr ""
3810
3811 #. type: Plain text
3812 #: build/C/man2/execve.2:140
3813 msgid "POSIX shared memory regions are unmapped (B<shm_open>(3))."
3814 msgstr ""
3815
3816 #. type: Plain text
3817 #: build/C/man2/execve.2:143
3818 msgid "Open POSIX message queue descriptors are closed (B<mq_overview>(7))."
3819 msgstr ""
3820
3821 #. type: Plain text
3822 #: build/C/man2/execve.2:146
3823 msgid "Any open POSIX named semaphores are closed (B<sem_overview>(7))."
3824 msgstr ""
3825
3826 #. type: Plain text
3827 #: build/C/man2/execve.2:149
3828 msgid "POSIX timers are not preserved (B<timer_create>(2))."
3829 msgstr ""
3830
3831 #. type: Plain text
3832 #: build/C/man2/execve.2:152
3833 msgid "Any open directory streams are closed (B<opendir>(3))."
3834 msgstr ""
3835
3836 #. type: Plain text
3837 #: build/C/man2/execve.2:156
3838 msgid "Memory locks are not preserved (B<mlock>(2), B<mlockall>(2))."
3839 msgstr ""
3840
3841 #. type: Plain text
3842 #: build/C/man2/execve.2:160
3843 msgid "Exit handlers are not preserved (B<atexit>(3), B<on_exit>(3))."
3844 msgstr ""
3845
3846 #. type: Plain text
3847 #: build/C/man2/execve.2:163
3848 msgid "The floating-point environment is reset to the default (see B<fenv>(3))."
3849 msgstr ""
3850
3851 #. type: Plain text
3852 #: build/C/man2/execve.2:169
3853 msgid ""
3854 "The process attributes in the preceding list are all specified in "
3855 "POSIX.1-2001.  The following Linux-specific process attributes are also not "
3856 "preserved during an B<execve>():"
3857 msgstr ""
3858
3859 #. type: Plain text
3860 #: build/C/man2/execve.2:176
3861 msgid ""
3862 "The B<prctl>(2)  B<PR_SET_DUMPABLE> flag is set, unless a set-user-ID or "
3863 "set-group ID program is being executed, in which case it is cleared."
3864 msgstr ""
3865
3866 #. type: Plain text
3867 #: build/C/man2/execve.2:181
3868 msgid "The B<prctl>(2)  B<PR_SET_KEEPCAPS> flag is cleared."
3869 msgstr ""
3870
3871 #. type: Plain text
3872 #: build/C/man2/execve.2:188
3873 msgid ""
3874 "(Since Linux 2.4.36 / 2.6.23)  If a set-user-ID or set-group-ID program is "
3875 "being executed, then the parent death signal set by B<prctl>(2)  "
3876 "B<PR_SET_PDEATHSIG> flag is cleared."
3877 msgstr ""
3878
3879 #. type: Plain text
3880 #: build/C/man2/execve.2:195
3881 msgid ""
3882 "The process name, as set by B<prctl>(2)  B<PR_SET_NAME> (and displayed by "
3883 "I<ps\\ -o comm>), is reset to the name of the new executable file."
3884 msgstr ""
3885
3886 #. type: Plain text
3887 #: build/C/man2/execve.2:202
3888 msgid ""
3889 "The B<SECBIT_KEEP_CAPS> I<securebits> flag is cleared.  See "
3890 "B<capabilities>(7)."
3891 msgstr ""
3892
3893 #. type: Plain text
3894 #: build/C/man2/execve.2:207
3895 msgid "The termination signal is reset to B<SIGCHLD> (see B<clone>(2))."
3896 msgstr ""
3897
3898 #. type: Plain text
3899 #: build/C/man2/execve.2:209 build/C/man2/fork.2:133
3900 msgid "Note the following further points:"
3901 msgstr ""
3902
3903 #. type: Plain text
3904 #: build/C/man2/execve.2:213
3905 msgid ""
3906 "All threads other than the calling thread are destroyed during an "
3907 "B<execve>().  Mutexes, condition variables, and other pthreads objects are "
3908 "not preserved."
3909 msgstr ""
3910
3911 #. type: Plain text
3912 #: build/C/man2/execve.2:216
3913 msgid ""
3914 "The equivalent of I<setlocale(LC_ALL, \"C\")> is executed at program "
3915 "start-up."
3916 msgstr ""
3917
3918 #. type: Plain text
3919 #: build/C/man2/execve.2:224
3920 msgid ""
3921 "POSIX.1-2001 specifies that the dispositions of any signals that are ignored "
3922 "or set to the default are left unchanged.  POSIX.1-2001 specifies one "
3923 "exception: if B<SIGCHLD> is being ignored, then an implementation may leave "
3924 "the disposition unchanged or reset it to the default; Linux does the former."
3925 msgstr ""
3926
3927 #. type: Plain text
3928 #: build/C/man2/execve.2:228
3929 msgid ""
3930 "Any outstanding asynchronous I/O operations are canceled (B<aio_read>(3), "
3931 "B<aio_write>(3))."
3932 msgstr ""
3933
3934 #. type: Plain text
3935 #: build/C/man2/execve.2:233
3936 msgid "For the handling of capabilities during B<execve>(), see B<capabilities>(7)."
3937 msgstr ""
3938
3939 #.  On Linux it appears that these file descriptors are
3940 #.  always open after an execve(), and it looks like
3941 #.  Solaris 8 and FreeBSD 6.1 are the same. -- mtk, 30 Apr 2007
3942 #. type: Plain text
3943 #: build/C/man2/execve.2:260
3944 msgid ""
3945 "By default, file descriptors remain open across an B<execve>().  File "
3946 "descriptors that are marked close-on-exec are closed; see the description of "
3947 "B<FD_CLOEXEC> in B<fcntl>(2).  (If a file descriptor is closed, this will "
3948 "cause the release of all record locks obtained on the underlying file by "
3949 "this process.  See B<fcntl>(2)  for details.)  POSIX.1-2001 says that if "
3950 "file descriptors 0, 1, and 2 would otherwise be closed after a successful "
3951 "B<execve>(), and the process would gain privilege because the set-user_ID or "
3952 "set-group_ID permission bit was set on the executed file, then the system "
3953 "may open an unspecified file for each of these file descriptors.  As a "
3954 "general principle, no portable program, whether privileged or not, can "
3955 "assume that these three file descriptors will remain closed across an "
3956 "B<execve>()."
3957 msgstr ""
3958
3959 #. type: SS
3960 #: build/C/man2/execve.2:260
3961 #, no-wrap
3962 msgid "Interpreter scripts"
3963 msgstr ""
3964
3965 #. type: Plain text
3966 #: build/C/man2/execve.2:263
3967 msgid ""
3968 "An interpreter script is a text file that has execute permission enabled and "
3969 "whose first line is of the form:"
3970 msgstr ""
3971
3972 #. type: Plain text
3973 #: build/C/man2/execve.2:281
3974 msgid ""
3975 "The I<interpreter> must be a valid pathname for an executable which is not "
3976 "itself a script.  If the I<filename> argument of B<execve>()  specifies an "
3977 "interpreter script, then I<interpreter> will be invoked with the following "
3978 "arguments:"
3979 msgstr ""
3980
3981 #. type: Plain text
3982 #: build/C/man2/execve.2:285
3983 #, no-wrap
3984 msgid "I<interpreter> [optional-arg] I<filename> arg...\n"
3985 msgstr ""
3986
3987 #. type: Plain text
3988 #: build/C/man2/execve.2:294
3989 msgid ""
3990 "where I<arg...> is the series of words pointed to by the I<argv> argument of "
3991 "B<execve>()."
3992 msgstr ""
3993
3994 #. type: Plain text
3995 #: build/C/man2/execve.2:299
3996 msgid ""
3997 "For portable use, I<optional-arg> should either be absent, or be specified "
3998 "as a single word (i.e., it should not contain white space); see NOTES below."
3999 msgstr ""
4000
4001 #. type: SS
4002 #: build/C/man2/execve.2:299
4003 #, no-wrap
4004 msgid "Limits on size of arguments and environment"
4005 msgstr ""
4006
4007 #. type: Plain text
4008 #: build/C/man2/execve.2:312
4009 msgid ""
4010 "Most UNIX implementations impose some limit on the total size of the "
4011 "command-line argument (I<argv>)  and environment (I<envp>)  strings that may "
4012 "be passed to a new program.  POSIX.1 allows an implementation to advertise "
4013 "this limit using the B<ARG_MAX> constant (either defined in "
4014 "I<E<lt>limits.hE<gt>> or available at run time using the call "
4015 "I<sysconf(_SC_ARG_MAX)>)."
4016 msgstr ""
4017
4018 #. type: Plain text
4019 #: build/C/man2/execve.2:319
4020 msgid ""
4021 "On Linux prior to kernel 2.6.23, the memory used to store the environment "
4022 "and argument strings was limited to 32 pages (defined by the kernel constant "
4023 "B<MAX_ARG_PAGES>).  On architectures with a 4-kB page size, this yields a "
4024 "maximum size of 128 kB."
4025 msgstr ""
4026
4027 #.  For some background on the changes to ARG_MAX in kernels 2.6.23 and
4028 #.  2.6.25, see:
4029 #.      http://sourceware.org/bugzilla/show_bug.cgi?id=5786
4030 #.      http://bugzilla.kernel.org/show_bug.cgi?id=10095
4031 #.      http://thread.gmane.org/gmane.linux.kernel/646709/focus=648101,
4032 #.      checked into 2.6.25 as commit a64e715fc74b1a7dcc5944f848acc38b2c4d4ee2.
4033 #.  Ollie: That doesn't include the lists of pointers, though,
4034 #.  so the actual usage is a bit higher (1 pointer per argument).
4035 #. type: Plain text
4036 #: build/C/man2/execve.2:355
4037 msgid ""
4038 "On kernel 2.6.23 and later, most architectures support a size limit derived "
4039 "from the soft B<RLIMIT_STACK> resource limit (see B<getrlimit>(2))  that is "
4040 "in force at the time of the B<execve>()  call.  (Architectures with no "
4041 "memory management unit are excepted: they maintain the limit that was in "
4042 "effect before kernel 2.6.23.)  This change allows programs to have a much "
4043 "larger argument and/or environment list.  For these architectures, the total "
4044 "size is limited to 1/4 of the allowed stack size.  (Imposing the 1/4-limit "
4045 "ensures that the new program always has some stack space.)  Since Linux "
4046 "2.6.25, the kernel places a floor of 32 pages on this size limit, so that, "
4047 "even when B<RLIMIT_STACK> is set very low, applications are guaranteed to "
4048 "have at least as much argument and environment space as was provided by "
4049 "Linux 2.6.23 and earlier.  (This guarantee was not provided in Linux 2.6.23 "
4050 "and 2.6.24.)  Additionally, the limit per string is 32 pages (the kernel "
4051 "constant B<MAX_ARG_STRLEN>), and the maximum number of strings is "
4052 "0x7FFFFFFF."
4053 msgstr ""
4054
4055 #. type: Plain text
4056 #: build/C/man2/execve.2:361
4057 msgid ""
4058 "On success, B<execve>()  does not return, on error -1 is returned, and "
4059 "I<errno> is set appropriately."
4060 msgstr ""
4061
4062 #. type: TP
4063 #: build/C/man2/execve.2:362
4064 #, no-wrap
4065 msgid "B<E2BIG>"
4066 msgstr ""
4067
4068 #. type: Plain text
4069 #: build/C/man2/execve.2:369
4070 msgid ""
4071 "The total number of bytes in the environment (I<envp>)  and argument list "
4072 "(I<argv>)  is too large."
4073 msgstr ""
4074
4075 #. type: Plain text
4076 #: build/C/man2/execve.2:376
4077 msgid ""
4078 "Search permission is denied on a component of the path prefix of I<filename> "
4079 "or the name of a script interpreter.  (See also B<path_resolution>(7).)"
4080 msgstr ""
4081
4082 #. type: Plain text
4083 #: build/C/man2/execve.2:379
4084 msgid "The file or a script interpreter is not a regular file."
4085 msgstr ""
4086
4087 #. type: Plain text
4088 #: build/C/man2/execve.2:382
4089 msgid "Execute permission is denied for the file or a script or ELF interpreter."
4090 msgstr ""
4091
4092 #. type: Plain text
4093 #: build/C/man2/execve.2:386
4094 msgid "The file system is mounted I<noexec>."
4095 msgstr ""
4096
4097 #. type: Plain text
4098 #: build/C/man2/execve.2:390
4099 msgid "I<filename> points outside your accessible address space."
4100 msgstr ""
4101
4102 #. type: Plain text
4103 #: build/C/man2/execve.2:394
4104 msgid ""
4105 "An ELF executable had more than one PT_INTERP segment (i.e., tried to name "
4106 "more than one interpreter)."
4107 msgstr ""
4108
4109 #. type: TP
4110 #: build/C/man2/execve.2:397 build/C/man2/truncate.2:148
4111 #, no-wrap
4112 msgid "B<EISDIR>"
4113 msgstr ""
4114
4115 #. type: Plain text
4116 #: build/C/man2/execve.2:400
4117 msgid "An ELF interpreter was a directory."
4118 msgstr ""
4119
4120 #. type: TP
4121 #: build/C/man2/execve.2:400
4122 #, no-wrap
4123 msgid "B<ELIBBAD>"
4124 msgstr ""
4125
4126 #. type: Plain text
4127 #: build/C/man2/execve.2:403
4128 msgid "An ELF interpreter was not in a recognized format."
4129 msgstr ""
4130
4131 #. type: Plain text
4132 #: build/C/man2/execve.2:408
4133 msgid ""
4134 "Too many symbolic links were encountered in resolving I<filename> or the "
4135 "name of a script or ELF interpreter."
4136 msgstr ""
4137
4138 #. type: Plain text
4139 #: build/C/man2/execve.2:411
4140 msgid "The process has the maximum number of files open."
4141 msgstr ""
4142
4143 #. type: Plain text
4144 #: build/C/man2/execve.2:415
4145 msgid "I<filename> is too long."
4146 msgstr ""
4147
4148 #. type: TP
4149 #: build/C/man2/execve.2:415 build/C/man3/getlogin.3:108 build/C/man2/swapon.2:133 build/C/man2/uselib.2:67
4150 #, no-wrap
4151 msgid "B<ENFILE>"
4152 msgstr ""
4153
4154 #. type: Plain text
4155 #: build/C/man2/execve.2:418 build/C/man2/swapon.2:136 build/C/man2/uselib.2:70
4156 msgid "The system limit on the total number of open files has been reached."
4157 msgstr ""
4158
4159 #. type: Plain text
4160 #: build/C/man2/execve.2:424
4161 msgid ""
4162 "The file I<filename> or a script or ELF interpreter does not exist, or a "
4163 "shared library needed for file or interpreter cannot be found."
4164 msgstr ""
4165
4166 #. type: TP
4167 #: build/C/man2/execve.2:424 build/C/man2/uselib.2:70
4168 #, no-wrap
4169 msgid "B<ENOEXEC>"
4170 msgstr ""
4171
4172 #. type: Plain text
4173 #: build/C/man2/execve.2:429
4174 msgid ""
4175 "An executable is not in a recognized format, is for the wrong architecture, "
4176 "or has some other format error that means it cannot be executed."
4177 msgstr ""
4178
4179 #. type: Plain text
4180 #: build/C/man2/execve.2:437
4181 msgid ""
4182 "A component of the path prefix of I<filename> or a script or ELF interpreter "
4183 "is not a directory."
4184 msgstr ""
4185
4186 #. type: Plain text
4187 #: build/C/man2/execve.2:443
4188 msgid ""
4189 "The file system is mounted I<nosuid>, the user is not the superuser, and the "
4190 "file has the set-user-ID or set-group-ID bit set."
4191 msgstr ""
4192
4193 #. type: Plain text
4194 #: build/C/man2/execve.2:447
4195 msgid ""
4196 "The process is being traced, the user is not the superuser and the file has "
4197 "the set-user-ID or set-group-ID bit set."
4198 msgstr ""
4199
4200 #. type: Plain text
4201 #: build/C/man2/execve.2:450
4202 msgid "Executable was open for writing by one or more processes."
4203 msgstr ""
4204
4205 #.  SVr4 documents additional error
4206 #.  conditions EAGAIN, EINTR, ELIBACC, ENOLINK, EMULTIHOP; POSIX does not
4207 #.  document ETXTBSY, EPERM, EFAULT, ELOOP, EIO, ENFILE, EMFILE, EINVAL,
4208 #.  EISDIR or ELIBBAD error conditions.
4209 #. type: Plain text
4210 #: build/C/man2/execve.2:458
4211 msgid ""
4212 "SVr4, 4.3BSD, POSIX.1-2001.  POSIX.1-2001 does not document the #! behavior "
4213 "but is otherwise compatible."
4214 msgstr ""
4215
4216 #. type: Plain text
4217 #: build/C/man2/execve.2:461
4218 msgid "Set-user-ID and set-group-ID processes can not be B<ptrace>(2)d."
4219 msgstr ""
4220
4221 #. type: Plain text
4222 #: build/C/man2/execve.2:463
4223 msgid "Linux ignores the set-user-ID and set-group-ID bits on scripts."
4224 msgstr ""
4225
4226 #. type: Plain text
4227 #: build/C/man2/execve.2:474
4228 msgid ""
4229 "The result of mounting a file system I<nosuid> varies across Linux kernel "
4230 "versions: some will refuse execution of set-user-ID and set-group-ID "
4231 "executables when this would give the user powers she did not have already "
4232 "(and return B<EPERM>), some will just ignore the set-user-ID and "
4233 "set-group-ID bits and B<exec>()  successfully."
4234 msgstr ""
4235
4236 #. type: Plain text
4237 #: build/C/man2/execve.2:477
4238 msgid ""
4239 "A maximum line length of 127 characters is allowed for the first line in a "
4240 "#! executable shell script."
4241 msgstr ""
4242
4243 #.  e.g., Solaris 8
4244 #.  e.g., FreeBSD before 6.0, but not FreeBSD 6.0 onward
4245 #. type: Plain text
4246 #: build/C/man2/execve.2:496
4247 msgid ""
4248 "The semantics of the I<optional-arg> argument of an interpreter script vary "
4249 "across implementations.  On Linux, the entire string following the "
4250 "I<interpreter> name is passed as a single argument to the interpreter, and "
4251 "this string can include white space.  However, behavior differs on some "
4252 "other systems.  Some systems use the first white space to terminate "
4253 "I<optional-arg>.  On some systems, an interpreter script can have multiple "
4254 "arguments, and white spaces in I<optional-arg> are used to delimit the "
4255 "arguments."
4256 msgstr ""
4257
4258 #.  e.g., EFAULT on Solaris 8 and FreeBSD 6.1; but
4259 #.  HP-UX 11 is like Linux -- mtk, Apr 2007
4260 #.  Bug filed 30 Apr 2007: http://bugzilla.kernel.org/show_bug.cgi?id=8408
4261 #.  Bug rejected (because fix would constitute an ABI change).
4262 #. type: Plain text
4263 #: build/C/man2/execve.2:513
4264 msgid ""
4265 "On Linux, either I<argv> or I<envp> can be specified as NULL, which has the "
4266 "same effect as specifying these arguments as a pointer to a list containing "
4267 "a single NULL pointer.  B<Do not take advantage of this misfeature!> It is "
4268 "nonstandard and nonportable: on most other UNIX systems doing this will "
4269 "result in an error (B<EFAULT>)."
4270 msgstr ""
4271
4272 #
4273 #.  .SH BUGS
4274 #.  Some Linux versions have failed to check permissions on ELF
4275 #.  interpreters.  This is a security hole, because it allows users to
4276 #.  open any file, such as a rewinding tape device, for reading.  Some
4277 #.  Linux versions have also had other security holes in
4278 #.  .BR execve ()
4279 #.  that could be exploited for denial of service by a suitably crafted
4280 #.  ELF binary. There are no known problems with 2.0.34 or 2.2.15.
4281 #. type: Plain text
4282 #: build/C/man2/execve.2:533
4283 msgid ""
4284 "POSIX.1-2001 says that values returned by B<sysconf>(3)  should be invariant "
4285 "over the lifetime of a process.  However, since Linux 2.6.23, if the "
4286 "B<RLIMIT_STACK> resource limit changes, then the value reported by "
4287 "B<_SC_ARG_MAX> will also change, to reflect the fact that the limit on space "
4288 "for holding command-line arguments and environment variables has changed."
4289 msgstr ""
4290
4291 #. type: SS
4292 #: build/C/man2/execve.2:533
4293 #, no-wrap
4294 msgid "Historical"
4295 msgstr ""
4296
4297 #. type: Plain text
4298 #: build/C/man2/execve.2:544
4299 msgid ""
4300 "With UNIX V6 the argument list of an B<exec>()  call was ended by 0, while "
4301 "the argument list of I<main> was ended by -1.  Thus, this argument list was "
4302 "not directly usable in a further B<exec>()  call.  Since UNIX V7 both are "
4303 "NULL."
4304 msgstr ""
4305
4306 #. type: Plain text
4307 #: build/C/man2/execve.2:547
4308 msgid ""
4309 "The following program is designed to be execed by the second program below.  "
4310 "It just echoes its command-line one per line."
4311 msgstr ""
4312
4313 #. type: Plain text
4314 #: build/C/man2/execve.2:551
4315 #, no-wrap
4316 msgid "/* myecho.c */\n"
4317 msgstr ""
4318
4319 #. type: Plain text
4320 #: build/C/man2/execve.2:554
4321 #, no-wrap
4322 msgid ""
4323 "#include E<lt>stdio.hE<gt>\n"
4324 "#include E<lt>stdlib.hE<gt>\n"
4325 msgstr ""
4326
4327 #. type: Plain text
4328 #: build/C/man2/execve.2:559
4329 #, no-wrap
4330 msgid ""
4331 "int\n"
4332 "main(int argc, char *argv[])\n"
4333 "{\n"
4334 "    int j;\n"
4335 msgstr ""
4336
4337 #. type: Plain text
4338 #: build/C/man2/execve.2:562
4339 #, no-wrap
4340 msgid ""
4341 "    for (j = 0; j E<lt> argc; j++)\n"
4342 "        printf(\"argv[%d]: %s\\en\", j, argv[j]);\n"
4343 msgstr ""
4344
4345 #. type: Plain text
4346 #: build/C/man2/execve.2:570
4347 msgid ""
4348 "This program can be used to exec the program named in its command-line "
4349 "argument:"
4350 msgstr ""
4351
4352 #. type: Plain text
4353 #: build/C/man2/execve.2:574
4354 #, no-wrap
4355 msgid "/* execve.c */\n"
4356 msgstr ""
4357
4358 #. type: Plain text
4359 #: build/C/man2/execve.2:578
4360 #, no-wrap
4361 msgid ""
4362 "#include E<lt>stdio.hE<gt>\n"
4363 "#include E<lt>stdlib.hE<gt>\n"
4364 "#include E<lt>unistd.hE<gt>\n"
4365 msgstr ""
4366
4367 #. type: Plain text
4368 #: build/C/man2/execve.2:584
4369 #, no-wrap
4370 msgid ""
4371 "int\n"
4372 "main(int argc, char *argv[])\n"
4373 "{\n"
4374 "    char *newargv[] = { NULL, \"hello\", \"world\", NULL };\n"
4375 "    char *newenviron[] = { NULL };\n"
4376 msgstr ""
4377
4378 #. type: Plain text
4379 #: build/C/man2/execve.2:589
4380 #, no-wrap
4381 msgid ""
4382 "    if (argc != 2) {\n"
4383 "\tfprintf(stderr, \"Usage: %s E<lt>file-to-execE<gt>\\en\", argv[0]);\n"
4384 "\texit(EXIT_FAILURE);\n"
4385 "    }\n"
4386 msgstr ""
4387
4388 #. type: Plain text
4389 #: build/C/man2/execve.2:591
4390 #, no-wrap
4391 msgid "    newargv[0] = argv[1];\n"
4392 msgstr ""
4393
4394 #. type: Plain text
4395 #: build/C/man2/execve.2:596
4396 #, no-wrap
4397 msgid ""
4398 "    execve(argv[1], newargv, newenviron);\n"
4399 "    perror(\"execve\");   /* execve() only returns on error */\n"
4400 "    exit(EXIT_FAILURE);\n"
4401 "}\n"
4402 msgstr ""
4403
4404 #. type: Plain text
4405 #: build/C/man2/execve.2:600
4406 msgid "We can use the second program to exec the first as follows:"
4407 msgstr ""
4408
4409 #. type: Plain text
4410 #: build/C/man2/execve.2:609
4411 #, no-wrap
4412 msgid ""
4413 "$B< cc myecho.c -o myecho>\n"
4414 "$B< cc execve.c -o execve>\n"
4415 "$B< ./execve ./myecho>\n"
4416 "argv[0]: ./myecho\n"
4417 "argv[1]: hello\n"
4418 "argv[2]: world\n"
4419 msgstr ""
4420
4421 #. type: Plain text
4422 #: build/C/man2/execve.2:617
4423 msgid ""
4424 "We can also use these programs to demonstrate the use of a script "
4425 "interpreter.  To do this we create a script whose \"interpreter\" is our "
4426 "I<myecho> program:"
4427 msgstr ""
4428
4429 #. type: Plain text
4430 #: build/C/man2/execve.2:624
4431 #, no-wrap
4432 msgid ""
4433 "$B< cat E<gt> script.sh>\n"
4434 "B<#! ./myecho script-arg>\n"
4435 "B<^D>\n"
4436 "$B< chmod +x script.sh>\n"
4437 msgstr ""
4438
4439 #. type: Plain text
4440 #: build/C/man2/execve.2:628
4441 msgid "We can then use our program to exec the script:"
4442 msgstr ""
4443
4444 #. type: Plain text
4445 #: build/C/man2/execve.2:637
4446 #, no-wrap
4447 msgid ""
4448 "$B< ./execve ./script.sh>\n"
4449 "argv[0]: ./myecho\n"
4450 "argv[1]: script-arg\n"
4451 "argv[2]: ./script.sh\n"
4452 "argv[3]: hello\n"
4453 "argv[4]: world\n"
4454 msgstr ""
4455
4456 #. type: Plain text
4457 #: build/C/man2/execve.2:650
4458 msgid ""
4459 "B<chmod>(2), B<fork>(2), B<ptrace>(2), B<execl>(3), B<fexecve>(3), "
4460 "B<getopt>(3), B<credentials>(7), B<environ>(7), B<path_resolution>(7), "
4461 "B<ld.so>(8)"
4462 msgstr ""
4463
4464 #. type: TH
4465 #: build/C/man2/exit_group.2:25
4466 #, no-wrap
4467 msgid "EXIT_GROUP"
4468 msgstr ""
4469
4470 #. type: TH
4471 #: build/C/man2/exit_group.2:25
4472 #, no-wrap
4473 msgid "2008-11-27"
4474 msgstr ""
4475
4476 #. type: Plain text
4477 #: build/C/man2/exit_group.2:28
4478 msgid "exit_group - exit all threads in a process"
4479 msgstr ""
4480
4481 #. type: Plain text
4482 #: build/C/man2/exit_group.2:31
4483 #, no-wrap
4484 msgid "B<#include E<lt>linux/unistd.hE<gt>>\n"
4485 msgstr ""
4486
4487 #. type: Plain text
4488 #: build/C/man2/exit_group.2:33
4489 #, no-wrap
4490 msgid "B<void exit_group(int >I<status>B<);>\n"
4491 msgstr ""
4492
4493 #. type: Plain text
4494 #: build/C/man2/exit_group.2:39
4495 msgid ""
4496 "This system call is equivalent to B<exit>(2)  except that it terminates not "
4497 "only the calling thread, but all threads in the calling process's thread "
4498 "group."
4499 msgstr ""
4500
4501 #. type: Plain text
4502 #: build/C/man2/exit_group.2:41
4503 msgid "This system call does not return."
4504 msgstr ""
4505
4506 #. type: Plain text
4507 #: build/C/man2/exit_group.2:43
4508 msgid "This call is present since Linux 2.5.35."
4509 msgstr ""
4510
4511 #. type: Plain text
4512 #: build/C/man2/exit_group.2:45
4513 msgid "This call is Linux-specific."
4514 msgstr ""
4515
4516 #. type: Plain text
4517 #: build/C/man2/exit_group.2:49
4518 msgid ""
4519 "Since glibc 2.3, this is the system call invoked when the B<exit>(2)  "
4520 "wrapper function is called."
4521 msgstr ""
4522
4523 #. type: Plain text
4524 #: build/C/man2/exit_group.2:51
4525 msgid "B<exit>(2)"
4526 msgstr ""
4527
4528 #. type: TH
4529 #: build/C/man2/fcntl.2:61
4530 #, no-wrap
4531 msgid "FCNTL"
4532 msgstr ""
4533
4534 #. type: TH
4535 #: build/C/man2/fcntl.2:61
4536 #, no-wrap
4537 msgid "2012-04-15"
4538 msgstr ""
4539
4540 #. type: Plain text
4541 #: build/C/man2/fcntl.2:64
4542 msgid "fcntl - manipulate file descriptor"
4543 msgstr ""
4544
4545 #. type: Plain text
4546 #: build/C/man2/fcntl.2:68
4547 #, no-wrap
4548 msgid ""
4549 "B<#include E<lt>unistd.hE<gt>>\n"
4550 "B<#include E<lt>fcntl.hE<gt>>\n"
4551 msgstr ""
4552
4553 #. type: Plain text
4554 #: build/C/man2/fcntl.2:70
4555 #, no-wrap
4556 msgid "B<int fcntl(int >I<fd>B<, int >I<cmd>B<, ... /* >I<arg>B< */ );>\n"
4557 msgstr ""
4558
4559 #. type: Plain text
4560 #: build/C/man2/fcntl.2:77
4561 msgid ""
4562 "B<fcntl>()  performs one of the operations described below on the open file "
4563 "descriptor I<fd>.  The operation is determined by I<cmd>."
4564 msgstr ""
4565
4566 #. type: Plain text
4567 #: build/C/man2/fcntl.2:91
4568 msgid ""
4569 "B<fcntl>()  can take an optional third argument.  Whether or not this "
4570 "argument is required is determined by I<cmd>.  The required argument type is "
4571 "indicated in parentheses after each I<cmd> name (in most cases, the required "
4572 "type is I<int>, and we identify the argument using the name I<arg>), or "
4573 "I<void> is specified if the argument is not required."
4574 msgstr ""
4575
4576 #. type: SS
4577 #: build/C/man2/fcntl.2:91
4578 #, no-wrap
4579 msgid "Duplicating a file descriptor"
4580 msgstr ""
4581
4582 #. type: TP
4583 #: build/C/man2/fcntl.2:92
4584 #, no-wrap
4585 msgid "B<F_DUPFD> (I<int>)"
4586 msgstr ""
4587
4588 #. type: Plain text
4589 #: build/C/man2/fcntl.2:102
4590 msgid ""
4591 "Find the lowest numbered available file descriptor greater than or equal to "
4592 "I<arg> and make it be a copy of I<fd>.  This is different from B<dup2>(2), "
4593 "which uses exactly the descriptor specified."
4594 msgstr ""
4595
4596 #. type: Plain text
4597 #: build/C/man2/fcntl.2:104
4598 msgid "On success, the new descriptor is returned."
4599 msgstr ""
4600
4601 #. type: Plain text
4602 #: build/C/man2/fcntl.2:108
4603 msgid "See B<dup>(2)  for further details."
4604 msgstr ""
4605
4606 #. type: TP
4607 #: build/C/man2/fcntl.2:108
4608 #, no-wrap
4609 msgid "B<F_DUPFD_CLOEXEC> (I<int>; since Linux 2.6.24)"
4610 msgstr ""
4611
4612 #. type: Plain text
4613 #: build/C/man2/fcntl.2:125
4614 msgid ""
4615 "As for B<F_DUPFD>, but additionally set the close-on-exec flag for the "
4616 "duplicate descriptor.  Specifying this flag permits a program to avoid an "
4617 "additional B<fcntl>()  B<F_SETFD> operation to set the B<FD_CLOEXEC> flag.  "
4618 "For an explanation of why this flag is useful, see the description of "
4619 "B<O_CLOEXEC> in B<open>(2)."
4620 msgstr ""
4621
4622 #. type: SS
4623 #: build/C/man2/fcntl.2:125
4624 #, no-wrap
4625 msgid "File descriptor flags"
4626 msgstr ""
4627
4628 #. type: Plain text
4629 #: build/C/man2/fcntl.2:136
4630 msgid ""
4631 "The following commands manipulate the flags associated with a file "
4632 "descriptor.  Currently, only one such flag is defined: B<FD_CLOEXEC>, the "
4633 "close-on-exec flag.  If the B<FD_CLOEXEC> bit is 0, the file descriptor will "
4634 "remain open across an B<execve>(2), otherwise it will be closed."
4635 msgstr ""
4636
4637 #. type: TP
4638 #: build/C/man2/fcntl.2:136
4639 #, no-wrap
4640 msgid "B<F_GETFD> (I<void>)"
4641 msgstr ""
4642
4643 #. type: Plain text
4644 #: build/C/man2/fcntl.2:141
4645 msgid "Read the file descriptor flags; I<arg> is ignored."
4646 msgstr ""
4647
4648 #. type: TP
4649 #: build/C/man2/fcntl.2:141
4650 #, no-wrap
4651 msgid "B<F_SETFD> (I<int>)"
4652 msgstr ""
4653
4654 #. type: Plain text
4655 #: build/C/man2/fcntl.2:145
4656 msgid "Set the file descriptor flags to the value specified by I<arg>."
4657 msgstr ""
4658
4659 #. type: SS
4660 #: build/C/man2/fcntl.2:145
4661 #, no-wrap
4662 msgid "File status flags"
4663 msgstr ""
4664
4665 #.  or
4666 #.  .BR creat (2),
4667 #. type: Plain text
4668 #: build/C/man2/fcntl.2:160
4669 msgid ""
4670 "Each open file description has certain associated status flags, initialized "
4671 "by B<open>(2)  and possibly modified by B<fcntl>().  Duplicated file "
4672 "descriptors (made with B<dup>(2), B<fcntl>(F_DUPFD), B<fork>(2), etc.) refer "
4673 "to the same open file description, and thus share the same file status "
4674 "flags."
4675 msgstr ""
4676
4677 #. type: Plain text
4678 #: build/C/man2/fcntl.2:163
4679 msgid "The file status flags and their semantics are described in B<open>(2)."
4680 msgstr ""
4681
4682 #. type: TP
4683 #: build/C/man2/fcntl.2:163
4684 #, no-wrap
4685 msgid "B<F_GETFL> (I<void>)"
4686 msgstr ""
4687
4688 #. type: Plain text
4689 #: build/C/man2/fcntl.2:168
4690 msgid "Get the file access mode and the file status flags; I<arg> is ignored."
4691 msgstr ""
4692
4693 #. type: TP
4694 #: build/C/man2/fcntl.2:168
4695 #, no-wrap
4696 msgid "B<F_SETFL> (I<int>)"
4697 msgstr ""
4698
4699 #.  FIXME . According to POSIX.1-2001, O_SYNC should also be modifiable
4700 #.  via fcntl(2), but currently Linux does not permit this
4701 #.  See http://bugzilla.kernel.org/show_bug.cgi?id=5994
4702 #. type: Plain text
4703 #: build/C/man2/fcntl.2:191
4704 msgid ""
4705 "Set the file status flags to the value specified by I<arg>.  File access "
4706 "mode (B<O_RDONLY>, B<O_WRONLY>, B<O_RDWR>)  and file creation flags (i.e., "
4707 "B<O_CREAT>, B<O_EXCL>, B<O_NOCTTY>, B<O_TRUNC>)  in I<arg> are ignored.  On "
4708 "Linux this command can change only the B<O_APPEND>, B<O_ASYNC>, B<O_DIRECT>, "
4709 "B<O_NOATIME>, and B<O_NONBLOCK> flags."
4710 msgstr ""
4711
4712 #. type: SS
4713 #: build/C/man2/fcntl.2:191
4714 #, no-wrap
4715 msgid "Advisory locking"
4716 msgstr ""
4717
4718 #. type: Plain text
4719 #: build/C/man2/fcntl.2:199
4720 msgid ""
4721 "B<F_GETLK>, B<F_SETLK> and B<F_SETLKW> are used to acquire, release, and "
4722 "test for the existence of record locks (also known as file-segment or "
4723 "file-region locks).  The third argument, I<lock>, is a pointer to a "
4724 "structure that has at least the following fields (in unspecified order)."
4725 msgstr ""
4726
4727 #. type: Plain text
4728 #: build/C/man2/fcntl.2:214
4729 #, no-wrap
4730 msgid ""
4731 "struct flock {\n"
4732 "    ...\n"
4733 "    short l_type;    /* Type of lock: F_RDLCK,\n"
4734 "                        F_WRLCK, F_UNLCK */\n"
4735 "    short l_whence;  /* How to interpret l_start:\n"
4736 "                        SEEK_SET, SEEK_CUR, SEEK_END */\n"
4737 "    off_t l_start;   /* Starting offset for lock */\n"
4738 "    off_t l_len;     /* Number of bytes to lock */\n"
4739 "    pid_t l_pid;     /* PID of process blocking our lock\n"
4740 "                        (F_GETLK only) */\n"
4741 "    ...\n"
4742 "};\n"
4743 msgstr ""
4744
4745 #. type: Plain text
4746 #: build/C/man2/fcntl.2:222
4747 msgid ""
4748 "The I<l_whence>, I<l_start>, and I<l_len> fields of this structure specify "
4749 "the range of bytes we wish to lock.  Bytes past the end of the file may be "
4750 "locked, but not bytes before the start of the file."
4751 msgstr ""
4752
4753 #. type: Plain text
4754 #: build/C/man2/fcntl.2:242
4755 msgid ""
4756 "I<l_start> is the starting offset for the lock, and is interpreted relative "
4757 "to either: the start of the file (if I<l_whence> is B<SEEK_SET>); the "
4758 "current file offset (if I<l_whence> is B<SEEK_CUR>); or the end of the file "
4759 "(if I<l_whence> is B<SEEK_END>).  In the final two cases, I<l_start> can be "
4760 "a negative number provided the offset does not lie before the start of the "
4761 "file."
4762 msgstr ""
4763
4764 #. type: Plain text
4765 #: build/C/man2/fcntl.2:257
4766 msgid ""
4767 "I<l_len> specifies the number of bytes to be locked.  If I<l_len> is "
4768 "positive, then the range to be locked covers bytes I<l_start> up to and "
4769 "including I<l_start>+I<l_len>-I<1>.  Specifying 0 for I<l_len> has the "
4770 "special meaning: lock all bytes starting at the location specified by "
4771 "I<l_whence> and I<l_start> through to the end of file, no matter how large "
4772 "the file grows."
4773 msgstr ""
4774
4775 #. type: Plain text
4776 #: build/C/man2/fcntl.2:270
4777 msgid ""
4778 "POSIX.1-2001 allows (but does not require)  an implementation to support a "
4779 "negative I<l_len> value; if I<l_len> is negative, the interval described by "
4780 "I<lock> covers bytes I<l_start>+I<l_len> up to and including I<l_start>-1.  "
4781 "This is supported by Linux since kernel versions 2.4.21 and 2.5.49."
4782 msgstr ""
4783
4784 #. type: Plain text
4785 #: build/C/man2/fcntl.2:289
4786 msgid ""
4787 "The I<l_type> field can be used to place a read (B<F_RDLCK>)  or a write "
4788 "(B<F_WRLCK>)  lock on a file.  Any number of processes may hold a read lock "
4789 "(shared lock)  on a file region, but only one process may hold a write lock "
4790 "(exclusive lock).  An exclusive lock excludes all other locks, both shared "
4791 "and exclusive.  A single process can hold only one type of lock on a file "
4792 "region; if a new lock is applied to an already-locked region, then the "
4793 "existing lock is converted to the new lock type.  (Such conversions may "
4794 "involve splitting, shrinking, or coalescing with an existing lock if the "
4795 "byte range specified by the new lock does not precisely coincide with the "
4796 "range of the existing lock.)"
4797 msgstr ""
4798
4799 #. type: TP
4800 #: build/C/man2/fcntl.2:289
4801 #, no-wrap
4802 msgid "B<F_SETLK> (I<struct flock *>)"
4803 msgstr ""
4804
4805 #. type: Plain text
4806 #: build/C/man2/fcntl.2:312
4807 msgid ""
4808 "Acquire a lock (when I<l_type> is B<F_RDLCK> or B<F_WRLCK>)  or release a "
4809 "lock (when I<l_type> is B<F_UNLCK>)  on the bytes specified by the "
4810 "I<l_whence>, I<l_start>, and I<l_len> fields of I<lock>.  If a conflicting "
4811 "lock is held by another process, this call returns -1 and sets I<errno> to "
4812 "B<EACCES> or B<EAGAIN>."
4813 msgstr ""
4814
4815 #. type: TP
4816 #: build/C/man2/fcntl.2:312
4817 #, no-wrap
4818 msgid "B<F_SETLKW> (I<struct flock *>)"
4819 msgstr ""
4820
4821 #. type: Plain text
4822 #: build/C/man2/fcntl.2:326
4823 msgid ""
4824 "As for B<F_SETLK>, but if a conflicting lock is held on the file, then wait "
4825 "for that lock to be released.  If a signal is caught while waiting, then the "
4826 "call is interrupted and (after the signal handler has returned)  returns "
4827 "immediately (with return value -1 and I<errno> set to B<EINTR>; see "
4828 "B<signal>(7))."
4829 msgstr ""
4830
4831 #. type: TP
4832 #: build/C/man2/fcntl.2:326
4833 #, no-wrap
4834 msgid "B<F_GETLK> (I<struct flock *>)"
4835 msgstr ""
4836
4837 #. type: Plain text
4838 #: build/C/man2/fcntl.2:350
4839 msgid ""
4840 "On input to this call, I<lock> describes a lock we would like to place on "
4841 "the file.  If the lock could be placed, B<fcntl>()  does not actually place "
4842 "it, but returns B<F_UNLCK> in the I<l_type> field of I<lock> and leaves the "
4843 "other fields of the structure unchanged.  If one or more incompatible locks "
4844 "would prevent this lock being placed, then B<fcntl>()  returns details about "
4845 "one of these locks in the I<l_type>, I<l_whence>, I<l_start>, and I<l_len> "
4846 "fields of I<lock> and sets I<l_pid> to be the PID of the process holding "
4847 "that lock."
4848 msgstr ""
4849
4850 #. type: Plain text
4851 #: build/C/man2/fcntl.2:358
4852 msgid ""
4853 "In order to place a read lock, I<fd> must be open for reading.  In order to "
4854 "place a write lock, I<fd> must be open for writing.  To place both types of "
4855 "lock, open a file read-write."
4856 msgstr ""
4857
4858 #.  (Additional file descriptors referring to the same file
4859 #.  may have been obtained by calls to
4860 #.  .BR open "(2), " dup "(2), " dup2 "(2), or " fcntl ().)
4861 #. type: Plain text
4862 #: build/C/man2/fcntl.2:375
4863 msgid ""
4864 "As well as being removed by an explicit B<F_UNLCK>, record locks are "
4865 "automatically released when the process terminates or if it closes I<any> "
4866 "file descriptor referring to a file on which locks are held.  This is bad: "
4867 "it means that a process can lose the locks on a file like I</etc/passwd> or "
4868 "I</etc/mtab> when for some reason a library function decides to open, read "
4869 "and close it."
4870 msgstr ""
4871
4872 #. type: Plain text
4873 #: build/C/man2/fcntl.2:380
4874 msgid ""
4875 "Record locks are not inherited by a child created via B<fork>(2), but are "
4876 "preserved across an B<execve>(2)."
4877 msgstr ""
4878
4879 #. type: Plain text
4880 #: build/C/man2/fcntl.2:389
4881 msgid ""
4882 "Because of the buffering performed by the B<stdio>(3)  library, the use of "
4883 "record locking with routines in that package should be avoided; use "
4884 "B<read>(2)  and B<write>(2)  instead."
4885 msgstr ""
4886
4887 #. type: SS
4888 #: build/C/man2/fcntl.2:389
4889 #, no-wrap
4890 msgid "Mandatory locking"
4891 msgstr ""
4892
4893 #. type: Plain text
4894 #: build/C/man2/fcntl.2:393
4895 msgid ""
4896 "(Non-POSIX.)  The above record locks may be either advisory or mandatory, "
4897 "and are advisory by default."
4898 msgstr ""
4899
4900 #. type: Plain text
4901 #: build/C/man2/fcntl.2:396
4902 msgid ""
4903 "Advisory locks are not enforced and are useful only between cooperating "
4904 "processes."
4905 msgstr ""
4906
4907 #. type: Plain text
4908 #: build/C/man2/fcntl.2:415
4909 msgid ""
4910 "Mandatory locks are enforced for all processes.  If a process tries to "
4911 "perform an incompatible access (e.g., B<read>(2)  or B<write>(2))  on a file "
4912 "region that has an incompatible mandatory lock, then the result depends upon "
4913 "whether the B<O_NONBLOCK> flag is enabled for its open file description.  If "
4914 "the B<O_NONBLOCK> flag is not enabled, then system call is blocked until the "
4915 "lock is removed or converted to a mode that is compatible with the access.  "
4916 "If the B<O_NONBLOCK> flag is enabled, then the system call fails with the "
4917 "error B<EAGAIN>."
4918 msgstr ""
4919
4920 #. type: Plain text
4921 #: build/C/man2/fcntl.2:432
4922 msgid ""
4923 "To make use of mandatory locks, mandatory locking must be enabled both on "
4924 "the file system that contains the file to be locked, and on the file "
4925 "itself.  Mandatory locking is enabled on a file system using the \"-o mand\" "
4926 "option to B<mount>(8), or the B<MS_MANDLOCK> flag for B<mount>(2).  "
4927 "Mandatory locking is enabled on a file by disabling group execute permission "
4928 "on the file and enabling the set-group-ID permission bit (see B<chmod>(1)  "
4929 "and B<chmod>(2))."
4930 msgstr ""
4931
4932 #. type: Plain text
4933 #: build/C/man2/fcntl.2:435
4934 msgid ""
4935 "The Linux implementation of mandatory locking is unreliable.  See BUGS "
4936 "below."
4937 msgstr ""
4938
4939 #. type: SS
4940 #: build/C/man2/fcntl.2:435
4941 #, no-wrap
4942 msgid "Managing signals"
4943 msgstr ""
4944
4945 #. type: Plain text
4946 #: build/C/man2/fcntl.2:444
4947 msgid ""
4948 "B<F_GETOWN>, B<F_SETOWN>, B<F_GETOWN_EX>, B<F_SETOWN_EX>, B<F_GETSIG> and "
4949 "B<F_SETSIG> are used to manage I/O availability signals:"
4950 msgstr ""
4951
4952 #. type: TP
4953 #: build/C/man2/fcntl.2:444
4954 #, no-wrap
4955 msgid "B<F_GETOWN> (I<void>)"
4956 msgstr ""
4957
4958 #. type: Plain text
4959 #: build/C/man2/fcntl.2:457
4960 msgid ""
4961 "Return (as the function result)  the process ID or process group currently "
4962 "receiving B<SIGIO> and B<SIGURG> signals for events on file descriptor "
4963 "I<fd>.  Process IDs are returned as positive values; process group IDs are "
4964 "returned as negative values (but see BUGS below).  I<arg> is ignored."
4965 msgstr ""
4966
4967 #. type: TP
4968 #: build/C/man2/fcntl.2:457
4969 #, no-wrap
4970 msgid "B<F_SETOWN> (I<int>)"
4971 msgstr ""
4972
4973 #. type: Plain text
4974 #: build/C/man2/fcntl.2:474
4975 msgid ""
4976 "Set the process ID or process group ID that will receive B<SIGIO> and "
4977 "B<SIGURG> signals for events on file descriptor I<fd> to the ID given in "
4978 "I<arg>.  A process ID is specified as a positive value; a process group ID "
4979 "is specified as a negative value.  Most commonly, the calling process "
4980 "specifies itself as the owner (that is, I<arg> is specified as "
4981 "B<getpid>(2))."
4982 msgstr ""
4983
4984 #.  From glibc.info:
4985 #. type: Plain text
4986 #: build/C/man2/fcntl.2:491
4987 msgid ""
4988 "If you set the B<O_ASYNC> status flag on a file descriptor by using the "
4989 "B<F_SETFL> command of B<fcntl>(), a B<SIGIO> signal is sent whenever input "
4990 "or output becomes possible on that file descriptor.  B<F_SETSIG> can be used "
4991 "to obtain delivery of a signal other than B<SIGIO>.  If this permission "
4992 "check fails, then the signal is silently discarded."
4993 msgstr ""
4994
4995 #. type: Plain text
4996 #: build/C/man2/fcntl.2:499
4997 msgid ""
4998 "Sending a signal to the owner process (group) specified by B<F_SETOWN> is "
4999 "subject to the same permissions checks as are described for B<kill>(2), "
5000 "where the sending process is the one that employs B<F_SETOWN> (but see BUGS "
5001 "below)."
5002 msgstr ""
5003
5004 #.  The following appears to be rubbish.  It doesn't seem to
5005 #.  be true according to the kernel source, and I can write
5006 #.  a program that gets a terminal-generated SIGIO even though
5007 #.  it is not the foreground process group of the terminal.
5008 #.  -- MTK, 8 Apr 05
5009 #
5010 #.  If the file descriptor
5011 #.  .I fd
5012 #.  refers to a terminal device, then SIGIO
5013 #.  signals are sent to the foreground process group of the terminal.
5014 #. type: Plain text
5015 #: build/C/man2/fcntl.2:523
5016 msgid ""
5017 "If the file descriptor I<fd> refers to a socket, B<F_SETOWN> also selects "
5018 "the recipient of B<SIGURG> signals that are delivered when out-of-band data "
5019 "arrives on that socket.  (B<SIGURG> is sent in any situation where "
5020 "B<select>(2)  would report the socket as having an \"exceptional "
5021 "condition\".)"
5022 msgstr ""
5023
5024 #. type: Plain text
5025 #: build/C/man2/fcntl.2:526
5026 msgid "The following was true in 2.6.x kernels up to and including kernel 2.6.11:"
5027 msgstr ""
5028
5029 #.  The relevant place in the (2.6) kernel source is the
5030 #.  'switch' in fs/fcntl.c::send_sigio_to_task() -- MTK, Apr 2005
5031 #.  send_sigurg()/send_sigurg_to_task() bypasses
5032 #.  kill_fasync()/send_sigio()/send_sigio_to_task()
5033 #.  to directly call send_group_sig_info()
5034 #.      -- MTK, Apr 2005 (kernel 2.6.11)
5035 #. type: Plain text
5036 #: build/C/man2/fcntl.2:566
5037 msgid ""
5038 "If a nonzero value is given to B<F_SETSIG> in a multithreaded process "
5039 "running with a threading library that supports thread groups (e.g., NPTL), "
5040 "then a positive value given to B<F_SETOWN> has a different meaning: instead "
5041 "of being a process ID identifying a whole process, it is a thread ID "
5042 "identifying a specific thread within a process.  Consequently, it may be "
5043 "necessary to pass B<F_SETOWN> the result of B<gettid>(2)  instead of "
5044 "B<getpid>(2)  to get sensible results when B<F_SETSIG> is used.  (In current "
5045 "Linux threading implementations, a main thread's thread ID is the same as "
5046 "its process ID.  This means that a single-threaded program can equally use "
5047 "B<gettid>(2)  or B<getpid>(2)  in this scenario.)  Note, however, that the "
5048 "statements in this paragraph do not apply to the B<SIGURG> signal generated "
5049 "for out-of-band data on a socket: this signal is always sent to either a "
5050 "process or a process group, depending on the value given to B<F_SETOWN>."
5051 msgstr ""
5052
5053 #. type: Plain text
5054 #: build/C/man2/fcntl.2:577
5055 msgid ""
5056 "The above behavior was accidentally dropped in Linux 2.6.12, and won't be "
5057 "restored.  From Linux 2.6.32 onward, use B<F_SETOWN_EX> to target B<SIGIO> "
5058 "and B<SIGURG> signals at a particular thread."
5059 msgstr ""
5060
5061 #. type: TP
5062 #: build/C/man2/fcntl.2:577
5063 #, no-wrap
5064 msgid "B<F_GETOWN_EX> (struct f_owner_ex *) (since Linux 2.6.32)"
5065 msgstr ""
5066
5067 #. type: Plain text
5068 #: build/C/man2/fcntl.2:586
5069 msgid ""
5070 "Return the current file descriptor owner settings as defined by a previous "
5071 "B<F_SETOWN_EX> operation.  The information is returned in the structure "
5072 "pointed to by I<arg>, which has the following form:"
5073 msgstr ""
5074
5075 #. type: Plain text
5076 #: build/C/man2/fcntl.2:593
5077 #, no-wrap
5078 msgid ""
5079 "struct f_owner_ex {\n"
5080 "    int   type;\n"
5081 "    pid_t pid;\n"
5082 "};\n"
5083 msgstr ""
5084
5085 #. type: Plain text
5086 #: build/C/man2/fcntl.2:610
5087 msgid ""
5088 "The I<type> field will have one of the values B<F_OWNER_TID>, "
5089 "B<F_OWNER_PID>, or B<F_OWNER_PGRP>.  The I<pid> field is a positive integer "
5090 "representing a thread ID, process ID, or process group ID.  See "
5091 "B<F_SETOWN_EX> for more details."
5092 msgstr ""
5093
5094 #. type: TP
5095 #: build/C/man2/fcntl.2:610
5096 #, no-wrap
5097 msgid "B<F_SETOWN_EX> (struct f_owner_ex *) (since Linux 2.6.32)"
5098 msgstr ""
5099
5100 #. type: Plain text
5101 #: build/C/man2/fcntl.2:626
5102 msgid ""
5103 "This operation performs a similar task to B<F_SETOWN>.  It allows the caller "
5104 "to direct I/O availability signals to a specific thread, process, or process "
5105 "group.  The caller specifies the target of signals via I<arg>, which is a "
5106 "pointer to a I<f_owner_ex> structure.  The I<type> field has one of the "
5107 "following values, which define how I<pid> is interpreted:"
5108 msgstr ""
5109
5110 #. type: TP
5111 #: build/C/man2/fcntl.2:627
5112 #, no-wrap
5113 msgid "B<F_OWNER_TID>"
5114 msgstr ""
5115
5116 #. type: Plain text
5117 #: build/C/man2/fcntl.2:636
5118 msgid ""
5119 "Send the signal to the thread whose thread ID (the value returned by a call "
5120 "to B<clone>(2)  or B<gettid>(2))  is specified in I<pid>."
5121 msgstr ""
5122
5123 #. type: TP
5124 #: build/C/man2/fcntl.2:636
5125 #, no-wrap
5126 msgid "B<F_OWNER_PID>"
5127 msgstr ""
5128
5129 #. type: Plain text
5130 #: build/C/man2/fcntl.2:641
5131 msgid "Send the signal to the process whose ID is specified in I<pid>."
5132 msgstr ""
5133
5134 #. type: TP
5135 #: build/C/man2/fcntl.2:641
5136 #, no-wrap
5137 msgid "B<F_OWNER_PGRP>"
5138 msgstr ""
5139
5140 #. type: Plain text
5141 #: build/C/man2/fcntl.2:649
5142 msgid ""
5143 "Send the signal to the process group whose ID is specified in I<pid>.  (Note "
5144 "that, unlike with B<F_SETOWN>, a process group ID is specified as a positive "
5145 "value here.)"
5146 msgstr ""
5147
5148 #. type: TP
5149 #: build/C/man2/fcntl.2:650
5150 #, no-wrap
5151 msgid "B<F_GETSIG> (I<void>)"
5152 msgstr ""
5153
5154 #. type: Plain text
5155 #: build/C/man2/fcntl.2:665
5156 msgid ""
5157 "Return (as the function result)  the signal sent when input or output "
5158 "becomes possible.  A value of zero means B<SIGIO> is sent.  Any other value "
5159 "(including B<SIGIO>)  is the signal sent instead, and in this case "
5160 "additional info is available to the signal handler if installed with "
5161 "B<SA_SIGINFO>.  I<arg> is ignored."
5162 msgstr ""
5163
5164 #. type: TP
5165 #: build/C/man2/fcntl.2:665
5166 #, no-wrap
5167 msgid "B<F_SETSIG> (I<int>)"
5168 msgstr ""
5169
5170 #
5171 #.  The following was true only up until 2.6.11:
5172 #
5173 #.  Additionally, passing a nonzero value to
5174 #.  .B F_SETSIG
5175 #.  changes the signal recipient from a whole process to a specific thread
5176 #.  within a process.
5177 #.  See the description of
5178 #.  .B F_SETOWN
5179 #.  for more details.
5180 #. type: Plain text
5181 #: build/C/man2/fcntl.2:688
5182 msgid ""
5183 "Set the signal sent when input or output becomes possible to the value given "
5184 "in I<arg>.  A value of zero means to send the default B<SIGIO> signal.  Any "
5185 "other value (including B<SIGIO>)  is the signal to send instead, and in this "
5186 "case additional info is available to the signal handler if installed with "
5187 "B<SA_SIGINFO>."
5188 msgstr ""
5189
5190 #. type: Plain text
5191 #: build/C/man2/fcntl.2:716
5192 msgid ""
5193 "By using B<F_SETSIG> with a nonzero value, and setting B<SA_SIGINFO> for the "
5194 "signal handler (see B<sigaction>(2)), extra information about I/O events is "
5195 "passed to the handler in a I<siginfo_t> structure.  If the I<si_code> field "
5196 "indicates the source is B<SI_SIGIO>, the I<si_fd> field gives the file "
5197 "descriptor associated with the event.  Otherwise, there is no indication "
5198 "which file descriptors are pending, and you should use the usual mechanisms "
5199 "(B<select>(2), B<poll>(2), B<read>(2)  with B<O_NONBLOCK> set etc.) to "
5200 "determine which file descriptors are available for I/O."
5201 msgstr ""
5202
5203 #. type: Plain text
5204 #: build/C/man2/fcntl.2:725
5205 msgid ""
5206 "By selecting a real time signal (value E<gt>= B<SIGRTMIN>), multiple I/O "
5207 "events may be queued using the same signal numbers.  (Queuing is dependent "
5208 "on available memory).  Extra information is available if B<SA_SIGINFO> is "
5209 "set for the signal handler, as above."
5210 msgstr ""
5211
5212 #.  See fs/fcntl.c::send_sigio_to_task() (2.4/2.6) sources -- MTK, Apr 05
5213 #. type: Plain text
5214 #: build/C/man2/fcntl.2:738
5215 msgid ""
5216 "Note that Linux imposes a limit on the number of real-time signals that may "
5217 "be queued to a process (see B<getrlimit>(2)  and B<signal>(7))  and if this "
5218 "limit is reached, then the kernel reverts to delivering B<SIGIO>, and this "
5219 "signal is delivered to the entire process rather than to a specific thread."
5220 msgstr ""
5221
5222 #. type: Plain text
5223 #: build/C/man2/fcntl.2:745
5224 msgid ""
5225 "Using these mechanisms, a program can implement fully asynchronous I/O "
5226 "without using B<select>(2)  or B<poll>(2)  most of the time."
5227 msgstr ""
5228
5229 #. type: Plain text
5230 #: build/C/man2/fcntl.2:761
5231 msgid ""
5232 "The use of B<O_ASYNC>, B<F_GETOWN>, B<F_SETOWN> is specific to BSD and "
5233 "Linux.  B<F_GETOWN_EX>, B<F_SETOWN_EX>, B<F_GETSIG>, and B<F_SETSIG> are "
5234 "Linux-specific.  POSIX has asynchronous I/O and the I<aio_sigevent> "
5235 "structure to achieve similar things; these are also available in Linux as "
5236 "part of the GNU C Library (Glibc)."
5237 msgstr ""
5238
5239 #. type: SS
5240 #: build/C/man2/fcntl.2:761
5241 #, no-wrap
5242 msgid "Leases"
5243 msgstr ""
5244
5245 #. type: Plain text
5246 #: build/C/man2/fcntl.2:776
5247 msgid ""
5248 "B<F_SETLEASE> and B<F_GETLEASE> (Linux 2.4 onward) are used (respectively) "
5249 "to establish a new lease, and retrieve the current lease, on the open file "
5250 "description referred to by the file descriptor I<fd>.  A file lease provides "
5251 "a mechanism whereby the process holding the lease (the \"lease holder\") is "
5252 "notified (via delivery of a signal)  when a process (the \"lease breaker\") "
5253 "tries to B<open>(2)  or B<truncate>(2)  the file referred to by that file "
5254 "descriptor."
5255 msgstr ""
5256
5257 #. type: TP
5258 #: build/C/man2/fcntl.2:776
5259 #, no-wrap
5260 msgid "B<F_SETLEASE> (I<int>)"
5261 msgstr ""
5262
5263 #. type: Plain text
5264 #: build/C/man2/fcntl.2:781
5265 msgid ""
5266 "Set or remove a file lease according to which of the following values is "
5267 "specified in the integer I<arg>:"
5268 msgstr ""
5269
5270 #. type: TP
5271 #: build/C/man2/fcntl.2:782
5272 #, no-wrap
5273 msgid "B<F_RDLCK>"
5274 msgstr ""
5275
5276 #.  The following became true in kernel 2.6.10:
5277 #.  See the man-pages-2.09 Changelog for further info.
5278 #. type: Plain text
5279 #: build/C/man2/fcntl.2:791
5280 msgid ""
5281 "Take out a read lease.  This will cause the calling process to be notified "
5282 "when the file is opened for writing or is truncated.  A read lease can be "
5283 "placed only on a file descriptor that is opened read-only."
5284 msgstr ""
5285
5286 #. type: TP
5287 #: build/C/man2/fcntl.2:791
5288 #, no-wrap
5289 msgid "B<F_WRLCK>"
5290 msgstr ""
5291
5292 #. type: Plain text
5293 #: build/C/man2/fcntl.2:798
5294 msgid ""
5295 "Take out a write lease.  This will cause the caller to be notified when the "
5296 "file is opened for reading or writing or is truncated.  A write lease may be "
5297 "placed on a file only if there are no other open file descriptors for the "
5298 "file."
5299 msgstr ""
5300
5301 #. type: TP
5302 #: build/C/man2/fcntl.2:798
5303 #, no-wrap
5304 msgid "B<F_UNLCK>"
5305 msgstr ""
5306
5307 #. type: Plain text
5308 #: build/C/man2/fcntl.2:801
5309 msgid "Remove our lease from the file."
5310 msgstr ""
5311
5312 #. type: Plain text
5313 #: build/C/man2/fcntl.2:815
5314 msgid ""
5315 "Leases are associated with an open file description (see B<open>(2)).  This "
5316 "means that duplicate file descriptors (created by, for example, B<fork>(2)  "
5317 "or B<dup>(2))  refer to the same lease, and this lease may be modified or "
5318 "released using any of these descriptors.  Furthermore, the lease is released "
5319 "by either an explicit B<F_UNLCK> operation on any of these duplicate "
5320 "descriptors, or when all such descriptors have been closed."
5321 msgstr ""
5322
5323 #. type: Plain text
5324 #: build/C/man2/fcntl.2:822
5325 msgid ""
5326 "Leases may be taken out only on regular files.  An unprivileged process may "
5327 "take out a lease only on a file whose UID (owner) matches the file system "
5328 "UID of the process.  A process with the B<CAP_LEASE> capability may take out "
5329 "leases on arbitrary files."
5330 msgstr ""
5331
5332 #. type: TP
5333 #: build/C/man2/fcntl.2:822
5334 #, no-wrap
5335 msgid "B<F_GETLEASE> (I<void>)"
5336 msgstr ""
5337
5338 #. type: Plain text
5339 #: build/C/man2/fcntl.2:831
5340 msgid ""
5341 "Indicates what type of lease is associated with the file descriptor I<fd> by "
5342 "returning either B<F_RDLCK>, B<F_WRLCK>, or B<F_UNLCK>, indicating, "
5343 "respectively, a read lease , a write lease, or no lease.  I<arg> is ignored."
5344 msgstr ""
5345
5346 #. type: Plain text
5347 #: build/C/man2/fcntl.2:862
5348 msgid ""
5349 "When a process (the \"lease breaker\") performs an B<open>(2)  or "
5350 "B<truncate>(2)  that conflicts with a lease established via B<F_SETLEASE>, "
5351 "the system call is blocked by the kernel and the kernel notifies the lease "
5352 "holder by sending it a signal (B<SIGIO> by default).  The lease holder "
5353 "should respond to receipt of this signal by doing whatever cleanup is "
5354 "required in preparation for the file to be accessed by another process "
5355 "(e.g., flushing cached buffers) and then either remove or downgrade its "
5356 "lease.  A lease is removed by performing an B<F_SETLEASE> command specifying "
5357 "I<arg> as B<F_UNLCK>.  If the lease holder currently holds a write lease on "
5358 "the file, and the lease breaker is opening the file for reading, then it is "
5359 "sufficient for the lease holder to downgrade the lease to a read lease.  "
5360 "This is done by performing an B<F_SETLEASE> command specifying I<arg> as "
5361 "B<F_RDLCK>."
5362 msgstr ""
5363
5364 #. type: Plain text
5365 #: build/C/man2/fcntl.2:867
5366 msgid ""
5367 "If the lease holder fails to downgrade or remove the lease within the number "
5368 "of seconds specified in I</proc/sys/fs/lease-break-time> then the kernel "
5369 "forcibly removes or downgrades the lease holder's lease."
5370 msgstr ""
5371
5372 #. type: Plain text
5373 #: build/C/man2/fcntl.2:877
5374 msgid ""
5375 "Once a lease break has been initiated, B<F_GETLEASE> returns the target "
5376 "lease type (either B<F_RDLCK> or B<F_UNLCK>, depending on what would be "
5377 "compatible with the lease breaker)  until the lease holder voluntarily "
5378 "downgrades or removes the lease or the kernel forcibly does so after the "
5379 "lease break timer expires."
5380 msgstr ""
5381
5382 #. type: Plain text
5383 #: build/C/man2/fcntl.2:881
5384 msgid ""
5385 "Once the lease has been voluntarily or forcibly removed or downgraded, and "
5386 "assuming the lease breaker has not unblocked its system call, the kernel "
5387 "permits the lease breaker's system call to proceed."
5388 msgstr ""
5389
5390 #. type: Plain text
5391 #: build/C/man2/fcntl.2:902
5392 msgid ""
5393 "If the lease breaker's blocked B<open>(2)  or B<truncate>(2)  is interrupted "
5394 "by a signal handler, then the system call fails with the error B<EINTR>, but "
5395 "the other steps still occur as described above.  If the lease breaker is "
5396 "killed by a signal while blocked in B<open>(2)  or B<truncate>(2), then the "
5397 "other steps still occur as described above.  If the lease breaker specifies "
5398 "the B<O_NONBLOCK> flag when calling B<open>(2), then the call immediately "
5399 "fails with the error B<EWOULDBLOCK>, but the other steps still occur as "
5400 "described above."
5401 msgstr ""
5402
5403 #. type: Plain text
5404 #: build/C/man2/fcntl.2:923
5405 msgid ""
5406 "The default signal used to notify the lease holder is B<SIGIO>, but this can "
5407 "be changed using the B<F_SETSIG> command to B<fcntl>().  If a B<F_SETSIG> "
5408 "command is performed (even one specifying B<SIGIO>), and the signal handler "
5409 "is established using B<SA_SIGINFO>, then the handler will receive a "
5410 "I<siginfo_t> structure as its second argument, and the I<si_fd> field of "
5411 "this argument will hold the descriptor of the leased file that has been "
5412 "accessed by another process.  (This is useful if the caller holds leases "
5413 "against multiple files)."
5414 msgstr ""
5415
5416 #. type: SS
5417 #: build/C/man2/fcntl.2:923
5418 #, no-wrap
5419 msgid "File and directory change notification (dnotify)"
5420 msgstr ""
5421
5422 #. type: TP
5423 #: build/C/man2/fcntl.2:924
5424 #, no-wrap
5425 msgid "B<F_NOTIFY> (I<int>)"
5426 msgstr ""
5427
5428 #. type: Plain text
5429 #: build/C/man2/fcntl.2:934
5430 msgid ""
5431 "(Linux 2.4 onward)  Provide notification when the directory referred to by "
5432 "I<fd> or any of the files that it contains is changed.  The events to be "
5433 "notified are specified in I<arg>, which is a bit mask specified by ORing "
5434 "together zero or more of the following bits:"
5435 msgstr ""
5436
5437 #. type: TP
5438 #: build/C/man2/fcntl.2:937
5439 #, no-wrap
5440 msgid "B<DN_ACCESS>"
5441 msgstr ""
5442
5443 #. type: Plain text
5444 #: build/C/man2/fcntl.2:940
5445 msgid "A file was accessed (read, pread, readv)"
5446 msgstr ""
5447
5448 #. type: TP
5449 #: build/C/man2/fcntl.2:940
5450 #, no-wrap
5451 msgid "B<DN_MODIFY>"
5452 msgstr ""
5453
5454 #. type: Plain text
5455 #: build/C/man2/fcntl.2:943
5456 msgid "A file was modified (write, pwrite, writev, truncate, ftruncate)."
5457 msgstr ""
5458
5459 #. type: TP
5460 #: build/C/man2/fcntl.2:943
5461 #, no-wrap
5462 msgid "B<DN_CREATE>"
5463 msgstr ""
5464
5465 #. type: Plain text
5466 #: build/C/man2/fcntl.2:946
5467 msgid "A file was created (open, creat, mknod, mkdir, link, symlink, rename)."
5468 msgstr ""
5469
5470 #. type: TP
5471 #: build/C/man2/fcntl.2:946
5472 #, no-wrap
5473 msgid "B<DN_DELETE>"
5474 msgstr ""
5475
5476 #. type: Plain text
5477 #: build/C/man2/fcntl.2:949
5478 msgid "A file was unlinked (unlink, rename to another directory, rmdir)."
5479 msgstr ""
5480
5481 #. type: TP
5482 #: build/C/man2/fcntl.2:949
5483 #, no-wrap
5484 msgid "B<DN_RENAME>"
5485 msgstr ""
5486
5487 #. type: Plain text
5488 #: build/C/man2/fcntl.2:952
5489 msgid "A file was renamed within this directory (rename)."
5490 msgstr ""
5491
5492 #. type: TP
5493 #: build/C/man2/fcntl.2:952
5494 #, no-wrap
5495 msgid "B<DN_ATTRIB>"
5496 msgstr ""
5497
5498 #. type: Plain text
5499 #: build/C/man2/fcntl.2:955
5500 msgid "The attributes of a file were changed (chown, chmod, utime[s])."
5501 msgstr ""
5502
5503 #. type: Plain text
5504 #: build/C/man2/fcntl.2:963
5505 msgid ""
5506 "(In order to obtain these definitions, the B<_GNU_SOURCE> feature test macro "
5507 "must be defined before including I<any> header files.)"
5508 msgstr ""
5509
5510 #. type: Plain text
5511 #: build/C/man2/fcntl.2:971
5512 msgid ""
5513 "Directory notifications are normally \"one-shot\", and the application must "
5514 "reregister to receive further notifications.  Alternatively, if "
5515 "B<DN_MULTISHOT> is included in I<arg>, then notification will remain in "
5516 "effect until explicitly removed."
5517 msgstr ""
5518
5519 #.  The following does seem a poor API-design choice...
5520 #. type: Plain text
5521 #: build/C/man2/fcntl.2:983
5522 msgid ""
5523 "A series of B<F_NOTIFY> requests is cumulative, with the events in I<arg> "
5524 "being added to the set already monitored.  To disable notification of all "
5525 "events, make an B<F_NOTIFY> call specifying I<arg> as 0."
5526 msgstr ""
5527
5528 #. type: Plain text
5529 #: build/C/man2/fcntl.2:1001
5530 msgid ""
5531 "Notification occurs via delivery of a signal.  The default signal is "
5532 "B<SIGIO>, but this can be changed using the B<F_SETSIG> command to "
5533 "B<fcntl>().  In the latter case, the signal handler receives a I<siginfo_t> "
5534 "structure as its second argument (if the handler was established using "
5535 "B<SA_SIGINFO>)  and the I<si_fd> field of this structure contains the file "
5536 "descriptor which generated the notification (useful when establishing "
5537 "notification on multiple directories)."
5538 msgstr ""
5539
5540 #. type: Plain text
5541 #: build/C/man2/fcntl.2:1006
5542 msgid ""
5543 "Especially when using B<DN_MULTISHOT>, a real time signal should be used for "
5544 "notification, so that multiple notifications can be queued."
5545 msgstr ""
5546
5547 #. type: Plain text
5548 #: build/C/man2/fcntl.2:1015
5549 msgid ""
5550 "B<NOTE:> New applications should use the I<inotify> interface (available "
5551 "since kernel 2.6.13), which provides a much superior interface for obtaining "
5552 "notifications of file system events.  See B<inotify>(7)."
5553 msgstr ""
5554
5555 #. type: SS
5556 #: build/C/man2/fcntl.2:1015
5557 #, no-wrap
5558 msgid "Changing the capacity of a pipe"
5559 msgstr ""
5560
5561 #. type: TP
5562 #: build/C/man2/fcntl.2:1016
5563 #, no-wrap
5564 msgid "B<F_SETPIPE_SZ> (I<int>; since Linux 2.6.35)"
5565 msgstr ""
5566
5567 #. type: Plain text
5568 #: build/C/man2/fcntl.2:1047
5569 msgid ""
5570 "Change the capacity of the pipe referred to by I<fd> to be at least I<arg> "
5571 "bytes.  An unprivileged process can adjust the pipe capacity to any value "
5572 "between the system page size and the limit defined in "
5573 "I</proc/sys/fs/pipe-max-size> (see B<proc>(5)).  Attempts to set the pipe "
5574 "capacity below the page size are silently rounded up to the page size.  "
5575 "Attempts by an unprivileged process to set the pipe capacity above the limit "
5576 "in I</proc/sys/fs/pipe-max-size> yield the error B<EPERM>; a privileged "
5577 "process (B<CAP_SYS_RESOURCE>)  can override the limit.  When allocating the "
5578 "buffer for the pipe, the kernel may use a capacity larger than I<arg>, if "
5579 "that is convenient for the implementation.  The B<F_GETPIPE_SZ> operation "
5580 "returns the actual size used.  Attempting to set the pipe capacity smaller "
5581 "than the amount of buffer space currently used to store data produces the "
5582 "error B<EBUSY>."
5583 msgstr ""
5584
5585 #. type: TP
5586 #: build/C/man2/fcntl.2:1047
5587 #, no-wrap
5588 msgid "B<F_GETPIPE_SZ> (I<void>; since Linux 2.6.35)"
5589 msgstr ""
5590
5591 #. type: Plain text
5592 #: build/C/man2/fcntl.2:1051
5593 msgid ""
5594 "Return (as the function result) the capacity of the pipe referred to by "
5595 "I<fd>."
5596 msgstr ""
5597
5598 #. type: Plain text
5599 #: build/C/man2/fcntl.2:1053
5600 msgid "For a successful call, the return value depends on the operation:"
5601 msgstr ""
5602
5603 #. type: TP
5604 #: build/C/man2/fcntl.2:1053
5605 #, no-wrap
5606 msgid "B<F_DUPFD>"
5607 msgstr ""
5608
5609 #. type: Plain text
5610 #: build/C/man2/fcntl.2:1056
5611 msgid "The new descriptor."
5612 msgstr ""
5613
5614 #. type: TP
5615 #: build/C/man2/fcntl.2:1056
5616 #, no-wrap
5617 msgid "B<F_GETFD>"
5618 msgstr ""
5619
5620 #. type: Plain text
5621 #: build/C/man2/fcntl.2:1059
5622 msgid "Value of file descriptor flags."
5623 msgstr ""
5624
5625 #. type: TP
5626 #: build/C/man2/fcntl.2:1059
5627 #, no-wrap
5628 msgid "B<F_GETFL>"
5629 msgstr ""
5630
5631 #. type: Plain text
5632 #: build/C/man2/fcntl.2:1062
5633 msgid "Value of file status flags."
5634 msgstr ""
5635
5636 #. type: TP
5637 #: build/C/man2/fcntl.2:1062
5638 #, no-wrap
5639 msgid "B<F_GETLEASE>"
5640 msgstr ""
5641
5642 #. type: Plain text
5643 #: build/C/man2/fcntl.2:1065
5644 msgid "Type of lease held on file descriptor."
5645 msgstr ""
5646
5647 #. type: TP
5648 #: build/C/man2/fcntl.2:1065
5649 #, no-wrap
5650 msgid "B<F_GETOWN>"
5651 msgstr ""
5652
5653 #. type: Plain text
5654 #: build/C/man2/fcntl.2:1068
5655 msgid "Value of descriptor owner."
5656 msgstr ""
5657
5658 #. type: TP
5659 #: build/C/man2/fcntl.2:1068
5660 #, no-wrap
5661 msgid "B<F_GETSIG>"
5662 msgstr ""
5663
5664 #. type: Plain text
5665 #: build/C/man2/fcntl.2:1074
5666 msgid ""
5667 "Value of signal sent when read or write becomes possible, or zero for "
5668 "traditional B<SIGIO> behavior."
5669 msgstr ""
5670
5671 #. type: TP
5672 #: build/C/man2/fcntl.2:1074
5673 #, no-wrap
5674 msgid "B<F_GETPIPE_SZ>"
5675 msgstr ""
5676
5677 #. type: Plain text
5678 #: build/C/man2/fcntl.2:1077
5679 msgid "The pipe capacity."
5680 msgstr ""
5681
5682 #. type: TP
5683 #: build/C/man2/fcntl.2:1077
5684 #, no-wrap
5685 msgid "All other commands"
5686 msgstr ""
5687
5688 #. type: Plain text
5689 #: build/C/man2/fcntl.2:1080
5690 msgid "Zero."
5691 msgstr ""
5692
5693 #. type: Plain text
5694 #: build/C/man2/fcntl.2:1084
5695 msgid "On error, -1 is returned, and I<errno> is set appropriately."
5696 msgstr ""
5697
5698 #. type: TP
5699 #: build/C/man2/fcntl.2:1085 build/C/man3/lockf.3:122
5700 #, no-wrap
5701 msgid "B<EACCES> or B<EAGAIN>"
5702 msgstr ""
5703
5704 #. type: Plain text
5705 #: build/C/man2/fcntl.2:1088
5706 msgid "Operation is prohibited by locks held by other processes."
5707 msgstr ""
5708
5709 #. type: TP
5710 #: build/C/man2/fcntl.2:1088 build/C/man2/fork.2:181 build/C/man2/fork.2:186
5711 #, no-wrap
5712 msgid "B<EAGAIN>"
5713 msgstr ""
5714
5715 #. type: Plain text
5716 #: build/C/man2/fcntl.2:1092
5717 msgid ""
5718 "The operation is prohibited because the file has been memory-mapped by "
5719 "another process."
5720 msgstr ""
5721
5722 #. type: Plain text
5723 #: build/C/man2/fcntl.2:1101
5724 msgid ""
5725 "I<fd> is not an open file descriptor, or the command was B<F_SETLK> or "
5726 "B<F_SETLKW> and the file descriptor open mode doesn't match with the type of "
5727 "lock requested."
5728 msgstr ""
5729
5730 #. type: TP
5731 #: build/C/man2/fcntl.2:1101 build/C/man3/lockf.3:142
5732 #, no-wrap
5733 msgid "B<EDEADLK>"
5734 msgstr ""
5735
5736 #. type: Plain text
5737 #: build/C/man2/fcntl.2:1106
5738 msgid ""
5739 "It was detected that the specified B<F_SETLKW> command would cause a "
5740 "deadlock."
5741 msgstr ""
5742
5743 #. type: Plain text
5744 #: build/C/man2/fcntl.2:1110
5745 msgid "I<lock> is outside your accessible address space."
5746 msgstr ""
5747
5748 #. type: Plain text
5749 #: build/C/man2/fcntl.2:1122
5750 msgid ""
5751 "For B<F_SETLKW>, the command was interrupted by a signal; see B<signal>(7).  "
5752 "For B<F_GETLK> and B<F_SETLK>, the command was interrupted by a signal "
5753 "before the lock was checked or acquired.  Most likely when locking a remote "
5754 "file (e.g., locking over NFS), but can sometimes happen locally."
5755 msgstr ""
5756
5757 #. type: Plain text
5758 #: build/C/man2/fcntl.2:1132
5759 msgid ""
5760 "For B<F_DUPFD>, I<arg> is negative or is greater than the maximum allowable "
5761 "value.  For B<F_SETSIG>, I<arg> is not an allowable signal number."
5762 msgstr ""
5763
5764 #. type: Plain text
5765 #: build/C/man2/fcntl.2:1137
5766 msgid ""
5767 "For B<F_DUPFD>, the process already has the maximum number of file "
5768 "descriptors open."
5769 msgstr ""
5770
5771 #. type: TP
5772 #: build/C/man2/fcntl.2:1137 build/C/man2/flock.2:130 build/C/man3/lockf.3:151
5773 #, no-wrap
5774 msgid "B<ENOLCK>"
5775 msgstr ""
5776
5777 #. type: Plain text
5778 #: build/C/man2/fcntl.2:1141
5779 msgid ""
5780 "Too many segment locks open, lock table is full, or a remote locking "
5781 "protocol failed (e.g., locking over NFS)."
5782 msgstr ""
5783
5784 #. type: Plain text
5785 #: build/C/man2/fcntl.2:1146
5786 msgid ""
5787 "Attempted to clear the B<O_APPEND> flag on a file that has the append-only "
5788 "attribute set."
5789 msgstr ""
5790
5791 #. type: Plain text
5792 #: build/C/man2/fcntl.2:1159
5793 msgid ""
5794 "SVr4, 4.3BSD, POSIX.1-2001.  Only the operations B<F_DUPFD>, B<F_GETFD>, "
5795 "B<F_SETFD>, B<F_GETFL>, B<F_SETFL>, B<F_GETLK>, B<F_SETLK> and B<F_SETLKW>, "
5796 "are specified in POSIX.1-2001."
5797 msgstr ""
5798
5799 #. type: Plain text
5800 #: build/C/man2/fcntl.2:1171
5801 msgid ""
5802 "B<F_GETOWN> and B<F_SETOWN> are specified in POSIX.1-2001.  (To get their "
5803 "definitions, define B<BSD_SOURCE>, or B<_XOPEN_SOURCE> with the value 500 or "
5804 "greater, or define B<_POSIX_C_SOURCE> with the value 200809L or greater.)"
5805 msgstr ""
5806
5807 #. type: Plain text
5808 #: build/C/man2/fcntl.2:1179
5809 msgid ""
5810 "B<F_DUPFD_CLOEXEC> is specified in POSIX.1-2008.  (To get this definition, "
5811 "define B<_POSIX_C_SOURCE> with the value 200809L or greater, or "
5812 "B<_XOPEN_SOURCE> with the value 700 or greater.)"
5813 msgstr ""
5814
5815 #.  .PP
5816 #.  SVr4 documents additional EIO, ENOLINK and EOVERFLOW error conditions.
5817 #. type: Plain text
5818 #: build/C/man2/fcntl.2:1196
5819 msgid ""
5820 "B<F_GETOWN_EX>, B<F_SETOWN_EX>, B<F_SETPIPE_SZ>, B<F_GETPIPE_SZ>, "
5821 "B<F_GETSIG>, B<F_SETSIG>, B<F_NOTIFY>, B<F_GETLEASE>, and B<F_SETLEASE> are "
5822 "Linux-specific.  (Define the B<_GNU_SOURCE> macro to obtain these "
5823 "definitions.)"
5824 msgstr ""
5825
5826 #. type: Plain text
5827 #: build/C/man2/fcntl.2:1217
5828 msgid ""
5829 "The original Linux B<fcntl>()  system call was not designed to handle large "
5830 "file offsets (in the I<flock> structure).  Consequently, an B<fcntl64>()  "
5831 "system call was added in Linux 2.4.  The newer system call employs a "
5832 "different structure for file locking, I<flock64>, and corresponding "
5833 "commands, B<F_GETLK64>, B<F_SETLK64>, and B<F_SETLKW64>.  However, these "
5834 "details can be ignored by applications using glibc, whose B<fcntl>()  "
5835 "wrapper function transparently employs the more recent system call where it "
5836 "is available."
5837 msgstr ""
5838
5839 #. type: Plain text
5840 #: build/C/man2/fcntl.2:1222
5841 msgid ""
5842 "The errors returned by B<dup2>(2)  are different from those returned by "
5843 "B<F_DUPFD>."
5844 msgstr ""
5845
5846 #. type: Plain text
5847 #: build/C/man2/fcntl.2:1228
5848 msgid ""
5849 "Since kernel 2.0, there is no interaction between the types of lock placed "
5850 "by B<flock>(2)  and B<fcntl>()."
5851 msgstr ""
5852
5853 #.  e.g., Solaris 8 documents this field in fcntl(2), and Irix 6.5
5854 #.  documents it in fcntl(5).  mtk, May 2007
5855 #. type: Plain text
5856 #: build/C/man2/fcntl.2:1239
5857 msgid ""
5858 "Several systems have more fields in I<struct flock> such as, for example, "
5859 "I<l_sysid>.  Clearly, I<l_pid> alone is not going to be very useful if the "
5860 "process holding the lock may live on a different machine."
5861 msgstr ""
5862
5863 #.  glibc source: sysdeps/unix/sysv/linux/i386/sysdep.h
5864 #.  mtk, Dec 04: some limited testing on alpha and ia64 seems to
5865 #.  indicate that ANY negative PGID value will cause F_GETOWN
5866 #.  to misinterpret the return as an error. Some other architectures
5867 #.  seem to have the same range check as i386.
5868 #. type: Plain text
5869 #: build/C/man2/fcntl.2:1265
5870 msgid ""
5871 "A limitation of the Linux system call conventions on some architectures "
5872 "(notably i386) means that if a (negative)  process group ID to be returned "
5873 "by B<F_GETOWN> falls in the range -1 to -4095, then the return value is "
5874 "wrongly interpreted by glibc as an error in the system call; that is, the "
5875 "return value of B<fcntl>()  will be -1, and I<errno> will contain the "
5876 "(positive) process group ID.  The Linux-specific B<F_GETOWN_EX> operation "
5877 "avoids this problem.  Since glibc version 2.11, glibc makes the kernel "
5878 "B<F_GETOWN> problem invisible by implementing B<F_GETOWN> using "
5879 "B<F_GETOWN_EX>."
5880 msgstr ""
5881
5882 #. type: Plain text
5883 #: build/C/man2/fcntl.2:1282
5884 msgid ""
5885 "In Linux 2.4 and earlier, there is bug that can occur when an unprivileged "
5886 "process uses B<F_SETOWN> to specify the owner of a socket file descriptor as "
5887 "a process (group) other than the caller.  In this case, B<fcntl>()  can "
5888 "return -1 with I<errno> set to B<EPERM>, even when the owner process (group) "
5889 "is one that the caller has permission to send signals to.  Despite this "
5890 "error return, the file descriptor owner is set, and signals will be sent to "
5891 "the owner."
5892 msgstr ""
5893
5894 #.  http://marc.info/?l=linux-kernel&m=119013491707153&w=2
5895 #. type: Plain text
5896 #: build/C/man2/fcntl.2:1297
5897 msgid ""
5898 "The implementation of mandatory locking in all known versions of Linux is "
5899 "subject to race conditions which render it unreliable: a B<write>(2)  call "
5900 "that overlaps with a lock may modify data after the mandatory lock is "
5901 "acquired; a B<read>(2)  call that overlaps with a lock may detect changes to "
5902 "data that were made only after a write lock was acquired.  Similar races "
5903 "exist between mandatory locks and B<mmap>(2).  It is therefore inadvisable "
5904 "to rely on mandatory locking."
5905 msgstr ""
5906
5907 #. type: Plain text
5908 #: build/C/man2/fcntl.2:1305
5909 msgid ""
5910 "B<dup2>(2), B<flock>(2), B<open>(2), B<socket>(2), B<lockf>(3), "
5911 "B<capabilities>(7), B<feature_test_macros>(7)"
5912 msgstr ""
5913
5914 #. type: Plain text
5915 #: build/C/man2/fcntl.2:1318
5916 msgid ""
5917 "I<locks.txt>, I<mandatory-locking.txt>, and I<dnotify.txt> in the Linux "
5918 "kernel source directory I<Documentation/filesystems/> (on older kernels, "
5919 "these files are directly under the I<Documentation/> directory, and "
5920 "I<mandatory-locking.txt> is called I<mandatory.txt>)"
5921 msgstr ""
5922
5923 #. type: TH
5924 #: build/C/man3/fexecve.3:25
5925 #, no-wrap
5926 msgid "FEXECVE"
5927 msgstr ""
5928
5929 #. type: TH
5930 #: build/C/man3/fexecve.3:25
5931 #, no-wrap
5932 msgid "2010-09-15"
5933 msgstr ""
5934
5935 #. type: Plain text
5936 #: build/C/man3/fexecve.3:28
5937 msgid "fexecve - execute program specified via file descriptor"
5938 msgstr ""
5939
5940 #. type: Plain text
5941 #: build/C/man3/fexecve.3:33
5942 #, no-wrap
5943 msgid ""
5944 "B<int fexecve(int >I<fd>B<, char *const >I<argv>B<[], char *const "
5945 ">I<envp>B<[]);>\n"
5946 msgstr ""
5947
5948 #. type: Plain text
5949 #: build/C/man3/fexecve.3:41
5950 msgid "B<fexecve>():"
5951 msgstr ""
5952
5953 #. type: TP
5954 #: build/C/man3/fexecve.3:44
5955 #, no-wrap
5956 msgid "Since glibc 2.10:"
5957 msgstr ""
5958
5959 #. type: Plain text
5960 #: build/C/man3/fexecve.3:47
5961 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 700 || _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
5962 msgstr ""
5963
5964 #. type: TP
5965 #: build/C/man3/fexecve.3:47
5966 #, no-wrap
5967 msgid "Before glibc 2.10:"
5968 msgstr ""
5969
5970 #. type: Plain text
5971 #: build/C/man3/fexecve.3:50 build/C/man3/getcwd.3:54
5972 msgid "_GNU_SOURCE"
5973 msgstr ""
5974
5975 #.  POSIX.1-2008 specifies the O_EXEC flag for open as an alternative,
5976 #.  but Linux doesn't support this flag yet.
5977 #. type: Plain text
5978 #: build/C/man3/fexecve.3:67
5979 msgid ""
5980 "B<fexecve>()  performs the same task as B<execve>(2), with the difference "
5981 "that the file to be executed is specified via a file descriptor, I<fd>, "
5982 "rather than via a pathname.  The file descriptor I<fd> must be opened "
5983 "read-only, and the caller must have permission to execute the file that it "
5984 "refers to."
5985 msgstr ""
5986
5987 #. type: Plain text
5988 #: build/C/man3/fexecve.3:74
5989 msgid ""
5990 "A successful call to B<fexecve>()  never returns.  On error, the function "
5991 "returns, with a result value of -1, and I<errno> is set appropriately."
5992 msgstr ""
5993
5994 #. type: Plain text
5995 #: build/C/man3/fexecve.3:78
5996 msgid "Errors are as for B<execve>(2), with the following additions:"
5997 msgstr ""
5998
5999 #. type: Plain text
6000 #: build/C/man3/fexecve.3:86
6001 msgid ""
6002 "I<fd> is not a valid file descriptor, or I<argv> is NULL, or I<envp> is "
6003 "NULL."
6004 msgstr ""
6005
6006 #. type: Plain text
6007 #: build/C/man3/fexecve.3:91
6008 msgid "The I</proc> file system could not be accessed."
6009 msgstr ""
6010
6011 #. type: Plain text
6012 #: build/C/man3/fexecve.3:94
6013 msgid "B<fexecve>()  is implemented since glibc 2.3.2."
6014 msgstr ""
6015
6016 #. type: Plain text
6017 #: build/C/man3/fexecve.3:98
6018 msgid ""
6019 "POSIX.1-2008.  This function is not specified in POSIX.1-2001, and is not "
6020 "widely available on other systems."
6021 msgstr ""
6022
6023 #. type: Plain text
6024 #: build/C/man3/fexecve.3:106
6025 msgid ""
6026 "On Linux, B<fexecve>()  is implemented using the B<proc>(5)  file system, so "
6027 "I</proc> needs to be mounted and available at the time of the call."
6028 msgstr ""
6029
6030 #. type: Plain text
6031 #: build/C/man3/fexecve.3:108
6032 msgid "B<execve>(2)"
6033 msgstr ""
6034
6035 #. type: TH
6036 #: build/C/man2/flock.2:35
6037 #, no-wrap
6038 msgid "FLOCK"
6039 msgstr ""
6040
6041 #. type: TH
6042 #: build/C/man2/flock.2:35
6043 #, no-wrap
6044 msgid "2013-02-11"
6045 msgstr ""
6046
6047 #. type: Plain text
6048 #: build/C/man2/flock.2:38
6049 msgid "flock - apply or remove an advisory lock on an open file"
6050 msgstr ""
6051
6052 #. type: Plain text
6053 #: build/C/man2/flock.2:40
6054 msgid "B<#include E<lt>sys/file.hE<gt>>"
6055 msgstr ""
6056
6057 #. type: Plain text
6058 #: build/C/man2/flock.2:42
6059 msgid "B<int flock(int >I<fd>B<, int >I<operation>B<);>"
6060 msgstr ""
6061
6062 #. type: Plain text
6063 #: build/C/man2/flock.2:48
6064 msgid ""
6065 "Apply or remove an advisory lock on the open file specified by I<fd>.  The "
6066 "argument I<operation> is one of the following:"
6067 msgstr ""
6068
6069 #. type: TP
6070 #: build/C/man2/flock.2:49
6071 #, no-wrap
6072 msgid "B<LOCK_SH>"
6073 msgstr ""
6074
6075 #. type: Plain text
6076 #: build/C/man2/flock.2:54
6077 msgid ""
6078 "Place a shared lock.  More than one process may hold a shared lock for a "
6079 "given file at a given time."
6080 msgstr ""
6081
6082 #. type: TP
6083 #: build/C/man2/flock.2:54
6084 #, no-wrap
6085 msgid "B<LOCK_EX>"
6086 msgstr ""
6087
6088 #. type: Plain text
6089 #: build/C/man2/flock.2:59
6090 msgid ""
6091 "Place an exclusive lock.  Only one process may hold an exclusive lock for a "
6092 "given file at a given time."
6093 msgstr ""
6094
6095 #. type: TP
6096 #: build/C/man2/flock.2:59
6097 #, no-wrap
6098 msgid "B<LOCK_UN>"
6099 msgstr ""
6100
6101 #. type: Plain text
6102 #: build/C/man2/flock.2:62
6103 msgid "Remove an existing lock held by this process."
6104 msgstr ""
6105
6106 #. type: Plain text
6107 #: build/C/man2/flock.2:71
6108 msgid ""
6109 "A call to B<flock>()  may block if an incompatible lock is held by another "
6110 "process.  To make a nonblocking request, include B<LOCK_NB> (by ORing)  with "
6111 "any of the above operations."
6112 msgstr ""
6113
6114 #. type: Plain text
6115 #: build/C/man2/flock.2:73
6116 msgid "A single file may not simultaneously have both shared and exclusive locks."
6117 msgstr ""
6118
6119 #. type: Plain text
6120 #: build/C/man2/flock.2:87
6121 msgid ""
6122 "Locks created by B<flock>()  are associated with an open file table entry.  "
6123 "This means that duplicate file descriptors (created by, for example, "
6124 "B<fork>(2)  or B<dup>(2))  refer to the same lock, and this lock may be "
6125 "modified or released using any of these descriptors.  Furthermore, the lock "
6126 "is released either by an explicit B<LOCK_UN> operation on any of these "
6127 "duplicate descriptors, or when all such descriptors have been closed."
6128 msgstr ""
6129
6130 #. type: Plain text
6131 #: build/C/man2/flock.2:96
6132 msgid ""
6133 "If a process uses B<open>(2)  (or similar) to obtain more than one "
6134 "descriptor for the same file, these descriptors are treated independently by "
6135 "B<flock>().  An attempt to lock the file using one of these file descriptors "
6136 "may be denied by a lock that the calling process has already placed via "
6137 "another descriptor."
6138 msgstr ""
6139
6140 #. type: Plain text
6141 #: build/C/man2/flock.2:103
6142 msgid ""
6143 "A process may hold only one type of lock (shared or exclusive)  on a file.  "
6144 "Subsequent B<flock>()  calls on an already locked file will convert an "
6145 "existing lock to the new lock mode."
6146 msgstr ""
6147
6148 #. type: Plain text
6149 #: build/C/man2/flock.2:108
6150 msgid "Locks created by B<flock>()  are preserved across an B<execve>(2)."
6151 msgstr ""
6152
6153 #. type: Plain text
6154 #: build/C/man2/flock.2:111
6155 msgid ""
6156 "A shared or exclusive lock can be placed on a file regardless of the mode in "
6157 "which the file was opened."
6158 msgstr ""
6159
6160 #. type: Plain text
6161 #: build/C/man2/flock.2:121
6162 msgid "I<fd> is not an open file descriptor."
6163 msgstr ""
6164
6165 #. type: Plain text
6166 #: build/C/man2/flock.2:126
6167 msgid ""
6168 "While waiting to acquire a lock, the call was interrupted by delivery of a "
6169 "signal caught by a handler; see B<signal>(7)."
6170 msgstr ""
6171
6172 #. type: Plain text
6173 #: build/C/man2/flock.2:130
6174 msgid "I<operation> is invalid."
6175 msgstr ""
6176
6177 #. type: Plain text
6178 #: build/C/man2/flock.2:133
6179 msgid "The kernel ran out of memory for allocating lock records."
6180 msgstr ""
6181
6182 #. type: TP
6183 #: build/C/man2/flock.2:133
6184 #, no-wrap
6185 msgid "B<EWOULDBLOCK>"
6186 msgstr ""
6187
6188 #. type: Plain text
6189 #: build/C/man2/flock.2:138
6190 msgid "The file is locked and the B<LOCK_NB> flag was selected."
6191 msgstr ""
6192
6193 #. type: Plain text
6194 #: build/C/man2/flock.2:147
6195 msgid ""
6196 "4.4BSD (the B<flock>()  call first appeared in 4.2BSD).  A version of "
6197 "B<flock>(), possibly implemented in terms of B<fcntl>(2), appears on most "
6198 "UNIX systems."
6199 msgstr ""
6200
6201 #. type: Plain text
6202 #: build/C/man2/flock.2:154
6203 msgid ""
6204 "B<flock>()  does not lock files over NFS.  Use B<fcntl>(2)  instead: that "
6205 "does work over NFS, given a sufficiently recent version of Linux and a "
6206 "server which supports locking."
6207 msgstr ""
6208
6209 #. type: Plain text
6210 #: build/C/man2/flock.2:169
6211 msgid ""
6212 "Since kernel 2.0, B<flock>()  is implemented as a system call in its own "
6213 "right rather than being emulated in the GNU C library as a call to "
6214 "B<fcntl>(2).  This yields true BSD semantics: there is no interaction "
6215 "between the types of lock placed by B<flock>()  and B<fcntl>(2), and "
6216 "B<flock>()  does not detect deadlock."
6217 msgstr ""
6218
6219 #. type: Plain text
6220 #: build/C/man2/flock.2:175
6221 msgid ""
6222 "B<flock>()  places advisory locks only; given suitable permissions on a "
6223 "file, a process is free to ignore the use of B<flock>()  and perform I/O on "
6224 "the file."
6225 msgstr ""
6226
6227 #. type: Plain text
6228 #: build/C/man2/flock.2:188
6229 msgid ""
6230 "B<flock>()  and B<fcntl>(2)  locks have different semantics with respect to "
6231 "forked processes and B<dup>(2).  On systems that implement B<flock>()  using "
6232 "B<fcntl>(2), the semantics of B<flock>()  will be different from those "
6233 "described in this manual page."
6234 msgstr ""
6235
6236 #.  Kernel 2.5.21 changed things a little: during lock conversion
6237 #.  it is now the highest priority process that will get the lock -- mtk
6238 #. type: Plain text
6239 #: build/C/man2/flock.2:201
6240 msgid ""
6241 "Converting a lock (shared to exclusive, or vice versa) is not guaranteed to "
6242 "be atomic: the existing lock is first removed, and then a new lock is "
6243 "established.  Between these two steps, a pending lock request by another "
6244 "process may be granted, with the result that the conversion either blocks, "
6245 "or fails if B<LOCK_NB> was specified.  (This is the original BSD behavior, "
6246 "and occurs on many other implementations.)"
6247 msgstr ""
6248
6249 #. type: Plain text
6250 #: build/C/man2/flock.2:210
6251 msgid ""
6252 "B<flock>(1), B<close>(2), B<dup>(2), B<execve>(2), B<fcntl>(2), B<fork>(2), "
6253 "B<open>(2), B<lockf>(3)"
6254 msgstr ""
6255
6256 #. type: Plain text
6257 #: build/C/man2/flock.2:215
6258 msgid ""
6259 "I<Documentation/filesystem/locks.txt> in the Linux kernel source tree "
6260 "(I<Documentation/locks.txt> in older kernels)"
6261 msgstr ""
6262
6263 #. type: TH
6264 #: build/C/man2/fork.2:39
6265 #, no-wrap
6266 msgid "FORK"
6267 msgstr ""
6268
6269 #. type: TH
6270 #: build/C/man2/fork.2:39 build/C/man2/ioperm.2:34
6271 #, no-wrap
6272 msgid "2013-03-12"
6273 msgstr ""
6274
6275 #. type: Plain text
6276 #: build/C/man2/fork.2:42
6277 msgid "fork - create a child process"
6278 msgstr ""
6279
6280 #. type: Plain text
6281 #: build/C/man2/fork.2:46
6282 msgid "B<pid_t fork(void);>"
6283 msgstr ""
6284
6285 #. type: Plain text
6286 #: build/C/man2/fork.2:52
6287 msgid ""
6288 "B<fork>()  creates a new process by duplicating the calling process.  The "
6289 "new process, referred to as the I<child>, is an exact duplicate of the "
6290 "calling process, referred to as the I<parent>, except for the following "
6291 "points:"
6292 msgstr ""
6293
6294 #. type: Plain text
6295 #: build/C/man2/fork.2:56
6296 msgid ""
6297 "The child has its own unique process ID, and this PID does not match the ID "
6298 "of any existing process group (B<setpgid>(2))."
6299 msgstr ""
6300
6301 #. type: Plain text
6302 #: build/C/man2/fork.2:58
6303 msgid "The child's parent process ID is the same as the parent's process ID."
6304 msgstr ""
6305
6306 #. type: Plain text
6307 #: build/C/man2/fork.2:62
6308 msgid ""
6309 "The child does not inherit its parent's memory locks (B<mlock>(2), "
6310 "B<mlockall>(2))."
6311 msgstr ""
6312
6313 #. type: Plain text
6314 #: build/C/man2/fork.2:68
6315 msgid ""
6316 "Process resource utilizations (B<getrusage>(2))  and CPU time counters "
6317 "(B<times>(2))  are reset to zero in the child."
6318 msgstr ""
6319
6320 #. type: Plain text
6321 #: build/C/man2/fork.2:71
6322 msgid "The child's set of pending signals is initially empty (B<sigpending>(2))."
6323 msgstr ""
6324
6325 #. type: Plain text
6326 #: build/C/man2/fork.2:74
6327 msgid ""
6328 "The child does not inherit semaphore adjustments from its parent "
6329 "(B<semop>(2))."
6330 msgstr ""
6331
6332 #. type: Plain text
6333 #: build/C/man2/fork.2:77
6334 msgid "The child does not inherit record locks from its parent (B<fcntl>(2))."
6335 msgstr ""
6336
6337 #. type: Plain text
6338 #: build/C/man2/fork.2:82
6339 msgid ""
6340 "The child does not inherit timers from its parent (B<setitimer>(2), "
6341 "B<alarm>(2), B<timer_create>(2))."
6342 msgstr ""
6343
6344 #. type: Plain text
6345 #: build/C/man2/fork.2:89
6346 msgid ""
6347 "The child does not inherit outstanding asynchronous I/O operations from its "
6348 "parent (B<aio_read>(3), B<aio_write>(3)), nor does it inherit any "
6349 "asynchronous I/O contexts from its parent (see B<io_setup>(2))."
6350 msgstr ""
6351
6352 #. type: Plain text
6353 #: build/C/man2/fork.2:94
6354 msgid ""
6355 "The process attributes in the preceding list are all specified in "
6356 "POSIX.1-2001.  The parent and child also differ with respect to the "
6357 "following Linux-specific process attributes:"
6358 msgstr ""
6359
6360 #. type: Plain text
6361 #: build/C/man2/fork.2:101
6362 msgid ""
6363 "The child does not inherit directory change notifications (dnotify)  from "
6364 "its parent (see the description of B<F_NOTIFY> in B<fcntl>(2))."
6365 msgstr ""
6366
6367 #. type: Plain text
6368 #: build/C/man2/fork.2:107
6369 msgid ""
6370 "The B<prctl>(2)  B<PR_SET_PDEATHSIG> setting is reset so that the child does "
6371 "not receive a signal when its parent terminates."
6372 msgstr ""
6373
6374 #. type: Plain text
6375 #: build/C/man2/fork.2:114
6376 msgid ""
6377 "The default timer slack value is set to the parent's current timer slack "
6378 "value.  See the description of B<PR_SET_TIMERSLACK> in B<prctl>(2)."
6379 msgstr ""
6380
6381 #. type: Plain text
6382 #: build/C/man2/fork.2:120
6383 msgid ""
6384 "Memory mappings that have been marked with the B<madvise>(2)  "
6385 "B<MADV_DONTFORK> flag are not inherited across a B<fork>()."
6386 msgstr ""
6387
6388 #. type: Plain text
6389 #: build/C/man2/fork.2:125
6390 msgid "The termination signal of the child is always B<SIGCHLD> (see B<clone>(2))."
6391 msgstr ""
6392
6393 #. type: Plain text
6394 #: build/C/man2/fork.2:131
6395 msgid ""
6396 "The port access permission bits set by B<ioperm>(2)  are not inherited by "
6397 "the child; the child must turn on any bits that it requires using "
6398 "B<ioperm>(2)."
6399 msgstr ""
6400
6401 #. type: Plain text
6402 #: build/C/man2/fork.2:142
6403 msgid ""
6404 "The child process is created with a single thread\\(emthe one that called "
6405 "B<fork>().  The entire virtual address space of the parent is replicated in "
6406 "the child, including the states of mutexes, condition variables, and other "
6407 "pthreads objects; the use of B<pthread_atfork>(3)  may be helpful for "
6408 "dealing with problems that this can cause."
6409 msgstr ""
6410
6411 #. type: Plain text
6412 #: build/C/man2/fork.2:156
6413 msgid ""
6414 "The child inherits copies of the parent's set of open file descriptors.  "
6415 "Each file descriptor in the child refers to the same open file description "
6416 "(see B<open>(2))  as the corresponding file descriptor in the parent.  This "
6417 "means that the two descriptors share open file status flags, current file "
6418 "offset, and signal-driven I/O attributes (see the description of B<F_SETOWN> "
6419 "and B<F_SETSIG> in B<fcntl>(2))."
6420 msgstr ""
6421
6422 #. type: Plain text
6423 #: build/C/man2/fork.2:165
6424 msgid ""
6425 "The child inherits copies of the parent's set of open message queue "
6426 "descriptors (see B<mq_overview>(7)).  Each descriptor in the child refers to "
6427 "the same open message queue description as the corresponding descriptor in "
6428 "the parent.  This means that the two descriptors share the same flags "
6429 "(I<mq_flags>)."
6430 msgstr ""
6431
6432 #. type: Plain text
6433 #: build/C/man2/fork.2:173
6434 msgid ""
6435 "The child inherits copies of the parent's set of open directory streams (see "
6436 "B<opendir>(3)).  POSIX.1-2001 says that the corresponding directory streams "
6437 "in the parent and child I<may> share the directory stream positioning; on "
6438 "Linux/glibc they do not."
6439 msgstr ""
6440
6441 #. type: Plain text
6442 #: build/C/man2/fork.2:180
6443 msgid ""
6444 "On success, the PID of the child process is returned in the parent, and 0 is "
6445 "returned in the child.  On failure, -1 is returned in the parent, no child "
6446 "process is created, and I<errno> is set appropriately."
6447 msgstr ""
6448
6449 #. type: Plain text
6450 #: build/C/man2/fork.2:186
6451 msgid ""
6452 "B<fork>()  cannot allocate sufficient memory to copy the parent's page "
6453 "tables and allocate a task structure for the child."
6454 msgstr ""
6455
6456 #. type: Plain text
6457 #: build/C/man2/fork.2:196
6458 msgid ""
6459 "It was not possible to create a new process because the caller's "
6460 "B<RLIMIT_NPROC> resource limit was encountered.  To exceed this limit, the "
6461 "process must have either the B<CAP_SYS_ADMIN> or the B<CAP_SYS_RESOURCE> "
6462 "capability."
6463 msgstr ""
6464
6465 #. type: Plain text
6466 #: build/C/man2/fork.2:200
6467 msgid ""
6468 "B<fork>()  failed to allocate the necessary kernel structures because memory "
6469 "is tight."
6470 msgstr ""
6471
6472 #.  e.g., arm (optionally), blackfin, c6x, frv, h8300, microblaze, xtensa
6473 #. type: Plain text
6474 #: build/C/man2/fork.2:206
6475 msgid ""
6476 "B<fork>()  is not supported on this platform (for example, hardware without "
6477 "a Memory-Management Unit)."
6478 msgstr ""
6479
6480 #. type: Plain text
6481 #: build/C/man2/fork.2:215
6482 msgid ""
6483 "Under Linux, B<fork>()  is implemented using copy-on-write pages, so the "
6484 "only penalty that it incurs is the time and memory required to duplicate the "
6485 "parent's page tables, and to create a unique task structure for the child."
6486 msgstr ""
6487
6488 #.  nptl/sysdeps/unix/sysv/linux/fork.c
6489 #.  and does some magic to ensure that getpid(2) returns the right value.
6490 #. type: Plain text
6491 #: build/C/man2/fork.2:239
6492 msgid ""
6493 "Since version 2.3.3, rather than invoking the kernel's B<fork>()  system "
6494 "call, the glibc B<fork>()  wrapper that is provided as part of the NPTL "
6495 "threading implementation invokes B<clone>(2)  with flags that provide the "
6496 "same effect as the traditional system call.  (A call to B<fork>()  is "
6497 "equivalent to a call to B<clone>(2)  specifying I<flags> as just "
6498 "B<SIGCHLD>.)  The glibc wrapper invokes any fork handlers that have been "
6499 "established using B<pthread_atfork>(3)."
6500 msgstr ""
6501
6502 #. type: Plain text
6503 #: build/C/man2/fork.2:244
6504 msgid "See B<pipe>(2)  and B<wait>(2)."
6505 msgstr ""
6506
6507 #. type: Plain text
6508 #: build/C/man2/fork.2:255
6509 msgid ""
6510 "B<clone>(2), B<execve>(2), B<exit>(2), B<setrlimit>(2), B<unshare>(2), "
6511 "B<vfork>(2), B<wait>(2), B<daemon>(3), B<capabilities>(7), B<credentials>(7)"
6512 msgstr ""
6513
6514 #. type: TH
6515 #: build/C/man3/fpathconf.3:41
6516 #, no-wrap
6517 msgid "FPATHCONF"
6518 msgstr ""
6519
6520 #. type: TH
6521 #: build/C/man3/fpathconf.3:41
6522 #, no-wrap
6523 msgid "1993-04-04"
6524 msgstr ""
6525
6526 #. type: Plain text
6527 #: build/C/man3/fpathconf.3:44
6528 msgid "fpathconf, pathconf - get configuration values for files"
6529 msgstr ""
6530
6531 #. type: Plain text
6532 #: build/C/man3/fpathconf.3:49
6533 #, no-wrap
6534 msgid "B<long fpathconf(int >I<fd>B<, int >I<name>B<);>\n"
6535 msgstr ""
6536
6537 #. type: Plain text
6538 #: build/C/man3/fpathconf.3:51
6539 #, no-wrap
6540 msgid "B<long pathconf(char *>I<path>B<, int >I<name>B<);>\n"
6541 msgstr ""
6542
6543 #. type: Plain text
6544 #: build/C/man3/fpathconf.3:58
6545 msgid ""
6546 "B<fpathconf>()  gets a value for the configuration option I<name> for the "
6547 "open file descriptor I<fd>."
6548 msgstr ""
6549
6550 #. type: Plain text
6551 #: build/C/man3/fpathconf.3:64
6552 msgid ""
6553 "B<pathconf>()  gets a value for configuration option I<name> for the "
6554 "filename I<path>."
6555 msgstr ""
6556
6557 #. type: Plain text
6558 #: build/C/man3/fpathconf.3:73
6559 msgid ""
6560 "The corresponding macros defined in I<E<lt>unistd.hE<gt>> are minimum "
6561 "values; if an application wants to take advantage of values which may "
6562 "change, a call to B<fpathconf>()  or B<pathconf>()  can be made, which may "
6563 "yield more liberal results."
6564 msgstr ""
6565
6566 #. type: Plain text
6567 #: build/C/man3/fpathconf.3:78
6568 msgid ""
6569 "Setting I<name> equal to one of the following constants returns the "
6570 "following configuration options:"
6571 msgstr ""
6572
6573 #. type: TP
6574 #: build/C/man3/fpathconf.3:78
6575 #, no-wrap
6576 msgid "B<_PC_LINK_MAX>"
6577 msgstr ""
6578
6579 #. type: Plain text
6580 #: build/C/man3/fpathconf.3:88
6581 msgid ""
6582 "returns the maximum number of links to the file.  If I<fd> or I<path> refer "
6583 "to a directory, then the value applies to the whole directory.  The "
6584 "corresponding macro is B<_POSIX_LINK_MAX>."
6585 msgstr ""
6586
6587 #. type: TP
6588 #: build/C/man3/fpathconf.3:88
6589 #, no-wrap
6590 msgid "B<_PC_MAX_CANON>"
6591 msgstr ""
6592
6593 #. type: Plain text
6594 #: build/C/man3/fpathconf.3:97
6595 msgid ""
6596 "returns the maximum length of a formatted input line, where I<fd> or I<path> "
6597 "must refer to a terminal.  The corresponding macro is B<_POSIX_MAX_CANON>."
6598 msgstr ""
6599
6600 #. type: TP
6601 #: build/C/man3/fpathconf.3:97
6602 #, no-wrap
6603 msgid "B<_PC_MAX_INPUT>"
6604 msgstr ""
6605
6606 #. type: Plain text
6607 #: build/C/man3/fpathconf.3:106
6608 msgid ""
6609 "returns the maximum length of an input line, where I<fd> or I<path> must "
6610 "refer to a terminal.  The corresponding macro is B<_POSIX_MAX_INPUT>."
6611 msgstr ""
6612
6613 #. type: TP
6614 #: build/C/man3/fpathconf.3:106
6615 #, no-wrap
6616 msgid "B<_PC_NAME_MAX>"
6617 msgstr ""
6618
6619 #. type: Plain text
6620 #: build/C/man3/fpathconf.3:115
6621 msgid ""
6622 "returns the maximum length of a filename in the directory I<path> or I<fd> "
6623 "that the process is allowed to create.  The corresponding macro is "
6624 "B<_POSIX_NAME_MAX>."
6625 msgstr ""
6626
6627 #. type: TP
6628 #: build/C/man3/fpathconf.3:115
6629 #, no-wrap
6630 msgid "B<_PC_PATH_MAX>"
6631 msgstr ""
6632
6633 #. type: Plain text
6634 #: build/C/man3/fpathconf.3:124
6635 msgid ""
6636 "returns the maximum length of a relative pathname when I<path> or I<fd> is "
6637 "the current working directory.  The corresponding macro is "
6638 "B<_POSIX_PATH_MAX>."
6639 msgstr ""
6640
6641 #. type: TP
6642 #: build/C/man3/fpathconf.3:124
6643 #, no-wrap
6644 msgid "B<_PC_PIPE_BUF>"
6645 msgstr ""
6646
6647 #. type: Plain text
6648 #: build/C/man3/fpathconf.3:133
6649 msgid ""
6650 "returns the size of the pipe buffer, where I<fd> must refer to a pipe or "
6651 "FIFO and I<path> must refer to a FIFO.  The corresponding macro is "
6652 "B<_POSIX_PIPE_BUF>."
6653 msgstr ""
6654
6655 #. type: TP
6656 #: build/C/man3/fpathconf.3:133
6657 #, no-wrap
6658 msgid "B<_PC_CHOWN_RESTRICTED>"
6659 msgstr ""
6660
6661 #. type: Plain text
6662 #: build/C/man3/fpathconf.3:146
6663 msgid ""
6664 "returns nonzero if the B<chown>(2)  call may not be used on this file.  If "
6665 "I<fd> or I<path> refer to a directory, then this applies to all files in "
6666 "that directory.  The corresponding macro is B<_POSIX_CHOWN_RESTRICTED>."
6667 msgstr ""
6668
6669 #. type: TP
6670 #: build/C/man3/fpathconf.3:146
6671 #, no-wrap
6672 msgid "B<_PC_NO_TRUNC>"
6673 msgstr ""
6674
6675 #. type: Plain text
6676 #: build/C/man3/fpathconf.3:153
6677 msgid ""
6678 "returns nonzero if accessing filenames longer than B<_POSIX_NAME_MAX> "
6679 "generates an error.  The corresponding macro is B<_POSIX_NO_TRUNC>."
6680 msgstr ""
6681
6682 #. type: TP
6683 #: build/C/man3/fpathconf.3:153
6684 #, no-wrap
6685 msgid "B<_PC_VDISABLE>"
6686 msgstr ""
6687
6688 #. type: Plain text
6689 #: build/C/man3/fpathconf.3:160
6690 msgid ""
6691 "returns nonzero if special character processing can be disabled, where I<fd> "
6692 "or I<path> must refer to a terminal."
6693 msgstr ""
6694
6695 #. type: Plain text
6696 #: build/C/man3/fpathconf.3:169
6697 msgid ""
6698 "The limit is returned, if one exists.  If the system does not have a limit "
6699 "for the requested resource, -1 is returned, and I<errno> is unchanged.  If "
6700 "there is an error, -1 is returned, and I<errno> is set to reflect the nature "
6701 "of the error."
6702 msgstr ""
6703
6704 #. type: Plain text
6705 #: build/C/man3/fpathconf.3:177
6706 msgid ""
6707 "Files with name lengths longer than the value returned for I<name> equal to "
6708 "B<_PC_NAME_MAX> may exist in the given directory."
6709 msgstr ""
6710
6711 #. type: Plain text
6712 #: build/C/man3/fpathconf.3:180 build/C/man3/sysconf.3:335
6713 msgid ""
6714 "Some returned values may be huge; they are not suitable for allocating "
6715 "memory."
6716 msgstr ""
6717
6718 #. type: Plain text
6719 #: build/C/man3/fpathconf.3:185
6720 msgid "B<getconf>(1), B<open>(2), B<statfs>(2), B<sysconf>(3)"
6721 msgstr ""
6722
6723 #. type: TH
6724 #: build/C/man2/fsync.2:38
6725 #, no-wrap
6726 msgid "FSYNC"
6727 msgstr ""
6728
6729 #. type: TH
6730 #: build/C/man2/fsync.2:38
6731 #, no-wrap
6732 msgid "2012-02-27"
6733 msgstr ""
6734
6735 #. type: Plain text
6736 #: build/C/man2/fsync.2:41
6737 msgid "fsync, fdatasync - synchronize a file's in-core state with storage device"
6738 msgstr ""
6739
6740 #. type: Plain text
6741 #: build/C/man2/fsync.2:45
6742 msgid "B<int fsync(int >I<fd>B<);>"
6743 msgstr ""
6744
6745 #. type: Plain text
6746 #: build/C/man2/fsync.2:47
6747 msgid "B<int fdatasync(int >I<fd>B<);>"
6748 msgstr ""
6749
6750 #. type: Plain text
6751 #: build/C/man2/fsync.2:55
6752 msgid "B<fsync>(): _BSD_SOURCE || _XOPEN_SOURCE"
6753 msgstr ""
6754
6755 #.  _POSIX_C_SOURCE\ >=\ 200112L only since glibc 2.8
6756 #. type: Plain text
6757 #: build/C/man2/fsync.2:58
6758 #, no-wrap
6759 msgid "         || /* since glibc 2.8: */ _POSIX_C_SOURCE\\ E<gt>=\\ 200112L\n"
6760 msgstr ""
6761
6762 #. type: Plain text
6763 #: build/C/man2/fsync.2:61
6764 msgid ""
6765 "B<fdatasync>(): _POSIX_C_SOURCE\\ E<gt>=\\ 199309L || _XOPEN_SOURCE\\ "
6766 "E<gt>=\\ 500"
6767 msgstr ""
6768
6769 #. type: Plain text
6770 #: build/C/man2/fsync.2:74
6771 msgid ""
6772 "B<fsync>()  transfers (\"flushes\") all modified in-core data of (i.e., "
6773 "modified buffer cache pages for) the file referred to by the file descriptor "
6774 "I<fd> to the disk device (or other permanent storage device) so that all "
6775 "changed information can be retrieved even after the system crashed or was "
6776 "rebooted.  This includes writing through or flushing a disk cache if "
6777 "present.  The call blocks until the device reports that the transfer has "
6778 "completed.  It also flushes metadata information associated with the file "
6779 "(see B<stat>(2))."
6780 msgstr ""
6781
6782 #. type: Plain text
6783 #: build/C/man2/fsync.2:82
6784 msgid ""
6785 "Calling B<fsync>()  does not necessarily ensure that the entry in the "
6786 "directory containing the file has also reached disk.  For that an explicit "
6787 "B<fsync>()  on a file descriptor for the directory is also needed."
6788 msgstr ""
6789
6790 #. type: Plain text
6791 #: build/C/man2/fsync.2:103
6792 msgid ""
6793 "B<fdatasync>()  is similar to B<fsync>(), but does not flush modified "
6794 "metadata unless that metadata is needed in order to allow a subsequent data "
6795 "retrieval to be correctly handled.  For example, changes to I<st_atime> or "
6796 "I<st_mtime> (respectively, time of last access and time of last "
6797 "modification; see B<stat>(2))  do not require flushing because they are not "
6798 "necessary for a subsequent data read to be handled correctly.  On the other "
6799 "hand, a change to the file size (I<st_size>, as made by say "
6800 "B<ftruncate>(2)), would require a metadata flush."
6801 msgstr ""
6802
6803 #. type: Plain text
6804 #: build/C/man2/fsync.2:108
6805 msgid ""
6806 "The aim of B<fdatasync>()  is to reduce disk activity for applications that "
6807 "do not require all metadata to be synchronized with the disk."
6808 msgstr ""
6809
6810 #. type: Plain text
6811 #: build/C/man2/fsync.2:113
6812 msgid ""
6813 "On success, these system calls return zero.  On error, -1 is returned, and "
6814 "I<errno> is set appropriately."
6815 msgstr ""
6816
6817 #. type: Plain text
6818 #: build/C/man2/fsync.2:118
6819 msgid "I<fd> is not a valid open file descriptor."
6820 msgstr ""
6821
6822 #. type: Plain text
6823 #: build/C/man2/fsync.2:121
6824 msgid "An error occurred during synchronization."
6825 msgstr ""
6826
6827 #. type: TP
6828 #: build/C/man2/fsync.2:121
6829 #, no-wrap
6830 msgid "B<EROFS>, B<EINVAL>"
6831 msgstr ""
6832
6833 #. type: Plain text
6834 #: build/C/man2/fsync.2:125
6835 msgid "I<fd> is bound to a special file which does not support synchronization."
6836 msgstr ""
6837
6838 #. type: Plain text
6839 #: build/C/man2/fsync.2:127
6840 msgid "4.3BSD, POSIX.1-2001."
6841 msgstr ""
6842
6843 #. type: SH
6844 #: build/C/man2/fsync.2:127
6845 #, no-wrap
6846 msgid "AVAILABILITY"
6847 msgstr ""
6848
6849 #.  POSIX.1-2001: It shall be defined to -1 or 0 or 200112L.
6850 #.  -1: unavailable, 0: ask using sysconf().
6851 #.  glibc defines them to 1.
6852 #. type: Plain text
6853 #: build/C/man2/fsync.2:140
6854 msgid ""
6855 "On POSIX systems on which B<fdatasync>()  is available, "
6856 "B<_POSIX_SYNCHRONIZED_IO> is defined in I<E<lt>unistd.hE<gt>> to a value "
6857 "greater than 0.  (See also B<sysconf>(3).)"
6858 msgstr ""
6859
6860 #. type: Plain text
6861 #: build/C/man2/fsync.2:146
6862 msgid ""
6863 "On some UNIX systems (but not Linux), I<fd> must be a I<writable> file "
6864 "descriptor."
6865 msgstr ""
6866
6867 #. type: Plain text
6868 #: build/C/man2/fsync.2:152
6869 msgid ""
6870 "In Linux 2.2 and earlier, B<fdatasync>()  is equivalent to B<fsync>(), and "
6871 "so has no performance advantage."
6872 msgstr ""
6873
6874 #. type: Plain text
6875 #: build/C/man2/fsync.2:162
6876 msgid ""
6877 "The B<fsync>()  implementations in older kernels and lesser used filesystems "
6878 "does not know how to flush disk caches.  In these cases disk caches need to "
6879 "be disabled using B<hdparm>(8)  or B<sdparm>(8)  to guarantee safe "
6880 "operation."
6881 msgstr ""
6882
6883 #. type: Plain text
6884 #: build/C/man2/fsync.2:171
6885 msgid ""
6886 "B<bdflush>(2), B<open>(2), B<sync>(2), B<sync_file_range>(2), B<hdparm>(8), "
6887 "B<mount>(8), B<sync>(8), B<update>(8)"
6888 msgstr ""
6889
6890 #. type: TH
6891 #: build/C/man3/get_nprocs_conf.3:26
6892 #, no-wrap
6893 msgid "GET_NPROCS"
6894 msgstr ""
6895
6896 #. type: TH
6897 #: build/C/man3/get_nprocs_conf.3:26
6898 #, no-wrap
6899 msgid "2012-03-20"
6900 msgstr ""
6901
6902 #. type: Plain text
6903 #: build/C/man3/get_nprocs_conf.3:29
6904 msgid "get_nprocs, get_nprocs_conf - get number of processors"
6905 msgstr ""
6906
6907 #. type: Plain text
6908 #: build/C/man3/get_nprocs_conf.3:31 build/C/man2/sysinfo.2:19
6909 msgid "B<#include E<lt>sys/sysinfo.hE<gt>>"
6910 msgstr ""
6911
6912 #. type: Plain text
6913 #: build/C/man3/get_nprocs_conf.3:33
6914 msgid "B<int get_nprocs(void);>"
6915 msgstr ""
6916
6917 #. type: Plain text
6918 #: build/C/man3/get_nprocs_conf.3:35
6919 msgid "B<int get_nprocs_conf(void);>"
6920 msgstr ""
6921
6922 #. type: Plain text
6923 #: build/C/man3/get_nprocs_conf.3:39
6924 msgid ""
6925 "The function B<get_nprocs_conf>()  returns the number of processors "
6926 "configured by the operating system."
6927 msgstr ""
6928
6929 #. type: Plain text
6930 #: build/C/man3/get_nprocs_conf.3:46
6931 msgid ""
6932 "The function B<get_nprocs>()  returns the number of processors currently "
6933 "available in the system.  This may be less than the number returned by "
6934 "B<get_nprocs_conf>()  because processors may be offline (e.g., on "
6935 "hotpluggable systems)."
6936 msgstr ""
6937
6938 #. type: Plain text
6939 #: build/C/man3/get_nprocs_conf.3:48
6940 msgid "As given in DESCRIPTION."
6941 msgstr ""
6942
6943 #. type: Plain text
6944 #: build/C/man3/get_nprocs_conf.3:50 build/C/man3/getopt.3:350
6945 msgid "These functions are GNU extensions."
6946 msgstr ""
6947
6948 #.  glibc 2.15
6949 #. type: Plain text
6950 #: build/C/man3/get_nprocs_conf.3:57
6951 msgid ""
6952 "The current implementation of these functions is rather expensive, since "
6953 "they open and parse files in the I</sys> file system each time they are "
6954 "called."
6955 msgstr ""
6956
6957 #. type: Plain text
6958 #: build/C/man3/get_nprocs_conf.3:62
6959 msgid ""
6960 "The following B<sysconf>(3)  calls make use of the functions documented on "
6961 "this page to return the same information."
6962 msgstr ""
6963
6964 #. type: Plain text
6965 #: build/C/man3/get_nprocs_conf.3:66
6966 #, no-wrap
6967 msgid ""
6968 "    np = sysconf(_SC_NPROCESSORS_CONF);     /* processors configured */\n"
6969 "    np = sysconf(_SC_NPROCESSORS_ONLN);     /* processors available */\n"
6970 msgstr ""
6971
6972 #. type: Plain text
6973 #: build/C/man3/get_nprocs_conf.3:73
6974 msgid ""
6975 "The following example shows how B<get_nprocs>()  and B<get_nprocs_conf>()  "
6976 "can be used."
6977 msgstr ""
6978
6979 #. type: Plain text
6980 #: build/C/man3/get_nprocs_conf.3:77
6981 #, no-wrap
6982 msgid ""
6983 "#include E<lt>stdio.hE<gt>\n"
6984 "#include E<lt>sys/sysinfo.hE<gt>\n"
6985 msgstr ""
6986
6987 #. type: Plain text
6988 #: build/C/man3/get_nprocs_conf.3:86
6989 #, no-wrap
6990 msgid ""
6991 "int\n"
6992 "main(int argc, char *argv[])\n"
6993 "{\n"
6994 "    printf(\"This system has %d processors configured and \"\n"
6995 "            \"%d processors available.\\en\",\n"
6996 "            get_nprocs_conf(), get_nprocs());\n"
6997 "    return 0;\n"
6998 "}\n"
6999 msgstr ""
7000
7001 #. type: TH
7002 #: build/C/man2/get_thread_area.2:8
7003 #, no-wrap
7004 msgid "GET_THREAD_AREA"
7005 msgstr ""
7006
7007 #. type: TH
7008 #: build/C/man2/get_thread_area.2:8 build/C/man2/set_thread_area.2:8
7009 #, no-wrap
7010 msgid "2012-07-13"
7011 msgstr ""
7012
7013 #. type: Plain text
7014 #: build/C/man2/get_thread_area.2:11
7015 msgid "get_thread_area - get a thread-local storage (TLS) area"
7016 msgstr ""
7017
7018 #. type: Plain text
7019 #: build/C/man2/get_thread_area.2:15 build/C/man2/set_thread_area.2:15
7020 msgid "B<#include E<lt>asm/ldt.hE<gt>>"
7021 msgstr ""
7022
7023 #. type: Plain text
7024 #: build/C/man2/get_thread_area.2:17
7025 msgid "B<int get_thread_area(struct user_desc *>I<u_info>B<);>"
7026 msgstr ""
7027
7028 #. type: Plain text
7029 #: build/C/man2/get_thread_area.2:20 build/C/man2/gettid.2:38 build/C/man2/set_thread_area.2:20 build/C/man2/sysctl.2:44
7030 msgid "I<Note>: There is no glibc wrapper for this system call; see NOTES."
7031 msgstr ""
7032
7033 #. type: Plain text
7034 #: build/C/man2/get_thread_area.2:29
7035 msgid ""
7036 "B<get_thread_area>()  returns an entry in the current thread's thread-local "
7037 "storage (TLS) array.  The index of the entry corresponds to the value of "
7038 "I<u_info-E<gt>entry_number>, passed in by the user.  If the value is in "
7039 "bounds, B<get_thread_area>()  copies the corresponding TLS entry into the "
7040 "area pointed to by I<u_info>."
7041 msgstr ""
7042
7043 #. type: Plain text
7044 #: build/C/man2/get_thread_area.2:35
7045 msgid ""
7046 "B<get_thread_area>()  returns 0 on success.  Otherwise, it returns -1 and "
7047 "sets I<errno> appropriately."
7048 msgstr ""
7049
7050 #. type: Plain text
7051 #: build/C/man2/get_thread_area.2:39 build/C/man2/set_thread_area.2:56
7052 msgid "I<u_info> is an invalid pointer."
7053 msgstr ""
7054
7055 #. type: Plain text
7056 #: build/C/man2/get_thread_area.2:42 build/C/man2/set_thread_area.2:53
7057 msgid "I<u_info-E<gt>entry_number> is out of bounds."
7058 msgstr ""
7059
7060 #. type: Plain text
7061 #: build/C/man2/get_thread_area.2:46
7062 msgid "A version of B<get_thread_area>()  first appeared in Linux 2.5.32."
7063 msgstr ""
7064
7065 #. type: Plain text
7066 #: build/C/man2/get_thread_area.2:50
7067 msgid ""
7068 "B<get_thread_area>()  is Linux-specific and should not be used in programs "
7069 "that are intended to be portable."
7070 msgstr ""
7071
7072 #. type: Plain text
7073 #: build/C/man2/get_thread_area.2:55
7074 msgid ""
7075 "Glibc does not provide a wrapper for this system call, since it is generally "
7076 "intended for use only by threading libraries.  In the unlikely event that "
7077 "you want to call it directly, use B<syscall>(2)."
7078 msgstr ""
7079
7080 #. type: Plain text
7081 #: build/C/man2/get_thread_area.2:58
7082 msgid "B<modify_ldt>(2), B<set_thread_area>(2)"
7083 msgstr ""
7084
7085 #. type: TH
7086 #: build/C/man3/getcwd.3:32
7087 #, no-wrap
7088 msgid "GETCWD"
7089 msgstr ""
7090
7091 #. type: Plain text
7092 #: build/C/man3/getcwd.3:35
7093 msgid "getcwd, getwd, get_current_dir_name - get current working directory"
7094 msgstr ""
7095
7096 #. type: Plain text
7097 #: build/C/man3/getcwd.3:40
7098 #, no-wrap
7099 msgid "B<char *getcwd(char *>I<buf>B<, size_t >I<size>B<);>\n"
7100 msgstr ""
7101
7102 #. type: Plain text
7103 #: build/C/man3/getcwd.3:42
7104 #, no-wrap
7105 msgid "B<char *getwd(char *>I<buf>B<);>\n"
7106 msgstr ""
7107
7108 #. type: Plain text
7109 #: build/C/man3/getcwd.3:44
7110 #, no-wrap
7111 msgid "B<char *get_current_dir_name(void);>\n"
7112 msgstr ""
7113
7114 #. type: Plain text
7115 #: build/C/man3/getcwd.3:52
7116 msgid "B<get_current_dir_name>():"
7117 msgstr ""
7118
7119 #. type: Plain text
7120 #: build/C/man3/getcwd.3:57
7121 msgid "B<getwd>():"
7122 msgstr ""
7123
7124 #. type: Plain text
7125 #: build/C/man3/getcwd.3:67 build/C/man3/ualarm.3:50 build/C/man3/usleep.3:59 build/C/man2/vfork.2:54
7126 #, no-wrap
7127 msgid ""
7128 "_BSD_SOURCE ||\n"
7129 "    (_XOPEN_SOURCE\\ E<gt>=\\ 500 ||\n"
7130 "        _XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED) &&\n"
7131 "    !(_POSIX_C_SOURCE\\ E<gt>=\\ 200809L || _XOPEN_SOURCE\\ E<gt>=\\ 700)\n"
7132 msgstr ""
7133
7134 #. type: Plain text
7135 #: build/C/man3/getcwd.3:72 build/C/man3/getdtablesize.3:54 build/C/man2/getpagesize.2:52 build/C/man3/ualarm.3:55 build/C/man3/usleep.3:64 build/C/man2/vfork.2:59
7136 msgid ""
7137 "Before glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
7138 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
7139 msgstr ""
7140
7141 #. type: Plain text
7142 #: build/C/man3/getcwd.3:82
7143 msgid ""
7144 "These functions return a null-terminated string containing an absolute "
7145 "pathname that is the current working directory of the calling process.  The "
7146 "pathname is returned as the function result and via the argument I<buf>, if "
7147 "present."
7148 msgstr ""
7149
7150 #. type: Plain text
7151 #: build/C/man3/getcwd.3:90
7152 msgid ""
7153 "The B<getcwd>()  function copies an absolute pathname of the current working "
7154 "directory to the array pointed to by I<buf>, which is of length I<size>."
7155 msgstr ""
7156
7157 #. type: Plain text
7158 #: build/C/man3/getcwd.3:100
7159 msgid ""
7160 "If the length of the absolute pathname of the current working directory, "
7161 "including the terminating null byte, exceeds I<size> bytes, NULL is "
7162 "returned, and I<errno> is set to B<ERANGE>; an application should check for "
7163 "this error, and allocate a larger buffer if necessary."
7164 msgstr ""
7165
7166 #. type: Plain text
7167 #: build/C/man3/getcwd.3:118
7168 msgid ""
7169 "As an extension to the POSIX.1-2001 standard, Linux (libc4, libc5, glibc)  "
7170 "B<getcwd>()  allocates the buffer dynamically using B<malloc>(3)  if I<buf> "
7171 "is NULL.  In this case, the allocated buffer has the length I<size> unless "
7172 "I<size> is zero, when I<buf> is allocated as big as necessary.  The caller "
7173 "should B<free>(3)  the returned buffer."
7174 msgstr ""
7175
7176 #. type: Plain text
7177 #: build/C/man3/getcwd.3:131
7178 msgid ""
7179 "B<get_current_dir_name>()  will B<malloc>(3)  an array big enough to hold "
7180 "the absolute pathname of the current working directory.  If the environment "
7181 "variable B<PWD> is set, and its value is correct, then that value will be "
7182 "returned.  The caller should B<free>(3)  the returned buffer."
7183 msgstr ""
7184
7185 #. type: Plain text
7186 #: build/C/man3/getcwd.3:156
7187 msgid ""
7188 "B<getwd>()  does not B<malloc>(3)  any memory.  The I<buf> argument should "
7189 "be a pointer to an array at least B<PATH_MAX> bytes long.  If the length of "
7190 "the absolute pathname of the current working directory, including the "
7191 "terminating null byte, exceeds B<PATH_MAX> bytes, NULL is returned, and "
7192 "I<errno> is set to B<ENAMETOOLONG>.  (Note that on some systems, B<PATH_MAX> "
7193 "may not be a compile-time constant; furthermore, its value may depend on the "
7194 "file system, see B<pathconf>(3).)  For portability and security reasons, use "
7195 "of B<getwd>()  is deprecated."
7196 msgstr ""
7197
7198 #. type: Plain text
7199 #: build/C/man3/getcwd.3:165
7200 msgid ""
7201 "On success, these functions return a pointer to a string containing the "
7202 "pathname of the current working directory.  In the case B<getcwd>()  and "
7203 "B<getwd>()  this is the same value as I<buf>."
7204 msgstr ""
7205
7206 #. type: Plain text
7207 #: build/C/man3/getcwd.3:172
7208 msgid ""
7209 "On failure, these functions return NULL, and I<errno> is set to indicate the "
7210 "error.  The contents of the array pointed to by I<buf> are undefined on "
7211 "error."
7212 msgstr ""
7213
7214 #. type: Plain text
7215 #: build/C/man3/getcwd.3:176
7216 msgid "Permission to read or search a component of the filename was denied."
7217 msgstr ""
7218
7219 #. type: Plain text
7220 #: build/C/man3/getcwd.3:180
7221 msgid "I<buf> points to a bad address."
7222 msgstr ""
7223
7224 #. type: Plain text
7225 #: build/C/man3/getcwd.3:187
7226 msgid "The I<size> argument is zero and I<buf> is not a NULL pointer."
7227 msgstr ""
7228
7229 #. type: TP
7230 #: build/C/man3/getcwd.3:187
7231 #, no-wrap
7232 msgid "EINVAL"
7233 msgstr ""
7234
7235 #. type: Plain text
7236 #: build/C/man3/getcwd.3:192
7237 msgid "B<getwd>(): I<buf> is NULL."
7238 msgstr ""
7239
7240 #. type: TP
7241 #: build/C/man3/getcwd.3:192
7242 #, no-wrap
7243 msgid "ENAMETOOLONG"
7244 msgstr ""
7245
7246 #. type: Plain text
7247 #: build/C/man3/getcwd.3:198
7248 msgid ""
7249 "B<getwd>(): The size of the null-terminated absolute pathname string exceeds "
7250 "B<PATH_MAX> bytes."
7251 msgstr ""
7252
7253 #. type: Plain text
7254 #: build/C/man3/getcwd.3:201
7255 msgid "The current working directory has been unlinked."
7256 msgstr ""
7257
7258 #. type: TP
7259 #: build/C/man3/getcwd.3:201 build/C/man3/getlogin.3:114
7260 #, no-wrap
7261 msgid "B<ERANGE>"
7262 msgstr ""
7263
7264 #. type: Plain text
7265 #: build/C/man3/getcwd.3:208
7266 msgid ""
7267 "The I<size> argument is less than the length of the absolute pathname of the "
7268 "working directory, including the terminating null byte.  You need to "
7269 "allocate a bigger array and try again."
7270 msgstr ""
7271
7272 #. type: Plain text
7273 #: build/C/man3/getcwd.3:216
7274 msgid ""
7275 "B<getcwd>()  conforms to POSIX.1-2001.  Note however that POSIX.1-2001 "
7276 "leaves the behavior of B<getcwd>()  unspecified if I<buf> is NULL."
7277 msgstr ""
7278
7279 #. type: Plain text
7280 #: build/C/man3/getcwd.3:227
7281 msgid ""
7282 "B<getwd>()  is present in POSIX.1-2001, but marked LEGACY.  POSIX.1-2008 "
7283 "removes the specification of B<getwd>().  Use B<getcwd>()  instead.  "
7284 "POSIX.1-2001 does not define any errors for B<getwd>()."
7285 msgstr ""
7286
7287 #. type: Plain text
7288 #: build/C/man3/getcwd.3:230
7289 msgid "B<get_current_dir_name>()  is a GNU extension."
7290 msgstr ""
7291
7292 #. type: Plain text
7293 #: build/C/man3/getcwd.3:241
7294 msgid ""
7295 "Under Linux, the function B<getcwd>()  is a system call (since 2.1.92).  On "
7296 "older systems it would query I</proc/self/cwd>.  If both system call and "
7297 "proc file system are missing, a generic implementation is called.  Only in "
7298 "that case can these calls fail under Linux with B<EACCES>."
7299 msgstr ""
7300
7301 #. type: Plain text
7302 #: build/C/man3/getcwd.3:249
7303 msgid ""
7304 "These functions are often used to save the location of the current working "
7305 "directory for the purpose of returning to it later.  Opening the current "
7306 "directory (\".\") and calling B<fchdir>(2)  to return is usually a faster "
7307 "and more reliable alternative when sufficiently many file descriptors are "
7308 "available, especially on platforms other than Linux."
7309 msgstr ""
7310
7311 #. type: Plain text
7312 #: build/C/man3/getcwd.3:256
7313 msgid ""
7314 "B<chdir>(2), B<fchdir>(2), B<open>(2), B<unlink>(2), B<free>(3), "
7315 "B<malloc>(3)"
7316 msgstr ""
7317
7318 #. type: TH
7319 #: build/C/man2/getdomainname.2:29
7320 #, no-wrap
7321 msgid "GETDOMAINNAME"
7322 msgstr ""
7323
7324 #. type: TH
7325 #: build/C/man2/getdomainname.2:29
7326 #, no-wrap
7327 msgid "2012-10-25"
7328 msgstr ""
7329
7330 #. type: Plain text
7331 #: build/C/man2/getdomainname.2:32
7332 msgid "getdomainname, setdomainname - get/set NIS domain name"
7333 msgstr ""
7334
7335 #. type: Plain text
7336 #: build/C/man2/getdomainname.2:36
7337 msgid "B<int getdomainname(char *>I<name>B<, size_t >I<len>B<);>"
7338 msgstr ""
7339
7340 #. type: Plain text
7341 #: build/C/man2/getdomainname.2:38
7342 msgid "B<int setdomainname(const char *>I<name>B<, size_t >I<len>B<);>"
7343 msgstr ""
7344
7345 #. type: Plain text
7346 #: build/C/man2/getdomainname.2:47
7347 msgid "B<getdomainname>(), B<setdomainname>():"
7348 msgstr ""
7349
7350 #. type: Plain text
7351 #: build/C/man2/getdomainname.2:49 build/C/man3/gethostid.3:54 build/C/man2/gethostname.2:60 build/C/man3/getusershell.3:55
7352 msgid "_BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\\ E<lt>\\ 500)"
7353 msgstr ""
7354
7355 #. type: Plain text
7356 #: build/C/man2/getdomainname.2:54
7357 msgid ""
7358 "These functions are used to access or to change the NIS domain name of the "
7359 "host system."
7360 msgstr ""
7361
7362 #. type: Plain text
7363 #: build/C/man2/getdomainname.2:65
7364 msgid ""
7365 "B<setdomainname>()  sets the domain name to the value given in the character "
7366 "array I<name>.  The I<len> argument specifies the number of bytes in "
7367 "I<name>.  (Thus, I<name> does not require a terminating null byte.)"
7368 msgstr ""
7369
7370 #. type: Plain text
7371 #: build/C/man2/getdomainname.2:75
7372 msgid ""
7373 "B<getdomainname>()  returns the null-terminated domain name in the character "
7374 "array I<name>, which has a length of I<len> bytes.  If the null-terminated "
7375 "domain name requires more than I<len> bytes, B<getdomainname>()  returns the "
7376 "first I<len> bytes (glibc) or gives an error (libc)."
7377 msgstr ""
7378
7379 #. type: Plain text
7380 #: build/C/man2/getdomainname.2:83
7381 msgid "B<setdomainname>()  can fail with the following errors:"
7382 msgstr ""
7383
7384 #. type: Plain text
7385 #: build/C/man2/getdomainname.2:87
7386 msgid "I<name> pointed outside of user address space."
7387 msgstr ""
7388
7389 #. type: Plain text
7390 #: build/C/man2/getdomainname.2:91
7391 msgid "I<len> was negative or too large."
7392 msgstr ""
7393
7394 #. type: Plain text
7395 #: build/C/man2/getdomainname.2:96
7396 msgid ""
7397 "the caller is unprivileged (Linux: does not have the B<CAP_SYS_ADMIN> "
7398 "capability)."
7399 msgstr ""
7400
7401 #. type: Plain text
7402 #: build/C/man2/getdomainname.2:99
7403 msgid "B<getdomainname>()  can fail with the following errors:"
7404 msgstr ""
7405
7406 #. type: Plain text
7407 #: build/C/man2/getdomainname.2:110
7408 msgid ""
7409 "For B<getdomainname>()  under libc: I<name> is NULL or I<name> is longer "
7410 "than I<len> bytes."
7411 msgstr ""
7412
7413 #.  But they appear on most systems...
7414 #. type: Plain text
7415 #: build/C/man2/getdomainname.2:113
7416 msgid "POSIX does not specify these calls."
7417 msgstr ""
7418
7419 #. type: Plain text
7420 #: build/C/man2/getdomainname.2:117
7421 msgid ""
7422 "Since Linux 1.0, the limit on the length of a domain name, including the "
7423 "terminating null byte, is 64 bytes.  In older kernels, it was 8 bytes."
7424 msgstr ""
7425
7426 #. type: Plain text
7427 #: build/C/man2/getdomainname.2:127
7428 msgid ""
7429 "On most Linux architectures (including x86), there is no B<getdomainname>()  "
7430 "system call; instead, glibc implements B<getdomainname>()  as a library "
7431 "function that returns a copy of the I<domainname> field returned from a call "
7432 "to B<uname>(2)."
7433 msgstr ""
7434
7435 #. type: Plain text
7436 #: build/C/man2/getdomainname.2:131
7437 msgid "B<gethostname>(2), B<sethostname>(2), B<uname>(2)"
7438 msgstr ""
7439
7440 #. type: TH
7441 #: build/C/man3/getdtablesize.3:27
7442 #, no-wrap
7443 msgid "GETDTABLESIZE"
7444 msgstr ""
7445
7446 #. type: TH
7447 #: build/C/man3/getdtablesize.3:27
7448 #, no-wrap
7449 msgid "2013-02-05"
7450 msgstr ""
7451
7452 #. type: Plain text
7453 #: build/C/man3/getdtablesize.3:30
7454 msgid "getdtablesize - get descriptor table size"
7455 msgstr ""
7456
7457 #. type: Plain text
7458 #: build/C/man3/getdtablesize.3:34
7459 msgid "B<int getdtablesize(void);>"
7460 msgstr ""
7461
7462 #. type: Plain text
7463 #: build/C/man3/getdtablesize.3:41
7464 msgid "B<getdtablesize>():"
7465 msgstr ""
7466
7467 #. type: Plain text
7468 #: build/C/man3/getdtablesize.3:49 build/C/man2/getpagesize.2:47
7469 #, no-wrap
7470 msgid ""
7471 "_BSD_SOURCE ||\n"
7472 "    !(_POSIX_C_SOURCE\\ E<gt>=\\ 200112L || _XOPEN_SOURCE\\ E<gt>=\\ 600)\n"
7473 msgstr ""
7474
7475 #. type: Plain text
7476 #: build/C/man3/getdtablesize.3:61
7477 msgid ""
7478 "B<getdtablesize>()  returns the maximum number of files a process can have "
7479 "open, one more than the largest possible value for a file descriptor."
7480 msgstr ""
7481
7482 #. type: Plain text
7483 #: build/C/man3/getdtablesize.3:63
7484 msgid "The current limit on the number of open files per process."
7485 msgstr ""
7486
7487 #. type: Plain text
7488 #: build/C/man3/getdtablesize.3:69
7489 msgid ""
7490 "On Linux, B<getdtablesize>()  can return any of the errors described for "
7491 "B<getrlimit>(2); see NOTES below."
7492 msgstr ""
7493
7494 #. type: Plain text
7495 #: build/C/man3/getdtablesize.3:77
7496 msgid ""
7497 "SVr4, 4.4BSD (the B<getdtablesize>()  function first appeared in 4.2BSD).  "
7498 "It is not specified in POSIX.1-2001; portable applications should employ "
7499 "I<sysconf(_SC_OPEN_MAX)> instead of this call."
7500 msgstr ""
7501
7502 #. type: Plain text
7503 #: build/C/man3/getdtablesize.3:90
7504 msgid ""
7505 "B<getdtablesize>()  is implemented as a libc library function.  The glibc "
7506 "version calls B<getrlimit>(2)  and returns the current B<RLIMIT_NOFILE> "
7507 "limit, or B<OPEN_MAX> when that fails.  The libc4 and libc5 versions return "
7508 "B<OPEN_MAX> (set to 256 since Linux 0.98.4)."
7509 msgstr ""
7510
7511 #. type: Plain text
7512 #: build/C/man3/getdtablesize.3:95
7513 msgid "B<close>(2), B<dup>(2), B<getrlimit>(2), B<open>(2)"
7514 msgstr ""
7515
7516 #. type: TH
7517 #: build/C/man3/gethostid.3:29
7518 #, no-wrap
7519 msgid "GETHOSTID"
7520 msgstr ""
7521
7522 #. type: Plain text
7523 #: build/C/man3/gethostid.3:32
7524 msgid "gethostid, sethostid - get or set the unique identifier of the current host"
7525 msgstr ""
7526
7527 #. type: Plain text
7528 #: build/C/man3/gethostid.3:36
7529 msgid "B<long gethostid(void);>"
7530 msgstr ""
7531
7532 #. type: Plain text
7533 #: build/C/man3/gethostid.3:38
7534 msgid "B<int sethostid(long >I<hostid>B<);>"
7535 msgstr ""
7536
7537 #. type: Plain text
7538 #: build/C/man3/gethostid.3:47
7539 msgid "B<gethostid>():"
7540 msgstr ""
7541
7542 #. type: Plain text
7543 #: build/C/man3/gethostid.3:52
7544 msgid "B<sethostid>():"
7545 msgstr ""
7546
7547 #. type: Plain text
7548 #: build/C/man3/gethostid.3:67
7549 msgid ""
7550 "B<gethostid>()  and B<sethostid>()  respectively get or set a unique 32-bit "
7551 "identifier for the current machine.  The 32-bit identifier is intended to be "
7552 "unique among all UNIX systems in existence.  This normally resembles the "
7553 "Internet address for the local machine, as returned by B<gethostbyname>(3), "
7554 "and thus usually never needs to be set."
7555 msgstr ""
7556
7557 #. type: Plain text
7558 #: build/C/man3/gethostid.3:71
7559 msgid "The B<sethostid>()  call is restricted to the superuser."
7560 msgstr ""
7561
7562 #. type: Plain text
7563 #: build/C/man3/gethostid.3:75
7564 msgid ""
7565 "B<gethostid>()  returns the 32-bit identifier for the current host as set by "
7566 "B<sethostid>()."
7567 msgstr ""
7568
7569 #. type: Plain text
7570 #: build/C/man3/gethostid.3:81
7571 msgid ""
7572 "On success, B<sethostid>()  returns 0; on error, -1 is returned, and "
7573 "I<errno> is set to indicate the error."
7574 msgstr ""
7575
7576 #. type: Plain text
7577 #: build/C/man3/gethostid.3:84
7578 msgid "B<sethostid>()  can fail with the following errors:"
7579 msgstr ""
7580
7581 #. type: Plain text
7582 #: build/C/man3/gethostid.3:88
7583 msgid ""
7584 "The caller did not have permission to write to the file used to store the "
7585 "host ID."
7586 msgstr ""
7587
7588 #. type: Plain text
7589 #: build/C/man3/gethostid.3:92
7590 msgid ""
7591 "The calling process's effective user or group ID is not the same as its "
7592 "corresponding real ID."
7593 msgstr ""
7594
7595 #. type: Plain text
7596 #: build/C/man3/gethostid.3:102
7597 msgid ""
7598 "4.2BSD; these functions were dropped in 4.4BSD.  SVr4 includes "
7599 "B<gethostid>()  but not B<sethostid>().  POSIX.1-2001 specifies "
7600 "B<gethostid>()  but not B<sethostid>()."
7601 msgstr ""
7602
7603 #.  libc5 used /etc/hostid; libc4 didn't have these functions
7604 #. type: Plain text
7605 #: build/C/man3/gethostid.3:111
7606 msgid ""
7607 "In the glibc implementation, the I<hostid> is stored in the file "
7608 "I</etc/hostid>.  (In glibc versions before 2.2, the file I</var/adm/hostid> "
7609 "was used.)"
7610 msgstr ""
7611
7612 #. type: Plain text
7613 #: build/C/man3/gethostid.3:122
7614 msgid ""
7615 "In the glibc implementation, if B<gethostid>()  cannot open the file "
7616 "containing the host ID, then it obtains the hostname using "
7617 "B<gethostname>(2), passes that hostname to B<gethostbyname_r>(3)  in order "
7618 "to obtain the host's IPv4 address, and returns a value obtained by "
7619 "bit-twiddling the IPv4 address.  (This value may not be unique.)"
7620 msgstr ""
7621
7622 #. type: Plain text
7623 #: build/C/man3/gethostid.3:124
7624 msgid "It is impossible to ensure that the identifier is globally unique."
7625 msgstr ""
7626
7627 #. type: Plain text
7628 #: build/C/man3/gethostid.3:127
7629 msgid "B<hostid>(1), B<gethostbyname>(3)"
7630 msgstr ""
7631
7632 #. type: TH
7633 #: build/C/man2/gethostname.2:32
7634 #, no-wrap
7635 msgid "GETHOSTNAME"
7636 msgstr ""
7637
7638 #. type: Plain text
7639 #: build/C/man2/gethostname.2:35
7640 msgid "gethostname, sethostname - get/set hostname"
7641 msgstr ""
7642
7643 #. type: Plain text
7644 #: build/C/man2/gethostname.2:39
7645 msgid "B<int gethostname(char *>I<name>B<, size_t >I<len>B<);>"
7646 msgstr ""
7647
7648 #. type: Plain text
7649 #: build/C/man2/gethostname.2:41
7650 msgid "B<int sethostname(const char *>I<name>B<, size_t >I<len>B<);>"
7651 msgstr ""
7652
7653 #. type: Plain text
7654 #: build/C/man2/gethostname.2:50
7655 msgid "B<gethostname>():"
7656 msgstr ""
7657
7658 #. type: Plain text
7659 #: build/C/man2/gethostname.2:53
7660 msgid "Since glibc 2.12: _BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500"
7661 msgstr ""
7662
7663 #. type: Plain text
7664 #: build/C/man2/gethostname.2:55
7665 msgid "|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\\ E<gt>=\\ 200112L"
7666 msgstr ""
7667
7668 #. type: Plain text
7669 #: build/C/man2/gethostname.2:58
7670 msgid "B<sethostname>():"
7671 msgstr ""
7672
7673 #. type: Plain text
7674 #: build/C/man2/gethostname.2:66
7675 msgid ""
7676 "These system calls are used to access or to change the hostname of the "
7677 "current processor."
7678 msgstr ""
7679
7680 #. type: Plain text
7681 #: build/C/man2/gethostname.2:77
7682 msgid ""
7683 "B<sethostname>()  sets the hostname to the value given in the character "
7684 "array I<name>.  The I<len> argument specifies the number of bytes in "
7685 "I<name>.  (Thus, I<name> does not require a terminating null byte.)"
7686 msgstr ""
7687
7688 #. type: Plain text
7689 #: build/C/man2/gethostname.2:89
7690 msgid ""
7691 "B<gethostname>()  returns the null-terminated hostname in the character "
7692 "array I<name>, which has a length of I<len> bytes.  If the null-terminated "
7693 "hostname is too large to fit, then the name is truncated, and no error is "
7694 "returned (but see NOTES below).  POSIX.1-2001 says that if such truncation "
7695 "occurs, then it is unspecified whether the returned buffer includes a "
7696 "terminating null byte."
7697 msgstr ""
7698
7699 #. type: Plain text
7700 #: build/C/man2/gethostname.2:99
7701 msgid "I<name> is an invalid address."
7702 msgstr ""
7703
7704 #.  Can't occur for gethostbyname() wrapper, since 'len' has an
7705 #.  unsigned type; can occur for the underlying system call.
7706 #. type: Plain text
7707 #: build/C/man2/gethostname.2:109
7708 msgid ""
7709 "I<len> is negative or, for B<sethostname>(), I<len> is larger than the "
7710 "maximum allowed size."
7711 msgstr ""
7712
7713 #. type: Plain text
7714 #: build/C/man2/gethostname.2:117
7715 msgid ""
7716 "(glibc B<gethostname>())  I<len> is smaller than the actual size.  (Before "
7717 "version 2.1, glibc uses B<EINVAL> for this case.)"
7718 msgstr ""
7719
7720 #. type: Plain text
7721 #: build/C/man2/gethostname.2:124
7722 msgid ""
7723 "For B<sethostname>(), the caller did not have the B<CAP_SYS_ADMIN> "
7724 "capability."
7725 msgstr ""
7726
7727 #. type: Plain text
7728 #: build/C/man2/gethostname.2:130
7729 msgid ""
7730 "SVr4, 4.4BSD (these interfaces first appeared in 4.2BSD).  POSIX.1-2001 "
7731 "specifies B<gethostname>()  but not B<sethostname>()."
7732 msgstr ""
7733
7734 #. type: Plain text
7735 #: build/C/man2/gethostname.2:140
7736 msgid ""
7737 "SUSv2 guarantees that \"Host names are limited to 255 bytes\".  POSIX.1-2001 "
7738 "guarantees that \"Host names (not including the terminating null byte) are "
7739 "limited to B<HOST_NAME_MAX> bytes\".  On Linux, B<HOST_NAME_MAX> is defined "
7740 "with the value 64, which has been the limit since Linux 1.0 (earlier kernels "
7741 "imposed a limit of 8 bytes)."
7742 msgstr ""
7743
7744 #. type: Plain text
7745 #: build/C/man2/gethostname.2:163
7746 msgid ""
7747 "The GNU C library does not employ the B<gethostname>()  system call; "
7748 "instead, it implements B<gethostname>()  as a library function that calls "
7749 "B<uname>(2)  and copies up to I<len> bytes from the returned I<nodename> "
7750 "field into I<name>.  Having performed the copy, the function then checks if "
7751 "the length of the I<nodename> was greater than or equal to I<len>, and if it "
7752 "is, then the function returns -1 with I<errno> set to B<ENAMETOOLONG>; in "
7753 "this case, a terminating null byte is not included in the returned I<name>."
7754 msgstr ""
7755
7756 #.  At least glibc 2.0 and 2.1, older versions not checked
7757 #. type: Plain text
7758 #: build/C/man2/gethostname.2:176
7759 msgid ""
7760 "Versions of glibc before 2.2 handle the case where the length of the "
7761 "I<nodename> was greater than or equal to I<len> differently: nothing is "
7762 "copied into I<name> and the function returns -1 with I<errno> set to "
7763 "B<ENAMETOOLONG>."
7764 msgstr ""
7765
7766 #. type: Plain text
7767 #: build/C/man2/gethostname.2:180
7768 msgid "B<getdomainname>(2), B<setdomainname>(2), B<uname>(2)"
7769 msgstr ""
7770
7771 #. type: TH
7772 #: build/C/man3/getlogin.3:28
7773 #, no-wrap
7774 msgid "GETLOGIN"
7775 msgstr ""
7776
7777 #. type: TH
7778 #: build/C/man3/getlogin.3:28 build/C/man3/usleep.3:33
7779 #, no-wrap
7780 msgid "2013-04-19"
7781 msgstr ""
7782
7783 #. type: Plain text
7784 #: build/C/man3/getlogin.3:31
7785 msgid "getlogin, getlogin_r, cuserid - get username"
7786 msgstr ""
7787
7788 #. type: Plain text
7789 #: build/C/man3/getlogin.3:35
7790 msgid "B<char *getlogin(void);>"
7791 msgstr ""
7792
7793 #. type: Plain text
7794 #: build/C/man3/getlogin.3:37
7795 msgid "B<int getlogin_r(char *>I<buf>B<, size_t >I<bufsize>B<);>"
7796 msgstr ""
7797
7798 #. type: Plain text
7799 #: build/C/man3/getlogin.3:39
7800 msgid "B<#include E<lt>stdio.hE<gt>>"
7801 msgstr ""
7802
7803 #. type: Plain text
7804 #: build/C/man3/getlogin.3:41
7805 msgid "B<char *cuserid(char *>I<string>B<);>"
7806 msgstr ""
7807
7808 #. type: Plain text
7809 #: build/C/man3/getlogin.3:49
7810 msgid "B<getlogin_r>(): _REENTRANT || _POSIX_C_SOURCE\\ E<gt>=\\ 199506L"
7811 msgstr ""
7812
7813 #. type: Plain text
7814 #: build/C/man3/getlogin.3:52
7815 msgid "B<cuserid>(): _XOPEN_SOURCE"
7816 msgstr ""
7817
7818 #. type: Plain text
7819 #: build/C/man3/getlogin.3:61
7820 msgid ""
7821 "B<getlogin>()  returns a pointer to a string containing the name of the user "
7822 "logged in on the controlling terminal of the process, or a NULL pointer if "
7823 "this information cannot be determined.  The string is statically allocated "
7824 "and might be overwritten on subsequent calls to this function or to "
7825 "B<cuserid>()."
7826 msgstr ""
7827
7828 #. type: Plain text
7829 #: build/C/man3/getlogin.3:67
7830 msgid ""
7831 "B<getlogin_r>()  returns this same username in the array I<buf> of size "
7832 "I<bufsize>."
7833 msgstr ""
7834
7835 #. type: Plain text
7836 #: build/C/man3/getlogin.3:79
7837 msgid ""
7838 "B<cuserid>()  returns a pointer to a string containing a username associated "
7839 "with the effective user ID of the process.  If I<string> is not a NULL "
7840 "pointer, it should be an array that can hold at least B<L_cuserid> "
7841 "characters; the string is returned in this array.  Otherwise, a pointer to a "
7842 "string in a static area is returned.  This string is statically allocated "
7843 "and might be overwritten on subsequent calls to this function or to "
7844 "B<getlogin>()."
7845 msgstr ""
7846
7847 #. type: Plain text
7848 #: build/C/man3/getlogin.3:83
7849 msgid ""
7850 "The macro B<L_cuserid> is an integer constant that indicates how long an "
7851 "array you might need to store a username.  B<L_cuserid> is declared in "
7852 "I<E<lt>stdio.hE<gt>>."
7853 msgstr ""
7854
7855 #. type: Plain text
7856 #: build/C/man3/getlogin.3:90
7857 msgid ""
7858 "These functions let your program identify positively the user who is running "
7859 "(B<cuserid>())  or the user who logged in this session (B<getlogin>()).  "
7860 "(These can differ when set-user-ID programs are involved.)"
7861 msgstr ""
7862
7863 #. type: Plain text
7864 #: build/C/man3/getlogin.3:95
7865 msgid ""
7866 "For most purposes, it is more useful to use the environment variable "
7867 "B<LOGNAME> to find out who the user is.  This is more flexible precisely "
7868 "because the user can set B<LOGNAME> arbitrarily."
7869 msgstr ""
7870
7871 #. type: Plain text
7872 #: build/C/man3/getlogin.3:103
7873 msgid ""
7874 "B<getlogin>()  returns a pointer to the username when successful, and NULL "
7875 "on failure, with I<errno> set to indicate the cause of the error.  "
7876 "B<getlogin_r>()  returns 0 when successful, and nonzero on failure."
7877 msgstr ""
7878
7879 #. type: Plain text
7880 #: build/C/man3/getlogin.3:105
7881 msgid "POSIX specifies"
7882 msgstr ""
7883
7884 #. type: Plain text
7885 #: build/C/man3/getlogin.3:108
7886 msgid "The calling process already has the maximum allowed number of open files."
7887 msgstr ""
7888
7889 #. type: Plain text
7890 #: build/C/man3/getlogin.3:111
7891 msgid "The system already has the maximum allowed number of open files."
7892 msgstr ""
7893
7894 #. type: TP
7895 #: build/C/man3/getlogin.3:111
7896 #, no-wrap
7897 msgid "B<ENXIO>"
7898 msgstr ""
7899
7900 #. type: Plain text
7901 #: build/C/man3/getlogin.3:114
7902 msgid "The calling process has no controlling terminal."
7903 msgstr ""
7904
7905 #. type: Plain text
7906 #: build/C/man3/getlogin.3:120
7907 msgid ""
7908 "(getlogin_r)  The length of the username, including the terminating null "
7909 "byte (\\(aq\\e0\\(aq), is larger than I<bufsize>."
7910 msgstr ""
7911
7912 #. type: Plain text
7913 #: build/C/man3/getlogin.3:122
7914 msgid "Linux/glibc also has"
7915 msgstr ""
7916
7917 #. type: Plain text
7918 #: build/C/man3/getlogin.3:125
7919 msgid "There was no corresponding entry in the utmp-file."
7920 msgstr ""
7921
7922 #. type: Plain text
7923 #: build/C/man3/getlogin.3:128
7924 msgid "Insufficient memory to allocate passwd structure."
7925 msgstr ""
7926
7927 #. type: TP
7928 #: build/C/man3/getlogin.3:128 build/C/man2/ioctl.2:107 build/C/man2/ioctl.2:111 build/C/man3/tcgetpgrp.3:95
7929 #, no-wrap
7930 msgid "B<ENOTTY>"
7931 msgstr ""
7932
7933 #. type: Plain text
7934 #: build/C/man3/getlogin.3:132
7935 msgid "Standard input didn't refer to a terminal.  (See BUGS.)"
7936 msgstr ""
7937
7938 #. type: TP
7939 #: build/C/man3/getlogin.3:133
7940 #, no-wrap
7941 msgid "I</etc/passwd>"
7942 msgstr ""
7943
7944 #. type: Plain text
7945 #: build/C/man3/getlogin.3:136
7946 msgid "password database file"
7947 msgstr ""
7948
7949 #. type: TP
7950 #: build/C/man3/getlogin.3:136
7951 #, no-wrap
7952 msgid "I</var/run/utmp>"
7953 msgstr ""
7954
7955 #. type: Plain text
7956 #: build/C/man3/getlogin.3:140
7957 msgid "(traditionally I</etc/utmp>; some libc versions used I</var/adm/utmp>)"
7958 msgstr ""
7959
7960 #. type: Plain text
7961 #: build/C/man3/getlogin.3:145
7962 msgid "The B<getlogin>()  function is not thread-safe."
7963 msgstr ""
7964
7965 #. type: Plain text
7966 #: build/C/man3/getlogin.3:149
7967 msgid "The B<getlogin_r>()  function is thread-safe."
7968 msgstr ""
7969
7970 #. type: Plain text
7971 #: build/C/man3/getlogin.3:154
7972 msgid ""
7973 "The B<cuserid>()  function is thread-safe with exceptions.  It is not "
7974 "thread-safe if called with a NULL parameter."
7975 msgstr ""
7976
7977 #. type: Plain text
7978 #: build/C/man3/getlogin.3:159
7979 msgid "B<getlogin>()  and B<getlogin_r>()  specified in POSIX.1-2001."
7980 msgstr ""
7981
7982 #. type: Plain text
7983 #: build/C/man3/getlogin.3:170
7984 msgid ""
7985 "System V has a B<cuserid>()  function which uses the real user ID rather "
7986 "than the effective user ID.  The B<cuserid>()  function was included in the "
7987 "1988 version of POSIX, but removed from the 1990 version.  It was present in "
7988 "SUSv2, but removed in POSIX.1-2001."
7989 msgstr ""
7990
7991 #. type: Plain text
7992 #: build/C/man3/getlogin.3:177
7993 msgid ""
7994 "OpenBSD has B<getlogin>()  and B<setlogin>(), and a username associated with "
7995 "a session, even if it has no controlling terminal."
7996 msgstr ""
7997
7998 #. type: Plain text
7999 #: build/C/man3/getlogin.3:189
8000 msgid ""
8001 "Unfortunately, it is often rather easy to fool B<getlogin>().  Sometimes it "
8002 "does not work at all, because some program messed up the utmp file.  Often, "
8003 "it gives only the first 8 characters of the login name.  The user currently "
8004 "logged in on the controlling terminal of our program need not be the user "
8005 "who started it.  Avoid B<getlogin>()  for security-related purposes."
8006 msgstr ""
8007
8008 #. type: Plain text
8009 #: build/C/man3/getlogin.3:199
8010 msgid ""
8011 "Note that glibc does not follow the POSIX specification and uses I<stdin> "
8012 "instead of I</dev/tty>.  A bug.  (Other recent systems, like SunOS 5.8 and "
8013 "HP-UX 11.11 and FreeBSD 4.8 all return the login name also when I<stdin> is "
8014 "redirected.)"
8015 msgstr ""
8016
8017 #. type: Plain text
8018 #: build/C/man3/getlogin.3:209
8019 msgid ""
8020 "Nobody knows precisely what B<cuserid>()  does; avoid it in portable "
8021 "programs.  Or avoid it altogether: use I<getpwuid(geteuid())> instead, if "
8022 "that is what you meant.  B<Do not use> B<cuserid>()."
8023 msgstr ""
8024
8025 #. type: Plain text
8026 #: build/C/man3/getlogin.3:213
8027 msgid "B<geteuid>(2), B<getuid>(2), B<utmp>(5)"
8028 msgstr ""
8029
8030 #. type: TH
8031 #: build/C/man3/getopt.3:41
8032 #, no-wrap
8033 msgid "GETOPT"
8034 msgstr ""
8035
8036 #. type: Plain text
8037 #: build/C/man3/getopt.3:45
8038 msgid ""
8039 "getopt, getopt_long, getopt_long_only, optarg, optind, opterr, optopt - "
8040 "Parse command-line options"
8041 msgstr ""
8042
8043 #. type: Plain text
8044 #: build/C/man3/getopt.3:51
8045 #, no-wrap
8046 msgid ""
8047 "B<int getopt(int >I<argc>B<, char * const >I<argv[]>B<,>\n"
8048 "B<           const char *>I<optstring>B<);>\n"
8049 msgstr ""
8050
8051 #. type: Plain text
8052 #: build/C/man3/getopt.3:54
8053 #, no-wrap
8054 msgid ""
8055 "B<extern char *>I<optarg>B<;>\n"
8056 "B<extern int >I<optind>B<, >I<opterr>B<, >I<optopt>B<;>\n"
8057 msgstr ""
8058
8059 #. type: Plain text
8060 #: build/C/man3/getopt.3:56
8061 #, no-wrap
8062 msgid "B<#include E<lt>getopt.hE<gt>>\n"
8063 msgstr ""
8064
8065 #. type: Plain text
8066 #: build/C/man3/getopt.3:60
8067 #, no-wrap
8068 msgid ""
8069 "B<int getopt_long(int >I<argc>B<, char * const >I<argv[]>B<,>\n"
8070 "B<           const char *>I<optstring>B<,>\n"
8071 "B<           const struct option *>I<longopts>B<, int *>I<longindex>B<);>\n"
8072 msgstr ""
8073
8074 #. type: Plain text
8075 #: build/C/man3/getopt.3:64
8076 #, no-wrap
8077 msgid ""
8078 "B<int getopt_long_only(int >I<argc>B<, char * const >I<argv[]>B<,>\n"
8079 "B<           const char *>I<optstring>B<,>\n"
8080 "B<           const struct option *>I<longopts>B<, int *>I<longindex>B<);>\n"
8081 msgstr ""
8082
8083 #. type: Plain text
8084 #: build/C/man3/getopt.3:74
8085 msgid "B<getopt>(): _POSIX_C_SOURCE\\ E<gt>=\\ 2 || _XOPEN_SOURCE"
8086 msgstr ""
8087
8088 #. type: Plain text
8089 #: build/C/man3/getopt.3:78
8090 msgid "B<getopt_long>(), B<getopt_long_only>(): _GNU_SOURCE"
8091 msgstr ""
8092
8093 #. type: Plain text
8094 #: build/C/man3/getopt.3:99
8095 msgid ""
8096 "The B<getopt>()  function parses the command-line arguments.  Its arguments "
8097 "I<argc> and I<argv> are the argument count and array as passed to the "
8098 "I<main>()  function on program invocation.  An element of I<argv> that "
8099 "starts with \\(aq-\\(aq (and is not exactly \"-\" or \"--\")  is an option "
8100 "element.  The characters of this element (aside from the initial "
8101 "\\(aq-\\(aq) are option characters.  If B<getopt>()  is called repeatedly, "
8102 "it returns successively each of the option characters from each of the "
8103 "option elements."
8104 msgstr ""
8105
8106 #. type: Plain text
8107 #: build/C/man3/getopt.3:108
8108 msgid ""
8109 "The variable I<optind> is the index of the next element to be processed in "
8110 "I<argv>.  The system initializes this value to 1.  The caller can reset it "
8111 "to 1 to restart scanning of the same I<argv>, or when scanning a new "
8112 "argument vector."
8113 msgstr ""
8114
8115 #. type: Plain text
8116 #: build/C/man3/getopt.3:118
8117 msgid ""
8118 "If B<getopt>()  finds another option character, it returns that character, "
8119 "updating the external variable I<optind> and a static variable I<nextchar> "
8120 "so that the next call to B<getopt>()  can resume the scan with the following "
8121 "option character or I<argv>-element."
8122 msgstr ""
8123
8124 #. type: Plain text
8125 #: build/C/man3/getopt.3:124
8126 msgid ""
8127 "If there are no more option characters, B<getopt>()  returns -1.  Then "
8128 "I<optind> is the index in I<argv> of the first I<argv>-element that is not "
8129 "an option."
8130 msgstr ""
8131
8132 #. type: Plain text
8133 #: build/C/man3/getopt.3:151
8134 msgid ""
8135 "I<optstring> is a string containing the legitimate option characters.  If "
8136 "such a character is followed by a colon, the option requires an argument, so "
8137 "B<getopt>()  places a pointer to the following text in the same "
8138 "I<argv>-element, or the text of the following I<argv>-element, in "
8139 "I<optarg>.  Two colons mean an option takes an optional arg; if there is "
8140 "text in the current I<argv>-element (i.e., in the same word as the option "
8141 "name itself, for example, \"-oarg\"), then it is returned in I<optarg>, "
8142 "otherwise I<optarg> is set to zero.  This is a GNU extension.  If "
8143 "I<optstring> contains B<W> followed by a semicolon, then B<-W foo> is "
8144 "treated as the long option B<--foo>.  (The B<-W> option is reserved by "
8145 "POSIX.2 for implementation extensions.)  This behavior is a GNU extension, "
8146 "not available with libraries before glibc 2."
8147 msgstr ""
8148
8149 #. type: Plain text
8150 #: build/C/man3/getopt.3:169
8151 msgid ""
8152 "By default, B<getopt>()  permutes the contents of I<argv> as it scans, so "
8153 "that eventually all the nonoptions are at the end.  Two other modes are also "
8154 "implemented.  If the first character of I<optstring> is \\(aq+\\(aq or the "
8155 "environment variable B<POSIXLY_CORRECT> is set, then option processing stops "
8156 "as soon as a nonoption argument is encountered.  If the first character of "
8157 "I<optstring> is \\(aq-\\(aq, then each nonoption I<argv>-element is handled "
8158 "as if it were the argument of an option with character code 1.  (This is "
8159 "used by programs that were written to expect options and other "
8160 "I<argv>-elements in any order and that care about the ordering of the two.)  "
8161 "The special argument \"--\" forces an end of option-scanning regardless of "
8162 "the scanning mode."
8163 msgstr ""
8164
8165 #. type: Plain text
8166 #: build/C/man3/getopt.3:177
8167 msgid ""
8168 "If B<getopt>()  does not recognize an option character, it prints an error "
8169 "message to I<stderr>, stores the character in I<optopt>, and returns "
8170 "\\(aq?\\(aq.  The calling program may prevent the error message by setting "
8171 "I<opterr> to 0."
8172 msgstr ""
8173
8174 #. type: Plain text
8175 #: build/C/man3/getopt.3:196
8176 msgid ""
8177 "If B<getopt>()  finds an option character in I<argv> that was not included "
8178 "in I<optstring>, or if it detects a missing option argument, it returns "
8179 "\\(aq?\\(aq and sets the external variable I<optopt> to the actual option "
8180 "character.  If the first character (following any optional \\(aq+\\(aq or "
8181 "\\(aq-\\(aq described above)  of I<optstring> is a colon (\\(aq:\\(aq), then "
8182 "B<getopt>()  returns \\(aq:\\(aq instead of \\(aq?\\(aq to indicate a "
8183 "missing option argument.  If an error was detected, and the first character "
8184 "of I<optstring> is not a colon, and the external variable I<opterr> is "
8185 "nonzero (which is the default), B<getopt>()  prints an error message."
8186 msgstr ""
8187
8188 #. type: SS
8189 #: build/C/man3/getopt.3:196
8190 #, no-wrap
8191 msgid "getopt_long() and getopt_long_only()"
8192 msgstr ""
8193
8194 #. type: Plain text
8195 #: build/C/man3/getopt.3:212
8196 msgid ""
8197 "The B<getopt_long>()  function works like B<getopt>()  except that it also "
8198 "accepts long options, started with two dashes.  (If the program accepts only "
8199 "long options, then I<optstring> should be specified as an empty string "
8200 "(\"\"), not NULL.)  Long option names may be abbreviated if the abbreviation "
8201 "is unique or is an exact match for some defined option.  A long option may "
8202 "take a parameter, of the form B<--arg=param> or B<--arg param>."
8203 msgstr ""
8204
8205 #. type: Plain text
8206 #: build/C/man3/getopt.3:219
8207 msgid ""
8208 "I<longopts> is a pointer to the first element of an array of I<struct "
8209 "option> declared in I<E<lt>getopt.hE<gt>> as"
8210 msgstr ""
8211
8212 #. type: Plain text
8213 #: build/C/man3/getopt.3:228
8214 #, no-wrap
8215 msgid ""
8216 "struct option {\n"
8217 "    const char *name;\n"
8218 "    int         has_arg;\n"
8219 "    int        *flag;\n"
8220 "    int         val;\n"
8221 "};\n"
8222 msgstr ""
8223
8224 #. type: Plain text
8225 #: build/C/man3/getopt.3:232
8226 msgid "The meanings of the different fields are:"
8227 msgstr ""
8228
8229 #. type: TP
8230 #: build/C/man3/getopt.3:232
8231 #, no-wrap
8232 msgid "I<name>"
8233 msgstr ""
8234
8235 #. type: Plain text
8236 #: build/C/man3/getopt.3:235
8237 msgid "is the name of the long option."
8238 msgstr ""
8239
8240 #. type: TP
8241 #: build/C/man3/getopt.3:235
8242 #, no-wrap
8243 msgid "I<has_arg>"
8244 msgstr ""
8245
8246 #. type: Plain text
8247 #: build/C/man3/getopt.3:241
8248 msgid ""
8249 "is: B<no_argument> (or 0) if the option does not take an argument; "
8250 "B<required_argument> (or 1) if the option requires an argument; or "
8251 "B<optional_argument> (or 2) if the option takes an optional argument."
8252 msgstr ""
8253
8254 #. type: TP
8255 #: build/C/man3/getopt.3:241
8256 #, no-wrap
8257 msgid "I<flag>"
8258 msgstr ""
8259
8260 #. type: Plain text
8261 #: build/C/man3/getopt.3:255
8262 msgid ""
8263 "specifies how results are returned for a long option.  If I<flag> is NULL, "
8264 "then B<getopt_long>()  returns I<val>.  (For example, the calling program "
8265 "may set I<val> to the equivalent short option character.)  Otherwise, "
8266 "B<getopt_long>()  returns 0, and I<flag> points to a variable which is set "
8267 "to I<val> if the option is found, but left unchanged if the option is not "
8268 "found."
8269 msgstr ""
8270
8271 #. type: TP
8272 #: build/C/man3/getopt.3:255
8273 #, no-wrap
8274 msgid "I<val>"
8275 msgstr ""
8276
8277 #. type: Plain text
8278 #: build/C/man3/getopt.3:259
8279 msgid "is the value to return, or to load into the variable pointed to by I<flag>."
8280 msgstr ""
8281
8282 #. type: Plain text
8283 #: build/C/man3/getopt.3:261
8284 msgid "The last element of the array has to be filled with zeros."
8285 msgstr ""
8286
8287 #. type: Plain text
8288 #: build/C/man3/getopt.3:265
8289 msgid ""
8290 "If I<longindex> is not NULL, it points to a variable which is set to the "
8291 "index of the long option relative to I<longopts>."
8292 msgstr ""
8293
8294 #. type: Plain text
8295 #: build/C/man3/getopt.3:274
8296 msgid ""
8297 "B<getopt_long_only>()  is like B<getopt_long>(), but \\(aq-\\(aq as well as "
8298 "\"--\" can indicate a long option.  If an option that starts with "
8299 "\\(aq-\\(aq (not \"--\") doesn't match a long option, but does match a short "
8300 "option, it is parsed as a short option instead."
8301 msgstr ""
8302
8303 #. type: Plain text
8304 #: build/C/man3/getopt.3:292
8305 msgid ""
8306 "If an option was successfully found, then B<getopt>()  returns the option "
8307 "character.  If all command-line options have been parsed, then B<getopt>()  "
8308 "returns -1.  If B<getopt>()  encounters an option character that was not in "
8309 "I<optstring>, then \\(aq?\\(aq is returned.  If B<getopt>()  encounters an "
8310 "option with a missing argument, then the return value depends on the first "
8311 "character in I<optstring>: if it is \\(aq:\\(aq, then \\(aq:\\(aq is "
8312 "returned; otherwise \\(aq?\\(aq is returned."
8313 msgstr ""
8314
8315 #. type: Plain text
8316 #: build/C/man3/getopt.3:304
8317 msgid ""
8318 "B<getopt_long>()  and B<getopt_long_only>()  also return the option "
8319 "character when a short option is recognized.  For a long option, they return "
8320 "I<val> if I<flag> is NULL, and 0 otherwise.  Error and -1 returns are the "
8321 "same as for B<getopt>(), plus \\(aq?\\(aq for an ambiguous match or an "
8322 "extraneous parameter."
8323 msgstr ""
8324
8325 #. type: SH
8326 #: build/C/man3/getopt.3:304
8327 #, no-wrap
8328 msgid "ENVIRONMENT"
8329 msgstr ""
8330
8331 #. type: TP
8332 #: build/C/man3/getopt.3:305
8333 #, no-wrap
8334 msgid "B<POSIXLY_CORRECT>"
8335 msgstr ""
8336
8337 #. type: Plain text
8338 #: build/C/man3/getopt.3:309
8339 msgid ""
8340 "If this is set, then option processing stops as soon as a nonoption argument "
8341 "is encountered."
8342 msgstr ""
8343
8344 #. type: TP
8345 #: build/C/man3/getopt.3:309
8346 #, no-wrap
8347 msgid "B<_E<lt>PIDE<gt>_GNU_nonoption_argv_flags_>"
8348 msgstr ""
8349
8350 #. type: Plain text
8351 #: build/C/man3/getopt.3:318
8352 msgid ""
8353 "This variable was used by B<bash>(1)  2.0 to communicate to glibc which "
8354 "arguments are the results of wildcard expansion and so should not be "
8355 "considered as options.  This behavior was removed in B<bash>(1)  version "
8356 "2.01, but the support remains in glibc."
8357 msgstr ""
8358
8359 #. type: TP
8360 #: build/C/man3/getopt.3:319
8361 #, no-wrap
8362 msgid "B<getopt>():"
8363 msgstr ""
8364
8365 #. type: Plain text
8366 #: build/C/man3/getopt.3:329
8367 msgid ""
8368 "POSIX.2 and POSIX.1-2001, provided the environment variable "
8369 "B<POSIXLY_CORRECT> is set.  Otherwise, the elements of I<argv> aren't really "
8370 "const, because we permute them.  We pretend they're const in the prototype "
8371 "to be compatible with other systems."
8372 msgstr ""
8373
8374 #. type: Plain text
8375 #: build/C/man3/getopt.3:333
8376 msgid "The use of \\(aq+\\(aq and \\(aq-\\(aq in I<optstring> is a GNU extension."
8377 msgstr ""
8378
8379 #. type: Plain text
8380 #: build/C/man3/getopt.3:347
8381 msgid ""
8382 "On some older implementations, B<getopt>()  was declared in "
8383 "I<E<lt>stdio.hE<gt>>.  SUSv1 permitted the declaration to appear in either "
8384 "I<E<lt>unistd.hE<gt>> or I<E<lt>stdio.hE<gt>>.  POSIX.1-2001 marked the use "
8385 "of I<E<lt>stdio.hE<gt>> for this purpose as LEGACY.  POSIX.1-2001 does not "
8386 "allow the declaration to appear in I<E<lt>stdio.hE<gt>>."
8387 msgstr ""
8388
8389 #. type: TP
8390 #: build/C/man3/getopt.3:347
8391 #, no-wrap
8392 msgid "B<getopt_long>() and B<getopt_long_only>():"
8393 msgstr ""
8394
8395 #. type: Plain text
8396 #: build/C/man3/getopt.3:369
8397 msgid ""
8398 "A program that scans multiple argument vectors, or rescans the same vector "
8399 "more than once, and wants to make use of GNU extensions such as \\(aq+\\(aq "
8400 "and \\(aq-\\(aq at the start of I<optstring>, or changes the value of "
8401 "B<POSIXLY_CORRECT> between scans, must reinitialize B<getopt>()  by "
8402 "resetting I<optind> to 0, rather than the traditional value of 1.  "
8403 "(Resetting to 0 forces the invocation of an internal initialization routine "
8404 "that rechecks B<POSIXLY_CORRECT> and checks for GNU extensions in "
8405 "I<optstring>.)"
8406 msgstr ""
8407
8408 #. type: Plain text
8409 #: build/C/man3/getopt.3:376
8410 msgid ""
8411 "The POSIX.2 specification of B<getopt>()  has a technical error described in "
8412 "POSIX.2 Interpretation 150.  The GNU implementation (and probably all other "
8413 "implementations) implements the correct behavior rather than that specified."
8414 msgstr ""
8415
8416 #. type: Plain text
8417 #: build/C/man3/getopt.3:384
8418 msgid ""
8419 "The following trivial example program uses B<getopt>()  to handle two "
8420 "program options: I<-n>, with no associated value; and I<-t val>, which "
8421 "expects an associated value."
8422 msgstr ""
8423
8424 #. type: Plain text
8425 #: build/C/man3/getopt.3:389
8426 #, no-wrap
8427 msgid ""
8428 "#include E<lt>unistd.hE<gt>\n"
8429 "#include E<lt>stdlib.hE<gt>\n"
8430 "#include E<lt>stdio.hE<gt>\n"
8431 msgstr ""
8432
8433 #. type: Plain text
8434 #: build/C/man3/getopt.3:395
8435 #, no-wrap
8436 msgid ""
8437 "int\n"
8438 "main(int argc, char *argv[])\n"
8439 "{\n"
8440 "    int flags, opt;\n"
8441 "    int nsecs, tfnd;\n"
8442 msgstr ""
8443
8444 #. type: Plain text
8445 #: build/C/man3/getopt.3:414
8446 #, no-wrap
8447 msgid ""
8448 "    nsecs = 0;\n"
8449 "    tfnd = 0;\n"
8450 "    flags = 0;\n"
8451 "    while ((opt = getopt(argc, argv, \"nt:\")) != -1) {\n"
8452 "        switch (opt) {\n"
8453 "        case \\(aqn\\(aq:\n"
8454 "            flags = 1;\n"
8455 "            break;\n"
8456 "        case \\(aqt\\(aq:\n"
8457 "            nsecs = atoi(optarg);\n"
8458 "            tfnd = 1;\n"
8459 "            break;\n"
8460 "        default: /* \\(aq?\\(aq */\n"
8461 "            fprintf(stderr, \"Usage: %s [-t nsecs] [-n] name\\en\",\n"
8462 "                    argv[0]);\n"
8463 "            exit(EXIT_FAILURE);\n"
8464 "        }\n"
8465 "    }\n"
8466 msgstr ""
8467
8468 #. type: Plain text
8469 #: build/C/man3/getopt.3:416
8470 #, no-wrap
8471 msgid "    printf(\"flags=%d; tfnd=%d; optind=%d\\en\", flags, tfnd, optind);\n"
8472 msgstr ""
8473
8474 #. type: Plain text
8475 #: build/C/man3/getopt.3:421
8476 #, no-wrap
8477 msgid ""
8478 "    if (optind E<gt>= argc) {\n"
8479 "        fprintf(stderr, \"Expected argument after options\\en\");\n"
8480 "        exit(EXIT_FAILURE);\n"
8481 "    }\n"
8482 msgstr ""
8483
8484 #. type: Plain text
8485 #: build/C/man3/getopt.3:423
8486 #, no-wrap
8487 msgid "    printf(\"name argument = %s\\en\", argv[optind]);\n"
8488 msgstr ""
8489
8490 #. type: Plain text
8491 #: build/C/man3/getopt.3:425
8492 #, no-wrap
8493 msgid "    /* Other code omitted */\n"
8494 msgstr ""
8495
8496 #. type: Plain text
8497 #: build/C/man3/getopt.3:433
8498 msgid ""
8499 "The following example program illustrates the use of B<getopt_long>()  with "
8500 "most of its features."
8501 msgstr ""
8502
8503 #. type: Plain text
8504 #: build/C/man3/getopt.3:438
8505 #, no-wrap
8506 msgid ""
8507 "#include E<lt>stdio.hE<gt>     /* for printf */\n"
8508 "#include E<lt>stdlib.hE<gt>    /* for exit */\n"
8509 "#include E<lt>getopt.hE<gt>\n"
8510 msgstr ""
8511
8512 #. type: Plain text
8513 #: build/C/man3/getopt.3:444
8514 #, no-wrap
8515 msgid ""
8516 "int\n"
8517 "main(int argc, char **argv)\n"
8518 "{\n"
8519 "    int c;\n"
8520 "    int digit_optind = 0;\n"
8521 msgstr ""
8522
8523 #. type: Plain text
8524 #: build/C/man3/getopt.3:457
8525 #, no-wrap
8526 msgid ""
8527 "    while (1) {\n"
8528 "        int this_option_optind = optind ? optind : 1;\n"
8529 "        int option_index = 0;\n"
8530 "        static struct option long_options[] = {\n"
8531 "            {\"add\",     required_argument, 0,  0 },\n"
8532 "            {\"append\",  no_argument,       0,  0 },\n"
8533 "            {\"delete\",  required_argument, 0,  0 },\n"
8534 "            {\"verbose\", no_argument,       0,  0 },\n"
8535 "            {\"create\",  required_argument, 0, \\(aqc\\(aq},\n"
8536 "            {\"file\",    required_argument, 0,  0 },\n"
8537 "            {0,         0,                 0,  0 }\n"
8538 "        };\n"
8539 msgstr ""
8540
8541 #. type: Plain text
8542 #: build/C/man3/getopt.3:462
8543 #, no-wrap
8544 msgid ""
8545 "        c = getopt_long(argc, argv, \"abc:d:012\",\n"
8546 "                 long_options, &option_index);\n"
8547 "        if (c == -1)\n"
8548 "            break;\n"
8549 msgstr ""
8550
8551 #. type: Plain text
8552 #: build/C/man3/getopt.3:470
8553 #, no-wrap
8554 msgid ""
8555 "        switch (c) {\n"
8556 "        case 0:\n"
8557 "            printf(\"option %s\", long_options[option_index].name);\n"
8558 "            if (optarg)\n"
8559 "                printf(\" with arg %s\", optarg);\n"
8560 "            printf(\"\\en\");\n"
8561 "            break;\n"
8562 msgstr ""
8563
8564 #. type: Plain text
8565 #: build/C/man3/getopt.3:479
8566 #, no-wrap
8567 msgid ""
8568 "        case \\(aq0\\(aq:\n"
8569 "        case \\(aq1\\(aq:\n"
8570 "        case \\(aq2\\(aq:\n"
8571 "            if (digit_optind != 0 && digit_optind != this_option_optind)\n"
8572 "              printf(\"digits occur in two different "
8573 "argv-elements.\\en\");\n"
8574 "            digit_optind = this_option_optind;\n"
8575 "            printf(\"option %c\\en\", c);\n"
8576 "            break;\n"
8577 msgstr ""
8578
8579 #. type: Plain text
8580 #: build/C/man3/getopt.3:483
8581 #, no-wrap
8582 msgid ""
8583 "        case \\(aqa\\(aq:\n"
8584 "            printf(\"option a\\en\");\n"
8585 "            break;\n"
8586 msgstr ""
8587
8588 #. type: Plain text
8589 #: build/C/man3/getopt.3:487
8590 #, no-wrap
8591 msgid ""
8592 "        case \\(aqb\\(aq:\n"
8593 "            printf(\"option b\\en\");\n"
8594 "            break;\n"
8595 msgstr ""
8596
8597 #. type: Plain text
8598 #: build/C/man3/getopt.3:491
8599 #, no-wrap
8600 msgid ""
8601 "        case \\(aqc\\(aq:\n"
8602 "            printf(\"option c with value \\(aq%s\\(aq\\en\", optarg);\n"
8603 "            break;\n"
8604 msgstr ""
8605
8606 #. type: Plain text
8607 #: build/C/man3/getopt.3:495
8608 #, no-wrap
8609 msgid ""
8610 "        case \\(aqd\\(aq:\n"
8611 "            printf(\"option d with value \\(aq%s\\(aq\\en\", optarg);\n"
8612 "            break;\n"
8613 msgstr ""
8614
8615 #. type: Plain text
8616 #: build/C/man3/getopt.3:498
8617 #, no-wrap
8618 msgid ""
8619 "        case \\(aq?\\(aq:\n"
8620 "            break;\n"
8621 msgstr ""
8622
8623 #. type: Plain text
8624 #: build/C/man3/getopt.3:503
8625 #, no-wrap
8626 msgid ""
8627 "        default:\n"
8628 "            printf(\"?? getopt returned character code 0%o ??\\en\", c);\n"
8629 "        }\n"
8630 "    }\n"
8631 msgstr ""
8632
8633 #. type: Plain text
8634 #: build/C/man3/getopt.3:510
8635 #, no-wrap
8636 msgid ""
8637 "    if (optind E<lt> argc) {\n"
8638 "        printf(\"non-option ARGV-elements: \");\n"
8639 "        while (optind E<lt> argc)\n"
8640 "            printf(\"%s \", argv[optind++]);\n"
8641 "        printf(\"\\en\");\n"
8642 "    }\n"
8643 msgstr ""
8644
8645 #. type: Plain text
8646 #: build/C/man3/getopt.3:516
8647 msgid "B<getsubopt>(3)"
8648 msgstr ""
8649
8650 #. type: TH
8651 #: build/C/man2/getpagesize.2:25
8652 #, no-wrap
8653 msgid "GETPAGESIZE"
8654 msgstr ""
8655
8656 #. type: TH
8657 #: build/C/man2/getpagesize.2:25
8658 #, no-wrap
8659 msgid "2010-11-16"
8660 msgstr ""
8661
8662 #. type: Plain text
8663 #: build/C/man2/getpagesize.2:28
8664 msgid "getpagesize - get memory page size"
8665 msgstr ""
8666
8667 #. type: Plain text
8668 #: build/C/man2/getpagesize.2:32
8669 msgid "B<int getpagesize(void);>"
8670 msgstr ""
8671
8672 #. type: Plain text
8673 #: build/C/man2/getpagesize.2:39
8674 msgid "B<getpagesize>():"
8675 msgstr ""
8676
8677 #.  .SH HISTORY
8678 #.  This call first appeared in 4.2BSD.
8679 #. type: Plain text
8680 #: build/C/man2/getpagesize.2:64
8681 msgid ""
8682 "The function B<getpagesize>()  returns the number of bytes in a memory page, "
8683 "where \"page\" is a fixed-length block, the unit for memory allocation and "
8684 "file mapping performed by B<mmap>(2)."
8685 msgstr ""
8686
8687 #. type: Plain text
8688 #: build/C/man2/getpagesize.2:71
8689 msgid ""
8690 "SVr4, 4.4BSD, SUSv2.  In SUSv2 the B<getpagesize>()  call is labeled LEGACY, "
8691 "and in POSIX.1-2001 it has been dropped; HP-UX does not have this call."
8692 msgstr ""
8693
8694 #. type: Plain text
8695 #: build/C/man2/getpagesize.2:76
8696 msgid ""
8697 "Portable applications should employ I<sysconf(_SC_PAGESIZE)> instead of "
8698 "B<getpagesize>():"
8699 msgstr ""
8700
8701 #. type: Plain text
8702 #: build/C/man2/getpagesize.2:81
8703 #, no-wrap
8704 msgid ""
8705 "#include E<lt>unistd.hE<gt>\n"
8706 "long sz = sysconf(_SC_PAGESIZE);\n"
8707 msgstr ""
8708
8709 #. type: Plain text
8710 #: build/C/man2/getpagesize.2:88
8711 msgid "(Most systems allow the synonym B<_SC_PAGE_SIZE> for B<_SC_PAGESIZE>.)"
8712 msgstr ""
8713
8714 #. type: Plain text
8715 #: build/C/man2/getpagesize.2:108
8716 msgid ""
8717 "Whether B<getpagesize>()  is present as a Linux system call depends on the "
8718 "architecture.  If it is, it returns the kernel symbol B<PAGE_SIZE>, whose "
8719 "value depends on the architecture and machine model.  Generally, one uses "
8720 "binaries that are dependent on the architecture but not on the machine "
8721 "model, in order to have a single binary distribution per architecture.  This "
8722 "means that a user program should not find B<PAGE_SIZE> at compile time from "
8723 "a header file, but use an actual system call, at least for those "
8724 "architectures (like sun4) where this dependency exists.  Here libc4, libc5, "
8725 "glibc 2.0 fail because their B<getpagesize>()  returns a statically derived "
8726 "value, and does not use a system call.  Things are OK in glibc 2.1."
8727 msgstr ""
8728
8729 #. type: Plain text
8730 #: build/C/man2/getpagesize.2:111
8731 msgid "B<mmap>(2), B<sysconf>(3)"
8732 msgstr ""
8733
8734 #. type: TH
8735 #: build/C/man2/gettid.2:26
8736 #, no-wrap
8737 msgid "GETTID"
8738 msgstr ""
8739
8740 #. type: TH
8741 #: build/C/man2/gettid.2:26
8742 #, no-wrap
8743 msgid "2013-02-04"
8744 msgstr ""
8745
8746 #. type: Plain text
8747 #: build/C/man2/gettid.2:29
8748 msgid "gettid - get thread identification"
8749 msgstr ""
8750
8751 #. type: Plain text
8752 #: build/C/man2/gettid.2:32
8753 #, no-wrap
8754 msgid "B<#include E<lt>sys/types.hE<gt>>\n"
8755 msgstr ""
8756
8757 #. type: Plain text
8758 #: build/C/man2/gettid.2:34
8759 #, no-wrap
8760 msgid "B<pid_t gettid(void);>\n"
8761 msgstr ""
8762
8763 #. type: Plain text
8764 #: build/C/man2/gettid.2:50
8765 msgid ""
8766 "B<gettid>()  returns the caller's thread ID (TID).  In a single-threaded "
8767 "process, the thread ID is equal to the process ID (PID, as returned by "
8768 "B<getpid>(2)).  In a multithreaded process, all threads have the same PID, "
8769 "but each one has a unique TID.  For further details, see the discussion of "
8770 "B<CLONE_THREAD> in B<clone>(2)."
8771 msgstr ""
8772
8773 #. type: Plain text
8774 #: build/C/man2/gettid.2:52
8775 msgid "On success, returns the thread ID of the calling process."
8776 msgstr ""
8777
8778 #. type: Plain text
8779 #: build/C/man2/gettid.2:54
8780 msgid "This call is always successful."
8781 msgstr ""
8782
8783 #. type: Plain text
8784 #: build/C/man2/gettid.2:58
8785 msgid "The B<gettid>()  system call first appeared on Linux in kernel 2.4.11."
8786 msgstr ""
8787
8788 #. type: Plain text
8789 #: build/C/man2/gettid.2:62
8790 msgid ""
8791 "B<gettid>()  is Linux-specific and should not be used in programs that are "
8792 "intended to be portable."
8793 msgstr ""
8794
8795 #.  FIXME See http://sourceware.org/bugzilla/show_bug.cgi?id=6399
8796 #.  "gettid() should have a wrapper"
8797 #. type: Plain text
8798 #: build/C/man2/gettid.2:67
8799 msgid ""
8800 "Glibc does not provide a wrapper for this system call; call it using "
8801 "B<syscall>(2)."
8802 msgstr ""
8803
8804 #. type: Plain text
8805 #: build/C/man2/gettid.2:71
8806 msgid ""
8807 "The thread ID returned by this call is not the same thing as a POSIX thread "
8808 "ID (i.e., the opaque value returned by B<pthread_self>(3))."
8809 msgstr ""
8810
8811 #.  .BR kcmp (2),
8812 #.  .BR move_pages (2),
8813 #.  .BR migrate_pages (2),
8814 #.  .BR process_vm_readv (2),
8815 #.  .BR ptrace (2),
8816 #. type: Plain text
8817 #: build/C/man2/gettid.2:90
8818 msgid ""
8819 "B<capget>(2), B<clone>(2), B<fcntl>(2), B<fork>(2), B<get_robust_list>(2), "
8820 "B<getpid>(2), B<ioprio_set>(2), B<perf_event_open>(2), "
8821 "B<sched_setaffinity>(2), B<sched_setparam>(2), B<sched_setscheduler>(2), "
8822 "B<timer_create>(2), B<tgkill>(2)"
8823 msgstr ""
8824
8825 #. type: TH
8826 #: build/C/man3/getumask.3:28
8827 #, no-wrap
8828 msgid "GETUMASK"
8829 msgstr ""
8830
8831 #. type: TH
8832 #: build/C/man3/getumask.3:28
8833 #, no-wrap
8834 msgid "2010-09-10"
8835 msgstr ""
8836
8837 #. type: Plain text
8838 #: build/C/man3/getumask.3:31
8839 msgid "getumask - get file creation mask"
8840 msgstr ""
8841
8842 #. type: Plain text
8843 #: build/C/man3/getumask.3:35 build/C/man2/truncate.2:50 build/C/man2/umask.2:39 build/C/man2/vfork.2:33
8844 msgid "B<#include E<lt>sys/types.hE<gt>>"
8845 msgstr ""
8846
8847 #. type: Plain text
8848 #: build/C/man3/getumask.3:39
8849 msgid "B<mode_t getumask(void);>"
8850 msgstr ""
8851
8852 #. type: Plain text
8853 #: build/C/man3/getumask.3:42
8854 msgid "This function returns the current file creation mask.  It is equivalent to"
8855 msgstr ""
8856
8857 #. type: Plain text
8858 #: build/C/man3/getumask.3:51
8859 #, no-wrap
8860 msgid ""
8861 "mode_t getumask(void)\n"
8862 "{\n"
8863 "    mode_t mask = umask( 0 );\n"
8864 "    umask(mask);\n"
8865 "    return mask;\n"
8866 "}\n"
8867 msgstr ""
8868
8869 #. type: Plain text
8870 #: build/C/man3/getumask.3:58
8871 msgid ""
8872 "except that it is documented to be thread-safe (that is, shares a lock with "
8873 "the B<umask>(2)  library call)."
8874 msgstr ""
8875
8876 #. type: Plain text
8877 #: build/C/man3/getumask.3:60
8878 msgid "This is a vaporware GNU extension."
8879 msgstr ""
8880
8881 #. type: Plain text
8882 #: build/C/man3/getumask.3:63
8883 msgid ""
8884 "This function is documented but not implemented yet in glibc, as at version "
8885 "2.9."
8886 msgstr ""
8887
8888 #. type: Plain text
8889 #: build/C/man3/getumask.3:65
8890 msgid "B<umask>(2)"
8891 msgstr ""
8892
8893 #. type: TH
8894 #: build/C/man3/getusershell.3:30
8895 #, no-wrap
8896 msgid "GETUSERSHELL"
8897 msgstr ""
8898
8899 #. type: Plain text
8900 #: build/C/man3/getusershell.3:33
8901 msgid "getusershell, setusershell, endusershell - get permitted user shells"
8902 msgstr ""
8903
8904 #. type: Plain text
8905 #: build/C/man3/getusershell.3:38
8906 #, no-wrap
8907 msgid "B<char *getusershell(void);>\n"
8908 msgstr ""
8909
8910 #. type: Plain text
8911 #: build/C/man3/getusershell.3:40
8912 #, no-wrap
8913 msgid "B<void setusershell(void);>\n"
8914 msgstr ""
8915
8916 #. type: Plain text
8917 #: build/C/man3/getusershell.3:42
8918 #, no-wrap
8919 msgid "B<void endusershell(void);>\n"
8920 msgstr ""
8921
8922 #. type: Plain text
8923 #: build/C/man3/getusershell.3:53
8924 msgid "B<getusershell>(), B<setusershell>(), B<endusershell>():"
8925 msgstr ""
8926
8927 #. type: Plain text
8928 #: build/C/man3/getusershell.3:75
8929 msgid ""
8930 "The B<getusershell>()  function returns the next line from the file "
8931 "I</etc/shells>, opening the file if necessary.  The line should contain the "
8932 "pathname of a valid user shell.  If I</etc/shells> does not exist or is "
8933 "unreadable, B<getusershell>()  behaves as if I</bin/sh> and I</bin/csh> were "
8934 "listed in the file."
8935 msgstr ""
8936
8937 #. type: Plain text
8938 #: build/C/man3/getusershell.3:80
8939 msgid "The B<setusershell>()  function rewinds I</etc/shells>."
8940 msgstr ""
8941
8942 #. type: Plain text
8943 #: build/C/man3/getusershell.3:85
8944 msgid "The B<endusershell>()  function closes I</etc/shells>."
8945 msgstr ""
8946
8947 #. type: Plain text
8948 #: build/C/man3/getusershell.3:89
8949 msgid "The B<getusershell>()  function returns a NULL pointer on end-of-file."
8950 msgstr ""
8951
8952 #. type: Plain text
8953 #: build/C/man3/getusershell.3:92
8954 #, no-wrap
8955 msgid "/etc/shells\n"
8956 msgstr ""
8957
8958 #. type: Plain text
8959 #: build/C/man3/getusershell.3:101
8960 msgid ""
8961 "The B<getusershell>(), B<setusershell>()  and B<endusershell>()  functions "
8962 "are not thread-safe."
8963 msgstr ""
8964
8965 #. type: Plain text
8966 #: build/C/man3/getusershell.3:103
8967 msgid "4.3BSD."
8968 msgstr ""
8969
8970 #. type: Plain text
8971 #: build/C/man3/getusershell.3:105
8972 msgid "B<shells>(5)"
8973 msgstr ""
8974
8975 #. type: TH
8976 #: build/C/man2/idle.2:32
8977 #, no-wrap
8978 msgid "IDLE"
8979 msgstr ""
8980
8981 #. type: TH
8982 #: build/C/man2/idle.2:32 build/C/man5/shells.5:28
8983 #, no-wrap
8984 msgid "2012-12-31"
8985 msgstr ""
8986
8987 #. type: Plain text
8988 #: build/C/man2/idle.2:35
8989 msgid "idle - make process 0 idle"
8990 msgstr ""
8991
8992 #. type: Plain text
8993 #: build/C/man2/idle.2:39
8994 msgid "B<int idle(void);>"
8995 msgstr ""
8996
8997 #. type: Plain text
8998 #: build/C/man2/idle.2:46
8999 msgid ""
9000 "B<idle>()  is an internal system call used during bootstrap.  It marks the "
9001 "process's pages as swappable, lowers its priority, and enters the main "
9002 "scheduling loop.  B<idle>()  never returns."
9003 msgstr ""
9004
9005 #. type: Plain text
9006 #: build/C/man2/idle.2:52
9007 msgid ""
9008 "Only process 0 may call B<idle>().  Any user process, even a process with "
9009 "superuser permission, will receive B<EPERM>."
9010 msgstr ""
9011
9012 #. type: Plain text
9013 #: build/C/man2/idle.2:55
9014 msgid ""
9015 "B<idle>()  never returns for process 0, and always returns -1 for a user "
9016 "process."
9017 msgstr ""
9018
9019 #. type: Plain text
9020 #: build/C/man2/idle.2:59 build/C/man2/setup.2:60
9021 msgid "Always, for a user process."
9022 msgstr ""
9023
9024 #. type: Plain text
9025 #: build/C/man2/idle.2:61
9026 msgid "Since Linux 2.3.13, this system call does not exist anymore."
9027 msgstr ""
9028
9029 #. type: Plain text
9030 #: build/C/man2/idle.2:64 build/C/man2/sysinfo.2:86
9031 msgid ""
9032 "This function is Linux-specific, and should not be used in programs intended "
9033 "to be portable."
9034 msgstr ""
9035
9036 #. type: TH
9037 #: build/C/man2/ioctl.2:41
9038 #, no-wrap
9039 msgid "IOCTL"
9040 msgstr ""
9041
9042 #. type: TH
9043 #: build/C/man2/ioctl.2:41
9044 #, no-wrap
9045 msgid "2000-09-21"
9046 msgstr ""
9047
9048 #. type: Plain text
9049 #: build/C/man2/ioctl.2:44
9050 msgid "ioctl - control device"
9051 msgstr ""
9052
9053 #. type: Plain text
9054 #: build/C/man2/ioctl.2:46
9055 msgid "B<#include E<lt>sys/ioctl.hE<gt>>"
9056 msgstr ""
9057
9058 #. type: Plain text
9059 #: build/C/man2/ioctl.2:48
9060 msgid "B<int ioctl(int >I<d>B<, int >I<request>B<, ...);>"
9061 msgstr ""
9062
9063 #. type: Plain text
9064 #: build/C/man2/ioctl.2:59
9065 msgid ""
9066 "The B<ioctl>()  function manipulates the underlying device parameters of "
9067 "special files.  In particular, many operating characteristics of character "
9068 "special files (e.g., terminals) may be controlled with B<ioctl>()  "
9069 "requests.  The argument I<d> must be an open file descriptor."
9070 msgstr ""
9071
9072 #. type: Plain text
9073 #: build/C/man2/ioctl.2:67
9074 msgid ""
9075 "The second argument is a device-dependent request code.  The third argument "
9076 "is an untyped pointer to memory.  It's traditionally B<char *>I<argp> (from "
9077 "the days before B<void *> was valid C), and will be so named for this "
9078 "discussion."
9079 msgstr ""
9080
9081 #. type: Plain text
9082 #: build/C/man2/ioctl.2:83
9083 msgid ""
9084 "An B<ioctl>()  I<request> has encoded in it whether the argument is an I<in> "
9085 "parameter or I<out> parameter, and the size of the argument I<argp> in "
9086 "bytes.  Macros and defines used in specifying an B<ioctl>()  I<request> are "
9087 "located in the file I<E<lt>sys/ioctl.hE<gt>>."
9088 msgstr ""
9089
9090 #. type: Plain text
9091 #: build/C/man2/ioctl.2:92
9092 msgid ""
9093 "Usually, on success zero is returned.  A few B<ioctl>()  requests use the "
9094 "return value as an output parameter and return a nonnegative value on "
9095 "success.  On error, -1 is returned, and I<errno> is set appropriately."
9096 msgstr ""
9097
9098 #. type: Plain text
9099 #: build/C/man2/ioctl.2:97
9100 msgid "I<d> is not a valid descriptor."
9101 msgstr ""
9102
9103 #. type: Plain text
9104 #: build/C/man2/ioctl.2:101
9105 msgid "I<argp> references an inaccessible memory area."
9106 msgstr ""
9107
9108 #. type: Plain text
9109 #: build/C/man2/ioctl.2:107
9110 msgid "I<Request> or I<argp> is not valid."
9111 msgstr ""
9112
9113 #. type: Plain text
9114 #: build/C/man2/ioctl.2:111
9115 msgid "I<d> is not associated with a character special device."
9116 msgstr ""
9117
9118 #. type: Plain text
9119 #: build/C/man2/ioctl.2:117
9120 msgid ""
9121 "The specified request does not apply to the kind of object that the "
9122 "descriptor I<d> references."
9123 msgstr ""
9124
9125 #. type: Plain text
9126 #: build/C/man2/ioctl.2:132
9127 msgid ""
9128 "No single standard.  Arguments, returns, and semantics of B<ioctl>()  vary "
9129 "according to the device driver in question (the call is used as a catch-all "
9130 "for operations that don't cleanly fit the UNIX stream I/O model).  See "
9131 "B<ioctl_list>(2)  for a list of many of the known B<ioctl>()  calls.  The "
9132 "B<ioctl>()  function call appeared in Version 7 AT&T UNIX."
9133 msgstr ""
9134
9135 #. type: Plain text
9136 #: build/C/man2/ioctl.2:140
9137 msgid ""
9138 "In order to use this call, one needs an open file descriptor.  Often the "
9139 "B<open>(2)  call has unwanted side effects, that can be avoided under Linux "
9140 "by giving it the B<O_NONBLOCK> flag."
9141 msgstr ""
9142
9143 #.  .BR mt (4),
9144 #. type: Plain text
9145 #: build/C/man2/ioctl.2:148
9146 msgid "B<execve>(2), B<fcntl>(2), B<ioctl_list>(2), B<open>(2), B<sd>(4), B<tty>(4)"
9147 msgstr ""
9148
9149 #. type: TH
9150 #: build/C/man2/ioctl_list.2:30
9151 #, no-wrap
9152 msgid "IOCTL_LIST"
9153 msgstr ""
9154
9155 #. type: TH
9156 #: build/C/man2/ioctl_list.2:30
9157 #, no-wrap
9158 msgid "2007-12-29"
9159 msgstr ""
9160
9161 #. type: Plain text
9162 #: build/C/man2/ioctl_list.2:33
9163 msgid "ioctl_list - list of ioctl calls in Linux/i386 kernel"
9164 msgstr ""
9165
9166 #. type: Plain text
9167 #: build/C/man2/ioctl_list.2:40
9168 msgid ""
9169 "This is Ioctl List 1.3.27, a list of ioctl calls in Linux/i386 kernel "
9170 "1.3.27.  It contains 421 ioctls from "
9171 "I<E<lt>/usr/include/{asm,linux}/*.hE<gt>>.  For each ioctl, its numerical "
9172 "value, its name, and its argument type are given."
9173 msgstr ""
9174
9175 #. type: Plain text
9176 #: build/C/man2/ioctl_list.2:48
9177 msgid ""
9178 "An argument type of I<const struct foo\\ *> means the argument is input to "
9179 "the kernel.  I<struct foo\\ *> means the kernel outputs the argument.  If "
9180 "the kernel uses the argument for both input and output, this is marked with "
9181 "I<//\\ I-O>."
9182 msgstr ""
9183
9184 #. type: Plain text
9185 #: build/C/man2/ioctl_list.2:53
9186 msgid ""
9187 "Some ioctls take more arguments or return more values than a single "
9188 "structure.  These are marked I<//\\ MORE> and documented further in a "
9189 "separate section."
9190 msgstr ""
9191
9192 #. type: Plain text
9193 #: build/C/man2/ioctl_list.2:55
9194 msgid "This list is very incomplete."
9195 msgstr ""
9196
9197 #. type: SS
9198 #: build/C/man2/ioctl_list.2:55
9199 #, no-wrap
9200 msgid "ioctl structure"
9201 msgstr ""
9202
9203 #.  added two sections - aeb
9204 #. type: Plain text
9205 #: build/C/man2/ioctl_list.2:60
9206 msgid ""
9207 "Ioctl command values are 32-bit constants.  In principle these constants are "
9208 "completely arbitrary, but people have tried to build some structure into "
9209 "them."
9210 msgstr ""
9211
9212 #. type: Plain text
9213 #: build/C/man2/ioctl_list.2:79
9214 msgid ""
9215 "The old Linux situation was that of mostly 16-bit constants, where the last "
9216 "byte is a serial number, and the preceding byte(s) give a type indicating "
9217 "the driver.  Sometimes the major number was used: 0x03 for the B<HDIO_*> "
9218 "ioctls, 0x06 for the B<LP*> ioctls.  And sometimes one or more ASCII letters "
9219 "were used.  For example, B<TCGETS> has value 0x00005401, with 0x54 = "
9220 "\\(aqT\\(aq indicating the terminal driver, and B<CYGETTIMEOUT> has value "
9221 "0x00435906, with 0x43 0x59 = \\(aqC\\(aq \\(aqY\\(aq indicating the cyclades "
9222 "driver."
9223 msgstr ""
9224
9225 #. type: Plain text
9226 #: build/C/man2/ioctl_list.2:87
9227 msgid ""
9228 "Later (0.98p5) some more information was built into the number.  One has 2 "
9229 "direction bits (00: none, 01: write, 10: read, 11: read/write)  followed by "
9230 "14 size bits (giving the size of the argument), followed by an 8-bit type "
9231 "(collecting the ioctls in groups for a common purpose or a common driver), "
9232 "and an 8-bit serial number."
9233 msgstr ""
9234
9235 #. type: Plain text
9236 #: build/C/man2/ioctl_list.2:98
9237 msgid ""
9238 "The macros describing this structure live in I<E<lt>asm/ioctl.hE<gt>> and "
9239 "are B<_IO(type,nr)> and B<{_IOR,_IOW,_IOWR}(type,nr,size)>.  They use "
9240 "I<sizeof(size)> so that size is a misnomer here: this third argument is a "
9241 "data type."
9242 msgstr ""
9243
9244 #. type: Plain text
9245 #: build/C/man2/ioctl_list.2:103
9246 msgid ""
9247 "Note that the size bits are very unreliable: in lots of cases they are "
9248 "wrong, either because of buggy macros using I<sizeof(sizeof(struct))>, or "
9249 "because of legacy values."
9250 msgstr ""
9251
9252 #. type: Plain text
9253 #: build/C/man2/ioctl_list.2:107
9254 msgid ""
9255 "Thus, it seems that the new structure only gave disadvantages: it does not "
9256 "help in checking, but it causes varying values for the various "
9257 "architectures."
9258 msgstr ""
9259
9260 #. type: Plain text
9261 #: build/C/man2/ioctl_list.2:113
9262 msgid ""
9263 "Decent ioctls return 0 on success and -1 on error, while any output value is "
9264 "stored via the argument.  However, quite a few ioctls in fact return an "
9265 "output value.  This is not yet indicated below."
9266 msgstr ""
9267
9268 #. type: Plain text
9269 #: build/C/man2/ioctl_list.2:115
9270 msgid "// Main table."
9271 msgstr ""
9272
9273 #. type: Plain text
9274 #: build/C/man2/ioctl_list.2:117
9275 msgid "// E<lt>include/asm-i386/socket.hE<gt>"
9276 msgstr ""
9277
9278 #. type: tbl table
9279 #: build/C/man2/ioctl_list.2:119
9280 #, no-wrap
9281 msgid "0x00008901\tFIOSETOWN\tconst int *\n"
9282 msgstr ""
9283
9284 #. type: tbl table
9285 #: build/C/man2/ioctl_list.2:120
9286 #, no-wrap
9287 msgid "0x00008902\tSIOCSPGRP\tconst int *\n"
9288 msgstr ""
9289
9290 #. type: tbl table
9291 #: build/C/man2/ioctl_list.2:121
9292 #, no-wrap
9293 msgid "0x00008903\tFIOGETOWN\tint *\n"
9294 msgstr ""
9295
9296 #. type: tbl table
9297 #: build/C/man2/ioctl_list.2:122
9298 #, no-wrap
9299 msgid "0x00008904\tSIOCGPGRP\tint *\n"
9300 msgstr ""
9301
9302 #. type: tbl table
9303 #: build/C/man2/ioctl_list.2:123
9304 #, no-wrap
9305 msgid "0x00008905\tSIOCATMAR\tint *\n"
9306 msgstr ""
9307
9308 #. type: tbl table
9309 #: build/C/man2/ioctl_list.2:124
9310 #, no-wrap
9311 msgid "0x00008906\tSIOCGSTAMP\ttimeval *\n"
9312 msgstr ""
9313
9314 #. type: Plain text
9315 #: build/C/man2/ioctl_list.2:128
9316 msgid "// E<lt>include/asm-i386/termios.hE<gt>"
9317 msgstr ""
9318
9319 #. type: tbl table
9320 #: build/C/man2/ioctl_list.2:130
9321 #, no-wrap
9322 msgid "0x00005401\tTCGETS\tstruct termios *\n"
9323 msgstr ""
9324
9325 #. type: tbl table
9326 #: build/C/man2/ioctl_list.2:131
9327 #, no-wrap
9328 msgid "0x00005402\tTCSETS\tconst struct termios *\n"
9329 msgstr ""
9330
9331 #. type: tbl table
9332 #: build/C/man2/ioctl_list.2:132
9333 #, no-wrap
9334 msgid "0x00005403\tTCSETSW\tconst struct termios *\n"
9335 msgstr ""
9336
9337 #. type: tbl table
9338 #: build/C/man2/ioctl_list.2:133
9339 #, no-wrap
9340 msgid "0x00005404\tTCSETSF\tconst struct termios *\n"
9341 msgstr ""
9342
9343 #. type: tbl table
9344 #: build/C/man2/ioctl_list.2:134
9345 #, no-wrap
9346 msgid "0x00005405\tTCGETA\tstruct termio *\n"
9347 msgstr ""
9348
9349 #. type: tbl table
9350 #: build/C/man2/ioctl_list.2:135
9351 #, no-wrap
9352 msgid "0x00005406\tTCSETA\tconst struct termio *\n"
9353 msgstr ""
9354
9355 #. type: tbl table
9356 #: build/C/man2/ioctl_list.2:136
9357 #, no-wrap
9358 msgid "0x00005407\tTCSETAW\tconst struct termio *\n"
9359 msgstr ""
9360
9361 #. type: tbl table
9362 #: build/C/man2/ioctl_list.2:137
9363 #, no-wrap
9364 msgid "0x00005408\tTCSETAF\tconst struct termio *\n"
9365 msgstr ""
9366
9367 #. type: tbl table
9368 #: build/C/man2/ioctl_list.2:138
9369 #, no-wrap
9370 msgid "0x00005409\tTCSBRK\tint\n"
9371 msgstr ""
9372
9373 #. type: tbl table
9374 #: build/C/man2/ioctl_list.2:139
9375 #, no-wrap
9376 msgid "0x0000540A\tTCXONC\tint\n"
9377 msgstr ""
9378
9379 #. type: tbl table
9380 #: build/C/man2/ioctl_list.2:140
9381 #, no-wrap
9382 msgid "0x0000540B\tTCFLSH\tint\n"
9383 msgstr ""
9384
9385 #. type: tbl table
9386 #: build/C/man2/ioctl_list.2:141
9387 #, no-wrap
9388 msgid "0x0000540C\tTIOCEXCL\tvoid\n"
9389 msgstr ""
9390
9391 #. type: tbl table
9392 #: build/C/man2/ioctl_list.2:142
9393 #, no-wrap
9394 msgid "0x0000540D\tTIOCNXCL\tvoid\n"
9395 msgstr ""
9396
9397 #. type: tbl table
9398 #: build/C/man2/ioctl_list.2:143
9399 #, no-wrap
9400 msgid "0x0000540E\tTIOCSCTTY\tint\n"
9401 msgstr ""
9402
9403 #. type: tbl table
9404 #: build/C/man2/ioctl_list.2:144
9405 #, no-wrap
9406 msgid "0x0000540F\tTIOCGPGRP\tpid_t *\n"
9407 msgstr ""
9408
9409 #. type: tbl table
9410 #: build/C/man2/ioctl_list.2:145
9411 #, no-wrap
9412 msgid "0x00005410\tTIOCSPGRP\tconst pid_t *\n"
9413 msgstr ""
9414
9415 #. type: tbl table
9416 #: build/C/man2/ioctl_list.2:146
9417 #, no-wrap
9418 msgid "0x00005411\tTIOCOUTQ\tint *\n"
9419 msgstr ""
9420
9421 #. type: tbl table
9422 #: build/C/man2/ioctl_list.2:147
9423 #, no-wrap
9424 msgid "0x00005412\tTIOCSTI\tconst char *\n"
9425 msgstr ""
9426
9427 #. type: tbl table
9428 #: build/C/man2/ioctl_list.2:148
9429 #, no-wrap
9430 msgid "0x00005413\tTIOCGWINSZ\tstruct winsize *\n"
9431 msgstr ""
9432
9433 #. type: tbl table
9434 #: build/C/man2/ioctl_list.2:149
9435 #, no-wrap
9436 msgid "0x00005414\tTIOCSWINSZ\tconst struct winsize *\n"
9437 msgstr ""
9438
9439 #. type: tbl table
9440 #: build/C/man2/ioctl_list.2:150
9441 #, no-wrap
9442 msgid "0x00005415\tTIOCMGET\tint *\n"
9443 msgstr ""
9444
9445 #. type: tbl table
9446 #: build/C/man2/ioctl_list.2:151
9447 #, no-wrap
9448 msgid "0x00005416\tTIOCMBIS\tconst int *\n"
9449 msgstr ""
9450
9451 #. type: tbl table
9452 #: build/C/man2/ioctl_list.2:152
9453 #, no-wrap
9454 msgid "0x00005417\tTIOCMBIC\tconst int *\n"
9455 msgstr ""
9456
9457 #. type: tbl table
9458 #: build/C/man2/ioctl_list.2:153
9459 #, no-wrap
9460 msgid "0x00005418\tTIOCMSET\tconst int *\n"
9461 msgstr ""
9462
9463 #. type: tbl table
9464 #: build/C/man2/ioctl_list.2:154
9465 #, no-wrap
9466 msgid "0x00005419\tTIOCGSOFTCAR\tint *\n"
9467 msgstr ""
9468
9469 #. type: tbl table
9470 #: build/C/man2/ioctl_list.2:155
9471 #, no-wrap
9472 msgid "0x0000541A\tTIOCSSOFTCAR\tconst int *\n"
9473 msgstr ""
9474
9475 #. type: tbl table
9476 #: build/C/man2/ioctl_list.2:156
9477 #, no-wrap
9478 msgid "0x0000541B\tFIONREAD\tint *\n"
9479 msgstr ""
9480
9481 #. type: tbl table
9482 #: build/C/man2/ioctl_list.2:157
9483 #, no-wrap
9484 msgid "0x0000541B\tTIOCINQ\tint *\n"
9485 msgstr ""
9486
9487 #. type: tbl table
9488 #: build/C/man2/ioctl_list.2:158
9489 #, no-wrap
9490 msgid "0x0000541C\tTIOCLINUX\tconst char *\t// MORE\n"
9491 msgstr ""
9492
9493 #. type: tbl table
9494 #: build/C/man2/ioctl_list.2:159
9495 #, no-wrap
9496 msgid "0x0000541D\tTIOCCONS\tvoid\n"
9497 msgstr ""
9498
9499 #. type: tbl table
9500 #: build/C/man2/ioctl_list.2:160
9501 #, no-wrap
9502 msgid "0x0000541E\tTIOCGSERIAL\tstruct serial_struct *\n"
9503 msgstr ""
9504
9505 #. type: tbl table
9506 #: build/C/man2/ioctl_list.2:161
9507 #, no-wrap
9508 msgid "0x0000541F\tTIOCSSERIAL\tconst struct serial_struct *\n"
9509 msgstr ""
9510
9511 #. type: tbl table
9512 #: build/C/man2/ioctl_list.2:162
9513 #, no-wrap
9514 msgid "0x00005420\tTIOCPKT\tconst int *\n"
9515 msgstr ""
9516
9517 #. type: tbl table
9518 #: build/C/man2/ioctl_list.2:163
9519 #, no-wrap
9520 msgid "0x00005421\tFIONBIO\tconst int *\n"
9521 msgstr ""
9522
9523 #. type: tbl table
9524 #: build/C/man2/ioctl_list.2:164
9525 #, no-wrap
9526 msgid "0x00005422\tTIOCNOTTY\tvoid\n"
9527 msgstr ""
9528
9529 #. type: tbl table
9530 #: build/C/man2/ioctl_list.2:165
9531 #, no-wrap
9532 msgid "0x00005423\tTIOCSETD\tconst int *\n"
9533 msgstr ""
9534
9535 #. type: tbl table
9536 #: build/C/man2/ioctl_list.2:166
9537 #, no-wrap
9538 msgid "0x00005424\tTIOCGETD\tint *\n"
9539 msgstr ""
9540
9541 #. type: tbl table
9542 #: build/C/man2/ioctl_list.2:167
9543 #, no-wrap
9544 msgid "0x00005425\tTCSBRKP\tint\n"
9545 msgstr ""
9546
9547 #. type: tbl table
9548 #: build/C/man2/ioctl_list.2:168
9549 #, no-wrap
9550 msgid "0x00005426\tTIOCTTYGSTRUCT\tstruct tty_struct *\n"
9551 msgstr ""
9552
9553 #. type: tbl table
9554 #: build/C/man2/ioctl_list.2:169
9555 #, no-wrap
9556 msgid "0x00005450\tFIONCLEX\tvoid\n"
9557 msgstr ""
9558
9559 #. type: tbl table
9560 #: build/C/man2/ioctl_list.2:170
9561 #, no-wrap
9562 msgid "0x00005451\tFIOCLEX\tvoid\n"
9563 msgstr ""
9564
9565 #. type: tbl table
9566 #: build/C/man2/ioctl_list.2:171
9567 #, no-wrap
9568 msgid "0x00005452\tFIOASYNC\tconst int *\n"
9569 msgstr ""
9570
9571 #. type: tbl table
9572 #: build/C/man2/ioctl_list.2:172
9573 #, no-wrap
9574 msgid "0x00005453\tTIOCSERCONFIG\tvoid\n"
9575 msgstr ""
9576
9577 #. type: tbl table
9578 #: build/C/man2/ioctl_list.2:173
9579 #, no-wrap
9580 msgid "0x00005454\tTIOCSERGWILD\tint *\n"
9581 msgstr ""
9582
9583 #. type: tbl table
9584 #: build/C/man2/ioctl_list.2:174
9585 #, no-wrap
9586 msgid "0x00005455\tTIOCSERSWILD\tconst int *\n"
9587 msgstr ""
9588
9589 #. type: tbl table
9590 #: build/C/man2/ioctl_list.2:175
9591 #, no-wrap
9592 msgid "0x00005456\tTIOCGLCKTRMIOS\tstruct termios *\n"
9593 msgstr ""
9594
9595 #. type: tbl table
9596 #: build/C/man2/ioctl_list.2:176
9597 #, no-wrap
9598 msgid "0x00005457\tTIOCSLCKTRMIOS\tconst struct termios *\n"
9599 msgstr ""
9600
9601 #. type: tbl table
9602 #: build/C/man2/ioctl_list.2:177
9603 #, no-wrap
9604 msgid "0x00005458\tTIOCSERGSTRUCT\tstruct async_struct *\n"
9605 msgstr ""
9606
9607 #. type: tbl table
9608 #: build/C/man2/ioctl_list.2:178
9609 #, no-wrap
9610 msgid "0x00005459\tTIOCSERGETLSR\tint *\n"
9611 msgstr ""
9612
9613 #. type: tbl table
9614 #: build/C/man2/ioctl_list.2:185
9615 #, no-wrap
9616 msgid "0x0000545A\tTIOCSERGETMULTI\tstruct serial_multiport_struct *\n"
9617 msgstr ""
9618
9619 #. type: tbl table
9620 #: build/C/man2/ioctl_list.2:186
9621 #, no-wrap
9622 msgid "0x0000545B\tTIOCSERSETMULTI\tconst struct serial_multiport_struct *\n"
9623 msgstr ""
9624
9625 #. type: Plain text
9626 #: build/C/man2/ioctl_list.2:190
9627 msgid "// E<lt>include/linux/ax25.hE<gt>"
9628 msgstr ""
9629
9630 #. type: tbl table
9631 #: build/C/man2/ioctl_list.2:192
9632 #, no-wrap
9633 msgid "0x000089E0\tSIOCAX25GETUID\tconst struct sockaddr_ax25 *\n"
9634 msgstr ""
9635
9636 #. type: tbl table
9637 #: build/C/man2/ioctl_list.2:193
9638 #, no-wrap
9639 msgid "0x000089E1\tSIOCAX25ADDUID\tconst struct sockaddr_ax25 *\n"
9640 msgstr ""
9641
9642 #. type: tbl table
9643 #: build/C/man2/ioctl_list.2:194
9644 #, no-wrap
9645 msgid "0x000089E2\tSIOCAX25DELUID\tconst struct sockaddr_ax25 *\n"
9646 msgstr ""
9647
9648 #. type: tbl table
9649 #: build/C/man2/ioctl_list.2:195
9650 #, no-wrap
9651 msgid "0x000089E3\tSIOCAX25NOUID\tconst int *\n"
9652 msgstr ""
9653
9654 #. type: tbl table
9655 #: build/C/man2/ioctl_list.2:196
9656 #, no-wrap
9657 msgid "0x000089E4\tSIOCAX25DIGCTL\tconst int *\n"
9658 msgstr ""
9659
9660 #. type: tbl table
9661 #: build/C/man2/ioctl_list.2:197
9662 #, no-wrap
9663 msgid "0x000089E5\tSIOCAX25GETPARMS\tstruct ax25_parms_struct *\t// I-O\n"
9664 msgstr ""
9665
9666 #. type: tbl table
9667 #: build/C/man2/ioctl_list.2:201
9668 #, no-wrap
9669 msgid "0x000089E6\tSIOCAX25SETPARMS\tconst struct ax25_parms_struct *\n"
9670 msgstr ""
9671
9672 #. type: Plain text
9673 #: build/C/man2/ioctl_list.2:205
9674 msgid "// E<lt>include/linux/cdk.hE<gt>"
9675 msgstr ""
9676
9677 #. type: tbl table
9678 #: build/C/man2/ioctl_list.2:207
9679 #, no-wrap
9680 msgid "0x00007314\tSTL_BINTR\tvoid\n"
9681 msgstr ""
9682
9683 #. type: tbl table
9684 #: build/C/man2/ioctl_list.2:208
9685 #, no-wrap
9686 msgid "0x00007315\tSTL_BSTART\tvoid\n"
9687 msgstr ""
9688
9689 #. type: tbl table
9690 #: build/C/man2/ioctl_list.2:209
9691 #, no-wrap
9692 msgid "0x00007316\tSTL_BSTOP\tvoid\n"
9693 msgstr ""
9694
9695 #. type: tbl table
9696 #: build/C/man2/ioctl_list.2:210
9697 #, no-wrap
9698 msgid "0x00007317\tSTL_BRESET\tvoid\n"
9699 msgstr ""
9700
9701 #. type: Plain text
9702 #: build/C/man2/ioctl_list.2:214
9703 msgid "// E<lt>include/linux/cdrom.hE<gt>"
9704 msgstr ""
9705
9706 #. type: tbl table
9707 #: build/C/man2/ioctl_list.2:216
9708 #, no-wrap
9709 msgid "0x00005301\tCDROMPAUSE\tvoid\n"
9710 msgstr ""
9711
9712 #. type: tbl table
9713 #: build/C/man2/ioctl_list.2:217
9714 #, no-wrap
9715 msgid "0x00005302\tCDROMRESUME\tvoid\n"
9716 msgstr ""
9717
9718 #. type: tbl table
9719 #: build/C/man2/ioctl_list.2:218
9720 #, no-wrap
9721 msgid "0x00005303\tCDROMPLAYMSF\tconst struct cdrom_msf *\n"
9722 msgstr ""
9723
9724 #. type: tbl table
9725 #: build/C/man2/ioctl_list.2:219
9726 #, no-wrap
9727 msgid "0x00005304\tCDROMPLAYTRKIND\tconst struct cdrom_ti *\n"
9728 msgstr ""
9729
9730 #. type: tbl table
9731 #: build/C/man2/ioctl_list.2:220
9732 #, no-wrap
9733 msgid "0x00005305\tCDROMREADTOCHDR\tstruct cdrom_tochdr *\n"
9734 msgstr ""
9735
9736 #. type: tbl table
9737 #: build/C/man2/ioctl_list.2:224
9738 #, no-wrap
9739 msgid "0x00005306\tCDROMREADTOCENTRY\tstruct cdrom_tocentry *\t// I-O\n"
9740 msgstr ""
9741
9742 #. type: tbl table
9743 #: build/C/man2/ioctl_list.2:228
9744 #, no-wrap
9745 msgid "0x00005307\tCDROMSTOP\tvoid\n"
9746 msgstr ""
9747
9748 #. type: tbl table
9749 #: build/C/man2/ioctl_list.2:229
9750 #, no-wrap
9751 msgid "0x00005308\tCDROMSTART\tvoid\n"
9752 msgstr ""
9753
9754 #. type: tbl table
9755 #: build/C/man2/ioctl_list.2:230
9756 #, no-wrap
9757 msgid "0x00005309\tCDROMEJECT\tvoid\n"
9758 msgstr ""
9759
9760 #. type: tbl table
9761 #: build/C/man2/ioctl_list.2:231
9762 #, no-wrap
9763 msgid "0x0000530A\tCDROMVOLCTRL\tconst struct cdrom_volctrl *\n"
9764 msgstr ""
9765
9766 #. type: tbl table
9767 #: build/C/man2/ioctl_list.2:232
9768 #, no-wrap
9769 msgid "0x0000530B\tCDROMSUBCHNL\tstruct cdrom_subchnl *\t// I-O\n"
9770 msgstr ""
9771
9772 #. type: tbl table
9773 #: build/C/man2/ioctl_list.2:233
9774 #, no-wrap
9775 msgid "0x0000530C\tCDROMREADMODE2\tconst struct cdrom_msf *\t// MORE\n"
9776 msgstr ""
9777
9778 #. type: tbl table
9779 #: build/C/man2/ioctl_list.2:234
9780 #, no-wrap
9781 msgid "0x0000530D\tCDROMREADMODE1\tconst struct cdrom_msf *\t// MORE\n"
9782 msgstr ""
9783
9784 #. type: tbl table
9785 #: build/C/man2/ioctl_list.2:235
9786 #, no-wrap
9787 msgid "0x0000530E\tCDROMREADAUDIO\tconst struct cdrom_read_audio *\t// MORE\n"
9788 msgstr ""
9789
9790 #. type: tbl table
9791 #: build/C/man2/ioctl_list.2:236
9792 #, no-wrap
9793 msgid "0x0000530F\tCDROMEJECT_SW\tint\n"
9794 msgstr ""
9795
9796 #. type: tbl table
9797 #: build/C/man2/ioctl_list.2:240
9798 #, no-wrap
9799 msgid "0x00005310\tCDROMMULTISESSION\tstruct cdrom_multisession *\t// I-O\n"
9800 msgstr ""
9801
9802 #. type: tbl table
9803 #: build/C/man2/ioctl_list.2:244
9804 #, no-wrap
9805 msgid "0x00005311\tCDROM_GET_UPC\tstruct { char [8]; } *\n"
9806 msgstr ""
9807
9808 #. type: tbl table
9809 #: build/C/man2/ioctl_list.2:245
9810 #, no-wrap
9811 msgid "0x00005312\tCDROMRESET\tvoid\n"
9812 msgstr ""
9813
9814 #. type: tbl table
9815 #: build/C/man2/ioctl_list.2:246
9816 #, no-wrap
9817 msgid "0x00005313\tCDROMVOLREAD\tstruct cdrom_volctrl *\n"
9818 msgstr ""
9819
9820 #. type: tbl table
9821 #: build/C/man2/ioctl_list.2:247
9822 #, no-wrap
9823 msgid "0x00005314\tCDROMREADRAW\tconst struct cdrom_msf *\t// MORE\n"
9824 msgstr ""
9825
9826 #. type: tbl table
9827 #: build/C/man2/ioctl_list.2:248
9828 #, no-wrap
9829 msgid "0x00005315\tCDROMREADCOOKED\tconst struct cdrom_msf *\t// MORE\n"
9830 msgstr ""
9831
9832 #. type: tbl table
9833 #: build/C/man2/ioctl_list.2:249
9834 #, no-wrap
9835 msgid "0x00005316\tCDROMSEEK\tconst struct cdrom_msf *\n"
9836 msgstr ""
9837
9838 #. type: Plain text
9839 #: build/C/man2/ioctl_list.2:253
9840 msgid "// E<lt>include/linux/cm206.hE<gt>"
9841 msgstr ""
9842
9843 #. type: tbl table
9844 #: build/C/man2/ioctl_list.2:255
9845 #, no-wrap
9846 msgid "0x00002000\tCM206CTL_GET_STAT\tint\n"
9847 msgstr ""
9848
9849 #. type: tbl table
9850 #: build/C/man2/ioctl_list.2:256
9851 #, no-wrap
9852 msgid "0x00002001\tCM206CTL_GET_LAST_STAT\tint\n"
9853 msgstr ""
9854
9855 #. type: Plain text
9856 #: build/C/man2/ioctl_list.2:260
9857 msgid "// E<lt>include/linux/cyclades.hE<gt>"
9858 msgstr ""
9859
9860 #. type: tbl table
9861 #: build/C/man2/ioctl_list.2:262
9862 #, no-wrap
9863 msgid "0x00435901\tCYGETMON\tstruct cyclades_monitor *\n"
9864 msgstr ""
9865
9866 #. type: tbl table
9867 #: build/C/man2/ioctl_list.2:263
9868 #, no-wrap
9869 msgid "0x00435902\tCYGETTHRESH\tint *\n"
9870 msgstr ""
9871
9872 #. type: tbl table
9873 #: build/C/man2/ioctl_list.2:264
9874 #, no-wrap
9875 msgid "0x00435903\tCYSETTHRESH\tint\n"
9876 msgstr ""
9877
9878 #. type: tbl table
9879 #: build/C/man2/ioctl_list.2:265
9880 #, no-wrap
9881 msgid "0x00435904\tCYGETDEFTHRESH\tint *\n"
9882 msgstr ""
9883
9884 #. type: tbl table
9885 #: build/C/man2/ioctl_list.2:266
9886 #, no-wrap
9887 msgid "0x00435905\tCYSETDEFTHRESH\tint\n"
9888 msgstr ""
9889
9890 #. type: tbl table
9891 #: build/C/man2/ioctl_list.2:267
9892 #, no-wrap
9893 msgid "0x00435906\tCYGETTIMEOUT\tint *\n"
9894 msgstr ""
9895
9896 #. type: tbl table
9897 #: build/C/man2/ioctl_list.2:268
9898 #, no-wrap
9899 msgid "0x00435907\tCYSETTIMEOUT\tint\n"
9900 msgstr ""
9901
9902 #. type: tbl table
9903 #: build/C/man2/ioctl_list.2:269
9904 #, no-wrap
9905 msgid "0x00435908\tCYGETDEFTIMEOUT\tint *\n"
9906 msgstr ""
9907
9908 #. type: tbl table
9909 #: build/C/man2/ioctl_list.2:270
9910 #, no-wrap
9911 msgid "0x00435909\tCYSETDEFTIMEOUT\tint\n"
9912 msgstr ""
9913
9914 #. type: Plain text
9915 #: build/C/man2/ioctl_list.2:274
9916 msgid "// E<lt>include/linux/ext2_fs.hE<gt>"
9917 msgstr ""
9918
9919 #. type: tbl table
9920 #: build/C/man2/ioctl_list.2:276
9921 #, no-wrap
9922 msgid "0x80046601\tEXT2_IOC_GETFLAGS\tint *\n"
9923 msgstr ""
9924
9925 #. type: tbl table
9926 #: build/C/man2/ioctl_list.2:277
9927 #, no-wrap
9928 msgid "0x40046602\tEXT2_IOC_SETFLAGS\tconst int *\n"
9929 msgstr ""
9930
9931 #. type: tbl table
9932 #: build/C/man2/ioctl_list.2:278
9933 #, no-wrap
9934 msgid "0x80047601\tEXT2_IOC_GETVERSION\tint *\n"
9935 msgstr ""
9936
9937 #. type: tbl table
9938 #: build/C/man2/ioctl_list.2:279
9939 #, no-wrap
9940 msgid "0x40047602\tEXT2_IOC_SETVERSION\tconst int *\n"
9941 msgstr ""
9942
9943 #. type: Plain text
9944 #: build/C/man2/ioctl_list.2:283
9945 msgid "// E<lt>include/linux/fd.hE<gt>"
9946 msgstr ""
9947
9948 #. type: tbl table
9949 #: build/C/man2/ioctl_list.2:285
9950 #, no-wrap
9951 msgid "0x00000000\tFDCLRPRM\tvoid\n"
9952 msgstr ""
9953
9954 #. type: tbl table
9955 #: build/C/man2/ioctl_list.2:286
9956 #, no-wrap
9957 msgid "0x00000001\tFDSETPRM\tconst struct floppy_struct *\n"
9958 msgstr ""
9959
9960 #. type: tbl table
9961 #: build/C/man2/ioctl_list.2:287
9962 #, no-wrap
9963 msgid "0x00000002\tFDDEFPRM\tconst struct floppy_struct *\n"
9964 msgstr ""
9965
9966 #. type: tbl table
9967 #: build/C/man2/ioctl_list.2:288
9968 #, no-wrap
9969 msgid "0x00000003\tFDGETPRM\tstruct floppy_struct *\n"
9970 msgstr ""
9971
9972 #. type: tbl table
9973 #: build/C/man2/ioctl_list.2:289
9974 #, no-wrap
9975 msgid "0x00000004\tFDMSGON\tvoid\n"
9976 msgstr ""
9977
9978 #. type: tbl table
9979 #: build/C/man2/ioctl_list.2:290
9980 #, no-wrap
9981 msgid "0x00000005\tFDMSGOFF\tvoid\n"
9982 msgstr ""
9983
9984 #. type: tbl table
9985 #: build/C/man2/ioctl_list.2:291
9986 #, no-wrap
9987 msgid "0x00000006\tFDFMTBEG\tvoid\n"
9988 msgstr ""
9989
9990 #. type: tbl table
9991 #: build/C/man2/ioctl_list.2:292
9992 #, no-wrap
9993 msgid "0x00000007\tFDFMTTRK\tconst struct format_descr *\n"
9994 msgstr ""
9995
9996 #. type: tbl table
9997 #: build/C/man2/ioctl_list.2:293
9998 #, no-wrap
9999 msgid "0x00000008\tFDFMTEND\tvoid\n"
10000 msgstr ""
10001
10002 #. type: tbl table
10003 #: build/C/man2/ioctl_list.2:294
10004 #, no-wrap
10005 msgid "0x0000000A\tFDSETEMSGTRESH\tint\n"
10006 msgstr ""
10007
10008 #. type: tbl table
10009 #: build/C/man2/ioctl_list.2:295
10010 #, no-wrap
10011 msgid "0x0000000B\tFDFLUSH\tvoid\n"
10012 msgstr ""
10013
10014 #. type: tbl table
10015 #: build/C/man2/ioctl_list.2:296
10016 #, no-wrap
10017 msgid "0x0000000C\tFDSETMAXERRS\tconst struct floppy_max_errors *\n"
10018 msgstr ""
10019
10020 #. type: tbl table
10021 #: build/C/man2/ioctl_list.2:297
10022 #, no-wrap
10023 msgid "0x0000000E\tFDGETMAXERRS\tstruct floppy_max_errors *\n"
10024 msgstr ""
10025
10026 #. type: tbl table
10027 #: build/C/man2/ioctl_list.2:298
10028 #, no-wrap
10029 msgid "0x00000010\tFDGETDRVTYP\tstruct { char [16]; } *\n"
10030 msgstr ""
10031
10032 #. type: tbl table
10033 #: build/C/man2/ioctl_list.2:299
10034 #, no-wrap
10035 msgid "0x00000014\tFDSETDRVPRM\tconst struct floppy_drive_params *\n"
10036 msgstr ""
10037
10038 #. type: tbl table
10039 #: build/C/man2/ioctl_list.2:300
10040 #, no-wrap
10041 msgid "0x00000015\tFDGETDRVPRM\tstruct floppy_drive_params *\n"
10042 msgstr ""
10043
10044 #. type: tbl table
10045 #: build/C/man2/ioctl_list.2:301
10046 #, no-wrap
10047 msgid "0x00000016\tFDGETDRVSTAT\tstruct floppy_drive_struct *\n"
10048 msgstr ""
10049
10050 #. type: tbl table
10051 #: build/C/man2/ioctl_list.2:302
10052 #, no-wrap
10053 msgid "0x00000017\tFDPOLLDRVSTAT\tstruct floppy_drive_struct *\n"
10054 msgstr ""
10055
10056 #. type: tbl table
10057 #: build/C/man2/ioctl_list.2:303
10058 #, no-wrap
10059 msgid "0x00000018\tFDRESET\tint\n"
10060 msgstr ""
10061
10062 #. type: tbl table
10063 #: build/C/man2/ioctl_list.2:304
10064 #, no-wrap
10065 msgid "0x00000019\tFDGETFDCSTAT\tstruct floppy_fdc_state *\n"
10066 msgstr ""
10067
10068 #. type: tbl table
10069 #: build/C/man2/ioctl_list.2:305
10070 #, no-wrap
10071 msgid "0x0000001B\tFDWERRORCLR\tvoid\n"
10072 msgstr ""
10073
10074 #. type: tbl table
10075 #: build/C/man2/ioctl_list.2:306
10076 #, no-wrap
10077 msgid "0x0000001C\tFDWERRORGET\tstruct floppy_write_errors *\n"
10078 msgstr ""
10079
10080 #. type: tbl table
10081 #: build/C/man2/ioctl_list.2:310
10082 #, no-wrap
10083 msgid "0x0000001E\tFDRAWCMD\tstruct floppy_raw_cmd *\t// MORE // I-O\n"
10084 msgstr ""
10085
10086 #. type: tbl table
10087 #: build/C/man2/ioctl_list.2:311
10088 #, no-wrap
10089 msgid "0x00000028\tFDTWADDLE\tvoid\n"
10090 msgstr ""
10091
10092 #. type: Plain text
10093 #: build/C/man2/ioctl_list.2:315
10094 msgid "// E<lt>include/linux/fs.hE<gt>"
10095 msgstr ""
10096
10097 #. type: tbl table
10098 #: build/C/man2/ioctl_list.2:317
10099 #, no-wrap
10100 msgid "0x0000125D\tBLKROSET\tconst int *\n"
10101 msgstr ""
10102
10103 #. type: tbl table
10104 #: build/C/man2/ioctl_list.2:318
10105 #, no-wrap
10106 msgid "0x0000125E\tBLKROGET\tint *\n"
10107 msgstr ""
10108
10109 #. type: tbl table
10110 #: build/C/man2/ioctl_list.2:319
10111 #, no-wrap
10112 msgid "0x0000125F\tBLKRRPART\tvoid\n"
10113 msgstr ""
10114
10115 #. type: tbl table
10116 #: build/C/man2/ioctl_list.2:320
10117 #, no-wrap
10118 msgid "0x00001260\tBLKGETSIZE\tunsigned long *\n"
10119 msgstr ""
10120
10121 #. type: tbl table
10122 #: build/C/man2/ioctl_list.2:321
10123 #, no-wrap
10124 msgid "0x00001261\tBLKFLSBUF\tvoid\n"
10125 msgstr ""
10126
10127 #. type: tbl table
10128 #: build/C/man2/ioctl_list.2:322
10129 #, no-wrap
10130 msgid "0x00001262\tBLKRASET\tint\n"
10131 msgstr ""
10132
10133 #. type: tbl table
10134 #: build/C/man2/ioctl_list.2:323
10135 #, no-wrap
10136 msgid "0x00001263\tBLKRAGET\tint *\n"
10137 msgstr ""
10138
10139 #. type: tbl table
10140 #: build/C/man2/ioctl_list.2:324
10141 #, no-wrap
10142 msgid "0x00000001\tFIBMAP\tint *\t// I-O\n"
10143 msgstr ""
10144
10145 #. type: tbl table
10146 #: build/C/man2/ioctl_list.2:325
10147 #, no-wrap
10148 msgid "0x00000002\tFIGETBSZ\tint *\n"
10149 msgstr ""
10150
10151 #. type: Plain text
10152 #: build/C/man2/ioctl_list.2:329
10153 msgid "// E<lt>include/linux/hdreg.hE<gt>"
10154 msgstr ""
10155
10156 #. type: tbl table
10157 #: build/C/man2/ioctl_list.2:331
10158 #, no-wrap
10159 msgid "0x00000301\tHDIO_GETGEO\tstruct hd_geometry *\n"
10160 msgstr ""
10161
10162 #. type: tbl table
10163 #: build/C/man2/ioctl_list.2:332
10164 #, no-wrap
10165 msgid "0x00000302\tHDIO_GET_UNMASKINTR\tint *\n"
10166 msgstr ""
10167
10168 #. type: tbl table
10169 #: build/C/man2/ioctl_list.2:333
10170 #, no-wrap
10171 msgid "0x00000304\tHDIO_GET_MULTCOUNT\tint *\n"
10172 msgstr ""
10173
10174 #. type: tbl table
10175 #: build/C/man2/ioctl_list.2:334
10176 #, no-wrap
10177 msgid "0x00000307\tHDIO_GET_IDENTITY\tstruct hd_driveid *\n"
10178 msgstr ""
10179
10180 #. type: tbl table
10181 #: build/C/man2/ioctl_list.2:335
10182 #, no-wrap
10183 msgid "0x00000308\tHDIO_GET_KEEPSETTINGS\tint *\n"
10184 msgstr ""
10185
10186 #. type: tbl table
10187 #: build/C/man2/ioctl_list.2:336
10188 #, no-wrap
10189 msgid "0x00000309\tHDIO_GET_CHIPSET\tint *\n"
10190 msgstr ""
10191
10192 #. type: tbl table
10193 #: build/C/man2/ioctl_list.2:337
10194 #, no-wrap
10195 msgid "0x0000030A\tHDIO_GET_NOWERR\tint *\n"
10196 msgstr ""
10197
10198 #. type: tbl table
10199 #: build/C/man2/ioctl_list.2:338
10200 #, no-wrap
10201 msgid "0x0000030B\tHDIO_GET_DMA\tint *\n"
10202 msgstr ""
10203
10204 #. type: tbl table
10205 #: build/C/man2/ioctl_list.2:339
10206 #, no-wrap
10207 msgid "0x0000031F\tHDIO_DRIVE_CMD\tint *\t// I-O\n"
10208 msgstr ""
10209
10210 #. type: tbl table
10211 #: build/C/man2/ioctl_list.2:340
10212 #, no-wrap
10213 msgid "0x00000321\tHDIO_SET_MULTCOUNT\tint\n"
10214 msgstr ""
10215
10216 #. type: tbl table
10217 #: build/C/man2/ioctl_list.2:341
10218 #, no-wrap
10219 msgid "0x00000322\tHDIO_SET_UNMASKINTR\tint\n"
10220 msgstr ""
10221
10222 #. type: tbl table
10223 #: build/C/man2/ioctl_list.2:342
10224 #, no-wrap
10225 msgid "0x00000323\tHDIO_SET_KEEPSETTINGS\tint\n"
10226 msgstr ""
10227
10228 #. type: tbl table
10229 #: build/C/man2/ioctl_list.2:343
10230 #, no-wrap
10231 msgid "0x00000324\tHDIO_SET_CHIPSET\tint\n"
10232 msgstr ""
10233
10234 #. type: tbl table
10235 #: build/C/man2/ioctl_list.2:344
10236 #, no-wrap
10237 msgid "0x00000325\tHDIO_SET_NOWERR\tint\n"
10238 msgstr ""
10239
10240 #. type: tbl table
10241 #: build/C/man2/ioctl_list.2:345
10242 #, no-wrap
10243 msgid "0x00000326\tHDIO_SET_DMA\tint\n"
10244 msgstr ""
10245
10246 #. type: Plain text
10247 #: build/C/man2/ioctl_list.2:349
10248 msgid "// E<lt>include/linux/if_eql.hE<gt>"
10249 msgstr ""
10250
10251 #. type: tbl table
10252 #: build/C/man2/ioctl_list.2:351
10253 #, no-wrap
10254 msgid "0x000089F0\tEQL_ENSLAVE\tstruct ifreq *\t// MORE // I-O\n"
10255 msgstr ""
10256
10257 #. type: tbl table
10258 #: build/C/man2/ioctl_list.2:352
10259 #, no-wrap
10260 msgid "0x000089F1\tEQL_EMANCIPATE\tstruct ifreq *\t// MORE // I-O\n"
10261 msgstr ""
10262
10263 #. type: tbl table
10264 #: build/C/man2/ioctl_list.2:353
10265 #, no-wrap
10266 msgid "0x000089F2\tEQL_GETSLAVECFG\tstruct ifreq *\t// MORE // I-O\n"
10267 msgstr ""
10268
10269 #. type: tbl table
10270 #: build/C/man2/ioctl_list.2:354
10271 #, no-wrap
10272 msgid "0x000089F3\tEQL_SETSLAVECFG\tstruct ifreq *\t// MORE // I-O\n"
10273 msgstr ""
10274
10275 #. type: tbl table
10276 #: build/C/man2/ioctl_list.2:355
10277 #, no-wrap
10278 msgid "0x000089F4\tEQL_GETMASTRCFG\tstruct ifreq *\t// MORE // I-O\n"
10279 msgstr ""
10280
10281 #. type: tbl table
10282 #: build/C/man2/ioctl_list.2:356
10283 #, no-wrap
10284 msgid "0x000089F5\tEQL_SETMASTRCFG\tstruct ifreq *\t// MORE // I-O\n"
10285 msgstr ""
10286
10287 #. type: Plain text
10288 #: build/C/man2/ioctl_list.2:360
10289 msgid "// E<lt>include/linux/if_plip.hE<gt>"
10290 msgstr ""
10291
10292 #. type: tbl table
10293 #: build/C/man2/ioctl_list.2:362
10294 #, no-wrap
10295 msgid "0x000089F0\tSIOCDEVPLIP\tstruct ifreq *\t// I-O\n"
10296 msgstr ""
10297
10298 #. type: Plain text
10299 #: build/C/man2/ioctl_list.2:366
10300 msgid "// E<lt>include/linux/if_ppp.hE<gt>"
10301 msgstr ""
10302
10303 #. type: tbl table
10304 #: build/C/man2/ioctl_list.2:368
10305 #, no-wrap
10306 msgid "0x00005490\tPPPIOCGFLAGS\tint *\n"
10307 msgstr ""
10308
10309 #. type: tbl table
10310 #: build/C/man2/ioctl_list.2:369
10311 #, no-wrap
10312 msgid "0x00005491\tPPPIOCSFLAGS\tconst int *\n"
10313 msgstr ""
10314
10315 #. type: tbl table
10316 #: build/C/man2/ioctl_list.2:370
10317 #, no-wrap
10318 msgid "0x00005492\tPPPIOCGASYNCMAP\tint *\n"
10319 msgstr ""
10320
10321 #. type: tbl table
10322 #: build/C/man2/ioctl_list.2:371
10323 #, no-wrap
10324 msgid "0x00005493\tPPPIOCSASYNCMAP\tconst int *\n"
10325 msgstr ""
10326
10327 #. type: tbl table
10328 #: build/C/man2/ioctl_list.2:372
10329 #, no-wrap
10330 msgid "0x00005494\tPPPIOCGUNIT\tint *\n"
10331 msgstr ""
10332
10333 #. type: tbl table
10334 #: build/C/man2/ioctl_list.2:373
10335 #, no-wrap
10336 msgid "0x00005495\tPPPIOCSINPSIG\tconst int *\n"
10337 msgstr ""
10338
10339 #. type: tbl table
10340 #: build/C/man2/ioctl_list.2:374
10341 #, no-wrap
10342 msgid "0x00005497\tPPPIOCSDEBUG\tconst int *\n"
10343 msgstr ""
10344
10345 #. type: tbl table
10346 #: build/C/man2/ioctl_list.2:375
10347 #, no-wrap
10348 msgid "0x00005498\tPPPIOCGDEBUG\tint *\n"
10349 msgstr ""
10350
10351 #. type: tbl table
10352 #: build/C/man2/ioctl_list.2:376
10353 #, no-wrap
10354 msgid "0x00005499\tPPPIOCGSTAT\tstruct ppp_stats *\n"
10355 msgstr ""
10356
10357 #. type: tbl table
10358 #: build/C/man2/ioctl_list.2:377
10359 #, no-wrap
10360 msgid "0x0000549A\tPPPIOCGTIME\tstruct ppp_ddinfo *\n"
10361 msgstr ""
10362
10363 #. type: tbl table
10364 #: build/C/man2/ioctl_list.2:378
10365 #, no-wrap
10366 msgid "0x0000549B\tPPPIOCGXASYNCMAP\tstruct { int [8]; } *\n"
10367 msgstr ""
10368
10369 #. type: tbl table
10370 #: build/C/man2/ioctl_list.2:379
10371 #, no-wrap
10372 msgid "0x0000549C\tPPPIOCSXASYNCMAP\tconst struct { int [8]; } *\n"
10373 msgstr ""
10374
10375 #. type: tbl table
10376 #: build/C/man2/ioctl_list.2:380
10377 #, no-wrap
10378 msgid "0x0000549D\tPPPIOCSMRU\tconst int *\n"
10379 msgstr ""
10380
10381 #. type: tbl table
10382 #: build/C/man2/ioctl_list.2:381
10383 #, no-wrap
10384 msgid "0x0000549E\tPPPIOCRASYNCMAP\tconst int *\n"
10385 msgstr ""
10386
10387 #. type: tbl table
10388 #: build/C/man2/ioctl_list.2:382
10389 #, no-wrap
10390 msgid "0x0000549F\tPPPIOCSMAXCID\tconst int *\n"
10391 msgstr ""
10392
10393 #. type: Plain text
10394 #: build/C/man2/ioctl_list.2:386
10395 msgid "// E<lt>include/linux/ipx.hE<gt>"
10396 msgstr ""
10397
10398 #. type: tbl table
10399 #: build/C/man2/ioctl_list.2:388
10400 #, no-wrap
10401 msgid "0x000089E0\tSIOCAIPXITFCRT\tconst char *\n"
10402 msgstr ""
10403
10404 #. type: tbl table
10405 #: build/C/man2/ioctl_list.2:389
10406 #, no-wrap
10407 msgid "0x000089E1\tSIOCAIPXPRISLT\tconst char *\n"
10408 msgstr ""
10409
10410 #. type: tbl table
10411 #: build/C/man2/ioctl_list.2:390
10412 #, no-wrap
10413 msgid "0x000089E2\tSIOCIPXCFGDATA\tstruct ipx_config_data *\n"
10414 msgstr ""
10415
10416 #. type: Plain text
10417 #: build/C/man2/ioctl_list.2:394
10418 msgid "// E<lt>include/linux/kd.hE<gt>"
10419 msgstr ""
10420
10421 #. type: tbl table
10422 #: build/C/man2/ioctl_list.2:396
10423 #, no-wrap
10424 msgid "0x00004B60\tGIO_FONT\tstruct { char [8192]; } *\n"
10425 msgstr ""
10426
10427 #. type: tbl table
10428 #: build/C/man2/ioctl_list.2:397
10429 #, no-wrap
10430 msgid "0x00004B61\tPIO_FONT\tconst struct { char [8192]; } *\n"
10431 msgstr ""
10432
10433 #. type: tbl table
10434 #: build/C/man2/ioctl_list.2:401
10435 #, no-wrap
10436 msgid "0x00004B6B\tGIO_FONTX\tstruct console_font_desc *\t// MORE // I-O\n"
10437 msgstr ""
10438
10439 #. type: tbl table
10440 #: build/C/man2/ioctl_list.2:402
10441 #, no-wrap
10442 msgid "0x00004B6C\tPIO_FONTX\tconst struct console_font_desc *\t//MORE\n"
10443 msgstr ""
10444
10445 #. type: tbl table
10446 #: build/C/man2/ioctl_list.2:406
10447 #, no-wrap
10448 msgid "0x00004B70\tGIO_CMAP\tstruct { char [48]; } *\n"
10449 msgstr ""
10450
10451 #. type: tbl table
10452 #: build/C/man2/ioctl_list.2:407
10453 #, no-wrap
10454 msgid "0x00004B71\tPIO_CMAP\tconst struct { char [48]; }\n"
10455 msgstr ""
10456
10457 #. type: tbl table
10458 #: build/C/man2/ioctl_list.2:411
10459 #, no-wrap
10460 msgid "0x00004B2F\tKIOCSOUND\tint\n"
10461 msgstr ""
10462
10463 #. type: tbl table
10464 #: build/C/man2/ioctl_list.2:412
10465 #, no-wrap
10466 msgid "0x00004B30\tKDMKTONE\tint\n"
10467 msgstr ""
10468
10469 #. type: tbl table
10470 #: build/C/man2/ioctl_list.2:413
10471 #, no-wrap
10472 msgid "0x00004B31\tKDGETLED\tchar *\n"
10473 msgstr ""
10474
10475 #. type: tbl table
10476 #: build/C/man2/ioctl_list.2:414
10477 #, no-wrap
10478 msgid "0x00004B32\tKDSETLED\tint\n"
10479 msgstr ""
10480
10481 #. type: tbl table
10482 #: build/C/man2/ioctl_list.2:415
10483 #, no-wrap
10484 msgid "0x00004B33\tKDGKBTYPE\tchar *\n"
10485 msgstr ""
10486
10487 #. type: tbl table
10488 #: build/C/man2/ioctl_list.2:416
10489 #, no-wrap
10490 msgid "0x00004B34\tKDADDIO\tint\t// MORE\n"
10491 msgstr ""
10492
10493 #. type: tbl table
10494 #: build/C/man2/ioctl_list.2:417
10495 #, no-wrap
10496 msgid "0x00004B35\tKDDELIO\tint\t// MORE\n"
10497 msgstr ""
10498
10499 #. type: tbl table
10500 #: build/C/man2/ioctl_list.2:418
10501 #, no-wrap
10502 msgid "0x00004B36\tKDENABIO\tvoid\t// MORE\n"
10503 msgstr ""
10504
10505 #. type: tbl table
10506 #: build/C/man2/ioctl_list.2:419
10507 #, no-wrap
10508 msgid "0x00004B37\tKDDISABIO\tvoid\t// MORE\n"
10509 msgstr ""
10510
10511 #. type: tbl table
10512 #: build/C/man2/ioctl_list.2:420
10513 #, no-wrap
10514 msgid "0x00004B3A\tKDSETMODE\tint\n"
10515 msgstr ""
10516
10517 #. type: tbl table
10518 #: build/C/man2/ioctl_list.2:421
10519 #, no-wrap
10520 msgid "0x00004B3B\tKDGETMODE\tint *\n"
10521 msgstr ""
10522
10523 #. type: tbl table
10524 #: build/C/man2/ioctl_list.2:422
10525 #, no-wrap
10526 msgid "0x00004B3C\tKDMAPDISP\tvoid\t// MORE\n"
10527 msgstr ""
10528
10529 #. type: tbl table
10530 #: build/C/man2/ioctl_list.2:423
10531 #, no-wrap
10532 msgid "0x00004B3D\tKDUNMAPDISP\tvoid\t// MORE\n"
10533 msgstr ""
10534
10535 #. type: tbl table
10536 #: build/C/man2/ioctl_list.2:424
10537 #, no-wrap
10538 msgid "0x00004B40\tGIO_SCRNMAP\tstruct { char [E_TABSZ]; } *\n"
10539 msgstr ""
10540
10541 #. type: tbl table
10542 #: build/C/man2/ioctl_list.2:428
10543 #, no-wrap
10544 msgid "0x00004B41\tPIO_SCRNMAP\tconst struct { char [E_TABSZ]; } *\n"
10545 msgstr ""
10546
10547 #. type: tbl table
10548 #: build/C/man2/ioctl_list.2:429
10549 #, no-wrap
10550 msgid "0x00004B69\tGIO_UNISCRNMAP\tstruct { short [E_TABSZ]; } *\n"
10551 msgstr ""
10552
10553 #. type: tbl table
10554 #: build/C/man2/ioctl_list.2:430
10555 #, no-wrap
10556 msgid "0x00004B6A\tPIO_UNISCRNMAP\tconst struct { short [E_TABSZ]; } *\n"
10557 msgstr ""
10558
10559 #. type: tbl table
10560 #: build/C/man2/ioctl_list.2:434
10561 #, no-wrap
10562 msgid "0x00004B66\tGIO_UNIMAP\tstruct unimapdesc *\t// MORE // I-O\n"
10563 msgstr ""
10564
10565 #. type: tbl table
10566 #: build/C/man2/ioctl_list.2:435
10567 #, no-wrap
10568 msgid "0x00004B67\tPIO_UNIMAP\tconst struct unimapdesc *\t// MORE\n"
10569 msgstr ""
10570
10571 #. type: tbl table
10572 #: build/C/man2/ioctl_list.2:436
10573 #, no-wrap
10574 msgid "0x00004B68\tPIO_UNIMAPCLR\tconst struct unimapinit *\n"
10575 msgstr ""
10576
10577 #. type: tbl table
10578 #: build/C/man2/ioctl_list.2:437
10579 #, no-wrap
10580 msgid "0x00004B44\tKDGKBMODE\tint *\n"
10581 msgstr ""
10582
10583 #. type: tbl table
10584 #: build/C/man2/ioctl_list.2:438
10585 #, no-wrap
10586 msgid "0x00004B45\tKDSKBMODE\tint\n"
10587 msgstr ""
10588
10589 #. type: tbl table
10590 #: build/C/man2/ioctl_list.2:439
10591 #, no-wrap
10592 msgid "0x00004B62\tKDGKBMETA\tint *\n"
10593 msgstr ""
10594
10595 #. type: tbl table
10596 #: build/C/man2/ioctl_list.2:440
10597 #, no-wrap
10598 msgid "0x00004B63\tKDSKBMETA\tint\n"
10599 msgstr ""
10600
10601 #. type: tbl table
10602 #: build/C/man2/ioctl_list.2:441
10603 #, no-wrap
10604 msgid "0x00004B64\tKDGKBLED\tint *\n"
10605 msgstr ""
10606
10607 #. type: tbl table
10608 #: build/C/man2/ioctl_list.2:442
10609 #, no-wrap
10610 msgid "0x00004B65\tKDSKBLED\tint\n"
10611 msgstr ""
10612
10613 #. type: tbl table
10614 #: build/C/man2/ioctl_list.2:443
10615 #, no-wrap
10616 msgid "0x00004B46\tKDGKBENT\tstruct kbentry *\t// I-O\n"
10617 msgstr ""
10618
10619 #. type: tbl table
10620 #: build/C/man2/ioctl_list.2:444
10621 #, no-wrap
10622 msgid "0x00004B47\tKDSKBENT\tconst struct kbentry *\n"
10623 msgstr ""
10624
10625 #. type: tbl table
10626 #: build/C/man2/ioctl_list.2:445
10627 #, no-wrap
10628 msgid "0x00004B48\tKDGKBSENT\tstruct kbsentry *\t// I-O\n"
10629 msgstr ""
10630
10631 #. type: tbl table
10632 #: build/C/man2/ioctl_list.2:446
10633 #, no-wrap
10634 msgid "0x00004B49\tKDSKBSENT\tconst struct kbsentry *\n"
10635 msgstr ""
10636
10637 #. type: tbl table
10638 #: build/C/man2/ioctl_list.2:447
10639 #, no-wrap
10640 msgid "0x00004B4A\tKDGKBDIACR\tstruct kbdiacrs *\n"
10641 msgstr ""
10642
10643 #. type: tbl table
10644 #: build/C/man2/ioctl_list.2:448
10645 #, no-wrap
10646 msgid "0x00004B4B\tKDSKBDIACR\tconst struct kbdiacrs *\n"
10647 msgstr ""
10648
10649 #. type: tbl table
10650 #: build/C/man2/ioctl_list.2:449
10651 #, no-wrap
10652 msgid "0x00004B4C\tKDGETKEYCODE\tstruct kbkeycode *\t// I-O\n"
10653 msgstr ""
10654
10655 #. type: tbl table
10656 #: build/C/man2/ioctl_list.2:450
10657 #, no-wrap
10658 msgid "0x00004B4D\tKDSETKEYCODE\tconst struct kbkeycode *\n"
10659 msgstr ""
10660
10661 #. type: tbl table
10662 #: build/C/man2/ioctl_list.2:451
10663 #, no-wrap
10664 msgid "0x00004B4E\tKDSIGACCEPT\tint\n"
10665 msgstr ""
10666
10667 #. type: Plain text
10668 #: build/C/man2/ioctl_list.2:455
10669 msgid "// E<lt>include/linux/lp.hE<gt>"
10670 msgstr ""
10671
10672 #. type: tbl table
10673 #: build/C/man2/ioctl_list.2:457
10674 #, no-wrap
10675 msgid "0x00000601\tLPCHAR\tint\n"
10676 msgstr ""
10677
10678 #. type: tbl table
10679 #: build/C/man2/ioctl_list.2:458
10680 #, no-wrap
10681 msgid "0x00000602\tLPTIME\tint\n"
10682 msgstr ""
10683
10684 #. type: tbl table
10685 #: build/C/man2/ioctl_list.2:459
10686 #, no-wrap
10687 msgid "0x00000604\tLPABORT\tint\n"
10688 msgstr ""
10689
10690 #. type: tbl table
10691 #: build/C/man2/ioctl_list.2:460
10692 #, no-wrap
10693 msgid "0x00000605\tLPSETIRQ\tint\n"
10694 msgstr ""
10695
10696 #. type: tbl table
10697 #: build/C/man2/ioctl_list.2:461
10698 #, no-wrap
10699 msgid "0x00000606\tLPGETIRQ\tint *\n"
10700 msgstr ""
10701
10702 #. type: tbl table
10703 #: build/C/man2/ioctl_list.2:462
10704 #, no-wrap
10705 msgid "0x00000608\tLPWAIT\tint\n"
10706 msgstr ""
10707
10708 #. type: tbl table
10709 #: build/C/man2/ioctl_list.2:463
10710 #, no-wrap
10711 msgid "0x00000609\tLPCAREFUL\tint\n"
10712 msgstr ""
10713
10714 #. type: tbl table
10715 #: build/C/man2/ioctl_list.2:464
10716 #, no-wrap
10717 msgid "0x0000060A\tLPABORTOPEN\tint\n"
10718 msgstr ""
10719
10720 #. type: tbl table
10721 #: build/C/man2/ioctl_list.2:465
10722 #, no-wrap
10723 msgid "0x0000060B\tLPGETSTATUS\tint *\n"
10724 msgstr ""
10725
10726 #. type: tbl table
10727 #: build/C/man2/ioctl_list.2:466
10728 #, no-wrap
10729 msgid "0x0000060C\tLPRESET\tvoid\n"
10730 msgstr ""
10731
10732 #. type: tbl table
10733 #: build/C/man2/ioctl_list.2:467
10734 #, no-wrap
10735 msgid "0x0000060D\tLPGETSTATS\tstruct lp_stats *\n"
10736 msgstr ""
10737
10738 #. type: Plain text
10739 #: build/C/man2/ioctl_list.2:471
10740 msgid "// E<lt>include/linux/mroute.hE<gt>"
10741 msgstr ""
10742
10743 #. type: tbl table
10744 #: build/C/man2/ioctl_list.2:473
10745 #, no-wrap
10746 msgid "0x000089E0\tSIOCGETVIFCNT\tstruct sioc_vif_req *\t// I-O\n"
10747 msgstr ""
10748
10749 #. type: tbl table
10750 #: build/C/man2/ioctl_list.2:474
10751 #, no-wrap
10752 msgid "0x000089E1\tSIOCGETSGCNT\tstruct sioc_sg_req *\t// I-O\n"
10753 msgstr ""
10754
10755 #. type: Plain text
10756 #: build/C/man2/ioctl_list.2:478
10757 msgid "// E<lt>include/linux/mtio.hE<gt>"
10758 msgstr ""
10759
10760 #. type: tbl table
10761 #: build/C/man2/ioctl_list.2:480
10762 #, no-wrap
10763 msgid "0x40086D01\tMTIOCTOP\tconst struct mtop *\n"
10764 msgstr ""
10765
10766 #. type: tbl table
10767 #: build/C/man2/ioctl_list.2:481
10768 #, no-wrap
10769 msgid "0x801C6D02\tMTIOCGET\tstruct mtget *\n"
10770 msgstr ""
10771
10772 #. type: tbl table
10773 #: build/C/man2/ioctl_list.2:482
10774 #, no-wrap
10775 msgid "0x80046D03\tMTIOCPOS\tstruct mtpos *\n"
10776 msgstr ""
10777
10778 #. type: tbl table
10779 #: build/C/man2/ioctl_list.2:483
10780 #, no-wrap
10781 msgid "0x80206D04\tMTIOCGETCONFIG\tstruct mtconfiginfo *\n"
10782 msgstr ""
10783
10784 #. type: tbl table
10785 #: build/C/man2/ioctl_list.2:484
10786 #, no-wrap
10787 msgid "0x40206D05\tMTIOCSETCONFIG\tconst struct mtconfiginfo *\n"
10788 msgstr ""
10789
10790 #. type: Plain text
10791 #: build/C/man2/ioctl_list.2:488
10792 msgid "// E<lt>include/linux/netrom.hE<gt>"
10793 msgstr ""
10794
10795 #. type: tbl table
10796 #: build/C/man2/ioctl_list.2:490
10797 #, no-wrap
10798 msgid "0x000089E0\tSIOCNRGETPARMS\tstruct nr_parms_struct *\t// I-O\n"
10799 msgstr ""
10800
10801 #. type: tbl table
10802 #: build/C/man2/ioctl_list.2:491
10803 #, no-wrap
10804 msgid "0x000089E1\tSIOCNRSETPARMS\tconst struct nr_parms_struct *\n"
10805 msgstr ""
10806
10807 #. type: tbl table
10808 #: build/C/man2/ioctl_list.2:492
10809 #, no-wrap
10810 msgid "0x000089E2\tSIOCNRDECOBS\tvoid\n"
10811 msgstr ""
10812
10813 #. type: tbl table
10814 #: build/C/man2/ioctl_list.2:493
10815 #, no-wrap
10816 msgid "0x000089E3\tSIOCNRRTCTL\tconst int *\n"
10817 msgstr ""
10818
10819 #. type: Plain text
10820 #: build/C/man2/ioctl_list.2:497
10821 msgid "// E<lt>include/linux/sbpcd.hE<gt>"
10822 msgstr ""
10823
10824 #. type: tbl table
10825 #: build/C/man2/ioctl_list.2:499
10826 #, no-wrap
10827 msgid "0x00009000\tDDIOCSDBG\tconst int *\n"
10828 msgstr ""
10829
10830 #. type: tbl table
10831 #: build/C/man2/ioctl_list.2:500
10832 #, no-wrap
10833 msgid "0x00005382\tCDROMAUDIOBUFSIZ\tint\n"
10834 msgstr ""
10835
10836 #. type: Plain text
10837 #: build/C/man2/ioctl_list.2:504
10838 msgid "// E<lt>include/linux/scc.hE<gt>"
10839 msgstr ""
10840
10841 #. type: tbl table
10842 #: build/C/man2/ioctl_list.2:506
10843 #, no-wrap
10844 msgid "0x00005470\tTIOCSCCINI\tvoid\n"
10845 msgstr ""
10846
10847 #. type: tbl table
10848 #: build/C/man2/ioctl_list.2:507
10849 #, no-wrap
10850 msgid "0x00005471\tTIOCCHANINI\tconst struct scc_modem *\n"
10851 msgstr ""
10852
10853 #. type: tbl table
10854 #: build/C/man2/ioctl_list.2:508
10855 #, no-wrap
10856 msgid "0x00005472\tTIOCGKISS\tstruct ioctl_command *\t// I-O\n"
10857 msgstr ""
10858
10859 #. type: tbl table
10860 #: build/C/man2/ioctl_list.2:509
10861 #, no-wrap
10862 msgid "0x00005473\tTIOCSKISS\tconst struct ioctl_command *\n"
10863 msgstr ""
10864
10865 #. type: tbl table
10866 #: build/C/man2/ioctl_list.2:510
10867 #, no-wrap
10868 msgid "0x00005474\tTIOCSCCSTAT\tstruct scc_stat *\n"
10869 msgstr ""
10870
10871 #. type: Plain text
10872 #: build/C/man2/ioctl_list.2:514
10873 msgid "// E<lt>include/linux/scsi.hE<gt>"
10874 msgstr ""
10875
10876 #. type: tbl table
10877 #: build/C/man2/ioctl_list.2:516
10878 #, no-wrap
10879 msgid "0x00005382\tSCSI_IOCTL_GET_IDLUN\tstruct { int [2]; } *\n"
10880 msgstr ""
10881
10882 #. type: tbl table
10883 #: build/C/man2/ioctl_list.2:517
10884 #, no-wrap
10885 msgid "0x00005383\tSCSI_IOCTL_TAGGED_ENABLE\tvoid\n"
10886 msgstr ""
10887
10888 #. type: tbl table
10889 #: build/C/man2/ioctl_list.2:518
10890 #, no-wrap
10891 msgid "0x00005384\tSCSI_IOCTL_TAGGED_DISABLE\tvoid\n"
10892 msgstr ""
10893
10894 #. type: tbl table
10895 #: build/C/man2/ioctl_list.2:522
10896 #, no-wrap
10897 msgid "0x00005385\tSCSI_IOCTL_PROBE_HOST\tconst int *\t// MORE\n"
10898 msgstr ""
10899
10900 #. type: Plain text
10901 #: build/C/man2/ioctl_list.2:526
10902 msgid "// E<lt>include/linux/smb_fs.hE<gt>"
10903 msgstr ""
10904
10905 #. type: tbl table
10906 #: build/C/man2/ioctl_list.2:528
10907 #, no-wrap
10908 msgid "0x80027501\tSMB_IOC_GETMOUNTUID\tuid_t *\n"
10909 msgstr ""
10910
10911 #. type: Plain text
10912 #: build/C/man2/ioctl_list.2:532
10913 msgid "// E<lt>include/linux/sockios.hE<gt>"
10914 msgstr ""
10915
10916 #. type: tbl table
10917 #: build/C/man2/ioctl_list.2:534
10918 #, no-wrap
10919 msgid "0x0000890B\tSIOCADDRT\tconst struct rtentry *\t// MORE\n"
10920 msgstr ""
10921
10922 #. type: tbl table
10923 #: build/C/man2/ioctl_list.2:535
10924 #, no-wrap
10925 msgid "0x0000890C\tSIOCDELRT\tconst struct rtentry *\t// MORE\n"
10926 msgstr ""
10927
10928 #. type: tbl table
10929 #: build/C/man2/ioctl_list.2:536
10930 #, no-wrap
10931 msgid "0x00008910\tSIOCGIFNAME\tchar []\n"
10932 msgstr ""
10933
10934 #. type: tbl table
10935 #: build/C/man2/ioctl_list.2:537
10936 #, no-wrap
10937 msgid "0x00008911\tSIOCSIFLINK\tvoid\n"
10938 msgstr ""
10939
10940 #. type: tbl table
10941 #: build/C/man2/ioctl_list.2:538
10942 #, no-wrap
10943 msgid "0x00008912\tSIOCGIFCONF\tstruct ifconf *\t// MORE // I-O\n"
10944 msgstr ""
10945
10946 #. type: tbl table
10947 #: build/C/man2/ioctl_list.2:539
10948 #, no-wrap
10949 msgid "0x00008913\tSIOCGIFFLAGS\tstruct ifreq *\t// I-O\n"
10950 msgstr ""
10951
10952 #. type: tbl table
10953 #: build/C/man2/ioctl_list.2:540
10954 #, no-wrap
10955 msgid "0x00008914\tSIOCSIFFLAGS\tconst struct ifreq *\n"
10956 msgstr ""
10957
10958 #. type: tbl table
10959 #: build/C/man2/ioctl_list.2:541
10960 #, no-wrap
10961 msgid "0x00008915\tSIOCGIFADDR\tstruct ifreq *\t// I-O\n"
10962 msgstr ""
10963
10964 #. type: tbl table
10965 #: build/C/man2/ioctl_list.2:542
10966 #, no-wrap
10967 msgid "0x00008916\tSIOCSIFADDR\tconst struct ifreq *\n"
10968 msgstr ""
10969
10970 #. type: tbl table
10971 #: build/C/man2/ioctl_list.2:543
10972 #, no-wrap
10973 msgid "0x00008917\tSIOCGIFDSTADDR\tstruct ifreq *\t// I-O\n"
10974 msgstr ""
10975
10976 #. type: tbl table
10977 #: build/C/man2/ioctl_list.2:544
10978 #, no-wrap
10979 msgid "0x00008918\tSIOCSIFDSTADDR\tconst struct ifreq *\n"
10980 msgstr ""
10981
10982 #. type: tbl table
10983 #: build/C/man2/ioctl_list.2:545
10984 #, no-wrap
10985 msgid "0x00008919\tSIOCGIFBRDADDR\tstruct ifreq *\t// I-O\n"
10986 msgstr ""
10987
10988 #. type: tbl table
10989 #: build/C/man2/ioctl_list.2:546
10990 #, no-wrap
10991 msgid "0x0000891A\tSIOCSIFBRDADDR\tconst struct ifreq *\n"
10992 msgstr ""
10993
10994 #. type: tbl table
10995 #: build/C/man2/ioctl_list.2:547
10996 #, no-wrap
10997 msgid "0x0000891B\tSIOCGIFNETMASK\tstruct ifreq *\t// I-O\n"
10998 msgstr ""
10999
11000 #. type: tbl table
11001 #: build/C/man2/ioctl_list.2:548
11002 #, no-wrap
11003 msgid "0x0000891C\tSIOCSIFNETMASK\tconst struct ifreq *\n"
11004 msgstr ""
11005
11006 #. type: tbl table
11007 #: build/C/man2/ioctl_list.2:549
11008 #, no-wrap
11009 msgid "0x0000891D\tSIOCGIFMETRIC\tstruct ifreq *\t// I-O\n"
11010 msgstr ""
11011
11012 #. type: tbl table
11013 #: build/C/man2/ioctl_list.2:550
11014 #, no-wrap
11015 msgid "0x0000891E\tSIOCSIFMETRIC\tconst struct ifreq *\n"
11016 msgstr ""
11017
11018 #. type: tbl table
11019 #: build/C/man2/ioctl_list.2:551
11020 #, no-wrap
11021 msgid "0x0000891F\tSIOCGIFMEM\tstruct ifreq *\t// I-O\n"
11022 msgstr ""
11023
11024 #. type: tbl table
11025 #: build/C/man2/ioctl_list.2:552
11026 #, no-wrap
11027 msgid "0x00008920\tSIOCSIFMEM\tconst struct ifreq *\n"
11028 msgstr ""
11029
11030 #. type: tbl table
11031 #: build/C/man2/ioctl_list.2:553
11032 #, no-wrap
11033 msgid "0x00008921\tSIOCGIFMTU\tstruct ifreq *\t// I-O\n"
11034 msgstr ""
11035
11036 #. type: tbl table
11037 #: build/C/man2/ioctl_list.2:554
11038 #, no-wrap
11039 msgid "0x00008922\tSIOCSIFMTU\tconst struct ifreq *\n"
11040 msgstr ""
11041
11042 #. type: tbl table
11043 #: build/C/man2/ioctl_list.2:558
11044 #, no-wrap
11045 msgid "0x00008923\tOLD_SIOCGIFHWADDR\tstruct ifreq *\t// I-O\n"
11046 msgstr ""
11047
11048 #. type: tbl table
11049 #: build/C/man2/ioctl_list.2:559
11050 #, no-wrap
11051 msgid "0x00008924\tSIOCSIFHWADDR\tconst struct ifreq *\t// MORE\n"
11052 msgstr ""
11053
11054 #. type: tbl table
11055 #: build/C/man2/ioctl_list.2:560
11056 #, no-wrap
11057 msgid "0x00008925\tSIOCGIFENCAP\tint *\n"
11058 msgstr ""
11059
11060 #. type: tbl table
11061 #: build/C/man2/ioctl_list.2:561
11062 #, no-wrap
11063 msgid "0x00008926\tSIOCSIFENCAP\tconst int *\n"
11064 msgstr ""
11065
11066 #. type: tbl table
11067 #: build/C/man2/ioctl_list.2:562
11068 #, no-wrap
11069 msgid "0x00008927\tSIOCGIFHWADDR\tstruct ifreq *\t// I-O\n"
11070 msgstr ""
11071
11072 #. type: tbl table
11073 #: build/C/man2/ioctl_list.2:563
11074 #, no-wrap
11075 msgid "0x00008929\tSIOCGIFSLAVE\tvoid\n"
11076 msgstr ""
11077
11078 #. type: tbl table
11079 #: build/C/man2/ioctl_list.2:564
11080 #, no-wrap
11081 msgid "0x00008930\tSIOCSIFSLAVE\tvoid\n"
11082 msgstr ""
11083
11084 #. type: tbl table
11085 #: build/C/man2/ioctl_list.2:565
11086 #, no-wrap
11087 msgid "0x00008931\tSIOCADDMULTI\tconst struct ifreq *\n"
11088 msgstr ""
11089
11090 #. type: tbl table
11091 #: build/C/man2/ioctl_list.2:566
11092 #, no-wrap
11093 msgid "0x00008932\tSIOCDELMULTI\tconst struct ifreq *\n"
11094 msgstr ""
11095
11096 #. type: tbl table
11097 #: build/C/man2/ioctl_list.2:567
11098 #, no-wrap
11099 msgid "0x00008940\tSIOCADDRTOLD\tvoid\n"
11100 msgstr ""
11101
11102 #. type: tbl table
11103 #: build/C/man2/ioctl_list.2:568
11104 #, no-wrap
11105 msgid "0x00008941\tSIOCDELRTOLD\tvoid\n"
11106 msgstr ""
11107
11108 #. type: tbl table
11109 #: build/C/man2/ioctl_list.2:569
11110 #, no-wrap
11111 msgid "0x00008950\tSIOCDARP\tconst struct arpreq *\n"
11112 msgstr ""
11113
11114 #. type: tbl table
11115 #: build/C/man2/ioctl_list.2:570
11116 #, no-wrap
11117 msgid "0x00008951\tSIOCGARP\tstruct arpreq *\t// I-O\n"
11118 msgstr ""
11119
11120 #. type: tbl table
11121 #: build/C/man2/ioctl_list.2:571
11122 #, no-wrap
11123 msgid "0x00008952\tSIOCSARP\tconst struct arpreq *\n"
11124 msgstr ""
11125
11126 #. type: tbl table
11127 #: build/C/man2/ioctl_list.2:572
11128 #, no-wrap
11129 msgid "0x00008960\tSIOCDRARP\tconst struct arpreq *\n"
11130 msgstr ""
11131
11132 #. type: tbl table
11133 #: build/C/man2/ioctl_list.2:573
11134 #, no-wrap
11135 msgid "0x00008961\tSIOCGRARP\tstruct arpreq *\t// I-O\n"
11136 msgstr ""
11137
11138 #. type: tbl table
11139 #: build/C/man2/ioctl_list.2:574
11140 #, no-wrap
11141 msgid "0x00008962\tSIOCSRARP\tconst struct arpreq *\n"
11142 msgstr ""
11143
11144 #. type: tbl table
11145 #: build/C/man2/ioctl_list.2:575
11146 #, no-wrap
11147 msgid "0x00008970\tSIOCGIFMAP\tstruct ifreq *\t// I-O\n"
11148 msgstr ""
11149
11150 #. type: tbl table
11151 #: build/C/man2/ioctl_list.2:576
11152 #, no-wrap
11153 msgid "0x00008971\tSIOCSIFMAP\tconst struct ifreq *\n"
11154 msgstr ""
11155
11156 #. type: Plain text
11157 #: build/C/man2/ioctl_list.2:580
11158 msgid "// E<lt>include/linux/soundcard.hE<gt>"
11159 msgstr ""
11160
11161 #. type: tbl table
11162 #: build/C/man2/ioctl_list.2:582
11163 #, no-wrap
11164 msgid "0x00005100\tSNDCTL_SEQ_RESET\tvoid\n"
11165 msgstr ""
11166
11167 #. type: tbl table
11168 #: build/C/man2/ioctl_list.2:583
11169 #, no-wrap
11170 msgid "0x00005101\tSNDCTL_SEQ_SYNC\tvoid\n"
11171 msgstr ""
11172
11173 #. type: tbl table
11174 #: build/C/man2/ioctl_list.2:587
11175 #, no-wrap
11176 msgid "0xC08C5102\tSNDCTL_SYNTH_INFO\tstruct synth_info *\t// I-O\n"
11177 msgstr ""
11178
11179 #. type: tbl table
11180 #: build/C/man2/ioctl_list.2:588
11181 #, no-wrap
11182 msgid "0xC0045103\tSNDCTL_SEQ_CTRLRATE\tint *\t// I-O\n"
11183 msgstr ""
11184
11185 #. type: tbl table
11186 #: build/C/man2/ioctl_list.2:589
11187 #, no-wrap
11188 msgid "0x80045104\tSNDCTL_SEQ_GETOUTCOUNT\tint *\n"
11189 msgstr ""
11190
11191 #. type: tbl table
11192 #: build/C/man2/ioctl_list.2:590
11193 #, no-wrap
11194 msgid "0x80045105\tSNDCTL_SEQ_GETINCOUNT\tint *\n"
11195 msgstr ""
11196
11197 #. type: tbl table
11198 #: build/C/man2/ioctl_list.2:591
11199 #, no-wrap
11200 msgid "0x40045106\tSNDCTL_SEQ_PERCMODE\tvoid\n"
11201 msgstr ""
11202
11203 #. type: tbl table
11204 #: build/C/man2/ioctl_list.2:595
11205 #, no-wrap
11206 msgid "0x40285107\tSNDCTL_FM_LOAD_INSTR\tconst struct sbi_instrument *\n"
11207 msgstr ""
11208
11209 #. type: tbl table
11210 #: build/C/man2/ioctl_list.2:599
11211 #, no-wrap
11212 msgid "0x40045108\tSNDCTL_SEQ_TESTMIDI\tconst int *\n"
11213 msgstr ""
11214
11215 #. type: tbl table
11216 #: build/C/man2/ioctl_list.2:600
11217 #, no-wrap
11218 msgid "0x40045109\tSNDCTL_SEQ_RESETSAMPLES\tconst int *\n"
11219 msgstr ""
11220
11221 #. type: tbl table
11222 #: build/C/man2/ioctl_list.2:601
11223 #, no-wrap
11224 msgid "0x8004510A\tSNDCTL_SEQ_NRSYNTHS\tint *\n"
11225 msgstr ""
11226
11227 #. type: tbl table
11228 #: build/C/man2/ioctl_list.2:602
11229 #, no-wrap
11230 msgid "0x8004510B\tSNDCTL_SEQ_NRMIDIS\tint *\n"
11231 msgstr ""
11232
11233 #. type: tbl table
11234 #: build/C/man2/ioctl_list.2:603
11235 #, no-wrap
11236 msgid "0xC074510C\tSNDCTL_MIDI_INFO\tstruct midi_info *\t// I-O\n"
11237 msgstr ""
11238
11239 #. type: tbl table
11240 #: build/C/man2/ioctl_list.2:604
11241 #, no-wrap
11242 msgid "0x4004510D\tSNDCTL_SEQ_THRESHOLD\tconst int *\n"
11243 msgstr ""
11244
11245 #. type: tbl table
11246 #: build/C/man2/ioctl_list.2:605
11247 #, no-wrap
11248 msgid "0xC004510E\tSNDCTL_SYNTH_MEMAVL\tint *\t// I-O\n"
11249 msgstr ""
11250
11251 #. type: tbl table
11252 #: build/C/man2/ioctl_list.2:606
11253 #, no-wrap
11254 msgid "0x4004510F\tSNDCTL_FM_4OP_ENABLE\tconst int *\n"
11255 msgstr ""
11256
11257 #. type: tbl table
11258 #: build/C/man2/ioctl_list.2:607
11259 #, no-wrap
11260 msgid "0xCFB85110\tSNDCTL_PMGR_ACCESS\tstruct patmgr_info *\t// I-O\n"
11261 msgstr ""
11262
11263 #. type: tbl table
11264 #: build/C/man2/ioctl_list.2:608
11265 #, no-wrap
11266 msgid "0x00005111\tSNDCTL_SEQ_PANIC\tvoid\n"
11267 msgstr ""
11268
11269 #. type: tbl table
11270 #: build/C/man2/ioctl_list.2:612
11271 #, no-wrap
11272 msgid "0x40085112\tSNDCTL_SEQ_OUTOFBAND\tconst struct seq_event_rec *\n"
11273 msgstr ""
11274
11275 #. type: tbl table
11276 #: build/C/man2/ioctl_list.2:616
11277 #, no-wrap
11278 msgid "0xC0045401\tSNDCTL_TMR_TIMEBASE\tint *\t// I-O\n"
11279 msgstr ""
11280
11281 #. type: tbl table
11282 #: build/C/man2/ioctl_list.2:617
11283 #, no-wrap
11284 msgid "0x00005402\tSNDCTL_TMR_START\tvoid\n"
11285 msgstr ""
11286
11287 #. type: tbl table
11288 #: build/C/man2/ioctl_list.2:618
11289 #, no-wrap
11290 msgid "0x00005403\tSNDCTL_TMR_STOP\tvoid\n"
11291 msgstr ""
11292
11293 #. type: tbl table
11294 #: build/C/man2/ioctl_list.2:619
11295 #, no-wrap
11296 msgid "0x00005404\tSNDCTL_TMR_CONTINUE\tvoid\n"
11297 msgstr ""
11298
11299 #. type: tbl table
11300 #: build/C/man2/ioctl_list.2:620
11301 #, no-wrap
11302 msgid "0xC0045405\tSNDCTL_TMR_TEMPO\tint *\t// I-O\n"
11303 msgstr ""
11304
11305 #. type: tbl table
11306 #: build/C/man2/ioctl_list.2:621
11307 #, no-wrap
11308 msgid "0xC0045406\tSNDCTL_TMR_SOURCE\tint *\t// I-O\n"
11309 msgstr ""
11310
11311 #. type: tbl table
11312 #: build/C/man2/ioctl_list.2:622
11313 #, no-wrap
11314 msgid "0x40045407\tSNDCTL_TMR_METRONOME\tconst int *\n"
11315 msgstr ""
11316
11317 #. type: tbl table
11318 #: build/C/man2/ioctl_list.2:623
11319 #, no-wrap
11320 msgid "0x40045408\tSNDCTL_TMR_SELECT\tint *\t// I-O\n"
11321 msgstr ""
11322
11323 #. type: tbl table
11324 #: build/C/man2/ioctl_list.2:624
11325 #, no-wrap
11326 msgid "0xCFB85001\tSNDCTL_PMGR_IFACE\tstruct patmgr_info *\t// I-O\n"
11327 msgstr ""
11328
11329 #. type: tbl table
11330 #: build/C/man2/ioctl_list.2:625
11331 #, no-wrap
11332 msgid "0xC0046D00\tSNDCTL_MIDI_PRETIME\tint *\t// I-O\n"
11333 msgstr ""
11334
11335 #. type: tbl table
11336 #: build/C/man2/ioctl_list.2:626
11337 #, no-wrap
11338 msgid "0xC0046D01\tSNDCTL_MIDI_MPUMODE\tconst int *\n"
11339 msgstr ""
11340
11341 #. type: tbl table
11342 #: build/C/man2/ioctl_list.2:630
11343 #, no-wrap
11344 msgid "0xC0216D02\tSNDCTL_MIDI_MPUCMD\tstruct mpu_command_rec *\t// I-O\n"
11345 msgstr ""
11346
11347 #. type: tbl table
11348 #: build/C/man2/ioctl_list.2:634
11349 #, no-wrap
11350 msgid "0x00005000\tSNDCTL_DSP_RESET\tvoid\n"
11351 msgstr ""
11352
11353 #. type: tbl table
11354 #: build/C/man2/ioctl_list.2:635
11355 #, no-wrap
11356 msgid "0x00005001\tSNDCTL_DSP_SYNC\tvoid\n"
11357 msgstr ""
11358
11359 #. type: tbl table
11360 #: build/C/man2/ioctl_list.2:636
11361 #, no-wrap
11362 msgid "0xC0045002\tSNDCTL_DSP_SPEED\tint *\t// I-O\n"
11363 msgstr ""
11364
11365 #. type: tbl table
11366 #: build/C/man2/ioctl_list.2:637
11367 #, no-wrap
11368 msgid "0xC0045003\tSNDCTL_DSP_STEREO\tint *\t// I-O\n"
11369 msgstr ""
11370
11371 #. type: tbl table
11372 #: build/C/man2/ioctl_list.2:638
11373 #, no-wrap
11374 msgid "0xC0045004\tSNDCTL_DSP_GETBLKSIZE\tint *\t// I-O\n"
11375 msgstr ""
11376
11377 #. type: tbl table
11378 #: build/C/man2/ioctl_list.2:639
11379 #, no-wrap
11380 msgid "0xC0045006\tSOUND_PCM_WRITE_CHANNELS\tint *\t// I-O\n"
11381 msgstr ""
11382
11383 #. type: tbl table
11384 #: build/C/man2/ioctl_list.2:640
11385 #, no-wrap
11386 msgid "0xC0045007\tSOUND_PCM_WRITE_FILTER\tint *\t// I-O\n"
11387 msgstr ""
11388
11389 #. type: tbl table
11390 #: build/C/man2/ioctl_list.2:641
11391 #, no-wrap
11392 msgid "0x00005008\tSNDCTL_DSP_POST\tvoid\n"
11393 msgstr ""
11394
11395 #. type: tbl table
11396 #: build/C/man2/ioctl_list.2:642
11397 #, no-wrap
11398 msgid "0xC0045009\tSNDCTL_DSP_SUBDIVIDE\tint *\t// I-O\n"
11399 msgstr ""
11400
11401 #. type: tbl table
11402 #: build/C/man2/ioctl_list.2:643
11403 #, no-wrap
11404 msgid "0xC004500A\tSNDCTL_DSP_SETFRAGMENT\tint *\t// I-O\n"
11405 msgstr ""
11406
11407 #. type: tbl table
11408 #: build/C/man2/ioctl_list.2:644
11409 #, no-wrap
11410 msgid "0x8004500B\tSNDCTL_DSP_GETFMTS\tint *\n"
11411 msgstr ""
11412
11413 #. type: tbl table
11414 #: build/C/man2/ioctl_list.2:645
11415 #, no-wrap
11416 msgid "0xC0045005\tSNDCTL_DSP_SETFMT\tint *\t// I-O\n"
11417 msgstr ""
11418
11419 #. type: tbl table
11420 #: build/C/man2/ioctl_list.2:649
11421 #, no-wrap
11422 msgid "0x800C500C\tSNDCTL_DSP_GETOSPACE\tstruct audio_buf_info *\n"
11423 msgstr ""
11424
11425 #. type: tbl table
11426 #: build/C/man2/ioctl_list.2:650
11427 #, no-wrap
11428 msgid "0x800C500D\tSNDCTL_DSP_GETISPACE\tstruct audio_buf_info *\n"
11429 msgstr ""
11430
11431 #. type: tbl table
11432 #: build/C/man2/ioctl_list.2:651
11433 #, no-wrap
11434 msgid "0x0000500E\tSNDCTL_DSP_NONBLOCK\tvoid\n"
11435 msgstr ""
11436
11437 #. type: tbl table
11438 #: build/C/man2/ioctl_list.2:652
11439 #, no-wrap
11440 msgid "0x80045002\tSOUND_PCM_READ_RATE\tint *\n"
11441 msgstr ""
11442
11443 #. type: tbl table
11444 #: build/C/man2/ioctl_list.2:653
11445 #, no-wrap
11446 msgid "0x80045006\tSOUND_PCM_READ_CHANNELS\tint *\n"
11447 msgstr ""
11448
11449 #. type: tbl table
11450 #: build/C/man2/ioctl_list.2:654
11451 #, no-wrap
11452 msgid "0x80045005\tSOUND_PCM_READ_BITS\tint *\n"
11453 msgstr ""
11454
11455 #. type: tbl table
11456 #: build/C/man2/ioctl_list.2:655
11457 #, no-wrap
11458 msgid "0x80045007\tSOUND_PCM_READ_FILTER\tint *\n"
11459 msgstr ""
11460
11461 #. type: tbl table
11462 #: build/C/man2/ioctl_list.2:656
11463 #, no-wrap
11464 msgid "0x00004300\tSNDCTL_COPR_RESET\tvoid\n"
11465 msgstr ""
11466
11467 #. type: tbl table
11468 #: build/C/man2/ioctl_list.2:657
11469 #, no-wrap
11470 msgid "0xCFB04301\tSNDCTL_COPR_LOAD\tconst struct copr_buffer *\n"
11471 msgstr ""
11472
11473 #. type: tbl table
11474 #: build/C/man2/ioctl_list.2:661
11475 #, no-wrap
11476 msgid "0xC0144302\tSNDCTL_COPR_RDATA\tstruct copr_debug_buf *\t// I-O\n"
11477 msgstr ""
11478
11479 #. type: tbl table
11480 #: build/C/man2/ioctl_list.2:662
11481 #, no-wrap
11482 msgid "0xC0144303\tSNDCTL_COPR_RCODE\tstruct copr_debug_buf *\t// I-O\n"
11483 msgstr ""
11484
11485 #. type: tbl table
11486 #: build/C/man2/ioctl_list.2:666
11487 #, no-wrap
11488 msgid "0x40144304\tSNDCTL_COPR_WDATA\tconst struct copr_debug_buf *\n"
11489 msgstr ""
11490
11491 #. type: tbl table
11492 #: build/C/man2/ioctl_list.2:667
11493 #, no-wrap
11494 msgid "0x40144305\tSNDCTL_COPR_WCODE\tconst struct copr_debug_buf *\n"
11495 msgstr ""
11496
11497 #. type: tbl table
11498 #: build/C/man2/ioctl_list.2:671
11499 #, no-wrap
11500 msgid "0xC0144306\tSNDCTL_COPR_RUN\tstruct copr_debug_buf *\t// I-O\n"
11501 msgstr ""
11502
11503 #. type: tbl table
11504 #: build/C/man2/ioctl_list.2:672
11505 #, no-wrap
11506 msgid "0xC0144307\tSNDCTL_COPR_HALT\tstruct copr_debug_buf *\t// I-O\n"
11507 msgstr ""
11508
11509 #. type: tbl table
11510 #: build/C/man2/ioctl_list.2:676
11511 #, no-wrap
11512 msgid "0x4FA44308\tSNDCTL_COPR_SENDMSG\tconst struct copr_msg *\n"
11513 msgstr ""
11514
11515 #. type: tbl table
11516 #: build/C/man2/ioctl_list.2:677
11517 #, no-wrap
11518 msgid "0x8FA44309\tSNDCTL_COPR_RCVMSG\tstruct copr_msg *\n"
11519 msgstr ""
11520
11521 #. type: tbl table
11522 #: build/C/man2/ioctl_list.2:678
11523 #, no-wrap
11524 msgid "0x80044D00\tSOUND_MIXER_READ_VOLUME\tint *\n"
11525 msgstr ""
11526
11527 #. type: tbl table
11528 #: build/C/man2/ioctl_list.2:679
11529 #, no-wrap
11530 msgid "0x80044D01\tSOUND_MIXER_READ_BASS\tint *\n"
11531 msgstr ""
11532
11533 #. type: tbl table
11534 #: build/C/man2/ioctl_list.2:680
11535 #, no-wrap
11536 msgid "0x80044D02\tSOUND_MIXER_READ_TREBLE\tint *\n"
11537 msgstr ""
11538
11539 #. type: tbl table
11540 #: build/C/man2/ioctl_list.2:681
11541 #, no-wrap
11542 msgid "0x80044D03\tSOUND_MIXER_READ_SYNTH\tint *\n"
11543 msgstr ""
11544
11545 #. type: tbl table
11546 #: build/C/man2/ioctl_list.2:682
11547 #, no-wrap
11548 msgid "0x80044D04\tSOUND_MIXER_READ_PCM\tint *\n"
11549 msgstr ""
11550
11551 #. type: tbl table
11552 #: build/C/man2/ioctl_list.2:683
11553 #, no-wrap
11554 msgid "0x80044D05\tSOUND_MIXER_READ_SPEAKER\tint *\n"
11555 msgstr ""
11556
11557 #. type: tbl table
11558 #: build/C/man2/ioctl_list.2:684
11559 #, no-wrap
11560 msgid "0x80044D06\tSOUND_MIXER_READ_LINE\tint *\n"
11561 msgstr ""
11562
11563 #. type: tbl table
11564 #: build/C/man2/ioctl_list.2:685
11565 #, no-wrap
11566 msgid "0x80044D07\tSOUND_MIXER_READ_MIC\tint *\n"
11567 msgstr ""
11568
11569 #. type: tbl table
11570 #: build/C/man2/ioctl_list.2:686
11571 #, no-wrap
11572 msgid "0x80044D08\tSOUND_MIXER_READ_CD\tint *\n"
11573 msgstr ""
11574
11575 #. type: tbl table
11576 #: build/C/man2/ioctl_list.2:687
11577 #, no-wrap
11578 msgid "0x80044D09\tSOUND_MIXER_READ_IMIX\tint *\n"
11579 msgstr ""
11580
11581 #. type: tbl table
11582 #: build/C/man2/ioctl_list.2:688
11583 #, no-wrap
11584 msgid "0x80044D0A\tSOUND_MIXER_READ_ALTPCM\tint *\n"
11585 msgstr ""
11586
11587 #. type: tbl table
11588 #: build/C/man2/ioctl_list.2:689
11589 #, no-wrap
11590 msgid "0x80044D0B\tSOUND_MIXER_READ_RECLEV\tint *\n"
11591 msgstr ""
11592
11593 #. type: tbl table
11594 #: build/C/man2/ioctl_list.2:690
11595 #, no-wrap
11596 msgid "0x80044D0C\tSOUND_MIXER_READ_IGAIN\tint *\n"
11597 msgstr ""
11598
11599 #. type: tbl table
11600 #: build/C/man2/ioctl_list.2:691
11601 #, no-wrap
11602 msgid "0x80044D0D\tSOUND_MIXER_READ_OGAIN\tint *\n"
11603 msgstr ""
11604
11605 #. type: tbl table
11606 #: build/C/man2/ioctl_list.2:692
11607 #, no-wrap
11608 msgid "0x80044D0E\tSOUND_MIXER_READ_LINE1\tint *\n"
11609 msgstr ""
11610
11611 #. type: tbl table
11612 #: build/C/man2/ioctl_list.2:693
11613 #, no-wrap
11614 msgid "0x80044D0F\tSOUND_MIXER_READ_LINE2\tint *\n"
11615 msgstr ""
11616
11617 #. type: tbl table
11618 #: build/C/man2/ioctl_list.2:694
11619 #, no-wrap
11620 msgid "0x80044D10\tSOUND_MIXER_READ_LINE3\tint *\n"
11621 msgstr ""
11622
11623 #. type: tbl table
11624 #: build/C/man2/ioctl_list.2:695
11625 #, no-wrap
11626 msgid "0x80044D1C\tSOUND_MIXER_READ_MUTE\tint *\n"
11627 msgstr ""
11628
11629 #. type: tbl table
11630 #: build/C/man2/ioctl_list.2:696
11631 #, no-wrap
11632 msgid "0x80044D1D\tSOUND_MIXER_READ_ENHANCE\tint *\n"
11633 msgstr ""
11634
11635 #. type: tbl table
11636 #: build/C/man2/ioctl_list.2:697
11637 #, no-wrap
11638 msgid "0x80044D1E\tSOUND_MIXER_READ_LOUD\tint *\n"
11639 msgstr ""
11640
11641 #. type: tbl table
11642 #: build/C/man2/ioctl_list.2:698
11643 #, no-wrap
11644 msgid "0x80044DFF\tSOUND_MIXER_READ_RECSRC\tint *\n"
11645 msgstr ""
11646
11647 #. type: tbl table
11648 #: build/C/man2/ioctl_list.2:699
11649 #, no-wrap
11650 msgid "0x80044DFE\tSOUND_MIXER_READ_DEVMASK\tint *\n"
11651 msgstr ""
11652
11653 #. type: tbl table
11654 #: build/C/man2/ioctl_list.2:700
11655 #, no-wrap
11656 msgid "0x80044DFD\tSOUND_MIXER_READ_RECMASK\tint *\n"
11657 msgstr ""
11658
11659 #. type: tbl table
11660 #: build/C/man2/ioctl_list.2:701
11661 #, no-wrap
11662 msgid "0x80044DFB\tSOUND_MIXER_READ_STEREODEVS\tint *\n"
11663 msgstr ""
11664
11665 #. type: tbl table
11666 #: build/C/man2/ioctl_list.2:702
11667 #, no-wrap
11668 msgid "0x80044DFC\tSOUND_MIXER_READ_CAPS\tint *\n"
11669 msgstr ""
11670
11671 #. type: tbl table
11672 #: build/C/man2/ioctl_list.2:706
11673 #, no-wrap
11674 msgid "0xC0044D00\tSOUND_MIXER_WRITE_VOLUME\tint *\t// I-O\n"
11675 msgstr ""
11676
11677 #. type: tbl table
11678 #: build/C/man2/ioctl_list.2:707
11679 #, no-wrap
11680 msgid "0xC0044D01\tSOUND_MIXER_WRITE_BASS\tint *\t// I-O\n"
11681 msgstr ""
11682
11683 #. type: tbl table
11684 #: build/C/man2/ioctl_list.2:708
11685 #, no-wrap
11686 msgid "0xC0044D02\tSOUND_MIXER_WRITE_TREBLE\tint *\t// I-O\n"
11687 msgstr ""
11688
11689 #. type: tbl table
11690 #: build/C/man2/ioctl_list.2:709
11691 #, no-wrap
11692 msgid "0xC0044D03\tSOUND_MIXER_WRITE_SYNTH\tint *\t// I-O\n"
11693 msgstr ""
11694
11695 #. type: tbl table
11696 #: build/C/man2/ioctl_list.2:710
11697 #, no-wrap
11698 msgid "0xC0044D04\tSOUND_MIXER_WRITE_PCM\tint *\t// I-O\n"
11699 msgstr ""
11700
11701 #. type: tbl table
11702 #: build/C/man2/ioctl_list.2:711
11703 #, no-wrap
11704 msgid "0xC0044D05\tSOUND_MIXER_WRITE_SPEAKER\tint *\t// I-O\n"
11705 msgstr ""
11706
11707 #. type: tbl table
11708 #: build/C/man2/ioctl_list.2:712
11709 #, no-wrap
11710 msgid "0xC0044D06\tSOUND_MIXER_WRITE_LINE\tint *\t// I-O\n"
11711 msgstr ""
11712
11713 #. type: tbl table
11714 #: build/C/man2/ioctl_list.2:713
11715 #, no-wrap
11716 msgid "0xC0044D07\tSOUND_MIXER_WRITE_MIC\tint *\t// I-O\n"
11717 msgstr ""
11718
11719 #. type: tbl table
11720 #: build/C/man2/ioctl_list.2:714
11721 #, no-wrap
11722 msgid "0xC0044D08\tSOUND_MIXER_WRITE_CD\tint *\t// I-O\n"
11723 msgstr ""
11724
11725 #. type: tbl table
11726 #: build/C/man2/ioctl_list.2:715
11727 #, no-wrap
11728 msgid "0xC0044D09\tSOUND_MIXER_WRITE_IMIX\tint *\t// I-O\n"
11729 msgstr ""
11730
11731 #. type: tbl table
11732 #: build/C/man2/ioctl_list.2:716
11733 #, no-wrap
11734 msgid "0xC0044D0A\tSOUND_MIXER_WRITE_ALTPCM\tint *\t// I-O\n"
11735 msgstr ""
11736
11737 #. type: tbl table
11738 #: build/C/man2/ioctl_list.2:717
11739 #, no-wrap
11740 msgid "0xC0044D0B\tSOUND_MIXER_WRITE_RECLEV\tint *\t// I-O\n"
11741 msgstr ""
11742
11743 #. type: tbl table
11744 #: build/C/man2/ioctl_list.2:718
11745 #, no-wrap
11746 msgid "0xC0044D0C\tSOUND_MIXER_WRITE_IGAIN\tint *\t// I-O\n"
11747 msgstr ""
11748
11749 #. type: tbl table
11750 #: build/C/man2/ioctl_list.2:719
11751 #, no-wrap
11752 msgid "0xC0044D0D\tSOUND_MIXER_WRITE_OGAIN\tint *\t// I-O\n"
11753 msgstr ""
11754
11755 #. type: tbl table
11756 #: build/C/man2/ioctl_list.2:720
11757 #, no-wrap
11758 msgid "0xC0044D0E\tSOUND_MIXER_WRITE_LINE1\tint *\t// I-O\n"
11759 msgstr ""
11760
11761 #. type: tbl table
11762 #: build/C/man2/ioctl_list.2:721
11763 #, no-wrap
11764 msgid "0xC0044D0F\tSOUND_MIXER_WRITE_LINE2\tint *\t// I-O\n"
11765 msgstr ""
11766
11767 #. type: tbl table
11768 #: build/C/man2/ioctl_list.2:722
11769 #, no-wrap
11770 msgid "0xC0044D10\tSOUND_MIXER_WRITE_LINE3\tint *\t// I-O\n"
11771 msgstr ""
11772
11773 #. type: tbl table
11774 #: build/C/man2/ioctl_list.2:723
11775 #, no-wrap
11776 msgid "0xC0044D1C\tSOUND_MIXER_WRITE_MUTE\tint *\t// I-O\n"
11777 msgstr ""
11778
11779 #. type: tbl table
11780 #: build/C/man2/ioctl_list.2:724
11781 #, no-wrap
11782 msgid "0xC0044D1D\tSOUND_MIXER_WRITE_ENHANCE\tint *\t// I-O\n"
11783 msgstr ""
11784
11785 #. type: tbl table
11786 #: build/C/man2/ioctl_list.2:725
11787 #, no-wrap
11788 msgid "0xC0044D1E\tSOUND_MIXER_WRITE_LOUD\tint *\t// I-O\n"
11789 msgstr ""
11790
11791 #. type: tbl table
11792 #: build/C/man2/ioctl_list.2:726
11793 #, no-wrap
11794 msgid "0xC0044DFF\tSOUND_MIXER_WRITE_RECSRC\tint *\t// I-O\n"
11795 msgstr ""
11796
11797 #. type: Plain text
11798 #: build/C/man2/ioctl_list.2:730
11799 msgid "// E<lt>include/linux/umsdos_fs.hE<gt>"
11800 msgstr ""
11801
11802 #. type: tbl table
11803 #: build/C/man2/ioctl_list.2:732
11804 #, no-wrap
11805 msgid "0x000004D2\tUMSDOS_READDIR_DOS\tstruct umsdos_ioctl *\t// I-O\n"
11806 msgstr ""
11807
11808 #. type: tbl table
11809 #: build/C/man2/ioctl_list.2:733
11810 #, no-wrap
11811 msgid "0x000004D3\tUMSDOS_UNLINK_DOS\tconst struct umsdos_ioctl *\n"
11812 msgstr ""
11813
11814 #. type: tbl table
11815 #: build/C/man2/ioctl_list.2:734
11816 #, no-wrap
11817 msgid "0x000004D4\tUMSDOS_RMDIR_DOS\tconst struct umsdos_ioctl *\n"
11818 msgstr ""
11819
11820 #. type: tbl table
11821 #: build/C/man2/ioctl_list.2:735
11822 #, no-wrap
11823 msgid "0x000004D5\tUMSDOS_STAT_DOS\tstruct umsdos_ioctl *\t// I-O\n"
11824 msgstr ""
11825
11826 #. type: tbl table
11827 #: build/C/man2/ioctl_list.2:736
11828 #, no-wrap
11829 msgid "0x000004D6\tUMSDOS_CREAT_EMD\tconst struct umsdos_ioctl *\n"
11830 msgstr ""
11831
11832 #. type: tbl table
11833 #: build/C/man2/ioctl_list.2:737
11834 #, no-wrap
11835 msgid "0x000004D7\tUMSDOS_UNLINK_EMD\tconst struct umsdos_ioctl *\n"
11836 msgstr ""
11837
11838 #. type: tbl table
11839 #: build/C/man2/ioctl_list.2:738
11840 #, no-wrap
11841 msgid "0x000004D8\tUMSDOS_READDIR_EMD\tstruct umsdos_ioctl *\t// I-O\n"
11842 msgstr ""
11843
11844 #. type: tbl table
11845 #: build/C/man2/ioctl_list.2:739
11846 #, no-wrap
11847 msgid "0x000004D9\tUMSDOS_GETVERSION\tstruct umsdos_ioctl *\n"
11848 msgstr ""
11849
11850 #. type: tbl table
11851 #: build/C/man2/ioctl_list.2:740
11852 #, no-wrap
11853 msgid "0x000004DA\tUMSDOS_INIT_EMD\tvoid\n"
11854 msgstr ""
11855
11856 #. type: tbl table
11857 #: build/C/man2/ioctl_list.2:741
11858 #, no-wrap
11859 msgid "0x000004DB\tUMSDOS_DOS_SETUP\tconst struct umsdos_ioctl *\n"
11860 msgstr ""
11861
11862 #. type: tbl table
11863 #: build/C/man2/ioctl_list.2:742
11864 #, no-wrap
11865 msgid "0x000004DC\tUMSDOS_RENAME_DOS\tconst struct umsdos_ioctl *\n"
11866 msgstr ""
11867
11868 #. type: Plain text
11869 #: build/C/man2/ioctl_list.2:746
11870 msgid "// E<lt>include/linux/vt.hE<gt>"
11871 msgstr ""
11872
11873 #. type: tbl table
11874 #: build/C/man2/ioctl_list.2:748
11875 #, no-wrap
11876 msgid "0x00005600\tVT_OPENQRY\tint *\n"
11877 msgstr ""
11878
11879 #. type: tbl table
11880 #: build/C/man2/ioctl_list.2:749
11881 #, no-wrap
11882 msgid "0x00005601\tVT_GETMODE\tstruct vt_mode *\n"
11883 msgstr ""
11884
11885 #. type: tbl table
11886 #: build/C/man2/ioctl_list.2:750
11887 #, no-wrap
11888 msgid "0x00005602\tVT_SETMODE\tconst struct vt_mode *\n"
11889 msgstr ""
11890
11891 #. type: tbl table
11892 #: build/C/man2/ioctl_list.2:751
11893 #, no-wrap
11894 msgid "0x00005603\tVT_GETSTATE\tstruct vt_stat *\n"
11895 msgstr ""
11896
11897 #. type: tbl table
11898 #: build/C/man2/ioctl_list.2:752
11899 #, no-wrap
11900 msgid "0x00005604\tVT_SENDSIG\tvoid\n"
11901 msgstr ""
11902
11903 #. type: tbl table
11904 #: build/C/man2/ioctl_list.2:753
11905 #, no-wrap
11906 msgid "0x00005605\tVT_RELDISP\tint\n"
11907 msgstr ""
11908
11909 #. type: tbl table
11910 #: build/C/man2/ioctl_list.2:754
11911 #, no-wrap
11912 msgid "0x00005606\tVT_ACTIVATE\tint\n"
11913 msgstr ""
11914
11915 #. type: tbl table
11916 #: build/C/man2/ioctl_list.2:755
11917 #, no-wrap
11918 msgid "0x00005607\tVT_WAITACTIVE\tint\n"
11919 msgstr ""
11920
11921 #. type: tbl table
11922 #: build/C/man2/ioctl_list.2:756
11923 #, no-wrap
11924 msgid "0x00005608\tVT_DISALLOCATE\tint\n"
11925 msgstr ""
11926
11927 #. type: tbl table
11928 #: build/C/man2/ioctl_list.2:757
11929 #, no-wrap
11930 msgid "0x00005609\tVT_RESIZE\tconst struct vt_sizes *\n"
11931 msgstr ""
11932
11933 #. type: tbl table
11934 #: build/C/man2/ioctl_list.2:758
11935 #, no-wrap
11936 msgid "0x0000560A\tVT_RESIZEX\tconst struct vt_consize *\n"
11937 msgstr ""
11938
11939 #. type: Plain text
11940 #: build/C/man2/ioctl_list.2:765
11941 msgid ""
11942 "// More arguments.  Some ioctl's take a pointer to a structure which "
11943 "contains additional pointers.  These are documented here in alphabetical "
11944 "order."
11945 msgstr ""
11946
11947 #. type: Plain text
11948 #: build/C/man2/ioctl_list.2:773
11949 msgid ""
11950 "B<CDROMREADAUDIO> takes an input pointer I<const struct cdrom_read_audio\\ "
11951 "*>.  The I<buf> field points to an output buffer of length I<nframes\\ * "
11952 "CD_FRAMESIZE_RAW>."
11953 msgstr ""
11954
11955 #. type: Plain text
11956 #: build/C/man2/ioctl_list.2:789
11957 msgid ""
11958 "B<CDROMREADCOOKED>, B<CDROMREADMODE1>, B<CDROMREADMODE2>, and "
11959 "B<CDROMREADRAW> take an input pointer I<const struct cdrom_msf\\ *>.  They "
11960 "use the same pointer as an output pointer to I<char []>.  The length varies "
11961 "by request.  For B<CDROMREADMODE1>, most drivers use CD_FRAMESIZE, but the "
11962 "Optics Storage driver uses OPT_BLOCKSIZE instead (both have the numerical "
11963 "value 2048)."
11964 msgstr ""
11965
11966 #. type: Plain text
11967 #: build/C/man2/ioctl_list.2:795
11968 #, no-wrap
11969 msgid ""
11970 "    CDROMREADCOOKED    char [CD_FRAMESIZE]\n"
11971 "    CDROMREADMODE1     char [CD_FRAMESIZE or OPT_BLOCKSIZE]\n"
11972 "    CDROMREADMODE2     char [CD_FRAMESIZE_RAW0]\n"
11973 "    CDROMREADRAW       char [CD_FRAMESIZE_RAW]\n"
11974 msgstr ""
11975
11976 #. type: Plain text
11977 #: build/C/man2/ioctl_list.2:809
11978 msgid ""
11979 "B<EQL_ENSLAVE>, B<EQL_EMANCIPATE>, B<EQL_GETSLAVECFG>, B<EQL_SETSLAVECFG>, "
11980 "B<EQL_GETMASTERCFG>, and B<EQL_SETMASTERCFG> take a I<struct ifreq\\ *>.  "
11981 "The I<ifr_data> field is a pointer to another structure as follows:"
11982 msgstr ""
11983
11984 #. type: Plain text
11985 #: build/C/man2/ioctl_list.2:817
11986 #, no-wrap
11987 msgid ""
11988 "    EQL_ENSLAVE         const struct slaving_request *\n"
11989 "    EQL_EMANCIPATE      const struct slaving_request *\n"
11990 "    EQL_GETSLAVECFG     struct slave_config *           // I-O\n"
11991 "    EQL_SETSLAVECFG     const struct slave_config *\n"
11992 "    EQL_GETMASTERCFG    struct master_config *\n"
11993 "    EQL_SETMASTERCFG    const struct master_config *\n"
11994 msgstr ""
11995
11996 #. type: Plain text
11997 #: build/C/man2/ioctl_list.2:834
11998 msgid ""
11999 "B<FDRAWCMD> takes a I<struct floppy raw_cmd\\ *>.  If I<flags & "
12000 "FD_RAW_WRITE> is nonzero, then I<data> points to an input buffer of length "
12001 "I<length>.  If I<flags & FD_RAW_READ> is nonzero, then I<data> points to an "
12002 "output buffer of length I<length>."
12003 msgstr ""
12004
12005 #. type: Plain text
12006 #: build/C/man2/ioctl_list.2:850
12007 msgid ""
12008 "B<GIO_FONTX> and B<PIO_FONTX> take a I<struct console_font_desc\\ *> or a "
12009 "I<const struct console_font_desc\\ *>, respectively.  I<chardata> points to "
12010 "a buffer of I<char [charcount]>.  This is an output buffer for B<GIO_FONTX> "
12011 "and an input buffer for B<PIO_FONTX>."
12012 msgstr ""
12013
12014 #. type: Plain text
12015 #: build/C/man2/ioctl_list.2:866
12016 msgid ""
12017 "B<GIO_UNIMAP> and B<PIO_UNIMAP> take a I<struct unimapdesc\\ *> or a I<const "
12018 "struct unimapdesc\\ *>, respectively.  I<entries> points to a buffer of "
12019 "I<struct unipair [entry_ct]>.  This is an output buffer for B<GIO_UNIMAP> "
12020 "and an input buffer for B<PIO_UNIMAP>."
12021 msgstr ""
12022
12023 #. type: Plain text
12024 #: build/C/man2/ioctl_list.2:870
12025 msgid ""
12026 "KDADDIO, KDDELIO, KDDISABIO, and KDENABIO enable or disable access to I/O "
12027 "ports.  They are essentially alternate interfaces to 'ioperm'."
12028 msgstr ""
12029
12030 #. type: Plain text
12031 #: build/C/man2/ioctl_list.2:876
12032 msgid ""
12033 "B<KDMAPDISP> and B<KDUNMAPDISP> enable or disable memory mappings or I/O "
12034 "port access.  They are not implemented in the kernel."
12035 msgstr ""
12036
12037 #. type: Plain text
12038 #: build/C/man2/ioctl_list.2:884
12039 msgid ""
12040 "B<SCSI_IOCTL_PROBE_HOST> takes an input pointer I<const int\\ *>, which is a "
12041 "length.  It uses the same pointer as an output pointer to a I<char []> "
12042 "buffer of this length."
12043 msgstr ""
12044
12045 #. type: Plain text
12046 #: build/C/man2/ioctl_list.2:890
12047 msgid ""
12048 "B<SIOCADDRT> and B<SIOCDELRT> take an input pointer whose type depends on "
12049 "the protocol:"
12050 msgstr ""
12051
12052 #. type: Plain text
12053 #: build/C/man2/ioctl_list.2:895
12054 #, no-wrap
12055 msgid ""
12056 "    Most protocols      const struct rtentry *\n"
12057 "    AX.25               const struct ax25_route *\n"
12058 "    NET/ROM             const struct nr_route_struct *\n"
12059 msgstr ""
12060
12061 #. type: Plain text
12062 #: build/C/man2/ioctl_list.2:906
12063 msgid ""
12064 "B<SIOCGIFCONF> takes a I<struct ifconf\\ *>.  The I<ifc_buf> field points to "
12065 "a buffer of length I<ifc_len> bytes, into which the kernel writes a list of "
12066 "type I<struct ifreq []>."
12067 msgstr ""
12068
12069 #. type: Plain text
12070 #: build/C/man2/ioctl_list.2:909
12071 msgid "B<SIOCSIFHWADDR> takes an input pointer whose type depends on the protocol:"
12072 msgstr ""
12073
12074 #. type: Plain text
12075 #: build/C/man2/ioctl_list.2:913
12076 #, no-wrap
12077 msgid ""
12078 "    Most protocols      const struct ifreq *\n"
12079 "    AX.25               const char [AX25_ADDR_LEN]\n"
12080 msgstr ""
12081
12082 #. type: Plain text
12083 #: build/C/man2/ioctl_list.2:928
12084 msgid ""
12085 "B<TIOCLINUX> takes a I<const char\\ *>.  It uses this to distinguish several "
12086 "independent subcases.  In the table below, I<N + foo> means I<foo> after an "
12087 "N-byte pad.  I<struct selection> is implicitly defined in "
12088 "I<drivers/char/selection.c>"
12089 msgstr ""
12090
12091 #. type: Plain text
12092 #: build/C/man2/ioctl_list.2:937
12093 #, no-wrap
12094 msgid ""
12095 "    TIOCLINUX-2         1 + const struct selection *\n"
12096 "    TIOCLINUX-3         void\n"
12097 "    TIOCLINUX-4         void\n"
12098 "    TIOCLINUX-5         4 + const struct { long [8]; } *\n"
12099 "    TIOCLINUX-6         char *\n"
12100 "    TIOCLINUX-7         char *\n"
12101 "    TIOCLINUX-10        1 + const char *\n"
12102 msgstr ""
12103
12104 #. type: Plain text
12105 #: build/C/man2/ioctl_list.2:940
12106 msgid "// Duplicate ioctls"
12107 msgstr ""
12108
12109 #. type: Plain text
12110 #: build/C/man2/ioctl_list.2:945
12111 msgid ""
12112 "This list does not include ioctls in the range B<SIOCDEVPRIVATE> and "
12113 "B<SIOCPROTOPRIVATE>."
12114 msgstr ""
12115
12116 #. type: tbl table
12117 #: build/C/man2/ioctl_list.2:947
12118 #, no-wrap
12119 msgid "0x00000001\tFDSETPRM\tFIBMAP\n"
12120 msgstr ""
12121
12122 #. type: tbl table
12123 #: build/C/man2/ioctl_list.2:948
12124 #, no-wrap
12125 msgid "0x00000002\tFDDEFPRM\tFIGETBSZ\n"
12126 msgstr ""
12127
12128 #. type: tbl table
12129 #: build/C/man2/ioctl_list.2:949
12130 #, no-wrap
12131 msgid "0x00005382\tCDROMAUDIOBUFSIZ\tSCSI_IOCTL_GET_IDLUN\n"
12132 msgstr ""
12133
12134 #. type: tbl table
12135 #: build/C/man2/ioctl_list.2:950
12136 #, no-wrap
12137 msgid "0x00005402\tSNDCTL_TMR_START\tTCSETS\n"
12138 msgstr ""
12139
12140 #. type: tbl table
12141 #: build/C/man2/ioctl_list.2:951
12142 #, no-wrap
12143 msgid "0x00005403\tSNDCTL_TMR_STOP\tTCSETSW\n"
12144 msgstr ""
12145
12146 #. type: tbl table
12147 #: build/C/man2/ioctl_list.2:952
12148 #, no-wrap
12149 msgid "0x00005404\tSNDCTL_TMR_CONTINUE\tTCSETSF\n"
12150 msgstr ""
12151
12152 #. type: Plain text
12153 #: build/C/man2/ioctl_list.2:956
12154 msgid "B<ioctl>(2)"
12155 msgstr ""
12156
12157 #. type: TH
12158 #: build/C/man2/ioperm.2:34
12159 #, no-wrap
12160 msgid "IOPERM"
12161 msgstr ""
12162
12163 #. type: Plain text
12164 #: build/C/man2/ioperm.2:37
12165 msgid "ioperm - set port input/output permissions"
12166 msgstr ""
12167
12168 #. type: Plain text
12169 #: build/C/man2/ioperm.2:40
12170 msgid "B<#include E<lt>unistd.hE<gt>> /* for libc5 */"
12171 msgstr ""
12172
12173 #. type: Plain text
12174 #: build/C/man2/ioperm.2:43
12175 msgid "B<#include E<lt>sys/io.hE<gt>> /* for glibc */"
12176 msgstr ""
12177
12178 #. type: Plain text
12179 #: build/C/man2/ioperm.2:45
12180 msgid ""
12181 "B<int ioperm(unsigned long >I<from>B<, unsigned long >I<num>B<, int "
12182 ">I<turn_on>B<);>"
12183 msgstr ""
12184
12185 #. type: Plain text
12186 #: build/C/man2/ioperm.2:59
12187 msgid ""
12188 "B<ioperm>()  sets the port access permission bits for the calling thread for "
12189 "I<num> bits starting from port address I<from>.  If I<turn_on> is nonzero, "
12190 "then permission for the specified bits is enabled; otherwise it is "
12191 "disabled.  If I<turn_on> is nonzero, the calling thread must be privileged "
12192 "(B<CAP_SYS_RAWIO>)."
12193 msgstr ""
12194
12195 #. type: Plain text
12196 #: build/C/man2/ioperm.2:68
12197 msgid ""
12198 "Before Linux 2.6.8, only the first 0x3ff I/O ports could be specified in "
12199 "this manner.  For more ports, the B<iopl>(2)  system call had to be used "
12200 "(with a I<level> argument of 3).  Since Linux 2.6.8, 65,536 I/O ports can be "
12201 "specified."
12202 msgstr ""
12203
12204 #. type: Plain text
12205 #: build/C/man2/ioperm.2:78
12206 msgid ""
12207 "Permissions are not inherited by the child created by B<fork>(2); following "
12208 "a B<fork>(2)  the child must turn on those permissions that it needs.  "
12209 "Permissions are preserved across B<execve>(2); this is useful for giving "
12210 "port access permissions to unprivileged programs."
12211 msgstr ""
12212
12213 #. type: Plain text
12214 #: build/C/man2/ioperm.2:82
12215 msgid ""
12216 "This call is mostly for the i386 architecture.  On many other architectures "
12217 "it does not exist or will always return an error."
12218 msgstr ""
12219
12220 #. type: Plain text
12221 #: build/C/man2/ioperm.2:94
12222 msgid "Invalid values for I<from> or I<num>."
12223 msgstr ""
12224
12225 #. type: Plain text
12226 #: build/C/man2/ioperm.2:97
12227 msgid "(on PowerPC) This call is not supported."
12228 msgstr ""
12229
12230 #.  Could not allocate I/O bitmap.
12231 #. type: Plain text
12232 #: build/C/man2/ioperm.2:101
12233 msgid "Out of memory."
12234 msgstr ""
12235
12236 #. type: Plain text
12237 #: build/C/man2/ioperm.2:104
12238 msgid "The calling thread has insufficient privilege."
12239 msgstr ""
12240
12241 #. type: Plain text
12242 #: build/C/man2/ioperm.2:108
12243 msgid ""
12244 "B<ioperm>()  is Linux-specific and should not be used in programs intended "
12245 "to be portable."
12246 msgstr ""
12247
12248 #. type: Plain text
12249 #: build/C/man2/ioperm.2:112
12250 msgid ""
12251 "The I</proc/ioports> file shows the I/O ports that are currently allocated "
12252 "on the system."
12253 msgstr ""
12254
12255 #. type: Plain text
12256 #: build/C/man2/ioperm.2:121
12257 msgid ""
12258 "Libc5 treats it as a system call and has a prototype in "
12259 "I<E<lt>unistd.hE<gt>>.  Glibc1 does not have a prototype.  Glibc2 has a "
12260 "prototype both in I<E<lt>sys/io.hE<gt>> and in I<E<lt>sys/perm.hE<gt>>.  "
12261 "Avoid the latter, it is available on i386 only."
12262 msgstr ""
12263
12264 #. type: Plain text
12265 #: build/C/man2/ioperm.2:125
12266 msgid "B<iopl>(2), B<outb>(2), B<capabilities>(7)"
12267 msgstr ""
12268
12269 #. type: TH
12270 #: build/C/man3/lockf.3:28
12271 #, no-wrap
12272 msgid "LOCKF"
12273 msgstr ""
12274
12275 #. type: TH
12276 #: build/C/man3/lockf.3:28
12277 #, no-wrap
12278 msgid "2012-07-07"
12279 msgstr ""
12280
12281 #. type: Plain text
12282 #: build/C/man3/lockf.3:31
12283 msgid "lockf - apply, test or remove a POSIX lock on an open file"
12284 msgstr ""
12285
12286 #. type: Plain text
12287 #: build/C/man3/lockf.3:35
12288 msgid "B<int lockf(int >I<fd>B<, int >I<cmd>B<, off_t >I<len>B<);>"
12289 msgstr ""
12290
12291 #. type: Plain text
12292 #: build/C/man3/lockf.3:42
12293 msgid "B<lockf>():"
12294 msgstr ""
12295
12296 #. type: Plain text
12297 #: build/C/man3/lockf.3:46
12298 msgid ""
12299 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
12300 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
12301 msgstr ""
12302
12303 #. type: Plain text
12304 #: build/C/man3/lockf.3:69
12305 msgid ""
12306 "Apply, test or remove a POSIX lock on a section of an open file.  The file "
12307 "is specified by I<fd>, a file descriptor open for writing, the action by "
12308 "I<cmd>, and the section consists of byte positions I<pos>..I<pos>+I<len>-1 "
12309 "if I<len> is positive, and I<pos>-I<len>..I<pos>-1 if I<len> is negative, "
12310 "where I<pos> is the current file position, and if I<len> is zero, the "
12311 "section extends from the current file position to infinity, encompassing the "
12312 "present and future end-of-file positions.  In all cases, the section may "
12313 "extend past current end-of-file."
12314 msgstr ""
12315
12316 #. type: Plain text
12317 #: build/C/man3/lockf.3:84
12318 msgid ""
12319 "On Linux, B<lockf>()  is just an interface on top of B<fcntl>(2)  locking.  "
12320 "Many other systems implement B<lockf>()  in this way, but note that "
12321 "POSIX.1-2001 leaves the relationship between B<lockf>()  and B<fcntl>(2)  "
12322 "locks unspecified.  A portable application should probably avoid mixing "
12323 "calls to these interfaces."
12324 msgstr ""
12325
12326 #. type: Plain text
12327 #: build/C/man3/lockf.3:86
12328 msgid "Valid operations are given below:"
12329 msgstr ""
12330
12331 #. type: TP
12332 #: build/C/man3/lockf.3:86
12333 #, no-wrap
12334 msgid "B<F_LOCK>"
12335 msgstr ""
12336
12337 #. type: Plain text
12338 #: build/C/man3/lockf.3:96
12339 msgid ""
12340 "Set an exclusive lock on the specified section of the file.  If (part of) "
12341 "this section is already locked, the call blocks until the previous lock is "
12342 "released.  If this section overlaps an earlier locked section, both are "
12343 "merged.  File locks are released as soon as the process holding the locks "
12344 "closes some file descriptor for the file.  A child process does not inherit "
12345 "these locks."
12346 msgstr ""
12347
12348 #. type: TP
12349 #: build/C/man3/lockf.3:96
12350 #, no-wrap
12351 msgid "B<F_TLOCK>"
12352 msgstr ""
12353
12354 #. type: Plain text
12355 #: build/C/man3/lockf.3:102
12356 msgid ""
12357 "Same as B<F_LOCK> but the call never blocks and returns an error instead if "
12358 "the file is already locked."
12359 msgstr ""
12360
12361 #. type: TP
12362 #: build/C/man3/lockf.3:102
12363 #, no-wrap
12364 msgid "B<F_ULOCK>"
12365 msgstr ""
12366
12367 #. type: Plain text
12368 #: build/C/man3/lockf.3:106
12369 msgid ""
12370 "Unlock the indicated section of the file.  This may cause a locked section "
12371 "to be split into two locked sections."
12372 msgstr ""
12373
12374 #. type: TP
12375 #: build/C/man3/lockf.3:106
12376 #, no-wrap
12377 msgid "B<F_TEST>"
12378 msgstr ""
12379
12380 #. type: Plain text
12381 #: build/C/man3/lockf.3:116
12382 msgid ""
12383 "Test the lock: return 0 if the specified section is unlocked or locked by "
12384 "this process; return -1, set I<errno> to B<EAGAIN> (B<EACCES> on some other "
12385 "systems), if another process holds a lock."
12386 msgstr ""
12387
12388 #. type: Plain text
12389 #: build/C/man3/lockf.3:130
12390 msgid ""
12391 "The file is locked and B<F_TLOCK> or B<F_TEST> was specified, or the "
12392 "operation is prohibited because the file has been memory-mapped by another "
12393 "process."
12394 msgstr ""
12395
12396 #. type: Plain text
12397 #: build/C/man3/lockf.3:142
12398 msgid ""
12399 "I<fd> is not an open file descriptor; or I<cmd> is B<F_LOCK> or B<F_TLOCK> "
12400 "and I<fd> is not a writable file descriptor."
12401 msgstr ""
12402
12403 #. type: Plain text
12404 #: build/C/man3/lockf.3:147
12405 msgid "The command was B<F_LOCK> and this lock operation would cause a deadlock."
12406 msgstr ""
12407
12408 #. type: Plain text
12409 #: build/C/man3/lockf.3:151
12410 msgid "An invalid operation was specified in I<fd>."
12411 msgstr ""
12412
12413 #. type: Plain text
12414 #: build/C/man3/lockf.3:154
12415 msgid "Too many segment locks open, lock table is full."
12416 msgstr ""
12417
12418 #. type: Plain text
12419 #: build/C/man3/lockf.3:156
12420 msgid "SVr4, POSIX.1-2001."
12421 msgstr ""
12422
12423 #. type: Plain text
12424 #: build/C/man3/lockf.3:159
12425 msgid "B<fcntl>(2), B<flock>(2)"
12426 msgstr ""
12427
12428 #. type: Plain text
12429 #: build/C/man3/lockf.3:171
12430 msgid ""
12431 "I<locks.txt> and I<mandatory-locking.txt> in the Linux kernel source "
12432 "directory I<Documentation/filesystems> (on older kernels, these files are "
12433 "directly under the I<Documentation> directory, and I<mandatory-locking.txt> "
12434 "is called I<mandatory.txt>)"
12435 msgstr ""
12436
12437 #. type: TH
12438 #: build/C/man2/mincore.2:34
12439 #, no-wrap
12440 msgid "MINCORE"
12441 msgstr ""
12442
12443 #. type: TH
12444 #: build/C/man2/mincore.2:34
12445 #, no-wrap
12446 msgid "2008-04-22"
12447 msgstr ""
12448
12449 #. type: Plain text
12450 #: build/C/man2/mincore.2:37
12451 msgid "mincore - determine whether pages are resident in memory"
12452 msgstr ""
12453
12454 #. type: Plain text
12455 #: build/C/man2/mincore.2:41
12456 msgid "B<#include E<lt>sys/mman.hE<gt>>"
12457 msgstr ""
12458
12459 #. type: Plain text
12460 #: build/C/man2/mincore.2:43
12461 msgid ""
12462 "B<int mincore(void *>I<addr>B<, size_t >I<length>B<, unsigned char "
12463 "*>I<vec>B<);>"
12464 msgstr ""
12465
12466 #. type: Plain text
12467 #: build/C/man2/mincore.2:51
12468 msgid "B<mincore>(): _BSD_SOURCE || _SVID_SOURCE"
12469 msgstr ""
12470
12471 #. type: Plain text
12472 #: build/C/man2/mincore.2:62
12473 msgid ""
12474 "B<mincore>()  returns a vector that indicates whether pages of the calling "
12475 "process's virtual memory are resident in core (RAM), and so will not cause a "
12476 "disk access (page fault) if referenced.  The kernel returns residency "
12477 "information about the pages starting at the address I<addr>, and continuing "
12478 "for I<length> bytes."
12479 msgstr ""
12480
12481 #. type: Plain text
12482 #: build/C/man2/mincore.2:76
12483 msgid ""
12484 "The I<addr> argument must be a multiple of the system page size.  The "
12485 "I<length> argument need not be a multiple of the page size, but since "
12486 "residency information is returned for whole pages, I<length> is effectively "
12487 "rounded up to the next multiple of the page size.  One may obtain the page "
12488 "size (B<PAGE_SIZE>)  using I<sysconf(_SC_PAGESIZE)>."
12489 msgstr ""
12490
12491 #. type: Plain text
12492 #: build/C/man2/mincore.2:94
12493 msgid ""
12494 "The I<vec> argument must point to an array containing at least "
12495 "I<(length+PAGE_SIZE-1) / PAGE_SIZE> bytes.  On return, the least significant "
12496 "bit of each byte will be set if the corresponding page is currently resident "
12497 "in memory, and be clear otherwise.  (The settings of the other bits in each "
12498 "byte are undefined; these bits are reserved for possible later use.)  Of "
12499 "course the information returned in I<vec> is only a snapshot: pages that are "
12500 "not locked in memory can come and go at any moment, and the contents of "
12501 "I<vec> may already be stale by the time this call returns."
12502 msgstr ""
12503
12504 #. type: Plain text
12505 #: build/C/man2/mincore.2:101
12506 msgid ""
12507 "On success, B<mincore>()  returns zero.  On error, -1 is returned, and "
12508 "I<errno> is set appropriately."
12509 msgstr ""
12510
12511 #. type: Plain text
12512 #: build/C/man2/mincore.2:104
12513 msgid "B<EAGAIN> kernel is temporarily out of resources."
12514 msgstr ""
12515
12516 #. type: Plain text
12517 #: build/C/man2/mincore.2:108
12518 msgid "I<vec> points to an invalid address."
12519 msgstr ""
12520
12521 #. type: Plain text
12522 #: build/C/man2/mincore.2:112
12523 msgid "I<addr> is not a multiple of the page size."
12524 msgstr ""
12525
12526 #. type: Plain text
12527 #: build/C/man2/mincore.2:124
12528 msgid ""
12529 "I<length> is greater than (I<TASK_SIZE> - I<addr>).  (This could occur if a "
12530 "negative value is specified for I<length>, since that value will be "
12531 "interpreted as a large unsigned integer.)  In Linux 2.6.11 and earlier, the "
12532 "error B<EINVAL> was returned for this condition."
12533 msgstr ""
12534
12535 #. type: Plain text
12536 #: build/C/man2/mincore.2:132
12537 msgid "I<addr> to I<addr> + I<length> contained unmapped memory."
12538 msgstr ""
12539
12540 #. type: Plain text
12541 #: build/C/man2/mincore.2:134
12542 msgid "Available since Linux 2.3.99pre1 and glibc 2.2."
12543 msgstr ""
12544
12545 #.  It is on at least NetBSD, FreeBSD, OpenBSD, Solaris 8,
12546 #.  AIX 5.1, SunOS 4.1
12547 #.  .SH HISTORY
12548 #.  The
12549 #.  .BR mincore ()
12550 #.  function first appeared in 4.4BSD.
12551 #. type: Plain text
12552 #: build/C/man2/mincore.2:144
12553 msgid ""
12554 "B<mincore>()  is not specified in POSIX.1-2001, and it is not available on "
12555 "all UNIX implementations."
12556 msgstr ""
12557
12558 #.  Linux (up to now, 2.6.5),
12559 #.  .B mincore
12560 #.  does not return correct information for MAP_PRIVATE mappings:
12561 #.  for a MAP_PRIVATE file mapping,
12562 #.  .B mincore
12563 #.  returns the residency of the file pages, rather than any
12564 #.  modified process-private pages that have been copied on write;
12565 #.  for a MAP_PRIVATE mapping of
12566 #.  .IR /dev/zero ,
12567 #.  .B mincore
12568 #.  always reports pages as nonresident;
12569 #.  and for a MAP_PRIVATE, MAP_ANONYMOUS mapping,
12570 #.  .B mincore
12571 #.  always fails with the error
12572 #.  .BR ENOMEM .
12573 #. type: Plain text
12574 #: build/C/man2/mincore.2:166
12575 msgid ""
12576 "Before kernel 2.6.21, B<mincore>()  did not return correct information for "
12577 "B<MAP_PRIVATE> mappings, or for nonlinear mappings (established using "
12578 "B<remap_file_pages>(2))."
12579 msgstr ""
12580
12581 #. type: Plain text
12582 #: build/C/man2/mincore.2:169
12583 msgid "B<mlock>(2), B<mmap>(2)"
12584 msgstr ""
12585
12586 #. type: TH
12587 #: build/C/man2/mkdir.2:10
12588 #, no-wrap
12589 msgid "MKDIR"
12590 msgstr ""
12591
12592 #. type: TH
12593 #: build/C/man2/mkdir.2:10
12594 #, no-wrap
12595 msgid "2013-01-27"
12596 msgstr ""
12597
12598 #. type: Plain text
12599 #: build/C/man2/mkdir.2:13
12600 msgid "mkdir - create a directory"
12601 msgstr ""
12602
12603 #.  .B #include <unistd.h>
12604 #. type: Plain text
12605 #: build/C/man2/mkdir.2:18
12606 #, no-wrap
12607 msgid ""
12608 "B<#include E<lt>sys/stat.hE<gt>>\n"
12609 "B<#include E<lt>sys/types.hE<gt>>\n"
12610 msgstr ""
12611
12612 #. type: Plain text
12613 #: build/C/man2/mkdir.2:20
12614 #, no-wrap
12615 msgid "B<int mkdir(const char *>I<pathname>B<, mode_t >I<mode>B<);>\n"
12616 msgstr ""
12617
12618 #. type: Plain text
12619 #: build/C/man2/mkdir.2:25
12620 msgid "B<mkdir>()  attempts to create a directory named I<pathname>."
12621 msgstr ""
12622
12623 #. type: Plain text
12624 #: build/C/man2/mkdir.2:35
12625 msgid ""
12626 "The argument I<mode> specifies the permissions to use.  It is modified by "
12627 "the process's I<umask> in the usual way: the permissions of the created "
12628 "directory are (I<mode> & ~I<umask> & 0777).  Other mode bits of the created "
12629 "directory depend on the operating system.  For Linux, see below."
12630 msgstr ""
12631
12632 #. type: Plain text
12633 #: build/C/man2/mkdir.2:45
12634 msgid ""
12635 "The newly created directory will be owned by the effective user ID of the "
12636 "process.  If the directory containing the file has the set-group-ID bit set, "
12637 "or if the file system is mounted with BSD group semantics (I<mount -o "
12638 "bsdgroups> or, synonymously I<mount -o grpid>), the new directory will "
12639 "inherit the group ownership from its parent; otherwise it will be owned by "
12640 "the effective group ID of the process."
12641 msgstr ""
12642
12643 #. type: Plain text
12644 #: build/C/man2/mkdir.2:48
12645 msgid ""
12646 "If the parent directory has the set-group-ID bit set then so will the newly "
12647 "created directory."
12648 msgstr ""
12649
12650 #. type: Plain text
12651 #: build/C/man2/mkdir.2:53
12652 msgid ""
12653 "B<mkdir>()  returns zero on success, or -1 if an error occurred (in which "
12654 "case, I<errno> is set appropriately)."
12655 msgstr ""
12656
12657 #. type: Plain text
12658 #: build/C/man2/mkdir.2:62
12659 msgid ""
12660 "The parent directory does not allow write permission to the process, or one "
12661 "of the directories in I<pathname> did not allow search permission.  (See "
12662 "also B<path_resolution>(7).)"
12663 msgstr ""
12664
12665 #. type: TP
12666 #: build/C/man2/mkdir.2:62
12667 #, no-wrap
12668 msgid "B<EDQUOT>"
12669 msgstr ""
12670
12671 #. type: Plain text
12672 #: build/C/man2/mkdir.2:66
12673 msgid ""
12674 "The user's quota of disk blocks or inodes on the file system has been "
12675 "exhausted."
12676 msgstr ""
12677
12678 #. type: TP
12679 #: build/C/man2/mkdir.2:66
12680 #, no-wrap
12681 msgid "B<EEXIST>"
12682 msgstr ""
12683
12684 #. type: Plain text
12685 #: build/C/man2/mkdir.2:73
12686 msgid ""
12687 "I<pathname> already exists (not necessarily as a directory).  This includes "
12688 "the case where I<pathname> is a symbolic link, dangling or not."
12689 msgstr ""
12690
12691 #. type: TP
12692 #: build/C/man2/mkdir.2:80
12693 #, no-wrap
12694 msgid "B<EMLINK>"
12695 msgstr ""
12696
12697 #. type: Plain text
12698 #: build/C/man2/mkdir.2:84
12699 msgid "The number of links to the parent directory would exceed B<LINK_MAX>."
12700 msgstr ""
12701
12702 #. type: Plain text
12703 #: build/C/man2/mkdir.2:87
12704 msgid "I<pathname> was too long."
12705 msgstr ""
12706
12707 #. type: Plain text
12708 #: build/C/man2/mkdir.2:92
12709 msgid ""
12710 "A directory component in I<pathname> does not exist or is a dangling "
12711 "symbolic link."
12712 msgstr ""
12713
12714 #. type: TP
12715 #: build/C/man2/mkdir.2:95 build/C/man2/mkdir.2:100
12716 #, no-wrap
12717 msgid "B<ENOSPC>"
12718 msgstr ""
12719
12720 #. type: Plain text
12721 #: build/C/man2/mkdir.2:100
12722 msgid "The device containing I<pathname> has no room for the new directory."
12723 msgstr ""
12724
12725 #. type: Plain text
12726 #: build/C/man2/mkdir.2:104
12727 msgid ""
12728 "The new directory cannot be created because the user's disk quota is "
12729 "exhausted."
12730 msgstr ""
12731
12732 #. type: Plain text
12733 #: build/C/man2/mkdir.2:114
12734 msgid ""
12735 "The file system containing I<pathname> does not support the creation of "
12736 "directories."
12737 msgstr ""
12738
12739 #. type: Plain text
12740 #: build/C/man2/mkdir.2:118
12741 msgid "I<pathname> refers to a file on a read-only file system."
12742 msgstr ""
12743
12744 #.  SVr4 documents additional EIO, EMULTIHOP
12745 #. type: Plain text
12746 #: build/C/man2/mkdir.2:121
12747 msgid "SVr4, BSD, POSIX.1-2001."
12748 msgstr ""
12749
12750 #. type: Plain text
12751 #: build/C/man2/mkdir.2:129
12752 msgid ""
12753 "Under Linux apart from the permission bits, only the B<S_ISVTX> mode bit is "
12754 "honored.  That is, under Linux the created directory actually gets mode "
12755 "(I<mode> & ~I<umask> & 01777).  See also B<stat>(2)."
12756 msgstr ""
12757
12758 #. type: Plain text
12759 #: build/C/man2/mkdir.2:133
12760 msgid ""
12761 "There are many infelicities in the protocol underlying NFS.  Some of these "
12762 "affect B<mkdir>()."
12763 msgstr ""
12764
12765 #. type: Plain text
12766 #: build/C/man2/mkdir.2:145
12767 msgid ""
12768 "B<mkdir>(1), B<chmod>(2), B<chown>(2), B<mkdirat>(2), B<mknod>(2), "
12769 "B<mount>(2), B<rmdir>(2), B<stat>(2), B<umask>(2), B<unlink>(2), "
12770 "B<path_resolution>(7)"
12771 msgstr ""
12772
12773 #. type: TH
12774 #: build/C/man2/nice.2:31
12775 #, no-wrap
12776 msgid "NICE"
12777 msgstr ""
12778
12779 #. type: TH
12780 #: build/C/man2/nice.2:31 build/C/man2/vhangup.2:28
12781 #, no-wrap
12782 msgid "2007-07-26"
12783 msgstr ""
12784
12785 #. type: Plain text
12786 #: build/C/man2/nice.2:34
12787 msgid "nice - change process priority"
12788 msgstr ""
12789
12790 #. type: Plain text
12791 #: build/C/man2/nice.2:38
12792 msgid "B<int nice(int >I<inc>B<);>"
12793 msgstr ""
12794
12795 #. type: Plain text
12796 #: build/C/man2/nice.2:46
12797 msgid "B<nice>(): _BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE"
12798 msgstr ""
12799
12800 #. type: Plain text
12801 #: build/C/man2/nice.2:56
12802 msgid ""
12803 "B<nice>()  adds I<inc> to the nice value for the calling process.  (A higher "
12804 "nice value means a low priority.)  Only the super\\%user may specify a "
12805 "negative increment, or priority increase.  The range for nice values is "
12806 "described in B<getpriority>(2)."
12807 msgstr ""
12808
12809 #. type: Plain text
12810 #: build/C/man2/nice.2:61
12811 msgid ""
12812 "On success, the new nice value is returned (but see NOTES below).  On error, "
12813 "-1 is returned, and I<errno> is set appropriately."
12814 msgstr ""
12815
12816 #. type: Plain text
12817 #: build/C/man2/nice.2:75
12818 msgid ""
12819 "The calling process attempted to increase its priority by supplying a "
12820 "negative I<inc> but has insufficient privileges.  Under Linux the "
12821 "B<CAP_SYS_NICE> capability is required.  (But see the discussion of the "
12822 "B<RLIMIT_NICE> resource limit in B<setrlimit>(2).)"
12823 msgstr ""
12824
12825 #. type: Plain text
12826 #: build/C/man2/nice.2:82
12827 msgid ""
12828 "SVr4, 4.3BSD, POSIX.1-2001.  However, the Linux and (g)libc (earlier than "
12829 "glibc 2.2.4) return value is nonstandard, see below.  SVr4 documents an "
12830 "additional B<EINVAL> error code."
12831 msgstr ""
12832
12833 #. type: Plain text
12834 #: build/C/man2/nice.2:92
12835 msgid ""
12836 "SUSv2 and POSIX.1-2001 specify that B<nice>()  should return the new nice "
12837 "value.  However, the Linux syscall and the B<nice>()  library function "
12838 "provided in older versions of (g)libc (earlier than glibc 2.2.4) return 0 on "
12839 "success.  The new nice value can be found using B<getpriority>(2)."
12840 msgstr ""
12841
12842 #. type: Plain text
12843 #: build/C/man2/nice.2:105
12844 msgid ""
12845 "Since glibc 2.2.4, B<nice>()  is implemented as a library function that "
12846 "calls B<getpriority>(2)  to obtain the new nice value to be returned to the "
12847 "caller.  With this implementation, a successful call can legitimately return "
12848 "-1.  To reliably detect an error, set I<errno> to 0 before the call, and "
12849 "check its value when B<nice>()  returns -1."
12850 msgstr ""
12851
12852 #. type: Plain text
12853 #: build/C/man2/nice.2:112
12854 msgid ""
12855 "B<nice>(1), B<renice>(1), B<fork>(2), B<getpriority>(2), B<setpriority>(2), "
12856 "B<capabilities>(7)"
12857 msgstr ""
12858
12859 #. type: TH
12860 #: build/C/man2/pread.2:25
12861 #, no-wrap
12862 msgid "PREAD"
12863 msgstr ""
12864
12865 #. type: Plain text
12866 #: build/C/man2/pread.2:28
12867 msgid "pread, pwrite - read from or write to a file descriptor at a given offset"
12868 msgstr ""
12869
12870 #. type: Plain text
12871 #: build/C/man2/pread.2:33
12872 msgid ""
12873 "B<ssize_t pread(int >I<fd>B<, void *>I<buf>B<, size_t >I<count>B<, off_t "
12874 ">I<offset>B<);>"
12875 msgstr ""
12876
12877 #. type: Plain text
12878 #: build/C/man2/pread.2:36
12879 msgid ""
12880 "B<ssize_t pwrite(int >I<fd>B<, const void *>I<buf>B<, size_t >I<count>B<, "
12881 "off_t >I<offset>B<);>"
12882 msgstr ""
12883
12884 #. type: Plain text
12885 #: build/C/man2/pread.2:46
12886 msgid "B<pread>(), B<pwrite>():"
12887 msgstr ""
12888
12889 #. type: Plain text
12890 #: build/C/man2/pread.2:48
12891 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 500"
12892 msgstr ""
12893
12894 #. type: Plain text
12895 #: build/C/man2/pread.2:64
12896 msgid ""
12897 "B<pread>()  reads up to I<count> bytes from file descriptor I<fd> at offset "
12898 "I<offset> (from the start of the file) into the buffer starting at I<buf>.  "
12899 "The file offset is not changed."
12900 msgstr ""
12901
12902 #. type: Plain text
12903 #: build/C/man2/pread.2:75
12904 msgid ""
12905 "B<pwrite>()  writes up to I<count> bytes from the buffer starting at I<buf> "
12906 "to the file descriptor I<fd> at offset I<offset>.  The file offset is not "
12907 "changed."
12908 msgstr ""
12909
12910 #. type: Plain text
12911 #: build/C/man2/pread.2:79
12912 msgid "The file referenced by I<fd> must be capable of seeking."
12913 msgstr ""
12914
12915 #. type: Plain text
12916 #: build/C/man2/pread.2:89
12917 msgid ""
12918 "On success, the number of bytes read or written is returned (zero indicates "
12919 "that nothing was written, in the case of B<pwrite>(), or end of file, in the "
12920 "case of B<pread>()), or -1 on error, in which case I<errno> is set to "
12921 "indicate the error."
12922 msgstr ""
12923
12924 #. type: Plain text
12925 #: build/C/man2/pread.2:104
12926 msgid ""
12927 "B<pread>()  can fail and set I<errno> to any error specified for B<read>(2)  "
12928 "or B<lseek>(2).  B<pwrite>()  can fail and set I<errno> to any error "
12929 "specified for B<write>(2)  or B<lseek>(2)."
12930 msgstr ""
12931
12932 #. type: Plain text
12933 #: build/C/man2/pread.2:115
12934 msgid ""
12935 "The B<pread>()  and B<pwrite>()  system calls were added to Linux in version "
12936 "2.1.60; the entries in the i386 system call table were added in 2.1.69.  C "
12937 "library support (including emulation using B<lseek>(2)  on older kernels "
12938 "without the system calls) was added in glibc 2.1."
12939 msgstr ""
12940
12941 #. type: Plain text
12942 #: build/C/man2/pread.2:125
12943 msgid ""
12944 "The B<pread>()  and B<pwrite>()  system calls are especially useful in "
12945 "multithreaded applications.  They allow multiple threads to perform I/O on "
12946 "the same file descriptor without being affected by changes to the file "
12947 "offset by other threads."
12948 msgstr ""
12949
12950 #. type: Plain text
12951 #: build/C/man2/pread.2:141
12952 msgid ""
12953 "On Linux, the underlying system calls were renamed in kernel 2.6: B<pread>()  "
12954 "became B<pread64>(), and B<pwrite>()  became B<pwrite64>().  The system call "
12955 "numbers remained the same.  The glibc B<pread>()  and B<pwrite>()  wrapper "
12956 "functions transparently deal with the change."
12957 msgstr ""
12958
12959 #. type: Plain text
12960 #: build/C/man2/pread.2:146 build/C/man2/truncate.2:248
12961 msgid ""
12962 "On some 32-bit architectures, the calling signature for these system calls "
12963 "differ, for the reasons described in B<syscall>(2)."
12964 msgstr ""
12965
12966 #.  FIXME https://bugzilla.kernel.org/show_bug.cgi?id=43178
12967 #. type: Plain text
12968 #: build/C/man2/pread.2:158
12969 msgid ""
12970 "POSIX requires that opening a file with the B<O_APPEND> flag should have no "
12971 "affect on the location at which B<pwrite>()  writes data.  However, on "
12972 "Linux, if a file is opened with B<O_APPEND>, B<pwrite>()  appends data to "
12973 "the end of the file, regardless of the value of I<offset>."
12974 msgstr ""
12975
12976 #. type: Plain text
12977 #: build/C/man2/pread.2:163
12978 msgid "B<lseek>(2), B<read>(2), B<readv>(2), B<write>(2)"
12979 msgstr ""
12980
12981 #. type: TH
12982 #: build/C/man2/set_thread_area.2:8
12983 #, no-wrap
12984 msgid "SET_THREAD_AREA"
12985 msgstr ""
12986
12987 #. type: Plain text
12988 #: build/C/man2/set_thread_area.2:11
12989 msgid "set_thread_area - set a thread local storage (TLS) area"
12990 msgstr ""
12991
12992 #. type: Plain text
12993 #: build/C/man2/set_thread_area.2:17
12994 msgid "B<int set_thread_area(struct user_desc *>I<u_info>B<);>"
12995 msgstr ""
12996
12997 #. type: Plain text
12998 #: build/C/man2/set_thread_area.2:33
12999 msgid ""
13000 "B<set_thread_area>()  sets an entry in the current thread's thread-local "
13001 "storage (TLS) array.  The TLS array entry set by B<set_thread_area>()  "
13002 "corresponds to the value of I<u_info-E<gt>entry_number> passed in by the "
13003 "user.  If this value is in bounds, B<set_thread_area>()  copies the TLS "
13004 "descriptor pointed to by I<u_info> into the thread's TLS array."
13005 msgstr ""
13006
13007 #. type: Plain text
13008 #: build/C/man2/set_thread_area.2:44
13009 msgid ""
13010 "When B<set_thread_area>()  is passed an I<entry_number> of -1, it uses a "
13011 "free TLS entry.  If B<set_thread_area>()  finds a free TLS entry, the value "
13012 "of I<u_info-E<gt>entry_number> is set upon return to show which entry was "
13013 "changed."
13014 msgstr ""
13015
13016 #. type: Plain text
13017 #: build/C/man2/set_thread_area.2:49
13018 msgid ""
13019 "B<set_thread_area>()  returns 0 on success, and -1 on failure, with I<errno> "
13020 "set appropriately."
13021 msgstr ""
13022
13023 #. type: TP
13024 #: build/C/man2/set_thread_area.2:56
13025 #, no-wrap
13026 msgid "B<ESRCH>"
13027 msgstr ""
13028
13029 #. type: Plain text
13030 #: build/C/man2/set_thread_area.2:59
13031 msgid "A free TLS entry could not be located."
13032 msgstr ""
13033
13034 #. type: Plain text
13035 #: build/C/man2/set_thread_area.2:63
13036 msgid "A version of B<set_thread_area>()  first appeared in Linux 2.5.29."
13037 msgstr ""
13038
13039 #. type: Plain text
13040 #: build/C/man2/set_thread_area.2:67
13041 msgid ""
13042 "B<set_thread_area>()  is Linux-specific and should not be used in programs "
13043 "that are intended to be portable."
13044 msgstr ""
13045
13046 #. type: Plain text
13047 #: build/C/man2/set_thread_area.2:72
13048 msgid ""
13049 "Glibc does not provide a wrapper for this system call, since it is generally "
13050 "intended only for use by threading libraries.  In the unlikely event that "
13051 "you want to call it directly, use B<syscall>(2)."
13052 msgstr ""
13053
13054 #. type: Plain text
13055 #: build/C/man2/set_thread_area.2:74
13056 msgid "B<get_thread_area>(2)"
13057 msgstr ""
13058
13059 #. type: TH
13060 #: build/C/man2/setup.2:34
13061 #, no-wrap
13062 msgid "SETUP"
13063 msgstr ""
13064
13065 #. type: TH
13066 #: build/C/man2/setup.2:34 build/C/man2/uname.2:27
13067 #, no-wrap
13068 msgid "2008-12-03"
13069 msgstr ""
13070
13071 #. type: Plain text
13072 #: build/C/man2/setup.2:37
13073 msgid "setup - setup devices and file systems, mount root file system"
13074 msgstr ""
13075
13076 #. type: Plain text
13077 #: build/C/man2/setup.2:41
13078 msgid "B<int setup(void);>"
13079 msgstr ""
13080
13081 #. type: Plain text
13082 #: build/C/man2/setup.2:47
13083 msgid ""
13084 "B<setup>()  is called once from within I<linux/init/main.c>.  It calls "
13085 "initialization functions for devices and file systems configured into the "
13086 "kernel and then mounts the root file system."
13087 msgstr ""
13088
13089 #. type: Plain text
13090 #: build/C/man2/setup.2:53
13091 msgid ""
13092 "No user process may call B<setup>().  Any user process, even a process with "
13093 "superuser permission, will receive B<EPERM>."
13094 msgstr ""
13095
13096 #. type: Plain text
13097 #: build/C/man2/setup.2:56
13098 msgid "B<setup>()  always returns -1 for a user process."
13099 msgstr ""
13100
13101 #. type: Plain text
13102 #: build/C/man2/setup.2:62
13103 msgid "Since Linux 2.1.121, no such function exists anymore."
13104 msgstr ""
13105
13106 #. type: Plain text
13107 #: build/C/man2/setup.2:65
13108 msgid ""
13109 "This function is Linux-specific, and should not be used in programs intended "
13110 "to be portable, or indeed in any programs at all."
13111 msgstr ""
13112
13113 #. type: Plain text
13114 #: build/C/man2/setup.2:72
13115 msgid ""
13116 "The calling sequence varied: at some times I<setup ()> has had a single "
13117 "argument I<void\\ *BIOS> and at other times a single argument I<int magic>."
13118 msgstr ""
13119
13120 #. type: TH
13121 #: build/C/man5/shells.5:28
13122 #, no-wrap
13123 msgid "SHELLS"
13124 msgstr ""
13125
13126 #. type: Plain text
13127 #: build/C/man5/shells.5:31
13128 msgid "shells - pathnames of valid login shells"
13129 msgstr ""
13130
13131 #. type: Plain text
13132 #: build/C/man5/shells.5:37
13133 msgid ""
13134 "I</etc/shells> is a text file which contains the full pathnames of valid "
13135 "login shells.  This file is consulted by B<chsh>(1)  and available to be "
13136 "queried by other programs."
13137 msgstr ""
13138
13139 #. type: Plain text
13140 #: build/C/man5/shells.5:43
13141 msgid ""
13142 "Be aware that there are programs which consult this file to find out if a "
13143 "user is a normal user; for example, FTP daemons traditionally disallow "
13144 "access to users with shells not included in this file."
13145 msgstr ""
13146
13147 #. type: Plain text
13148 #: build/C/man5/shells.5:45
13149 msgid "I</etc/shells>"
13150 msgstr ""
13151
13152 #. type: Plain text
13153 #: build/C/man5/shells.5:48
13154 msgid "I</etc/shells> may contain the following paths:"
13155 msgstr ""
13156
13157 #. type: Plain text
13158 #: build/C/man5/shells.5:51
13159 msgid "I</bin/sh>"
13160 msgstr ""
13161
13162 #. type: Plain text
13163 #: build/C/man5/shells.5:53
13164 msgid "I</bin/bash>"
13165 msgstr ""
13166
13167 #. type: Plain text
13168 #: build/C/man5/shells.5:55
13169 msgid "I</bin/csh>"
13170 msgstr ""
13171
13172 #. type: Plain text
13173 #: build/C/man5/shells.5:59
13174 msgid "B<chsh>(1), B<getusershell>(3)"
13175 msgstr ""
13176
13177 #. type: TH
13178 #: build/C/man3/sleep.3:26
13179 #, no-wrap
13180 msgid "SLEEP"
13181 msgstr ""
13182
13183 #. type: TH
13184 #: build/C/man3/sleep.3:26
13185 #, no-wrap
13186 msgid "2010-02-03"
13187 msgstr ""
13188
13189 #. type: Plain text
13190 #: build/C/man3/sleep.3:29
13191 msgid "sleep - sleep for the specified number of seconds"
13192 msgstr ""
13193
13194 #. type: Plain text
13195 #: build/C/man3/sleep.3:34
13196 #, no-wrap
13197 msgid "B<unsigned int sleep(unsigned int >I<seconds>B<);>\n"
13198 msgstr ""
13199
13200 #. type: Plain text
13201 #: build/C/man3/sleep.3:40
13202 msgid ""
13203 "B<sleep>()  makes the calling thread sleep until I<seconds> seconds have "
13204 "elapsed or a signal arrives which is not ignored."
13205 msgstr ""
13206
13207 #. type: Plain text
13208 #: build/C/man3/sleep.3:44
13209 msgid ""
13210 "Zero if the requested time has elapsed, or the number of seconds left to "
13211 "sleep, if the call was interrupted by a signal handler."
13212 msgstr ""
13213
13214 #. type: Plain text
13215 #: build/C/man3/sleep.3:55
13216 msgid ""
13217 "B<sleep>()  may be implemented using B<SIGALRM>; mixing calls to B<alarm>(2)  "
13218 "and B<sleep>()  is a bad idea."
13219 msgstr ""
13220
13221 #. type: Plain text
13222 #: build/C/man3/sleep.3:61
13223 msgid ""
13224 "Using B<longjmp>(3)  from a signal handler or modifying the handling of "
13225 "B<SIGALRM> while sleeping will cause undefined results."
13226 msgstr ""
13227
13228 #. type: Plain text
13229 #: build/C/man3/sleep.3:66
13230 msgid "B<alarm>(2), B<nanosleep>(2), B<signal>(2), B<signal>(7)"
13231 msgstr ""
13232
13233 #. type: TH
13234 #: build/C/man3/swab.3:31
13235 #, no-wrap
13236 msgid "SWAB"
13237 msgstr ""
13238
13239 #. type: TH
13240 #: build/C/man3/swab.3:31
13241 #, no-wrap
13242 msgid "2001-12-15"
13243 msgstr ""
13244
13245 #. type: Plain text
13246 #: build/C/man3/swab.3:34
13247 msgid "swab - swap adjacent bytes"
13248 msgstr ""
13249
13250 #. type: Plain text
13251 #: build/C/man3/swab.3:38
13252 #, no-wrap
13253 msgid ""
13254 "B<#define _XOPEN_SOURCE>       /* See feature_test_macros(7) */\n"
13255 "B<#include E<lt>unistd.hE<gt>>\n"
13256 msgstr ""
13257
13258 #. type: Plain text
13259 #: build/C/man3/swab.3:40
13260 #, no-wrap
13261 msgid "B<void swab(const void *>I<from>B<, void *>I<to>B<, ssize_t >I<n>B<);>\n"
13262 msgstr ""
13263
13264 #. type: Plain text
13265 #: build/C/man3/swab.3:55
13266 msgid ""
13267 "The B<swab>()  function copies I<n> bytes from the array pointed to by "
13268 "I<from> to the array pointed to by I<to>, exchanging adjacent even and odd "
13269 "bytes.  This function is used to exchange data between machines that have "
13270 "different low/high byte ordering."
13271 msgstr ""
13272
13273 #. type: Plain text
13274 #: build/C/man3/swab.3:68
13275 msgid ""
13276 "This function does nothing when I<n> is negative.  When I<n> is positive and "
13277 "odd, it handles I<n-1> bytes as above, and does something unspecified with "
13278 "the last byte.  (In other words, I<n> should be even.)"
13279 msgstr ""
13280
13281 #. type: Plain text
13282 #: build/C/man3/swab.3:72
13283 msgid "The B<swab>()  function returns no value."
13284 msgstr ""
13285
13286 #. type: Plain text
13287 #: build/C/man3/swab.3:76
13288 msgid "B<bstring>(3)"
13289 msgstr ""
13290
13291 #. type: TH
13292 #: build/C/man2/swapon.2:37
13293 #, no-wrap
13294 msgid "SWAPON"
13295 msgstr ""
13296
13297 #. type: TH
13298 #: build/C/man2/swapon.2:37
13299 #, no-wrap
13300 msgid "2010-11-15"
13301 msgstr ""
13302
13303 #. type: Plain text
13304 #: build/C/man2/swapon.2:40
13305 msgid "swapon, swapoff - start/stop swapping to file/device"
13306 msgstr ""
13307
13308 #. type: Plain text
13309 #: build/C/man2/swapon.2:44
13310 msgid "B<#include E<lt>asm/page.hE<gt> /* to find PAGE_SIZE */>"
13311 msgstr ""
13312
13313 #. type: Plain text
13314 #: build/C/man2/swapon.2:46
13315 msgid "B<#include E<lt>sys/swap.hE<gt>>"
13316 msgstr ""
13317
13318 #. type: Plain text
13319 #: build/C/man2/swapon.2:48
13320 msgid "B<int swapon(const char *>I<path>B<, int >I<swapflags>B<);>"
13321 msgstr ""
13322
13323 #. type: Plain text
13324 #: build/C/man2/swapon.2:50
13325 msgid "B<int swapoff(const char *>I<path>B<);>"
13326 msgstr ""
13327
13328 #. type: Plain text
13329 #: build/C/man2/swapon.2:57
13330 msgid ""
13331 "B<swapon>()  sets the swap area to the file or block device specified by "
13332 "I<path>.  B<swapoff>()  stops swapping to the file or block device specified "
13333 "by I<path>."
13334 msgstr ""
13335
13336 #. type: Plain text
13337 #: build/C/man2/swapon.2:67
13338 msgid ""
13339 "If the B<SWAP_FLAG_PREFER> flag is specified in the B<swapon>()  "
13340 "I<swapflags> argument, the new swap area will have a higher priority than "
13341 "default.  The priority is encoded within I<swapflags> as:"
13342 msgstr ""
13343
13344 #. type: Plain text
13345 #: build/C/man2/swapon.2:70
13346 msgid "I<(prio E<lt>E<lt> SWAP_FLAG_PRIO_SHIFT) & SWAP_FLAG_PRIO_MASK>"
13347 msgstr ""
13348
13349 #. type: Plain text
13350 #: build/C/man2/swapon.2:82
13351 msgid ""
13352 "If the B<SWAP_FLAG_DISCARD> flag is specified in the B<swapon>()  "
13353 "I<swapflags> argument, freed swap pages will be discarded before they are "
13354 "reused, if the swap device supports the discard or trim operation.  (This "
13355 "may improve performance on some Solid State Devices, but often it does not.)  "
13356 "See also NOTES."
13357 msgstr ""
13358
13359 #. type: Plain text
13360 #: build/C/man2/swapon.2:86
13361 msgid ""
13362 "These functions may be used only by a privileged process (one having the "
13363 "B<CAP_SYS_ADMIN> capability)."
13364 msgstr ""
13365
13366 #. type: SS
13367 #: build/C/man2/swapon.2:86
13368 #, no-wrap
13369 msgid "Priority"
13370 msgstr ""
13371
13372 #. type: Plain text
13373 #: build/C/man2/swapon.2:91
13374 msgid ""
13375 "Each swap area has a priority, either high or low.  The default priority is "
13376 "low.  Within the low-priority areas, newer areas are even lower priority "
13377 "than older areas."
13378 msgstr ""
13379
13380 #. type: Plain text
13381 #: build/C/man2/swapon.2:97
13382 msgid ""
13383 "All priorities set with I<swapflags> are high-priority, higher than "
13384 "default.  They may have any nonnegative value chosen by the caller.  Higher "
13385 "numbers mean higher priority."
13386 msgstr ""
13387
13388 #. type: Plain text
13389 #: build/C/man2/swapon.2:105
13390 msgid ""
13391 "Swap pages are allocated from areas in priority order, highest priority "
13392 "first.  For areas with different priorities, a higher-priority area is "
13393 "exhausted before using a lower-priority area.  If two or more areas have the "
13394 "same priority, and it is the highest priority available, pages are allocated "
13395 "on a round-robin basis between them."
13396 msgstr ""
13397
13398 #. type: Plain text
13399 #: build/C/man2/swapon.2:108
13400 msgid ""
13401 "As of Linux 1.3.6, the kernel usually follows these rules, but there are "
13402 "exceptions."
13403 msgstr ""
13404
13405 #. type: Plain text
13406 #: build/C/man2/swapon.2:121
13407 msgid ""
13408 "(for B<swapon>())  The specified I<path> is already being used as a swap "
13409 "area."
13410 msgstr ""
13411
13412 #. type: Plain text
13413 #: build/C/man2/swapon.2:133
13414 msgid ""
13415 "The file I<path> exists, but refers neither to a regular file nor to a block "
13416 "device; or, for B<swapon>(), the indicated path does not contain a valid "
13417 "swap signature or resides on an in-memory file system like tmpfs; or, for "
13418 "B<swapoff>(), I<path> is not currently a swap area."
13419 msgstr ""
13420
13421 #. type: Plain text
13422 #: build/C/man2/swapon.2:141
13423 msgid "The file I<path> does not exist."
13424 msgstr ""
13425
13426 #. type: Plain text
13427 #: build/C/man2/swapon.2:144
13428 msgid "The system has insufficient memory to start swapping."
13429 msgstr ""
13430
13431 #. type: Plain text
13432 #: build/C/man2/swapon.2:151
13433 msgid ""
13434 "The caller does not have the B<CAP_SYS_ADMIN> capability.  Alternatively, "
13435 "the maximum number of swap files are already in use; see NOTES below."
13436 msgstr ""
13437
13438 #. type: Plain text
13439 #: build/C/man2/swapon.2:157
13440 msgid ""
13441 "These functions are Linux-specific and should not be used in programs "
13442 "intended to be portable.  The second I<swapflags> argument was introduced in "
13443 "Linux 1.3.2."
13444 msgstr ""
13445
13446 #. type: Plain text
13447 #: build/C/man2/swapon.2:160
13448 msgid "The partition or path must be prepared with B<mkswap>(8)."
13449 msgstr ""
13450
13451 #. type: Plain text
13452 #: build/C/man2/swapon.2:180
13453 msgid ""
13454 "There is an upper limit on the number of swap files that may be used, "
13455 "defined by the kernel constant B<MAX_SWAPFILES>.  Before kernel 2.4.10, "
13456 "B<MAX_SWAPFILES> has the value 8; since kernel 2.4.10, it has the value 32.  "
13457 "Since kernel 2.6.18, the limit is decreased by 2 (thus: 30)  if the kernel "
13458 "is built with the B<CONFIG_MIGRATION> option (which reserves two swap table "
13459 "entries for the page migration features of B<mbind>(2)  and "
13460 "B<migrate_pages>(2)).  Since kernel 2.6.32, the limit is further decreased "
13461 "by 1 if the kernel is built with the B<CONFIG_MEMORY_FAILURE> option."
13462 msgstr ""
13463
13464 #.  To be precise: 2.6.35.5
13465 #. type: Plain text
13466 #: build/C/man2/swapon.2:191
13467 msgid ""
13468 "Discard of swap pages was introduced in kernel 2.6.29, then made conditional "
13469 "on the B<SWAP_FLAG_DISCARD> flag in kernel 2.6.36, which still discards the "
13470 "entire swap area when B<swapon>()  is called, even if that flag bit is not "
13471 "set."
13472 msgstr ""
13473
13474 #. type: Plain text
13475 #: build/C/man2/swapon.2:195
13476 msgid "B<mkswap>(8), B<swapoff>(8), B<swapon>(8)"
13477 msgstr ""
13478
13479 #. type: TH
13480 #: build/C/man2/syscall.2:40
13481 #, no-wrap
13482 msgid "SYSCALL"
13483 msgstr ""
13484
13485 #. type: Plain text
13486 #: build/C/man2/syscall.2:43
13487 msgid "syscall - indirect system call"
13488 msgstr ""
13489
13490 #. type: Plain text
13491 #: build/C/man2/syscall.2:48
13492 #, no-wrap
13493 msgid ""
13494 "B<#define _GNU_SOURCE>         /* See feature_test_macros(7) */\n"
13495 "B<#include E<lt>unistd.hE<gt>>\n"
13496 "B<#include E<lt>sys/syscall.hE<gt>   >/* For SYS_xxx definitions */\n"
13497 msgstr ""
13498
13499 #. type: Plain text
13500 #: build/C/man2/syscall.2:50
13501 #, no-wrap
13502 msgid "B<int syscall(int >I<number>B<, ...);>\n"
13503 msgstr ""
13504
13505 #. type: Plain text
13506 #: build/C/man2/syscall.2:62
13507 msgid ""
13508 "B<syscall>()  is a small library function that invokes the system call whose "
13509 "assembly language interface has the specified I<number> with the specified "
13510 "arguments.  Employing B<syscall>()  is useful, for example, when invoking a "
13511 "system call that has no wrapper function in the C library."
13512 msgstr ""
13513
13514 #. type: Plain text
13515 #: build/C/man2/syscall.2:69
13516 msgid ""
13517 "B<syscall>()  saves CPU registers before making the system call, restores "
13518 "the registers upon return from the system call, and stores any error code "
13519 "returned by the system call in B<errno>(3)  if an error occurs."
13520 msgstr ""
13521
13522 #. type: Plain text
13523 #: build/C/man2/syscall.2:72
13524 msgid ""
13525 "Symbolic constants for system call numbers can be found in the header file "
13526 "I<E<lt>sys/syscall.hE<gt>>."
13527 msgstr ""
13528
13529 #. type: Plain text
13530 #: build/C/man2/syscall.2:78
13531 msgid ""
13532 "The return value is defined by the system call being invoked.  In general, a "
13533 "0 return value indicates success.  A -1 return value indicates an error, and "
13534 "an error code is stored in I<errno>."
13535 msgstr ""
13536
13537 #. type: Plain text
13538 #: build/C/man2/syscall.2:82
13539 msgid "B<syscall>()  first appeared in 4BSD."
13540 msgstr ""
13541
13542 #. type: SS
13543 #: build/C/man2/syscall.2:82
13544 #, no-wrap
13545 msgid "Architecture-specific requirements"
13546 msgstr ""
13547
13548 #. type: Plain text
13549 #: build/C/man2/syscall.2:93
13550 msgid ""
13551 "Each architecture ABI has its own requirements on how system call arguments "
13552 "are passed to the kernel.  For system calls that have a glibc wrapper (e.g., "
13553 "most system calls), glibc handles the details of copying arguments to the "
13554 "right registers in a manner suitable for the architecture.  However, when "
13555 "using B<syscall>()  to make a system call, the caller might need to handle "
13556 "architecture-dependent details; this requirement is most commonly "
13557 "encountered on certain 32-bit architectures."
13558 msgstr ""
13559
13560 #. type: Plain text
13561 #: build/C/man2/syscall.2:104
13562 msgid ""
13563 "For example, on the ARM architecture Embedded ABI (EABI), a 64-bit value "
13564 "(e.g., I<long long>)  must be aligned to an even register pair.  Thus, using "
13565 "B<syscall>()  instead of the wrapper provided by glibc, the B<readahead>()  "
13566 "system call would be invoked as follows on the ARM architecture with the "
13567 "EABI:"
13568 msgstr ""
13569
13570 #. type: Plain text
13571 #: build/C/man2/syscall.2:111
13572 #, no-wrap
13573 msgid ""
13574 "syscall(SYS_readahead, fd, 0,\n"
13575 "        (unsigned int) (offset E<gt>E<gt> 32),\n"
13576 "        (unsigned int) (offset & 0xFFFFFFFF),\n"
13577 "        count);\n"
13578 msgstr ""
13579
13580 #. type: Plain text
13581 #: build/C/man2/syscall.2:125
13582 msgid ""
13583 "Since the offset argument is 64 bits, and the first argument (I<fd>)  is "
13584 "passed in I<r0>, the caller must manually split and align the 64-bit value "
13585 "so that it is passed in the I<r2>/I<r3> register pair.  That means inserting "
13586 "a dummy value into I<r1> (the second argument of 0)."
13587 msgstr ""
13588
13589 #.  Mike Frysinger: this issue ends up forcing MIPS
13590 #.  O32 to take 7 arguments to syscall()
13591 #. type: Plain text
13592 #: build/C/man2/syscall.2:130
13593 msgid ""
13594 "Similar issues can occur on MIPS with the O32 ABI, on PowerPC with the "
13595 "32-bit ABI, and on Xtensa."
13596 msgstr ""
13597
13598 #. type: Plain text
13599 #: build/C/man2/syscall.2:141
13600 msgid ""
13601 "The affected system calls are B<fadvise64_64>(2), B<ftruncate64>(2), "
13602 "B<posix_fadvise>(2), B<pread64>(2), B<pwrite64>(2), B<readahead>(2), "
13603 "B<sync_file_range>(2), and B<truncate64>(2)."
13604 msgstr ""
13605
13606 #. type: SS
13607 #: build/C/man2/syscall.2:141
13608 #, no-wrap
13609 msgid "Architecture calling conventions"
13610 msgstr ""
13611
13612 #. type: Plain text
13613 #: build/C/man2/syscall.2:145
13614 msgid ""
13615 "Every architecture has its own way of invoking and passing arguments to the "
13616 "kernel.  The details for various architectures are listed in the two tables "
13617 "below."
13618 msgstr ""
13619
13620 #. type: Plain text
13621 #: build/C/man2/syscall.2:151
13622 msgid ""
13623 "The first table lists the instruction used to transition to kernel mode, "
13624 "(which might not be the fastest or best way to transition to the kernel, so "
13625 "you might have to refer to the VDSO), the register used to indicate the "
13626 "system call number, and the register used to return the system call result."
13627 msgstr ""
13628
13629 #. type: tbl table
13630 #: build/C/man2/syscall.2:156
13631 #, no-wrap
13632 msgid "arch/ABI\tinstruction\tsyscall #\tretval\tNotes\n"
13633 msgstr ""
13634
13635 #. type: tbl table
13636 #: build/C/man2/syscall.2:158
13637 #, no-wrap
13638 msgid "arm/OABI\tswi NR\t-\ta1\tNR is syscall #\n"
13639 msgstr ""
13640
13641 #. type: tbl table
13642 #: build/C/man2/syscall.2:159
13643 #, no-wrap
13644 msgid "arm/EABI\tswi 0x0\tr7\tr1\n"
13645 msgstr ""
13646
13647 #. type: tbl table
13648 #: build/C/man2/syscall.2:160
13649 #, no-wrap
13650 msgid "blackfin\texcpt 0x0\tP0\tR0\n"
13651 msgstr ""
13652
13653 #. type: tbl table
13654 #: build/C/man2/syscall.2:161
13655 #, no-wrap
13656 msgid "i386\tint $0x80\teax\teax\n"
13657 msgstr ""
13658
13659 #. type: tbl table
13660 #: build/C/man2/syscall.2:162
13661 #, no-wrap
13662 msgid "ia64\tbreak 0x100000\tr15\tr10/r8\n"
13663 msgstr ""
13664
13665 #. type: tbl table
13666 #: build/C/man2/syscall.2:163
13667 #, no-wrap
13668 msgid "parisc\tble 0x100(%sr2, %r0)\tr20\tr28\n"
13669 msgstr ""
13670
13671 #. type: tbl table
13672 #: build/C/man2/syscall.2:164
13673 #, no-wrap
13674 msgid "s390\tsvc 0\tr1\tr2\tNR may be passed directly with\n"
13675 msgstr ""
13676
13677 #. type: tbl table
13678 #: build/C/man2/syscall.2:165
13679 #, no-wrap
13680 msgid "s390x\tsvc 0\tr1\tr2\t\"svc NR\" if NR is less than 256\n"
13681 msgstr ""
13682
13683 #. type: tbl table
13684 #: build/C/man2/syscall.2:166
13685 #, no-wrap
13686 msgid "sparc/32\tt 0x10\tg1\to0\n"
13687 msgstr ""
13688
13689 #. type: tbl table
13690 #: build/C/man2/syscall.2:167
13691 #, no-wrap
13692 msgid "sparc/64\tt 0x6d\tg1\to0\n"
13693 msgstr ""
13694
13695 #. type: tbl table
13696 #: build/C/man2/syscall.2:168
13697 #, no-wrap
13698 msgid "x86_64\tsyscall\trax\trax\n"
13699 msgstr ""
13700
13701 #. type: Plain text
13702 #: build/C/man2/syscall.2:176
13703 msgid "The second table shows the registers used to pass the system call arguments."
13704 msgstr ""
13705
13706 #. type: tbl table
13707 #: build/C/man2/syscall.2:181
13708 #, no-wrap
13709 msgid "arch/ABI\targ1\targ2\targ3\targ4\targ5\targ6\targ7\n"
13710 msgstr ""
13711
13712 #. type: tbl table
13713 #: build/C/man2/syscall.2:183
13714 #, no-wrap
13715 msgid "arm/OABI\ta1\ta2\ta3\ta4\tv1\tv2\tv3\n"
13716 msgstr ""
13717
13718 #. type: tbl table
13719 #: build/C/man2/syscall.2:184
13720 #, no-wrap
13721 msgid "arm/EABI\tr1\tr2\tr3\tr4\tr5\tr6\tr7\n"
13722 msgstr ""
13723
13724 #. type: tbl table
13725 #: build/C/man2/syscall.2:185
13726 #, no-wrap
13727 msgid "blackfin\tR0\tR1\tR2\tR3\tR4\tR5\t-\n"
13728 msgstr ""
13729
13730 #. type: tbl table
13731 #: build/C/man2/syscall.2:186
13732 #, no-wrap
13733 msgid "i386\tebx\tecx\tedx\tesi\tedi\tebp\t-\n"
13734 msgstr ""
13735
13736 #. type: tbl table
13737 #: build/C/man2/syscall.2:187
13738 #, no-wrap
13739 msgid "ia64\tr11\tr9\tr10\tr14\tr15\tr13\t-\n"
13740 msgstr ""
13741
13742 #. type: tbl table
13743 #: build/C/man2/syscall.2:188
13744 #, no-wrap
13745 msgid "parisc\tr26\tr25\tr24\tr23\tr22\tr21\t-\n"
13746 msgstr ""
13747
13748 #. type: tbl table
13749 #: build/C/man2/syscall.2:189
13750 #, no-wrap
13751 msgid "s390\tr2\tr3\tr4\tr5\tr6\tr7\t-\n"
13752 msgstr ""
13753
13754 #. type: tbl table
13755 #: build/C/man2/syscall.2:190
13756 #, no-wrap
13757 msgid "s390x\tr2\tr3\tr4\tr5\tr6\tr7\t-\n"
13758 msgstr ""
13759
13760 #. type: tbl table
13761 #: build/C/man2/syscall.2:191
13762 #, no-wrap
13763 msgid "sparc/32\to0\to1\to2\to3\to4\to5\t-\n"
13764 msgstr ""
13765
13766 #. type: tbl table
13767 #: build/C/man2/syscall.2:192
13768 #, no-wrap
13769 msgid "sparc/64\to0\to1\to2\to3\to4\to5\t-\n"
13770 msgstr ""
13771
13772 #. type: tbl table
13773 #: build/C/man2/syscall.2:193
13774 #, no-wrap
13775 msgid "x86_64\trdi\trsi\trdx\tr10\tr8\tr9\t-\n"
13776 msgstr ""
13777
13778 #. type: Plain text
13779 #: build/C/man2/syscall.2:202
13780 msgid ""
13781 "Note that these tables don't cover the entire calling convention\\(emsome "
13782 "architectures may indiscriminately clobber other registers not listed here."
13783 msgstr ""
13784
13785 #. type: Plain text
13786 #: build/C/man2/syscall.2:208
13787 #, no-wrap
13788 msgid ""
13789 "#define _GNU_SOURCE\n"
13790 "#include E<lt>unistd.hE<gt>\n"
13791 "#include E<lt>sys/syscall.hE<gt>\n"
13792 "#include E<lt>sys/types.hE<gt>\n"
13793 msgstr ""
13794
13795 #. type: Plain text
13796 #: build/C/man2/syscall.2:213
13797 #, no-wrap
13798 msgid ""
13799 "int\n"
13800 "main(int argc, char *argv[])\n"
13801 "{\n"
13802 "    pid_t tid;\n"
13803 msgstr ""
13804
13805 #. type: Plain text
13806 #: build/C/man2/syscall.2:217
13807 #, no-wrap
13808 msgid ""
13809 "    tid = syscall(SYS_gettid);\n"
13810 "    tid = syscall(SYS_tgkill, getpid(), tid);\n"
13811 "}\n"
13812 msgstr ""
13813
13814 #. type: Plain text
13815 #: build/C/man2/syscall.2:222
13816 msgid "B<_syscall>(2), B<intro>(2), B<syscalls>(2)"
13817 msgstr ""
13818
13819 #. type: TH
13820 #: build/C/man2/syscalls.2:31
13821 #, no-wrap
13822 msgid "SYSCALLS"
13823 msgstr ""
13824
13825 #. type: TH
13826 #: build/C/man2/syscalls.2:31
13827 #, no-wrap
13828 msgid "2013-04-17"
13829 msgstr ""
13830
13831 #. type: Plain text
13832 #: build/C/man2/syscalls.2:34
13833 msgid "syscalls - Linux system calls"
13834 msgstr ""
13835
13836 #. type: Plain text
13837 #: build/C/man2/syscalls.2:36
13838 msgid "Linux system calls."
13839 msgstr ""
13840
13841 #. type: Plain text
13842 #: build/C/man2/syscalls.2:39
13843 msgid ""
13844 "The system call is the fundamental interface between an application and the "
13845 "Linux kernel."
13846 msgstr ""
13847
13848 #. type: SS
13849 #: build/C/man2/syscalls.2:39
13850 #, no-wrap
13851 msgid "System calls and library wrapper functions"
13852 msgstr ""
13853
13854 #. type: Plain text
13855 #: build/C/man2/syscalls.2:49
13856 msgid ""
13857 "System calls are generally not invoked directly, but rather via wrapper "
13858 "functions in glibc (or perhaps some other library).  For details of direct "
13859 "invocation of a system call, see B<intro>(2).  Often, but not always, the "
13860 "name of the wrapper function is the same as the name of the system call that "
13861 "it invokes.  For example, glibc contains a function B<truncate>()  which "
13862 "invokes the underlying \"truncate\" system call."
13863 msgstr ""
13864
13865 #. type: Plain text
13866 #: build/C/man2/syscalls.2:67
13867 msgid ""
13868 "Often the glibc wrapper function is quite thin, doing little work other than "
13869 "copying arguments to the right registers before invoking the system call, "
13870 "and then setting I<errno> appropriately after the system call has returned.  "
13871 "(These are the same steps that are performed by B<syscall>(2), which can be "
13872 "used to invoke system calls for which no wrapper function is provided.)  "
13873 "Note: system calls indicate a failure by returning a negative error number "
13874 "to the caller; when this happens, the wrapper function negates the returned "
13875 "error number (to make it positive), copies it to I<errno>, and returns -1 to "
13876 "the caller of the wrapper."
13877 msgstr ""
13878
13879 #. type: Plain text
13880 #: build/C/man2/syscalls.2:79
13881 msgid ""
13882 "Sometimes, however, the wrapper function does some extra work before "
13883 "invoking the system call.  For example, nowadays there are (for reasons "
13884 "described below) two related system calls, B<truncate>(2)  and "
13885 "B<truncate64>(2), and the glibc B<truncate>()  wrapper function checks which "
13886 "of those system calls are provided by the kernel and determines which should "
13887 "be employed."
13888 msgstr ""
13889
13890 #. type: SS
13891 #: build/C/man2/syscalls.2:79
13892 #, no-wrap
13893 msgid "System call list"
13894 msgstr ""
13895
13896 #. type: Plain text
13897 #: build/C/man2/syscalls.2:87
13898 msgid ""
13899 "Below is a list of the Linux system calls.  In the list, the I<Kernel> "
13900 "column indicates the kernel version for those system calls that were new in "
13901 "Linux 2.2, or have appeared since that kernel version.  Note the following "
13902 "points:"
13903 msgstr ""
13904
13905 #. type: Plain text
13906 #: build/C/man2/syscalls.2:90
13907 msgid ""
13908 "Where no kernel version is indicated, the system call appeared in kernel 1.0 "
13909 "or earlier."
13910 msgstr ""
13911
13912 #. type: Plain text
13913 #: build/C/man2/syscalls.2:96
13914 msgid ""
13915 "Where a system call is marked \"1.2\" this means the system call probably "
13916 "appeared in a 1.1.x kernel version, and first appeared in a stable kernel "
13917 "with 1.2.  (Development of the 1.2 kernel was initiated from a branch of "
13918 "kernel 1.0.6 via the 1.1.x unstable kernel series.)"
13919 msgstr ""
13920
13921 #.  Was kernel 2.0 started from a branch of 1.2.10?
13922 #.  At least from the timestamps of the tarballs of
13923 #.  of 1.2.10 and 1.3.0, that's how it looks, but in
13924 #.  fact the diff doesn't seem very clear, the
13925 #.  1.3.0 .tar.bz is much bigger (2.0 MB) than the
13926 #.  1.2.10 .tar.bz2 (1.8 MB), and AEB points out the
13927 #.  timestamps of some files in 1.3.0 seem to be older
13928 #.  than those in 1.2.10.  All of this suggests
13929 #.  that there might not have been a clean branch point.
13930 #. type: Plain text
13931 #: build/C/man2/syscalls.2:112
13932 msgid ""
13933 "Where a system call is marked \"2.0\" this means the system call probably "
13934 "appeared in a 1.3.x kernel version, and first appeared in a stable kernel "
13935 "with 2.0.  (Development of the 2.0 kernel was initiated from a branch of "
13936 "kernel 1.2.x, somewhere around 1.2.10, via the 1.3.x unstable kernel "
13937 "series.)"
13938 msgstr ""
13939
13940 #. type: Plain text
13941 #: build/C/man2/syscalls.2:118
13942 msgid ""
13943 "Where a system call is marked \"2.2\" this means the system call probably "
13944 "appeared in a 2.1.x kernel version, and first appeared in a stable kernel "
13945 "with 2.2.0.  (Development of the 2.2 kernel was initiated from a branch of "
13946 "kernel 2.0.21 via the 2.1.x unstable kernel series.)"
13947 msgstr ""
13948
13949 #. type: Plain text
13950 #: build/C/man2/syscalls.2:124
13951 msgid ""
13952 "Where a system call is marked \"2.4\" this means the system call probably "
13953 "appeared in a 2.3.x kernel version, and first appeared in a stable kernel "
13954 "with 2.4.0.  (Development of the 2.4 kernel was initiated from a branch of "
13955 "kernel 2.2.8 via the 2.3.x unstable kernel series.)"
13956 msgstr ""
13957
13958 #. type: Plain text
13959 #: build/C/man2/syscalls.2:130
13960 msgid ""
13961 "Where a system call is marked \"2.6\" this means the system call probably "
13962 "appeared in a 2.5.x kernel version, and first appeared in a stable kernel "
13963 "with 2.6.0.  (Development of kernel 2.6 was initiated from a branch of "
13964 "kernel 2.4.15 via the 2.5.x unstable kernel series.)"
13965 msgstr ""
13966
13967 #. type: Plain text
13968 #: build/C/man2/syscalls.2:137
13969 msgid ""
13970 "Starting with kernel 2.6.0, the development model changed, and new system "
13971 "calls may appear in each 2.6.x release.  In this case, the exact version "
13972 "number where the system call appeared is shown.  This convention continues "
13973 "with the 3.x kernel series, which followed on from kernel 2.6.39."
13974 msgstr ""
13975
13976 #. type: Plain text
13977 #: build/C/man2/syscalls.2:145
13978 msgid ""
13979 "In some cases, a system call was added to a stable kernel series after it "
13980 "branched from the previous stable kernel series, and then backported into "
13981 "the earlier stable kernel series.  For example some system calls that "
13982 "appeared in 2.6.x were also backported into a 2.4.x release after 2.4.15.  "
13983 "When this is so, the version where the system call appeared in both of the "
13984 "major kernel series is listed."
13985 msgstr ""
13986
13987 #
13988 #.  Looking at scripts/checksyscalls.sh in the kernel source is
13989 #.  instructive about x86 specifics.
13990 #. type: Plain text
13991 #: build/C/man2/syscalls.2:152
13992 msgid ""
13993 "The list of system calls that are available as at kernel 3.9 (or in a few "
13994 "cases only on older kernels) is as follows:"
13995 msgstr ""
13996
13997 #. type: tbl table
13998 #: build/C/man2/syscalls.2:157
13999 #, no-wrap
14000 msgid "B<System call>\tB<Kernel>\tB<Notes>\n"
14001 msgstr ""
14002
14003 #. type: tbl table
14004 #: build/C/man2/syscalls.2:159
14005 #, no-wrap
14006 msgid "B<_llseek>(2)\t1.2\n"
14007 msgstr ""
14008
14009 #. type: tbl table
14010 #: build/C/man2/syscalls.2:160
14011 #, no-wrap
14012 msgid "B<_newselect>(2)\t2.0\n"
14013 msgstr ""
14014
14015 #. type: tbl table
14016 #: build/C/man2/syscalls.2:161
14017 #, no-wrap
14018 msgid "B<_sysctl>(2)\t2.0\n"
14019 msgstr ""
14020
14021 #. type: tbl table
14022 #: build/C/man2/syscalls.2:162
14023 #, no-wrap
14024 msgid "B<accept>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
14025 msgstr ""
14026
14027 #. type: tbl table
14028 #: build/C/man2/syscalls.2:163
14029 #, no-wrap
14030 msgid "B<accept4>(2)\t2.6.28\n"
14031 msgstr ""
14032
14033 #. type: tbl table
14034 #: build/C/man2/syscalls.2:164
14035 #, no-wrap
14036 msgid "B<access>(2)\t1.0\n"
14037 msgstr ""
14038
14039 #. type: tbl table
14040 #: build/C/man2/syscalls.2:165
14041 #, no-wrap
14042 msgid "B<acct>(2)\t1.0\n"
14043 msgstr ""
14044
14045 #. type: tbl table
14046 #: build/C/man2/syscalls.2:166
14047 #, no-wrap
14048 msgid "B<add_key>(2)\t2.6.11\n"
14049 msgstr ""
14050
14051 #. type: tbl table
14052 #: build/C/man2/syscalls.2:167
14053 #, no-wrap
14054 msgid "B<adjtimex>(2)\t1.0\n"
14055 msgstr ""
14056
14057 #. type: tbl table
14058 #: build/C/man2/syscalls.2:168
14059 #, no-wrap
14060 msgid "B<alarm>(2)\t1.0\n"
14061 msgstr ""
14062
14063 #. type: tbl table
14064 #: build/C/man2/syscalls.2:169
14065 #, no-wrap
14066 msgid "B<alloc_hugepages>(2)\t2.5.36\tRemoved in 2.5.44\n"
14067 msgstr ""
14068
14069 #. type: tbl table
14070 #: build/C/man2/syscalls.2:170
14071 #, no-wrap
14072 msgid "B<bdflush>(2)\t1.2\tT{\n"
14073 msgstr ""
14074
14075 #. type: tbl table
14076 #: build/C/man2/syscalls.2:171
14077 #, no-wrap
14078 msgid "Deprecated (does nothing)\n"
14079 msgstr ""
14080
14081 #. type: tbl table
14082 #: build/C/man2/syscalls.2:172 build/C/man2/syscalls.2:184 build/C/man2/syscalls.2:314 build/C/man2/syscalls.2:387 build/C/man2/syscalls.2:403 build/C/man2/syscalls.2:415
14083 #, no-wrap
14084 msgid ".br\n"
14085 msgstr ""
14086
14087 #. type: tbl table
14088 #: build/C/man2/syscalls.2:173
14089 #, no-wrap
14090 msgid "since 2.6\n"
14091 msgstr ""
14092
14093 #. type: tbl table
14094 #: build/C/man2/syscalls.2:174 build/C/man2/syscalls.2:186 build/C/man2/syscalls.2:316 build/C/man2/syscalls.2:389 build/C/man2/syscalls.2:405 build/C/man2/syscalls.2:417 build/C/man2/syscalls.2:545 build/C/man2/syscalls.2:590
14095 #, no-wrap
14096 msgid "T}\n"
14097 msgstr ""
14098
14099 #. type: tbl table
14100 #: build/C/man2/syscalls.2:175
14101 #, no-wrap
14102 msgid "B<bind>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
14103 msgstr ""
14104
14105 #. type: tbl table
14106 #: build/C/man2/syscalls.2:176
14107 #, no-wrap
14108 msgid "B<brk>(2)\t1.0\n"
14109 msgstr ""
14110
14111 #. type: tbl table
14112 #: build/C/man2/syscalls.2:177
14113 #, no-wrap
14114 msgid "B<cacheflush>(2)\t1.2\tNot on x86\n"
14115 msgstr ""
14116
14117 #. type: tbl table
14118 #: build/C/man2/syscalls.2:178
14119 #, no-wrap
14120 msgid "B<capget>(2)\t2.2\n"
14121 msgstr ""
14122
14123 #. type: tbl table
14124 #: build/C/man2/syscalls.2:179
14125 #, no-wrap
14126 msgid "B<capset>(2)\t2.2\n"
14127 msgstr ""
14128
14129 #. type: tbl table
14130 #: build/C/man2/syscalls.2:180
14131 #, no-wrap
14132 msgid "B<chdir>(2)\t1.0\n"
14133 msgstr ""
14134
14135 #. type: tbl table
14136 #: build/C/man2/syscalls.2:181
14137 #, no-wrap
14138 msgid "B<chmod>(2)\t1.0\n"
14139 msgstr ""
14140
14141 #. type: tbl table
14142 #: build/C/man2/syscalls.2:182
14143 #, no-wrap
14144 msgid "B<chown>(2)\t2.2\tT{\n"
14145 msgstr ""
14146
14147 #. type: tbl table
14148 #: build/C/man2/syscalls.2:183 build/C/man2/syscalls.2:313
14149 #, no-wrap
14150 msgid "See B<chown>(2) for\n"
14151 msgstr ""
14152
14153 #. type: tbl table
14154 #: build/C/man2/syscalls.2:185 build/C/man2/syscalls.2:315
14155 #, no-wrap
14156 msgid "version details\n"
14157 msgstr ""
14158
14159 #. type: tbl table
14160 #: build/C/man2/syscalls.2:187
14161 #, no-wrap
14162 msgid "B<chown32>(2)\t2.4\n"
14163 msgstr ""
14164
14165 #. type: tbl table
14166 #: build/C/man2/syscalls.2:188
14167 #, no-wrap
14168 msgid "B<chroot>(2)\t1.0\n"
14169 msgstr ""
14170
14171 #. type: tbl table
14172 #: build/C/man2/syscalls.2:189
14173 #, no-wrap
14174 msgid "B<clock_adjtime>(2)\t2.6.39\n"
14175 msgstr ""
14176
14177 #. type: tbl table
14178 #: build/C/man2/syscalls.2:190
14179 #, no-wrap
14180 msgid "B<clock_getres>(2)\t2.6\n"
14181 msgstr ""
14182
14183 #. type: tbl table
14184 #: build/C/man2/syscalls.2:191
14185 #, no-wrap
14186 msgid "B<clock_gettime>(2)\t2.6\n"
14187 msgstr ""
14188
14189 #. type: tbl table
14190 #: build/C/man2/syscalls.2:192
14191 #, no-wrap
14192 msgid "B<clock_nanosleep>(2)\t2.6\n"
14193 msgstr ""
14194
14195 #. type: tbl table
14196 #: build/C/man2/syscalls.2:193
14197 #, no-wrap
14198 msgid "B<clock_settime>(2)\t2.6\n"
14199 msgstr ""
14200
14201 #. type: tbl table
14202 #: build/C/man2/syscalls.2:194
14203 #, no-wrap
14204 msgid "B<clone>(2)\t1.0\n"
14205 msgstr ""
14206
14207 #. type: tbl table
14208 #: build/C/man2/syscalls.2:195
14209 #, no-wrap
14210 msgid "B<close>(2)\t1.0\n"
14211 msgstr ""
14212
14213 #. type: tbl table
14214 #: build/C/man2/syscalls.2:196
14215 #, no-wrap
14216 msgid "B<connect>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
14217 msgstr ""
14218
14219 #. type: tbl table
14220 #: build/C/man2/syscalls.2:197
14221 #, no-wrap
14222 msgid "B<creat>(2)\t1.0\n"
14223 msgstr ""
14224
14225 #. type: tbl table
14226 #: build/C/man2/syscalls.2:198
14227 #, no-wrap
14228 msgid "B<create_module>(2)\t\tRemoved in 2.6\n"
14229 msgstr ""
14230
14231 #. type: tbl table
14232 #: build/C/man2/syscalls.2:199
14233 #, no-wrap
14234 msgid "B<delete_module>(2)\t1.0\n"
14235 msgstr ""
14236
14237 #. type: tbl table
14238 #: build/C/man2/syscalls.2:200
14239 #, no-wrap
14240 msgid "B<dup>(2)\t1.0\n"
14241 msgstr ""
14242
14243 #. type: tbl table
14244 #: build/C/man2/syscalls.2:201
14245 #, no-wrap
14246 msgid "B<dup2>(2)\t1.0\n"
14247 msgstr ""
14248
14249 #. type: tbl table
14250 #: build/C/man2/syscalls.2:202
14251 #, no-wrap
14252 msgid "B<dup3>(2)\t2.6.27\n"
14253 msgstr ""
14254
14255 #. type: tbl table
14256 #: build/C/man2/syscalls.2:203
14257 #, no-wrap
14258 msgid "B<epoll_create>(2)\t2.6\n"
14259 msgstr ""
14260
14261 #. type: tbl table
14262 #: build/C/man2/syscalls.2:204
14263 #, no-wrap
14264 msgid "B<epoll_create1>(2)\t2.6.27\n"
14265 msgstr ""
14266
14267 #. type: tbl table
14268 #: build/C/man2/syscalls.2:205
14269 #, no-wrap
14270 msgid "B<epoll_ctl>(2)\t2.6\n"
14271 msgstr ""
14272
14273 #. type: tbl table
14274 #: build/C/man2/syscalls.2:206
14275 #, no-wrap
14276 msgid "B<epoll_pwait>(2)\t2.6.19\n"
14277 msgstr ""
14278
14279 #. type: tbl table
14280 #: build/C/man2/syscalls.2:207
14281 #, no-wrap
14282 msgid "B<epoll_wait>(2)\t2.6\n"
14283 msgstr ""
14284
14285 #. type: tbl table
14286 #: build/C/man2/syscalls.2:208
14287 #, no-wrap
14288 msgid "B<eventfd>(2)\t2.6.22\n"
14289 msgstr ""
14290
14291 #. type: tbl table
14292 #: build/C/man2/syscalls.2:209
14293 #, no-wrap
14294 msgid "B<eventfd2>(2)\t2.6.27\n"
14295 msgstr ""
14296
14297 #. type: tbl table
14298 #: build/C/man2/syscalls.2:210
14299 #, no-wrap
14300 msgid "B<execve>(2)\t1.0\n"
14301 msgstr ""
14302
14303 #. type: tbl table
14304 #: build/C/man2/syscalls.2:211
14305 #, no-wrap
14306 msgid "B<exit>(2)\t1.0\n"
14307 msgstr ""
14308
14309 #. type: tbl table
14310 #: build/C/man2/syscalls.2:212
14311 #, no-wrap
14312 msgid "B<exit_group>(2)\t2.6\n"
14313 msgstr ""
14314
14315 #. type: tbl table
14316 #: build/C/man2/syscalls.2:213
14317 #, no-wrap
14318 msgid "B<faccessat>(2)\t2.6.16\n"
14319 msgstr ""
14320
14321 #. type: tbl table
14322 #: build/C/man2/syscalls.2:214
14323 #, no-wrap
14324 msgid "B<fadvise64>(2)\t2.6\n"
14325 msgstr ""
14326
14327 #.  Implements \fBposix_fadvise\fP(2)
14328 #. type: tbl table
14329 #: build/C/man2/syscalls.2:216
14330 #, no-wrap
14331 msgid "B<fadvise64_64>(2)\t2.6\n"
14332 msgstr ""
14333
14334 #. type: tbl table
14335 #: build/C/man2/syscalls.2:217
14336 #, no-wrap
14337 msgid "B<fallocate>(2)\t2.6.23\n"
14338 msgstr ""
14339
14340 #. type: tbl table
14341 #: build/C/man2/syscalls.2:218
14342 #, no-wrap
14343 msgid "B<fanotify_init>(2)\t2.6.37\n"
14344 msgstr ""
14345
14346 #. type: tbl table
14347 #: build/C/man2/syscalls.2:219
14348 #, no-wrap
14349 msgid "B<fanotify_mark>(2)\t2.6.37\n"
14350 msgstr ""
14351
14352 #.  The fanotify calls were added in Linux 2.6.36,
14353 #.  but disabled while the API was finalized.
14354 #. type: tbl table
14355 #: build/C/man2/syscalls.2:222
14356 #, no-wrap
14357 msgid "B<fchdir>(2)\t1.0\n"
14358 msgstr ""
14359
14360 #. type: tbl table
14361 #: build/C/man2/syscalls.2:223
14362 #, no-wrap
14363 msgid "B<fchmod>(2)\t1.0\n"
14364 msgstr ""
14365
14366 #. type: tbl table
14367 #: build/C/man2/syscalls.2:224
14368 #, no-wrap
14369 msgid "B<fchmodat>(2)\t2.6.16\n"
14370 msgstr ""
14371
14372 #. type: tbl table
14373 #: build/C/man2/syscalls.2:225
14374 #, no-wrap
14375 msgid "B<fchown>(2)\t1.0\n"
14376 msgstr ""
14377
14378 #. type: tbl table
14379 #: build/C/man2/syscalls.2:226
14380 #, no-wrap
14381 msgid "B<fchown32>(2)\t2.4\n"
14382 msgstr ""
14383
14384 #. type: tbl table
14385 #: build/C/man2/syscalls.2:227
14386 #, no-wrap
14387 msgid "B<fchownat>(2)\t2.6.16\n"
14388 msgstr ""
14389
14390 #. type: tbl table
14391 #: build/C/man2/syscalls.2:228
14392 #, no-wrap
14393 msgid "B<fcntl>(2)\t1.0\n"
14394 msgstr ""
14395
14396 #. type: tbl table
14397 #: build/C/man2/syscalls.2:229
14398 #, no-wrap
14399 msgid "B<fcntl64>(2)\t2.4\n"
14400 msgstr ""
14401
14402 #. type: tbl table
14403 #: build/C/man2/syscalls.2:230
14404 #, no-wrap
14405 msgid "B<fdatasync>(2)\t2.0\n"
14406 msgstr ""
14407
14408 #. type: tbl table
14409 #: build/C/man2/syscalls.2:231
14410 #, no-wrap
14411 msgid "B<fgetxattr>(2)\t2.6; 2.4.18\n"
14412 msgstr ""
14413
14414 #. type: tbl table
14415 #: build/C/man2/syscalls.2:232
14416 #, no-wrap
14417 msgid "B<finit_module>(2)\t3.8\n"
14418 msgstr ""
14419
14420 #. type: tbl table
14421 #: build/C/man2/syscalls.2:233
14422 #, no-wrap
14423 msgid "B<flistxattr>(2)\t2.6; 2.4.18\n"
14424 msgstr ""
14425
14426 #. type: tbl table
14427 #: build/C/man2/syscalls.2:234
14428 #, no-wrap
14429 msgid "B<flock>(2)\t2.0\n"
14430 msgstr ""
14431
14432 #. type: tbl table
14433 #: build/C/man2/syscalls.2:235
14434 #, no-wrap
14435 msgid "B<fork>(2)\t1.0\n"
14436 msgstr ""
14437
14438 #. type: tbl table
14439 #: build/C/man2/syscalls.2:236
14440 #, no-wrap
14441 msgid "B<free_hugepages>(2)\t2.5.36\tRemoved in 2.5.44\n"
14442 msgstr ""
14443
14444 #. type: tbl table
14445 #: build/C/man2/syscalls.2:237
14446 #, no-wrap
14447 msgid "B<fremovexattr>(2)\t2.6; 2.4.18\n"
14448 msgstr ""
14449
14450 #. type: tbl table
14451 #: build/C/man2/syscalls.2:238
14452 #, no-wrap
14453 msgid "B<fsetxattr>(2)\t2.6; 2.4.18\n"
14454 msgstr ""
14455
14456 #. type: tbl table
14457 #: build/C/man2/syscalls.2:239
14458 #, no-wrap
14459 msgid "B<fstat>(2)\t1.0\n"
14460 msgstr ""
14461
14462 #. type: tbl table
14463 #: build/C/man2/syscalls.2:240
14464 #, no-wrap
14465 msgid "B<fstat64>(2)\t2.4\n"
14466 msgstr ""
14467
14468 #. type: tbl table
14469 #: build/C/man2/syscalls.2:241
14470 #, no-wrap
14471 msgid "B<fstatat64>(2)\t2.6.16\n"
14472 msgstr ""
14473
14474 #. type: tbl table
14475 #: build/C/man2/syscalls.2:242
14476 #, no-wrap
14477 msgid "B<fstatfs>(2)\t1.0\n"
14478 msgstr ""
14479
14480 #. type: tbl table
14481 #: build/C/man2/syscalls.2:243
14482 #, no-wrap
14483 msgid "B<fstatfs64>(2)\t2.6\n"
14484 msgstr ""
14485
14486 #. type: tbl table
14487 #: build/C/man2/syscalls.2:244
14488 #, no-wrap
14489 msgid "B<fsync>(2)\t1.0\t1.0\n"
14490 msgstr ""
14491
14492 #. type: tbl table
14493 #: build/C/man2/syscalls.2:245
14494 #, no-wrap
14495 msgid "B<ftruncate>(2)\t1.0\n"
14496 msgstr ""
14497
14498 #. type: tbl table
14499 #: build/C/man2/syscalls.2:246
14500 #, no-wrap
14501 msgid "B<ftruncate64>(2)\t2.4\n"
14502 msgstr ""
14503
14504 #. type: tbl table
14505 #: build/C/man2/syscalls.2:247
14506 #, no-wrap
14507 msgid "B<futex>(2)\t2.6\n"
14508 msgstr ""
14509
14510 #. type: tbl table
14511 #: build/C/man2/syscalls.2:248
14512 #, no-wrap
14513 msgid "B<futimesat>(2)\t2.6.16\n"
14514 msgstr ""
14515
14516 #. type: tbl table
14517 #: build/C/man2/syscalls.2:249
14518 #, no-wrap
14519 msgid "B<get_kernel_syms>(2)\t\tRemoved in 2.6\n"
14520 msgstr ""
14521
14522 #. type: tbl table
14523 #: build/C/man2/syscalls.2:250
14524 #, no-wrap
14525 msgid "B<get_mempolicy>(2)\t2.6.6\n"
14526 msgstr ""
14527
14528 #. type: tbl table
14529 #: build/C/man2/syscalls.2:251
14530 #, no-wrap
14531 msgid "B<get_robust_list>(2)\t2.6.17\n"
14532 msgstr ""
14533
14534 #. type: tbl table
14535 #: build/C/man2/syscalls.2:252
14536 #, no-wrap
14537 msgid "B<get_thread_area>(2)\t2.6\n"
14538 msgstr ""
14539
14540 #. type: tbl table
14541 #: build/C/man2/syscalls.2:253
14542 #, no-wrap
14543 msgid "B<getcpu>(2)\t2.6.19\n"
14544 msgstr ""
14545
14546 #. type: tbl table
14547 #: build/C/man2/syscalls.2:254
14548 #, no-wrap
14549 msgid "B<getcwd>(2)\t2.2\n"
14550 msgstr ""
14551
14552 #. type: tbl table
14553 #: build/C/man2/syscalls.2:255
14554 #, no-wrap
14555 msgid "B<getdents>(2)\t2.0\n"
14556 msgstr ""
14557
14558 #. type: tbl table
14559 #: build/C/man2/syscalls.2:256
14560 #, no-wrap
14561 msgid "B<getdents64>(2)\t2.4\n"
14562 msgstr ""
14563
14564 #. type: tbl table
14565 #: build/C/man2/syscalls.2:257
14566 #, no-wrap
14567 msgid "B<getegid>(2)\t1.0\n"
14568 msgstr ""
14569
14570 #. type: tbl table
14571 #: build/C/man2/syscalls.2:258
14572 #, no-wrap
14573 msgid "B<getegid32>(2)\t2.4\n"
14574 msgstr ""
14575
14576 #. type: tbl table
14577 #: build/C/man2/syscalls.2:259
14578 #, no-wrap
14579 msgid "B<geteuid>(2)\t1.0\n"
14580 msgstr ""
14581
14582 #. type: tbl table
14583 #: build/C/man2/syscalls.2:260
14584 #, no-wrap
14585 msgid "B<geteuid32>(2)\t2.4\n"
14586 msgstr ""
14587
14588 #. type: tbl table
14589 #: build/C/man2/syscalls.2:261
14590 #, no-wrap
14591 msgid "B<getgid>(2)\t1.0\n"
14592 msgstr ""
14593
14594 #. type: tbl table
14595 #: build/C/man2/syscalls.2:262
14596 #, no-wrap
14597 msgid "B<getgid32>(2)\t2.4\n"
14598 msgstr ""
14599
14600 #. type: tbl table
14601 #: build/C/man2/syscalls.2:263
14602 #, no-wrap
14603 msgid "B<getgroups>(2)\t1.0\n"
14604 msgstr ""
14605
14606 #. type: tbl table
14607 #: build/C/man2/syscalls.2:264
14608 #, no-wrap
14609 msgid "B<getgroups32>(2)\t2.4\n"
14610 msgstr ""
14611
14612 #. type: tbl table
14613 #: build/C/man2/syscalls.2:265
14614 #, no-wrap
14615 msgid "B<getitimer>(2)\t1.0\n"
14616 msgstr ""
14617
14618 #. type: tbl table
14619 #: build/C/man2/syscalls.2:266
14620 #, no-wrap
14621 msgid "B<getpeername>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
14622 msgstr ""
14623
14624 #. type: tbl table
14625 #: build/C/man2/syscalls.2:267
14626 #, no-wrap
14627 msgid "B<getpagesize>(2)\t2.0\tNot on x86\n"
14628 msgstr ""
14629
14630 #. type: tbl table
14631 #: build/C/man2/syscalls.2:268
14632 #, no-wrap
14633 msgid "B<getpgid>(2)\t1.0\n"
14634 msgstr ""
14635
14636 #. type: tbl table
14637 #: build/C/man2/syscalls.2:269
14638 #, no-wrap
14639 msgid "B<getpgrp>(2)\t1.0\n"
14640 msgstr ""
14641
14642 #. type: tbl table
14643 #: build/C/man2/syscalls.2:270
14644 #, no-wrap
14645 msgid "B<getpid>(2)\t1.0\n"
14646 msgstr ""
14647
14648 #. type: tbl table
14649 #: build/C/man2/syscalls.2:271
14650 #, no-wrap
14651 msgid "B<getppid>(2)\t1.0\n"
14652 msgstr ""
14653
14654 #. type: tbl table
14655 #: build/C/man2/syscalls.2:272
14656 #, no-wrap
14657 msgid "B<getpriority>(2)\t1.0\n"
14658 msgstr ""
14659
14660 #. type: tbl table
14661 #: build/C/man2/syscalls.2:273
14662 #, no-wrap
14663 msgid "B<getresgid>(2)\t2.2\n"
14664 msgstr ""
14665
14666 #. type: tbl table
14667 #: build/C/man2/syscalls.2:274
14668 #, no-wrap
14669 msgid "B<getresgid32>(2)\t2.4\n"
14670 msgstr ""
14671
14672 #. type: tbl table
14673 #: build/C/man2/syscalls.2:275
14674 #, no-wrap
14675 msgid "B<getresuid>(2)\t2.2\n"
14676 msgstr ""
14677
14678 #. type: tbl table
14679 #: build/C/man2/syscalls.2:276
14680 #, no-wrap
14681 msgid "B<getresuid32>(2)\t2.4\n"
14682 msgstr ""
14683
14684 #. type: tbl table
14685 #: build/C/man2/syscalls.2:277
14686 #, no-wrap
14687 msgid "B<getrlimit>(2)\t1.0\n"
14688 msgstr ""
14689
14690 #. type: tbl table
14691 #: build/C/man2/syscalls.2:278
14692 #, no-wrap
14693 msgid "B<getrusage>(2)\t1.0\n"
14694 msgstr ""
14695
14696 #. type: tbl table
14697 #: build/C/man2/syscalls.2:279
14698 #, no-wrap
14699 msgid "B<getsid>(2)\t2.0\n"
14700 msgstr ""
14701
14702 #. type: tbl table
14703 #: build/C/man2/syscalls.2:280
14704 #, no-wrap
14705 msgid "B<getsockname>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
14706 msgstr ""
14707
14708 #. type: tbl table
14709 #: build/C/man2/syscalls.2:281
14710 #, no-wrap
14711 msgid "B<getsockopt>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
14712 msgstr ""
14713
14714 #. type: tbl table
14715 #: build/C/man2/syscalls.2:282
14716 #, no-wrap
14717 msgid "B<gettid>(2)\t2.4.11\n"
14718 msgstr ""
14719
14720 #. type: tbl table
14721 #: build/C/man2/syscalls.2:283
14722 #, no-wrap
14723 msgid "B<gettimeofday>(2)\t1.0\n"
14724 msgstr ""
14725
14726 #. type: tbl table
14727 #: build/C/man2/syscalls.2:284
14728 #, no-wrap
14729 msgid "B<getuid>(2)\t1.0\n"
14730 msgstr ""
14731
14732 #. type: tbl table
14733 #: build/C/man2/syscalls.2:285
14734 #, no-wrap
14735 msgid "B<getuid32>(2)\t2.4\n"
14736 msgstr ""
14737
14738 #.  \fBgetunwind\fP(2)  2.4.8   ia64; DEPRECATED
14739 #. type: tbl table
14740 #: build/C/man2/syscalls.2:287
14741 #, no-wrap
14742 msgid "B<getxattr>(2)\t2.6; 2.4.18\n"
14743 msgstr ""
14744
14745 #. type: tbl table
14746 #: build/C/man2/syscalls.2:288
14747 #, no-wrap
14748 msgid "B<init_module>(2)\t1.0\n"
14749 msgstr ""
14750
14751 #. type: tbl table
14752 #: build/C/man2/syscalls.2:289
14753 #, no-wrap
14754 msgid "B<inotify_add_watch>(2)\t2.6.13\n"
14755 msgstr ""
14756
14757 #. type: tbl table
14758 #: build/C/man2/syscalls.2:290
14759 #, no-wrap
14760 msgid "B<inotify_init>(2)\t2.6.13\n"
14761 msgstr ""
14762
14763 #. type: tbl table
14764 #: build/C/man2/syscalls.2:291
14765 #, no-wrap
14766 msgid "B<inotify_init1>(2)\t2.6.27\n"
14767 msgstr ""
14768
14769 #. type: tbl table
14770 #: build/C/man2/syscalls.2:292
14771 #, no-wrap
14772 msgid "B<inotify_rm_watch>(2)\t2.6.13\n"
14773 msgstr ""
14774
14775 #. type: tbl table
14776 #: build/C/man2/syscalls.2:293
14777 #, no-wrap
14778 msgid "B<io_cancel>(2)\t2.6\n"
14779 msgstr ""
14780
14781 #. type: tbl table
14782 #: build/C/man2/syscalls.2:294
14783 #, no-wrap
14784 msgid "B<io_destroy>(2)\t2.6\n"
14785 msgstr ""
14786
14787 #. type: tbl table
14788 #: build/C/man2/syscalls.2:295
14789 #, no-wrap
14790 msgid "B<io_getevents>(2)\t2.6\n"
14791 msgstr ""
14792
14793 #. type: tbl table
14794 #: build/C/man2/syscalls.2:296
14795 #, no-wrap
14796 msgid "B<io_setup>(2)\t2.6\n"
14797 msgstr ""
14798
14799 #. type: tbl table
14800 #: build/C/man2/syscalls.2:297
14801 #, no-wrap
14802 msgid "B<io_submit>(2)\t2.6\n"
14803 msgstr ""
14804
14805 #. type: tbl table
14806 #: build/C/man2/syscalls.2:298
14807 #, no-wrap
14808 msgid "B<ioctl>(2)\t1.0\n"
14809 msgstr ""
14810
14811 #. type: tbl table
14812 #: build/C/man2/syscalls.2:299
14813 #, no-wrap
14814 msgid "B<ioperm>(2)\t1.0\n"
14815 msgstr ""
14816
14817 #. type: tbl table
14818 #: build/C/man2/syscalls.2:300
14819 #, no-wrap
14820 msgid "B<iopl>(2)\t1.0\n"
14821 msgstr ""
14822
14823 #. type: tbl table
14824 #: build/C/man2/syscalls.2:301
14825 #, no-wrap
14826 msgid "B<ioprio_get>(2)\t2.6.13\n"
14827 msgstr ""
14828
14829 #. type: tbl table
14830 #: build/C/man2/syscalls.2:302
14831 #, no-wrap
14832 msgid "B<ioprio_set>(2)\t2.6.13\n"
14833 msgstr ""
14834
14835 #. type: tbl table
14836 #: build/C/man2/syscalls.2:303
14837 #, no-wrap
14838 msgid "B<ipc>(2)\t1.0\n"
14839 msgstr ""
14840
14841 #.  Implements System V IPC calls
14842 #. type: tbl table
14843 #: build/C/man2/syscalls.2:305
14844 #, no-wrap
14845 msgid "B<kcmp>(2)\t3.5\n"
14846 msgstr ""
14847
14848 #. type: tbl table
14849 #: build/C/man2/syscalls.2:306
14850 #, no-wrap
14851 msgid "B<kern_features>(2)\t3.7\tSparc64\n"
14852 msgstr ""
14853
14854 #. type: tbl table
14855 #: build/C/man2/syscalls.2:307
14856 #, no-wrap
14857 msgid "B<kexec_load>(2)\t2.6.13\n"
14858 msgstr ""
14859
14860 #.  The entry in the syscall table was reserved starting in 2.6.7
14861 #.  Was named sys_kexec_load() from 2.6.7 to 2.6.16
14862 #. type: tbl table
14863 #: build/C/man2/syscalls.2:310
14864 #, no-wrap
14865 msgid "B<keyctl>(2)\t2.6.11\n"
14866 msgstr ""
14867
14868 #. type: tbl table
14869 #: build/C/man2/syscalls.2:311
14870 #, no-wrap
14871 msgid "B<kill>(2)\t1.0\n"
14872 msgstr ""
14873
14874 #. type: tbl table
14875 #: build/C/man2/syscalls.2:312
14876 #, no-wrap
14877 msgid "B<lchown>(2)\t1.0\tT{\n"
14878 msgstr ""
14879
14880 #. type: tbl table
14881 #: build/C/man2/syscalls.2:317
14882 #, no-wrap
14883 msgid "B<lchown32>(2)\t2.4\n"
14884 msgstr ""
14885
14886 #. type: tbl table
14887 #: build/C/man2/syscalls.2:318
14888 #, no-wrap
14889 msgid "B<lgetxattr>(2)\t2.6; 2.4.18\n"
14890 msgstr ""
14891
14892 #. type: tbl table
14893 #: build/C/man2/syscalls.2:319
14894 #, no-wrap
14895 msgid "B<link>(2)\t1.0\n"
14896 msgstr ""
14897
14898 #. type: tbl table
14899 #: build/C/man2/syscalls.2:320
14900 #, no-wrap
14901 msgid "B<linkat>(2)\t2.6.16\n"
14902 msgstr ""
14903
14904 #. type: tbl table
14905 #: build/C/man2/syscalls.2:321
14906 #, no-wrap
14907 msgid "B<listen>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
14908 msgstr ""
14909
14910 #. type: tbl table
14911 #: build/C/man2/syscalls.2:322
14912 #, no-wrap
14913 msgid "B<listxattr>(2)\t2.6; 2.4.18\n"
14914 msgstr ""
14915
14916 #. type: tbl table
14917 #: build/C/man2/syscalls.2:323
14918 #, no-wrap
14919 msgid "B<llistxattr>(2)\t2.6; 2.4.18\n"
14920 msgstr ""
14921
14922 #. type: tbl table
14923 #: build/C/man2/syscalls.2:324
14924 #, no-wrap
14925 msgid "B<lookup_dcookie>(2)\t2.6\n"
14926 msgstr ""
14927
14928 #. type: tbl table
14929 #: build/C/man2/syscalls.2:325
14930 #, no-wrap
14931 msgid "B<lremovexattr>(2)\t2.6; 2.4.18\n"
14932 msgstr ""
14933
14934 #. type: tbl table
14935 #: build/C/man2/syscalls.2:326
14936 #, no-wrap
14937 msgid "B<lseek>(2)\t1.0\n"
14938 msgstr ""
14939
14940 #. type: tbl table
14941 #: build/C/man2/syscalls.2:327
14942 #, no-wrap
14943 msgid "B<lsetxattr>(2)\t2.6; 2.4.18\n"
14944 msgstr ""
14945
14946 #. type: tbl table
14947 #: build/C/man2/syscalls.2:328
14948 #, no-wrap
14949 msgid "B<lstat>(2)\t1.0\n"
14950 msgstr ""
14951
14952 #. type: tbl table
14953 #: build/C/man2/syscalls.2:329
14954 #, no-wrap
14955 msgid "B<lstat64>(2)\t2.4\n"
14956 msgstr ""
14957
14958 #. type: tbl table
14959 #: build/C/man2/syscalls.2:330
14960 #, no-wrap
14961 msgid "B<madvise>(2)\t2.4\n"
14962 msgstr ""
14963
14964 #. type: tbl table
14965 #: build/C/man2/syscalls.2:331
14966 #, no-wrap
14967 msgid "B<madvise1>(2)\t2.4\n"
14968 msgstr ""
14969
14970 #. type: tbl table
14971 #: build/C/man2/syscalls.2:332
14972 #, no-wrap
14973 msgid "B<mbind>(2)\t2.6.6\n"
14974 msgstr ""
14975
14976 #.  \fBmemory_ordering\fP(2)    ???     Sparc64
14977 #. type: tbl table
14978 #: build/C/man2/syscalls.2:334
14979 #, no-wrap
14980 msgid "B<migrate_pages>(2)\t2.6.16\n"
14981 msgstr ""
14982
14983 #. type: tbl table
14984 #: build/C/man2/syscalls.2:335
14985 #, no-wrap
14986 msgid "B<mincore>(2)\t2.4\n"
14987 msgstr ""
14988
14989 #. type: tbl table
14990 #: build/C/man2/syscalls.2:336
14991 #, no-wrap
14992 msgid "B<mkdir>(2)\t1.0\n"
14993 msgstr ""
14994
14995 #. type: tbl table
14996 #: build/C/man2/syscalls.2:337
14997 #, no-wrap
14998 msgid "B<mkdirat>(2)\t2.6.16\n"
14999 msgstr ""
15000
15001 #. type: tbl table
15002 #: build/C/man2/syscalls.2:338
15003 #, no-wrap
15004 msgid "B<mknod>(2)\t1.0\n"
15005 msgstr ""
15006
15007 #. type: tbl table
15008 #: build/C/man2/syscalls.2:339
15009 #, no-wrap
15010 msgid "B<mknodat>(2)\t2.6.16\n"
15011 msgstr ""
15012
15013 #. type: tbl table
15014 #: build/C/man2/syscalls.2:340
15015 #, no-wrap
15016 msgid "B<mlock>(2)\t2.0\n"
15017 msgstr ""
15018
15019 #. type: tbl table
15020 #: build/C/man2/syscalls.2:341
15021 #, no-wrap
15022 msgid "B<mlockall>(2)\t2.0\n"
15023 msgstr ""
15024
15025 #. type: tbl table
15026 #: build/C/man2/syscalls.2:342
15027 #, no-wrap
15028 msgid "B<mmap>(2)\t1.0\n"
15029 msgstr ""
15030
15031 #. type: tbl table
15032 #: build/C/man2/syscalls.2:343
15033 #, no-wrap
15034 msgid "B<mmap2>(2)\t2.4\n"
15035 msgstr ""
15036
15037 #. type: tbl table
15038 #: build/C/man2/syscalls.2:344
15039 #, no-wrap
15040 msgid "B<modify_ldt>(2)\t1.0\n"
15041 msgstr ""
15042
15043 #. type: tbl table
15044 #: build/C/man2/syscalls.2:345
15045 #, no-wrap
15046 msgid "B<mount>(2)\t1.0\n"
15047 msgstr ""
15048
15049 #. type: tbl table
15050 #: build/C/man2/syscalls.2:346
15051 #, no-wrap
15052 msgid "B<move_pages>(2)\t2.6.18\n"
15053 msgstr ""
15054
15055 #. type: tbl table
15056 #: build/C/man2/syscalls.2:347
15057 #, no-wrap
15058 msgid "B<mprotect>(2)\t1.0\n"
15059 msgstr ""
15060
15061 #. type: tbl table
15062 #: build/C/man2/syscalls.2:348
15063 #, no-wrap
15064 msgid "B<mq_getsetattr>(2)\t2.6.6\n"
15065 msgstr ""
15066
15067 #.  Implements \fBmq_getattr\fP(3) and \fBmq_setattr\fP(3)
15068 #. type: tbl table
15069 #: build/C/man2/syscalls.2:350
15070 #, no-wrap
15071 msgid "B<mq_notify>(2)\t2.6.6\n"
15072 msgstr ""
15073
15074 #. type: tbl table
15075 #: build/C/man2/syscalls.2:351
15076 #, no-wrap
15077 msgid "B<mq_open>(2)\t2.6.6\n"
15078 msgstr ""
15079
15080 #. type: tbl table
15081 #: build/C/man2/syscalls.2:352
15082 #, no-wrap
15083 msgid "B<mq_timedreceive>(2)\t2.6.6\n"
15084 msgstr ""
15085
15086 #. type: tbl table
15087 #: build/C/man2/syscalls.2:353
15088 #, no-wrap
15089 msgid "B<mq_timedsend>(2)\t2.6.6\n"
15090 msgstr ""
15091
15092 #. type: tbl table
15093 #: build/C/man2/syscalls.2:354
15094 #, no-wrap
15095 msgid "B<mq_unlink>(2)\t2.6.6\n"
15096 msgstr ""
15097
15098 #. type: tbl table
15099 #: build/C/man2/syscalls.2:355
15100 #, no-wrap
15101 msgid "B<mremap>(2)\t2.0\n"
15102 msgstr ""
15103
15104 #. type: tbl table
15105 #: build/C/man2/syscalls.2:356
15106 #, no-wrap
15107 msgid "B<msgctl>(2)\t2.0\tSee notes on B<ipc>(2)\n"
15108 msgstr ""
15109
15110 #. type: tbl table
15111 #: build/C/man2/syscalls.2:357
15112 #, no-wrap
15113 msgid "B<msgget>(2)\t2.0\tSee notes on B<ipc>(2)\n"
15114 msgstr ""
15115
15116 #. type: tbl table
15117 #: build/C/man2/syscalls.2:358
15118 #, no-wrap
15119 msgid "B<msgrcv>(2)\t2.0\tSee notes on B<ipc>(2)\n"
15120 msgstr ""
15121
15122 #. type: tbl table
15123 #: build/C/man2/syscalls.2:359
15124 #, no-wrap
15125 msgid "B<msgsnd>(2)\t2.0\tSee notes on B<ipc>(2)\n"
15126 msgstr ""
15127
15128 #. type: tbl table
15129 #: build/C/man2/syscalls.2:360
15130 #, no-wrap
15131 msgid "B<msync>(2)\t2.0\n"
15132 msgstr ""
15133
15134 #.  \fBmultiplexer\fP(2)        ??      __NR_multiplexer reserved on
15135 #.              PowerPC, but unimplemented?
15136 #. type: tbl table
15137 #: build/C/man2/syscalls.2:363
15138 #, no-wrap
15139 msgid "B<munlock>(2)\t2.0\n"
15140 msgstr ""
15141
15142 #. type: tbl table
15143 #: build/C/man2/syscalls.2:364
15144 #, no-wrap
15145 msgid "B<munlockall>(2)\t2.0\n"
15146 msgstr ""
15147
15148 #. type: tbl table
15149 #: build/C/man2/syscalls.2:365
15150 #, no-wrap
15151 msgid "B<munmap>(2)\t1.0\n"
15152 msgstr ""
15153
15154 #. type: tbl table
15155 #: build/C/man2/syscalls.2:366
15156 #, no-wrap
15157 msgid "B<name_to_handle_at>(2)\t2.6.39\n"
15158 msgstr ""
15159
15160 #. type: tbl table
15161 #: build/C/man2/syscalls.2:367
15162 #, no-wrap
15163 msgid "B<nanosleep>(2)\t2.0\n"
15164 msgstr ""
15165
15166 #. type: tbl table
15167 #: build/C/man2/syscalls.2:368
15168 #, no-wrap
15169 msgid "B<nfsservctl>(2)\t2.2\tRemoved in 3.1\n"
15170 msgstr ""
15171
15172 #. type: tbl table
15173 #: build/C/man2/syscalls.2:369
15174 #, no-wrap
15175 msgid "B<nice>(2)\t1.0\n"
15176 msgstr ""
15177
15178 #. type: tbl table
15179 #: build/C/man2/syscalls.2:370
15180 #, no-wrap
15181 msgid "B<oldfstat>(2)\t1.0\n"
15182 msgstr ""
15183
15184 #. type: tbl table
15185 #: build/C/man2/syscalls.2:371
15186 #, no-wrap
15187 msgid "B<oldlstat>(2)\t1.0\n"
15188 msgstr ""
15189
15190 #. type: tbl table
15191 #: build/C/man2/syscalls.2:372
15192 #, no-wrap
15193 msgid "B<oldolduname>(2)\t1.0\n"
15194 msgstr ""
15195
15196 #. type: tbl table
15197 #: build/C/man2/syscalls.2:373
15198 #, no-wrap
15199 msgid "B<oldstat>(2)\t1.0\n"
15200 msgstr ""
15201
15202 #. type: tbl table
15203 #: build/C/man2/syscalls.2:374
15204 #, no-wrap
15205 msgid "B<olduname>(2)\t1.0\n"
15206 msgstr ""
15207
15208 #. type: tbl table
15209 #: build/C/man2/syscalls.2:375
15210 #, no-wrap
15211 msgid "B<open>(2)\t1.0\n"
15212 msgstr ""
15213
15214 #. type: tbl table
15215 #: build/C/man2/syscalls.2:376
15216 #, no-wrap
15217 msgid "B<open_by_handle_at>(2)\t2.6.39\n"
15218 msgstr ""
15219
15220 #. type: tbl table
15221 #: build/C/man2/syscalls.2:377
15222 #, no-wrap
15223 msgid "B<openat>(2)\t2.6.16\n"
15224 msgstr ""
15225
15226 #. type: tbl table
15227 #: build/C/man2/syscalls.2:378
15228 #, no-wrap
15229 msgid "B<pause>(2)\t1.0\n"
15230 msgstr ""
15231
15232 #. type: tbl table
15233 #: build/C/man2/syscalls.2:379
15234 #, no-wrap
15235 msgid "B<pciconfig_iobase>(2)\t2.2.15; 2.4\tNot on x86\n"
15236 msgstr ""
15237
15238 #.  Alpha, PowerPC, ARM; not x86
15239 #. type: tbl table
15240 #: build/C/man2/syscalls.2:381
15241 #, no-wrap
15242 msgid "B<pciconfig_read>(2)\t2.0.26; 2.2\tNot on x86\n"
15243 msgstr ""
15244
15245 #.  , PowerPC, ARM; not x86
15246 #. type: tbl table
15247 #: build/C/man2/syscalls.2:383
15248 #, no-wrap
15249 msgid "B<pciconfig_write>(2)\t2.0.26; 2.2\tNot on x86\n"
15250 msgstr ""
15251
15252 #.  , PowerPC, ARM; not x86
15253 #. type: tbl table
15254 #: build/C/man2/syscalls.2:385
15255 #, no-wrap
15256 msgid "B<perf_event_open>(2)\t2.6.31\tT{\n"
15257 msgstr ""
15258
15259 #. type: tbl table
15260 #: build/C/man2/syscalls.2:386
15261 #, no-wrap
15262 msgid "Was called perf_counter_open()\n"
15263 msgstr ""
15264
15265 #. type: tbl table
15266 #: build/C/man2/syscalls.2:388
15267 #, no-wrap
15268 msgid "in 2.6.31; renamed in 2.6.32\n"
15269 msgstr ""
15270
15271 #. type: tbl table
15272 #: build/C/man2/syscalls.2:390
15273 #, no-wrap
15274 msgid "B<personality>(2)\t1.2\n"
15275 msgstr ""
15276
15277 #. type: tbl table
15278 #: build/C/man2/syscalls.2:391
15279 #, no-wrap
15280 msgid "B<perfctr>(2)\t2.2\tSparc; removed in 2.6.34\n"
15281 msgstr ""
15282
15283 #.      commit c7d5a0050773e98d1094eaa9f2a1a793fafac300 removed perfctr()
15284 #. type: tbl table
15285 #: build/C/man2/syscalls.2:393
15286 #, no-wrap
15287 msgid "B<perfmonctl>(2)\t2.4\tia64\n"
15288 msgstr ""
15289
15290 #. type: tbl table
15291 #: build/C/man2/syscalls.2:394
15292 #, no-wrap
15293 msgid "B<pipe>(2)\t1.0\n"
15294 msgstr ""
15295
15296 #. type: tbl table
15297 #: build/C/man2/syscalls.2:395
15298 #, no-wrap
15299 msgid "B<pipe2>(2)\t2.6.27\n"
15300 msgstr ""
15301
15302 #. type: tbl table
15303 #: build/C/man2/syscalls.2:396
15304 #, no-wrap
15305 msgid "B<pivot_root>(2)\t2.4\n"
15306 msgstr ""
15307
15308 #. type: tbl table
15309 #: build/C/man2/syscalls.2:397
15310 #, no-wrap
15311 msgid "B<poll>(2)\t2.0.36; 2.2\n"
15312 msgstr ""
15313
15314 #. type: tbl table
15315 #: build/C/man2/syscalls.2:398
15316 #, no-wrap
15317 msgid "B<ppc_rtas>(2)\t\tPowerPC only\n"
15318 msgstr ""
15319
15320 #. type: tbl table
15321 #: build/C/man2/syscalls.2:399
15322 #, no-wrap
15323 msgid "B<ppoll>(2)\t2.6.16\n"
15324 msgstr ""
15325
15326 #. type: tbl table
15327 #: build/C/man2/syscalls.2:400
15328 #, no-wrap
15329 msgid "B<prctl>(2)\t2.2\n"
15330 msgstr ""
15331
15332 #. type: tbl table
15333 #: build/C/man2/syscalls.2:401
15334 #, no-wrap
15335 msgid "B<pread64>(2)\t\tT{\n"
15336 msgstr ""
15337
15338 #. type: tbl table
15339 #: build/C/man2/syscalls.2:402
15340 #, no-wrap
15341 msgid "Added as \"pread\" in 2.2;\n"
15342 msgstr ""
15343
15344 #. type: tbl table
15345 #: build/C/man2/syscalls.2:404
15346 #, no-wrap
15347 msgid "renamed \"pread64\" in 2.6\n"
15348 msgstr ""
15349
15350 #. type: tbl table
15351 #: build/C/man2/syscalls.2:406
15352 #, no-wrap
15353 msgid "B<preadv>(2)\t2.6.30\n"
15354 msgstr ""
15355
15356 #. type: tbl table
15357 #: build/C/man2/syscalls.2:407
15358 #, no-wrap
15359 msgid "B<prlimit>(2)\t2.6.36\n"
15360 msgstr ""
15361
15362 #. type: tbl table
15363 #: build/C/man2/syscalls.2:408
15364 #, no-wrap
15365 msgid "B<process_vm_readv>(2)\t3.2\n"
15366 msgstr ""
15367
15368 #. type: tbl table
15369 #: build/C/man2/syscalls.2:409
15370 #, no-wrap
15371 msgid "B<process_vm_writev>(2)\t3.2\n"
15372 msgstr ""
15373
15374 #. type: tbl table
15375 #: build/C/man2/syscalls.2:410
15376 #, no-wrap
15377 msgid "B<pselect6>(2)\t2.6.16\n"
15378 msgstr ""
15379
15380 #.  Implements \fBpselect\fP(2)
15381 #. type: tbl table
15382 #: build/C/man2/syscalls.2:412
15383 #, no-wrap
15384 msgid "B<ptrace>(2)\t1.0\n"
15385 msgstr ""
15386
15387 #. type: tbl table
15388 #: build/C/man2/syscalls.2:413
15389 #, no-wrap
15390 msgid "B<pwrite64>(2)\t\tT{\n"
15391 msgstr ""
15392
15393 #. type: tbl table
15394 #: build/C/man2/syscalls.2:414
15395 #, no-wrap
15396 msgid "Added as \"pwrite\" in 2.2;\n"
15397 msgstr ""
15398
15399 #. type: tbl table
15400 #: build/C/man2/syscalls.2:416
15401 #, no-wrap
15402 msgid "renamed \"pwrite64\" in 2.6\n"
15403 msgstr ""
15404
15405 #. type: tbl table
15406 #: build/C/man2/syscalls.2:418
15407 #, no-wrap
15408 msgid "B<pwritev>(2)\t2.6.30\n"
15409 msgstr ""
15410
15411 #. type: tbl table
15412 #: build/C/man2/syscalls.2:419
15413 #, no-wrap
15414 msgid "B<query_module>(2)\t2.2\tRemoved in 2.6\n"
15415 msgstr ""
15416
15417 #. type: tbl table
15418 #: build/C/man2/syscalls.2:420
15419 #, no-wrap
15420 msgid "B<quotactl>(2)\t1.0\n"
15421 msgstr ""
15422
15423 #. type: tbl table
15424 #: build/C/man2/syscalls.2:421
15425 #, no-wrap
15426 msgid "B<read>(2)\t1.0\n"
15427 msgstr ""
15428
15429 #. type: tbl table
15430 #: build/C/man2/syscalls.2:422
15431 #, no-wrap
15432 msgid "B<readahead>(2)\t2.4.13\n"
15433 msgstr ""
15434
15435 #. type: tbl table
15436 #: build/C/man2/syscalls.2:423
15437 #, no-wrap
15438 msgid "B<readdir>(2)\t1.0\n"
15439 msgstr ""
15440
15441 #.  Supersedes \fBgetdents\fP(2)
15442 #. type: tbl table
15443 #: build/C/man2/syscalls.2:425
15444 #, no-wrap
15445 msgid "B<readlink>(2)\t1.0\n"
15446 msgstr ""
15447
15448 #. type: tbl table
15449 #: build/C/man2/syscalls.2:426
15450 #, no-wrap
15451 msgid "B<readlinkat>(2)\t2.6.16\n"
15452 msgstr ""
15453
15454 #. type: tbl table
15455 #: build/C/man2/syscalls.2:427
15456 #, no-wrap
15457 msgid "B<readv>(2)\t2.0\n"
15458 msgstr ""
15459
15460 #. type: tbl table
15461 #: build/C/man2/syscalls.2:428
15462 #, no-wrap
15463 msgid "B<reboot>(2)\t1.0\n"
15464 msgstr ""
15465
15466 #. type: tbl table
15467 #: build/C/man2/syscalls.2:429
15468 #, no-wrap
15469 msgid "B<recv>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
15470 msgstr ""
15471
15472 #. type: tbl table
15473 #: build/C/man2/syscalls.2:430
15474 #, no-wrap
15475 msgid "B<recvfrom>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
15476 msgstr ""
15477
15478 #. type: tbl table
15479 #: build/C/man2/syscalls.2:431
15480 #, no-wrap
15481 msgid "B<recvmsg>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
15482 msgstr ""
15483
15484 #. type: tbl table
15485 #: build/C/man2/syscalls.2:432
15486 #, no-wrap
15487 msgid "B<recvmmsg>(2)\t2.6.33\n"
15488 msgstr ""
15489
15490 #. type: tbl table
15491 #: build/C/man2/syscalls.2:433
15492 #, no-wrap
15493 msgid "B<remap_file_pages>(2)\t2.6\n"
15494 msgstr ""
15495
15496 #. type: tbl table
15497 #: build/C/man2/syscalls.2:434
15498 #, no-wrap
15499 msgid "B<removexattr>(2)\t2.6; 2.4.18\n"
15500 msgstr ""
15501
15502 #. type: tbl table
15503 #: build/C/man2/syscalls.2:435
15504 #, no-wrap
15505 msgid "B<rename>(2)\t1.0\n"
15506 msgstr ""
15507
15508 #. type: tbl table
15509 #: build/C/man2/syscalls.2:436
15510 #, no-wrap
15511 msgid "B<renameat>(2)\t2.6.16\n"
15512 msgstr ""
15513
15514 #. type: tbl table
15515 #: build/C/man2/syscalls.2:437
15516 #, no-wrap
15517 msgid "B<request_key>(2)\t2.6.11\n"
15518 msgstr ""
15519
15520 #. type: tbl table
15521 #: build/C/man2/syscalls.2:438
15522 #, no-wrap
15523 msgid "B<restart_syscall>(2)\t2.6\n"
15524 msgstr ""
15525
15526 #. type: tbl table
15527 #: build/C/man2/syscalls.2:439
15528 #, no-wrap
15529 msgid "B<rmdir>(2)\t1.0\n"
15530 msgstr ""
15531
15532 #. type: tbl table
15533 #: build/C/man2/syscalls.2:440
15534 #, no-wrap
15535 msgid "B<rt_sigaction>(2)\t2.2\n"
15536 msgstr ""
15537
15538 #. type: tbl table
15539 #: build/C/man2/syscalls.2:441
15540 #, no-wrap
15541 msgid "B<rt_sigpending>(2)\t2.2\n"
15542 msgstr ""
15543
15544 #. type: tbl table
15545 #: build/C/man2/syscalls.2:442
15546 #, no-wrap
15547 msgid "B<rt_sigprocmask>(2)\t2.2\n"
15548 msgstr ""
15549
15550 #. type: tbl table
15551 #: build/C/man2/syscalls.2:443
15552 #, no-wrap
15553 msgid "B<rt_sigqueueinfo>(2)\t2.2\n"
15554 msgstr ""
15555
15556 #. type: tbl table
15557 #: build/C/man2/syscalls.2:444
15558 #, no-wrap
15559 msgid "B<rt_sigreturn>(2)\t2.2\n"
15560 msgstr ""
15561
15562 #. type: tbl table
15563 #: build/C/man2/syscalls.2:445
15564 #, no-wrap
15565 msgid "B<rt_sigsuspend>(2)\t2.2\n"
15566 msgstr ""
15567
15568 #. type: tbl table
15569 #: build/C/man2/syscalls.2:446
15570 #, no-wrap
15571 msgid "B<rt_sigtimedwait>(2)\t2.2\n"
15572 msgstr ""
15573
15574 #. type: tbl table
15575 #: build/C/man2/syscalls.2:447
15576 #, no-wrap
15577 msgid "B<rt_tgsigqueueinfo>(2)\t2.6.31\n"
15578 msgstr ""
15579
15580 #. type: tbl table
15581 #: build/C/man2/syscalls.2:448
15582 #, no-wrap
15583 msgid "B<s390_runtime_instr>(2)\t3.7\ts390 only\n"
15584 msgstr ""
15585
15586 #. type: tbl table
15587 #: build/C/man2/syscalls.2:449
15588 #, no-wrap
15589 msgid "B<sched_get_priority_max>(2)\t2.0\n"
15590 msgstr ""
15591
15592 #. type: tbl table
15593 #: build/C/man2/syscalls.2:450
15594 #, no-wrap
15595 msgid "B<sched_get_priority_min>(2)\t2.0\n"
15596 msgstr ""
15597
15598 #. type: tbl table
15599 #: build/C/man2/syscalls.2:451
15600 #, no-wrap
15601 msgid "B<sched_getaffinity>(2)\t2.6\n"
15602 msgstr ""
15603
15604 #. type: tbl table
15605 #: build/C/man2/syscalls.2:452
15606 #, no-wrap
15607 msgid "B<sched_getparam>(2)\t2.0\n"
15608 msgstr ""
15609
15610 #. type: tbl table
15611 #: build/C/man2/syscalls.2:453
15612 #, no-wrap
15613 msgid "B<sched_getscheduler>(2)\t2.0\n"
15614 msgstr ""
15615
15616 #. type: tbl table
15617 #: build/C/man2/syscalls.2:454
15618 #, no-wrap
15619 msgid "B<sched_rr_get_interval>(2)\t2.0\n"
15620 msgstr ""
15621
15622 #. type: tbl table
15623 #: build/C/man2/syscalls.2:455
15624 #, no-wrap
15625 msgid "B<sched_setaffinity>(2)\t2.6\n"
15626 msgstr ""
15627
15628 #. type: tbl table
15629 #: build/C/man2/syscalls.2:456
15630 #, no-wrap
15631 msgid "B<sched_setparam>(2)\t2.0\n"
15632 msgstr ""
15633
15634 #. type: tbl table
15635 #: build/C/man2/syscalls.2:457
15636 #, no-wrap
15637 msgid "B<sched_setscheduler>(2)\t2.0\n"
15638 msgstr ""
15639
15640 #. type: tbl table
15641 #: build/C/man2/syscalls.2:458
15642 #, no-wrap
15643 msgid "B<sched_yield>(2)\t2.0\n"
15644 msgstr ""
15645
15646 #. type: tbl table
15647 #: build/C/man2/syscalls.2:459
15648 #, no-wrap
15649 msgid "B<select>(2)\t1.0\n"
15650 msgstr ""
15651
15652 #. type: tbl table
15653 #: build/C/man2/syscalls.2:460
15654 #, no-wrap
15655 msgid "B<semctl>(2)\t2.0\tSee notes on B<ipc>(2)\n"
15656 msgstr ""
15657
15658 #. type: tbl table
15659 #: build/C/man2/syscalls.2:461
15660 #, no-wrap
15661 msgid "B<semget>(2)\t2.0\tSee notes on B<ipc>(2)\n"
15662 msgstr ""
15663
15664 #. type: tbl table
15665 #: build/C/man2/syscalls.2:462
15666 #, no-wrap
15667 msgid "B<semop>(2)\t2.0\tSee notes on B<ipc>(2)\n"
15668 msgstr ""
15669
15670 #. type: tbl table
15671 #: build/C/man2/syscalls.2:463
15672 #, no-wrap
15673 msgid "B<semtimedop>(2)\t2.6; 2.4.22\n"
15674 msgstr ""
15675
15676 #. type: tbl table
15677 #: build/C/man2/syscalls.2:464
15678 #, no-wrap
15679 msgid "B<send>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
15680 msgstr ""
15681
15682 #. type: tbl table
15683 #: build/C/man2/syscalls.2:465
15684 #, no-wrap
15685 msgid "B<sendfile>(2)\t2.2\n"
15686 msgstr ""
15687
15688 #. type: tbl table
15689 #: build/C/man2/syscalls.2:466
15690 #, no-wrap
15691 msgid "B<sendfile64>(2)\t2.6; 2.4.19\n"
15692 msgstr ""
15693
15694 #. type: tbl table
15695 #: build/C/man2/syscalls.2:467
15696 #, no-wrap
15697 msgid "B<sendmmsg>(2)\t3.0\n"
15698 msgstr ""
15699
15700 #. type: tbl table
15701 #: build/C/man2/syscalls.2:468
15702 #, no-wrap
15703 msgid "B<sendmsg>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
15704 msgstr ""
15705
15706 #. type: tbl table
15707 #: build/C/man2/syscalls.2:469
15708 #, no-wrap
15709 msgid "B<sendto>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
15710 msgstr ""
15711
15712 #. type: tbl table
15713 #: build/C/man2/syscalls.2:470
15714 #, no-wrap
15715 msgid "B<set_mempolicy>(2)\t2.6.6\n"
15716 msgstr ""
15717
15718 #. type: tbl table
15719 #: build/C/man2/syscalls.2:471
15720 #, no-wrap
15721 msgid "B<set_robust_list>(2)\t2.6.17\n"
15722 msgstr ""
15723
15724 #. type: tbl table
15725 #: build/C/man2/syscalls.2:472
15726 #, no-wrap
15727 msgid "B<set_thread_area>(2)\t2.6\n"
15728 msgstr ""
15729
15730 #. type: tbl table
15731 #: build/C/man2/syscalls.2:473
15732 #, no-wrap
15733 msgid "B<set_tid_address>(2)\t2.6\n"
15734 msgstr ""
15735
15736 #.  See http://lkml.org/lkml/2005/8/1/83
15737 #.  "[PATCH] remove sys_set_zone_reclaim()"
15738 #. type: tbl table
15739 #: build/C/man2/syscalls.2:476
15740 #, no-wrap
15741 msgid "B<setdomainname>(2)\t1.0\n"
15742 msgstr ""
15743
15744 #. type: tbl table
15745 #: build/C/man2/syscalls.2:477
15746 #, no-wrap
15747 msgid "B<setfsgid>(2)\t1.2\n"
15748 msgstr ""
15749
15750 #. type: tbl table
15751 #: build/C/man2/syscalls.2:478
15752 #, no-wrap
15753 msgid "B<setfsgid32>(2)\t2.4\n"
15754 msgstr ""
15755
15756 #. type: tbl table
15757 #: build/C/man2/syscalls.2:479
15758 #, no-wrap
15759 msgid "B<setfsuid>(2)\t1.2\n"
15760 msgstr ""
15761
15762 #. type: tbl table
15763 #: build/C/man2/syscalls.2:480
15764 #, no-wrap
15765 msgid "B<setfsuid32>(2)\t2.4\n"
15766 msgstr ""
15767
15768 #. type: tbl table
15769 #: build/C/man2/syscalls.2:481
15770 #, no-wrap
15771 msgid "B<setgid>(2)\t1.0\n"
15772 msgstr ""
15773
15774 #. type: tbl table
15775 #: build/C/man2/syscalls.2:482
15776 #, no-wrap
15777 msgid "B<setgid32>(2)\t2.4\n"
15778 msgstr ""
15779
15780 #. type: tbl table
15781 #: build/C/man2/syscalls.2:483
15782 #, no-wrap
15783 msgid "B<setgroups>(2)\t1.0\n"
15784 msgstr ""
15785
15786 #. type: tbl table
15787 #: build/C/man2/syscalls.2:484
15788 #, no-wrap
15789 msgid "B<setgroups32>(2)\t2.4\n"
15790 msgstr ""
15791
15792 #. type: tbl table
15793 #: build/C/man2/syscalls.2:485
15794 #, no-wrap
15795 msgid "B<sethostname>(2)\t1.0\n"
15796 msgstr ""
15797
15798 #. type: tbl table
15799 #: build/C/man2/syscalls.2:486
15800 #, no-wrap
15801 msgid "B<setitimer>(2)\t1.0\n"
15802 msgstr ""
15803
15804 #. type: tbl table
15805 #: build/C/man2/syscalls.2:487
15806 #, no-wrap
15807 msgid "B<setns>(2)\t3.0\n"
15808 msgstr ""
15809
15810 #. type: tbl table
15811 #: build/C/man2/syscalls.2:488
15812 #, no-wrap
15813 msgid "B<setpgid>(2)\t1.0\n"
15814 msgstr ""
15815
15816 #. type: tbl table
15817 #: build/C/man2/syscalls.2:489
15818 #, no-wrap
15819 msgid "B<setpriority>(2)\t1.0\n"
15820 msgstr ""
15821
15822 #. type: tbl table
15823 #: build/C/man2/syscalls.2:490
15824 #, no-wrap
15825 msgid "B<setregid>(2)\t1.0\n"
15826 msgstr ""
15827
15828 #. type: tbl table
15829 #: build/C/man2/syscalls.2:491
15830 #, no-wrap
15831 msgid "B<setregid32>(2)\t2.4\n"
15832 msgstr ""
15833
15834 #. type: tbl table
15835 #: build/C/man2/syscalls.2:492
15836 #, no-wrap
15837 msgid "B<setresgid>(2)\t2.2\n"
15838 msgstr ""
15839
15840 #. type: tbl table
15841 #: build/C/man2/syscalls.2:493
15842 #, no-wrap
15843 msgid "B<setresgid32>(2)\t2.4\n"
15844 msgstr ""
15845
15846 #. type: tbl table
15847 #: build/C/man2/syscalls.2:494
15848 #, no-wrap
15849 msgid "B<setresuid>(2)\t2.2\n"
15850 msgstr ""
15851
15852 #. type: tbl table
15853 #: build/C/man2/syscalls.2:495
15854 #, no-wrap
15855 msgid "B<setresuid32>(2)\t2.4\n"
15856 msgstr ""
15857
15858 #. type: tbl table
15859 #: build/C/man2/syscalls.2:496
15860 #, no-wrap
15861 msgid "B<setreuid>(2)\t1.0\n"
15862 msgstr ""
15863
15864 #. type: tbl table
15865 #: build/C/man2/syscalls.2:497
15866 #, no-wrap
15867 msgid "B<setreuid32>(2)\t2.4\n"
15868 msgstr ""
15869
15870 #. type: tbl table
15871 #: build/C/man2/syscalls.2:498
15872 #, no-wrap
15873 msgid "B<setrlimit>(2)\t1.0\n"
15874 msgstr ""
15875
15876 #. type: tbl table
15877 #: build/C/man2/syscalls.2:499
15878 #, no-wrap
15879 msgid "B<setsid>(2)\t1.0\n"
15880 msgstr ""
15881
15882 #. type: tbl table
15883 #: build/C/man2/syscalls.2:500
15884 #, no-wrap
15885 msgid "B<setsockopt>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
15886 msgstr ""
15887
15888 #. type: tbl table
15889 #: build/C/man2/syscalls.2:501
15890 #, no-wrap
15891 msgid "B<settimeofday>(2)\t1.0\n"
15892 msgstr ""
15893
15894 #. type: tbl table
15895 #: build/C/man2/syscalls.2:502
15896 #, no-wrap
15897 msgid "B<setuid>(2)\t1.0\n"
15898 msgstr ""
15899
15900 #. type: tbl table
15901 #: build/C/man2/syscalls.2:503
15902 #, no-wrap
15903 msgid "B<setuid32>(2)\t2.4\n"
15904 msgstr ""
15905
15906 #. type: tbl table
15907 #: build/C/man2/syscalls.2:504
15908 #, no-wrap
15909 msgid "B<setup>(2)\t\tRemoved in 2.2\n"
15910 msgstr ""
15911
15912 #. type: tbl table
15913 #: build/C/man2/syscalls.2:505
15914 #, no-wrap
15915 msgid "B<setxattr>(2)\t2.6; 2.4.18\n"
15916 msgstr ""
15917
15918 #. type: tbl table
15919 #: build/C/man2/syscalls.2:506
15920 #, no-wrap
15921 msgid "B<sgetmask>(2)\t1.0\n"
15922 msgstr ""
15923
15924 #. type: tbl table
15925 #: build/C/man2/syscalls.2:507
15926 #, no-wrap
15927 msgid "B<shmat>(2)\t2.0\tSee notes on B<ipc>(2)\n"
15928 msgstr ""
15929
15930 #. type: tbl table
15931 #: build/C/man2/syscalls.2:508
15932 #, no-wrap
15933 msgid "B<shmctl>(2)\t2.0\tSee notes on B<ipc>(2)\n"
15934 msgstr ""
15935
15936 #. type: tbl table
15937 #: build/C/man2/syscalls.2:509
15938 #, no-wrap
15939 msgid "B<shmdt>(2)\t2.0\tSee notes on B<ipc>(2)\n"
15940 msgstr ""
15941
15942 #. type: tbl table
15943 #: build/C/man2/syscalls.2:510
15944 #, no-wrap
15945 msgid "B<shmget>(2)\t2.0\tSee notes on B<ipc>(2)\n"
15946 msgstr ""
15947
15948 #. type: tbl table
15949 #: build/C/man2/syscalls.2:511
15950 #, no-wrap
15951 msgid "B<shutdown>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
15952 msgstr ""
15953
15954 #. type: tbl table
15955 #: build/C/man2/syscalls.2:512
15956 #, no-wrap
15957 msgid "B<sigaction>(2)\t1.0\n"
15958 msgstr ""
15959
15960 #. type: tbl table
15961 #: build/C/man2/syscalls.2:513
15962 #, no-wrap
15963 msgid "B<sigaltstack>(2)\t2.2\n"
15964 msgstr ""
15965
15966 #. type: tbl table
15967 #: build/C/man2/syscalls.2:514
15968 #, no-wrap
15969 msgid "B<signal>(2)\t1.0\n"
15970 msgstr ""
15971
15972 #. type: tbl table
15973 #: build/C/man2/syscalls.2:515
15974 #, no-wrap
15975 msgid "B<signalfd>(2)\t2.6.22\n"
15976 msgstr ""
15977
15978 #. type: tbl table
15979 #: build/C/man2/syscalls.2:516
15980 #, no-wrap
15981 msgid "B<signalfd4>(2)\t2.6.27\n"
15982 msgstr ""
15983
15984 #. type: tbl table
15985 #: build/C/man2/syscalls.2:517
15986 #, no-wrap
15987 msgid "B<sigpending>(2)\t1.0\n"
15988 msgstr ""
15989
15990 #. type: tbl table
15991 #: build/C/man2/syscalls.2:518
15992 #, no-wrap
15993 msgid "B<sigprocmask>(2)\t1.0\n"
15994 msgstr ""
15995
15996 #. type: tbl table
15997 #: build/C/man2/syscalls.2:519
15998 #, no-wrap
15999 msgid "B<sigreturn>(2)\t1.0\n"
16000 msgstr ""
16001
16002 #. type: tbl table
16003 #: build/C/man2/syscalls.2:520
16004 #, no-wrap
16005 msgid "B<sigsuspend>(2)\t1.0\n"
16006 msgstr ""
16007
16008 #. type: tbl table
16009 #: build/C/man2/syscalls.2:521
16010 #, no-wrap
16011 msgid "B<socket>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
16012 msgstr ""
16013
16014 #. type: tbl table
16015 #: build/C/man2/syscalls.2:522
16016 #, no-wrap
16017 msgid "B<socketcall>(2)\t1.0\n"
16018 msgstr ""
16019
16020 #.  Implements BSD socket calls
16021 #. type: tbl table
16022 #: build/C/man2/syscalls.2:524
16023 #, no-wrap
16024 msgid "B<socketpair>(2)\t2.0\tSee notes on B<socketcall>(2)\n"
16025 msgstr ""
16026
16027 #. type: tbl table
16028 #: build/C/man2/syscalls.2:525
16029 #, no-wrap
16030 msgid "B<splice>(2)\t2.6.17\n"
16031 msgstr ""
16032
16033 #. type: tbl table
16034 #: build/C/man2/syscalls.2:526
16035 #, no-wrap
16036 msgid "B<spu_create>(2)\t2.6.16\tPowerPC only\n"
16037 msgstr ""
16038
16039 #. type: tbl table
16040 #: build/C/man2/syscalls.2:527
16041 #, no-wrap
16042 msgid "B<spu_run>(2)\t2.6.16\tPowerPC only\n"
16043 msgstr ""
16044
16045 #. type: tbl table
16046 #: build/C/man2/syscalls.2:528
16047 #, no-wrap
16048 msgid "B<ssetmask>(2)\t1.0\n"
16049 msgstr ""
16050
16051 #. type: tbl table
16052 #: build/C/man2/syscalls.2:529
16053 #, no-wrap
16054 msgid "B<stat>(2)\t1.0\n"
16055 msgstr ""
16056
16057 #. type: tbl table
16058 #: build/C/man2/syscalls.2:530
16059 #, no-wrap
16060 msgid "B<stat64>(2)\t2.4\n"
16061 msgstr ""
16062
16063 #. type: tbl table
16064 #: build/C/man2/syscalls.2:531
16065 #, no-wrap
16066 msgid "B<statfs>(2)\t1.0\n"
16067 msgstr ""
16068
16069 #. type: tbl table
16070 #: build/C/man2/syscalls.2:532
16071 #, no-wrap
16072 msgid "B<statfs64>(2)\t2.6\n"
16073 msgstr ""
16074
16075 #. type: tbl table
16076 #: build/C/man2/syscalls.2:533
16077 #, no-wrap
16078 msgid "B<stime>(2)\t1.0\n"
16079 msgstr ""
16080
16081 #. type: tbl table
16082 #: build/C/man2/syscalls.2:534
16083 #, no-wrap
16084 msgid "B<subpage_prot>(2)\t2.6.25\tPowerPC if\n"
16085 msgstr ""
16086
16087 #. type: tbl table
16088 #: build/C/man2/syscalls.2:535
16089 #, no-wrap
16090 msgid "\t\tCONFIG_PPC_64K_PAGES\n"
16091 msgstr ""
16092
16093 #. type: tbl table
16094 #: build/C/man2/syscalls.2:536
16095 #, no-wrap
16096 msgid "B<swapoff>(2)\t1.0\n"
16097 msgstr ""
16098
16099 #. type: tbl table
16100 #: build/C/man2/syscalls.2:537
16101 #, no-wrap
16102 msgid "B<swapon>(2)\t1.0\n"
16103 msgstr ""
16104
16105 #. type: tbl table
16106 #: build/C/man2/syscalls.2:538
16107 #, no-wrap
16108 msgid "B<symlink>(2)\t1.0\n"
16109 msgstr ""
16110
16111 #. type: tbl table
16112 #: build/C/man2/syscalls.2:539
16113 #, no-wrap
16114 msgid "B<symlinkat>(2)\t2.6.16\n"
16115 msgstr ""
16116
16117 #. type: tbl table
16118 #: build/C/man2/syscalls.2:540
16119 #, no-wrap
16120 msgid "B<sync>(2)\t1.0\n"
16121 msgstr ""
16122
16123 #. type: tbl table
16124 #: build/C/man2/syscalls.2:541
16125 #, no-wrap
16126 msgid "B<sync_file_range>(2)\t2.6.17\n"
16127 msgstr ""
16128
16129 #. type: tbl table
16130 #: build/C/man2/syscalls.2:542
16131 #, no-wrap
16132 msgid "B<sync_file_range2>(2)\t2.6.22\tT{\n"
16133 msgstr ""
16134
16135 #. type: tbl table
16136 #: build/C/man2/syscalls.2:543
16137 #, no-wrap
16138 msgid "Architecture-specific\n"
16139 msgstr ""
16140
16141 #. type: tbl table
16142 #: build/C/man2/syscalls.2:544
16143 #, no-wrap
16144 msgid "variant of B<sync_file_range>(2)\n"
16145 msgstr ""
16146
16147 #.  PowerPC, ARM, tile
16148 #.  First appeared on ARM, as arm_sync_file_range(), but later renamed
16149 #.  \fBsys_debug_setcontext\fP(2)       ???     PowerPC if CONFIG_PPC32
16150 #. type: tbl table
16151 #: build/C/man2/syscalls.2:549
16152 #, no-wrap
16153 msgid "B<syncfs>(2)\t2.6.39\n"
16154 msgstr ""
16155
16156 #. type: tbl table
16157 #: build/C/man2/syscalls.2:550
16158 #, no-wrap
16159 msgid "B<sysfs>(2)\t1.2\n"
16160 msgstr ""
16161
16162 #. type: tbl table
16163 #: build/C/man2/syscalls.2:551
16164 #, no-wrap
16165 msgid "B<sysinfo>(2)\t1.0\n"
16166 msgstr ""
16167
16168 #. type: tbl table
16169 #: build/C/man2/syscalls.2:552
16170 #, no-wrap
16171 msgid "B<syslog>(2)\t1.0\n"
16172 msgstr ""
16173
16174 #.  glibc interface is \fBklogctl\fP(3)
16175 #. type: tbl table
16176 #: build/C/man2/syscalls.2:554
16177 #, no-wrap
16178 msgid "B<tee>(2)\t2.6.17\n"
16179 msgstr ""
16180
16181 #. type: tbl table
16182 #: build/C/man2/syscalls.2:555
16183 #, no-wrap
16184 msgid "B<tgkill>(2)\t2.6\n"
16185 msgstr ""
16186
16187 #. type: tbl table
16188 #: build/C/man2/syscalls.2:556
16189 #, no-wrap
16190 msgid "B<time>(2)\t1.0\n"
16191 msgstr ""
16192
16193 #. type: tbl table
16194 #: build/C/man2/syscalls.2:557
16195 #, no-wrap
16196 msgid "B<timer_create>(2)\t2.6\n"
16197 msgstr ""
16198
16199 #. type: tbl table
16200 #: build/C/man2/syscalls.2:558
16201 #, no-wrap
16202 msgid "B<timer_delete>(2)\t2.6\n"
16203 msgstr ""
16204
16205 #. type: tbl table
16206 #: build/C/man2/syscalls.2:559
16207 #, no-wrap
16208 msgid "B<timer_getoverrun>(2)\t2.6\n"
16209 msgstr ""
16210
16211 #. type: tbl table
16212 #: build/C/man2/syscalls.2:560
16213 #, no-wrap
16214 msgid "B<timer_gettime>(2)\t2.6\n"
16215 msgstr ""
16216
16217 #. type: tbl table
16218 #: build/C/man2/syscalls.2:561
16219 #, no-wrap
16220 msgid "B<timer_settime>(2)\t2.6\n"
16221 msgstr ""
16222
16223 #. type: tbl table
16224 #: build/C/man2/syscalls.2:562
16225 #, no-wrap
16226 msgid "B<timerfd_create>(2)\t2.6.25\n"
16227 msgstr ""
16228
16229 #. type: tbl table
16230 #: build/C/man2/syscalls.2:563
16231 #, no-wrap
16232 msgid "B<timerfd_gettime>(2)\t2.6.25\n"
16233 msgstr ""
16234
16235 #. type: tbl table
16236 #: build/C/man2/syscalls.2:564
16237 #, no-wrap
16238 msgid "B<timerfd_settime>(2)\t2.6.25\n"
16239 msgstr ""
16240
16241 #. type: tbl table
16242 #: build/C/man2/syscalls.2:565
16243 #, no-wrap
16244 msgid "B<times>(2)\t1.0\n"
16245 msgstr ""
16246
16247 #. type: tbl table
16248 #: build/C/man2/syscalls.2:566
16249 #, no-wrap
16250 msgid "B<tkill>(2)\t2.6; 2.4.22\n"
16251 msgstr ""
16252
16253 #. type: tbl table
16254 #: build/C/man2/syscalls.2:567
16255 #, no-wrap
16256 msgid "B<truncate>(2)\t1.0\n"
16257 msgstr ""
16258
16259 #. type: tbl table
16260 #: build/C/man2/syscalls.2:568
16261 #, no-wrap
16262 msgid "B<truncate64>(2)\t2.4\n"
16263 msgstr ""
16264
16265 #. type: tbl table
16266 #: build/C/man2/syscalls.2:569
16267 #, no-wrap
16268 msgid "B<ugetrlimit>(2)\t2.4\n"
16269 msgstr ""
16270
16271 #. type: tbl table
16272 #: build/C/man2/syscalls.2:570
16273 #, no-wrap
16274 msgid "B<umask>(2)\t1.0\n"
16275 msgstr ""
16276
16277 #. type: tbl table
16278 #: build/C/man2/syscalls.2:571
16279 #, no-wrap
16280 msgid "B<umount>(2)\t1.0\n"
16281 msgstr ""
16282
16283 #.  sys_oldumount() -- __NR_umount
16284 #. type: tbl table
16285 #: build/C/man2/syscalls.2:573
16286 #, no-wrap
16287 msgid "B<umount2>(2)\t2.2\n"
16288 msgstr ""
16289
16290 #.  sys_umount() -- __NR_umount2
16291 #. type: tbl table
16292 #: build/C/man2/syscalls.2:575
16293 #, no-wrap
16294 msgid "B<uname>(2)\t1.0\n"
16295 msgstr ""
16296
16297 #. type: tbl table
16298 #: build/C/man2/syscalls.2:576
16299 #, no-wrap
16300 msgid "B<unlink>(2)\t1.0\n"
16301 msgstr ""
16302
16303 #. type: tbl table
16304 #: build/C/man2/syscalls.2:577
16305 #, no-wrap
16306 msgid "B<unlinkat>(2)\t2.6.16\n"
16307 msgstr ""
16308
16309 #. type: tbl table
16310 #: build/C/man2/syscalls.2:578
16311 #, no-wrap
16312 msgid "B<unshare>(2)\t2.6.16\n"
16313 msgstr ""
16314
16315 #. type: tbl table
16316 #: build/C/man2/syscalls.2:579
16317 #, no-wrap
16318 msgid "B<uselib>(2)\t1.0\n"
16319 msgstr ""
16320
16321 #. type: tbl table
16322 #: build/C/man2/syscalls.2:580
16323 #, no-wrap
16324 msgid "B<ustat>(2)\t1.0\n"
16325 msgstr ""
16326
16327 #. type: tbl table
16328 #: build/C/man2/syscalls.2:581
16329 #, no-wrap
16330 msgid "B<utime>(2)\t1.0\n"
16331 msgstr ""
16332
16333 #. type: tbl table
16334 #: build/C/man2/syscalls.2:582
16335 #, no-wrap
16336 msgid "B<utimensat>(2)\t2.6.22\n"
16337 msgstr ""
16338
16339 #. type: tbl table
16340 #: build/C/man2/syscalls.2:583
16341 #, no-wrap
16342 msgid "B<utimes>(2)\t2.2\n"
16343 msgstr ""
16344
16345 #. type: tbl table
16346 #: build/C/man2/syscalls.2:584
16347 #, no-wrap
16348 msgid "B<utrap_install>(2)\t2.2\tSparc\n"
16349 msgstr ""
16350
16351 #. type: tbl table
16352 #: build/C/man2/syscalls.2:585
16353 #, no-wrap
16354 msgid "B<vfork>(2)\t2.2\n"
16355 msgstr ""
16356
16357 #. type: tbl table
16358 #: build/C/man2/syscalls.2:586
16359 #, no-wrap
16360 msgid "B<vhangup>(2)\t1.0\n"
16361 msgstr ""
16362
16363 #. type: tbl table
16364 #: build/C/man2/syscalls.2:587
16365 #, no-wrap
16366 msgid "B<vm86old>(2)\t1.0\tT{\n"
16367 msgstr ""
16368
16369 #. type: tbl table
16370 #: build/C/man2/syscalls.2:588
16371 #, no-wrap
16372 msgid "Was \"vm86\"; renamed in\n"
16373 msgstr ""
16374
16375 #. type: tbl table
16376 #: build/C/man2/syscalls.2:589
16377 #, no-wrap
16378 msgid "2.0.28/2.2\n"
16379 msgstr ""
16380
16381 #. type: tbl table
16382 #: build/C/man2/syscalls.2:591
16383 #, no-wrap
16384 msgid "B<vm86>(2)\t2.0.28; 2.2\n"
16385 msgstr ""
16386
16387 #. type: tbl table
16388 #: build/C/man2/syscalls.2:592
16389 #, no-wrap
16390 msgid "B<vmsplice>(2)\t2.6.17\n"
16391 msgstr ""
16392
16393 #. type: tbl table
16394 #: build/C/man2/syscalls.2:593
16395 #, no-wrap
16396 msgid "B<wait4>(2)\t1.0\n"
16397 msgstr ""
16398
16399 #. type: tbl table
16400 #: build/C/man2/syscalls.2:594
16401 #, no-wrap
16402 msgid "B<waitid>(2)\t2.6.10\n"
16403 msgstr ""
16404
16405 #. type: tbl table
16406 #: build/C/man2/syscalls.2:595
16407 #, no-wrap
16408 msgid "B<waitpid>(2)\t1.0\n"
16409 msgstr ""
16410
16411 #. type: tbl table
16412 #: build/C/man2/syscalls.2:596
16413 #, no-wrap
16414 msgid "B<write>(2)\t1.0\n"
16415 msgstr ""
16416
16417 #. type: tbl table
16418 #: build/C/man2/syscalls.2:597
16419 #, no-wrap
16420 msgid "B<writev>(2)\t2.0\n"
16421 msgstr ""
16422
16423 #. type: Plain text
16424 #: build/C/man2/syscalls.2:606
16425 msgid ""
16426 "On many platforms, including x86-32, socket calls are all multiplexed (via "
16427 "glibc wrapper functions) through B<socketcall>(2)  and similarly System V "
16428 "IPC calls are multiplexed through B<ipc>(2)."
16429 msgstr ""
16430
16431 #.  __NR_afs_syscall is 53 on Linux 2.6.22/i386
16432 #.  __NR_break is 17 on Linux 2.6.22/i386
16433 #.  __NR_ftime is 35 on Linux 2.6.22/i386
16434 #.  __NR_getpmsg is 188 on Linux 2.6.22/i386
16435 #.  __NR_gtty is 32 on Linux 2.6.22/i386
16436 #.  __NR_idle is 112 on Linux 2.6.22/i386
16437 #.  __NR_lock is 53 on Linux 2.6.22/i386
16438 #.  __NR_madvise1 is 219 on Linux 2.6.22/i386
16439 #.  __NR_mpx is 66 on Linux 2.6.22/i386
16440 #.  Slot has been reused
16441 #.  __NR_prof is 44 on Linux 2.6.22/i386
16442 #.  __NR_profil is 98 on Linux 2.6.22/i386
16443 #.  __NR_putpmsg is 189 on Linux 2.6.22/i386
16444 #.  __NR_security is 223 on Linux 2.4/i386
16445 #.  __NR_security is 223 on Linux 2.4/i386; absent on 2.6/i386, present
16446 #.  on a couple of 2.6 architectures
16447 #.  __NR_stty is 31 on Linux 2.6.22/i386
16448 #.  The security call is for future use.
16449 #.  __NR_tuxcall is 184 on x86_64, also on PPC and alpha
16450 #.  __NR_ulimit is 58 on Linux 2.6.22/i386
16451 #.  __NR_vserver is 273 on Linux 2.6.22/i386
16452 #. type: Plain text
16453 #: build/C/man2/syscalls.2:651
16454 msgid ""
16455 "Although slots are reserved for them in the system call table, the following "
16456 "system calls are not implemented in the standard kernel: B<afs_syscall>(2), "
16457 "B<break>(2), B<ftime>(2), B<getpmsg>(2), B<gtty>(2), B<idle>(2), B<lock>(2), "
16458 "B<madvise1>(2), B<mpx>(2), B<phys>(2), B<prof>(2), B<profil>(2), "
16459 "B<putpmsg>(2), B<security>(2), B<stty>(2), B<tuxcall>(2), B<ulimit>(2), and "
16460 "B<vserver>(2)  (see also B<unimplemented>(2)).  However, B<ftime>(3), "
16461 "B<profil>(3)  and B<ulimit>(3)  exist as library routines.  The slot for "
16462 "B<phys>(2)  is in use since kernel 2.1.116 for B<umount>(2); B<phys>(2)  "
16463 "will never be implemented.  The B<getpmsg>(2)  and B<putpmsg>(2)  calls are "
16464 "for kernels patched to support STREAMS, and may never be in the standard "
16465 "kernel."
16466 msgstr ""
16467
16468 #. type: Plain text
16469 #: build/C/man2/syscalls.2:656
16470 msgid ""
16471 "There was briefly B<set_zone_reclaim>(2), added in Linux 2.6.13, and removed "
16472 "in 2.6.16; this system call was never available to user space."
16473 msgstr ""
16474
16475 #. type: Plain text
16476 #: build/C/man2/syscalls.2:673
16477 msgid ""
16478 "Roughly speaking, the code belonging to the system call with number __NR_xxx "
16479 "defined in I</usr/include/asm/unistd.h> can be found in the Linux kernel "
16480 "source in the routine I<sys_xxx>().  (The dispatch table for i386 can be "
16481 "found in I</usr/src/linux/arch/i386/kernel/entry.S>.)  There are many "
16482 "exceptions, however, mostly because older system calls were superseded by "
16483 "newer ones, and this has been treated somewhat unsystematically.  On "
16484 "platforms with proprietary operating-system emulation, such as parisc, "
16485 "sparc, sparc64 and alpha, there are many additional system calls; mips64 "
16486 "also contains a full set of 32-bit system calls."
16487 msgstr ""
16488
16489 #. type: Plain text
16490 #: build/C/man2/syscalls.2:692
16491 msgid ""
16492 "Over time, changes to the interfaces of some system calls have been "
16493 "necessary.  One reason for such changes was the need to increase the size of "
16494 "structures or scalar values passed to the system call.  Because of these "
16495 "changes, there are now various groups of related system calls (e.g., "
16496 "B<truncate>(2)  and B<truncate64>(2))  which perform similar tasks, but "
16497 "which vary in details such as the size of their arguments.  (As noted "
16498 "earlier, applications are generally unaware of this: the glibc wrapper "
16499 "functions do some work to ensure that the right system call is invoked, and "
16500 "that ABI compatibility is preserved for old binaries.)  Examples of systems "
16501 "calls that exist in multiple versions are the following:"
16502 msgstr ""
16503
16504 #.  e.g., on 2.6.22/i386: __NR_oldstat 18, __NR_stat 106, __NR_stat64 195
16505 #.  The stat system calls deal with three different data structures,
16506 #.  defined in include/asm-i386/stat.h: __old_kernel_stat, stat, stat64
16507 #. type: Plain text
16508 #: build/C/man2/syscalls.2:713
16509 msgid ""
16510 "By now there are three different versions of B<stat>(2): I<sys_stat>()  "
16511 "(slot I<__NR_oldstat>), I<sys_newstat>()  (slot I<__NR_stat>), and "
16512 "I<sys_stat64>()  (slot I<__NR_stat64>), with the last being the most "
16513 "current.  A similar story applies for B<lstat>(2)  and B<fstat>(2)."
16514 msgstr ""
16515
16516 #. type: Plain text
16517 #: build/C/man2/syscalls.2:724
16518 msgid ""
16519 "Similarly, the defines I<__NR_oldolduname>, I<__NR_olduname>, and "
16520 "I<__NR_uname> refer to the routines I<sys_olduname>(), I<sys_uname>()  and "
16521 "I<sys_newuname>()."
16522 msgstr ""
16523
16524 #. type: Plain text
16525 #: build/C/man2/syscalls.2:731
16526 msgid ""
16527 "In Linux 2.0, a new version of B<vm86>(2)  appeared, with the old and the "
16528 "new kernel routines being named I<sys_vm86old>()  and I<sys_vm86>()."
16529 msgstr ""
16530
16531 #. type: Plain text
16532 #: build/C/man2/syscalls.2:742
16533 msgid ""
16534 "In Linux 2.4, a new version of B<getrlimit>(2)  appeared, with the old and "
16535 "the new kernel routines being named I<sys_old_getrlimit>()  (slot "
16536 "I<__NR_getrlimit>)  and I<sys_getrlimit>()  (slot I<__NR_ugetrlimit>)."
16537 msgstr ""
16538
16539 #.  64-bit off_t changes: ftruncate64, *stat64,
16540 #.  fcntl64 (because of the flock structure), getdents64, *statfs64
16541 #. type: Plain text
16542 #: build/C/man2/syscalls.2:754
16543 msgid ""
16544 "Linux 2.4 increased the size of user and group IDs from 16 to 32 bits.  To "
16545 "support this change, a range of system calls were added (e.g., "
16546 "B<chown32>(2), B<getuid32>(2), B<getgroups32>(2), B<setresuid32>(2)), "
16547 "superseding earlier calls of the same name without the \"32\" suffix."
16548 msgstr ""
16549
16550 #. type: Plain text
16551 #: build/C/man2/syscalls.2:771
16552 msgid ""
16553 "Linux 2.4 added support for applications on 32-bit architectures to access "
16554 "large files (i.e., files for which the sizes and file offsets can't be "
16555 "represented in 32 bits.)  To support this change, replacements were required "
16556 "for system calls that deal with file offsets and sizes.  Thus the following "
16557 "system calls were added: B<fcntl64>(2), B<ftruncate64>(2), B<getdents64>(2), "
16558 "B<stat64>(2), B<statfs64>(2), and their analogs that work with file "
16559 "descriptors or symbolic links.  These system calls supersede the older "
16560 "system calls which, except in the case of the \"stat\" calls, have the same "
16561 "name without the \"64\" suffix."
16562 msgstr ""
16563
16564 #. type: Plain text
16565 #: build/C/man2/syscalls.2:775
16566 msgid ""
16567 "On newer platforms that only have 64-bit file access and 32-bit uids (e.g., "
16568 "alpha, ia64, s390x) there are no *64 or *32 calls.  Where the *64 and *32 "
16569 "calls exist, the other versions are obsolete."
16570 msgstr ""
16571
16572 #. type: Plain text
16573 #: build/C/man2/syscalls.2:783
16574 msgid ""
16575 "The I<rt_sig*> calls were added in kernel 2.2 to support the addition of "
16576 "real-time signals (see B<signal>(7)).  These system calls supersede the "
16577 "older system calls of the same name without the \"rt_\" prefix."
16578 msgstr ""
16579
16580 #.  (used by libc 6)
16581 #.  .PP
16582 #.  Two system call numbers,
16583 #.  .IR __NR__llseek
16584 #.  and
16585 #.  .IR __NR__sysctl
16586 #.  have an additional underscore absent in
16587 #.  .IR sys_llseek ()
16588 #.  and
16589 #.  .IR sys_sysctl ().
16590 #
16591 #.  In kernel 2.1.81,
16592 #.  .BR lchown (2)
16593 #.  and
16594 #.  .BR chown (2)
16595 #.  were swapped; that is,
16596 #.  .BR lchown (2)
16597 #.  was added with the semantics that were then current for
16598 #.  .BR chown (2),
16599 #.  and the semantics of the latter call were changed to what
16600 #.  they are today.
16601 #. type: Plain text
16602 #: build/C/man2/syscalls.2:833
16603 msgid ""
16604 "The B<select>(2)  and B<mmap>(2)  system calls use five or more arguments, "
16605 "which caused problems in the way argument passing on the i386 used to be set "
16606 "up.  Thus, while other architectures have I<sys_select>()  and I<sys_mmap>()  "
16607 "corresponding to I<__NR_select> and I<__NR_mmap>, on i386 one finds "
16608 "I<old_select>()  and I<old_mmap>()  (routines that use a pointer to a "
16609 "argument block) instead.  These days passing five arguments is not a problem "
16610 "any more, and there is a I<__NR__newselect> that corresponds directly to "
16611 "I<sys_select>()  and similarly I<__NR_mmap2>."
16612 msgstr ""
16613
16614 #. type: Plain text
16615 #: build/C/man2/syscalls.2:837
16616 msgid "B<syscall>(2), B<unimplemented>(2), B<libc>(7)"
16617 msgstr ""
16618
16619 #. type: TH
16620 #: build/C/man3/sysconf.3:27
16621 #, no-wrap
16622 msgid "SYSCONF"
16623 msgstr ""
16624
16625 #. type: TH
16626 #: build/C/man3/sysconf.3:27
16627 #, no-wrap
16628 msgid "2013-02-12"
16629 msgstr ""
16630
16631 #. type: Plain text
16632 #: build/C/man3/sysconf.3:30
16633 msgid "sysconf - get configuration information at run time"
16634 msgstr ""
16635
16636 #. type: Plain text
16637 #: build/C/man3/sysconf.3:35
16638 #, no-wrap
16639 msgid "B<long sysconf(int >I<name>B<);>\n"
16640 msgstr ""
16641
16642 #. type: Plain text
16643 #: build/C/man3/sysconf.3:40
16644 msgid ""
16645 "POSIX allows an application to test at compile or run time whether certain "
16646 "options are supported, or what the value is of certain configurable "
16647 "constants or limits."
16648 msgstr ""
16649
16650 #. type: Plain text
16651 #: build/C/man3/sysconf.3:46
16652 msgid ""
16653 "At compile time this is done by including I<E<lt>unistd.hE<gt>> and/or "
16654 "I<E<lt>limits.hE<gt>> and testing the value of certain macros."
16655 msgstr ""
16656
16657 #. type: Plain text
16658 #: build/C/man3/sysconf.3:56
16659 msgid ""
16660 "At run time, one can ask for numerical values using the present function "
16661 "B<sysconf>().  One can ask for numerical values that may depend on the file "
16662 "system a file is in using the calls B<fpathconf>(3)  and B<pathconf>(3).  "
16663 "One can ask for string values using B<confstr>(3)."
16664 msgstr ""
16665
16666 #.  except that sysconf(_SC_OPEN_MAX) may change answer after a call
16667 #.  to setrlimit( ) which changes the RLIMIT_NOFILE soft limit
16668 #. type: Plain text
16669 #: build/C/man3/sysconf.3:61
16670 msgid ""
16671 "The values obtained from these functions are system configuration "
16672 "constants.  They do not change during the lifetime of a process."
16673 msgstr ""
16674
16675 #.  and 999 to indicate support for options no longer present in the latest
16676 #.  standard. (?)
16677 #. type: Plain text
16678 #: build/C/man3/sysconf.3:84
16679 msgid ""
16680 "For options, typically, there is a constant B<_POSIX_FOO> that may be "
16681 "defined in I<E<lt>unistd.hE<gt>>.  If it is undefined, one should ask at run "
16682 "time.  If it is defined to -1, then the option is not supported.  If it is "
16683 "defined to 0, then relevant functions and headers exist, but one has to ask "
16684 "at run time what degree of support is available.  If it is defined to a "
16685 "value other than -1 or 0, then the option is supported.  Usually the value "
16686 "(such as 200112L) indicates the year and month of the POSIX revision "
16687 "describing the option.  Glibc uses the value 1 to indicate support as long "
16688 "as the POSIX revision has not been published yet.  The B<sysconf>()  "
16689 "argument will be B<_SC_FOO>.  For a list of options, see B<posixoptions>(7)."
16690 msgstr ""
16691
16692 #. type: Plain text
16693 #: build/C/man3/sysconf.3:104
16694 msgid ""
16695 "For variables or limits, typically, there is a constant B<_FOO>, maybe "
16696 "defined in I<E<lt>limits.hE<gt>>, or B<_POSIX_FOO>, maybe defined in "
16697 "I<E<lt>unistd.hE<gt>>.  The constant will not be defined if the limit is "
16698 "unspecified.  If the constant is defined, it gives a guaranteed value, and a "
16699 "greater value might actually be supported.  If an application wants to take "
16700 "advantage of values which may change between systems, a call to B<sysconf>()  "
16701 "can be made.  The B<sysconf>()  argument will be B<_SC_FOO>."
16702 msgstr ""
16703
16704 #. type: SS
16705 #: build/C/man3/sysconf.3:104
16706 #, no-wrap
16707 msgid "POSIX.1 variables"
16708 msgstr ""
16709
16710 #. type: Plain text
16711 #: build/C/man3/sysconf.3:109
16712 msgid ""
16713 "We give the name of the variable, the name of the B<sysconf>()  argument "
16714 "used to inquire about its value, and a short description."
16715 msgstr ""
16716
16717 #.  [for the moment: only the things that are unconditionally present]
16718 #.  .TP
16719 #.  .BR AIO_LISTIO_MAX " - " _SC_AIO_LISTIO_MAX
16720 #.  (if _POSIX_ASYNCHRONOUS_IO)
16721 #.  Maximum number of I/O operations in a single list I/O call.
16722 #.  Must not be less than _POSIX_AIO_LISTIO_MAX.
16723 #.  .TP
16724 #.  .BR AIO_MAX " - " _SC_AIO_MAX
16725 #.  (if _POSIX_ASYNCHRONOUS_IO)
16726 #.  Maximum number of outstanding asynchronous I/O operations.
16727 #.  Must not be less than _POSIX_AIO_MAX.
16728 #.  .TP
16729 #.  .BR AIO_PRIO_DELTA_MAX " - " _SC_AIO_PRIO_DELTA_MAX
16730 #.  (if _POSIX_ASYNCHRONOUS_IO)
16731 #.  The maximum amount by which a process can decrease its
16732 #.  asynchronous I/O priority level from its own scheduling priority.
16733 #.  Must be nonnegative.
16734 #. type: Plain text
16735 #: build/C/man3/sysconf.3:128
16736 msgid "First, the POSIX.1 compatible values."
16737 msgstr ""
16738
16739 #. type: TP
16740 #: build/C/man3/sysconf.3:128
16741 #, no-wrap
16742 msgid "B<ARG_MAX> - B<_SC_ARG_MAX>"
16743 msgstr ""
16744
16745 #. type: Plain text
16746 #: build/C/man3/sysconf.3:136
16747 msgid ""
16748 "The maximum length of the arguments to the B<exec>(3)  family of functions.  "
16749 "Must not be less than B<_POSIX_ARG_MAX> (4096)."
16750 msgstr ""
16751
16752 #. type: TP
16753 #: build/C/man3/sysconf.3:136
16754 #, no-wrap
16755 msgid "B<CHILD_MAX> - B<_SC_CHILD_MAX>"
16756 msgstr ""
16757
16758 #. type: Plain text
16759 #: build/C/man3/sysconf.3:142
16760 msgid ""
16761 "The maximum number of simultaneous processes per user ID.  Must not be less "
16762 "than B<_POSIX_CHILD_MAX> (25)."
16763 msgstr ""
16764
16765 #. type: TP
16766 #: build/C/man3/sysconf.3:142
16767 #, no-wrap
16768 msgid "B<HOST_NAME_MAX> - B<_SC_HOST_NAME_MAX>"
16769 msgstr ""
16770
16771 #. type: Plain text
16772 #: build/C/man3/sysconf.3:150
16773 msgid ""
16774 "Maximum length of a hostname, not including the terminating null byte, as "
16775 "returned by B<gethostname>(2).  Must not be less than "
16776 "B<_POSIX_HOST_NAME_MAX> (255)."
16777 msgstr ""
16778
16779 #. type: TP
16780 #: build/C/man3/sysconf.3:150
16781 #, no-wrap
16782 msgid "B<LOGIN_NAME_MAX> - B<_SC_LOGIN_NAME_MAX>"
16783 msgstr ""
16784
16785 #. type: Plain text
16786 #: build/C/man3/sysconf.3:156
16787 msgid ""
16788 "Maximum length of a login name, including the terminating null byte.  Must "
16789 "not be less than B<_POSIX_LOGIN_NAME_MAX> (9)."
16790 msgstr ""
16791
16792 #. type: TP
16793 #: build/C/man3/sysconf.3:156
16794 #, no-wrap
16795 msgid "clock ticks - B<_SC_CLK_TCK>"
16796 msgstr ""
16797
16798 #. type: Plain text
16799 #: build/C/man3/sysconf.3:165
16800 msgid ""
16801 "The number of clock ticks per second.  The corresponding variable is "
16802 "obsolete.  It was of course called B<CLK_TCK>.  (Note: the macro "
16803 "B<CLOCKS_PER_SEC> does not give information: it must equal 1000000.)"
16804 msgstr ""
16805
16806 #. type: TP
16807 #: build/C/man3/sysconf.3:165
16808 #, no-wrap
16809 msgid "B<OPEN_MAX> - B<_SC_OPEN_MAX>"
16810 msgstr ""
16811
16812 #. type: Plain text
16813 #: build/C/man3/sysconf.3:171
16814 msgid ""
16815 "The maximum number of files that a process can have open at any time.  Must "
16816 "not be less than B<_POSIX_OPEN_MAX> (20)."
16817 msgstr ""
16818
16819 #. type: TP
16820 #: build/C/man3/sysconf.3:171
16821 #, no-wrap
16822 msgid "B<PAGESIZE> - B<_SC_PAGESIZE>"
16823 msgstr ""
16824
16825 #. type: Plain text
16826 #: build/C/man3/sysconf.3:176
16827 msgid ""
16828 "Size of a page in bytes.  Must not be less than 1.  (Some systems use "
16829 "PAGE_SIZE instead.)"
16830 msgstr ""
16831
16832 #. type: TP
16833 #: build/C/man3/sysconf.3:176 build/C/man3/sysconf.3:263
16834 #, no-wrap
16835 msgid "B<RE_DUP_MAX> - B<_SC_RE_DUP_MAX>"
16836 msgstr ""
16837
16838 #. type: Plain text
16839 #: build/C/man3/sysconf.3:185
16840 msgid ""
16841 "The number of repeated occurrences of a BRE permitted by B<regexec>(3)  and "
16842 "B<regcomp>(3).  Must not be less than B<_POSIX2_RE_DUP_MAX> (255)."
16843 msgstr ""
16844
16845 #. type: TP
16846 #: build/C/man3/sysconf.3:185
16847 #, no-wrap
16848 msgid "B<STREAM_MAX> - B<_SC_STREAM_MAX>"
16849 msgstr ""
16850
16851 #. type: Plain text
16852 #: build/C/man3/sysconf.3:194
16853 msgid ""
16854 "The maximum number of streams that a process can have open at any time.  If "
16855 "defined, it has the same value as the standard C macro B<FOPEN_MAX>.  Must "
16856 "not be less than B<_POSIX_STREAM_MAX> (8)."
16857 msgstr ""
16858
16859 #. type: TP
16860 #: build/C/man3/sysconf.3:194
16861 #, no-wrap
16862 msgid "B<SYMLOOP_MAX> - B<_SC_SYMLOOP_MAX>"
16863 msgstr ""
16864
16865 #. type: Plain text
16866 #: build/C/man3/sysconf.3:202
16867 msgid ""
16868 "The maximum number of symbolic links seen in a pathname before resolution "
16869 "returns B<ELOOP>.  Must not be less than B<_POSIX_SYMLOOP_MAX> (8)."
16870 msgstr ""
16871
16872 #. type: TP
16873 #: build/C/man3/sysconf.3:202
16874 #, no-wrap
16875 msgid "B<TTY_NAME_MAX> - B<_SC_TTY_NAME_MAX>"
16876 msgstr ""
16877
16878 #. type: Plain text
16879 #: build/C/man3/sysconf.3:209
16880 msgid ""
16881 "The maximum length of terminal device name, including the terminating null "
16882 "byte.  Must not be less than B<_POSIX_TTY_NAME_MAX> (9)."
16883 msgstr ""
16884
16885 #. type: TP
16886 #: build/C/man3/sysconf.3:209
16887 #, no-wrap
16888 msgid "B<TZNAME_MAX> - B<_SC_TZNAME_MAX>"
16889 msgstr ""
16890
16891 #. type: Plain text
16892 #: build/C/man3/sysconf.3:215
16893 msgid ""
16894 "The maximum number of bytes in a timezone name.  Must not be less than "
16895 "B<_POSIX_TZNAME_MAX> (6)."
16896 msgstr ""
16897
16898 #. type: TP
16899 #: build/C/man3/sysconf.3:215
16900 #, no-wrap
16901 msgid "B<_POSIX_VERSION> - B<_SC_VERSION>"
16902 msgstr ""
16903
16904 #. type: Plain text
16905 #: build/C/man3/sysconf.3:223
16906 msgid ""
16907 "indicates the year and month the POSIX.1 standard was approved in the format "
16908 "B<YYYYMML>; the value B<199009L> indicates the Sept. 1990 revision."
16909 msgstr ""
16910
16911 #. type: SS
16912 #: build/C/man3/sysconf.3:223
16913 #, no-wrap
16914 msgid "POSIX.2 variables"
16915 msgstr ""
16916
16917 #. type: Plain text
16918 #: build/C/man3/sysconf.3:225
16919 msgid "Next, the POSIX.2 values, giving limits for utilities."
16920 msgstr ""
16921
16922 #. type: TP
16923 #: build/C/man3/sysconf.3:225
16924 #, no-wrap
16925 msgid "B<BC_BASE_MAX> - B<_SC_BC_BASE_MAX>"
16926 msgstr ""
16927
16928 #. type: Plain text
16929 #: build/C/man3/sysconf.3:232
16930 msgid "indicates the maximum I<obase> value accepted by the B<bc>(1)  utility."
16931 msgstr ""
16932
16933 #. type: TP
16934 #: build/C/man3/sysconf.3:232
16935 #, no-wrap
16936 msgid "B<BC_DIM_MAX> - B<_SC_BC_DIM_MAX>"
16937 msgstr ""
16938
16939 #. type: Plain text
16940 #: build/C/man3/sysconf.3:236
16941 msgid "indicates the maximum value of elements permitted in an array by B<bc>(1)."
16942 msgstr ""
16943
16944 #. type: TP
16945 #: build/C/man3/sysconf.3:236
16946 #, no-wrap
16947 msgid "B<BC_SCALE_MAX> - B<_SC_BC_SCALE_MAX>"
16948 msgstr ""
16949
16950 #. type: Plain text
16951 #: build/C/man3/sysconf.3:242
16952 msgid "indicates the maximum I<scale> value allowed by B<bc>(1)."
16953 msgstr ""
16954
16955 #. type: TP
16956 #: build/C/man3/sysconf.3:242
16957 #, no-wrap
16958 msgid "B<BC_STRING_MAX> - B<_SC_BC_STRING_MAX>"
16959 msgstr ""
16960
16961 #. type: Plain text
16962 #: build/C/man3/sysconf.3:246
16963 msgid "indicates the maximum length of a string accepted by B<bc>(1)."
16964 msgstr ""
16965
16966 #. type: TP
16967 #: build/C/man3/sysconf.3:246
16968 #, no-wrap
16969 msgid "B<COLL_WEIGHTS_MAX> - B<_SC_COLL_WEIGHTS_MAX>"
16970 msgstr ""
16971
16972 #. type: Plain text
16973 #: build/C/man3/sysconf.3:252
16974 msgid ""
16975 "indicates the maximum numbers of weights that can be assigned to an entry of "
16976 "the B<LC_COLLATE order> keyword in the locale definition file,"
16977 msgstr ""
16978
16979 #. type: TP
16980 #: build/C/man3/sysconf.3:252
16981 #, no-wrap
16982 msgid "B<EXPR_NEST_MAX> - B<_SC_EXPR_NEST_MAX>"
16983 msgstr ""
16984
16985 #. type: Plain text
16986 #: build/C/man3/sysconf.3:257
16987 msgid ""
16988 "is the maximum number of expressions which can be nested within parentheses "
16989 "by B<expr>(1)."
16990 msgstr ""
16991
16992 #. type: TP
16993 #: build/C/man3/sysconf.3:257
16994 #, no-wrap
16995 msgid "B<LINE_MAX> - B<_SC_LINE_MAX>"
16996 msgstr ""
16997
16998 #. type: Plain text
16999 #: build/C/man3/sysconf.3:263
17000 msgid ""
17001 "The maximum length of a utility's input line, either from standard input or "
17002 "from a file.  This includes space for a trailing newline."
17003 msgstr ""
17004
17005 #. type: Plain text
17006 #: build/C/man3/sysconf.3:269
17007 msgid ""
17008 "The maximum number of repeated occurrences of a regular expression when the "
17009 "interval notation B<\\e{m,n\\e}> is used."
17010 msgstr ""
17011
17012 #. type: TP
17013 #: build/C/man3/sysconf.3:269
17014 #, no-wrap
17015 msgid "B<POSIX2_VERSION> - B<_SC_2_VERSION>"
17016 msgstr ""
17017
17018 #. type: Plain text
17019 #: build/C/man3/sysconf.3:273
17020 msgid "indicates the version of the POSIX.2 standard in the format of YYYYMML."
17021 msgstr ""
17022
17023 #. type: TP
17024 #: build/C/man3/sysconf.3:273
17025 #, no-wrap
17026 msgid "B<POSIX2_C_DEV> - B<_SC_2_C_DEV>"
17027 msgstr ""
17028
17029 #. type: Plain text
17030 #: build/C/man3/sysconf.3:277
17031 msgid ""
17032 "indicates whether the POSIX.2 C language development facilities are "
17033 "supported."
17034 msgstr ""
17035
17036 #. type: TP
17037 #: build/C/man3/sysconf.3:277
17038 #, no-wrap
17039 msgid "B<POSIX2_FORT_DEV> - B<_SC_2_FORT_DEV>"
17040 msgstr ""
17041
17042 #. type: Plain text
17043 #: build/C/man3/sysconf.3:281
17044 msgid "indicates whether the POSIX.2 FORTRAN development utilities are supported."
17045 msgstr ""
17046
17047 #. type: TP
17048 #: build/C/man3/sysconf.3:281
17049 #, no-wrap
17050 msgid "B<POSIX2_FORT_RUN> - B<_SC_2_FORT_RUN>"
17051 msgstr ""
17052
17053 #. type: Plain text
17054 #: build/C/man3/sysconf.3:284
17055 msgid "indicates whether the POSIX.2 FORTRAN run-time utilities are supported."
17056 msgstr ""
17057
17058 #. type: TP
17059 #: build/C/man3/sysconf.3:284
17060 #, no-wrap
17061 msgid "B<_POSIX2_LOCALEDEF> - B<_SC_2_LOCALEDEF>"
17062 msgstr ""
17063
17064 #. type: Plain text
17065 #: build/C/man3/sysconf.3:289
17066 msgid ""
17067 "indicates whether the POSIX.2 creation of locates via B<localedef>(1)  is "
17068 "supported."
17069 msgstr ""
17070
17071 #. type: TP
17072 #: build/C/man3/sysconf.3:289
17073 #, no-wrap
17074 msgid "B<POSIX2_SW_DEV> - B<_SC_2_SW_DEV>"
17075 msgstr ""
17076
17077 #. type: Plain text
17078 #: build/C/man3/sysconf.3:293
17079 msgid ""
17080 "indicates whether the POSIX.2 software development utilities option is "
17081 "supported."
17082 msgstr ""
17083
17084 #. type: Plain text
17085 #: build/C/man3/sysconf.3:295
17086 msgid "These values also exist, but may not be standard."
17087 msgstr ""
17088
17089 #. type: TP
17090 #: build/C/man3/sysconf.3:295
17091 #, no-wrap
17092 msgid " - B<_SC_PHYS_PAGES>"
17093 msgstr ""
17094
17095 #. type: Plain text
17096 #: build/C/man3/sysconf.3:302
17097 msgid ""
17098 "The number of pages of physical memory.  Note that it is possible for the "
17099 "product of this value and the value of B<_SC_PAGESIZE> to overflow."
17100 msgstr ""
17101
17102 #. type: TP
17103 #: build/C/man3/sysconf.3:302
17104 #, no-wrap
17105 msgid " - B<_SC_AVPHYS_PAGES>"
17106 msgstr ""
17107
17108 #. type: Plain text
17109 #: build/C/man3/sysconf.3:305
17110 msgid "The number of currently available pages of physical memory."
17111 msgstr ""
17112
17113 #. type: TP
17114 #: build/C/man3/sysconf.3:305
17115 #, no-wrap
17116 msgid " - B<_SC_NPROCESSORS_CONF>"
17117 msgstr ""
17118
17119 #. type: Plain text
17120 #: build/C/man3/sysconf.3:308
17121 msgid "The number of processors configured."
17122 msgstr ""
17123
17124 #. type: TP
17125 #: build/C/man3/sysconf.3:308
17126 #, no-wrap
17127 msgid " - B<_SC_NPROCESSORS_ONLN>"
17128 msgstr ""
17129
17130 #. type: Plain text
17131 #: build/C/man3/sysconf.3:311
17132 msgid "The number of processors currently online (available)."
17133 msgstr ""
17134
17135 #. type: Plain text
17136 #: build/C/man3/sysconf.3:324
17137 msgid ""
17138 "If I<name> is invalid, -1 is returned, and I<errno> is set to B<EINVAL>.  "
17139 "Otherwise, the value returned is the value of the system resource and "
17140 "I<errno> is not changed.  In the case of options, a positive value is "
17141 "returned if a queried option is available, and -1 if it is not.  In the case "
17142 "of limits, -1 means that there is no definite limit."
17143 msgstr ""
17144
17145 #. type: Plain text
17146 #: build/C/man3/sysconf.3:332
17147 msgid ""
17148 "It is difficult to use B<ARG_MAX> because it is not specified how much of "
17149 "the argument space for B<exec>(3)  is consumed by the user's environment "
17150 "variables."
17151 msgstr ""
17152
17153 #. type: Plain text
17154 #: build/C/man3/sysconf.3:343
17155 msgid ""
17156 "B<bc>(1), B<expr>(1), B<getconf>(1), B<locale>(1), B<fpathconf>(3), "
17157 "B<pathconf>(3), B<posixoptions>(7)"
17158 msgstr ""
17159
17160 #. type: TH
17161 #: build/C/man2/sysctl.2:30
17162 #, no-wrap
17163 msgid "SYSCTL"
17164 msgstr ""
17165
17166 #. type: TH
17167 #: build/C/man2/sysctl.2:30
17168 #, no-wrap
17169 msgid "2012-12-22"
17170 msgstr ""
17171
17172 #. type: Plain text
17173 #: build/C/man2/sysctl.2:33
17174 msgid "sysctl - read/write system parameters"
17175 msgstr ""
17176
17177 #. type: Plain text
17178 #: build/C/man2/sysctl.2:38
17179 #, no-wrap
17180 msgid "B<#include E<lt>linux/sysctl.hE<gt>>\n"
17181 msgstr ""
17182
17183 #. type: Plain text
17184 #: build/C/man2/sysctl.2:40
17185 #, no-wrap
17186 msgid "B<int _sysctl(struct __sysctl_args *>I<args>B<);>\n"
17187 msgstr ""
17188
17189 #. type: Plain text
17190 #: build/C/man2/sysctl.2:47
17191 msgid "B<Do not use this system call!> See NOTES."
17192 msgstr ""
17193
17194 #. type: Plain text
17195 #: build/C/man2/sysctl.2:54
17196 msgid ""
17197 "The B<_sysctl>()  call reads and/or writes kernel parameters.  For example, "
17198 "the hostname, or the maximum number of open files.  The argument has the "
17199 "form"
17200 msgstr ""
17201
17202 #. type: Plain text
17203 #: build/C/man2/sysctl.2:66
17204 #, no-wrap
17205 msgid ""
17206 "struct __sysctl_args {\n"
17207 "    int    *name;    /* integer vector describing variable */\n"
17208 "    int     nlen;    /* length of this vector */\n"
17209 "    void   *oldval;  /* 0 or address where to store old value */\n"
17210 "    size_t *oldlenp; /* available room for old value,\n"
17211 "                        overwritten by actual size of old value */\n"
17212 "    void   *newval;  /* 0 or address of new value */\n"
17213 "    size_t  newlen;  /* size of new value */\n"
17214 "};\n"
17215 msgstr ""
17216
17217 #. type: Plain text
17218 #: build/C/man2/sysctl.2:74
17219 msgid ""
17220 "This call does a search in a tree structure, possibly resembling a directory "
17221 "tree under I</proc/sys>, and if the requested item is found calls some "
17222 "appropriate routine to read or modify the value."
17223 msgstr ""
17224
17225 #. type: Plain text
17226 #: build/C/man2/sysctl.2:81
17227 msgid ""
17228 "Upon successful completion, B<_sysctl>()  returns 0.  Otherwise, a value of "
17229 "-1 is returned and I<errno> is set to indicate the error."
17230 msgstr ""
17231
17232 #. type: Plain text
17233 #: build/C/man2/sysctl.2:88
17234 msgid ""
17235 "The invocation asked for the previous value by setting I<oldval> non-NULL, "
17236 "but allowed zero room in I<oldlenp>."
17237 msgstr ""
17238
17239 #. type: Plain text
17240 #: build/C/man2/sysctl.2:92
17241 msgid "I<name> was not found."
17242 msgstr ""
17243
17244 #. type: TP
17245 #: build/C/man2/sysctl.2:92
17246 #, no-wrap
17247 msgid "B<EACCES>, B<EPERM>"
17248 msgstr ""
17249
17250 #. type: Plain text
17251 #: build/C/man2/sysctl.2:100
17252 msgid ""
17253 "No search permission for one of the encountered \"directories\", or no read "
17254 "permission where I<oldval> was nonzero, or no write permission where "
17255 "I<newval> was nonzero."
17256 msgstr ""
17257
17258 #. type: Plain text
17259 #: build/C/man2/sysctl.2:114
17260 msgid ""
17261 "This call is Linux-specific, and should not be used in programs intended to "
17262 "be portable.  A B<sysctl>()  call has been present in Linux since version "
17263 "1.3.57.  It originated in 4.4BSD.  Only Linux has the I</proc/sys> mirror, "
17264 "and the object naming schemes differ between Linux and 4.4BSD, but the "
17265 "declaration of the B<sysctl>()  function is the same in both."
17266 msgstr ""
17267
17268 #.  See http://lwn.net/Articles/247243/
17269 #.  Though comments in suggest that it is needed by old glibc binaries,
17270 #.  so maybe it's not going away.
17271 #. type: Plain text
17272 #: build/C/man2/sysctl.2:131
17273 msgid ""
17274 "Glibc does not provide a wrapper for this system call; call it using "
17275 "B<syscall>(2).  Or rather...  I<don't> call it: use of this system call has "
17276 "long been discouraged, and it is so unloved that B<it is likely to disappear "
17277 "in a future kernel version>.  Since Linux 2.6.24, uses of this system call "
17278 "result in warnings in the kernel log.  Remove it from your programs now; use "
17279 "the I</proc/sys> interface instead."
17280 msgstr ""
17281
17282 #. type: Plain text
17283 #: build/C/man2/sysctl.2:135
17284 msgid ""
17285 "This system call is available only if the kernel was configured with the "
17286 "B<CONFIG_SYSCTL_SYSCALL> option."
17287 msgstr ""
17288
17289 #. type: Plain text
17290 #: build/C/man2/sysctl.2:138
17291 msgid ""
17292 "The object names vary between kernel versions, making this system call "
17293 "worthless for applications."
17294 msgstr ""
17295
17296 #. type: Plain text
17297 #: build/C/man2/sysctl.2:140
17298 msgid "Not all available objects are properly documented."
17299 msgstr ""
17300
17301 #. type: Plain text
17302 #: build/C/man2/sysctl.2:143
17303 msgid ""
17304 "It is not yet possible to change operating system by writing to "
17305 "I</proc/sys/kernel/ostype>."
17306 msgstr ""
17307
17308 #. type: Plain text
17309 #: build/C/man2/sysctl.2:152
17310 #, no-wrap
17311 msgid ""
17312 "#define _GNU_SOURCE\n"
17313 "#include E<lt>unistd.hE<gt>\n"
17314 "#include E<lt>sys/syscall.hE<gt>\n"
17315 "#include E<lt>string.hE<gt>\n"
17316 "#include E<lt>stdio.hE<gt>\n"
17317 "#include E<lt>stdlib.hE<gt>\n"
17318 "#include E<lt>linux/sysctl.hE<gt>\n"
17319 msgstr ""
17320
17321 #. type: Plain text
17322 #: build/C/man2/sysctl.2:154
17323 #, no-wrap
17324 msgid "int _sysctl(struct __sysctl_args *args );\n"
17325 msgstr ""
17326
17327 #. type: Plain text
17328 #: build/C/man2/sysctl.2:156
17329 #, no-wrap
17330 msgid "#define OSNAMESZ 100\n"
17331 msgstr ""
17332
17333 #. type: Plain text
17334 #: build/C/man2/sysctl.2:164
17335 #, no-wrap
17336 msgid ""
17337 "int\n"
17338 "main(void)\n"
17339 "{\n"
17340 "    struct __sysctl_args args;\n"
17341 "    char osname[OSNAMESZ];\n"
17342 "    size_t osnamelth;\n"
17343 "    int name[] = { CTL_KERN, KERN_OSTYPE };\n"
17344 msgstr ""
17345
17346 #. type: Plain text
17347 #: build/C/man2/sysctl.2:170
17348 #, no-wrap
17349 msgid ""
17350 "    memset(&args, 0, sizeof(struct __sysctl_args));\n"
17351 "    args.name = name;\n"
17352 "    args.nlen = sizeof(name)/sizeof(name[0]);\n"
17353 "    args.oldval = osname;\n"
17354 "    args.oldlenp = &osnamelth;\n"
17355 msgstr ""
17356
17357 #. type: Plain text
17358 #: build/C/man2/sysctl.2:172
17359 #, no-wrap
17360 msgid "    osnamelth = sizeof(osname);\n"
17361 msgstr ""
17362
17363 #. type: Plain text
17364 #: build/C/man2/sysctl.2:180
17365 #, no-wrap
17366 msgid ""
17367 "    if (syscall(SYS__sysctl, &args) == -1) {\n"
17368 "        perror(\"_sysctl\");\n"
17369 "        exit(EXIT_FAILURE);\n"
17370 "    }\n"
17371 "    printf(\"This machine is running %*s\\en\", osnamelth, osname);\n"
17372 "    exit(EXIT_SUCCESS);\n"
17373 "}\n"
17374 msgstr ""
17375
17376 #. type: Plain text
17377 #: build/C/man2/sysctl.2:183 build/C/man2/sysinfo.2:96
17378 msgid "B<proc>(5)"
17379 msgstr ""
17380
17381 #. type: TH
17382 #: build/C/man2/sysinfo.2:14
17383 #, no-wrap
17384 msgid "SYSINFO"
17385 msgstr ""
17386
17387 #. type: TH
17388 #: build/C/man2/sysinfo.2:14
17389 #, no-wrap
17390 msgid "2012-05-05"
17391 msgstr ""
17392
17393 #. type: Plain text
17394 #: build/C/man2/sysinfo.2:17
17395 msgid "sysinfo - returns information on overall system statistics"
17396 msgstr ""
17397
17398 #. type: Plain text
17399 #: build/C/man2/sysinfo.2:21
17400 msgid "B<int sysinfo(struct sysinfo *>I<info>B<);>"
17401 msgstr ""
17402
17403 #. type: Plain text
17404 #: build/C/man2/sysinfo.2:25
17405 msgid ""
17406 "Until Linux 2.3.16, B<sysinfo>()  used to return information in the "
17407 "following structure:"
17408 msgstr ""
17409
17410 #. type: Plain text
17411 #: build/C/man2/sysinfo.2:40
17412 #, no-wrap
17413 msgid ""
17414 "struct sysinfo {\n"
17415 "    long uptime;             /* Seconds since boot */\n"
17416 "    unsigned long loads[3];  /* 1, 5, and 15 minute load averages */\n"
17417 "    unsigned long totalram;  /* Total usable main memory size */\n"
17418 "    unsigned long freeram;   /* Available memory size */\n"
17419 "    unsigned long sharedram; /* Amount of shared memory */\n"
17420 "    unsigned long bufferram; /* Memory used by buffers */\n"
17421 "    unsigned long totalswap; /* Total swap space size */\n"
17422 "    unsigned long freeswap;  /* swap space still available */\n"
17423 "    unsigned short procs;    /* Number of current processes */\n"
17424 "    char _f[22];             /* Pads structure to 64 bytes */\n"
17425 "};\n"
17426 msgstr ""
17427
17428 #. type: Plain text
17429 #: build/C/man2/sysinfo.2:44
17430 msgid "and the sizes were given in bytes."
17431 msgstr ""
17432
17433 #. type: Plain text
17434 #: build/C/man2/sysinfo.2:47
17435 msgid "Since Linux 2.3.23 (i386), 2.3.48 (all architectures) the structure is:"
17436 msgstr ""
17437
17438 #. type: Plain text
17439 #: build/C/man2/sysinfo.2:65
17440 #, no-wrap
17441 msgid ""
17442 "struct sysinfo {\n"
17443 "    long uptime;             /* Seconds since boot */\n"
17444 "    unsigned long loads[3];  /* 1, 5, and 15 minute load averages */\n"
17445 "    unsigned long totalram;  /* Total usable main memory size */\n"
17446 "    unsigned long freeram;   /* Available memory size */\n"
17447 "    unsigned long sharedram; /* Amount of shared memory */\n"
17448 "    unsigned long bufferram; /* Memory used by buffers */\n"
17449 "    unsigned long totalswap; /* Total swap space size */\n"
17450 "    unsigned long freeswap;  /* swap space still available */\n"
17451 "    unsigned short procs;    /* Number of current processes */\n"
17452 "    unsigned long totalhigh; /* Total high memory size */\n"
17453 "    unsigned long freehigh;  /* Available high memory size */\n"
17454 "    unsigned int mem_unit;   /* Memory unit size in bytes */\n"
17455 "    char _f[20-2*sizeof(long)-sizeof(int)]; /* Padding to 64 bytes */\n"
17456 "};\n"
17457 msgstr ""
17458
17459 #. type: Plain text
17460 #: build/C/man2/sysinfo.2:69
17461 msgid "and the sizes are given as multiples of I<mem_unit> bytes."
17462 msgstr ""
17463
17464 #. type: Plain text
17465 #: build/C/man2/sysinfo.2:74
17466 msgid ""
17467 "B<sysinfo>()  provides a simple way of getting overall system statistics.  "
17468 "This is more portable than reading I</dev/kmem>."
17469 msgstr ""
17470
17471 #. type: Plain text
17472 #: build/C/man2/sysinfo.2:83
17473 msgid "pointer to I<struct\\ sysinfo> is invalid"
17474 msgstr ""
17475
17476 #. type: Plain text
17477 #: build/C/man2/sysinfo.2:94
17478 msgid ""
17479 "The Linux kernel has a B<sysinfo>()  system call since 0.98.pl6.  Linux libc "
17480 "contains a B<sysinfo>()  routine since 5.3.5, and glibc has one since 1.90."
17481 msgstr ""
17482
17483 #. type: TH
17484 #: build/C/man3/tcgetpgrp.3:25
17485 #, no-wrap
17486 msgid "TCGETPGRP"
17487 msgstr ""
17488
17489 #. type: TH
17490 #: build/C/man3/tcgetpgrp.3:25
17491 #, no-wrap
17492 msgid "2003-01-28"
17493 msgstr ""
17494
17495 #. type: Plain text
17496 #: build/C/man3/tcgetpgrp.3:28
17497 msgid "tcgetpgrp, tcsetpgrp - get and set terminal foreground process group"
17498 msgstr ""
17499
17500 #. type: Plain text
17501 #: build/C/man3/tcgetpgrp.3:32
17502 msgid "B<pid_t tcgetpgrp(int >I<fd>B<);>"
17503 msgstr ""
17504
17505 #. type: Plain text
17506 #: build/C/man3/tcgetpgrp.3:34
17507 msgid "B<int tcsetpgrp(int >I<fd>B<, pid_t >I<pgrp>B<);>"
17508 msgstr ""
17509
17510 #.  The process itself may be a background process.
17511 #. type: Plain text
17512 #: build/C/man3/tcgetpgrp.3:42
17513 msgid ""
17514 "The function B<tcgetpgrp>()  returns the process group ID of the foreground "
17515 "process group on the terminal associated to I<fd>, which must be the "
17516 "controlling terminal of the calling process."
17517 msgstr ""
17518
17519 #. type: Plain text
17520 #: build/C/man3/tcgetpgrp.3:55
17521 msgid ""
17522 "The function B<tcsetpgrp>()  makes the process group with process group ID "
17523 "I<pgrp> the foreground process group on the terminal associated to I<fd>, "
17524 "which must be the controlling terminal of the calling process, and still be "
17525 "associated with its session.  Moreover, I<pgrp> must be a (nonempty) process "
17526 "group belonging to the same session as the calling process."
17527 msgstr ""
17528
17529 #. type: Plain text
17530 #: build/C/man3/tcgetpgrp.3:64
17531 msgid ""
17532 "If B<tcsetpgrp>()  is called by a member of a background process group in "
17533 "its session, and the calling process is not blocking or ignoring B<SIGTTOU>, "
17534 "a B<SIGTTOU> signal is sent to all members of this background process group."
17535 msgstr ""
17536
17537 #. type: Plain text
17538 #: build/C/man3/tcgetpgrp.3:79
17539 msgid ""
17540 "When I<fd> refers to the controlling terminal of the calling process, the "
17541 "function B<tcgetpgrp>()  will return the foreground process group ID of that "
17542 "terminal if there is one, and some value larger than 1 that is not presently "
17543 "a process group ID otherwise.  When I<fd> does not refer to the controlling "
17544 "terminal of the calling process, -1 is returned, and I<errno> is set "
17545 "appropriately."
17546 msgstr ""
17547
17548 #. type: Plain text
17549 #: build/C/man3/tcgetpgrp.3:86
17550 msgid ""
17551 "When successful, B<tcsetpgrp>()  returns 0.  Otherwise, it returns -1, and "
17552 "I<errno> is set appropriately."
17553 msgstr ""
17554
17555 #. type: Plain text
17556 #: build/C/man3/tcgetpgrp.3:95
17557 msgid "I<pgrp> has an unsupported value."
17558 msgstr ""
17559
17560 #. type: Plain text
17561 #: build/C/man3/tcgetpgrp.3:104
17562 msgid ""
17563 "The calling process does not have a controlling terminal, or it has one but "
17564 "it is not described by I<fd>, or, for B<tcsetpgrp>(), this controlling "
17565 "terminal is no longer associated with the session of the calling process."
17566 msgstr ""
17567
17568 #. type: Plain text
17569 #: build/C/man3/tcgetpgrp.3:109
17570 msgid ""
17571 "I<pgrp> has a supported value, but is not the process group ID of a process "
17572 "in the same session as the calling process."
17573 msgstr ""
17574
17575 #. type: Plain text
17576 #: build/C/man3/tcgetpgrp.3:117
17577 msgid ""
17578 "These functions are implemented via the B<TIOCGPGRP> and B<TIOCSPGRP> "
17579 "ioctls."
17580 msgstr ""
17581
17582 #. type: SS
17583 #: build/C/man3/tcgetpgrp.3:117 build/C/man2/vfork.2:234
17584 #, no-wrap
17585 msgid "History"
17586 msgstr ""
17587
17588 #. type: Plain text
17589 #: build/C/man3/tcgetpgrp.3:120
17590 msgid "The ioctls appeared in 4.2BSD.  The functions are POSIX inventions."
17591 msgstr ""
17592
17593 #. type: Plain text
17594 #: build/C/man3/tcgetpgrp.3:124
17595 msgid "B<setpgid>(2), B<setsid>(2), B<credentials>(7)"
17596 msgstr ""
17597
17598 #. type: TH
17599 #: build/C/man2/truncate.2:43
17600 #, no-wrap
17601 msgid "TRUNCATE"
17602 msgstr ""
17603
17604 #. type: TH
17605 #: build/C/man2/truncate.2:43
17606 #, no-wrap
17607 msgid "2013-04-01"
17608 msgstr ""
17609
17610 #. type: Plain text
17611 #: build/C/man2/truncate.2:46
17612 msgid "truncate, ftruncate - truncate a file to a specified length"
17613 msgstr ""
17614
17615 #. type: Plain text
17616 #: build/C/man2/truncate.2:52
17617 msgid "B<int truncate(const char *>I<path>B<, off_t >I<length>B<);>"
17618 msgstr ""
17619
17620 #. type: Plain text
17621 #: build/C/man2/truncate.2:54
17622 msgid "B<int ftruncate(int >I<fd>B<, off_t >I<length>B<);>"
17623 msgstr ""
17624
17625 #. type: Plain text
17626 #: build/C/man2/truncate.2:63
17627 msgid "B<truncate>():"
17628 msgstr ""
17629
17630 #. type: Plain text
17631 #: build/C/man2/truncate.2:71
17632 msgid "B<ftruncate>():"
17633 msgstr ""
17634
17635 #. type: Plain text
17636 #: build/C/man2/truncate.2:76
17637 msgid "|| /* Since glibc 2.3.5: */ _POSIX_C_SOURCE\\ E<gt>=\\ 200112L"
17638 msgstr ""
17639
17640 #. type: Plain text
17641 #: build/C/man2/truncate.2:91
17642 msgid ""
17643 "The B<truncate>()  and B<ftruncate>()  functions cause the regular file "
17644 "named by I<path> or referenced by I<fd> to be truncated to a size of "
17645 "precisely I<length> bytes."
17646 msgstr ""
17647
17648 #. type: Plain text
17649 #: build/C/man2/truncate.2:95
17650 msgid ""
17651 "If the file previously was larger than this size, the extra data is lost.  "
17652 "If the file previously was shorter, it is extended, and the extended part "
17653 "reads as null bytes (\\(aq\\e0\\(aq)."
17654 msgstr ""
17655
17656 #. type: Plain text
17657 #: build/C/man2/truncate.2:97
17658 msgid "The file offset is not changed."
17659 msgstr ""
17660
17661 #. type: Plain text
17662 #: build/C/man2/truncate.2:104
17663 msgid ""
17664 "If the size changed, then the st_ctime and st_mtime fields (respectively, "
17665 "time of last status change and time of last modification; see B<stat>(2))  "
17666 "for the file are updated, and the set-user-ID and set-group-ID permission "
17667 "bits may be cleared."
17668 msgstr ""
17669
17670 #. type: Plain text
17671 #: build/C/man2/truncate.2:110
17672 msgid ""
17673 "With B<ftruncate>(), the file must be open for writing; with B<truncate>(), "
17674 "the file must be writable."
17675 msgstr ""
17676
17677 #. type: Plain text
17678 #: build/C/man2/truncate.2:118
17679 msgid "For B<truncate>():"
17680 msgstr ""
17681
17682 #. type: Plain text
17683 #: build/C/man2/truncate.2:124
17684 msgid ""
17685 "Search permission is denied for a component of the path prefix, or the named "
17686 "file is not writable by the user.  (See also B<path_resolution>(7).)"
17687 msgstr ""
17688
17689 #. type: Plain text
17690 #: build/C/man2/truncate.2:128
17691 msgid "I<Path> points outside the process's allocated address space."
17692 msgstr ""
17693
17694 #. type: TP
17695 #: build/C/man2/truncate.2:128
17696 #, no-wrap
17697 msgid "B<EFBIG>"
17698 msgstr ""
17699
17700 #. type: Plain text
17701 #: build/C/man2/truncate.2:133
17702 msgid "The argument I<length> is larger than the maximum file size. (XSI)"
17703 msgstr ""
17704
17705 #. type: Plain text
17706 #: build/C/man2/truncate.2:140
17707 msgid ""
17708 "While blocked waiting to complete, the call was interrupted by a signal "
17709 "handler; see B<fcntl>(2)  and B<signal>(7)."
17710 msgstr ""
17711
17712 #. type: Plain text
17713 #: build/C/man2/truncate.2:145
17714 msgid "The argument I<length> is negative or larger than the maximum file size."
17715 msgstr ""
17716
17717 #. type: Plain text
17718 #: build/C/man2/truncate.2:148
17719 msgid "An I/O error occurred updating the inode."
17720 msgstr ""
17721
17722 #. type: Plain text
17723 #: build/C/man2/truncate.2:151
17724 msgid "The named file is a directory."
17725 msgstr ""
17726
17727 #. type: Plain text
17728 #: build/C/man2/truncate.2:154
17729 msgid "Too many symbolic links were encountered in translating the pathname."
17730 msgstr ""
17731
17732 #. type: Plain text
17733 #: build/C/man2/truncate.2:158
17734 msgid ""
17735 "A component of a pathname exceeded 255 characters, or an entire pathname "
17736 "exceeded 1023 characters."
17737 msgstr ""
17738
17739 #. type: Plain text
17740 #: build/C/man2/truncate.2:161
17741 msgid "The named file does not exist."
17742 msgstr ""
17743
17744 #.  This happens for at least MSDOS and VFAT file systems
17745 #.  on kernel 2.6.13
17746 #. type: Plain text
17747 #: build/C/man2/truncate.2:170
17748 msgid ""
17749 "The underlying file system does not support extending a file beyond its "
17750 "current size."
17751 msgstr ""
17752
17753 #. type: Plain text
17754 #: build/C/man2/truncate.2:176
17755 msgid "The file is a pure procedure (shared text) file that is being executed."
17756 msgstr ""
17757
17758 #. type: Plain text
17759 #: build/C/man2/truncate.2:183
17760 msgid ""
17761 "For B<ftruncate>()  the same errors apply, but instead of things that can be "
17762 "wrong with I<path>, we now have things that can be wrong with the file "
17763 "descriptor, I<fd>:"
17764 msgstr ""
17765
17766 #. type: Plain text
17767 #: build/C/man2/truncate.2:187
17768 msgid "I<fd> is not a valid descriptor."
17769 msgstr ""
17770
17771 #. type: TP
17772 #: build/C/man2/truncate.2:187
17773 #, no-wrap
17774 msgid "B<EBADF> or B<EINVAL>"
17775 msgstr ""
17776
17777 #. type: Plain text
17778 #: build/C/man2/truncate.2:191
17779 msgid "I<fd> is not open for writing."
17780 msgstr ""
17781
17782 #. type: Plain text
17783 #: build/C/man2/truncate.2:195
17784 msgid "I<fd> does not reference a regular file."
17785 msgstr ""
17786
17787 #.  POSIX.1-1996 has
17788 #.  .BR ftruncate ().
17789 #.  POSIX.1-2001 also has
17790 #.  .BR truncate (),
17791 #.  as an XSI extension.
17792 #.  .LP
17793 #.  SVr4 documents additional
17794 #.  .BR truncate ()
17795 #.  error conditions EMFILE, EMULTIHP, ENFILE, ENOLINK.  SVr4 documents for
17796 #.  .BR ftruncate ()
17797 #.  an additional EAGAIN error condition.
17798 #. type: Plain text
17799 #: build/C/man2/truncate.2:208
17800 msgid "4.4BSD, SVr4, POSIX.1-2001 (these calls first appeared in 4.2BSD)."
17801 msgstr ""
17802
17803 #.  At the very least: OSF/1, Solaris 7, and FreeBSD conform, mtk, Jan 2002
17804 #. type: Plain text
17805 #: build/C/man2/truncate.2:229
17806 msgid ""
17807 "The details in DESCRIPTION are for XSI-compliant systems.  For "
17808 "non-XSI-compliant systems, the POSIX standard allows two behaviors for "
17809 "B<ftruncate>()  when I<length> exceeds the file length (note that "
17810 "B<truncate>()  is not specified at all in such an environment): either "
17811 "returning an error, or extending the file.  Like most UNIX implementations, "
17812 "Linux follows the XSI requirement when dealing with native file systems.  "
17813 "However, some nonnative file systems do not permit B<truncate>()  and "
17814 "B<ftruncate>()  to be used to extend a file beyond its current length: a "
17815 "notable example on Linux is VFAT."
17816 msgstr ""
17817
17818 #. type: Plain text
17819 #: build/C/man2/truncate.2:243
17820 msgid ""
17821 "The original Linux B<truncate>()  and B<ftruncate>()  system calls were not "
17822 "designed to handle large file offsets.  Consequently, Linux 2.4 added "
17823 "B<truncate64>()  and B<ftruncate64>()  system calls that handle large "
17824 "files.  However, these details can be ignored by applications using glibc, "
17825 "whose wrapper functions transparently employ the more recent system calls "
17826 "where they are available."
17827 msgstr ""
17828
17829 #.  http://sourceware.org/bugzilla/show_bug.cgi?id=12037
17830 #. type: Plain text
17831 #: build/C/man2/truncate.2:256
17832 msgid ""
17833 "A header file bug in glibc 2.12 meant that the minimum value of "
17834 "B<_POSIX_C_SOURCE> required to expose the declaration of B<ftruncate>()  was "
17835 "200809L instead of 200112L.  This has been fixed in later glibc versions."
17836 msgstr ""
17837
17838 #. type: Plain text
17839 #: build/C/man2/truncate.2:260
17840 msgid "B<open>(2), B<stat>(2), B<path_resolution>(7)"
17841 msgstr ""
17842
17843 #. type: TH
17844 #: build/C/man3/ualarm.3:24
17845 #, no-wrap
17846 msgid "UALARM"
17847 msgstr ""
17848
17849 #. type: Plain text
17850 #: build/C/man3/ualarm.3:27
17851 msgid "ualarm - schedule signal after given number of microseconds"
17852 msgstr ""
17853
17854 #. type: Plain text
17855 #: build/C/man3/ualarm.3:32
17856 #, no-wrap
17857 msgid "B<useconds_t ualarm(useconds_t >I<usecs>B<, useconds_t >I<interval>B<);>\n"
17858 msgstr ""
17859
17860 #. type: Plain text
17861 #: build/C/man3/ualarm.3:40
17862 msgid "B<ualarm>():"
17863 msgstr ""
17864
17865 #. type: Plain text
17866 #: build/C/man3/ualarm.3:69
17867 msgid ""
17868 "The B<ualarm>()  function causes the signal B<SIGALRM> to be sent to the "
17869 "invoking process after (not less than)  I<usecs> microseconds.  The delay "
17870 "may be lengthened slightly by any system activity or by the time spent "
17871 "processing the call or by the granularity of system timers."
17872 msgstr ""
17873
17874 #. type: Plain text
17875 #: build/C/man3/ualarm.3:73
17876 msgid "Unless caught or ignored, the B<SIGALRM> signal will terminate the process."
17877 msgstr ""
17878
17879 #. type: Plain text
17880 #: build/C/man3/ualarm.3:81
17881 msgid ""
17882 "If the I<interval> argument is nonzero, further B<SIGALRM> signals will be "
17883 "sent every I<interval> microseconds after the first."
17884 msgstr ""
17885
17886 #. type: Plain text
17887 #: build/C/man3/ualarm.3:84
17888 msgid ""
17889 "This function returns the number of microseconds remaining for any alarm "
17890 "that was previously set, or 0 if no alarm was pending."
17891 msgstr ""
17892
17893 #. type: Plain text
17894 #: build/C/man3/ualarm.3:88
17895 msgid "Interrupted by a signal."
17896 msgstr ""
17897
17898 #. type: Plain text
17899 #: build/C/man3/ualarm.3:92
17900 msgid ""
17901 "I<usecs> or I<interval> is not smaller than 1000000.  (On systems where that "
17902 "is considered an error.)"
17903 msgstr ""
17904
17905 #. type: Plain text
17906 #: build/C/man3/ualarm.3:100
17907 msgid ""
17908 "4.3BSD, POSIX.1-2001.  POSIX.1-2001 marks B<ualarm>()  as obsolete.  "
17909 "POSIX.1-2008 removes the specification of B<ualarm>().  4.3BSD, SUSv2, and "
17910 "POSIX do not define any errors."
17911 msgstr ""
17912
17913 #.  This case is not documented in HP-US, Solar, FreeBSD, NetBSD, or OpenBSD!
17914 #. type: Plain text
17915 #: build/C/man3/ualarm.3:107
17916 msgid ""
17917 "POSIX.1-2001 does not specify what happens if the I<usecs> argument is 0.  "
17918 "On Linux (and probably most other systems), the effect is to cancel any "
17919 "pending alarm."
17920 msgstr ""
17921
17922 #. type: Plain text
17923 #: build/C/man3/ualarm.3:120
17924 msgid ""
17925 "The type I<useconds_t> is an unsigned integer type capable of holding "
17926 "integers in the range [0,1000000].  On the original BSD implementation, and "
17927 "in glibc before version 2.1, the arguments to B<ualarm>()  were instead "
17928 "typed as I<unsigned int>.  Programs will be more portable if they never "
17929 "mention I<useconds_t> explicitly."
17930 msgstr ""
17931
17932 #. type: Plain text
17933 #: build/C/man3/ualarm.3:134
17934 msgid ""
17935 "The interaction of this function with other timer functions such as "
17936 "B<alarm>(2), B<sleep>(3), B<nanosleep>(2), B<setitimer>(2), "
17937 "B<timer_create>(2), B<timer_delete>(2), B<timer_getoverrun>(2), "
17938 "B<timer_gettime>(2), B<timer_settime>(2), B<usleep>(3)  is unspecified."
17939 msgstr ""
17940
17941 #. type: Plain text
17942 #: build/C/man3/ualarm.3:142
17943 msgid ""
17944 "This function is obsolete.  Use B<setitimer>(2)  or POSIX interval timers "
17945 "(B<timer_create>(2), etc.)  instead."
17946 msgstr ""
17947
17948 #. type: Plain text
17949 #: build/C/man3/ualarm.3:150
17950 msgid ""
17951 "B<alarm>(2), B<getitimer>(2), B<nanosleep>(2), B<select>(2), "
17952 "B<setitimer>(2), B<usleep>(3), B<time>(7)"
17953 msgstr ""
17954
17955 #. type: TH
17956 #: build/C/man2/umask.2:34
17957 #, no-wrap
17958 msgid "UMASK"
17959 msgstr ""
17960
17961 #. type: TH
17962 #: build/C/man2/umask.2:34
17963 #, no-wrap
17964 msgid "2008-01-09"
17965 msgstr ""
17966
17967 #. type: Plain text
17968 #: build/C/man2/umask.2:37
17969 msgid "umask - set file mode creation mask"
17970 msgstr ""
17971
17972 #. type: Plain text
17973 #: build/C/man2/umask.2:43
17974 msgid "B<mode_t umask(mode_t >I<mask>B<);>"
17975 msgstr ""
17976
17977 #. type: Plain text
17978 #: build/C/man2/umask.2:50
17979 msgid ""
17980 "B<umask>()  sets the calling process's file mode creation mask (umask) to "
17981 "I<mask> & 0777 (i.e., only the file permission bits of I<mask> are used), "
17982 "and returns the previous value of the mask."
17983 msgstr ""
17984
17985 #.  e.g., mkfifo(), creat(), mknod(), sem_open(), mq_open(), shm_open()
17986 #.  but NOT the System V IPC *get() calls
17987 #. type: Plain text
17988 #: build/C/man2/umask.2:65
17989 msgid ""
17990 "The umask is used by B<open>(2), B<mkdir>(2), and other system calls that "
17991 "create files to modify the permissions placed on newly created files or "
17992 "directories.  Specifically, permissions in the umask are turned off from the "
17993 "I<mode> argument to B<open>(2)  and B<mkdir>(2)."
17994 msgstr ""
17995
17996 #. type: Plain text
17997 #: build/C/man2/umask.2:70
17998 msgid ""
17999 "The constants that should be used to specify I<mask> are described under "
18000 "B<stat>(2)."
18001 msgstr ""
18002
18003 #. type: Plain text
18004 #: build/C/man2/umask.2:79
18005 msgid ""
18006 "The typical default value for the process umask is I<S_IWGRP\\ |\\ S_IWOTH> "
18007 "(octal 022).  In the usual case where the I<mode> argument to B<open>(2)  is "
18008 "specified as:"
18009 msgstr ""
18010
18011 #. type: Plain text
18012 #: build/C/man2/umask.2:82
18013 #, no-wrap
18014 msgid "    S_IRUSR | S_IWUSR | S_IRGRP | S_IWGRP | S_IROTH | S_IWOTH\n"
18015 msgstr ""
18016
18017 #. type: Plain text
18018 #: build/C/man2/umask.2:86
18019 msgid ""
18020 "(octal 0666) when creating a new file, the permissions on the resulting file "
18021 "will be:"
18022 msgstr ""
18023
18024 #. type: Plain text
18025 #: build/C/man2/umask.2:89
18026 #, no-wrap
18027 msgid "    S_IRUSR | S_IWUSR | S_IRGRP | S_IROTH\n"
18028 msgstr ""
18029
18030 #. type: Plain text
18031 #: build/C/man2/umask.2:92
18032 msgid "(because 0666 & ~022 = 0644; i.e., rw-r--r--)."
18033 msgstr ""
18034
18035 #. type: Plain text
18036 #: build/C/man2/umask.2:95
18037 msgid ""
18038 "This system call always succeeds and the previous value of the mask is "
18039 "returned."
18040 msgstr ""
18041
18042 #. type: Plain text
18043 #: build/C/man2/umask.2:103
18044 msgid ""
18045 "A child process created via B<fork>(2)  inherits its parent's umask.  The "
18046 "umask is left unchanged by B<execve>(2)."
18047 msgstr ""
18048
18049 #. type: Plain text
18050 #: build/C/man2/umask.2:118
18051 msgid ""
18052 "The umask setting also affects the permissions assigned to POSIX IPC objects "
18053 "(B<mq_open>(3), B<sem_open>(3), B<shm_open>(3)), FIFOs (B<mkfifo>(3)), and "
18054 "UNIX domain sockets (B<unix>(7))  created by the process.  The umask does "
18055 "not affect the permissions assigned to System V IPC objects created by the "
18056 "process (using B<msgget>(2), B<semget>(2), B<shmget>(2))."
18057 msgstr ""
18058
18059 #. type: Plain text
18060 #: build/C/man2/umask.2:124
18061 msgid "B<chmod>(2), B<mkdir>(2), B<open>(2), B<stat>(2), B<acl>(5)"
18062 msgstr ""
18063
18064 #. type: TH
18065 #: build/C/man2/uname.2:27
18066 #, no-wrap
18067 msgid "UNAME"
18068 msgstr ""
18069
18070 #. type: Plain text
18071 #: build/C/man2/uname.2:30
18072 msgid "uname - get name and information about current kernel"
18073 msgstr ""
18074
18075 #. type: Plain text
18076 #: build/C/man2/uname.2:32
18077 msgid "B<#include E<lt>sys/utsname.hE<gt>>"
18078 msgstr ""
18079
18080 #. type: Plain text
18081 #: build/C/man2/uname.2:34
18082 msgid "B<int uname(struct utsname *>I<buf>B<);>"
18083 msgstr ""
18084
18085 #. type: Plain text
18086 #: build/C/man2/uname.2:42
18087 msgid ""
18088 "B<uname>()  returns system information in the structure pointed to by "
18089 "I<buf>.  The I<utsname> struct is defined in I<E<lt>sys/utsname.hE<gt>>:"
18090 msgstr ""
18091
18092 #. type: Plain text
18093 #: build/C/man2/uname.2:56
18094 #, no-wrap
18095 msgid ""
18096 "struct utsname {\n"
18097 "    char sysname[];    /* Operating system name (e.g., \"Linux\") */\n"
18098 "    char nodename[];   /* Name within \"some implementation-defined\n"
18099 "                          network\" */\n"
18100 "    char release[];    /* Operating system release (e.g., \"2.6.28\") */\n"
18101 "    char version[];    /* Operating system version */\n"
18102 "    char machine[];    /* Hardware identifier */\n"
18103 "#ifdef _GNU_SOURCE\n"
18104 "    char domainname[]; /* NIS or YP domain name */\n"
18105 "#endif\n"
18106 "};\n"
18107 msgstr ""
18108
18109 #. type: Plain text
18110 #: build/C/man2/uname.2:63
18111 msgid ""
18112 "The length of the arrays in a I<struct utsname> is unspecified (see NOTES); "
18113 "the fields are terminated by a null byte (\\(aq\\e0\\(aq)."
18114 msgstr ""
18115
18116 #. type: Plain text
18117 #: build/C/man2/uname.2:73
18118 msgid "I<buf> is not valid."
18119 msgstr ""
18120
18121 #. type: Plain text
18122 #: build/C/man2/uname.2:78
18123 msgid "SVr4, POSIX.1-2001.  There is no B<uname>()  call in 4.3BSD."
18124 msgstr ""
18125
18126 #. type: Plain text
18127 #: build/C/man2/uname.2:82
18128 msgid "The I<domainname> member (the NIS or YP domain name) is a GNU extension."
18129 msgstr ""
18130
18131 #. type: Plain text
18132 #: build/C/man2/uname.2:98
18133 msgid ""
18134 "This is a system call, and the operating system presumably knows its name, "
18135 "release and version.  It also knows what hardware it runs on.  So, four of "
18136 "the fields of the struct are meaningful.  On the other hand, the field "
18137 "I<nodename> is meaningless: it gives the name of the present machine in some "
18138 "undefined network, but typically machines are in more than one network and "
18139 "have several names.  Moreover, the kernel has no way of knowing about such "
18140 "things, so it has to be told what to answer here.  The same holds for the "
18141 "additional I<domainname> field."
18142 msgstr ""
18143
18144 #. type: Plain text
18145 #: build/C/man2/uname.2:116
18146 msgid ""
18147 "To this end Linux uses the system calls B<sethostname>(2)  and "
18148 "B<setdomainname>(2).  Note that there is no standard that says that the "
18149 "hostname set by B<sethostname>(2)  is the same string as the I<nodename> "
18150 "field of the struct returned by B<uname>()  (indeed, some systems allow a "
18151 "256-byte hostname and an 8-byte nodename), but this is true on Linux.  The "
18152 "same holds for B<setdomainname>(2)  and the I<domainname> field."
18153 msgstr ""
18154
18155 #. type: Plain text
18156 #: build/C/man2/uname.2:131
18157 msgid ""
18158 "The length of the fields in the struct varies.  Some operating systems or "
18159 "libraries use a hardcoded 9 or 33 or 65 or 257.  Other systems use "
18160 "B<SYS_NMLN> or B<_SYS_NMLN> or B<UTSLEN> or B<_UTSNAME_LENGTH>.  Clearly, it "
18161 "is a bad idea to use any of these constants; just use sizeof(...).  Often "
18162 "257 is chosen in order to have room for an internet hostname."
18163 msgstr ""
18164
18165 #. type: Plain text
18166 #: build/C/man2/uname.2:138
18167 msgid ""
18168 "Part of the utsname information is also accessible via "
18169 "I</proc/sys/kernel/>{I<ostype>, I<hostname>, I<osrelease>, I<version>, "
18170 "I<domainname>}."
18171 msgstr ""
18172
18173 #. type: SS
18174 #: build/C/man2/uname.2:138
18175 #, no-wrap
18176 msgid "Underlying kernel interface"
18177 msgstr ""
18178
18179 #.  That was back before Linux 1.0
18180 #.  That was also back before Linux 1.0
18181 #. type: Plain text
18182 #: build/C/man2/uname.2:167
18183 msgid ""
18184 "Over time, increases in the size of the I<utsname> structure have led to "
18185 "three successive versions of B<uname>(): I<sys_olduname>()  (slot "
18186 "I<__NR_oldolduname>), I<sys_uname>()  (slot I<__NR_olduname>), and "
18187 "I<sys_newuname>()  (slot I<__NR_uname)>.  The first one used length 9 for "
18188 "all fields; the second used 65; the third also uses 65 but adds the "
18189 "I<domainname> field.  The glibc B<uname>()  wrapper function hides these "
18190 "details from applications, invoking the most recent version of the system "
18191 "call provided by the kernel."
18192 msgstr ""
18193
18194 #. type: Plain text
18195 #: build/C/man2/uname.2:171
18196 msgid "B<uname>(1), B<getdomainname>(2), B<gethostname>(2)"
18197 msgstr ""
18198
18199 #. type: TH
18200 #: build/C/man2/uselib.2:31
18201 #, no-wrap
18202 msgid "USELIB"
18203 msgstr ""
18204
18205 #. type: TH
18206 #: build/C/man2/uselib.2:31
18207 #, no-wrap
18208 msgid "2005-01-09"
18209 msgstr ""
18210
18211 #. type: Plain text
18212 #: build/C/man2/uselib.2:34
18213 msgid "uselib - load shared library"
18214 msgstr ""
18215
18216 #. type: Plain text
18217 #: build/C/man2/uselib.2:38
18218 msgid "B<int uselib(const char *>I<library>B<);>"
18219 msgstr ""
18220
18221 #. type: Plain text
18222 #: build/C/man2/uselib.2:48
18223 msgid ""
18224 "The system call B<uselib>()  serves to load a shared library to be used by "
18225 "the calling process.  It is given a pathname.  The address where to load is "
18226 "found in the library itself.  The library can have any recognized binary "
18227 "format."
18228 msgstr ""
18229
18230 #. type: Plain text
18231 #: build/C/man2/uselib.2:59
18232 msgid ""
18233 "In addition to all of the error codes returned by B<open>(2)  and "
18234 "B<mmap>(2), the following may also be returned:"
18235 msgstr ""
18236
18237 #. type: Plain text
18238 #: build/C/man2/uselib.2:67
18239 msgid ""
18240 "The library specified by I<library> does not have read or execute "
18241 "permission, or the caller does not have search permission for one of the "
18242 "directories in the path prefix.  (See also B<path_resolution>(7).)"
18243 msgstr ""
18244
18245 #. type: Plain text
18246 #: build/C/man2/uselib.2:76
18247 msgid ""
18248 "The file specified by I<library> is not an executable of known type, e.g., "
18249 "does not have the correct magic numbers."
18250 msgstr ""
18251
18252 #. type: Plain text
18253 #: build/C/man2/uselib.2:80
18254 msgid ""
18255 "B<uselib>()  is Linux-specific, and should not be used in programs intended "
18256 "to be portable."
18257 msgstr ""
18258
18259 #. type: Plain text
18260 #: build/C/man2/uselib.2:85
18261 msgid ""
18262 "B<uselib>()  was used by early libc startup code to load the shared "
18263 "libraries with names found in an array of names in the binary."
18264 msgstr ""
18265
18266 #.  libc 4.3.1f - changelog 1993-03-02
18267 #.  libc 4.3.4 - changelog 1993-04-21
18268 #. type: Plain text
18269 #: build/C/man2/uselib.2:95
18270 msgid ""
18271 "Since libc 4.3.2, startup code tries to prefix these names with "
18272 "\"/usr/lib\", \"/lib\" and \"\" before giving up.  In libc 4.3.4 and later "
18273 "these names are looked for in the directories found in B<LD_LIBRARY_PATH>, "
18274 "and if not found there, prefixes \"/usr/lib\", \"/lib\" and \"/\" are tried."
18275 msgstr ""
18276
18277 #. type: Plain text
18278 #: build/C/man2/uselib.2:100
18279 msgid ""
18280 "From libc 4.4.4 on only the library \"/lib/ld.so\" is loaded, so that this "
18281 "dynamic library can load the remaining libraries needed (again using this "
18282 "call).  This is also the state of affairs in libc5."
18283 msgstr ""
18284
18285 #. type: Plain text
18286 #: build/C/man2/uselib.2:102
18287 msgid "glibc2 does not use this call."
18288 msgstr ""
18289
18290 #. type: Plain text
18291 #: build/C/man2/uselib.2:112
18292 msgid ""
18293 "B<ar>(1), B<gcc>(1), B<ld>(1), B<ldd>(1), B<mmap>(2), B<open>(2), "
18294 "B<dlopen>(3), B<capabilities>(7), B<ld.so>(8)"
18295 msgstr ""
18296
18297 #. type: TH
18298 #: build/C/man3/usleep.3:33
18299 #, no-wrap
18300 msgid "USLEEP"
18301 msgstr ""
18302
18303 #. type: Plain text
18304 #: build/C/man3/usleep.3:36
18305 msgid "usleep - suspend execution for microsecond intervals"
18306 msgstr ""
18307
18308 #. type: Plain text
18309 #: build/C/man3/usleep.3:41
18310 #, no-wrap
18311 msgid "B<int usleep(useconds_t >I<usec>B<);>\n"
18312 msgstr ""
18313
18314 #. type: Plain text
18315 #: build/C/man3/usleep.3:49
18316 msgid "B<usleep>():"
18317 msgstr ""
18318
18319 #. type: Plain text
18320 #: build/C/man3/usleep.3:75
18321 msgid ""
18322 "The B<usleep>()  function suspends execution of the calling thread for (at "
18323 "least) I<usec> microseconds.  The sleep may be lengthened slightly by any "
18324 "system activity or by the time spent processing the call or by the "
18325 "granularity of system timers."
18326 msgstr ""
18327
18328 #. type: Plain text
18329 #: build/C/man3/usleep.3:82
18330 msgid ""
18331 "The B<usleep>()  function returns 0 on success.  On error, -1 is returned, "
18332 "with I<errno> set to indicate the cause of the error."
18333 msgstr ""
18334
18335 #. type: Plain text
18336 #: build/C/man3/usleep.3:87
18337 msgid "Interrupted by a signal; see B<signal>(7)."
18338 msgstr ""
18339
18340 #. type: Plain text
18341 #: build/C/man3/usleep.3:91
18342 msgid ""
18343 "I<usec> is not smaller than 1000000.  (On systems where that is considered "
18344 "an error.)"
18345 msgstr ""
18346
18347 #. type: Plain text
18348 #: build/C/man3/usleep.3:98
18349 msgid ""
18350 "4.3BSD, POSIX.1-2001.  POSIX.1-2001 declares this function obsolete; use "
18351 "B<nanosleep>(2)  instead.  POSIX.1-2008 removes the specification of "
18352 "B<usleep>()."
18353 msgstr ""
18354
18355 #. type: Plain text
18356 #: build/C/man3/usleep.3:105
18357 msgid ""
18358 "On the original BSD implementation, and in glibc before version 2.2.2, the "
18359 "return type of this function is I<void>.  The POSIX version returns I<int>, "
18360 "and this is also the prototype used since glibc 2.2.2."
18361 msgstr ""
18362
18363 #. type: Plain text
18364 #: build/C/man3/usleep.3:109
18365 msgid "Only the B<EINVAL> error return is documented by SUSv2 and POSIX.1-2001."
18366 msgstr ""
18367
18368 #. type: Plain text
18369 #: build/C/man3/usleep.3:117
18370 msgid ""
18371 "The type I<useconds_t> is an unsigned integer type capable of holding "
18372 "integers in the range [0,1000000].  Programs will be more portable if they "
18373 "never mention this type explicitly.  Use"
18374 msgstr ""
18375
18376 #. type: Plain text
18377 #: build/C/man3/usleep.3:125
18378 #, no-wrap
18379 msgid ""
18380 "#include E<lt>unistd.hE<gt>\n"
18381 "\\&...\n"
18382 "    unsigned int usecs;\n"
18383 "\\&...\n"
18384 "    usleep(usecs);\n"
18385 msgstr ""
18386
18387 #. type: Plain text
18388 #: build/C/man3/usleep.3:142
18389 msgid ""
18390 "The interaction of this function with the B<SIGALRM> signal, and with other "
18391 "timer functions such as B<alarm>(2), B<sleep>(3), B<nanosleep>(2), "
18392 "B<setitimer>(2), B<timer_create>(2), B<timer_delete>(2), "
18393 "B<timer_getoverrun>(2), B<timer_gettime>(2), B<timer_settime>(2), "
18394 "B<ualarm>(3)  is unspecified."
18395 msgstr ""
18396
18397 #. type: Plain text
18398 #: build/C/man3/usleep.3:151
18399 msgid ""
18400 "B<alarm>(2), B<getitimer>(2), B<nanosleep>(2), B<select>(2), "
18401 "B<setitimer>(2), B<sleep>(3), B<ualarm>(3), B<time>(7)"
18402 msgstr ""
18403
18404 #. type: TH
18405 #: build/C/man2/vfork.2:28
18406 #, no-wrap
18407 msgid "VFORK"
18408 msgstr ""
18409
18410 #. type: TH
18411 #: build/C/man2/vfork.2:28
18412 #, no-wrap
18413 msgid "2012-08-05"
18414 msgstr ""
18415
18416 #. type: Plain text
18417 #: build/C/man2/vfork.2:31
18418 msgid "vfork - create a child process and block parent"
18419 msgstr ""
18420
18421 #. type: Plain text
18422 #: build/C/man2/vfork.2:37
18423 msgid "B<pid_t vfork(void);>"
18424 msgstr ""
18425
18426 #. type: Plain text
18427 #: build/C/man2/vfork.2:44
18428 msgid "B<vfork>():"
18429 msgstr ""
18430
18431 #. type: SS
18432 #: build/C/man2/vfork.2:63
18433 #, no-wrap
18434 msgid "Standard description"
18435 msgstr ""
18436
18437 #. type: Plain text
18438 #: build/C/man2/vfork.2:82
18439 msgid ""
18440 "(From POSIX.1)  The B<vfork>()  function has the same effect as B<fork>(2), "
18441 "except that the behavior is undefined if the process created by B<vfork>()  "
18442 "either modifies any data other than a variable of type I<pid_t> used to "
18443 "store the return value from B<vfork>(), or returns from the function in "
18444 "which B<vfork>()  was called, or calls any other function before "
18445 "successfully calling B<_exit>(2)  or one of the B<exec>(3)  family of "
18446 "functions."
18447 msgstr ""
18448
18449 #. type: SS
18450 #: build/C/man2/vfork.2:82
18451 #, no-wrap
18452 msgid "Linux description"
18453 msgstr ""
18454
18455 #. type: Plain text
18456 #: build/C/man2/vfork.2:89
18457 msgid ""
18458 "B<vfork>(), just like B<fork>(2), creates a child process of the calling "
18459 "process.  For details and return value and errors, see B<fork>(2)."
18460 msgstr ""
18461
18462 #. type: Plain text
18463 #: build/C/man2/vfork.2:98
18464 msgid ""
18465 "B<vfork>()  is a special case of B<clone>(2).  It is used to create new "
18466 "processes without copying the page tables of the parent process.  It may be "
18467 "useful in performance-sensitive applications where a child is created which "
18468 "then immediately issues an B<execve>(2)."
18469 msgstr ""
18470
18471 #. type: Plain text
18472 #: build/C/man2/vfork.2:115
18473 msgid ""
18474 "B<vfork>()  differs from B<fork>(2)  in that the calling thread is suspended "
18475 "until the child terminates (either normally, by calling B<_exit>(2), or "
18476 "abnormally, after delivery of a fatal signal), or it makes a call to "
18477 "B<execve>(2).  Until that point, the child shares all memory with its "
18478 "parent, including the stack.  The child must not return from the current "
18479 "function or call B<exit>(3), but may call B<_exit>(2)."
18480 msgstr ""
18481
18482 #. type: Plain text
18483 #: build/C/man2/vfork.2:126
18484 msgid ""
18485 "As with B<fork>(2), the child process created by B<vfork>()  inherits copies "
18486 "of various of the caller's process attributes (e.g., file descriptors, "
18487 "signal dispositions, and current working directory); the B<vfork>()  call "
18488 "differs only in the treatment of the virtual address space, as described "
18489 "above."
18490 msgstr ""
18491
18492 #. type: Plain text
18493 #: build/C/man2/vfork.2:132
18494 msgid ""
18495 "Signals sent to the parent arrive after the child releases the parent's "
18496 "memory (i.e., after the child terminates or calls B<execve>(2))."
18497 msgstr ""
18498
18499 #. type: SS
18500 #: build/C/man2/vfork.2:132
18501 #, no-wrap
18502 msgid "Historic description"
18503 msgstr ""
18504
18505 #. type: Plain text
18506 #: build/C/man2/vfork.2:159
18507 msgid ""
18508 "Under Linux, B<fork>(2)  is implemented using copy-on-write pages, so the "
18509 "only penalty incurred by B<fork>(2)  is the time and memory required to "
18510 "duplicate the parent's page tables, and to create a unique task structure "
18511 "for the child.  However, in the bad old days a B<fork>(2)  would require "
18512 "making a complete copy of the caller's data space, often needlessly, since "
18513 "usually immediately afterward an B<exec>(3)  is done.  Thus, for greater "
18514 "efficiency, BSD introduced the B<vfork>()  system call, which did not fully "
18515 "copy the address space of the parent process, but borrowed the parent's "
18516 "memory and thread of control until a call to B<execve>(2)  or an exit "
18517 "occurred.  The parent process was suspended while the child was using its "
18518 "resources.  The use of B<vfork>()  was tricky: for example, not modifying "
18519 "data in the parent process depended on knowing which variables were held in "
18520 "a register."
18521 msgstr ""
18522
18523 #. type: Plain text
18524 #: build/C/man2/vfork.2:163
18525 msgid ""
18526 "4.3BSD; POSIX.1-2001 (but marked OBSOLETE).  POSIX.1-2008 removes the "
18527 "specification of B<vfork>()."
18528 msgstr ""
18529
18530 #.  In AIXv3.1 vfork is equivalent to fork.
18531 #. type: Plain text
18532 #: build/C/man2/vfork.2:174
18533 msgid ""
18534 "The requirements put on B<vfork>()  by the standards are weaker than those "
18535 "put on B<fork>(2), so an implementation where the two are synonymous is "
18536 "compliant.  In particular, the programmer cannot rely on the parent "
18537 "remaining blocked until the child either terminates or calls B<execve>(2), "
18538 "and cannot rely on any specific behavior with respect to shared memory."
18539 msgstr ""
18540
18541 #. type: Plain text
18542 #: build/C/man2/vfork.2:193
18543 msgid ""
18544 "Some consider the semantics of B<vfork>()  to be an architectural blemish, "
18545 "and the 4.2BSD man page stated: \"This system call will be eliminated when "
18546 "proper system sharing mechanisms are implemented.  Users should not depend "
18547 "on the memory sharing semantics of B<vfork>()  as it will, in that case, be "
18548 "made synonymous to B<fork>(2).\" However, even though modern memory "
18549 "management hardware has decreased the performance difference between "
18550 "B<fork>(2)  and B<vfork>(), there are various reasons why Linux and other "
18551 "systems have retained B<vfork>():"
18552 msgstr ""
18553
18554 #. type: Plain text
18555 #: build/C/man2/vfork.2:197
18556 msgid ""
18557 "Some performance-critical applications require the small performance "
18558 "advantage conferred by B<vfork>()."
18559 msgstr ""
18560
18561 #.  http://stackoverflow.com/questions/4259629/what-is-the-difference-between-fork-and-vfork
18562 #.  http://developers.sun.com/solaris/articles/subprocess/subprocess.html
18563 #.  http://mailman.uclinux.org/pipermail/uclinux-dev/2009-April/000684.html
18564 #. type: Plain text
18565 #: build/C/man2/vfork.2:213
18566 msgid ""
18567 "B<vfork>()  can be implemented on systems that lack a memory-management unit "
18568 "(MMU), but B<fork>(2)  can't be implemented on such systems.  (POSIX.1-2008 "
18569 "removed B<vfork>()  from the standard; the POSIX rationale for the "
18570 "B<posix_spawn>(3)  function notes that that function, which provides "
18571 "functionality equivalent to B<fork>(2)+B<exec>(3), is designed to be "
18572 "implementable on systems that lack an MMU.)"
18573 msgstr ""
18574
18575 #. type: Plain text
18576 #: build/C/man2/vfork.2:224
18577 msgid ""
18578 "Fork handlers established using B<pthread_atfork>(3)  are not called when a "
18579 "multithreaded program employing the NPTL threading library calls "
18580 "B<vfork>().  Fork handlers are called in this case in a program using the "
18581 "LinuxThreads threading library.  (See B<pthreads>(7)  for a description of "
18582 "Linux threading libraries.)"
18583 msgstr ""
18584
18585 #. type: Plain text
18586 #: build/C/man2/vfork.2:232
18587 msgid ""
18588 "A call to B<vfork>()  is equivalent to calling B<clone>(2)  with I<flags> "
18589 "specified as:"
18590 msgstr ""
18591
18592 #. type: Plain text
18593 #: build/C/man2/vfork.2:234
18594 #, no-wrap
18595 msgid "     CLONE_VM | CLONE_VFORK | SIGCHLD\n"
18596 msgstr ""
18597
18598 #.  In the release notes for 4.2BSD Sam Leffler wrote: `vfork: Is still
18599 #.  present, but definitely on its way out'.
18600 #. type: Plain text
18601 #: build/C/man2/vfork.2:252
18602 msgid ""
18603 "The B<vfork>()  system call appeared in 3.0BSD.  In 4.4BSD it was made "
18604 "synonymous to B<fork>(2)  but NetBSD introduced it again, cf.  E<.UR "
18605 "http://www.netbsd.org\\:/Documentation\\:/kernel\\:/vfork.html> E<.UE .> In "
18606 "Linux, it has been equivalent to B<fork>(2)  until 2.2.0-pre6 or so.  Since "
18607 "2.2.0-pre9 (on i386, somewhat later on other architectures) it is an "
18608 "independent system call.  Support was added in glibc 2.0.112."
18609 msgstr ""
18610
18611 #
18612 #.  As far as I can tell, the following is not true in 2.6.19:
18613 #.  Currently (Linux 2.3.25),
18614 #.  .BR strace (1)
18615 #.  cannot follow
18616 #.  .BR vfork ()
18617 #.  and requires a kernel patch.
18618 #. type: Plain text
18619 #: build/C/man2/vfork.2:273
18620 msgid ""
18621 "Details of the signal handling are obscure and differ between systems.  The "
18622 "BSD man page states: \"To avoid a possible deadlock situation, processes "
18623 "that are children in the middle of a B<vfork>()  are never sent B<SIGTTOU> "
18624 "or B<SIGTTIN> signals; rather, output or I<ioctl>s are allowed and input "
18625 "attempts result in an end-of-file indication.\""
18626 msgstr ""
18627
18628 #. type: Plain text
18629 #: build/C/man2/vfork.2:279
18630 msgid "B<clone>(2), B<execve>(2), B<fork>(2), B<unshare>(2), B<wait>(2)"
18631 msgstr ""
18632
18633 #. type: TH
18634 #: build/C/man2/vhangup.2:28
18635 #, no-wrap
18636 msgid "VHANGUP"
18637 msgstr ""
18638
18639 #. type: Plain text
18640 #: build/C/man2/vhangup.2:31
18641 msgid "vhangup - virtually hangup the current terminal"
18642 msgstr ""
18643
18644 #. type: Plain text
18645 #: build/C/man2/vhangup.2:35
18646 msgid "B<int vhangup(void);>"
18647 msgstr ""
18648
18649 #. type: Plain text
18650 #: build/C/man2/vhangup.2:44
18651 msgid "B<vhangup>(): _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\\ E<lt>\\ 500)"
18652 msgstr ""
18653
18654 #. type: Plain text
18655 #: build/C/man2/vhangup.2:50
18656 msgid ""
18657 "B<vhangup>()  simulates a hangup on the current terminal.  This call "
18658 "arranges for other users to have a ``clean'' terminal at login time."
18659 msgstr ""
18660
18661 #. type: Plain text
18662 #: build/C/man2/vhangup.2:63
18663 msgid ""
18664 "The calling process has insufficient privilege to call B<vhangup>(); the "
18665 "B<CAP_SYS_TTY_CONFIG> capability is required."
18666 msgstr ""
18667
18668 #. type: Plain text
18669 #: build/C/man2/vhangup.2:66
18670 msgid ""
18671 "This call is Linux-specific, and should not be used in programs intended to "
18672 "be portable."
18673 msgstr ""
18674
18675 #. type: Plain text
18676 #: build/C/man2/vhangup.2:69
18677 msgid "B<capabilities>(7), B<init>(8)"
18678 msgstr ""