po4a/process/po/process.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-09-28 04:06+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/acct.2:31 build/C/man5/acct.5:25
  21 #, no-wrap
  22 msgid "ACCT"
  23 msgstr ""
  24
  25 #. type: TH
  26 #: build/C/man2/acct.2:31
  27 #, no-wrap
  28 msgid "2008-06-16"
  29 msgstr ""
  30
  31 #. type: TH
  32 #: build/C/man2/acct.2:31 build/C/man5/acct.5:25 build/C/man7/capabilities.7:48 build/C/man2/capget.2:15 build/C/man7/cpuset.7:25 build/C/man7/credentials.7:27 build/C/man2/getgid.2:25 build/C/man2/getgroups.2:31 build/C/man2/getpid.2:25 build/C/man2/getpriority.2:48 build/C/man2/getresuid.2:28 build/C/man2/getrlimit.2:64 build/C/man2/getrusage.2:39 build/C/man2/getsid.2:26 build/C/man2/getuid.2:26 build/C/man2/iopl.2:33 build/C/man2/ioprio_set.2:24 build/C/man2/ipc.2:25 build/C/man2/seteuid.2:29 build/C/man2/setfsgid.2:31 build/C/man2/setfsuid.2:31 build/C/man2/setgid.2:29 build/C/man2/setpgid.2:48 build/C/man2/setresuid.2:26 build/C/man2/setreuid.2:45 build/C/man2/setsid.2:30 build/C/man2/setuid.2:30 build/C/man7/svipc.7:40 build/C/man3/ulimit.3:27
  33 #, no-wrap
  34 msgid "Linux"
  35 msgstr ""
  36
  37 #. type: TH
  38 #: build/C/man2/acct.2:31 build/C/man5/acct.5:25 build/C/man7/capabilities.7:48 build/C/man2/capget.2:15 build/C/man7/cpuset.7:25 build/C/man7/credentials.7:27 build/C/man2/getgid.2:25 build/C/man2/getgroups.2:31 build/C/man2/getpid.2:25 build/C/man2/getpriority.2:48 build/C/man2/getresuid.2:28 build/C/man2/getrlimit.2:64 build/C/man2/getrusage.2:39 build/C/man2/getsid.2:26 build/C/man2/getuid.2:26 build/C/man2/iopl.2:33 build/C/man2/ioprio_set.2:24 build/C/man2/ipc.2:25 build/C/man2/seteuid.2:29 build/C/man2/setfsgid.2:31 build/C/man2/setfsuid.2:31 build/C/man2/setgid.2:29 build/C/man2/setpgid.2:48 build/C/man2/setresuid.2:26 build/C/man2/setreuid.2:45 build/C/man2/setsid.2:30 build/C/man2/setuid.2:30 build/C/man7/svipc.7:40 build/C/man3/ulimit.3:27
  39 #, no-wrap
  40 msgid "Linux Programmer's Manual"
  41 msgstr ""
  42
  43 #. type: SH
  44 #: build/C/man2/acct.2:32 build/C/man5/acct.5:26 build/C/man7/capabilities.7:49 build/C/man2/capget.2:16 build/C/man7/cpuset.7:26 build/C/man7/credentials.7:28 build/C/man2/getgid.2:26 build/C/man2/getgroups.2:32 build/C/man2/getpid.2:26 build/C/man2/getpriority.2:49 build/C/man2/getresuid.2:29 build/C/man2/getrlimit.2:65 build/C/man2/getrusage.2:40 build/C/man2/getsid.2:27 build/C/man2/getuid.2:27 build/C/man2/iopl.2:34 build/C/man2/ioprio_set.2:25 build/C/man2/ipc.2:26 build/C/man2/seteuid.2:30 build/C/man2/setfsgid.2:32 build/C/man2/setfsuid.2:32 build/C/man2/setgid.2:30 build/C/man2/setpgid.2:49 build/C/man2/setresuid.2:27 build/C/man2/setreuid.2:46 build/C/man2/setsid.2:31 build/C/man2/setuid.2:31 build/C/man7/svipc.7:41 build/C/man3/ulimit.3:28
  45 #, no-wrap
  46 msgid "NAME"
  47 msgstr ""
  48
  49 #. type: Plain text
  50 #: build/C/man2/acct.2:34
  51 msgid "acct - switch process accounting on or off"
  52 msgstr ""
  53
  54 #. type: SH
  55 #: build/C/man2/acct.2:34 build/C/man5/acct.5:28 build/C/man2/capget.2:18 build/C/man2/getgid.2:28 build/C/man2/getgroups.2:34 build/C/man2/getpid.2:28 build/C/man2/getpriority.2:51 build/C/man2/getresuid.2:31 build/C/man2/getrlimit.2:67 build/C/man2/getrusage.2:42 build/C/man2/getsid.2:29 build/C/man2/getuid.2:29 build/C/man2/iopl.2:36 build/C/man2/ioprio_set.2:27 build/C/man2/ipc.2:28 build/C/man2/seteuid.2:32 build/C/man2/setfsgid.2:34 build/C/man2/setfsuid.2:34 build/C/man2/setgid.2:32 build/C/man2/setpgid.2:51 build/C/man2/setresuid.2:29 build/C/man2/setreuid.2:48 build/C/man2/setsid.2:33 build/C/man2/setuid.2:33 build/C/man7/svipc.7:43 build/C/man3/ulimit.3:30
  56 #, no-wrap
  57 msgid "SYNOPSIS"
  58 msgstr ""
  59
  60 #. type: Plain text
  61 #: build/C/man2/acct.2:38
  62 #, no-wrap
  63 msgid "B<#include E<lt>unistd.hE<gt>>\n"
  64 msgstr ""
  65
  66 #. type: Plain text
  67 #: build/C/man2/acct.2:40
  68 #, no-wrap
  69 msgid "B<int acct(const char *>I<filename>B<);>\n"
  70 msgstr ""
  71
  72 #. type: Plain text
  73 #: build/C/man2/acct.2:46 build/C/man2/getgroups.2:48 build/C/man2/getrlimit.2:84 build/C/man2/getsid.2:37 build/C/man2/seteuid.2:44 build/C/man2/setpgid.2:71 build/C/man2/setreuid.2:60
  74 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
  75 msgstr ""
  76
  77 #. type: Plain text
  78 #: build/C/man2/acct.2:50
  79 msgid "B<acct>(): _BSD_SOURCE || (_XOPEN_SOURCE && _XOPEN_SOURCE\\ E<lt>\\ 500)"
  80 msgstr ""
  81
  82 #. type: SH
  83 #: build/C/man2/acct.2:50 build/C/man5/acct.5:30 build/C/man7/capabilities.7:51 build/C/man2/capget.2:24 build/C/man7/cpuset.7:28 build/C/man7/credentials.7:30 build/C/man2/getgid.2:36 build/C/man2/getgroups.2:52 build/C/man2/getpid.2:36 build/C/man2/getpriority.2:59 build/C/man2/getresuid.2:39 build/C/man2/getrlimit.2:88 build/C/man2/getrusage.2:48 build/C/man2/getsid.2:50 build/C/man2/getuid.2:37 build/C/man2/iopl.2:40 build/C/man2/ioprio_set.2:35 build/C/man2/ipc.2:34 build/C/man2/seteuid.2:53 build/C/man2/setfsgid.2:38 build/C/man2/setfsuid.2:38 build/C/man2/setgid.2:38 build/C/man2/setpgid.2:98 build/C/man2/setresuid.2:37 build/C/man2/setreuid.2:70 build/C/man2/setsid.2:40 build/C/man2/setuid.2:39 build/C/man7/svipc.7:49 build/C/man3/ulimit.3:34
  84 #, no-wrap
  85 msgid "DESCRIPTION"
  86 msgstr ""
  87
  88 #. type: Plain text
  89 #: build/C/man2/acct.2:60
  90 msgid ""
  91 "The B<acct>()  system call enables or disables process accounting.  If "
  92 "called with the name of an existing file as its argument, accounting is "
  93 "turned on, and records for each terminating process are appended to "
  94 "I<filename> as it terminates.  An argument of NULL causes accounting to be "
  95 "turned off."
  96 msgstr ""
  97
  98 #. type: SH
  99 #: build/C/man2/acct.2:60 build/C/man2/capget.2:160 build/C/man2/getgroups.2:92 build/C/man2/getpriority.2:107 build/C/man2/getresuid.2:50 build/C/man2/getrlimit.2:430 build/C/man2/getrusage.2:181 build/C/man2/getsid.2:58 build/C/man2/iopl.2:66 build/C/man2/ioprio_set.2:149 build/C/man2/seteuid.2:67 build/C/man2/setfsgid.2:68 build/C/man2/setfsuid.2:68 build/C/man2/setgid.2:53 build/C/man2/setpgid.2:172 build/C/man2/setresuid.2:64 build/C/man2/setreuid.2:91 build/C/man2/setsid.2:51 build/C/man2/setuid.2:70 build/C/man3/ulimit.3:67
 100 #, no-wrap
 101 msgid "RETURN VALUE"
 102 msgstr ""
 103
 104 #. type: Plain text
 105 #: build/C/man2/acct.2:65 build/C/man2/capget.2:165 build/C/man2/getresuid.2:55 build/C/man2/getrusage.2:186 build/C/man2/iopl.2:71 build/C/man2/seteuid.2:72 build/C/man2/setgid.2:58 build/C/man2/setresuid.2:69 build/C/man2/setreuid.2:96 build/C/man2/setuid.2:75
 106 msgid ""
 107 "On success, zero is returned.  On error, -1 is returned, and I<errno> is set "
 108 "appropriately."
 109 msgstr ""
 110
 111 #. type: SH
 112 #: build/C/man2/acct.2:65 build/C/man2/capget.2:179 build/C/man7/cpuset.7:1100 build/C/man2/getgid.2:42 build/C/man2/getgroups.2:106 build/C/man2/getpid.2:44 build/C/man2/getpriority.2:120 build/C/man2/getresuid.2:55 build/C/man2/getrlimit.2:435 build/C/man2/getrusage.2:186 build/C/man2/getsid.2:63 build/C/man2/getuid.2:43 build/C/man2/iopl.2:71 build/C/man2/ioprio_set.2:169 build/C/man2/seteuid.2:72 build/C/man2/setgid.2:58 build/C/man2/setpgid.2:193 build/C/man2/setresuid.2:69 build/C/man2/setreuid.2:96 build/C/man2/setsid.2:58 build/C/man2/setuid.2:75 build/C/man3/ulimit.3:74
 113 #, no-wrap
 114 msgid "ERRORS"
 115 msgstr ""
 116
 117 #. type: TP
 118 #: build/C/man2/acct.2:66 build/C/man7/cpuset.7:1116 build/C/man7/cpuset.7:1123 build/C/man7/cpuset.7:1129 build/C/man7/cpuset.7:1137 build/C/man7/cpuset.7:1144 build/C/man2/getpriority.2:140 build/C/man2/setpgid.2:194
 119 #, no-wrap
 120 msgid "B<EACCES>"
 121 msgstr ""
 122
 123 #. type: Plain text
 124 #: build/C/man2/acct.2:77
 125 msgid ""
 126 "Write permission is denied for the specified file, or search permission is "
 127 "denied for one of the directories in the path prefix of I<filename> (see "
 128 "also B<path_resolution>(7)), or I<filename> is not a regular file."
 129 msgstr ""
 130
 131 #. type: TP
 132 #: build/C/man2/acct.2:77 build/C/man2/capget.2:180 build/C/man7/cpuset.7:1172 build/C/man2/getgroups.2:107 build/C/man2/getresuid.2:56 build/C/man2/getrlimit.2:436 build/C/man2/getrusage.2:187
 133 #, no-wrap
 134 msgid "B<EFAULT>"
 135 msgstr ""
 136
 137 #. type: Plain text
 138 #: build/C/man2/acct.2:81
 139 msgid "I<filename> points outside your accessible address space."
 140 msgstr ""
 141
 142 #. type: TP
 143 #: build/C/man2/acct.2:81 build/C/man7/cpuset.7:1238 build/C/man7/cpuset.7:1246
 144 #, no-wrap
 145 msgid "B<EIO>"
 146 msgstr ""
 147
 148 #. type: Plain text
 149 #: build/C/man2/acct.2:85
 150 msgid "Error writing to the file I<filename>."
 151 msgstr ""
 152
 153 #. type: TP
 154 #: build/C/man2/acct.2:85
 155 #, no-wrap
 156 msgid "B<EISDIR>"
 157 msgstr ""
 158
 159 #. type: Plain text
 160 #: build/C/man2/acct.2:89
 161 msgid "I<filename> is a directory."
 162 msgstr ""
 163
 164 #. type: TP
 165 #: build/C/man2/acct.2:89
 166 #, no-wrap
 167 msgid "B<ELOOP>"
 168 msgstr ""
 169
 170 #. type: Plain text
 171 #: build/C/man2/acct.2:93
 172 msgid "Too many symbolic links were encountered in resolving I<filename>."
 173 msgstr ""
 174
 175 #. type: TP
 176 #: build/C/man2/acct.2:93 build/C/man7/cpuset.7:1251 build/C/man7/cpuset.7:1258 build/C/man7/cpuset.7:1263
 177 #, no-wrap
 178 msgid "B<ENAMETOOLONG>"
 179 msgstr ""
 180
 181 #. type: Plain text
 182 #: build/C/man2/acct.2:97
 183 msgid "I<filename> was too long."
 184 msgstr ""
 185
 186 #. type: TP
 187 #: build/C/man2/acct.2:97
 188 #, no-wrap
 189 msgid "B<ENFILE>"
 190 msgstr ""
 191
 192 #. type: Plain text
 193 #: build/C/man2/acct.2:100
 194 msgid "The system limit on the total number of open files has been reached."
 195 msgstr ""
 196
 197 #. type: TP
 198 #: build/C/man2/acct.2:100 build/C/man7/cpuset.7:1275 build/C/man7/cpuset.7:1280
 199 #, no-wrap
 200 msgid "B<ENOENT>"
 201 msgstr ""
 202
 203 #. type: Plain text
 204 #: build/C/man2/acct.2:103
 205 msgid "The specified filename does not exist."
 206 msgstr ""
 207
 208 #. type: TP
 209 #: build/C/man2/acct.2:103 build/C/man7/cpuset.7:1287 build/C/man2/getgroups.2:127
 210 #, no-wrap
 211 msgid "B<ENOMEM>"
 212 msgstr ""
 213
 214 #. type: Plain text
 215 #: build/C/man2/acct.2:106 build/C/man2/getgroups.2:130
 216 msgid "Out of memory."
 217 msgstr ""
 218
 219 #. type: TP
 220 #: build/C/man2/acct.2:106 build/C/man2/iopl.2:76
 221 #, no-wrap
 222 msgid "B<ENOSYS>"
 223 msgstr ""
 224
 225 #. type: Plain text
 226 #: build/C/man2/acct.2:112
 227 msgid ""
 228 "BSD process accounting has not been enabled when the operating system kernel "
 229 "was compiled.  The kernel configuration parameter controlling this feature "
 230 "is B<CONFIG_BSD_PROCESS_ACCT>."
 231 msgstr ""
 232
 233 #. type: TP
 234 #: build/C/man2/acct.2:112 build/C/man7/cpuset.7:1314
 235 #, no-wrap
 236 msgid "B<ENOTDIR>"
 237 msgstr ""
 238
 239 #. type: Plain text
 240 #: build/C/man2/acct.2:117
 241 msgid "A component used as a directory in I<filename> is not in fact a directory."
 242 msgstr ""
 243
 244 #. type: TP
 245 #: build/C/man2/acct.2:117 build/C/man2/capget.2:191 build/C/man2/capget.2:196 build/C/man7/cpuset.7:1319 build/C/man2/getgroups.2:130 build/C/man2/getpriority.2:152 build/C/man2/getrlimit.2:452 build/C/man2/getsid.2:64 build/C/man2/iopl.2:79 build/C/man2/ioprio_set.2:179 build/C/man2/seteuid.2:75 build/C/man2/setgid.2:59 build/C/man2/setpgid.2:208 build/C/man2/setresuid.2:77 build/C/man2/setreuid.2:97 build/C/man2/setsid.2:59 build/C/man2/setuid.2:85 build/C/man3/ulimit.3:75
 246 #, no-wrap
 247 msgid "B<EPERM>"
 248 msgstr ""
 249
 250 #. type: Plain text
 251 #: build/C/man2/acct.2:123
 252 msgid ""
 253 "The calling process has insufficient privilege to enable process "
 254 "accounting.  On Linux the B<CAP_SYS_PACCT> capability is required."
 255 msgstr ""
 256
 257 #. type: TP
 258 #: build/C/man2/acct.2:123
 259 #, no-wrap
 260 msgid "B<EROFS>"
 261 msgstr ""
 262
 263 #. type: Plain text
 264 #: build/C/man2/acct.2:127
 265 msgid "I<filename> refers to a file on a read-only filesystem."
 266 msgstr ""
 267
 268 #. type: TP
 269 #: build/C/man2/acct.2:127
 270 #, no-wrap
 271 msgid "B<EUSERS>"
 272 msgstr ""
 273
 274 #. type: Plain text
 275 #: build/C/man2/acct.2:130
 276 msgid "There are no more free file structures or we ran out of memory."
 277 msgstr ""
 278
 279 #. type: SH
 280 #: build/C/man2/acct.2:130 build/C/man5/acct.5:153 build/C/man7/capabilities.7:1079 build/C/man2/capget.2:218 build/C/man7/credentials.7:234 build/C/man2/getgid.2:44 build/C/man2/getgroups.2:133 build/C/man2/getpid.2:46 build/C/man2/getpriority.2:160 build/C/man2/getresuid.2:67 build/C/man2/getrlimit.2:473 build/C/man2/getrusage.2:195 build/C/man2/getsid.2:79 build/C/man2/getuid.2:45 build/C/man2/iopl.2:87 build/C/man2/ioprio_set.2:196 build/C/man2/ipc.2:45 build/C/man2/seteuid.2:91 build/C/man2/setfsgid.2:75 build/C/man2/setfsuid.2:75 build/C/man2/setgid.2:66 build/C/man2/setpgid.2:227 build/C/man2/setresuid.2:83 build/C/man2/setreuid.2:113 build/C/man2/setsid.2:65 build/C/man2/setuid.2:92 build/C/man3/ulimit.3:78
 281 #, no-wrap
 282 msgid "CONFORMING TO"
 283 msgstr ""
 284
 285 #.  SVr4 documents an EBUSY error condition, but no EISDIR or ENOSYS.
 286 #.  Also AIX and HP-UX document EBUSY (attempt is made
 287 #.  to enable accounting when it is already enabled), as does Solaris
 288 #.  (attempt is made to enable accounting using the same file that is
 289 #.  currently being used).
 290 #. type: Plain text
 291 #: build/C/man2/acct.2:137
 292 msgid "SVr4, 4.3BSD (but not POSIX)."
 293 msgstr ""
 294
 295 #. type: SH
 296 #: build/C/man2/acct.2:137 build/C/man5/acct.5:157 build/C/man7/capabilities.7:1085 build/C/man2/capget.2:220 build/C/man7/cpuset.7:1341 build/C/man7/credentials.7:240 build/C/man2/getgid.2:46 build/C/man2/getgroups.2:141 build/C/man2/getpid.2:48 build/C/man2/getpriority.2:163 build/C/man2/getresuid.2:70 build/C/man2/getrlimit.2:496 build/C/man2/getrusage.2:206 build/C/man2/getsid.2:81 build/C/man2/getuid.2:47 build/C/man2/iopl.2:91 build/C/man2/ioprio_set.2:198 build/C/man2/ipc.2:49 build/C/man2/seteuid.2:93 build/C/man2/setfsgid.2:79 build/C/man2/setfsuid.2:79 build/C/man2/setgid.2:68 build/C/man2/setpgid.2:249 build/C/man2/setresuid.2:86 build/C/man2/setreuid.2:119 build/C/man2/setsid.2:67 build/C/man2/setuid.2:97
 297 #, no-wrap
 298 msgid "NOTES"
 299 msgstr ""
 300
 301 #. type: Plain text
 302 #: build/C/man2/acct.2:140
 303 msgid ""
 304 "No accounting is produced for programs running when a system crash occurs.  "
 305 "In particular, nonterminating processes are never accounted for."
 306 msgstr ""
 307
 308 #. type: Plain text
 309 #: build/C/man2/acct.2:143
 310 msgid ""
 311 "The structure of the records written to the accounting file is described in "
 312 "B<acct>(5)."
 313 msgstr ""
 314
 315 #. type: SH
 316 #: build/C/man2/acct.2:143 build/C/man5/acct.5:174 build/C/man7/capabilities.7:1141 build/C/man2/capget.2:228 build/C/man7/cpuset.7:1488 build/C/man7/credentials.7:251 build/C/man2/getgid.2:62 build/C/man2/getgroups.2:171 build/C/man2/getpid.2:100 build/C/man2/getpriority.2:232 build/C/man2/getresuid.2:86 build/C/man2/getrlimit.2:656 build/C/man2/getrusage.2:246 build/C/man2/getsid.2:84 build/C/man2/getuid.2:73 build/C/man2/iopl.2:100 build/C/man2/ioprio_set.2:346 build/C/man2/ipc.2:57 build/C/man2/seteuid.2:124 build/C/man2/setfsgid.2:123 build/C/man2/setfsuid.2:131 build/C/man2/setgid.2:78 build/C/man2/setpgid.2:317 build/C/man2/setresuid.2:106 build/C/man2/setreuid.2:159 build/C/man2/setsid.2:84 build/C/man2/setuid.2:120 build/C/man7/svipc.7:331 build/C/man3/ulimit.3:83
 317 #, no-wrap
 318 msgid "SEE ALSO"
 319 msgstr ""
 320
 321 #. type: Plain text
 322 #: build/C/man2/acct.2:145
 323 msgid "B<acct>(5)"
 324 msgstr ""
 325
 326 #. type: SH
 327 #: build/C/man2/acct.2:145 build/C/man5/acct.5:179 build/C/man7/capabilities.7:1161 build/C/man2/capget.2:232 build/C/man7/cpuset.7:1505 build/C/man7/credentials.7:282 build/C/man2/getgid.2:67 build/C/man2/getgroups.2:178 build/C/man2/getpid.2:110 build/C/man2/getpriority.2:240 build/C/man2/getresuid.2:92 build/C/man2/getrlimit.2:674 build/C/man2/getrusage.2:253 build/C/man2/getsid.2:88 build/C/man2/getuid.2:78 build/C/man2/iopl.2:104 build/C/man2/ioprio_set.2:354 build/C/man2/ipc.2:70 build/C/man2/seteuid.2:131 build/C/man2/setfsgid.2:128 build/C/man2/setfsuid.2:136 build/C/man2/setgid.2:84 build/C/man2/setpgid.2:324 build/C/man2/setresuid.2:115 build/C/man2/setreuid.2:167 build/C/man2/setsid.2:91 build/C/man2/setuid.2:127 build/C/man7/svipc.7:348 build/C/man3/ulimit.3:88
 328 #, no-wrap
 329 msgid "COLOPHON"
 330 msgstr ""
 331
 332 #. type: Plain text
 333 #: build/C/man2/acct.2:152 build/C/man5/acct.5:186 build/C/man7/capabilities.7:1168 build/C/man2/capget.2:239 build/C/man7/cpuset.7:1512 build/C/man7/credentials.7:289 build/C/man2/getgid.2:74 build/C/man2/getgroups.2:185 build/C/man2/getpid.2:117 build/C/man2/getpriority.2:247 build/C/man2/getresuid.2:99 build/C/man2/getrlimit.2:681 build/C/man2/getrusage.2:260 build/C/man2/getsid.2:95 build/C/man2/getuid.2:85 build/C/man2/iopl.2:111 build/C/man2/ioprio_set.2:361 build/C/man2/ipc.2:77 build/C/man2/seteuid.2:138 build/C/man2/setfsgid.2:135 build/C/man2/setfsuid.2:143 build/C/man2/setgid.2:91 build/C/man2/setpgid.2:331 build/C/man2/setresuid.2:122 build/C/man2/setreuid.2:174 build/C/man2/setsid.2:98 build/C/man2/setuid.2:134 build/C/man7/svipc.7:355 build/C/man3/ulimit.3:95
 334 msgid ""
 335 "This page is part of release 3.54 of the Linux I<man-pages> project.  A "
 336 "description of the project, and information about reporting bugs, can be "
 337 "found at \\%http://www.kernel.org/doc/man-pages/."
 338 msgstr ""
 339
 340 #. type: TH
 341 #: build/C/man5/acct.5:25
 342 #, no-wrap
 343 msgid "2008-06-15"
 344 msgstr ""
 345
 346 #. type: Plain text
 347 #: build/C/man5/acct.5:28
 348 msgid "acct - process accounting file"
 349 msgstr ""
 350
 351 #. type: Plain text
 352 #: build/C/man5/acct.5:30
 353 msgid "B<#include E<lt>sys/acct.hE<gt>>"
 354 msgstr ""
 355
 356 #. type: Plain text
 357 #: build/C/man5/acct.5:36
 358 msgid ""
 359 "If the kernel is built with the process accounting option enabled "
 360 "(B<CONFIG_BSD_PROCESS_ACCT>), then calling B<acct>(2)  starts process "
 361 "accounting, for example:"
 362 msgstr ""
 363
 364 #. type: Plain text
 365 #: build/C/man5/acct.5:39
 366 msgid "acct(\"/var/log/pacct\");"
 367 msgstr ""
 368
 369 #. type: Plain text
 370 #: build/C/man5/acct.5:47
 371 msgid ""
 372 "When process accounting is enabled, the kernel writes a record to the "
 373 "accounting file as each process on the system terminates.  This record "
 374 "contains information about the terminated process, and is defined in "
 375 "I<E<lt>sys/acct.hE<gt>> as follows:"
 376 msgstr ""
 377
 378 #. type: Plain text
 379 #: build/C/man5/acct.5:51
 380 #, no-wrap
 381 msgid "#define ACCT_COMM 16\n"
 382 msgstr ""
 383
 384 #. type: Plain text
 385 #: build/C/man5/acct.5:53
 386 #, no-wrap
 387 msgid "typedef u_int16_t comp_t;\n"
 388 msgstr ""
 389
 390 #. type: Plain text
 391 #: build/C/man5/acct.5:77
 392 #, no-wrap
 393 msgid ""
 394 "struct acct {\n"
 395 "    char ac_flag;           /* Accounting flags */\n"
 396 "    u_int16_t ac_uid;       /* Accounting user ID */\n"
 397 "    u_int16_t ac_gid;       /* Accounting group ID */\n"
 398 "    u_int16_t ac_tty;       /* Controlling terminal */\n"
 399 "    u_int32_t ac_btime;     /* Process creation time\n"
 400 "                               (seconds since the Epoch) */\n"
 401 "    comp_t    ac_utime;     /* User CPU time */\n"
 402 "    comp_t    ac_stime;     /* System CPU time */\n"
 403 "    comp_t    ac_etime;     /* Elapsed time */\n"
 404 "    comp_t    ac_mem;       /* Average memory usage (kB) */\n"
 405 "    comp_t    ac_io;        /* Characters transferred (unused) */\n"
 406 "    comp_t    ac_rw;        /* Blocks read or written (unused) */\n"
 407 "    comp_t    ac_minflt;    /* Minor page faults */\n"
 408 "    comp_t    ac_majflt;    /* Major page faults */\n"
 409 "    comp_t    ac_swaps;     /* Number of swaps (unused) */\n"
 410 "    u_int32_t ac_exitcode;  /* Process termination status\n"
 411 "                               (see wait(2)) */\n"
 412 "    char      ac_comm[ACCT_COMM+1];\n"
 413 "                            /* Command name (basename of last\n"
 414 "                               executed command; null-terminated) */\n"
 415 "    char      ac_pad[I<X>];    /* padding bytes */\n"
 416 "};\n"
 417 msgstr ""
 418
 419 #. type: Plain text
 420 #: build/C/man5/acct.5:84
 421 #, no-wrap
 422 msgid ""
 423 "enum {          /* Bits that may be set in ac_flag field */\n"
 424 "    AFORK = 0x01,           /* Has executed fork, but no exec */\n"
 425 "    ASU   = 0x02,           /* Used superuser privileges */\n"
 426 "    ACORE = 0x08,           /* Dumped core */\n"
 427 "    AXSIG = 0x10            /* Killed by a signal */\n"
 428 "};\n"
 429 msgstr ""
 430
 431 #. type: Plain text
 432 #: build/C/man5/acct.5:94
 433 msgid ""
 434 "The I<comp_t> data type is a floating-point value consisting of a 3-bit, "
 435 "base-8 exponent, and a 13-bit mantissa.  A value, I<c>, of this type can be "
 436 "converted to a (long) integer as follows:"
 437 msgstr ""
 438
 439 #. type: Plain text
 440 #: build/C/man5/acct.5:97
 441 #, no-wrap
 442 msgid "    v = (c & 0x1fff) E<lt>E<lt> (((c E<gt>E<gt> 13) & 0x7) * 3);\n"
 443 msgstr ""
 444
 445 #. type: Plain text
 446 #: build/C/man5/acct.5:107
 447 msgid ""
 448 "The I<ac_utime>, I<ac_stime>, and I<ac_etime> fields measure time in \"clock "
 449 "ticks\"; divide these values by I<sysconf(_SC_CLK_TCK)> to convert them to "
 450 "seconds."
 451 msgstr ""
 452
 453 #. type: SS
 454 #: build/C/man5/acct.5:107
 455 #, no-wrap
 456 msgid "Version 3 accounting file format"
 457 msgstr ""
 458
 459 #. type: Plain text
 460 #: build/C/man5/acct.5:122
 461 msgid ""
 462 "Since kernel 2.6.8, an optional alternative version of the accounting file "
 463 "can be produced if the B<CONFIG_BSD_PROCESS_ACCT_V3> option is set when "
 464 "building the kernel.  With this option is set, the records written to the "
 465 "accounting file contain additional fields, and the width of I<c_uid> and "
 466 "I<ac_gid> fields is widened from 16 to 32 bits (in line with the increased "
 467 "size of UID and GIDs in Linux 2.4 and later).  The records are defined as "
 468 "follows:"
 469 msgstr ""
 470
 471 #. type: Plain text
 472 #: build/C/man5/acct.5:147
 473 #, no-wrap
 474 msgid ""
 475 "struct acct_v3 {\n"
 476 "    char      ac_flag;      /* Flags */\n"
 477 "    char      ac_version;   /* Always set to ACCT_VERSION (3) */\n"
 478 "    u_int16_t ac_tty;       /* Controlling terminal */\n"
 479 "    u_int32_t ac_exitcode;  /* Process termination status */\n"
 480 "    u_int32_t ac_uid;       /* Real user ID */\n"
 481 "    u_int32_t ac_gid;       /* Real group ID */\n"
 482 "    u_int32_t ac_pid;       /* Process ID */\n"
 483 "    u_int32_t ac_ppid;      /* Parent process ID */\n"
 484 "    u_int32_t ac_btime;     /* Process creation time */\n"
 485 "    float     ac_etime;     /* Elapsed time */\n"
 486 "    comp_t    ac_utime;     /* User CPU time */\n"
 487 "    comp_t    ac_stime;     /* System time */\n"
 488 "    comp_t    ac_mem;       /* Average memory usage (kB) */\n"
 489 "    comp_t    ac_io;        /* Characters transferred (unused) */\n"
 490 "    comp_t    ac_rw;        /* Blocks read or written\n"
 491 "                               (unused) */\n"
 492 "    comp_t    ac_minflt;    /* Minor page faults */\n"
 493 "    comp_t    ac_majflt;    /* Major page faults */\n"
 494 "    comp_t    ac_swaps;     /* Number of swaps (unused) */\n"
 495 "    char      ac_comm[ACCT_COMM]; /* Command name */\n"
 496 "};\n"
 497 msgstr ""
 498
 499 #. type: SH
 500 #: build/C/man5/acct.5:149 build/C/man7/cpuset.7:1338 build/C/man2/getresuid.2:60 build/C/man2/getrlimit.2:468 build/C/man2/getsid.2:75 build/C/man2/ioprio_set.2:193 build/C/man2/setfsgid.2:71 build/C/man2/setfsuid.2:71 build/C/man2/setresuid.2:81
 501 #, no-wrap
 502 msgid "VERSIONS"
 503 msgstr ""
 504
 505 #. type: Plain text
 506 #: build/C/man5/acct.5:153
 507 msgid "The I<acct_v3> structure is defined in glibc since version 2.6."
 508 msgstr ""
 509
 510 #. type: Plain text
 511 #: build/C/man5/acct.5:157
 512 msgid ""
 513 "Process accounting originated on BSD.  Although it is present on most "
 514 "systems, it is not standardized, and the details vary somewhat between "
 515 "systems."
 516 msgstr ""
 517
 518 #. type: Plain text
 519 #: build/C/man5/acct.5:160
 520 msgid ""
 521 "Records in the accounting file are ordered by termination time of the "
 522 "process."
 523 msgstr ""
 524
 525 #. type: Plain text
 526 #: build/C/man5/acct.5:167
 527 msgid ""
 528 "In kernels up to and including 2.6.9, a separate accounting record is "
 529 "written for each thread created using the NPTL threading library; since "
 530 "Linux 2.6.10, a single accounting record is written for the entire process "
 531 "on termination of the last thread in the process."
 532 msgstr ""
 533
 534 #. type: Plain text
 535 #: build/C/man5/acct.5:174
 536 msgid ""
 537 "The I<proc/sys/kernel/acct> file, described in B<proc>(5), defines settings "
 538 "that control the behavior of process accounting when disk space runs low."
 539 msgstr ""
 540
 541 #. type: Plain text
 542 #: build/C/man5/acct.5:179
 543 msgid "B<lastcomm>(1), B<acct>(2), B<accton>(8), B<sa>(8)"
 544 msgstr ""
 545
 546 #. type: TH
 547 #: build/C/man7/capabilities.7:48
 548 #, no-wrap
 549 msgid "CAPABILITIES"
 550 msgstr ""
 551
 552 #. type: TH
 553 #: build/C/man7/capabilities.7:48
 554 #, no-wrap
 555 msgid "2013-07-21"
 556 msgstr ""
 557
 558 #. type: Plain text
 559 #: build/C/man7/capabilities.7:51
 560 msgid "capabilities - overview of Linux capabilities"
 561 msgstr ""
 562
 563 #. type: Plain text
 564 #: build/C/man7/capabilities.7:63
 565 msgid ""
 566 "For the purpose of performing permission checks, traditional UNIX "
 567 "implementations distinguish two categories of processes: I<privileged> "
 568 "processes (whose effective user ID is 0, referred to as superuser or root), "
 569 "and I<unprivileged> processes (whose effective UID is nonzero).  Privileged "
 570 "processes bypass all kernel permission checks, while unprivileged processes "
 571 "are subject to full permission checking based on the process's credentials "
 572 "(usually: effective UID, effective GID, and supplementary group list)."
 573 msgstr ""
 574
 575 #. type: Plain text
 576 #: build/C/man7/capabilities.7:70
 577 msgid ""
 578 "Starting with kernel 2.2, Linux divides the privileges traditionally "
 579 "associated with superuser into distinct units, known as I<capabilities>, "
 580 "which can be independently enabled and disabled.  Capabilities are a "
 581 "per-thread attribute."
 582 msgstr ""
 583
 584 #. type: SS
 585 #: build/C/man7/capabilities.7:70
 586 #, no-wrap
 587 msgid "Capabilities list"
 588 msgstr ""
 589
 590 #. type: Plain text
 591 #: build/C/man7/capabilities.7:73
 592 msgid ""
 593 "The following list shows the capabilities implemented on Linux, and the "
 594 "operations or behaviors that each capability permits:"
 595 msgstr ""
 596
 597 #. type: TP
 598 #: build/C/man7/capabilities.7:73
 599 #, no-wrap
 600 msgid "B<CAP_AUDIT_CONTROL> (since Linux 2.6.11)"
 601 msgstr ""
 602
 603 #. type: Plain text
 604 #: build/C/man7/capabilities.7:77
 605 msgid ""
 606 "Enable and disable kernel auditing; change auditing filter rules; retrieve "
 607 "auditing status and filtering rules."
 608 msgstr ""
 609
 610 #. type: TP
 611 #: build/C/man7/capabilities.7:77
 612 #, no-wrap
 613 msgid "B<CAP_AUDIT_WRITE> (since Linux 2.6.11)"
 614 msgstr ""
 615
 616 #. type: Plain text
 617 #: build/C/man7/capabilities.7:80
 618 msgid "Write records to kernel auditing log."
 619 msgstr ""
 620
 621 #. type: TP
 622 #: build/C/man7/capabilities.7:80
 623 #, no-wrap
 624 msgid "B<CAP_BLOCK_SUSPEND> (since Linux 3.5)"
 625 msgstr ""
 626
 627 #. type: Plain text
 628 #: build/C/man7/capabilities.7:86
 629 msgid ""
 630 "Employ features that can block system suspend (B<epoll>(7)  B<EPOLLWAKEUP>, "
 631 "I</proc/sys/wake_lock>)."
 632 msgstr ""
 633
 634 #. type: TP
 635 #: build/C/man7/capabilities.7:86
 636 #, no-wrap
 637 msgid "B<CAP_CHOWN>"
 638 msgstr ""
 639
 640 #. type: Plain text
 641 #: build/C/man7/capabilities.7:90
 642 msgid "Make arbitrary changes to file UIDs and GIDs (see B<chown>(2))."
 643 msgstr ""
 644
 645 #. type: TP
 646 #: build/C/man7/capabilities.7:90
 647 #, no-wrap
 648 msgid "B<CAP_DAC_OVERRIDE>"
 649 msgstr ""
 650
 651 #. type: Plain text
 652 #: build/C/man7/capabilities.7:94
 653 msgid ""
 654 "Bypass file read, write, and execute permission checks.  (DAC is an "
 655 "abbreviation of \"discretionary access control\".)"
 656 msgstr ""
 657
 658 #. type: TP
 659 #: build/C/man7/capabilities.7:94
 660 #, no-wrap
 661 msgid "B<CAP_DAC_READ_SEARCH>"
 662 msgstr ""
 663
 664 #. type: IP
 665 #: build/C/man7/capabilities.7:98 build/C/man7/capabilities.7:101 build/C/man7/capabilities.7:111 build/C/man7/capabilities.7:121 build/C/man7/capabilities.7:125 build/C/man7/capabilities.7:127 build/C/man7/capabilities.7:129 build/C/man7/capabilities.7:199 build/C/man7/capabilities.7:201 build/C/man7/capabilities.7:203 build/C/man7/capabilities.7:205 build/C/man7/capabilities.7:207 build/C/man7/capabilities.7:209 build/C/man7/capabilities.7:211 build/C/man7/capabilities.7:213 build/C/man7/capabilities.7:215 build/C/man7/capabilities.7:239 build/C/man7/capabilities.7:241 build/C/man7/capabilities.7:287 build/C/man7/capabilities.7:297 build/C/man7/capabilities.7:303 build/C/man7/capabilities.7:308 build/C/man7/capabilities.7:314 build/C/man7/capabilities.7:321 build/C/man7/capabilities.7:324 build/C/man7/capabilities.7:332 build/C/man7/capabilities.7:334 build/C/man7/capabilities.7:343 build/C/man7/capabilities.7:350 build/C/man7/capabilities.7:353 build/C/man7/capabilities.7:357 build/C/man7/capabilities.7:360 build/C/man7/capabilities.7:363 build/C/man7/capabilities.7:370 build/C/man7/capabilities.7:375 build/C/man7/capabilities.7:381 build/C/man7/capabilities.7:385 build/C/man7/capabilities.7:389 build/C/man7/capabilities.7:393 build/C/man7/capabilities.7:397 build/C/man7/capabilities.7:424 build/C/man7/capabilities.7:429 build/C/man7/capabilities.7:434 build/C/man7/capabilities.7:437 build/C/man7/capabilities.7:440 build/C/man7/capabilities.7:449 build/C/man7/capabilities.7:453 build/C/man7/capabilities.7:479 build/C/man7/capabilities.7:484 build/C/man7/capabilities.7:487 build/C/man7/capabilities.7:492 build/C/man7/capabilities.7:495 build/C/man7/capabilities.7:498 build/C/man7/capabilities.7:501 build/C/man7/capabilities.7:504 build/C/man7/capabilities.7:509 build/C/man7/capabilities.7:511 build/C/man7/capabilities.7:517 build/C/man7/capabilities.7:525 build/C/man7/capabilities.7:527 build/C/man7/capabilities.7:531 build/C/man7/capabilities.7:533 build/C/man7/capabilities.7:536 build/C/man7/capabilities.7:540 build/C/man7/capabilities.7:542 build/C/man7/capabilities.7:544 build/C/man7/capabilities.7:546 build/C/man7/capabilities.7:555 build/C/man7/capabilities.7:562 build/C/man7/capabilities.7:567 build/C/man7/capabilities.7:572 build/C/man7/capabilities.7:577 build/C/man7/capabilities.7:600 build/C/man7/capabilities.7:607 build/C/man7/capabilities.7:806 build/C/man7/capabilities.7:814 build/C/man7/capabilities.7:1130 build/C/man7/capabilities.7:1135 build/C/man7/cpuset.7:540 build/C/man7/cpuset.7:545 build/C/man7/cpuset.7:550 build/C/man7/cpuset.7:726 build/C/man7/cpuset.7:730 build/C/man7/cpuset.7:927 build/C/man7/cpuset.7:930 build/C/man7/cpuset.7:934 build/C/man7/cpuset.7:938 build/C/man7/cpuset.7:942 build/C/man7/credentials.7:125 build/C/man7/credentials.7:131 build/C/man7/credentials.7:143 build/C/man7/credentials.7:165 build/C/man7/credentials.7:182 build/C/man7/credentials.7:214 build/C/man7/credentials.7:217 build/C/man7/credentials.7:227 build/C/man7/credentials.7:230
 666 #, no-wrap
 667 msgid "*"
 668 msgstr ""
 669
 670 #. type: Plain text
 671 #: build/C/man7/capabilities.7:101
 672 msgid ""
 673 "Bypass file read permission checks and directory read and execute permission "
 674 "checks;"
 675 msgstr ""
 676
 677 #. type: Plain text
 678 #: build/C/man7/capabilities.7:104
 679 msgid "Invoke B<open_by_handle_at>(2)."
 680 msgstr ""
 681
 682 #. type: TP
 683 #: build/C/man7/capabilities.7:107
 684 #, no-wrap
 685 msgid "B<CAP_FOWNER>"
 686 msgstr ""
 687
 688 #. type: Plain text
 689 #: build/C/man7/capabilities.7:121
 690 msgid ""
 691 "Bypass permission checks on operations that normally require the filesystem "
 692 "UID of the process to match the UID of the file (e.g., B<chmod>(2), "
 693 "B<utime>(2)), excluding those operations covered by B<CAP_DAC_OVERRIDE> and "
 694 "B<CAP_DAC_READ_SEARCH>;"
 695 msgstr ""
 696
 697 #. type: Plain text
 698 #: build/C/man7/capabilities.7:125
 699 msgid "set extended file attributes (see B<chattr>(1))  on arbitrary files;"
 700 msgstr ""
 701
 702 #. type: Plain text
 703 #: build/C/man7/capabilities.7:127
 704 msgid "set Access Control Lists (ACLs) on arbitrary files;"
 705 msgstr ""
 706
 707 #. type: Plain text
 708 #: build/C/man7/capabilities.7:129
 709 msgid "ignore directory sticky bit on file deletion;"
 710 msgstr ""
 711
 712 #. type: Plain text
 713 #: build/C/man7/capabilities.7:136
 714 msgid "specify B<O_NOATIME> for arbitrary files in B<open>(2)  and B<fcntl>(2)."
 715 msgstr ""
 716
 717 #. type: TP
 718 #: build/C/man7/capabilities.7:138
 719 #, no-wrap
 720 msgid "B<CAP_FSETID>"
 721 msgstr ""
 722
 723 #. type: Plain text
 724 #: build/C/man7/capabilities.7:144
 725 msgid ""
 726 "Don't clear set-user-ID and set-group-ID permission bits when a file is "
 727 "modified; set the set-group-ID bit for a file whose GID does not match the "
 728 "filesystem or any of the supplementary GIDs of the calling process."
 729 msgstr ""
 730
 731 #. type: TP
 732 #: build/C/man7/capabilities.7:144
 733 #, no-wrap
 734 msgid "B<CAP_IPC_LOCK>"
 735 msgstr ""
 736
 737 #.  FIXME As at Linux 3.2, there are some strange uses of this capability
 738 #.  in other places; they probably should be replaced with something else.
 739 #. type: Plain text
 740 #: build/C/man7/capabilities.7:153
 741 msgid "Lock memory (B<mlock>(2), B<mlockall>(2), B<mmap>(2), B<shmctl>(2))."
 742 msgstr ""
 743
 744 #. type: TP
 745 #: build/C/man7/capabilities.7:153
 746 #, no-wrap
 747 msgid "B<CAP_IPC_OWNER>"
 748 msgstr ""
 749
 750 #. type: Plain text
 751 #: build/C/man7/capabilities.7:156
 752 msgid "Bypass permission checks for operations on System V IPC objects."
 753 msgstr ""
 754
 755 #. type: TP
 756 #: build/C/man7/capabilities.7:156
 757 #, no-wrap
 758 msgid "B<CAP_KILL>"
 759 msgstr ""
 760
 761 #.  FIXME CAP_KILL also has an effect for threads + setting child
 762 #.        termination signal to other than SIGCHLD: without this
 763 #.        capability, the termination signal reverts to SIGCHLD
 764 #.        if the child does an exec().  What is the rationale
 765 #.        for this?
 766 #. type: Plain text
 767 #: build/C/man7/capabilities.7:169
 768 msgid ""
 769 "Bypass permission checks for sending signals (see B<kill>(2)).  This "
 770 "includes use of the B<ioctl>(2)  B<KDSIGACCEPT> operation."
 771 msgstr ""
 772
 773 #. type: TP
 774 #: build/C/man7/capabilities.7:169
 775 #, no-wrap
 776 msgid "B<CAP_LEASE> (since Linux 2.4)"
 777 msgstr ""
 778
 779 #. type: Plain text
 780 #: build/C/man7/capabilities.7:173
 781 msgid "Establish leases on arbitrary files (see B<fcntl>(2))."
 782 msgstr ""
 783
 784 #. type: TP
 785 #: build/C/man7/capabilities.7:173
 786 #, no-wrap
 787 msgid "B<CAP_LINUX_IMMUTABLE>"
 788 msgstr ""
 789
 790 #.  These attributes are now available on ext2, ext3, Reiserfs, XFS, JFS
 791 #. type: Plain text
 792 #: build/C/man7/capabilities.7:182
 793 msgid ""
 794 "Set the B<FS_APPEND_FL> and B<FS_IMMUTABLE_FL> i-node flags (see "
 795 "B<chattr>(1))."
 796 msgstr ""
 797
 798 #. type: TP
 799 #: build/C/man7/capabilities.7:182
 800 #, no-wrap
 801 msgid "B<CAP_MAC_ADMIN> (since Linux 2.6.25)"
 802 msgstr ""
 803
 804 #. type: Plain text
 805 #: build/C/man7/capabilities.7:186
 806 msgid ""
 807 "Override Mandatory Access Control (MAC).  Implemented for the Smack Linux "
 808 "Security Module (LSM)."
 809 msgstr ""
 810
 811 #. type: TP
 812 #: build/C/man7/capabilities.7:186
 813 #, no-wrap
 814 msgid "B<CAP_MAC_OVERRIDE> (since Linux 2.6.25)"
 815 msgstr ""
 816
 817 #. type: Plain text
 818 #: build/C/man7/capabilities.7:190
 819 msgid "Allow MAC configuration or state changes.  Implemented for the Smack LSM."
 820 msgstr ""
 821
 822 #. type: TP
 823 #: build/C/man7/capabilities.7:190
 824 #, no-wrap
 825 msgid "B<CAP_MKNOD> (since Linux 2.4)"
 826 msgstr ""
 827
 828 #. type: Plain text
 829 #: build/C/man7/capabilities.7:194
 830 msgid "Create special files using B<mknod>(2)."
 831 msgstr ""
 832
 833 #. type: TP
 834 #: build/C/man7/capabilities.7:194
 835 #, no-wrap
 836 msgid "B<CAP_NET_ADMIN>"
 837 msgstr ""
 838
 839 #. type: Plain text
 840 #: build/C/man7/capabilities.7:197
 841 msgid "Perform various network-related operations:"
 842 msgstr ""
 843
 844 #. type: Plain text
 845 #: build/C/man7/capabilities.7:201
 846 msgid "interface configuration;"
 847 msgstr ""
 848
 849 #. type: Plain text
 850 #: build/C/man7/capabilities.7:203
 851 msgid "administration of IP firewall, masquerading, and accounting;"
 852 msgstr ""
 853
 854 #. type: Plain text
 855 #: build/C/man7/capabilities.7:205
 856 msgid "modify routing tables;"
 857 msgstr ""
 858
 859 #. type: Plain text
 860 #: build/C/man7/capabilities.7:207
 861 msgid "bind to any address for transparent proxying;"
 862 msgstr ""
 863
 864 #. type: Plain text
 865 #: build/C/man7/capabilities.7:209
 866 msgid "set type-of-service (TOS)"
 867 msgstr ""
 868
 869 #. type: Plain text
 870 #: build/C/man7/capabilities.7:211
 871 msgid "clear driver statistics;"
 872 msgstr ""
 873
 874 #. type: Plain text
 875 #: build/C/man7/capabilities.7:213
 876 msgid "set promiscuous mode;"
 877 msgstr ""
 878
 879 #. type: Plain text
 880 #: build/C/man7/capabilities.7:215
 881 msgid "enabling multicasting;"
 882 msgstr ""
 883
 884 #. type: Plain text
 885 #: build/C/man7/capabilities.7:226
 886 msgid ""
 887 "use B<setsockopt>(2)  to set the following socket options: B<SO_DEBUG>, "
 888 "B<SO_MARK>, B<SO_PRIORITY> (for a priority outside the range 0 to 6), "
 889 "B<SO_RCVBUFFORCE>, and B<SO_SNDBUFFORCE>."
 890 msgstr ""
 891
 892 #. type: TP
 893 #: build/C/man7/capabilities.7:228
 894 #, no-wrap
 895 msgid "B<CAP_NET_BIND_SERVICE>"
 896 msgstr ""
 897
 898 #. type: Plain text
 899 #: build/C/man7/capabilities.7:232
 900 msgid ""
 901 "Bind a socket to Internet domain privileged ports (port numbers less than "
 902 "1024)."
 903 msgstr ""
 904
 905 #. type: TP
 906 #: build/C/man7/capabilities.7:232
 907 #, no-wrap
 908 msgid "B<CAP_NET_BROADCAST>"
 909 msgstr ""
 910
 911 #. type: Plain text
 912 #: build/C/man7/capabilities.7:235
 913 msgid "(Unused)  Make socket broadcasts, and listen to multicasts."
 914 msgstr ""
 915
 916 #. type: TP
 917 #: build/C/man7/capabilities.7:235
 918 #, no-wrap
 919 msgid "B<CAP_NET_RAW>"
 920 msgstr ""
 921
 922 #. type: Plain text
 923 #: build/C/man7/capabilities.7:241
 924 msgid "use RAW and PACKET sockets;"
 925 msgstr ""
 926
 927 #. type: Plain text
 928 #: build/C/man7/capabilities.7:243
 929 msgid "bind to any address for transparent proxying."
 930 msgstr ""
 931
 932 #. type: TP
 933 #: build/C/man7/capabilities.7:246
 934 #, no-wrap
 935 msgid "B<CAP_SETGID>"
 936 msgstr ""
 937
 938 #. type: Plain text
 939 #: build/C/man7/capabilities.7:250
 940 msgid ""
 941 "Make arbitrary manipulations of process GIDs and supplementary GID list; "
 942 "forge GID when passing socket credentials via UNIX domain sockets."
 943 msgstr ""
 944
 945 #. type: TP
 946 #: build/C/man7/capabilities.7:250
 947 #, no-wrap
 948 msgid "B<CAP_SETFCAP> (since Linux 2.6.24)"
 949 msgstr ""
 950
 951 #. type: Plain text
 952 #: build/C/man7/capabilities.7:253
 953 msgid "Set file capabilities."
 954 msgstr ""
 955
 956 #. type: TP
 957 #: build/C/man7/capabilities.7:253
 958 #, no-wrap
 959 msgid "B<CAP_SETPCAP>"
 960 msgstr ""
 961
 962 #. type: Plain text
 963 #: build/C/man7/capabilities.7:264
 964 msgid ""
 965 "If file capabilities are not supported: grant or remove any capability in "
 966 "the caller's permitted capability set to or from any other process.  (This "
 967 "property of B<CAP_SETPCAP> is not available when the kernel is configured to "
 968 "support file capabilities, since B<CAP_SETPCAP> has entirely different "
 969 "semantics for such kernels.)"
 970 msgstr ""
 971
 972 #. type: Plain text
 973 #: build/C/man7/capabilities.7:274
 974 msgid ""
 975 "If file capabilities are supported: add any capability from the calling "
 976 "thread's bounding set to its inheritable set; drop capabilities from the "
 977 "bounding set (via B<prctl>(2)  B<PR_CAPBSET_DROP>); make changes to the "
 978 "I<securebits> flags."
 979 msgstr ""
 980
 981 #. type: TP
 982 #: build/C/man7/capabilities.7:274
 983 #, no-wrap
 984 msgid "B<CAP_SETUID>"
 985 msgstr ""
 986
 987 #.  FIXME CAP_SETUID also an effect in exec(); document this.
 988 #. type: Plain text
 989 #: build/C/man7/capabilities.7:283
 990 msgid ""
 991 "Make arbitrary manipulations of process UIDs (B<setuid>(2), B<setreuid>(2), "
 992 "B<setresuid>(2), B<setfsuid>(2)); make forged UID when passing socket "
 993 "credentials via UNIX domain sockets."
 994 msgstr ""
 995
 996 #. type: TP
 997 #: build/C/man7/capabilities.7:283
 998 #, no-wrap
 999 msgid "B<CAP_SYS_ADMIN>"
1000 msgstr ""
1001
1002 #. type: Plain text
1003 #: build/C/man7/capabilities.7:297
1004 msgid ""
1005 "Perform a range of system administration operations including: "
1006 "B<quotactl>(2), B<mount>(2), B<umount>(2), B<swapon>(2), B<swapoff>(2), "
1007 "B<sethostname>(2), and B<setdomainname>(2);"
1008 msgstr ""
1009
1010 #. type: Plain text
1011 #: build/C/man7/capabilities.7:303
1012 msgid ""
1013 "perform privileged B<syslog>(2)  operations (since Linux 2.6.37, "
1014 "B<CAP_SYSLOG> should be used to permit such operations);"
1015 msgstr ""
1016
1017 #. type: Plain text
1018 #: build/C/man7/capabilities.7:308
1019 msgid "perform B<VM86_REQUEST_IRQ> B<vm86>(2)  command;"
1020 msgstr ""
1021
1022 #. type: Plain text
1023 #: build/C/man7/capabilities.7:314
1024 msgid ""
1025 "perform B<IPC_SET> and B<IPC_RMID> operations on arbitrary System V IPC "
1026 "objects;"
1027 msgstr ""
1028
1029 #. type: Plain text
1030 #: build/C/man7/capabilities.7:321
1031 msgid ""
1032 "perform operations on I<trusted> and I<security> Extended Attributes (see "
1033 "B<attr>(5));"
1034 msgstr ""
1035
1036 #. type: Plain text
1037 #: build/C/man7/capabilities.7:324
1038 msgid "use B<lookup_dcookie>(2);"
1039 msgstr ""
1040
1041 #. type: Plain text
1042 #: build/C/man7/capabilities.7:332
1043 msgid ""
1044 "use B<ioprio_set>(2)  to assign B<IOPRIO_CLASS_RT> and (before Linux 2.6.25)  "
1045 "B<IOPRIO_CLASS_IDLE> I/O scheduling classes;"
1046 msgstr ""
1047
1048 #. type: Plain text
1049 #: build/C/man7/capabilities.7:334
1050 msgid "forge UID when passing socket credentials;"
1051 msgstr ""
1052
1053 #. type: Plain text
1054 #: build/C/man7/capabilities.7:343
1055 msgid ""
1056 "exceed I</proc/sys/fs/file-max>, the system-wide limit on the number of open "
1057 "files, in system calls that open files (e.g., B<accept>(2), B<execve>(2), "
1058 "B<open>(2), B<pipe>(2));"
1059 msgstr ""
1060
1061 #. type: Plain text
1062 #: build/C/man7/capabilities.7:350
1063 msgid ""
1064 "employ B<CLONE_*> flags that create new namespaces with B<clone>(2)  and "
1065 "B<unshare>(2);"
1066 msgstr ""
1067
1068 #. type: Plain text
1069 #: build/C/man7/capabilities.7:353
1070 msgid "call B<perf_event_open>(2);"
1071 msgstr ""
1072
1073 #. type: Plain text
1074 #: build/C/man7/capabilities.7:357
1075 msgid "access privileged I<perf> event information;"
1076 msgstr ""
1077
1078 #. type: Plain text
1079 #: build/C/man7/capabilities.7:360
1080 msgid "call B<setns>(2);"
1081 msgstr ""
1082
1083 #. type: Plain text
1084 #: build/C/man7/capabilities.7:363
1085 msgid "call B<fanotify_init>(2);"
1086 msgstr ""
1087
1088 #. type: Plain text
1089 #: build/C/man7/capabilities.7:370
1090 msgid "perform B<KEYCTL_CHOWN> and B<KEYCTL_SETPERM> B<keyctl>(2)  operations;"
1091 msgstr ""
1092
1093 #. type: Plain text
1094 #: build/C/man7/capabilities.7:375
1095 msgid "perform B<madvise>(2)  B<MADV_HWPOISON> operation;"
1096 msgstr ""
1097
1098 #. type: Plain text
1099 #: build/C/man7/capabilities.7:381
1100 msgid ""
1101 "employ the B<TIOCSTI> B<ioctl>(2)  to insert characters into the input queue "
1102 "of a terminal other than the caller's controlling terminal."
1103 msgstr ""
1104
1105 #. type: Plain text
1106 #: build/C/man7/capabilities.7:385
1107 msgid "employ the obsolete B<nfsservctl>(2)  system call;"
1108 msgstr ""
1109
1110 #. type: Plain text
1111 #: build/C/man7/capabilities.7:389
1112 msgid "employ the obsolete B<bdflush>(2)  system call;"
1113 msgstr ""
1114
1115 #. type: Plain text
1116 #: build/C/man7/capabilities.7:393
1117 msgid "perform various privileged block-device B<ioctl>(2)  operations;"
1118 msgstr ""
1119
1120 #. type: Plain text
1121 #: build/C/man7/capabilities.7:397
1122 msgid "perform various privileged filesystem B<ioctl>(2)  operations;"
1123 msgstr ""
1124
1125 #. type: Plain text
1126 #: build/C/man7/capabilities.7:399
1127 msgid "perform administrative operations on many device drivers."
1128 msgstr ""
1129
1130 #. type: TP
1131 #: build/C/man7/capabilities.7:401
1132 #, no-wrap
1133 msgid "B<CAP_SYS_BOOT>"
1134 msgstr ""
1135
1136 #. type: Plain text
1137 #: build/C/man7/capabilities.7:407
1138 msgid "Use B<reboot>(2)  and B<kexec_load>(2)."
1139 msgstr ""
1140
1141 #. type: TP
1142 #: build/C/man7/capabilities.7:407
1143 #, no-wrap
1144 msgid "B<CAP_SYS_CHROOT>"
1145 msgstr ""
1146
1147 #. type: Plain text
1148 #: build/C/man7/capabilities.7:411
1149 msgid "Use B<chroot>(2)."
1150 msgstr ""
1151
1152 #. type: TP
1153 #: build/C/man7/capabilities.7:411
1154 #, no-wrap
1155 msgid "B<CAP_SYS_MODULE>"
1156 msgstr ""
1157
1158 #. type: Plain text
1159 #: build/C/man7/capabilities.7:420
1160 msgid ""
1161 "Load and unload kernel modules (see B<init_module>(2)  and "
1162 "B<delete_module>(2)); in kernels before 2.6.25: drop capabilities from the "
1163 "system-wide capability bounding set."
1164 msgstr ""
1165
1166 #. type: TP
1167 #: build/C/man7/capabilities.7:420
1168 #, no-wrap
1169 msgid "B<CAP_SYS_NICE>"
1170 msgstr ""
1171
1172 #. type: Plain text
1173 #: build/C/man7/capabilities.7:429
1174 msgid ""
1175 "Raise process nice value (B<nice>(2), B<setpriority>(2))  and change the "
1176 "nice value for arbitrary processes;"
1177 msgstr ""
1178
1179 #. type: Plain text
1180 #: build/C/man7/capabilities.7:434
1181 msgid ""
1182 "set real-time scheduling policies for calling process, and set scheduling "
1183 "policies and priorities for arbitrary processes (B<sched_setscheduler>(2), "
1184 "B<sched_setparam>(2));"
1185 msgstr ""
1186
1187 #. type: Plain text
1188 #: build/C/man7/capabilities.7:437
1189 msgid "set CPU affinity for arbitrary processes (B<sched_setaffinity>(2));"
1190 msgstr ""
1191
1192 #. type: Plain text
1193 #: build/C/man7/capabilities.7:440
1194 msgid ""
1195 "set I/O scheduling class and priority for arbitrary processes "
1196 "(B<ioprio_set>(2));"
1197 msgstr ""
1198
1199 #.  FIXME CAP_SYS_NICE also has the following effect for
1200 #.  migrate_pages(2):
1201 #.      do_migrate_pages(mm, &old, &new,
1202 #.          capable(CAP_SYS_NICE) ? MPOL_MF_MOVE_ALL : MPOL_MF_MOVE);
1203 #. type: Plain text
1204 #: build/C/man7/capabilities.7:449
1205 msgid ""
1206 "apply B<migrate_pages>(2)  to arbitrary processes and allow processes to be "
1207 "migrated to arbitrary nodes;"
1208 msgstr ""
1209
1210 #. type: Plain text
1211 #: build/C/man7/capabilities.7:453
1212 msgid "apply B<move_pages>(2)  to arbitrary processes;"
1213 msgstr ""
1214
1215 #. type: Plain text
1216 #: build/C/man7/capabilities.7:460
1217 msgid "use the B<MPOL_MF_MOVE_ALL> flag with B<mbind>(2)  and B<move_pages>(2)."
1218 msgstr ""
1219
1220 #. type: TP
1221 #: build/C/man7/capabilities.7:462
1222 #, no-wrap
1223 msgid "B<CAP_SYS_PACCT>"
1224 msgstr ""
1225
1226 #. type: Plain text
1227 #: build/C/man7/capabilities.7:466
1228 msgid "Use B<acct>(2)."
1229 msgstr ""
1230
1231 #. type: TP
1232 #: build/C/man7/capabilities.7:466
1233 #, no-wrap
1234 msgid "B<CAP_SYS_PTRACE>"
1235 msgstr ""
1236
1237 #. type: Plain text
1238 #: build/C/man7/capabilities.7:475
1239 msgid ""
1240 "Trace arbitrary processes using B<ptrace>(2); apply B<get_robust_list>(2)  "
1241 "to arbitrary processes; inspect processes using B<kcmp>(2)."
1242 msgstr ""
1243
1244 #. type: TP
1245 #: build/C/man7/capabilities.7:475
1246 #, no-wrap
1247 msgid "B<CAP_SYS_RAWIO>"
1248 msgstr ""
1249
1250 #. type: Plain text
1251 #: build/C/man7/capabilities.7:484
1252 msgid "Perform I/O port operations (B<iopl>(2)  and B<ioperm>(2));"
1253 msgstr ""
1254
1255 #. type: Plain text
1256 #: build/C/man7/capabilities.7:487
1257 msgid "access I</proc/kcore>;"
1258 msgstr ""
1259
1260 #. type: Plain text
1261 #: build/C/man7/capabilities.7:492
1262 msgid "employ the B<FIBMAP> B<ioctl>(2)  operation;"
1263 msgstr ""
1264
1265 #. type: Plain text
1266 #: build/C/man7/capabilities.7:495
1267 msgid ""
1268 "open devices for accessing x86 model-specific registers (MSRs, see "
1269 "B<msr>(4))"
1270 msgstr ""
1271
1272 #. type: Plain text
1273 #: build/C/man7/capabilities.7:498
1274 msgid "update I</proc/sys/vm/mmap_min_addr>;"
1275 msgstr ""
1276
1277 #. type: Plain text
1278 #: build/C/man7/capabilities.7:501
1279 msgid ""
1280 "create memory mappings at addresses below the value specified by "
1281 "I</proc/sys/vm/mmap_min_addr>;"
1282 msgstr ""
1283
1284 #. type: Plain text
1285 #: build/C/man7/capabilities.7:504
1286 msgid "map files in I</proc/bus/pci>;"
1287 msgstr ""
1288
1289 #. type: Plain text
1290 #: build/C/man7/capabilities.7:509
1291 msgid "open I</dev/mem> and I</dev/kmem>;"
1292 msgstr ""
1293
1294 #. type: Plain text
1295 #: build/C/man7/capabilities.7:511
1296 msgid "perform various SCSI device commands;"
1297 msgstr ""
1298
1299 #. type: Plain text
1300 #: build/C/man7/capabilities.7:517
1301 msgid "perform certain operations on B<hpsa>(4)  and B<cciss>(4)  devices;"
1302 msgstr ""
1303
1304 #. type: Plain text
1305 #: build/C/man7/capabilities.7:519
1306 msgid "perform a range of device-specific operations on other devices."
1307 msgstr ""
1308
1309 #. type: TP
1310 #: build/C/man7/capabilities.7:521
1311 #, no-wrap
1312 msgid "B<CAP_SYS_RESOURCE>"
1313 msgstr ""
1314
1315 #. type: Plain text
1316 #: build/C/man7/capabilities.7:527
1317 msgid "Use reserved space on ext2 filesystems;"
1318 msgstr ""
1319
1320 #. type: Plain text
1321 #: build/C/man7/capabilities.7:531
1322 msgid "make B<ioctl>(2)  calls controlling ext3 journaling;"
1323 msgstr ""
1324
1325 #. type: Plain text
1326 #: build/C/man7/capabilities.7:533
1327 msgid "override disk quota limits;"
1328 msgstr ""
1329
1330 #. type: Plain text
1331 #: build/C/man7/capabilities.7:536
1332 msgid "increase resource limits (see B<setrlimit>(2));"
1333 msgstr ""
1334
1335 #. type: Plain text
1336 #: build/C/man7/capabilities.7:540
1337 msgid "override B<RLIMIT_NPROC> resource limit;"
1338 msgstr ""
1339
1340 #. type: Plain text
1341 #: build/C/man7/capabilities.7:542
1342 msgid "override maximum number of consoles on console allocation;"
1343 msgstr ""
1344
1345 #. type: Plain text
1346 #: build/C/man7/capabilities.7:544
1347 msgid "override maximum number of keymaps;"
1348 msgstr ""
1349
1350 #. type: Plain text
1351 #: build/C/man7/capabilities.7:546
1352 msgid "allow more than 64hz interrupts from the real-time clock;"
1353 msgstr ""
1354
1355 #. type: Plain text
1356 #: build/C/man7/capabilities.7:555
1357 msgid ""
1358 "raise I<msg_qbytes> limit for a System V message queue above the limit in "
1359 "I</proc/sys/kernel/msgmnb> (see B<msgop>(2)  and B<msgctl>(2));"
1360 msgstr ""
1361
1362 #. type: Plain text
1363 #: build/C/man7/capabilities.7:562
1364 msgid ""
1365 "override the I</proc/sys/fs/pipe-size-max> limit when setting the capacity "
1366 "of a pipe using the B<F_SETPIPE_SZ> B<fcntl>(2)  command."
1367 msgstr ""
1368
1369 #. type: Plain text
1370 #: build/C/man7/capabilities.7:567
1371 msgid ""
1372 "use B<F_SETPIPE_SZ> to increase the capacity of a pipe above the limit "
1373 "specified by I</proc/sys/fs/pipe-max-size>;"
1374 msgstr ""
1375
1376 #. type: Plain text
1377 #: build/C/man7/capabilities.7:572
1378 msgid ""
1379 "override I</proc/sys/fs/mqueue/queues_max> limit when creating POSIX message "
1380 "queues (see B<mq_overview>(7));"
1381 msgstr ""
1382
1383 #. type: Plain text
1384 #: build/C/man7/capabilities.7:577
1385 msgid "employ B<prctl>(2)  B<PR_SET_MM> operation;"
1386 msgstr ""
1387
1388 #. type: Plain text
1389 #: build/C/man7/capabilities.7:582
1390 msgid ""
1391 "set I</proc/PID/oom_score_adj> to a value lower than the value last set by a "
1392 "process with B<CAP_SYS_RESOURCE>."
1393 msgstr ""
1394
1395 #. type: TP
1396 #: build/C/man7/capabilities.7:584
1397 #, no-wrap
1398 msgid "B<CAP_SYS_TIME>"
1399 msgstr ""
1400
1401 #. type: Plain text
1402 #: build/C/man7/capabilities.7:591
1403 msgid ""
1404 "Set system clock (B<settimeofday>(2), B<stime>(2), B<adjtimex>(2)); set "
1405 "real-time (hardware) clock."
1406 msgstr ""
1407
1408 #. type: TP
1409 #: build/C/man7/capabilities.7:591
1410 #, no-wrap
1411 msgid "B<CAP_SYS_TTY_CONFIG>"
1412 msgstr ""
1413
1414 #. type: Plain text
1415 #: build/C/man7/capabilities.7:598
1416 msgid ""
1417 "Use B<vhangup>(2); employ various privileged B<ioctl>(2)  operations on "
1418 "virtual terminals."
1419 msgstr ""
1420
1421 #. type: TP
1422 #: build/C/man7/capabilities.7:598
1423 #, no-wrap
1424 msgid "B<CAP_SYSLOG> (since Linux 2.6.37)"
1425 msgstr ""
1426
1427 #. type: Plain text
1428 #: build/C/man7/capabilities.7:607
1429 msgid ""
1430 "Perform privileged B<syslog>(2)  operations.  See B<syslog>(2)  for "
1431 "information on which operations require privilege."
1432 msgstr ""
1433
1434 #. type: Plain text
1435 #: build/C/man7/capabilities.7:617
1436 msgid ""
1437 "View kernel addresses exposed via I</proc> and other interfaces when "
1438 "I</proc/sys/kernel/kptr_restrict> has the value 1.  (See the discussion of "
1439 "the I<kptr_restrict> in B<proc>(5).)"
1440 msgstr ""
1441
1442 #. type: TP
1443 #: build/C/man7/capabilities.7:617
1444 #, no-wrap
1445 msgid "B<CAP_WAKE_ALARM> (since Linux 3.0)"
1446 msgstr ""
1447
1448 #. type: Plain text
1449 #: build/C/man7/capabilities.7:625
1450 msgid ""
1451 "Trigger something that will wake up the system (set B<CLOCK_REALTIME_ALARM> "
1452 "and B<CLOCK_BOOTTIME_ALARM> timers)."
1453 msgstr ""
1454
1455 #. type: SS
1456 #: build/C/man7/capabilities.7:625
1457 #, no-wrap
1458 msgid "Past and current implementation"
1459 msgstr ""
1460
1461 #. type: Plain text
1462 #: build/C/man7/capabilities.7:627
1463 msgid "A full implementation of capabilities requires that:"
1464 msgstr ""
1465
1466 #. type: IP
1467 #: build/C/man7/capabilities.7:627 build/C/man7/capabilities.7:778 build/C/man7/capabilities.7:925 build/C/man7/capabilities.7:978
1468 #, no-wrap
1469 msgid "1."
1470 msgstr ""
1471
1472 #. type: Plain text
1473 #: build/C/man7/capabilities.7:631
1474 msgid ""
1475 "For all privileged operations, the kernel must check whether the thread has "
1476 "the required capability in its effective set."
1477 msgstr ""
1478
1479 #. type: IP
1480 #: build/C/man7/capabilities.7:631 build/C/man7/capabilities.7:783 build/C/man7/capabilities.7:931 build/C/man7/capabilities.7:984
1481 #, no-wrap
1482 msgid "2."
1483 msgstr ""
1484
1485 #. type: Plain text
1486 #: build/C/man7/capabilities.7:634
1487 msgid ""
1488 "The kernel must provide system calls allowing a thread's capability sets to "
1489 "be changed and retrieved."
1490 msgstr ""
1491
1492 #. type: IP
1493 #: build/C/man7/capabilities.7:634 build/C/man7/capabilities.7:934 build/C/man7/capabilities.7:988
1494 #, no-wrap
1495 msgid "3."
1496 msgstr ""
1497
1498 #. type: Plain text
1499 #: build/C/man7/capabilities.7:637
1500 msgid ""
1501 "The filesystem must support attaching capabilities to an executable file, so "
1502 "that a process gains those capabilities when the file is executed."
1503 msgstr ""
1504
1505 #. type: Plain text
1506 #: build/C/man7/capabilities.7:641
1507 msgid ""
1508 "Before kernel 2.6.24, only the first two of these requirements are met; "
1509 "since kernel 2.6.24, all three requirements are met."
1510 msgstr ""
1511
1512 #. type: SS
1513 #: build/C/man7/capabilities.7:641
1514 #, no-wrap
1515 msgid "Thread capability sets"
1516 msgstr ""
1517
1518 #. type: Plain text
1519 #: build/C/man7/capabilities.7:644
1520 msgid ""
1521 "Each thread has three capability sets containing zero or more of the above "
1522 "capabilities:"
1523 msgstr ""
1524
1525 #. type: TP
1526 #: build/C/man7/capabilities.7:644
1527 #, no-wrap
1528 msgid "I<Permitted>:"
1529 msgstr ""
1530
1531 #. type: Plain text
1532 #: build/C/man7/capabilities.7:652
1533 msgid ""
1534 "This is a limiting superset for the effective capabilities that the thread "
1535 "may assume.  It is also a limiting superset for the capabilities that may be "
1536 "added to the inheritable set by a thread that does not have the "
1537 "B<CAP_SETPCAP> capability in its effective set."
1538 msgstr ""
1539
1540 #. type: Plain text
1541 #: build/C/man7/capabilities.7:658
1542 msgid ""
1543 "If a thread drops a capability from its permitted set, it can never "
1544 "reacquire that capability (unless it B<execve>(2)s either a set-user-ID-root "
1545 "program, or a program whose associated file capabilities grant that "
1546 "capability)."
1547 msgstr ""
1548
1549 #. type: TP
1550 #: build/C/man7/capabilities.7:658
1551 #, no-wrap
1552 msgid "I<Inheritable>:"
1553 msgstr ""
1554
1555 #. type: Plain text
1556 #: build/C/man7/capabilities.7:665
1557 msgid ""
1558 "This is a set of capabilities preserved across an B<execve>(2).  It provides "
1559 "a mechanism for a process to assign capabilities to the permitted set of the "
1560 "new program during an B<execve>(2)."
1561 msgstr ""
1562
1563 #. type: TP
1564 #: build/C/man7/capabilities.7:665 build/C/man7/capabilities.7:715
1565 #, no-wrap
1566 msgid "I<Effective>:"
1567 msgstr ""
1568
1569 #. type: Plain text
1570 #: build/C/man7/capabilities.7:669
1571 msgid ""
1572 "This is the set of capabilities used by the kernel to perform permission "
1573 "checks for the thread."
1574 msgstr ""
1575
1576 #. type: Plain text
1577 #: build/C/man7/capabilities.7:675
1578 msgid ""
1579 "A child created via B<fork>(2)  inherits copies of its parent's capability "
1580 "sets.  See below for a discussion of the treatment of capabilities during "
1581 "B<execve>(2)."
1582 msgstr ""
1583
1584 #. type: Plain text
1585 #: build/C/man7/capabilities.7:679
1586 msgid ""
1587 "Using B<capset>(2), a thread may manipulate its own capability sets (see "
1588 "below)."
1589 msgstr ""
1590
1591 #.  commit 73efc0394e148d0e15583e13712637831f926720
1592 #. type: Plain text
1593 #: build/C/man7/capabilities.7:688
1594 msgid ""
1595 "Since Linux 3.2, the file I</proc/sys/kernel/cap_last_cap> exposes the "
1596 "numerical value of the highest capability supported by the running kernel; "
1597 "this can be used to determine the highest bit that may be set in a "
1598 "capability set."
1599 msgstr ""
1600
1601 #. type: SS
1602 #: build/C/man7/capabilities.7:688
1603 #, no-wrap
1604 msgid "File capabilities"
1605 msgstr ""
1606
1607 #. type: Plain text
1608 #: build/C/man7/capabilities.7:703
1609 msgid ""
1610 "Since kernel 2.6.24, the kernel supports associating capability sets with an "
1611 "executable file using B<setcap>(8).  The file capability sets are stored in "
1612 "an extended attribute (see B<setxattr>(2))  named I<security.capability>.  "
1613 "Writing to this extended attribute requires the B<CAP_SETFCAP> capability.  "
1614 "The file capability sets, in conjunction with the capability sets of the "
1615 "thread, determine the capabilities of a thread after an B<execve>(2)."
1616 msgstr ""
1617
1618 #. type: Plain text
1619 #: build/C/man7/capabilities.7:705
1620 msgid "The three file capability sets are:"
1621 msgstr ""
1622
1623 #. type: TP
1624 #: build/C/man7/capabilities.7:705
1625 #, no-wrap
1626 msgid "I<Permitted> (formerly known as I<forced>):"
1627 msgstr ""
1628
1629 #. type: Plain text
1630 #: build/C/man7/capabilities.7:709
1631 msgid ""
1632 "These capabilities are automatically permitted to the thread, regardless of "
1633 "the thread's inheritable capabilities."
1634 msgstr ""
1635
1636 #. type: TP
1637 #: build/C/man7/capabilities.7:709
1638 #, no-wrap
1639 msgid "I<Inheritable> (formerly known as I<allowed>):"
1640 msgstr ""
1641
1642 #. type: Plain text
1643 #: build/C/man7/capabilities.7:715
1644 msgid ""
1645 "This set is ANDed with the thread's inheritable set to determine which "
1646 "inheritable capabilities are enabled in the permitted set of the thread "
1647 "after the B<execve>(2)."
1648 msgstr ""
1649
1650 #. type: Plain text
1651 #: build/C/man7/capabilities.7:725
1652 msgid ""
1653 "This is not a set, but rather just a single bit.  If this bit is set, then "
1654 "during an B<execve>(2)  all of the new permitted capabilities for the thread "
1655 "are also raised in the effective set.  If this bit is not set, then after an "
1656 "B<execve>(2), none of the new permitted capabilities is in the new effective "
1657 "set."
1658 msgstr ""
1659
1660 #. type: Plain text
1661 #: build/C/man7/capabilities.7:741
1662 msgid ""
1663 "Enabling the file effective capability bit implies that any file permitted "
1664 "or inheritable capability that causes a thread to acquire the corresponding "
1665 "permitted capability during an B<execve>(2)  (see the transformation rules "
1666 "described below) will also acquire that capability in its effective set.  "
1667 "Therefore, when assigning capabilities to a file (B<setcap>(8), "
1668 "B<cap_set_file>(3), B<cap_set_fd>(3)), if we specify the effective flag as "
1669 "being enabled for any capability, then the effective flag must also be "
1670 "specified as enabled for all other capabilities for which the corresponding "
1671 "permitted or inheritable flags is enabled."
1672 msgstr ""
1673
1674 #. type: SS
1675 #: build/C/man7/capabilities.7:741
1676 #, no-wrap
1677 msgid "Transformation of capabilities during execve()"
1678 msgstr ""
1679
1680 #. type: Plain text
1681 #: build/C/man7/capabilities.7:747
1682 msgid ""
1683 "During an B<execve>(2), the kernel calculates the new capabilities of the "
1684 "process using the following algorithm:"
1685 msgstr ""
1686
1687 #. type: Plain text
1688 #: build/C/man7/capabilities.7:752
1689 #, no-wrap
1690 msgid ""
1691 "P'(permitted) = (P(inheritable) & F(inheritable)) |\n"
1692 "                (F(permitted) & cap_bset)\n"
1693 msgstr ""
1694
1695 #. type: Plain text
1696 #: build/C/man7/capabilities.7:754
1697 #, no-wrap
1698 msgid "P'(effective) = F(effective) ? P'(permitted) : 0\n"
1699 msgstr ""
1700
1701 #. type: Plain text
1702 #: build/C/man7/capabilities.7:756
1703 #, no-wrap
1704 msgid "P'(inheritable) = P(inheritable)    [i.e., unchanged]\n"
1705 msgstr ""
1706
1707 #. type: Plain text
1708 #: build/C/man7/capabilities.7:760
1709 msgid "where:"
1710 msgstr ""
1711
1712 #. type: IP
1713 #: build/C/man7/capabilities.7:761
1714 #, no-wrap
1715 msgid "P"
1716 msgstr ""
1717
1718 #. type: Plain text
1719 #: build/C/man7/capabilities.7:764
1720 msgid "denotes the value of a thread capability set before the B<execve>(2)"
1721 msgstr ""
1722
1723 #. type: IP
1724 #: build/C/man7/capabilities.7:764
1725 #, no-wrap
1726 msgid "P'"
1727 msgstr ""
1728
1729 #. type: Plain text
1730 #: build/C/man7/capabilities.7:767
1731 msgid "denotes the value of a capability set after the B<execve>(2)"
1732 msgstr ""
1733
1734 #. type: IP
1735 #: build/C/man7/capabilities.7:767
1736 #, no-wrap
1737 msgid "F"
1738 msgstr ""
1739
1740 #. type: Plain text
1741 #: build/C/man7/capabilities.7:769
1742 msgid "denotes a file capability set"
1743 msgstr ""
1744
1745 #. type: IP
1746 #: build/C/man7/capabilities.7:769
1747 #, no-wrap
1748 msgid "cap_bset"
1749 msgstr ""
1750
1751 #. type: Plain text
1752 #: build/C/man7/capabilities.7:771
1753 msgid "is the value of the capability bounding set (described below)."
1754 msgstr ""
1755
1756 #. type: SS
1757 #: build/C/man7/capabilities.7:773
1758 #, no-wrap
1759 msgid "Capabilities and execution of programs by root"
1760 msgstr ""
1761
1762 #. type: Plain text
1763 #: build/C/man7/capabilities.7:778
1764 msgid ""
1765 "In order to provide an all-powerful I<root> using capability sets, during an "
1766 "B<execve>(2):"
1767 msgstr ""
1768
1769 #. type: Plain text
1770 #: build/C/man7/capabilities.7:783
1771 msgid ""
1772 "If a set-user-ID-root program is being executed, or the real user ID of the "
1773 "process is 0 (root)  then the file inheritable and permitted sets are "
1774 "defined to be all ones (i.e., all capabilities enabled)."
1775 msgstr ""
1776
1777 #. type: Plain text
1778 #: build/C/man7/capabilities.7:786
1779 msgid ""
1780 "If a set-user-ID-root program is being executed, then the file effective bit "
1781 "is defined to be one (enabled)."
1782 msgstr ""
1783
1784 #.  If a process with real UID 0, and nonzero effective UID does an
1785 #.  exec(), then it gets all capabilities in its
1786 #.  permitted set, and no effective capabilities
1787 #. type: Plain text
1788 #: build/C/man7/capabilities.7:801
1789 msgid ""
1790 "The upshot of the above rules, combined with the capabilities "
1791 "transformations described above, is that when a process B<execve>(2)s a "
1792 "set-user-ID-root program, or when a process with an effective UID of 0 "
1793 "B<execve>(2)s a program, it gains all capabilities in its permitted and "
1794 "effective capability sets, except those masked out by the capability "
1795 "bounding set.  This provides semantics that are the same as those provided "
1796 "by traditional UNIX systems."
1797 msgstr ""
1798
1799 #. type: SS
1800 #: build/C/man7/capabilities.7:801
1801 #, no-wrap
1802 msgid "Capability bounding set"
1803 msgstr ""
1804
1805 #. type: Plain text
1806 #: build/C/man7/capabilities.7:806
1807 msgid ""
1808 "The capability bounding set is a security mechanism that can be used to "
1809 "limit the capabilities that can be gained during an B<execve>(2).  The "
1810 "bounding set is used in the following ways:"
1811 msgstr ""
1812
1813 #. type: Plain text
1814 #: build/C/man7/capabilities.7:814
1815 msgid ""
1816 "During an B<execve>(2), the capability bounding set is ANDed with the file "
1817 "permitted capability set, and the result of this operation is assigned to "
1818 "the thread's permitted capability set.  The capability bounding set thus "
1819 "places a limit on the permitted capabilities that may be granted by an "
1820 "executable file."
1821 msgstr ""
1822
1823 #. type: Plain text
1824 #: build/C/man7/capabilities.7:826
1825 msgid ""
1826 "(Since Linux 2.6.25)  The capability bounding set acts as a limiting "
1827 "superset for the capabilities that a thread can add to its inheritable set "
1828 "using B<capset>(2).  This means that if a capability is not in the bounding "
1829 "set, then a thread can't add this capability to its inheritable set, even if "
1830 "it was in its permitted capabilities, and thereby cannot have this "
1831 "capability preserved in its permitted set when it B<execve>(2)s a file that "
1832 "has the capability in its inheritable set."
1833 msgstr ""
1834
1835 #. type: Plain text
1836 #: build/C/man7/capabilities.7:833
1837 msgid ""
1838 "Note that the bounding set masks the file permitted capabilities, but not "
1839 "the inherited capabilities.  If a thread maintains a capability in its "
1840 "inherited set that is not in its bounding set, then it can still gain that "
1841 "capability in its permitted set by executing a file that has the capability "
1842 "in its inherited set."
1843 msgstr ""
1844
1845 #. type: Plain text
1846 #: build/C/man7/capabilities.7:836
1847 msgid ""
1848 "Depending on the kernel version, the capability bounding set is either a "
1849 "system-wide attribute, or a per-process attribute."
1850 msgstr ""
1851
1852 #. type: Plain text
1853 #: build/C/man7/capabilities.7:838
1854 msgid "B<Capability bounding set prior to Linux 2.6.25>"
1855 msgstr ""
1856
1857 #. type: Plain text
1858 #: build/C/man7/capabilities.7:846
1859 msgid ""
1860 "In kernels before 2.6.25, the capability bounding set is a system-wide "
1861 "attribute that affects all threads on the system.  The bounding set is "
1862 "accessible via the file I</proc/sys/kernel/cap-bound>.  (Confusingly, this "
1863 "bit mask parameter is expressed as a signed decimal number in "
1864 "I</proc/sys/kernel/cap-bound>.)"
1865 msgstr ""
1866
1867 #. type: Plain text
1868 #: build/C/man7/capabilities.7:853
1869 msgid ""
1870 "Only the B<init> process may set capabilities in the capability bounding "
1871 "set; other than that, the superuser (more precisely: programs with the "
1872 "B<CAP_SYS_MODULE> capability) may only clear capabilities from this set."
1873 msgstr ""
1874
1875 #. type: Plain text
1876 #: build/C/man7/capabilities.7:862
1877 msgid ""
1878 "On a standard system the capability bounding set always masks out the "
1879 "B<CAP_SETPCAP> capability.  To remove this restriction (dangerous!), modify "
1880 "the definition of B<CAP_INIT_EFF_SET> in I<include/linux/capability.h> and "
1881 "rebuild the kernel."
1882 msgstr ""
1883
1884 #. type: Plain text
1885 #: build/C/man7/capabilities.7:866
1886 msgid ""
1887 "The system-wide capability bounding set feature was added to Linux starting "
1888 "with kernel version 2.2.11."
1889 msgstr ""
1890
1891 #. type: Plain text
1892 #: build/C/man7/capabilities.7:868
1893 msgid "B<Capability bounding set from Linux 2.6.25 onward>"
1894 msgstr ""
1895
1896 #. type: Plain text
1897 #: build/C/man7/capabilities.7:873
1898 msgid ""
1899 "From Linux 2.6.25, the I<capability bounding set> is a per-thread "
1900 "attribute.  (There is no longer a system-wide capability bounding set.)"
1901 msgstr ""
1902
1903 #. type: Plain text
1904 #: build/C/man7/capabilities.7:878
1905 msgid ""
1906 "The bounding set is inherited at B<fork>(2)  from the thread's parent, and "
1907 "is preserved across an B<execve>(2)."
1908 msgstr ""
1909
1910 #. type: Plain text
1911 #: build/C/man7/capabilities.7:891
1912 msgid ""
1913 "A thread may remove capabilities from its capability bounding set using the "
1914 "B<prctl>(2)  B<PR_CAPBSET_DROP> operation, provided it has the "
1915 "B<CAP_SETPCAP> capability.  Once a capability has been dropped from the "
1916 "bounding set, it cannot be restored to that set.  A thread can determine if "
1917 "a capability is in its bounding set using the B<prctl>(2)  "
1918 "B<PR_CAPBSET_READ> operation."
1919 msgstr ""
1920
1921 #. type: Plain text
1922 #: build/C/man7/capabilities.7:909
1923 msgid ""
1924 "Removing capabilities from the bounding set is supported only if file "
1925 "capabilities are compiled into the kernel.  In kernels before Linux 2.6.33, "
1926 "file capabilities were an optional feature configurable via the "
1927 "CONFIG_SECURITY_FILE_CAPABILITIES option.  Since Linux 2.6.33, the "
1928 "configuration option has been removed and file capabilities are always part "
1929 "of the kernel.  When file capabilities are compiled into the kernel, the "
1930 "B<init> process (the ancestor of all processes) begins with a full bounding "
1931 "set.  If file capabilities are not compiled into the kernel, then B<init> "
1932 "begins with a full bounding set minus B<CAP_SETPCAP>, because this "
1933 "capability has a different meaning when there are no file capabilities."
1934 msgstr ""
1935
1936 #. type: Plain text
1937 #: build/C/man7/capabilities.7:916
1938 msgid ""
1939 "Removing a capability from the bounding set does not remove it from the "
1940 "thread's inherited set.  However it does prevent the capability from being "
1941 "added back into the thread's inherited set in the future."
1942 msgstr ""
1943
1944 #. type: SS
1945 #: build/C/man7/capabilities.7:916
1946 #, no-wrap
1947 msgid "Effect of user ID changes on capabilities"
1948 msgstr ""
1949
1950 #. type: Plain text
1951 #: build/C/man7/capabilities.7:925
1952 msgid ""
1953 "To preserve the traditional semantics for transitions between 0 and nonzero "
1954 "user IDs, the kernel makes the following changes to a thread's capability "
1955 "sets on changes to the thread's real, effective, saved set, and filesystem "
1956 "user IDs (using B<setuid>(2), B<setresuid>(2), or similar):"
1957 msgstr ""
1958
1959 #. type: Plain text
1960 #: build/C/man7/capabilities.7:931
1961 msgid ""
1962 "If one or more of the real, effective or saved set user IDs was previously "
1963 "0, and as a result of the UID changes all of these IDs have a nonzero value, "
1964 "then all capabilities are cleared from the permitted and effective "
1965 "capability sets."
1966 msgstr ""
1967
1968 #. type: Plain text
1969 #: build/C/man7/capabilities.7:934
1970 msgid ""
1971 "If the effective user ID is changed from 0 to nonzero, then all capabilities "
1972 "are cleared from the effective set."
1973 msgstr ""
1974
1975 #. type: Plain text
1976 #: build/C/man7/capabilities.7:937
1977 msgid ""
1978 "If the effective user ID is changed from nonzero to 0, then the permitted "
1979 "set is copied to the effective set."
1980 msgstr ""
1981
1982 #. type: IP
1983 #: build/C/man7/capabilities.7:937 build/C/man7/capabilities.7:992
1984 #, no-wrap
1985 msgid "4."
1986 msgstr ""
1987
1988 #. type: Plain text
1989 #: build/C/man7/capabilities.7:955
1990 msgid ""
1991 "If the filesystem user ID is changed from 0 to nonzero (see B<setfsuid>(2))  "
1992 "then the following capabilities are cleared from the effective set: "
1993 "B<CAP_CHOWN>, B<CAP_DAC_OVERRIDE>, B<CAP_DAC_READ_SEARCH>, B<CAP_FOWNER>, "
1994 "B<CAP_FSETID>, B<CAP_LINUX_IMMUTABLE> (since Linux 2.2.30), "
1995 "B<CAP_MAC_OVERRIDE>, and B<CAP_MKNOD> (since Linux 2.2.30).  If the "
1996 "filesystem UID is changed from nonzero to 0, then any of these capabilities "
1997 "that are enabled in the permitted set are enabled in the effective set."
1998 msgstr ""
1999
2000 #. type: Plain text
2001 #: build/C/man7/capabilities.7:963
2002 msgid ""
2003 "If a thread that has a 0 value for one or more of its user IDs wants to "
2004 "prevent its permitted capability set being cleared when it resets all of its "
2005 "user IDs to nonzero values, it can do so using the B<prctl>(2)  "
2006 "B<PR_SET_KEEPCAPS> operation."
2007 msgstr ""
2008
2009 #. type: SS
2010 #: build/C/man7/capabilities.7:963
2011 #, no-wrap
2012 msgid "Programmatically adjusting capability sets"
2013 msgstr ""
2014
2015 #. type: Plain text
2016 #: build/C/man7/capabilities.7:978
2017 msgid ""
2018 "A thread can retrieve and change its capability sets using the B<capget>(2)  "
2019 "and B<capset>(2)  system calls.  However, the use of B<cap_get_proc>(3)  and "
2020 "B<cap_set_proc>(3), both provided in the I<libcap> package, is preferred for "
2021 "this purpose.  The following rules govern changes to the thread capability "
2022 "sets:"
2023 msgstr ""
2024
2025 #. type: Plain text
2026 #: build/C/man7/capabilities.7:984
2027 msgid ""
2028 "If the caller does not have the B<CAP_SETPCAP> capability, the new "
2029 "inheritable set must be a subset of the combination of the existing "
2030 "inheritable and permitted sets."
2031 msgstr ""
2032
2033 #. type: Plain text
2034 #: build/C/man7/capabilities.7:988
2035 msgid ""
2036 "(Since Linux 2.6.25)  The new inheritable set must be a subset of the "
2037 "combination of the existing inheritable set and the capability bounding set."
2038 msgstr ""
2039
2040 #. type: Plain text
2041 #: build/C/man7/capabilities.7:992
2042 msgid ""
2043 "The new permitted set must be a subset of the existing permitted set (i.e., "
2044 "it is not possible to acquire permitted capabilities that the thread does "
2045 "not currently have)."
2046 msgstr ""
2047
2048 #. type: Plain text
2049 #: build/C/man7/capabilities.7:994
2050 msgid "The new effective set must be a subset of the new permitted set."
2051 msgstr ""
2052
2053 #. type: SS
2054 #: build/C/man7/capabilities.7:994
2055 #, no-wrap
2056 msgid "The securebits flags: establishing a capabilities-only environment"
2057 msgstr ""
2058
2059 #.  For some background:
2060 #.        see http://lwn.net/Articles/280279/ and
2061 #.        http://article.gmane.org/gmane.linux.kernel.lsm/5476/
2062 #. type: Plain text
2063 #: build/C/man7/capabilities.7:1005
2064 msgid ""
2065 "Starting with kernel 2.6.26, and with a kernel in which file capabilities "
2066 "are enabled, Linux implements a set of per-thread I<securebits> flags that "
2067 "can be used to disable special handling of capabilities for UID 0 "
2068 "(I<root>).  These flags are as follows:"
2069 msgstr ""
2070
2071 #. type: TP
2072 #: build/C/man7/capabilities.7:1005
2073 #, no-wrap
2074 msgid "B<SECBIT_KEEP_CAPS>"
2075 msgstr ""
2076
2077 #. type: Plain text
2078 #: build/C/man7/capabilities.7:1017
2079 msgid ""
2080 "Setting this flag allows a thread that has one or more 0 UIDs to retain its "
2081 "capabilities when it switches all of its UIDs to a nonzero value.  If this "
2082 "flag is not set, then such a UID switch causes the thread to lose all "
2083 "capabilities.  This flag is always cleared on an B<execve>(2).  (This flag "
2084 "provides the same functionality as the older B<prctl>(2)  B<PR_SET_KEEPCAPS> "
2085 "operation.)"
2086 msgstr ""
2087
2088 #. type: TP
2089 #: build/C/man7/capabilities.7:1017
2090 #, no-wrap
2091 msgid "B<SECBIT_NO_SETUID_FIXUP>"
2092 msgstr ""
2093
2094 #. type: Plain text
2095 #: build/C/man7/capabilities.7:1024
2096 msgid ""
2097 "Setting this flag stops the kernel from adjusting capability sets when the "
2098 "threads's effective and filesystem UIDs are switched between zero and "
2099 "nonzero values.  (See the subsection I<Effect of User ID Changes on "
2100 "Capabilities>.)"
2101 msgstr ""
2102
2103 #. type: TP
2104 #: build/C/man7/capabilities.7:1024
2105 #, no-wrap
2106 msgid "B<SECBIT_NOROOT>"
2107 msgstr ""
2108
2109 #. type: Plain text
2110 #: build/C/man7/capabilities.7:1032
2111 msgid ""
2112 "If this bit is set, then the kernel does not grant capabilities when a "
2113 "set-user-ID-root program is executed, or when a process with an effective or "
2114 "real UID of 0 calls B<execve>(2).  (See the subsection I<Capabilities and "
2115 "execution of programs by root>.)"
2116 msgstr ""
2117
2118 #. type: Plain text
2119 #: build/C/man7/capabilities.7:1042
2120 msgid ""
2121 "Each of the above \"base\" flags has a companion \"locked\" flag.  Setting "
2122 "any of the \"locked\" flags is irreversible, and has the effect of "
2123 "preventing further changes to the corresponding \"base\" flag.  The locked "
2124 "flags are: B<SECBIT_KEEP_CAPS_LOCKED>, B<SECBIT_NO_SETUID_FIXUP_LOCKED>, and "
2125 "B<SECBIT_NOROOT_LOCKED>."
2126 msgstr ""
2127
2128 #. type: Plain text
2129 #: build/C/man7/capabilities.7:1054
2130 msgid ""
2131 "The I<securebits> flags can be modified and retrieved using the B<prctl>(2)  "
2132 "B<PR_SET_SECUREBITS> and B<PR_GET_SECUREBITS> operations.  The "
2133 "B<CAP_SETPCAP> capability is required to modify the flags."
2134 msgstr ""
2135
2136 #. type: Plain text
2137 #: build/C/man7/capabilities.7:1063
2138 msgid ""
2139 "The I<securebits> flags are inherited by child processes.  During an "
2140 "B<execve>(2), all of the flags are preserved, except B<SECBIT_KEEP_CAPS> "
2141 "which is always cleared."
2142 msgstr ""
2143
2144 #. type: Plain text
2145 #: build/C/man7/capabilities.7:1068
2146 msgid ""
2147 "An application can use the following call to lock itself, and all of its "
2148 "descendants, into an environment where the only way of gaining capabilities "
2149 "is by executing a program with associated file capabilities:"
2150 msgstr ""
2151
2152 #. type: Plain text
2153 #: build/C/man7/capabilities.7:1077
2154 #, no-wrap
2155 msgid ""
2156 "prctl(PR_SET_SECUREBITS,\n"
2157 "        SECBIT_KEEP_CAPS_LOCKED |\n"
2158 "        SECBIT_NO_SETUID_FIXUP |\n"
2159 "        SECBIT_NO_SETUID_FIXUP_LOCKED |\n"
2160 "        SECBIT_NOROOT |\n"
2161 "        SECBIT_NOROOT_LOCKED);\n"
2162 msgstr ""
2163
2164 #. type: Plain text
2165 #: build/C/man7/capabilities.7:1085
2166 msgid ""
2167 "No standards govern capabilities, but the Linux capability implementation is "
2168 "based on the withdrawn POSIX.1e draft standard; see E<.UR "
2169 "http://wt.tuxomania.net\\:/publications\\:/posix.1e/> E<.UE .>"
2170 msgstr ""
2171
2172 #. type: Plain text
2173 #: build/C/man7/capabilities.7:1089
2174 msgid ""
2175 "Since kernel 2.5.27, capabilities are an optional kernel component, and can "
2176 "be enabled/disabled via the CONFIG_SECURITY_CAPABILITIES kernel "
2177 "configuration option."
2178 msgstr ""
2179
2180 #.  7b9a7ec565505699f503b4fcf61500dceb36e744
2181 #. type: Plain text
2182 #: build/C/man7/capabilities.7:1103
2183 msgid ""
2184 "The I</proc/PID/task/TID/status> file can be used to view the capability "
2185 "sets of a thread.  The I</proc/PID/status> file shows the capability sets of "
2186 "a process's main thread.  Before Linux 3.8, nonexistent capabilities were "
2187 "shown as being enabled (1) in these sets.  Since Linux 3.8, all non-existent "
2188 "capabilities (above B<CAP_LAST_CAP>)  are shown as disabled (0)."
2189 msgstr ""
2190
2191 #. type: Plain text
2192 #: build/C/man7/capabilities.7:1118
2193 msgid ""
2194 "The I<libcap> package provides a suite of routines for setting and getting "
2195 "capabilities that is more comfortable and less likely to change than the "
2196 "interface provided by B<capset>(2)  and B<capget>(2).  This package also "
2197 "provides the B<setcap>(8)  and B<getcap>(8)  programs.  It can be found at"
2198 msgstr ""
2199
2200 #. type: Plain text
2201 #: build/C/man7/capabilities.7:1121
2202 msgid ""
2203 "E<.UR "
2204 "http://www.kernel.org\\:/pub\\:/linux\\:/libs\\:/security\\:/linux-privs> "
2205 "E<.UE .>"
2206 msgstr ""
2207
2208 #. type: Plain text
2209 #: build/C/man7/capabilities.7:1130
2210 msgid ""
2211 "Before kernel 2.6.24, and since kernel 2.6.24 if file capabilities are not "
2212 "enabled, a thread with the B<CAP_SETPCAP> capability can manipulate the "
2213 "capabilities of threads other than itself.  However, this is only "
2214 "theoretically possible, since no thread ever has B<CAP_SETPCAP> in either of "
2215 "these cases:"
2216 msgstr ""
2217
2218 #. type: Plain text
2219 #: build/C/man7/capabilities.7:1135
2220 msgid ""
2221 "In the pre-2.6.25 implementation the system-wide capability bounding set, "
2222 "I</proc/sys/kernel/cap-bound>, always masks out this capability, and this "
2223 "can not be changed without modifying the kernel source and rebuilding."
2224 msgstr ""
2225
2226 #. type: Plain text
2227 #: build/C/man7/capabilities.7:1141
2228 msgid ""
2229 "If file capabilities are disabled in the current implementation, then "
2230 "B<init> starts out with this capability removed from its per-process "
2231 "bounding set, and that bounding set is inherited by all other processes "
2232 "created on the system."
2233 msgstr ""
2234
2235 #. type: Plain text
2236 #: build/C/man7/capabilities.7:1158
2237 msgid ""
2238 "B<capget>(2), B<prctl>(2), B<setfsuid>(2), B<cap_clear>(3), "
2239 "B<cap_copy_ext>(3), B<cap_from_text>(3), B<cap_get_file>(3), "
2240 "B<cap_get_proc>(3), B<cap_init>(3), B<capgetp>(3), B<capsetp>(3), "
2241 "B<libcap>(3), B<credentials>(7), B<pthreads>(7), B<getcap>(8), B<setcap>(8)"
2242 msgstr ""
2243
2244 #. type: Plain text
2245 #: build/C/man7/capabilities.7:1161
2246 msgid "I<include/linux/capability.h> in the Linux kernel source tree"
2247 msgstr ""
2248
2249 #. type: TH
2250 #: build/C/man2/capget.2:15
2251 #, no-wrap
2252 msgid "CAPGET"
2253 msgstr ""
2254
2255 #. type: TH
2256 #: build/C/man2/capget.2:15
2257 #, no-wrap
2258 msgid "2013-03-11"
2259 msgstr ""
2260
2261 #. type: Plain text
2262 #: build/C/man2/capget.2:18
2263 msgid "capget, capset - set/get capabilities of thread(s)"
2264 msgstr ""
2265
2266 #. type: Plain text
2267 #: build/C/man2/capget.2:20
2268 msgid "B<#include E<lt>sys/capability.hE<gt>>"
2269 msgstr ""
2270
2271 #. type: Plain text
2272 #: build/C/man2/capget.2:22
2273 msgid "B<int capget(cap_user_header_t >I<hdrp>B<, cap_user_data_t >I<datap>B<);>"
2274 msgstr ""
2275
2276 #. type: Plain text
2277 #: build/C/man2/capget.2:24
2278 msgid ""
2279 "B<int capset(cap_user_header_t >I<hdrp>B<, const cap_user_data_t "
2280 ">I<datap>B<);>"
2281 msgstr ""
2282
2283 #. type: Plain text
2284 #: build/C/man2/capget.2:35
2285 msgid ""
2286 "As of Linux 2.2, the power of the superuser (root) has been partitioned into "
2287 "a set of discrete capabilities.  Each thread has a set of effective "
2288 "capabilities identifying which capabilities (if any) it may currently "
2289 "exercise.  Each thread also has a set of inheritable capabilities that may "
2290 "be passed through an B<execve>(2)  call, and a set of permitted capabilities "
2291 "that it can make effective or inheritable."
2292 msgstr ""
2293
2294 #. type: Plain text
2295 #: build/C/man2/capget.2:44
2296 msgid ""
2297 "These two system calls are the raw kernel interface for getting and setting "
2298 "thread capabilities.  Not only are these system calls specific to Linux, but "
2299 "the kernel API is likely to change and use of these system calls (in "
2300 "particular the format of the I<cap_user_*_t> types) is subject to extension "
2301 "with each kernel revision, but old programs will keep working."
2302 msgstr ""
2303
2304 #. type: Plain text
2305 #: build/C/man2/capget.2:55
2306 msgid ""
2307 "The portable interfaces are B<cap_set_proc>(3)  and B<cap_get_proc>(3); if "
2308 "possible you should use those interfaces in applications.  If you wish to "
2309 "use the Linux extensions in applications, you should use the easier-to-use "
2310 "interfaces B<capsetp>(3)  and B<capgetp>(3)."
2311 msgstr ""
2312
2313 #. type: SS
2314 #: build/C/man2/capget.2:55
2315 #, no-wrap
2316 msgid "Current details"
2317 msgstr ""
2318
2319 #. type: Plain text
2320 #: build/C/man2/capget.2:58
2321 msgid ""
2322 "Now that you have been warned, some current kernel details.  The structures "
2323 "are defined as follows."
2324 msgstr ""
2325
2326 #. type: Plain text
2327 #: build/C/man2/capget.2:63
2328 #, no-wrap
2329 msgid ""
2330 "#define _LINUX_CAPABILITY_VERSION_1  0x19980330\n"
2331 "#define _LINUX_CAPABILITY_U32S_1     1\n"
2332 msgstr ""
2333
2334 #. type: Plain text
2335 #: build/C/man2/capget.2:66
2336 #, no-wrap
2337 msgid ""
2338 "#define _LINUX_CAPABILITY_VERSION_2  0x20071026\n"
2339 "#define _LINUX_CAPABILITY_U32S_2     2\n"
2340 msgstr ""
2341
2342 #. type: Plain text
2343 #: build/C/man2/capget.2:71
2344 #, no-wrap
2345 msgid ""
2346 "typedef struct __user_cap_header_struct {\n"
2347 "   __u32 version;\n"
2348 "   int pid;\n"
2349 "} *cap_user_header_t;\n"
2350 msgstr ""
2351
2352 #. type: Plain text
2353 #: build/C/man2/capget.2:77
2354 #, no-wrap
2355 msgid ""
2356 "typedef struct __user_cap_data_struct {\n"
2357 "   __u32 effective;\n"
2358 "   __u32 permitted;\n"
2359 "   __u32 inheritable;\n"
2360 "} *cap_user_data_t;\n"
2361 msgstr ""
2362
2363 #. type: Plain text
2364 #: build/C/man2/capget.2:96
2365 msgid ""
2366 "The I<effective>, I<permitted>, and I<inheritable> fields are bit masks of "
2367 "the capabilities defined in I<capability(7).> Note the B<CAP_*> values are "
2368 "bit indexes and need to be bit-shifted before ORing into the bit fields.  To "
2369 "define the structures for passing to the system call you have to use the "
2370 "I<struct __user_cap_header_struct> and I<struct __user_cap_data_struct> "
2371 "names because the typedefs are only pointers."
2372 msgstr ""
2373
2374 #. type: Plain text
2375 #: build/C/man2/capget.2:108
2376 msgid ""
2377 "Kernels prior to 2.6.25 prefer 32-bit capabilities with version "
2378 "B<_LINUX_CAPABILITY_VERSION_1>, and kernels 2.6.25+ prefer 64-bit "
2379 "capabilities with version B<_LINUX_CAPABILITY_VERSION_2>.  Note, 64-bit "
2380 "capabilities use I<datap>[0] and I<datap>[1], whereas 32-bit capabilities "
2381 "use only I<datap>[0]."
2382 msgstr ""
2383
2384 #. type: Plain text
2385 #: build/C/man2/capget.2:112
2386 msgid ""
2387 "Another change affecting the behavior of these system calls is kernel "
2388 "support for file capabilities (VFS capability support).  This support is "
2389 "currently a compile time option (added in kernel 2.6.24)."
2390 msgstr ""
2391
2392 #. type: Plain text
2393 #: build/C/man2/capget.2:119
2394 msgid ""
2395 "For B<capget>()  calls, one can probe the capabilities of any process by "
2396 "specifying its process ID with the I<hdrp-E<gt>pid> field value."
2397 msgstr ""
2398
2399 #. type: SS
2400 #: build/C/man2/capget.2:119
2401 #, no-wrap
2402 msgid "With VFS capability support"
2403 msgstr ""
2404
2405 #. type: Plain text
2406 #: build/C/man2/capget.2:131
2407 msgid ""
2408 "VFS Capability support creates a file-attribute method for adding "
2409 "capabilities to privileged executables.  This privilege model obsoletes "
2410 "kernel support for one process asynchronously setting the capabilities of "
2411 "another.  That is, with VFS support, for B<capset>()  calls the only "
2412 "permitted values for I<hdrp-E<gt>pid> are 0 or B<getpid>(2), which are "
2413 "equivalent."
2414 msgstr ""
2415
2416 #. type: SS
2417 #: build/C/man2/capget.2:131
2418 #, no-wrap
2419 msgid "Without VFS capability support"
2420 msgstr ""
2421
2422 #. type: Plain text
2423 #: build/C/man2/capget.2:157
2424 msgid ""
2425 "When the kernel does not support VFS capabilities, B<capset>()  calls can "
2426 "operate on the capabilities of the thread specified by the I<pid> field of "
2427 "I<hdrp> when that is nonzero, or on the capabilities of the calling thread "
2428 "if I<pid> is 0.  If I<pid> refers to a single-threaded process, then I<pid> "
2429 "can be specified as a traditional process ID; operating on a thread of a "
2430 "multithreaded process requires a thread ID of the type returned by "
2431 "B<gettid>(2).  For B<capset>(), I<pid> can also be: -1, meaning perform the "
2432 "change on all threads except the caller and B<init>(8); or a value less than "
2433 "-1, in which case the change is applied to all members of the process group "
2434 "whose ID is -I<pid>."
2435 msgstr ""
2436
2437 #. type: Plain text
2438 #: build/C/man2/capget.2:160
2439 msgid "For details on the data, see B<capabilities>(7)."
2440 msgstr ""
2441
2442 #. type: Plain text
2443 #: build/C/man2/capget.2:179
2444 msgid ""
2445 "The calls will fail with the error B<EINVAL>, and set the I<version> field "
2446 "of I<hdrp> to the kernel preferred value of B<_LINUX_CAPABILITY_VERSION_?> "
2447 "when an unsupported I<version> value is specified.  In this way, one can "
2448 "probe what the current preferred capability revision is."
2449 msgstr ""
2450
2451 #. type: Plain text
2452 #: build/C/man2/capget.2:188
2453 msgid ""
2454 "Bad memory address.  I<hdrp> must not be NULL.  I<datap> may be NULL only "
2455 "when the user is trying to determine the preferred capability version format "
2456 "supported by the kernel."
2457 msgstr ""
2458
2459 #. type: TP
2460 #: build/C/man2/capget.2:188 build/C/man7/cpuset.7:1180 build/C/man7/cpuset.7:1189 build/C/man7/cpuset.7:1198 build/C/man7/cpuset.7:1208 build/C/man7/cpuset.7:1217 build/C/man7/cpuset.7:1224 build/C/man7/cpuset.7:1231 build/C/man2/getgroups.2:114 build/C/man2/getgroups.2:121 build/C/man2/getpriority.2:121 build/C/man2/getrlimit.2:440 build/C/man2/getrusage.2:191 build/C/man2/iopl.2:72 build/C/man2/ioprio_set.2:170 build/C/man2/setpgid.2:202
2461 #, no-wrap
2462 msgid "B<EINVAL>"
2463 msgstr ""
2464
2465 #. type: Plain text
2466 #: build/C/man2/capget.2:191
2467 msgid "One of the arguments was invalid."
2468 msgstr ""
2469
2470 #. type: Plain text
2471 #: build/C/man2/capget.2:196
2472 msgid ""
2473 "An attempt was made to add a capability to the Permitted set, or to set a "
2474 "capability in the Effective or Inheritable sets that is not in the Permitted "
2475 "set."
2476 msgstr ""
2477
2478 #. type: Plain text
2479 #: build/C/man2/capget.2:215
2480 msgid ""
2481 "The caller attempted to use B<capset>()  to modify the capabilities of a "
2482 "thread other than itself, but lacked sufficient privilege.  For kernels "
2483 "supporting VFS capabilities, this is never permitted.  For kernels lacking "
2484 "VFS support, the B<CAP_SETPCAP> capability is required.  (A bug in kernels "
2485 "before 2.6.11 meant that this error could also occur if a thread without "
2486 "this capability tried to change its own capabilities by specifying the "
2487 "I<pid> field as a nonzero value (i.e., the value returned by B<getpid>(2))  "
2488 "instead of 0.)"
2489 msgstr ""
2490
2491 #. type: TP
2492 #: build/C/man2/capget.2:215 build/C/man7/cpuset.7:1330 build/C/man2/getpriority.2:129 build/C/man2/getrlimit.2:464 build/C/man2/getsid.2:70 build/C/man2/ioprio_set.2:187 build/C/man2/setpgid.2:217
2493 #, no-wrap
2494 msgid "B<ESRCH>"
2495 msgstr ""
2496
2497 #. type: Plain text
2498 #: build/C/man2/capget.2:218
2499 msgid "No such thread."
2500 msgstr ""
2501
2502 #. type: Plain text
2503 #: build/C/man2/capget.2:220 build/C/man2/ioprio_set.2:198
2504 msgid "These system calls are Linux-specific."
2505 msgstr ""
2506
2507 #. type: Plain text
2508 #: build/C/man2/capget.2:225
2509 msgid ""
2510 "The portable interface to the capability querying and setting functions is "
2511 "provided by the I<libcap> library and is available here:"
2512 msgstr ""
2513
2514 #. type: Plain text
2515 #: build/C/man2/capget.2:228
2516 msgid ""
2517 "E<.UR "
2518 "http://git.kernel.org/cgit\\:/linux\\:/kernel\\:/git\\:/morgan\\:\\:/libcap.git> "
2519 "E<.UE>"
2520 msgstr ""
2521
2522 #. type: Plain text
2523 #: build/C/man2/capget.2:232
2524 msgid "B<clone>(2), B<gettid>(2), B<capabilities>(7)"
2525 msgstr ""
2526
2527 #. type: TH
2528 #: build/C/man7/cpuset.7:25
2529 #, no-wrap
2530 msgid "CPUSET"
2531 msgstr ""
2532
2533 #. type: TH
2534 #: build/C/man7/cpuset.7:25 build/C/man2/getpriority.2:48 build/C/man2/ioprio_set.2:24 build/C/man7/svipc.7:40
2535 #, no-wrap
2536 msgid "2013-02-12"
2537 msgstr ""
2538
2539 #. type: Plain text
2540 #: build/C/man7/cpuset.7:28
2541 msgid "cpuset - confine processes to processor and memory node subsets"
2542 msgstr ""
2543
2544 #. type: Plain text
2545 #: build/C/man7/cpuset.7:35
2546 msgid ""
2547 "The cpuset filesystem is a pseudo-filesystem interface to the kernel cpuset "
2548 "mechanism, which is used to control the processor placement and memory "
2549 "placement of processes.  It is commonly mounted at I</dev/cpuset>."
2550 msgstr ""
2551
2552 #. type: Plain text
2553 #: build/C/man7/cpuset.7:52
2554 msgid ""
2555 "On systems with kernels compiled with built in support for cpusets, all "
2556 "processes are attached to a cpuset, and cpusets are always present.  If a "
2557 "system supports cpusets, then it will have the entry B<nodev cpuset> in the "
2558 "file I</proc/filesystems>.  By mounting the cpuset filesystem (see the "
2559 "B<EXAMPLE> section below), the administrator can configure the cpusets on a "
2560 "system to control the processor and memory placement of processes on that "
2561 "system.  By default, if the cpuset configuration on a system is not modified "
2562 "or if the cpuset filesystem is not even mounted, then the cpuset mechanism, "
2563 "though present, has no affect on the system's behavior."
2564 msgstr ""
2565
2566 #. type: Plain text
2567 #: build/C/man7/cpuset.7:54
2568 msgid "A cpuset defines a list of CPUs and memory nodes."
2569 msgstr ""
2570
2571 #. type: Plain text
2572 #: build/C/man7/cpuset.7:63
2573 msgid ""
2574 "The CPUs of a system include all the logical processing units on which a "
2575 "process can execute, including, if present, multiple processor cores within "
2576 "a package and Hyper-Threads within a processor core.  Memory nodes include "
2577 "all distinct banks of main memory; small and SMP systems typically have just "
2578 "one memory node that contains all the system's main memory, while NUMA "
2579 "(non-uniform memory access) systems have multiple memory nodes."
2580 msgstr ""
2581
2582 #. type: Plain text
2583 #: build/C/man7/cpuset.7:73
2584 msgid ""
2585 "Cpusets are represented as directories in a hierarchical pseudo-filesystem, "
2586 "where the top directory in the hierarchy (I</dev/cpuset>)  represents the "
2587 "entire system (all online CPUs and memory nodes)  and any cpuset that is the "
2588 "child (descendant) of another parent cpuset contains a subset of that "
2589 "parent's CPUs and memory nodes.  The directories and files representing "
2590 "cpusets have normal filesystem permissions."
2591 msgstr ""
2592
2593 #. type: Plain text
2594 #: build/C/man7/cpuset.7:84
2595 msgid ""
2596 "Every process in the system belongs to exactly one cpuset.  A process is "
2597 "confined to run only on the CPUs in the cpuset it belongs to, and to "
2598 "allocate memory only on the memory nodes in that cpuset.  When a process "
2599 "B<fork>(2)s, the child process is placed in the same cpuset as its parent.  "
2600 "With sufficient privilege, a process may be moved from one cpuset to another "
2601 "and the allowed CPUs and memory nodes of an existing cpuset may be changed."
2602 msgstr ""
2603
2604 #. type: Plain text
2605 #: build/C/man7/cpuset.7:92
2606 msgid ""
2607 "When the system begins booting, a single cpuset is defined that includes all "
2608 "CPUs and memory nodes on the system, and all processes are in that cpuset.  "
2609 "During the boot process, or later during normal system operation, other "
2610 "cpusets may be created, as subdirectories of this top cpuset, under the "
2611 "control of the system administrator, and processes may be placed in these "
2612 "other cpusets."
2613 msgstr ""
2614
2615 #. type: Plain text
2616 #: build/C/man7/cpuset.7:114
2617 msgid ""
2618 "Cpusets are integrated with the B<sched_setaffinity>(2)  scheduling affinity "
2619 "mechanism and the B<mbind>(2)  and B<set_mempolicy>(2)  memory-placement "
2620 "mechanisms in the kernel.  Neither of these mechanisms let a process make "
2621 "use of a CPU or memory node that is not allowed by that process's cpuset.  "
2622 "If changes to a process's cpuset placement conflict with these other "
2623 "mechanisms, then cpuset placement is enforced even if it means overriding "
2624 "these other mechanisms.  The kernel accomplishes this overriding by silently "
2625 "restricting the CPUs and memory nodes requested by these other mechanisms to "
2626 "those allowed by the invoking process's cpuset.  This can result in these "
2627 "other calls returning an error, if for example, such a call ends up "
2628 "requesting an empty set of CPUs or memory nodes, after that request is "
2629 "restricted to the invoking process's cpuset."
2630 msgstr ""
2631
2632 #. type: Plain text
2633 #: build/C/man7/cpuset.7:120
2634 msgid ""
2635 "Typically, a cpuset is used to manage the CPU and memory-node confinement "
2636 "for a set of cooperating processes such as a batch scheduler job, and these "
2637 "other mechanisms are used to manage the placement of individual processes or "
2638 "memory regions within that set or job."
2639 msgstr ""
2640
2641 #. type: SH
2642 #: build/C/man7/cpuset.7:120
2643 #, no-wrap
2644 msgid "FILES"
2645 msgstr ""
2646
2647 #. type: Plain text
2648 #: build/C/man7/cpuset.7:125
2649 msgid ""
2650 "Each directory below I</dev/cpuset> represents a cpuset and contains a fixed "
2651 "set of pseudo-files describing the state of that cpuset."
2652 msgstr ""
2653
2654 #. type: Plain text
2655 #: build/C/man7/cpuset.7:135
2656 msgid ""
2657 "New cpusets are created using the B<mkdir>(2)  system call or the "
2658 "B<mkdir>(1)  command.  The properties of a cpuset, such as its flags, "
2659 "allowed CPUs and memory nodes, and attached processes, are queried and "
2660 "modified by reading or writing to the appropriate file in that cpuset's "
2661 "directory, as listed below."
2662 msgstr ""
2663
2664 #. type: Plain text
2665 #: build/C/man7/cpuset.7:141
2666 msgid ""
2667 "The pseudo-files in each cpuset directory are automatically created when the "
2668 "cpuset is created, as a result of the B<mkdir>(2)  invocation.  It is not "
2669 "possible to directly add or remove these pseudo-files."
2670 msgstr ""
2671
2672 #. type: Plain text
2673 #: build/C/man7/cpuset.7:149
2674 msgid ""
2675 "A cpuset directory that contains no child cpuset directories, and has no "
2676 "attached processes, can be removed using B<rmdir>(2)  or B<rmdir>(1).  It is "
2677 "not necessary, or possible, to remove the pseudo-files inside the directory "
2678 "before removing it."
2679 msgstr ""
2680
2681 #. type: Plain text
2682 #: build/C/man7/cpuset.7:163
2683 msgid ""
2684 "The pseudo-files in each cpuset directory are small text files that may be "
2685 "read and written using traditional shell utilities such as B<cat>(1), and "
2686 "B<echo>(1), or from a program by using file I/O library functions or system "
2687 "calls, such as B<open>(2), B<read>(2), B<write>(2), and B<close>(2)."
2688 msgstr ""
2689
2690 #.  ====================== tasks ======================
2691 #. type: Plain text
2692 #: build/C/man7/cpuset.7:168
2693 msgid ""
2694 "The pseudo-files in a cpuset directory represent internal kernel state and "
2695 "do not have any persistent image on disk.  Each of these per-cpuset files is "
2696 "listed and described below."
2697 msgstr ""
2698
2699 #. type: TP
2700 #: build/C/man7/cpuset.7:168
2701 #, no-wrap
2702 msgid "I<tasks>"
2703 msgstr ""
2704
2705 #. type: Plain text
2706 #: build/C/man7/cpuset.7:178
2707 msgid ""
2708 "List of the process IDs (PIDs) of the processes in that cpuset.  The list is "
2709 "formatted as a series of ASCII decimal numbers, each followed by a newline.  "
2710 "A process may be added to a cpuset (automatically removing it from the "
2711 "cpuset that previously contained it) by writing its PID to that cpuset's "
2712 "I<tasks> file (with or without a trailing newline.)"
2713 msgstr ""
2714
2715 #.  =================== notify_on_release ===================
2716 #. type: Plain text
2717 #: build/C/man7/cpuset.7:186
2718 msgid ""
2719 "B<Warning:> only one PID may be written to the I<tasks> file at a time.  If "
2720 "a string is written that contains more than one PID, only the first one will "
2721 "be used."
2722 msgstr ""
2723
2724 #. type: TP
2725 #: build/C/man7/cpuset.7:186
2726 #, no-wrap
2727 msgid "I<notify_on_release>"
2728 msgstr ""
2729
2730 #.  ====================== cpus ======================
2731 #. type: Plain text
2732 #: build/C/man7/cpuset.7:195
2733 msgid ""
2734 "Flag (0 or 1).  If set (1), that cpuset will receive special handling after "
2735 "it is released, that is, after all processes cease using it (i.e., terminate "
2736 "or are moved to a different cpuset)  and all child cpuset directories have "
2737 "been removed.  See the B<Notify On Release> section, below."
2738 msgstr ""
2739
2740 #. type: TP
2741 #: build/C/man7/cpuset.7:195
2742 #, no-wrap
2743 msgid "I<cpuset.cpus>"
2744 msgstr ""
2745
2746 #. type: Plain text
2747 #: build/C/man7/cpuset.7:202
2748 msgid ""
2749 "List of the physical numbers of the CPUs on which processes in that cpuset "
2750 "are allowed to execute.  See B<List Format> below for a description of the "
2751 "format of I<cpus>."
2752 msgstr ""
2753
2754 #.  ==================== cpu_exclusive ====================
2755 #. type: Plain text
2756 #: build/C/man7/cpuset.7:208
2757 msgid ""
2758 "The CPUs allowed to a cpuset may be changed by writing a new list to its "
2759 "I<cpus> file."
2760 msgstr ""
2761
2762 #. type: TP
2763 #: build/C/man7/cpuset.7:208
2764 #, no-wrap
2765 msgid "I<cpuset.cpu_exclusive>"
2766 msgstr ""
2767
2768 #. type: Plain text
2769 #: build/C/man7/cpuset.7:215
2770 msgid ""
2771 "Flag (0 or 1).  If set (1), the cpuset has exclusive use of its CPUs (no "
2772 "sibling or cousin cpuset may overlap CPUs).  By default this is off (0).  "
2773 "Newly created cpusets also initially default this to off (0)."
2774 msgstr ""
2775
2776 #.  ====================== mems ======================
2777 #. type: Plain text
2778 #: build/C/man7/cpuset.7:237
2779 msgid ""
2780 "Two cpusets are I<sibling> cpusets if they share the same parent cpuset in "
2781 "the I</dev/cpuset> hierarchy.  Two cpusets are I<cousin> cpusets if neither "
2782 "is the ancestor of the other.  Regardless of the I<cpu_exclusive> setting, "
2783 "if one cpuset is the ancestor of another, and if both of these cpusets have "
2784 "nonempty I<cpus>, then their I<cpus> must overlap, because the I<cpus> of "
2785 "any cpuset are always a subset of the I<cpus> of its parent cpuset."
2786 msgstr ""
2787
2788 #. type: TP
2789 #: build/C/man7/cpuset.7:237
2790 #, no-wrap
2791 msgid "I<cpuset.mems>"
2792 msgstr ""
2793
2794 #.  ==================== mem_exclusive ====================
2795 #. type: Plain text
2796 #: build/C/man7/cpuset.7:245
2797 msgid ""
2798 "List of memory nodes on which processes in this cpuset are allowed to "
2799 "allocate memory.  See B<List Format> below for a description of the format "
2800 "of I<mems>."
2801 msgstr ""
2802
2803 #. type: TP
2804 #: build/C/man7/cpuset.7:245
2805 #, no-wrap
2806 msgid "I<cpuset.mem_exclusive>"
2807 msgstr ""
2808
2809 #. type: Plain text
2810 #: build/C/man7/cpuset.7:253
2811 msgid ""
2812 "Flag (0 or 1).  If set (1), the cpuset has exclusive use of its memory nodes "
2813 "(no sibling or cousin may overlap).  Also if set (1), the cpuset is a "
2814 "B<Hardwall> cpuset (see below.)  By default this is off (0).  Newly created "
2815 "cpusets also initially default this to off (0)."
2816 msgstr ""
2817
2818 #.  ==================== mem_hardwall ====================
2819 #. type: Plain text
2820 #: build/C/man7/cpuset.7:261
2821 msgid ""
2822 "Regardless of the I<mem_exclusive> setting, if one cpuset is the ancestor of "
2823 "another, then their memory nodes must overlap, because the memory nodes of "
2824 "any cpuset are always a subset of the memory nodes of that cpuset's parent "
2825 "cpuset."
2826 msgstr ""
2827
2828 #. type: TP
2829 #: build/C/man7/cpuset.7:261
2830 #, no-wrap
2831 msgid "I<cpuset.mem_hardwall> (since Linux 2.6.26)"
2832 msgstr ""
2833
2834 #.  ==================== memory_migrate ====================
2835 #. type: Plain text
2836 #: build/C/man7/cpuset.7:272
2837 msgid ""
2838 "Flag (0 or 1).  If set (1), the cpuset is a B<Hardwall> cpuset (see below.)  "
2839 "Unlike B<mem_exclusive>, there is no constraint on whether cpusets marked "
2840 "B<mem_hardwall> may have overlapping memory nodes with sibling or cousin "
2841 "cpusets.  By default this is off (0).  Newly created cpusets also initially "
2842 "default this to off (0)."
2843 msgstr ""
2844
2845 #. type: TP
2846 #: build/C/man7/cpuset.7:272
2847 #, no-wrap
2848 msgid "I<cpuset.memory_migrate> (since Linux 2.6.16)"
2849 msgstr ""
2850
2851 #.  ==================== memory_pressure ====================
2852 #. type: Plain text
2853 #: build/C/man7/cpuset.7:279
2854 msgid ""
2855 "Flag (0 or 1).  If set (1), then memory migration is enabled.  By default "
2856 "this is off (0).  See the B<Memory Migration> section, below."
2857 msgstr ""
2858
2859 #. type: TP
2860 #: build/C/man7/cpuset.7:279
2861 #, no-wrap
2862 msgid "I<cpuset.memory_pressure> (since Linux 2.6.16)"
2863 msgstr ""
2864
2865 #.  ================= memory_pressure_enabled =================
2866 #. type: Plain text
2867 #: build/C/man7/cpuset.7:292
2868 msgid ""
2869 "A measure of how much memory pressure the processes in this cpuset are "
2870 "causing.  See the B<Memory Pressure> section, below.  Unless "
2871 "I<memory_pressure_enabled> is enabled, always has value zero (0).  This file "
2872 "is read-only.  See the B<WARNINGS> section, below."
2873 msgstr ""
2874
2875 #. type: TP
2876 #: build/C/man7/cpuset.7:292
2877 #, no-wrap
2878 msgid "I<cpuset.memory_pressure_enabled> (since Linux 2.6.16)"
2879 msgstr ""
2880
2881 #.  ================== memory_spread_page ==================
2882 #. type: Plain text
2883 #: build/C/man7/cpuset.7:304
2884 msgid ""
2885 "Flag (0 or 1).  This file is present only in the root cpuset, normally "
2886 "I</dev/cpuset>.  If set (1), the I<memory_pressure> calculations are enabled "
2887 "for all cpusets in the system.  By default this is off (0).  See the "
2888 "B<Memory Pressure> section, below."
2889 msgstr ""
2890
2891 #. type: TP
2892 #: build/C/man7/cpuset.7:304
2893 #, no-wrap
2894 msgid "I<cpuset.memory_spread_page> (since Linux 2.6.17)"
2895 msgstr ""
2896
2897 #.  ================== memory_spread_slab ==================
2898 #. type: Plain text
2899 #: build/C/man7/cpuset.7:314
2900 msgid ""
2901 "Flag (0 or 1).  If set (1), pages in the kernel page cache (filesystem "
2902 "buffers) are uniformly spread across the cpuset.  By default this is off (0) "
2903 "in the top cpuset, and inherited from the parent cpuset in newly created "
2904 "cpusets.  See the B<Memory Spread> section, below."
2905 msgstr ""
2906
2907 #. type: TP
2908 #: build/C/man7/cpuset.7:314
2909 #, no-wrap
2910 msgid "I<cpuset.memory_spread_slab> (since Linux 2.6.17)"
2911 msgstr ""
2912
2913 #.  ================== sched_load_balance ==================
2914 #. type: Plain text
2915 #: build/C/man7/cpuset.7:325
2916 msgid ""
2917 "Flag (0 or 1).  If set (1), the kernel slab caches for file I/O (directory "
2918 "and inode structures) are uniformly spread across the cpuset.  By default "
2919 "this is off (0) in the top cpuset, and inherited from the parent cpuset in "
2920 "newly created cpusets.  See the B<Memory Spread> section, below."
2921 msgstr ""
2922
2923 #. type: TP
2924 #: build/C/man7/cpuset.7:325
2925 #, no-wrap
2926 msgid "I<cpuset.sched_load_balance> (since Linux 2.6.24)"
2927 msgstr ""
2928
2929 #.  ================== sched_relax_domain_level ==================
2930 #. type: Plain text
2931 #: build/C/man7/cpuset.7:339
2932 msgid ""
2933 "Flag (0 or 1).  If set (1, the default) the kernel will automatically load "
2934 "balance processes in that cpuset over the allowed CPUs in that cpuset.  If "
2935 "cleared (0) the kernel will avoid load balancing processes in this cpuset, "
2936 "I<unless> some other cpuset with overlapping CPUs has its "
2937 "I<sched_load_balance> flag set.  See B<Scheduler Load Balancing>, below, for "
2938 "further details."
2939 msgstr ""
2940
2941 #. type: TP
2942 #: build/C/man7/cpuset.7:339
2943 #, no-wrap
2944 msgid "I<cpuset.sched_relax_domain_level> (since Linux 2.6.26)"
2945 msgstr ""
2946
2947 #.  ================== proc cpuset ==================
2948 #. type: Plain text
2949 #: build/C/man7/cpuset.7:359
2950 msgid ""
2951 "Integer, between -1 and a small positive value.  The "
2952 "I<sched_relax_domain_level> controls the width of the range of CPUs over "
2953 "which the kernel scheduler performs immediate rebalancing of runnable tasks "
2954 "across CPUs.  If I<sched_load_balance> is disabled, then the setting of "
2955 "I<sched_relax_domain_level> does not matter, as no such load balancing is "
2956 "done.  If I<sched_load_balance> is enabled, then the higher the value of the "
2957 "I<sched_relax_domain_level>, the wider the range of CPUs over which "
2958 "immediate load balancing is attempted.  See B<Scheduler Relax Domain Level>, "
2959 "below, for further details."
2960 msgstr ""
2961
2962 #.  ================== proc status ==================
2963 #. type: Plain text
2964 #: build/C/man7/cpuset.7:367
2965 msgid ""
2966 "In addition to the above pseudo-files in each directory below "
2967 "I</dev/cpuset>, each process has a pseudo-file, "
2968 "I</proc/E<lt>pidE<gt>/cpuset>, that displays the path of the process's "
2969 "cpuset directory relative to the root of the cpuset filesystem."
2970 msgstr ""
2971
2972 #. type: Plain text
2973 #: build/C/man7/cpuset.7:378
2974 msgid ""
2975 "Also the I</proc/E<lt>pidE<gt>/status> file for each process has four added "
2976 "lines, displaying the process's I<Cpus_allowed> (on which CPUs it may be "
2977 "scheduled) and I<Mems_allowed> (on which memory nodes it may obtain memory), "
2978 "in the two formats B<Mask Format> and B<List Format> (see below)  as shown "
2979 "in the following example:"
2980 msgstr ""
2981
2982 #. type: Plain text
2983 #: build/C/man7/cpuset.7:385
2984 #, no-wrap
2985 msgid ""
2986 "Cpus_allowed:   ffffffff,ffffffff,ffffffff,ffffffff\n"
2987 "Cpus_allowed_list:     0-127\n"
2988 "Mems_allowed:   ffffffff,ffffffff\n"
2989 "Mems_allowed_list:     0-63\n"
2990 msgstr ""
2991
2992 #.  ================== EXTENDED CAPABILITIES ==================
2993 #. type: Plain text
2994 #: build/C/man7/cpuset.7:391
2995 msgid ""
2996 "The \"allowed\" fields were added in Linux 2.6.24; the \"allowed_list\" "
2997 "fields were added in Linux 2.6.26."
2998 msgstr ""
2999
3000 #. type: SH
3001 #: build/C/man7/cpuset.7:391
3002 #, no-wrap
3003 msgid "EXTENDED CAPABILITIES"
3004 msgstr ""
3005
3006 #.  ================== Exclusive Cpusets ==================
3007 #. type: Plain text
3008 #: build/C/man7/cpuset.7:399
3009 msgid ""
3010 "In addition to controlling which I<cpus> and I<mems> a process is allowed to "
3011 "use, cpusets provide the following extended capabilities."
3012 msgstr ""
3013
3014 #. type: SS
3015 #: build/C/man7/cpuset.7:399
3016 #, no-wrap
3017 msgid "Exclusive cpusets"
3018 msgstr ""
3019
3020 #. type: Plain text
3021 #: build/C/man7/cpuset.7:406
3022 msgid ""
3023 "If a cpuset is marked I<cpu_exclusive> or I<mem_exclusive>, no other cpuset, "
3024 "other than a direct ancestor or descendant, may share any of the same CPUs "
3025 "or memory nodes."
3026 msgstr ""
3027
3028 #.  ================== Hardwall ==================
3029 #. type: Plain text
3030 #: build/C/man7/cpuset.7:432
3031 msgid ""
3032 "A cpuset that is I<mem_exclusive> restricts kernel allocations for buffer "
3033 "cache pages and other internal kernel data pages commonly shared by the "
3034 "kernel across multiple users.  All cpusets, whether I<mem_exclusive> or not, "
3035 "restrict allocations of memory for user space.  This enables configuring a "
3036 "system so that several independent jobs can share common kernel data, while "
3037 "isolating each job's user allocation in its own cpuset.  To do this, "
3038 "construct a large I<mem_exclusive> cpuset to hold all the jobs, and "
3039 "construct child, non-I<mem_exclusive> cpusets for each individual job.  Only "
3040 "a small amount of kernel memory, such as requests from interrupt handlers, "
3041 "is allowed to be placed on memory nodes outside even a I<mem_exclusive> "
3042 "cpuset."
3043 msgstr ""
3044
3045 #. type: SS
3046 #: build/C/man7/cpuset.7:432
3047 #, no-wrap
3048 msgid "Hardwall"
3049 msgstr ""
3050
3051 #. type: Plain text
3052 #: build/C/man7/cpuset.7:447
3053 msgid ""
3054 "A cpuset that has I<mem_exclusive> or I<mem_hardwall> set is a I<hardwall> "
3055 "cpuset.  A I<hardwall> cpuset restricts kernel allocations for page, buffer, "
3056 "and other data commonly shared by the kernel across multiple users.  All "
3057 "cpusets, whether I<hardwall> or not, restrict allocations of memory for user "
3058 "space."
3059 msgstr ""
3060
3061 #. type: Plain text
3062 #: build/C/man7/cpuset.7:458
3063 msgid ""
3064 "This enables configuring a system so that several independent jobs can share "
3065 "common kernel data, such as filesystem pages, while isolating each job's "
3066 "user allocation in its own cpuset.  To do this, construct a large "
3067 "I<hardwall> cpuset to hold all the jobs, and construct child cpusets for "
3068 "each individual job which are not I<hardwall> cpusets."
3069 msgstr ""
3070
3071 #.  ================== Notify On Release ==================
3072 #. type: Plain text
3073 #: build/C/man7/cpuset.7:464
3074 msgid ""
3075 "Only a small amount of kernel memory, such as requests from interrupt "
3076 "handlers, is allowed to be taken outside even a I<hardwall> cpuset."
3077 msgstr ""
3078
3079 #. type: SS
3080 #: build/C/man7/cpuset.7:464
3081 #, no-wrap
3082 msgid "Notify on release"
3083 msgstr ""
3084
3085 #. type: Plain text
3086 #: build/C/man7/cpuset.7:476
3087 msgid ""
3088 "If the I<notify_on_release> flag is enabled (1) in a cpuset, then whenever "
3089 "the last process in the cpuset leaves (exits or attaches to some other "
3090 "cpuset)  and the last child cpuset of that cpuset is removed, the kernel "
3091 "will run the command I</sbin/cpuset_release_agent>, supplying the pathname "
3092 "(relative to the mount point of the cpuset filesystem) of the abandoned "
3093 "cpuset.  This enables automatic removal of abandoned cpusets."
3094 msgstr ""
3095
3096 #. type: Plain text
3097 #: build/C/man7/cpuset.7:484
3098 msgid ""
3099 "The default value of I<notify_on_release> in the root cpuset at system boot "
3100 "is disabled (0).  The default value of other cpusets at creation is the "
3101 "current value of their parent's I<notify_on_release> setting."
3102 msgstr ""
3103
3104 #. type: Plain text
3105 #: build/C/man7/cpuset.7:492
3106 msgid ""
3107 "The command I</sbin/cpuset_release_agent> is invoked, with the name "
3108 "(I</dev/cpuset> relative path)  of the to-be-released cpuset in I<argv[1]>."
3109 msgstr ""
3110
3111 #. type: Plain text
3112 #: build/C/man7/cpuset.7:496
3113 msgid ""
3114 "The usual contents of the command I</sbin/cpuset_release_agent> is simply "
3115 "the shell script:"
3116 msgstr ""
3117
3118 #. type: Plain text
3119 #: build/C/man7/cpuset.7:501
3120 #, no-wrap
3121 msgid ""
3122 "#!/bin/sh\n"
3123 "rmdir /dev/cpuset/$1\n"
3124 msgstr ""
3125
3126 #.  ================== Memory Pressure ==================
3127 #. type: Plain text
3128 #: build/C/man7/cpuset.7:509
3129 msgid ""
3130 "As with other flag values below, this flag can be changed by writing an "
3131 "ASCII number 0 or 1 (with optional trailing newline)  into the file, to "
3132 "clear or set the flag, respectively."
3133 msgstr ""
3134
3135 #. type: SS
3136 #: build/C/man7/cpuset.7:509
3137 #, no-wrap
3138 msgid "Memory pressure"
3139 msgstr ""
3140
3141 #. type: Plain text
3142 #: build/C/man7/cpuset.7:515
3143 msgid ""
3144 "The I<memory_pressure> of a cpuset provides a simple per-cpuset running "
3145 "average of the rate that the processes in a cpuset are attempting to free up "
3146 "in-use memory on the nodes of the cpuset to satisfy additional memory "
3147 "requests."
3148 msgstr ""
3149
3150 #. type: Plain text
3151 #: build/C/man7/cpuset.7:519
3152 msgid ""
3153 "This enables batch managers that are monitoring jobs running in dedicated "
3154 "cpusets to efficiently detect what level of memory pressure that job is "
3155 "causing."
3156 msgstr ""
3157
3158 #. type: Plain text
3159 #: build/C/man7/cpuset.7:526
3160 msgid ""
3161 "This is useful both on tightly managed systems running a wide mix of "
3162 "submitted jobs, which may choose to terminate or reprioritize jobs that are "
3163 "trying to use more memory than allowed on the nodes assigned them, and with "
3164 "tightly coupled, long-running, massively parallel scientific computing jobs "
3165 "that will dramatically fail to meet required performance goals if they start "
3166 "to use more memory than allowed to them."
3167 msgstr ""
3168
3169 #. type: Plain text
3170 #: build/C/man7/cpuset.7:531
3171 msgid ""
3172 "This mechanism provides a very economical way for the batch manager to "
3173 "monitor a cpuset for signs of memory pressure.  It's up to the batch manager "
3174 "or other user code to decide what action to take if it detects signs of "
3175 "memory pressure."
3176 msgstr ""
3177
3178 #. type: Plain text
3179 #: build/C/man7/cpuset.7:538
3180 msgid ""
3181 "Unless memory pressure calculation is enabled by setting the pseudo-file "
3182 "I</dev/cpuset/cpuset.memory_pressure_enabled>, it is not computed for any "
3183 "cpuset, and reads from any I<memory_pressure> always return zero, as "
3184 "represented by the ASCII string \"0\\en\".  See the B<WARNINGS> section, "
3185 "below."
3186 msgstr ""
3187
3188 #. type: Plain text
3189 #: build/C/man7/cpuset.7:540
3190 msgid "A per-cpuset, running average is employed for the following reasons:"
3191 msgstr ""
3192
3193 #. type: Plain text
3194 #: build/C/man7/cpuset.7:545
3195 msgid ""
3196 "Because this meter is per-cpuset rather than per-process or per virtual "
3197 "memory region, the system load imposed by a batch scheduler monitoring this "
3198 "metric is sharply reduced on large systems, because a scan of the tasklist "
3199 "can be avoided on each set of queries."
3200 msgstr ""
3201
3202 #. type: Plain text
3203 #: build/C/man7/cpuset.7:550
3204 msgid ""
3205 "Because this meter is a running average rather than an accumulating counter, "
3206 "a batch scheduler can detect memory pressure with a single read, instead of "
3207 "having to read and accumulate results for a period of time."
3208 msgstr ""
3209
3210 #. type: Plain text
3211 #: build/C/man7/cpuset.7:556
3212 msgid ""
3213 "Because this meter is per-cpuset rather than per-process, the batch "
3214 "scheduler can obtain the key information\\(emmemory pressure in a "
3215 "cpuset\\(emwith a single read, rather than having to query and accumulate "
3216 "results over all the (dynamically changing)  set of processes in the cpuset."
3217 msgstr ""
3218
3219 #. type: Plain text
3220 #: build/C/man7/cpuset.7:564
3221 msgid ""
3222 "The I<memory_pressure> of a cpuset is calculated using a per-cpuset simple "
3223 "digital filter that is kept within the kernel.  For each cpuset, this filter "
3224 "tracks the recent rate at which processes attached to that cpuset enter the "
3225 "kernel direct reclaim code."
3226 msgstr ""
3227
3228 #. type: Plain text
3229 #: build/C/man7/cpuset.7:573
3230 msgid ""
3231 "The kernel direct reclaim code is entered whenever a process has to satisfy "
3232 "a memory page request by first finding some other page to repurpose, due to "
3233 "lack of any readily available already free pages.  Dirty filesystem pages "
3234 "are repurposed by first writing them to disk.  Unmodified filesystem buffer "
3235 "pages are repurposed by simply dropping them, though if that page is needed "
3236 "again, it will have to be reread from disk."
3237 msgstr ""
3238
3239 #.  ================== Memory Spread ==================
3240 #. type: Plain text
3241 #: build/C/man7/cpuset.7:581
3242 msgid ""
3243 "The I<cpuset.memory_pressure> file provides an integer number representing "
3244 "the recent (half-life of 10 seconds) rate of entries to the direct reclaim "
3245 "code caused by any process in the cpuset, in units of reclaims attempted per "
3246 "second, times 1000."
3247 msgstr ""
3248
3249 #. type: SS
3250 #: build/C/man7/cpuset.7:581
3251 #, no-wrap
3252 msgid "Memory spread"
3253 msgstr ""
3254
3255 #. type: Plain text
3256 #: build/C/man7/cpuset.7:589
3257 msgid ""
3258 "There are two Boolean flag files per cpuset that control where the kernel "
3259 "allocates pages for the filesystem buffers and related in-kernel data "
3260 "structures.  They are called I<cpuset.memory_spread_page> and "
3261 "I<cpuset.memory_spread_slab>."
3262 msgstr ""
3263
3264 #. type: Plain text
3265 #: build/C/man7/cpuset.7:596
3266 msgid ""
3267 "If the per-cpuset Boolean flag file I<cpuset.memory_spread_page> is set, "
3268 "then the kernel will spread the filesystem buffers (page cache) evenly over "
3269 "all the nodes that the faulting process is allowed to use, instead of "
3270 "preferring to put those pages on the node where the process is running."
3271 msgstr ""
3272
3273 #. type: Plain text
3274 #: build/C/man7/cpuset.7:604
3275 msgid ""
3276 "If the per-cpuset Boolean flag file I<cpuset.memory_spread_slab> is set, "
3277 "then the kernel will spread some filesystem-related slab caches, such as "
3278 "those for inodes and directory entries, evenly over all the nodes that the "
3279 "faulting process is allowed to use, instead of preferring to put those pages "
3280 "on the node where the process is running."
3281 msgstr ""
3282
3283 #. type: Plain text
3284 #: build/C/man7/cpuset.7:609
3285 msgid ""
3286 "The setting of these flags does not affect the data segment (see B<brk>(2))  "
3287 "or stack segment pages of a process."
3288 msgstr ""
3289
3290 #. type: Plain text
3291 #: build/C/man7/cpuset.7:617
3292 msgid ""
3293 "By default, both kinds of memory spreading are off and the kernel prefers to "
3294 "allocate memory pages on the node local to where the requesting process is "
3295 "running.  If that node is not allowed by the process's NUMA memory policy or "
3296 "cpuset configuration or if there are insufficient free memory pages on that "
3297 "node, then the kernel looks for the nearest node that is allowed and has "
3298 "sufficient free memory."
3299 msgstr ""
3300
3301 #. type: Plain text
3302 #: build/C/man7/cpuset.7:620
3303 msgid ""
3304 "When new cpusets are created, they inherit the memory spread settings of "
3305 "their parent."
3306 msgstr ""
3307
3308 #. type: Plain text
3309 #: build/C/man7/cpuset.7:635
3310 msgid ""
3311 "Setting memory spreading causes allocations for the affected page or slab "
3312 "caches to ignore the process's NUMA memory policy and be spread instead.  "
3313 "However, the effect of these changes in memory placement caused by "
3314 "cpuset-specified memory spreading is hidden from the B<mbind>(2)  or "
3315 "B<set_mempolicy>(2)  calls.  These two NUMA memory policy calls always "
3316 "appear to behave as if no cpuset-specified memory spreading is in effect, "
3317 "even if it is.  If cpuset memory spreading is subsequently turned off, the "
3318 "NUMA memory policy most recently specified by these calls is automatically "
3319 "reapplied."
3320 msgstr ""
3321
3322 #. type: Plain text
3323 #: build/C/man7/cpuset.7:644
3324 msgid ""
3325 "Both I<cpuset.memory_spread_page> and I<cpuset.memory_spread_slab> are "
3326 "Boolean flag files.  By default they contain \"0\", meaning that the feature "
3327 "is off for that cpuset.  If a \"1\" is written to that file, that turns the "
3328 "named feature on."
3329 msgstr ""
3330
3331 #. type: Plain text
3332 #: build/C/man7/cpuset.7:647
3333 msgid ""
3334 "Cpuset-specified memory spreading behaves similarly to what is known (in "
3335 "other contexts) as round-robin or interleave memory placement."
3336 msgstr ""
3337
3338 #. type: Plain text
3339 #: build/C/man7/cpuset.7:650
3340 msgid ""
3341 "Cpuset-specified memory spreading can provide substantial performance "
3342 "improvements for jobs that:"
3343 msgstr ""
3344
3345 #. type: IP
3346 #: build/C/man7/cpuset.7:650
3347 #, no-wrap
3348 msgid "a)"
3349 msgstr ""
3350
3351 #. type: Plain text
3352 #: build/C/man7/cpuset.7:654
3353 msgid ""
3354 "need to place thread-local data on memory nodes close to the CPUs which are "
3355 "running the threads that most frequently access that data; but also"
3356 msgstr ""
3357
3358 #. type: IP
3359 #: build/C/man7/cpuset.7:654
3360 #, no-wrap
3361 msgid "b)"
3362 msgstr ""
3363
3364 #. type: Plain text
3365 #: build/C/man7/cpuset.7:657
3366 msgid ""
3367 "need to access large filesystem data sets that must to be spread across the "
3368 "several nodes in the job's cpuset in order to fit."
3369 msgstr ""
3370
3371 #.  ================== Memory Migration ==================
3372 #. type: Plain text
3373 #: build/C/man7/cpuset.7:664
3374 msgid ""
3375 "Without this policy, the memory allocation across the nodes in the job's "
3376 "cpuset can become very uneven, especially for jobs that might have just a "
3377 "single thread initializing or reading in the data set."
3378 msgstr ""
3379
3380 #. type: SS
3381 #: build/C/man7/cpuset.7:664
3382 #, no-wrap
3383 msgid "Memory migration"
3384 msgstr ""
3385
3386 #. type: Plain text
3387 #: build/C/man7/cpuset.7:673
3388 msgid ""
3389 "Normally, under the default setting (disabled) of I<cpuset.memory_migrate>, "
3390 "once a page is allocated (given a physical page of main memory) then that "
3391 "page stays on whatever node it was allocated, so long as it remains "
3392 "allocated, even if the cpuset's memory-placement policy I<mems> subsequently "
3393 "changes."
3394 msgstr ""
3395
3396 #. type: Plain text
3397 #: build/C/man7/cpuset.7:679
3398 msgid ""
3399 "When memory migration is enabled in a cpuset, if the I<mems> setting of the "
3400 "cpuset is changed, then any memory page in use by any process in the cpuset "
3401 "that is on a memory node that is no longer allowed will be migrated to a "
3402 "memory node that is allowed."
3403 msgstr ""
3404
3405 #. type: Plain text
3406 #: build/C/man7/cpuset.7:685
3407 msgid ""
3408 "Furthermore, if a process is moved into a cpuset with I<memory_migrate> "
3409 "enabled, any memory pages it uses that were on memory nodes allowed in its "
3410 "previous cpuset, but which are not allowed in its new cpuset, will be "
3411 "migrated to a memory node allowed in the new cpuset."
3412 msgstr ""
3413
3414 #.  ================== Scheduler Load Balancing ==================
3415 #. type: Plain text
3416 #: build/C/man7/cpuset.7:693
3417 msgid ""
3418 "The relative placement of a migrated page within the cpuset is preserved "
3419 "during these migration operations if possible.  For example, if the page was "
3420 "on the second valid node of the prior cpuset, then the page will be placed "
3421 "on the second valid node of the new cpuset, if possible."
3422 msgstr ""
3423
3424 #. type: SS
3425 #: build/C/man7/cpuset.7:693
3426 #, no-wrap
3427 msgid "Scheduler load balancing"
3428 msgstr ""
3429
3430 #. type: Plain text
3431 #: build/C/man7/cpuset.7:700
3432 msgid ""
3433 "The kernel scheduler automatically load balances processes.  If one CPU is "
3434 "underutilized, the kernel will look for processes on other more overloaded "
3435 "CPUs and move those processes to the underutilized CPU, within the "
3436 "constraints of such placement mechanisms as cpusets and "
3437 "B<sched_setaffinity>(2)."
3438 msgstr ""
3439
3440 #. type: Plain text
3441 #: build/C/man7/cpuset.7:713
3442 msgid ""
3443 "The algorithmic cost of load balancing and its impact on key shared kernel "
3444 "data structures such as the process list increases more than linearly with "
3445 "the number of CPUs being balanced.  For example, it costs more to load "
3446 "balance across one large set of CPUs than it does to balance across two "
3447 "smaller sets of CPUs, each of half the size of the larger set.  (The precise "
3448 "relationship between the number of CPUs being balanced and the cost of load "
3449 "balancing depends on implementation details of the kernel process scheduler, "
3450 "which is subject to change over time, as improved kernel scheduler "
3451 "algorithms are implemented.)"
3452 msgstr ""
3453
3454 #. type: Plain text
3455 #: build/C/man7/cpuset.7:719
3456 msgid ""
3457 "The per-cpuset flag I<sched_load_balance> provides a mechanism to suppress "
3458 "this automatic scheduler load balancing in cases where it is not needed and "
3459 "suppressing it would have worthwhile performance benefits."
3460 msgstr ""
3461
3462 #. type: Plain text
3463 #: build/C/man7/cpuset.7:723
3464 msgid ""
3465 "By default, load balancing is done across all CPUs, except those marked "
3466 "isolated using the kernel boot time \"isolcpus=\" argument.  (See "
3467 "B<Scheduler Relax Domain Level>, below, to change this default.)"
3468 msgstr ""
3469
3470 #. type: Plain text
3471 #: build/C/man7/cpuset.7:726
3472 msgid ""
3473 "This default load balancing across all CPUs is not well suited to the "
3474 "following two situations:"
3475 msgstr ""
3476
3477 #. type: Plain text
3478 #: build/C/man7/cpuset.7:730
3479 msgid ""
3480 "On large systems, load balancing across many CPUs is expensive.  If the "
3481 "system is managed using cpusets to place independent jobs on separate sets "
3482 "of CPUs, full load balancing is unnecessary."
3483 msgstr ""
3484
3485 #. type: Plain text
3486 #: build/C/man7/cpuset.7:734
3487 msgid ""
3488 "Systems supporting real-time on some CPUs need to minimize system overhead "
3489 "on those CPUs, including avoiding process load balancing if that is not "
3490 "needed."
3491 msgstr ""
3492
3493 #. type: Plain text
3494 #: build/C/man7/cpuset.7:744
3495 msgid ""
3496 "When the per-cpuset flag I<sched_load_balance> is enabled (the default "
3497 "setting), it requests load balancing across all the CPUs in that cpuset's "
3498 "allowed CPUs, ensuring that load balancing can move a process (not otherwise "
3499 "pinned, as by B<sched_setaffinity>(2))  from any CPU in that cpuset to any "
3500 "other."
3501 msgstr ""
3502
3503 #. type: Plain text
3504 #: build/C/man7/cpuset.7:753
3505 msgid ""
3506 "When the per-cpuset flag I<sched_load_balance> is disabled, then the "
3507 "scheduler will avoid load balancing across the CPUs in that cpuset, "
3508 "I<except> in so far as is necessary because some overlapping cpuset has "
3509 "I<sched_load_balance> enabled."
3510 msgstr ""
3511
3512 #. type: Plain text
3513 #: build/C/man7/cpuset.7:761
3514 msgid ""
3515 "So, for example, if the top cpuset has the flag I<sched_load_balance> "
3516 "enabled, then the scheduler will load balance across all CPUs, and the "
3517 "setting of the I<sched_load_balance> flag in other cpusets has no effect, as "
3518 "we're already fully load balancing."
3519 msgstr ""
3520
3521 #. type: Plain text
3522 #: build/C/man7/cpuset.7:766
3523 msgid ""
3524 "Therefore in the above two situations, the flag I<sched_load_balance> should "
3525 "be disabled in the top cpuset, and only some of the smaller, child cpusets "
3526 "would have this flag enabled."
3527 msgstr ""
3528
3529 #. type: Plain text
3530 #: build/C/man7/cpuset.7:774
3531 msgid ""
3532 "When doing this, you don't usually want to leave any unpinned processes in "
3533 "the top cpuset that might use nontrivial amounts of CPU, as such processes "
3534 "may be artificially constrained to some subset of CPUs, depending on the "
3535 "particulars of this flag setting in descendant cpusets.  Even if such a "
3536 "process could use spare CPU cycles in some other CPUs, the kernel scheduler "
3537 "might not consider the possibility of load balancing that process to the "
3538 "underused CPU."
3539 msgstr ""
3540
3541 #.  ================== Scheduler Relax Domain Level ==================
3542 #. type: Plain text
3543 #: build/C/man7/cpuset.7:780
3544 msgid ""
3545 "Of course, processes pinned to a particular CPU can be left in a cpuset that "
3546 "disables I<sched_load_balance> as those processes aren't going anywhere else "
3547 "anyway."
3548 msgstr ""
3549
3550 #. type: SS
3551 #: build/C/man7/cpuset.7:780
3552 #, no-wrap
3553 msgid "Scheduler relax domain level"
3554 msgstr ""
3555
3556 #. type: Plain text
3557 #: build/C/man7/cpuset.7:801
3558 msgid ""
3559 "The kernel scheduler performs immediate load balancing whenever a CPU "
3560 "becomes free or another task becomes runnable.  This load balancing works to "
3561 "ensure that as many CPUs as possible are usefully employed running tasks.  "
3562 "The kernel also performs periodic load balancing off the software clock "
3563 "described in I<time>(7).  The setting of I<sched_relax_domain_level> applies "
3564 "only to immediate load balancing.  Regardless of the "
3565 "I<sched_relax_domain_level> setting, periodic load balancing is attempted "
3566 "over all CPUs (unless disabled by turning off I<sched_load_balance>.)  In "
3567 "any case, of course, tasks will be scheduled to run only on CPUs allowed by "
3568 "their cpuset, as modified by B<sched_setaffinity>(2)  system calls."
3569 msgstr ""
3570
3571 #. type: Plain text
3572 #: build/C/man7/cpuset.7:809
3573 msgid ""
3574 "On small systems, such as those with just a few CPUs, immediate load "
3575 "balancing is useful to improve system interactivity and to minimize wasteful "
3576 "idle CPU cycles.  But on large systems, attempting immediate load balancing "
3577 "across a large number of CPUs can be more costly than it is worth, depending "
3578 "on the particular performance characteristics of the job mix and the "
3579 "hardware."
3580 msgstr ""
3581
3582 #. type: Plain text
3583 #: build/C/man7/cpuset.7:817
3584 msgid ""
3585 "The exact meaning of the small integer values of I<sched_relax_domain_level> "
3586 "will depend on internal implementation details of the kernel scheduler code "
3587 "and on the non-uniform architecture of the hardware.  Both of these will "
3588 "evolve over time and vary by system architecture and kernel version."
3589 msgstr ""
3590
3591 #. type: Plain text
3592 #: build/C/man7/cpuset.7:822
3593 msgid ""
3594 "As of this writing, when this capability was introduced in Linux 2.6.26, on "
3595 "certain popular architectures, the positive values of "
3596 "I<sched_relax_domain_level> have the following meanings."
3597 msgstr ""
3598
3599 #. type: IP
3600 #: build/C/man7/cpuset.7:824
3601 #, no-wrap
3602 msgid "B<(1)>"
3603 msgstr ""
3604
3605 #. type: Plain text
3606 #: build/C/man7/cpuset.7:827
3607 msgid ""
3608 "Perform immediate load balancing across Hyper-Thread siblings on the same "
3609 "core."
3610 msgstr ""
3611
3612 #. type: IP
3613 #: build/C/man7/cpuset.7:827
3614 #, no-wrap
3615 msgid "B<(2)>"
3616 msgstr ""
3617
3618 #. type: Plain text
3619 #: build/C/man7/cpuset.7:829
3620 msgid "Perform immediate load balancing across other cores in the same package."
3621 msgstr ""
3622
3623 #. type: IP
3624 #: build/C/man7/cpuset.7:829
3625 #, no-wrap
3626 msgid "B<(3)>"
3627 msgstr ""
3628
3629 #. type: Plain text
3630 #: build/C/man7/cpuset.7:832
3631 msgid ""
3632 "Perform immediate load balancing across other CPUs on the same node or "
3633 "blade."
3634 msgstr ""
3635
3636 #. type: IP
3637 #: build/C/man7/cpuset.7:832
3638 #, no-wrap
3639 msgid "B<(4)>"
3640 msgstr ""
3641
3642 #. type: Plain text
3643 #: build/C/man7/cpuset.7:835
3644 msgid ""
3645 "Perform immediate load balancing across over several (implementation detail) "
3646 "nodes [On NUMA systems]."
3647 msgstr ""
3648
3649 #. type: IP
3650 #: build/C/man7/cpuset.7:835
3651 #, no-wrap
3652 msgid "B<(5)>"
3653 msgstr ""
3654
3655 #. type: Plain text
3656 #: build/C/man7/cpuset.7:838
3657 msgid ""
3658 "Perform immediate load balancing across over all CPUs in system [On NUMA "
3659 "systems]."
3660 msgstr ""
3661
3662 #. type: Plain text
3663 #: build/C/man7/cpuset.7:847
3664 msgid ""
3665 "The I<sched_relax_domain_level> value of zero (0) always means don't perform "
3666 "immediate load balancing, hence that load balancing is done only "
3667 "periodically, not immediately when a CPU becomes available or another task "
3668 "becomes runnable."
3669 msgstr ""
3670
3671 #. type: Plain text
3672 #: build/C/man7/cpuset.7:855
3673 msgid ""
3674 "The I<sched_relax_domain_level> value of minus one (-1)  always means use "
3675 "the system default value.  The system default value can vary by architecture "
3676 "and kernel version.  This system default value can be changed by kernel "
3677 "boot-time \"relax_domain_level=\" argument."
3678 msgstr ""
3679
3680 #. type: Plain text
3681 #: build/C/man7/cpuset.7:863
3682 msgid ""
3683 "In the case of multiple overlapping cpusets which have conflicting "
3684 "I<sched_relax_domain_level> values, then the highest such value applies to "
3685 "all CPUs in any of the overlapping cpusets.  In such cases, the value "
3686 "B<minus one (-1)> is the lowest value, overridden by any other value, and "
3687 "the value B<zero (0)> is the next lowest value."
3688 msgstr ""
3689
3690 #. type: SH
3691 #: build/C/man7/cpuset.7:863
3692 #, no-wrap
3693 msgid "FORMATS"
3694 msgstr ""
3695
3696 #.  ================== Mask Format ==================
3697 #. type: Plain text
3698 #: build/C/man7/cpuset.7:867
3699 msgid "The following formats are used to represent sets of CPUs and memory nodes."
3700 msgstr ""
3701
3702 #. type: SS
3703 #: build/C/man7/cpuset.7:867
3704 #, no-wrap
3705 msgid "Mask format"
3706 msgstr ""
3707
3708 #. type: Plain text
3709 #: build/C/man7/cpuset.7:872
3710 msgid ""
3711 "The B<Mask Format> is used to represent CPU and memory-node bit masks in the "
3712 "I</proc/E<lt>pidE<gt>/status> file."
3713 msgstr ""
3714
3715 #. type: Plain text
3716 #: build/C/man7/cpuset.7:880
3717 msgid ""
3718 "This format displays each 32-bit word in hexadecimal (using ASCII characters "
3719 "\"0\" - \"9\" and \"a\" - \"f\"); words are filled with leading zeros, if "
3720 "required.  For masks longer than one word, a comma separator is used between "
3721 "words.  Words are displayed in big-endian order, which has the most "
3722 "significant bit first.  The hex digits within a word are also in big-endian "
3723 "order."
3724 msgstr ""
3725
3726 #. type: Plain text
3727 #: build/C/man7/cpuset.7:883
3728 msgid ""
3729 "The number of 32-bit words displayed is the minimum number needed to display "
3730 "all bits of the bit mask, based on the size of the bit mask."
3731 msgstr ""
3732
3733 #. type: Plain text
3734 #: build/C/man7/cpuset.7:885
3735 msgid "Examples of the B<Mask Format>:"
3736 msgstr ""
3737
3738 #. type: Plain text
3739 #: build/C/man7/cpuset.7:893
3740 #, no-wrap
3741 msgid ""
3742 "00000001                        # just bit 0 set\n"
3743 "40000000,00000000,00000000      # just bit 94 set\n"
3744 "00000001,00000000,00000000      # just bit 64 set\n"
3745 "000000ff,00000000               # bits 32-39 set\n"
3746 "00000000,000E3862               # 1,5,6,11-13,17-19 set\n"
3747 msgstr ""
3748
3749 #. type: Plain text
3750 #: build/C/man7/cpuset.7:897
3751 msgid "A mask with bits 0, 1, 2, 4, 8, 16, 32, and 64 set displays as:"
3752 msgstr ""
3753
3754 #. type: Plain text
3755 #: build/C/man7/cpuset.7:901
3756 #, no-wrap
3757 msgid "00000001,00000001,00010117\n"
3758 msgstr ""
3759
3760 #.  ================== List Format ==================
3761 #. type: Plain text
3762 #: build/C/man7/cpuset.7:908
3763 msgid ""
3764 "The first \"1\" is for bit 64, the second for bit 32, the third for bit 16, "
3765 "the fourth for bit 8, the fifth for bit 4, and the \"7\" is for bits 2, 1, "
3766 "and 0."
3767 msgstr ""
3768
3769 #. type: SS
3770 #: build/C/man7/cpuset.7:908
3771 #, no-wrap
3772 msgid "List format"
3773 msgstr ""
3774
3775 #. type: Plain text
3776 #: build/C/man7/cpuset.7:915
3777 msgid ""
3778 "The B<List Format> for I<cpus> and I<mems> is a comma-separated list of CPU "
3779 "or memory-node numbers and ranges of numbers, in ASCII decimal."
3780 msgstr ""
3781
3782 #. type: Plain text
3783 #: build/C/man7/cpuset.7:917
3784 msgid "Examples of the B<List Format>:"
3785 msgstr ""
3786
3787 #. type: Plain text
3788 #: build/C/man7/cpuset.7:922
3789 #, no-wrap
3790 msgid ""
3791 "0-4,9           # bits 0, 1, 2, 3, 4, and 9 set\n"
3792 "0-2,7,12-14     # bits 0, 1, 2, 7, 12, 13, and 14 set\n"
3793 msgstr ""
3794
3795 #.  ================== RULES ==================
3796 #. type: SH
3797 #: build/C/man7/cpuset.7:925
3798 #, no-wrap
3799 msgid "RULES"
3800 msgstr ""
3801
3802 #. type: Plain text
3803 #: build/C/man7/cpuset.7:927
3804 msgid "The following rules apply to each cpuset:"
3805 msgstr ""
3806
3807 #. type: Plain text
3808 #: build/C/man7/cpuset.7:930
3809 msgid ""
3810 "Its CPUs and memory nodes must be a (possibly equal)  subset of its "
3811 "parent's."
3812 msgstr ""
3813
3814 #. type: Plain text
3815 #: build/C/man7/cpuset.7:934
3816 msgid "It can be marked I<cpu_exclusive> only if its parent is."
3817 msgstr ""
3818
3819 #. type: Plain text
3820 #: build/C/man7/cpuset.7:938
3821 msgid "It can be marked I<mem_exclusive> only if its parent is."
3822 msgstr ""
3823
3824 #. type: Plain text
3825 #: build/C/man7/cpuset.7:942
3826 msgid "If it is I<cpu_exclusive>, its CPUs may not overlap any sibling."
3827 msgstr ""
3828
3829 #.  ================== PERMISSIONS ==================
3830 #. type: Plain text
3831 #: build/C/man7/cpuset.7:947
3832 msgid "If it is I<memory_exclusive>, its memory nodes may not overlap any sibling."
3833 msgstr ""
3834
3835 #. type: SH
3836 #: build/C/man7/cpuset.7:947
3837 #, no-wrap
3838 msgid "PERMISSIONS"
3839 msgstr ""
3840
3841 #. type: Plain text
3842 #: build/C/man7/cpuset.7:952
3843 msgid ""
3844 "The permissions of a cpuset are determined by the permissions of the "
3845 "directories and pseudo-files in the cpuset filesystem, normally mounted at "
3846 "I</dev/cpuset>."
3847 msgstr ""
3848
3849 #. type: Plain text
3850 #: build/C/man7/cpuset.7:961
3851 msgid ""
3852 "For instance, a process can put itself in some other cpuset (than its "
3853 "current one) if it can write the I<tasks> file for that cpuset.  This "
3854 "requires execute permission on the encompassing directories and write "
3855 "permission on the I<tasks> file."
3856 msgstr ""
3857
3858 #. type: Plain text
3859 #: build/C/man7/cpuset.7:968
3860 msgid ""
3861 "An additional constraint is applied to requests to place some other process "
3862 "in a cpuset.  One process may not attach another to a cpuset unless it would "
3863 "have permission to send that process a signal (see B<kill>(2))."
3864 msgstr ""
3865
3866 #. type: Plain text
3867 #: build/C/man7/cpuset.7:979
3868 msgid ""
3869 "A process may create a child cpuset if it can access and write the parent "
3870 "cpuset directory.  It can modify the CPUs or memory nodes in a cpuset if it "
3871 "can access that cpuset's directory (execute permissions on the each of the "
3872 "parent directories) and write the corresponding I<cpus> or I<mems> file."
3873 msgstr ""
3874
3875 #. type: Plain text
3876 #: build/C/man7/cpuset.7:1000
3877 msgid ""
3878 "There is one minor difference between the manner in which these permissions "
3879 "are evaluated and the manner in which normal filesystem operation "
3880 "permissions are evaluated.  The kernel interprets relative pathnames "
3881 "starting at a process's current working directory.  Even if one is operating "
3882 "on a cpuset file, relative pathnames are interpreted relative to the "
3883 "process's current working directory, not relative to the process's current "
3884 "cpuset.  The only ways that cpuset paths relative to a process's current "
3885 "cpuset can be used are if either the process's current working directory is "
3886 "its cpuset (it first did a B<cd> or B<chdir>(2)  to its cpuset directory "
3887 "beneath I</dev/cpuset>, which is a bit unusual)  or if some user code "
3888 "converts the relative cpuset path to a full filesystem path."
3889 msgstr ""
3890
3891 #.  ================== WARNINGS ==================
3892 #. type: Plain text
3893 #: build/C/man7/cpuset.7:1015
3894 msgid ""
3895 "In theory, this means that user code should specify cpusets using absolute "
3896 "pathnames, which requires knowing the mount point of the cpuset filesystem "
3897 "(usually, but not necessarily, I</dev/cpuset>).  In practice, all user level "
3898 "code that this author is aware of simply assumes that if the cpuset "
3899 "filesystem is mounted, then it is mounted at I</dev/cpuset>.  Furthermore, "
3900 "it is common practice for carefully written user code to verify the presence "
3901 "of the pseudo-file I</dev/cpuset/tasks> in order to verify that the cpuset "
3902 "pseudo-filesystem is currently mounted."
3903 msgstr ""
3904
3905 #. type: SH
3906 #: build/C/man7/cpuset.7:1015
3907 #, no-wrap
3908 msgid "WARNINGS"
3909 msgstr ""
3910
3911 #. type: SS
3912 #: build/C/man7/cpuset.7:1016
3913 #, no-wrap
3914 msgid "Enabling memory_pressure"
3915 msgstr ""
3916
3917 #. type: Plain text
3918 #: build/C/man7/cpuset.7:1025
3919 msgid ""
3920 "By default, the per-cpuset file I<cpuset.memory_pressure> always contains "
3921 "zero (0).  Unless this feature is enabled by writing \"1\" to the "
3922 "pseudo-file I</dev/cpuset/cpuset.memory_pressure_enabled>, the kernel does "
3923 "not compute per-cpuset I<memory_pressure>."
3924 msgstr ""
3925
3926 #. type: SS
3927 #: build/C/man7/cpuset.7:1025
3928 #, no-wrap
3929 msgid "Using the echo command"
3930 msgstr ""
3931
3932 #.  Gack!  csh(1)'s echo does this
3933 #. type: Plain text
3934 #: build/C/man7/cpuset.7:1036
3935 msgid ""
3936 "When using the B<echo> command at the shell prompt to change the values of "
3937 "cpuset files, beware that the built-in B<echo> command in some shells does "
3938 "not display an error message if the B<write>(2)  system call fails.  For "
3939 "example, if the command:"
3940 msgstr ""
3941
3942 #. type: Plain text
3943 #: build/C/man7/cpuset.7:1040
3944 #, no-wrap
3945 msgid "echo 19 E<gt> cpuset.mems\n"
3946 msgstr ""
3947
3948 #. type: Plain text
3949 #: build/C/man7/cpuset.7:1053
3950 msgid ""
3951 "failed because memory node 19 was not allowed (perhaps the current system "
3952 "does not have a memory node 19), then the B<echo> command might not display "
3953 "any error.  It is better to use the B</bin/echo> external command to change "
3954 "cpuset file settings, as this command will display B<write>(2)  errors, as "
3955 "in the example:"
3956 msgstr ""
3957
3958 #. type: Plain text
3959 #: build/C/man7/cpuset.7:1058
3960 #, no-wrap
3961 msgid ""
3962 "/bin/echo 19 E<gt> cpuset.mems\n"
3963 "/bin/echo: write error: Invalid argument\n"
3964 msgstr ""
3965
3966 #.  ================== EXCEPTIONS ==================
3967 #. type: SH
3968 #: build/C/man7/cpuset.7:1061
3969 #, no-wrap
3970 msgid "EXCEPTIONS"
3971 msgstr ""
3972
3973 #. type: SS
3974 #: build/C/man7/cpuset.7:1062
3975 #, no-wrap
3976 msgid "Memory placement"
3977 msgstr ""
3978
3979 #. type: Plain text
3980 #: build/C/man7/cpuset.7:1065
3981 msgid ""
3982 "Not all allocations of system memory are constrained by cpusets, for the "
3983 "following reasons."
3984 msgstr ""
3985
3986 #. type: Plain text
3987 #: build/C/man7/cpuset.7:1080
3988 msgid ""
3989 "If hot-plug functionality is used to remove all the CPUs that are currently "
3990 "assigned to a cpuset, then the kernel will automatically update the "
3991 "I<cpus_allowed> of all processes attached to CPUs in that cpuset to allow "
3992 "all CPUs.  When memory hot-plug functionality for removing memory nodes is "
3993 "available, a similar exception is expected to apply there as well.  In "
3994 "general, the kernel prefers to violate cpuset placement, rather than "
3995 "starving a process that has had all its allowed CPUs or memory nodes taken "
3996 "offline.  User code should reconfigure cpusets to refer only to online CPUs "
3997 "and memory nodes when using hot-plug to add or remove such resources."
3998 msgstr ""
3999
4000 #. type: Plain text
4001 #: build/C/man7/cpuset.7:1088
4002 msgid ""
4003 "A few kernel-critical, internal memory-allocation requests, marked "
4004 "GFP_ATOMIC, must be satisfied immediately.  The kernel may drop some request "
4005 "or malfunction if one of these allocations fail.  If such a request cannot "
4006 "be satisfied within the current process's cpuset, then we relax the cpuset, "
4007 "and look for memory anywhere we can find it.  It's better to violate the "
4008 "cpuset than stress the kernel."
4009 msgstr ""
4010
4011 #. type: Plain text
4012 #: build/C/man7/cpuset.7:1092
4013 msgid ""
4014 "Allocations of memory requested by kernel drivers while processing an "
4015 "interrupt lack any relevant process context, and are not confined by "
4016 "cpusets."
4017 msgstr ""
4018
4019 #. type: SS
4020 #: build/C/man7/cpuset.7:1092
4021 #, no-wrap
4022 msgid "Renaming cpusets"
4023 msgstr ""
4024
4025 #.  ================== ERRORS ==================
4026 #. type: Plain text
4027 #: build/C/man7/cpuset.7:1100
4028 msgid ""
4029 "You can use the B<rename>(2)  system call to rename cpusets.  Only simple "
4030 "renaming is supported; that is, changing the name of a cpuset directory is "
4031 "permitted, but moving a directory into a different directory is not "
4032 "permitted."
4033 msgstr ""
4034
4035 #. type: Plain text
4036 #: build/C/man7/cpuset.7:1104
4037 msgid ""
4038 "The Linux kernel implementation of cpusets sets I<errno> to specify the "
4039 "reason for a failed system call affecting cpusets."
4040 msgstr ""
4041
4042 #. type: Plain text
4043 #: build/C/man7/cpuset.7:1109
4044 msgid ""
4045 "The possible I<errno> settings and their meaning when set on a failed cpuset "
4046 "call are as listed below."
4047 msgstr ""
4048
4049 #. type: TP
4050 #: build/C/man7/cpuset.7:1109
4051 #, no-wrap
4052 msgid "B<E2BIG>"
4053 msgstr ""
4054
4055 #. type: Plain text
4056 #: build/C/man7/cpuset.7:1116
4057 msgid ""
4058 "Attempted a B<write>(2)  on a special cpuset file with a length larger than "
4059 "some kernel-determined upper limit on the length of such writes."
4060 msgstr ""
4061
4062 #. type: Plain text
4063 #: build/C/man7/cpuset.7:1123
4064 msgid ""
4065 "Attempted to B<write>(2)  the process ID (PID) of a process to a cpuset "
4066 "I<tasks> file when one lacks permission to move that process."
4067 msgstr ""
4068
4069 #. type: Plain text
4070 #: build/C/man7/cpuset.7:1129
4071 msgid ""
4072 "Attempted to add, using B<write>(2), a CPU or memory node to a cpuset, when "
4073 "that CPU or memory node was not already in its parent."
4074 msgstr ""
4075
4076 #. type: Plain text
4077 #: build/C/man7/cpuset.7:1137
4078 msgid ""
4079 "Attempted to set, using B<write>(2), I<cpuset.cpu_exclusive> or "
4080 "I<cpuset.mem_exclusive> on a cpuset whose parent lacks the same setting."
4081 msgstr ""
4082
4083 #. type: Plain text
4084 #: build/C/man7/cpuset.7:1144
4085 msgid "Attempted to B<write>(2)  a I<cpuset.memory_pressure> file."
4086 msgstr ""
4087
4088 #. type: Plain text
4089 #: build/C/man7/cpuset.7:1147
4090 msgid "Attempted to create a file in a cpuset directory."
4091 msgstr ""
4092
4093 #. type: TP
4094 #: build/C/man7/cpuset.7:1147 build/C/man7/cpuset.7:1152 build/C/man7/cpuset.7:1157
4095 #, no-wrap
4096 msgid "B<EBUSY>"
4097 msgstr ""
4098
4099 #. type: Plain text
4100 #: build/C/man7/cpuset.7:1152
4101 msgid "Attempted to remove, using B<rmdir>(2), a cpuset with attached processes."
4102 msgstr ""
4103
4104 #. type: Plain text
4105 #: build/C/man7/cpuset.7:1157
4106 msgid "Attempted to remove, using B<rmdir>(2), a cpuset with child cpusets."
4107 msgstr ""
4108
4109 #. type: Plain text
4110 #: build/C/man7/cpuset.7:1162
4111 msgid ""
4112 "Attempted to remove a CPU or memory node from a cpuset that is also in a "
4113 "child of that cpuset."
4114 msgstr ""
4115
4116 #. type: TP
4117 #: build/C/man7/cpuset.7:1162 build/C/man7/cpuset.7:1167
4118 #, no-wrap
4119 msgid "B<EEXIST>"
4120 msgstr ""
4121
4122 #. type: Plain text
4123 #: build/C/man7/cpuset.7:1167
4124 msgid "Attempted to create, using B<mkdir>(2), a cpuset that already exists."
4125 msgstr ""
4126
4127 #. type: Plain text
4128 #: build/C/man7/cpuset.7:1172
4129 msgid "Attempted to B<rename>(2)  a cpuset to a name that already exists."
4130 msgstr ""
4131
4132 #. type: Plain text
4133 #: build/C/man7/cpuset.7:1180
4134 msgid ""
4135 "Attempted to B<read>(2)  or B<write>(2)  a cpuset file using a buffer that "
4136 "is outside the writing processes accessible address space."
4137 msgstr ""
4138
4139 #. type: Plain text
4140 #: build/C/man7/cpuset.7:1189
4141 msgid ""
4142 "Attempted to change a cpuset, using B<write>(2), in a way that would violate "
4143 "a I<cpu_exclusive> or I<mem_exclusive> attribute of that cpuset or any of "
4144 "its siblings."
4145 msgstr ""
4146
4147 #. type: Plain text
4148 #: build/C/man7/cpuset.7:1198
4149 msgid ""
4150 "Attempted to B<write>(2)  an empty I<cpuset.cpus> or I<cpuset.mems> list to "
4151 "a cpuset which has attached processes or child cpusets."
4152 msgstr ""
4153
4154 #. type: Plain text
4155 #: build/C/man7/cpuset.7:1208
4156 msgid ""
4157 "Attempted to B<write>(2)  a I<cpuset.cpus> or I<cpuset.mems> list which "
4158 "included a range with the second number smaller than the first number."
4159 msgstr ""
4160
4161 #. type: Plain text
4162 #: build/C/man7/cpuset.7:1217
4163 msgid ""
4164 "Attempted to B<write>(2)  a I<cpuset.cpus> or I<cpuset.mems> list which "
4165 "included an invalid character in the string."
4166 msgstr ""
4167
4168 #. type: Plain text
4169 #: build/C/man7/cpuset.7:1224
4170 msgid ""
4171 "Attempted to B<write>(2)  a list to a I<cpuset.cpus> file that did not "
4172 "include any online CPUs."
4173 msgstr ""
4174
4175 #. type: Plain text
4176 #: build/C/man7/cpuset.7:1231
4177 msgid ""
4178 "Attempted to B<write>(2)  a list to a I<cpuset.mems> file that did not "
4179 "include any online memory nodes."
4180 msgstr ""
4181
4182 #. type: Plain text
4183 #: build/C/man7/cpuset.7:1238
4184 msgid ""
4185 "Attempted to B<write>(2)  a list to a I<cpuset.mems> file that included a "
4186 "node that held no memory."
4187 msgstr ""
4188
4189 #. type: Plain text
4190 #: build/C/man7/cpuset.7:1246
4191 msgid ""
4192 "Attempted to B<write>(2)  a string to a cpuset I<tasks> file that does not "
4193 "begin with an ASCII decimal integer."
4194 msgstr ""
4195
4196 #. type: Plain text
4197 #: build/C/man7/cpuset.7:1251
4198 msgid "Attempted to B<rename>(2)  a cpuset into a different directory."
4199 msgstr ""
4200
4201 #. type: Plain text
4202 #: build/C/man7/cpuset.7:1258
4203 msgid ""
4204 "Attempted to B<read>(2)  a I</proc/E<lt>pidE<gt>/cpuset> file for a cpuset "
4205 "path that is longer than the kernel page size."
4206 msgstr ""
4207
4208 #. type: Plain text
4209 #: build/C/man7/cpuset.7:1263
4210 msgid ""
4211 "Attempted to create, using B<mkdir>(2), a cpuset whose base directory name "
4212 "is longer than 255 characters."
4213 msgstr ""
4214
4215 #. type: Plain text
4216 #: build/C/man7/cpuset.7:1270
4217 msgid ""
4218 "Attempted to create, using B<mkdir>(2), a cpuset whose full pathname, "
4219 "including the mount point (typically \"/dev/cpuset/\") prefix, is longer "
4220 "than 4095 characters."
4221 msgstr ""
4222
4223 #. type: TP
4224 #: build/C/man7/cpuset.7:1270
4225 #, no-wrap
4226 msgid "B<ENODEV>"
4227 msgstr ""
4228
4229 #. type: Plain text
4230 #: build/C/man7/cpuset.7:1275
4231 msgid ""
4232 "The cpuset was removed by another process at the same time as a B<write>(2)  "
4233 "was attempted on one of the pseudo-files in the cpuset directory."
4234 msgstr ""
4235
4236 #. type: Plain text
4237 #: build/C/man7/cpuset.7:1280
4238 msgid ""
4239 "Attempted to create, using B<mkdir>(2), a cpuset in a parent cpuset that "
4240 "doesn't exist."
4241 msgstr ""
4242
4243 #. type: Plain text
4244 #: build/C/man7/cpuset.7:1287
4245 msgid ""
4246 "Attempted to B<access>(2)  or B<open>(2)  a nonexistent file in a cpuset "
4247 "directory."
4248 msgstr ""
4249
4250 #. type: Plain text
4251 #: build/C/man7/cpuset.7:1292
4252 msgid ""
4253 "Insufficient memory is available within the kernel; can occur on a variety "
4254 "of system calls affecting cpusets, but only if the system is extremely short "
4255 "of memory."
4256 msgstr ""
4257
4258 #. type: TP
4259 #: build/C/man7/cpuset.7:1292 build/C/man7/cpuset.7:1304
4260 #, no-wrap
4261 msgid "B<ENOSPC>"
4262 msgstr ""
4263
4264 #. type: Plain text
4265 #: build/C/man7/cpuset.7:1304
4266 msgid ""
4267 "Attempted to B<write>(2)  the process ID (PID)  of a process to a cpuset "
4268 "I<tasks> file when the cpuset had an empty I<cpuset.cpus> or empty "
4269 "I<cpuset.mems> setting."
4270 msgstr ""
4271
4272 #. type: Plain text
4273 #: build/C/man7/cpuset.7:1314
4274 msgid ""
4275 "Attempted to B<write>(2)  an empty I<cpuset.cpus> or I<cpuset.mems> setting "
4276 "to a cpuset that has tasks attached."
4277 msgstr ""
4278
4279 #. type: Plain text
4280 #: build/C/man7/cpuset.7:1319
4281 msgid "Attempted to B<rename>(2)  a nonexistent cpuset."
4282 msgstr ""
4283
4284 #. type: Plain text
4285 #: build/C/man7/cpuset.7:1322
4286 msgid "Attempted to remove a file from a cpuset directory."
4287 msgstr ""
4288
4289 #. type: TP
4290 #: build/C/man7/cpuset.7:1322
4291 #, no-wrap
4292 msgid "B<ERANGE>"
4293 msgstr ""
4294
4295 #. type: Plain text
4296 #: build/C/man7/cpuset.7:1330
4297 msgid ""
4298 "Specified a I<cpuset.cpus> or I<cpuset.mems> list to the kernel which "
4299 "included a number too large for the kernel to set in its bit masks."
4300 msgstr ""
4301
4302 #.  ================== VERSIONS ==================
4303 #. type: Plain text
4304 #: build/C/man7/cpuset.7:1338
4305 msgid ""
4306 "Attempted to B<write>(2)  the process ID (PID) of a nonexistent process to a "
4307 "cpuset I<tasks> file."
4308 msgstr ""
4309
4310 #.  ================== NOTES ==================
4311 #. type: Plain text
4312 #: build/C/man7/cpuset.7:1341
4313 msgid "Cpusets appeared in version 2.6.12 of the Linux kernel."
4314 msgstr ""
4315
4316 #.  ================== BUGS ==================
4317 #. type: Plain text
4318 #: build/C/man7/cpuset.7:1352
4319 msgid ""
4320 "Despite its name, the I<pid> parameter is actually a thread ID, and each "
4321 "thread in a threaded group can be attached to a different cpuset.  The value "
4322 "returned from a call to B<gettid>(2)  can be passed in the argument I<pid>."
4323 msgstr ""
4324
4325 #. type: SH
4326 #: build/C/man7/cpuset.7:1352 build/C/man2/getpriority.2:225 build/C/man2/getrlimit.2:525 build/C/man2/ioprio_set.2:337 build/C/man2/setfsgid.2:106 build/C/man2/setfsuid.2:114
4327 #, no-wrap
4328 msgid "BUGS"
4329 msgstr ""
4330
4331 #.  ================== EXAMPLE ==================
4332 #. type: Plain text
4333 #: build/C/man7/cpuset.7:1365
4334 msgid ""
4335 "I<cpuset.memory_pressure> cpuset files can be opened for writing, creation, "
4336 "or truncation, but then the B<write>(2)  fails with I<errno> set to "
4337 "B<EACCES>, and the creation and truncation options on B<open>(2)  have no "
4338 "effect."
4339 msgstr ""
4340
4341 #. type: SH
4342 #: build/C/man7/cpuset.7:1365 build/C/man2/getrlimit.2:600
4343 #, no-wrap
4344 msgid "EXAMPLE"
4345 msgstr ""
4346
4347 #. type: Plain text
4348 #: build/C/man7/cpuset.7:1368
4349 msgid ""
4350 "The following examples demonstrate querying and setting cpuset options using "
4351 "shell commands."
4352 msgstr ""
4353
4354 #. type: SS
4355 #: build/C/man7/cpuset.7:1368
4356 #, no-wrap
4357 msgid "Creating and attaching to a cpuset."
4358 msgstr ""
4359
4360 #. type: Plain text
4361 #: build/C/man7/cpuset.7:1371
4362 msgid ""
4363 "To create a new cpuset and attach the current command shell to it, the steps "
4364 "are:"
4365 msgstr ""
4366
4367 #. type: IP
4368 #: build/C/man7/cpuset.7:1373 build/C/man7/cpuset.7:1412
4369 #, no-wrap
4370 msgid "1)"
4371 msgstr ""
4372
4373 #. type: Plain text
4374 #: build/C/man7/cpuset.7:1375
4375 msgid "mkdir /dev/cpuset (if not already done)"
4376 msgstr ""
4377
4378 #. type: IP
4379 #: build/C/man7/cpuset.7:1375 build/C/man7/cpuset.7:1418
4380 #, no-wrap
4381 msgid "2)"
4382 msgstr ""
4383
4384 #. type: Plain text
4385 #: build/C/man7/cpuset.7:1377
4386 msgid "mount -t cpuset none /dev/cpuset (if not already done)"
4387 msgstr ""
4388
4389 #. type: IP
4390 #: build/C/man7/cpuset.7:1377 build/C/man7/cpuset.7:1421
4391 #, no-wrap
4392 msgid "3)"
4393 msgstr ""
4394
4395 #. type: Plain text
4396 #: build/C/man7/cpuset.7:1380
4397 msgid "Create the new cpuset using B<mkdir>(1)."
4398 msgstr ""
4399
4400 #. type: IP
4401 #: build/C/man7/cpuset.7:1380 build/C/man7/cpuset.7:1424
4402 #, no-wrap
4403 msgid "4)"
4404 msgstr ""
4405
4406 #. type: Plain text
4407 #: build/C/man7/cpuset.7:1382
4408 msgid "Assign CPUs and memory nodes to the new cpuset."
4409 msgstr ""
4410
4411 #. type: IP
4412 #: build/C/man7/cpuset.7:1382 build/C/man7/cpuset.7:1429
4413 #, no-wrap
4414 msgid "5)"
4415 msgstr ""
4416
4417 #. type: Plain text
4418 #: build/C/man7/cpuset.7:1384
4419 msgid "Attach the shell to the new cpuset."
4420 msgstr ""
4421
4422 #. type: Plain text
4423 #: build/C/man7/cpuset.7:1389
4424 msgid ""
4425 "For example, the following sequence of commands will set up a cpuset named "
4426 "\"Charlie\", containing just CPUs 2 and 3, and memory node 1, and then "
4427 "attach the current shell to that cpuset."
4428 msgstr ""
4429
4430 #. type: Plain text
4431 #: build/C/man7/cpuset.7:1403
4432 #, no-wrap
4433 msgid ""
4434 "$B< mkdir /dev/cpuset>\n"
4435 "$B< mount -t cpuset cpuset /dev/cpuset>\n"
4436 "$B< cd /dev/cpuset>\n"
4437 "$B< mkdir Charlie>\n"
4438 "$B< cd Charlie>\n"
4439 "$B< /bin/echo 2-3 E<gt> cpuset.cpus>\n"
4440 "$B< /bin/echo 1 E<gt> cpuset.mems>\n"
4441 "$B< /bin/echo $$ E<gt> tasks>\n"
4442 "# The current shell is now running in cpuset Charlie\n"
4443 "# The next line should display '/Charlie'\n"
4444 "$B< cat /proc/self/cpuset>\n"
4445 msgstr ""
4446
4447 #. type: SS
4448 #: build/C/man7/cpuset.7:1405
4449 #, no-wrap
4450 msgid "Migrating a job to different memory nodes."
4451 msgstr ""
4452
4453 #. type: Plain text
4454 #: build/C/man7/cpuset.7:1410
4455 msgid ""
4456 "To migrate a job (the set of processes attached to a cpuset)  to different "
4457 "CPUs and memory nodes in the system, including moving the memory pages "
4458 "currently allocated to that job, perform the following steps."
4459 msgstr ""
4460
4461 #. type: Plain text
4462 #: build/C/man7/cpuset.7:1418
4463 msgid ""
4464 "Let's say we want to move the job in cpuset I<alpha> (CPUs 4-7 and memory "
4465 "nodes 2-3) to a new cpuset I<beta> (CPUs 16-19 and memory nodes 8-9)."
4466 msgstr ""
4467
4468 #. type: Plain text
4469 #: build/C/man7/cpuset.7:1421
4470 msgid "First create the new cpuset I<beta>."
4471 msgstr ""
4472
4473 #. type: Plain text
4474 #: build/C/man7/cpuset.7:1424
4475 msgid "Then allow CPUs 16-19 and memory nodes 8-9 in I<beta>."
4476 msgstr ""
4477
4478 #. type: Plain text
4479 #: build/C/man7/cpuset.7:1429
4480 msgid "Then enable I<memory_migration> in I<beta>."
4481 msgstr ""
4482
4483 #. type: Plain text
4484 #: build/C/man7/cpuset.7:1434
4485 msgid "Then move each process from I<alpha> to I<beta>."
4486 msgstr ""
4487
4488 #. type: Plain text
4489 #: build/C/man7/cpuset.7:1437
4490 msgid "The following sequence of commands accomplishes this."
4491 msgstr ""
4492
4493 #. type: Plain text
4494 #: build/C/man7/cpuset.7:1447
4495 #, no-wrap
4496 msgid ""
4497 "$B< cd /dev/cpuset>\n"
4498 "$B< mkdir beta>\n"
4499 "$B< cd beta>\n"
4500 "$B< /bin/echo 16-19 E<gt> cpuset.cpus>\n"
4501 "$B< /bin/echo 8-9 E<gt> cpuset.mems>\n"
4502 "$B< /bin/echo 1 E<gt> cpuset.memory_migrate>\n"
4503 "$B< while read i; do /bin/echo $i; done E<lt> ../alpha/tasks E<gt> tasks>\n"
4504 msgstr ""
4505
4506 #. type: Plain text
4507 #: build/C/man7/cpuset.7:1456
4508 msgid ""
4509 "The above should move any processes in I<alpha> to I<beta>, and any memory "
4510 "held by these processes on memory nodes 2-3 to memory nodes 8-9, "
4511 "respectively."
4512 msgstr ""
4513
4514 #. type: Plain text
4515 #: build/C/man7/cpuset.7:1458
4516 msgid "Notice that the last step of the above sequence did not do:"
4517 msgstr ""
4518
4519 #. type: Plain text
4520 #: build/C/man7/cpuset.7:1462
4521 #, no-wrap
4522 msgid "$B< cp ../alpha/tasks tasks>\n"
4523 msgstr ""
4524
4525 #. type: Plain text
4526 #: build/C/man7/cpuset.7:1473
4527 msgid ""
4528 "The I<while> loop, rather than the seemingly easier use of the B<cp>(1)  "
4529 "command, was necessary because only one process PID at a time may be written "
4530 "to the I<tasks> file."
4531 msgstr ""
4532
4533 #. type: Plain text
4534 #: build/C/man7/cpuset.7:1481
4535 msgid ""
4536 "The same effect (writing one PID at a time) as the I<while> loop can be "
4537 "accomplished more efficiently, in fewer keystrokes and in syntax that works "
4538 "on any shell, but alas more obscurely, by using the B<-u> (unbuffered) "
4539 "option of B<sed>(1):"
4540 msgstr ""
4541
4542 #. type: Plain text
4543 #: build/C/man7/cpuset.7:1485
4544 #, no-wrap
4545 msgid "$B< sed -un p E<lt> ../alpha/tasks E<gt> tasks>\n"
4546 msgstr ""
4547
4548 #. type: Plain text
4549 #: build/C/man7/cpuset.7:1502
4550 msgid ""
4551 "B<taskset>(1), B<get_mempolicy>(2), B<getcpu>(2), B<mbind>(2), "
4552 "B<sched_getaffinity>(2), B<sched_setaffinity>(2), B<sched_setscheduler>(2), "
4553 "B<set_mempolicy>(2), B<CPU_SET>(3), B<proc>(5), B<numa>(7), "
4554 "B<migratepages>(8), B<numactl>(8)"
4555 msgstr ""
4556
4557 #. type: Plain text
4558 #: build/C/man7/cpuset.7:1505
4559 msgid "I<Documentation/cpusets.txt> in the Linux kernel source tree"
4560 msgstr ""
4561
4562 #. type: TH
4563 #: build/C/man7/credentials.7:27
4564 #, no-wrap
4565 msgid "CREDENTIALS"
4566 msgstr ""
4567
4568 #. type: TH
4569 #: build/C/man7/credentials.7:27
4570 #, no-wrap
4571 msgid "2008-06-03"
4572 msgstr ""
4573
4574 #. type: Plain text
4575 #: build/C/man7/credentials.7:30
4576 msgid "credentials - process identifiers"
4577 msgstr ""
4578
4579 #. type: SS
4580 #: build/C/man7/credentials.7:31
4581 #, no-wrap
4582 msgid "Process ID (PID)"
4583 msgstr ""
4584
4585 #. type: Plain text
4586 #: build/C/man7/credentials.7:41
4587 msgid ""
4588 "Each process has a unique nonnegative integer identifier that is assigned "
4589 "when the process is created using B<fork>(2).  A process can obtain its PID "
4590 "using B<getpid>(2).  A PID is represented using the type I<pid_t> (defined "
4591 "in I<E<lt>sys/types.hE<gt>>)."
4592 msgstr ""
4593
4594 #.  .BR sched_rr_get_interval (2),
4595 #.  .BR sched_getaffinity (2),
4596 #.  .BR sched_setaffinity (2),
4597 #.  .BR sched_getparam (2),
4598 #.  .BR sched_setparam (2),
4599 #.  .BR sched_setscheduler (2),
4600 #.  .BR sched_getscheduler (2),
4601 #.  .BR getsid (2),
4602 #.  .BR waitid (2),
4603 #.  .BR wait4 (2),
4604 #. type: Plain text
4605 #: build/C/man7/credentials.7:62
4606 msgid ""
4607 "PIDs are used in a range of system calls to identify the process affected by "
4608 "the call, for example: B<kill>(2), B<ptrace>(2), B<setpriority>(2)  "
4609 "B<setpgid>(2), B<setsid>(2), B<sigqueue>(3), and B<waitpid>(2)."
4610 msgstr ""
4611
4612 #. type: Plain text
4613 #: build/C/man7/credentials.7:65
4614 msgid "A process's PID is preserved across an B<execve>(2)."
4615 msgstr ""
4616
4617 #. type: SS
4618 #: build/C/man7/credentials.7:65
4619 #, no-wrap
4620 msgid "Parent process ID (PPID)"
4621 msgstr ""
4622
4623 #. type: Plain text
4624 #: build/C/man7/credentials.7:73
4625 msgid ""
4626 "A process's parent process ID identifies the process that created this "
4627 "process using B<fork>(2).  A process can obtain its PPID using "
4628 "B<getppid>(2).  A PPID is represented using the type I<pid_t>."
4629 msgstr ""
4630
4631 #. type: Plain text
4632 #: build/C/man7/credentials.7:76
4633 msgid "A process's PPID is preserved across an B<execve>(2)."
4634 msgstr ""
4635
4636 #. type: SS
4637 #: build/C/man7/credentials.7:76
4638 #, no-wrap
4639 msgid "Process group ID and session ID"
4640 msgstr ""
4641
4642 #. type: Plain text
4643 #: build/C/man7/credentials.7:84
4644 msgid ""
4645 "Each process has a session ID and a process group ID, both represented using "
4646 "the type I<pid_t>.  A process can obtain its session ID using B<getsid>(2), "
4647 "and its process group ID using B<getpgrp>(2)."
4648 msgstr ""
4649
4650 #. type: Plain text
4651 #: build/C/man7/credentials.7:90
4652 msgid ""
4653 "A child created by B<fork>(2)  inherits its parent's session ID and process "
4654 "group ID.  A process's session ID and process group ID are preserved across "
4655 "an B<execve>(2)."
4656 msgstr ""
4657
4658 #. type: Plain text
4659 #: build/C/man7/credentials.7:103
4660 msgid ""
4661 "Sessions and process groups are abstractions devised to support shell job "
4662 "control.  A process group (sometimes called a \"job\") is a collection of "
4663 "processes that share the same process group ID; the shell creates a new "
4664 "process group for the process(es) used to execute single command or pipeline "
4665 "(e.g., the two processes created to execute the command \"ls\\ |\\ wc\" are "
4666 "placed in the same process group).  A process's group membership can be set "
4667 "using B<setpgid>(2).  The process whose process ID is the same as its "
4668 "process group ID is the I<process group leader> for that group."
4669 msgstr ""
4670
4671 #. type: Plain text
4672 #: build/C/man7/credentials.7:115
4673 msgid ""
4674 "A session is a collection of processes that share the same session ID.  All "
4675 "of the members of a process group also have the same session ID (i.e., all "
4676 "of the members of a process group always belong to the same session, so that "
4677 "sessions and process groups form a strict two-level hierarchy of processes.)  "
4678 "A new session is created when a process calls B<setsid>(2), which creates a "
4679 "new session whose session ID is the same as the PID of the process that "
4680 "called B<setsid>(2).  The creator of the session is called the I<session "
4681 "leader>."
4682 msgstr ""
4683
4684 #. type: SS
4685 #: build/C/man7/credentials.7:115
4686 #, no-wrap
4687 msgid "User and group identifiers"
4688 msgstr ""
4689
4690 #. type: Plain text
4691 #: build/C/man7/credentials.7:123
4692 msgid ""
4693 "Each process has various associated user and groups IDs.  These IDs are "
4694 "integers, respectively represented using the types I<uid_t> and I<gid_t> "
4695 "(defined in I<E<lt>sys/types.hE<gt>>)."
4696 msgstr ""
4697
4698 #. type: Plain text
4699 #: build/C/man7/credentials.7:125
4700 msgid "On Linux, each process has the following user and group identifiers:"
4701 msgstr ""
4702
4703 #. type: Plain text
4704 #: build/C/man7/credentials.7:131
4705 msgid ""
4706 "Real user ID and real group ID.  These IDs determine who owns the process.  "
4707 "A process can obtain its real user (group) ID using B<getuid>(2)  "
4708 "(B<getgid>(2))."
4709 msgstr ""
4710
4711 #. type: Plain text
4712 #: build/C/man7/credentials.7:143
4713 msgid ""
4714 "Effective user ID and effective group ID.  These IDs are used by the kernel "
4715 "to determine the permissions that the process will have when accessing "
4716 "shared resources such as message queues, shared memory, and semaphores.  On "
4717 "most UNIX systems, these IDs also determine the permissions when accessing "
4718 "files.  However, Linux uses the filesystem IDs described below for this "
4719 "task.  A process can obtain its effective user (group) ID using "
4720 "B<geteuid>(2)  (B<getegid>(2))."
4721 msgstr ""
4722
4723 #. type: Plain text
4724 #: build/C/man7/credentials.7:165
4725 msgid ""
4726 "Saved set-user-ID and saved set-group-ID.  These IDs are used in set-user-ID "
4727 "and set-group-ID programs to save a copy of the corresponding effective IDs "
4728 "that were set when the program was executed (see B<execve>(2)).  A "
4729 "set-user-ID program can assume and drop privileges by switching its "
4730 "effective user ID back and forth between the values in its real user ID and "
4731 "saved set-user-ID.  This switching is done via calls to B<seteuid>(2), "
4732 "B<setreuid>(2), or B<setresuid>(2).  A set-group-ID program performs the "
4733 "analogous tasks using B<setegid>(2), B<setregid>(2), or B<setresgid>(2).  A "
4734 "process can obtain its saved set-user-ID (set-group-ID) using "
4735 "B<getresuid>(2)  (B<getresgid>(2))."
4736 msgstr ""
4737
4738 #. type: Plain text
4739 #: build/C/man7/credentials.7:182
4740 msgid ""
4741 "Filesystem user ID and filesystem group ID (Linux-specific).  These IDs, in "
4742 "conjunction with the supplementary group IDs described below, are used to "
4743 "determine permissions for accessing files; see B<path_resolution>(7)  for "
4744 "details.  Whenever a process's effective user (group) ID is changed, the "
4745 "kernel also automatically changes the filesystem user (group) ID to the same "
4746 "value.  Consequently, the filesystem IDs normally have the same values as "
4747 "the corresponding effective ID, and the semantics for file-permission checks "
4748 "are thus the same on Linux as on other UNIX systems.  The filesystem IDs can "
4749 "be made to differ from the effective IDs by calling B<setfsuid>(2)  and "
4750 "B<setfsgid>(2)."
4751 msgstr ""
4752
4753 #.  Since kernel 2.6.4, the limit is visible via the read-only file
4754 #.  /proc/sys/kernel/ngroups_max.
4755 #.  As at 2.6.22-rc2, this file is still read-only.
4756 #. type: Plain text
4757 #: build/C/man7/credentials.7:201
4758 msgid ""
4759 "Supplementary group IDs.  This is a set of additional group IDs that are "
4760 "used for permission checks when accessing files and other shared resources.  "
4761 "On Linux kernels before 2.6.4, a process can be a member of up to 32 "
4762 "supplementary groups; since kernel 2.6.4, a process can be a member of up to "
4763 "65536 supplementary groups.  The call I<sysconf(_SC_NGROUPS_MAX)> can be "
4764 "used to determine the number of supplementary groups of which a process may "
4765 "be a member.  A process can obtain its set of supplementary group IDs using "
4766 "B<getgroups>(2), and can modify the set using B<setgroups>(2)."
4767 msgstr ""
4768
4769 #. type: Plain text
4770 #: build/C/man7/credentials.7:211
4771 msgid ""
4772 "A child process created by B<fork>(2)  inherits copies of its parent's user "
4773 "and groups IDs.  During an B<execve>(2), a process's real user and group ID "
4774 "and supplementary group IDs are preserved; the effective and saved set IDs "
4775 "may be changed, as described in B<execve>(2)."
4776 msgstr ""
4777
4778 #. type: Plain text
4779 #: build/C/man7/credentials.7:214
4780 msgid ""
4781 "Aside from the purposes noted above, a process's user IDs are also employed "
4782 "in a number of other contexts:"
4783 msgstr ""
4784
4785 #. type: Plain text
4786 #: build/C/man7/credentials.7:217
4787 msgid "when determining the permissions for sending signals\\(emsee B<kill>(2);"
4788 msgstr ""
4789
4790 #. type: Plain text
4791 #: build/C/man7/credentials.7:227
4792 msgid ""
4793 "when determining the permissions for setting process-scheduling parameters "
4794 "(nice value, real time scheduling policy and priority, CPU affinity, I/O "
4795 "priority) using B<setpriority>(2), B<sched_setaffinity>(2), "
4796 "B<sched_setscheduler>(2), B<sched_setparam>(2), and B<ioprio_set>(2);"
4797 msgstr ""
4798
4799 #. type: Plain text
4800 #: build/C/man7/credentials.7:230
4801 msgid "when checking resource limits; see B<getrlimit>(2);"
4802 msgstr ""
4803
4804 #. type: Plain text
4805 #: build/C/man7/credentials.7:234
4806 msgid ""
4807 "when checking the limit on the number of inotify instances that the process "
4808 "may create; see B<inotify>(7)."
4809 msgstr ""
4810
4811 #. type: Plain text
4812 #: build/C/man7/credentials.7:240
4813 msgid ""
4814 "Process IDs, parent process IDs, process group IDs, and session IDs are "
4815 "specified in POSIX.1-2001.  The real, effective, and saved set user and "
4816 "groups IDs, and the supplementary group IDs, are specified in POSIX.1-2001.  "
4817 "The filesystem user and group IDs are a Linux extension."
4818 msgstr ""
4819
4820 #. type: Plain text
4821 #: build/C/man7/credentials.7:251
4822 msgid ""
4823 "The POSIX threads specification requires that credentials are shared by all "
4824 "of the threads in a process.  However, at the kernel level, Linux maintains "
4825 "separate user and group credentials for each thread.  The NPTL threading "
4826 "implementation does some work to ensure that any change to user or group "
4827 "credentials (e.g., calls to B<setuid>(2), B<setresuid>(2))  is carried "
4828 "through to all of the POSIX threads in a process."
4829 msgstr ""
4830
4831 #. type: Plain text
4832 #: build/C/man7/credentials.7:282
4833 msgid ""
4834 "B<bash>(1), B<csh>(1), B<ps>(1), B<access>(2), B<execve>(2), "
4835 "B<faccessat>(2), B<fork>(2), B<getpgrp>(2), B<getpid>(2), B<getppid>(2), "
4836 "B<getsid>(2), B<kill>(2), B<killpg>(2), B<setegid>(2), B<seteuid>(2), "
4837 "B<setfsgid>(2), B<setfsuid>(2), B<setgid>(2), B<setgroups>(2), "
4838 "B<setresgid>(2), B<setresuid>(2), B<setuid>(2), B<waitpid>(2), "
4839 "B<euidaccess>(3), B<initgroups>(3), B<tcgetpgrp>(3), B<tcsetpgrp>(3), "
4840 "B<capabilities>(7), B<path_resolution>(7), B<unix>(7)"
4841 msgstr ""
4842
4843 #. type: TH
4844 #: build/C/man2/getgid.2:25
4845 #, no-wrap
4846 msgid "GETGID"
4847 msgstr ""
4848
4849 #. type: TH
4850 #: build/C/man2/getgid.2:25 build/C/man2/getgroups.2:31 build/C/man2/getresuid.2:28 build/C/man2/getuid.2:26 build/C/man2/setgid.2:29 build/C/man2/setresuid.2:26 build/C/man2/setreuid.2:45 build/C/man2/setuid.2:30
4851 #, no-wrap
4852 msgid "2010-11-22"
4853 msgstr ""
4854
4855 #. type: Plain text
4856 #: build/C/man2/getgid.2:28
4857 msgid "getgid, getegid - get group identity"
4858 msgstr ""
4859
4860 #. type: Plain text
4861 #: build/C/man2/getgid.2:30 build/C/man2/getgroups.2:38 build/C/man2/getpid.2:32 build/C/man2/getresuid.2:35 build/C/man2/getsid.2:31 build/C/man2/getuid.2:31 build/C/man2/seteuid.2:36 build/C/man2/setgid.2:36 build/C/man2/setpgid.2:53 build/C/man2/setresuid.2:33 build/C/man2/setreuid.2:52 build/C/man2/setsid.2:36 build/C/man2/setuid.2:37
4862 msgid "B<#include E<lt>unistd.hE<gt>>"
4863 msgstr ""
4864
4865 #. type: Plain text
4866 #: build/C/man2/getgid.2:32 build/C/man2/getgroups.2:36 build/C/man2/getpid.2:30 build/C/man2/getuid.2:33 build/C/man2/seteuid.2:34 build/C/man2/setgid.2:34 build/C/man2/setreuid.2:50 build/C/man2/setuid.2:35
4867 msgid "B<#include E<lt>sys/types.hE<gt>>"
4868 msgstr ""
4869
4870 #. type: Plain text
4871 #: build/C/man2/getgid.2:34
4872 msgid "B<gid_t getgid(void);>"
4873 msgstr ""
4874
4875 #. type: Plain text
4876 #: build/C/man2/getgid.2:36
4877 msgid "B<gid_t getegid(void);>"
4878 msgstr ""
4879
4880 #. type: Plain text
4881 #: build/C/man2/getgid.2:39
4882 msgid "B<getgid>()  returns the real group ID of the calling process."
4883 msgstr ""
4884
4885 #. type: Plain text
4886 #: build/C/man2/getgid.2:42
4887 msgid "B<getegid>()  returns the effective group ID of the calling process."
4888 msgstr ""
4889
4890 #. type: Plain text
4891 #: build/C/man2/getgid.2:44 build/C/man2/getpid.2:46 build/C/man2/getuid.2:45
4892 msgid "These functions are always successful."
4893 msgstr ""
4894
4895 #. type: Plain text
4896 #: build/C/man2/getgid.2:46 build/C/man2/getuid.2:47
4897 msgid "POSIX.1-2001, 4.3BSD."
4898 msgstr ""
4899
4900 #. type: Plain text
4901 #: build/C/man2/getgid.2:62
4902 msgid ""
4903 "The original Linux B<getgid>()  and B<getegid>()  system calls supported "
4904 "only 16-bit group IDs.  Subsequently, Linux 2.4 added B<getgid32>()  and "
4905 "B<getegid32>(), supporting 32-bit IDs.  The glibc B<getgid>()  and "
4906 "B<getegid>()  wrapper functions transparently deal with the variations "
4907 "across kernel versions."
4908 msgstr ""
4909
4910 #. type: Plain text
4911 #: build/C/man2/getgid.2:67
4912 msgid "B<getresgid>(2), B<setgid>(2), B<setregid>(2), B<credentials>(7)"
4913 msgstr ""
4914
4915 #. type: TH
4916 #: build/C/man2/getgroups.2:31
4917 #, no-wrap
4918 msgid "GETGROUPS"
4919 msgstr ""
4920
4921 #. type: Plain text
4922 #: build/C/man2/getgroups.2:34
4923 msgid "getgroups, setgroups - get/set list of supplementary group IDs"
4924 msgstr ""
4925
4926 #. type: Plain text
4927 #: build/C/man2/getgroups.2:40
4928 msgid "B<int getgroups(int >I<size>B<, gid_t >I<list>B<[]);>"
4929 msgstr ""
4930
4931 #. type: Plain text
4932 #: build/C/man2/getgroups.2:42
4933 msgid "B<#include E<lt>grp.hE<gt>>"
4934 msgstr ""
4935
4936 #. type: Plain text
4937 #: build/C/man2/getgroups.2:44
4938 msgid "B<int setgroups(size_t >I<size>B<, const gid_t *>I<list>B<);>"
4939 msgstr ""
4940
4941 #. type: Plain text
4942 #: build/C/man2/getgroups.2:52
4943 msgid "B<setgroups>(): _BSD_SOURCE"
4944 msgstr ""
4945
4946 #. type: Plain text
4947 #: build/C/man2/getgroups.2:70
4948 msgid ""
4949 "B<getgroups>()  returns the supplementary group IDs of the calling process "
4950 "in I<list>.  The argument I<size> should be set to the maximum number of "
4951 "items that can be stored in the buffer pointed to by I<list>.  If the "
4952 "calling process is a member of more than I<size> supplementary groups, then "
4953 "an error results.  It is unspecified whether the effective group ID of the "
4954 "calling process is included in the returned list.  (Thus, an application "
4955 "should also call B<getegid>(2)  and add or remove the resulting value.)"
4956 msgstr ""
4957
4958 #. type: Plain text
4959 #: build/C/man2/getgroups.2:81
4960 msgid ""
4961 "If I<size> is zero, I<list> is not modified, but the total number of "
4962 "supplementary group IDs for the process is returned.  This allows the caller "
4963 "to determine the size of a dynamically allocated I<list> to be used in a "
4964 "further call to B<getgroups>()."
4965 msgstr ""
4966
4967 #. type: Plain text
4968 #: build/C/man2/getgroups.2:92
4969 msgid ""
4970 "B<setgroups>()  sets the supplementary group IDs for the calling process.  "
4971 "Appropriate privileges (Linux: the B<CAP_SETGID> capability) are required.  "
4972 "The I<size> argument specifies the number of supplementary group IDs in the "
4973 "buffer pointed to by I<list>."
4974 msgstr ""
4975
4976 #. type: Plain text
4977 #: build/C/man2/getgroups.2:99
4978 msgid ""
4979 "On success, B<getgroups>()  returns the number of supplementary group IDs.  "
4980 "On error, -1 is returned, and I<errno> is set appropriately."
4981 msgstr ""
4982
4983 #. type: Plain text
4984 #: build/C/man2/getgroups.2:106
4985 msgid ""
4986 "On success, B<setgroups>()  returns 0.  On error, -1 is returned, and "
4987 "I<errno> is set appropriately."
4988 msgstr ""
4989
4990 #. type: Plain text
4991 #: build/C/man2/getgroups.2:111
4992 msgid "I<list> has an invalid address."
4993 msgstr ""
4994
4995 #. type: Plain text
4996 #: build/C/man2/getgroups.2:114
4997 msgid "B<getgroups>()  can additionally fail with the following error:"
4998 msgstr ""
4999
5000 #. type: Plain text
5001 #: build/C/man2/getgroups.2:118
5002 msgid "I<size> is less than the number of supplementary group IDs, but is not zero."
5003 msgstr ""
5004
5005 #. type: Plain text
5006 #: build/C/man2/getgroups.2:121
5007 msgid "B<setgroups>()  can additionally fail with the following errors:"
5008 msgstr ""
5009
5010 #. type: Plain text
5011 #: build/C/man2/getgroups.2:127
5012 msgid ""
5013 "I<size> is greater than B<NGROUPS_MAX> (32 before Linux 2.6.4; 65536 since "
5014 "Linux 2.6.4)."
5015 msgstr ""
5016
5017 #. type: Plain text
5018 #: build/C/man2/getgroups.2:133
5019 msgid "The calling process has insufficient privilege."
5020 msgstr ""
5021
5022 #. type: Plain text
5023 #: build/C/man2/getgroups.2:141
5024 msgid ""
5025 "SVr4, 4.3BSD.  The B<getgroups>()  function is in POSIX.1-2001.  Since "
5026 "B<setgroups>()  requires privilege, it is not covered by POSIX.1-2001."
5027 msgstr ""
5028
5029 #. type: Plain text
5030 #: build/C/man2/getgroups.2:149
5031 msgid ""
5032 "A process can have up to B<NGROUPS_MAX> supplementary group IDs in addition "
5033 "to the effective group ID.  The set of supplementary group IDs is inherited "
5034 "from the parent process, and preserved across an B<execve>(2)."
5035 msgstr ""
5036
5037 #. type: Plain text
5038 #: build/C/man2/getgroups.2:152
5039 msgid ""
5040 "The maximum number of supplementary group IDs can be found using "
5041 "B<sysconf>(3):"
5042 msgstr ""
5043
5044 #. type: Plain text
5045 #: build/C/man2/getgroups.2:156
5046 #, no-wrap
5047 msgid ""
5048 "    long ngroups_max;\n"
5049 "    ngroups_max = sysconf(_SC_NGROUPS_MAX);\n"
5050 msgstr ""
5051
5052 #. type: Plain text
5053 #: build/C/man2/getgroups.2:161
5054 msgid ""
5055 "The maximum return value of B<getgroups>()  cannot be larger than one more "
5056 "than this value."
5057 msgstr ""
5058
5059 #. type: Plain text
5060 #: build/C/man2/getgroups.2:171
5061 msgid ""
5062 "The original Linux B<getgroups>()  system call supported only 16-bit group "
5063 "IDs.  Subsequently, Linux 2.4 added B<getgroups32>(), supporting 32-bit "
5064 "IDs.  The glibc B<getgroups>()  wrapper function transparently deals with "
5065 "the variation across kernel versions."
5066 msgstr ""
5067
5068 #. type: Plain text
5069 #: build/C/man2/getgroups.2:178
5070 msgid ""
5071 "B<getgid>(2), B<setgid>(2), B<getgrouplist>(3), B<initgroups>(3), "
5072 "B<capabilities>(7), B<credentials>(7)"
5073 msgstr ""
5074
5075 #. type: TH
5076 #: build/C/man2/getpid.2:25
5077 #, no-wrap
5078 msgid "GETPID"
5079 msgstr ""
5080
5081 #. type: TH
5082 #: build/C/man2/getpid.2:25
5083 #, no-wrap
5084 msgid "2008-09-23"
5085 msgstr ""
5086
5087 #. type: Plain text
5088 #: build/C/man2/getpid.2:28
5089 msgid "getpid, getppid - get process identification"
5090 msgstr ""
5091
5092 #. type: Plain text
5093 #: build/C/man2/getpid.2:34
5094 msgid "B<pid_t getpid(void);>"
5095 msgstr ""
5096
5097 #. type: Plain text
5098 #: build/C/man2/getpid.2:36
5099 msgid "B<pid_t getppid(void);>"
5100 msgstr ""
5101
5102 #. type: Plain text
5103 #: build/C/man2/getpid.2:41
5104 msgid ""
5105 "B<getpid>()  returns the process ID of the calling process.  (This is often "
5106 "used by routines that generate unique temporary filenames.)"
5107 msgstr ""
5108
5109 #. type: Plain text
5110 #: build/C/man2/getpid.2:44
5111 msgid "B<getppid>()  returns the process ID of the parent of the calling process."
5112 msgstr ""
5113
5114 #. type: Plain text
5115 #: build/C/man2/getpid.2:48
5116 msgid "POSIX.1-2001, 4.3BSD, SVr4."
5117 msgstr ""
5118
5119 #.  The following program demonstrates this "feature":
5120 #
5121 #.  #define _GNU_SOURCE
5122 #.  #include <sys/syscall.h>
5123 #.  #include <sys/wait.h>
5124 #.  #include <stdio.h>
5125 #.  #include <stdlib.h>
5126 #.  #include <unistd.h>
5127 #
5128 #.  int
5129 #.  main(int argc, char *argv[])
5130 #.  {
5131 #.     /* The following statement fills the getpid() cache */
5132 #
5133 #.     printf("parent PID = %ld
5134 #. ", (long) getpid());
5135 #
5136 #.     if (syscall(SYS_fork) == 0) {
5137 #.         if (getpid() != syscall(SYS_getpid))
5138 #.             printf("child getpid() mismatch: getpid()=%ld; "
5139 #.                     "syscall(SYS_getpid)=%ld
5140 #. ",
5141 #.                     (long) getpid(), (long) syscall(SYS_getpid));
5142 #.         exit(EXIT_SUCCESS);
5143 #.     }
5144 #.     wait(NULL);
5145 #. }
5146 #. type: Plain text
5147 #: build/C/man2/getpid.2:100
5148 msgid ""
5149 "Since glibc version 2.3.4, the glibc wrapper function for B<getpid>()  "
5150 "caches PIDs, so as to avoid additional system calls when a process calls "
5151 "B<getpid>()  repeatedly.  Normally this caching is invisible, but its "
5152 "correct operation relies on support in the wrapper functions for B<fork>(2), "
5153 "B<vfork>(2), and B<clone>(2): if an application bypasses the glibc wrappers "
5154 "for these system calls by using B<syscall>(2), then a call to B<getpid>()  "
5155 "in the child will return the wrong value (to be precise: it will return the "
5156 "PID of the parent process).  See also B<clone>(2)  for discussion of a case "
5157 "where B<getpid>()  may return the wrong value even when invoking B<clone>(2)  "
5158 "via the glibc wrapper function."
5159 msgstr ""
5160
5161 #. type: Plain text
5162 #: build/C/man2/getpid.2:110
5163 msgid ""
5164 "B<clone>(2), B<fork>(2), B<kill>(2), B<exec>(3), B<mkstemp>(3), "
5165 "B<tempnam>(3), B<tmpfile>(3), B<tmpnam>(3), B<credentials>(7)"
5166 msgstr ""
5167
5168 #. type: TH
5169 #: build/C/man2/getpriority.2:48
5170 #, no-wrap
5171 msgid "GETPRIORITY"
5172 msgstr ""
5173
5174 #. type: Plain text
5175 #: build/C/man2/getpriority.2:51
5176 msgid "getpriority, setpriority - get/set program scheduling priority"
5177 msgstr ""
5178
5179 #. type: Plain text
5180 #: build/C/man2/getpriority.2:53 build/C/man2/getrlimit.2:69 build/C/man2/getrusage.2:44
5181 msgid "B<#include E<lt>sys/time.hE<gt>>"
5182 msgstr ""
5183
5184 #. type: Plain text
5185 #: build/C/man2/getpriority.2:55 build/C/man2/getrlimit.2:71 build/C/man2/getrusage.2:46
5186 msgid "B<#include E<lt>sys/resource.hE<gt>>"
5187 msgstr ""
5188
5189 #. type: Plain text
5190 #: build/C/man2/getpriority.2:57
5191 msgid "B<int getpriority(int >I<which>B<, int >I<who>B<);>"
5192 msgstr ""
5193
5194 #. type: Plain text
5195 #: build/C/man2/getpriority.2:59
5196 msgid "B<int setpriority(int >I<which>B<, int >I<who>B<, int >I<prio>B<);>"
5197 msgstr ""
5198
5199 #. type: Plain text
5200 #: build/C/man2/getpriority.2:70
5201 msgid ""
5202 "The scheduling priority of the process, process group, or user, as indicated "
5203 "by I<which> and I<who> is obtained with the B<getpriority>()  call and set "
5204 "with the B<setpriority>()  call."
5205 msgstr ""
5206
5207 #. type: Plain text
5208 #: build/C/man2/getpriority.2:97
5209 msgid ""
5210 "The value I<which> is one of B<PRIO_PROCESS>, B<PRIO_PGRP>, or B<PRIO_USER>, "
5211 "and I<who> is interpreted relative to I<which> (a process identifier for "
5212 "B<PRIO_PROCESS>, process group identifier for B<PRIO_PGRP>, and a user ID "
5213 "for B<PRIO_USER>).  A zero value for I<who> denotes (respectively) the "
5214 "calling process, the process group of the calling process, or the real user "
5215 "ID of the calling process.  I<Prio> is a value in the range -20 to 19 (but "
5216 "see the Notes below).  The default priority is 0; lower priorities cause "
5217 "more favorable scheduling."
5218 msgstr ""
5219
5220 #. type: Plain text
5221 #: build/C/man2/getpriority.2:107
5222 msgid ""
5223 "The B<getpriority>()  call returns the highest priority (lowest numerical "
5224 "value)  enjoyed by any of the specified processes.  The B<setpriority>()  "
5225 "call sets the priorities of all of the specified processes to the specified "
5226 "value.  Only the superuser may lower priorities."
5227 msgstr ""
5228
5229 #. type: Plain text
5230 #: build/C/man2/getpriority.2:120
5231 msgid ""
5232 "Since B<getpriority>()  can legitimately return the value -1, it is "
5233 "necessary to clear the external variable I<errno> prior to the call, then "
5234 "check it afterward to determine if -1 is an error or a legitimate value.  "
5235 "The B<setpriority>()  call returns 0 if there is no error, or -1 if there "
5236 "is."
5237 msgstr ""
5238
5239 #. type: Plain text
5240 #: build/C/man2/getpriority.2:129
5241 msgid "I<which> was not one of B<PRIO_PROCESS>, B<PRIO_PGRP>, or B<PRIO_USER>."
5242 msgstr ""
5243
5244 #. type: Plain text
5245 #: build/C/man2/getpriority.2:136
5246 msgid "No process was located using the I<which> and I<who> values specified."
5247 msgstr ""
5248
5249 #. type: Plain text
5250 #: build/C/man2/getpriority.2:140
5251 msgid "In addition to the errors indicated above, B<setpriority>()  may fail if:"
5252 msgstr ""
5253
5254 #. type: Plain text
5255 #: build/C/man2/getpriority.2:152
5256 msgid ""
5257 "The caller attempted to lower a process priority, but did not have the "
5258 "required privilege (on Linux: did not have the B<CAP_SYS_NICE> capability).  "
5259 "Since Linux 2.6.12, this error occurs only if the caller attempts to set a "
5260 "process priority outside the range of the B<RLIMIT_NICE> soft resource limit "
5261 "of the target process; see B<getrlimit>(2)  for details."
5262 msgstr ""
5263
5264 #. type: Plain text
5265 #: build/C/man2/getpriority.2:160
5266 msgid ""
5267 "A process was located, but its effective user ID did not match either the "
5268 "effective or the real user ID of the caller, and was not privileged (on "
5269 "Linux: did not have the B<CAP_SYS_NICE> capability).  But see NOTES below."
5270 msgstr ""
5271
5272 #. type: Plain text
5273 #: build/C/man2/getpriority.2:163
5274 msgid "SVr4, 4.4BSD (these function calls first appeared in 4.2BSD), POSIX.1-2001."
5275 msgstr ""
5276
5277 #. type: Plain text
5278 #: build/C/man2/getpriority.2:169
5279 msgid ""
5280 "A child created by B<fork>(2)  inherits its parent's nice value.  The nice "
5281 "value is preserved across B<execve>(2)."
5282 msgstr ""
5283
5284 #. type: Plain text
5285 #: build/C/man2/getpriority.2:180
5286 msgid ""
5287 "The degree to which their relative nice value affects the scheduling of "
5288 "processes varies across UNIX systems, and, on Linux, across kernel "
5289 "versions.  Starting with kernel 2.6.23, Linux adopted an algorithm that "
5290 "causes relative differences in nice values to have a much stronger effect.  "
5291 "This causes very low nice values (+19) to truly provide little CPU to a "
5292 "process whenever there is any other higher priority load on the system, and "
5293 "makes high nice values (-20) deliver most of the CPU to applications that "
5294 "require it (e.g., some audio applications)."
5295 msgstr ""
5296
5297 #. type: Plain text
5298 #: build/C/man2/getpriority.2:195
5299 msgid ""
5300 "The details on the condition for B<EPERM> depend on the system.  The above "
5301 "description is what POSIX.1-2001 says, and seems to be followed on all "
5302 "System V-like systems.  Linux kernels before 2.6.12 required the real or "
5303 "effective user ID of the caller to match the real user of the process I<who> "
5304 "(instead of its effective user ID).  Linux 2.6.12 and later require the "
5305 "effective user ID of the caller to match the real or effective user ID of "
5306 "the process I<who>.  All BSD-like systems (SunOS 4.1.3, Ultrix 4.2, 4.3BSD, "
5307 "FreeBSD 4.3, OpenBSD-2.5, ...) behave in the same manner as Linux 2.6.12 and "
5308 "later."
5309 msgstr ""
5310
5311 #. type: Plain text
5312 #: build/C/man2/getpriority.2:211
5313 msgid ""
5314 "The actual priority range varies between kernel versions.  Linux before "
5315 "1.3.36 had -infinity..15.  Since kernel 1.3.43, Linux has the range "
5316 "-20..19.  Within the kernel, nice values are actually represented using the "
5317 "corresponding range 40..1 (since negative numbers are error codes) and these "
5318 "are the values employed by the B<setpriority>()  and B<getpriority>()  "
5319 "system calls.  The glibc wrapper functions for these system calls handle the "
5320 "translations between the user-land and kernel representations of the nice "
5321 "value according to the formula I<unice\\ =\\ 20\\ -\\ knice>."
5322 msgstr ""
5323
5324 #. type: Plain text
5325 #: build/C/man2/getpriority.2:213
5326 msgid "On some systems, the range of nice values is -20..20."
5327 msgstr ""
5328
5329 #. type: Plain text
5330 #: build/C/man2/getpriority.2:225
5331 msgid ""
5332 "Including I<E<lt>sys/time.hE<gt>> is not required these days, but increases "
5333 "portability.  (Indeed, I<E<lt>sys/resource.hE<gt>> defines the I<rusage> "
5334 "structure with fields of type I<struct timeval> defined in "
5335 "I<E<lt>sys/time.hE<gt>>.)"
5336 msgstr ""
5337
5338 #. type: Plain text
5339 #: build/C/man2/getpriority.2:232
5340 msgid ""
5341 "According to POSIX, the nice value is a per-process setting.  However, under "
5342 "the current Linux/NPTL implementation of POSIX threads, the nice value is a "
5343 "per-thread attribute: different threads in the same process can have "
5344 "different nice values.  Portable applications should avoid relying on the "
5345 "Linux behavior, which may be made standards conformant in the future."
5346 msgstr ""
5347
5348 #. type: Plain text
5349 #: build/C/man2/getpriority.2:237
5350 msgid "B<nice>(1), B<renice>(1), B<fork>(2), B<capabilities>(7)"
5351 msgstr ""
5352
5353 #. type: Plain text
5354 #: build/C/man2/getpriority.2:240
5355 msgid ""
5356 "I<Documentation/scheduler/sched-nice-design.txt> in the Linux kernel source "
5357 "tree (since Linux 2.6.23)"
5358 msgstr ""
5359
5360 #. type: TH
5361 #: build/C/man2/getresuid.2:28
5362 #, no-wrap
5363 msgid "GETRESUID"
5364 msgstr ""
5365
5366 #. type: Plain text
5367 #: build/C/man2/getresuid.2:31
5368 msgid "getresuid, getresgid - get real, effective and saved user/group IDs"
5369 msgstr ""
5370
5371 #. type: Plain text
5372 #: build/C/man2/getresuid.2:33 build/C/man2/setresuid.2:31
5373 msgid "B<#define _GNU_SOURCE> /* See feature_test_macros(7) */"
5374 msgstr ""
5375
5376 #. type: Plain text
5377 #: build/C/man2/getresuid.2:37
5378 msgid "B<int getresuid(uid_t *>I<ruid>B<, uid_t *>I<euid>B<, uid_t *>I<suid>B<);>"
5379 msgstr ""
5380
5381 #. type: Plain text
5382 #: build/C/man2/getresuid.2:39
5383 msgid "B<int getresgid(gid_t *>I<rgid>B<, gid_t *>I<egid>B<, gid_t *>I<sgid>B<);>"
5384 msgstr ""
5385
5386 #. type: Plain text
5387 #: build/C/man2/getresuid.2:50
5388 msgid ""
5389 "B<getresuid>()  returns the real UID, the effective UID, and the saved "
5390 "set-user-ID of the calling process, in the arguments I<ruid>, I<euid>, and "
5391 "I<suid>, respectively.  B<getresgid>()  performs the analogous task for the "
5392 "process's group IDs."
5393 msgstr ""
5394
5395 #. type: Plain text
5396 #: build/C/man2/getresuid.2:60
5397 msgid ""
5398 "One of the arguments specified an address outside the calling program's "
5399 "address space."
5400 msgstr ""
5401
5402 #. type: Plain text
5403 #: build/C/man2/getresuid.2:62
5404 msgid "These system calls appeared on Linux starting with kernel 2.1.44."
5405 msgstr ""
5406
5407 #. type: Plain text
5408 #: build/C/man2/getresuid.2:67
5409 msgid ""
5410 "The prototypes are given by glibc since version 2.3.2, provided "
5411 "B<_GNU_SOURCE> is defined."
5412 msgstr ""
5413
5414 #. type: Plain text
5415 #: build/C/man2/getresuid.2:70 build/C/man2/setresuid.2:86
5416 msgid "These calls are nonstandard; they also appear on HP-UX and some of the BSDs."
5417 msgstr ""
5418
5419 #. type: Plain text
5420 #: build/C/man2/getresuid.2:86
5421 msgid ""
5422 "The original Linux B<getresuid>()  and B<getresgid>()  system calls "
5423 "supported only 16-bit user and group IDs.  Subsequently, Linux 2.4 added "
5424 "B<getresuid32>()  and B<getresgid32>(), supporting 32-bit IDs.  The glibc "
5425 "B<getresuid>()  and B<getresgid>()  wrapper functions transparently deal "
5426 "with the variations across kernel versions."
5427 msgstr ""
5428
5429 #. type: Plain text
5430 #: build/C/man2/getresuid.2:92
5431 msgid ""
5432 "B<getuid>(2), B<setresuid>(2), B<setreuid>(2), B<setuid>(2), "
5433 "B<credentials>(7)"
5434 msgstr ""
5435
5436 #. type: TH
5437 #: build/C/man2/getrlimit.2:64
5438 #, no-wrap
5439 msgid "GETRLIMIT"
5440 msgstr ""
5441
5442 #. type: TH
5443 #: build/C/man2/getrlimit.2:64 build/C/man2/setsid.2:30
5444 #, no-wrap
5445 msgid "2013-02-11"
5446 msgstr ""
5447
5448 #. type: Plain text
5449 #: build/C/man2/getrlimit.2:67
5450 msgid "getrlimit, setrlimit, prlimit - get/set resource limits"
5451 msgstr ""
5452
5453 #. type: Plain text
5454 #: build/C/man2/getrlimit.2:73
5455 msgid "B<int getrlimit(int >I<resource>B<, struct rlimit *>I<rlim>B<);>"
5456 msgstr ""
5457
5458 #. type: Plain text
5459 #: build/C/man2/getrlimit.2:75
5460 msgid "B<int setrlimit(int >I<resource>B<, const struct rlimit *>I<rlim>B<);>"
5461 msgstr ""
5462
5463 #. type: Plain text
5464 #: build/C/man2/getrlimit.2:78
5465 msgid ""
5466 "B<int prlimit(pid_t >I<pid>B<, int >I<resource>B<, const struct rlimit "
5467 "*>I<new_limit>B<,>"
5468 msgstr ""
5469
5470 #. type: Plain text
5471 #: build/C/man2/getrlimit.2:80
5472 msgid "B< struct rlimit *>I<old_limit>B<);>"
5473 msgstr ""
5474
5475 #. type: Plain text
5476 #: build/C/man2/getrlimit.2:88
5477 msgid "B<prlimit>(): _GNU_SOURCE && _FILE_OFFSET_BITS == 64"
5478 msgstr ""
5479
5480 #. type: Plain text
5481 #: build/C/man2/getrlimit.2:97
5482 msgid ""
5483 "The B<getrlimit>()  and B<setrlimit>()  system calls get and set resource "
5484 "limits respectively.  Each resource has an associated soft and hard limit, "
5485 "as defined by the I<rlimit> structure:"
5486 msgstr ""
5487
5488 #. type: Plain text
5489 #: build/C/man2/getrlimit.2:104
5490 #, no-wrap
5491 msgid ""
5492 "struct rlimit {\n"
5493 "    rlim_t rlim_cur;  /* Soft limit */\n"
5494 "    rlim_t rlim_max;  /* Hard limit (ceiling for rlim_cur) */\n"
5495 "};\n"
5496 msgstr ""
5497
5498 #. type: Plain text
5499 #: build/C/man2/getrlimit.2:115
5500 msgid ""
5501 "The soft limit is the value that the kernel enforces for the corresponding "
5502 "resource.  The hard limit acts as a ceiling for the soft limit: an "
5503 "unprivileged process may set only its soft limit to a value in the range "
5504 "from 0 up to the hard limit, and (irreversibly) lower its hard limit.  A "
5505 "privileged process (under Linux: one with the B<CAP_SYS_RESOURCE> "
5506 "capability) may make arbitrary changes to either limit value."
5507 msgstr ""
5508
5509 #. type: Plain text
5510 #: build/C/man2/getrlimit.2:122
5511 msgid ""
5512 "The value B<RLIM_INFINITY> denotes no limit on a resource (both in the "
5513 "structure returned by B<getrlimit>()  and in the structure passed to "
5514 "B<setrlimit>())."
5515 msgstr ""
5516
5517 #. type: Plain text
5518 #: build/C/man2/getrlimit.2:126
5519 msgid "The I<resource> argument must be one of:"
5520 msgstr ""
5521
5522 #. type: TP
5523 #: build/C/man2/getrlimit.2:126
5524 #, no-wrap
5525 msgid "B<RLIMIT_AS>"
5526 msgstr ""
5527
5528 #.  since 2.0.27 / 2.1.12
5529 #. type: Plain text
5530 #: build/C/man2/getrlimit.2:146
5531 msgid ""
5532 "The maximum size of the process's virtual memory (address space) in bytes.  "
5533 "This limit affects calls to B<brk>(2), B<mmap>(2)  and B<mremap>(2), which "
5534 "fail with the error B<ENOMEM> upon exceeding this limit.  Also automatic "
5535 "stack expansion will fail (and generate a B<SIGSEGV> that kills the process "
5536 "if no alternate stack has been made available via B<sigaltstack>(2)).  Since "
5537 "the value is a I<long>, on machines with a 32-bit I<long> either this limit "
5538 "is at most 2 GiB, or this resource is unlimited."
5539 msgstr ""
5540
5541 #. type: TP
5542 #: build/C/man2/getrlimit.2:146
5543 #, no-wrap
5544 msgid "B<RLIMIT_CORE>"
5545 msgstr ""
5546
5547 #. type: Plain text
5548 #: build/C/man2/getrlimit.2:153
5549 msgid ""
5550 "Maximum size of I<core> file.  When 0 no core dump files are created.  When "
5551 "nonzero, larger dumps are truncated to this size."
5552 msgstr ""
5553
5554 #. type: TP
5555 #: build/C/man2/getrlimit.2:153
5556 #, no-wrap
5557 msgid "B<RLIMIT_CPU>"
5558 msgstr ""
5559
5560 #. type: Plain text
5561 #: build/C/man2/getrlimit.2:173
5562 msgid ""
5563 "CPU time limit in seconds.  When the process reaches the soft limit, it is "
5564 "sent a B<SIGXCPU> signal.  The default action for this signal is to "
5565 "terminate the process.  However, the signal can be caught, and the handler "
5566 "can return control to the main program.  If the process continues to consume "
5567 "CPU time, it will be sent B<SIGXCPU> once per second until the hard limit is "
5568 "reached, at which time it is sent B<SIGKILL>.  (This latter point describes "
5569 "Linux behavior.  Implementations vary in how they treat processes which "
5570 "continue to consume CPU time after reaching the soft limit.  Portable "
5571 "applications that need to catch this signal should perform an orderly "
5572 "termination upon first receipt of B<SIGXCPU>.)"
5573 msgstr ""
5574
5575 #. type: TP
5576 #: build/C/man2/getrlimit.2:173
5577 #, no-wrap
5578 msgid "B<RLIMIT_DATA>"
5579 msgstr ""
5580
5581 #. type: Plain text
5582 #: build/C/man2/getrlimit.2:184
5583 msgid ""
5584 "The maximum size of the process's data segment (initialized data, "
5585 "uninitialized data, and heap).  This limit affects calls to B<brk>(2)  and "
5586 "B<sbrk>(2), which fail with the error B<ENOMEM> upon encountering the soft "
5587 "limit of this resource."
5588 msgstr ""
5589
5590 #. type: TP
5591 #: build/C/man2/getrlimit.2:184
5592 #, no-wrap
5593 msgid "B<RLIMIT_FSIZE>"
5594 msgstr ""
5595
5596 #. type: Plain text
5597 #: build/C/man2/getrlimit.2:196
5598 msgid ""
5599 "The maximum size of files that the process may create.  Attempts to extend a "
5600 "file beyond this limit result in delivery of a B<SIGXFSZ> signal.  By "
5601 "default, this signal terminates a process, but a process can catch this "
5602 "signal instead, in which case the relevant system call (e.g., B<write>(2), "
5603 "B<truncate>(2))  fails with the error B<EFBIG>."
5604 msgstr ""
5605
5606 #. type: TP
5607 #: build/C/man2/getrlimit.2:196
5608 #, no-wrap
5609 msgid "B<RLIMIT_LOCKS> (Early Linux 2.4 only)"
5610 msgstr ""
5611
5612 #.  to be precise: Linux 2.4.0-test9; no longer in 2.4.25 / 2.5.65
5613 #. type: Plain text
5614 #: build/C/man2/getrlimit.2:204
5615 msgid ""
5616 "A limit on the combined number of B<flock>(2)  locks and B<fcntl>(2)  leases "
5617 "that this process may establish."
5618 msgstr ""
5619
5620 #. type: TP
5621 #: build/C/man2/getrlimit.2:204
5622 #, no-wrap
5623 msgid "B<RLIMIT_MEMLOCK>"
5624 msgstr ""
5625
5626 #. type: Plain text
5627 #: build/C/man2/getrlimit.2:242
5628 msgid ""
5629 "The maximum number of bytes of memory that may be locked into RAM.  In "
5630 "effect this limit is rounded down to the nearest multiple of the system page "
5631 "size.  This limit affects B<mlock>(2)  and B<mlockall>(2)  and the "
5632 "B<mmap>(2)  B<MAP_LOCKED> operation.  Since Linux 2.6.9 it also affects the "
5633 "B<shmctl>(2)  B<SHM_LOCK> operation, where it sets a maximum on the total "
5634 "bytes in shared memory segments (see B<shmget>(2))  that may be locked by "
5635 "the real user ID of the calling process.  The B<shmctl>(2)  B<SHM_LOCK> "
5636 "locks are accounted for separately from the per-process memory locks "
5637 "established by B<mlock>(2), B<mlockall>(2), and B<mmap>(2)  B<MAP_LOCKED>; a "
5638 "process can lock bytes up to this limit in each of these two categories.  In "
5639 "Linux kernels before 2.6.9, this limit controlled the amount of memory that "
5640 "could be locked by a privileged process.  Since Linux 2.6.9, no limits are "
5641 "placed on the amount of memory that a privileged process may lock, and this "
5642 "limit instead governs the amount of memory that an unprivileged process may "
5643 "lock."
5644 msgstr ""
5645
5646 #. type: TP
5647 #: build/C/man2/getrlimit.2:242
5648 #, no-wrap
5649 msgid "B<RLIMIT_MSGQUEUE> (Since Linux 2.6.8)"
5650 msgstr ""
5651
5652 #. type: Plain text
5653 #: build/C/man2/getrlimit.2:250
5654 msgid ""
5655 "Specifies the limit on the number of bytes that can be allocated for POSIX "
5656 "message queues for the real user ID of the calling process.  This limit is "
5657 "enforced for B<mq_open>(3).  Each message queue that the user creates counts "
5658 "(until it is removed)  against this limit according to the formula:"
5659 msgstr ""
5660
5661 #. type: Plain text
5662 #: build/C/man2/getrlimit.2:254
5663 #, no-wrap
5664 msgid ""
5665 "    bytes = attr.mq_maxmsg * sizeof(struct msg_msg *) +\n"
5666 "            attr.mq_maxmsg * attr.mq_msgsize\n"
5667 msgstr ""
5668
5669 #. type: Plain text
5670 #: build/C/man2/getrlimit.2:262
5671 msgid ""
5672 "where I<attr> is the I<mq_attr> structure specified as the fourth argument "
5673 "to B<mq_open>(3)."
5674 msgstr ""
5675
5676 #. type: Plain text
5677 #: build/C/man2/getrlimit.2:268
5678 msgid ""
5679 "The first addend in the formula, which includes I<sizeof(struct msg_msg\\ "
5680 "*)> (4 bytes on Linux/i386), ensures that the user cannot create an "
5681 "unlimited number of zero-length messages (such messages nevertheless each "
5682 "consume some system memory for bookkeeping overhead)."
5683 msgstr ""
5684
5685 #. type: TP
5686 #: build/C/man2/getrlimit.2:268
5687 #, no-wrap
5688 msgid "B<RLIMIT_NICE> (since Linux 2.6.12, but see BUGS below)"
5689 msgstr ""
5690
5691 #. type: Plain text
5692 #: build/C/man2/getrlimit.2:281
5693 msgid ""
5694 "Specifies a ceiling to which the process's nice value can be raised using "
5695 "B<setpriority>(2)  or B<nice>(2).  The actual ceiling for the nice value is "
5696 "calculated as I<20\\ -\\ rlim_cur>.  (This strangeness occurs because "
5697 "negative numbers cannot be specified as resource limit values, since they "
5698 "typically have special meanings.  For example, B<RLIM_INFINITY> typically is "
5699 "the same as -1.)"
5700 msgstr ""
5701
5702 #. type: TP
5703 #: build/C/man2/getrlimit.2:281
5704 #, no-wrap
5705 msgid "B<RLIMIT_NOFILE>"
5706 msgstr ""
5707
5708 #. type: Plain text
5709 #: build/C/man2/getrlimit.2:295
5710 msgid ""
5711 "Specifies a value one greater than the maximum file descriptor number that "
5712 "can be opened by this process.  Attempts (B<open>(2), B<pipe>(2), B<dup>(2), "
5713 "etc.)  to exceed this limit yield the error B<EMFILE>.  (Historically, this "
5714 "limit was named B<RLIMIT_OFILE> on BSD.)"
5715 msgstr ""
5716
5717 #. type: TP
5718 #: build/C/man2/getrlimit.2:295
5719 #, no-wrap
5720 msgid "B<RLIMIT_NPROC>"
5721 msgstr ""
5722
5723 #. type: Plain text
5724 #: build/C/man2/getrlimit.2:303
5725 msgid ""
5726 "The maximum number of processes (or, more precisely on Linux, threads)  that "
5727 "can be created for the real user ID of the calling process.  Upon "
5728 "encountering this limit, B<fork>(2)  fails with the error B<EAGAIN>."
5729 msgstr ""
5730
5731 #. type: TP
5732 #: build/C/man2/getrlimit.2:303
5733 #, no-wrap
5734 msgid "B<RLIMIT_RSS>"
5735 msgstr ""
5736
5737 #.  As at kernel 2.6.12, this limit still does nothing in 2.6 though
5738 #.  talk of making it do something has surfaced from time to time in LKML
5739 #.        -- MTK, Jul 05
5740 #. type: Plain text
5741 #: build/C/man2/getrlimit.2:315
5742 msgid ""
5743 "Specifies the limit (in pages) of the process's resident set (the number of "
5744 "virtual pages resident in RAM).  This limit has effect only in Linux 2.4.x, "
5745 "x E<lt> 30, and there affects only calls to B<madvise>(2)  specifying "
5746 "B<MADV_WILLNEED>."
5747 msgstr ""
5748
5749 #. type: TP
5750 #: build/C/man2/getrlimit.2:315
5751 #, no-wrap
5752 msgid "B<RLIMIT_RTPRIO> (Since Linux 2.6.12, but see BUGS)"
5753 msgstr ""
5754
5755 #. type: Plain text
5756 #: build/C/man2/getrlimit.2:322
5757 msgid ""
5758 "Specifies a ceiling on the real-time priority that may be set for this "
5759 "process using B<sched_setscheduler>(2)  and B<sched_setparam>(2)."
5760 msgstr ""
5761
5762 #. type: TP
5763 #: build/C/man2/getrlimit.2:322
5764 #, no-wrap
5765 msgid "B<RLIMIT_RTTIME> (Since Linux 2.6.25)"
5766 msgstr ""
5767
5768 #. type: Plain text
5769 #: build/C/man2/getrlimit.2:334
5770 msgid ""
5771 "Specifies a limit (in microseconds)  on the amount of CPU time that a "
5772 "process scheduled under a real-time scheduling policy may consume without "
5773 "making a blocking system call.  For the purpose of this limit, each time a "
5774 "process makes a blocking system call, the count of its consumed CPU time is "
5775 "reset to zero.  The CPU time count is not reset if the process continues "
5776 "trying to use the CPU but is preempted, its time slice expires, or it calls "
5777 "B<sched_yield>(2)."
5778 msgstr ""
5779
5780 #. type: Plain text
5781 #: build/C/man2/getrlimit.2:345
5782 msgid ""
5783 "Upon reaching the soft limit, the process is sent a B<SIGXCPU> signal.  If "
5784 "the process catches or ignores this signal and continues consuming CPU time, "
5785 "then B<SIGXCPU> will be generated once each second until the hard limit is "
5786 "reached, at which point the process is sent a B<SIGKILL> signal."
5787 msgstr ""
5788
5789 #. type: Plain text
5790 #: build/C/man2/getrlimit.2:348
5791 msgid ""
5792 "The intended use of this limit is to stop a runaway real-time process from "
5793 "locking up the system."
5794 msgstr ""
5795
5796 #. type: TP
5797 #: build/C/man2/getrlimit.2:348
5798 #, no-wrap
5799 msgid "B<RLIMIT_SIGPENDING> (Since Linux 2.6.8)"
5800 msgstr ""
5801
5802 #.  This replaces the /proc/sys/kernel/rtsig-max system-wide limit
5803 #.  that was present in kernels <= 2.6.7.  MTK Dec 04
5804 #. type: Plain text
5805 #: build/C/man2/getrlimit.2:362
5806 msgid ""
5807 "Specifies the limit on the number of signals that may be queued for the real "
5808 "user ID of the calling process.  Both standard and real-time signals are "
5809 "counted for the purpose of checking this limit.  However, the limit is "
5810 "enforced only for B<sigqueue>(3); it is always possible to use B<kill>(2)  "
5811 "to queue one instance of any of the signals that are not already queued to "
5812 "the process."
5813 msgstr ""
5814
5815 #. type: TP
5816 #: build/C/man2/getrlimit.2:362
5817 #, no-wrap
5818 msgid "B<RLIMIT_STACK>"
5819 msgstr ""
5820
5821 #. type: Plain text
5822 #: build/C/man2/getrlimit.2:370
5823 msgid ""
5824 "The maximum size of the process stack, in bytes.  Upon reaching this limit, "
5825 "a B<SIGSEGV> signal is generated.  To handle this signal, a process must "
5826 "employ an alternate signal stack (B<sigaltstack>(2))."
5827 msgstr ""
5828
5829 #. type: Plain text
5830 #: build/C/man2/getrlimit.2:375
5831 msgid ""
5832 "Since Linux 2.6.23, this limit also determines the amount of space used for "
5833 "the process's command-line arguments and environment variables; for details, "
5834 "see B<execve>(2)."
5835 msgstr ""
5836
5837 #. type: SS
5838 #: build/C/man2/getrlimit.2:375
5839 #, no-wrap
5840 msgid "prlimit()"
5841 msgstr ""
5842
5843 #.  commit c022a0acad534fd5f5d5f17280f6d4d135e74e81
5844 #.  Author: Jiri Slaby <jslaby@suse.cz>
5845 #.  Date:   Tue May 4 18:03:50 2010 +0200
5846 #. type: Plain text
5847 #: build/C/man2/getrlimit.2:386
5848 msgid ""
5849 "The Linux-specific B<prlimit>()  system call combines and extends the "
5850 "functionality of B<setrlimit>()  and B<getrlimit>().  It can be used to both "
5851 "set and get the resource limits of an arbitrary process."
5852 msgstr ""
5853
5854 #. type: Plain text
5855 #: build/C/man2/getrlimit.2:393
5856 msgid ""
5857 "The I<resource> argument has the same meaning as for B<setrlimit>()  and "
5858 "B<getrlimit>()."
5859 msgstr ""
5860
5861 #. type: Plain text
5862 #: build/C/man2/getrlimit.2:411
5863 msgid ""
5864 "If the I<new_limit> argument is a not NULL, then the I<rlimit> structure to "
5865 "which it points is used to set new values for the soft and hard limits for "
5866 "I<resource>.  If the I<old_limit> argument is a not NULL, then a successful "
5867 "call to B<prlimit>()  places the previous soft and hard limits for "
5868 "I<resource> in the I<rlimit> structure pointed to by I<old_limit>."
5869 msgstr ""
5870
5871 #.  FIXME this permission check is strange
5872 #.  Asked about this on LKML, 7 Nov 2010
5873 #.      "Inconsistent credential checking in prlimit() syscall"
5874 #. type: Plain text
5875 #: build/C/man2/getrlimit.2:430
5876 msgid ""
5877 "The I<pid> argument specifies the ID of the process on which the call is to "
5878 "operate.  If I<pid> is 0, then the call applies to the calling process.  To "
5879 "set or get the resources of a process other than itself, the caller must "
5880 "have the B<CAP_SYS_RESOURCE> capability, or the real, effective, and saved "
5881 "set user IDs of the target process must match the real user ID of the caller "
5882 "I<and> the real, effective, and saved set group IDs of the target process "
5883 "must match the real group ID of the caller."
5884 msgstr ""
5885
5886 #. type: Plain text
5887 #: build/C/man2/getrlimit.2:435
5888 msgid ""
5889 "On success, these system calls return 0.  On error, -1 is returned, and "
5890 "I<errno> is set appropriately."
5891 msgstr ""
5892
5893 #. type: Plain text
5894 #: build/C/man2/getrlimit.2:440
5895 msgid ""
5896 "A pointer argument points to a location outside the accessible address "
5897 "space."
5898 msgstr ""
5899
5900 #. type: Plain text
5901 #: build/C/man2/getrlimit.2:452
5902 msgid ""
5903 "The value specified in I<resource> is not valid; or, for B<setrlimit>()  or "
5904 "B<prlimit>(): I<rlim-E<gt>rlim_cur> was greater than I<rlim-E<gt>rlim_max>."
5905 msgstr ""
5906
5907 #. type: Plain text
5908 #: build/C/man2/getrlimit.2:464
5909 msgid ""
5910 "An unprivileged process tried to raise the hard limit; the "
5911 "B<CAP_SYS_RESOURCE> capability is required to do this.  Or, the caller tried "
5912 "to increase the hard B<RLIMIT_NOFILE> limit above the current kernel maximum "
5913 "(B<NR_OPEN>).  Or, the calling process did not have permission to set limits "
5914 "for the process specified by I<pid>."
5915 msgstr ""
5916
5917 #. type: Plain text
5918 #: build/C/man2/getrlimit.2:468
5919 msgid "Could not find a process with the ID specified in I<pid>."
5920 msgstr ""
5921
5922 #. type: Plain text
5923 #: build/C/man2/getrlimit.2:473
5924 msgid ""
5925 "The B<prlimit>()  system call is available since Linux 2.6.36.  Library "
5926 "support is available since glibc 2.13."
5927 msgstr ""
5928
5929 #. type: Plain text
5930 #: build/C/man2/getrlimit.2:477
5931 msgid "B<getrlimit>(), B<setrlimit>(): SVr4, 4.3BSD, POSIX.1-2001."
5932 msgstr ""
5933
5934 #. type: Plain text
5935 #: build/C/man2/getrlimit.2:480
5936 msgid "B<prlimit>(): Linux-specific."
5937 msgstr ""
5938
5939 #. type: Plain text
5940 #: build/C/man2/getrlimit.2:496
5941 msgid ""
5942 "B<RLIMIT_MEMLOCK> and B<RLIMIT_NPROC> derive from BSD and are not specified "
5943 "in POSIX.1-2001; they are present on the BSDs and Linux, but on few other "
5944 "implementations.  B<RLIMIT_RSS> derives from BSD and is not specified in "
5945 "POSIX.1-2001; it is nevertheless present on most implementations.  "
5946 "B<RLIMIT_MSGQUEUE>, B<RLIMIT_NICE>, B<RLIMIT_RTPRIO>, B<RLIMIT_RTTIME>, and "
5947 "B<RLIMIT_SIGPENDING> are Linux-specific."
5948 msgstr ""
5949
5950 #. type: Plain text
5951 #: build/C/man2/getrlimit.2:502
5952 msgid ""
5953 "A child process created via B<fork>(2)  inherits its parent's resource "
5954 "limits.  Resource limits are preserved across B<execve>(2)."
5955 msgstr ""
5956
5957 #. type: Plain text
5958 #: build/C/man2/getrlimit.2:511
5959 msgid ""
5960 "One can set the resource limits of the shell using the built-in I<ulimit> "
5961 "command (I<limit> in B<csh>(1)).  The shell's resource limits are inherited "
5962 "by the processes that it creates to execute commands."
5963 msgstr ""
5964
5965 #. type: Plain text
5966 #: build/C/man2/getrlimit.2:516
5967 msgid ""
5968 "Since Linux 2.6.24, the resource limits of any process can be inspected via "
5969 "I</proc/[pid]/limits>; see B<proc>(5)."
5970 msgstr ""
5971
5972 #. type: Plain text
5973 #: build/C/man2/getrlimit.2:525
5974 msgid ""
5975 "Ancient systems provided a B<vlimit>()  function with a similar purpose to "
5976 "B<setrlimit>().  For backward compatibility, glibc also provides "
5977 "B<vlimit>().  All new applications should be written using B<setrlimit>()."
5978 msgstr ""
5979
5980 #.  FIXME prlimit() does not suffer
5981 #.  https://bugzilla.kernel.org/show_bug.cgi?id=5042
5982 #.  http://sources.redhat.com/bugzilla/show_bug.cgi?id=12201
5983 #.  Since versions 2.13, glibc has library implementations of
5984 #.  getrlimit() and setrlimit() that use prlimit() to work around
5985 #.  this bug.
5986 #. type: Plain text
5987 #: build/C/man2/getrlimit.2:540
5988 msgid ""
5989 "In older Linux kernels, the B<SIGXCPU> and B<SIGKILL> signals delivered when "
5990 "a process encountered the soft and hard B<RLIMIT_CPU> limits were delivered "
5991 "one (CPU) second later than they should have been.  This was fixed in kernel "
5992 "2.6.8."
5993 msgstr ""
5994
5995 #.  see http://marc.theaimsgroup.com/?l=linux-kernel&m=114008066530167&w=2
5996 #. type: Plain text
5997 #: build/C/man2/getrlimit.2:548
5998 msgid ""
5999 "In 2.6.x kernels before 2.6.17, a B<RLIMIT_CPU> limit of 0 is wrongly "
6000 "treated as \"no limit\" (like B<RLIM_INFINITY>).  Since Linux 2.6.17, "
6001 "setting a limit of 0 does have an effect, but is actually treated as a limit "
6002 "of 1 second."
6003 msgstr ""
6004
6005 #.  See https://lwn.net/Articles/145008/
6006 #. type: Plain text
6007 #: build/C/man2/getrlimit.2:553
6008 msgid ""
6009 "A kernel bug means that B<RLIMIT_RTPRIO> does not work in kernel 2.6.12; the "
6010 "problem is fixed in kernel 2.6.13."
6011 msgstr ""
6012
6013 #.  see http://marc.theaimsgroup.com/?l=linux-kernel&m=112256338703880&w=2
6014 #. type: Plain text
6015 #: build/C/man2/getrlimit.2:564
6016 msgid ""
6017 "In kernel 2.6.12, there was an off-by-one mismatch between the priority "
6018 "ranges returned by B<getpriority>(2)  and B<RLIMIT_NICE>.  This had the "
6019 "effect that the actual ceiling for the nice value was calculated as I<19\\ "
6020 "-\\ rlim_cur>.  This was fixed in kernel 2.6.13."
6021 msgstr ""
6022
6023 #.  The relevant patch, sent to LKML, seems to be
6024 #.  http://thread.gmane.org/gmane.linux.kernel/273462
6025 #.  From: Roland McGrath <roland <at> redhat.com>
6026 #.  Subject: [PATCH 7/7] make RLIMIT_CPU/SIGXCPU per-process
6027 #.  Date: 2005-01-23 23:27:46 GMT
6028 #.  Tested Solaris 10, FreeBSD 9, OpenBSD 5.0
6029 #.  FIXME https://bugzilla.kernel.org/show_bug.cgi?id=50951
6030 #. type: Plain text
6031 #: build/C/man2/getrlimit.2:591
6032 msgid ""
6033 "Since Linux 2.6.12, if a process reaches its soft B<RLIMIT_CPU> limit and "
6034 "has a handler installed for B<SIGXCPU>, then, in addition to invoking the "
6035 "signal handler, the kernel increases the soft limit by one second.  This "
6036 "behavior repeats if the process continues to consume CPU time, until the "
6037 "hard limit is reached, at which point the process is killed.  Other "
6038 "implementations do not change the B<RLIMIT_CPU> soft limit in this manner, "
6039 "and the Linux behavior is probably not standards conformant; portable "
6040 "applications should avoid relying on this Linux-specific behavior.  The "
6041 "Linux-specific B<RLIMIT_RTTIME> limit exhibits the same behavior when the "
6042 "soft limit is encountered."
6043 msgstr ""
6044
6045 #. type: Plain text
6046 #: build/C/man2/getrlimit.2:600
6047 msgid ""
6048 "Kernels before 2.4.22 did not diagnose the error B<EINVAL> for "
6049 "B<setrlimit>()  when I<rlim-E<gt>rlim_cur> was greater than "
6050 "I<rlim-E<gt>rlim_max>."
6051 msgstr ""
6052
6053 #. type: Plain text
6054 #: build/C/man2/getrlimit.2:603
6055 msgid "The program below demonstrates the use of B<prlimit>()."
6056 msgstr ""
6057
6058 #. type: Plain text
6059 #: build/C/man2/getrlimit.2:612
6060 #, no-wrap
6061 msgid ""
6062 "#define _GNU_SOURCE\n"
6063 "#define _FILE_OFFSET_BITS 64\n"
6064 "#include E<lt>stdio.hE<gt>\n"
6065 "#include E<lt>time.hE<gt>\n"
6066 "#include E<lt>stdlib.hE<gt>\n"
6067 "#include E<lt>unistd.hE<gt>\n"
6068 "#include E<lt>sys/resource.hE<gt>\n"
6069 msgstr ""
6070
6071 #. type: Plain text
6072 #: build/C/man2/getrlimit.2:615
6073 #, no-wrap
6074 msgid ""
6075 "#define errExit(msg) \tdo { perror(msg); exit(EXIT_FAILURE); \\e\n"
6076 "                        } while (0)\n"
6077 msgstr ""
6078
6079 #. type: Plain text
6080 #: build/C/man2/getrlimit.2:622
6081 #, no-wrap
6082 msgid ""
6083 "int\n"
6084 "main(int argc, char *argv[])\n"
6085 "{\n"
6086 "    struct rlimit old, new;\n"
6087 "    struct rlimit *newp;\n"
6088 "    pid_t pid;\n"
6089 msgstr ""
6090
6091 #. type: Plain text
6092 #: build/C/man2/getrlimit.2:628
6093 #, no-wrap
6094 msgid ""
6095 "    if (!(argc == 2 || argc == 4)) {\n"
6096 "        fprintf(stderr, \"Usage: %s E<lt>pidE<gt> [E<lt>new-soft-limitE<gt> "
6097 "\"\n"
6098 "                \"E<lt>new-hard-limitE<gt>]\\en\", argv[0]);\n"
6099 "        exit(EXIT_FAILURE);\n"
6100 "    }\n"
6101 msgstr ""
6102
6103 #. type: Plain text
6104 #: build/C/man2/getrlimit.2:630
6105 #, no-wrap
6106 msgid "    pid = atoi(argv[1]);        /* PID of target process */\n"
6107 msgstr ""
6108
6109 #. type: Plain text
6110 #: build/C/man2/getrlimit.2:637
6111 #, no-wrap
6112 msgid ""
6113 "    newp = NULL;\n"
6114 "    if (argc == 4) {\n"
6115 "        new.rlim_cur = atoi(argv[2]);\n"
6116 "        new.rlim_max = atoi(argv[3]);\n"
6117 "        newp = &new;\n"
6118 "    }\n"
6119 msgstr ""
6120
6121 #. type: Plain text
6122 #: build/C/man2/getrlimit.2:640
6123 #, no-wrap
6124 msgid ""
6125 "    /* Set CPU time limit of target process; retrieve and display\n"
6126 "       previous limit */\n"
6127 msgstr ""
6128
6129 #. type: Plain text
6130 #: build/C/man2/getrlimit.2:645
6131 #, no-wrap
6132 msgid ""
6133 "    if (prlimit(pid, RLIMIT_CPU, newp, &old) == -1)\n"
6134 "        errExit(\"prlimit-1\");\n"
6135 "    printf(\"Previous limits: soft=%lld; hard=%lld\\en\",\n"
6136 "            (long long) old.rlim_cur, (long long) old.rlim_max);\n"
6137 msgstr ""
6138
6139 #. type: Plain text
6140 #: build/C/man2/getrlimit.2:647
6141 #, no-wrap
6142 msgid "    /* Retrieve and display new CPU time limit */\n"
6143 msgstr ""
6144
6145 #. type: Plain text
6146 #: build/C/man2/getrlimit.2:652
6147 #, no-wrap
6148 msgid ""
6149 "    if (prlimit(pid, RLIMIT_CPU, NULL, &old) == -1)\n"
6150 "        errExit(\"prlimit-2\");\n"
6151 "    printf(\"New limits: soft=%lld; hard=%lld\\en\",\n"
6152 "            (long long) old.rlim_cur, (long long) old.rlim_max);\n"
6153 msgstr ""
6154
6155 #. type: Plain text
6156 #: build/C/man2/getrlimit.2:655
6157 #, no-wrap
6158 msgid ""
6159 "    exit(EXIT_FAILURE);\n"
6160 "}\n"
6161 msgstr ""
6162
6163 #. type: Plain text
6164 #: build/C/man2/getrlimit.2:674
6165 msgid ""
6166 "B<prlimit>(1), B<dup>(2), B<fcntl>(2), B<fork>(2), B<getrusage>(2), "
6167 "B<mlock>(2), B<mmap>(2), B<open>(2), B<quotactl>(2), B<sbrk>(2), "
6168 "B<shmctl>(2), B<malloc>(3), B<sigqueue>(3), B<ulimit>(3), B<core>(5), "
6169 "B<capabilities>(7), B<signal>(7)"
6170 msgstr ""
6171
6172 #. type: TH
6173 #: build/C/man2/getrusage.2:39
6174 #, no-wrap
6175 msgid "GETRUSAGE"
6176 msgstr ""
6177
6178 #. type: TH
6179 #: build/C/man2/getrusage.2:39 build/C/man2/getsid.2:26
6180 #, no-wrap
6181 msgid "2010-09-26"
6182 msgstr ""
6183
6184 #. type: Plain text
6185 #: build/C/man2/getrusage.2:42
6186 msgid "getrusage - get resource usage"
6187 msgstr ""
6188
6189 #. type: Plain text
6190 #: build/C/man2/getrusage.2:48
6191 msgid "B<int getrusage(int >I<who>B<, struct rusage *>I<usage>B<);>"
6192 msgstr ""
6193
6194 #. type: Plain text
6195 #: build/C/man2/getrusage.2:54
6196 msgid ""
6197 "B<getrusage>()  returns resource usage measures for I<who>, which can be one "
6198 "of the following:"
6199 msgstr ""
6200
6201 #. type: TP
6202 #: build/C/man2/getrusage.2:54
6203 #, no-wrap
6204 msgid "B<RUSAGE_SELF>"
6205 msgstr ""
6206
6207 #. type: Plain text
6208 #: build/C/man2/getrusage.2:58
6209 msgid ""
6210 "Return resource usage statistics for the calling process, which is the sum "
6211 "of resources used by all threads in the process."
6212 msgstr ""
6213
6214 #. type: TP
6215 #: build/C/man2/getrusage.2:58
6216 #, no-wrap
6217 msgid "B<RUSAGE_CHILDREN>"
6218 msgstr ""
6219
6220 #. type: Plain text
6221 #: build/C/man2/getrusage.2:65
6222 msgid ""
6223 "Return resource usage statistics for all children of the calling process "
6224 "that have terminated and been waited for.  These statistics will include the "
6225 "resources used by grandchildren, and further removed descendants, if all of "
6226 "the intervening descendants waited on their terminated children."
6227 msgstr ""
6228
6229 #. type: TP
6230 #: build/C/man2/getrusage.2:65
6231 #, no-wrap
6232 msgid "B<RUSAGE_THREAD> (since Linux 2.6.26)"
6233 msgstr ""
6234
6235 #. type: Plain text
6236 #: build/C/man2/getrusage.2:68
6237 msgid "Return resource usage statistics for the calling thread."
6238 msgstr ""
6239
6240 #. type: Plain text
6241 #: build/C/man2/getrusage.2:72
6242 msgid ""
6243 "The resource usages are returned in the structure pointed to by I<usage>, "
6244 "which has the following form:"
6245 msgstr ""
6246
6247 #. type: Plain text
6248 #: build/C/man2/getrusage.2:93
6249 #, no-wrap
6250 msgid ""
6251 "struct rusage {\n"
6252 "    struct timeval ru_utime; /* user CPU time used */\n"
6253 "    struct timeval ru_stime; /* system CPU time used */\n"
6254 "    long   ru_maxrss;        /* maximum resident set size */\n"
6255 "    long   ru_ixrss;         /* integral shared memory size */\n"
6256 "    long   ru_idrss;         /* integral unshared data size */\n"
6257 "    long   ru_isrss;         /* integral unshared stack size */\n"
6258 "    long   ru_minflt;        /* page reclaims (soft page faults) */\n"
6259 "    long   ru_majflt;        /* page faults (hard page faults) */\n"
6260 "    long   ru_nswap;         /* swaps */\n"
6261 "    long   ru_inblock;       /* block input operations */\n"
6262 "    long   ru_oublock;       /* block output operations */\n"
6263 "    long   ru_msgsnd;        /* IPC messages sent */\n"
6264 "    long   ru_msgrcv;        /* IPC messages received */\n"
6265 "    long   ru_nsignals;      /* signals received */\n"
6266 "    long   ru_nvcsw;         /* voluntary context switches */\n"
6267 "    long   ru_nivcsw;        /* involuntary context switches */\n"
6268 "};\n"
6269 msgstr ""
6270
6271 #. type: Plain text
6272 #: build/C/man2/getrusage.2:101
6273 msgid ""
6274 "Not all fields are completed; unmaintained fields are set to zero by the "
6275 "kernel.  (The unmaintained fields are provided for compatibility with other "
6276 "systems, and because they may one day be supported on Linux.)  The fields "
6277 "are interpreted as follows:"
6278 msgstr ""
6279
6280 #. type: TP
6281 #: build/C/man2/getrusage.2:101
6282 #, no-wrap
6283 msgid "I<ru_utime>"
6284 msgstr ""
6285
6286 #. type: Plain text
6287 #: build/C/man2/getrusage.2:107
6288 msgid ""
6289 "This is the total amount of time spent executing in user mode, expressed in "
6290 "a I<timeval> structure (seconds plus microseconds)."
6291 msgstr ""
6292
6293 #. type: TP
6294 #: build/C/man2/getrusage.2:107
6295 #, no-wrap
6296 msgid "I<ru_stime>"
6297 msgstr ""
6298
6299 #. type: Plain text
6300 #: build/C/man2/getrusage.2:113
6301 msgid ""
6302 "This is the total amount of time spent executing in kernel mode, expressed "
6303 "in a I<timeval> structure (seconds plus microseconds)."
6304 msgstr ""
6305
6306 #. type: TP
6307 #: build/C/man2/getrusage.2:113
6308 #, no-wrap
6309 msgid "I<ru_maxrss> (since Linux 2.6.32)"
6310 msgstr ""
6311
6312 #. type: Plain text
6313 #: build/C/man2/getrusage.2:120
6314 msgid ""
6315 "This is the maximum resident set size used (in kilobytes).  For "
6316 "B<RUSAGE_CHILDREN>, this is the resident set size of the largest child, not "
6317 "the maximum resident set size of the process tree."
6318 msgstr ""
6319
6320 #. type: TP
6321 #: build/C/man2/getrusage.2:120
6322 #, no-wrap
6323 msgid "I<ru_ixrss> (unmaintained)"
6324 msgstr ""
6325
6326 #.  On some systems, this field records the number of signals received.
6327 #. type: Plain text
6328 #: build/C/man2/getrusage.2:126 build/C/man2/getrusage.2:131 build/C/man2/getrusage.2:136 build/C/man2/getrusage.2:148 build/C/man2/getrusage.2:160 build/C/man2/getrusage.2:166 build/C/man2/getrusage.2:170
6329 msgid "This field is currently unused on Linux."
6330 msgstr ""
6331
6332 #. type: TP
6333 #: build/C/man2/getrusage.2:126
6334 #, no-wrap
6335 msgid "I<ru_idrss> (unmaintained)"
6336 msgstr ""
6337
6338 #. type: TP
6339 #: build/C/man2/getrusage.2:131
6340 #, no-wrap
6341 msgid "I<ru_isrss> (unmaintained)"
6342 msgstr ""
6343
6344 #. type: TP
6345 #: build/C/man2/getrusage.2:136
6346 #, no-wrap
6347 msgid "I<ru_minflt>"
6348 msgstr ""
6349
6350 #. type: Plain text
6351 #: build/C/man2/getrusage.2:141
6352 msgid ""
6353 "The number of page faults serviced without any I/O activity; here I/O "
6354 "activity is avoided by ``reclaiming'' a page frame from the list of pages "
6355 "awaiting reallocation."
6356 msgstr ""
6357
6358 #. type: TP
6359 #: build/C/man2/getrusage.2:141
6360 #, no-wrap
6361 msgid "I<ru_majflt>"
6362 msgstr ""
6363
6364 #. type: Plain text
6365 #: build/C/man2/getrusage.2:144
6366 msgid "The number of page faults serviced that required I/O activity."
6367 msgstr ""
6368
6369 #. type: TP
6370 #: build/C/man2/getrusage.2:144
6371 #, no-wrap
6372 msgid "I<ru_nswap> (unmaintained)"
6373 msgstr ""
6374
6375 #. type: TP
6376 #: build/C/man2/getrusage.2:148
6377 #, no-wrap
6378 msgid "I<ru_inblock> (since Linux 2.6.22)"
6379 msgstr ""
6380
6381 #. type: Plain text
6382 #: build/C/man2/getrusage.2:151
6383 msgid "The number of times the filesystem had to perform input."
6384 msgstr ""
6385
6386 #. type: TP
6387 #: build/C/man2/getrusage.2:151
6388 #, no-wrap
6389 msgid "I<ru_oublock> (since Linux 2.6.22)"
6390 msgstr ""
6391
6392 #. type: Plain text
6393 #: build/C/man2/getrusage.2:154
6394 msgid "The number of times the filesystem had to perform output."
6395 msgstr ""
6396
6397 #. type: TP
6398 #: build/C/man2/getrusage.2:154
6399 #, no-wrap
6400 msgid "I<ru_msgsnd> (unmaintained)"
6401 msgstr ""
6402
6403 #. type: TP
6404 #: build/C/man2/getrusage.2:160
6405 #, no-wrap
6406 msgid "I<ru_msgrcv> (unmaintained)"
6407 msgstr ""
6408
6409 #. type: TP
6410 #: build/C/man2/getrusage.2:166
6411 #, no-wrap
6412 msgid "I<ru_nsignals> (unmaintained)"
6413 msgstr ""
6414
6415 #. type: TP
6416 #: build/C/man2/getrusage.2:170
6417 #, no-wrap
6418 msgid "I<ru_nvcsw> (since Linux 2.6)"
6419 msgstr ""
6420
6421 #. type: Plain text
6422 #: build/C/man2/getrusage.2:175
6423 msgid ""
6424 "The number of times a context switch resulted due to a process voluntarily "
6425 "giving up the processor before its time slice was completed (usually to "
6426 "await availability of a resource)."
6427 msgstr ""
6428
6429 #. type: TP
6430 #: build/C/man2/getrusage.2:175
6431 #, no-wrap
6432 msgid "I<ru_nivcsw> (since Linux 2.6)"
6433 msgstr ""
6434
6435 #. type: Plain text
6436 #: build/C/man2/getrusage.2:180
6437 msgid ""
6438 "The number of times a context switch resulted due to a higher priority "
6439 "process becoming runnable or because the current process exceeded its time "
6440 "slice."
6441 msgstr ""
6442
6443 #. type: Plain text
6444 #: build/C/man2/getrusage.2:191
6445 msgid "I<usage> points outside the accessible address space."
6446 msgstr ""
6447
6448 #. type: Plain text
6449 #: build/C/man2/getrusage.2:195
6450 msgid "I<who> is invalid."
6451 msgstr ""
6452
6453 #. type: Plain text
6454 #: build/C/man2/getrusage.2:203
6455 msgid ""
6456 "SVr4, 4.3BSD.  POSIX.1-2001 specifies B<getrusage>(), but specifies only the "
6457 "fields I<ru_utime> and I<ru_stime>."
6458 msgstr ""
6459
6460 #. type: Plain text
6461 #: build/C/man2/getrusage.2:206
6462 msgid "B<RUSAGE_THREAD> is Linux-specific."
6463 msgstr ""
6464
6465 #. type: Plain text
6466 #: build/C/man2/getrusage.2:209
6467 msgid "Resource usage metrics are preserved across an B<execve>(2)."
6468 msgstr ""
6469
6470 #. type: Plain text
6471 #: build/C/man2/getrusage.2:217
6472 msgid ""
6473 "Including I<E<lt>sys/time.hE<gt>> is not required these days, but increases "
6474 "portability.  (Indeed, I<struct timeval> is defined in "
6475 "I<E<lt>sys/time.hE<gt>>.)"
6476 msgstr ""
6477
6478 #.  See the description of getrusage() in XSH.
6479 #.  A similar statement was also in SUSv2.
6480 #. type: Plain text
6481 #: build/C/man2/getrusage.2:229
6482 msgid ""
6483 "In Linux kernel versions before 2.6.9, if the disposition of B<SIGCHLD> is "
6484 "set to B<SIG_IGN> then the resource usages of child processes are "
6485 "automatically included in the value returned by B<RUSAGE_CHILDREN>, although "
6486 "POSIX.1-2001 explicitly prohibits this.  This nonconformance is rectified in "
6487 "Linux 2.6.9 and later."
6488 msgstr ""
6489
6490 #. type: Plain text
6491 #: build/C/man2/getrusage.2:232
6492 msgid ""
6493 "The structure definition shown at the start of this page was taken from "
6494 "4.3BSD Reno."
6495 msgstr ""
6496
6497 #. type: Plain text
6498 #: build/C/man2/getrusage.2:241
6499 msgid ""
6500 "Ancient systems provided a B<vtimes>()  function with a similar purpose to "
6501 "B<getrusage>().  For backward compatibility, glibc also provides "
6502 "B<vtimes>().  All new applications should be written using B<getrusage>()."
6503 msgstr ""
6504
6505 #. type: Plain text
6506 #: build/C/man2/getrusage.2:246
6507 msgid "See also the description of I</proc/PID/stat> in B<proc>(5)."
6508 msgstr ""
6509
6510 #. type: Plain text
6511 #: build/C/man2/getrusage.2:253
6512 msgid ""
6513 "B<clock_gettime>(2), B<getrlimit>(2), B<times>(2), B<wait>(2), B<wait4>(2), "
6514 "B<clock>(3)"
6515 msgstr ""
6516
6517 #. type: TH
6518 #: build/C/man2/getsid.2:26
6519 #, no-wrap
6520 msgid "GETSID"
6521 msgstr ""
6522
6523 #. type: Plain text
6524 #: build/C/man2/getsid.2:29
6525 msgid "getsid - get session ID"
6526 msgstr ""
6527
6528 #. type: Plain text
6529 #: build/C/man2/getsid.2:33
6530 msgid "B<pid_t getsid(pid_t>I< pid>B<);>"
6531 msgstr ""
6532
6533 #. type: Plain text
6534 #: build/C/man2/getsid.2:42
6535 msgid "B<getsid>():"
6536 msgstr ""
6537
6538 #. type: Plain text
6539 #: build/C/man2/getsid.2:45 build/C/man2/setpgid.2:79
6540 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 500 || _XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
6541 msgstr ""
6542
6543 #. type: Plain text
6544 #: build/C/man2/getsid.2:47 build/C/man2/setpgid.2:81
6545 msgid "|| /* Since glibc 2.12: */ _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
6546 msgstr ""
6547
6548 #. type: Plain text
6549 #: build/C/man2/getsid.2:58
6550 msgid ""
6551 "I<getsid(0)> returns the session ID of the calling process.  I<getsid(p)> "
6552 "returns the session ID of the process with process ID I<p>.  (The session ID "
6553 "of a process is the process group ID of the session leader.)"
6554 msgstr ""
6555
6556 #. type: Plain text
6557 #: build/C/man2/getsid.2:63
6558 msgid ""
6559 "On success, a session ID is returned.  On error, I<(pid_t)\\ -1> will be "
6560 "returned, and I<errno> is set appropriately."
6561 msgstr ""
6562
6563 #. type: Plain text
6564 #: build/C/man2/getsid.2:70
6565 msgid ""
6566 "A process with process ID I<p> exists, but it is not in the same session as "
6567 "the calling process, and the implementation considers this an error."
6568 msgstr ""
6569
6570 #. type: Plain text
6571 #: build/C/man2/getsid.2:75
6572 msgid "No process with process ID I<p> was found."
6573 msgstr ""
6574
6575 #.  Linux has this system call since Linux 1.3.44.
6576 #.  There is libc support since libc 5.2.19.
6577 #. type: Plain text
6578 #: build/C/man2/getsid.2:79
6579 msgid "This system call is available on Linux since version 2.0."
6580 msgstr ""
6581
6582 #. type: Plain text
6583 #: build/C/man2/getsid.2:81 build/C/man2/setgid.2:68 build/C/man2/setsid.2:67
6584 msgid "SVr4, POSIX.1-2001."
6585 msgstr ""
6586
6587 #. type: Plain text
6588 #: build/C/man2/getsid.2:84
6589 msgid "Linux does not return B<EPERM>."
6590 msgstr ""
6591
6592 #. type: Plain text
6593 #: build/C/man2/getsid.2:88
6594 msgid "B<getpgid>(2), B<setsid>(2), B<credentials>(7)"
6595 msgstr ""
6596
6597 #. type: TH
6598 #: build/C/man2/getuid.2:26
6599 #, no-wrap
6600 msgid "GETUID"
6601 msgstr ""
6602
6603 #. type: Plain text
6604 #: build/C/man2/getuid.2:29
6605 msgid "getuid, geteuid - get user identity"
6606 msgstr ""
6607
6608 #. type: Plain text
6609 #: build/C/man2/getuid.2:35
6610 msgid "B<uid_t getuid(void);>"
6611 msgstr ""
6612
6613 #. type: Plain text
6614 #: build/C/man2/getuid.2:37
6615 msgid "B<uid_t geteuid(void);>"
6616 msgstr ""
6617
6618 #. type: Plain text
6619 #: build/C/man2/getuid.2:40
6620 msgid "B<getuid>()  returns the real user ID of the calling process."
6621 msgstr ""
6622
6623 #. type: Plain text
6624 #: build/C/man2/getuid.2:43
6625 msgid "B<geteuid>()  returns the effective user ID of the calling process."
6626 msgstr ""
6627
6628 #. type: SS
6629 #: build/C/man2/getuid.2:48
6630 #, no-wrap
6631 msgid "History"
6632 msgstr ""
6633
6634 #. type: Plain text
6635 #: build/C/man2/getuid.2:57
6636 msgid ""
6637 "In UNIX V6 the B<getuid>()  call returned I<(euid E<lt>E<lt> 8) + uid>.  "
6638 "UNIX V7 introduced separate calls B<getuid>()  and B<geteuid>()."
6639 msgstr ""
6640
6641 #. type: Plain text
6642 #: build/C/man2/getuid.2:73
6643 msgid ""
6644 "The original Linux B<getuid>()  and B<geteuid>()  system calls supported "
6645 "only 16-bit user IDs.  Subsequently, Linux 2.4 added B<getuid32>()  and "
6646 "B<geteuid32>(), supporting 32-bit IDs.  The glibc B<getuid>()  and "
6647 "B<geteuid>()  wrapper functions transparently deal with the variations "
6648 "across kernel versions."
6649 msgstr ""
6650
6651 #. type: Plain text
6652 #: build/C/man2/getuid.2:78
6653 msgid "B<getresuid>(2), B<setreuid>(2), B<setuid>(2), B<credentials>(7)"
6654 msgstr ""
6655
6656 #. type: TH
6657 #: build/C/man2/iopl.2:33
6658 #, no-wrap
6659 msgid "IOPL"
6660 msgstr ""
6661
6662 #. type: TH
6663 #: build/C/man2/iopl.2:33
6664 #, no-wrap
6665 msgid "2013-03-15"
6666 msgstr ""
6667
6668 #. type: Plain text
6669 #: build/C/man2/iopl.2:36
6670 msgid "iopl - change I/O privilege level"
6671 msgstr ""
6672
6673 #. type: Plain text
6674 #: build/C/man2/iopl.2:38
6675 msgid "B<#include E<lt>sys/io.hE<gt>>"
6676 msgstr ""
6677
6678 #. type: Plain text
6679 #: build/C/man2/iopl.2:40
6680 msgid "B<int iopl(int >I<level>B<);>"
6681 msgstr ""
6682
6683 #. type: Plain text
6684 #: build/C/man2/iopl.2:45
6685 msgid ""
6686 "B<iopl>()  changes the I/O privilege level of the calling process, as "
6687 "specified by the two least significant bits in I<level>."
6688 msgstr ""
6689
6690 #. type: Plain text
6691 #: build/C/man2/iopl.2:51
6692 msgid ""
6693 "This call is necessary to allow 8514-compatible X servers to run under "
6694 "Linux.  Since these X servers require access to all 65536 I/O ports, the "
6695 "B<ioperm>(2)  call is not sufficient."
6696 msgstr ""
6697
6698 #. type: Plain text
6699 #: build/C/man2/iopl.2:55
6700 msgid ""
6701 "In addition to granting unrestricted I/O port access, running at a higher "
6702 "I/O privilege level also allows the process to disable interrupts.  This "
6703 "will probably crash the system, and is not recommended."
6704 msgstr ""
6705
6706 #. type: Plain text
6707 #: build/C/man2/iopl.2:60
6708 msgid "Permissions are inherited by B<fork>(2)  and B<execve>(2)."
6709 msgstr ""
6710
6711 #. type: Plain text
6712 #: build/C/man2/iopl.2:62
6713 msgid "The I/O privilege level for a normal process is 0."
6714 msgstr ""
6715
6716 #. type: Plain text
6717 #: build/C/man2/iopl.2:66
6718 msgid ""
6719 "This call is mostly for the i386 architecture.  On many other architectures "
6720 "it does not exist or will always return an error."
6721 msgstr ""
6722
6723 #. type: Plain text
6724 #: build/C/man2/iopl.2:76
6725 msgid "I<level> is greater than 3."
6726 msgstr ""
6727
6728 #. type: Plain text
6729 #: build/C/man2/iopl.2:79
6730 msgid "This call is unimplemented."
6731 msgstr ""
6732
6733 #. type: Plain text
6734 #: build/C/man2/iopl.2:87
6735 msgid ""
6736 "The calling process has insufficient privilege to call B<iopl>(); the "
6737 "B<CAP_SYS_RAWIO> capability is required to raise the I/O privilege level "
6738 "above its current value."
6739 msgstr ""
6740
6741 #. type: Plain text
6742 #: build/C/man2/iopl.2:91
6743 msgid ""
6744 "B<iopl>()  is Linux-specific and should not be used in programs that are "
6745 "intended to be portable."
6746 msgstr ""
6747
6748 #. type: Plain text
6749 #: build/C/man2/iopl.2:100
6750 msgid ""
6751 "Libc5 treats it as a system call and has a prototype in "
6752 "I<E<lt>unistd.hE<gt>>.  Glibc1 does not have a prototype.  Glibc2 has a "
6753 "prototype both in I<E<lt>sys/io.hE<gt>> and in I<E<lt>sys/perm.hE<gt>>.  "
6754 "Avoid the latter, it is available on i386 only."
6755 msgstr ""
6756
6757 #. type: Plain text
6758 #: build/C/man2/iopl.2:104
6759 msgid "B<ioperm>(2), B<outb>(2), B<capabilities>(7)"
6760 msgstr ""
6761
6762 #. type: TH
6763 #: build/C/man2/ioprio_set.2:24
6764 #, no-wrap
6765 msgid "IOPRIO_SET"
6766 msgstr ""
6767
6768 #. type: Plain text
6769 #: build/C/man2/ioprio_set.2:27
6770 msgid "ioprio_get, ioprio_set - get/set I/O scheduling class and priority"
6771 msgstr ""
6772
6773 #. type: Plain text
6774 #: build/C/man2/ioprio_set.2:31
6775 #, no-wrap
6776 msgid ""
6777 "B<int ioprio_get(int >I<which>B<, int >I<who>B<);>\n"
6778 "B<int ioprio_set(int >I<which>B<, int >I<who>B<, int >I<ioprio>B<);>\n"
6779 msgstr ""
6780
6781 #. type: Plain text
6782 #: build/C/man2/ioprio_set.2:35
6783 msgid "I<Note>: There are no glibc wrappers for these system calls; see NOTES."
6784 msgstr ""
6785
6786 #. type: Plain text
6787 #: build/C/man2/ioprio_set.2:42
6788 msgid ""
6789 "The B<ioprio_get>()  and B<ioprio_set>()  system calls respectively get and "
6790 "set the I/O scheduling class and priority of one or more threads."
6791 msgstr ""
6792
6793 #. type: Plain text
6794 #: build/C/man2/ioprio_set.2:54
6795 msgid ""
6796 "The I<which> and I<who> arguments identify the thread(s) on which the system "
6797 "calls operate.  The I<which> argument determines how I<who> is interpreted, "
6798 "and has one of the following values:"
6799 msgstr ""
6800
6801 #. type: TP
6802 #: build/C/man2/ioprio_set.2:54
6803 #, no-wrap
6804 msgid "B<IOPRIO_WHO_PROCESS>"
6805 msgstr ""
6806
6807 #. type: Plain text
6808 #: build/C/man2/ioprio_set.2:61
6809 msgid ""
6810 "I<who> is a process ID or thread ID identifying a single process or thread.  "
6811 "If I<who> is 0, then operate on the calling thread."
6812 msgstr ""
6813
6814 #. type: TP
6815 #: build/C/man2/ioprio_set.2:61
6816 #, no-wrap
6817 msgid "B<IOPRIO_WHO_PGRP>"
6818 msgstr ""
6819
6820 #. type: Plain text
6821 #: build/C/man2/ioprio_set.2:68
6822 msgid ""
6823 "I<who> is a process group ID identifying all the members of a process "
6824 "group.  If I<who> is 0, then operate on the process group of which the "
6825 "caller is a member."
6826 msgstr ""
6827
6828 #. type: TP
6829 #: build/C/man2/ioprio_set.2:68
6830 #, no-wrap
6831 msgid "B<IOPRIO_WHO_USER>"
6832 msgstr ""
6833
6834 #.  FIXME who==0 needs to be documented,
6835 #.  See http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=652443
6836 #. type: Plain text
6837 #: build/C/man2/ioprio_set.2:75
6838 msgid ""
6839 "I<who> is a user ID identifying all of the processes that have a matching "
6840 "real UID."
6841 msgstr ""
6842
6843 #. type: Plain text
6844 #: build/C/man2/ioprio_set.2:98
6845 msgid ""
6846 "If I<which> is specified as B<IOPRIO_WHO_PGRP> or B<IOPRIO_WHO_USER> when "
6847 "calling B<ioprio_get>(), and more than one process matches I<who>, then the "
6848 "returned priority will be the highest one found among all of the matching "
6849 "processes.  One priority is said to be higher than another one if it belongs "
6850 "to a higher priority class (B<IOPRIO_CLASS_RT> is the highest priority "
6851 "class; B<IOPRIO_CLASS_IDLE> is the lowest)  or if it belongs to the same "
6852 "priority class as the other process but has a higher priority level (a lower "
6853 "priority number means a higher priority level)."
6854 msgstr ""
6855
6856 #. type: Plain text
6857 #: build/C/man2/ioprio_set.2:108
6858 msgid ""
6859 "The I<ioprio> argument given to B<ioprio_set>()  is a bit mask that "
6860 "specifies both the scheduling class and the priority to be assigned to the "
6861 "target process(es).  The following macros are used for assembling and "
6862 "dissecting I<ioprio> values:"
6863 msgstr ""
6864
6865 #. type: TP
6866 #: build/C/man2/ioprio_set.2:108
6867 #, no-wrap
6868 msgid "B<IOPRIO_PRIO_VALUE(>I<class>B<, >I<data>B<)>"
6869 msgstr ""
6870
6871 #. type: Plain text
6872 #: build/C/man2/ioprio_set.2:117
6873 msgid ""
6874 "Given a scheduling I<class> and priority (I<data>), this macro combines the "
6875 "two values to produce an I<ioprio> value, which is returned as the result of "
6876 "the macro."
6877 msgstr ""
6878
6879 #. type: TP
6880 #: build/C/man2/ioprio_set.2:117
6881 #, no-wrap
6882 msgid "B<IOPRIO_PRIO_CLASS(>I<mask>B<)>"
6883 msgstr ""
6884
6885 #. type: Plain text
6886 #: build/C/man2/ioprio_set.2:129
6887 msgid ""
6888 "Given I<mask> (an I<ioprio> value), this macro returns its I/O class "
6889 "component, that is, one of the values B<IOPRIO_CLASS_RT>, "
6890 "B<IOPRIO_CLASS_BE>, or B<IOPRIO_CLASS_IDLE>."
6891 msgstr ""
6892
6893 #. type: TP
6894 #: build/C/man2/ioprio_set.2:129
6895 #, no-wrap
6896 msgid "B<IOPRIO_PRIO_DATA(>I<mask>B<)>"
6897 msgstr ""
6898
6899 #. type: Plain text
6900 #: build/C/man2/ioprio_set.2:138
6901 msgid ""
6902 "Given I<mask> (an I<ioprio> value), this macro returns its priority "
6903 "(I<data>)  component."
6904 msgstr ""
6905
6906 #. type: Plain text
6907 #: build/C/man2/ioprio_set.2:141
6908 msgid ""
6909 "See the NOTES section for more information on scheduling classes and "
6910 "priorities."
6911 msgstr ""
6912
6913 #. type: Plain text
6914 #: build/C/man2/ioprio_set.2:149
6915 msgid ""
6916 "I/O priorities are supported for reads and for synchronous (B<O_DIRECT>, "
6917 "B<O_SYNC>)  writes.  I/O priorities are not supported for asynchronous "
6918 "writes because they are issued outside the context of the program dirtying "
6919 "the memory, and thus program-specific priorities do not apply."
6920 msgstr ""
6921
6922 #. type: Plain text
6923 #: build/C/man2/ioprio_set.2:162
6924 msgid ""
6925 "On success, B<ioprio_get>()  returns the I<ioprio> value of the process with "
6926 "highest I/O priority of any of the processes that match the criteria "
6927 "specified in I<which> and I<who>.  On error, -1 is returned, and I<errno> is "
6928 "set to indicate the error."
6929 msgstr ""
6930
6931 #. type: Plain text
6932 #: build/C/man2/ioprio_set.2:169
6933 msgid ""
6934 "On success, B<ioprio_set>()  returns 0.  On error, -1 is returned, and "
6935 "I<errno> is set to indicate the error."
6936 msgstr ""
6937
6938 #. type: Plain text
6939 #: build/C/man2/ioprio_set.2:179
6940 msgid ""
6941 "Invalid value for I<which> or I<ioprio>.  Refer to the NOTES section for "
6942 "available scheduler classes and priority levels for I<ioprio>."
6943 msgstr ""
6944
6945 #. type: Plain text
6946 #: build/C/man2/ioprio_set.2:187
6947 msgid ""
6948 "The calling process does not have the privilege needed to assign this "
6949 "I<ioprio> to the specified process(es).  See the NOTES section for more "
6950 "information on required privileges for B<ioprio_set>()."
6951 msgstr ""
6952
6953 #. type: Plain text
6954 #: build/C/man2/ioprio_set.2:193
6955 msgid ""
6956 "No process(es) could be found that matched the specification in I<which> and "
6957 "I<who>."
6958 msgstr ""
6959
6960 #. type: Plain text
6961 #: build/C/man2/ioprio_set.2:196
6962 msgid "These system calls have been available on Linux since kernel 2.6.13."
6963 msgstr ""
6964
6965 #. type: Plain text
6966 #: build/C/man2/ioprio_set.2:201
6967 msgid ""
6968 "Glibc does not provide a wrapper for these system calls; call them using "
6969 "B<syscall>(2)."
6970 msgstr ""
6971
6972 #. type: Plain text
6973 #: build/C/man2/ioprio_set.2:220
6974 msgid ""
6975 "Two or more processes or threads can share an I/O context.  This will be the "
6976 "case when B<clone>(2)  was called with the B<CLONE_IO> flag.  However, by "
6977 "default, the distinct threads of a process will B<not> share the same I/O "
6978 "context.  This means that if you want to change the I/O priority of all "
6979 "threads in a process, you may need to call B<ioprio_set>()  on each of the "
6980 "threads.  The thread ID that you would need for this operation is the one "
6981 "that is returned by B<gettid>(2)  or B<clone>(2)."
6982 msgstr ""
6983
6984 #. type: Plain text
6985 #: build/C/man2/ioprio_set.2:225
6986 msgid ""
6987 "These system calls have an effect only when used in conjunction with an I/O "
6988 "scheduler that supports I/O priorities.  As at kernel 2.6.17 the only such "
6989 "scheduler is the Completely Fair Queuing (CFQ) I/O scheduler."
6990 msgstr ""
6991
6992 #. type: SS
6993 #: build/C/man2/ioprio_set.2:225
6994 #, no-wrap
6995 msgid "Selecting an I/O scheduler"
6996 msgstr ""
6997
6998 #. type: Plain text
6999 #: build/C/man2/ioprio_set.2:229
7000 msgid ""
7001 "I/O Schedulers are selected on a per-device basis via the special file "
7002 "I</sys/block/E<lt>deviceE<gt>/queue/scheduler>."
7003 msgstr ""
7004
7005 #. type: Plain text
7006 #: build/C/man2/ioprio_set.2:235
7007 msgid ""
7008 "One can view the current I/O scheduler via the I</sys> filesystem.  For "
7009 "example, the following command displays a list of all schedulers currently "
7010 "loaded in the kernel:"
7011 msgstr ""
7012
7013 #. type: Plain text
7014 #: build/C/man2/ioprio_set.2:240
7015 #, no-wrap
7016 msgid ""
7017 "$B< cat /sys/block/hda/queue/scheduler>\n"
7018 "noop anticipatory deadline [cfq]\n"
7019 msgstr ""
7020
7021 #. type: Plain text
7022 #: build/C/man2/ioprio_set.2:254
7023 msgid ""
7024 "The scheduler surrounded by brackets is the one actually in use for the "
7025 "device (I<hda> in the example).  Setting another scheduler is done by "
7026 "writing the name of the new scheduler to this file.  For example, the "
7027 "following command will set the scheduler for the I<hda> device to I<cfq>:"
7028 msgstr ""
7029
7030 #. type: Plain text
7031 #: build/C/man2/ioprio_set.2:260
7032 #, no-wrap
7033 msgid ""
7034 "$B< su>\n"
7035 "Password:\n"
7036 "#B< echo cfq E<gt> /sys/block/hda/queue/scheduler>\n"
7037 msgstr ""
7038
7039 #. type: SS
7040 #: build/C/man2/ioprio_set.2:262
7041 #, no-wrap
7042 msgid "The Completely Fair Queuing (CFQ) I/O scheduler"
7043 msgstr ""
7044
7045 #. type: Plain text
7046 #: build/C/man2/ioprio_set.2:268
7047 msgid ""
7048 "Since v3 (aka CFQ Time Sliced) CFQ implements I/O nice levels similar to "
7049 "those of CPU scheduling.  These nice levels are grouped in three scheduling "
7050 "classes each one containing one or more priority levels:"
7051 msgstr ""
7052
7053 #. type: TP
7054 #: build/C/man2/ioprio_set.2:268
7055 #, no-wrap
7056 msgid "B<IOPRIO_CLASS_RT> (1)"
7057 msgstr ""
7058
7059 #. type: Plain text
7060 #: build/C/man2/ioprio_set.2:283
7061 msgid ""
7062 "This is the real-time I/O class.  This scheduling class is given higher "
7063 "priority than any other class: processes from this class are given first "
7064 "access to the disk every time.  Thus this I/O class needs to be used with "
7065 "some care: one I/O real-time process can starve the entire system.  Within "
7066 "the real-time class, there are 8 levels of class data (priority) that "
7067 "determine exactly how much time this process needs the disk for on each "
7068 "service.  The highest real-time priority level is 0; the lowest is 7.  In "
7069 "the future this might change to be more directly mappable to performance, by "
7070 "passing in a desired data rate instead."
7071 msgstr ""
7072
7073 #. type: TP
7074 #: build/C/man2/ioprio_set.2:283
7075 #, no-wrap
7076 msgid "B<IOPRIO_CLASS_BE> (2)"
7077 msgstr ""
7078
7079 #. type: Plain text
7080 #: build/C/man2/ioprio_set.2:296
7081 msgid ""
7082 "This is the best-effort scheduling class, which is the default for any "
7083 "process that hasn't set a specific I/O priority.  The class data (priority) "
7084 "determines how much I/O bandwidth the process will get.  Best-effort "
7085 "priority levels are analogous to CPU nice values (see B<getpriority>(2)).  "
7086 "The priority level determines a priority relative to other processes in the "
7087 "best-effort scheduling class.  Priority levels range from 0 (highest) to 7 "
7088 "(lowest)."
7089 msgstr ""
7090
7091 #. type: TP
7092 #: build/C/man2/ioprio_set.2:296
7093 #, no-wrap
7094 msgid "B<IOPRIO_CLASS_IDLE> (3)"
7095 msgstr ""
7096
7097 #. type: Plain text
7098 #: build/C/man2/ioprio_set.2:305
7099 msgid ""
7100 "This is the idle scheduling class.  Processes running at this level only get "
7101 "I/O time when no-one else needs the disk.  The idle class has no class "
7102 "data.  Attention is required when assigning this priority class to a "
7103 "process, since it may become starved if higher priority processes are "
7104 "constantly accessing the disk."
7105 msgstr ""
7106
7107 #. type: Plain text
7108 #: build/C/man2/ioprio_set.2:309
7109 msgid ""
7110 "Refer to I<Documentation/block/ioprio.txt> for more information on the CFQ "
7111 "I/O Scheduler and an example program."
7112 msgstr ""
7113
7114 #. type: SS
7115 #: build/C/man2/ioprio_set.2:309
7116 #, no-wrap
7117 msgid "Required permissions to set I/O priorities"
7118 msgstr ""
7119
7120 #. type: Plain text
7121 #: build/C/man2/ioprio_set.2:312
7122 msgid ""
7123 "Permission to change a process's priority is granted or denied based on two "
7124 "assertions:"
7125 msgstr ""
7126
7127 #. type: TP
7128 #: build/C/man2/ioprio_set.2:312
7129 #, no-wrap
7130 msgid "B<Process ownership>"
7131 msgstr ""
7132
7133 #. type: Plain text
7134 #: build/C/man2/ioprio_set.2:320
7135 msgid ""
7136 "An unprivileged process may set only the I/O priority of a process whose "
7137 "real UID matches the real or effective UID of the calling process.  A "
7138 "process which has the B<CAP_SYS_NICE> capability can change the priority of "
7139 "any process."
7140 msgstr ""
7141
7142 #. type: TP
7143 #: build/C/man2/ioprio_set.2:320
7144 #, no-wrap
7145 msgid "B<What is the desired priority>"
7146 msgstr ""
7147
7148 #. type: Plain text
7149 #: build/C/man2/ioprio_set.2:332
7150 msgid ""
7151 "Attempts to set very high priorities (B<IOPRIO_CLASS_RT>)  require the "
7152 "B<CAP_SYS_ADMIN> capability.  Kernel versions up to 2.6.24 also required "
7153 "B<CAP_SYS_ADMIN> to set a very low priority (B<IOPRIO_CLASS_IDLE>), but "
7154 "since Linux 2.6.25, this is no longer required."
7155 msgstr ""
7156
7157 #. type: Plain text
7158 #: build/C/man2/ioprio_set.2:337
7159 msgid ""
7160 "A call to B<ioprio_set>()  must follow both rules, or the call will fail "
7161 "with the error B<EPERM>."
7162 msgstr ""
7163
7164 #.  6 May 07: Bug report raised:
7165 #.  http://sources.redhat.com/bugzilla/show_bug.cgi?id=4464
7166 #.  Ulrich Drepper replied that he wasn't going to add these
7167 #.  to glibc.
7168 #. type: Plain text
7169 #: build/C/man2/ioprio_set.2:346
7170 msgid ""
7171 "Glibc does not yet provide a suitable header file defining the function "
7172 "prototypes and macros described on this page.  Suitable definitions can be "
7173 "found in I<linux/ioprio.h>."
7174 msgstr ""
7175
7176 #. type: Plain text
7177 #: build/C/man2/ioprio_set.2:351
7178 msgid "B<ionice>(1), B<getpriority>(2), B<open>(2), B<capabilities>(7)"
7179 msgstr ""
7180
7181 #. type: Plain text
7182 #: build/C/man2/ioprio_set.2:354
7183 msgid "I<Documentation/block/ioprio.txt> in the Linux kernel source tree"
7184 msgstr ""
7185
7186 #. type: TH
7187 #: build/C/man2/ipc.2:25
7188 #, no-wrap
7189 msgid "IPC"
7190 msgstr ""
7191
7192 #. type: TH
7193 #: build/C/man2/ipc.2:25
7194 #, no-wrap
7195 msgid "2012-10-16"
7196 msgstr ""
7197
7198 #. type: Plain text
7199 #: build/C/man2/ipc.2:28
7200 msgid "ipc - System V IPC system calls"
7201 msgstr ""
7202
7203 #. type: Plain text
7204 #: build/C/man2/ipc.2:33
7205 #, no-wrap
7206 msgid ""
7207 "B<int ipc(unsigned int >I<call>B<, int >I<first>B<, int >I<second>B<, int "
7208 ">I<third>B<,>\n"
7209 "B<        void *>I<ptr>B<, long >I<fifth>B<);>\n"
7210 msgstr ""
7211
7212 #. type: Plain text
7213 #: build/C/man2/ipc.2:41
7214 msgid ""
7215 "B<ipc>()  is a common kernel entry point for the System V IPC calls for "
7216 "messages, semaphores, and shared memory.  I<call> determines which IPC "
7217 "function to invoke; the other arguments are passed through to the "
7218 "appropriate call."
7219 msgstr ""
7220
7221 #. type: Plain text
7222 #: build/C/man2/ipc.2:45
7223 msgid ""
7224 "User programs should call the appropriate functions by their usual names.  "
7225 "Only standard library implementors and kernel hackers need to know about "
7226 "B<ipc>()."
7227 msgstr ""
7228
7229 #. type: Plain text
7230 #: build/C/man2/ipc.2:49
7231 msgid ""
7232 "B<ipc>()  is Linux-specific, and should not be used in programs intended to "
7233 "be portable."
7234 msgstr ""
7235
7236 #. type: Plain text
7237 #: build/C/man2/ipc.2:57
7238 msgid ""
7239 "On some architectures\\(emfor example x86-64 and ARM\\(emthere is no "
7240 "B<ipc>()  system call; instead B<msgctl>(2), B<semctl>(2), B<shmctl>(2), and "
7241 "so on really are implemented as separate system calls."
7242 msgstr ""
7243
7244 #. type: Plain text
7245 #: build/C/man2/ipc.2:70
7246 msgid ""
7247 "B<msgctl>(2), B<msgget>(2), B<msgrcv>(2), B<msgsnd>(2), B<semctl>(2), "
7248 "B<semget>(2), B<semop>(2), B<semtimedop>(2), B<shmat>(2), B<shmctl>(2), "
7249 "B<shmdt>(2), B<shmget>(2)"
7250 msgstr ""
7251
7252 #. type: TH
7253 #: build/C/man2/seteuid.2:29
7254 #, no-wrap
7255 msgid "SETEUID"
7256 msgstr ""
7257
7258 #. type: TH
7259 #: build/C/man2/seteuid.2:29
7260 #, no-wrap
7261 msgid "2012-07-02"
7262 msgstr ""
7263
7264 #. type: Plain text
7265 #: build/C/man2/seteuid.2:32
7266 msgid "seteuid, setegid - set effective user or group ID"
7267 msgstr ""
7268
7269 #. type: Plain text
7270 #: build/C/man2/seteuid.2:38
7271 msgid "B<int seteuid(uid_t >I<euid>B<);>"
7272 msgstr ""
7273
7274 #. type: Plain text
7275 #: build/C/man2/seteuid.2:40
7276 msgid "B<int setegid(gid_t >I<egid>B<);>"
7277 msgstr ""
7278
7279 #. type: Plain text
7280 #: build/C/man2/seteuid.2:49
7281 msgid "B<seteuid>(), B<setegid>():"
7282 msgstr ""
7283
7284 #. type: Plain text
7285 #: build/C/man2/seteuid.2:51
7286 msgid ""
7287 "_BSD_SOURCE || _POSIX_C_SOURCE\\ E<gt>=\\ 200112L || _XOPEN_SOURCE\\ "
7288 "E<gt>=\\ 600"
7289 msgstr ""
7290
7291 #. type: Plain text
7292 #: build/C/man2/seteuid.2:58
7293 msgid ""
7294 "B<seteuid>()  sets the effective user ID of the calling process.  "
7295 "Unprivileged user processes may only set the effective user ID to the real "
7296 "user ID, the effective user ID or the saved set-user-ID."
7297 msgstr ""
7298
7299 #.  When
7300 #.  .I euid
7301 #.  equals \-1, nothing is changed.
7302 #.  (This is an artifact of the implementation in glibc of seteuid()
7303 #.  using setresuid(2).)
7304 #. type: Plain text
7305 #: build/C/man2/seteuid.2:67
7306 msgid ""
7307 "Precisely the same holds for B<setegid>()  with \"group\" instead of "
7308 "\"user\"."
7309 msgstr ""
7310
7311 #. type: Plain text
7312 #: build/C/man2/seteuid.2:91
7313 msgid ""
7314 "The calling process is not privileged (Linux: does not have the "
7315 "B<CAP_SETUID> capability in the case of B<seteuid>(), or the B<CAP_SETGID> "
7316 "capability in the case of B<setegid>())  and I<euid> (respectively, I<egid>)  "
7317 "is not the real user (group) ID, the effective user (group) ID, or the saved "
7318 "set-user-ID (saved set-group-ID)."
7319 msgstr ""
7320
7321 #. type: Plain text
7322 #: build/C/man2/seteuid.2:93
7323 msgid "4.3BSD, POSIX.1-2001."
7324 msgstr ""
7325
7326 #. type: Plain text
7327 #: build/C/man2/seteuid.2:99
7328 msgid ""
7329 "Setting the effective user (group) ID to the saved set-user-ID (saved "
7330 "set-group-ID) is possible since Linux 1.1.37 (1.1.38).  On an arbitrary "
7331 "system one should check B<_POSIX_SAVED_IDS>."
7332 msgstr ""
7333
7334 #. type: Plain text
7335 #: build/C/man2/seteuid.2:115
7336 msgid ""
7337 "Under libc4, libc5 and glibc 2.0 B<seteuid(>I<euid>B<)> is equivalent to "
7338 "B<setreuid(-1,>I< euid>B<)> and hence may change the saved set-user-ID.  "
7339 "Under glibc 2.1 and later it is equivalent to B<setresuid(-1,>I< euid>B<, "
7340 "-1)> and hence does not change the saved set-user-ID.  Analogous remarks "
7341 "hold for B<setegid>(), with the difference that the change in implementation "
7342 "from B<setregid(-1,>I< egid>B<)> to B<setresgid(-1,>I< egid>B<, -1)> "
7343 "occurred in glibc 2.2 or 2.3 (dependeing on the hardware architecture)."
7344 msgstr ""
7345
7346 #. type: Plain text
7347 #: build/C/man2/seteuid.2:124
7348 msgid ""
7349 "According to POSIX.1, B<seteuid>()  (B<setegid>())  need not permit I<euid> "
7350 "(I<egid>)  to be the same value as the current effective user (group) ID, "
7351 "and some implementations do not permit this."
7352 msgstr ""
7353
7354 #. type: Plain text
7355 #: build/C/man2/seteuid.2:131
7356 msgid ""
7357 "B<geteuid>(2), B<setresuid>(2), B<setreuid>(2), B<setuid>(2), "
7358 "B<capabilities>(7), B<credentials>(7)"
7359 msgstr ""
7360
7361 #. type: TH
7362 #: build/C/man2/setfsgid.2:31
7363 #, no-wrap
7364 msgid "SETFSGID"
7365 msgstr ""
7366
7367 #. type: TH
7368 #: build/C/man2/setfsgid.2:31 build/C/man2/setfsuid.2:31
7369 #, no-wrap
7370 msgid "2013-08-08"
7371 msgstr ""
7372
7373 #. type: Plain text
7374 #: build/C/man2/setfsgid.2:34
7375 msgid "setfsgid - set group identity used for filesystem checks"
7376 msgstr ""
7377
7378 #. type: Plain text
7379 #: build/C/man2/setfsgid.2:36 build/C/man2/setfsuid.2:36
7380 msgid "B<#include E<lt>sys/fsuid.hE<gt>>"
7381 msgstr ""
7382
7383 #. type: Plain text
7384 #: build/C/man2/setfsgid.2:38
7385 msgid "B<int setfsgid(uid_t >I<fsgid>B<);>"
7386 msgstr ""
7387
7388 #. type: Plain text
7389 #: build/C/man2/setfsgid.2:51
7390 msgid ""
7391 "The system call B<setfsgid>()  changes the value of the caller's filesystem "
7392 "group ID\\(emthe group ID that the Linux kernel uses to check for all "
7393 "accesses to the filesystem.  Normally, the value of the filesystem group ID "
7394 "will shadow the value of the effective group ID.  In fact, whenever the "
7395 "effective group ID is changed, the filesystem group ID will also be changed "
7396 "to the new value of the effective group ID."
7397 msgstr ""
7398
7399 #. type: Plain text
7400 #: build/C/man2/setfsgid.2:62
7401 msgid ""
7402 "Explicit calls to B<setfsuid>(2)  and B<setfsgid>()  are usually used only "
7403 "by programs such as the Linux NFS server that need to change what user and "
7404 "group ID is used for file access without a corresponding change in the real "
7405 "and effective user and group IDs.  A change in the normal user IDs for a "
7406 "program such as the NFS server is a security hole that can expose it to "
7407 "unwanted signals.  (But see below.)"
7408 msgstr ""
7409
7410 #. type: Plain text
7411 #: build/C/man2/setfsgid.2:68
7412 msgid ""
7413 "B<setfsgid>()  will succeed only if the caller is the superuser or if "
7414 "I<fsgid> matches either the caller's real group ID, effective group ID, "
7415 "saved set-group-ID, or current the filesystem user ID."
7416 msgstr ""
7417
7418 #. type: Plain text
7419 #: build/C/man2/setfsgid.2:71
7420 msgid ""
7421 "On both success and failure, this call returns the previous filesystem group "
7422 "ID of the caller."
7423 msgstr ""
7424
7425 #.  This system call is present since Linux 1.1.44
7426 #.  and in libc since libc 4.7.6.
7427 #. type: Plain text
7428 #: build/C/man2/setfsgid.2:75 build/C/man2/setfsuid.2:75
7429 msgid "This system call is present in Linux since version 1.2."
7430 msgstr ""
7431
7432 #. type: Plain text
7433 #: build/C/man2/setfsgid.2:79
7434 msgid ""
7435 "B<setfsgid>()  is Linux-specific and should not be used in programs intended "
7436 "to be portable."
7437 msgstr ""
7438
7439 #. type: Plain text
7440 #: build/C/man2/setfsgid.2:85
7441 msgid ""
7442 "When glibc determines that the argument is not a valid group ID, it will "
7443 "return -1 and set I<errno> to B<EINVAL> without attempting the system call."
7444 msgstr ""
7445
7446 #. type: Plain text
7447 #: build/C/man2/setfsgid.2:96
7448 msgid ""
7449 "Note that at the time this system call was introduced, a process could send "
7450 "a signal to a process with the same effective user ID.  Today signal "
7451 "permission handling is slightly different.  See B<setfsuid>(2)  for a "
7452 "discussion of why the use of both B<setfsuid>(2)  and B<setfsgid>()  is "
7453 "nowadays unneeded."
7454 msgstr ""
7455
7456 #. type: Plain text
7457 #: build/C/man2/setfsgid.2:106
7458 msgid ""
7459 "The original Linux B<setfsgid>()  system call supported only 16-bit group "
7460 "IDs.  Subsequently, Linux 2.4 added B<setfsgid32>()  supporting 32-bit IDs.  "
7461 "The glibc B<setfsgid>()  wrapper function transparently deals with the "
7462 "variation across kernel versions."
7463 msgstr ""
7464
7465 #. type: Plain text
7466 #: build/C/man2/setfsgid.2:123
7467 msgid ""
7468 "No error indications of any kind are returned to the caller, and the fact "
7469 "that both successful and unsuccessful calls return the same value makes it "
7470 "impossible to directly determine whether the call succeeded or failed.  "
7471 "Instead, the caller must resort to looking at the return value from a "
7472 "further call such as I<setfsgid(-1)> (which will always fail), in order to "
7473 "determine if a preceding call to B<setfsgid>()  changed the filesystem group "
7474 "ID.  At the very least, B<EPERM> should be returned when the call fails "
7475 "(because the caller lacks the B<CAP_SETGID> capability)."
7476 msgstr ""
7477
7478 #. type: Plain text
7479 #: build/C/man2/setfsgid.2:128
7480 msgid "B<kill>(2), B<setfsuid>(2), B<capabilities>(7), B<credentials>(7)"
7481 msgstr ""
7482
7483 #. type: TH
7484 #: build/C/man2/setfsuid.2:31
7485 #, no-wrap
7486 msgid "SETFSUID"
7487 msgstr ""
7488
7489 #. type: Plain text
7490 #: build/C/man2/setfsuid.2:34
7491 msgid "setfsuid - set user identity used for filesystem checks"
7492 msgstr ""
7493
7494 #. type: Plain text
7495 #: build/C/man2/setfsuid.2:38
7496 msgid "B<int setfsuid(uid_t >I<fsuid>B<);>"
7497 msgstr ""
7498
7499 #. type: Plain text
7500 #: build/C/man2/setfsuid.2:51
7501 msgid ""
7502 "The system call B<setfsuid>()  changes the value of the caller's filesystem "
7503 "user ID\\(emthe user ID that the Linux kernel uses to check for all accesses "
7504 "to the filesystem.  Normally, the value of the filesystem user ID will "
7505 "shadow the value of the effective user ID.  In fact, whenever the effective "
7506 "user ID is changed, the filesystem user ID will also be changed to the new "
7507 "value of the effective user ID."
7508 msgstr ""
7509
7510 #. type: Plain text
7511 #: build/C/man2/setfsuid.2:62
7512 msgid ""
7513 "Explicit calls to B<setfsuid>()  and B<setfsgid>(2)  are usually used only "
7514 "by programs such as the Linux NFS server that need to change what user and "
7515 "group ID is used for file access without a corresponding change in the real "
7516 "and effective user and group IDs.  A change in the normal user IDs for a "
7517 "program such as the NFS server is a security hole that can expose it to "
7518 "unwanted signals.  (But see below.)"
7519 msgstr ""
7520
7521 #. type: Plain text
7522 #: build/C/man2/setfsuid.2:68
7523 msgid ""
7524 "B<setfsuid>()  will succeed only if the caller is the superuser or if "
7525 "I<fsuid> matches either the caller's real user ID, effective user ID, saved "
7526 "set-user-ID, or current filesystem user ID."
7527 msgstr ""
7528
7529 #. type: Plain text
7530 #: build/C/man2/setfsuid.2:71
7531 msgid ""
7532 "On both success and failure, this call returns the previous filesystem user "
7533 "ID of the caller."
7534 msgstr ""
7535
7536 #. type: Plain text
7537 #: build/C/man2/setfsuid.2:79
7538 msgid ""
7539 "B<setfsuid>()  is Linux-specific and should not be used in programs intended "
7540 "to be portable."
7541 msgstr ""
7542
7543 #. type: Plain text
7544 #: build/C/man2/setfsuid.2:85
7545 msgid ""
7546 "When glibc determines that the argument is not a valid user ID, it will "
7547 "return -1 and set I<errno> to B<EINVAL> without attempting the system call."
7548 msgstr ""
7549
7550 #. type: Plain text
7551 #: build/C/man2/setfsuid.2:104
7552 msgid ""
7553 "At the time when this system call was introduced, one process could send a "
7554 "signal to another process with the same effective user ID.  This meant that "
7555 "if a privilged process changed its effective user ID for the purpose of file "
7556 "permission checking, then it could become vulnerable to receiving signals "
7557 "sent by another (unprivileged) process with the same user ID.  The "
7558 "filesystem user ID attribute was thus added to allow a process to change its "
7559 "user ID for the purposes of file permission checking without at the same "
7560 "time becoming vulnerable to receiving unwanted signals.  Since Linux 2.0, "
7561 "signal permission handling is different (see B<kill>(2)), with the result "
7562 "that a process change can change its effective user ID without being "
7563 "vulnerable to receiving signals from unwanted processes.  Thus, "
7564 "B<setfsuid>()  is nowadays unneeded and should be avoided in new "
7565 "applications (likewise for B<setfsgid>(2))."
7566 msgstr ""
7567
7568 #. type: Plain text
7569 #: build/C/man2/setfsuid.2:114
7570 msgid ""
7571 "The original Linux B<setfsuid>()  system call supported only 16-bit user "
7572 "IDs.  Subsequently, Linux 2.4 added B<setfsuid32>()  supporting 32-bit IDs.  "
7573 "The glibc B<setfsuid>()  wrapper function transparently deals with the "
7574 "variation across kernel versions."
7575 msgstr ""
7576
7577 #. type: Plain text
7578 #: build/C/man2/setfsuid.2:131
7579 msgid ""
7580 "No error indications of any kind are returned to the caller, and the fact "
7581 "that both successful and unsuccessful calls return the same value makes it "
7582 "impossible to directly determine whether the call succeeded or failed.  "
7583 "Instead, the caller must resort to looking at the return value from a "
7584 "further call such as I<setfsuid(-1)> (which will always fail), in order to "
7585 "determine if a preceding call to B<setfsuid>()  changed the filesystem user "
7586 "ID.  At the very least, B<EPERM> should be returned when the call fails "
7587 "(because the caller lacks the B<CAP_SETUID> capability)."
7588 msgstr ""
7589
7590 #. type: Plain text
7591 #: build/C/man2/setfsuid.2:136
7592 msgid "B<kill>(2), B<setfsgid>(2), B<capabilities>(7), B<credentials>(7)"
7593 msgstr ""
7594
7595 #. type: TH
7596 #: build/C/man2/setgid.2:29
7597 #, no-wrap
7598 msgid "SETGID"
7599 msgstr ""
7600
7601 #. type: Plain text
7602 #: build/C/man2/setgid.2:32
7603 msgid "setgid - set group identity"
7604 msgstr ""
7605
7606 #. type: Plain text
7607 #: build/C/man2/setgid.2:38
7608 msgid "B<int setgid(gid_t >I<gid>B<);>"
7609 msgstr ""
7610
7611 #. type: Plain text
7612 #: build/C/man2/setgid.2:43
7613 msgid ""
7614 "B<setgid>()  sets the effective group ID of the calling process.  If the "
7615 "caller is the superuser, the real GID and saved set-group-ID are also set."
7616 msgstr ""
7617
7618 #. type: Plain text
7619 #: build/C/man2/setgid.2:53
7620 msgid ""
7621 "Under Linux, B<setgid>()  is implemented like the POSIX version with the "
7622 "B<_POSIX_SAVED_IDS> feature.  This allows a set-group-ID program that is not "
7623 "set-user-ID-root to drop all of its group privileges, do some un-privileged "
7624 "work, and then reengage the original effective group ID in a secure manner."
7625 msgstr ""
7626
7627 #. type: Plain text
7628 #: build/C/man2/setgid.2:66
7629 msgid ""
7630 "The calling process is not privileged (does not have the B<CAP_SETGID> "
7631 "capability), and I<gid> does not match the real group ID or saved "
7632 "set-group-ID of the calling process."
7633 msgstr ""
7634
7635 #. type: Plain text
7636 #: build/C/man2/setgid.2:78
7637 msgid ""
7638 "The original Linux B<setgid>()  system call supported only 16-bit group "
7639 "IDs.  Subsequently, Linux 2.4 added B<setgid32>()  supporting 32-bit IDs.  "
7640 "The glibc B<setgid>()  wrapper function transparently deals with the "
7641 "variation across kernel versions."
7642 msgstr ""
7643
7644 #. type: Plain text
7645 #: build/C/man2/setgid.2:84
7646 msgid ""
7647 "B<getgid>(2), B<setegid>(2), B<setregid>(2), B<capabilities>(7), "
7648 "B<credentials>(7)"
7649 msgstr ""
7650
7651 #. type: TH
7652 #: build/C/man2/setpgid.2:48
7653 #, no-wrap
7654 msgid "SETPGID"
7655 msgstr ""
7656
7657 #. type: TH
7658 #: build/C/man2/setpgid.2:48
7659 #, no-wrap
7660 msgid "2013-07-31"
7661 msgstr ""
7662
7663 #. type: Plain text
7664 #: build/C/man2/setpgid.2:51
7665 msgid "setpgid, getpgid, setpgrp, getpgrp - set/get process group"
7666 msgstr ""
7667
7668 #. type: Plain text
7669 #: build/C/man2/setpgid.2:55
7670 msgid "B<int setpgid(pid_t >I<pid>B<, pid_t >I<pgid>B<);>"
7671 msgstr ""
7672
7673 #. type: Plain text
7674 #: build/C/man2/setpgid.2:57
7675 msgid "B<pid_t getpgid(pid_t >I<pid>B<);>"
7676 msgstr ""
7677
7678 #. type: Plain text
7679 #: build/C/man2/setpgid.2:59
7680 msgid "B<pid_t getpgrp(void);> /* POSIX.1 version */"
7681 msgstr ""
7682
7683 #. type: Plain text
7684 #: build/C/man2/setpgid.2:62
7685 msgid ""
7686 "B<pid_t getpgrp(pid_t >I<pid>B<);\\ \\ \\ \\ \\ \\ \\ \\ \\ \\ \\ > /* BSD "
7687 "version */"
7688 msgstr ""
7689
7690 #. type: Plain text
7691 #: build/C/man2/setpgid.2:64
7692 msgid "B<int setpgrp(void);> /* System V version */"
7693 msgstr ""
7694
7695 #. type: Plain text
7696 #: build/C/man2/setpgid.2:67
7697 msgid "B<int setpgrp(pid_t >I<pid>B<, pid_t >I<pgid>B<);\\ > /* BSD version */"
7698 msgstr ""
7699
7700 #. type: Plain text
7701 #: build/C/man2/setpgid.2:76
7702 msgid "B<getpgid>():"
7703 msgstr ""
7704
7705 #. type: Plain text
7706 #: build/C/man2/setpgid.2:84
7707 msgid "B<setpgrp>() (POSIX.1):"
7708 msgstr ""
7709
7710 #. type: Plain text
7711 #: build/C/man2/setpgid.2:87
7712 #, no-wrap
7713 msgid ""
7714 "    _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 ||\n"
7715 "    _XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED\n"
7716 msgstr ""
7717
7718 #. type: Plain text
7719 #: build/C/man2/setpgid.2:91
7720 msgid "B<setpgrp>()\\ (BSD), B<getpgrp>()\\ (BSD):"
7721 msgstr ""
7722
7723 #. type: Plain text
7724 #: build/C/man2/setpgid.2:95
7725 #, no-wrap
7726 msgid ""
7727 "    _BSD_SOURCE &&\n"
7728 "        !\\ (_POSIX_SOURCE || _POSIX_C_SOURCE || _XOPEN_SOURCE ||\n"
7729 "           _XOPEN_SOURCE_EXTENDED || _GNU_SOURCE || _SVID_SOURCE)\n"
7730 msgstr ""
7731
7732 #. type: Plain text
7733 #: build/C/man2/setpgid.2:107
7734 msgid ""
7735 "All of these interfaces are available on Linux, and are used for getting and "
7736 "setting the process group ID (PGID) of a process.  The preferred, "
7737 "POSIX.1-specified ways of doing this are: B<getpgrp>(void), for retrieving "
7738 "the calling process's PGID; and B<setpgid>(), for setting a process's PGID."
7739 msgstr ""
7740
7741 #. type: Plain text
7742 #: build/C/man2/setpgid.2:132
7743 msgid ""
7744 "B<setpgid>()  sets the PGID of the process specified by I<pid> to I<pgid>.  "
7745 "If I<pid> is zero, then the process ID of the calling process is used.  If "
7746 "I<pgid> is zero, then the PGID of the process specified by I<pid> is made "
7747 "the same as its process ID.  If B<setpgid>()  is used to move a process from "
7748 "one process group to another (as is done by some shells when creating "
7749 "pipelines), both process groups must be part of the same session (see "
7750 "B<setsid>(2)  and B<credentials>(7)).  In this case, the I<pgid> specifies "
7751 "an existing process group to be joined and the session ID of that group must "
7752 "match the session ID of the joining process."
7753 msgstr ""
7754
7755 #. type: Plain text
7756 #: build/C/man2/setpgid.2:137
7757 msgid ""
7758 "The POSIX.1 version of B<getpgrp>(), which takes no arguments, returns the "
7759 "PGID of the calling process."
7760 msgstr ""
7761
7762 #. type: Plain text
7763 #: build/C/man2/setpgid.2:148
7764 msgid ""
7765 "B<getpgid>()  returns the PGID of the process specified by I<pid>.  If "
7766 "I<pid> is zero, the process ID of the calling process is used.  (Retrieving "
7767 "the PGID of a process other than the caller is rarely necessary, and the "
7768 "POSIX.1 B<getpgrp>()  is preferred for that task.)"
7769 msgstr ""
7770
7771 #. type: Plain text
7772 #: build/C/man2/setpgid.2:153
7773 msgid ""
7774 "The System V-style B<setpgrp>(), which takes no arguments, is equivalent to "
7775 "I<setpgid(0,\\ 0)>."
7776 msgstr ""
7777
7778 #.  The true BSD setpgrp() system call differs in allowing the PGID
7779 #.  to be set to arbitrary values, rather than being restricted to
7780 #.  PGIDs in the same session.
7781 #. type: Plain text
7782 #: build/C/man2/setpgid.2:165
7783 msgid ""
7784 "The BSD-specific B<setpgrp>()  call, which takes arguments I<pid> and "
7785 "I<pgid>, is equivalent to I<setpgid(pid, pgid)>."
7786 msgstr ""
7787
7788 #. type: Plain text
7789 #: build/C/man2/setpgid.2:172
7790 msgid ""
7791 "The BSD-specific B<getpgrp>()  call, which takes a single I<pid> argument, "
7792 "is equivalent to I<getpgid(pid)>."
7793 msgstr ""
7794
7795 #. type: Plain text
7796 #: build/C/man2/setpgid.2:181
7797 msgid ""
7798 "On success, B<setpgid>()  and B<setpgrp>()  return zero.  On error, -1 is "
7799 "returned, and I<errno> is set appropriately."
7800 msgstr ""
7801
7802 #. type: Plain text
7803 #: build/C/man2/setpgid.2:185
7804 msgid "The POSIX.1 B<getpgrp>()  always returns the PGID of the caller."
7805 msgstr ""
7806
7807 #. type: Plain text
7808 #: build/C/man2/setpgid.2:193
7809 msgid ""
7810 "B<getpgid>(), and the BSD-specific B<getpgrp>()  return a process group on "
7811 "success.  On error, -1 is returned, and I<errno> is set appropriately."
7812 msgstr ""
7813
7814 #. type: Plain text
7815 #: build/C/man2/setpgid.2:202
7816 msgid ""
7817 "An attempt was made to change the process group ID of one of the children of "
7818 "the calling process and the child had already performed an B<execve>(2)  "
7819 "(B<setpgid>(), B<setpgrp>())."
7820 msgstr ""
7821
7822 #. type: Plain text
7823 #: build/C/man2/setpgid.2:208
7824 msgid "I<pgid> is less than 0 (B<setpgid>(), B<setpgrp>())."
7825 msgstr ""
7826
7827 #. type: Plain text
7828 #: build/C/man2/setpgid.2:217
7829 msgid ""
7830 "An attempt was made to move a process into a process group in a different "
7831 "session, or to change the process group ID of one of the children of the "
7832 "calling process and the child was in a different session, or to change the "
7833 "process group ID of a session leader (B<setpgid>(), B<setpgrp>())."
7834 msgstr ""
7835
7836 #. type: Plain text
7837 #: build/C/man2/setpgid.2:227
7838 msgid ""
7839 "For B<getpgid>(): I<pid> does not match any process.  For B<setpgid>(): "
7840 "I<pid> is not the calling process and not a child of the calling process."
7841 msgstr ""
7842
7843 #. type: Plain text
7844 #: build/C/man2/setpgid.2:233
7845 msgid ""
7846 "B<setpgid>()  and the version of B<getpgrp>()  with no arguments conform to "
7847 "POSIX.1-2001."
7848 msgstr ""
7849
7850 #. type: Plain text
7851 #: build/C/man2/setpgid.2:242
7852 msgid ""
7853 "POSIX.1-2001 also specifies B<getpgid>()  and the version of B<setpgrp>()  "
7854 "that takes no arguments.  (POSIX.1-2008 marks this B<setpgrp>()  "
7855 "specification as obsolete.)"
7856 msgstr ""
7857
7858 #. type: Plain text
7859 #: build/C/man2/setpgid.2:249
7860 msgid ""
7861 "The version of B<getpgrp>()  with one argument and the version of "
7862 "B<setpgrp>()  that takes two arguments derive from 4.2BSD, and are not "
7863 "specified by POSIX.1."
7864 msgstr ""
7865
7866 #. type: Plain text
7867 #: build/C/man2/setpgid.2:255
7868 msgid ""
7869 "A child created via B<fork>(2)  inherits its parent's process group ID.  The "
7870 "PGID is preserved across an B<execve>(2)."
7871 msgstr ""
7872
7873 #. type: Plain text
7874 #: build/C/man2/setpgid.2:258
7875 msgid ""
7876 "Each process group is a member of a session and each process is a member of "
7877 "the session of which its process group is a member."
7878 msgstr ""
7879
7880 #. type: Plain text
7881 #: build/C/man2/setpgid.2:285
7882 msgid ""
7883 "A session can have a controlling terminal.  At any time, one (and only one) "
7884 "of the process groups in the session can be the foreground process group for "
7885 "the terminal; the remaining process groups are in the background.  If a "
7886 "signal is generated from the terminal (e.g., typing the interrupt key to "
7887 "generate B<SIGINT>), that signal is sent to the foreground process group.  "
7888 "(See B<termios>(3)  for a description of the characters that generate "
7889 "signals.)  Only the foreground process group may B<read>(2)  from the "
7890 "terminal; if a background process group tries to B<read>(2)  from the "
7891 "terminal, then the group is sent a B<SIGTTIN> signal, which suspends it.  "
7892 "The B<tcgetpgrp>(3)  and B<tcsetpgrp>(3)  functions are used to get/set the "
7893 "foreground process group of the controlling terminal."
7894 msgstr ""
7895
7896 #. type: Plain text
7897 #: build/C/man2/setpgid.2:293
7898 msgid ""
7899 "The B<setpgid>()  and B<getpgrp>()  calls are used by programs such as "
7900 "B<bash>(1)  to create process groups in order to implement shell job "
7901 "control."
7902 msgstr ""
7903
7904 #. type: Plain text
7905 #: build/C/man2/setpgid.2:303
7906 msgid ""
7907 "If a session has a controlling terminal, and the B<CLOCAL> flag for that "
7908 "terminal is not set, and a terminal hangup occurs, then the session leader "
7909 "is sent a B<SIGHUP>.  If the session leader exits, then a B<SIGHUP> signal "
7910 "will also be sent to each process in the foreground process group of the "
7911 "controlling terminal."
7912 msgstr ""
7913
7914 #.  exit.3 refers to the following text:
7915 #. type: Plain text
7916 #: build/C/man2/setpgid.2:317
7917 msgid ""
7918 "If the exit of the process causes a process group to become orphaned, and if "
7919 "any member of the newly orphaned process group is stopped, then a B<SIGHUP> "
7920 "signal followed by a B<SIGCONT> signal will be sent to each process in the "
7921 "newly orphaned process group.  An orphaned process group is one in which the "
7922 "parent of every member of process group is either itself also a member of "
7923 "the process group or is a member of a process group in a different session "
7924 "(see also B<credentials>(7))."
7925 msgstr ""
7926
7927 #. type: Plain text
7928 #: build/C/man2/setpgid.2:324
7929 msgid ""
7930 "B<getuid>(2), B<setsid>(2), B<tcgetpgrp>(3), B<tcsetpgrp>(3), B<termios>(3), "
7931 "B<credentials>(7)"
7932 msgstr ""
7933
7934 #. type: TH
7935 #: build/C/man2/setresuid.2:26
7936 #, no-wrap
7937 msgid "SETRESUID"
7938 msgstr ""
7939
7940 #. type: Plain text
7941 #: build/C/man2/setresuid.2:29
7942 msgid "setresuid, setresgid - set real, effective and saved user or group ID"
7943 msgstr ""
7944
7945 #. type: Plain text
7946 #: build/C/man2/setresuid.2:35
7947 msgid "B<int setresuid(uid_t >I<ruid>B<, uid_t >I<euid>B<, uid_t >I<suid>B<);>"
7948 msgstr ""
7949
7950 #. type: Plain text
7951 #: build/C/man2/setresuid.2:37
7952 msgid "B<int setresgid(gid_t >I<rgid>B<, gid_t >I<egid>B<, gid_t >I<sgid>B<);>"
7953 msgstr ""
7954
7955 #. type: Plain text
7956 #: build/C/man2/setresuid.2:41
7957 msgid ""
7958 "B<setresuid>()  sets the real user ID, the effective user ID, and the saved "
7959 "set-user-ID of the calling process."
7960 msgstr ""
7961
7962 #. type: Plain text
7963 #: build/C/man2/setresuid.2:47
7964 msgid ""
7965 "Unprivileged user processes may change the real UID, effective UID, and "
7966 "saved set-user-ID, each to one of: the current real UID, the current "
7967 "effective UID or the current saved set-user-ID."
7968 msgstr ""
7969
7970 #. type: Plain text
7971 #: build/C/man2/setresuid.2:51
7972 msgid ""
7973 "Privileged processes (on Linux, those having the B<CAP_SETUID> capability)  "
7974 "may set the real UID, effective UID, and saved set-user-ID to arbitrary "
7975 "values."
7976 msgstr ""
7977
7978 #. type: Plain text
7979 #: build/C/man2/setresuid.2:53
7980 msgid "If one of the arguments equals -1, the corresponding value is not changed."
7981 msgstr ""
7982
7983 #. type: Plain text
7984 #: build/C/man2/setresuid.2:57
7985 msgid ""
7986 "Regardless of what changes are made to the real UID, effective UID, and "
7987 "saved set-user-ID, the filesystem UID is always set to the same value as the "
7988 "(possibly new) effective UID."
7989 msgstr ""
7990
7991 #. type: Plain text
7992 #: build/C/man2/setresuid.2:64
7993 msgid ""
7994 "Completely analogously, B<setresgid>()  sets the real GID, effective GID, "
7995 "and saved set-group-ID of the calling process (and always modifies the "
7996 "filesystem GID to be the same as the effective GID), with the same "
7997 "restrictions for unprivileged processes."
7998 msgstr ""
7999
8000 #. type: TP
8001 #: build/C/man2/setresuid.2:70 build/C/man2/setuid.2:76
8002 #, no-wrap
8003 msgid "B<EAGAIN>"
8004 msgstr ""
8005
8006 #. type: Plain text
8007 #: build/C/man2/setresuid.2:77
8008 msgid ""
8009 "I<uid> does not match the current UID and this call would bring that user ID "
8010 "over its B<RLIMIT_NPROC> resource limit."
8011 msgstr ""
8012
8013 #. type: Plain text
8014 #: build/C/man2/setresuid.2:81
8015 msgid ""
8016 "The calling process is not privileged (did not have the B<CAP_SETUID> "
8017 "capability) and tried to change the IDs to values that are not permitted."
8018 msgstr ""
8019
8020 #. type: Plain text
8021 #: build/C/man2/setresuid.2:83
8022 msgid "These calls are available under Linux since Linux 2.1.44."
8023 msgstr ""
8024
8025 #. type: Plain text
8026 #: build/C/man2/setresuid.2:90
8027 msgid ""
8028 "Under HP-UX and FreeBSD, the prototype is found in I<E<lt>unistd.hE<gt>>.  "
8029 "Under Linux the prototype is provided by glibc since version 2.3.2."
8030 msgstr ""
8031
8032 #. type: Plain text
8033 #: build/C/man2/setresuid.2:106
8034 msgid ""
8035 "The original Linux B<setresuid>()  and B<setresgid>()  system calls "
8036 "supported only 16-bit user and group IDs.  Subsequently, Linux 2.4 added "
8037 "B<setresuid32>()  and B<setresgid32>(), supporting 32-bit IDs.  The glibc "
8038 "B<setresuid>()  and B<setresgid>()  wrapper functions transparently deal "
8039 "with the variations across kernel versions."
8040 msgstr ""
8041
8042 #. type: Plain text
8043 #: build/C/man2/setresuid.2:115
8044 msgid ""
8045 "B<getresuid>(2), B<getuid>(2), B<setfsgid>(2), B<setfsuid>(2), "
8046 "B<setreuid>(2), B<setuid>(2), B<capabilities>(7), B<credentials>(7)"
8047 msgstr ""
8048
8049 #. type: TH
8050 #: build/C/man2/setreuid.2:45
8051 #, no-wrap
8052 msgid "SETREUID"
8053 msgstr ""
8054
8055 #. type: Plain text
8056 #: build/C/man2/setreuid.2:48
8057 msgid "setreuid, setregid - set real and/or effective user or group ID"
8058 msgstr ""
8059
8060 #. type: Plain text
8061 #: build/C/man2/setreuid.2:54
8062 msgid "B<int setreuid(uid_t >I<ruid>B<, uid_t >I<euid>B<);>"
8063 msgstr ""
8064
8065 #. type: Plain text
8066 #: build/C/man2/setreuid.2:56
8067 msgid "B<int setregid(gid_t >I<rgid>B<, gid_t >I<egid>B<);>"
8068 msgstr ""
8069
8070 #. type: Plain text
8071 #: build/C/man2/setreuid.2:64
8072 msgid "B<setreuid>(), B<setregid>():"
8073 msgstr ""
8074
8075 #. type: Plain text
8076 #: build/C/man2/setreuid.2:68
8077 msgid ""
8078 "_BSD_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || _XOPEN_SOURCE\\ &&\\ "
8079 "_XOPEN_SOURCE_EXTENDED"
8080 msgstr ""
8081
8082 #. type: Plain text
8083 #: build/C/man2/setreuid.2:73
8084 msgid "B<setreuid>()  sets real and effective user IDs of the calling process."
8085 msgstr ""
8086
8087 #. type: Plain text
8088 #: build/C/man2/setreuid.2:76
8089 msgid ""
8090 "Supplying a value of -1 for either the real or effective user ID forces the "
8091 "system to leave that ID unchanged."
8092 msgstr ""
8093
8094 #. type: Plain text
8095 #: build/C/man2/setreuid.2:79
8096 msgid ""
8097 "Unprivileged processes may only set the effective user ID to the real user "
8098 "ID, the effective user ID, or the saved set-user-ID."
8099 msgstr ""
8100
8101 #. type: Plain text
8102 #: build/C/man2/setreuid.2:82
8103 msgid ""
8104 "Unprivileged users may only set the real user ID to the real user ID or the "
8105 "effective user ID."
8106 msgstr ""
8107
8108 #. type: Plain text
8109 #: build/C/man2/setreuid.2:86
8110 msgid ""
8111 "If the real user ID is set or the effective user ID is set to a value not "
8112 "equal to the previous real user ID, the saved set-user-ID will be set to the "
8113 "new effective user ID."
8114 msgstr ""
8115
8116 #. type: Plain text
8117 #: build/C/man2/setreuid.2:91
8118 msgid ""
8119 "Completely analogously, B<setregid>()  sets real and effective group ID's of "
8120 "the calling process, and all of the above holds with \"group\" instead of "
8121 "\"user\"."
8122 msgstr ""
8123
8124 #. type: Plain text
8125 #: build/C/man2/setreuid.2:113
8126 msgid ""
8127 "The calling process is not privileged (Linux: does not have the "
8128 "B<CAP_SETUID> capability in the case of B<setreuid>(), or the B<CAP_SETGID> "
8129 "capability in the case of B<setregid>())  and a change other than (i)  "
8130 "swapping the effective user (group) ID with the real user (group) ID, or "
8131 "(ii) setting one to the value of the other or (iii) setting the effective "
8132 "user (group) ID to the value of the saved set-user-ID (saved set-group-ID) "
8133 "was specified."
8134 msgstr ""
8135
8136 #. type: Plain text
8137 #: build/C/man2/setreuid.2:119
8138 msgid ""
8139 "POSIX.1-2001, 4.3BSD (the B<setreuid>()  and B<setregid>()  function calls "
8140 "first appeared in 4.2BSD)."
8141 msgstr ""
8142
8143 #. type: Plain text
8144 #: build/C/man2/setreuid.2:123
8145 msgid ""
8146 "Setting the effective user (group) ID to the saved set-user-ID (saved "
8147 "set-group-ID) is possible since Linux 1.1.37 (1.1.38)."
8148 msgstr ""
8149
8150 #. type: Plain text
8151 #: build/C/man2/setreuid.2:140
8152 msgid ""
8153 "POSIX.1 does not specify all of possible ID changes that are permitted on "
8154 "Linux for an unprivileged process.  For B<setreuid>(), the effective user ID "
8155 "can be made the same as the real user ID or the save set-user-ID, and it is "
8156 "unspecified whether unprivileged processes may set the real user ID to the "
8157 "real user ID, the effective user ID, or the saved set-user-ID.  For "
8158 "B<setregid>(), the real group ID can be changed to the value of the saved "
8159 "set-group-ID, and the effective group ID can be changed to the value of the "
8160 "real group ID or the saved set-group-ID.  The precise details of what ID "
8161 "changes are permitted vary across implementations."
8162 msgstr ""
8163
8164 #. type: Plain text
8165 #: build/C/man2/setreuid.2:143
8166 msgid ""
8167 "POSIX.1 makes no specification about the effect of these calls on the saved "
8168 "set-user-ID and saved set-group-ID."
8169 msgstr ""
8170
8171 #. type: Plain text
8172 #: build/C/man2/setreuid.2:159
8173 msgid ""
8174 "The original Linux B<setreuid>()  and B<setregid>()  system calls supported "
8175 "only 16-bit user and group IDs.  Subsequently, Linux 2.4 added "
8176 "B<setreuid32>()  and B<setregid32>(), supporting 32-bit IDs.  The glibc "
8177 "B<setreuid>()  and B<setregid>()  wrapper functions transparently deal with "
8178 "the variations across kernel versions."
8179 msgstr ""
8180
8181 #. type: Plain text
8182 #: build/C/man2/setreuid.2:167
8183 msgid ""
8184 "B<getgid>(2), B<getuid>(2), B<seteuid>(2), B<setgid>(2), B<setresuid>(2), "
8185 "B<setuid>(2), B<capabilities>(7)"
8186 msgstr ""
8187
8188 #. type: TH
8189 #: build/C/man2/setsid.2:30
8190 #, no-wrap
8191 msgid "SETSID"
8192 msgstr ""
8193
8194 #. type: Plain text
8195 #: build/C/man2/setsid.2:33
8196 msgid "setsid - creates a session and sets the process group ID"
8197 msgstr ""
8198
8199 #. type: Plain text
8200 #: build/C/man2/setsid.2:38
8201 msgid "B<pid_t setsid(void);>"
8202 msgstr ""
8203
8204 #. type: Plain text
8205 #: build/C/man2/setsid.2:51
8206 msgid ""
8207 "B<setsid>()  creates a new session if the calling process is not a process "
8208 "group leader.  The calling process is the leader of the new session, the "
8209 "process group leader of the new process group, and has no controlling "
8210 "terminal.  The process group ID and session ID of the calling process are "
8211 "set to the PID of the calling process.  The calling process will be the only "
8212 "process in this new process group and in this new session."
8213 msgstr ""
8214
8215 #. type: Plain text
8216 #: build/C/man2/setsid.2:58
8217 msgid ""
8218 "On success, the (new) session ID of the calling process is returned.  On "
8219 "error, I<(pid_t)\\ -1> is returned, and I<errno> is set to indicate the "
8220 "error."
8221 msgstr ""
8222
8223 #. type: Plain text
8224 #: build/C/man2/setsid.2:65
8225 msgid ""
8226 "The process group ID of any process equals the PID of the calling process.  "
8227 "Thus, in particular, B<setsid>()  fails if the calling process is already a "
8228 "process group leader."
8229 msgstr ""
8230
8231 #. type: Plain text
8232 #: build/C/man2/setsid.2:73
8233 msgid ""
8234 "A child created via B<fork>(2)  inherits its parent's session ID.  The "
8235 "session ID is preserved across an B<execve>(2)."
8236 msgstr ""
8237
8238 #. type: Plain text
8239 #: build/C/man2/setsid.2:84
8240 msgid ""
8241 "A process group leader is a process with process group ID equal to its PID.  "
8242 "In order to be sure that B<setsid>()  will succeed, B<fork>(2)  and "
8243 "B<_exit>(2), and have the child do B<setsid>()."
8244 msgstr ""
8245
8246 #. type: Plain text
8247 #: build/C/man2/setsid.2:91
8248 msgid ""
8249 "B<setsid>(1), B<getsid>(2), B<setpgid>(2), B<setpgrp>(2), B<tcgetsid>(3), "
8250 "B<credentials>(7)"
8251 msgstr ""
8252
8253 #. type: TH
8254 #: build/C/man2/setuid.2:30
8255 #, no-wrap
8256 msgid "SETUID"
8257 msgstr ""
8258
8259 #. type: Plain text
8260 #: build/C/man2/setuid.2:33
8261 msgid "setuid - set user identity"
8262 msgstr ""
8263
8264 #. type: Plain text
8265 #: build/C/man2/setuid.2:39
8266 msgid "B<int setuid(uid_t >I<uid>B<);>"
8267 msgstr ""
8268
8269 #. type: Plain text
8270 #: build/C/man2/setuid.2:44
8271 msgid ""
8272 "B<setuid>()  sets the effective user ID of the calling process.  If the "
8273 "effective UID of the caller is root, the real UID and saved set-user-ID are "
8274 "also set."
8275 msgstr ""
8276
8277 #. type: Plain text
8278 #: build/C/man2/setuid.2:53
8279 msgid ""
8280 "Under Linux, B<setuid>()  is implemented like the POSIX version with the "
8281 "B<_POSIX_SAVED_IDS> feature.  This allows a set-user-ID (other than root) "
8282 "program to drop all of its user privileges, do some un-privileged work, and "
8283 "then reengage the original effective user ID in a secure manner."
8284 msgstr ""
8285
8286 #. type: Plain text
8287 #: build/C/man2/setuid.2:63
8288 msgid ""
8289 "If the user is root or the program is set-user-ID-root, special care must be "
8290 "taken.  The B<setuid>()  function checks the effective user ID of the caller "
8291 "and if it is the superuser, all process-related user ID's are set to "
8292 "I<uid>.  After this has occurred, it is impossible for the program to regain "
8293 "root privileges."
8294 msgstr ""
8295
8296 #. type: Plain text
8297 #: build/C/man2/setuid.2:70
8298 msgid ""
8299 "Thus, a set-user-ID-root program wishing to temporarily drop root "
8300 "privileges, assume the identity of an unprivileged user, and then regain "
8301 "root privileges afterward cannot use B<setuid>().  You can accomplish this "
8302 "with B<seteuid>(2)."
8303 msgstr ""
8304
8305 #. type: Plain text
8306 #: build/C/man2/setuid.2:85
8307 msgid ""
8308 "The I<uid> does not match the current uid and I<uid> brings process over its "
8309 "B<RLIMIT_NPROC> resource limit."
8310 msgstr ""
8311
8312 #. type: Plain text
8313 #: build/C/man2/setuid.2:92
8314 msgid ""
8315 "The user is not privileged (Linux: does not have the B<CAP_SETUID> "
8316 "capability) and I<uid> does not match the real UID or saved set-user-ID of "
8317 "the calling process."
8318 msgstr ""
8319
8320 #.  SVr4 documents an additional EINVAL error condition.
8321 #. type: Plain text
8322 #: build/C/man2/setuid.2:97
8323 msgid ""
8324 "SVr4, POSIX.1-2001.  Not quite compatible with the 4.4BSD call, which sets "
8325 "all of the real, saved, and effective user IDs."
8326 msgstr ""
8327
8328 #. type: Plain text
8329 #: build/C/man2/setuid.2:105
8330 msgid ""
8331 "Linux has the concept of the filesystem user ID, normally equal to the "
8332 "effective user ID.  The B<setuid>()  call also sets the filesystem user ID "
8333 "of the calling process.  See B<setfsuid>(2)."
8334 msgstr ""
8335
8336 #. type: Plain text
8337 #: build/C/man2/setuid.2:110
8338 msgid ""
8339 "If I<uid> is different from the old effective UID, the process will be "
8340 "forbidden from leaving core dumps."
8341 msgstr ""
8342
8343 #. type: Plain text
8344 #: build/C/man2/setuid.2:120
8345 msgid ""
8346 "The original Linux B<setuid>()  system call supported only 16-bit user IDs.  "
8347 "Subsequently, Linux 2.4 added B<setuid32>()  supporting 32-bit IDs.  The "
8348 "glibc B<setuid>()  wrapper function transparently deals with the variation "
8349 "across kernel versions."
8350 msgstr ""
8351
8352 #. type: Plain text
8353 #: build/C/man2/setuid.2:127
8354 msgid ""
8355 "B<getuid>(2), B<seteuid>(2), B<setfsuid>(2), B<setreuid>(2), "
8356 "B<capabilities>(7), B<credentials>(7)"
8357 msgstr ""
8358
8359 #. type: TH
8360 #: build/C/man7/svipc.7:40
8361 #, no-wrap
8362 msgid "SVIPC"
8363 msgstr ""
8364
8365 #. type: Plain text
8366 #: build/C/man7/svipc.7:43
8367 msgid "svipc - System V interprocess communication mechanisms"
8368 msgstr ""
8369
8370 #. type: Plain text
8371 #: build/C/man7/svipc.7:48
8372 #, no-wrap
8373 msgid ""
8374 "B<#include E<lt>sys/msg.hE<gt>>\n"
8375 "B<#include E<lt>sys/sem.hE<gt>>\n"
8376 "B<#include E<lt>sys/shm.hE<gt>>\n"
8377 msgstr ""
8378
8379 #. type: Plain text
8380 #: build/C/man7/svipc.7:56
8381 msgid ""
8382 "This manual page refers to the Linux implementation of the System V "
8383 "interprocess communication (IPC) mechanisms: message queues, semaphore sets, "
8384 "and shared memory segments.  In the following, the word I<resource> means an "
8385 "instantiation of one among such mechanisms."
8386 msgstr ""
8387
8388 #. type: SS
8389 #: build/C/man7/svipc.7:56
8390 #, no-wrap
8391 msgid "Resource access permissions"
8392 msgstr ""
8393
8394 #. type: Plain text
8395 #: build/C/man7/svipc.7:64
8396 msgid ""
8397 "For each resource, the system uses a common structure of type I<struct "
8398 "ipc_perm> to store information needed in determining permissions to perform "
8399 "an IPC operation.  The I<ipc_perm> structure includes the following members:"
8400 msgstr ""
8401
8402 #. type: Plain text
8403 #: build/C/man7/svipc.7:74
8404 #, no-wrap
8405 msgid ""
8406 "struct ipc_perm {\n"
8407 "    uid_t          cuid;   /* creator user ID */\n"
8408 "    gid_t          cgid;   /* creator group ID */\n"
8409 "    uid_t          uid;    /* owner user ID */\n"
8410 "    gid_t          gid;    /* owner group ID */\n"
8411 "    unsigned short mode;   /* r/w permissions */\n"
8412 "};\n"
8413 msgstr ""
8414
8415 #. type: Plain text
8416 #: build/C/man7/svipc.7:84
8417 msgid ""
8418 "The I<mode> member of the I<ipc_perm> structure defines, with its lower 9 "
8419 "bits, the access permissions to the resource for a process executing an IPC "
8420 "system call.  The permissions are interpreted as follows:"
8421 msgstr ""
8422
8423 #. type: Plain text
8424 #: build/C/man7/svipc.7:88
8425 #, no-wrap
8426 msgid ""
8427 "    0400    Read by user.\n"
8428 "    0200    Write by user.\n"
8429 msgstr ""
8430
8431 #. type: Plain text
8432 #: build/C/man7/svipc.7:91
8433 #, no-wrap
8434 msgid ""
8435 "    0040    Read by group.\n"
8436 "    0020    Write by group.\n"
8437 msgstr ""
8438
8439 #. type: Plain text
8440 #: build/C/man7/svipc.7:94
8441 #, no-wrap
8442 msgid ""
8443 "    0004    Read by others.\n"
8444 "    0002    Write by others.\n"
8445 msgstr ""
8446
8447 #. type: Plain text
8448 #: build/C/man7/svipc.7:102
8449 msgid ""
8450 "Bits 0100, 0010, and 0001 (the execute bits) are unused by the system.  "
8451 "Furthermore, \"write\" effectively means \"alter\" for a semaphore set."
8452 msgstr ""
8453
8454 #. type: Plain text
8455 #: build/C/man7/svipc.7:105
8456 msgid "The same system header file also defines the following symbolic constants:"
8457 msgstr ""
8458
8459 #. type: TP
8460 #: build/C/man7/svipc.7:105
8461 #, no-wrap
8462 msgid "B<IPC_CREAT>"
8463 msgstr ""
8464
8465 #. type: Plain text
8466 #: build/C/man7/svipc.7:108
8467 msgid "Create entry if key doesn't exist."
8468 msgstr ""
8469
8470 #. type: TP
8471 #: build/C/man7/svipc.7:108
8472 #, no-wrap
8473 msgid "B<IPC_EXCL>"
8474 msgstr ""
8475
8476 #. type: Plain text
8477 #: build/C/man7/svipc.7:111
8478 msgid "Fail if key exists."
8479 msgstr ""
8480
8481 #. type: TP
8482 #: build/C/man7/svipc.7:111
8483 #, no-wrap
8484 msgid "B<IPC_NOWAIT>"
8485 msgstr ""
8486
8487 #. type: Plain text
8488 #: build/C/man7/svipc.7:114
8489 msgid "Error if request must wait."
8490 msgstr ""
8491
8492 #. type: TP
8493 #: build/C/man7/svipc.7:114
8494 #, no-wrap
8495 msgid "B<IPC_PRIVATE>"
8496 msgstr ""
8497
8498 #. type: Plain text
8499 #: build/C/man7/svipc.7:117
8500 msgid "Private key."
8501 msgstr ""
8502
8503 #. type: TP
8504 #: build/C/man7/svipc.7:117
8505 #, no-wrap
8506 msgid "B<IPC_RMID>"
8507 msgstr ""
8508
8509 #. type: Plain text
8510 #: build/C/man7/svipc.7:120
8511 msgid "Remove resource."
8512 msgstr ""
8513
8514 #. type: TP
8515 #: build/C/man7/svipc.7:120
8516 #, no-wrap
8517 msgid "B<IPC_SET>"
8518 msgstr ""
8519
8520 #. type: Plain text
8521 #: build/C/man7/svipc.7:123
8522 msgid "Set resource options."
8523 msgstr ""
8524
8525 #. type: TP
8526 #: build/C/man7/svipc.7:123
8527 #, no-wrap
8528 msgid "B<IPC_STAT>"
8529 msgstr ""
8530
8531 #. type: Plain text
8532 #: build/C/man7/svipc.7:126
8533 msgid "Get resource options."
8534 msgstr ""
8535
8536 #. type: Plain text
8537 #: build/C/man7/svipc.7:135
8538 msgid ""
8539 "Note that B<IPC_PRIVATE> is a I<key_t> type, while all the other symbolic "
8540 "constants are flag fields and can be OR'ed into an I<int> type variable."
8541 msgstr ""
8542
8543 #. type: SS
8544 #: build/C/man7/svipc.7:135
8545 #, no-wrap
8546 msgid "Message queues"
8547 msgstr ""
8548
8549 #. type: Plain text
8550 #: build/C/man7/svipc.7:143
8551 msgid ""
8552 "A message queue is uniquely identified by a positive integer (its I<msqid>)  "
8553 "and has an associated data structure of type I<struct msqid_ds>, defined in "
8554 "I<E<lt>sys/msg.hE<gt>>, containing the following members:"
8555 msgstr ""
8556
8557 #. type: Plain text
8558 #: build/C/man7/svipc.7:156
8559 #, no-wrap
8560 msgid ""
8561 "struct msqid_ds {\n"
8562 "    struct ipc_perm msg_perm;\n"
8563 "    msgqnum_t       msg_qnum;    /* no of messages on queue */\n"
8564 "    msglen_t        msg_qbytes;  /* bytes max on a queue */\n"
8565 "    pid_t           msg_lspid;   /* PID of last msgsnd(2) call */\n"
8566 "    pid_t           msg_lrpid;   /* PID of last msgrcv(2) call */\n"
8567 "    time_t          msg_stime;   /* last msgsnd(2) time */\n"
8568 "    time_t          msg_rtime;   /* last msgrcv(2) time */\n"
8569 "    time_t          msg_ctime;   /* last change time */\n"
8570 "};\n"
8571 msgstr ""
8572
8573 #. type: TP
8574 #: build/C/man7/svipc.7:158
8575 #, no-wrap
8576 msgid "I<msg_perm>"
8577 msgstr ""
8578
8579 #. type: Plain text
8580 #: build/C/man7/svipc.7:163
8581 msgid ""
8582 "I<ipc_perm> structure that specifies the access permissions on the message "
8583 "queue."
8584 msgstr ""
8585
8586 #. type: TP
8587 #: build/C/man7/svipc.7:163
8588 #, no-wrap
8589 msgid "I<msg_qnum>"
8590 msgstr ""
8591
8592 #. type: Plain text
8593 #: build/C/man7/svipc.7:166
8594 msgid "Number of messages currently on the message queue."
8595 msgstr ""
8596
8597 #. type: TP
8598 #: build/C/man7/svipc.7:166
8599 #, no-wrap
8600 msgid "I<msg_qbytes>"
8601 msgstr ""
8602
8603 #. type: Plain text
8604 #: build/C/man7/svipc.7:170
8605 msgid "Maximum number of bytes of message text allowed on the message queue."
8606 msgstr ""
8607
8608 #. type: TP
8609 #: build/C/man7/svipc.7:170
8610 #, no-wrap
8611 msgid "I<msg_lspid>"
8612 msgstr ""
8613
8614 #. type: Plain text
8615 #: build/C/man7/svipc.7:175
8616 msgid "ID of the process that performed the last B<msgsnd>(2)  system call."
8617 msgstr ""
8618
8619 #. type: TP
8620 #: build/C/man7/svipc.7:175
8621 #, no-wrap
8622 msgid "I<msg_lrpid>"
8623 msgstr ""
8624
8625 #. type: Plain text
8626 #: build/C/man7/svipc.7:180
8627 msgid "ID of the process that performed the last B<msgrcv>(2)  system call."
8628 msgstr ""
8629
8630 #. type: TP
8631 #: build/C/man7/svipc.7:180
8632 #, no-wrap
8633 msgid "I<msg_stime>"
8634 msgstr ""
8635
8636 #. type: Plain text
8637 #: build/C/man7/svipc.7:185
8638 msgid "Time of the last B<msgsnd>(2)  system call."
8639 msgstr ""
8640
8641 #. type: TP
8642 #: build/C/man7/svipc.7:185
8643 #, no-wrap
8644 msgid "I<msg_rtime>"
8645 msgstr ""
8646
8647 #. type: Plain text
8648 #: build/C/man7/svipc.7:190
8649 msgid "Time of the last B<msgrcv>(2)  system call."
8650 msgstr ""
8651
8652 #. type: TP
8653 #: build/C/man7/svipc.7:190
8654 #, no-wrap
8655 msgid "I<msg_ctime>"
8656 msgstr ""
8657
8658 #. type: Plain text
8659 #: build/C/man7/svipc.7:196
8660 msgid ""
8661 "Time of the last system call that changed a member of the I<msqid_ds> "
8662 "structure."
8663 msgstr ""
8664
8665 #. type: SS
8666 #: build/C/man7/svipc.7:196
8667 #, no-wrap
8668 msgid "Semaphore sets"
8669 msgstr ""
8670
8671 #. type: Plain text
8672 #: build/C/man7/svipc.7:204
8673 msgid ""
8674 "A semaphore set is uniquely identified by a positive integer (its I<semid>)  "
8675 "and has an associated data structure of type I<struct semid_ds>, defined in "
8676 "I<E<lt>sys/sem.hE<gt>>, containing the following members:"
8677 msgstr ""
8678
8679 #. type: Plain text
8680 #: build/C/man7/svipc.7:213
8681 #, no-wrap
8682 msgid ""
8683 "struct semid_ds {\n"
8684 "    struct ipc_perm sem_perm;\n"
8685 "    time_t          sem_otime;   /* last operation time */\n"
8686 "    time_t          sem_ctime;   /* last change time */\n"
8687 "    unsigned long   sem_nsems;   /* count of sems in set */\n"
8688 "};\n"
8689 msgstr ""
8690
8691 #. type: TP
8692 #: build/C/man7/svipc.7:215
8693 #, no-wrap
8694 msgid "I<sem_perm>"
8695 msgstr ""
8696
8697 #. type: Plain text
8698 #: build/C/man7/svipc.7:220
8699 msgid ""
8700 "I<ipc_perm> structure that specifies the access permissions on the semaphore "
8701 "set."
8702 msgstr ""
8703
8704 #. type: TP
8705 #: build/C/man7/svipc.7:220
8706 #, no-wrap
8707 msgid "I<sem_otime>"
8708 msgstr ""
8709
8710 #. type: Plain text
8711 #: build/C/man7/svipc.7:225
8712 msgid "Time of last B<semop>(2)  system call."
8713 msgstr ""
8714
8715 #. type: TP
8716 #: build/C/man7/svipc.7:225
8717 #, no-wrap
8718 msgid "I<sem_ctime>"
8719 msgstr ""
8720
8721 #. type: Plain text
8722 #: build/C/man7/svipc.7:231
8723 msgid ""
8724 "Time of last B<semctl>(2)  system call that changed a member of the above "
8725 "structure or of one semaphore belonging to the set."
8726 msgstr ""
8727
8728 #. type: TP
8729 #: build/C/man7/svipc.7:231
8730 #, no-wrap
8731 msgid "I<sem_nsems>"
8732 msgstr ""
8733
8734 #. type: Plain text
8735 #: build/C/man7/svipc.7:239
8736 msgid ""
8737 "Number of semaphores in the set.  Each semaphore of the set is referenced by "
8738 "a nonnegative integer ranging from B<0> to I<sem_nsems-1>."
8739 msgstr ""
8740
8741 #. type: Plain text
8742 #: build/C/man7/svipc.7:243
8743 msgid ""
8744 "A semaphore is a data structure of type I<struct sem> containing the "
8745 "following members:"
8746 msgstr ""
8747
8748 #.     unsigned short semncnt; /* nr awaiting semval to increase */
8749 #.     unsigned short semzcnt; /* nr awaiting semval = 0 */
8750 #. type: Plain text
8751 #: build/C/man7/svipc.7:252
8752 #, no-wrap
8753 msgid ""
8754 "struct sem {\n"
8755 "    int semval;  /* semaphore value */\n"
8756 "    int sempid;  /* PID for last operation */\n"
8757 "};\n"
8758 msgstr ""
8759
8760 #. type: TP
8761 #: build/C/man7/svipc.7:254
8762 #, no-wrap
8763 msgid "I<semval>"
8764 msgstr ""
8765
8766 #. type: Plain text
8767 #: build/C/man7/svipc.7:257
8768 msgid "Semaphore value: a nonnegative integer."
8769 msgstr ""
8770
8771 #. type: TP
8772 #: build/C/man7/svipc.7:257
8773 #, no-wrap
8774 msgid "I<sempid>"
8775 msgstr ""
8776
8777 #. .TP
8778 #. .I semncnt
8779 #. Number of processes suspended awaiting for
8780 #. .I semval
8781 #. to increase.
8782 #. .TP
8783 #. .I semznt
8784 #. Number of processes suspended awaiting for
8785 #. .I semval
8786 #. to become zero.
8787 #. type: Plain text
8788 #: build/C/man7/svipc.7:271
8789 msgid ""
8790 "ID of the last process that performed a semaphore operation on this "
8791 "semaphore."
8792 msgstr ""
8793
8794 #. type: SS
8795 #: build/C/man7/svipc.7:271
8796 #, no-wrap
8797 msgid "Shared memory segments"
8798 msgstr ""
8799
8800 #. type: Plain text
8801 #: build/C/man7/svipc.7:279
8802 msgid ""
8803 "A shared memory segment is uniquely identified by a positive integer (its "
8804 "I<shmid>)  and has an associated data structure of type I<struct shmid_ds>, "
8805 "defined in I<E<lt>sys/shm.hE<gt>>, containing the following members:"
8806 msgstr ""
8807
8808 #. type: Plain text
8809 #: build/C/man7/svipc.7:292
8810 #, no-wrap
8811 msgid ""
8812 "struct shmid_ds {\n"
8813 "    struct ipc_perm shm_perm;\n"
8814 "    size_t          shm_segsz;   /* size of segment */\n"
8815 "    pid_t           shm_cpid;    /* PID of creator */\n"
8816 "    pid_t           shm_lpid;    /* PID, last operation */\n"
8817 "    shmatt_t        shm_nattch;  /* no. of current attaches */\n"
8818 "    time_t          shm_atime;   /* time of last attach */\n"
8819 "    time_t          shm_dtime;   /* time of last detach */\n"
8820 "    time_t          shm_ctime;   /* time of last change */\n"
8821 "};\n"
8822 msgstr ""
8823
8824 #. type: TP
8825 #: build/C/man7/svipc.7:294
8826 #, no-wrap
8827 msgid "I<shm_perm>"
8828 msgstr ""
8829
8830 #. type: Plain text
8831 #: build/C/man7/svipc.7:299
8832 msgid ""
8833 "I<ipc_perm> structure that specifies the access permissions on the shared "
8834 "memory segment."
8835 msgstr ""
8836
8837 #. type: TP
8838 #: build/C/man7/svipc.7:299
8839 #, no-wrap
8840 msgid "I<shm_segsz>"
8841 msgstr ""
8842
8843 #. type: Plain text
8844 #: build/C/man7/svipc.7:302
8845 msgid "Size in bytes of the shared memory segment."
8846 msgstr ""
8847
8848 #. type: TP
8849 #: build/C/man7/svipc.7:302
8850 #, no-wrap
8851 msgid "I<shm_cpid>"
8852 msgstr ""
8853
8854 #. type: Plain text
8855 #: build/C/man7/svipc.7:305
8856 msgid "ID of the process that created the shared memory segment."
8857 msgstr ""
8858
8859 #. type: TP
8860 #: build/C/man7/svipc.7:305
8861 #, no-wrap
8862 msgid "I<shm_lpid>"
8863 msgstr ""
8864
8865 #. type: Plain text
8866 #: build/C/man7/svipc.7:312
8867 msgid ""
8868 "ID of the last process that executed a B<shmat>(2)  or B<shmdt>(2)  system "
8869 "call."
8870 msgstr ""
8871
8872 #. type: TP
8873 #: build/C/man7/svipc.7:312
8874 #, no-wrap
8875 msgid "I<shm_nattch>"
8876 msgstr ""
8877
8878 #. type: Plain text
8879 #: build/C/man7/svipc.7:315
8880 msgid "Number of current alive attaches for this shared memory segment."
8881 msgstr ""
8882
8883 #. type: TP
8884 #: build/C/man7/svipc.7:315
8885 #, no-wrap
8886 msgid "I<shm_atime>"
8887 msgstr ""
8888
8889 #. type: Plain text
8890 #: build/C/man7/svipc.7:320
8891 msgid "Time of the last B<shmat>(2)  system call."
8892 msgstr ""
8893
8894 #. type: TP
8895 #: build/C/man7/svipc.7:320
8896 #, no-wrap
8897 msgid "I<shm_dtime>"
8898 msgstr ""
8899
8900 #. type: Plain text
8901 #: build/C/man7/svipc.7:325
8902 msgid "Time of the last B<shmdt>(2)  system call."
8903 msgstr ""
8904
8905 #. type: TP
8906 #: build/C/man7/svipc.7:325
8907 #, no-wrap
8908 msgid "I<shm_ctime>"
8909 msgstr ""
8910
8911 #. type: Plain text
8912 #: build/C/man7/svipc.7:331
8913 msgid "Time of the last B<shmctl>(2)  system call that changed I<shmid_ds>."
8914 msgstr ""
8915
8916 #. type: Plain text
8917 #: build/C/man7/svipc.7:348
8918 msgid ""
8919 "B<ipcmk>(1), B<ipcrm>(1), B<ipcs>(1), B<ipc>(2), B<msgctl>(2), B<msgget>(2), "
8920 "B<msgrcv>(2), B<msgsnd>(2), B<semctl>(2), B<semget>(2), B<semop>(2), "
8921 "B<shmat>(2), B<shmctl>(2), B<shmdt>(2), B<shmget>(2), B<ftok>(3)"
8922 msgstr ""
8923
8924 #. type: TH
8925 #: build/C/man3/ulimit.3:27
8926 #, no-wrap
8927 msgid "ULIMIT"
8928 msgstr ""
8929
8930 #. type: TH
8931 #: build/C/man3/ulimit.3:27
8932 #, no-wrap
8933 msgid "2008-08-06"
8934 msgstr ""
8935
8936 #. type: Plain text
8937 #: build/C/man3/ulimit.3:30
8938 msgid "ulimit - get and set user limits"
8939 msgstr ""
8940
8941 #. type: Plain text
8942 #: build/C/man3/ulimit.3:32
8943 msgid "B<#include E<lt>ulimit.hE<gt>>"
8944 msgstr ""
8945
8946 #. type: Plain text
8947 #: build/C/man3/ulimit.3:34
8948 msgid "B<long ulimit(int >I<cmd>B<, long >I<newlimit>B<);>"
8949 msgstr ""
8950
8951 #. type: Plain text
8952 #: build/C/man3/ulimit.3:46
8953 msgid ""
8954 "Warning: This routine is obsolete.  Use B<getrlimit>(2), B<setrlimit>(2), "
8955 "and B<sysconf>(3)  instead.  For the shell command B<ulimit>(), see "
8956 "B<bash>(1)."
8957 msgstr ""
8958
8959 #. type: Plain text
8960 #: build/C/man3/ulimit.3:53
8961 msgid ""
8962 "The B<ulimit>()  call will get or set some limit for the calling process.  "
8963 "The I<cmd> argument can have one of the following values."
8964 msgstr ""
8965
8966 #. type: TP
8967 #: build/C/man3/ulimit.3:53
8968 #, no-wrap
8969 msgid "B<UL_GETFSIZE>"
8970 msgstr ""
8971
8972 #. type: Plain text
8973 #: build/C/man3/ulimit.3:56
8974 msgid "Return the limit on the size of a file, in units of 512 bytes."
8975 msgstr ""
8976
8977 #. type: TP
8978 #: build/C/man3/ulimit.3:56
8979 #, no-wrap
8980 msgid "B<UL_SETFSIZE>"
8981 msgstr ""
8982
8983 #. type: Plain text
8984 #: build/C/man3/ulimit.3:59
8985 msgid "Set the limit on the size of a file."
8986 msgstr ""
8987
8988 #. type: TP
8989 #: build/C/man3/ulimit.3:59
8990 #, no-wrap
8991 msgid "B<3>"
8992 msgstr ""
8993
8994 #. type: Plain text
8995 #: build/C/man3/ulimit.3:63
8996 msgid ""
8997 "(Not implemented for Linux.)  Return the maximum possible address of the "
8998 "data segment."
8999 msgstr ""
9000
9001 #. type: TP
9002 #: build/C/man3/ulimit.3:63
9003 #, no-wrap
9004 msgid "B<4>"
9005 msgstr ""
9006
9007 #. type: Plain text
9008 #: build/C/man3/ulimit.3:67
9009 msgid ""
9010 "(Implemented but no symbolic constant provided.)  Return the maximum number "
9011 "of files that the calling process can open."
9012 msgstr ""
9013
9014 #. type: Plain text
9015 #: build/C/man3/ulimit.3:74
9016 msgid ""
9017 "On success, B<ulimit>()  returns a nonnegative value.  On error, -1 is "
9018 "returned, and I<errno> is set appropriately."
9019 msgstr ""
9020
9021 #. type: Plain text
9022 #: build/C/man3/ulimit.3:78
9023 msgid "A unprivileged process tried to increase a limit."
9024 msgstr ""
9025
9026 #. type: Plain text
9027 #: build/C/man3/ulimit.3:83
9028 msgid "SVr4, POSIX.1-2001.  POSIX.1-2008 marks B<ulimit>()  as obsolete."
9029 msgstr ""
9030
9031 #. type: Plain text
9032 #: build/C/man3/ulimit.3:88
9033 msgid "B<bash>(1), B<getrlimit>(2), B<setrlimit>(2), B<sysconf>(3)"
9034 msgstr ""