po4a/special/po/special.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: 2015-01-21 20:35+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 #.  Copyright (C) 2011, Hewlett-Packard Development Company, L.P.
  20 #.  Written by Stephen M. Cameron <scameron@beardog.cce.hp.com>
  21 #
  22 #.  %%%LICENSE_START(GPLv2_ONELINE)
  23 #.  Licensed under GNU General Public License version 2 (GPLv2)
  24 #.  %%%LICENSE_END
  25 #
  26 #.  shorthand for double quote that works everywhere.
  27 #. type: ds q
  28 #: build/C/man4/cciss.4:9 build/C/man4/hpsa.4:9
  29 #, no-wrap
  30 msgid "\\N'34'"
  31 msgstr ""
  32
  33 #. type: TH
  34 #: build/C/man4/cciss.4:10
  35 #, no-wrap
  36 msgid "CCISS"
  37 msgstr ""
  38
  39 #. type: TH
  40 #: build/C/man4/cciss.4:10 build/C/man4/console_codes.4:23 build/C/man4/dsp56k.4:27 build/C/man4/hpsa.4:10 build/C/man4/sk98lin.4:27
  41 #, no-wrap
  42 msgid "2012-08-05"
  43 msgstr ""
  44
  45 #. type: TH
  46 #: build/C/man4/cciss.4:10 build/C/man4/console.4:12 build/C/man4/console_codes.4:23 build/C/man4/console_ioctl.4:40 build/C/man5/core.5:25 build/C/man4/cpuid.4:26 build/C/man4/dsp56k.4:27 build/C/man4/fd.4:28 build/C/man7/fifo.7:13 build/C/man4/full.4:26 build/C/man3/gnu_get_libc_version.3:26 build/C/man4/hd.4:29 build/C/man4/hpsa.4:10 build/C/man4/initrd.4:35 build/C/man4/lp.4:27 build/C/man3/makedev.3:26 build/C/man4/mem.4:26 build/C/man2/mknod.2:15 build/C/man4/mouse.4:26 build/C/man4/msr.4:26 build/C/man4/null.4:26 build/C/man7/pipe.7:25 build/C/man4/ram.4:26 build/C/man4/random.4:19 build/C/man4/sd.4:26 build/C/man4/sk98lin.4:27 build/C/man4/st.4:25 build/C/man2/syslog.2:33 build/C/man3/syslog.3:36 build/C/man4/ttyS.4:26 build/C/man7/uri.7:48 build/C/man4/vcs.4:29 build/C/man4/wavelan.4:15
  47 #, no-wrap
  48 msgid "Linux"
  49 msgstr ""
  50
  51 #. type: TH
  52 #: build/C/man4/cciss.4:10 build/C/man4/console.4:12 build/C/man4/console_codes.4:23 build/C/man4/console_ioctl.4:40 build/C/man5/core.5:25 build/C/man4/cpuid.4:26 build/C/man4/dsp56k.4:27 build/C/man4/fd.4:28 build/C/man7/fifo.7:13 build/C/man4/full.4:26 build/C/man3/gnu_get_libc_version.3:26 build/C/man4/hd.4:29 build/C/man4/hpsa.4:10 build/C/man4/initrd.4:35 build/C/man4/lp.4:27 build/C/man3/makedev.3:26 build/C/man4/mem.4:26 build/C/man3/mkfifo.3:28 build/C/man2/mknod.2:15 build/C/man4/mouse.4:26 build/C/man4/msr.4:26 build/C/man4/null.4:26 build/C/man7/pipe.7:25 build/C/man4/ram.4:26 build/C/man4/random.4:19 build/C/man4/sd.4:26 build/C/man3/setlogmask.3:25 build/C/man4/sk98lin.4:27 build/C/man4/st.4:25 build/C/man3/stdarg.3:43 build/C/man2/syslog.2:33 build/C/man3/syslog.3:36 build/C/man4/ttyS.4:26 build/C/man7/uri.7:48 build/C/man4/vcs.4:29 build/C/man4/wavelan.4:15
  53 #, no-wrap
  54 msgid "Linux Programmer's Manual"
  55 msgstr ""
  56
  57 #. type: SH
  58 #: build/C/man4/cciss.4:11 build/C/man4/console.4:13 build/C/man4/console_codes.4:24 build/C/man4/console_ioctl.4:41 build/C/man5/core.5:26 build/C/man4/cpuid.4:27 build/C/man4/dsp56k.4:28 build/C/man4/fd.4:29 build/C/man7/fifo.7:14 build/C/man4/full.4:27 build/C/man3/gnu_get_libc_version.3:27 build/C/man4/hd.4:30 build/C/man4/hpsa.4:11 build/C/man4/initrd.4:36 build/C/man4/lp.4:28 build/C/man3/makedev.3:27 build/C/man4/mem.4:27 build/C/man3/mkfifo.3:29 build/C/man2/mknod.2:16 build/C/man4/mouse.4:27 build/C/man4/msr.4:27 build/C/man4/null.4:27 build/C/man7/pipe.7:26 build/C/man4/ram.4:27 build/C/man4/random.4:20 build/C/man4/sd.4:27 build/C/man3/setlogmask.3:26 build/C/man4/sk98lin.4:28 build/C/man4/st.4:26 build/C/man3/stdarg.3:44 build/C/man2/syslog.2:34 build/C/man3/syslog.3:37 build/C/man4/ttyS.4:27 build/C/man7/uri.7:49 build/C/man4/vcs.4:30 build/C/man4/wavelan.4:16
  59 #, no-wrap
  60 msgid "NAME"
  61 msgstr ""
  62
  63 #. type: Plain text
  64 #: build/C/man4/cciss.4:13
  65 msgid "cciss - HP Smart Array block driver"
  66 msgstr ""
  67
  68 #. type: SH
  69 #: build/C/man4/cciss.4:13 build/C/man4/dsp56k.4:30 build/C/man3/gnu_get_libc_version.3:29 build/C/man4/hpsa.4:13 build/C/man4/lp.4:30 build/C/man3/makedev.3:29 build/C/man3/mkfifo.3:31 build/C/man2/mknod.2:18 build/C/man4/random.4:22 build/C/man4/sd.4:29 build/C/man3/setlogmask.3:28 build/C/man4/sk98lin.4:30 build/C/man4/st.4:28 build/C/man3/stdarg.3:46 build/C/man2/syslog.2:37 build/C/man3/syslog.3:39 build/C/man7/uri.7:51 build/C/man4/wavelan.4:18
  70 #, no-wrap
  71 msgid "SYNOPSIS"
  72 msgstr ""
  73
  74 #. type: Plain text
  75 #: build/C/man4/cciss.4:16
  76 #, no-wrap
  77 msgid "modprobe cciss [ cciss_allow_hpsa=1 ]\n"
  78 msgstr ""
  79
  80 #. type: SH
  81 #: build/C/man4/cciss.4:17 build/C/man4/console.4:15 build/C/man4/console_codes.4:26 build/C/man4/console_ioctl.4:43 build/C/man5/core.5:28 build/C/man4/cpuid.4:29 build/C/man4/dsp56k.4:46 build/C/man4/fd.4:132 build/C/man7/fifo.7:16 build/C/man4/full.4:39 build/C/man3/gnu_get_libc_version.3:36 build/C/man4/hd.4:32 build/C/man4/hpsa.4:17 build/C/man4/initrd.4:71 build/C/man4/lp.4:43 build/C/man3/makedev.3:39 build/C/man4/mem.4:29 build/C/man3/mkfifo.3:62 build/C/man2/mknod.2:46 build/C/man4/mouse.4:33 build/C/man4/msr.4:29 build/C/man4/null.4:29 build/C/man7/pipe.7:28 build/C/man4/ram.4:29 build/C/man4/random.4:26 build/C/man4/sd.4:71 build/C/man3/setlogmask.3:34 build/C/man4/sk98lin.4:62 build/C/man4/st.4:37 build/C/man3/stdarg.3:56 build/C/man2/syslog.2:48 build/C/man3/syslog.3:59 build/C/man4/ttyS.4:29 build/C/man7/uri.7:71 build/C/man4/vcs.4:32 build/C/man4/wavelan.4:20
  82 #, no-wrap
  83 msgid "DESCRIPTION"
  84 msgstr ""
  85
  86 #. type: Plain text
  87 #: build/C/man4/cciss.4:20
  88 msgid "B<cciss> is a block driver for older HP Smart Array RAID controllers."
  89 msgstr ""
  90
  91 #. type: SS
  92 #: build/C/man4/cciss.4:20 build/C/man4/hpsa.4:20 build/C/man4/initrd.4:180
  93 #, no-wrap
  94 msgid "Options"
  95 msgstr ""
  96
  97 #. type: Plain text
  98 #: build/C/man4/cciss.4:29
  99 msgid ""
 100 "I<cciss_allow_hpsa=1>: This option prevents the B<cciss> driver from "
 101 "attempting to drive any controllers that the B<hpsa>(4)  driver is capable "
 102 "of controlling, which is to say, the B<cciss> driver is restricted by this "
 103 "option to the following controllers:"
 104 msgstr ""
 105
 106 #. type: Plain text
 107 #: build/C/man4/cciss.4:48
 108 #, no-wrap
 109 msgid ""
 110 "    Smart Array 5300\n"
 111 "    Smart Array 5i\n"
 112 "    Smart Array 532\n"
 113 "    Smart Array 5312\n"
 114 "    Smart Array 641\n"
 115 "    Smart Array 642\n"
 116 "    Smart Array 6400\n"
 117 "    Smart Array 6400 EM\n"
 118 "    Smart Array 6i\n"
 119 "    Smart Array P600\n"
 120 "    Smart Array P400i\n"
 121 "    Smart Array E200i\n"
 122 "    Smart Array E200\n"
 123 "    Smart Array E200i\n"
 124 "    Smart Array E200i\n"
 125 "    Smart Array E200i\n"
 126 "    Smart Array E500\n"
 127 msgstr ""
 128
 129 #. type: SS
 130 #: build/C/man4/cciss.4:49 build/C/man4/hpsa.4:39
 131 #, no-wrap
 132 msgid "Supported hardware"
 133 msgstr ""
 134
 135 #. type: Plain text
 136 #: build/C/man4/cciss.4:53
 137 msgid "The B<cciss> driver supports the following Smart Array boards:"
 138 msgstr ""
 139
 140 #. type: Plain text
 141 #: build/C/man4/cciss.4:79
 142 #, no-wrap
 143 msgid ""
 144 "    Smart Array 5300\n"
 145 "    Smart Array 5i\n"
 146 "    Smart Array 532\n"
 147 "    Smart Array 5312\n"
 148 "    Smart Array 641\n"
 149 "    Smart Array 642\n"
 150 "    Smart Array 6400\n"
 151 "    Smart Array 6400 U320 Expansion Module\n"
 152 "    Smart Array 6i\n"
 153 "    Smart Array P600\n"
 154 "    Smart Array P800\n"
 155 "    Smart Array E400\n"
 156 "    Smart Array P400i\n"
 157 "    Smart Array E200\n"
 158 "    Smart Array E200i\n"
 159 "    Smart Array E500\n"
 160 "    Smart Array P700m\n"
 161 "    Smart Array P212\n"
 162 "    Smart Array P410\n"
 163 "    Smart Array P410i\n"
 164 "    Smart Array P411\n"
 165 "    Smart Array P812\n"
 166 "    Smart Array P712m\n"
 167 "    Smart Array P711m\n"
 168 msgstr ""
 169
 170 #. type: SS
 171 #: build/C/man4/cciss.4:80 build/C/man4/hpsa.4:55
 172 #, no-wrap
 173 msgid "Configuration details"
 174 msgstr ""
 175
 176 #. type: Plain text
 177 #: build/C/man4/cciss.4:89 build/C/man4/hpsa.4:63
 178 msgid ""
 179 "To configure HP Smart Array controllers, use the HP Array Configuration "
 180 "Utility (either B<hpacuxe>(8)  or B<hpacucli>(8))  or the Offline ROM-based "
 181 "Configuration Utility (ORCA)  run from the Smart Array's option ROM at boot "
 182 "time."
 183 msgstr ""
 184
 185 #. type: SH
 186 #: build/C/man4/cciss.4:89 build/C/man4/console.4:91 build/C/man4/dsp56k.4:110 build/C/man4/fd.4:195 build/C/man4/full.4:59 build/C/man4/hd.4:103 build/C/man4/hpsa.4:63 build/C/man4/initrd.4:418 build/C/man4/lp.4:126 build/C/man4/mem.4:88 build/C/man4/mouse.4:180 build/C/man4/null.4:57 build/C/man4/ram.4:41 build/C/man4/random.4:301 build/C/man4/sd.4:131 build/C/man4/sk98lin.4:574 build/C/man4/st.4:879 build/C/man4/ttyS.4:46 build/C/man4/vcs.4:93
 187 #, no-wrap
 188 msgid "FILES"
 189 msgstr ""
 190
 191 #. type: SS
 192 #: build/C/man4/cciss.4:90 build/C/man4/hpsa.4:64
 193 #, no-wrap
 194 msgid "Device nodes"
 195 msgstr ""
 196
 197 #. type: Plain text
 198 #: build/C/man4/cciss.4:92
 199 msgid "The device naming scheme is as follows:"
 200 msgstr ""
 201
 202 #. type: Plain text
 203 #: build/C/man4/cciss.4:95
 204 #, no-wrap
 205 msgid "Major numbers:\n"
 206 msgstr ""
 207
 208 #. type: Plain text
 209 #: build/C/man4/cciss.4:104
 210 #, no-wrap
 211 msgid ""
 212 "    104     cciss0\n"
 213 "    105     cciss1\n"
 214 "    106     cciss2\n"
 215 "    105     cciss3\n"
 216 "    108     cciss4\n"
 217 "    109     cciss5\n"
 218 "    110     cciss6\n"
 219 "    111     cciss7\n"
 220 msgstr ""
 221
 222 #. type: Plain text
 223 #: build/C/man4/cciss.4:106
 224 #, no-wrap
 225 msgid "Minor numbers:\n"
 226 msgstr ""
 227
 228 #. type: Plain text
 229 #: build/C/man4/cciss.4:113
 230 #, no-wrap
 231 msgid ""
 232 "    b7 b6 b5 b4 b3 b2 b1 b0\n"
 233 "    |----+----| |----+----|\n"
 234 "         |           |\n"
 235 "         |           +-------- Partition ID (0=wholedev, 1-15 partition)\n"
 236 "         |\n"
 237 "         +-------------------- Logical Volume number\n"
 238 msgstr ""
 239
 240 #. type: Plain text
 241 #: build/C/man4/cciss.4:115
 242 #, no-wrap
 243 msgid "The device naming scheme is:\n"
 244 msgstr ""
 245
 246 #. type: Plain text
 247 #: build/C/man4/cciss.4:120
 248 #, no-wrap
 249 msgid ""
 250 "    /dev/cciss/c0d0         Controller 0, disk 0, whole device\n"
 251 "    /dev/cciss/c0d0p1       Controller 0, disk 0, partition 1\n"
 252 "    /dev/cciss/c0d0p2       Controller 0, disk 0, partition 2\n"
 253 "    /dev/cciss/c0d0p3       Controller 0, disk 0, partition 3\n"
 254 msgstr ""
 255
 256 #. type: Plain text
 257 #: build/C/man4/cciss.4:125
 258 #, no-wrap
 259 msgid ""
 260 "    /dev/cciss/c1d1         Controller 1, disk 1, whole device\n"
 261 "    /dev/cciss/c1d1p1       Controller 1, disk 1, partition 1\n"
 262 "    /dev/cciss/c1d1p2       Controller 1, disk 1, partition 2\n"
 263 "    /dev/cciss/c1d1p3       Controller 1, disk 1, partition 3\n"
 264 msgstr ""
 265
 266 #. type: SS
 267 #: build/C/man4/cciss.4:126
 268 #, no-wrap
 269 msgid "Files in /proc"
 270 msgstr ""
 271
 272 #. type: Plain text
 273 #: build/C/man4/cciss.4:132
 274 msgid ""
 275 "The files I</proc/driver/cciss/cciss[0-9]+> contain information about the "
 276 "configuration of each controller.  For example:"
 277 msgstr ""
 278
 279 #. type: Plain text
 280 #: build/C/man4/cciss.4:152
 281 #, no-wrap
 282 msgid ""
 283 "    $ B<cd /proc/driver/cciss>\n"
 284 "    $ B<ls -l>\n"
 285 "    total 0\n"
 286 "    -rw-r--r-- 1 root root 0 2010-09-10 10:38 cciss0\n"
 287 "    -rw-r--r-- 1 root root 0 2010-09-10 10:38 cciss1\n"
 288 "    -rw-r--r-- 1 root root 0 2010-09-10 10:38 cciss2\n"
 289 "    $ B<cat cciss2>\n"
 290 "    cciss2: HP Smart Array P800 Controller\n"
 291 "    Board ID: 0x3223103c\n"
 292 "    Firmware Version: 7.14\n"
 293 "    IRQ: 16\n"
 294 "    Logical drives: 1\n"
 295 "    Current Q depth: 0\n"
 296 "    Current # commands on controller: 0\n"
 297 "    Max Q depth since init: 1\n"
 298 "    Max # commands on controller since init: 2\n"
 299 "    Max SG entries since init: 32\n"
 300 "    Sequential access devices: 0\n"
 301 msgstr ""
 302
 303 #. type: Plain text
 304 #: build/C/man4/cciss.4:154
 305 #, no-wrap
 306 msgid "    cciss/c2d0:   36.38GB       RAID 0\n"
 307 msgstr ""
 308
 309 #. type: SS
 310 #: build/C/man4/cciss.4:155
 311 #, no-wrap
 312 msgid "Files in /sys"
 313 msgstr ""
 314
 315 #. type: TP
 316 #: build/C/man4/cciss.4:156
 317 #, no-wrap
 318 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/model>"
 319 msgstr ""
 320
 321 #. type: Plain text
 322 #: build/C/man4/cciss.4:162
 323 msgid ""
 324 "Displays the SCSI INQUIRY page 0 model for logical drive I<Y> of controller "
 325 "I<X>."
 326 msgstr ""
 327
 328 #. type: TP
 329 #: build/C/man4/cciss.4:162
 330 #, no-wrap
 331 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/rev>"
 332 msgstr ""
 333
 334 #. type: Plain text
 335 #: build/C/man4/cciss.4:168
 336 msgid ""
 337 "Displays the SCSI INQUIRY page 0 revision for logical drive I<Y> of "
 338 "controller I<X>."
 339 msgstr ""
 340
 341 #. type: TP
 342 #: build/C/man4/cciss.4:168
 343 #, no-wrap
 344 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/unique_id>"
 345 msgstr ""
 346
 347 #. type: Plain text
 348 #: build/C/man4/cciss.4:174
 349 msgid ""
 350 "Displays the SCSI INQUIRY page 83 serial number for logical drive I<Y> of "
 351 "controller I<X>."
 352 msgstr ""
 353
 354 #. type: TP
 355 #: build/C/man4/cciss.4:174
 356 #, no-wrap
 357 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/vendor>"
 358 msgstr ""
 359
 360 #. type: Plain text
 361 #: build/C/man4/cciss.4:180
 362 msgid ""
 363 "Displays the SCSI INQUIRY page 0 vendor for logical drive I<Y> of controller "
 364 "I<X>."
 365 msgstr ""
 366
 367 #. type: TP
 368 #: build/C/man4/cciss.4:180
 369 #, no-wrap
 370 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/block:cciss!cXdY>"
 371 msgstr ""
 372
 373 #. type: Plain text
 374 #: build/C/man4/cciss.4:184
 375 msgid "A symbolic link to I</sys/block/cciss!cXdY>."
 376 msgstr ""
 377
 378 #. type: TP
 379 #: build/C/man4/cciss.4:184
 380 #, no-wrap
 381 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/rescan>"
 382 msgstr ""
 383
 384 #. type: Plain text
 385 #: build/C/man4/cciss.4:188
 386 msgid ""
 387 "When this file is written to, the driver rescans the controller to discover "
 388 "any new, removed, or modified logical drives."
 389 msgstr ""
 390
 391 #. type: TP
 392 #: build/C/man4/cciss.4:188
 393 #, no-wrap
 394 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/resettable>"
 395 msgstr ""
 396
 397 #. type: Plain text
 398 #: build/C/man4/cciss.4:197
 399 msgid ""
 400 "A value of 1 displayed in this file indicates that the \"reset_devices=1\" "
 401 "kernel parameter (used by B<kdump>)  is honored by this controller.  A value "
 402 "of 0 indicates that the \"reset_devices=1\" kernel parameter will not be "
 403 "honored.  Some models of Smart Array are not able to honor this parameter."
 404 msgstr ""
 405
 406 #. type: TP
 407 #: build/C/man4/cciss.4:197
 408 #, no-wrap
 409 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/lunid>"
 410 msgstr ""
 411
 412 #. type: Plain text
 413 #: build/C/man4/cciss.4:203
 414 msgid ""
 415 "Displays the 8-byte LUN ID used to address logical drive I<Y> of controller "
 416 "I<X>."
 417 msgstr ""
 418
 419 #. type: TP
 420 #: build/C/man4/cciss.4:203
 421 #, no-wrap
 422 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/raid_level>"
 423 msgstr ""
 424
 425 #. type: Plain text
 426 #: build/C/man4/cciss.4:209
 427 msgid "Displays the RAID level of logical drive I<Y> of controller I<X>."
 428 msgstr ""
 429
 430 #. type: TP
 431 #: build/C/man4/cciss.4:209
 432 #, no-wrap
 433 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/usage_count>"
 434 msgstr ""
 435
 436 #. type: Plain text
 437 #: build/C/man4/cciss.4:215
 438 msgid ""
 439 "Displays the usage count (number of opens) of logical drive I<Y> of "
 440 "controller I<X>."
 441 msgstr ""
 442
 443 #. type: SS
 444 #: build/C/man4/cciss.4:215
 445 #, no-wrap
 446 msgid "SCSI tape drive and medium changer support"
 447 msgstr ""
 448
 449 #. type: Plain text
 450 #: build/C/man4/cciss.4:226
 451 msgid ""
 452 "SCSI sequential access devices and medium changer devices are supported and "
 453 "appropriate device nodes are automatically created (e.g., I</dev/st0>, "
 454 "I</dev/st1>, etc.; see B<st>(4)  for more details.)  You must enable \"SCSI "
 455 "tape drive support for Smart Array 5xxx\" and \"SCSI support\" in your "
 456 "kernel configuration to be able to use SCSI tape drives with your Smart "
 457 "Array 5xxx controller."
 458 msgstr ""
 459
 460 #. type: Plain text
 461 #: build/C/man4/cciss.4:244
 462 msgid ""
 463 "Additionally, note that the driver will not engage the SCSI core at init "
 464 "time.  The driver must be directed to dynamically engage the SCSI core via "
 465 "the I</proc> filesystem entry, which the \"block\" side of the driver "
 466 "creates as I</proc/driver/cciss/cciss*> at run time.  This is because at "
 467 "driver init time, the SCSI core may not yet be initialized (because the "
 468 "driver is a block driver) and attempting to register it with the SCSI core "
 469 "in such a case would cause a hang.  This is best done via an initialization "
 470 "script (typically in I</etc/init.d>, but could vary depending on "
 471 "distribution).  For example:"
 472 msgstr ""
 473
 474 #. type: Plain text
 475 #: build/C/man4/cciss.4:250
 476 #, no-wrap
 477 msgid ""
 478 "    for x in /proc/driver/cciss/cciss[0-9]*\n"
 479 "    do\n"
 480 "        echo \"engage scsi\" E<gt> $x\n"
 481 "    done\n"
 482 msgstr ""
 483
 484 #. type: Plain text
 485 #: build/C/man4/cciss.4:254
 486 msgid ""
 487 "Once the SCSI core is engaged by the driver, it cannot be disengaged (except "
 488 "by unloading the driver, if it happens to be linked as a module.)"
 489 msgstr ""
 490
 491 #. type: Plain text
 492 #: build/C/man4/cciss.4:258
 493 msgid ""
 494 "Note also that if no sequential access devices or medium changers are "
 495 "detected, the SCSI core will not be engaged by the action of the above "
 496 "script."
 497 msgstr ""
 498
 499 #. type: SS
 500 #: build/C/man4/cciss.4:258
 501 #, no-wrap
 502 msgid "Hot plug support for SCSI tape drives"
 503 msgstr ""
 504
 505 #. type: Plain text
 506 #: build/C/man4/cciss.4:268
 507 msgid ""
 508 "Hot plugging of SCSI tape drives is supported, with some caveats.  The "
 509 "B<cciss> driver must be informed that changes to the SCSI bus have been "
 510 "made.  This may be done via the I</proc> filesystem.  For example:"
 511 msgstr ""
 512
 513 #. type: Plain text
 514 #: build/C/man4/cciss.4:270
 515 #, no-wrap
 516 msgid "    echo \"rescan\" E<gt> /proc/scsi/cciss0/1\n"
 517 msgstr ""
 518
 519 #. type: Plain text
 520 #: build/C/man4/cciss.4:272
 521 msgid "This causes the driver to:"
 522 msgstr ""
 523
 524 #. type: IP
 525 #: build/C/man4/cciss.4:273 build/C/man4/initrd.4:97 build/C/man4/initrd.4:323 build/C/man4/initrd.4:430 build/C/man4/st.4:892 build/C/man7/uri.7:532
 526 #, no-wrap
 527 msgid "1."
 528 msgstr ""
 529
 530 #. type: Plain text
 531 #: build/C/man4/cciss.4:276
 532 msgid ""
 533 "query the adapter about changes to the physical SCSI buses and/or fibre "
 534 "channel arbitrated loop, and"
 535 msgstr ""
 536
 537 #. type: IP
 538 #: build/C/man4/cciss.4:276 build/C/man4/initrd.4:101 build/C/man4/initrd.4:331 build/C/man4/initrd.4:441 build/C/man4/st.4:912 build/C/man7/uri.7:536
 539 #, no-wrap
 540 msgid "2."
 541 msgstr ""
 542
 543 #. type: Plain text
 544 #: build/C/man4/cciss.4:279
 545 msgid ""
 546 "make note of any new or removed sequential access devices or medium "
 547 "changers."
 548 msgstr ""
 549
 550 #. type: Plain text
 551 #: build/C/man4/cciss.4:286
 552 msgid ""
 553 "The driver will output messages indicating which devices have been added or "
 554 "removed and the controller, bus, target, and lun used to address each "
 555 "device.  The driver then notifies the SCSI midlayer of these changes."
 556 msgstr ""
 557
 558 #. type: Plain text
 559 #: build/C/man4/cciss.4:293
 560 msgid ""
 561 "Note that the naming convention of the I</proc> filesystem entries contains "
 562 "a number in addition to the driver name (e.g., \"cciss0\" instead of just "
 563 "\"cciss\", which you might expect)."
 564 msgstr ""
 565
 566 #. type: Plain text
 567 #: build/C/man4/cciss.4:311
 568 msgid ""
 569 "Note: I<Only> sequential access devices and medium changers are presented as "
 570 "SCSI devices to the SCSI midlayer by the B<cciss> driver.  Specifically, "
 571 "physical SCSI disk drives are I<not> presented to the SCSI midlayer.  The "
 572 "only disk devices that are presented to the kernel are logical drives that "
 573 "the array controller constructs from regions on the physical drives.  The "
 574 "logical drives are presented to the block layer (not to the SCSI midlayer).  "
 575 "It is important for the driver to prevent the kernel from accessing the "
 576 "physical drives directly, since these drives are used by the array "
 577 "controller to construct the logical drives."
 578 msgstr ""
 579
 580 #. type: SS
 581 #: build/C/man4/cciss.4:311
 582 #, no-wrap
 583 msgid "SCSI error handling for tape drives and medium changers"
 584 msgstr ""
 585
 586 #. type: Plain text
 587 #: build/C/man4/cciss.4:319
 588 msgid ""
 589 "The Linux SCSI midlayer provides an error-handling protocol that is "
 590 "initiated whenever a SCSI command fails to complete within a certain amount "
 591 "of time (which can vary depending on the command).  The B<cciss> driver "
 592 "participates in this protocol to some extent.  The normal protocol is a "
 593 "four-step process:"
 594 msgstr ""
 595
 596 #. type: IP
 597 #: build/C/man4/cciss.4:319 build/C/man4/cciss.4:321 build/C/man4/cciss.4:323 build/C/man4/cciss.4:325 build/C/man5/core.5:49 build/C/man5/core.5:66 build/C/man5/core.5:70 build/C/man5/core.5:74 build/C/man5/core.5:77 build/C/man5/core.5:90 build/C/man5/core.5:93 build/C/man5/core.5:106 build/C/man5/core.5:223 build/C/man5/core.5:227 build/C/man5/core.5:230 build/C/man5/core.5:234
 598 #, no-wrap
 599 msgid "*"
 600 msgstr ""
 601
 602 #. type: Plain text
 603 #: build/C/man4/cciss.4:321
 604 msgid "First, the device is told to abort the command."
 605 msgstr ""
 606
 607 #. type: Plain text
 608 #: build/C/man4/cciss.4:323
 609 msgid "If that doesn't work, the device is reset."
 610 msgstr ""
 611
 612 #. type: Plain text
 613 #: build/C/man4/cciss.4:325
 614 msgid "If that doesn't work, the SCSI bus is reset."
 615 msgstr ""
 616
 617 #. type: Plain text
 618 #: build/C/man4/cciss.4:327
 619 msgid "If that doesn't work, the host bus adapter is reset."
 620 msgstr ""
 621
 622 #. type: Plain text
 623 #: build/C/man4/cciss.4:345
 624 msgid ""
 625 "The B<cciss> driver is a block driver as well as a SCSI driver and only the "
 626 "tape drives and medium changers are presented to the SCSI midlayer.  "
 627 "Furthermore, unlike more straightforward SCSI drivers, disk I/O continues "
 628 "through the block side during the SCSI error-recovery process.  Therefore, "
 629 "the B<cciss> driver implements only the first two of these actions, aborting "
 630 "the command, and resetting the device.  Note also that most tape drives will "
 631 "not oblige in aborting commands, and sometimes it appears they will not even "
 632 "obey a reset command, though in most circumstances they will.  If the "
 633 "command cannot be aborted and the device cannot be reset, the device will be "
 634 "set offline."
 635 msgstr ""
 636
 637 #. type: Plain text
 638 #: build/C/man4/cciss.4:353
 639 msgid ""
 640 "In the event that the error-handling code is triggered and a tape drive is "
 641 "successfully reset or the tardy command is successfully aborted, the tape "
 642 "drive may still not allow I/O to continue until some command is issued that "
 643 "positions the tape to a known position.  Typically you must rewind the tape "
 644 "(by issuing I<mt -f /dev/st0 rewind> for example) before I/O can proceed "
 645 "again to a tape drive that was reset."
 646 msgstr ""
 647
 648 #. type: SH
 649 #: build/C/man4/cciss.4:353 build/C/man4/console.4:95 build/C/man4/console_codes.4:642 build/C/man4/console_ioctl.4:846 build/C/man5/core.5:429 build/C/man4/cpuid.4:89 build/C/man4/dsp56k.4:115 build/C/man4/fd.4:214 build/C/man7/fifo.7:65 build/C/man4/full.4:61 build/C/man3/gnu_get_libc_version.3:76 build/C/man4/hd.4:105 build/C/man4/hpsa.4:179 build/C/man4/initrd.4:474 build/C/man4/lp.4:135 build/C/man3/makedev.3:80 build/C/man4/mem.4:94 build/C/man3/mkfifo.3:197 build/C/man2/mknod.2:284 build/C/man4/mouse.4:184 build/C/man4/msr.4:55 build/C/man4/null.4:64 build/C/man7/pipe.7:243 build/C/man4/ram.4:43 build/C/man4/random.4:308 build/C/man3/setlogmask.3:78 build/C/man4/sk98lin.4:598 build/C/man4/st.4:954 build/C/man2/syslog.2:388 build/C/man3/syslog.3:315 build/C/man4/ttyS.4:48 build/C/man7/uri.7:706 build/C/man4/vcs.4:173 build/C/man4/wavelan.4:138
 650 #, no-wrap
 651 msgid "SEE ALSO"
 652 msgstr ""
 653
 654 #. type: Plain text
 655 #: build/C/man4/cciss.4:358
 656 msgid "B<cciss_vol_status>(8), B<hpsa>(4), B<hpacucli>(8), B<hpacuxe>(8),"
 657 msgstr ""
 658
 659 #. type: Plain text
 660 #: build/C/man4/cciss.4:365
 661 msgid ""
 662 "E<.UR http://cciss.sf.net> E<.UE ,> and I<Documentation/blockdev/cciss.txt> "
 663 "and I<Documentation/ABI/testing/sysfs-bus-pci-devices-cciss> in the Linux "
 664 "kernel source tree"
 665 msgstr ""
 666
 667 #. type: TH
 668 #: build/C/man4/console.4:12
 669 #, no-wrap
 670 msgid "CONSOLE"
 671 msgstr ""
 672
 673 #. type: TH
 674 #: build/C/man4/console.4:12
 675 #, no-wrap
 676 msgid "1994-10-31"
 677 msgstr ""
 678
 679 #. type: Plain text
 680 #: build/C/man4/console.4:15
 681 msgid "console - console terminal and virtual consoles"
 682 msgstr ""
 683
 684 #. type: Plain text
 685 #: build/C/man4/console.4:37
 686 msgid ""
 687 "A Linux system has up to 63 I<virtual consoles> (character devices with "
 688 "major number 4 and minor number 1 to 63), usually called I</dev/ttyn> with 1 "
 689 "\\(E<lt>= I<n> \\(E<lt>= 63.  The current console is also addressed by "
 690 "I</dev/console> or I</dev/tty0>, the character device with major number 4 "
 691 "and minor number 0.  The device files I</dev/*> are usually created using "
 692 "the script MAKEDEV, or using B<mknod>(1), usually with mode 0622 and owner "
 693 "I<root.tty>."
 694 msgstr ""
 695
 696 #. type: Plain text
 697 #: build/C/man4/console.4:45
 698 msgid ""
 699 "Before kernel version 1.1.54 the number of virtual consoles was compiled "
 700 "into the kernel (in I<tty.h>: #define NR_CONSOLES 8)  and could be changed "
 701 "by editing and recompiling.  Since version 1.1.54 virtual consoles are "
 702 "created on the fly, as soon as they are needed."
 703 msgstr ""
 704
 705 #. type: Plain text
 706 #: build/C/man4/console.4:63
 707 msgid ""
 708 "Common ways to start a process on a console are: (a) tell B<init>(1)  (in "
 709 "B<inittab>(5))  to start a B<mingetty>(8)  (or B<agetty>(8))  on the "
 710 "console; (b) ask B<openvt>(1)  to start a process on the console; (c) start "
 711 "X\\(emit will find the first unused console, and display its output there.  "
 712 "(There is also the ancient B<doshell>(8).)"
 713 msgstr ""
 714
 715 #. type: Plain text
 716 #: build/C/man4/console.4:76
 717 msgid ""
 718 "Common ways to switch consoles are: (a) use Alt+FI<n> or Ctrl+Alt+FI<n> to "
 719 "switch to console I<n>; AltGr+FI<n> might bring you to console I<n>+12 [here "
 720 "Alt and AltGr refer to the left and right Alt keys, respectively]; (b) use "
 721 "Alt+RightArrow or Alt+LeftArrow to cycle through the presently allocated "
 722 "consoles; (c) use the program B<chvt>(1).  (The key mapping is user "
 723 "settable, see B<loadkeys>(1); the above mentioned key combinations are "
 724 "according to the default settings.)"
 725 msgstr ""
 726
 727 #. type: Plain text
 728 #: build/C/man4/console.4:83
 729 msgid ""
 730 "The command B<deallocvt>(1)  (formerly B<disalloc>)  will free the memory "
 731 "taken by the screen buffers for consoles that no longer have any associated "
 732 "process."
 733 msgstr ""
 734
 735 #. type: SS
 736 #: build/C/man4/console.4:83
 737 #, no-wrap
 738 msgid "Properties"
 739 msgstr ""
 740
 741 #. type: Plain text
 742 #: build/C/man4/console.4:91
 743 msgid ""
 744 "Consoles carry a lot of state.  I hope to document that some other time.  "
 745 "The most important fact is that the consoles simulate vt100 terminals.  In "
 746 "particular, a console is reset to the initial state by printing the two "
 747 "characters ESC c.  All escape sequences can be found in B<console_codes>(4)."
 748 msgstr ""
 749
 750 #. type: Plain text
 751 #: build/C/man4/console.4:93
 752 msgid "I</dev/console>"
 753 msgstr ""
 754
 755 #. type: Plain text
 756 #: build/C/man4/console.4:95
 757 msgid "I</dev/tty*>"
 758 msgstr ""
 759
 760 #. type: Plain text
 761 #: build/C/man4/console.4:111
 762 msgid ""
 763 "B<chvt>(1), B<deallocvt>(1), B<init>(1), B<loadkeys>(1), B<mknod>(1), "
 764 "B<openvt>(1), B<console_codes>(4), B<console_ioctl>(4), B<tty>(4), "
 765 "B<ttyS>(4), B<charsets>(7), B<agetty>(8), B<mapscrn>(8), B<mingetty>(8), "
 766 "B<resizecons>(8), B<setfont>(8)"
 767 msgstr ""
 768
 769 #. type: TH
 770 #: build/C/man4/console_codes.4:23
 771 #, no-wrap
 772 msgid "CONSOLE_CODES"
 773 msgstr ""
 774
 775 #. type: Plain text
 776 #: build/C/man4/console_codes.4:26
 777 msgid "console_codes - Linux console escape and control sequences"
 778 msgstr ""
 779
 780 #. type: Plain text
 781 #: build/C/man4/console_codes.4:33
 782 msgid ""
 783 "The Linux console implements a large subset of the VT102 and ECMA-48/ISO "
 784 "6429/ANSI X3.64 terminal controls, plus certain private-mode sequences for "
 785 "changing the color palette, character-set mapping, and so on.  In the "
 786 "tabular descriptions below, the second column gives ECMA-48 or DEC mnemonics "
 787 "(the latter if prefixed with DEC) for the given function.  Sequences without "
 788 "a mnemonic are neither ECMA-48 nor VT102."
 789 msgstr ""
 790
 791 #. type: Plain text
 792 #: build/C/man4/console_codes.4:38
 793 msgid ""
 794 "After all the normal output processing has been done, and a stream of "
 795 "characters arrives at the console driver for actual printing, the first "
 796 "thing that happens is a translation from the code used for processing to the "
 797 "code used for printing."
 798 msgstr ""
 799
 800 #. type: Plain text
 801 #: build/C/man4/console_codes.4:44
 802 msgid ""
 803 "If the console is in UTF-8 mode, then the incoming bytes are first assembled "
 804 "into 16-bit Unicode codes.  Otherwise, each byte is transformed according to "
 805 "the current mapping table (which translates it to a Unicode value).  See the "
 806 "B<Character Sets> section below for discussion."
 807 msgstr ""
 808
 809 #. type: Plain text
 810 #: build/C/man4/console_codes.4:50
 811 msgid ""
 812 "In the normal case, the Unicode value is converted to a font index, and this "
 813 "is stored in video memory, so that the corresponding glyph (as found in "
 814 "video ROM) appears on the screen.  Note that the use of Unicode (and the "
 815 "design of the PC hardware)  allows us to use 512 different glyphs "
 816 "simultaneously."
 817 msgstr ""
 818
 819 #. type: Plain text
 820 #: build/C/man4/console_codes.4:57
 821 msgid ""
 822 "If the current Unicode value is a control character, or we are currently "
 823 "processing an escape sequence, the value will treated specially.  Instead of "
 824 "being turned into a font index and rendered as a glyph, it may trigger "
 825 "cursor movement or other control functions.  See the B<Linux Console "
 826 "Controls> section below for discussion."
 827 msgstr ""
 828
 829 #. type: Plain text
 830 #: build/C/man4/console_codes.4:69
 831 msgid ""
 832 "It is generally not good practice to hard-wire terminal controls into "
 833 "programs.  Linux supports a B<terminfo>(5)  database of terminal "
 834 "capabilities.  Rather than emitting console escape sequences by hand, you "
 835 "will almost always want to use a terminfo-aware screen library or utility "
 836 "such as B<ncurses>(3), B<tput>(1), or B<reset>(1)."
 837 msgstr ""
 838
 839 #. type: SS
 840 #: build/C/man4/console_codes.4:69
 841 #, no-wrap
 842 msgid "Linux console controls"
 843 msgstr ""
 844
 845 #. type: Plain text
 846 #: build/C/man4/console_codes.4:73
 847 msgid ""
 848 "This section describes all the control characters and escape sequences that "
 849 "invoke special functions (i.e., anything other than writing a glyph at the "
 850 "current cursor location) on the Linux console."
 851 msgstr ""
 852
 853 #. type: Plain text
 854 #: build/C/man4/console_codes.4:75
 855 msgid "B<Control characters>"
 856 msgstr ""
 857
 858 #. type: Plain text
 859 #: build/C/man4/console_codes.4:86
 860 msgid ""
 861 "A character is a control character if (before transformation according to "
 862 "the mapping table) it has one of the 14 codes 00 (NUL), 07 (BEL), 08 (BS), "
 863 "09 (HT), 0a (LF), 0b (VT), 0c (FF), 0d (CR), 0e (SO), 0f (SI), 18 (CAN), 1a "
 864 "(SUB), 1b (ESC), 7f (DEL).  One can set a \"display control characters\" "
 865 "mode (see below), and allow 07, 09, 0b, 18, 1a, 7f to be displayed as "
 866 "glyphs.  On the other hand, in UTF-8 mode all codes 00-1f are regarded as "
 867 "control characters, regardless of any \"display control characters\" mode."
 868 msgstr ""
 869
 870 #. type: Plain text
 871 #: build/C/man4/console_codes.4:95
 872 msgid ""
 873 "If we have a control character, it is acted upon immediately and then "
 874 "discarded (even in the middle of an escape sequence)  and the escape "
 875 "sequence continues with the next character.  (However, ESC starts a new "
 876 "escape sequence, possibly aborting a previous unfinished one, and CAN and "
 877 "SUB abort any escape sequence.)  The recognized control characters are BEL, "
 878 "BS, HT, LF, VT, FF, CR, SO, SI, CAN, SUB, ESC, DEL, CSI.  They do what one "
 879 "would expect:"
 880 msgstr ""
 881
 882 #. type: Plain text
 883 #: build/C/man4/console_codes.4:97
 884 msgid "BEL (0x07, B<^G>) beeps;"
 885 msgstr ""
 886
 887 #. type: Plain text
 888 #: build/C/man4/console_codes.4:100
 889 msgid ""
 890 "BS (0x08, B<^H>) backspaces one column (but not past the beginning of the "
 891 "line);"
 892 msgstr ""
 893
 894 #. type: Plain text
 895 #: build/C/man4/console_codes.4:103
 896 msgid ""
 897 "HT (0x09, B<^I>) goes to the next tab stop or to the end of the line if "
 898 "there is no earlier tab stop;"
 899 msgstr ""
 900
 901 #. type: Plain text
 902 #: build/C/man4/console_codes.4:107
 903 msgid ""
 904 "LF (0x0A, B<^J>), VT (0x0B, B<^K>) and FF (0x0C, B<^L>) all give a linefeed, "
 905 "and if LF/NL (new-line mode) is set also a carriage return;"
 906 msgstr ""
 907
 908 #. type: Plain text
 909 #: build/C/man4/console_codes.4:109
 910 msgid "CR (0x0D, B<^M>) gives a carriage return;"
 911 msgstr ""
 912
 913 #. type: Plain text
 914 #: build/C/man4/console_codes.4:111
 915 msgid "SO (0x0E, B<^N>) activates the G1 character set;"
 916 msgstr ""
 917
 918 #. type: Plain text
 919 #: build/C/man4/console_codes.4:113
 920 msgid "SI (0x0F, B<^O>) activates the G0 character set;"
 921 msgstr ""
 922
 923 #. type: Plain text
 924 #: build/C/man4/console_codes.4:115
 925 msgid "CAN (0x18, B<^X>) and SUB (0x1A, B<^Z>) interrupt escape sequences;"
 926 msgstr ""
 927
 928 #. type: Plain text
 929 #: build/C/man4/console_codes.4:117
 930 msgid "ESC (0x1B, B<^[>) starts an escape sequence;"
 931 msgstr ""
 932
 933 #. type: Plain text
 934 #: build/C/man4/console_codes.4:119
 935 msgid "DEL (0x7F) is ignored;"
 936 msgstr ""
 937
 938 #. type: Plain text
 939 #: build/C/man4/console_codes.4:121
 940 msgid "CSI (0x9B) is equivalent to ESC [."
 941 msgstr ""
 942
 943 #. type: Plain text
 944 #: build/C/man4/console_codes.4:123
 945 msgid "B<ESC- but not CSI-sequences>"
 946 msgstr ""
 947
 948 #. type: tbl table
 949 #: build/C/man4/console_codes.4:125
 950 #, no-wrap
 951 msgid "ESC c\tRIS\tReset.\n"
 952 msgstr ""
 953
 954 #. type: tbl table
 955 #: build/C/man4/console_codes.4:126
 956 #, no-wrap
 957 msgid "ESC D\tIND\tLinefeed.\n"
 958 msgstr ""
 959
 960 #. type: tbl table
 961 #: build/C/man4/console_codes.4:127
 962 #, no-wrap
 963 msgid "ESC E\tNEL\tNewline.\n"
 964 msgstr ""
 965
 966 #. type: tbl table
 967 #: build/C/man4/console_codes.4:128
 968 #, no-wrap
 969 msgid "ESC H\tHTS\tSet tab stop at current column.\n"
 970 msgstr ""
 971
 972 #. type: tbl table
 973 #: build/C/man4/console_codes.4:129
 974 #, no-wrap
 975 msgid "ESC M\tRI\tReverse linefeed.\n"
 976 msgstr ""
 977
 978 #. type: tbl table
 979 #: build/C/man4/console_codes.4:130
 980 #, no-wrap
 981 msgid "ESC Z\tDECID\tT{\n"
 982 msgstr ""
 983
 984 #. type: tbl table
 985 #: build/C/man4/console_codes.4:131
 986 #, no-wrap
 987 msgid "DEC private identification. The kernel\n"
 988 msgstr ""
 989
 990 #. type: tbl table
 991 #: build/C/man4/console_codes.4:132
 992 #, no-wrap
 993 msgid "returns the string  ESC [ ? 6 c, claiming\n"
 994 msgstr ""
 995
 996 #. type: tbl table
 997 #: build/C/man4/console_codes.4:133
 998 #, no-wrap
 999 msgid "that it is a VT102.\n"
1000 msgstr ""
1001
1002 #. type: tbl table
1003 #: build/C/man4/console_codes.4:134 build/C/man4/console_codes.4:138 build/C/man4/console_codes.4:163 build/C/man4/console_codes.4:243 build/C/man4/console_codes.4:249 build/C/man4/console_codes.4:253 build/C/man4/console_codes.4:260
1004 #, no-wrap
1005 msgid "T}\n"
1006 msgstr ""
1007
1008 #. type: tbl table
1009 #: build/C/man4/console_codes.4:135
1010 #, no-wrap
1011 msgid "ESC 7\tDECSC\tT{\n"
1012 msgstr ""
1013
1014 #. type: tbl table
1015 #: build/C/man4/console_codes.4:136
1016 #, no-wrap
1017 msgid "Save current state (cursor coordinates,\n"
1018 msgstr ""
1019
1020 #. type: tbl table
1021 #: build/C/man4/console_codes.4:137
1022 #, no-wrap
1023 msgid "attributes, character sets pointed at by G0, G1).\n"
1024 msgstr ""
1025
1026 #. type: tbl table
1027 #: build/C/man4/console_codes.4:139
1028 #, no-wrap
1029 msgid "ESC 8\tDECRC\tRestore state most recently saved by ESC 7.\n"
1030 msgstr ""
1031
1032 #. type: tbl table
1033 #: build/C/man4/console_codes.4:140
1034 #, no-wrap
1035 msgid "ESC [\tCSI\tControl sequence introducer\n"
1036 msgstr ""
1037
1038 #. type: tbl table
1039 #: build/C/man4/console_codes.4:141
1040 #, no-wrap
1041 msgid "ESC %\t\tStart sequence selecting character set\n"
1042 msgstr ""
1043
1044 #. type: tbl table
1045 #: build/C/man4/console_codes.4:142
1046 #, no-wrap
1047 msgid "ESC % @\t\t\\0\\0\\0Select default (ISO 646 / ISO 8859-1)\n"
1048 msgstr ""
1049
1050 #. type: tbl table
1051 #: build/C/man4/console_codes.4:143
1052 #, no-wrap
1053 msgid "ESC % G\t\t\\0\\0\\0Select UTF-8\n"
1054 msgstr ""
1055
1056 #. type: tbl table
1057 #: build/C/man4/console_codes.4:144
1058 #, no-wrap
1059 msgid "ESC % 8\t\t\\0\\0\\0Select UTF-8 (obsolete)\n"
1060 msgstr ""
1061
1062 #. type: tbl table
1063 #: build/C/man4/console_codes.4:145
1064 #, no-wrap
1065 msgid "ESC # 8\tDECALN\tDEC screen alignment test - fill screen with E's.\n"
1066 msgstr ""
1067
1068 #. type: tbl table
1069 #: build/C/man4/console_codes.4:146
1070 #, no-wrap
1071 msgid "ESC (\t\tStart sequence defining G0 character set\n"
1072 msgstr ""
1073
1074 #. type: tbl table
1075 #: build/C/man4/console_codes.4:147
1076 #, no-wrap
1077 msgid "ESC ( B\t\t\\0\\0\\0Select default (ISO 8859-1 mapping)\n"
1078 msgstr ""
1079
1080 #. type: tbl table
1081 #: build/C/man4/console_codes.4:148
1082 #, no-wrap
1083 msgid "ESC ( 0\t\t\\0\\0\\0Select VT100 graphics mapping\n"
1084 msgstr ""
1085
1086 #. type: tbl table
1087 #: build/C/man4/console_codes.4:149
1088 #, no-wrap
1089 msgid "ESC ( U\t\t\\0\\0\\0Select null mapping - straight to character ROM\n"
1090 msgstr ""
1091
1092 #. type: tbl table
1093 #: build/C/man4/console_codes.4:150
1094 #, no-wrap
1095 msgid "ESC ( K\t\t\\0\\0\\0Select user mapping - the map that is loaded by\n"
1096 msgstr ""
1097
1098 #. type: tbl table
1099 #: build/C/man4/console_codes.4:151
1100 #, no-wrap
1101 msgid "\t\t\\0\\0\\0the utility B<mapscrn>(8).\n"
1102 msgstr ""
1103
1104 #. type: tbl table
1105 #: build/C/man4/console_codes.4:152
1106 #, no-wrap
1107 msgid "ESC )\t\tStart sequence defining G1\n"
1108 msgstr ""
1109
1110 #. type: tbl table
1111 #: build/C/man4/console_codes.4:153
1112 #, no-wrap
1113 msgid "\t\t(followed by one of B, 0, U, K, as above).\n"
1114 msgstr ""
1115
1116 #. type: tbl table
1117 #: build/C/man4/console_codes.4:154
1118 #, no-wrap
1119 msgid "ESC E<gt>\tDECPNM\tSet numeric keypad mode\n"
1120 msgstr ""
1121
1122 #. type: tbl table
1123 #: build/C/man4/console_codes.4:155
1124 #, no-wrap
1125 msgid "ESC =\tDECPAM\tSet application keypad mode\n"
1126 msgstr ""
1127
1128 #. type: tbl table
1129 #: build/C/man4/console_codes.4:156
1130 #, no-wrap
1131 msgid "ESC ]\tOSC\tT{\n"
1132 msgstr ""
1133
1134 #. type: tbl table
1135 #: build/C/man4/console_codes.4:157
1136 #, no-wrap
1137 msgid "(Should be: Operating system command)\n"
1138 msgstr ""
1139
1140 #. type: tbl table
1141 #: build/C/man4/console_codes.4:158
1142 #, no-wrap
1143 msgid "ESC ] P I<nrrggbb>: set palette, with parameter\n"
1144 msgstr ""
1145
1146 #. type: tbl table
1147 #: build/C/man4/console_codes.4:159
1148 #, no-wrap
1149 msgid "given in 7 hexadecimal digits after the final P :-(.\n"
1150 msgstr ""
1151
1152 #. type: tbl table
1153 #: build/C/man4/console_codes.4:160
1154 #, no-wrap
1155 msgid "Here I<n> is the color (0-15), and I<rrggbb> indicates\n"
1156 msgstr ""
1157
1158 #. type: tbl table
1159 #: build/C/man4/console_codes.4:161
1160 #, no-wrap
1161 msgid "the red/green/blue values (0-255).\n"
1162 msgstr ""
1163
1164 #. type: tbl table
1165 #: build/C/man4/console_codes.4:162
1166 #, no-wrap
1167 msgid "ESC ] R: reset palette\n"
1168 msgstr ""
1169
1170 #. type: Plain text
1171 #: build/C/man4/console_codes.4:167
1172 msgid "B<ECMA-48 CSI sequences>"
1173 msgstr ""
1174
1175 #. type: Plain text
1176 #: build/C/man4/console_codes.4:173
1177 msgid ""
1178 "CSI (or ESC [) is followed by a sequence of parameters, at most NPAR (16), "
1179 "that are decimal numbers separated by semicolons.  An empty or absent "
1180 "parameter is taken to be 0.  The sequence of parameters may be preceded by a "
1181 "single question mark."
1182 msgstr ""
1183
1184 #. type: Plain text
1185 #: build/C/man4/console_codes.4:177
1186 msgid ""
1187 "However, after CSI [ (or ESC [ [) a single character is read and this entire "
1188 "sequence is ignored.  (The idea is to ignore an echoed function key.)"
1189 msgstr ""
1190
1191 #. type: Plain text
1192 #: build/C/man4/console_codes.4:179
1193 msgid "The action of a CSI sequence is determined by its final character."
1194 msgstr ""
1195
1196 #. type: tbl table
1197 #: build/C/man4/console_codes.4:181
1198 #, no-wrap
1199 msgid "@\tICH\tInsert the indicated # of blank characters.\n"
1200 msgstr ""
1201
1202 #. type: tbl table
1203 #: build/C/man4/console_codes.4:182
1204 #, no-wrap
1205 msgid "A\tCUU\tMove cursor up the indicated # of rows.\n"
1206 msgstr ""
1207
1208 #. type: tbl table
1209 #: build/C/man4/console_codes.4:183
1210 #, no-wrap
1211 msgid "B\tCUD\tMove cursor down the indicated # of rows.\n"
1212 msgstr ""
1213
1214 #. type: tbl table
1215 #: build/C/man4/console_codes.4:184
1216 #, no-wrap
1217 msgid "C\tCUF\tMove cursor right the indicated # of columns.\n"
1218 msgstr ""
1219
1220 #. type: tbl table
1221 #: build/C/man4/console_codes.4:185
1222 #, no-wrap
1223 msgid "D\tCUB\tMove cursor left the indicated # of columns.\n"
1224 msgstr ""
1225
1226 #. type: tbl table
1227 #: build/C/man4/console_codes.4:186
1228 #, no-wrap
1229 msgid "E\tCNL\tMove cursor down the indicated # of rows, to column 1.\n"
1230 msgstr ""
1231
1232 #. type: tbl table
1233 #: build/C/man4/console_codes.4:187
1234 #, no-wrap
1235 msgid "F\tCPL\tMove cursor up the indicated # of rows, to column 1.\n"
1236 msgstr ""
1237
1238 #. type: tbl table
1239 #: build/C/man4/console_codes.4:188
1240 #, no-wrap
1241 msgid "G\tCHA\tMove cursor to indicated column in current row.\n"
1242 msgstr ""
1243
1244 #. type: tbl table
1245 #: build/C/man4/console_codes.4:189
1246 #, no-wrap
1247 msgid "H\tCUP\tMove cursor to the indicated row, column (origin at 1,1).\n"
1248 msgstr ""
1249
1250 #. type: tbl table
1251 #: build/C/man4/console_codes.4:190
1252 #, no-wrap
1253 msgid "J\tED\tErase display (default: from cursor to end of display).\n"
1254 msgstr ""
1255
1256 #. type: tbl table
1257 #: build/C/man4/console_codes.4:191
1258 #, no-wrap
1259 msgid "\t\tESC [ 1 J: erase from start to cursor.\n"
1260 msgstr ""
1261
1262 #. type: tbl table
1263 #: build/C/man4/console_codes.4:192
1264 #, no-wrap
1265 msgid "\t\tESC [ 2 J: erase whole display.\n"
1266 msgstr ""
1267
1268 #. type: tbl table
1269 #: build/C/man4/console_codes.4:193
1270 #, no-wrap
1271 msgid "\t\tESC [ 3 J: erase whole display including scroll-back\n"
1272 msgstr ""
1273
1274 #. type: tbl table
1275 #: build/C/man4/console_codes.4:194
1276 #, no-wrap
1277 msgid "\t\t           buffer (since Linux 3.0).\n"
1278 msgstr ""
1279
1280 #.  ESC [ 3 J: commit f8df13e0a901fe55631fed66562369b4dba40f8b
1281 #. type: tbl table
1282 #: build/C/man4/console_codes.4:196
1283 #, no-wrap
1284 msgid "K\tEL\tErase line (default: from cursor to end of line).\n"
1285 msgstr ""
1286
1287 #. type: tbl table
1288 #: build/C/man4/console_codes.4:197
1289 #, no-wrap
1290 msgid "\t\tESC [ 1 K: erase from start of line to cursor.\n"
1291 msgstr ""
1292
1293 #. type: tbl table
1294 #: build/C/man4/console_codes.4:198
1295 #, no-wrap
1296 msgid "\t\tESC [ 2 K: erase whole line.\n"
1297 msgstr ""
1298
1299 #. type: tbl table
1300 #: build/C/man4/console_codes.4:199
1301 #, no-wrap
1302 msgid "L\tIL\tInsert the indicated # of blank lines.\n"
1303 msgstr ""
1304
1305 #. type: tbl table
1306 #: build/C/man4/console_codes.4:200
1307 #, no-wrap
1308 msgid "M\tDL\tDelete the indicated # of lines.\n"
1309 msgstr ""
1310
1311 #. type: tbl table
1312 #: build/C/man4/console_codes.4:201
1313 #, no-wrap
1314 msgid "P\tDCH\tDelete the indicated # of characters on current line.\n"
1315 msgstr ""
1316
1317 #. type: tbl table
1318 #: build/C/man4/console_codes.4:202
1319 #, no-wrap
1320 msgid "X\tECH\tErase the indicated # of characters on current line.\n"
1321 msgstr ""
1322
1323 #. type: tbl table
1324 #: build/C/man4/console_codes.4:203
1325 #, no-wrap
1326 msgid "a\tHPR\tMove cursor right the indicated # of columns.\n"
1327 msgstr ""
1328
1329 #. type: tbl table
1330 #: build/C/man4/console_codes.4:204
1331 #, no-wrap
1332 msgid "c\tDA\tAnswer ESC [ ? 6 c: \"I am a VT102\".\n"
1333 msgstr ""
1334
1335 #. type: tbl table
1336 #: build/C/man4/console_codes.4:205
1337 #, no-wrap
1338 msgid "d\tVPA\tMove cursor to the indicated row, current column.\n"
1339 msgstr ""
1340
1341 #. type: tbl table
1342 #: build/C/man4/console_codes.4:206
1343 #, no-wrap
1344 msgid "e\tVPR\tMove cursor down the indicated # of rows.\n"
1345 msgstr ""
1346
1347 #. type: tbl table
1348 #: build/C/man4/console_codes.4:207
1349 #, no-wrap
1350 msgid "f\tHVP\tMove cursor to the indicated row, column.\n"
1351 msgstr ""
1352
1353 #. type: tbl table
1354 #: build/C/man4/console_codes.4:208
1355 #, no-wrap
1356 msgid "g\tTBC\tWithout parameter: clear tab stop at current position.\n"
1357 msgstr ""
1358
1359 #. type: tbl table
1360 #: build/C/man4/console_codes.4:209
1361 #, no-wrap
1362 msgid "\t\tESC [ 3 g: delete all tab stops.\n"
1363 msgstr ""
1364
1365 #. type: tbl table
1366 #: build/C/man4/console_codes.4:210
1367 #, no-wrap
1368 msgid "h\tSM\tSet Mode (see below).\n"
1369 msgstr ""
1370
1371 #. type: tbl table
1372 #: build/C/man4/console_codes.4:211
1373 #, no-wrap
1374 msgid "l\tRM\tReset Mode (see below).\n"
1375 msgstr ""
1376
1377 #. type: tbl table
1378 #: build/C/man4/console_codes.4:212
1379 #, no-wrap
1380 msgid "m\tSGR\tSet attributes (see below).\n"
1381 msgstr ""
1382
1383 #. type: tbl table
1384 #: build/C/man4/console_codes.4:213
1385 #, no-wrap
1386 msgid "n\tDSR\tStatus report (see below).\n"
1387 msgstr ""
1388
1389 #. type: tbl table
1390 #: build/C/man4/console_codes.4:214
1391 #, no-wrap
1392 msgid "q\tDECLL\tSet keyboard LEDs.\n"
1393 msgstr ""
1394
1395 #. type: tbl table
1396 #: build/C/man4/console_codes.4:215
1397 #, no-wrap
1398 msgid "\t\tESC [ 0 q: clear all LEDs\n"
1399 msgstr ""
1400
1401 #. type: tbl table
1402 #: build/C/man4/console_codes.4:216
1403 #, no-wrap
1404 msgid "\t\tESC [ 1 q: set Scroll Lock LED\n"
1405 msgstr ""
1406
1407 #. type: tbl table
1408 #: build/C/man4/console_codes.4:217
1409 #, no-wrap
1410 msgid "\t\tESC [ 2 q: set Num Lock LED\n"
1411 msgstr ""
1412
1413 #. type: tbl table
1414 #: build/C/man4/console_codes.4:218
1415 #, no-wrap
1416 msgid "\t\tESC [ 3 q: set Caps Lock LED\n"
1417 msgstr ""
1418
1419 #. type: tbl table
1420 #: build/C/man4/console_codes.4:219
1421 #, no-wrap
1422 msgid "r\tDECSTBM\tSet scrolling region; parameters are top and bottom row.\n"
1423 msgstr ""
1424
1425 #. type: tbl table
1426 #: build/C/man4/console_codes.4:220
1427 #, no-wrap
1428 msgid "s\t?\tSave cursor location.\n"
1429 msgstr ""
1430
1431 #. type: tbl table
1432 #: build/C/man4/console_codes.4:221
1433 #, no-wrap
1434 msgid "u\t?\tRestore cursor location.\n"
1435 msgstr ""
1436
1437 #. type: tbl table
1438 #: build/C/man4/console_codes.4:222
1439 #, no-wrap
1440 msgid "\\`\tHPA\tMove cursor to indicated column in current row.\n"
1441 msgstr ""
1442
1443 #. type: Plain text
1444 #: build/C/man4/console_codes.4:226
1445 msgid "B<ECMA-48 Set Graphics Rendition>"
1446 msgstr ""
1447
1448 #. type: Plain text
1449 #: build/C/man4/console_codes.4:233
1450 msgid ""
1451 "The ECMA-48 SGR sequence ESC [ I<parameters> m sets display attributes.  "
1452 "Several attributes can be set in the same sequence, separated by "
1453 "semicolons.  An empty parameter (between semicolons or string initiator or "
1454 "terminator) is interpreted as a zero."
1455 msgstr ""
1456
1457 #. type: tbl table
1458 #: build/C/man4/console_codes.4:235
1459 #, no-wrap
1460 msgid "param\tresult\n"
1461 msgstr ""
1462
1463 #. type: tbl table
1464 #: build/C/man4/console_codes.4:236
1465 #, no-wrap
1466 msgid "0\treset all attributes to their defaults\n"
1467 msgstr ""
1468
1469 #. type: tbl table
1470 #: build/C/man4/console_codes.4:237
1471 #, no-wrap
1472 msgid "1\tset bold\n"
1473 msgstr ""
1474
1475 #. type: tbl table
1476 #: build/C/man4/console_codes.4:238
1477 #, no-wrap
1478 msgid "2\tset half-bright (simulated with color on a color display)\n"
1479 msgstr ""
1480
1481 #. type: tbl table
1482 #: build/C/man4/console_codes.4:239
1483 #, no-wrap
1484 msgid "4\tT{\n"
1485 msgstr ""
1486
1487 #. type: tbl table
1488 #: build/C/man4/console_codes.4:240
1489 #, no-wrap
1490 msgid "set underscore (simulated with color on a color display)\n"
1491 msgstr ""
1492
1493 #. type: tbl table
1494 #: build/C/man4/console_codes.4:241
1495 #, no-wrap
1496 msgid "(the colors used to simulate dim or underline are set\n"
1497 msgstr ""
1498
1499 #. type: tbl table
1500 #: build/C/man4/console_codes.4:242
1501 #, no-wrap
1502 msgid "using ESC ] ...)\n"
1503 msgstr ""
1504
1505 #. type: tbl table
1506 #: build/C/man4/console_codes.4:244
1507 #, no-wrap
1508 msgid "5\tset blink\n"
1509 msgstr ""
1510
1511 #. type: tbl table
1512 #: build/C/man4/console_codes.4:245
1513 #, no-wrap
1514 msgid "7\tset reverse video\n"
1515 msgstr ""
1516
1517 #. type: tbl table
1518 #: build/C/man4/console_codes.4:246
1519 #, no-wrap
1520 msgid "10\tT{\n"
1521 msgstr ""
1522
1523 #. type: tbl table
1524 #: build/C/man4/console_codes.4:247
1525 #, no-wrap
1526 msgid "reset selected mapping, display control flag,\n"
1527 msgstr ""
1528
1529 #. type: tbl table
1530 #: build/C/man4/console_codes.4:248
1531 #, no-wrap
1532 msgid "and toggle meta flag (ECMA-48 says \"primary font\").\n"
1533 msgstr ""
1534
1535 #. type: tbl table
1536 #: build/C/man4/console_codes.4:250
1537 #, no-wrap
1538 msgid "11\tT{\n"
1539 msgstr ""
1540
1541 #. type: tbl table
1542 #: build/C/man4/console_codes.4:251 build/C/man4/console_codes.4:255
1543 #, no-wrap
1544 msgid "select null mapping, set display control flag,\n"
1545 msgstr ""
1546
1547 #. type: tbl table
1548 #: build/C/man4/console_codes.4:252
1549 #, no-wrap
1550 msgid "reset toggle meta flag (ECMA-48 says \"first alternate font\").\n"
1551 msgstr ""
1552
1553 #. type: tbl table
1554 #: build/C/man4/console_codes.4:254
1555 #, no-wrap
1556 msgid "12\tT{\n"
1557 msgstr ""
1558
1559 #. type: tbl table
1560 #: build/C/man4/console_codes.4:256
1561 #, no-wrap
1562 msgid "set toggle meta flag (ECMA-48 says \"second alternate font\").\n"
1563 msgstr ""
1564
1565 #. type: tbl table
1566 #: build/C/man4/console_codes.4:257
1567 #, no-wrap
1568 msgid "The toggle meta flag\n"
1569 msgstr ""
1570
1571 #. type: tbl table
1572 #: build/C/man4/console_codes.4:258
1573 #, no-wrap
1574 msgid "causes the high bit of a byte to be toggled\n"
1575 msgstr ""
1576
1577 #. type: tbl table
1578 #: build/C/man4/console_codes.4:259
1579 #, no-wrap
1580 msgid "before the mapping table translation is done.\n"
1581 msgstr ""
1582
1583 #. type: tbl table
1584 #: build/C/man4/console_codes.4:261
1585 #, no-wrap
1586 msgid "21\tset normal intensity (ECMA-48 says \"doubly underlined\")\n"
1587 msgstr ""
1588
1589 #. type: tbl table
1590 #: build/C/man4/console_codes.4:262
1591 #, no-wrap
1592 msgid "22\tset normal intensity\n"
1593 msgstr ""
1594
1595 #. type: tbl table
1596 #: build/C/man4/console_codes.4:263
1597 #, no-wrap
1598 msgid "24\tunderline off\n"
1599 msgstr ""
1600
1601 #. type: tbl table
1602 #: build/C/man4/console_codes.4:264
1603 #, no-wrap
1604 msgid "25\tblink off\n"
1605 msgstr ""
1606
1607 #. type: tbl table
1608 #: build/C/man4/console_codes.4:265
1609 #, no-wrap
1610 msgid "27\treverse video off\n"
1611 msgstr ""
1612
1613 #. type: tbl table
1614 #: build/C/man4/console_codes.4:266
1615 #, no-wrap
1616 msgid "30\tset black foreground\n"
1617 msgstr ""
1618
1619 #. type: tbl table
1620 #: build/C/man4/console_codes.4:267
1621 #, no-wrap
1622 msgid "31\tset red foreground\n"
1623 msgstr ""
1624
1625 #. type: tbl table
1626 #: build/C/man4/console_codes.4:268
1627 #, no-wrap
1628 msgid "32\tset green foreground\n"
1629 msgstr ""
1630
1631 #. type: tbl table
1632 #: build/C/man4/console_codes.4:269
1633 #, no-wrap
1634 msgid "33\tset brown foreground\n"
1635 msgstr ""
1636
1637 #. type: tbl table
1638 #: build/C/man4/console_codes.4:270
1639 #, no-wrap
1640 msgid "34\tset blue foreground\n"
1641 msgstr ""
1642
1643 #. type: tbl table
1644 #: build/C/man4/console_codes.4:271
1645 #, no-wrap
1646 msgid "35\tset magenta foreground\n"
1647 msgstr ""
1648
1649 #. type: tbl table
1650 #: build/C/man4/console_codes.4:272
1651 #, no-wrap
1652 msgid "36\tset cyan foreground\n"
1653 msgstr ""
1654
1655 #. type: tbl table
1656 #: build/C/man4/console_codes.4:273
1657 #, no-wrap
1658 msgid "37\tset white foreground\n"
1659 msgstr ""
1660
1661 #. type: tbl table
1662 #: build/C/man4/console_codes.4:274
1663 #, no-wrap
1664 msgid "38\tset underscore on, set default foreground color\n"
1665 msgstr ""
1666
1667 #. type: tbl table
1668 #: build/C/man4/console_codes.4:275
1669 #, no-wrap
1670 msgid "39\tset underscore off, set default foreground color\n"
1671 msgstr ""
1672
1673 #. type: tbl table
1674 #: build/C/man4/console_codes.4:276
1675 #, no-wrap
1676 msgid "40\tset black background\n"
1677 msgstr ""
1678
1679 #. type: tbl table
1680 #: build/C/man4/console_codes.4:277
1681 #, no-wrap
1682 msgid "41\tset red background\n"
1683 msgstr ""
1684
1685 #. type: tbl table
1686 #: build/C/man4/console_codes.4:278
1687 #, no-wrap
1688 msgid "42\tset green background\n"
1689 msgstr ""
1690
1691 #. type: tbl table
1692 #: build/C/man4/console_codes.4:279
1693 #, no-wrap
1694 msgid "43\tset brown background\n"
1695 msgstr ""
1696
1697 #. type: tbl table
1698 #: build/C/man4/console_codes.4:280
1699 #, no-wrap
1700 msgid "44\tset blue background\n"
1701 msgstr ""
1702
1703 #. type: tbl table
1704 #: build/C/man4/console_codes.4:281
1705 #, no-wrap
1706 msgid "45\tset magenta background\n"
1707 msgstr ""
1708
1709 #. type: tbl table
1710 #: build/C/man4/console_codes.4:282
1711 #, no-wrap
1712 msgid "46\tset cyan background\n"
1713 msgstr ""
1714
1715 #. type: tbl table
1716 #: build/C/man4/console_codes.4:283
1717 #, no-wrap
1718 msgid "47\tset white background\n"
1719 msgstr ""
1720
1721 #. type: tbl table
1722 #: build/C/man4/console_codes.4:284
1723 #, no-wrap
1724 msgid "49\tset default background color\n"
1725 msgstr ""
1726
1727 #. type: Plain text
1728 #: build/C/man4/console_codes.4:288
1729 msgid "B<ECMA-48 Mode Switches>"
1730 msgstr ""
1731
1732 #. type: TP
1733 #: build/C/man4/console_codes.4:288
1734 #, no-wrap
1735 msgid "ESC [ 3 h"
1736 msgstr ""
1737
1738 #. type: Plain text
1739 #: build/C/man4/console_codes.4:291
1740 msgid "DECCRM (default off): Display control chars."
1741 msgstr ""
1742
1743 #. type: TP
1744 #: build/C/man4/console_codes.4:291
1745 #, no-wrap
1746 msgid "ESC [ 4 h"
1747 msgstr ""
1748
1749 #. type: Plain text
1750 #: build/C/man4/console_codes.4:294
1751 msgid "DECIM (default off): Set insert mode."
1752 msgstr ""
1753
1754 #. type: TP
1755 #: build/C/man4/console_codes.4:294
1756 #, no-wrap
1757 msgid "ESC [ 20 h"
1758 msgstr ""
1759
1760 #. type: Plain text
1761 #: build/C/man4/console_codes.4:298
1762 msgid "LF/NL (default off): Automatically follow echo of LF, VT or FF with CR."
1763 msgstr ""
1764
1765 #. type: Plain text
1766 #: build/C/man4/console_codes.4:301
1767 msgid "B<ECMA-48 Status Report Commands>"
1768 msgstr ""
1769
1770 #. type: TP
1771 #: build/C/man4/console_codes.4:301
1772 #, no-wrap
1773 msgid "ESC [ 5 n"
1774 msgstr ""
1775
1776 #. type: Plain text
1777 #: build/C/man4/console_codes.4:304
1778 msgid "Device status report (DSR): Answer is ESC [ 0 n (Terminal OK)."
1779 msgstr ""
1780
1781 #. type: TP
1782 #: build/C/man4/console_codes.4:304
1783 #, no-wrap
1784 msgid "ESC [ 6 n"
1785 msgstr ""
1786
1787 #. type: Plain text
1788 #: build/C/man4/console_codes.4:309
1789 msgid ""
1790 "Cursor position report (CPR): Answer is ESC [ I<y> ; I<x> R, where I<x,y> is "
1791 "the cursor location."
1792 msgstr ""
1793
1794 #. type: Plain text
1795 #: build/C/man4/console_codes.4:311
1796 msgid "B<DEC Private Mode (DECSET/DECRST) sequences>"
1797 msgstr ""
1798
1799 #. type: Plain text
1800 #: build/C/man4/console_codes.4:317
1801 msgid ""
1802 "These are not described in ECMA-48.  We list the Set Mode sequences; the "
1803 "Reset Mode sequences are obtained by replacing the final \\(aqh\\(aq by "
1804 "\\(aql\\(aq."
1805 msgstr ""
1806
1807 #. type: TP
1808 #: build/C/man4/console_codes.4:317
1809 #, no-wrap
1810 msgid "ESC [ ? 1 h"
1811 msgstr ""
1812
1813 #. type: Plain text
1814 #: build/C/man4/console_codes.4:321
1815 msgid ""
1816 "DECCKM (default off): When set, the cursor keys send an ESC O prefix, rather "
1817 "than ESC [."
1818 msgstr ""
1819
1820 #. type: TP
1821 #: build/C/man4/console_codes.4:321
1822 #, no-wrap
1823 msgid "ESC [ ? 3 h"
1824 msgstr ""
1825
1826 #. type: Plain text
1827 #: build/C/man4/console_codes.4:328
1828 msgid ""
1829 "DECCOLM (default off = 80 columns): 80/132 col mode switch.  The driver "
1830 "sources note that this alone does not suffice; some user-mode utility such "
1831 "as B<resizecons>(8)  has to change the hardware registers on the console "
1832 "video card."
1833 msgstr ""
1834
1835 #. type: TP
1836 #: build/C/man4/console_codes.4:328
1837 #, no-wrap
1838 msgid "ESC [ ? 5 h"
1839 msgstr ""
1840
1841 #. type: Plain text
1842 #: build/C/man4/console_codes.4:331
1843 msgid "DECSCNM (default off): Set reverse-video mode."
1844 msgstr ""
1845
1846 #. type: TP
1847 #: build/C/man4/console_codes.4:331
1848 #, no-wrap
1849 msgid "ESC [ ? 6 h"
1850 msgstr ""
1851
1852 #. type: Plain text
1853 #: build/C/man4/console_codes.4:335
1854 msgid ""
1855 "DECOM (default off): When set, cursor addressing is relative to the upper "
1856 "left corner of the scrolling region."
1857 msgstr ""
1858
1859 #. type: TP
1860 #: build/C/man4/console_codes.4:335
1861 #, no-wrap
1862 msgid "ESC [ ? 7 h"
1863 msgstr ""
1864
1865 #. type: Plain text
1866 #: build/C/man4/console_codes.4:341
1867 msgid ""
1868 "DECAWM (default on): Set autowrap on.  In this mode, a graphic character "
1869 "emitted after column 80 (or column 132 of DECCOLM is on)  forces a wrap to "
1870 "the beginning of the following line first."
1871 msgstr ""
1872
1873 #. type: TP
1874 #: build/C/man4/console_codes.4:341
1875 #, no-wrap
1876 msgid "ESC [ ? 8 h"
1877 msgstr ""
1878
1879 #. type: Plain text
1880 #: build/C/man4/console_codes.4:344
1881 msgid "DECARM (default on): Set keyboard autorepeat on."
1882 msgstr ""
1883
1884 #. type: TP
1885 #: build/C/man4/console_codes.4:344
1886 #, no-wrap
1887 msgid "ESC [ ? 9 h"
1888 msgstr ""
1889
1890 #. type: Plain text
1891 #: build/C/man4/console_codes.4:348
1892 msgid ""
1893 "X10 Mouse Reporting (default off): Set reporting mode to 1 (or reset to "
1894 "0)\\(emsee below."
1895 msgstr ""
1896
1897 #. type: TP
1898 #: build/C/man4/console_codes.4:348
1899 #, no-wrap
1900 msgid "ESC [ ? 25 h"
1901 msgstr ""
1902
1903 #. type: Plain text
1904 #: build/C/man4/console_codes.4:351
1905 msgid "DECTECM (default on): Make cursor visible."
1906 msgstr ""
1907
1908 #. type: TP
1909 #: build/C/man4/console_codes.4:351
1910 #, no-wrap
1911 msgid "ESC [ ? 1000 h"
1912 msgstr ""
1913
1914 #. type: Plain text
1915 #: build/C/man4/console_codes.4:356
1916 msgid ""
1917 "X11 Mouse Reporting (default off): Set reporting mode to 2 (or reset to "
1918 "0)\\(emsee below."
1919 msgstr ""
1920
1921 #. type: Plain text
1922 #: build/C/man4/console_codes.4:358
1923 msgid "B<Linux Console Private CSI Sequences>"
1924 msgstr ""
1925
1926 #. type: Plain text
1927 #: build/C/man4/console_codes.4:365
1928 msgid ""
1929 "The following sequences are neither ECMA-48 nor native VT102.  They are "
1930 "native to the Linux console driver.  Colors are in SGR parameters: 0 = "
1931 "black, 1 = red, 2 = green, 3 = brown, 4 = blue, 5 = magenta, 6 = cyan, 7 = "
1932 "white."
1933 msgstr ""
1934
1935 #. type: tbl table
1936 #: build/C/man4/console_codes.4:367
1937 #, no-wrap
1938 msgid "ESC [ 1 ; I<n> ]\tSet color I<n> as the underline color\n"
1939 msgstr ""
1940
1941 #. type: tbl table
1942 #: build/C/man4/console_codes.4:368
1943 #, no-wrap
1944 msgid "ESC [ 2 ; I<n> ]\tSet color I<n> as the dim color\n"
1945 msgstr ""
1946
1947 #. type: tbl table
1948 #: build/C/man4/console_codes.4:369
1949 #, no-wrap
1950 msgid "ESC [ 8 ]       \tMake the current color pair the default attributes.\n"
1951 msgstr ""
1952
1953 #. type: tbl table
1954 #: build/C/man4/console_codes.4:370
1955 #, no-wrap
1956 msgid "ESC [ 9 ; I<n> ]\tSet screen blank timeout to I<n> minutes.\n"
1957 msgstr ""
1958
1959 #. type: tbl table
1960 #: build/C/man4/console_codes.4:371
1961 #, no-wrap
1962 msgid "ESC [ 10 ; I<n> ]\tSet bell frequency in Hz.\n"
1963 msgstr ""
1964
1965 #. type: tbl table
1966 #: build/C/man4/console_codes.4:372
1967 #, no-wrap
1968 msgid "ESC [ 11 ; I<n> ]\tSet bell duration in msec.\n"
1969 msgstr ""
1970
1971 #. type: tbl table
1972 #: build/C/man4/console_codes.4:373
1973 #, no-wrap
1974 msgid "ESC [ 12 ; I<n> ]\tBring specified console to the front.\n"
1975 msgstr ""
1976
1977 #. type: tbl table
1978 #: build/C/man4/console_codes.4:374
1979 #, no-wrap
1980 msgid "ESC [ 13 ]      \tUnblank the screen.\n"
1981 msgstr ""
1982
1983 #. type: tbl table
1984 #: build/C/man4/console_codes.4:375
1985 #, no-wrap
1986 msgid "ESC [ 14 ; I<n> ]   \tSet the VESA powerdown interval in minutes.\n"
1987 msgstr ""
1988
1989 #. type: SS
1990 #: build/C/man4/console_codes.4:377
1991 #, no-wrap
1992 msgid "Character sets"
1993 msgstr ""
1994
1995 #. type: Plain text
1996 #: build/C/man4/console_codes.4:382
1997 msgid ""
1998 "The kernel knows about 4 translations of bytes into console-screen symbols.  "
1999 "The four tables are: a) Latin1 -E<gt> PC, b) VT100 graphics -E<gt> PC, c) PC "
2000 "-E<gt> PC, d) user-defined."
2001 msgstr ""
2002
2003 #. type: Plain text
2004 #: build/C/man4/console_codes.4:388
2005 msgid ""
2006 "There are two character sets, called G0 and G1, and one of them is the "
2007 "current character set.  (Initially G0.)  Typing B<^N> causes G1 to become "
2008 "current, B<^O> causes G0 to become current."
2009 msgstr ""
2010
2011 #. type: Plain text
2012 #: build/C/man4/console_codes.4:396
2013 msgid ""
2014 "These variables G0 and G1 point at a translation table, and can be changed "
2015 "by the user.  Initially they point at tables a) and b), respectively.  The "
2016 "sequences ESC ( B and ESC ( 0 and ESC ( U and ESC ( K cause G0 to point at "
2017 "translation table a), b), c) and d), respectively.  The sequences ESC ) B "
2018 "and ESC ) 0 and ESC ) U and ESC ) K cause G1 to point at translation table "
2019 "a), b), c) and d), respectively."
2020 msgstr ""
2021
2022 #. type: Plain text
2023 #: build/C/man4/console_codes.4:406
2024 msgid ""
2025 "The sequence ESC c causes a terminal reset, which is what you want if the "
2026 "screen is all garbled.  The oft-advised \"echo ^V^O\" will make only G0 "
2027 "current, but there is no guarantee that G0 points at table a).  In some "
2028 "distributions there is a program B<reset>(1)  that just does \"echo ^[c\".  "
2029 "If your terminfo entry for the console is correct (and has an entry "
2030 "rs1=\\eEc), then \"tput reset\" will also work."
2031 msgstr ""
2032
2033 #. type: Plain text
2034 #: build/C/man4/console_codes.4:414
2035 msgid ""
2036 "The user-defined mapping table can be set using B<mapscrn>(8).  The result "
2037 "of the mapping is that if a symbol c is printed, the symbol s = map[c] is "
2038 "sent to the video memory.  The bitmap that corresponds to s is found in the "
2039 "character ROM, and can be changed using B<setfont>(8)."
2040 msgstr ""
2041
2042 #. type: SS
2043 #: build/C/man4/console_codes.4:414
2044 #, no-wrap
2045 msgid "Mouse tracking"
2046 msgstr ""
2047
2048 #. type: Plain text
2049 #: build/C/man4/console_codes.4:426
2050 msgid ""
2051 "The mouse tracking facility is intended to return B<xterm>(1)-compatible "
2052 "mouse status reports.  Because the console driver has no way to know the "
2053 "device or type of the mouse, these reports are returned in the console input "
2054 "stream only when the virtual terminal driver receives a mouse update ioctl.  "
2055 "These ioctls must be generated by a mouse-aware user-mode application such "
2056 "as the B<gpm>(8)  daemon."
2057 msgstr ""
2058
2059 #. type: Plain text
2060 #: build/C/man4/console_codes.4:432
2061 msgid ""
2062 "The mouse tracking escape sequences generated by B<xterm>(1) encode numeric "
2063 "parameters in a single character as I<value>+040.  For example, \\(aq!\\(aq "
2064 "is 1.  The screen coordinate system is 1-based."
2065 msgstr ""
2066
2067 #. type: Plain text
2068 #: build/C/man4/console_codes.4:442
2069 msgid ""
2070 "The X10 compatibility mode sends an escape sequence on button press encoding "
2071 "the location and the mouse button pressed.  It is enabled by sending ESC [ ? "
2072 "9 h and disabled with ESC [ ? 9 l.  On button press, B<xterm>(1) sends ESC [ "
2073 "M I<bxy> (6 characters).  Here I<b> is button-1, and I<x> and I<y> are the x "
2074 "and y coordinates of the mouse when the button was pressed.  This is the "
2075 "same code the kernel also produces."
2076 msgstr ""
2077
2078 #. type: Plain text
2079 #: build/C/man4/console_codes.4:457
2080 msgid ""
2081 "Normal tracking mode (not implemented in Linux 2.0.24) sends an escape "
2082 "sequence on both button press and release.  Modifier information is also "
2083 "sent.  It is enabled by sending ESC [ ? 1000 h and disabled with ESC [ ? "
2084 "1000 l.  On button press or release, B<xterm>(1) sends ESC [ M I<bxy>.  The "
2085 "low two bits of I<b> encode button information: 0=MB1 pressed, 1=MB2 "
2086 "pressed, 2=MB3 pressed, 3=release.  The upper bits encode what modifiers "
2087 "were down when the button was pressed and are added together: 4=Shift, "
2088 "8=Meta, 16=Control.  Again I<x> and I<y> are the x and y coordinates of the "
2089 "mouse event.  The upper left corner is (1,1)."
2090 msgstr ""
2091
2092 #. type: SS
2093 #: build/C/man4/console_codes.4:457
2094 #, no-wrap
2095 msgid "Comparisons with other terminals"
2096 msgstr ""
2097
2098 #. type: Plain text
2099 #: build/C/man4/console_codes.4:464
2100 msgid ""
2101 "Many different terminal types are described, like the Linux console, as "
2102 "being \"VT100-compatible\".  Here we discuss differences between the Linux "
2103 "console and the two most important others, the DEC VT102 and B<xterm>(1)."
2104 msgstr ""
2105
2106 #. type: Plain text
2107 #: build/C/man4/console_codes.4:466
2108 msgid "B<Control-character handling>"
2109 msgstr ""
2110
2111 #. type: Plain text
2112 #: build/C/man4/console_codes.4:468
2113 msgid "The VT102 also recognized the following control characters:"
2114 msgstr ""
2115
2116 #. type: Plain text
2117 #: build/C/man4/console_codes.4:470
2118 msgid "NUL (0x00) was ignored;"
2119 msgstr ""
2120
2121 #. type: Plain text
2122 #: build/C/man4/console_codes.4:472
2123 msgid "ENQ (0x05) triggered an answerback message;"
2124 msgstr ""
2125
2126 #. type: Plain text
2127 #: build/C/man4/console_codes.4:474
2128 msgid "DC1 (0x11, B<^Q>, XON) resumed transmission;"
2129 msgstr ""
2130
2131 #. type: Plain text
2132 #: build/C/man4/console_codes.4:477
2133 msgid ""
2134 "DC3 (0x13, B<^S>, XOFF) caused VT100 to ignore (and stop transmitting)  all "
2135 "codes except XOFF and XON."
2136 msgstr ""
2137
2138 #. type: Plain text
2139 #: build/C/man4/console_codes.4:479
2140 msgid "VT100-like DC1/DC3 processing may be enabled by the terminal driver."
2141 msgstr ""
2142
2143 #. type: Plain text
2144 #: build/C/man4/console_codes.4:485
2145 msgid ""
2146 "The B<xterm>(1)  program (in VT100 mode) recognizes the control characters "
2147 "BEL, BS, HT, LF, VT, FF, CR, SO, SI, ESC."
2148 msgstr ""
2149
2150 #. type: Plain text
2151 #: build/C/man4/console_codes.4:487
2152 msgid "B<Escape sequences>"
2153 msgstr ""
2154
2155 #. type: Plain text
2156 #: build/C/man4/console_codes.4:489
2157 msgid "VT100 console sequences not implemented on the Linux console:"
2158 msgstr ""
2159
2160 #. type: tbl table
2161 #: build/C/man4/console_codes.4:491
2162 #, no-wrap
2163 msgid "ESC N\tSS2\tSingle shift 2. (Select G2 character set for the next\n"
2164 msgstr ""
2165
2166 #. type: tbl table
2167 #: build/C/man4/console_codes.4:492 build/C/man4/console_codes.4:494
2168 #, no-wrap
2169 msgid "\t\tcharacter only.)\n"
2170 msgstr ""
2171
2172 #. type: tbl table
2173 #: build/C/man4/console_codes.4:493
2174 #, no-wrap
2175 msgid "ESC O\tSS3\tSingle shift 3. (Select G3 character set for the next\n"
2176 msgstr ""
2177
2178 #. type: tbl table
2179 #: build/C/man4/console_codes.4:495
2180 #, no-wrap
2181 msgid "ESC P\tDCS\tDevice control string (ended by ESC \\e)\n"
2182 msgstr ""
2183
2184 #. type: tbl table
2185 #: build/C/man4/console_codes.4:496
2186 #, no-wrap
2187 msgid "ESC X\tSOS\tStart of string.\n"
2188 msgstr ""
2189
2190 #. type: tbl table
2191 #: build/C/man4/console_codes.4:497
2192 #, no-wrap
2193 msgid "ESC ^\tPM\tPrivacy message (ended by ESC \\e)\n"
2194 msgstr ""
2195
2196 #. type: tbl table
2197 #: build/C/man4/console_codes.4:498
2198 #, no-wrap
2199 msgid "ESC \\e\tST\tString terminator\n"
2200 msgstr ""
2201
2202 #. type: tbl table
2203 #: build/C/man4/console_codes.4:499
2204 #, no-wrap
2205 msgid "ESC * ...\t\tDesignate G2 character set\n"
2206 msgstr ""
2207
2208 #. type: tbl table
2209 #: build/C/man4/console_codes.4:500
2210 #, no-wrap
2211 msgid "ESC + ...\t\tDesignate G3 character set\n"
2212 msgstr ""
2213
2214 #. type: Plain text
2215 #: build/C/man4/console_codes.4:513
2216 msgid ""
2217 "The program B<xterm>(1)  (in VT100 mode) recognizes ESC c, ESC # 8, ESC "
2218 "E<gt>, ESC =, ESC D, ESC E, ESC H, ESC M, ESC N, ESC O, ESC P ... ESC \\e, "
2219 "ESC Z (it answers ESC [ ? 1 ; 2 c, \"I am a VT100 with advanced video "
2220 "option\")  and ESC ^ ... ESC \\e with the same meanings as indicated above.  "
2221 "It accepts ESC (, ESC ), ESC *, ESC + followed by 0, A, B for the DEC "
2222 "special character and line drawing set, UK, and US-ASCII, respectively."
2223 msgstr ""
2224
2225 #. type: Plain text
2226 #: build/C/man4/console_codes.4:517
2227 msgid ""
2228 "The user can configure B<xterm>(1) to respond to VT220-specific control "
2229 "sequences, and it will identify itself as a VT52, VT100, and up depending on "
2230 "the way it is configured and initialized."
2231 msgstr ""
2232
2233 #. type: Plain text
2234 #: build/C/man4/console_codes.4:522
2235 msgid ""
2236 "It accepts ESC ] (OSC) for the setting of certain resources.  In addition to "
2237 "the ECMA-48 string terminator (ST), B<xterm>(1) accepts a BEL to terminate "
2238 "an OSC string.  These are a few of the OSC control sequences recognized by "
2239 "B<xterm>(1):"
2240 msgstr ""
2241
2242 #. type: tbl table
2243 #: build/C/man4/console_codes.4:524
2244 #, no-wrap
2245 msgid "ESC ] 0 ; I<txt> ST\tSet icon name and window title to I<txt>.\n"
2246 msgstr ""
2247
2248 #. type: tbl table
2249 #: build/C/man4/console_codes.4:525
2250 #, no-wrap
2251 msgid "ESC ] 1 ; I<txt> ST\tSet icon name to I<txt>.\n"
2252 msgstr ""
2253
2254 #. type: tbl table
2255 #: build/C/man4/console_codes.4:526
2256 #, no-wrap
2257 msgid "ESC ] 2 ; I<txt> ST\tSet window title to I<txt>.\n"
2258 msgstr ""
2259
2260 #. type: tbl table
2261 #: build/C/man4/console_codes.4:527
2262 #, no-wrap
2263 msgid "ESC ] 4 ; I<num>; I<txt> ST\tSet ANSI color I<num> to I<txt>.\n"
2264 msgstr ""
2265
2266 #. type: tbl table
2267 #: build/C/man4/console_codes.4:528
2268 #, no-wrap
2269 msgid "ESC ] 10 ; I<txt> ST\tSet dynamic text color to I<txt>.\n"
2270 msgstr ""
2271
2272 #. type: tbl table
2273 #: build/C/man4/console_codes.4:529
2274 #, no-wrap
2275 msgid "ESC ] 4 6 ; I<name> ST\tChange log file to I<name> (normally disabled\n"
2276 msgstr ""
2277
2278 #. type: tbl table
2279 #: build/C/man4/console_codes.4:530
2280 #, no-wrap
2281 msgid "\tby a compile-time option)\n"
2282 msgstr ""
2283
2284 #. type: tbl table
2285 #: build/C/man4/console_codes.4:531
2286 #, no-wrap
2287 msgid "ESC ] 5 0 ; I<fn> ST\tSet font to I<fn>.\n"
2288 msgstr ""
2289
2290 #. type: Plain text
2291 #: build/C/man4/console_codes.4:536
2292 msgid ""
2293 "It recognizes the following with slightly modified meaning (saving more "
2294 "state, behaving closer to VT100/VT220):"
2295 msgstr ""
2296
2297 #. type: tbl table
2298 #: build/C/man4/console_codes.4:538
2299 #, no-wrap
2300 msgid "ESC 7  DECSC\tSave cursor\n"
2301 msgstr ""
2302
2303 #. type: tbl table
2304 #: build/C/man4/console_codes.4:539
2305 #, no-wrap
2306 msgid "ESC 8  DECRC\tRestore cursor\n"
2307 msgstr ""
2308
2309 #. type: Plain text
2310 #: build/C/man4/console_codes.4:543
2311 msgid "It also recognizes"
2312 msgstr ""
2313
2314 #. type: tbl table
2315 #: build/C/man4/console_codes.4:545
2316 #, no-wrap
2317 msgid "ESC F\t\tCursor to lower left corner of screen (if enabled by\n"
2318 msgstr ""
2319
2320 #. type: tbl table
2321 #: build/C/man4/console_codes.4:546
2322 #, no-wrap
2323 msgid "\t\tB<xterm>(1)'s B<hpLowerleftBugCompat> resource)\n"
2324 msgstr ""
2325
2326 #. type: tbl table
2327 #: build/C/man4/console_codes.4:547
2328 #, no-wrap
2329 msgid "ESC l\t\tMemory lock (per HP terminals).\n"
2330 msgstr ""
2331
2332 #. type: tbl table
2333 #: build/C/man4/console_codes.4:548
2334 #, no-wrap
2335 msgid "\t\tLocks memory above the cursor.\n"
2336 msgstr ""
2337
2338 #. type: tbl table
2339 #: build/C/man4/console_codes.4:549
2340 #, no-wrap
2341 msgid "ESC m\t\tMemory unlock (per HP terminals).\n"
2342 msgstr ""
2343
2344 #. type: tbl table
2345 #: build/C/man4/console_codes.4:550
2346 #, no-wrap
2347 msgid "ESC n\tLS2\tInvoke the G2 character set.\n"
2348 msgstr ""
2349
2350 #. type: tbl table
2351 #: build/C/man4/console_codes.4:551
2352 #, no-wrap
2353 msgid "ESC o\tLS3\tInvoke the G3 character set.\n"
2354 msgstr ""
2355
2356 #. type: tbl table
2357 #: build/C/man4/console_codes.4:552
2358 #, no-wrap
2359 msgid "ESC |\tLS3R\tInvoke the G3 character set as GR.\n"
2360 msgstr ""
2361
2362 #. type: tbl table
2363 #: build/C/man4/console_codes.4:553
2364 #, no-wrap
2365 msgid "ESC }\tLS2R\tInvoke the G2 character set as GR.\n"
2366 msgstr ""
2367
2368 #. type: tbl table
2369 #: build/C/man4/console_codes.4:554
2370 #, no-wrap
2371 msgid "ESC ~\tLS1R\tInvoke the G1 character set as GR.\n"
2372 msgstr ""
2373
2374 #. type: Plain text
2375 #: build/C/man4/console_codes.4:560
2376 msgid ""
2377 "It also recognizes ESC % and provides a more complete UTF-8 implementation "
2378 "than Linux console."
2379 msgstr ""
2380
2381 #. type: Plain text
2382 #: build/C/man4/console_codes.4:562
2383 msgid "B<CSI Sequences>"
2384 msgstr ""
2385
2386 #. type: Plain text
2387 #: build/C/man4/console_codes.4:576
2388 msgid ""
2389 "Old versions of B<xterm>(1), for example, from X11R5, interpret the blink "
2390 "SGR as a bold SGR.  Later versions which implemented ANSI colors, for "
2391 "example, XFree86 3.1.2A in 1995, improved this by allowing the blink "
2392 "attribute to be displayed as a color.  Modern versions of xterm implement "
2393 "blink SGR as blinking text and still allow colored text as an alternate "
2394 "rendering of SGRs.  Stock X11R6 versions did not recognize the color-setting "
2395 "SGRs until the X11R6.8 release, which incorporated XFree86 xterm.  All "
2396 "ECMA-48 CSI sequences recognized by Linux are also recognized by I<xterm>, "
2397 "however B<xterm>(1) implements several ECMA-48 and DEC control sequences not "
2398 "recognized by Linux."
2399 msgstr ""
2400
2401 #. type: Plain text
2402 #: build/C/man4/console_codes.4:590
2403 msgid ""
2404 "The B<xterm>(1)  program recognizes all of the DEC Private Mode sequences "
2405 "listed above, but none of the Linux private-mode sequences.  For discussion "
2406 "of B<xterm>(1)'s own private-mode sequences, refer to the I<Xterm Control "
2407 "Sequences> document by Edward Moy, Stephen Gildea, and Thomas E. Dickey "
2408 "available with the X distribution.  That document, though terse, is much "
2409 "longer than this manual page.  For a chronological overview,"
2410 msgstr ""
2411
2412 #. type: Plain text
2413 #: build/C/man4/console_codes.4:594
2414 msgid "E<.UR http://invisible-island.net\\:/xterm\\:/xterm.log.html> E<.UE>"
2415 msgstr ""
2416
2417 #. type: Plain text
2418 #: build/C/man4/console_codes.4:597
2419 msgid "details changes to xterm."
2420 msgstr ""
2421
2422 #. type: Plain text
2423 #: build/C/man4/console_codes.4:599
2424 msgid "The I<vttest> program"
2425 msgstr ""
2426
2427 #. type: Plain text
2428 #: build/C/man4/console_codes.4:603
2429 msgid "E<.UR http://invisible-island.net\\:/vttest/> E<.UE>"
2430 msgstr ""
2431
2432 #. type: Plain text
2433 #: build/C/man4/console_codes.4:608
2434 msgid ""
2435 "demonstrates many of these control sequences.  The B<xterm>(1) source "
2436 "distribution also contains sample scripts which exercise other features."
2437 msgstr ""
2438
2439 #. type: SH
2440 #: build/C/man4/console_codes.4:608 build/C/man4/console_ioctl.4:824 build/C/man5/core.5:316 build/C/man4/cpuid.4:62 build/C/man4/fd.4:197 build/C/man7/fifo.7:54 build/C/man4/initrd.4:429 build/C/man3/makedev.3:71 build/C/man2/mknod.2:253 build/C/man4/msr.4:47 build/C/man4/null.4:61 build/C/man4/st.4:891 build/C/man3/stdarg.3:248 build/C/man2/syslog.2:380 build/C/man3/syslog.3:296 build/C/man7/uri.7:592
2441 #, no-wrap
2442 msgid "NOTES"
2443 msgstr ""
2444
2445 #. type: Plain text
2446 #: build/C/man4/console_codes.4:611
2447 msgid "ESC 8 (DECRC) is not able to restore the character set changed with ESC %."
2448 msgstr ""
2449
2450 #. type: SH
2451 #: build/C/man4/console_codes.4:611 build/C/man4/sk98lin.4:592 build/C/man3/stdarg.3:284 build/C/man7/uri.7:673
2452 #, no-wrap
2453 msgid "BUGS"
2454 msgstr ""
2455
2456 #. type: Plain text
2457 #: build/C/man4/console_codes.4:614
2458 msgid "In 2.0.23, CSI is broken, and NUL is not ignored inside escape sequences."
2459 msgstr ""
2460
2461 #. type: Plain text
2462 #: build/C/man4/console_codes.4:623
2463 msgid ""
2464 "Some older kernel versions (after 2.0) interpret 8-bit control sequences.  "
2465 "These \"C1 controls\" use codes between 128 and 159 to replace ESC [, ESC ] "
2466 "and similar two-byte control sequence initiators.  There are fragments of "
2467 "that in modern kernels (either overlooked or broken by changes to support "
2468 "UTF-8), but the implementation is incomplete and should be regarded as "
2469 "unreliable."
2470 msgstr ""
2471
2472 #. type: Plain text
2473 #: build/C/man4/console_codes.4:638
2474 msgid ""
2475 "Linux \"private mode\" sequences do not follow the rules in ECMA-48 for "
2476 "private mode control sequences.  In particular, those ending with ] do not "
2477 "use a standard terminating character.  The OSC (set palette) sequence is a "
2478 "greater problem, since B<xterm>(1) may interpret this as a control sequence "
2479 "which requires a string terminator (ST).  Unlike the B<setterm>(1) sequences "
2480 "which will be ignored (since they are invalid control sequences), the "
2481 "palette sequence will make B<xterm>(1) appear to hang (though pressing the "
2482 "return-key will fix that).  To accommodate applications which have been "
2483 "hardcoded to use Linux control sequences, set the B<xterm>(1) resource "
2484 "B<brokenLinuxOSC> to true."
2485 msgstr ""
2486
2487 #. type: Plain text
2488 #: build/C/man4/console_codes.4:642
2489 msgid ""
2490 "An older version of this document implied that Linux recognizes the ECMA-48 "
2491 "control sequence for invisible text.  It is ignored."
2492 msgstr ""
2493
2494 #. type: Plain text
2495 #: build/C/man4/console_codes.4:645
2496 msgid "B<console>(4), B<console_ioctl>(4), B<charsets>(7)"
2497 msgstr ""
2498
2499 #. type: TH
2500 #: build/C/man4/console_ioctl.4:40
2501 #, no-wrap
2502 msgid "CONSOLE_IOCTL"
2503 msgstr ""
2504
2505 #. type: TH
2506 #: build/C/man4/console_ioctl.4:40
2507 #, no-wrap
2508 msgid "2009-02-28"
2509 msgstr ""
2510
2511 #. type: Plain text
2512 #: build/C/man4/console_ioctl.4:43
2513 msgid "console_ioctl - ioctls for console terminal and virtual consoles"
2514 msgstr ""
2515
2516 #. type: Plain text
2517 #: build/C/man4/console_ioctl.4:49
2518 msgid ""
2519 "The following Linux-specific B<ioctl>(2)  requests are supported.  Each "
2520 "requires a third argument, assumed here to be I<argp>."
2521 msgstr ""
2522
2523 #. type: TP
2524 #: build/C/man4/console_ioctl.4:49
2525 #, no-wrap
2526 msgid "B<KDGETLED>"
2527 msgstr ""
2528
2529 #. type: Plain text
2530 #: build/C/man4/console_ioctl.4:59
2531 msgid ""
2532 "Get state of LEDs.  I<argp> points to a I<char>.  The lower three bits of "
2533 "I<*argp> are set to the state of the LEDs, as follows:"
2534 msgstr ""
2535
2536 #. type: tbl table
2537 #: build/C/man4/console_ioctl.4:61
2538 #, no-wrap
2539 msgid "LED_CAP \t0x04\tcaps lock led\n"
2540 msgstr ""
2541
2542 #. type: tbl table
2543 #: build/C/man4/console_ioctl.4:62
2544 #, no-wrap
2545 msgid "LED_NUM \t0x02\tnum lock led\n"
2546 msgstr ""
2547
2548 #. type: tbl table
2549 #: build/C/man4/console_ioctl.4:63
2550 #, no-wrap
2551 msgid "LED_SCR \t0x01\tscroll lock led\n"
2552 msgstr ""
2553
2554 #. type: TP
2555 #: build/C/man4/console_ioctl.4:65
2556 #, no-wrap
2557 msgid "B<KDSETLED>"
2558 msgstr ""
2559
2560 #. type: Plain text
2561 #: build/C/man4/console_ioctl.4:73
2562 msgid ""
2563 "Set the LEDs.  The LEDs are set to correspond to the lower three bits of "
2564 "I<argp>.  However, if a higher order bit is set, the LEDs revert to normal: "
2565 "displaying the state of the keyboard functions of caps lock, num lock, and "
2566 "scroll lock."
2567 msgstr ""
2568
2569 #. type: Plain text
2570 #: build/C/man4/console_ioctl.4:80
2571 msgid ""
2572 "Before 1.1.54, the LEDs just reflected the state of the corresponding "
2573 "keyboard flags, and KDGETLED/KDSETLED would also change the keyboard flags.  "
2574 "Since 1.1.54 the LEDs can be made to display arbitrary information, but by "
2575 "default they display the keyboard flags.  The following two ioctls are used "
2576 "to access the keyboard flags."
2577 msgstr ""
2578
2579 #. type: TP
2580 #: build/C/man4/console_ioctl.4:80
2581 #, no-wrap
2582 msgid "B<KDGKBLED>"
2583 msgstr ""
2584
2585 #. type: Plain text
2586 #: build/C/man4/console_ioctl.4:89
2587 msgid ""
2588 "Get keyboard flags CapsLock, NumLock, ScrollLock (not lights).  I<argp> "
2589 "points to a char which is set to the flag state.  The low order three bits "
2590 "(mask 0x7) get the current flag state, and the low order bits of the next "
2591 "nibble (mask 0x70) get the default flag state.  (Since 1.1.54.)"
2592 msgstr ""
2593
2594 #. type: TP
2595 #: build/C/man4/console_ioctl.4:89
2596 #, no-wrap
2597 msgid "B<KDSKBLED>"
2598 msgstr ""
2599
2600 #. type: Plain text
2601 #: build/C/man4/console_ioctl.4:98
2602 msgid ""
2603 "Set keyboard flags CapsLock, NumLock, ScrollLock (not lights).  I<argp> has "
2604 "the desired flag state.  The low order three bits (mask 0x7) have the flag "
2605 "state, and the low order bits of the next nibble (mask 0x70) have the "
2606 "default flag state.  (Since 1.1.54.)"
2607 msgstr ""
2608
2609 #. type: TP
2610 #: build/C/man4/console_ioctl.4:98
2611 #, no-wrap
2612 msgid "B<KDGKBTYPE>"
2613 msgstr ""
2614
2615 #. type: Plain text
2616 #: build/C/man4/console_ioctl.4:102
2617 msgid "Get keyboard type.  This returns the value KB_101, defined as 0x02."
2618 msgstr ""
2619
2620 #. type: TP
2621 #: build/C/man4/console_ioctl.4:102
2622 #, no-wrap
2623 msgid "B<KDADDIO>"
2624 msgstr ""
2625
2626 #. type: Plain text
2627 #: build/C/man4/console_ioctl.4:107
2628 msgid "Add I/O port as valid.  Equivalent to I<ioperm(arg,1,1)>."
2629 msgstr ""
2630
2631 #. type: TP
2632 #: build/C/man4/console_ioctl.4:107
2633 #, no-wrap
2634 msgid "B<KDDELIO>"
2635 msgstr ""
2636
2637 #. type: Plain text
2638 #: build/C/man4/console_ioctl.4:112
2639 msgid "Delete I/O port as valid.  Equivalent to I<ioperm(arg,1,0)>."
2640 msgstr ""
2641
2642 #. type: TP
2643 #: build/C/man4/console_ioctl.4:112
2644 #, no-wrap
2645 msgid "B<KDENABIO>"
2646 msgstr ""
2647
2648 #. type: Plain text
2649 #: build/C/man4/console_ioctl.4:117
2650 msgid ""
2651 "Enable I/O to video board.  Equivalent to I<ioperm(0x3b4, 0x3df-0x3b4+1, "
2652 "1)>."
2653 msgstr ""
2654
2655 #. type: TP
2656 #: build/C/man4/console_ioctl.4:117
2657 #, no-wrap
2658 msgid "B<KDDISABIO>"
2659 msgstr ""
2660
2661 #. type: Plain text
2662 #: build/C/man4/console_ioctl.4:122
2663 msgid ""
2664 "Disable I/O to video board.  Equivalent to I<ioperm(0x3b4, 0x3df-0x3b4+1, "
2665 "0)>."
2666 msgstr ""
2667
2668 #. type: TP
2669 #: build/C/man4/console_ioctl.4:122
2670 #, no-wrap
2671 msgid "B<KDSETMODE>"
2672 msgstr ""
2673
2674 #. type: Plain text
2675 #: build/C/man4/console_ioctl.4:127
2676 msgid "Set text/graphics mode.  I<argp> is one of these:"
2677 msgstr ""
2678
2679 #. type: tbl table
2680 #: build/C/man4/console_ioctl.4:130
2681 #, no-wrap
2682 msgid "KD_TEXT\t0x00\n"
2683 msgstr ""
2684
2685 #. type: tbl table
2686 #: build/C/man4/console_ioctl.4:131
2687 #, no-wrap
2688 msgid "KD_GRAPHICS\t0x01\n"
2689 msgstr ""
2690
2691 #. type: TP
2692 #: build/C/man4/console_ioctl.4:133
2693 #, no-wrap
2694 msgid "B<KDGETMODE>"
2695 msgstr ""
2696
2697 #. type: Plain text
2698 #: build/C/man4/console_ioctl.4:141
2699 msgid ""
2700 "Get text/graphics mode.  I<argp> points to a I<long> which is set to one of "
2701 "the above values."
2702 msgstr ""
2703
2704 #. type: TP
2705 #: build/C/man4/console_ioctl.4:141
2706 #, no-wrap
2707 msgid "B<KDMKTONE>"
2708 msgstr ""
2709
2710 #. type: Plain text
2711 #: build/C/man4/console_ioctl.4:155
2712 msgid ""
2713 "Generate tone of specified length.  The lower 16 bits of I<argp> specify the "
2714 "period in clock cycles, and the upper 16 bits give the duration in msec.  If "
2715 "the duration is zero, the sound is turned off.  Control returns "
2716 "immediately.  For example, I<argp> = (125E<lt>E<lt>16) + 0x637 would specify "
2717 "the beep normally associated with a ctrl-G.  (Thus since 0.99pl1; broken in "
2718 "2.1.49-50.)"
2719 msgstr ""
2720
2721 #. type: TP
2722 #: build/C/man4/console_ioctl.4:155
2723 #, no-wrap
2724 msgid "B<KIOCSOUND>"
2725 msgstr ""
2726
2727 #. type: Plain text
2728 #: build/C/man4/console_ioctl.4:167
2729 msgid ""
2730 "Start or stop sound generation.  The lower 16 bits of I<argp> specify the "
2731 "period in clock cycles (that is, I<argp> = 1193180/frequency).  I<argp> = 0 "
2732 "turns sound off.  In either case, control returns immediately."
2733 msgstr ""
2734
2735 #. type: TP
2736 #: build/C/man4/console_ioctl.4:167
2737 #, no-wrap
2738 msgid "B<GIO_CMAP>"
2739 msgstr ""
2740
2741 #. type: Plain text
2742 #: build/C/man4/console_ioctl.4:174
2743 msgid ""
2744 "Get the current default color map from kernel.  I<argp> points to a 48-byte "
2745 "array.  (Since 1.3.3.)"
2746 msgstr ""
2747
2748 #. type: TP
2749 #: build/C/man4/console_ioctl.4:174
2750 #, no-wrap
2751 msgid "B<PIO_CMAP>"
2752 msgstr ""
2753
2754 #. type: Plain text
2755 #: build/C/man4/console_ioctl.4:187
2756 msgid ""
2757 "Change the default text-mode color map.  I<argp> points to a 48-byte array "
2758 "which contains, in order, the Red, Green, and Blue values for the 16 "
2759 "available screen colors: 0 is off, and 255 is full intensity.  The default "
2760 "colors are, in order: black, dark red, dark green, brown, dark blue, dark "
2761 "purple, dark cyan, light grey, dark grey, bright red, bright green, yellow, "
2762 "bright blue, bright purple, bright cyan and white.  (Since 1.3.3.)"
2763 msgstr ""
2764
2765 #. type: TP
2766 #: build/C/man4/console_ioctl.4:187
2767 #, no-wrap
2768 msgid "B<GIO_FONT>"
2769 msgstr ""
2770
2771 #. type: Plain text
2772 #: build/C/man4/console_ioctl.4:197
2773 msgid ""
2774 "Gets 256-character screen font in expanded form.  I<argp> points to an 8192 "
2775 "byte array.  Fails with error code B<EINVAL> if the currently loaded font is "
2776 "a 512-character font, or if the console is not in text mode."
2777 msgstr ""
2778
2779 #. type: TP
2780 #: build/C/man4/console_ioctl.4:197
2781 #, no-wrap
2782 msgid "B<GIO_FONTX>"
2783 msgstr ""
2784
2785 #. type: Plain text
2786 #: build/C/man4/console_ioctl.4:225
2787 msgid ""
2788 "Gets screen font and associated information.  I<argp> points to a I<struct "
2789 "consolefontdesc> (see B<PIO_FONTX>).  On call, the I<charcount> field should "
2790 "be set to the maximum number of characters that would fit in the buffer "
2791 "pointed to by I<chardata>.  On return, the I<charcount> and I<charheight> "
2792 "are filled with the respective data for the currently loaded font, and the "
2793 "I<chardata> array contains the font data if the initial value of "
2794 "I<charcount> indicated enough space was available; otherwise the buffer is "
2795 "untouched and I<errno> is set to B<ENOMEM>.  (Since 1.3.1.)"
2796 msgstr ""
2797
2798 #. type: TP
2799 #: build/C/man4/console_ioctl.4:225
2800 #, no-wrap
2801 msgid "B<PIO_FONT>"
2802 msgstr ""
2803
2804 #. type: Plain text
2805 #: build/C/man4/console_ioctl.4:240
2806 msgid ""
2807 "Sets 256-character screen font.  Load font into the EGA/VGA character "
2808 "generator.  I<argp> points to a 8192 byte map, with 32 bytes per character.  "
2809 "Only the first I<N> of them are used for an 8xI<N> font (0 E<lt> I<N> E<lt>= "
2810 "32).  This call also invalidates the Unicode mapping."
2811 msgstr ""
2812
2813 #. type: TP
2814 #: build/C/man4/console_ioctl.4:240
2815 #, no-wrap
2816 msgid "B<PIO_FONTX>"
2817 msgstr ""
2818
2819 #. type: Plain text
2820 #: build/C/man4/console_ioctl.4:245
2821 msgid "Sets screen font and associated rendering information.  I<argp> points to a"
2822 msgstr ""
2823
2824 #. type: Plain text
2825 #: build/C/man4/console_ioctl.4:256
2826 #, no-wrap
2827 msgid ""
2828 "struct consolefontdesc {\n"
2829 "    unsigned short charcount;  /* characters in font\n"
2830 "                                  (256 or 512) */\n"
2831 "    unsigned short charheight; /* scan lines per\n"
2832 "                                  character (1-32) */\n"
2833 "    char          *chardata;   /* font data in\n"
2834 "                                  expanded form */\n"
2835 "};\n"
2836 msgstr ""
2837
2838 #. type: Plain text
2839 #: build/C/man4/console_ioctl.4:264
2840 msgid ""
2841 "If necessary, the screen will be appropriately resized, and B<SIGWINCH> sent "
2842 "to the appropriate processes.  This call also invalidates the Unicode "
2843 "mapping.  (Since 1.3.1.)"
2844 msgstr ""
2845
2846 #. type: TP
2847 #: build/C/man4/console_ioctl.4:264
2848 #, no-wrap
2849 msgid "B<PIO_FONTRESET>"
2850 msgstr ""
2851
2852 #. type: Plain text
2853 #: build/C/man4/console_ioctl.4:272
2854 msgid ""
2855 "Resets the screen font, size and Unicode mapping to the bootup defaults.  "
2856 "I<argp> is unused, but should be set to NULL to ensure compatibility with "
2857 "future versions of Linux.  (Since 1.3.28.)"
2858 msgstr ""
2859
2860 #. type: TP
2861 #: build/C/man4/console_ioctl.4:272
2862 #, no-wrap
2863 msgid "B<GIO_SCRNMAP>"
2864 msgstr ""
2865
2866 #. type: Plain text
2867 #: build/C/man4/console_ioctl.4:281
2868 msgid ""
2869 "Get screen mapping from kernel.  I<argp> points to an area of size E_TABSZ, "
2870 "which is loaded with the font positions used to display each character.  "
2871 "This call is likely to return useless information if the currently loaded "
2872 "font is more than 256 characters."
2873 msgstr ""
2874
2875 #. type: TP
2876 #: build/C/man4/console_ioctl.4:281
2877 #, no-wrap
2878 msgid "B<GIO_UNISCRNMAP>"
2879 msgstr ""
2880
2881 #. type: Plain text
2882 #: build/C/man4/console_ioctl.4:293
2883 msgid ""
2884 "Get full Unicode screen mapping from kernel.  I<argp> points to an area of "
2885 "size I<E_TABSZ*sizeof(unsigned short)>, which is loaded with the Unicodes "
2886 "each character represent.  A special set of Unicodes, starting at U+F000, "
2887 "are used to represent \"direct to font\" mappings.  (Since 1.3.1.)"
2888 msgstr ""
2889
2890 #. type: TP
2891 #: build/C/man4/console_ioctl.4:293
2892 #, no-wrap
2893 msgid "B<PIO_SCRNMAP>"
2894 msgstr ""
2895
2896 #. type: Plain text
2897 #: build/C/man4/console_ioctl.4:300
2898 msgid ""
2899 "Loads the \"user definable\" (fourth) table in the kernel which maps bytes "
2900 "into console screen symbols.  I<argp> points to an area of size E_TABSZ."
2901 msgstr ""
2902
2903 #. type: TP
2904 #: build/C/man4/console_ioctl.4:300
2905 #, no-wrap
2906 msgid "B<PIO_UNISCRNMAP>"
2907 msgstr ""
2908
2909 #. type: Plain text
2910 #: build/C/man4/console_ioctl.4:308
2911 msgid ""
2912 "Loads the \"user definable\" (fourth) table in the kernel which maps bytes "
2913 "into Unicodes, which are then translated into screen symbols according to "
2914 "the currently loaded Unicode-to-font map.  Special Unicodes starting at "
2915 "U+F000 can be used to map directly to the font symbols.  (Since 1.3.1.)"
2916 msgstr ""
2917
2918 #. type: TP
2919 #: build/C/man4/console_ioctl.4:308
2920 #, no-wrap
2921 msgid "B<GIO_UNIMAP>"
2922 msgstr ""
2923
2924 #. type: Plain text
2925 #: build/C/man4/console_ioctl.4:313
2926 msgid "Get Unicode-to-font mapping from kernel.  I<argp> points to a"
2927 msgstr ""
2928
2929 #. type: Plain text
2930 #: build/C/man4/console_ioctl.4:320
2931 #, no-wrap
2932 msgid ""
2933 "struct unimapdesc {\n"
2934 "    unsigned short  entry_ct;\n"
2935 "    struct unipair *entries;\n"
2936 "};\n"
2937 msgstr ""
2938
2939 #. type: Plain text
2940 #: build/C/man4/console_ioctl.4:326
2941 msgid "where I<entries> points to an array of"
2942 msgstr ""
2943
2944 #. type: Plain text
2945 #: build/C/man4/console_ioctl.4:333
2946 #, no-wrap
2947 msgid ""
2948 "struct unipair {\n"
2949 "    unsigned short unicode;\n"
2950 "    unsigned short fontpos;\n"
2951 "};\n"
2952 msgstr ""
2953
2954 #. type: Plain text
2955 #: build/C/man4/console_ioctl.4:337 build/C/man4/console_ioctl.4:361
2956 msgid "(Since 1.1.92.)"
2957 msgstr ""
2958
2959 #. type: TP
2960 #: build/C/man4/console_ioctl.4:337
2961 #, no-wrap
2962 msgid "B<PIO_UNIMAP>"
2963 msgstr ""
2964
2965 #. type: Plain text
2966 #: build/C/man4/console_ioctl.4:344
2967 msgid ""
2968 "Put unicode-to-font mapping in kernel.  I<argp> points to a I<struct "
2969 "unimapdesc>.  (Since 1.1.92)"
2970 msgstr ""
2971
2972 #. type: TP
2973 #: build/C/man4/console_ioctl.4:344
2974 #, no-wrap
2975 msgid "B<PIO_UNIMAPCLR>"
2976 msgstr ""
2977
2978 #. type: Plain text
2979 #: build/C/man4/console_ioctl.4:349
2980 msgid "Clear table, possibly advise hash algorithm.  I<argp> points to a"
2981 msgstr ""
2982
2983 #. type: Plain text
2984 #: build/C/man4/console_ioctl.4:357
2985 #, no-wrap
2986 msgid ""
2987 "struct unimapinit {\n"
2988 "    unsigned short advised_hashsize;  /* 0 if no opinion */\n"
2989 "    unsigned short advised_hashstep;  /* 0 if no opinion */\n"
2990 "    unsigned short advised_hashlevel; /* 0 if no opinion */\n"
2991 "};\n"
2992 msgstr ""
2993
2994 #. type: TP
2995 #: build/C/man4/console_ioctl.4:361
2996 #, no-wrap
2997 msgid "B<KDGKBMODE>"
2998 msgstr ""
2999
3000 #. type: Plain text
3001 #: build/C/man4/console_ioctl.4:369
3002 msgid ""
3003 "Gets current keyboard mode.  I<argp> points to a I<long> which is set to one "
3004 "of these:"
3005 msgstr ""
3006
3007 #. type: tbl table
3008 #: build/C/man4/console_ioctl.4:372
3009 #, no-wrap
3010 msgid "K_RAW\t0x00\n"
3011 msgstr ""
3012
3013 #. type: tbl table
3014 #: build/C/man4/console_ioctl.4:373
3015 #, no-wrap
3016 msgid "K_XLATE\t0x01\n"
3017 msgstr ""
3018
3019 #. type: tbl table
3020 #: build/C/man4/console_ioctl.4:374
3021 #, no-wrap
3022 msgid "K_MEDIUMRAW\t0x02\n"
3023 msgstr ""
3024
3025 #. type: tbl table
3026 #: build/C/man4/console_ioctl.4:375
3027 #, no-wrap
3028 msgid "K_UNICODE\t0x03\n"
3029 msgstr ""
3030
3031 #. type: TP
3032 #: build/C/man4/console_ioctl.4:377
3033 #, no-wrap
3034 msgid "B<KDSKBMODE>"
3035 msgstr ""
3036
3037 #. type: Plain text
3038 #: build/C/man4/console_ioctl.4:384
3039 msgid ""
3040 "Sets current keyboard mode.  I<argp> is a I<long> equal to one of the above "
3041 "values."
3042 msgstr ""
3043
3044 #. type: TP
3045 #: build/C/man4/console_ioctl.4:384
3046 #, no-wrap
3047 msgid "B<KDGKBMETA>"
3048 msgstr ""
3049
3050 #. type: Plain text
3051 #: build/C/man4/console_ioctl.4:392
3052 msgid ""
3053 "Gets meta key handling mode.  I<argp> points to a I<long> which is set to "
3054 "one of these:"
3055 msgstr ""
3056
3057 #. type: tbl table
3058 #: build/C/man4/console_ioctl.4:395
3059 #, no-wrap
3060 msgid "K_METABIT\t0x03\tset high order bit\n"
3061 msgstr ""
3062
3063 #. type: tbl table
3064 #: build/C/man4/console_ioctl.4:396
3065 #, no-wrap
3066 msgid "K_ESCPREFIX\t0x04\tescape prefix\n"
3067 msgstr ""
3068
3069 #. type: TP
3070 #: build/C/man4/console_ioctl.4:398
3071 #, no-wrap
3072 msgid "B<KDSKBMETA>"
3073 msgstr ""
3074
3075 #. type: Plain text
3076 #: build/C/man4/console_ioctl.4:405
3077 msgid ""
3078 "Sets meta key handling mode.  I<argp> is a I<long> equal to one of the above "
3079 "values."
3080 msgstr ""
3081
3082 #. type: TP
3083 #: build/C/man4/console_ioctl.4:405
3084 #, no-wrap
3085 msgid "B<KDGKBENT>"
3086 msgstr ""
3087
3088 #. type: Plain text
3089 #: build/C/man4/console_ioctl.4:410
3090 msgid ""
3091 "Gets one entry in key translation table (keycode to action code).  I<argp> "
3092 "points to a"
3093 msgstr ""
3094
3095 #. type: Plain text
3096 #: build/C/man4/console_ioctl.4:418
3097 #, no-wrap
3098 msgid ""
3099 "struct kbentry {\n"
3100 "    unsigned char  kb_table;\n"
3101 "    unsigned char  kb_index;\n"
3102 "    unsigned short kb_value;\n"
3103 "};\n"
3104 msgstr ""
3105
3106 #. type: Plain text
3107 #: build/C/man4/console_ioctl.4:437
3108 msgid ""
3109 "with the first two members filled in: I<kb_table> selects the key table (0 "
3110 "E<lt>= I<kb_table> E<lt> MAX_NR_KEYMAPS), and I<kb_index> is the keycode (0 "
3111 "E<lt>= I<kb_index> E<lt> NR_KEYS).  I<kb_value> is set to the corresponding "
3112 "action code, or K_HOLE if there is no such key, or K_NOSUCHMAP if "
3113 "I<kb_table> is invalid."
3114 msgstr ""
3115
3116 #. type: TP
3117 #: build/C/man4/console_ioctl.4:437
3118 #, no-wrap
3119 msgid "B<KDSKBENT>"
3120 msgstr ""
3121
3122 #. type: Plain text
3123 #: build/C/man4/console_ioctl.4:443
3124 msgid "Sets one entry in translation table.  I<argp> points to a I<struct kbentry>."
3125 msgstr ""
3126
3127 #. type: TP
3128 #: build/C/man4/console_ioctl.4:443
3129 #, no-wrap
3130 msgid "B<KDGKBSENT>"
3131 msgstr ""
3132
3133 #. type: Plain text
3134 #: build/C/man4/console_ioctl.4:448
3135 msgid "Gets one function key string.  I<argp> points to a"
3136 msgstr ""
3137
3138 #. type: Plain text
3139 #: build/C/man4/console_ioctl.4:455
3140 #, no-wrap
3141 msgid ""
3142 "struct kbsentry {\n"
3143 "    unsigned char kb_func;\n"
3144 "    unsigned char kb_string[512];\n"
3145 "};\n"
3146 msgstr ""
3147
3148 #. type: Plain text
3149 #: build/C/man4/console_ioctl.4:463
3150 msgid ""
3151 "I<kb_string> is set to the (null-terminated) string corresponding to the "
3152 "I<kb_func>th function key action code."
3153 msgstr ""
3154
3155 #. type: TP
3156 #: build/C/man4/console_ioctl.4:463
3157 #, no-wrap
3158 msgid "B<KDSKBSENT>"
3159 msgstr ""
3160
3161 #. type: Plain text
3162 #: build/C/man4/console_ioctl.4:469
3163 msgid "Sets one function key string entry.  I<argp> points to a I<struct kbsentry>."
3164 msgstr ""
3165
3166 #. type: TP
3167 #: build/C/man4/console_ioctl.4:469
3168 #, no-wrap
3169 msgid "B<KDGKBDIACR>"
3170 msgstr ""
3171
3172 #. type: Plain text
3173 #: build/C/man4/console_ioctl.4:474
3174 msgid "Read kernel accent table.  I<argp> points to a"
3175 msgstr ""
3176
3177 #. type: Plain text
3178 #: build/C/man4/console_ioctl.4:481
3179 #, no-wrap
3180 msgid ""
3181 "struct kbdiacrs {\n"
3182 "    unsigned int   kb_cnt;\n"
3183 "    struct kbdiacr kbdiacr[256];\n"
3184 "};\n"
3185 msgstr ""
3186
3187 #. type: Plain text
3188 #: build/C/man4/console_ioctl.4:488
3189 msgid "where I<kb_cnt> is the number of entries in the array, each of which is a"
3190 msgstr ""
3191
3192 #. type: Plain text
3193 #: build/C/man4/console_ioctl.4:496
3194 #, no-wrap
3195 msgid ""
3196 "struct kbdiacr {\n"
3197 "    unsigned char diacr;\n"
3198 "    unsigned char base;\n"
3199 "    unsigned char result;\n"
3200 "};\n"
3201 msgstr ""
3202
3203 #. type: TP
3204 #: build/C/man4/console_ioctl.4:498
3205 #, no-wrap
3206 msgid "B<KDGETKEYCODE>"
3207 msgstr ""
3208
3209 #. type: Plain text
3210 #: build/C/man4/console_ioctl.4:503
3211 msgid "Read kernel keycode table entry (scan code to keycode).  I<argp> points to a"
3212 msgstr ""
3213
3214 #. type: Plain text
3215 #: build/C/man4/console_ioctl.4:510
3216 #, no-wrap
3217 msgid ""
3218 "struct kbkeycode {\n"
3219 "    unsigned int scancode;\n"
3220 "    unsigned int keycode;\n"
3221 "};\n"
3222 msgstr ""
3223
3224 #. type: Plain text
3225 #: build/C/man4/console_ioctl.4:524
3226 msgid ""
3227 "I<keycode> is set to correspond to the given I<scancode>.  (89 E<lt>= "
3228 "I<scancode> E<lt>= 255 only.  For 1 E<lt>= I<scancode> E<lt>= 88, "
3229 "I<keycode>==I<scancode>.)  (Since 1.1.63.)"
3230 msgstr ""
3231
3232 #. type: TP
3233 #: build/C/man4/console_ioctl.4:524
3234 #, no-wrap
3235 msgid "B<KDSETKEYCODE>"
3236 msgstr ""
3237
3238 #. type: Plain text
3239 #: build/C/man4/console_ioctl.4:531
3240 msgid ""
3241 "Write kernel keycode table entry.  I<argp> points to a I<struct kbkeycode>.  "
3242 "(Since 1.1.63.)"
3243 msgstr ""
3244
3245 #. type: TP
3246 #: build/C/man4/console_ioctl.4:531
3247 #, no-wrap
3248 msgid "B<KDSIGACCEPT>"
3249 msgstr ""
3250
3251 #. type: Plain text
3252 #: build/C/man4/console_ioctl.4:543
3253 msgid ""
3254 "The calling process indicates its willingness to accept the signal I<argp> "
3255 "when it is generated by pressing an appropriate key combination.  (1 E<lt>= "
3256 "I<argp> E<lt>= NSIG).  (See I<spawn_console>()  in "
3257 "I<linux/drivers/char/keyboard.c>.)"
3258 msgstr ""
3259
3260 #. type: TP
3261 #: build/C/man4/console_ioctl.4:543
3262 #, no-wrap
3263 msgid "B<VT_OPENQRY>"
3264 msgstr ""
3265
3266 #. type: Plain text
3267 #: build/C/man4/console_ioctl.4:553
3268 msgid ""
3269 "Returns the first available (non-opened) console.  I<argp> points to an "
3270 "I<int> which is set to the number of the vt (1 E<lt>= I<*argp> E<lt>= "
3271 "MAX_NR_CONSOLES)."
3272 msgstr ""
3273
3274 #. type: TP
3275 #: build/C/man4/console_ioctl.4:553
3276 #, no-wrap
3277 msgid "B<VT_GETMODE>"
3278 msgstr ""
3279
3280 #. type: Plain text
3281 #: build/C/man4/console_ioctl.4:558
3282 msgid "Get mode of active vt.  I<argp> points to a"
3283 msgstr ""
3284
3285 #. type: Plain text
3286 #: build/C/man4/console_ioctl.4:568
3287 #, no-wrap
3288 msgid ""
3289 "struct vt_mode {\n"
3290 "    char  mode;    /* vt mode */\n"
3291 "    char  waitv;   /* if set, hang on writes if not active */\n"
3292 "    short relsig;  /* signal to raise on release req */\n"
3293 "    short acqsig;  /* signal to raise on acquisition */\n"
3294 "    short frsig;   /* unused (set to 0) */\n"
3295 "};\n"
3296 msgstr ""
3297
3298 #. type: Plain text
3299 #: build/C/man4/console_ioctl.4:574
3300 msgid ""
3301 "which is set to the mode of the active vt.  I<mode> is set to one of these "
3302 "values:"
3303 msgstr ""
3304
3305 #. type: tbl table
3306 #: build/C/man4/console_ioctl.4:577
3307 #, no-wrap
3308 msgid "VT_AUTO\tauto vt switching\n"
3309 msgstr ""
3310
3311 #. type: tbl table
3312 #: build/C/man4/console_ioctl.4:578
3313 #, no-wrap
3314 msgid "VT_PROCESS\tprocess controls switching\n"
3315 msgstr ""
3316
3317 #. type: tbl table
3318 #: build/C/man4/console_ioctl.4:579
3319 #, no-wrap
3320 msgid "VT_ACKACQ\tacknowledge switch\n"
3321 msgstr ""
3322
3323 #. type: TP
3324 #: build/C/man4/console_ioctl.4:581
3325 #, no-wrap
3326 msgid "B<VT_SETMODE>"
3327 msgstr ""
3328
3329 #. type: Plain text
3330 #: build/C/man4/console_ioctl.4:587
3331 msgid "Set mode of active vt.  I<argp> points to a I<struct vt_mode>."
3332 msgstr ""
3333
3334 #. type: TP
3335 #: build/C/man4/console_ioctl.4:587
3336 #, no-wrap
3337 msgid "B<VT_GETSTATE>"
3338 msgstr ""
3339
3340 #. type: Plain text
3341 #: build/C/man4/console_ioctl.4:592
3342 msgid "Get global vt state info.  I<argp> points to a"
3343 msgstr ""
3344
3345 #. type: Plain text
3346 #: build/C/man4/console_ioctl.4:600
3347 #, no-wrap
3348 msgid ""
3349 "struct vt_stat {\n"
3350 "    unsigned short v_active;  /* active vt */\n"
3351 "    unsigned short v_signal;  /* signal to send */\n"
3352 "    unsigned short v_state;   /* vt bit mask */\n"
3353 "};\n"
3354 msgstr ""
3355
3356 #. type: Plain text
3357 #: build/C/man4/console_ioctl.4:607
3358 msgid ""
3359 "For each vt in use, the corresponding bit in the I<v_state> member is set.  "
3360 "(Kernels 1.0 through 1.1.92.)"
3361 msgstr ""
3362
3363 #. type: TP
3364 #: build/C/man4/console_ioctl.4:607
3365 #, no-wrap
3366 msgid "B<VT_RELDISP>"
3367 msgstr ""
3368
3369 #. type: Plain text
3370 #: build/C/man4/console_ioctl.4:610
3371 msgid "Release a display."
3372 msgstr ""
3373
3374 #. type: TP
3375 #: build/C/man4/console_ioctl.4:610
3376 #, no-wrap
3377 msgid "B<VT_ACTIVATE>"
3378 msgstr ""
3379
3380 #. type: Plain text
3381 #: build/C/man4/console_ioctl.4:617
3382 msgid "Switch to vt I<argp> (1 E<lt>= I<argp> E<lt>= MAX_NR_CONSOLES)."
3383 msgstr ""
3384
3385 #. type: TP
3386 #: build/C/man4/console_ioctl.4:617
3387 #, no-wrap
3388 msgid "B<VT_WAITACTIVE>"
3389 msgstr ""
3390
3391 #. type: Plain text
3392 #: build/C/man4/console_ioctl.4:622
3393 msgid "Wait until vt I<argp> has been activated."
3394 msgstr ""
3395
3396 #. type: TP
3397 #: build/C/man4/console_ioctl.4:622
3398 #, no-wrap
3399 msgid "B<VT_DISALLOCATE>"
3400 msgstr ""
3401
3402 #. type: Plain text
3403 #: build/C/man4/console_ioctl.4:627
3404 msgid "Deallocate the memory associated with vt I<argp>.  (Since 1.1.54.)"
3405 msgstr ""
3406
3407 #. type: TP
3408 #: build/C/man4/console_ioctl.4:627
3409 #, no-wrap
3410 msgid "B<VT_RESIZE>"
3411 msgstr ""
3412
3413 #. type: Plain text
3414 #: build/C/man4/console_ioctl.4:632
3415 msgid "Set the kernel's idea of screensize.  I<argp> points to a"
3416 msgstr ""
3417
3418 #. type: Plain text
3419 #: build/C/man4/console_ioctl.4:640
3420 #, no-wrap
3421 msgid ""
3422 "struct vt_sizes {\n"
3423 "    unsigned short v_rows;       /* # rows */\n"
3424 "    unsigned short v_cols;       /* # columns */\n"
3425 "    unsigned short v_scrollsize; /* no longer used */\n"
3426 "};\n"
3427 msgstr ""
3428
3429 #. type: Plain text
3430 #: build/C/man4/console_ioctl.4:647
3431 msgid ""
3432 "Note that this does not change the videomode.  See B<resizecons>(8).  (Since "
3433 "1.1.54.)"
3434 msgstr ""
3435
3436 #. type: TP
3437 #: build/C/man4/console_ioctl.4:647
3438 #, no-wrap
3439 msgid "B<VT_RESIZEX>"
3440 msgstr ""
3441
3442 #. type: Plain text
3443 #: build/C/man4/console_ioctl.4:652
3444 msgid "Set the kernel's idea of various screen parameters.  I<argp> points to a"
3445 msgstr ""
3446
3447 #. type: Plain text
3448 #: build/C/man4/console_ioctl.4:667
3449 #, no-wrap
3450 msgid ""
3451 "struct vt_consize {\n"
3452 "    unsigned short v_rows;  /* number of rows */\n"
3453 "    unsigned short v_cols;  /* number of columns */\n"
3454 "    unsigned short v_vlin;  /* number of pixel rows\n"
3455 "                               on screen */\n"
3456 "    unsigned short v_clin;  /* number of pixel rows\n"
3457 "                               per character */\n"
3458 "    unsigned short v_vcol;  /* number of pixel columns\n"
3459 "                               on screen */\n"
3460 "    unsigned short v_ccol;  /* number of pixel columns\n"
3461 "                               per character */\n"
3462 "};\n"
3463 msgstr ""
3464
3465 #. type: Plain text
3466 #: build/C/man4/console_ioctl.4:676
3467 msgid ""
3468 "Any parameter may be set to zero, indicating \"no change\", but if multiple "
3469 "parameters are set, they must be self-consistent.  Note that this does not "
3470 "change the videomode.  See B<resizecons>(8).  (Since 1.3.3.)"
3471 msgstr ""
3472
3473 #. type: Plain text
3474 #: build/C/man4/console_ioctl.4:683
3475 msgid ""
3476 "The action of the following ioctls depends on the first byte in the struct "
3477 "pointed to by I<argp>, referred to here as the I<subcode>.  These are legal "
3478 "only for the superuser or the owner of the current terminal."
3479 msgstr ""
3480
3481 #. type: TP
3482 #: build/C/man4/console_ioctl.4:683
3483 #, no-wrap
3484 msgid "B<TIOCLINUX, subcode=0>"
3485 msgstr ""
3486
3487 #. type: Plain text
3488 #: build/C/man4/console_ioctl.4:691
3489 msgid ""
3490 "Dump the screen.  Disappeared in 1.1.92.  (With kernel 1.1.92 or later, read "
3491 "from I</dev/vcsN> or I</dev/vcsaN> instead.)"
3492 msgstr ""
3493
3494 #. type: TP
3495 #: build/C/man4/console_ioctl.4:691
3496 #, no-wrap
3497 msgid "B<TIOCLINUX, subcode=1>"
3498 msgstr ""
3499
3500 #. type: Plain text
3501 #: build/C/man4/console_ioctl.4:695
3502 msgid "Get task information.  Disappeared in 1.1.92."
3503 msgstr ""
3504
3505 #. type: TP
3506 #: build/C/man4/console_ioctl.4:695
3507 #, no-wrap
3508 msgid "B<TIOCLINUX, subcode=2>"
3509 msgstr ""
3510
3511 #. type: Plain text
3512 #: build/C/man4/console_ioctl.4:700
3513 msgid "Set selection.  I<argp> points to a"
3514 msgstr ""
3515
3516 #. type: Plain text
3517 #: build/C/man4/console_ioctl.4:708
3518 #, no-wrap
3519 msgid ""
3520 "struct {\n"
3521 "   char  subcode;\n"
3522 "   short xs, ys, xe, ye;\n"
3523 "   short sel_mode;\n"
3524 "};\n"
3525 msgstr ""
3526
3527 #. type: Plain text
3528 #: build/C/man4/console_ioctl.4:728
3529 msgid ""
3530 "I<xs> and I<ys> are the starting column and row.  I<xe> and I<ye> are the "
3531 "ending column and row.  (Upper left corner is row=column=1.)  I<sel_mode> is "
3532 "0 for character-by-character selection, 1 for word-by-word selection, or 2 "
3533 "for line-by-line selection.  The indicated screen characters are highlighted "
3534 "and saved in the static array sel_buffer in I<devices/char/console.c>."
3535 msgstr ""
3536
3537 #. type: TP
3538 #: build/C/man4/console_ioctl.4:728
3539 #, no-wrap
3540 msgid "B<TIOCLINUX, subcode=3>"
3541 msgstr ""
3542
3543 #. type: Plain text
3544 #: build/C/man4/console_ioctl.4:734
3545 msgid ""
3546 "Paste selection.  The characters in the selection buffer are written to "
3547 "I<fd>."
3548 msgstr ""
3549
3550 #. type: TP
3551 #: build/C/man4/console_ioctl.4:734
3552 #, no-wrap
3553 msgid "B<TIOCLINUX, subcode=4>"
3554 msgstr ""
3555
3556 #. type: Plain text
3557 #: build/C/man4/console_ioctl.4:737
3558 msgid "Unblank the screen."
3559 msgstr ""
3560
3561 #. type: TP
3562 #: build/C/man4/console_ioctl.4:737
3563 #, no-wrap
3564 msgid "B<TIOCLINUX, subcode=5>"
3565 msgstr ""
3566
3567 #. type: Plain text
3568 #: build/C/man4/console_ioctl.4:742
3569 msgid ""
3570 "Sets contents of a 256-bit look up table defining characters in a \"word\", "
3571 "for word-by-word selection.  (Since 1.1.32.)"
3572 msgstr ""
3573
3574 #. type: TP
3575 #: build/C/man4/console_ioctl.4:742
3576 #, no-wrap
3577 msgid "B<TIOCLINUX, subcode=6>"
3578 msgstr ""
3579
3580 #. type: Plain text
3581 #: build/C/man4/console_ioctl.4:749
3582 msgid ""
3583 "I<argp> points to a char which is set to the value of the kernel variable "
3584 "I<shift_state>.  (Since 1.1.32.)"
3585 msgstr ""
3586
3587 #. type: TP
3588 #: build/C/man4/console_ioctl.4:749
3589 #, no-wrap
3590 msgid "B<TIOCLINUX, subcode=7>"
3591 msgstr ""
3592
3593 #. type: Plain text
3594 #: build/C/man4/console_ioctl.4:756
3595 msgid ""
3596 "I<argp> points to a char which is set to the value of the kernel variable "
3597 "I<report_mouse>.  (Since 1.1.33.)"
3598 msgstr ""
3599
3600 #. type: TP
3601 #: build/C/man4/console_ioctl.4:756
3602 #, no-wrap
3603 msgid "B<TIOCLINUX, subcode=8>"
3604 msgstr ""
3605
3606 #. type: Plain text
3607 #: build/C/man4/console_ioctl.4:764
3608 msgid ""
3609 "Dump screen width and height, cursor position, and all the "
3610 "character-attribute pairs.  (Kernels 1.1.67 through 1.1.91 only.  With "
3611 "kernel 1.1.92 or later, read from I</dev/vcsa*> instead.)"
3612 msgstr ""
3613
3614 #. type: TP
3615 #: build/C/man4/console_ioctl.4:764
3616 #, no-wrap
3617 msgid "B<TIOCLINUX, subcode=9>"
3618 msgstr ""
3619
3620 #. type: Plain text
3621 #: build/C/man4/console_ioctl.4:772
3622 msgid ""
3623 "Restore screen width and height, cursor position, and all the "
3624 "character-attribute pairs.  (Kernels 1.1.67 through 1.1.91 only.  With "
3625 "kernel 1.1.92 or later, write to I</dev/vcsa*> instead.)"
3626 msgstr ""
3627
3628 #. type: TP
3629 #: build/C/man4/console_ioctl.4:772
3630 #, no-wrap
3631 msgid "B<TIOCLINUX, subcode=10>"
3632 msgstr ""
3633
3634 #. type: Plain text
3635 #: build/C/man4/console_ioctl.4:780
3636 msgid ""
3637 "Handles the Power Saving feature of the new generation of monitors.  VESA "
3638 "screen blanking mode is set to I<argp[1]>, which governs what screen "
3639 "blanking does:"
3640 msgstr ""
3641
3642 #. type: IP
3643 #: build/C/man4/console_ioctl.4:781
3644 #, no-wrap
3645 msgid "0:"
3646 msgstr ""
3647
3648 #. type: Plain text
3649 #: build/C/man4/console_ioctl.4:783
3650 msgid "Screen blanking is disabled."
3651 msgstr ""
3652
3653 #. type: IP
3654 #: build/C/man4/console_ioctl.4:783
3655 #, no-wrap
3656 msgid "1:"
3657 msgstr ""
3658
3659 #. type: Plain text
3660 #: build/C/man4/console_ioctl.4:790
3661 msgid ""
3662 "The current video adapter register settings are saved, then the controller "
3663 "is programmed to turn off the vertical synchronization pulses.  This puts "
3664 "the monitor into \"standby\" mode.  If your monitor has an Off_Mode timer, "
3665 "then it will eventually power down by itself."
3666 msgstr ""
3667
3668 #. type: IP
3669 #: build/C/man4/console_ioctl.4:790
3670 #, no-wrap
3671 msgid "2:"
3672 msgstr ""
3673
3674 #. type: Plain text
3675 #: build/C/man4/console_ioctl.4:800
3676 msgid ""
3677 "The current settings are saved, then both the vertical and horizontal "
3678 "synchronization pulses are turned off.  This puts the monitor into \"off\" "
3679 "mode.  If your monitor has no Off_Mode timer, or if you want your monitor to "
3680 "power down immediately when the blank_timer times out, then you choose this "
3681 "option.  (I<Caution:> Powering down frequently will damage the monitor.)  "
3682 "(Since 1.1.76.)"
3683 msgstr ""
3684
3685 #. type: SH
3686 #: build/C/man4/console_ioctl.4:801 build/C/man3/mkfifo.3:120 build/C/man2/mknod.2:149 build/C/man3/setlogmask.3:69 build/C/man4/st.4:827 build/C/man2/syslog.2:321
3687 #, no-wrap
3688 msgid "RETURN VALUE"
3689 msgstr ""
3690
3691 #. type: Plain text
3692 #: build/C/man4/console_ioctl.4:806
3693 msgid "On success, 0 is returned.  On error, -1 is returned, and I<errno> is set."
3694 msgstr ""
3695
3696 #. type: SH
3697 #: build/C/man4/console_ioctl.4:806 build/C/man3/mkfifo.3:128 build/C/man2/mknod.2:156 build/C/man3/setlogmask.3:71 build/C/man2/syslog.2:337
3698 #, no-wrap
3699 msgid "ERRORS"
3700 msgstr ""
3701
3702 #. type: Plain text
3703 #: build/C/man4/console_ioctl.4:809
3704 msgid "I<errno> may take on these values:"
3705 msgstr ""
3706
3707 #. type: TP
3708 #: build/C/man4/console_ioctl.4:809 build/C/man3/mkfifo.3:168 build/C/man2/mknod.2:230
3709 #, no-wrap
3710 msgid "B<EBADF>"
3711 msgstr ""
3712
3713 #. type: Plain text
3714 #: build/C/man4/console_ioctl.4:812
3715 msgid "The file descriptor is invalid."
3716 msgstr ""
3717
3718 #. type: TP
3719 #: build/C/man4/console_ioctl.4:812
3720 #, no-wrap
3721 msgid "B<ENOTTY>"
3722 msgstr ""
3723
3724 #. type: Plain text
3725 #: build/C/man4/console_ioctl.4:816
3726 msgid ""
3727 "The file descriptor is not associated with a character special device, or "
3728 "the specified request does not apply to it."
3729 msgstr ""
3730
3731 #. type: TP
3732 #: build/C/man4/console_ioctl.4:816 build/C/man2/mknod.2:179 build/C/man4/st.4:842 build/C/man2/syslog.2:338
3733 #, no-wrap
3734 msgid "B<EINVAL>"
3735 msgstr ""
3736
3737 #. type: Plain text
3738 #: build/C/man4/console_ioctl.4:821
3739 msgid "The file descriptor or I<argp> is invalid."
3740 msgstr ""
3741
3742 #. type: TP
3743 #: build/C/man4/console_ioctl.4:821 build/C/man2/mknod.2:209 build/C/man2/syslog.2:362
3744 #, no-wrap
3745 msgid "B<EPERM>"
3746 msgstr ""
3747
3748 #. type: Plain text
3749 #: build/C/man4/console_ioctl.4:824
3750 msgid "Insufficient permission."
3751 msgstr ""
3752
3753 #. type: Plain text
3754 #: build/C/man4/console_ioctl.4:835
3755 msgid ""
3756 "B<Warning>: Do not regard this man page as documentation of the Linux "
3757 "console ioctls.  This is provided for the curious only, as an alternative to "
3758 "reading the source.  Ioctl's are undocumented Linux internals, liable to be "
3759 "changed without warning.  (And indeed, this page more or less describes the "
3760 "situation as of kernel version 1.1.94; there are many minor and not-so-minor "
3761 "differences with earlier versions.)"
3762 msgstr ""
3763
3764 #. type: Plain text
3765 #: build/C/man4/console_ioctl.4:840
3766 msgid ""
3767 "Very often, ioctls are introduced for communication between the kernel and "
3768 "one particular well-known program (fdisk, hdparm, setserial, tunelp, "
3769 "loadkeys, selection, setfont, etc.), and their behavior will be changed when "
3770 "required by this particular program."
3771 msgstr ""
3772
3773 #. type: Plain text
3774 #: build/C/man4/console_ioctl.4:844
3775 msgid ""
3776 "Programs using these ioctls will not be portable to other versions of UNIX, "
3777 "will not work on older versions of Linux, and will not work on future "
3778 "versions of Linux."
3779 msgstr ""
3780
3781 #. type: Plain text
3782 #: build/C/man4/console_ioctl.4:846
3783 msgid "Use POSIX functions."
3784 msgstr ""
3785
3786 #. type: Plain text
3787 #: build/C/man4/console_ioctl.4:870
3788 msgid ""
3789 "B<dumpkeys>(1), B<kbd_mode>(1), B<loadkeys>(1), B<mknod>(1), B<setleds>(1), "
3790 "B<setmetamode>(1), B<execve>(2), B<fcntl>(2), B<ioperm>(2), B<termios>(3), "
3791 "B<console>(4), B<console_codes>(4), B<mt>(4), B<sd>(4), B<tty>(4), "
3792 "B<tty_ioctl>(4), B<ttyS>(4), B<vcs>(4), B<vcsa>(4), B<charsets>(7), "
3793 "B<mapscrn>(8), B<resizecons>(8), B<setfont>(8)"
3794 msgstr ""
3795
3796 #. type: Plain text
3797 #: build/C/man4/console_ioctl.4:872
3798 msgid "I</usr/include/linux/kd.h>, I</usr/include/linux/vt.h>"
3799 msgstr ""
3800
3801 #. type: TH
3802 #: build/C/man5/core.5:25
3803 #, no-wrap
3804 msgid "CORE"
3805 msgstr ""
3806
3807 #. type: TH
3808 #: build/C/man5/core.5:25
3809 #, no-wrap
3810 msgid "2014-08-19"
3811 msgstr ""
3812
3813 #. type: Plain text
3814 #: build/C/man5/core.5:28
3815 msgid "core - core dump file"
3816 msgstr ""
3817
3818 #. type: Plain text
3819 #: build/C/man5/core.5:39
3820 msgid ""
3821 "The default action of certain signals is to cause a process to terminate and "
3822 "produce a I<core dump file>, a disk file containing an image of the "
3823 "process's memory at the time of termination.  This image can be used in a "
3824 "debugger (e.g., B<gdb>(1))  to inspect the state of the program at the time "
3825 "that it terminated.  A list of the signals which cause a process to dump "
3826 "core can be found in B<signal>(7)."
3827 msgstr ""
3828
3829 #. type: Plain text
3830 #: build/C/man5/core.5:46
3831 msgid ""
3832 "A process can set its soft B<RLIMIT_CORE> resource limit to place an upper "
3833 "limit on the size of the core dump file that will be produced if it receives "
3834 "a \"core dump\" signal; see B<getrlimit>(2)  for details."
3835 msgstr ""
3836
3837 #. type: Plain text
3838 #: build/C/man5/core.5:49
3839 msgid "There are various circumstances in which a core dump file is not produced:"
3840 msgstr ""
3841
3842 #. type: Plain text
3843 #: build/C/man5/core.5:66
3844 msgid ""
3845 "The process does not have permission to write the core file.  (By default, "
3846 "the core file is called I<core> or I<core.pid>, where I<pid> is the ID of "
3847 "the process that dumped core, and is created in the current working "
3848 "directory.  See below for details on naming.)  Writing the core file will "
3849 "fail if the directory in which it is to be created is nonwritable, or if a "
3850 "file with the same name exists and is not writable or is not a regular file "
3851 "(e.g., it is a directory or a symbolic link)."
3852 msgstr ""
3853
3854 #. type: Plain text
3855 #: build/C/man5/core.5:70
3856 msgid ""
3857 "A (writable, regular) file with the same name as would be used for the core "
3858 "dump already exists, but there is more than one hard link to that file."
3859 msgstr ""
3860
3861 #. type: Plain text
3862 #: build/C/man5/core.5:74
3863 msgid ""
3864 "The filesystem where the core dump file would be created is full; or has run "
3865 "out of inodes; or is mounted read-only; or the user has reached their quota "
3866 "for the filesystem."
3867 msgstr ""
3868
3869 #. type: Plain text
3870 #: build/C/man5/core.5:77
3871 msgid "The directory in which the core dump file is to be created does not exist."
3872 msgstr ""
3873
3874 #. type: Plain text
3875 #: build/C/man5/core.5:90
3876 msgid ""
3877 "The B<RLIMIT_CORE> (core file size) or B<RLIMIT_FSIZE> (file size) resource "
3878 "limits for the process are set to zero; see B<getrlimit>(2)  and the "
3879 "documentation of the shell's I<ulimit> command (I<limit> in B<csh>(1))."
3880 msgstr ""
3881
3882 #. type: Plain text
3883 #: build/C/man5/core.5:93
3884 msgid ""
3885 "The binary being executed by the process does not have read permission "
3886 "enabled."
3887 msgstr ""
3888
3889 #.  FIXME . Perhaps relocate discussion of /proc/sys/fs/suid_dumpable
3890 #.  and PR_SET_DUMPABLE to this page?
3891 #. type: Plain text
3892 #: build/C/man5/core.5:106
3893 msgid ""
3894 "The process is executing a set-user-ID (set-group-ID) program that is owned "
3895 "by a user (group) other than the real user (group)  ID of the process.  "
3896 "(However, see the description of the B<prctl>(2)  B<PR_SET_DUMPABLE> "
3897 "operation, and the description of the I</proc/sys/fs/suid_dumpable> file in "
3898 "B<proc>(5).)"
3899 msgstr ""
3900
3901 #.  commit 046d662f481830e652ac34cd112249adde16452a
3902 #. type: Plain text
3903 #: build/C/man5/core.5:112
3904 msgid ""
3905 "(Since Linux 3.7)  The kernel was configured without the B<CONFIG_COREDUMP> "
3906 "option."
3907 msgstr ""
3908
3909 #. type: Plain text
3910 #: build/C/man5/core.5:118
3911 msgid ""
3912 "In addition, a core dump may exclude part of the address space of the "
3913 "process if the B<madvise>(2)  B<MADV_DONTDUMP> flag was employed."
3914 msgstr ""
3915
3916 #. type: SS
3917 #: build/C/man5/core.5:118
3918 #, no-wrap
3919 msgid "Naming of core dump files"
3920 msgstr ""
3921
3922 #. type: Plain text
3923 #: build/C/man5/core.5:127
3924 msgid ""
3925 "By default, a core dump file is named I<core>, but the "
3926 "I</proc/sys/kernel/core_pattern> file (since Linux 2.6 and 2.4.21)  can be "
3927 "set to define a template that is used to name core dump files.  The template "
3928 "can contain % specifiers which are substituted by the following values when "
3929 "a core file is created:"
3930 msgstr ""
3931
3932 #. type: TP
3933 #: build/C/man5/core.5:130
3934 #, no-wrap
3935 msgid "%%"
3936 msgstr ""
3937
3938 #. type: Plain text
3939 #: build/C/man5/core.5:133
3940 msgid "a single % character"
3941 msgstr ""
3942
3943 #. type: TP
3944 #: build/C/man5/core.5:133
3945 #, no-wrap
3946 msgid "%c"
3947 msgstr ""
3948
3949 #. type: Plain text
3950 #: build/C/man5/core.5:136
3951 msgid "core file size soft resource limit of crashing process (since Linux 2.6.24)"
3952 msgstr ""
3953
3954 #. type: TP
3955 #: build/C/man5/core.5:136
3956 #, no-wrap
3957 msgid "%d"
3958 msgstr ""
3959
3960 #.  Added in git commit 12a2b4b2241e318b4f6df31228e4272d2c2968a1
3961 #. type: Plain text
3962 #: build/C/man5/core.5:143
3963 msgid ""
3964 "dump mode\\(emsame as value returned by B<prctl>(2)  B<PR_GET_DUMPABLE> "
3965 "(since Linux 3.7)"
3966 msgstr ""
3967
3968 #. type: TP
3969 #: build/C/man5/core.5:143
3970 #, no-wrap
3971 msgid "%e"
3972 msgstr ""
3973
3974 #. type: Plain text
3975 #: build/C/man5/core.5:146
3976 msgid "executable filename (without path prefix)"
3977 msgstr ""
3978
3979 #. type: TP
3980 #: build/C/man5/core.5:146
3981 #, no-wrap
3982 msgid "%E"
3983 msgstr ""
3984
3985 #. type: Plain text
3986 #: build/C/man5/core.5:151
3987 msgid ""
3988 "pathname of executable, with slashes (\\(aq/\\(aq) replaced by exclamation "
3989 "marks (\\(aq!\\(aq)  (since Linux 3.0)."
3990 msgstr ""
3991
3992 #. type: TP
3993 #: build/C/man5/core.5:151
3994 #, no-wrap
3995 msgid "%g"
3996 msgstr ""
3997
3998 #. type: Plain text
3999 #: build/C/man5/core.5:154
4000 msgid "(numeric) real GID of dumped process"
4001 msgstr ""
4002
4003 #. type: TP
4004 #: build/C/man5/core.5:154
4005 #, no-wrap
4006 msgid "%h"
4007 msgstr ""
4008
4009 #. type: Plain text
4010 #: build/C/man5/core.5:157
4011 msgid "hostname (same as I<nodename> returned by B<uname>(2))"
4012 msgstr ""
4013
4014 #. type: TP
4015 #: build/C/man5/core.5:157
4016 #, no-wrap
4017 msgid "%p"
4018 msgstr ""
4019
4020 #. type: Plain text
4021 #: build/C/man5/core.5:161
4022 msgid ""
4023 "PID of dumped process, as seen in the PID namespace in which the process "
4024 "resides"
4025 msgstr ""
4026
4027 #. type: TP
4028 #: build/C/man5/core.5:161
4029 #, no-wrap
4030 msgid "%P"
4031 msgstr ""
4032
4033 #.  Added in git commit 65aafb1e7484b7434a0c1d4c593191ebe5776a2f
4034 #. type: Plain text
4035 #: build/C/man5/core.5:166
4036 msgid ""
4037 "PID of dumped process, as seen in the initial PID namespace (since Linux "
4038 "3.12)"
4039 msgstr ""
4040
4041 #. type: TP
4042 #: build/C/man5/core.5:166
4043 #, no-wrap
4044 msgid "%s"
4045 msgstr ""
4046
4047 #. type: Plain text
4048 #: build/C/man5/core.5:169
4049 msgid "number of signal causing dump"
4050 msgstr ""
4051
4052 #. type: TP
4053 #: build/C/man5/core.5:169
4054 #, no-wrap
4055 msgid "%t"
4056 msgstr ""
4057
4058 #. type: Plain text
4059 #: build/C/man5/core.5:173
4060 msgid ""
4061 "time of dump, expressed as seconds since the Epoch, 1970-01-01 00:00:00 "
4062 "+0000 (UTC)"
4063 msgstr ""
4064
4065 #. type: TP
4066 #: build/C/man5/core.5:173
4067 #, no-wrap
4068 msgid "%u"
4069 msgstr ""
4070
4071 #. type: Plain text
4072 #: build/C/man5/core.5:176
4073 msgid "(numeric) real UID of dumped process"
4074 msgstr ""
4075
4076 #. type: Plain text
4077 #: build/C/man5/core.5:195
4078 msgid ""
4079 "A single % at the end of the template is dropped from the core filename, as "
4080 "is the combination of a % followed by any character other than those listed "
4081 "above.  All other characters in the template become a literal part of the "
4082 "core filename.  The template may include \\(aq/\\(aq characters, which are "
4083 "interpreted as delimiters for directory names.  The maximum size of the "
4084 "resulting core filename is 128 bytes (64 bytes in kernels before 2.6.19).  "
4085 "The default value in this file is \"core\".  For backward compatibility, if "
4086 "I</proc/sys/kernel/core_pattern> does not include \"%p\" and "
4087 "I</proc/sys/kernel/core_uses_pid> (see below)  is nonzero, then .PID will be "
4088 "appended to the core filename."
4089 msgstr ""
4090
4091 #. type: Plain text
4092 #: build/C/man5/core.5:206
4093 msgid ""
4094 "Since version 2.4, Linux has also provided a more primitive method of "
4095 "controlling the name of the core dump file.  If the "
4096 "I</proc/sys/kernel/core_uses_pid> file contains the value 0, then a core "
4097 "dump file is simply named I<core>.  If this file contains a nonzero value, "
4098 "then the core dump file includes the process ID in a name of the form "
4099 "I<core.PID>."
4100 msgstr ""
4101
4102 #.  9520628e8ceb69fa9a4aee6b57f22675d9e1b709
4103 #. type: Plain text
4104 #: build/C/man5/core.5:213
4105 msgid ""
4106 "Since Linux 3.6, if I</proc/sys/fs/suid_dumpable> is set to 2 "
4107 "(\"suidsafe\"), the pattern must be either an absolute pathname (starting "
4108 "with a leading \\(aq/\\(aq character) or a pipe, as defined below."
4109 msgstr ""
4110
4111 #. type: SS
4112 #: build/C/man5/core.5:213
4113 #, no-wrap
4114 msgid "Piping core dumps to a program"
4115 msgstr ""
4116
4117 #. type: Plain text
4118 #: build/C/man5/core.5:223
4119 msgid ""
4120 "Since kernel 2.6.19, Linux supports an alternate syntax for the "
4121 "I</proc/sys/kernel/core_pattern> file.  If the first character of this file "
4122 "is a pipe symbol (B<|>), then the remainder of the line is interpreted as a "
4123 "program to be executed.  Instead of being written to a disk file, the core "
4124 "dump is given as standard input to the program.  Note the following points:"
4125 msgstr ""
4126
4127 #. type: Plain text
4128 #: build/C/man5/core.5:227
4129 msgid ""
4130 "The program must be specified using an absolute pathname (or a pathname "
4131 "relative to the root directory, I</>), and must immediately follow the '|' "
4132 "character."
4133 msgstr ""
4134
4135 #. type: Plain text
4136 #: build/C/man5/core.5:230
4137 msgid "The process created to run the program runs as user and group I<root>."
4138 msgstr ""
4139
4140 #. type: Plain text
4141 #: build/C/man5/core.5:234
4142 msgid ""
4143 "Command-line arguments can be supplied to the program (since Linux 2.6.24), "
4144 "delimited by white space (up to a total line length of 128 bytes)."
4145 msgstr ""
4146
4147 #. type: Plain text
4148 #: build/C/man5/core.5:240
4149 msgid ""
4150 "The command-line arguments can include any of the % specifiers listed "
4151 "above.  For example, to pass the PID of the process that is being dumped, "
4152 "specify I<%p> in an argument."
4153 msgstr ""
4154
4155 #. type: SS
4156 #: build/C/man5/core.5:240
4157 #, no-wrap
4158 msgid "Controlling which mappings are written to the core dump"
4159 msgstr ""
4160
4161 #. type: Plain text
4162 #: build/C/man5/core.5:246
4163 msgid ""
4164 "Since kernel 2.6.23, the Linux-specific I</proc/PID/coredump_filter> file "
4165 "can be used to control which memory segments are written to the core dump "
4166 "file in the event that a core dump is performed for the process with the "
4167 "corresponding process ID."
4168 msgstr ""
4169
4170 #. type: Plain text
4171 #: build/C/man5/core.5:252
4172 msgid ""
4173 "The value in the file is a bit mask of memory mapping types (see "
4174 "B<mmap>(2)).  If a bit is set in the mask, then memory mappings of the "
4175 "corresponding type are dumped; otherwise they are not dumped.  The bits in "
4176 "this file have the following meanings:"
4177 msgstr ""
4178
4179 #. type: TP
4180 #: build/C/man5/core.5:255
4181 #, no-wrap
4182 msgid "bit 0"
4183 msgstr ""
4184
4185 #. type: Plain text
4186 #: build/C/man5/core.5:258
4187 msgid "Dump anonymous private mappings."
4188 msgstr ""
4189
4190 #. type: TP
4191 #: build/C/man5/core.5:258
4192 #, no-wrap
4193 msgid "bit 1"
4194 msgstr ""
4195
4196 #. type: Plain text
4197 #: build/C/man5/core.5:261
4198 msgid "Dump anonymous shared mappings."
4199 msgstr ""
4200
4201 #. type: TP
4202 #: build/C/man5/core.5:261
4203 #, no-wrap
4204 msgid "bit 2"
4205 msgstr ""
4206
4207 #. type: Plain text
4208 #: build/C/man5/core.5:264
4209 msgid "Dump file-backed private mappings."
4210 msgstr ""
4211
4212 #. type: TP
4213 #: build/C/man5/core.5:264
4214 #, no-wrap
4215 msgid "bit 3"
4216 msgstr ""
4217
4218 #.  file-backed shared mappings of course also update the underlying
4219 #.  mapped file.
4220 #. type: Plain text
4221 #: build/C/man5/core.5:269
4222 msgid "Dump file-backed shared mappings."
4223 msgstr ""
4224
4225 #. type: TP
4226 #: build/C/man5/core.5:269
4227 #, no-wrap
4228 msgid "bit 4 (since Linux 2.6.24)"
4229 msgstr ""
4230
4231 #. type: Plain text
4232 #: build/C/man5/core.5:272
4233 msgid "Dump ELF headers."
4234 msgstr ""
4235
4236 #. type: TP
4237 #: build/C/man5/core.5:272
4238 #, no-wrap
4239 msgid "bit 5 (since Linux 2.6.28)"
4240 msgstr ""
4241
4242 #. type: Plain text
4243 #: build/C/man5/core.5:275
4244 msgid "Dump private huge pages."
4245 msgstr ""
4246
4247 #. type: TP
4248 #: build/C/man5/core.5:275
4249 #, no-wrap
4250 msgid "bit 6 (since Linux 2.6.28)"
4251 msgstr ""
4252
4253 #. type: Plain text
4254 #: build/C/man5/core.5:278
4255 msgid "Dump shared huge pages."
4256 msgstr ""
4257
4258 #. type: Plain text
4259 #: build/C/man5/core.5:286
4260 msgid ""
4261 "By default, the following bits are set: 0, 1, 4 (if the "
4262 "B<CONFIG_CORE_DUMP_DEFAULT_ELF_HEADERS> kernel configuration option is "
4263 "enabled), and 5.  The value of this file is displayed in hexadecimal.  (The "
4264 "default value is thus displayed as 33.)"
4265 msgstr ""
4266
4267 #. type: Plain text
4268 #: build/C/man5/core.5:291
4269 msgid ""
4270 "Memory-mapped I/O pages such as frame buffer are never dumped, and virtual "
4271 "DSO pages are always dumped, regardless of the I<coredump_filter> value."
4272 msgstr ""
4273
4274 #. type: Plain text
4275 #: build/C/man5/core.5:301
4276 msgid ""
4277 "A child process created via B<fork>(2)  inherits its parent's "
4278 "I<coredump_filter> value; the I<coredump_filter> value is preserved across "
4279 "an B<execve>(2)."
4280 msgstr ""
4281
4282 #. type: Plain text
4283 #: build/C/man5/core.5:305
4284 msgid ""
4285 "It can be useful to set I<coredump_filter> in the parent shell before "
4286 "running a program, for example:"
4287 msgstr ""
4288
4289 #. type: Plain text
4290 #: build/C/man5/core.5:310
4291 #, no-wrap
4292 msgid ""
4293 "$B< echo 0x7 E<gt> /proc/self/coredump_filter>\n"
4294 "$B< ./some_program>\n"
4295 msgstr ""
4296
4297 #. type: Plain text
4298 #: build/C/man5/core.5:316
4299 msgid ""
4300 "This file is provided only if the kernel was built with the "
4301 "B<CONFIG_ELF_CORE> configuration option."
4302 msgstr ""
4303
4304 #. type: Plain text
4305 #: build/C/man5/core.5:321
4306 msgid ""
4307 "The B<gdb>(1)  I<gcore> command can be used to obtain a core dump of a "
4308 "running process."
4309 msgstr ""
4310
4311 #.  Changed with commit 6409324b385f3f63a03645b4422e3be67348d922
4312 #.  Always including the PID in the name of the core file made
4313 #.  sense for LinuxThreads, where each thread had a unique PID,
4314 #.  but doesn't seem to serve any purpose with NPTL, where all the
4315 #.  threads in a process share the same PID (as POSIX.1 requires).
4316 #.  Probably the behavior is maintained so that applications using
4317 #.  LinuxThreads continue appending the PID (the kernel has no easy
4318 #.  way of telling which threading implementation the user-space
4319 #.  application is using). -- mtk, April 2006
4320 #. type: Plain text
4321 #: build/C/man5/core.5:344
4322 msgid ""
4323 "In Linux versions up to and including 2.6.27, if a multithreaded process "
4324 "(or, more precisely, a process that shares its memory with another process "
4325 "by being created with the B<CLONE_VM> flag of B<clone>(2))  dumps core, then "
4326 "the process ID is always appended to the core filename, unless the process "
4327 "ID was already included elsewhere in the filename via a %p specification in "
4328 "I</proc/sys/kernel/core_pattern>.  (This is primarily useful when employing "
4329 "the obsolete LinuxThreads implementation, where each thread of a process has "
4330 "a different PID.)"
4331 msgstr ""
4332
4333 #. type: SH
4334 #: build/C/man5/core.5:344 build/C/man3/gnu_get_libc_version.3:51 build/C/man3/stdarg.3:300 build/C/man4/vcs.4:101
4335 #, no-wrap
4336 msgid "EXAMPLE"
4337 msgstr ""
4338
4339 #. type: Plain text
4340 #: build/C/man5/core.5:352
4341 msgid ""
4342 "The program below can be used to demonstrate the use of the pipe syntax in "
4343 "the I</proc/sys/kernel/core_pattern> file.  The following shell session "
4344 "demonstrates the use of this program (compiled to create an executable named "
4345 "I<core_pattern_pipe_test>):"
4346 msgstr ""
4347
4348 #. type: Plain text
4349 #: build/C/man5/core.5:373
4350 #, no-wrap
4351 msgid ""
4352 "$B< cc -o core_pattern_pipe_test core_pattern_pipe_test.c>\n"
4353 "$B< su>\n"
4354 "Password:\n"
4355 "#B< echo \"|$PWD/core_pattern_pipe_test %p UID=%u GID=%g sig=%s\" E<gt> "
4356 "\\e>\n"
4357 "B</proc/sys/kernel/core_pattern>\n"
4358 "#B< exit>\n"
4359 "$B< sleep 100>\n"
4360 "B<^\\e>                     # type control-backslash\n"
4361 "Quit (core dumped)\n"
4362 "$B< cat core.info>\n"
4363 "argc=5\n"
4364 "argc[0]=E<lt>/home/mtk/core_pattern_pipe_testE<gt>\n"
4365 "argc[1]=E<lt>20575E<gt>\n"
4366 "argc[2]=E<lt>UID=1000E<gt>\n"
4367 "argc[3]=E<lt>GID=100E<gt>\n"
4368 "argc[4]=E<lt>sig=3E<gt>\n"
4369 "Total bytes in core dump: 282624\n"
4370 msgstr ""
4371
4372 #. type: SS
4373 #: build/C/man5/core.5:375 build/C/man3/gnu_get_libc_version.3:61
4374 #, no-wrap
4375 msgid "Program source"
4376 msgstr ""
4377
4378 #. type: Plain text
4379 #: build/C/man5/core.5:379
4380 #, no-wrap
4381 msgid "/* core_pattern_pipe_test.c */\n"
4382 msgstr ""
4383
4384 #. type: Plain text
4385 #: build/C/man5/core.5:387
4386 #, no-wrap
4387 msgid ""
4388 "#define _GNU_SOURCE\n"
4389 "#include E<lt>sys/stat.hE<gt>\n"
4390 "#include E<lt>fcntl.hE<gt>\n"
4391 "#include E<lt>limits.hE<gt>\n"
4392 "#include E<lt>stdio.hE<gt>\n"
4393 "#include E<lt>stdlib.hE<gt>\n"
4394 "#include E<lt>unistd.hE<gt>\n"
4395 msgstr ""
4396
4397 #. type: Plain text
4398 #: build/C/man5/core.5:389
4399 #, no-wrap
4400 msgid "#define BUF_SIZE 1024\n"
4401 msgstr ""
4402
4403 #. type: Plain text
4404 #: build/C/man5/core.5:398
4405 #, no-wrap
4406 msgid ""
4407 "int\n"
4408 "main(int argc, char *argv[])\n"
4409 "{\n"
4410 "    int tot, j;\n"
4411 "    ssize_t nread;\n"
4412 "    char buf[BUF_SIZE];\n"
4413 "    FILE *fp;\n"
4414 "    char cwd[PATH_MAX];\n"
4415 msgstr ""
4416
4417 #. type: Plain text
4418 #: build/C/man5/core.5:401
4419 #, no-wrap
4420 msgid ""
4421 "    /* Change our current working directory to that of the\n"
4422 "       crashing process */\n"
4423 msgstr ""
4424
4425 #. type: Plain text
4426 #: build/C/man5/core.5:404
4427 #, no-wrap
4428 msgid ""
4429 "    snprintf(cwd, PATH_MAX, \"/proc/%s/cwd\", argv[1]);\n"
4430 "    chdir(cwd);\n"
4431 msgstr ""
4432
4433 #. type: Plain text
4434 #: build/C/man5/core.5:406
4435 #, no-wrap
4436 msgid "    /* Write output to file \"core.info\" in that directory */\n"
4437 msgstr ""
4438
4439 #. type: Plain text
4440 #: build/C/man5/core.5:410
4441 #, no-wrap
4442 msgid ""
4443 "    fp = fopen(\"core.info\", \"w+\");\n"
4444 "    if (fp == NULL)\n"
4445 "        exit(EXIT_FAILURE);\n"
4446 msgstr ""
4447
4448 #. type: Plain text
4449 #: build/C/man5/core.5:413
4450 #, no-wrap
4451 msgid ""
4452 "    /* Display command-line arguments given to core_pattern\n"
4453 "       pipe program */\n"
4454 msgstr ""
4455
4456 #. type: Plain text
4457 #: build/C/man5/core.5:417
4458 #, no-wrap
4459 msgid ""
4460 "    fprintf(fp, \"argc=%d\\en\", argc);\n"
4461 "    for (j = 0; j E<lt> argc; j++)\n"
4462 "        fprintf(fp, \"argc[%d]=E<lt>%sE<gt>\\en\", j, argv[j]);\n"
4463 msgstr ""
4464
4465 #. type: Plain text
4466 #: build/C/man5/core.5:419
4467 #, no-wrap
4468 msgid "    /* Count bytes in standard input (the core dump) */\n"
4469 msgstr ""
4470
4471 #. type: Plain text
4472 #: build/C/man5/core.5:424
4473 #, no-wrap
4474 msgid ""
4475 "    tot = 0;\n"
4476 "    while ((nread = read(STDIN_FILENO, buf, BUF_SIZE)) E<gt> 0)\n"
4477 "        tot += nread;\n"
4478 "    fprintf(fp, \"Total bytes in core dump: %d\\en\", tot);\n"
4479 msgstr ""
4480
4481 #. type: Plain text
4482 #: build/C/man5/core.5:428
4483 #, no-wrap
4484 msgid ""
4485 "    fclose(fp);\n"
4486 "    exit(EXIT_SUCCESS);\n"
4487 "}\n"
4488 msgstr ""
4489
4490 #. type: Plain text
4491 #: build/C/man5/core.5:439
4492 msgid ""
4493 "B<bash>(1), B<gdb>(1), B<getrlimit>(2), B<mmap>(2), B<prctl>(2), "
4494 "B<sigaction>(2), B<elf>(5), B<proc>(5), B<pthreads>(7), B<signal>(7)"
4495 msgstr ""
4496
4497 #. type: TH
4498 #: build/C/man4/cpuid.4:26
4499 #, no-wrap
4500 msgid "CPUID"
4501 msgstr ""
4502
4503 #. type: TH
4504 #: build/C/man4/cpuid.4:26 build/C/man4/msr.4:26
4505 #, no-wrap
4506 msgid "2009-03-31"
4507 msgstr ""
4508
4509 #. type: Plain text
4510 #: build/C/man4/cpuid.4:29
4511 msgid "cpuid - x86 CPUID access device"
4512 msgstr ""
4513
4514 #. type: Plain text
4515 #: build/C/man4/cpuid.4:31
4516 msgid "CPUID provides an interface for querying information about the x86 CPU."
4517 msgstr ""
4518
4519 #. type: Plain text
4520 #: build/C/man4/cpuid.4:38
4521 msgid ""
4522 "This device is accessed by B<lseek>(2)  or B<pread>(2)  to the appropriate "
4523 "CPUID level and reading in chunks of 16 bytes.  A larger read size means "
4524 "multiple reads of consecutive levels."
4525 msgstr ""
4526
4527 #. type: Plain text
4528 #: build/C/man4/cpuid.4:47
4529 msgid ""
4530 "The lower 32 bits of the file position is used as the incoming I<%eax>, and "
4531 "the upper 32 bits of the file position as the incoming I<%ecx>, the latter "
4532 "intended for \"counting\" I<eax> levels like I<eax=4>."
4533 msgstr ""
4534
4535 #. type: Plain text
4536 #: build/C/man4/cpuid.4:57
4537 msgid ""
4538 "This driver uses I</dev/cpu/CPUNUM/cpuid>, where I<CPUNUM> is the minor "
4539 "number, and on an SMP box will direct the access to CPU I<CPUNUM> as listed "
4540 "in I</proc/cpuinfo>."
4541 msgstr ""
4542
4543 #. type: Plain text
4544 #: build/C/man4/cpuid.4:62
4545 msgid ""
4546 "This file is protected so that it can be read only by the user I<root>, or "
4547 "members of the group I<root>."
4548 msgstr ""
4549
4550 #. type: Plain text
4551 #: build/C/man4/cpuid.4:67
4552 msgid ""
4553 "The CPUID instruction can be directly executed by a program using inline "
4554 "assembler.  However this device allows convenient access to all CPUs without "
4555 "changing process affinity."
4556 msgstr ""
4557
4558 #. type: Plain text
4559 #: build/C/man4/cpuid.4:76
4560 msgid ""
4561 "Most of the information in I<cpuid> is reported by the kernel in cooked form "
4562 "either in I</proc/cpuinfo> or through subdirectories in "
4563 "I</sys/devices/system/cpu>.  Direct CPUID access through this device should "
4564 "only be used in exceptional cases."
4565 msgstr ""
4566
4567 #. type: Plain text
4568 #: build/C/man4/cpuid.4:82
4569 msgid ""
4570 "The I<cpuid> driver is not auto-loaded.  On modular kernels you might need "
4571 "to use the following command to load it explicitly before use:"
4572 msgstr ""
4573
4574 #. type: Plain text
4575 #: build/C/man4/cpuid.4:84
4576 #, no-wrap
4577 msgid "     $ I<modprobe cpuid>\n"
4578 msgstr ""
4579
4580 #. type: Plain text
4581 #: build/C/man4/cpuid.4:87
4582 msgid ""
4583 "There is no support for CPUID functions that require additional input "
4584 "registers."
4585 msgstr ""
4586
4587 #. type: Plain text
4588 #: build/C/man4/cpuid.4:89
4589 msgid "Very old x86 CPUs don't support CPUID."
4590 msgstr ""
4591
4592 #. type: Plain text
4593 #: build/C/man4/cpuid.4:93
4594 msgid ""
4595 "Intel Corporation, Intel 64 and IA-32 Architectures Software Developer's "
4596 "Manual Volume 2A: Instruction Set Reference, A-M, 3-180 CPUID reference."
4597 msgstr ""
4598
4599 #. type: Plain text
4600 #: build/C/man4/cpuid.4:95
4601 msgid ""
4602 "Intel Corporation, Intel Processor Identification and the CPUID Instruction, "
4603 "Application note 485."
4604 msgstr ""
4605
4606 #. type: TH
4607 #: build/C/man4/dsp56k.4:27
4608 #, no-wrap
4609 msgid "DSP56K"
4610 msgstr ""
4611
4612 #. type: Plain text
4613 #: build/C/man4/dsp56k.4:30
4614 msgid "dsp56k - DSP56001 interface device"
4615 msgstr ""
4616
4617 #. type: Plain text
4618 #: build/C/man4/dsp56k.4:33
4619 #, no-wrap
4620 msgid "#include E<lt>asm/dsp56k.hE<gt>\n"
4621 msgstr ""
4622
4623 #. type: Plain text
4624 #: build/C/man4/dsp56k.4:36
4625 #, no-wrap
4626 msgid ""
4627 "B<ssize_t read(int >I<fd>B<, void *>I<data>B<, size_t >I<length>B<);>\n"
4628 "B<ssize_t write(int >I<fd>B<, void *>I<data>B<, size_t >I<length>B<);>\n"
4629 msgstr ""
4630
4631 #. type: Plain text
4632 #: build/C/man4/dsp56k.4:42
4633 #, no-wrap
4634 msgid ""
4635 "B<int ioctl(int >I<fd>B<, DSP56K_UPLOAD, struct dsp56k_upload "
4636 "*>I<program>B<);>\n"
4637 "B<int ioctl(int >I<fd>B<, DSP56K_SET_TX_WSIZE, int >I<wsize>B<);>\n"
4638 "B<int ioctl(int >I<fd>B<, DSP56K_SET_RX_WSIZE, int >I<wsize>B<);>\n"
4639 "B<int ioctl(int >I<fd>B<, DSP56K_HOST_FLAGS, struct dsp56k_host_flags "
4640 "*>I<flags>B<);>\n"
4641 "B<int ioctl(int >I<fd>B<, DSP56K_HOST_CMD, int >I<cmd>B<);>\n"
4642 msgstr ""
4643
4644 #. type: SH
4645 #: build/C/man4/dsp56k.4:43 build/C/man4/fd.4:31 build/C/man4/full.4:29 build/C/man4/initrd.4:38 build/C/man4/lp.4:32 build/C/man4/mouse.4:29 build/C/man4/sd.4:34
4646 #, no-wrap
4647 msgid "CONFIGURATION"
4648 msgstr ""
4649
4650 #. type: Plain text
4651 #: build/C/man4/dsp56k.4:46
4652 msgid ""
4653 "The dsp56k device is a character device with major number 55 and minor "
4654 "number 0."
4655 msgstr ""
4656
4657 #. type: Plain text
4658 #: build/C/man4/dsp56k.4:52
4659 msgid ""
4660 "The Motorola DSP56001 is a fully programmable 24-bit digital signal "
4661 "processor found in Atari Falcon030-compatible computers.  The I<dsp56k> "
4662 "special file is used to control the DSP56001, and to send and receive data "
4663 "using the bidirectional handshaked host port."
4664 msgstr ""
4665
4666 #. type: Plain text
4667 #: build/C/man4/dsp56k.4:62
4668 msgid ""
4669 "To send a data stream to the signal processor, use B<write>(2)  to the "
4670 "device, and B<read>(2)  to receive processed data.  The data can be sent or "
4671 "received in 8, 16, 24, or 32-bit quantities on the host side, but will "
4672 "always be seen as 24-bit quantities in the DSP56001."
4673 msgstr ""
4674
4675 #. type: Plain text
4676 #: build/C/man4/dsp56k.4:67
4677 msgid "The following B<ioctl>(2)  calls are used to control the I<dsp56k> device:"
4678 msgstr ""
4679
4680 #. type: IP
4681 #: build/C/man4/dsp56k.4:67
4682 #, no-wrap
4683 msgid "B<DSP56K_UPLOAD>"
4684 msgstr ""
4685
4686 #. type: Plain text
4687 #: build/C/man4/dsp56k.4:74
4688 msgid ""
4689 "resets the DSP56001 and uploads a program.  The third B<ioctl>(2)  argument "
4690 "must be a pointer to a I<struct dsp56k_binary> with members I<bin> pointing "
4691 "to a DSP56001 binary program, and I<len> set to the length of the program, "
4692 "counted in 24-bit words."
4693 msgstr ""
4694
4695 #. type: IP
4696 #: build/C/man4/dsp56k.4:74
4697 #, no-wrap
4698 msgid "B<DSP56K_SET_TX_WSIZE>"
4699 msgstr ""
4700
4701 #. type: Plain text
4702 #: build/C/man4/dsp56k.4:82
4703 msgid ""
4704 "sets the transmit word size.  Allowed values are in the range 1 to 4, and is "
4705 "the number of bytes that will be sent at a time to the DSP56001.  These data "
4706 "quantities will either be padded with zero bytes, or truncated to fit the "
4707 "native 24-bit data format of the DSP56001."
4708 msgstr ""
4709
4710 #. type: IP
4711 #: build/C/man4/dsp56k.4:82
4712 #, no-wrap
4713 msgid "B<DSP56K_SET_RX_WSIZE>"
4714 msgstr ""
4715
4716 #. type: Plain text
4717 #: build/C/man4/dsp56k.4:89
4718 msgid ""
4719 "sets the receive word size.  Allowed values are in the range 1 to 4, and is "
4720 "the number of bytes that will be received at a time from the DSP56001.  "
4721 "These data quantities will either truncated, or padded with a null byte "
4722 "(\\(aq\\e0\\(aq) to fit the native 24-bit data format of the DSP56001."
4723 msgstr ""
4724
4725 #. type: IP
4726 #: build/C/man4/dsp56k.4:89
4727 #, no-wrap
4728 msgid "B<DSP56K_HOST_FLAGS>"
4729 msgstr ""
4730
4731 #. type: Plain text
4732 #: build/C/man4/dsp56k.4:96
4733 msgid ""
4734 "read and write the host flags.  The host flags are four general-purpose bits "
4735 "that can be read by both the hosting computer and the DSP56001.  Bits 0 and "
4736 "1 can be written by the host, and bits 2 and 3 can be written by the "
4737 "DSP56001."
4738 msgstr ""
4739
4740 #. type: Plain text
4741 #: build/C/man4/dsp56k.4:106
4742 msgid ""
4743 "To access the host flags, the third B<ioctl>(2)  argument must be a pointer "
4744 "to a I<struct dsp56k_host_flags>.  If bit 0 or 1 is set in the I<dir> "
4745 "member, the corresponding bit in I<out> will be written to the host flags.  "
4746 "The state of all host flags will be returned in the lower four bits of the "
4747 "I<status> member."
4748 msgstr ""
4749
4750 #. type: IP
4751 #: build/C/man4/dsp56k.4:106
4752 #, no-wrap
4753 msgid "B<DSP56K_HOST_CMD>"
4754 msgstr ""
4755
4756 #. type: Plain text
4757 #: build/C/man4/dsp56k.4:110
4758 msgid ""
4759 "sends a host command.  Allowed values are in the range 0 to 31, and is a "
4760 "user-defined command handled by the program running in the DSP56001."
4761 msgstr ""
4762
4763 #.  .SH AUTHORS
4764 #.  Fredrik Noring <noring@nocrew.org>, lars brinkhoff <lars@nocrew.org>,
4765 #.  Tomas Berndtsson <tomas@nocrew.org>.
4766 #. type: Plain text
4767 #: build/C/man4/dsp56k.4:115
4768 msgid "/dev/dsp56k"
4769 msgstr ""
4770
4771 #. type: Plain text
4772 #: build/C/man4/dsp56k.4:120
4773 msgid ""
4774 "I<linux/include/asm-m68k/dsp56k.h>, I<linux/drivers/char/dsp56k.c>, E<.UR "
4775 "http://dsp56k.nocrew.org/> E<.UE ,> DSP56000/DSP56001 Digital Signal "
4776 "Processor User's Manual"
4777 msgstr ""
4778
4779 #. type: TH
4780 #: build/C/man4/fd.4:28
4781 #, no-wrap
4782 msgid "FD"
4783 msgstr ""
4784
4785 #. type: TH
4786 #: build/C/man4/fd.4:28
4787 #, no-wrap
4788 msgid "2014-05-10"
4789 msgstr ""
4790
4791 #. type: Plain text
4792 #: build/C/man4/fd.4:31
4793 msgid "fd - floppy disk device"
4794 msgstr ""
4795
4796 #. type: Plain text
4797 #: build/C/man4/fd.4:48
4798 msgid ""
4799 "Floppy drives are block devices with major number 2.  Typically they are "
4800 "owned by I<root.floppy> (i.e., user root, group floppy) and have either mode "
4801 "0660 (access checking via group membership) or mode 0666 (everybody has "
4802 "access).  The minor numbers encode the device type, drive number, and "
4803 "controller number.  For each device type (that is, combination of density "
4804 "and track count)  there is a base minor number.  To this base number, add "
4805 "the drive's number on its controller and 128 if the drive is on the "
4806 "secondary controller.  In the following device tables, I<n> represents the "
4807 "drive number."
4808 msgstr ""
4809
4810 #. type: Plain text
4811 #: build/C/man4/fd.4:55
4812 msgid ""
4813 "B<Warning: If you use formats with more tracks than supported by your drive, "
4814 "you may cause it mechanical damage.> Trying once if more tracks than the "
4815 "usual 40/80 are supported should not damage it, but no warranty is given for "
4816 "that.  If you are not sure, don't create device entries for those formats, "
4817 "so as to prevent their usage."
4818 msgstr ""
4819
4820 #. type: Plain text
4821 #: build/C/man4/fd.4:58
4822 msgid ""
4823 "Drive-independent device files which automatically detect the media format "
4824 "and capacity:"
4825 msgstr ""
4826
4827 #. type: tbl table
4828 #: build/C/man4/fd.4:60
4829 #, no-wrap
4830 msgid "Name\tBase minor #\n"
4831 msgstr ""
4832
4833 #. type: tbl table
4834 #: build/C/man4/fd.4:61 build/C/man4/fd.4:69 build/C/man4/fd.4:77 build/C/man4/fd.4:94 build/C/man4/fd.4:106 build/C/man4/fd.4:125
4835 #, no-wrap
4836 msgid "_\n"
4837 msgstr ""
4838
4839 #. type: tbl table
4840 #: build/C/man4/fd.4:62
4841 #, no-wrap
4842 msgid "B<fd>I<n>\t0\n"
4843 msgstr ""
4844
4845 #. type: Plain text
4846 #: build/C/man4/fd.4:66
4847 msgid "5.25 inch double-density device files:"
4848 msgstr ""
4849
4850 #. type: tbl table
4851 #: build/C/man4/fd.4:68 build/C/man4/fd.4:76 build/C/man4/fd.4:93 build/C/man4/fd.4:105 build/C/man4/fd.4:124
4852 #, no-wrap
4853 msgid "Name\tCapac.\tCyl.\tSect.\tHeads\tBase minor #\n"
4854 msgstr ""
4855
4856 #. type: tbl table
4857 #: build/C/man4/fd.4:70
4858 #, no-wrap
4859 msgid "B<fd>I<n>B<d360>\t360K\t40\t9\t2\t4\n"
4860 msgstr ""
4861
4862 #. type: Plain text
4863 #: build/C/man4/fd.4:74
4864 msgid "5.25 inch high-density device files:"
4865 msgstr ""
4866
4867 #. type: tbl table
4868 #: build/C/man4/fd.4:78
4869 #, no-wrap
4870 msgid "B<fd>I<n>B<h360>\t360K\t40\t9\t2\t20\n"
4871 msgstr ""
4872
4873 #. type: tbl table
4874 #: build/C/man4/fd.4:79
4875 #, no-wrap
4876 msgid "B<fd>I<n>B<h410>\t410K\t41\t10\t2\t48\n"
4877 msgstr ""
4878
4879 #. type: tbl table
4880 #: build/C/man4/fd.4:80
4881 #, no-wrap
4882 msgid "B<fd>I<n>B<h420>\t420K\t42\t10\t2\t64\n"
4883 msgstr ""
4884
4885 #. type: tbl table
4886 #: build/C/man4/fd.4:81
4887 #, no-wrap
4888 msgid "B<fd>I<n>B<h720>\t720K\t80\t9\t2\t24\n"
4889 msgstr ""
4890
4891 #. type: tbl table
4892 #: build/C/man4/fd.4:82
4893 #, no-wrap
4894 msgid "B<fd>I<n>B<h880>\t880K\t80\t11\t2\t80\n"
4895 msgstr ""
4896
4897 #. type: tbl table
4898 #: build/C/man4/fd.4:83
4899 #, no-wrap
4900 msgid "B<fd>I<n>B<h1200>\t1200K\t80\t15\t2\t8\n"
4901 msgstr ""
4902
4903 #. type: tbl table
4904 #: build/C/man4/fd.4:84
4905 #, no-wrap
4906 msgid "B<fd>I<n>B<h1440>\t1440K\t80\t18\t2\t40\n"
4907 msgstr ""
4908
4909 #. type: tbl table
4910 #: build/C/man4/fd.4:85
4911 #, no-wrap
4912 msgid "B<fd>I<n>B<h1476>\t1476K\t82\t18\t2\t56\n"
4913 msgstr ""
4914
4915 #. type: tbl table
4916 #: build/C/man4/fd.4:86
4917 #, no-wrap
4918 msgid "B<fd>I<n>B<h1494>\t1494K\t83\t18\t2\t72\n"
4919 msgstr ""
4920
4921 #. type: tbl table
4922 #: build/C/man4/fd.4:87
4923 #, no-wrap
4924 msgid "B<fd>I<n>B<h1600>\t1600K\t80\t20\t2\t92\n"
4925 msgstr ""
4926
4927 #. type: Plain text
4928 #: build/C/man4/fd.4:91
4929 msgid "3.5 inch double-density device files:"
4930 msgstr ""
4931
4932 #. type: tbl table
4933 #: build/C/man4/fd.4:95
4934 #, no-wrap
4935 msgid "B<fd>I<n>B<u360>\t360K\t80\t9\t1\t12\n"
4936 msgstr ""
4937
4938 #. type: tbl table
4939 #: build/C/man4/fd.4:96 build/C/man4/fd.4:108
4940 #, no-wrap
4941 msgid "B<fd>I<n>B<u720>\t720K\t80\t9\t2\t16\n"
4942 msgstr ""
4943
4944 #. type: tbl table
4945 #: build/C/man4/fd.4:97
4946 #, no-wrap
4947 msgid "B<fd>I<n>B<u800>\t800K\t80\t10\t2\t120\n"
4948 msgstr ""
4949
4950 #. type: tbl table
4951 #: build/C/man4/fd.4:98
4952 #, no-wrap
4953 msgid "B<fd>I<n>B<u1040>\t1040K\t80\t13\t2\t84\n"
4954 msgstr ""
4955
4956 #. type: tbl table
4957 #: build/C/man4/fd.4:99
4958 #, no-wrap
4959 msgid "B<fd>I<n>B<u1120>\t1120K\t80\t14\t2\t88\n"
4960 msgstr ""
4961
4962 #. type: Plain text
4963 #: build/C/man4/fd.4:103
4964 msgid "3.5 inch high-density device files:"
4965 msgstr ""
4966
4967 #. type: tbl table
4968 #: build/C/man4/fd.4:107
4969 #, no-wrap
4970 msgid "B<fd>I<n>B<u360>\t360K\t40\t9\t2\t12\n"
4971 msgstr ""
4972
4973 #. type: tbl table
4974 #: build/C/man4/fd.4:109
4975 #, no-wrap
4976 msgid "B<fd>I<n>B<u820>\t820K\t82\t10\t2\t52\n"
4977 msgstr ""
4978
4979 #. type: tbl table
4980 #: build/C/man4/fd.4:110
4981 #, no-wrap
4982 msgid "B<fd>I<n>B<u830>\t830K\t83\t10\t2\t68\n"
4983 msgstr ""
4984
4985 #. type: tbl table
4986 #: build/C/man4/fd.4:111
4987 #, no-wrap
4988 msgid "B<fd>I<n>B<u1440>\t1440K\t80\t18\t2\t28\n"
4989 msgstr ""
4990
4991 #. type: tbl table
4992 #: build/C/man4/fd.4:112
4993 #, no-wrap
4994 msgid "B<fd>I<n>B<u1600>\t1600K\t80\t20\t2\t124\n"
4995 msgstr ""
4996
4997 #. type: tbl table
4998 #: build/C/man4/fd.4:113
4999 #, no-wrap
5000 msgid "B<fd>I<n>B<u1680>\t1680K\t80\t21\t2\t44\n"
5001 msgstr ""
5002
5003 #. type: tbl table
5004 #: build/C/man4/fd.4:114
5005 #, no-wrap
5006 msgid "B<fd>I<n>B<u1722>\t1722K\t82\t21\t2\t60\n"
5007 msgstr ""
5008
5009 #. type: tbl table
5010 #: build/C/man4/fd.4:115
5011 #, no-wrap
5012 msgid "B<fd>I<n>B<u1743>\t1743K\t83\t21\t2\t76\n"
5013 msgstr ""
5014
5015 #. type: tbl table
5016 #: build/C/man4/fd.4:116
5017 #, no-wrap
5018 msgid "B<fd>I<n>B<u1760>\t1760K\t80\t22\t2\t96\n"
5019 msgstr ""
5020
5021 #. type: tbl table
5022 #: build/C/man4/fd.4:117
5023 #, no-wrap
5024 msgid "B<fd>I<n>B<u1840>\t1840K\t80\t23\t2\t116\n"
5025 msgstr ""
5026
5027 #. type: tbl table
5028 #: build/C/man4/fd.4:118
5029 #, no-wrap
5030 msgid "B<fd>I<n>B<u1920>\t1920K\t80\t24\t2\t100\n"
5031 msgstr ""
5032
5033 #. type: Plain text
5034 #: build/C/man4/fd.4:122
5035 msgid "3.5 inch extra-density device files:"
5036 msgstr ""
5037
5038 #. type: tbl table
5039 #: build/C/man4/fd.4:126
5040 #, no-wrap
5041 msgid "B<fd>I<n>B<u2880>\t2880K\t80\t36\t2\t32\n"
5042 msgstr ""
5043
5044 #. type: tbl table
5045 #: build/C/man4/fd.4:127
5046 #, no-wrap
5047 msgid "B<fd>I<n>B<CompaQ>\t2880K\t80\t36\t2\t36\n"
5048 msgstr ""
5049
5050 #. type: tbl table
5051 #: build/C/man4/fd.4:128
5052 #, no-wrap
5053 msgid "B<fd>I<n>B<u3200>\t3200K\t80\t40\t2\t104\n"
5054 msgstr ""
5055
5056 #. type: tbl table
5057 #: build/C/man4/fd.4:129
5058 #, no-wrap
5059 msgid "B<fd>I<n>B<u3520>\t3520K\t80\t44\t2\t108\n"
5060 msgstr ""
5061
5062 #. type: tbl table
5063 #: build/C/man4/fd.4:130
5064 #, no-wrap
5065 msgid "B<fd>I<n>B<u3840>\t3840K\t80\t48\t2\t112\n"
5066 msgstr ""
5067
5068 #. type: Plain text
5069 #: build/C/man4/fd.4:137
5070 msgid ""
5071 "B<fd> special files access the floppy disk drives in raw mode.  The "
5072 "following B<ioctl>(2)  calls are supported by B<fd> devices:"
5073 msgstr ""
5074
5075 #. type: IP
5076 #: build/C/man4/fd.4:137
5077 #, no-wrap
5078 msgid "B<FDCLRPRM>"
5079 msgstr ""
5080
5081 #. type: Plain text
5082 #: build/C/man4/fd.4:139
5083 msgid "clears the media information of a drive (geometry of disk in drive)."
5084 msgstr ""
5085
5086 #. type: IP
5087 #: build/C/man4/fd.4:139
5088 #, no-wrap
5089 msgid "B<FDSETPRM>"
5090 msgstr ""
5091
5092 #. type: Plain text
5093 #: build/C/man4/fd.4:143
5094 msgid ""
5095 "sets the media information of a drive.  The media information will be lost "
5096 "when the media is changed."
5097 msgstr ""
5098
5099 #. type: IP
5100 #: build/C/man4/fd.4:143
5101 #, no-wrap
5102 msgid "B<FDDEFPRM>"
5103 msgstr ""
5104
5105 #. type: Plain text
5106 #: build/C/man4/fd.4:149
5107 msgid ""
5108 "sets the media information of a drive (geometry of disk in drive).  The "
5109 "media information will not be lost when the media is changed.  This will "
5110 "disable autodetection.  In order to reenable autodetection, you have to "
5111 "issue an B<FDCLRPRM>."
5112 msgstr ""
5113
5114 #. type: IP
5115 #: build/C/man4/fd.4:149 build/C/man4/fd.4:161
5116 #, no-wrap
5117 msgid "B<FDGETDRVTYP>"
5118 msgstr ""
5119
5120 #. type: Plain text
5121 #: build/C/man4/fd.4:154
5122 msgid ""
5123 "returns the type of a drive (name parameter).  For formats which work in "
5124 "several drive types, B<FDGETDRVTYP> returns a name which is appropriate for "
5125 "the oldest drive type which supports this format."
5126 msgstr ""
5127
5128 #. type: IP
5129 #: build/C/man4/fd.4:154
5130 #, no-wrap
5131 msgid "B<FDFLUSH>"
5132 msgstr ""
5133
5134 #. type: Plain text
5135 #: build/C/man4/fd.4:156
5136 msgid "invalidates the buffer cache for the given drive."
5137 msgstr ""
5138
5139 #. type: IP
5140 #: build/C/man4/fd.4:156 build/C/man4/fd.4:159
5141 #, no-wrap
5142 msgid "B<FDSETMAXERRS>"
5143 msgstr ""
5144
5145 #. type: Plain text
5146 #: build/C/man4/fd.4:159
5147 msgid ""
5148 "sets the error thresholds for reporting errors, aborting the operation, "
5149 "recalibrating, resetting, and reading sector by sector."
5150 msgstr ""
5151
5152 #. type: Plain text
5153 #: build/C/man4/fd.4:161
5154 msgid "gets the current error thresholds."
5155 msgstr ""
5156
5157 #. type: Plain text
5158 #: build/C/man4/fd.4:163
5159 msgid "gets the internal name of the drive."
5160 msgstr ""
5161
5162 #. type: IP
5163 #: build/C/man4/fd.4:163
5164 #, no-wrap
5165 msgid "B<FDWERRORCLR>"
5166 msgstr ""
5167
5168 #. type: Plain text
5169 #: build/C/man4/fd.4:165
5170 msgid "clears the write error statistics."
5171 msgstr ""
5172
5173 #. type: IP
5174 #: build/C/man4/fd.4:165
5175 #, no-wrap
5176 msgid "B<FDWERRORGET>"
5177 msgstr ""
5178
5179 #. type: Plain text
5180 #: build/C/man4/fd.4:172
5181 msgid ""
5182 "reads the write error statistics.  These include the total number of write "
5183 "errors, the location and disk of the first write error, and the location and "
5184 "disk of the last write error.  Disks are identified by a generation number "
5185 "which is incremented at (almost) each disk change."
5186 msgstr ""
5187
5188 #. type: IP
5189 #: build/C/man4/fd.4:172
5190 #, no-wrap
5191 msgid "B<FDTWADDLE>"
5192 msgstr ""
5193
5194 #. type: Plain text
5195 #: build/C/man4/fd.4:176
5196 msgid ""
5197 "Switch the drive motor off for a few microseconds.  This might be needed in "
5198 "order to access a disk whose sectors are too close together."
5199 msgstr ""
5200
5201 #. type: IP
5202 #: build/C/man4/fd.4:176
5203 #, no-wrap
5204 msgid "B<FDSETDRVPRM>"
5205 msgstr ""
5206
5207 #. type: Plain text
5208 #: build/C/man4/fd.4:178
5209 msgid "sets various drive parameters."
5210 msgstr ""
5211
5212 #. type: IP
5213 #: build/C/man4/fd.4:178
5214 #, no-wrap
5215 msgid "B<FDGETDRVPRM>"
5216 msgstr ""
5217
5218 #. type: Plain text
5219 #: build/C/man4/fd.4:180
5220 msgid "reads these parameters back."
5221 msgstr ""
5222
5223 #. type: IP
5224 #: build/C/man4/fd.4:180
5225 #, no-wrap
5226 msgid "B<FDGETDRVSTAT>"
5227 msgstr ""
5228
5229 #. type: Plain text
5230 #: build/C/man4/fd.4:182
5231 msgid "gets the cached drive state (disk changed, write protected et al.)"
5232 msgstr ""
5233
5234 #. type: IP
5235 #: build/C/man4/fd.4:182
5236 #, no-wrap
5237 msgid "B<FDPOLLDRVSTAT>"
5238 msgstr ""
5239
5240 #. type: Plain text
5241 #: build/C/man4/fd.4:184
5242 msgid "polls the drive and return its state."
5243 msgstr ""
5244
5245 #. type: IP
5246 #: build/C/man4/fd.4:184
5247 #, no-wrap
5248 msgid "B<FDGETFDCSTAT>"
5249 msgstr ""
5250
5251 #. type: Plain text
5252 #: build/C/man4/fd.4:186
5253 msgid "gets the floppy controller state."
5254 msgstr ""
5255
5256 #. type: IP
5257 #: build/C/man4/fd.4:186
5258 #, no-wrap
5259 msgid "B<FDRESET>"
5260 msgstr ""
5261
5262 #. type: Plain text
5263 #: build/C/man4/fd.4:188
5264 msgid "resets the floppy controller under certain conditions."
5265 msgstr ""
5266
5267 #. type: IP
5268 #: build/C/man4/fd.4:188
5269 #, no-wrap
5270 msgid "B<FDRAWCMD>"
5271 msgstr ""
5272
5273 #. type: Plain text
5274 #: build/C/man4/fd.4:190
5275 msgid "sends a raw command to the floppy controller."
5276 msgstr ""
5277
5278 #. type: Plain text
5279 #: build/C/man4/fd.4:195
5280 msgid ""
5281 "For more precise information, consult also the I<E<lt>linux/fd.hE<gt>> and "
5282 "I<E<lt>linux/fdreg.hE<gt>> include files, as well as the B<floppycontrol>(1)  "
5283 "manual page."
5284 msgstr ""
5285
5286 #. type: Plain text
5287 #: build/C/man4/fd.4:197
5288 msgid "/dev/fd*"
5289 msgstr ""
5290
5291 #. type: Plain text
5292 #: build/C/man4/fd.4:203
5293 msgid ""
5294 "The various formats permit reading and writing many types of disks.  "
5295 "However, if a floppy is formatted with an inter-sector gap that is too "
5296 "small, performance may drop, to the point of needing a few seconds to access "
5297 "an entire track.  To prevent this, use interleaved formats."
5298 msgstr ""
5299
5300 #. type: Plain text
5301 #: build/C/man4/fd.4:207
5302 msgid ""
5303 "It is not possible to read floppies which are formatted using GCR (group "
5304 "code recording), which is used by Apple II and Macintosh computers (800k "
5305 "disks)."
5306 msgstr ""
5307
5308 #.  .SH AUTHORS
5309 #.  Alain Knaff (Alain.Knaff@imag.fr), David Niemi
5310 #.  (niemidc@clark.net), Bill Broadhurst (bbroad@netcom.com).
5311 #. type: Plain text
5312 #: build/C/man4/fd.4:214
5313 msgid ""
5314 "Reading floppies which are hard sectored (one hole per sector, with the "
5315 "index hole being a little skewed) is not supported.  This used to be common "
5316 "with older 8-inch floppies."
5317 msgstr ""
5318
5319 #. type: Plain text
5320 #: build/C/man4/fd.4:221
5321 msgid ""
5322 "B<chown>(1), B<floppycontrol>(1), B<getfdprm>(1), B<mknod>(1), "
5323 "B<superformat>(1), B<mount>(8), B<setfdprm>(8)"
5324 msgstr ""
5325
5326 #. type: TH
5327 #: build/C/man7/fifo.7:13
5328 #, no-wrap
5329 msgid "FIFO"
5330 msgstr ""
5331
5332 #. type: TH
5333 #: build/C/man7/fifo.7:13
5334 #, no-wrap
5335 msgid "2008-12-03"
5336 msgstr ""
5337
5338 #. type: Plain text
5339 #: build/C/man7/fifo.7:16
5340 msgid "fifo - first-in first-out special file, named pipe"
5341 msgstr ""
5342
5343 #. type: Plain text
5344 #: build/C/man7/fifo.7:28
5345 msgid ""
5346 "A FIFO special file (a named pipe) is similar to a pipe, except that it is "
5347 "accessed as part of the filesystem.  It can be opened by multiple processes "
5348 "for reading or writing.  When processes are exchanging data via the FIFO, "
5349 "the kernel passes all data internally without writing it to the filesystem.  "
5350 "Thus, the FIFO special file has no contents on the filesystem; the "
5351 "filesystem entry merely serves as a reference point so that processes can "
5352 "access the pipe using a name in the filesystem."
5353 msgstr ""
5354
5355 #. type: Plain text
5356 #: build/C/man7/fifo.7:35
5357 msgid ""
5358 "The kernel maintains exactly one pipe object for each FIFO special file that "
5359 "is opened by at least one process.  The FIFO must be opened on both ends "
5360 "(reading and writing)  before data can be passed.  Normally, opening the "
5361 "FIFO blocks until the other end is opened also."
5362 msgstr ""
5363
5364 #. type: Plain text
5365 #: build/C/man7/fifo.7:44
5366 msgid ""
5367 "A process can open a FIFO in nonblocking mode.  In this case, opening for "
5368 "read-only will succeed even if no-one has opened on the write side yet, "
5369 "opening for write-only will fail with B<ENXIO> (no such device or address) "
5370 "unless the other end has already been opened."
5371 msgstr ""
5372
5373 #. type: Plain text
5374 #: build/C/man7/fifo.7:54
5375 msgid ""
5376 "Under Linux, opening a FIFO for read and write will succeed both in blocking "
5377 "and nonblocking mode.  POSIX leaves this behavior undefined.  This can be "
5378 "used to open a FIFO for writing while there are no readers available.  A "
5379 "process that uses both ends of the connection in order to communicate with "
5380 "itself should be very careful to avoid deadlocks."
5381 msgstr ""
5382
5383 #. type: Plain text
5384 #: build/C/man7/fifo.7:59
5385 msgid ""
5386 "When a process tries to write to a FIFO that is not opened for read on the "
5387 "other side, the process is sent a B<SIGPIPE> signal."
5388 msgstr ""
5389
5390 #. type: Plain text
5391 #: build/C/man7/fifo.7:65
5392 msgid ""
5393 "FIFO special files can be created by B<mkfifo>(3), and are indicated by I<ls "
5394 "-l> with the file type \\(aqp\\(aq."
5395 msgstr ""
5396
5397 #. type: Plain text
5398 #: build/C/man7/fifo.7:73
5399 msgid ""
5400 "B<mkfifo>(1), B<open>(2), B<pipe>(2), B<sigaction>(2), B<signal>(2), "
5401 "B<socketpair>(2), B<mkfifo>(3), B<pipe>(7)"
5402 msgstr ""
5403
5404 #. type: TH
5405 #: build/C/man4/full.4:26
5406 #, no-wrap
5407 msgid "FULL"
5408 msgstr ""
5409
5410 #. type: TH
5411 #: build/C/man4/full.4:26
5412 #, no-wrap
5413 msgid "2007-11-24"
5414 msgstr ""
5415
5416 #. type: Plain text
5417 #: build/C/man4/full.4:29
5418 msgid "full - always full device"
5419 msgstr ""
5420
5421 #. type: Plain text
5422 #: build/C/man4/full.4:34
5423 msgid ""
5424 "If your system does not have I</dev/full> created already, it can be created "
5425 "with the following commands:"
5426 msgstr ""
5427
5428 #. type: Plain text
5429 #: build/C/man4/full.4:38
5430 #, no-wrap
5431 msgid ""
5432 "        mknod -m 666 /dev/full c 1 7\n"
5433 "        chown root:root /dev/full\n"
5434 msgstr ""
5435
5436 #. type: Plain text
5437 #: build/C/man4/full.4:44
5438 msgid "File I</dev/full> has major device number 1 and minor device number 7."
5439 msgstr ""
5440
5441 #. type: Plain text
5442 #: build/C/man4/full.4:51
5443 msgid ""
5444 "Writes to the I</dev/full> device will fail with an B<ENOSPC> error.  This "
5445 "can be used to test how a program handles disk-full errors."
5446 msgstr ""
5447
5448 #. type: Plain text
5449 #: build/C/man4/full.4:55
5450 msgid "Reads from the I</dev/full> device will return \\e0 characters."
5451 msgstr ""
5452
5453 #. type: Plain text
5454 #: build/C/man4/full.4:59
5455 msgid "Seeks on I</dev/full> will always succeed."
5456 msgstr ""
5457
5458 #. type: Plain text
5459 #: build/C/man4/full.4:61
5460 msgid "/dev/full"
5461 msgstr ""
5462
5463 #. type: Plain text
5464 #: build/C/man4/full.4:64
5465 msgid "B<mknod>(1), B<null>(4), B<zero>(4)"
5466 msgstr ""
5467
5468 #. type: TH
5469 #: build/C/man3/gnu_get_libc_version.3:26
5470 #, no-wrap
5471 msgid "GNU_GET_LIBC_VERSION"
5472 msgstr ""
5473
5474 #. type: TH
5475 #: build/C/man3/gnu_get_libc_version.3:26
5476 #, no-wrap
5477 msgid "2012-08-26"
5478 msgstr ""
5479
5480 #. type: Plain text
5481 #: build/C/man3/gnu_get_libc_version.3:29
5482 msgid "gnu_get_libc_version, gnu_get_libc_release - get glibc version and release"
5483 msgstr ""
5484
5485 #. type: Plain text
5486 #: build/C/man3/gnu_get_libc_version.3:32
5487 #, no-wrap
5488 msgid "B<#include E<lt>gnu/libc-version.hE<gt>>\n"
5489 msgstr ""
5490
5491 #. type: Plain text
5492 #: build/C/man3/gnu_get_libc_version.3:35
5493 #, no-wrap
5494 msgid ""
5495 "B<const char *gnu_get_libc_version(void);>\n"
5496 "B<const char *gnu_get_libc_release(void);>\n"
5497 msgstr ""
5498
5499 #. type: Plain text
5500 #: build/C/man3/gnu_get_libc_version.3:40
5501 msgid ""
5502 "The function B<gnu_get_libc_version>()  returns a string that identifies the "
5503 "glibc version available on the system."
5504 msgstr ""
5505
5506 #. type: Plain text
5507 #: build/C/man3/gnu_get_libc_version.3:47
5508 msgid ""
5509 "The function B<gnu_get_libc_release>()  returns a string indicates the "
5510 "release status of the glibc version available on the system.  This will be a "
5511 "string such as I<stable>."
5512 msgstr ""
5513
5514 #. type: SH
5515 #: build/C/man3/gnu_get_libc_version.3:47 build/C/man3/mkfifo.3:178 build/C/man2/mknod.2:240 build/C/man4/vcs.4:99
5516 #, no-wrap
5517 msgid "VERSIONS"
5518 msgstr ""
5519
5520 #. type: Plain text
5521 #: build/C/man3/gnu_get_libc_version.3:49
5522 msgid "These functions first appeared in glibc in version 2.1."
5523 msgstr ""
5524
5525 #. type: SH
5526 #: build/C/man3/gnu_get_libc_version.3:49 build/C/man3/makedev.3:62 build/C/man3/mkfifo.3:191 build/C/man2/mknod.2:244 build/C/man3/setlogmask.3:75 build/C/man3/stdarg.3:238 build/C/man2/syslog.2:377 build/C/man3/syslog.3:252 build/C/man7/uri.7:584
5527 #, no-wrap
5528 msgid "CONFORMING TO"
5529 msgstr ""
5530
5531 #. type: Plain text
5532 #: build/C/man3/gnu_get_libc_version.3:51
5533 msgid "These functions are glibc-specific."
5534 msgstr ""
5535
5536 #. type: Plain text
5537 #: build/C/man3/gnu_get_libc_version.3:53
5538 msgid "When run, the program below will produce output such as the following:"
5539 msgstr ""
5540
5541 #. type: Plain text
5542 #: build/C/man3/gnu_get_libc_version.3:59
5543 #, no-wrap
5544 msgid ""
5545 "$B< ./a.out>\n"
5546 "GNU libc version: 2.8\n"
5547 "GNU libc release: stable\n"
5548 msgstr ""
5549
5550 #. type: Plain text
5551 #: build/C/man3/gnu_get_libc_version.3:67
5552 #, no-wrap
5553 msgid ""
5554 "#include E<lt>gnu/libc-version.hE<gt>\n"
5555 "#include E<lt>stdlib.hE<gt>\n"
5556 "#include E<lt>stdio.hE<gt>\n"
5557 msgstr ""
5558
5559 #. type: Plain text
5560 #: build/C/man3/gnu_get_libc_version.3:75
5561 #, no-wrap
5562 msgid ""
5563 "int\n"
5564 "main(int argc, char *argv[])\n"
5565 "{\n"
5566 "    printf(\"GNU libc version: %s\\en\", gnu_get_libc_version());\n"
5567 "    printf(\"GNU libc release: %s\\en\", gnu_get_libc_release());\n"
5568 "    exit(EXIT_SUCCESS);\n"
5569 "}\n"
5570 msgstr ""
5571
5572 #. type: Plain text
5573 #: build/C/man3/gnu_get_libc_version.3:77
5574 msgid "B<confstr>(3)"
5575 msgstr ""
5576
5577 #. type: TH
5578 #: build/C/man4/hd.4:29
5579 #, no-wrap
5580 msgid "HD"
5581 msgstr ""
5582
5583 #. type: TH
5584 #: build/C/man4/hd.4:29
5585 #, no-wrap
5586 msgid "1992-12-17"
5587 msgstr ""
5588
5589 #. type: Plain text
5590 #: build/C/man4/hd.4:32
5591 msgid "hd - MFM/IDE hard disk devices"
5592 msgstr ""
5593
5594 #. type: Plain text
5595 #: build/C/man4/hd.4:47
5596 msgid ""
5597 "The B<hd*> devices are block devices to access MFM/IDE hard disk drives in "
5598 "raw mode.  The master drive on the primary IDE controller (major device "
5599 "number 3) is B<hda>; the slave drive is B<hdb>.  The master drive of the "
5600 "second controller (major device number 22)  is B<hdc> and the slave is "
5601 "B<hdd>."
5602 msgstr ""
5603
5604 #. type: Plain text
5605 #: build/C/man4/hd.4:71
5606 msgid ""
5607 "General IDE block device names have the form B<hd>I<X>, or B<hd>I<XP>, where "
5608 "I<X> is a letter denoting the physical drive, and I<P> is a number denoting "
5609 "the partition on that physical drive.  The first form, B<hd>I<X>, is used to "
5610 "address the whole drive.  Partition numbers are assigned in the order the "
5611 "partitions are discovered, and only nonempty, nonextended partitions get a "
5612 "number.  However, partition numbers 1-4 are given to the four partitions "
5613 "described in the MBR (the \"primary\" partitions), regardless of whether "
5614 "they are unused or extended.  Thus, the first logical partition will be "
5615 "B<hd>I<X>B<5>\\&.  Both DOS-type partitioning and BSD-disklabel partitioning "
5616 "are supported.  You can have at most 63 partitions on an IDE disk."
5617 msgstr ""
5618
5619 #. type: Plain text
5620 #: build/C/man4/hd.4:77
5621 msgid ""
5622 "For example, I</dev/hda> refers to all of the first IDE drive in the system; "
5623 "and I</dev/hdb3> refers to the third DOS \"primary\" partition on the second "
5624 "one."
5625 msgstr ""
5626
5627 #. type: Plain text
5628 #: build/C/man4/hd.4:79 build/C/man4/ttyS.4:34
5629 msgid "They are typically created by:"
5630 msgstr ""
5631
5632 #. type: Plain text
5633 #: build/C/man4/hd.4:82
5634 msgid "mknod -m 660 /dev/hda b 3 0"
5635 msgstr ""
5636
5637 #. type: Plain text
5638 #: build/C/man4/hd.4:84
5639 msgid "mknod -m 660 /dev/hda1 b 3 1"
5640 msgstr ""
5641
5642 #. type: Plain text
5643 #: build/C/man4/hd.4:86
5644 msgid "mknod -m 660 /dev/hda2 b 3 2"
5645 msgstr ""
5646
5647 #. type: Plain text
5648 #: build/C/man4/hd.4:88 build/C/man4/hd.4:98
5649 msgid "\\&..."
5650 msgstr ""
5651
5652 #. type: Plain text
5653 #: build/C/man4/hd.4:90
5654 msgid "mknod -m 660 /dev/hda8 b 3 8"
5655 msgstr ""
5656
5657 #. type: Plain text
5658 #: build/C/man4/hd.4:92
5659 msgid "mknod -m 660 /dev/hdb b 3 64"
5660 msgstr ""
5661
5662 #. type: Plain text
5663 #: build/C/man4/hd.4:94
5664 msgid "mknod -m 660 /dev/hdb1 b 3 65"
5665 msgstr ""
5666
5667 #. type: Plain text
5668 #: build/C/man4/hd.4:96
5669 msgid "mknod -m 660 /dev/hdb2 b 3 66"
5670 msgstr ""
5671
5672 #. type: Plain text
5673 #: build/C/man4/hd.4:100
5674 msgid "mknod -m 660 /dev/hdb8 b 3 72"
5675 msgstr ""
5676
5677 #. type: Plain text
5678 #: build/C/man4/hd.4:102
5679 msgid "chown root:disk /dev/hd*"
5680 msgstr ""
5681
5682 #. type: Plain text
5683 #: build/C/man4/hd.4:105
5684 msgid "/dev/hd*"
5685 msgstr ""
5686
5687 #. type: Plain text
5688 #: build/C/man4/hd.4:109
5689 msgid "B<chown>(1), B<mknod>(1), B<sd>(4), B<mount>(8)"
5690 msgstr ""
5691
5692 #. type: TH
5693 #: build/C/man4/hpsa.4:10
5694 #, no-wrap
5695 msgid "HPSA"
5696 msgstr ""
5697
5698 #. type: Plain text
5699 #: build/C/man4/hpsa.4:13
5700 msgid "hpsa - HP Smart Array SCSI driver"
5701 msgstr ""
5702
5703 #. type: Plain text
5704 #: build/C/man4/hpsa.4:16
5705 #, no-wrap
5706 msgid "modprobe hpsa [ hpsa_allow_any=1 ]\n"
5707 msgstr ""
5708
5709 #. type: Plain text
5710 #: build/C/man4/hpsa.4:20
5711 msgid "B<hpsa> is a SCSI driver for HP Smart Array RAID controllers."
5712 msgstr ""
5713
5714 #. type: Plain text
5715 #: build/C/man4/hpsa.4:39
5716 msgid ""
5717 "I<hpsa_allow_any=1>: This option allows the driver to attempt to operate on "
5718 "any HP Smart Array hardware RAID controller, even if it is not explicitly "
5719 "known to the driver.  This allows newer hardware to work with older "
5720 "drivers.  Typically this is used to allow installation of operating systems "
5721 "from media that predates the RAID controller, though it may also be used to "
5722 "enable B<hpsa> to drive older controllers that would normally be handled by "
5723 "the B<cciss>(4)  driver.  These older boards have not been tested and are "
5724 "not supported with B<hpsa>, and B<cciss>(4)  should still be used for these."
5725 msgstr ""
5726
5727 #. type: Plain text
5728 #: build/C/man4/hpsa.4:43
5729 msgid "The B<hpsa> driver supports the following Smart Array boards:"
5730 msgstr ""
5731
5732 #. type: Plain text
5733 #: build/C/man4/hpsa.4:54
5734 #, no-wrap
5735 msgid ""
5736 "    Smart Array P700M\n"
5737 "    Smart Array P212\n"
5738 "    Smart Array P410\n"
5739 "    Smart Array P410i\n"
5740 "    Smart Array P411\n"
5741 "    Smart Array P812\n"
5742 "    Smart Array P712m\n"
5743 "    Smart Array P711m\n"
5744 "    StorageWorks P1210m\n"
5745 msgstr ""
5746
5747 #. type: Plain text
5748 #: build/C/man4/hpsa.4:78
5749 msgid ""
5750 "Logical drives are accessed via the SCSI disk driver (B<sd>(4)), tape drives "
5751 "via the SCSI tape driver (B<st>(4)), and the RAID controller via the SCSI "
5752 "generic driver (B<sg>(4)), with device nodes named I</dev/sd*>, I</dev/st*>, "
5753 "and I</dev/sg*>, respectively."
5754 msgstr ""
5755
5756 #. type: SS
5757 #: build/C/man4/hpsa.4:78
5758 #, no-wrap
5759 msgid "HPSA-specific host attribute files in /sys"
5760 msgstr ""
5761
5762 #. type: TP
5763 #: build/C/man4/hpsa.4:79
5764 #, no-wrap
5765 msgid "I</sys/class/scsi_host/host*/rescan>"
5766 msgstr ""
5767
5768 #. type: Plain text
5769 #: build/C/man4/hpsa.4:93
5770 msgid ""
5771 "This is a write-only attribute.  Writing to this attribute will cause the "
5772 "driver to scan for new, changed, or removed devices (e.g,. hot-plugged tape "
5773 "drives, or newly configured or deleted logical drives, etc.)  and notify the "
5774 "SCSI midlayer of any changes detected.  Normally a rescan is triggered "
5775 "automatically by HP's Array Configuration Utility (either the GUI or the "
5776 "command-line variety); thus, for logical drive changes, the user should not "
5777 "normally have to use this attribute.  This attribute may be useful when hot "
5778 "plugging devices like tape drives, or entire storage boxes containing "
5779 "preconfigured logical drives."
5780 msgstr ""
5781
5782 #. type: TP
5783 #: build/C/man4/hpsa.4:93
5784 #, no-wrap
5785 msgid "I</sys/class/scsi_host/host*/firmware_revision>"
5786 msgstr ""
5787
5788 #. type: Plain text
5789 #: build/C/man4/hpsa.4:96
5790 msgid "This attribute contains the firmware version of the Smart Array."
5791 msgstr ""
5792
5793 #. type: Plain text
5794 #: build/C/man4/hpsa.4:98
5795 msgid "For example:"
5796 msgstr ""
5797
5798 #. type: Plain text
5799 #: build/C/man4/hpsa.4:103
5800 #, no-wrap
5801 msgid ""
5802 "    # B<cd /sys/class/scsi_host/host4>\n"
5803 "    # B<cat firmware_revision>\n"
5804 "    7.14\n"
5805 msgstr ""
5806
5807 #. type: SS
5808 #: build/C/man4/hpsa.4:104
5809 #, no-wrap
5810 msgid "HPSA-specific disk attribute files in /sys"
5811 msgstr ""
5812
5813 #. type: TP
5814 #: build/C/man4/hpsa.4:105
5815 #, no-wrap
5816 msgid "I</sys/class/scsi_disk/c:b:t:l/device/unique_id>"
5817 msgstr ""
5818
5819 #. type: Plain text
5820 #: build/C/man4/hpsa.4:108
5821 msgid "This attribute contains a 32 hex-digit unique ID for each logical drive."
5822 msgstr ""
5823
5824 #. type: Plain text
5825 #: build/C/man4/hpsa.4:111 build/C/man4/hpsa.4:122 build/C/man4/hpsa.4:136
5826 #, no-wrap
5827 msgid "For example:\n"
5828 msgstr ""
5829
5830 #. type: Plain text
5831 #: build/C/man4/hpsa.4:115
5832 #, no-wrap
5833 msgid ""
5834 "    # B<cd /sys/class/scsi_disk/4:0:0:0/device>\n"
5835 "    # B<cat unique_id>\n"
5836 "    600508B1001044395355323037570F77\n"
5837 msgstr ""
5838
5839 #. type: TP
5840 #: build/C/man4/hpsa.4:116
5841 #, no-wrap
5842 msgid "I</sys/class/scsi_disk/c:b:t:l/device/raid_level>"
5843 msgstr ""
5844
5845 #. type: Plain text
5846 #: build/C/man4/hpsa.4:119
5847 msgid "This attribute contains the RAID level of each logical drive."
5848 msgstr ""
5849
5850 #. type: Plain text
5851 #: build/C/man4/hpsa.4:126
5852 #, no-wrap
5853 msgid ""
5854 "    # B<cd /sys/class/scsi_disk/4:0:0:0/device>\n"
5855 "    # B<cat raid_level>\n"
5856 "    RAID 0\n"
5857 msgstr ""
5858
5859 #. type: TP
5860 #: build/C/man4/hpsa.4:127
5861 #, no-wrap
5862 msgid "I</sys/class/scsi_disk/c:b:t:l/device/lunid>"
5863 msgstr ""
5864
5865 #. type: Plain text
5866 #: build/C/man4/hpsa.4:133
5867 msgid ""
5868 "This attribute contains the 16 hex-digit (8 byte) LUN ID by which a logical "
5869 "drive or physical device can be addressed.  I<c>:I<b>:I<t>:I<l> are the "
5870 "controller, bus, target, and lun of the device."
5871 msgstr ""
5872
5873 #. type: Plain text
5874 #: build/C/man4/hpsa.4:140
5875 #, no-wrap
5876 msgid ""
5877 "    # B<cd /sys/class/scsi_disk/4:0:0:0/device>\n"
5878 "    # B<cat lunid>\n"
5879 "    0x0000004000000000\n"
5880 msgstr ""
5881
5882 #. type: SS
5883 #: build/C/man4/hpsa.4:141
5884 #, no-wrap
5885 msgid "Supported ioctl() operations"
5886 msgstr ""
5887
5888 #. type: Plain text
5889 #: build/C/man4/hpsa.4:153
5890 msgid ""
5891 "For compatibility with applications written for the B<cciss>(4)  driver, "
5892 "many, but not all of the ioctls supported by the B<cciss>(4)  driver are "
5893 "also supported by the B<hpsa> driver.  The data structures used by these "
5894 "ioctls are described in the Linux kernel source file "
5895 "I<include/linux/cciss_ioctl.h>."
5896 msgstr ""
5897
5898 #. type: TP
5899 #: build/C/man4/hpsa.4:153
5900 #, no-wrap
5901 msgid "B<CCISS_DEREGDISK>, B<CCISS_REGNEWDISK>, B<CCISS_REGNEWD>"
5902 msgstr ""
5903
5904 #. type: Plain text
5905 #: build/C/man4/hpsa.4:159
5906 msgid ""
5907 "These three ioctls all do exactly the same thing, which is to cause the "
5908 "driver to rescan for new devices.  This does exactly the same thing as "
5909 "writing to the hpsa-specific host \"rescan\" attribute."
5910 msgstr ""
5911
5912 #. type: TP
5913 #: build/C/man4/hpsa.4:159
5914 #, no-wrap
5915 msgid "B<CCISS_GETPCIINFO>"
5916 msgstr ""
5917
5918 #. type: Plain text
5919 #: build/C/man4/hpsa.4:162
5920 msgid ""
5921 "Returns PCI domain, bus, device and function and \"board ID\" (PCI subsystem "
5922 "ID)."
5923 msgstr ""
5924
5925 #. type: TP
5926 #: build/C/man4/hpsa.4:162
5927 #, no-wrap
5928 msgid "B<CCISS_GETDRIVVER>"
5929 msgstr ""
5930
5931 #. type: Plain text
5932 #: build/C/man4/hpsa.4:165
5933 msgid "Returns driver version in three bytes encoded as:"
5934 msgstr ""
5935
5936 #. type: Plain text
5937 #: build/C/man4/hpsa.4:168
5938 #, no-wrap
5939 msgid ""
5940 "    (major_version E<lt>E<lt> 16) | (minor_version E<lt>E<lt> 8) |\n"
5941 "        (subminor_version)\n"
5942 msgstr ""
5943
5944 #. type: TP
5945 #: build/C/man4/hpsa.4:168
5946 #, no-wrap
5947 msgid "B<CCISS_PASSTHRU>, B<CCISS_BIG_PASSTHRU>"
5948 msgstr ""
5949
5950 #. type: Plain text
5951 #: build/C/man4/hpsa.4:179
5952 msgid ""
5953 "Allows \"BMIC\" and \"CISS\" commands to be passed through to the Smart "
5954 "Array.  These are used extensively by the HP Array Configuration Utility, "
5955 "SNMP storage agents, and so on.  See I<cciss_vol_status> at E<.UR "
5956 "http://cciss.sf.net> E<.UE> for some examples."
5957 msgstr ""
5958
5959 #. type: Plain text
5960 #: build/C/man4/hpsa.4:186
5961 msgid ""
5962 "B<cciss>(4), B<sd>(4), B<st>(4), B<cciss_vol_status>(8), B<hpacucli>(8), "
5963 "B<hpacuxe>(8),"
5964 msgstr ""
5965
5966 #. type: Plain text
5967 #: build/C/man4/hpsa.4:193
5968 msgid ""
5969 "E<.UR http://cciss.sf.net> E<.UE ,> and I<Documentation/scsi/hpsa.txt> and "
5970 "I<Documentation/ABI/testing/sysfs-bus-pci-devices-cciss> in the Linux kernel "
5971 "source tree"
5972 msgstr ""
5973
5974 #. type: TH
5975 #: build/C/man4/initrd.4:35
5976 #, no-wrap
5977 msgid "INITRD"
5978 msgstr ""
5979
5980 #. type: TH
5981 #: build/C/man4/initrd.4:35 build/C/man4/st.4:25
5982 #, no-wrap
5983 msgid "2010-09-04"
5984 msgstr ""
5985
5986 #. type: Plain text
5987 #: build/C/man4/initrd.4:38
5988 msgid "initrd - boot loader initialized RAM disk"
5989 msgstr ""
5990
5991 #. type: Plain text
5992 #: build/C/man4/initrd.4:51
5993 msgid ""
5994 "The I</dev/initrd> is a read-only block device assigned major number 1 and "
5995 "minor number 250.  Typically I</dev/initrd> is owned by I<root.disk> with "
5996 "mode 0400 (read access by root only).  If the Linux system does not have "
5997 "I</dev/initrd> already created, it can be created with the following "
5998 "commands:"
5999 msgstr ""
6000
6001 #. type: Plain text
6002 #: build/C/man4/initrd.4:56
6003 #, no-wrap
6004 msgid ""
6005 "B<\n"
6006 "        mknod -m 400 /dev/initrd b 1 250\n"
6007 "        chown root:disk /dev/initrd>\n"
6008 "\n"
6009 msgstr ""
6010
6011 #. type: Plain text
6012 #: build/C/man4/initrd.4:71
6013 msgid ""
6014 "Also, support for both \"RAM disk\" and \"Initial RAM disk\" (e.g., "
6015 "B<CONFIG_BLK_DEV_RAM=y> and B<CONFIG_BLK_DEV_INITRD=y>)  must be compiled "
6016 "directly into the Linux kernel to use I</dev/initrd>.  When using "
6017 "I</dev/initrd>, the RAM disk driver cannot be loaded as a module."
6018 msgstr ""
6019
6020 #. type: Plain text
6021 #: build/C/man4/initrd.4:80
6022 msgid ""
6023 "The special file I</dev/initrd> is a read-only block device.  This device is "
6024 "a RAM disk that is initialized (e.g., loaded)  by the boot loader before the "
6025 "kernel is started.  The kernel then can use I</dev/initrd>'s contents for a "
6026 "two-phase system boot-up."
6027 msgstr ""
6028
6029 #. type: Plain text
6030 #: build/C/man4/initrd.4:93
6031 msgid ""
6032 "In the first boot-up phase, the kernel starts up and mounts an initial root "
6033 "filesystem from the contents of I</dev/initrd> (e.g., RAM disk initialized "
6034 "by the boot loader).  In the second phase, additional drivers or other "
6035 "modules are loaded from the initial root device's contents.  After loading "
6036 "the additional modules, a new root filesystem (i.e., the normal root "
6037 "filesystem) is mounted from a different device."
6038 msgstr ""
6039
6040 #. type: SS
6041 #: build/C/man4/initrd.4:93
6042 #, no-wrap
6043 msgid "Boot-up operation"
6044 msgstr ""
6045
6046 #. type: Plain text
6047 #: build/C/man4/initrd.4:97
6048 msgid "When booting up with B<initrd>, the system boots as follows:"
6049 msgstr ""
6050
6051 #. type: Plain text
6052 #: build/C/man4/initrd.4:101
6053 msgid ""
6054 "The boot loader loads the kernel program and I</dev/initrd>'s contents into "
6055 "memory."
6056 msgstr ""
6057
6058 #. type: Plain text
6059 #: build/C/man4/initrd.4:109
6060 msgid ""
6061 "On kernel startup, the kernel uncompresses and copies the contents of the "
6062 "device I</dev/initrd> onto device I</dev/ram0> and then frees the memory "
6063 "used by I</dev/initrd>."
6064 msgstr ""
6065
6066 #. type: IP
6067 #: build/C/man4/initrd.4:109 build/C/man4/initrd.4:339 build/C/man4/initrd.4:458 build/C/man4/st.4:919
6068 #, no-wrap
6069 msgid "3."
6070 msgstr ""
6071
6072 #. type: Plain text
6073 #: build/C/man4/initrd.4:113
6074 msgid ""
6075 "The kernel then read-write mounts the device I</dev/ram0> as the initial "
6076 "root filesystem."
6077 msgstr ""
6078
6079 #. type: IP
6080 #: build/C/man4/initrd.4:113 build/C/man4/initrd.4:343 build/C/man4/st.4:926
6081 #, no-wrap
6082 msgid "4."
6083 msgstr ""
6084
6085 #. type: Plain text
6086 #: build/C/man4/initrd.4:118
6087 msgid ""
6088 "If the indicated normal root filesystem is also the initial root filesystem "
6089 "(e.g., I</dev/ram0>)  then the kernel skips to the last step for the usual "
6090 "boot sequence."
6091 msgstr ""
6092
6093 #. type: IP
6094 #: build/C/man4/initrd.4:118 build/C/man4/initrd.4:349 build/C/man4/st.4:931
6095 #, no-wrap
6096 msgid "5."
6097 msgstr ""
6098
6099 #. type: Plain text
6100 #: build/C/man4/initrd.4:130
6101 msgid ""
6102 "If the executable file I</linuxrc> is present in the initial root "
6103 "filesystem, I</linuxrc> is executed with UID 0.  (The file I</linuxrc> must "
6104 "have executable permission.  The file I</linuxrc> can be any valid "
6105 "executable, including a shell script.)"
6106 msgstr ""
6107
6108 #. type: IP
6109 #: build/C/man4/initrd.4:130 build/C/man4/initrd.4:358
6110 #, no-wrap
6111 msgid "6."
6112 msgstr ""
6113
6114 #. type: Plain text
6115 #: build/C/man4/initrd.4:142
6116 msgid ""
6117 "If I</linuxrc> is not executed or when I</linuxrc> terminates, the normal "
6118 "root filesystem is mounted.  (If I</linuxrc> exits with any filesystems "
6119 "mounted on the initial root filesystem, then the behavior of the kernel is "
6120 "B<UNSPECIFIED>.  See the NOTES section for the current kernel behavior.)"
6121 msgstr ""
6122
6123 #. type: IP
6124 #: build/C/man4/initrd.4:142 build/C/man4/initrd.4:360
6125 #, no-wrap
6126 msgid "7."
6127 msgstr ""
6128
6129 #. type: Plain text
6130 #: build/C/man4/initrd.4:173
6131 msgid ""
6132 "If the normal root filesystem has a directory I</initrd>, the device "
6133 "I</dev/ram0> is moved from I</> to I</initrd>.  Otherwise, if the directory "
6134 "I</initrd> does not exist, the device I</dev/ram0> is unmounted.  (When "
6135 "moved from I</> to I</initrd>, I</dev/ram0> is not unmounted and therefore "
6136 "processes can remain running from I</dev/ram0>.  If directory I</initrd> "
6137 "does not exist on the normal root filesystem and any processes remain "
6138 "running from I</dev/ram0> when I</linuxrc> exits, the behavior of the kernel "
6139 "is B<UNSPECIFIED>.  See the NOTES section for the current kernel behavior.)"
6140 msgstr ""
6141
6142 #. type: IP
6143 #: build/C/man4/initrd.4:173 build/C/man4/initrd.4:363
6144 #, no-wrap
6145 msgid "8."
6146 msgstr ""
6147
6148 #. type: Plain text
6149 #: build/C/man4/initrd.4:180
6150 msgid ""
6151 "The usual boot sequence (e.g., invocation of I</sbin/init>)  is performed on "
6152 "the normal root filesystem."
6153 msgstr ""
6154
6155 #. type: Plain text
6156 #: build/C/man4/initrd.4:184
6157 msgid ""
6158 "The following boot loader options, when used with B<initrd>, affect the "
6159 "kernel's boot-up operation:"
6160 msgstr ""
6161
6162 #. type: TP
6163 #: build/C/man4/initrd.4:184
6164 #, no-wrap
6165 msgid "B<initrd=>I<filename>"
6166 msgstr ""
6167
6168 #. type: Plain text
6169 #: build/C/man4/initrd.4:199
6170 msgid ""
6171 "Specifies the file to load as the contents of I</dev/initrd>.  For "
6172 "B<LOADLIN> this is a command-line option.  For B<LILO> you have to use this "
6173 "command in the B<LILO> configuration file I</etc/lilo.config>.  The filename "
6174 "specified with this option will typically be a gzipped filesystem image."
6175 msgstr ""
6176
6177 #. type: TP
6178 #: build/C/man4/initrd.4:199
6179 #, no-wrap
6180 msgid "I<noinitrd>"
6181 msgstr ""
6182
6183 #. type: Plain text
6184 #: build/C/man4/initrd.4:214
6185 msgid ""
6186 "This boot option disables the two-phase boot-up operation.  The kernel "
6187 "performs the usual boot sequence as if I</dev/initrd> was not initialized.  "
6188 "With this option, any contents of I</dev/initrd> loaded into memory by the "
6189 "boot loader contents are preserved.  This option permits the contents of "
6190 "I</dev/initrd> to be any data and need not be limited to a filesystem "
6191 "image.  However, device I</dev/initrd> is read-only and can be read only one "
6192 "time after system startup."
6193 msgstr ""
6194
6195 #. type: TP
6196 #: build/C/man4/initrd.4:214
6197 #, no-wrap
6198 msgid "B<root=>I<device-name>"
6199 msgstr ""
6200
6201 #. type: Plain text
6202 #: build/C/man4/initrd.4:232
6203 msgid ""
6204 "Specifies the device to be used as the normal root filesystem.  For "
6205 "B<LOADLIN> this is a command-line option.  For B<LILO> this is a boot time "
6206 "option or can be used as an option line in the B<LILO> configuration file "
6207 "I</etc/lilo.config>.  The device specified by the this option must be a "
6208 "mountable device having a suitable root filesystem."
6209 msgstr ""
6210
6211 #. type: SS
6212 #: build/C/man4/initrd.4:232
6213 #, no-wrap
6214 msgid "Changing the normal root filesystem"
6215 msgstr ""
6216
6217 #. type: Plain text
6218 #: build/C/man4/initrd.4:252
6219 msgid ""
6220 "By default, the kernel's settings (e.g., set in the kernel file with "
6221 "B<rdev>(8)  or compiled into the kernel file), or the boot loader option "
6222 "setting is used for the normal root filesystems.  For an NFS-mounted normal "
6223 "root filesystem, one has to use the B<nfs_root_name> and B<nfs_root_addrs> "
6224 "boot options to give the NFS settings.  For more information on NFS-mounted "
6225 "root see the kernel documentation file "
6226 "B<Documentation/filesystems/nfsroot.txt>.  For more information on setting "
6227 "the root filesystem see also the B<LILO> and B<LOADLIN> documentation."
6228 msgstr ""
6229
6230 #. type: Plain text
6231 #: build/C/man4/initrd.4:284
6232 msgid ""
6233 "It is also possible for the I</linuxrc> executable to change the normal root "
6234 "device.  For I</linuxrc> to change the normal root device, I</proc> must be "
6235 "mounted.  After mounting I</proc>, I</linuxrc> changes the normal root "
6236 "device by writing into the proc files I</proc/sys/kernel/real-root-dev>, "
6237 "I</proc/sys/kernel/nfs-root-name>, and I</proc/sys/kernel/nfs-root-addrs>.  "
6238 "For a physical root device, the root device is changed by having I</linuxrc> "
6239 "write the new root filesystem device number into "
6240 "I</proc/sys/kernel/real-root-dev>.  For an NFS root filesystem, the root "
6241 "device is changed by having I</linuxrc> write the NFS setting into files "
6242 "I</proc/sys/kernel/nfs-root-name> and I</proc/sys/kernel/nfs-root-addrs> and "
6243 "then writing 0xff (e.g., the pseudo-NFS-device number) into file "
6244 "I</proc/sys/kernel/real-root-dev>.  For example, the following shell command "
6245 "line would change the normal root device to I</dev/hdb1>:"
6246 msgstr ""
6247
6248 #. type: Plain text
6249 #: build/C/man4/initrd.4:287
6250 #, no-wrap
6251 msgid "    echo 0x365 E<gt>/proc/sys/kernel/real-root-dev\n"
6252 msgstr ""
6253
6254 #. type: Plain text
6255 #: build/C/man4/initrd.4:294
6256 msgid ""
6257 "For an NFS example, the following shell command lines would change the "
6258 "normal root device to the NFS directory I</var/nfsroot> on a local networked "
6259 "NFS server with IP number 193.8.232.7 for a system with IP number "
6260 "193.8.232.2 and named \"idefix\":"
6261 msgstr ""
6262
6263 #. type: Plain text
6264 #: build/C/man4/initrd.4:300
6265 #, no-wrap
6266 msgid ""
6267 "    echo /var/nfsroot E<gt>/proc/sys/kernel/nfs-root-name\n"
6268 "    echo 193.8.232.2:193.8.232.7::255.255.255.0:idefix \\e\n"
6269 "        E<gt>/proc/sys/kernel/nfs-root-addrs\n"
6270 "    echo 255 E<gt>/proc/sys/kernel/real-root-dev\n"
6271 msgstr ""
6272
6273 #.  FIXME . Should this manual page  describe the pivot_root mechanism?
6274 #. type: Plain text
6275 #: build/C/man4/initrd.4:317
6276 msgid ""
6277 "B<Note>: The use of I</proc/sys/kernel/real-root-dev> to change the root "
6278 "filesystem is obsolete.  See the Linux kernel source file "
6279 "I<Documentation/initrd.txt> as well as B<pivot_root>(2)  and "
6280 "B<pivot_root>(8)  for information on the modern method of changing the root "
6281 "filesystem."
6282 msgstr ""
6283
6284 #. type: SS
6285 #: build/C/man4/initrd.4:317 build/C/man4/random.4:91 build/C/man7/uri.7:109
6286 #, no-wrap
6287 msgid "Usage"
6288 msgstr ""
6289
6290 #. type: Plain text
6291 #: build/C/man4/initrd.4:321
6292 msgid ""
6293 "The main motivation for implementing B<initrd> was to allow for modular "
6294 "kernel configuration at system installation."
6295 msgstr ""
6296
6297 #. type: Plain text
6298 #: build/C/man4/initrd.4:323
6299 msgid "A possible system installation scenario is as follows:"
6300 msgstr ""
6301
6302 #. type: Plain text
6303 #: build/C/man4/initrd.4:331
6304 msgid ""
6305 "The loader program boots from floppy or other media with a minimal kernel "
6306 "(e.g., support for I</dev/ram>, I</dev/initrd>, and the ext2 filesystem) and "
6307 "loads I</dev/initrd> with a gzipped version of the initial filesystem."
6308 msgstr ""
6309
6310 #. type: Plain text
6311 #: build/C/man4/initrd.4:339
6312 msgid ""
6313 "The executable I</linuxrc> determines what is needed to (1) mount the normal "
6314 "root filesystem (i.e., device type, device drivers, filesystem) and (2) the "
6315 "distribution media (e.g., CD-ROM, network, tape, ...).  This can be done by "
6316 "asking the user, by auto-probing, or by using a hybrid approach."
6317 msgstr ""
6318
6319 #. type: Plain text
6320 #: build/C/man4/initrd.4:343
6321 msgid ""
6322 "The executable I</linuxrc> loads the necessary modules from the initial root "
6323 "filesystem."
6324 msgstr ""
6325
6326 #. type: Plain text
6327 #: build/C/man4/initrd.4:349
6328 msgid ""
6329 "The executable I</linuxrc> creates and populates the root filesystem.  (At "
6330 "this stage the normal root filesystem does not have to be a completed system "
6331 "yet.)"
6332 msgstr ""
6333
6334 #. type: Plain text
6335 #: build/C/man4/initrd.4:358
6336 msgid ""
6337 "The executable I</linuxrc> sets I</proc/sys/kernel/real-root-dev>, unmount "
6338 "I</proc>, the normal root filesystem and any other filesystems it has "
6339 "mounted, and then terminates."
6340 msgstr ""
6341
6342 #. type: Plain text
6343 #: build/C/man4/initrd.4:360
6344 msgid "The kernel then mounts the normal root filesystem."
6345 msgstr ""
6346
6347 #. type: Plain text
6348 #: build/C/man4/initrd.4:363
6349 msgid ""
6350 "Now that the filesystem is accessible and intact, the boot loader can be "
6351 "installed."
6352 msgstr ""
6353
6354 #. type: Plain text
6355 #: build/C/man4/initrd.4:372
6356 msgid ""
6357 "The boot loader is configured to load into I</dev/initrd> a filesystem with "
6358 "the set of modules that was used to bring up the system.  (e.g., Device "
6359 "I</dev/ram0> can be modified, then unmounted, and finally, the image is "
6360 "written from I</dev/ram0> to a file.)"
6361 msgstr ""
6362
6363 #. type: IP
6364 #: build/C/man4/initrd.4:372
6365 #, no-wrap
6366 msgid "9."
6367 msgstr ""
6368
6369 #. type: Plain text
6370 #: build/C/man4/initrd.4:375
6371 msgid ""
6372 "The system is now bootable and additional installation tasks can be "
6373 "performed."
6374 msgstr ""
6375
6376 #. type: Plain text
6377 #: build/C/man4/initrd.4:381
6378 msgid ""
6379 "The key role of I</dev/initrd> in the above is to reuse the configuration "
6380 "data during normal system operation without requiring initial kernel "
6381 "selection, a large generic kernel or, recompiling the kernel."
6382 msgstr ""
6383
6384 #. type: Plain text
6385 #: build/C/man4/initrd.4:394
6386 msgid ""
6387 "A second scenario is for installations where Linux runs on systems with "
6388 "different hardware configurations in a single administrative network.  In "
6389 "such cases, it may be desirable to use only a small set of kernels (ideally "
6390 "only one) and to keep the system-specific part of configuration information "
6391 "as small as possible.  In this case, create a common file with all needed "
6392 "modules.  Then, only the I</linuxrc> file or a file executed by I</linuxrc> "
6393 "would be different."
6394 msgstr ""
6395
6396 #. type: Plain text
6397 #: build/C/man4/initrd.4:401
6398 msgid ""
6399 "A third scenario is more convenient recovery disks.  Because information "
6400 "like the location of the root filesystem partition is not needed at boot "
6401 "time, the system loaded from I</dev/initrd> can use a dialog and/or "
6402 "auto-detection followed by a possible sanity check."
6403 msgstr ""
6404
6405 #. type: Plain text
6406 #: build/C/man4/initrd.4:418
6407 msgid ""
6408 "Last but not least, Linux distributions on CD-ROM may use B<initrd> for easy "
6409 "installation from the CD-ROM.  The distribution can use B<LOADLIN> to "
6410 "directly load I</dev/initrd> from CD-ROM without the need of any floppies.  "
6411 "The distribution could also use a B<LILO> boot floppy and then bootstrap a "
6412 "bigger RAM disk via I</dev/initrd> from the CD-ROM."
6413 msgstr ""
6414
6415 #. type: Plain text
6416 #: build/C/man4/initrd.4:420
6417 msgid "I</dev/initrd>"
6418 msgstr ""
6419
6420 #. type: Plain text
6421 #: build/C/man4/initrd.4:422
6422 msgid "I</dev/ram0>"
6423 msgstr ""
6424
6425 #. type: Plain text
6426 #: build/C/man4/initrd.4:424
6427 msgid "I</linuxrc>"
6428 msgstr ""
6429
6430 #. type: Plain text
6431 #: build/C/man4/initrd.4:429
6432 msgid "I</initrd>"
6433 msgstr ""
6434
6435 #. type: Plain text
6436 #: build/C/man4/initrd.4:441
6437 msgid ""
6438 "With the current kernel, any filesystems that remain mounted when "
6439 "I</dev/ram0> is moved from I</> to I</initrd> continue to be accessible.  "
6440 "However, the I</proc/mounts> entries are not updated."
6441 msgstr ""
6442
6443 #. type: Plain text
6444 #: build/C/man4/initrd.4:458
6445 msgid ""
6446 "With the current kernel, if directory I</initrd> does not exist, then "
6447 "I</dev/ram0> will B<not> be fully unmounted if I</dev/ram0> is used by any "
6448 "process or has any filesystem mounted on it.  If I</dev/ram0> is B<not> "
6449 "fully unmounted, then I</dev/ram0> will remain in memory."
6450 msgstr ""
6451
6452 #
6453 #
6454 #
6455 #.  .SH AUTHORS
6456 #.  The kernel code for device
6457 #.  .BR initrd
6458 #.  was written by Werner Almesberger <almesber@lrc.epfl.ch> and
6459 #.  Hans Lermen <lermen@elserv.ffm.fgan.de>.
6460 #.  The code for
6461 #.  .BR initrd
6462 #.  was added to the baseline Linux kernel in development version 1.3.73.
6463 #. type: Plain text
6464 #: build/C/man4/initrd.4:474
6465 msgid ""
6466 "Users of I</dev/initrd> should not depend on the behavior give in the above "
6467 "notes.  The behavior may change in future versions of the Linux kernel."
6468 msgstr ""
6469
6470 #. type: Plain text
6471 #: build/C/man4/initrd.4:480
6472 msgid "B<chown>(1), B<mknod>(1), B<ram>(4), B<freeramdisk>(8), B<rdev>(8)"
6473 msgstr ""
6474
6475 #. type: Plain text
6476 #: build/C/man4/initrd.4:483
6477 msgid ""
6478 "I<Documentation/initrd.txt> in the Linux kernel source tree, the LILO "
6479 "documentation, the LOADLIN documentation, the SYSLINUX documentation"
6480 msgstr ""
6481
6482 #. type: TH
6483 #: build/C/man4/lp.4:27
6484 #, no-wrap
6485 msgid "LP"
6486 msgstr ""
6487
6488 #. type: TH
6489 #: build/C/man4/lp.4:27
6490 #, no-wrap
6491 msgid "1995-01-15"
6492 msgstr ""
6493
6494 #. type: Plain text
6495 #: build/C/man4/lp.4:30
6496 msgid "lp - line printer devices"
6497 msgstr ""
6498
6499 #. type: Plain text
6500 #: build/C/man4/lp.4:32
6501 msgid "B<#include E<lt>linux/lp.hE<gt>>"
6502 msgstr ""
6503
6504 #. type: Plain text
6505 #: build/C/man4/lp.4:43
6506 msgid ""
6507 "B<lp>[0\\(en2] are character devices for the parallel line printers; they "
6508 "have major number 6 and minor number 0\\(en2.  The minor numbers correspond "
6509 "to the printer port base addresses 0x03bc, 0x0378 and 0x0278.  Usually they "
6510 "have mode 220 and are owned by root and group lp.  You can use printer ports "
6511 "either with polling or with interrupts.  Interrupts are recommended when "
6512 "high traffic is expected, for example, for laser printers.  For usual dot "
6513 "matrix printers polling will usually be enough.  The default is polling."
6514 msgstr ""
6515
6516 #. type: Plain text
6517 #: build/C/man4/lp.4:47
6518 msgid "The following B<ioctl>(2)  calls are supported:"
6519 msgstr ""
6520
6521 #. type: IP
6522 #: build/C/man4/lp.4:47
6523 #, no-wrap
6524 msgid "B<int ioctl(int >I<fd>B<, LPTIME, int >I<arg>B<)>"
6525 msgstr ""
6526
6527 #. type: Plain text
6528 #: build/C/man4/lp.4:56
6529 msgid ""
6530 "Sets the amount of time that the driver sleeps before rechecking the printer "
6531 "when the printer's buffer appears to be filled to I<arg>.  If you have a "
6532 "fast printer, decrease this number; if you have a slow printer, then "
6533 "increase it.  This is in hundredths of a second, the default 2 being 0.02 "
6534 "seconds.  It only influences the polling driver."
6535 msgstr ""
6536
6537 #. type: IP
6538 #: build/C/man4/lp.4:56
6539 #, no-wrap
6540 msgid "B<int ioctl(int >I<fd>B<, LPCHAR, int >I<arg>B<)>"
6541 msgstr ""
6542
6543 #. type: Plain text
6544 #: build/C/man4/lp.4:64
6545 msgid ""
6546 "Sets the maximum number of busy-wait iterations which the polling driver "
6547 "does while waiting for the printer to get ready for receiving a character to "
6548 "I<arg>.  If printing is too slow, increase this number; if the system gets "
6549 "too slow, decrease this number.  The default is 1000.  It only influences "
6550 "the polling driver."
6551 msgstr ""
6552
6553 #. type: IP
6554 #: build/C/man4/lp.4:64
6555 #, no-wrap
6556 msgid "B<int ioctl(int >I<fd>B<, LPABORT, int >I<arg>B<)>"
6557 msgstr ""
6558
6559 #. type: Plain text
6560 #: build/C/man4/lp.4:70
6561 msgid ""
6562 "If I<arg> is 0, the printer driver will retry on errors, otherwise it will "
6563 "abort.  The default is 0."
6564 msgstr ""
6565
6566 #. type: IP
6567 #: build/C/man4/lp.4:70
6568 #, no-wrap
6569 msgid "B<int ioctl(int >I<fd>B<, LPABORTOPEN, int >I<arg>B<)>"
6570 msgstr ""
6571
6572 #. type: Plain text
6573 #: build/C/man4/lp.4:77
6574 msgid ""
6575 "If I<arg> is 0, B<open>(2)  will be aborted on error, otherwise error will "
6576 "be ignored.  The default is to ignore it."
6577 msgstr ""
6578
6579 #. type: IP
6580 #: build/C/man4/lp.4:77
6581 #, no-wrap
6582 msgid "B<int ioctl(int >I<fd>B<, LPCAREFUL, int >I<arg>B<)>"
6583 msgstr ""
6584
6585 #. type: Plain text
6586 #: build/C/man4/lp.4:83
6587 msgid ""
6588 "If I<arg> is 0, then the out-of-paper, offline and error signals are "
6589 "required to be false on all writes, otherwise they are ignored.  The default "
6590 "is to ignore them."
6591 msgstr ""
6592
6593 #. type: IP
6594 #: build/C/man4/lp.4:83
6595 #, no-wrap
6596 msgid "B<int ioctl(int >I<fd>B<, LPWAIT, int >I<arg>B<)>"
6597 msgstr ""
6598
6599 #. type: Plain text
6600 #: build/C/man4/lp.4:94
6601 msgid ""
6602 "Sets the number of busy waiting iterations to wait before strobing the "
6603 "printer to accept a just-written character, and the number of iterations to "
6604 "wait before turning the strobe off again, to I<arg>.  The specification says "
6605 "this time should be 0.5 microseconds, but experience has shown the delay "
6606 "caused by the code is already enough.  For that reason, the default value is "
6607 "0.  This is used for both the polling and the interrupt driver."
6608 msgstr ""
6609
6610 #. type: IP
6611 #: build/C/man4/lp.4:94
6612 #, no-wrap
6613 msgid "B<int ioctl(int >I<fd>B<, LPSETIRQ, int >I<arg>B<)>"
6614 msgstr ""
6615
6616 #. type: Plain text
6617 #: build/C/man4/lp.4:105
6618 msgid ""
6619 "This B<ioctl>(2)  requires superuser privileges.  It takes an I<int> "
6620 "containing the new IRQ as argument.  As a side effect, the printer will be "
6621 "reset.  When I<arg> is 0, the polling driver will be used, which is also "
6622 "default."
6623 msgstr ""
6624
6625 #. type: IP
6626 #: build/C/man4/lp.4:105
6627 #, no-wrap
6628 msgid "B<int ioctl(int >I<fd>B<, LPGETIRQ, int *>I<arg>B<)>"
6629 msgstr ""
6630
6631 #. type: Plain text
6632 #: build/C/man4/lp.4:108
6633 msgid "Stores the currently used IRQ in I<arg>."
6634 msgstr ""
6635
6636 #. type: IP
6637 #: build/C/man4/lp.4:108
6638 #, no-wrap
6639 msgid "B<int ioctl(int >I<fd>B<, LPGETSTATUS, int *>I<arg>B<)>"
6640 msgstr ""
6641
6642 #. type: Plain text
6643 #: build/C/man4/lp.4:112
6644 msgid ""
6645 "Stores the value of the status port in I<arg>.  The bits have the following "
6646 "meaning:"
6647 msgstr ""
6648
6649 #. type: tbl table
6650 #: build/C/man4/lp.4:114
6651 #, no-wrap
6652 msgid "LP_PBUSY\tinverted busy input, active high\n"
6653 msgstr ""
6654
6655 #. type: tbl table
6656 #: build/C/man4/lp.4:115
6657 #, no-wrap
6658 msgid "LP_PACK\tunchanged acknowledge input, active low\n"
6659 msgstr ""
6660
6661 #. type: tbl table
6662 #: build/C/man4/lp.4:116
6663 #, no-wrap
6664 msgid "LP_POUTPA\tunchanged out-of-paper input, active high\n"
6665 msgstr ""
6666
6667 #. type: tbl table
6668 #: build/C/man4/lp.4:117
6669 #, no-wrap
6670 msgid "LP_PSELECD\tunchanged selected input, active high\n"
6671 msgstr ""
6672
6673 #. type: tbl table
6674 #: build/C/man4/lp.4:118
6675 #, no-wrap
6676 msgid "LP_PERRORP\tunchanged error input, active low\n"
6677 msgstr ""
6678
6679 #. type: Plain text
6680 #: build/C/man4/lp.4:123
6681 msgid ""
6682 "Refer to your printer manual for the meaning of the signals.  Note that "
6683 "undocumented bits may also be set, depending on your printer."
6684 msgstr ""
6685
6686 #. type: IP
6687 #: build/C/man4/lp.4:123
6688 #, no-wrap
6689 msgid "B<int ioctl(int >I<fd>B<, LPRESET)>"
6690 msgstr ""
6691
6692 #. type: Plain text
6693 #: build/C/man4/lp.4:126
6694 msgid "Resets the printer.  No argument is used."
6695 msgstr ""
6696
6697 #.  .SH AUTHORS
6698 #.  The printer driver was originally written by Jim Weigand and Linus
6699 #.  Torvalds.
6700 #.  It was further improved by Michael K.\& Johnson.
6701 #.  The interrupt code was written by Nigel Gamble.
6702 #.  Alan Cox modularized it.
6703 #.  LPCAREFUL, LPABORT, LPGETSTATUS were added by Chris Metcalf.
6704 #. type: Plain text
6705 #: build/C/man4/lp.4:135
6706 msgid "/dev/lp*"
6707 msgstr ""
6708
6709 #. type: Plain text
6710 #: build/C/man4/lp.4:140
6711 msgid "B<chmod>(1), B<chown>(1), B<mknod>(1), B<lpcntl>(8), B<tunelp>(8)"
6712 msgstr ""
6713
6714 #. type: TH
6715 #: build/C/man3/makedev.3:26
6716 #, no-wrap
6717 msgid "MAKEDEV"
6718 msgstr ""
6719
6720 #. type: TH
6721 #: build/C/man3/makedev.3:26
6722 #, no-wrap
6723 msgid "2014-05-28"
6724 msgstr ""
6725
6726 #. type: Plain text
6727 #: build/C/man3/makedev.3:29
6728 msgid "makedev, major, minor - manage a device number"
6729 msgstr ""
6730
6731 #. type: Plain text
6732 #: build/C/man3/makedev.3:33
6733 #, no-wrap
6734 msgid ""
6735 "B<#define _BSD_SOURCE>             /* See feature_test_macros(7) */\n"
6736 "B<#include E<lt>sys/types.hE<gt>>\n"
6737 msgstr ""
6738
6739 #. type: Plain text
6740 #: build/C/man3/makedev.3:35
6741 #, no-wrap
6742 msgid "B<dev_t makedev(unsigned int >I<maj>B<, unsigned int >I<min>B<);>\n"
6743 msgstr ""
6744
6745 #. type: Plain text
6746 #: build/C/man3/makedev.3:38
6747 #, no-wrap
6748 msgid ""
6749 "B<unsigned int major(dev_t >I<dev>B<);>\n"
6750 "B<unsigned int minor(dev_t >I<dev>B<);>\n"
6751 msgstr ""
6752
6753 #. type: Plain text
6754 #: build/C/man3/makedev.3:45
6755 msgid ""
6756 "A device ID consists of two parts: a major ID, identifying the class of the "
6757 "device, and a minor ID, identifying a specific instance of a device in that "
6758 "class.  A device ID is represented using the type I<dev_t>."
6759 msgstr ""
6760
6761 #. type: Plain text
6762 #: build/C/man3/makedev.3:52
6763 msgid ""
6764 "Given major and minor device IDs, B<makedev>()  combines these to produce a "
6765 "device ID, returned as the function result.  This device ID can be given to "
6766 "B<mknod>(2), for example."
6767 msgstr ""
6768
6769 #. type: Plain text
6770 #: build/C/man3/makedev.3:62
6771 msgid ""
6772 "The B<major>()  and B<minor>()  functions perform the converse task: given a "
6773 "device ID, they return, respectively, the major and minor components.  These "
6774 "macros can be useful to, for example, decompose the device IDs in the "
6775 "structure returned by B<stat>(2)."
6776 msgstr ""
6777
6778 #.  The BSDs, HP-UX, Solaris, AIX, Irix
6779 #. type: Plain text
6780 #: build/C/man3/makedev.3:71
6781 msgid ""
6782 "The B<makedev>(), B<major>(), and B<minor>()  functions are not specified in "
6783 "POSIX.1, but are present on many other systems."
6784 msgstr ""
6785
6786 #. type: Plain text
6787 #: build/C/man3/makedev.3:80
6788 msgid ""
6789 "These interfaces are defined as macros.  Since glibc 2.3.3, they have been "
6790 "aliases for three GNU-specific functions: B<gnu_dev_makedev>(), "
6791 "B<gnu_dev_major>(), and B<gnu_dev_minor>().  The latter names are exported, "
6792 "but the traditional names are more portable."
6793 msgstr ""
6794
6795 #. type: Plain text
6796 #: build/C/man3/makedev.3:82
6797 msgid "B<mknod>(2), B<stat>(2)"
6798 msgstr ""
6799
6800 #. type: TH
6801 #: build/C/man4/mem.4:26
6802 #, no-wrap
6803 msgid "MEM"
6804 msgstr ""
6805
6806 #. type: TH
6807 #: build/C/man4/mem.4:26
6808 #, no-wrap
6809 msgid "2015-01-02"
6810 msgstr ""
6811
6812 #. type: Plain text
6813 #: build/C/man4/mem.4:29
6814 msgid "mem, kmem, port - system memory, kernel memory and system ports"
6815 msgstr ""
6816
6817 #. type: Plain text
6818 #: build/C/man4/mem.4:34
6819 msgid ""
6820 "B<mem> is a character device file that is an image of the main memory of the "
6821 "computer.  It may be used, for example, to examine (and even patch) the "
6822 "system."
6823 msgstr ""
6824
6825 #. type: Plain text
6826 #: build/C/man4/mem.4:39
6827 msgid ""
6828 "Byte addresses in B<mem> are interpreted as physical memory addresses.  "
6829 "References to nonexistent locations cause errors to be returned."
6830 msgstr ""
6831
6832 #. type: Plain text
6833 #: build/C/man4/mem.4:42
6834 msgid ""
6835 "Examining and patching is likely to lead to unexpected results when "
6836 "read-only or write-only bits are present."
6837 msgstr ""
6838
6839 #. type: Plain text
6840 #: build/C/man4/mem.4:49
6841 msgid ""
6842 "Since 2.6.26, and depending on the architecture, the B<CONFIG_STRICT_DEVMEM> "
6843 "kernel configuration option limits the areas which can be accessed through "
6844 "this file.  For example: on x86, RAM access is not allowed but accessing "
6845 "memory-mapped PCI regions is."
6846 msgstr ""
6847
6848 #. type: Plain text
6849 #: build/C/man4/mem.4:51 build/C/man4/mem.4:69 build/C/man4/mem.4:82 build/C/man4/ram.4:35
6850 msgid "It is typically created by:"
6851 msgstr ""
6852
6853 #. type: Plain text
6854 #: build/C/man4/mem.4:54
6855 msgid "mknod -m 660 /dev/mem c 1 1"
6856 msgstr ""
6857
6858 #. type: Plain text
6859 #: build/C/man4/mem.4:56
6860 msgid "chown root:kmem /dev/mem"
6861 msgstr ""
6862
6863 #. type: Plain text
6864 #: build/C/man4/mem.4:67
6865 msgid ""
6866 "The file B<kmem> is the same as B<mem>, except that the kernel virtual "
6867 "memory rather than physical memory is accessed.  Since 2.6.26, this file is "
6868 "only available if the B<CONFIG_DEVKMEM> kernel configuration option is "
6869 "enabled."
6870 msgstr ""
6871
6872 #. type: Plain text
6873 #: build/C/man4/mem.4:72
6874 msgid "mknod -m 640 /dev/kmem c 1 2"
6875 msgstr ""
6876
6877 #. type: Plain text
6878 #: build/C/man4/mem.4:74
6879 msgid "chown root:kmem /dev/kmem"
6880 msgstr ""
6881
6882 #. type: Plain text
6883 #: build/C/man4/mem.4:80
6884 msgid "B<port> is similar to B<mem>, but the I/O ports are accessed."
6885 msgstr ""
6886
6887 #. type: Plain text
6888 #: build/C/man4/mem.4:85
6889 msgid "mknod -m 660 /dev/port c 1 4"
6890 msgstr ""
6891
6892 #. type: Plain text
6893 #: build/C/man4/mem.4:87
6894 msgid "chown root:kmem /dev/port"
6895 msgstr ""
6896
6897 #. type: Plain text
6898 #: build/C/man4/mem.4:90
6899 msgid "I</dev/mem>"
6900 msgstr ""
6901
6902 #. type: Plain text
6903 #: build/C/man4/mem.4:92
6904 msgid "I</dev/kmem>"
6905 msgstr ""
6906
6907 #. type: Plain text
6908 #: build/C/man4/mem.4:94
6909 msgid "I</dev/port>"
6910 msgstr ""
6911
6912 #. type: Plain text
6913 #: build/C/man4/mem.4:97
6914 msgid "B<chown>(1), B<mknod>(1), B<ioperm>(2)"
6915 msgstr ""
6916
6917 #. type: TH
6918 #: build/C/man3/mkfifo.3:28
6919 #, no-wrap
6920 msgid "MKFIFO"
6921 msgstr ""
6922
6923 #. type: TH
6924 #: build/C/man3/mkfifo.3:28
6925 #, no-wrap
6926 msgid "2014-03-24"
6927 msgstr ""
6928
6929 #. type: TH
6930 #: build/C/man3/mkfifo.3:28
6931 #, no-wrap
6932 msgid "GNU"
6933 msgstr ""
6934
6935 #. type: Plain text
6936 #: build/C/man3/mkfifo.3:31
6937 msgid "mkfifo, mkfifoat - make a FIFO special file (a named pipe)"
6938 msgstr ""
6939
6940 #. type: Plain text
6941 #: build/C/man3/mkfifo.3:35
6942 #, no-wrap
6943 msgid ""
6944 "B<#include E<lt>sys/types.hE<gt>>\n"
6945 "B<#include E<lt>sys/stat.hE<gt>>\n"
6946 msgstr ""
6947
6948 #. type: Plain text
6949 #: build/C/man3/mkfifo.3:37
6950 #, no-wrap
6951 msgid "B<int mkfifo(const char *>I<pathname>B<, mode_t >I<mode>B<);>\n"
6952 msgstr ""
6953
6954 #. type: Plain text
6955 #: build/C/man3/mkfifo.3:40 build/C/man2/mknod.2:29
6956 #, no-wrap
6957 msgid ""
6958 "B<#include E<lt>fcntl.hE<gt>           >/* Definition of AT_* constants */\n"
6959 "B<#include E<lt>sys/stat.hE<gt>>\n"
6960 msgstr ""
6961
6962 #. type: Plain text
6963 #: build/C/man3/mkfifo.3:42
6964 #, no-wrap
6965 msgid ""
6966 "B<int mkfifoat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
6967 ">I<mode>B<);>\n"
6968 msgstr ""
6969
6970 #. type: Plain text
6971 #: build/C/man3/mkfifo.3:47 build/C/man2/mknod.2:37 build/C/man3/syslog.3:55
6972 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
6973 msgstr ""
6974
6975 #. type: Plain text
6976 #: build/C/man3/mkfifo.3:50
6977 msgid "B<mkfifoat>():"
6978 msgstr ""
6979
6980 #. type: TP
6981 #: build/C/man3/mkfifo.3:53
6982 #, no-wrap
6983 msgid "Since glibc 2.10:"
6984 msgstr ""
6985
6986 #. type: Plain text
6987 #: build/C/man3/mkfifo.3:56
6988 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 700 || _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
6989 msgstr ""
6990
6991 #. type: TP
6992 #: build/C/man3/mkfifo.3:56
6993 #, no-wrap
6994 msgid "Before glibc 2.10:"
6995 msgstr ""
6996
6997 #. type: Plain text
6998 #: build/C/man3/mkfifo.3:59
6999 msgid "_ATFILE_SOURCE"
7000 msgstr ""
7001
7002 #. type: Plain text
7003 #: build/C/man3/mkfifo.3:69
7004 msgid ""
7005 "B<mkfifo>()  makes a FIFO special file with name I<pathname>.  I<mode> "
7006 "specifies the FIFO's permissions.  It is modified by the process's B<umask> "
7007 "in the usual way: the permissions of the created file are B<(>I<mode>B< & "
7008 "~umask)>."
7009 msgstr ""
7010
7011 #. type: Plain text
7012 #: build/C/man3/mkfifo.3:76
7013 msgid ""
7014 "A FIFO special file is similar to a pipe, except that it is created in a "
7015 "different way.  Instead of being an anonymous communications channel, a FIFO "
7016 "special file is entered into the filesystem by calling B<mkfifo>()."
7017 msgstr ""
7018
7019 #. type: Plain text
7020 #: build/C/man3/mkfifo.3:86
7021 msgid ""
7022 "Once you have created a FIFO special file in this way, any process can open "
7023 "it for reading or writing, in the same way as an ordinary file.  However, it "
7024 "has to be open at both ends simultaneously before you can proceed to do any "
7025 "input or output operations on it.  Opening a FIFO for reading normally "
7026 "blocks until some other process opens the same FIFO for writing, and vice "
7027 "versa.  See B<fifo>(7)  for nonblocking handling of FIFO special files."
7028 msgstr ""
7029
7030 #. type: SS
7031 #: build/C/man3/mkfifo.3:86
7032 #, no-wrap
7033 msgid "mkfifoat()"
7034 msgstr ""
7035
7036 #. type: Plain text
7037 #: build/C/man3/mkfifo.3:92
7038 msgid ""
7039 "The B<mkfifoat>()  function operates in exactly the same way as B<mkfifo>(), "
7040 "except for the differences described here."
7041 msgstr ""
7042
7043 #. type: Plain text
7044 #: build/C/man3/mkfifo.3:102
7045 msgid ""
7046 "If the pathname given in I<pathname> is relative, then it is interpreted "
7047 "relative to the directory referred to by the file descriptor I<dirfd> "
7048 "(rather than relative to the current working directory of the calling "
7049 "process, as is done by B<mkfifo>()  for a relative pathname)."
7050 msgstr ""
7051
7052 #. type: Plain text
7053 #: build/C/man3/mkfifo.3:114
7054 msgid ""
7055 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
7056 "then I<pathname> is interpreted relative to the current working directory of "
7057 "the calling process (like B<mkfifo>())."
7058 msgstr ""
7059
7060 #. type: Plain text
7061 #: build/C/man3/mkfifo.3:120 build/C/man2/mknod.2:144
7062 msgid "If I<pathname> is absolute, then I<dirfd> is ignored."
7063 msgstr ""
7064
7065 #. type: Plain text
7066 #: build/C/man3/mkfifo.3:128
7067 msgid ""
7068 "On success B<mkfifo>()  and B<mkfifoat>()  return 0.  In the case of an "
7069 "error, -1 is returned (in which case, I<errno> is set appropriately)."
7070 msgstr ""
7071
7072 #. type: TP
7073 #: build/C/man3/mkfifo.3:129 build/C/man2/mknod.2:157 build/C/man4/st.4:829
7074 #, no-wrap
7075 msgid "B<EACCES>"
7076 msgstr ""
7077
7078 #. type: Plain text
7079 #: build/C/man3/mkfifo.3:133
7080 msgid ""
7081 "One of the directories in I<pathname> did not allow search (execute) "
7082 "permission."
7083 msgstr ""
7084
7085 #. type: TP
7086 #: build/C/man3/mkfifo.3:133 build/C/man2/mknod.2:165
7087 #, no-wrap
7088 msgid "B<EDQUOT>"
7089 msgstr ""
7090
7091 #. type: Plain text
7092 #: build/C/man3/mkfifo.3:137 build/C/man2/mknod.2:169
7093 msgid ""
7094 "The user's quota of disk blocks or inodes on the filesystem has been "
7095 "exhausted."
7096 msgstr ""
7097
7098 #. type: TP
7099 #: build/C/man3/mkfifo.3:137 build/C/man2/mknod.2:169
7100 #, no-wrap
7101 msgid "B<EEXIST>"
7102 msgstr ""
7103
7104 #. type: Plain text
7105 #: build/C/man3/mkfifo.3:143 build/C/man2/mknod.2:176
7106 msgid ""
7107 "I<pathname> already exists.  This includes the case where I<pathname> is a "
7108 "symbolic link, dangling or not."
7109 msgstr ""
7110
7111 #. type: TP
7112 #: build/C/man3/mkfifo.3:143 build/C/man2/mknod.2:188
7113 #, no-wrap
7114 msgid "B<ENAMETOOLONG>"
7115 msgstr ""
7116
7117 #. type: Plain text
7118 #: build/C/man3/mkfifo.3:151
7119 msgid ""
7120 "Either the total length of I<pathname> is greater than B<PATH_MAX>, or an "
7121 "individual filename component has a length greater than B<NAME_MAX>.  In the "
7122 "GNU system, there is no imposed limit on overall filename length, but some "
7123 "filesystems may place limits on the length of a component."
7124 msgstr ""
7125
7126 #. type: TP
7127 #: build/C/man3/mkfifo.3:151 build/C/man2/mknod.2:191
7128 #, no-wrap
7129 msgid "B<ENOENT>"
7130 msgstr ""
7131
7132 #. type: Plain text
7133 #: build/C/man3/mkfifo.3:155 build/C/man2/mknod.2:196
7134 msgid ""
7135 "A directory component in I<pathname> does not exist or is a dangling "
7136 "symbolic link."
7137 msgstr ""
7138
7139 #. type: TP
7140 #: build/C/man3/mkfifo.3:155 build/C/man2/mknod.2:199 build/C/man4/st.4:857
7141 #, no-wrap
7142 msgid "B<ENOSPC>"
7143 msgstr ""
7144
7145 #. type: Plain text
7146 #: build/C/man3/mkfifo.3:158
7147 msgid "The directory or filesystem has no room for the new file."
7148 msgstr ""
7149
7150 #. type: TP
7151 #: build/C/man3/mkfifo.3:158 build/C/man3/mkfifo.3:172 build/C/man2/mknod.2:204 build/C/man2/mknod.2:234
7152 #, no-wrap
7153 msgid "B<ENOTDIR>"
7154 msgstr ""
7155
7156 #. type: Plain text
7157 #: build/C/man3/mkfifo.3:162 build/C/man2/mknod.2:209
7158 msgid "A component used as a directory in I<pathname> is not, in fact, a directory."
7159 msgstr ""
7160
7161 #. type: TP
7162 #: build/C/man3/mkfifo.3:162 build/C/man2/mknod.2:223 build/C/man4/st.4:872
7163 #, no-wrap
7164 msgid "B<EROFS>"
7165 msgstr ""
7166
7167 #. type: Plain text
7168 #: build/C/man3/mkfifo.3:165
7169 msgid "I<pathname> refers to a read-only filesystem."
7170 msgstr ""
7171
7172 #. type: Plain text
7173 #: build/C/man3/mkfifo.3:168
7174 msgid "The following additional errors can occur for B<mkfifoat>():"
7175 msgstr ""
7176
7177 #. type: Plain text
7178 #: build/C/man3/mkfifo.3:172 build/C/man2/mknod.2:234
7179 msgid "I<dirfd> is not a valid file descriptor."
7180 msgstr ""
7181
7182 #. type: Plain text
7183 #: build/C/man3/mkfifo.3:178
7184 msgid ""
7185 "I<pathname> is a relative path and I<dirfd> is a file descriptor referring "
7186 "to a file other than a directory."
7187 msgstr ""
7188
7189 #. type: Plain text
7190 #: build/C/man3/mkfifo.3:184
7191 msgid ""
7192 "B<mkfifoat>()  was added to glibc in version 2.4.  It is implemented using "
7193 "B<mknodat>(2), available on Linux since kernel 2.6.16."
7194 msgstr ""
7195
7196 #. type: SH
7197 #: build/C/man3/mkfifo.3:184 build/C/man3/stdarg.3:229
7198 #, no-wrap
7199 msgid "ATTRIBUTES"
7200 msgstr ""
7201
7202 #. type: SS
7203 #: build/C/man3/mkfifo.3:185 build/C/man3/stdarg.3:230
7204 #, no-wrap
7205 msgid "Multithreading (see pthreads(7))"
7206 msgstr ""
7207
7208 #. type: Plain text
7209 #: build/C/man3/mkfifo.3:191
7210 msgid "The B<mkfifo>()  and B<mkfifoat>()  functions are thread-safe."
7211 msgstr ""
7212
7213 #. type: Plain text
7214 #: build/C/man3/mkfifo.3:194
7215 msgid "B<mkfifo>(): POSIX.1-2001, POSIX.1-2008."
7216 msgstr ""
7217
7218 #. type: Plain text
7219 #: build/C/man3/mkfifo.3:197
7220 msgid "B<mkfifoat>(): POSIX.1-2008."
7221 msgstr ""
7222
7223 #. type: Plain text
7224 #: build/C/man3/mkfifo.3:205
7225 msgid ""
7226 "B<mkfifo>(1), B<close>(2), B<open>(2), B<read>(2), B<stat>(2), B<umask>(2), "
7227 "B<write>(2), B<fifo>(7)"
7228 msgstr ""
7229
7230 #. type: TH
7231 #: build/C/man2/mknod.2:15
7232 #, no-wrap
7233 msgid "MKNOD"
7234 msgstr ""
7235
7236 #. type: TH
7237 #: build/C/man2/mknod.2:15
7238 #, no-wrap
7239 msgid "2014-02-21"
7240 msgstr ""
7241
7242 #. type: Plain text
7243 #: build/C/man2/mknod.2:18
7244 msgid "mknod, mknodat - create a special or ordinary file"
7245 msgstr ""
7246
7247 #. type: Plain text
7248 #: build/C/man2/mknod.2:24
7249 #, no-wrap
7250 msgid ""
7251 "B<#include E<lt>sys/types.hE<gt>>\n"
7252 "B<#include E<lt>sys/stat.hE<gt>>\n"
7253 "B<#include E<lt>fcntl.hE<gt>>\n"
7254 "B<#include E<lt>unistd.hE<gt>>\n"
7255 msgstr ""
7256
7257 #. type: Plain text
7258 #: build/C/man2/mknod.2:26
7259 #, no-wrap
7260 msgid ""
7261 "B<int mknod(const char *>I<pathname>B<, mode_t >I<mode>B<, dev_t "
7262 ">I<dev>B<);>\n"
7263 msgstr ""
7264
7265 #. type: Plain text
7266 #: build/C/man2/mknod.2:32
7267 #, no-wrap
7268 msgid ""
7269 "B<int mknodat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
7270 ">I<mode>B<, dev_t >I<dev>B<);>\n"
7271 msgstr ""
7272
7273 #. type: Plain text
7274 #: build/C/man2/mknod.2:40
7275 msgid "B<mknod>():"
7276 msgstr ""
7277
7278 #. type: Plain text
7279 #: build/C/man2/mknod.2:44
7280 msgid ""
7281 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
7282 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
7283 msgstr ""
7284
7285 #. type: Plain text
7286 #: build/C/man2/mknod.2:56
7287 msgid ""
7288 "The system call B<mknod>()  creates a filesystem node (file, device special "
7289 "file, or named pipe) named I<pathname>, with attributes specified by I<mode> "
7290 "and I<dev>."
7291 msgstr ""
7292
7293 #. type: Plain text
7294 #: build/C/man2/mknod.2:63
7295 msgid ""
7296 "The I<mode> argument specifies both the permissions to use and the type of "
7297 "node to be created.  It should be a combination (using bitwise OR) of one of "
7298 "the file types listed below and the permissions for the new node."
7299 msgstr ""
7300
7301 #. type: Plain text
7302 #: build/C/man2/mknod.2:68
7303 msgid ""
7304 "The permissions are modified by the process's I<umask> in the usual way: the "
7305 "permissions of the created node are I<(mode & ~umask)>."
7306 msgstr ""
7307
7308 #.  (S_IFSOCK since Linux 1.2.4)
7309 #. type: Plain text
7310 #: build/C/man2/mknod.2:82
7311 msgid ""
7312 "The file type must be one of B<S_IFREG>, B<S_IFCHR>, B<S_IFBLK>, B<S_IFIFO>, "
7313 "or B<S_IFSOCK> to specify a regular file (which will be created empty), "
7314 "character special file, block special file, FIFO (named pipe), or UNIX "
7315 "domain socket, respectively.  (Zero file type is equivalent to type "
7316 "B<S_IFREG>.)"
7317 msgstr ""
7318
7319 #. type: Plain text
7320 #: build/C/man2/mknod.2:95
7321 msgid ""
7322 "If the file type is B<S_IFCHR> or B<S_IFBLK>, then I<dev> specifies the "
7323 "major and minor numbers of the newly created device special file "
7324 "(B<makedev>(3)  may be useful to build the value for I<dev>); otherwise it "
7325 "is ignored."
7326 msgstr ""
7327
7328 #. type: Plain text
7329 #: build/C/man2/mknod.2:101
7330 msgid ""
7331 "If I<pathname> already exists, or is a symbolic link, this call fails with "
7332 "an B<EEXIST> error."
7333 msgstr ""
7334
7335 #. type: Plain text
7336 #: build/C/man2/mknod.2:110
7337 msgid ""
7338 "The newly created node will be owned by the effective user ID of the "
7339 "process.  If the directory containing the node has the set-group-ID bit set, "
7340 "or if the filesystem is mounted with BSD group semantics, the new node will "
7341 "inherit the group ownership from its parent directory; otherwise it will be "
7342 "owned by the effective group ID of the process."
7343 msgstr ""
7344
7345 #. type: SS
7346 #: build/C/man2/mknod.2:110
7347 #, no-wrap
7348 msgid "mknodat()"
7349 msgstr ""
7350
7351 #. type: Plain text
7352 #: build/C/man2/mknod.2:116
7353 msgid ""
7354 "The B<mknodat>()  system call operates in exactly the same way as "
7355 "B<mknod>(2), except for the differences described here."
7356 msgstr ""
7357
7358 #. type: Plain text
7359 #: build/C/man2/mknod.2:126
7360 msgid ""
7361 "If the pathname given in I<pathname> is relative, then it is interpreted "
7362 "relative to the directory referred to by the file descriptor I<dirfd> "
7363 "(rather than relative to the current working directory of the calling "
7364 "process, as is done by B<mknod>(2)  for a relative pathname)."
7365 msgstr ""
7366
7367 #. type: Plain text
7368 #: build/C/man2/mknod.2:138
7369 msgid ""
7370 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
7371 "then I<pathname> is interpreted relative to the current working directory of "
7372 "the calling process (like B<mknod>(2))."
7373 msgstr ""
7374
7375 #. type: Plain text
7376 #: build/C/man2/mknod.2:149
7377 msgid "See B<openat>(2)  for an explanation of the need for B<mknodat>()."
7378 msgstr ""
7379
7380 #. type: Plain text
7381 #: build/C/man2/mknod.2:156
7382 msgid ""
7383 "B<mknod>()  and B<mknodat>()  return zero on success, or -1 if an error "
7384 "occurred (in which case, I<errno> is set appropriately)."
7385 msgstr ""
7386
7387 #. type: Plain text
7388 #: build/C/man2/mknod.2:165
7389 msgid ""
7390 "The parent directory does not allow write permission to the process, or one "
7391 "of the directories in the path prefix of I<pathname> did not allow search "
7392 "permission.  (See also B<path_resolution>(7).)"
7393 msgstr ""
7394
7395 #. type: TP
7396 #: build/C/man2/mknod.2:176 build/C/man4/st.4:838
7397 #, no-wrap
7398 msgid "B<EFAULT>"
7399 msgstr ""
7400
7401 #. type: Plain text
7402 #: build/C/man2/mknod.2:179
7403 msgid "I<pathname> points outside your accessible address space."
7404 msgstr ""
7405
7406 #. type: Plain text
7407 #: build/C/man2/mknod.2:184
7408 msgid ""
7409 "I<mode> requested creation of something other than a regular file, device "
7410 "special file, FIFO or socket."
7411 msgstr ""
7412
7413 #. type: TP
7414 #: build/C/man2/mknod.2:184
7415 #, no-wrap
7416 msgid "B<ELOOP>"
7417 msgstr ""
7418
7419 #. type: Plain text
7420 #: build/C/man2/mknod.2:188
7421 msgid "Too many symbolic links were encountered in resolving I<pathname>."
7422 msgstr ""
7423
7424 #. type: Plain text
7425 #: build/C/man2/mknod.2:191
7426 msgid "I<pathname> was too long."
7427 msgstr ""
7428
7429 #. type: TP
7430 #: build/C/man2/mknod.2:196 build/C/man4/st.4:850
7431 #, no-wrap
7432 msgid "B<ENOMEM>"
7433 msgstr ""
7434
7435 #. type: Plain text
7436 #: build/C/man2/mknod.2:199
7437 msgid "Insufficient kernel memory was available."
7438 msgstr ""
7439
7440 #. type: Plain text
7441 #: build/C/man2/mknod.2:204
7442 msgid "The device containing I<pathname> has no room for the new node."
7443 msgstr ""
7444
7445 #.  For UNIX domain sockets and regular files, EPERM is returned only in
7446 #.  Linux 2.2 and earlier; in Linux 2.4 and later, unprivileged can
7447 #.  use mknod() to make these files.
7448 #. type: Plain text
7449 #: build/C/man2/mknod.2:223
7450 msgid ""
7451 "I<mode> requested creation of something other than a regular file, FIFO "
7452 "(named pipe), or UNIX domain socket, and the caller is not privileged "
7453 "(Linux: does not have the B<CAP_MKNOD> capability); also returned if the "
7454 "filesystem containing I<pathname> does not support the type of node "
7455 "requested."
7456 msgstr ""
7457
7458 #. type: Plain text
7459 #: build/C/man2/mknod.2:227
7460 msgid "I<pathname> refers to a file on a read-only filesystem."
7461 msgstr ""
7462
7463 #. type: Plain text
7464 #: build/C/man2/mknod.2:230
7465 msgid "The following additional errors can occur for B<mknodat>():"
7466 msgstr ""
7467
7468 #. type: Plain text
7469 #: build/C/man2/mknod.2:240
7470 msgid ""
7471 "I<pathname> is relative and I<dirfd> is a file descriptor referring to a "
7472 "file other than a directory."
7473 msgstr ""
7474
7475 #. type: Plain text
7476 #: build/C/man2/mknod.2:244
7477 msgid ""
7478 "B<mknodat>()  was added to Linux in kernel 2.6.16; library support was added "
7479 "to glibc in version 2.4."
7480 msgstr ""
7481
7482 #.  The Linux version differs from the SVr4 version in that it
7483 #.  does not require root permission to create pipes, also in that no
7484 #.  EMULTIHOP, ENOLINK, or EINTR error is documented.
7485 #. type: Plain text
7486 #: build/C/man2/mknod.2:250
7487 msgid "B<mknod>(): SVr4, 4.4BSD, POSIX.1-2001 (but see below), POSIX.1-2008."
7488 msgstr ""
7489
7490 #. type: Plain text
7491 #: build/C/man2/mknod.2:253
7492 msgid "B<mknodat>(): POSIX.1-2008."
7493 msgstr ""
7494
7495 #. type: Plain text
7496 #: build/C/man2/mknod.2:271
7497 msgid ""
7498 "POSIX.1-2001 says: \"The only portable use of B<mknod>()  is to create a "
7499 "FIFO-special file.  If I<mode> is not B<S_IFIFO> or I<dev> is not 0, the "
7500 "behavior of B<mknod>()  is unspecified.\" However, nowadays one should never "
7501 "use B<mknod>()  for this purpose; one should use B<mkfifo>(3), a function "
7502 "especially defined for this purpose."
7503 msgstr ""
7504
7505 #.  and one should make UNIX domain sockets with socket(2) and bind(2).
7506 #. type: Plain text
7507 #: build/C/man2/mknod.2:278
7508 msgid ""
7509 "Under Linux, B<mknod>()  cannot be used to create directories.  One should "
7510 "make directories with B<mkdir>(2)."
7511 msgstr ""
7512
7513 #. type: Plain text
7514 #: build/C/man2/mknod.2:284
7515 msgid ""
7516 "There are many infelicities in the protocol underlying NFS.  Some of these "
7517 "affect B<mknod>()  and B<mknodat>(2)."
7518 msgstr ""
7519
7520 #. type: Plain text
7521 #: build/C/man2/mknod.2:296
7522 msgid ""
7523 "B<chmod>(2), B<chown>(2), B<fcntl>(2), B<mkdir>(2), B<mount>(2), "
7524 "B<socket>(2), B<stat>(2), B<umask>(2), B<unlink>(2), B<makedev>(3), "
7525 "B<mkfifo>(3), B<path_resolution>(7)"
7526 msgstr ""
7527
7528 #. type: TH
7529 #: build/C/man4/mouse.4:26
7530 #, no-wrap
7531 msgid "MOUSE"
7532 msgstr ""
7533
7534 #. type: TH
7535 #: build/C/man4/mouse.4:26
7536 #, no-wrap
7537 msgid "1996-02-10"
7538 msgstr ""
7539
7540 #. type: Plain text
7541 #: build/C/man4/mouse.4:29
7542 msgid "mouse - serial mouse interface"
7543 msgstr ""
7544
7545 #. type: Plain text
7546 #: build/C/man4/mouse.4:33
7547 msgid ""
7548 "Serial mice are connected to a serial RS232/V24 dialout line, see B<ttyS>(4)  "
7549 "for a description."
7550 msgstr ""
7551
7552 #. type: SS
7553 #: build/C/man4/mouse.4:34
7554 #, no-wrap
7555 msgid "Introduction"
7556 msgstr ""
7557
7558 #. type: Plain text
7559 #: build/C/man4/mouse.4:36
7560 msgid "The pinout of the usual 9 pin plug as used for serial mice is:"
7561 msgstr ""
7562
7563 #. type: tbl table
7564 #: build/C/man4/mouse.4:39
7565 #, no-wrap
7566 msgid "pin\tname\tused for\n"
7567 msgstr ""
7568
7569 #. type: tbl table
7570 #: build/C/man4/mouse.4:40
7571 #, no-wrap
7572 msgid "2\tRX\tData\n"
7573 msgstr ""
7574
7575 #. type: tbl table
7576 #: build/C/man4/mouse.4:41
7577 #, no-wrap
7578 msgid "3\tTX\t-12 V, Imax = 10 mA\n"
7579 msgstr ""
7580
7581 #. type: tbl table
7582 #: build/C/man4/mouse.4:42
7583 #, no-wrap
7584 msgid "4\tDTR\t+12 V, Imax = 10 mA\n"
7585 msgstr ""
7586
7587 #. type: tbl table
7588 #: build/C/man4/mouse.4:43
7589 #, no-wrap
7590 msgid "7\tRTS\t+12 V, Imax = 10 mA\n"
7591 msgstr ""
7592
7593 #. type: tbl table
7594 #: build/C/man4/mouse.4:44
7595 #, no-wrap
7596 msgid "5\tGND\tGround\n"
7597 msgstr ""
7598
7599 #. type: Plain text
7600 #: build/C/man4/mouse.4:48
7601 msgid "This is the specification, in fact 9 V suffices with most mice."
7602 msgstr ""
7603
7604 #. type: Plain text
7605 #: build/C/man4/mouse.4:54
7606 msgid ""
7607 "The mouse driver can recognize a mouse by dropping RTS to low and raising it "
7608 "again.  About 14 ms later the mouse will send 0x4D (\\(aqM\\(aq) on the data "
7609 "line.  After a further 63 ms, a Microsoft-compatible 3-button mouse will "
7610 "send 0x33 (\\(aq3\\(aq)."
7611 msgstr ""
7612
7613 #. type: Plain text
7614 #: build/C/man4/mouse.4:66
7615 msgid ""
7616 "The relative mouse movement is sent as I<dx> (positive means right)  and "
7617 "I<dy> (positive means down).  Various mice can operate at different speeds.  "
7618 "To select speeds, cycle through the speeds 9600, 4800, 2400, and 1200 bit/s, "
7619 "each time writing the two characters from the table below and waiting 0.1 "
7620 "seconds.  The following table shows available speeds and the strings that "
7621 "select them:"
7622 msgstr ""
7623
7624 #. type: tbl table
7625 #: build/C/man4/mouse.4:69
7626 #, no-wrap
7627 msgid "bit/s\tstring\n"
7628 msgstr ""
7629
7630 #. type: tbl table
7631 #: build/C/man4/mouse.4:70
7632 #, no-wrap
7633 msgid "9600\t*q\n"
7634 msgstr ""
7635
7636 #. type: tbl table
7637 #: build/C/man4/mouse.4:71
7638 #, no-wrap
7639 msgid "4800\t*p\n"
7640 msgstr ""
7641
7642 #. type: tbl table
7643 #: build/C/man4/mouse.4:72
7644 #, no-wrap
7645 msgid "2400\t*o\n"
7646 msgstr ""
7647
7648 #. type: tbl table
7649 #: build/C/man4/mouse.4:73
7650 #, no-wrap
7651 msgid "1200\t*n\n"
7652 msgstr ""
7653
7654 #. type: Plain text
7655 #: build/C/man4/mouse.4:77
7656 msgid "The first byte of a data packet can be used to synchronization purposes."
7657 msgstr ""
7658
7659 #. type: SS
7660 #: build/C/man4/mouse.4:77
7661 #, no-wrap
7662 msgid "Microsoft protocol"
7663 msgstr ""
7664
7665 #. type: Plain text
7666 #: build/C/man4/mouse.4:93
7667 msgid ""
7668 "The B<Microsoft> protocol uses 1 start bit, 7 data bits, no parity and one "
7669 "stop bit at the speed of 1200 bits/sec.  Data is sent to RxD in 3-byte "
7670 "packets.  The I<dx> and I<dy> movements are sent as two's-complement, I<lb> "
7671 "(I<rb>)  are set when the left (right)  button is pressed:"
7672 msgstr ""
7673
7674 #. type: tbl table
7675 #: build/C/man4/mouse.4:96
7676 #, no-wrap
7677 msgid "byte\td6\td5\td4\td3\td2\td1\td0\n"
7678 msgstr ""
7679
7680 #. type: tbl table
7681 #: build/C/man4/mouse.4:97
7682 #, no-wrap
7683 msgid "1\t1\tlb\trb\tdy7\tdy6\tdx7\tdx6\n"
7684 msgstr ""
7685
7686 #. type: tbl table
7687 #: build/C/man4/mouse.4:98
7688 #, no-wrap
7689 msgid "2\t0\tdx5\tdx4\tdx3\tdx2\tdx1\tdx0\n"
7690 msgstr ""
7691
7692 #. type: tbl table
7693 #: build/C/man4/mouse.4:99
7694 #, no-wrap
7695 msgid "3\t0\tdy5\tdy4\tdy3\tdy2\tdy1\tdy0\n"
7696 msgstr ""
7697
7698 #. type: SS
7699 #: build/C/man4/mouse.4:101
7700 #, no-wrap
7701 msgid "3-button Microsoft protocol"
7702 msgstr ""
7703
7704 #. type: Plain text
7705 #: build/C/man4/mouse.4:110
7706 msgid ""
7707 "Original Microsoft mice only have two buttons.  However, there are some "
7708 "three button mice which also use the Microsoft protocol.  Pressing or "
7709 "releasing the middle button is reported by sending a packet with zero "
7710 "movement and no buttons pressed.  (Thus, unlike for the other two buttons, "
7711 "the status of the middle button is not reported in each packet.)"
7712 msgstr ""
7713
7714 #. type: SS
7715 #: build/C/man4/mouse.4:110
7716 #, no-wrap
7717 msgid "Logitech protocol"
7718 msgstr ""
7719
7720 #. type: Plain text
7721 #: build/C/man4/mouse.4:119
7722 msgid ""
7723 "Logitech serial 3-button mice use a different extension of the Microsoft "
7724 "protocol: when the middle button is up, the above 3-byte packet is sent.  "
7725 "When the middle button is down a 4-byte packet is sent, where the 4th byte "
7726 "has value 0x20 (or at least has the 0x20 bit set).  In particular, a press "
7727 "of the middle button is reported as 0,0,0,0x20 when no other buttons are "
7728 "down."
7729 msgstr ""
7730
7731 #. type: SS
7732 #: build/C/man4/mouse.4:119
7733 #, no-wrap
7734 msgid "Mousesystems protocol"
7735 msgstr ""
7736
7737 #. type: Plain text
7738 #: build/C/man4/mouse.4:137
7739 msgid ""
7740 "The B<Mousesystems> protocol uses 1 start bit, 8 data bits, no parity and "
7741 "two stop bits at the speed of 1200 bits/sec.  Data is sent to RxD in 5-byte "
7742 "packets.  I<dx> is sent as the sum of the two two's-complement values, I<dy> "
7743 "is send as negated sum of the two two's-complement values.  I<lb> (I<mb>, "
7744 "I<rb>)  are cleared when the left (middle, right) button is pressed:"
7745 msgstr ""
7746
7747 #. type: tbl table
7748 #: build/C/man4/mouse.4:140 build/C/man4/mouse.4:175
7749 #, no-wrap
7750 msgid "byte\td7\td6\td5\td4\td3\td2\td1\td0\n"
7751 msgstr ""
7752
7753 #. type: tbl table
7754 #: build/C/man4/mouse.4:141
7755 #, no-wrap
7756 msgid "1\t1\t0\t0\t0\t0\tlb\tmb\trb\n"
7757 msgstr ""
7758
7759 #. type: tbl table
7760 #: build/C/man4/mouse.4:142
7761 #, no-wrap
7762 msgid "2\t0\tdxa6\tdxa5\tdxa4\tdxa3\tdxa2\tdxa1\tdxa0\n"
7763 msgstr ""
7764
7765 #. type: tbl table
7766 #: build/C/man4/mouse.4:143
7767 #, no-wrap
7768 msgid "3\t0\tdya6\tdya5\tdya4\tdya3\tdya2\tdya1\tdya0\n"
7769 msgstr ""
7770
7771 #. type: tbl table
7772 #: build/C/man4/mouse.4:144
7773 #, no-wrap
7774 msgid "4\t0\tdxb6\tdxb5\tdxb4\tdxb3\tdxb2\tdxb1\tdxb0\n"
7775 msgstr ""
7776
7777 #. type: tbl table
7778 #: build/C/man4/mouse.4:145
7779 #, no-wrap
7780 msgid "5\t0\tdyb6\tdyb5\tdyb4\tdyb3\tdyb2\tdyb1\tdyb0\n"
7781 msgstr ""
7782
7783 #. type: Plain text
7784 #: build/C/man4/mouse.4:150
7785 msgid ""
7786 "Bytes 4 and 5 describe the change that occurred since bytes 2 and 3 were "
7787 "transmitted."
7788 msgstr ""
7789
7790 #. type: SS
7791 #: build/C/man4/mouse.4:150
7792 #, no-wrap
7793 msgid "Sun protocol"
7794 msgstr ""
7795
7796 #. type: Plain text
7797 #: build/C/man4/mouse.4:155
7798 msgid ""
7799 "The B<Sun> protocol is the 3-byte version of the above 5-byte Mousesystems "
7800 "protocol: the last two bytes are not sent."
7801 msgstr ""
7802
7803 #. type: SS
7804 #: build/C/man4/mouse.4:155
7805 #, no-wrap
7806 msgid "MM protocol"
7807 msgstr ""
7808
7809 #. type: Plain text
7810 #: build/C/man4/mouse.4:172
7811 msgid ""
7812 "The B<MM> protocol uses 1 start bit, 8 data bits, odd parity and one stop "
7813 "bit at the speed of 1200 bits/sec.  Data is sent to RxD in 3-byte packets.  "
7814 "I<dx> and I<dy> are sent as single signed values, the sign bit indicating a "
7815 "negative value.  I<lb> (I<mb>, I<rb>)  are set when the left (middle, right) "
7816 "button is pressed:"
7817 msgstr ""
7818
7819 #. type: tbl table
7820 #: build/C/man4/mouse.4:176
7821 #, no-wrap
7822 msgid "1\t1\t0\t0\tdxs\tdys\tlb\tmb\trb\n"
7823 msgstr ""
7824
7825 #. type: tbl table
7826 #: build/C/man4/mouse.4:177
7827 #, no-wrap
7828 msgid "2\t0\tdx6\tdx5\tdx4\tdx3\tdx2\tdx1\tdx0\n"
7829 msgstr ""
7830
7831 #. type: tbl table
7832 #: build/C/man4/mouse.4:178
7833 #, no-wrap
7834 msgid "3\t0\tdy6\tdy5\tdy4\tdy3\tdy2\tdy1\tdy0\n"
7835 msgstr ""
7836
7837 #. type: TP
7838 #: build/C/man4/mouse.4:181
7839 #, no-wrap
7840 msgid "I</dev/mouse>"
7841 msgstr ""
7842
7843 #. type: Plain text
7844 #: build/C/man4/mouse.4:184
7845 msgid "A commonly used symlink pointing to a mouse device."
7846 msgstr ""
7847
7848 #. type: Plain text
7849 #: build/C/man4/mouse.4:186
7850 msgid "B<ttyS>(4), B<gpm>(8)"
7851 msgstr ""
7852
7853 #. type: TH
7854 #: build/C/man4/msr.4:26
7855 #, no-wrap
7856 msgid "MSR"
7857 msgstr ""
7858
7859 #. type: Plain text
7860 #: build/C/man4/msr.4:29
7861 msgid "msr - x86 CPU MSR access device"
7862 msgstr ""
7863
7864 #. type: Plain text
7865 #: build/C/man4/msr.4:36
7866 msgid ""
7867 "I</dev/cpu/CPUNUM/msr> provides an interface to read and write the "
7868 "model-specific registers (MSRs) of an x86 CPU.  I<CPUNUM> is the number of "
7869 "the CPU to access as listed in I</proc/cpuinfo>."
7870 msgstr ""
7871
7872 #. type: Plain text
7873 #: build/C/man4/msr.4:42
7874 msgid ""
7875 "The register access is done by opening the file and seeking to the MSR "
7876 "number as offset in the file, and then reading or writing in chunks of 8 "
7877 "bytes.  An I/O transfer of more than 8 bytes means multiple reads or writes "
7878 "of the same register."
7879 msgstr ""
7880
7881 #. type: Plain text
7882 #: build/C/man4/msr.4:47
7883 msgid ""
7884 "This file is protected so that it can be read and written only by the user "
7885 "I<root>, or members of the group I<root>."
7886 msgstr ""
7887
7888 #. type: Plain text
7889 #: build/C/man4/msr.4:53
7890 msgid ""
7891 "The I<msr> driver is not auto-loaded.  On modular kernels you might need to "
7892 "use the following command to load it explicitly before use:"
7893 msgstr ""
7894
7895 #. type: Plain text
7896 #: build/C/man4/msr.4:55
7897 #, no-wrap
7898 msgid "    $ I<modprobe msr>\n"
7899 msgstr ""
7900
7901 #. type: Plain text
7902 #: build/C/man4/msr.4:58
7903 msgid ""
7904 "Intel Corporation Intel 64 and IA-32 Architectures Software Developer's "
7905 "Manual Volume 3B Appendix B, for an overview of the Intel CPU MSRs."
7906 msgstr ""
7907
7908 #. type: TH
7909 #: build/C/man4/null.4:26
7910 #, no-wrap
7911 msgid "NULL"
7912 msgstr ""
7913
7914 #. type: TH
7915 #: build/C/man4/null.4:26
7916 #, no-wrap
7917 msgid "2009-02-23"
7918 msgstr ""
7919
7920 #. type: Plain text
7921 #: build/C/man4/null.4:29
7922 msgid "null, zero - data sink"
7923 msgstr ""
7924
7925 #. type: Plain text
7926 #: build/C/man4/null.4:35
7927 msgid "Data written to a B<null> or B<zero> special file is discarded."
7928 msgstr ""
7929
7930 #. type: Plain text
7931 #: build/C/man4/null.4:44
7932 msgid ""
7933 "Reads from the B<null> special file always return end of file (i.e., "
7934 "B<read>(2)  returns 0), whereas reads from B<zero> always return bytes "
7935 "containing zero (\\e0 characters)."
7936 msgstr ""
7937
7938 #. type: Plain text
7939 #: build/C/man4/null.4:49
7940 msgid "B<null> and B<zero> are typically created by:"
7941 msgstr ""
7942
7943 #. type: Plain text
7944 #: build/C/man4/null.4:52
7945 msgid "mknod -m 666 /dev/null c 1 3"
7946 msgstr ""
7947
7948 #. type: Plain text
7949 #: build/C/man4/null.4:54
7950 msgid "mknod -m 666 /dev/zero c 1 5"
7951 msgstr ""
7952
7953 #. type: Plain text
7954 #: build/C/man4/null.4:56
7955 msgid "chown root:root /dev/null /dev/zero"
7956 msgstr ""
7957
7958 #. type: Plain text
7959 #: build/C/man4/null.4:59
7960 msgid "I</dev/null>"
7961 msgstr ""
7962
7963 #. type: Plain text
7964 #: build/C/man4/null.4:61
7965 msgid "I</dev/zero>"
7966 msgstr ""
7967
7968 #. type: Plain text
7969 #: build/C/man4/null.4:64
7970 msgid ""
7971 "If these devices are not writable and readable for all users, many programs "
7972 "will act strangely."
7973 msgstr ""
7974
7975 #. type: Plain text
7976 #: build/C/man4/null.4:67
7977 msgid "B<chown>(1), B<mknod>(1), B<full>(4)"
7978 msgstr ""
7979
7980 #. type: TH
7981 #: build/C/man7/pipe.7:25
7982 #, no-wrap
7983 msgid "PIPE"
7984 msgstr ""
7985
7986 #. type: TH
7987 #: build/C/man7/pipe.7:25 build/C/man2/syslog.2:33
7988 #, no-wrap
7989 msgid "2014-07-08"
7990 msgstr ""
7991
7992 #. type: Plain text
7993 #: build/C/man7/pipe.7:28
7994 msgid "pipe - overview of pipes and FIFOs"
7995 msgstr ""
7996
7997 #. type: Plain text
7998 #: build/C/man7/pipe.7:37
7999 msgid ""
8000 "Pipes and FIFOs (also known as named pipes)  provide a unidirectional "
8001 "interprocess communication channel.  A pipe has a I<read end> and a I<write "
8002 "end>.  Data written to the write end of a pipe can be read from the read end "
8003 "of the pipe."
8004 msgstr ""
8005
8006 #. type: Plain text
8007 #: build/C/man7/pipe.7:47
8008 msgid ""
8009 "A pipe is created using B<pipe>(2), which creates a new pipe and returns two "
8010 "file descriptors, one referring to the read end of the pipe, the other "
8011 "referring to the write end.  Pipes can be used to create a communication "
8012 "channel between related processes; see B<pipe>(2)  for an example."
8013 msgstr ""
8014
8015 #. type: Plain text
8016 #: build/C/man7/pipe.7:66
8017 msgid ""
8018 "A FIFO (short for First In First Out) has a name within the filesystem "
8019 "(created using B<mkfifo>(3)), and is opened using B<open>(2).  Any process "
8020 "may open a FIFO, assuming the file permissions allow it.  The read end is "
8021 "opened using the B<O_RDONLY> flag; the write end is opened using the "
8022 "B<O_WRONLY> flag.  See B<fifo>(7)  for further details.  I<Note>: although "
8023 "FIFOs have a pathname in the filesystem, I/O on FIFOs does not involve "
8024 "operations on the underlying device (if there is one)."
8025 msgstr ""
8026
8027 #. type: SS
8028 #: build/C/man7/pipe.7:66
8029 #, no-wrap
8030 msgid "I/O on pipes and FIFOs"
8031 msgstr ""
8032
8033 #. type: Plain text
8034 #: build/C/man7/pipe.7:71
8035 msgid ""
8036 "The only difference between pipes and FIFOs is the manner in which they are "
8037 "created and opened.  Once these tasks have been accomplished, I/O on pipes "
8038 "and FIFOs has exactly the same semantics."
8039 msgstr ""
8040
8041 #. type: Plain text
8042 #: build/C/man7/pipe.7:85
8043 msgid ""
8044 "If a process attempts to read from an empty pipe, then B<read>(2)  will "
8045 "block until data is available.  If a process attempts to write to a full "
8046 "pipe (see below), then B<write>(2)  blocks until sufficient data has been "
8047 "read from the pipe to allow the write to complete.  Nonblocking I/O is "
8048 "possible by using the B<fcntl>(2)  B<F_SETFL> operation to enable the "
8049 "B<O_NONBLOCK> open file status flag."
8050 msgstr ""
8051
8052 #. type: Plain text
8053 #: build/C/man7/pipe.7:89
8054 msgid ""
8055 "The communication channel provided by a pipe is a I<byte stream>: there is "
8056 "no concept of message boundaries."
8057 msgstr ""
8058
8059 #. type: Plain text
8060 #: build/C/man7/pipe.7:116
8061 msgid ""
8062 "If all file descriptors referring to the write end of a pipe have been "
8063 "closed, then an attempt to B<read>(2)  from the pipe will see end-of-file "
8064 "(B<read>(2)  will return 0).  If all file descriptors referring to the read "
8065 "end of a pipe have been closed, then a B<write>(2)  will cause a B<SIGPIPE> "
8066 "signal to be generated for the calling process.  If the calling process is "
8067 "ignoring this signal, then B<write>(2)  fails with the error B<EPIPE>.  An "
8068 "application that uses B<pipe>(2)  and B<fork>(2)  should use suitable "
8069 "B<close>(2)  calls to close unnecessary duplicate file descriptors; this "
8070 "ensures that end-of-file and B<SIGPIPE>/B<EPIPE> are delivered when "
8071 "appropriate."
8072 msgstr ""
8073
8074 #. type: Plain text
8075 #: build/C/man7/pipe.7:120
8076 msgid "It is not possible to apply B<lseek>(2)  to a pipe."
8077 msgstr ""
8078
8079 #. type: SS
8080 #: build/C/man7/pipe.7:120
8081 #, no-wrap
8082 msgid "Pipe capacity"
8083 msgstr ""
8084
8085 #. type: Plain text
8086 #: build/C/man7/pipe.7:132
8087 msgid ""
8088 "A pipe has a limited capacity.  If the pipe is full, then a B<write>(2)  "
8089 "will block or fail, depending on whether the B<O_NONBLOCK> flag is set (see "
8090 "below).  Different implementations have different limits for the pipe "
8091 "capacity.  Applications should not rely on a particular capacity: an "
8092 "application should be designed so that a reading process consumes data as "
8093 "soon as it is available, so that a writing process does not remain blocked."
8094 msgstr ""
8095
8096 #. type: Plain text
8097 #: build/C/man7/pipe.7:146
8098 msgid ""
8099 "In Linux versions before 2.6.11, the capacity of a pipe was the same as the "
8100 "system page size (e.g., 4096 bytes on i386).  Since Linux 2.6.11, the pipe "
8101 "capacity is 65536 bytes.  Since Linux 2.6.35, the default pipe capacity is "
8102 "65536 bytes, but the capacity can be queried and set using the B<fcntl>(2)  "
8103 "B<F_GETPIPE_SZ> and B<F_SETPIPE_SZ> operations.  See B<fcntl>(2)  for more "
8104 "information."
8105 msgstr ""
8106
8107 #. type: SS
8108 #: build/C/man7/pipe.7:147
8109 #, no-wrap
8110 msgid "PIPE_BUF"
8111 msgstr ""
8112
8113 #. type: Plain text
8114 #: build/C/man7/pipe.7:169
8115 msgid ""
8116 "POSIX.1-2001 says that B<write>(2)s of less than B<PIPE_BUF> bytes must be "
8117 "atomic: the output data is written to the pipe as a contiguous sequence.  "
8118 "Writes of more than B<PIPE_BUF> bytes may be nonatomic: the kernel may "
8119 "interleave the data with data written by other processes.  POSIX.1-2001 "
8120 "requires B<PIPE_BUF> to be at least 512 bytes.  (On Linux, B<PIPE_BUF> is "
8121 "4096 bytes.)  The precise semantics depend on whether the file descriptor is "
8122 "nonblocking (B<O_NONBLOCK>), whether there are multiple writers to the pipe, "
8123 "and on I<n>, the number of bytes to be written:"
8124 msgstr ""
8125
8126 #. type: TP
8127 #: build/C/man7/pipe.7:169
8128 #, no-wrap
8129 msgid "B<O_NONBLOCK> disabled, I<n> E<lt>= B<PIPE_BUF>"
8130 msgstr ""
8131
8132 #. type: Plain text
8133 #: build/C/man7/pipe.7:178
8134 msgid ""
8135 "All I<n> bytes are written atomically; B<write>(2)  may block if there is "
8136 "not room for I<n> bytes to be written immediately"
8137 msgstr ""
8138
8139 #. type: TP
8140 #: build/C/man7/pipe.7:178
8141 #, no-wrap
8142 msgid "B<O_NONBLOCK> enabled, I<n> E<lt>= B<PIPE_BUF>"
8143 msgstr ""
8144
8145 #. type: Plain text
8146 #: build/C/man7/pipe.7:192
8147 msgid ""
8148 "If there is room to write I<n> bytes to the pipe, then B<write>(2)  succeeds "
8149 "immediately, writing all I<n> bytes; otherwise B<write>(2)  fails, with "
8150 "I<errno> set to B<EAGAIN>."
8151 msgstr ""
8152
8153 #. type: TP
8154 #: build/C/man7/pipe.7:192
8155 #, no-wrap
8156 msgid "B<O_NONBLOCK> disabled, I<n> E<gt> B<PIPE_BUF>"
8157 msgstr ""
8158
8159 #. type: Plain text
8160 #: build/C/man7/pipe.7:204
8161 msgid ""
8162 "The write is nonatomic: the data given to B<write>(2)  may be interleaved "
8163 "with B<write>(2)s by other process; the B<write>(2)  blocks until I<n> bytes "
8164 "have been written."
8165 msgstr ""
8166
8167 #. type: TP
8168 #: build/C/man7/pipe.7:204
8169 #, no-wrap
8170 msgid "B<O_NONBLOCK> enabled, I<n> E<gt> B<PIPE_BUF>"
8171 msgstr ""
8172
8173 #. type: Plain text
8174 #: build/C/man7/pipe.7:219
8175 msgid ""
8176 "If the pipe is full, then B<write>(2)  fails, with I<errno> set to "
8177 "B<EAGAIN>.  Otherwise, from 1 to I<n> bytes may be written (i.e., a "
8178 "\"partial write\" may occur; the caller should check the return value from "
8179 "B<write>(2)  to see how many bytes were actually written), and these bytes "
8180 "may be interleaved with writes by other processes."
8181 msgstr ""
8182
8183 #. type: SS
8184 #: build/C/man7/pipe.7:219
8185 #, no-wrap
8186 msgid "Open file status flags"
8187 msgstr ""
8188
8189 #. type: Plain text
8190 #: build/C/man7/pipe.7:225
8191 msgid ""
8192 "The only open file status flags that can be meaningfully applied to a pipe "
8193 "or FIFO are B<O_NONBLOCK> and B<O_ASYNC>."
8194 msgstr ""
8195
8196 #. type: Plain text
8197 #: build/C/man7/pipe.7:237
8198 msgid ""
8199 "Setting the B<O_ASYNC> flag for the read end of a pipe causes a signal "
8200 "(B<SIGIO> by default) to be generated when new input becomes available on "
8201 "the pipe (see B<fcntl>(2)  for details).  On Linux, B<O_ASYNC> is supported "
8202 "for pipes and FIFOs only since kernel 2.6."
8203 msgstr ""
8204
8205 #. type: SS
8206 #: build/C/man7/pipe.7:237
8207 #, no-wrap
8208 msgid "Portability notes"
8209 msgstr ""
8210
8211 #. type: Plain text
8212 #: build/C/man7/pipe.7:243
8213 msgid ""
8214 "On some systems (but not Linux), pipes are bidirectional: data can be "
8215 "transmitted in both directions between the pipe ends.  According to "
8216 "POSIX.1-2001, pipes only need to be unidirectional.  Portable applications "
8217 "should avoid reliance on bidirectional pipe semantics."
8218 msgstr ""
8219
8220 #. type: Plain text
8221 #: build/C/man7/pipe.7:254
8222 msgid ""
8223 "B<dup>(2), B<fcntl>(2), B<open>(2), B<pipe>(2), B<poll>(2), B<select>(2), "
8224 "B<socketpair>(2), B<stat>(2), B<mkfifo>(3), B<epoll>(7), B<fifo>(7)"
8225 msgstr ""
8226
8227 #. type: TH
8228 #: build/C/man4/ram.4:26
8229 #, no-wrap
8230 msgid "RAM"
8231 msgstr ""
8232
8233 #. type: TH
8234 #: build/C/man4/ram.4:26
8235 #, no-wrap
8236 msgid "1992-11-21"
8237 msgstr ""
8238
8239 #. type: Plain text
8240 #: build/C/man4/ram.4:29
8241 msgid "ram - ram disk device"
8242 msgstr ""
8243
8244 #. type: Plain text
8245 #: build/C/man4/ram.4:33
8246 msgid "The I<ram> device is a block device to access the ram disk in raw mode."
8247 msgstr ""
8248
8249 #. type: Plain text
8250 #: build/C/man4/ram.4:38
8251 msgid "mknod -m 660 /dev/ram b 1 1"
8252 msgstr ""
8253
8254 #. type: Plain text
8255 #: build/C/man4/ram.4:40
8256 msgid "chown root:disk /dev/ram"
8257 msgstr ""
8258
8259 #. type: Plain text
8260 #: build/C/man4/ram.4:43
8261 msgid "/dev/ram"
8262 msgstr ""
8263
8264 #. type: Plain text
8265 #: build/C/man4/ram.4:46
8266 msgid "B<chown>(1), B<mknod>(1), B<mount>(8)"
8267 msgstr ""
8268
8269 #. type: TH
8270 #: build/C/man4/random.4:19
8271 #, no-wrap
8272 msgid "RANDOM"
8273 msgstr ""
8274
8275 #. type: TH
8276 #: build/C/man4/random.4:19
8277 #, no-wrap
8278 msgid "2015-01-10"
8279 msgstr ""
8280
8281 #. type: Plain text
8282 #: build/C/man4/random.4:22
8283 msgid "random, urandom - kernel random number source devices"
8284 msgstr ""
8285
8286 #. type: Plain text
8287 #: build/C/man4/random.4:24
8288 msgid "#include E<lt>linux/random.hE<gt>"
8289 msgstr ""
8290
8291 #. type: Plain text
8292 #: build/C/man4/random.4:26
8293 msgid "B<int ioctl(>I<fd>B<, RND>I<request>B<, >I<param>B<);>"
8294 msgstr ""
8295
8296 #. type: Plain text
8297 #: build/C/man4/random.4:33
8298 msgid ""
8299 "The character special files I</dev/random> and I</dev/urandom> (present "
8300 "since Linux 1.3.30)  provide an interface to the kernel's random number "
8301 "generator.  File I</dev/random> has major device number 1 and minor device "
8302 "number 8.  File I</dev/urandom> has major device number 1 and minor device "
8303 "number 9."
8304 msgstr ""
8305
8306 #. type: Plain text
8307 #: build/C/man4/random.4:39
8308 msgid ""
8309 "The random number generator gathers environmental noise from device drivers "
8310 "and other sources into an entropy pool.  The generator also keeps an "
8311 "estimate of the number of bits of noise in the entropy pool.  From this "
8312 "entropy pool random numbers are created."
8313 msgstr ""
8314
8315 #. type: Plain text
8316 #: build/C/man4/random.4:63
8317 msgid ""
8318 "When read, the I</dev/random> device will only return random bytes within "
8319 "the estimated number of bits of noise in the entropy pool.  I</dev/random> "
8320 "should be suitable for uses that need very high quality randomness such as "
8321 "one-time pad or key generation.  When the entropy pool is empty, reads from "
8322 "I</dev/random> will block until additional environmental noise is gathered.  "
8323 "If B<open>(2)  is called for I</dev/random> with flag B<O_NONBLOCK>, a "
8324 "subsequent B<read>(2)  will not block if the requested number of bytes is "
8325 "not available.  Instead, the available bytes are returned.  If no byte is "
8326 "available B<read>(2)  will return -1 and I<errno> will be set to B<EAGAIN>."
8327 msgstr ""
8328
8329 #. type: Plain text
8330 #: build/C/man4/random.4:84
8331 msgid ""
8332 "A read from the I</dev/urandom> device will not block waiting for more "
8333 "entropy.  If there is not sufficient entropy, a pseudorandom number "
8334 "generator is used to create the requested bytes.  As a result, in this case "
8335 "the returned values are theoretically vulnerable to a cryptographic attack "
8336 "on the algorithms used by the driver.  Knowledge of how to do this is not "
8337 "available in the current unclassified literature, but it is theoretically "
8338 "possible that such an attack may exist.  If this is a concern in your "
8339 "application, use I</dev/random> instead.  B<O_NONBLOCK> has no effect when "
8340 "opening I</dev/urandom>.  When calling B<read>(2)  for device "
8341 "I</dev/urandom> signals will not be handled until after the requested random "
8342 "bytes have been generated."
8343 msgstr ""
8344
8345 #. type: Plain text
8346 #: build/C/man4/random.4:91
8347 msgid ""
8348 "Writing to I</dev/random> or I</dev/urandom> will update the entropy pool "
8349 "with the data written, but this will not result in a higher entropy count.  "
8350 "This means that it will impact the contents read from both files, but it "
8351 "will not make reads from I</dev/random> faster."
8352 msgstr ""
8353
8354 #. type: Plain text
8355 #: build/C/man4/random.4:100
8356 msgid ""
8357 "If you are unsure about whether you should use I</dev/random> or "
8358 "I</dev/urandom>, then probably you want to use the latter.  As a general "
8359 "rule, I</dev/urandom> should be used for everything except long-lived "
8360 "GPG/SSL/SSH keys."
8361 msgstr ""
8362
8363 #. type: Plain text
8364 #: build/C/man4/random.4:112
8365 msgid ""
8366 "If a seed file is saved across reboots as recommended below (all major Linux "
8367 "distributions have done this since 2000 at least), the output is "
8368 "cryptographically secure against attackers without local root access as soon "
8369 "as it is reloaded in the boot sequence, and perfectly adequate for network "
8370 "encryption session keys.  Since reads from I</dev/random> may block, users "
8371 "will usually want to open it in nonblocking mode (or perform a read with "
8372 "timeout), and provide some sort of user notification if the desired entropy "
8373 "is not immediately available."
8374 msgstr ""
8375
8376 #. type: Plain text
8377 #: build/C/man4/random.4:125
8378 msgid ""
8379 "The kernel random-number generator is designed to produce a small amount of "
8380 "high-quality seed material to seed a cryptographic pseudo-random number "
8381 "generator (CPRNG).  It is designed for security, not speed, and is poorly "
8382 "suited to generating large amounts of random data.  Users should be very "
8383 "economical in the amount of seed material that they read from "
8384 "I</dev/urandom> (and I</dev/random>); unnecessarily reading large quantities "
8385 "of data from this device will have a negative impact on other users of the "
8386 "device."
8387 msgstr ""
8388
8389 #. type: Plain text
8390 #: build/C/man4/random.4:133
8391 msgid ""
8392 "The amount of seed material required to generate a cryptographic key equals "
8393 "the effective key size of the key.  For example, a 3072-bit RSA or "
8394 "Diffie-Hellman private key has an effective key size of 128 bits (it "
8395 "requires about 2^128 operations to break) so a key generator only needs 128 "
8396 "bits (16 bytes) of seed material from I</dev/random>."
8397 msgstr ""
8398
8399 #. type: Plain text
8400 #: build/C/man4/random.4:142
8401 msgid ""
8402 "While some safety margin above that minimum is reasonable, as a guard "
8403 "against flaws in the CPRNG algorithm, no cryptographic primitive available "
8404 "today can hope to promise more than 256 bits of security, so if any program "
8405 "reads more than 256 bits (32 bytes) from the kernel random pool per "
8406 "invocation, or per reasonable reseed interval (not less than one minute), "
8407 "that should be taken as a sign that its cryptography is I<not> skillfully "
8408 "implemented."
8409 msgstr ""
8410
8411 #. type: SS
8412 #: build/C/man4/random.4:142
8413 #, no-wrap
8414 msgid "Configuration"
8415 msgstr ""
8416
8417 #. type: Plain text
8418 #: build/C/man4/random.4:146
8419 msgid ""
8420 "If your system does not have I</dev/random> and I</dev/urandom> created "
8421 "already, they can be created with the following commands:"
8422 msgstr ""
8423
8424 #. type: Plain text
8425 #: build/C/man4/random.4:151
8426 #, no-wrap
8427 msgid ""
8428 "    mknod -m 644 /dev/random c 1 8\n"
8429 "    mknod -m 644 /dev/urandom c 1 9\n"
8430 "    chown root:root /dev/random /dev/urandom\n"
8431 msgstr ""
8432
8433 #. type: Plain text
8434 #: build/C/man4/random.4:161
8435 msgid ""
8436 "When a Linux system starts up without much operator interaction, the entropy "
8437 "pool may be in a fairly predictable state.  This reduces the actual amount "
8438 "of noise in the entropy pool below the estimate.  In order to counteract "
8439 "this effect, it helps to carry entropy pool information across shut-downs "
8440 "and start-ups.  To do this, add the following lines to an appropriate script "
8441 "which is run during the Linux system start-up sequence:"
8442 msgstr ""
8443
8444 #. type: Plain text
8445 #: build/C/man4/random.4:176
8446 #, no-wrap
8447 msgid ""
8448 "    echo \"Initializing random number generator...\"\n"
8449 "    random_seed=/var/run/random-seed\n"
8450 "    # Carry a random seed from start-up to start-up\n"
8451 "    # Load and then save the whole entropy pool\n"
8452 "    if [ -f $random_seed ]; then\n"
8453 "        cat $random_seed E<gt>/dev/urandom\n"
8454 "    else\n"
8455 "        touch $random_seed\n"
8456 "    fi\n"
8457 "    chmod 600 $random_seed\n"
8458 "    poolfile=/proc/sys/kernel/random/poolsize\n"
8459 "    [ -r $poolfile ] && bytes=\\`cat $poolfile\\` || bytes=512\n"
8460 "    dd if=/dev/urandom of=$random_seed count=1 bs=$bytes\n"
8461 msgstr ""
8462
8463 #. type: Plain text
8464 #: build/C/man4/random.4:180
8465 msgid ""
8466 "Also, add the following lines in an appropriate script which is run during "
8467 "the Linux system shutdown:"
8468 msgstr ""
8469
8470 #. type: Plain text
8471 #: build/C/man4/random.4:191
8472 #, no-wrap
8473 msgid ""
8474 "    # Carry a random seed from shut-down to start-up\n"
8475 "    # Save the whole entropy pool\n"
8476 "    echo \"Saving random seed...\"\n"
8477 "    random_seed=/var/run/random-seed\n"
8478 "    touch $random_seed\n"
8479 "    chmod 600 $random_seed\n"
8480 "    poolfile=/proc/sys/kernel/random/poolsize\n"
8481 "    [ -r $poolfile ] && bytes=\\`cat $poolfile\\` || bytes=512\n"
8482 "    dd if=/dev/urandom of=$random_seed count=1 bs=$bytes\n"
8483 msgstr ""
8484
8485 #. type: SS
8486 #: build/C/man4/random.4:192
8487 #, no-wrap
8488 msgid "/proc Interface"
8489 msgstr ""
8490
8491 #. type: Plain text
8492 #: build/C/man4/random.4:198
8493 msgid ""
8494 "The files in the directory I</proc/sys/kernel/random> (present since 2.3.16) "
8495 "provide an additional interface to the I</dev/random> device."
8496 msgstr ""
8497
8498 #. type: Plain text
8499 #: build/C/man4/random.4:204
8500 msgid ""
8501 "The read-only file I<entropy_avail> gives the available entropy.  Normally, "
8502 "this will be 4096 (bits), a full entropy pool."
8503 msgstr ""
8504
8505 #. type: Plain text
8506 #: build/C/man4/random.4:209
8507 msgid ""
8508 "The file I<poolsize> gives the size of the entropy pool.  The semantics of "
8509 "this file vary across kernel versions:"
8510 msgstr ""
8511
8512 #. type: TP
8513 #: build/C/man4/random.4:210
8514 #, no-wrap
8515 msgid "Linux 2.4:"
8516 msgstr ""
8517
8518 #. type: Plain text
8519 #: build/C/man4/random.4:217
8520 msgid ""
8521 "This file gives the size of the entropy pool in I<bytes>.  Normally, this "
8522 "file will have the value 512, but it is writable, and can be changed to any "
8523 "value for which an algorithm is available.  The choices are 32, 64, 128, "
8524 "256, 512, 1024, or 2048."
8525 msgstr ""
8526
8527 #. type: TP
8528 #: build/C/man4/random.4:217
8529 #, no-wrap
8530 msgid "Linux 2.6:"
8531 msgstr ""
8532
8533 #. type: Plain text
8534 #: build/C/man4/random.4:222
8535 msgid ""
8536 "This file is read-only, and gives the size of the entropy pool in I<bits>.  "
8537 "It contains the value 4096."
8538 msgstr ""
8539
8540 #. type: Plain text
8541 #: build/C/man4/random.4:240
8542 msgid ""
8543 "The file I<read_wakeup_threshold> contains the number of bits of entropy "
8544 "required for waking up processes that sleep waiting for entropy from "
8545 "I</dev/random>.  The default is 64.  The file I<write_wakeup_threshold> "
8546 "contains the number of bits of entropy below which we wake up processes that "
8547 "do a B<select>(2)  or B<poll>(2)  for write access to I</dev/random>.  These "
8548 "values can be changed by writing to the files."
8549 msgstr ""
8550
8551 #. type: Plain text
8552 #: build/C/man4/random.4:248
8553 msgid ""
8554 "The read-only files I<uuid> and I<boot_id> contain random strings like "
8555 "6fd5a44b-35f4-4ad4-a9b9-6b9be13e1fe9.  The former is generated afresh for "
8556 "each read, the latter was generated once."
8557 msgstr ""
8558
8559 #. type: SS
8560 #: build/C/man4/random.4:248
8561 #, no-wrap
8562 msgid "ioctl(2) interface"
8563 msgstr ""
8564
8565 #. type: Plain text
8566 #: build/C/man4/random.4:259
8567 msgid ""
8568 "The following B<ioctl>(2)  requests are defined on file descriptors "
8569 "connected to either I</dev/random> or I</dev/urandom>.  All requests "
8570 "performed will interact with the input entropy pool impacting both "
8571 "I</dev/random> and I</dev/urandom>.  The B<CAP_SYS_ADMIN> capability is "
8572 "required for all requests except B<RNDGETENTCNT>."
8573 msgstr ""
8574
8575 #. type: TP
8576 #: build/C/man4/random.4:259
8577 #, no-wrap
8578 msgid "B<RNDGETENTCNT>"
8579 msgstr ""
8580
8581 #. type: Plain text
8582 #: build/C/man4/random.4:266
8583 msgid ""
8584 "Retrieve the entropy count of the input pool, the contents will be the same "
8585 "as the I<entropy_avail> file under proc.  The result will be stored in the "
8586 "int pointed to by the argument."
8587 msgstr ""
8588
8589 #. type: TP
8590 #: build/C/man4/random.4:266
8591 #, no-wrap
8592 msgid "B<RNDADDTOENTCNT>"
8593 msgstr ""
8594
8595 #. type: Plain text
8596 #: build/C/man4/random.4:270
8597 msgid ""
8598 "Increment or decrement the entropy count of the input pool by the value "
8599 "pointed to by the argument."
8600 msgstr ""
8601
8602 #. type: TP
8603 #: build/C/man4/random.4:270
8604 #, no-wrap
8605 msgid "B<RNDGETPOOL>"
8606 msgstr ""
8607
8608 #. type: Plain text
8609 #: build/C/man4/random.4:273
8610 msgid "Removed in Linux 2.6.9."
8611 msgstr ""
8612
8613 #. type: TP
8614 #: build/C/man4/random.4:273
8615 #, no-wrap
8616 msgid "B<RNDADDENTROPY>"
8617 msgstr ""
8618
8619 #. type: Plain text
8620 #: build/C/man4/random.4:281
8621 msgid ""
8622 "Add some additional entropy to the input pool, incrementing the entropy "
8623 "count.  This differs from writing to I</dev/random> or I</dev/urandom>, "
8624 "which only adds some data but does not increment the entropy count.  The "
8625 "following structure is used:"
8626 msgstr ""
8627
8628 #. type: Plain text
8629 #: build/C/man4/random.4:288
8630 #, no-wrap
8631 msgid ""
8632 "    struct rand_pool_info {\n"
8633 "        int    entropy_count;\n"
8634 "        int    buf_size;\n"
8635 "        __u32  buf[0];\n"
8636 "    };\n"
8637 msgstr ""
8638
8639 #. type: Plain text
8640 #: build/C/man4/random.4:297
8641 msgid ""
8642 "Here I<entropy_count> is the value added to (or subtracted from) the entropy "
8643 "count, and I<buf> is the buffer of size I<buf_size> which gets added to the "
8644 "entropy pool."
8645 msgstr ""
8646
8647 #. type: TP
8648 #: build/C/man4/random.4:297
8649 #, no-wrap
8650 msgid "B<RNDZAPENTCNT>, B<RNDCLEARPOOL>"
8651 msgstr ""
8652
8653 #. type: Plain text
8654 #: build/C/man4/random.4:301
8655 msgid ""
8656 "Zero the entropy count of all pools and add some system data (such as wall "
8657 "clock) to the pools."
8658 msgstr ""
8659
8660 #. type: Plain text
8661 #: build/C/man4/random.4:303
8662 msgid "/dev/random"
8663 msgstr ""
8664
8665 #.  .SH AUTHOR
8666 #.  The kernel's random number generator was written by
8667 #.  Theodore Ts'o (tytso@athena.mit.edu).
8668 #. type: Plain text
8669 #: build/C/man4/random.4:308
8670 msgid "/dev/urandom"
8671 msgstr ""
8672
8673 #. type: Plain text
8674 #: build/C/man4/random.4:310
8675 msgid "B<mknod>(1)"
8676 msgstr ""
8677
8678 #. type: Plain text
8679 #: build/C/man4/random.4:311
8680 msgid "RFC\\ 1750, \"Randomness Recommendations for Security\""
8681 msgstr ""
8682
8683 #. type: TH
8684 #: build/C/man4/sd.4:26
8685 #, no-wrap
8686 msgid "SD"
8687 msgstr ""
8688
8689 #. type: TH
8690 #: build/C/man4/sd.4:26
8691 #, no-wrap
8692 msgid "2012-05-03"
8693 msgstr ""
8694
8695 #. type: Plain text
8696 #: build/C/man4/sd.4:29
8697 msgid "sd - driver for SCSI disk drives"
8698 msgstr ""
8699
8700 #. type: Plain text
8701 #: build/C/man4/sd.4:33
8702 #, no-wrap
8703 msgid ""
8704 "B<#include E<lt>linux/hdreg.hE<gt>        >/* for HDIO_GETGEO */\n"
8705 "B<#include E<lt>linux/fs.hE<gt>           >/* for BLKGETSIZE and BLKRRPART "
8706 "*/\n"
8707 msgstr ""
8708
8709 #. type: Plain text
8710 #: build/C/man4/sd.4:45
8711 msgid ""
8712 "The block device name has the following form: B<sd>I<lp,> where I<l> is a "
8713 "letter denoting the physical drive, and I<p> is a number denoting the "
8714 "partition on that physical drive.  Often, the partition number, I<p>, will "
8715 "be left off when the device corresponds to the whole drive."
8716 msgstr ""
8717
8718 #. type: Plain text
8719 #: build/C/man4/sd.4:54
8720 msgid ""
8721 "SCSI disks have a major device number of 8, and a minor device number of the "
8722 "form (16 * I<drive_number>) + I<partition_number>, where I<drive_number> is "
8723 "the number of the physical drive in order of detection, and "
8724 "I<partition_number> is as follows:"
8725 msgstr ""
8726
8727 #. type: Plain text
8728 #: build/C/man4/sd.4:56
8729 msgid "partition 0 is the whole drive"
8730 msgstr ""
8731
8732 #. type: Plain text
8733 #: build/C/man4/sd.4:58
8734 msgid "partitions 1-4 are the DOS \"primary\" partitions"
8735 msgstr ""
8736
8737 #. type: Plain text
8738 #: build/C/man4/sd.4:60
8739 msgid "partitions 5-8 are the DOS \"extended\" (or \"logical\") partitions"
8740 msgstr ""
8741
8742 #. type: Plain text
8743 #: build/C/man4/sd.4:68
8744 msgid ""
8745 "For example, I</dev/sda> will have major 8, minor 0, and will refer to all "
8746 "of the first SCSI drive in the system; and I</dev/sdb3> will have major 8, "
8747 "minor 19, and will refer to the third DOS \"primary\" partition on the "
8748 "second SCSI drive in the system."
8749 msgstr ""
8750
8751 #. type: Plain text
8752 #: build/C/man4/sd.4:71
8753 msgid ""
8754 "At this time, only block devices are provided.  Raw devices have not yet "
8755 "been implemented."
8756 msgstr ""
8757
8758 #. type: Plain text
8759 #: build/C/man4/sd.4:75
8760 msgid "The following I<ioctl>s are provided:"
8761 msgstr ""
8762
8763 #. type: TP
8764 #: build/C/man4/sd.4:75
8765 #, no-wrap
8766 msgid "B<HDIO_GETGEO>"
8767 msgstr ""
8768
8769 #. type: Plain text
8770 #: build/C/man4/sd.4:79
8771 msgid "Returns the BIOS disk parameters in the following structure:"
8772 msgstr ""
8773
8774 #. type: Plain text
8775 #: build/C/man4/sd.4:88
8776 #, no-wrap
8777 msgid ""
8778 "struct hd_geometry {\n"
8779 "    unsigned char  heads;\n"
8780 "    unsigned char  sectors;\n"
8781 "    unsigned short cylinders;\n"
8782 "    unsigned long  start;\n"
8783 "};\n"
8784 msgstr ""
8785
8786 #. type: Plain text
8787 #: build/C/man4/sd.4:94
8788 msgid "A pointer to this structure is passed as the B<ioctl>(2)  parameter."
8789 msgstr ""
8790
8791 #. type: Plain text
8792 #: build/C/man4/sd.4:109
8793 msgid ""
8794 "The information returned in the parameter is the disk geometry of the drive "
8795 "I<as understood by DOS!> This geometry is I<not> the physical geometry of "
8796 "the drive.  It is used when constructing the drive's partition table, "
8797 "however, and is needed for convenient operation of B<fdisk>(1), "
8798 "B<efdisk>(1), and B<lilo>(1).  If the geometry information is not available, "
8799 "zero will be returned for all of the parameters."
8800 msgstr ""
8801
8802 #. type: TP
8803 #: build/C/man4/sd.4:110
8804 #, no-wrap
8805 msgid "B<BLKGETSIZE>"
8806 msgstr ""
8807
8808 #. type: Plain text
8809 #: build/C/man4/sd.4:117
8810 msgid ""
8811 "Returns the device size in sectors.  The B<ioctl>(2)  parameter should be a "
8812 "pointer to a I<long>."
8813 msgstr ""
8814
8815 #. type: TP
8816 #: build/C/man4/sd.4:117
8817 #, no-wrap
8818 msgid "B<BLKRRPART>"
8819 msgstr ""
8820
8821 #. type: Plain text
8822 #: build/C/man4/sd.4:121
8823 msgid "Forces a reread of the SCSI disk partition tables.  No parameter is needed."
8824 msgstr ""
8825
8826 #. type: Plain text
8827 #: build/C/man4/sd.4:131
8828 msgid ""
8829 "The SCSI B<ioctl>(2)  operations are also supported.  If the B<ioctl>(2)  "
8830 "parameter is required, and it is NULL, then B<ioctl>(2)  will fail with the "
8831 "error B<EINVAL>."
8832 msgstr ""
8833
8834 #. type: Plain text
8835 #: build/C/man4/sd.4:133
8836 msgid "/dev/sd[a-h]: the whole device"
8837 msgstr ""
8838
8839 #. type: Plain text
8840 #: build/C/man4/sd.4:134
8841 msgid "/dev/sd[a-h][0-8]: individual block partitions"
8842 msgstr ""
8843
8844 #. type: TH
8845 #: build/C/man3/setlogmask.3:25
8846 #, no-wrap
8847 msgid "SETLOGMASK"
8848 msgstr ""
8849
8850 #. type: TH
8851 #: build/C/man3/setlogmask.3:25
8852 #, no-wrap
8853 msgid "2001-10-05"
8854 msgstr ""
8855
8856 #. type: Plain text
8857 #: build/C/man3/setlogmask.3:28
8858 msgid "setlogmask - set log priority mask"
8859 msgstr ""
8860
8861 #. type: Plain text
8862 #: build/C/man3/setlogmask.3:31
8863 #, no-wrap
8864 msgid "B<#include E<lt>syslog.hE<gt>>\n"
8865 msgstr ""
8866
8867 #. type: Plain text
8868 #: build/C/man3/setlogmask.3:33
8869 #, no-wrap
8870 msgid "B<int setlogmask(int >I<mask>B<);>\n"
8871 msgstr ""
8872
8873 #. type: Plain text
8874 #: build/C/man3/setlogmask.3:43
8875 msgid ""
8876 "A process has a log priority mask that determines which calls to "
8877 "B<syslog>(3)  may be logged.  All other calls will be ignored.  Logging is "
8878 "enabled for the priorities that have the corresponding bit set in I<mask>.  "
8879 "The initial mask is such that logging is enabled for all priorities."
8880 msgstr ""
8881
8882 #. type: Plain text
8883 #: build/C/man3/setlogmask.3:49
8884 msgid ""
8885 "The B<setlogmask>()  function sets this logmask for the calling process, and "
8886 "returns the previous mask.  If the mask argument is 0, the current logmask "
8887 "is not modified."
8888 msgstr ""
8889
8890 #. type: Plain text
8891 #: build/C/man3/setlogmask.3:69
8892 msgid ""
8893 "The eight priorities are B<LOG_EMERG>, B<LOG_ALERT>, B<LOG_CRIT>, "
8894 "B<LOG_ERR>, B<LOG_WARNING>, B<LOG_NOTICE>, B<LOG_INFO>, and B<LOG_DEBUG>.  "
8895 "The bit corresponding to a priority I<p> is I<LOG_MASK(p)>.  Some systems "
8896 "also provide a macro I<LOG_UPTO(p)> for the mask of all priorities in the "
8897 "above list up to and including I<p>."
8898 msgstr ""
8899
8900 #. type: Plain text
8901 #: build/C/man3/setlogmask.3:71
8902 msgid "This function returns the previous log priority mask."
8903 msgstr ""
8904
8905 #.  .SH NOTES
8906 #.  The glibc logmask handling was broken in versions before glibc 2.1.1.
8907 #. type: Plain text
8908 #: build/C/man3/setlogmask.3:75
8909 msgid "None."
8910 msgstr ""
8911
8912 #. type: Plain text
8913 #: build/C/man3/setlogmask.3:78
8914 msgid "POSIX.1-2001.  Note that the description in POSIX.1-2001 is flawed."
8915 msgstr ""
8916
8917 #. type: Plain text
8918 #: build/C/man3/setlogmask.3:81
8919 msgid "B<closelog>(3), B<openlog>(3), B<syslog>(3)"
8920 msgstr ""
8921
8922 #. type: TH
8923 #: build/C/man4/sk98lin.4:27
8924 #, no-wrap
8925 msgid "SK98LIN"
8926 msgstr ""
8927
8928 #. type: Plain text
8929 #: build/C/man4/sk98lin.4:30
8930 msgid "sk98lin - Marvell/SysKonnect Gigabit Ethernet driver v6.21"
8931 msgstr ""
8932
8933 #. type: Plain text
8934 #: build/C/man4/sk98lin.4:62
8935 msgid ""
8936 "B<insmod sk98lin.o> [B<Speed_A=>I<i,j,...>] [B<Speed_B=>I<i,j,...>] "
8937 "[B<AutoNeg_A=>I<i,j,...>] [B<AutoNeg_B=>I<i,j,...>] [B<DupCap_A=>I<i,j,...>] "
8938 "[B<DupCap_B=>I<i,j,...>] [B<FlowCtrl_A=>I<i,j,...>] "
8939 "[B<FlowCtrl_B=>I<i,j,...>] [B<Role_A=>I<i,j,...>] [B<Role_B=>I<i,j,...>] "
8940 "[B<ConType=>I<i,j,...>] [B<Moderation=>I<i,j,...>] "
8941 "[B<IntsPerSec=>I<i,j,...>] [B<PrefPort=>I<i,j,...>] [B<RlmtMode=>I<i,j,...>]"
8942 msgstr ""
8943
8944 #. type: Plain text
8945 #: build/C/man4/sk98lin.4:67
8946 msgid "B<Note>: This obsolete driver was removed from the kernel in version 2.6.26."
8947 msgstr ""
8948
8949 #. type: Plain text
8950 #: build/C/man4/sk98lin.4:74
8951 msgid ""
8952 "B<sk98lin> is the Gigabit Ethernet driver for Marvell and SysKonnect network "
8953 "adapter cards.  It supports SysKonnect SK-98xx/SK-95xx compliant Gigabit "
8954 "Ethernet Adapter and any Yukon compliant chipset."
8955 msgstr ""
8956
8957 #. type: Plain text
8958 #: build/C/man4/sk98lin.4:81
8959 msgid ""
8960 "When loading the driver using insmod, parameters for the network adapter "
8961 "cards might be stated as a sequence of comma separated commands.  If for "
8962 "instance two network adapters are installed and AutoNegotiation on Port A of "
8963 "the first adapter should be ON, but on the Port A of the second adapter "
8964 "switched OFF, one must enter:"
8965 msgstr ""
8966
8967 #. type: Plain text
8968 #: build/C/man4/sk98lin.4:83
8969 #, no-wrap
8970 msgid "   insmod sk98lin.o AutoNeg_A=On,Off\n"
8971 msgstr ""
8972
8973 #. type: Plain text
8974 #: build/C/man4/sk98lin.4:98
8975 msgid ""
8976 "After B<sk98lin> is bound to one or more adapter cards and the I</proc> "
8977 "filesystem is mounted on your system, a dedicated statistics file will be "
8978 "created in the folder I</proc/net/sk98lin> for all ports of the installed "
8979 "network adapter cards.  Those files are named I<eth[x]>, where I<x> is the "
8980 "number of the interface that has been assigned to a dedicated port by the "
8981 "system."
8982 msgstr ""
8983
8984 #. type: Plain text
8985 #: build/C/man4/sk98lin.4:108
8986 msgid ""
8987 "If loading is finished, any desired IP address can be assigned to the "
8988 "respective I<eth[x]> interface using the B<ifconfig>(8)  command.  This "
8989 "causes the adapter to connect to the Ethernet and to display a status "
8990 "message on the console saying \"ethx: network connection up using port y\" "
8991 "followed by the configured or detected connection parameters."
8992 msgstr ""
8993
8994 #. type: Plain text
8995 #: build/C/man4/sk98lin.4:124
8996 msgid ""
8997 "The B<sk98lin> also supports large frames (also called jumbo frames).  Using "
8998 "jumbo frames can improve throughput tremendously when transferring large "
8999 "amounts of data.  To enable large frames, the MTU (maximum transfer unit) "
9000 "size for an interface is to be set to a high value.  The default MTU size is "
9001 "1500 and can be changed up to 9000 (bytes).  Setting the MTU size can be "
9002 "done when assigning the IP address to the interface or later by using the "
9003 "B<ifconfig>(8)  command with the mtu parameter.  If for instance eth0 needs "
9004 "an IP address and a large frame MTU size, the following two commands might "
9005 "be used:"
9006 msgstr ""
9007
9008 #. type: Plain text
9009 #: build/C/man4/sk98lin.4:127
9010 #, no-wrap
9011 msgid ""
9012 "    ifconfig eth0 10.1.1.1\n"
9013 "    ifconfig eth0 mtu 9000\n"
9014 msgstr ""
9015
9016 #. type: Plain text
9017 #: build/C/man4/sk98lin.4:129
9018 msgid "Those two commands might even be combined into one:"
9019 msgstr ""
9020
9021 #. type: Plain text
9022 #: build/C/man4/sk98lin.4:131
9023 #, no-wrap
9024 msgid "    ifconfig eth0 10.1.1.1 mtu 9000\n"
9025 msgstr ""
9026
9027 #. type: Plain text
9028 #: build/C/man4/sk98lin.4:144
9029 msgid ""
9030 "Note that large frames can be used only if permitted by your network "
9031 "infrastructure.  This means, that any switch being used in your Ethernet "
9032 "must also support large frames.  Quite some switches support large frames, "
9033 "but need to be configured to do so.  Most of the times, their default "
9034 "setting is to support only standard frames with an MTU size of 1500 "
9035 "(bytes).  In addition to the switches inside the network, all network "
9036 "adapters that are to be used must also be enabled regarding jumbo frames.  "
9037 "If an adapter is not set to receive large frames, it will simply drop them."
9038 msgstr ""
9039
9040 #. type: Plain text
9041 #: build/C/man4/sk98lin.4:148
9042 msgid ""
9043 "Switching back to the standard Ethernet frame size can be done by using the "
9044 "B<ifconfig>(8)  command again:"
9045 msgstr ""
9046
9047 #. type: Plain text
9048 #: build/C/man4/sk98lin.4:150
9049 #, no-wrap
9050 msgid "    ifconfig eth0 mtu 1500\n"
9051 msgstr ""
9052
9053 #. type: Plain text
9054 #: build/C/man4/sk98lin.4:156
9055 msgid ""
9056 "The Marvell/SysKonnect Gigabit Ethernet driver for Linux is able to support "
9057 "VLAN and Link Aggregation according to IEEE standards 802.1, 802.1q, and "
9058 "802.3ad.  Those features are available only after installation of open "
9059 "source modules which can be found on the Internet:"
9060 msgstr ""
9061
9062 #. type: Plain text
9063 #: build/C/man4/sk98lin.4:161
9064 msgid "I<VLAN>: E<.UR http://www.candelatech.com\\:/~greear\\:/vlan.html> E<.UE>"
9065 msgstr ""
9066
9067 #. type: Plain text
9068 #: build/C/man4/sk98lin.4:167
9069 msgid "I<Link> I<Aggregation>: E<.UR http://www.st.rim.or.jp\\:/~yumo> E<.UE>"
9070 msgstr ""
9071
9072 #. type: Plain text
9073 #: build/C/man4/sk98lin.4:172
9074 msgid ""
9075 "Note that Marvell/SysKonnect does not offer any support for these open "
9076 "source modules and does not take the responsibility for any kind of failures "
9077 "or problems arising when using these modules."
9078 msgstr ""
9079
9080 #. type: SS
9081 #: build/C/man4/sk98lin.4:172 build/C/man4/wavelan.4:39
9082 #, no-wrap
9083 msgid "Parameters"
9084 msgstr ""
9085
9086 #. type: TP
9087 #: build/C/man4/sk98lin.4:173
9088 #, no-wrap
9089 msgid "B<Speed_A=>I<i,j,...>"
9090 msgstr ""
9091
9092 #. type: Plain text
9093 #: build/C/man4/sk98lin.4:190
9094 msgid ""
9095 "This parameter is used to set the speed capabilities of port A of an adapter "
9096 "card.  It is valid only for Yukon copper adapters.  Possible values are: "
9097 "I<10>, I<100>, I<1000>, or I<Auto>; I<Auto> is the default.  Usually, the "
9098 "speed is negotiated between the two ports during link establishment.  If "
9099 "this fails, a port can be forced to a specific setting with this parameter."
9100 msgstr ""
9101
9102 #. type: TP
9103 #: build/C/man4/sk98lin.4:190
9104 #, no-wrap
9105 msgid "B<Speed_B=>I<i,j,...>"
9106 msgstr ""
9107
9108 #. type: Plain text
9109 #: build/C/man4/sk98lin.4:207
9110 msgid ""
9111 "This parameter is used to set the speed capabilities of port B of an adapter "
9112 "card.  It is valid only for Yukon copper adapters.  Possible values are: "
9113 "I<10>, I<100>, I<1000>, or I<Auto>; I<Auto> is the default.  Usually, the "
9114 "speed is negotiated between the two ports during link establishment.  If "
9115 "this fails, a port can be forced to a specific setting with this parameter."
9116 msgstr ""
9117
9118 #. type: TP
9119 #: build/C/man4/sk98lin.4:207
9120 #, no-wrap
9121 msgid "B<AutoNeg_A=>I<i,j,...>"
9122 msgstr ""
9123
9124 #. type: Plain text
9125 #: build/C/man4/sk98lin.4:221
9126 msgid ""
9127 "Enables or disables the use of autonegotiation of port A of an adapter "
9128 "card.  Possible values are: I<On>, I<Off>, or I<Sense>; I<On> is the "
9129 "default.  The I<Sense> mode automatically detects whether the link partner "
9130 "supports auto-negotiation or not."
9131 msgstr ""
9132
9133 #. type: TP
9134 #: build/C/man4/sk98lin.4:221
9135 #, no-wrap
9136 msgid "B<AutoNeg_B=>I<i,j,...>"
9137 msgstr ""
9138
9139 #. type: Plain text
9140 #: build/C/man4/sk98lin.4:235
9141 msgid ""
9142 "Enables or disables the use of autonegotiation of port B of an adapter "
9143 "card.  Possible values are: I<On>, I<Off>, or I<Sense>; I<On> is the "
9144 "default.  The I<Sense> mode automatically detects whether the link partner "
9145 "supports auto-negotiation or not."
9146 msgstr ""
9147
9148 #. type: TP
9149 #: build/C/man4/sk98lin.4:235
9150 #, no-wrap
9151 msgid "B<DupCap_A=>I<i,j,...>"
9152 msgstr ""
9153
9154 #. type: Plain text
9155 #: build/C/man4/sk98lin.4:265
9156 msgid ""
9157 "This parameter indicates the duplex mode to be used for port A of an adapter "
9158 "card.  Possible values are: I<Half>, I<Full>, or I<Both>; I<Both> is the "
9159 "default.  This parameter is relevant only if AutoNeg_A of port A is not set "
9160 "to I<Sense>.  If AutoNeg_A is set to I<On>, all three values of DupCap_A ( "
9161 "I<Half>, I<Full> or I<Both>)  might be stated.  If AutoNeg_A is set to "
9162 "I<Off>, only DupCap_A values I<Full> and I<Half> are allowed.  This DupCap_A "
9163 "parameter is useful if your link partner does not support all possible "
9164 "duplex combinations."
9165 msgstr ""
9166
9167 #. type: TP
9168 #: build/C/man4/sk98lin.4:265
9169 #, no-wrap
9170 msgid "B<DupCap_B=>I<i,j,...>"
9171 msgstr ""
9172
9173 #. type: Plain text
9174 #: build/C/man4/sk98lin.4:295
9175 msgid ""
9176 "This parameter indicates the duplex mode to be used for port B of an adapter "
9177 "card.  Possible values are: I<Half>, I<Full>, or I<Both>; I<Both> is the "
9178 "default.  This parameter is relevant only if AutoNeg_B of port B is not set "
9179 "to I<Sense>.  If AutoNeg_B is set to I<On>, all three values of DupCap_B ( "
9180 "I<Half>, I<Full> or I<Both>)  might be stated.  If AutoNeg_B is set to "
9181 "I<Off>, only DupCap_B values I<Full> and I<Half> are allowed.  This DupCap_B "
9182 "parameter is useful if your link partner does not support all possible "
9183 "duplex combinations."
9184 msgstr ""
9185
9186 #. type: TP
9187 #: build/C/man4/sk98lin.4:295
9188 #, no-wrap
9189 msgid "B<FlowCtrl_A=>I<i,j,...>"
9190 msgstr ""
9191
9192 #. type: Plain text
9193 #: build/C/man4/sk98lin.4:308 build/C/man4/sk98lin.4:341
9194 msgid ""
9195 "This parameter can be used to set the flow control capabilities the port "
9196 "reports during auto-negotiation.  Possible values are: I<Sym>, I<SymOrRem>, "
9197 "I<LocSend>, or I<None>; I<SymOrRem> is the default.  The different modes "
9198 "have the following meaning:"
9199 msgstr ""
9200
9201 #. type: Plain text
9202 #: build/C/man4/sk98lin.4:313 build/C/man4/sk98lin.4:345
9203 #, no-wrap
9204 msgid ""
9205 "I<Sym>\n"
9206 "= Symmetric\n"
9207 " both link partners are allowed to send PAUSE frames\n"
9208 msgstr ""
9209
9210 #. type: Plain text
9211 #: build/C/man4/sk98lin.4:317 build/C/man4/sk98lin.4:349
9212 #, no-wrap
9213 msgid ""
9214 "I<SymOrRem>\n"
9215 "= SymmetricOrRemote\n"
9216 " both or only remote partner are allowed to send PAUSE frames\n"
9217 msgstr ""
9218
9219 #. type: Plain text
9220 #: build/C/man4/sk98lin.4:321 build/C/man4/sk98lin.4:353
9221 #, no-wrap
9222 msgid ""
9223 "I<LocSend>\n"
9224 "= LocalSend\n"
9225 " only local link partner is allowed to send PAUSE frames\n"
9226 msgstr ""
9227
9228 #. type: Plain text
9229 #: build/C/man4/sk98lin.4:325 build/C/man4/sk98lin.4:357
9230 #, no-wrap
9231 msgid ""
9232 "I<None>\n"
9233 "= None\n"
9234 " no link partner is allowed to send PAUSE frames\n"
9235 msgstr ""
9236
9237 #. type: Plain text
9238 #: build/C/man4/sk98lin.4:328
9239 msgid "Note that this parameter is ignored if AutoNeg_A is set to I<Off>."
9240 msgstr ""
9241
9242 #. type: TP
9243 #: build/C/man4/sk98lin.4:328
9244 #, no-wrap
9245 msgid "B<FlowCtrl_B=>I<i,j,...>"
9246 msgstr ""
9247
9248 #. type: Plain text
9249 #: build/C/man4/sk98lin.4:361
9250 msgid "Note that this parameter is ignored if AutoNeg_B is set to I<Off>."
9251 msgstr ""
9252
9253 #. type: TP
9254 #: build/C/man4/sk98lin.4:361
9255 #, no-wrap
9256 msgid "B<Role_A=>I<i,j,...>"
9257 msgstr ""
9258
9259 #. type: Plain text
9260 #: build/C/man4/sk98lin.4:377
9261 msgid ""
9262 "This parameter is valid only for 1000Base-T adapter cards.  For two "
9263 "1000Base-T ports to communicate, one must take the role of the master "
9264 "(providing timing information), while the other must be the slave.  Possible "
9265 "values are: I<Auto>, I<Master>, or I<Slave>; I<Auto> is the default.  "
9266 "Usually, the role of a port is negotiated between two ports during link "
9267 "establishment, but if that fails the port A of an adapter card can be forced "
9268 "to a specific setting with this parameter."
9269 msgstr ""
9270
9271 #. type: TP
9272 #: build/C/man4/sk98lin.4:377
9273 #, no-wrap
9274 msgid "B<Role_B=>I<i,j,...>"
9275 msgstr ""
9276
9277 #. type: Plain text
9278 #: build/C/man4/sk98lin.4:394
9279 msgid ""
9280 "This parameter is valid only for 1000Base-T adapter cards.  For two "
9281 "1000Base-T ports to communicate, one must take the role of the master "
9282 "(providing timing information), while the other must be the slave.  Possible "
9283 "values are: I<Auto>, I<Master>, or I<Slave>; I<Auto> is the default.  "
9284 "Usually, the role of a port is negotiated between two ports during link "
9285 "establishment, but if that fails the port B of an adapter card can be forced "
9286 "to a specific setting with this parameter."
9287 msgstr ""
9288
9289 #. type: TP
9290 #: build/C/man4/sk98lin.4:394
9291 #, no-wrap
9292 msgid "B<ConType=>I<i,j,...>"
9293 msgstr ""
9294
9295 #. type: Plain text
9296 #: build/C/man4/sk98lin.4:402
9297 msgid ""
9298 "This parameter is a combination of all five per-port parameters within one "
9299 "single parameter.  This simplifies the configuration of both ports of an "
9300 "adapter card.  The different values of this variable reflect the most "
9301 "meaningful combinations of port parameters.  Possible values and their "
9302 "corresponding combination of per-port parameters:"
9303 msgstr ""
9304
9305 #. type: Plain text
9306 #: build/C/man4/sk98lin.4:407
9307 #, no-wrap
9308 msgid ""
9309 "ConType | DupCap   AutoNeg   FlowCtrl   Role   Speed\n"
9310 "--------+-------------------------------------------\n"
9311 "I<Auto>    |  Both      On      SymOrRem   Auto   Auto\n"
9312 msgstr ""
9313
9314 #. type: Plain text
9315 #: build/C/man4/sk98lin.4:409
9316 #, no-wrap
9317 msgid "I<100FD>   |  Full      Off       None     Auto   100\n"
9318 msgstr ""
9319
9320 #. type: Plain text
9321 #: build/C/man4/sk98lin.4:411
9322 #, no-wrap
9323 msgid "I<100HD>   |  Half      Off       None     Auto   100\n"
9324 msgstr ""
9325
9326 #. type: Plain text
9327 #: build/C/man4/sk98lin.4:413
9328 #, no-wrap
9329 msgid "I<10FD>    |  Full      Off       None     Auto   10\n"
9330 msgstr ""
9331
9332 #. type: Plain text
9333 #: build/C/man4/sk98lin.4:415
9334 #, no-wrap
9335 msgid "I<10HD>    |  Half      Off       None     Auto   10\n"
9336 msgstr ""
9337
9338 #. type: Plain text
9339 #: build/C/man4/sk98lin.4:425
9340 msgid ""
9341 "Stating any other port parameter together with this I<ConType> parameter "
9342 "will result in a merged configuration of those settings.  This is due to the "
9343 "fact, that the per-port parameters (e.g., I<Speed_A>)  have a higher "
9344 "priority than the combined variable I<ConType>."
9345 msgstr ""
9346
9347 #. type: TP
9348 #: build/C/man4/sk98lin.4:425
9349 #, no-wrap
9350 msgid "B<Moderation=>I<i,j,...>"
9351 msgstr ""
9352
9353 #. type: Plain text
9354 #: build/C/man4/sk98lin.4:442
9355 msgid ""
9356 "Interrupt moderation is employed to limit the maximum number of interrupts "
9357 "the driver has to serve.  That is, one or more interrupts (which indicate "
9358 "any transmit or receive packet to be processed) are queued until the driver "
9359 "processes them.  When queued interrupts are to be served, is determined by "
9360 "the I<IntsPerSec> parameter, which is explained later below.  Possible "
9361 "moderation modes are: I<None>, I<Static>, or I<Dynamic>; I<None> is the "
9362 "default.  The different modes have the following meaning:"
9363 msgstr ""
9364
9365 #. type: Plain text
9366 #: build/C/man4/sk98lin.4:447
9367 msgid ""
9368 "I<None> No interrupt moderation is applied on the adapter card.  Therefore, "
9369 "each transmit or receive interrupt is served immediately as soon as it "
9370 "appears on the interrupt line of the adapter card."
9371 msgstr ""
9372
9373 #. type: Plain text
9374 #: build/C/man4/sk98lin.4:462
9375 msgid ""
9376 "I<Static> Interrupt moderation is applied on the adapter card.  All transmit "
9377 "and receive interrupts are queued until a complete moderation interval "
9378 "ends.  If such a moderation interval ends, all queued interrupts are "
9379 "processed in one big bunch without any delay.  The term I<Static> reflects "
9380 "the fact, that interrupt moderation is always enabled, regardless how much "
9381 "network load is currently passing via a particular interface.  In addition, "
9382 "the duration of the moderation interval has a fixed length that never "
9383 "changes while the driver is operational."
9384 msgstr ""
9385
9386 #. type: Plain text
9387 #: build/C/man4/sk98lin.4:473
9388 msgid ""
9389 "I<Dynamic> Interrupt moderation might be applied on the adapter card, "
9390 "depending on the load of the system.  If the driver detects that the system "
9391 "load is too high, the driver tries to shield the system against too much "
9392 "network load by enabling interrupt moderation.  If\\(emat a later "
9393 "time\\(emthe CPU utilization decreases again (or if the network load is "
9394 "negligible), the interrupt moderation will automatically be disabled."
9395 msgstr ""
9396
9397 #. type: Plain text
9398 #: build/C/man4/sk98lin.4:479
9399 msgid ""
9400 "Interrupt moderation should be used when the driver has to handle one or "
9401 "more interfaces with a high network load, which\\(emas a "
9402 "consequence\\(emleads also to a high CPU utilization.  When moderation is "
9403 "applied in such high network load situations, CPU load might be reduced by "
9404 "20-30% on slow computers."
9405 msgstr ""
9406
9407 #. type: Plain text
9408 #: build/C/man4/sk98lin.4:483
9409 msgid ""
9410 "Note that the drawback of using interrupt moderation is an increase of the "
9411 "round-trip-time (RTT), due to the queuing and serving of interrupts at "
9412 "dedicated moderation times."
9413 msgstr ""
9414
9415 #. type: TP
9416 #: build/C/man4/sk98lin.4:483
9417 #, no-wrap
9418 msgid "B<IntsPerSec=>I<i,j,...>"
9419 msgstr ""
9420
9421 #. type: Plain text
9422 #: build/C/man4/sk98lin.4:493
9423 msgid ""
9424 "This parameter determines the length of any interrupt moderation interval.  "
9425 "Assuming that static interrupt moderation is to be used, an I<IntsPerSec> "
9426 "parameter value of 2000 will lead to an interrupt moderation interval of 500 "
9427 "microseconds.  Possible values for this parameter are in the range of "
9428 "30...40000 (interrupts per second).  The default value is 2000."
9429 msgstr ""
9430
9431 #. type: Plain text
9432 #: build/C/man4/sk98lin.4:497
9433 msgid ""
9434 "This parameter is used only if either static or dynamic interrupt moderation "
9435 "is enabled on a network adapter card.  This parameter is ignored if no "
9436 "moderation is applied."
9437 msgstr ""
9438
9439 #. type: Plain text
9440 #: build/C/man4/sk98lin.4:504
9441 msgid ""
9442 "Note that the duration of the moderation interval is to be chosen with "
9443 "care.  At first glance, selecting a very long duration (e.g., only 100 "
9444 "interrupts per second) seems to be meaningful, but the increase of "
9445 "packet-processing delay is tremendous.  On the other hand, selecting a very "
9446 "short moderation time might compensate the use of any moderation being "
9447 "applied."
9448 msgstr ""
9449
9450 #. type: TP
9451 #: build/C/man4/sk98lin.4:504
9452 #, no-wrap
9453 msgid "B<PrefPort=>I<i,j,...>"
9454 msgstr ""
9455
9456 #. type: Plain text
9457 #: build/C/man4/sk98lin.4:516
9458 msgid ""
9459 "This parameter is used to force the preferred port to A or B (on dual-port "
9460 "network adapters).  The preferred port is the one that is used if both ports "
9461 "A and B are detected as fully functional.  Possible values are: I<A> or "
9462 "I<B>; I<A> is the default."
9463 msgstr ""
9464
9465 #. type: TP
9466 #: build/C/man4/sk98lin.4:516
9467 #, no-wrap
9468 msgid "B<RlmtMode=>I<i,j,...>"
9469 msgstr ""
9470
9471 #. type: Plain text
9472 #: build/C/man4/sk98lin.4:532
9473 msgid ""
9474 "RLMT monitors the status of the port.  If the link of the active port fails, "
9475 "RLMT switches immediately to the standby link.  The virtual link is "
9476 "maintained as long as at least one \"physical\" link is up.  This parameters "
9477 "states how RLMT should monitor both ports.  Possible values are: "
9478 "I<CheckLinkState>, I<CheckLocalPort>, I<CheckSeg>, or I<DualNet>; "
9479 "I<CheckLinkState> is the default.  The different modes have the following "
9480 "meaning:"
9481 msgstr ""
9482
9483 #. type: Plain text
9484 #: build/C/man4/sk98lin.4:537
9485 msgid ""
9486 "I<CheckLinkState> Check link state only: RLMT uses the link state reported "
9487 "by the adapter hardware for each individual port to determine whether a port "
9488 "can be used for all network traffic or not."
9489 msgstr ""
9490
9491 #. type: Plain text
9492 #: build/C/man4/sk98lin.4:545
9493 msgid ""
9494 "I<CheckLocalPort> In this mode, RLMT monitors the network path between the "
9495 "two ports of an adapter by regularly exchanging packets between them.  This "
9496 "mode requires a network configuration in which the two ports are able to "
9497 "\"see\" each other (i.e., there must not be any router between the ports)."
9498 msgstr ""
9499
9500 #. type: Plain text
9501 #: build/C/man4/sk98lin.4:554
9502 msgid ""
9503 "I<CheckSeg> Check local port and segmentation: This mode supports the same "
9504 "functions as the CheckLocalPort mode and additionally checks network "
9505 "segmentation between the ports.  Therefore, this mode is to be used only if "
9506 "Gigabit Ethernet switches are installed on the network that have been "
9507 "configured to use the Spanning Tree protocol."
9508 msgstr ""
9509
9510 #. type: Plain text
9511 #: build/C/man4/sk98lin.4:565
9512 msgid ""
9513 "I<DualNet> In this mode, ports A and B are used as separate devices.  If you "
9514 "have a dual port adapter, port A will be configured as I<eth[x]> and port B "
9515 "as I<eth[x+1]>.  Both ports can be used independently with distinct IP "
9516 "addresses.  The preferred port setting is not used.  RLMT is turned off."
9517 msgstr ""
9518
9519 #. type: Plain text
9520 #: build/C/man4/sk98lin.4:574
9521 msgid ""
9522 "Note that RLMT modes I<CheckLocalPort> and I<CheckLinkState> are designed to "
9523 "operate in configurations where a network path between the ports on one "
9524 "adapter exists.  Moreover, they are not designed to work where adapters are "
9525 "connected back-to-back."
9526 msgstr ""
9527
9528 #. type: TP
9529 #: build/C/man4/sk98lin.4:575
9530 #, no-wrap
9531 msgid "I</proc/net/sk98lin/eth[x]>"
9532 msgstr ""
9533
9534 #. type: Plain text
9535 #: build/C/man4/sk98lin.4:581
9536 msgid ""
9537 "The statistics file of a particular interface of an adapter card.  It "
9538 "contains generic information about the adapter card plus a detailed summary "
9539 "of all transmit and receive counters."
9540 msgstr ""
9541
9542 #. type: TP
9543 #: build/C/man4/sk98lin.4:581
9544 #, no-wrap
9545 msgid "I</usr/src/linux/Documentation/networking/sk98lin.txt>"
9546 msgstr ""
9547
9548 #. type: Plain text
9549 #: build/C/man4/sk98lin.4:592
9550 msgid ""
9551 "This is the I<README> file of the I<sk98lin> driver.  It contains a detailed "
9552 "installation HOWTO and describes all parameters of the driver.  It denotes "
9553 "also common problems and provides the solution to them."
9554 msgstr ""
9555
9556 #.  .SH AUTHORS
9557 #.  Ralph Roesler \(em rroesler@syskonnect.de
9558 #.  .br
9559 #.  Mirko Lindner \(em mlindner@syskonnect.de
9560 #. type: Plain text
9561 #: build/C/man4/sk98lin.4:598
9562 msgid "Report any bugs to linux@syskonnect.de"
9563 msgstr ""
9564
9565 #. type: Plain text
9566 #: build/C/man4/sk98lin.4:601
9567 msgid "B<ifconfig>(8), B<insmod>(8), B<modprobe>(8)"
9568 msgstr ""
9569
9570 #. type: TH
9571 #: build/C/man4/st.4:25
9572 #, no-wrap
9573 msgid "ST"
9574 msgstr ""
9575
9576 #. type: Plain text
9577 #: build/C/man4/st.4:28
9578 msgid "st - SCSI tape device"
9579 msgstr ""
9580
9581 #. type: Plain text
9582 #: build/C/man4/st.4:31
9583 #, no-wrap
9584 msgid "B<#include E<lt>sys/mtio.hE<gt>>\n"
9585 msgstr ""
9586
9587 #. type: Plain text
9588 #: build/C/man4/st.4:36
9589 #, no-wrap
9590 msgid ""
9591 "B<int ioctl(int >I<fd>B<, int >I<request>B< [, (void *)>I<arg3>B<]);>\n"
9592 "B<int ioctl(int >I<fd>B<, MTIOCTOP, (struct mtop *)>I<mt_cmd>B<);>\n"
9593 "B<int ioctl(int >I<fd>B<, MTIOCGET, (struct mtget *)>I<mt_status>B<);>\n"
9594 "B<int ioctl(int >I<fd>B<, MTIOCPOS, (struct mtpos *)>I<mt_pos>B<);>\n"
9595 msgstr ""
9596
9597 #. type: Plain text
9598 #: build/C/man4/st.4:46
9599 msgid ""
9600 "The B<st> driver provides the interface to a variety of SCSI tape devices.  "
9601 "Currently, the driver takes control of all detected devices of type "
9602 "\\(lqsequential-access\\(rq.  The B<st> driver uses major device number 9."
9603 msgstr ""
9604
9605 #. type: Plain text
9606 #: build/C/man4/st.4:66
9607 msgid ""
9608 "Each device uses eight minor device numbers.  The lowermost five bits in the "
9609 "minor numbers are assigned sequentially in the order of detection.  In the "
9610 "2.6 kernel, the bits above the eight lowermost bits are concatenated to the "
9611 "five lowermost bits to form the tape number.  The minor numbers can be "
9612 "grouped into two sets of four numbers: the principal (auto-rewind) minor "
9613 "device numbers, I<n>, and the \\(lqno-rewind\\(rq device numbers, (I<n> + "
9614 "128).  Devices opened using the principal device number will be sent a "
9615 "B<REWIND> command when they are closed.  Devices opened using the "
9616 "\\(lqno-rewind\\(rq device number will not.  (Note that using an auto-rewind "
9617 "device for positioning the tape with, for instance, mt does not lead to the "
9618 "desired result: the tape is rewound after the mt command and the next "
9619 "command starts from the beginning of the tape)."
9620 msgstr ""
9621
9622 #. type: Plain text
9623 #: build/C/man4/st.4:80
9624 msgid ""
9625 "Within each group, four minor numbers are available to define devices with "
9626 "different characteristics (block size, compression, density, etc.)  When the "
9627 "system starts up, only the first device is available.  The other three are "
9628 "activated when the default characteristics are defined (see below).  (By "
9629 "changing compile-time constants, it is possible to change the balance "
9630 "between the maximum number of tape drives and the number of minor numbers "
9631 "for each drive.  The default allocation allows control of 32 tape drives.  "
9632 "For instance, it is possible to control up to 64 tape drives with two minor "
9633 "numbers for different options.)"
9634 msgstr ""
9635
9636 #. type: Plain text
9637 #: build/C/man4/st.4:82
9638 msgid "Devices are typically created by:"
9639 msgstr ""
9640
9641 #. type: Plain text
9642 #: build/C/man4/st.4:93
9643 #, no-wrap
9644 msgid ""
9645 "mknod -m 666 /dev/st0 c 9 0\n"
9646 "mknod -m 666 /dev/st0l c 9 32\n"
9647 "mknod -m 666 /dev/st0m c 9 64\n"
9648 "mknod -m 666 /dev/st0a c 9 96\n"
9649 "mknod -m 666 /dev/nst0 c 9 128\n"
9650 "mknod -m 666 /dev/nst0l c 9 160\n"
9651 "mknod -m 666 /dev/nst0m c 9 192\n"
9652 "mknod -m 666 /dev/nst0a c 9 224\n"
9653 msgstr ""
9654
9655 #. type: Plain text
9656 #: build/C/man4/st.4:97
9657 msgid "There is no corresponding block device."
9658 msgstr ""
9659
9660 #. type: Plain text
9661 #: build/C/man4/st.4:112
9662 msgid ""
9663 "The driver uses an internal buffer that has to be large enough to hold at "
9664 "least one tape block.  In kernels before 2.1.121, the buffer is allocated as "
9665 "one contiguous block.  This limits the block size to the largest contiguous "
9666 "block of memory the kernel allocator can provide.  The limit is currently "
9667 "128 kB for 32-bit architectures and 256 kB for 64-bit architectures.  In "
9668 "newer kernels the driver allocates the buffer in several parts if "
9669 "necessary.  By default, the maximum number of parts is 16.  This means that "
9670 "the maximum block size is very large (2 MB if allocation of 16 blocks of 128 "
9671 "kB succeeds)."
9672 msgstr ""
9673
9674 #. type: Plain text
9675 #: build/C/man4/st.4:121
9676 msgid ""
9677 "The driver's internal buffer size is determined by a compile-time constant "
9678 "which can be overridden with a kernel startup option.  In addition to this, "
9679 "the driver tries to allocate a larger temporary buffer at run time if "
9680 "necessary.  However, run-time allocation of large contiguous blocks of "
9681 "memory may fail and it is advisable not to rely too much on dynamic buffer "
9682 "allocation with kernels older than 2.1.121 (this applies also to "
9683 "demand-loading the driver with kerneld or kmod)."
9684 msgstr ""
9685
9686 #. type: Plain text
9687 #: build/C/man4/st.4:134
9688 msgid ""
9689 "The driver does not specifically support any tape drive brand or model.  "
9690 "After system start-up the tape device options are defined by the drive "
9691 "firmware.  For example, if the drive firmware selects fixed-block mode, the "
9692 "tape device uses fixed-block mode.  The options can be changed with explicit "
9693 "B<ioctl>(2)  calls and remain in effect when the device is closed and "
9694 "reopened.  Setting the options affects both the auto-rewind and the "
9695 "nonrewind device."
9696 msgstr ""
9697
9698 #. type: Plain text
9699 #: build/C/man4/st.4:143
9700 msgid ""
9701 "Different options can be specified for the different devices within the "
9702 "subgroup of four.  The options take effect when the device is opened.  For "
9703 "example, the system administrator can define one device that writes in "
9704 "fixed-block mode with a certain block size, and one which writes in "
9705 "variable-block mode (if the drive supports both modes)."
9706 msgstr ""
9707
9708 #. type: Plain text
9709 #: build/C/man4/st.4:166
9710 msgid ""
9711 "The driver supports B<tape partitions> if they are supported by the drive.  "
9712 "(Note that the tape partitions have nothing to do with disk partitions.  A "
9713 "partitioned tape can be seen as several logical tapes within one medium.)  "
9714 "Partition support has to be enabled with an B<ioctl>(2).  The tape location "
9715 "is preserved within each partition across partition changes.  The partition "
9716 "used for subsequent tape operations is selected with an B<ioctl>(2).  The "
9717 "partition switch is executed together with the next tape operation in order "
9718 "to avoid unnecessary tape movement.  The maximum number of partitions on a "
9719 "tape is defined by a compile-time constant (originally four).  The driver "
9720 "contains an B<ioctl>(2)  that can format a tape with either one or two "
9721 "partitions."
9722 msgstr ""
9723
9724 #. type: Plain text
9725 #: build/C/man4/st.4:171
9726 msgid ""
9727 "Device I</dev/tape> is usually created as a hard or soft link to the default "
9728 "tape device on the system."
9729 msgstr ""
9730
9731 #. type: Plain text
9732 #: build/C/man4/st.4:175
9733 msgid ""
9734 "Starting from kernel 2.6.2, the driver exports in the sysfs directory "
9735 "I</sys/class/scsi_tape> the attached devices and some parameters assigned to "
9736 "the devices."
9737 msgstr ""
9738
9739 #. type: SS
9740 #: build/C/man4/st.4:175
9741 #, no-wrap
9742 msgid "Data transfer"
9743 msgstr ""
9744
9745 #. type: Plain text
9746 #: build/C/man4/st.4:188
9747 msgid ""
9748 "The driver supports operation in both fixed-block mode and variable-block "
9749 "mode (if supported by the drive).  In fixed-block mode the drive writes "
9750 "blocks of the specified size and the block size is not dependent on the byte "
9751 "counts of the write system calls.  In variable-block mode one tape block is "
9752 "written for each write call and the byte count determines the size of the "
9753 "corresponding tape block.  Note that the blocks on the tape don't contain "
9754 "any information about the writing mode: when reading, the only important "
9755 "thing is to use commands that accept the block sizes on the tape."
9756 msgstr ""
9757
9758 #. type: Plain text
9759 #: build/C/man4/st.4:197
9760 msgid ""
9761 "In variable-block mode the read byte count does not have to match the tape "
9762 "block size exactly.  If the byte count is larger than the next block on "
9763 "tape, the driver returns the data and the function returns the actual block "
9764 "size.  If the block size is larger than the byte count, the requested amount "
9765 "of data from the start of the block is returned and the rest of the block is "
9766 "discarded."
9767 msgstr ""
9768
9769 #. type: Plain text
9770 #: build/C/man4/st.4:206
9771 msgid ""
9772 "In fixed-block mode the read byte counts can be arbitrary if buffering is "
9773 "enabled, or a multiple of the tape block size if buffering is disabled.  "
9774 "Kernels before 2.1.121 allow writes with arbitrary byte count if buffering "
9775 "is enabled.  In all other cases (kernel before 2.1.121 with buffering "
9776 "disabled or newer kernel) the write byte count must be a multiple of the "
9777 "tape block size."
9778 msgstr ""
9779
9780 #. type: Plain text
9781 #: build/C/man4/st.4:215
9782 msgid ""
9783 "In the 2.6 kernel, the driver tries to use direct transfers between the user "
9784 "buffer and the device.  If this is not possible, the driver's internal "
9785 "buffer is used.  The reasons for not using direct transfers include improper "
9786 "alignment of the user buffer (default is 512 bytes but this can be changed "
9787 "by the HBA driver), one or more pages of the user buffer not reachable by "
9788 "the SCSI adapter, and so on."
9789 msgstr ""
9790
9791 #. type: Plain text
9792 #: build/C/man4/st.4:218
9793 msgid ""
9794 "A filemark is automatically written to tape if the last tape operation "
9795 "before close was a write."
9796 msgstr ""
9797
9798 #. type: Plain text
9799 #: build/C/man4/st.4:230
9800 msgid ""
9801 "When a filemark is encountered while reading, the following happens.  If "
9802 "there are data remaining in the buffer when the filemark is found, the "
9803 "buffered data is returned.  The next read returns zero bytes.  The following "
9804 "read returns data from the next file.  The end of recorded data is signaled "
9805 "by returning zero bytes for two consecutive read calls.  The third read "
9806 "returns an error."
9807 msgstr ""
9808
9809 #. type: SS
9810 #: build/C/man4/st.4:230
9811 #, no-wrap
9812 msgid "Ioctls"
9813 msgstr ""
9814
9815 #. type: Plain text
9816 #: build/C/man4/st.4:241
9817 msgid ""
9818 "The driver supports three B<ioctl>(2)  requests.  Requests not recognized by "
9819 "the B<st> driver are passed to the B<SCSI> driver.  The definitions below "
9820 "are from I</usr/include/linux/mtio.h>:"
9821 msgstr ""
9822
9823 #. type: SS
9824 #: build/C/man4/st.4:241
9825 #, no-wrap
9826 msgid "MTIOCTOP \\(em perform a tape operation"
9827 msgstr ""
9828
9829 #. type: Plain text
9830 #: build/C/man4/st.4:249
9831 msgid ""
9832 "This request takes an argument of type I<(struct mtop\\ *)>.  Not all drives "
9833 "support all operations.  The driver returns an B<EIO> error if the drive "
9834 "rejects an operation."
9835 msgstr ""
9836
9837 #. type: Plain text
9838 #: build/C/man4/st.4:257
9839 #, no-wrap
9840 msgid ""
9841 "/* Structure for MTIOCTOP - mag tape op command: */\n"
9842 "struct mtop {\n"
9843 "    short   mt_op;       /* operations defined below */\n"
9844 "    int     mt_count;    /* how many of them */\n"
9845 "};\n"
9846 msgstr ""
9847
9848 #. type: Plain text
9849 #: build/C/man4/st.4:261
9850 msgid "Magnetic Tape operations for normal tape use:"
9851 msgstr ""
9852
9853 #. type: TP
9854 #: build/C/man4/st.4:261
9855 #, no-wrap
9856 msgid "B<MTBSF>"
9857 msgstr ""
9858
9859 #. type: Plain text
9860 #: build/C/man4/st.4:266
9861 msgid "Backward space over I<mt_count> filemarks."
9862 msgstr ""
9863
9864 #. type: TP
9865 #: build/C/man4/st.4:266
9866 #, no-wrap
9867 msgid "B<MTBSFM>"
9868 msgstr ""
9869
9870 #. type: Plain text
9871 #: build/C/man4/st.4:272
9872 msgid ""
9873 "Backward space over I<mt_count> filemarks.  Reposition the tape to the EOT "
9874 "side of the last filemark."
9875 msgstr ""
9876
9877 #. type: TP
9878 #: build/C/man4/st.4:272
9879 #, no-wrap
9880 msgid "B<MTBSR>"
9881 msgstr ""
9882
9883 #. type: Plain text
9884 #: build/C/man4/st.4:277
9885 msgid "Backward space over I<mt_count> records (tape blocks)."
9886 msgstr ""
9887
9888 #. type: TP
9889 #: build/C/man4/st.4:277
9890 #, no-wrap
9891 msgid "B<MTBSS>"
9892 msgstr ""
9893
9894 #. type: Plain text
9895 #: build/C/man4/st.4:282
9896 msgid "Backward space over I<mt_count> setmarks."
9897 msgstr ""
9898
9899 #. type: TP
9900 #: build/C/man4/st.4:282
9901 #, no-wrap
9902 msgid "B<MTCOMPRESSION>"
9903 msgstr ""
9904
9905 #. type: Plain text
9906 #: build/C/man4/st.4:290
9907 msgid ""
9908 "Enable compression of tape data within the drive if I<mt_count> is nonzero "
9909 "and disable compression if I<mt_count> is zero.  This command uses the MODE "
9910 "page 15 supported by most DATs."
9911 msgstr ""
9912
9913 #. type: TP
9914 #: build/C/man4/st.4:290
9915 #, no-wrap
9916 msgid "B<MTEOM>"
9917 msgstr ""
9918
9919 #. type: Plain text
9920 #: build/C/man4/st.4:293
9921 msgid "Go to the end of the recorded media (for appending files)."
9922 msgstr ""
9923
9924 #. type: TP
9925 #: build/C/man4/st.4:293
9926 #, no-wrap
9927 msgid "B<MTERASE>"
9928 msgstr ""
9929
9930 #. type: Plain text
9931 #: build/C/man4/st.4:299
9932 msgid ""
9933 "Erase tape.  With 2.6 kernel, short erase (mark tape empty) is performed if "
9934 "the argument is zero.  Otherwise, long erase (erase all) is done."
9935 msgstr ""
9936
9937 #. type: TP
9938 #: build/C/man4/st.4:299
9939 #, no-wrap
9940 msgid "B<MTFSF>"
9941 msgstr ""
9942
9943 #. type: Plain text
9944 #: build/C/man4/st.4:304
9945 msgid "Forward space over I<mt_count> filemarks."
9946 msgstr ""
9947
9948 #. type: TP
9949 #: build/C/man4/st.4:304
9950 #, no-wrap
9951 msgid "B<MTFSFM>"
9952 msgstr ""
9953
9954 #. type: Plain text
9955 #: build/C/man4/st.4:310
9956 msgid ""
9957 "Forward space over I<mt_count> filemarks.  Reposition the tape to the BOT "
9958 "side of the last filemark."
9959 msgstr ""
9960
9961 #. type: TP
9962 #: build/C/man4/st.4:310
9963 #, no-wrap
9964 msgid "B<MTFSR>"
9965 msgstr ""
9966
9967 #. type: Plain text
9968 #: build/C/man4/st.4:315
9969 msgid "Forward space over I<mt_count> records (tape blocks)."
9970 msgstr ""
9971
9972 #. type: TP
9973 #: build/C/man4/st.4:315
9974 #, no-wrap
9975 msgid "B<MTFSS>"
9976 msgstr ""
9977
9978 #. type: Plain text
9979 #: build/C/man4/st.4:320
9980 msgid "Forward space over I<mt_count> setmarks."
9981 msgstr ""
9982
9983 #. type: TP
9984 #: build/C/man4/st.4:320
9985 #, no-wrap
9986 msgid "B<MTLOAD>"
9987 msgstr ""
9988
9989 #. type: Plain text
9990 #: build/C/man4/st.4:331
9991 msgid ""
9992 "Execute the SCSI load command.  A special case is available for some HP "
9993 "autoloaders.  If I<mt_count> is the constant B<MT_ST_HPLOADER_OFFSET> plus a "
9994 "number, the number is sent to the drive to control the autoloader."
9995 msgstr ""
9996
9997 #. type: TP
9998 #: build/C/man4/st.4:331
9999 #, no-wrap
10000 msgid "B<MTLOCK>"
10001 msgstr ""
10002
10003 #. type: Plain text
10004 #: build/C/man4/st.4:334
10005 msgid "Lock the tape drive door."
10006 msgstr ""
10007
10008 #. type: TP
10009 #: build/C/man4/st.4:334
10010 #, no-wrap
10011 msgid "B<MTMKPART>"
10012 msgstr ""
10013
10014 #. type: Plain text
10015 #: build/C/man4/st.4:348
10016 msgid ""
10017 "Format the tape into one or two partitions.  If I<mt_count> is nonzero, it "
10018 "gives the size of the first partition and the second partition contains the "
10019 "rest of the tape.  If I<mt_count> is zero, the tape is formatted into one "
10020 "partition.  This command is not allowed for a drive unless the partition "
10021 "support is enabled for the drive (see B<MT_ST_CAN_PARTITIONS> below)."
10022 msgstr ""
10023
10024 #. type: TP
10025 #: build/C/man4/st.4:348
10026 #, no-wrap
10027 msgid "B<MTNOP>"
10028 msgstr ""
10029
10030 #. type: Plain text
10031 #: build/C/man4/st.4:353
10032 msgid ""
10033 "No op\\(emflushes the driver's buffer as a side effect.  Should be used "
10034 "before reading status with B<MTIOCGET>."
10035 msgstr ""
10036
10037 #. type: TP
10038 #: build/C/man4/st.4:353
10039 #, no-wrap
10040 msgid "B<MTOFFL>"
10041 msgstr ""
10042
10043 #. type: Plain text
10044 #: build/C/man4/st.4:356
10045 msgid "Rewind and put the drive off line."
10046 msgstr ""
10047
10048 #. type: TP
10049 #: build/C/man4/st.4:356
10050 #, no-wrap
10051 msgid "B<MTRESET>"
10052 msgstr ""
10053
10054 #. type: Plain text
10055 #: build/C/man4/st.4:359
10056 msgid "Reset drive."
10057 msgstr ""
10058
10059 #. type: TP
10060 #: build/C/man4/st.4:359
10061 #, no-wrap
10062 msgid "B<MTRETEN>"
10063 msgstr ""
10064
10065 #. type: Plain text
10066 #: build/C/man4/st.4:362
10067 msgid "Re-tension tape."
10068 msgstr ""
10069
10070 #. type: TP
10071 #: build/C/man4/st.4:362
10072 #, no-wrap
10073 msgid "B<MTREW>"
10074 msgstr ""
10075
10076 #. type: Plain text
10077 #: build/C/man4/st.4:365
10078 msgid "Rewind."
10079 msgstr ""
10080
10081 #. type: TP
10082 #: build/C/man4/st.4:365
10083 #, no-wrap
10084 msgid "B<MTSEEK>"
10085 msgstr ""
10086
10087 #. type: Plain text
10088 #: build/C/man4/st.4:377
10089 msgid ""
10090 "Seek to the tape block number specified in I<mt_count>.  This operation "
10091 "requires either a SCSI-2 drive that supports the B<LOCATE> command "
10092 "(device-specific address)  or a Tandberg-compatible SCSI-1 drive (Tandberg, "
10093 "Archive Viper, Wangtek, ...).  The block number should be one that was "
10094 "previously returned by B<MTIOCPOS> if device-specific addresses are used."
10095 msgstr ""
10096
10097 #. type: TP
10098 #: build/C/man4/st.4:377
10099 #, no-wrap
10100 msgid "B<MTSETBLK>"
10101 msgstr ""
10102
10103 #. type: Plain text
10104 #: build/C/man4/st.4:382
10105 msgid ""
10106 "Set the drive's block length to the value specified in I<mt_count>.  A block "
10107 "length of zero sets the drive to variable block size mode."
10108 msgstr ""
10109
10110 #. type: TP
10111 #: build/C/man4/st.4:382
10112 #, no-wrap
10113 msgid "B<MTSETDENSITY>"
10114 msgstr ""
10115
10116 #. type: Plain text
10117 #: build/C/man4/st.4:388
10118 msgid ""
10119 "Set the tape density to the code in I<mt_count>.  The density codes "
10120 "supported by a drive can be found from the drive documentation."
10121 msgstr ""
10122
10123 #. type: TP
10124 #: build/C/man4/st.4:388
10125 #, no-wrap
10126 msgid "B<MTSETPART>"
10127 msgstr ""
10128
10129 #. type: Plain text
10130 #: build/C/man4/st.4:397
10131 msgid ""
10132 "The active partition is switched to I<mt_count>.  The partitions are "
10133 "numbered from zero.  This command is not allowed for a drive unless the "
10134 "partition support is enabled for the drive (see B<MT_ST_CAN_PARTITIONS> "
10135 "below)."
10136 msgstr ""
10137
10138 #. type: TP
10139 #: build/C/man4/st.4:397
10140 #, no-wrap
10141 msgid "B<MTUNLOAD>"
10142 msgstr ""
10143
10144 #. type: Plain text
10145 #: build/C/man4/st.4:400
10146 msgid "Execute the SCSI unload command (does not eject the tape)."
10147 msgstr ""
10148
10149 #. type: TP
10150 #: build/C/man4/st.4:400
10151 #, no-wrap
10152 msgid "B<MTUNLOCK>"
10153 msgstr ""
10154
10155 #. type: Plain text
10156 #: build/C/man4/st.4:403
10157 msgid "Unlock the tape drive door."
10158 msgstr ""
10159
10160 #. type: TP
10161 #: build/C/man4/st.4:403
10162 #, no-wrap
10163 msgid "B<MTWEOF>"
10164 msgstr ""
10165
10166 #. type: Plain text
10167 #: build/C/man4/st.4:408
10168 msgid "Write I<mt_count> filemarks."
10169 msgstr ""
10170
10171 #. type: TP
10172 #: build/C/man4/st.4:408
10173 #, no-wrap
10174 msgid "B<MTWSM>"
10175 msgstr ""
10176
10177 #. type: Plain text
10178 #: build/C/man4/st.4:413
10179 msgid "Write I<mt_count> setmarks."
10180 msgstr ""
10181
10182 #. type: Plain text
10183 #: build/C/man4/st.4:415
10184 msgid "Magnetic Tape operations for setting of device options (by the superuser):"
10185 msgstr ""
10186
10187 #. type: TP
10188 #: build/C/man4/st.4:415
10189 #, no-wrap
10190 msgid "B<MTSETDRVBUFFER>"
10191 msgstr ""
10192
10193 #. type: Plain text
10194 #: build/C/man4/st.4:424
10195 msgid ""
10196 "Set various drive and driver options according to bits encoded in "
10197 "I<mt_count>.  These consist of the drive's buffering mode, a set of Boolean "
10198 "driver options, the buffer write threshold, defaults for the block size and "
10199 "density, and timeouts (only in kernels 2.1 and later).  A single operation "
10200 "can affect only one item in the list above (the Booleans counted as one "
10201 "item.)"
10202 msgstr ""
10203
10204 #. type: Plain text
10205 #: build/C/man4/st.4:428
10206 msgid ""
10207 "A value having zeros in the high-order 4 bits will be used to set the "
10208 "drive's buffering mode.  The buffering modes are:"
10209 msgstr ""
10210
10211 #. type: IP
10212 #: build/C/man4/st.4:429
10213 #, no-wrap
10214 msgid "0"
10215 msgstr ""
10216
10217 #. type: Plain text
10218 #: build/C/man4/st.4:434
10219 msgid ""
10220 "The drive will not report B<GOOD> status on write commands until the data "
10221 "blocks are actually written to the medium."
10222 msgstr ""
10223
10224 #. type: IP
10225 #: build/C/man4/st.4:434
10226 #, no-wrap
10227 msgid "1"
10228 msgstr ""
10229
10230 #. type: Plain text
10231 #: build/C/man4/st.4:439
10232 msgid ""
10233 "The drive may report B<GOOD> status on write commands as soon as all the "
10234 "data has been transferred to the drive's internal buffer."
10235 msgstr ""
10236
10237 #. type: IP
10238 #: build/C/man4/st.4:439
10239 #, no-wrap
10240 msgid "2"
10241 msgstr ""
10242
10243 #. type: Plain text
10244 #: build/C/man4/st.4:446
10245 msgid ""
10246 "The drive may report B<GOOD> status on write commands as soon as (a) all the "
10247 "data has been transferred to the drive's internal buffer, and (b) all "
10248 "buffered data from different initiators has been successfully written to the "
10249 "medium."
10250 msgstr ""
10251
10252 #. type: Plain text
10253 #: build/C/man4/st.4:457
10254 msgid ""
10255 "To control the write threshold the value in I<mt_count> must include the "
10256 "constant B<MT_ST_WRITE_THRESHOLD> bitwise ORed with a block count in the low "
10257 "28 bits.  The block count refers to 1024-byte blocks, not the physical block "
10258 "size on the tape.  The threshold cannot exceed the driver's internal buffer "
10259 "size (see DESCRIPTION, above)."
10260 msgstr ""
10261
10262 #. type: Plain text
10263 #: build/C/man4/st.4:478
10264 msgid ""
10265 "To set and clear the Boolean options the value in I<mt_count> must include "
10266 "one of the constants B<MT_ST_BOOLEANS>, B<MT_ST_SETBOOLEANS>, "
10267 "B<MT_ST_CLEARBOOLEANS>, or B<MT_ST_DEFBOOLEANS> bitwise ORed with whatever "
10268 "combination of the following options is desired.  Using B<MT_ST_BOOLEANS> "
10269 "the options can be set to the values defined in the corresponding bits.  "
10270 "With B<MT_ST_SETBOOLEANS> the options can be selectively set and with "
10271 "B<MT_ST_DEFBOOLEANS> selectively cleared."
10272 msgstr ""
10273
10274 #. type: Plain text
10275 #: build/C/man4/st.4:486
10276 msgid ""
10277 "The default options for a tape device are set with B<MT_ST_DEFBOOLEANS>.  A "
10278 "nonactive tape device (e.g., device with minor 32 or 160) is activated when "
10279 "the default options for it are defined the first time.  An activated device "
10280 "inherits from the device activated at start-up the options not set "
10281 "explicitly."
10282 msgstr ""
10283
10284 #. type: Plain text
10285 #: build/C/man4/st.4:488
10286 msgid "The Boolean options are:"
10287 msgstr ""
10288
10289 #. type: TP
10290 #: build/C/man4/st.4:489
10291 #, no-wrap
10292 msgid "B<MT_ST_BUFFER_WRITES> (Default: true)"
10293 msgstr ""
10294
10295 #. type: Plain text
10296 #: build/C/man4/st.4:495
10297 msgid ""
10298 "Buffer all write operations in fixed-block mode.  If this option is false "
10299 "and the drive uses a fixed block size, then all write operations must be for "
10300 "a multiple of the block size.  This option must be set false to write "
10301 "reliable multivolume archives."
10302 msgstr ""
10303
10304 #. type: TP
10305 #: build/C/man4/st.4:495
10306 #, no-wrap
10307 msgid "B<MT_ST_ASYNC_WRITES> (Default: true)"
10308 msgstr ""
10309
10310 #. type: Plain text
10311 #: build/C/man4/st.4:505
10312 msgid ""
10313 "When this option is true, write operations return immediately without "
10314 "waiting for the data to be transferred to the drive if the data fits into "
10315 "the driver's buffer.  The write threshold determines how full the buffer "
10316 "must be before a new SCSI write command is issued.  Any errors reported by "
10317 "the drive will be held until the next operation.  This option must be set "
10318 "false to write reliable multivolume archives."
10319 msgstr ""
10320
10321 #. type: TP
10322 #: build/C/man4/st.4:505
10323 #, no-wrap
10324 msgid "B<MT_ST_READ_AHEAD> (Default: true)"
10325 msgstr ""
10326
10327 #. type: Plain text
10328 #: build/C/man4/st.4:511
10329 msgid ""
10330 "This option causes the driver to provide read buffering and read-ahead in "
10331 "fixed-block mode.  If this option is false and the drive uses a fixed block "
10332 "size, then all read operations must be for a multiple of the block size."
10333 msgstr ""
10334
10335 #. type: TP
10336 #: build/C/man4/st.4:511
10337 #, no-wrap
10338 msgid "B<MT_ST_TWO_FM> (Default: false)"
10339 msgstr ""
10340
10341 #. type: Plain text
10342 #: build/C/man4/st.4:517
10343 msgid ""
10344 "This option modifies the driver behavior when a file is closed.  The normal "
10345 "action is to write a single filemark.  If the option is true, the driver "
10346 "will write two filemarks and backspace over the second one."
10347 msgstr ""
10348
10349 #. type: Plain text
10350 #: build/C/man4/st.4:526
10351 msgid ""
10352 "Note: This option should not be set true for QIC tape drives since they are "
10353 "unable to overwrite a filemark.  These drives detect the end of recorded "
10354 "data by testing for blank tape rather than two consecutive filemarks.  Most "
10355 "other current drives also detect the end of recorded data and using two "
10356 "filemarks is usually necessary only when interchanging tapes with some other "
10357 "systems."
10358 msgstr ""
10359
10360 #. type: TP
10361 #: build/C/man4/st.4:526
10362 #, no-wrap
10363 msgid "B<MT_ST_DEBUGGING> (Default: false)"
10364 msgstr ""
10365
10366 #. type: Plain text
10367 #: build/C/man4/st.4:532
10368 msgid ""
10369 "This option turns on various debugging messages from the driver (effective "
10370 "only if the driver was compiled with B<DEBUG> defined nonzero)."
10371 msgstr ""
10372
10373 #. type: TP
10374 #: build/C/man4/st.4:532
10375 #, no-wrap
10376 msgid "B<MT_ST_FAST_EOM> (Default: false)"
10377 msgstr ""
10378
10379 #. type: Plain text
10380 #: build/C/man4/st.4:546
10381 msgid ""
10382 "This option causes the B<MTEOM> operation to be sent directly to the drive, "
10383 "potentially speeding up the operation but causing the driver to lose track "
10384 "of the current file number normally returned by the B<MTIOCGET> request.  If "
10385 "B<MT_ST_FAST_EOM> is false, the driver will respond to an B<MTEOM> request "
10386 "by forward spacing over files."
10387 msgstr ""
10388
10389 #. type: TP
10390 #: build/C/man4/st.4:546
10391 #, no-wrap
10392 msgid "B<MT_ST_AUTO_LOCK> (Default: false)"
10393 msgstr ""
10394
10395 #. type: Plain text
10396 #: build/C/man4/st.4:550
10397 msgid ""
10398 "When this option is true, the drive door is locked when the device is opened "
10399 "and unlocked when it is closed."
10400 msgstr ""
10401
10402 #. type: TP
10403 #: build/C/man4/st.4:550
10404 #, no-wrap
10405 msgid "B<MT_ST_DEF_WRITES> (Default: false)"
10406 msgstr ""
10407
10408 #. type: Plain text
10409 #: build/C/man4/st.4:567
10410 msgid ""
10411 "The tape options (block size, mode, compression, etc.) may change when "
10412 "changing from one device linked to a drive to another device linked to the "
10413 "same drive depending on how the devices are defined.  This option defines "
10414 "when the changes are enforced by the driver using SCSI-commands and when the "
10415 "drives auto-detection capabilities are relied upon.  If this option is "
10416 "false, the driver sends the SCSI-commands immediately when the device is "
10417 "changed.  If the option is true, the SCSI-commands are not sent until a "
10418 "write is requested.  In this case, the drive firmware is allowed to detect "
10419 "the tape structure when reading and the SCSI-commands are used only to make "
10420 "sure that a tape is written according to the correct specification."
10421 msgstr ""
10422
10423 #. type: TP
10424 #: build/C/man4/st.4:567
10425 #, no-wrap
10426 msgid "B<MT_ST_CAN_BSR> (Default: false)"
10427 msgstr ""
10428
10429 #. type: Plain text
10430 #: build/C/man4/st.4:580
10431 msgid ""
10432 "When read-ahead is used, the tape must sometimes be spaced backward to the "
10433 "correct position when the device is closed and the SCSI command to space "
10434 "backward over records is used for this purpose.  Some older drives can't "
10435 "process this command reliably and this option can be used to instruct the "
10436 "driver not to use the command.  The end result is that, with read-ahead and "
10437 "fixed-block mode, the tape may not be correctly positioned within a file "
10438 "when the device is closed.  With 2.6 kernel, the default is true for drives "
10439 "supporting SCSI-3."
10440 msgstr ""
10441
10442 #. type: TP
10443 #: build/C/man4/st.4:580
10444 #, no-wrap
10445 msgid "B<MT_ST_NO_BLKLIMS> (Default: false)"
10446 msgstr ""
10447
10448 #. type: Plain text
10449 #: build/C/man4/st.4:589
10450 msgid ""
10451 "Some drives don't accept the B<READ BLOCK LIMITS> SCSI command.  If this is "
10452 "used, the driver does not use the command.  The drawback is that the driver "
10453 "can't check before sending commands if the selected block size is acceptable "
10454 "to the drive."
10455 msgstr ""
10456
10457 #. type: TP
10458 #: build/C/man4/st.4:589
10459 #, no-wrap
10460 msgid "B<MT_ST_CAN_PARTITIONS> (Default: false)"
10461 msgstr ""
10462
10463 #. type: Plain text
10464 #: build/C/man4/st.4:594
10465 msgid ""
10466 "This option enables support for several partitions within a tape.  The "
10467 "option applies to all devices linked to a drive."
10468 msgstr ""
10469
10470 #. type: TP
10471 #: build/C/man4/st.4:594
10472 #, no-wrap
10473 msgid "B<MT_ST_SCSI2LOGICAL> (Default: false)"
10474 msgstr ""
10475
10476 #. type: Plain text
10477 #: build/C/man4/st.4:609
10478 msgid ""
10479 "This option instructs the driver to use the logical block addresses defined "
10480 "in the SCSI-2 standard when performing the seek and tell operations (both "
10481 "with B<MTSEEK> and B<MTIOCPOS> commands and when changing tape partition).  "
10482 "Otherwise, the device-specific addresses are used.  It is highly advisable "
10483 "to set this option if the drive supports the logical addresses because they "
10484 "count also filemarks.  There are some drives that support only the logical "
10485 "block addresses."
10486 msgstr ""
10487
10488 #. type: TP
10489 #: build/C/man4/st.4:609
10490 #, no-wrap
10491 msgid "B<MT_ST_SYSV> (Default: false)"
10492 msgstr ""
10493
10494 #. type: Plain text
10495 #: build/C/man4/st.4:620
10496 msgid ""
10497 "When this option is enabled, the tape devices use the SystemV semantics.  "
10498 "Otherwise, the BSD semantics are used.  The most important difference "
10499 "between the semantics is what happens when a device used for reading is "
10500 "closed: in System V semantics the tape is spaced forward past the next "
10501 "filemark if this has not happened while using the device.  In BSD semantics "
10502 "the tape position is not changed."
10503 msgstr ""
10504
10505 #. type: TP
10506 #: build/C/man4/st.4:620
10507 #, no-wrap
10508 msgid "B<MT_NO_WAIT> (Default: false)"
10509 msgstr ""
10510
10511 #. type: Plain text
10512 #: build/C/man4/st.4:624
10513 msgid ""
10514 "Enables immediate mode (i.e., don't wait for the command to finish) for some "
10515 "commands (e.g., rewind)."
10516 msgstr ""
10517
10518 #. type: Plain text
10519 #: build/C/man4/st.4:626
10520 msgid "An example:"
10521 msgstr ""
10522
10523 #. type: Plain text
10524 #: build/C/man4/st.4:634
10525 #, no-wrap
10526 msgid ""
10527 "struct mtop mt_cmd;\n"
10528 "mt_cmd.mt_op = MTSETDRVBUFFER;\n"
10529 "mt_cmd.mt_count = MT_ST_BOOLEANS |\n"
10530 "        MT_ST_BUFFER_WRITES | MT_ST_ASYNC_WRITES;\n"
10531 "ioctl(fd, MTIOCTOP, mt_cmd);\n"
10532 msgstr ""
10533
10534 #. type: Plain text
10535 #: build/C/man4/st.4:644
10536 msgid ""
10537 "The default block size for a device can be set with B<MT_ST_DEF_BLKSIZE> and "
10538 "the default density code can be set with B<MT_ST_DEFDENSITY>.  The values "
10539 "for the parameters are or'ed with the operation code."
10540 msgstr ""
10541
10542 #. type: Plain text
10543 #: build/C/man4/st.4:661
10544 msgid ""
10545 "With kernels 2.1.x and later, the timeout values can be set with the "
10546 "subcommand B<MT_ST_SET_TIMEOUT> ORed with the timeout in seconds.  The long "
10547 "timeout (used for rewinds and other commands that may take a long time) can "
10548 "be set with B<MT_ST_SET_LONG_TIMEOUT>.  The kernel defaults are very long to "
10549 "make sure that a successful command is not timed out with any drive.  "
10550 "Because of this the driver may seem stuck even if it is only waiting for the "
10551 "timeout.  These commands can be used to set more practical values for a "
10552 "specific drive.  The timeouts set for one device apply for all devices "
10553 "linked to the same drive."
10554 msgstr ""
10555
10556 #. type: Plain text
10557 #: build/C/man4/st.4:682
10558 msgid ""
10559 "Starting from kernels 2.4.19 and 2.5.43, the driver supports a status bit "
10560 "which indicates whether the drive requests cleaning.  The method used by the "
10561 "drive to return cleaning information is set using the B<MT_ST_SEL_CLN> "
10562 "subcommand.  If the value is zero, the cleaning bit is always zero.  If the "
10563 "value is one, the TapeAlert data defined in the SCSI-3 standard is used (not "
10564 "yet implemented).  Values 2-17 are reserved.  If the lowest eight bits are "
10565 "E<gt>= 18, bits from the extended sense data are used.  The bits 9-16 "
10566 "specify a mask to select the bits to look at and the bits 17-23 specify the "
10567 "bit pattern to look for.  If the bit pattern is zero, one or more bits under "
10568 "the mask indicate the cleaning request.  If the pattern is nonzero, the "
10569 "pattern must match the masked sense data byte."
10570 msgstr ""
10571
10572 #. type: SS
10573 #: build/C/man4/st.4:682
10574 #, no-wrap
10575 msgid "MTIOCGET \\(em get status"
10576 msgstr ""
10577
10578 #. type: Plain text
10579 #: build/C/man4/st.4:686
10580 msgid "This request takes an argument of type I<(struct mtget\\ *)>."
10581 msgstr ""
10582
10583 #. type: Plain text
10584 #: build/C/man4/st.4:701
10585 #, no-wrap
10586 msgid ""
10587 "/* structure for MTIOCGET - mag tape get status command */\n"
10588 "struct mtget {\n"
10589 "    long     mt_type;\n"
10590 "    long     mt_resid;\n"
10591 "    /* the following registers are device dependent */\n"
10592 "    long     mt_dsreg;\n"
10593 "    long     mt_gstat;\n"
10594 "    long     mt_erreg;\n"
10595 "    /* The next two fields are not always used */\n"
10596 "    daddr_t  mt_fileno;\n"
10597 "    daddr_t  mt_blkno;\n"
10598 "};\n"
10599 msgstr ""
10600
10601 #. type: IP
10602 #: build/C/man4/st.4:703
10603 #, no-wrap
10604 msgid "I<mt_type>"
10605 msgstr ""
10606
10607 #. type: Plain text
10608 #: build/C/man4/st.4:712
10609 msgid ""
10610 "The header file defines many values for I<mt_type>, but the current driver "
10611 "reports only the generic types B<MT_ISSCSI1> (Generic SCSI-1 tape)  and "
10612 "B<MT_ISSCSI2> (Generic SCSI-2 tape)."
10613 msgstr ""
10614
10615 #. type: IP
10616 #: build/C/man4/st.4:712
10617 #, no-wrap
10618 msgid "I<mt_resid>"
10619 msgstr ""
10620
10621 #. type: Plain text
10622 #: build/C/man4/st.4:714
10623 msgid "contains the current tape partition number."
10624 msgstr ""
10625
10626 #. type: IP
10627 #: build/C/man4/st.4:714
10628 #, no-wrap
10629 msgid "I<mt_dsreg>"
10630 msgstr ""
10631
10632 #. type: Plain text
10633 #: build/C/man4/st.4:723
10634 msgid ""
10635 "reports the drive's current settings for block size (in the low 24 bits) and "
10636 "density (in the high 8 bits).  These fields are defined by "
10637 "B<MT_ST_BLKSIZE_SHIFT>, B<MT_ST_BLKSIZE_MASK>, B<MT_ST_DENSITY_SHIFT>, and "
10638 "B<MT_ST_DENSITY_MASK>."
10639 msgstr ""
10640
10641 #. type: IP
10642 #: build/C/man4/st.4:723
10643 #, no-wrap
10644 msgid "I<mt_gstat>"
10645 msgstr ""
10646
10647 #. type: Plain text
10648 #: build/C/man4/st.4:726
10649 msgid ""
10650 "reports generic (device independent) status information.  The header file "
10651 "defines macros for testing these status bits:"
10652 msgstr ""
10653
10654 #. type: Plain text
10655 #: build/C/man4/st.4:733
10656 msgid ""
10657 "B<GMT_EOF>(I<x>): The tape is positioned just after a filemark (always false "
10658 "after an B<MTSEEK> operation)."
10659 msgstr ""
10660
10661 #. type: Plain text
10662 #: build/C/man4/st.4:739
10663 msgid ""
10664 "B<GMT_BOT>(I<x>): The tape is positioned at the beginning of the first file "
10665 "(always false after an B<MTSEEK> operation)."
10666 msgstr ""
10667
10668 #. type: Plain text
10669 #: build/C/man4/st.4:742
10670 msgid "B<GMT_EOT>(I<x>): A tape operation has reached the physical End Of Tape."
10671 msgstr ""
10672
10673 #. type: Plain text
10674 #: build/C/man4/st.4:748
10675 msgid ""
10676 "B<GMT_SM>(I<x>): The tape is currently positioned at a setmark (always false "
10677 "after an B<MTSEEK> operation)."
10678 msgstr ""
10679
10680 #. type: Plain text
10681 #: build/C/man4/st.4:751
10682 msgid "B<GMT_EOD>(I<x>): The tape is positioned at the end of recorded data."
10683 msgstr ""
10684
10685 #. type: Plain text
10686 #: build/C/man4/st.4:756
10687 msgid ""
10688 "B<GMT_WR_PROT>(I<x>): The drive is write-protected.  For some drives this "
10689 "can also mean that the drive does not support writing on the current medium "
10690 "type."
10691 msgstr ""
10692
10693 #. type: Plain text
10694 #: build/C/man4/st.4:761
10695 msgid ""
10696 "B<GMT_ONLINE>(I<x>): The last B<open>(2)  found the drive with a tape in "
10697 "place and ready for operation."
10698 msgstr ""
10699
10700 #. type: Plain text
10701 #: build/C/man4/st.4:765
10702 msgid ""
10703 "B<GMT_D_6250>(I<x>), B<GMT_D_1600>(I<x>), B<GMT_D_800>(I<x>): This "
10704 "\\(lqgeneric\\(rq status information reports the current density setting for "
10705 "9-track \\(12\" tape drives only."
10706 msgstr ""
10707
10708 #. type: Plain text
10709 #: build/C/man4/st.4:768
10710 msgid "B<GMT_DR_OPEN>(I<x>): The drive does not have a tape in place."
10711 msgstr ""
10712
10713 #. type: Plain text
10714 #: build/C/man4/st.4:776
10715 msgid ""
10716 "B<GMT_IM_REP_EN>(I<x>): Immediate report mode.  This bit is set if there are "
10717 "no guarantees that the data has been physically written to the tape when the "
10718 "write call returns.  It is set zero only when the driver does not buffer "
10719 "data and the drive is set not to buffer data."
10720 msgstr ""
10721
10722 #. type: Plain text
10723 #: build/C/man4/st.4:780
10724 msgid ""
10725 "B<GMT_CLN>(I<x>): The drive has requested cleaning.  Implemented in kernels "
10726 "since 2.4.19 and 2.5.43."
10727 msgstr ""
10728
10729 #. type: IP
10730 #: build/C/man4/st.4:781
10731 #, no-wrap
10732 msgid "I<mt_erreg>"
10733 msgstr ""
10734
10735 #. type: Plain text
10736 #: build/C/man4/st.4:791
10737 msgid ""
10738 "The only field defined in I<mt_erreg> is the recovered error count in the "
10739 "low 16 bits (as defined by B<MT_ST_SOFTERR_SHIFT> and "
10740 "B<MT_ST_SOFTERR_MASK>.  Due to inconsistencies in the way drives report "
10741 "recovered errors, this count is often not maintained (most drives do not by "
10742 "default report soft errors but this can be changed with a SCSI MODE SELECT "
10743 "command)."
10744 msgstr ""
10745
10746 #. type: IP
10747 #: build/C/man4/st.4:791
10748 #, no-wrap
10749 msgid "I<mt_fileno>"
10750 msgstr ""
10751
10752 #. type: Plain text
10753 #: build/C/man4/st.4:797
10754 msgid ""
10755 "reports the current file number (zero-based).  This value is set to -1 when "
10756 "the file number is unknown (e.g., after B<MTBSS> or B<MTSEEK>)."
10757 msgstr ""
10758
10759 #. type: IP
10760 #: build/C/man4/st.4:797
10761 #, no-wrap
10762 msgid "I<mt_blkno>"
10763 msgstr ""
10764
10765 #. type: Plain text
10766 #: build/C/man4/st.4:804
10767 msgid ""
10768 "reports the block number (zero-based) within the current file.  This value "
10769 "is set to -1 when the block number is unknown (e.g., after B<MTBSF>, "
10770 "B<MTBSS>, or B<MTSEEK>)."
10771 msgstr ""
10772
10773 #. type: SS
10774 #: build/C/man4/st.4:804
10775 #, no-wrap
10776 msgid "MTIOCPOS \\(em get tape position"
10777 msgstr ""
10778
10779 #. type: Plain text
10780 #: build/C/man4/st.4:818
10781 msgid ""
10782 "This request takes an argument of type I<(struct mtpos\\ *)> and reports the "
10783 "drive's notion of the current tape block number, which is not the same as "
10784 "I<mt_blkno> returned by B<MTIOCGET>.  This drive must be a SCSI-2 drive that "
10785 "supports the B<READ POSITION> command (device-specific address)  or a "
10786 "Tandberg-compatible SCSI-1 drive (Tandberg, Archive Viper, Wangtek, ... )."
10787 msgstr ""
10788
10789 #. type: Plain text
10790 #: build/C/man4/st.4:825
10791 #, no-wrap
10792 msgid ""
10793 "/* structure for MTIOCPOS - mag tape get position command */\n"
10794 "struct mtpos {\n"
10795 "    long mt_blkno;    /* current block number */\n"
10796 "};\n"
10797 msgstr ""
10798
10799 #. type: Plain text
10800 #: build/C/man4/st.4:834
10801 msgid ""
10802 "An attempt was made to write or erase a write-protected tape.  (This error "
10803 "is not detected during B<open>(2).)"
10804 msgstr ""
10805
10806 #. type: TP
10807 #: build/C/man4/st.4:834
10808 #, no-wrap
10809 msgid "B<EBUSY>"
10810 msgstr ""
10811
10812 #. type: Plain text
10813 #: build/C/man4/st.4:838
10814 msgid "The device is already in use or the driver was unable to allocate a buffer."
10815 msgstr ""
10816
10817 #. type: Plain text
10818 #: build/C/man4/st.4:842
10819 msgid "The command parameters point to memory not belonging to the calling process."
10820 msgstr ""
10821
10822 #. type: Plain text
10823 #: build/C/man4/st.4:847
10824 msgid ""
10825 "An B<ioctl>(2)  had an invalid argument, or a requested block size was "
10826 "invalid."
10827 msgstr ""
10828
10829 #. type: TP
10830 #: build/C/man4/st.4:847
10831 #, no-wrap
10832 msgid "B<EIO>"
10833 msgstr ""
10834
10835 #. type: Plain text
10836 #: build/C/man4/st.4:850
10837 msgid "The requested operation could not be completed."
10838 msgstr ""
10839
10840 #. type: Plain text
10841 #: build/C/man4/st.4:857
10842 msgid ""
10843 "The byte count in B<read>(2)  is smaller than the next physical block on the "
10844 "tape.  (Before 2.2.18 and 2.4.0-test6 the extra bytes have been silently "
10845 "ignored.)"
10846 msgstr ""
10847
10848 #. type: Plain text
10849 #: build/C/man4/st.4:861
10850 msgid ""
10851 "A write operation could not be completed because the tape reached "
10852 "end-of-medium."
10853 msgstr ""
10854
10855 #. type: TP
10856 #: build/C/man4/st.4:861 build/C/man2/syslog.2:355
10857 #, no-wrap
10858 msgid "B<ENOSYS>"
10859 msgstr ""
10860
10861 #. type: Plain text
10862 #: build/C/man4/st.4:865
10863 msgid "Unknown B<ioctl>(2)."
10864 msgstr ""
10865
10866 #. type: TP
10867 #: build/C/man4/st.4:865
10868 #, no-wrap
10869 msgid "B<ENXIO>"
10870 msgstr ""
10871
10872 #. type: Plain text
10873 #: build/C/man4/st.4:868
10874 msgid "During opening, the tape device does not exist."
10875 msgstr ""
10876
10877 #. type: TP
10878 #: build/C/man4/st.4:868
10879 #, no-wrap
10880 msgid "B<EOVERFLOW>"
10881 msgstr ""
10882
10883 #. type: Plain text
10884 #: build/C/man4/st.4:872
10885 msgid ""
10886 "An attempt was made to read or write a variable-length block that is larger "
10887 "than the driver's internal buffer."
10888 msgstr ""
10889
10890 #. type: Plain text
10891 #: build/C/man4/st.4:879
10892 msgid ""
10893 "Open is attempted with B<O_WRONLY> or B<O_RDWR> when the tape in the drive "
10894 "is write-protected."
10895 msgstr ""
10896
10897 #. type: TP
10898 #: build/C/man4/st.4:880
10899 #, no-wrap
10900 msgid "I</dev/st*>"
10901 msgstr ""
10902
10903 #. type: Plain text
10904 #: build/C/man4/st.4:883
10905 msgid "the auto-rewind SCSI tape devices"
10906 msgstr ""
10907
10908 #. type: TP
10909 #: build/C/man4/st.4:883
10910 #, no-wrap
10911 msgid "I</dev/nst*>"
10912 msgstr ""
10913
10914 #.  .SH AUTHOR
10915 #.  The driver has been written by Kai M\(:akisara (Kai.Makisara@metla.fi)
10916 #.  starting from a driver written by Dwayne Forsyth.
10917 #.  Several other
10918 #.  people have also contributed to the driver.
10919 #. type: Plain text
10920 #: build/C/man4/st.4:891
10921 msgid "the nonrewind SCSI tape devices"
10922 msgstr ""
10923
10924 #. type: Plain text
10925 #: build/C/man4/st.4:912
10926 msgid ""
10927 "When exchanging data between systems, both systems have to agree on the "
10928 "physical tape block size.  The parameters of a drive after startup are often "
10929 "not the ones most operating systems use with these devices.  Most systems "
10930 "use drives in variable-block mode if the drive supports that mode.  This "
10931 "applies to most modern drives, including DATs, 8mm helical scan drives, "
10932 "DLTs, etc.  It may be advisable to use these drives in variable-block mode "
10933 "also in Linux (i.e., use B<MTSETBLK> or B<MTSETDEFBLK> at system startup to "
10934 "set the mode), at least when exchanging data with a foreign system.  The "
10935 "drawback of this is that a fairly large tape block size has to be used to "
10936 "get acceptable data transfer rates on the SCSI bus."
10937 msgstr ""
10938
10939 #. type: Plain text
10940 #: build/C/man4/st.4:919
10941 msgid ""
10942 "Many programs (e.g., B<tar>(1))  allow the user to specify the blocking "
10943 "factor on the command line.  Note that this determines the physical block "
10944 "size on tape only in variable-block mode."
10945 msgstr ""
10946
10947 #. type: Plain text
10948 #: build/C/man4/st.4:926
10949 msgid ""
10950 "In order to use SCSI tape drives, the basic SCSI driver, a SCSI-adapter "
10951 "driver and the SCSI tape driver must be either configured into the kernel or "
10952 "loaded as modules.  If the SCSI-tape driver is not present, the drive is "
10953 "recognized but the tape support described in this page is not available."
10954 msgstr ""
10955
10956 #. type: Plain text
10957 #: build/C/man4/st.4:931
10958 msgid ""
10959 "The driver writes error messages to the console/log.  The SENSE codes "
10960 "written into some messages are automatically translated to text if verbose "
10961 "SCSI messages are enabled in kernel configuration."
10962 msgstr ""
10963
10964 #.  .SH COPYRIGHT
10965 #.  Copyright \(co 1995 Robert K. Nichols.
10966 #.  .br
10967 #.  Copyright \(co 1999-2005 Kai M\(:akisara.
10968 #.  .PP
10969 #.  %%%LICENSE_START(VERBATIM)
10970 #.  Permission is granted to make and distribute verbatim copies of this
10971 #.  manual provided the copyright notice and this permission notice are
10972 #.  preserved on all copies.
10973 #.  Additional permissions are contained in the header of the source file.
10974 #. type: Plain text
10975 #: build/C/man4/st.4:954
10976 msgid ""
10977 "The driver's internal buffering allows good throughput in fixed-block mode "
10978 "also with small B<read>(2)  and B<write>(2)  byte counts.  With direct "
10979 "transfers this is not possible and may cause a surprise when moving to the "
10980 "2.6 kernel.  The solution is to tell the software to use larger transfers "
10981 "(often telling it to use larger blocks).  If this is not possible, direct "
10982 "transfers can be disabled."
10983 msgstr ""
10984
10985 #. type: Plain text
10986 #: build/C/man4/st.4:956
10987 msgid "B<mt>(1)"
10988 msgstr ""
10989
10990 #. type: Plain text
10991 #: build/C/man4/st.4:963
10992 msgid ""
10993 "The file I<drivers/scsi/README.st> or I<Documentation/scsi/st.txt> (kernel "
10994 "E<gt>= 2.6) in the Linux kernel source tree contains the most recent "
10995 "information about the driver and its configuration possibilities"
10996 msgstr ""
10997
10998 #. type: TH
10999 #: build/C/man3/stdarg.3:43
11000 #, no-wrap
11001 msgid "STDARG"
11002 msgstr ""
11003
11004 #. type: TH
11005 #: build/C/man3/stdarg.3:43
11006 #, no-wrap
11007 msgid "2013-12-10"
11008 msgstr ""
11009
11010 #. type: Plain text
11011 #: build/C/man3/stdarg.3:46
11012 msgid "stdarg, va_start, va_arg, va_end, va_copy - variable argument lists"
11013 msgstr ""
11014
11015 #. type: Plain text
11016 #: build/C/man3/stdarg.3:48 build/C/man3/syslog.3:49
11017 msgid "B<#include E<lt>stdarg.hE<gt>>"
11018 msgstr ""
11019
11020 #. type: Plain text
11021 #: build/C/man3/stdarg.3:50
11022 msgid "B<void va_start(va_list >I<ap>B<, >I<last>B<);>"
11023 msgstr ""
11024
11025 #. type: Plain text
11026 #: build/C/man3/stdarg.3:52
11027 msgid "I<type>B< va_arg(va_list >I<ap>B<, >I<type>B<);>"
11028 msgstr ""
11029
11030 #. type: Plain text
11031 #: build/C/man3/stdarg.3:54
11032 msgid "B<void va_end(va_list >I<ap>B<);>"
11033 msgstr ""
11034
11035 #. type: Plain text
11036 #: build/C/man3/stdarg.3:56
11037 msgid "B<void va_copy(va_list >I<dest>B<, va_list >I<src>B<);>"
11038 msgstr ""
11039
11040 #. type: Plain text
11041 #: build/C/man3/stdarg.3:65
11042 msgid ""
11043 "A function may be called with a varying number of arguments of varying "
11044 "types.  The include file I<E<lt>stdarg.hE<gt>> declares a type I<va_list> "
11045 "and defines three macros for stepping through a list of arguments whose "
11046 "number and types are not known to the called function."
11047 msgstr ""
11048
11049 #. type: Plain text
11050 #: build/C/man3/stdarg.3:73
11051 msgid ""
11052 "The called function must declare an object of type I<va_list> which is used "
11053 "by the macros B<va_start>(), B<va_arg>(), and B<va_end>()."
11054 msgstr ""
11055
11056 #. type: SS
11057 #: build/C/man3/stdarg.3:73
11058 #, no-wrap
11059 msgid "va_start()"
11060 msgstr ""
11061
11062 #. type: Plain text
11063 #: build/C/man3/stdarg.3:83
11064 msgid ""
11065 "The B<va_start>()  macro initializes I<ap> for subsequent use by B<va_arg>()  "
11066 "and B<va_end>(), and must be called first."
11067 msgstr ""
11068
11069 #. type: Plain text
11070 #: build/C/man3/stdarg.3:88
11071 msgid ""
11072 "The argument I<last> is the name of the last argument before the variable "
11073 "argument list, that is, the last argument of which the calling function "
11074 "knows the type."
11075 msgstr ""
11076
11077 #. type: Plain text
11078 #: build/C/man3/stdarg.3:93
11079 msgid ""
11080 "Because the address of this argument may be used in the B<va_start>()  "
11081 "macro, it should not be declared as a register variable, or as a function or "
11082 "an array type."
11083 msgstr ""
11084
11085 #. type: SS
11086 #: build/C/man3/stdarg.3:93
11087 #, no-wrap
11088 msgid "va_arg()"
11089 msgstr ""
11090
11091 #. type: Plain text
11092 #: build/C/man3/stdarg.3:115
11093 msgid ""
11094 "The B<va_arg>()  macro expands to an expression that has the type and value "
11095 "of the next argument in the call.  The argument I<ap> is the I<va_list> "
11096 "I<ap> initialized by B<va_start>().  Each call to B<va_arg>()  modifies "
11097 "I<ap> so that the next call returns the next argument.  The argument I<type> "
11098 "is a type name specified so that the type of a pointer to an object that has "
11099 "the specified type can be obtained simply by adding a * to I<type>."
11100 msgstr ""
11101
11102 #. type: Plain text
11103 #: build/C/man3/stdarg.3:123
11104 msgid ""
11105 "The first use of the B<va_arg>()  macro after that of the B<va_start>()  "
11106 "macro returns the argument after I<last>.  Successive invocations return the "
11107 "values of the remaining arguments."
11108 msgstr ""
11109
11110 #. type: Plain text
11111 #: build/C/man3/stdarg.3:128
11112 msgid ""
11113 "If there is no next argument, or if I<type> is not compatible with the type "
11114 "of the actual next argument (as promoted according to the default argument "
11115 "promotions), random errors will occur."
11116 msgstr ""
11117
11118 #. type: Plain text
11119 #: build/C/man3/stdarg.3:136
11120 msgid ""
11121 "If I<ap> is passed to a function that uses B<va_arg(>I<ap>B<,>I<type>B<),> "
11122 "then the value of I<ap> is undefined after the return of that function."
11123 msgstr ""
11124
11125 #. type: SS
11126 #: build/C/man3/stdarg.3:136
11127 #, no-wrap
11128 msgid "va_end()"
11129 msgstr ""
11130
11131 #. type: Plain text
11132 #: build/C/man3/stdarg.3:155
11133 msgid ""
11134 "Each invocation of B<va_start>()  must be matched by a corresponding "
11135 "invocation of B<va_end>()  in the same function.  After the call "
11136 "B<va_end(>I<ap>B<)> the variable I<ap> is undefined.  Multiple traversals of "
11137 "the list, each bracketed by B<va_start>()  and B<va_end>()  are possible.  "
11138 "B<va_end>()  may be a macro or a function."
11139 msgstr ""
11140
11141 #. type: SS
11142 #: build/C/man3/stdarg.3:155
11143 #, no-wrap
11144 msgid "va_copy()"
11145 msgstr ""
11146
11147 #. type: Plain text
11148 #: build/C/man3/stdarg.3:172
11149 msgid ""
11150 "The B<va_copy>()  macro copies the (previously initialized) variable "
11151 "argument list I<src> to I<dest>.  The behavior is as if B<va_start>()  were "
11152 "applied to I<dest> with the same I<last> argument, followed by the same "
11153 "number of B<va_arg>()  invocations that was used to reach the current state "
11154 "of I<src>."
11155 msgstr ""
11156
11157 #.  Proposal from clive@demon.net, 1997-02-28
11158 #. type: Plain text
11159 #: build/C/man3/stdarg.3:179
11160 msgid ""
11161 "An obvious implementation would have a I<va_list> be a pointer to the stack "
11162 "frame of the variadic function.  In such a setup (by far the most common) "
11163 "there seems nothing against an assignment"
11164 msgstr ""
11165
11166 #. type: Plain text
11167 #: build/C/man3/stdarg.3:183
11168 #, no-wrap
11169 msgid "va_list aq = ap;\n"
11170 msgstr ""
11171
11172 #. type: Plain text
11173 #: build/C/man3/stdarg.3:188
11174 msgid ""
11175 "Unfortunately, there are also systems that make it an array of pointers (of "
11176 "length 1), and there one needs"
11177 msgstr ""
11178
11179 #. type: Plain text
11180 #: build/C/man3/stdarg.3:193
11181 #, no-wrap
11182 msgid ""
11183 "va_list aq;\n"
11184 "*aq = *ap;\n"
11185 msgstr ""
11186
11187 #. type: Plain text
11188 #: build/C/man3/stdarg.3:209
11189 msgid ""
11190 "Finally, on systems where arguments are passed in registers, it may be "
11191 "necessary for B<va_start>()  to allocate memory, store the arguments there, "
11192 "and also an indication of which argument is next, so that B<va_arg>()  can "
11193 "step through the list.  Now B<va_end>()  can free the allocated memory "
11194 "again.  To accommodate this situation, C99 adds a macro B<va_copy>(), so "
11195 "that the above assignment can be replaced by"
11196 msgstr ""
11197
11198 #. type: Plain text
11199 #: build/C/man3/stdarg.3:216
11200 #, no-wrap
11201 msgid ""
11202 "va_list aq;\n"
11203 "va_copy(aq, ap);\n"
11204 "\\&...\n"
11205 "va_end(aq);\n"
11206 msgstr ""
11207
11208 #. type: Plain text
11209 #: build/C/man3/stdarg.3:229
11210 msgid ""
11211 "Each invocation of B<va_copy>()  must be matched by a corresponding "
11212 "invocation of B<va_end>()  in the same function.  Some systems that do not "
11213 "supply B<va_copy>()  have B<__va_copy> instead, since that was the name used "
11214 "in the draft proposal."
11215 msgstr ""
11216
11217 #. type: Plain text
11218 #: build/C/man3/stdarg.3:238
11219 msgid ""
11220 "The B<va_start>(), B<va_arg>(), B<va_end>(), and B<va_copy>()  macros are "
11221 "thread-safe."
11222 msgstr ""
11223
11224 #. type: Plain text
11225 #: build/C/man3/stdarg.3:248
11226 msgid ""
11227 "The B<va_start>(), B<va_arg>(), and B<va_end>()  macros conform to C89.  C99 "
11228 "defines the B<va_copy>()  macro."
11229 msgstr ""
11230
11231 #. type: Plain text
11232 #: build/C/man3/stdarg.3:254
11233 msgid ""
11234 "These macros are I<not> compatible with the historic macros they replace.  A "
11235 "backward-compatible version can be found in the include file "
11236 "I<E<lt>varargs.hE<gt>>."
11237 msgstr ""
11238
11239 #. type: Plain text
11240 #: build/C/man3/stdarg.3:256
11241 msgid "The historic setup is:"
11242 msgstr ""
11243
11244 #. type: Plain text
11245 #: build/C/man3/stdarg.3:260
11246 #, no-wrap
11247 msgid "#include E<lt>varargs.hE<gt>\n"
11248 msgstr ""
11249
11250 #. type: Plain text
11251 #: build/C/man3/stdarg.3:266
11252 #, no-wrap
11253 msgid ""
11254 "void\n"
11255 "foo(va_alist)\n"
11256 "    va_dcl\n"
11257 "{\n"
11258 "    va_list ap;\n"
11259 msgstr ""
11260
11261 #. type: Plain text
11262 #: build/C/man3/stdarg.3:275
11263 #, no-wrap
11264 msgid ""
11265 "    va_start(ap);\n"
11266 "    while (...) {\n"
11267 "        ...\n"
11268 "        x = va_arg(ap, type);\n"
11269 "        ...\n"
11270 "    }\n"
11271 "    va_end(ap);\n"
11272 "}\n"
11273 msgstr ""
11274
11275 #. type: Plain text
11276 #: build/C/man3/stdarg.3:284
11277 msgid ""
11278 "On some systems, I<va_end> contains a closing \\(aq}\\(aq matching a "
11279 "\\(aq{\\(aq in I<va_start>, so that both macros must occur in the same "
11280 "function, and in a way that allows this."
11281 msgstr ""
11282
11283 #. type: Plain text
11284 #: build/C/man3/stdarg.3:300
11285 msgid ""
11286 "Unlike the B<varargs> macros, the B<stdarg> macros do not permit programmers "
11287 "to code a function with no fixed arguments.  This problem generates work "
11288 "mainly when converting B<varargs> code to B<stdarg> code, but it also "
11289 "creates difficulties for variadic functions that wish to pass all of their "
11290 "arguments on to a function that takes a I<va_list> argument, such as "
11291 "B<vfprintf>(3)."
11292 msgstr ""
11293
11294 #. type: Plain text
11295 #: build/C/man3/stdarg.3:305
11296 msgid ""
11297 "The function I<foo> takes a string of format characters and prints out the "
11298 "argument associated with each format character based on the type."
11299 msgstr ""
11300
11301 #. type: Plain text
11302 #: build/C/man3/stdarg.3:309
11303 #, no-wrap
11304 msgid ""
11305 "#include E<lt>stdio.hE<gt>\n"
11306 "#include E<lt>stdarg.hE<gt>\n"
11307 msgstr ""
11308
11309 #. type: Plain text
11310 #: build/C/man3/stdarg.3:316
11311 #, no-wrap
11312 msgid ""
11313 "void\n"
11314 "foo(char *fmt, ...)\n"
11315 "{\n"
11316 "    va_list ap;\n"
11317 "    int d;\n"
11318 "    char c, *s;\n"
11319 msgstr ""
11320
11321 #. type: Plain text
11322 #: build/C/man3/stdarg.3:337
11323 #, no-wrap
11324 msgid ""
11325 "    va_start(ap, fmt);\n"
11326 "    while (*fmt)\n"
11327 "        switch (*fmt++) {\n"
11328 "        case \\(aqs\\(aq:              /* string */\n"
11329 "            s = va_arg(ap, char *);\n"
11330 "            printf(\"string %s\\en\", s);\n"
11331 "            break;\n"
11332 "        case \\(aqd\\(aq:              /* int */\n"
11333 "            d = va_arg(ap, int);\n"
11334 "            printf(\"int %d\\en\", d);\n"
11335 "            break;\n"
11336 "        case \\(aqc\\(aq:              /* char */\n"
11337 "            /* need a cast here since va_arg only\n"
11338 "               takes fully promoted types */\n"
11339 "            c = (char) va_arg(ap, int);\n"
11340 "            printf(\"char %c\\en\", c);\n"
11341 "            break;\n"
11342 "        }\n"
11343 "    va_end(ap);\n"
11344 "}\n"
11345 msgstr ""
11346
11347 #. type: TH
11348 #: build/C/man2/syslog.2:33 build/C/man3/syslog.3:36
11349 #, no-wrap
11350 msgid "SYSLOG"
11351 msgstr ""
11352
11353 #. type: Plain text
11354 #: build/C/man2/syslog.2:37
11355 msgid ""
11356 "syslog, klogctl - read and/or clear kernel message ring buffer; set "
11357 "console_loglevel"
11358 msgstr ""
11359
11360 #. type: Plain text
11361 #: build/C/man2/syslog.2:41
11362 #, no-wrap
11363 msgid ""
11364 "B<int syslog(int >I<type>B<, char *>I<bufp>B<, int >I<len>B<);>\n"
11365 "B</* No wrapper provided in glibc */>\n"
11366 msgstr ""
11367
11368 #. type: Plain text
11369 #: build/C/man2/syslog.2:43
11370 #, no-wrap
11371 msgid "/* The glibc interface */\n"
11372 msgstr ""
11373
11374 #. type: Plain text
11375 #: build/C/man2/syslog.2:45
11376 #, no-wrap
11377 msgid "B<#include E<lt>sys/klog.hE<gt>>\n"
11378 msgstr ""
11379
11380 #. type: Plain text
11381 #: build/C/man2/syslog.2:47
11382 #, no-wrap
11383 msgid "B<int klogctl(int >I<type>B<, char *>I<bufp>B<, int >I<len>B<);>\n"
11384 msgstr ""
11385
11386 #. type: Plain text
11387 #: build/C/man2/syslog.2:57
11388 msgid ""
11389 "I<Note>: Probably, you are looking for the C library function B<syslog>(), "
11390 "which talks to B<syslogd>(8); see B<syslog>(3)  for details."
11391 msgstr ""
11392
11393 #. type: Plain text
11394 #: build/C/man2/syslog.2:64
11395 msgid ""
11396 "This page describes the kernel B<syslog>()  system call, which is used to "
11397 "control the kernel I<printk>()  buffer; the glibc wrapper function for the "
11398 "system call is called B<klogctl>()."
11399 msgstr ""
11400
11401 #. type: SS
11402 #: build/C/man2/syslog.2:64
11403 #, no-wrap
11404 msgid "The kernel log buffer"
11405 msgstr ""
11406
11407 #.  Under "General setup" ==> "Kernel log buffer size"
11408 #.  For 2.6, precisely the option seems to have appeared in 2.5.55.
11409 #. type: Plain text
11410 #: build/C/man2/syslog.2:81
11411 msgid ""
11412 "The kernel has a cyclic buffer of length B<LOG_BUF_LEN> in which messages "
11413 "given as arguments to the kernel function B<printk>()  are stored "
11414 "(regardless of their log level).  In early kernels, B<LOG_BUF_LEN> had the "
11415 "value 4096; from kernel 1.3.54, it was 8192; from kernel 2.1.113, it was "
11416 "16384; since kernel 2.4.23/2.6, the value is a kernel configuration option "
11417 "(B<CONFIG_LOG_BUF_SHIFT>, default value dependent on the architecture).  "
11418 "Since Linux 2.6.6, the size can be queried with command type 10 (see below)."
11419 msgstr ""
11420
11421 #. type: SS
11422 #: build/C/man2/syslog.2:81
11423 #, no-wrap
11424 msgid "Commands"
11425 msgstr ""
11426
11427 #. type: Plain text
11428 #: build/C/man2/syslog.2:88
11429 msgid ""
11430 "The I<type> argument determines the action taken by this function.  The list "
11431 "below specifies the values for I<type>.  The symbolic names are defined in "
11432 "the kernel source, but are not exported to user space; you will either need "
11433 "to use the numbers, or define the names yourself."
11434 msgstr ""
11435
11436 #. type: TP
11437 #: build/C/man2/syslog.2:88
11438 #, no-wrap
11439 msgid "B<SYSLOG_ACTION_CLOSE> (0)"
11440 msgstr ""
11441
11442 #. type: Plain text
11443 #: build/C/man2/syslog.2:92
11444 msgid "Close the log.  Currently a NOP."
11445 msgstr ""
11446
11447 #. type: TP
11448 #: build/C/man2/syslog.2:92
11449 #, no-wrap
11450 msgid "B<SYSLOG_ACTION_OPEN> (1)"
11451 msgstr ""
11452
11453 #. type: Plain text
11454 #: build/C/man2/syslog.2:96
11455 msgid "Open the log.  Currently a NOP."
11456 msgstr ""
11457
11458 #. type: TP
11459 #: build/C/man2/syslog.2:96
11460 #, no-wrap
11461 msgid "B<SYSLOG_ACTION_READ> (2)"
11462 msgstr ""
11463
11464 #. type: Plain text
11465 #: build/C/man2/syslog.2:108
11466 msgid ""
11467 "Read from the log.  The call waits until the kernel log buffer is nonempty, "
11468 "and then reads at most I<len> bytes into the buffer pointed to by I<bufp>.  "
11469 "The call returns the number of bytes read.  Bytes read from the log "
11470 "disappear from the log buffer: the information can be read only once.  This "
11471 "is the function executed by the kernel when a user program reads "
11472 "I</proc/kmsg>."
11473 msgstr ""
11474
11475 #. type: TP
11476 #: build/C/man2/syslog.2:108
11477 #, no-wrap
11478 msgid "B<SYSLOG_ACTION_READ_ALL> (3)"
11479 msgstr ""
11480
11481 #. type: Plain text
11482 #: build/C/man2/syslog.2:118
11483 msgid ""
11484 "Read all messages remaining in the ring buffer, placing them in the buffer "
11485 "pointed to by I<bufp>.  The call reads the last I<len> bytes from the log "
11486 "buffer (nondestructively), but will not read more than was written into the "
11487 "buffer since the last \"clear ring buffer\" command (see command 5 below)).  "
11488 "The call returns the number of bytes read."
11489 msgstr ""
11490
11491 #. type: TP
11492 #: build/C/man2/syslog.2:118
11493 #, no-wrap
11494 msgid "B<SYSLOG_ACTION_READ_CLEAR> (4)"
11495 msgstr ""
11496
11497 #. type: Plain text
11498 #: build/C/man2/syslog.2:124
11499 msgid ""
11500 "Read and clear all messages remaining in the ring buffer.  The call does "
11501 "precisely the same as for a I<type> of 3, but also executes the \"clear ring "
11502 "buffer\" command."
11503 msgstr ""
11504
11505 #. type: TP
11506 #: build/C/man2/syslog.2:124
11507 #, no-wrap
11508 msgid "B<SYSLOG_ACTION_CLEAR> (5)"
11509 msgstr ""
11510
11511 #. type: Plain text
11512 #: build/C/man2/syslog.2:132
11513 msgid ""
11514 "The call executes just the \"clear ring buffer\" command.  The I<bufp> and "
11515 "I<len> arguments are ignored."
11516 msgstr ""
11517
11518 #. type: Plain text
11519 #: build/C/man2/syslog.2:143
11520 msgid ""
11521 "This command does not really clear the ring buffer.  Rather, it sets a "
11522 "kernel bookkeeping variable that determines the results returned by commands "
11523 "3 (B<SYSLOG_ACTION_READ_ALL>)  and 4 (B<SYSLOG_ACTION_READ_CLEAR>).  This "
11524 "command has no effect on commands 2 (B<SYSLOG_ACTION_READ>)  and 9 "
11525 "(B<SYSLOG_ACTION_SIZE_UNREAD>)."
11526 msgstr ""
11527
11528 #. type: TP
11529 #: build/C/man2/syslog.2:143
11530 #, no-wrap
11531 msgid "B<SYSLOG_ACTION_CONSOLE_OFF> (6)"
11532 msgstr ""
11533
11534 #.  commit 1aaad49e856ce41adc07d8ae0c8ef35fc4483245
11535 #. type: Plain text
11536 #: build/C/man2/syslog.2:161
11537 msgid ""
11538 "The command saves the current value of I<console_loglevel> and then sets "
11539 "I<console_loglevel> to I<minimum_console_loglevel>, so that no messages are "
11540 "printed to the console.  Before Linux 2.6.32, the command simply sets "
11541 "I<console_loglevel> to I<minimum_console_loglevel>.  See the discussion of "
11542 "I</proc/sys/kernel/printk>, below."
11543 msgstr ""
11544
11545 #. type: Plain text
11546 #: build/C/man2/syslog.2:167 build/C/man2/syslog.2:190
11547 msgid "The I<bufp> and I<len> arguments are ignored."
11548 msgstr ""
11549
11550 #. type: TP
11551 #: build/C/man2/syslog.2:167
11552 #, no-wrap
11553 msgid "B<SYSLOG_ACTION_CONSOLE_ON> (7)"
11554 msgstr ""
11555
11556 #.  commit 1aaad49e856ce41adc07d8ae0c8ef35fc4483245
11557 #. type: Plain text
11558 #: build/C/man2/syslog.2:184
11559 msgid ""
11560 "If a previous B<SYSLOG_ACTION_CONSOLE_OFF> command has been performed, this "
11561 "command restores I<console_loglevel> to the value that was saved by that "
11562 "command.  Before Linux 2.6.32, this command simply sets I<console_loglevel> "
11563 "to I<default_console_loglevel>.  See the discussion of "
11564 "I</proc/sys/kernel/printk>, below."
11565 msgstr ""
11566
11567 #. type: TP
11568 #: build/C/man2/syslog.2:190
11569 #, no-wrap
11570 msgid "B<SYSLOG_ACTION_CONSOLE_LEVEL> (8)"
11571 msgstr ""
11572
11573 #. type: Plain text
11574 #: build/C/man2/syslog.2:207
11575 msgid ""
11576 "The call sets I<console_loglevel> to the value given in I<len>, which must "
11577 "be an integer between 1 and 8 (inclusive).  The kernel silently enforces a "
11578 "minimum value of I<minimum_console_loglevel> for I<len>.  See the I<log "
11579 "level> section for details.  The I<bufp> argument is ignored."
11580 msgstr ""
11581
11582 #. type: TP
11583 #: build/C/man2/syslog.2:207
11584 #, no-wrap
11585 msgid "B<SYSLOG_ACTION_SIZE_UNREAD> (9) (since Linux 2.4.10)"
11586 msgstr ""
11587
11588 #. type: Plain text
11589 #: build/C/man2/syslog.2:218
11590 msgid ""
11591 "The call returns the number of bytes currently available to be read from the "
11592 "kernel log buffer via command 2 (B<SYSLOG_ACTION_READ>).  The I<bufp> and "
11593 "I<len> arguments are ignored."
11594 msgstr ""
11595
11596 #. type: TP
11597 #: build/C/man2/syslog.2:218
11598 #, no-wrap
11599 msgid "B<SYSLOG_ACTION_SIZE_BUFFER> (10) (since Linux 2.6.6)"
11600 msgstr ""
11601
11602 #. type: Plain text
11603 #: build/C/man2/syslog.2:226
11604 msgid ""
11605 "This command returns the total size of the kernel log buffer.  The I<bufp> "
11606 "and I<len> arguments are ignored."
11607 msgstr ""
11608
11609 #. type: Plain text
11610 #: build/C/man2/syslog.2:245
11611 msgid ""
11612 "All commands except 3 and 10 require privilege.  In Linux kernels before "
11613 "2.6.37, command types 3 and 10 are allowed to unprivileged processes; since "
11614 "Linux 2.6.37, these commands are allowed to unprivileged processes only if "
11615 "I</proc/sys/kernel/dmesg_restrict> has the value 0.  Before Linux 2.6.37, "
11616 "\"privileged\" means that the caller has the B<CAP_SYS_ADMIN> capability.  "
11617 "Since Linux 2.6.37, \"privileged\" means that the caller has either the "
11618 "B<CAP_SYS_ADMIN> capability (now deprecated for this purpose) or the (new)  "
11619 "B<CAP_SYSLOG> capability."
11620 msgstr ""
11621
11622 #. type: SS
11623 #: build/C/man2/syslog.2:245
11624 #, no-wrap
11625 msgid "/proc/sys/kernel/printk"
11626 msgstr ""
11627
11628 #. type: Plain text
11629 #: build/C/man2/syslog.2:251
11630 msgid ""
11631 "I</proc/sys/kernel/printk> is a writable file containing four integer values "
11632 "that influence kernel I<printk()> behavior when printing or logging error "
11633 "messages.  The four values are:"
11634 msgstr ""
11635
11636 #. type: TP
11637 #: build/C/man2/syslog.2:251
11638 #, no-wrap
11639 msgid "I<console_loglevel>"
11640 msgstr ""
11641
11642 #.  since Linux 2.4
11643 #. type: Plain text
11644 #: build/C/man2/syslog.2:269
11645 msgid ""
11646 "Only messages with a log level lower than this value will be printed to the "
11647 "console.  The default value for this field is B<DEFAULT_CONSOLE_LOGLEVEL> "
11648 "(7), but it is set to 4 if the kernel command line contains the word "
11649 "\"quiet\", 10 if the kernel command line contains the word \"debug\", and to "
11650 "15 in case of a kernel fault (the 10 and 15 are just silly, and equivalent "
11651 "to 8).  The value of I<console_loglevel> can be set (to a value in the range "
11652 "1-8) by a B<syslog>()  call with a I<type> of 8."
11653 msgstr ""
11654
11655 #. type: TP
11656 #: build/C/man2/syslog.2:269
11657 #, no-wrap
11658 msgid "I<default_message_loglevel>"
11659 msgstr ""
11660
11661 #.  commit 5af5bcb8d37f99ba415a1adc6da71051b84f93a5
11662 #. type: Plain text
11663 #: build/C/man2/syslog.2:282
11664 msgid ""
11665 "This value will be used as the log level for I<printk()> messages that do "
11666 "not have an explicit level.  Up to and including Linux 2.6.38, the "
11667 "hard-coded default value for this field was 4 (B<KERN_WARNING>); since Linux "
11668 "2.6.39, the default value is a defined by the kernel configuration option "
11669 "B<CONFIG_DEFAULT_MESSAGE_LOGLEVEL>, which defaults to 4."
11670 msgstr ""
11671
11672 #. type: TP
11673 #: build/C/man2/syslog.2:282
11674 #, no-wrap
11675 msgid "I<minimum_console_loglevel>"
11676 msgstr ""
11677
11678 #. type: Plain text
11679 #: build/C/man2/syslog.2:287
11680 msgid ""
11681 "The value in this field is the minimum value to which I<console_loglevel> "
11682 "can be set."
11683 msgstr ""
11684
11685 #. type: TP
11686 #: build/C/man2/syslog.2:287
11687 #, no-wrap
11688 msgid "I<default_console_loglevel>"
11689 msgstr ""
11690
11691 #. type: Plain text
11692 #: build/C/man2/syslog.2:293
11693 msgid "This is the default value for I<console_loglevel>."
11694 msgstr ""
11695
11696 #. type: SS
11697 #: build/C/man2/syslog.2:293
11698 #, no-wrap
11699 msgid "The log level"
11700 msgstr ""
11701
11702 #. type: Plain text
11703 #: build/C/man2/syslog.2:301
11704 msgid ""
11705 "Every I<printk>()  message has its own log level.  If the log level is not "
11706 "explicitly specified as part of the message, it defaults to "
11707 "I<default_message_loglevel>.  The conventional meaning of the log level is "
11708 "as follows:"
11709 msgstr ""
11710
11711 #. type: tbl table
11712 #: build/C/man2/syslog.2:305
11713 #, no-wrap
11714 msgid "Kernel constant\tLevel value\tMeaning\n"
11715 msgstr ""
11716
11717 #. type: tbl table
11718 #: build/C/man2/syslog.2:306
11719 #, no-wrap
11720 msgid "KERN_EMERG\t0\tSystem is unusable\n"
11721 msgstr ""
11722
11723 #. type: tbl table
11724 #: build/C/man2/syslog.2:307
11725 #, no-wrap
11726 msgid "KERN_ALERT\t1\tAction must be taken immediately\n"
11727 msgstr ""
11728
11729 #. type: tbl table
11730 #: build/C/man2/syslog.2:308
11731 #, no-wrap
11732 msgid "KERN_CRIT\t2\tCritical conditions\n"
11733 msgstr ""
11734
11735 #. type: tbl table
11736 #: build/C/man2/syslog.2:309
11737 #, no-wrap
11738 msgid "KERN_ERR\t3\tError conditions\n"
11739 msgstr ""
11740
11741 #. type: tbl table
11742 #: build/C/man2/syslog.2:310
11743 #, no-wrap
11744 msgid "KERN_WARNING\t4\tWarning conditions\n"
11745 msgstr ""
11746
11747 #. type: tbl table
11748 #: build/C/man2/syslog.2:311
11749 #, no-wrap
11750 msgid "KERN_NOTICE\t5\tNormal but significant condition\n"
11751 msgstr ""
11752
11753 #. type: tbl table
11754 #: build/C/man2/syslog.2:312
11755 #, no-wrap
11756 msgid "KERN_INFO\t6\tInformational\n"
11757 msgstr ""
11758
11759 #. type: tbl table
11760 #: build/C/man2/syslog.2:313
11761 #, no-wrap
11762 msgid "KERN_DEBUG\t7\tDebug-level messages\n"
11763 msgstr ""
11764
11765 #. type: Plain text
11766 #: build/C/man2/syslog.2:321
11767 msgid ""
11768 "The kernel I<printk()> routine will print a message on the console only if "
11769 "it has a log level less than the value of I<console_loglevel>."
11770 msgstr ""
11771
11772 #. type: Plain text
11773 #: build/C/man2/syslog.2:334
11774 msgid ""
11775 "For I<type> equal to 2, 3, or 4, a successful call to B<syslog>()  returns "
11776 "the number of bytes read.  For I<type> 9, B<syslog>()  returns the number of "
11777 "bytes currently available to be read on the kernel log buffer.  For I<type> "
11778 "10, B<syslog>()  returns the total size of the kernel log buffer.  For other "
11779 "values of I<type>, 0 is returned on success."
11780 msgstr ""
11781
11782 #. type: Plain text
11783 #: build/C/man2/syslog.2:337
11784 msgid "In case of error, -1 is returned, and I<errno> is set to indicate the error."
11785 msgstr ""
11786
11787 #. type: Plain text
11788 #: build/C/man2/syslog.2:355
11789 msgid ""
11790 "Bad arguments (e.g., bad I<type>; or for I<type> 2, 3, or 4, I<buf> is NULL, "
11791 "or I<len> is less than zero; or for I<type> 8, the I<level> is outside the "
11792 "range 1 to 8)."
11793 msgstr ""
11794
11795 #. type: Plain text
11796 #: build/C/man2/syslog.2:362
11797 msgid ""
11798 "This B<syslog>()  system call is not available, because the kernel was "
11799 "compiled with the B<CONFIG_PRINTK> kernel-configuration option disabled."
11800 msgstr ""
11801
11802 #. type: Plain text
11803 #: build/C/man2/syslog.2:373
11804 msgid ""
11805 "An attempt was made to change I<console_loglevel> or clear the kernel "
11806 "message ring buffer by a process without sufficient privilege (more "
11807 "precisely: without the B<CAP_SYS_ADMIN> or B<CAP_SYSLOG> capability)."
11808 msgstr ""
11809
11810 #. type: TP
11811 #: build/C/man2/syslog.2:373
11812 #, no-wrap
11813 msgid "B<ERESTARTSYS>"
11814 msgstr ""
11815
11816 #. type: Plain text
11817 #: build/C/man2/syslog.2:377
11818 msgid ""
11819 "System call was interrupted by a signal; nothing was read.  (This can be "
11820 "seen only during a trace.)"
11821 msgstr ""
11822
11823 #. type: Plain text
11824 #: build/C/man2/syslog.2:380
11825 msgid ""
11826 "This system call is Linux-specific and should not be used in programs "
11827 "intended to be portable."
11828 msgstr ""
11829
11830 #.  In libc4 and libc5 the number of this call was defined by
11831 #.  .BR SYS_klog .
11832 #.  In glibc 2.0 the syscall is baptized
11833 #.  .BR klogctl ().
11834 #. type: Plain text
11835 #: build/C/man2/syslog.2:388
11836 msgid ""
11837 "From the very start, people noted that it is unfortunate that a system call "
11838 "and a library routine of the same name are entirely different animals."
11839 msgstr ""
11840
11841 #. type: Plain text
11842 #: build/C/man2/syslog.2:390
11843 msgid "B<syslog>(3), B<capabilities>(7)"
11844 msgstr ""
11845
11846 #. type: TH
11847 #: build/C/man3/syslog.3:36
11848 #, no-wrap
11849 msgid "2012-08-17"
11850 msgstr ""
11851
11852 #. type: Plain text
11853 #: build/C/man3/syslog.3:39
11854 msgid "closelog, openlog, syslog, vsyslog - send messages to the system logger"
11855 msgstr ""
11856
11857 #. type: Plain text
11858 #: build/C/man3/syslog.3:41
11859 msgid "B<#include E<lt>syslog.hE<gt>>"
11860 msgstr ""
11861
11862 #. type: Plain text
11863 #: build/C/man3/syslog.3:43
11864 msgid ""
11865 "B<void openlog(const char *>I<ident>B<, int >I<option>B<, int "
11866 ">I<facility>B<);>"
11867 msgstr ""
11868
11869 #. type: Plain text
11870 #: build/C/man3/syslog.3:45
11871 msgid "B<void syslog(int >I<priority>B<, const char *>I<format>B<, ...);>"
11872 msgstr ""
11873
11874 #. type: Plain text
11875 #: build/C/man3/syslog.3:47
11876 msgid "B<void closelog(void);>"
11877 msgstr ""
11878
11879 #. type: Plain text
11880 #: build/C/man3/syslog.3:51
11881 msgid ""
11882 "B<void vsyslog(int >I<priority>B<, const char *>I<format>B<, va_list "
11883 ">I<ap>B<);>"
11884 msgstr ""
11885
11886 #. type: Plain text
11887 #: build/C/man3/syslog.3:59
11888 msgid "B<vsyslog>(): _BSD_SOURCE"
11889 msgstr ""
11890
11891 #. type: Plain text
11892 #: build/C/man3/syslog.3:65
11893 msgid ""
11894 "B<closelog>()  closes the descriptor being used to write to the system "
11895 "logger.  The use of B<closelog>()  is optional."
11896 msgstr ""
11897
11898 #. type: Plain text
11899 #: build/C/man3/syslog.3:77
11900 msgid ""
11901 "B<openlog>()  opens a connection to the system logger for a program.  The "
11902 "string pointed to by I<ident> is prepended to every message, and is "
11903 "typically set to the program name.  If I<ident> is NULL, the program name is "
11904 "used.  (POSIX.1-2008 does not specify the behavior when I<ident> is NULL.)"
11905 msgstr ""
11906
11907 #. type: Plain text
11908 #: build/C/man3/syslog.3:101
11909 msgid ""
11910 "The I<option> argument specifies flags which control the operation of "
11911 "B<openlog>()  and subsequent calls to B<syslog>().  The I<facility> argument "
11912 "establishes a default to be used if none is specified in subsequent calls to "
11913 "B<syslog>().  Values for I<option> and I<facility> are given below.  The use "
11914 "of B<openlog>()  is optional; it will automatically be called by B<syslog>()  "
11915 "if necessary, in which case I<ident> will default to NULL."
11916 msgstr ""
11917
11918 #. type: Plain text
11919 #: build/C/man3/syslog.3:125
11920 msgid ""
11921 "B<syslog>()  generates a log message, which will be distributed by "
11922 "B<syslogd>(8).  The I<priority> argument is formed by ORing the I<facility> "
11923 "and the I<level> values (explained below).  The remaining arguments are a "
11924 "I<format>, as in B<printf>(3)  and any arguments required by the I<format>, "
11925 "except that the two character sequence B<%m> will be replaced by the error "
11926 "message string I<strerror>(I<errno>).  A trailing newline may be added if "
11927 "needed."
11928 msgstr ""
11929
11930 #. type: Plain text
11931 #: build/C/man3/syslog.3:134
11932 msgid ""
11933 "The function B<vsyslog>()  performs the same task as B<syslog>()  with the "
11934 "difference that it takes a set of arguments which have been obtained using "
11935 "the B<stdarg>(3)  variable argument list macros."
11936 msgstr ""
11937
11938 #. type: Plain text
11939 #: build/C/man3/syslog.3:137
11940 msgid ""
11941 "The subsections below list the parameters used to set the values of "
11942 "I<option>,I< facility>, and I<priority>."
11943 msgstr ""
11944
11945 #. type: SS
11946 #: build/C/man3/syslog.3:137
11947 #, no-wrap
11948 msgid "option"
11949 msgstr ""
11950
11951 #. type: Plain text
11952 #: build/C/man3/syslog.3:143
11953 msgid "The I<option> argument to B<openlog>()  is an OR of any of these:"
11954 msgstr ""
11955
11956 #. type: TP
11957 #: build/C/man3/syslog.3:143
11958 #, no-wrap
11959 msgid "B<LOG_CONS>"
11960 msgstr ""
11961
11962 #. type: Plain text
11963 #: build/C/man3/syslog.3:147
11964 msgid ""
11965 "Write directly to system console if there is an error while sending to "
11966 "system logger."
11967 msgstr ""
11968
11969 #. type: TP
11970 #: build/C/man3/syslog.3:147
11971 #, no-wrap
11972 msgid "B<LOG_NDELAY>"
11973 msgstr ""
11974
11975 #. type: Plain text
11976 #: build/C/man3/syslog.3:151
11977 msgid ""
11978 "Open the connection immediately (normally, the connection is opened when the "
11979 "first message is logged)."
11980 msgstr ""
11981
11982 #. type: TP
11983 #: build/C/man3/syslog.3:151
11984 #, no-wrap
11985 msgid "B<LOG_NOWAIT>"
11986 msgstr ""
11987
11988 #. type: Plain text
11989 #: build/C/man3/syslog.3:157
11990 msgid ""
11991 "Don't wait for child processes that may have been created while logging the "
11992 "message.  (The GNU C library does not create a child process, so this option "
11993 "has no effect on Linux.)"
11994 msgstr ""
11995
11996 #. type: TP
11997 #: build/C/man3/syslog.3:157
11998 #, no-wrap
11999 msgid "B<LOG_ODELAY>"
12000 msgstr ""
12001
12002 #. type: Plain text
12003 #: build/C/man3/syslog.3:165
12004 msgid ""
12005 "The converse of B<LOG_NDELAY>; opening of the connection is delayed until "
12006 "B<syslog>()  is called.  (This is the default, and need not be specified.)"
12007 msgstr ""
12008
12009 #. type: TP
12010 #: build/C/man3/syslog.3:165
12011 #, no-wrap
12012 msgid "B<LOG_PERROR>"
12013 msgstr ""
12014
12015 #. type: Plain text
12016 #: build/C/man3/syslog.3:169
12017 msgid "(Not in POSIX.1-2001 or POSIX.1-2008.)  Print to I<stderr> as well."
12018 msgstr ""
12019
12020 #. type: TP
12021 #: build/C/man3/syslog.3:169
12022 #, no-wrap
12023 msgid "B<LOG_PID>"
12024 msgstr ""
12025
12026 #. type: Plain text
12027 #: build/C/man3/syslog.3:172
12028 msgid "Include PID with each message."
12029 msgstr ""
12030
12031 #. type: SS
12032 #: build/C/man3/syslog.3:172
12033 #, no-wrap
12034 msgid "facility"
12035 msgstr ""
12036
12037 #. type: Plain text
12038 #: build/C/man3/syslog.3:178
12039 msgid ""
12040 "The I<facility> argument is used to specify what type of program is logging "
12041 "the message.  This lets the configuration file specify that messages from "
12042 "different facilities will be handled differently."
12043 msgstr ""
12044
12045 #. type: TP
12046 #: build/C/man3/syslog.3:178
12047 #, no-wrap
12048 msgid "B<LOG_AUTH>"
12049 msgstr ""
12050
12051 #. type: Plain text
12052 #: build/C/man3/syslog.3:181
12053 msgid "security/authorization messages"
12054 msgstr ""
12055
12056 #. type: TP
12057 #: build/C/man3/syslog.3:181
12058 #, no-wrap
12059 msgid "B<LOG_AUTHPRIV>"
12060 msgstr ""
12061
12062 #. type: Plain text
12063 #: build/C/man3/syslog.3:184
12064 msgid "security/authorization messages (private)"
12065 msgstr ""
12066
12067 #. type: TP
12068 #: build/C/man3/syslog.3:184
12069 #, no-wrap
12070 msgid "B<LOG_CRON>"
12071 msgstr ""
12072
12073 #. type: Plain text
12074 #: build/C/man3/syslog.3:188
12075 msgid "clock daemon (B<cron> and B<at>)"
12076 msgstr ""
12077
12078 #. type: TP
12079 #: build/C/man3/syslog.3:188
12080 #, no-wrap
12081 msgid "B<LOG_DAEMON>"
12082 msgstr ""
12083
12084 #. type: Plain text
12085 #: build/C/man3/syslog.3:191
12086 msgid "system daemons without separate facility value"
12087 msgstr ""
12088
12089 #. type: TP
12090 #: build/C/man3/syslog.3:191
12091 #, no-wrap
12092 msgid "B<LOG_FTP>"
12093 msgstr ""
12094
12095 #. type: Plain text
12096 #: build/C/man3/syslog.3:194
12097 msgid "ftp daemon"
12098 msgstr ""
12099
12100 #. type: TP
12101 #: build/C/man3/syslog.3:194
12102 #, no-wrap
12103 msgid "B<LOG_KERN>"
12104 msgstr ""
12105
12106 #.  LOG_KERN has the value 0; if used as a facility, zero translates to:
12107 #.  "use the default facility".
12108 #. type: Plain text
12109 #: build/C/man3/syslog.3:199
12110 msgid "kernel messages (these can't be generated from user processes)"
12111 msgstr ""
12112
12113 #. type: TP
12114 #: build/C/man3/syslog.3:199
12115 #, no-wrap
12116 msgid "B<LOG_LOCAL0> through B<LOG_LOCAL7>"
12117 msgstr ""
12118
12119 #. type: Plain text
12120 #: build/C/man3/syslog.3:202
12121 msgid "reserved for local use"
12122 msgstr ""
12123
12124 #. type: TP
12125 #: build/C/man3/syslog.3:202
12126 #, no-wrap
12127 msgid "B<LOG_LPR>"
12128 msgstr ""
12129
12130 #. type: Plain text
12131 #: build/C/man3/syslog.3:205
12132 msgid "line printer subsystem"
12133 msgstr ""
12134
12135 #. type: TP
12136 #: build/C/man3/syslog.3:205
12137 #, no-wrap
12138 msgid "B<LOG_MAIL>"
12139 msgstr ""
12140
12141 #. type: Plain text
12142 #: build/C/man3/syslog.3:208
12143 msgid "mail subsystem"
12144 msgstr ""
12145
12146 #. type: TP
12147 #: build/C/man3/syslog.3:208
12148 #, no-wrap
12149 msgid "B<LOG_NEWS>"
12150 msgstr ""
12151
12152 #. type: Plain text
12153 #: build/C/man3/syslog.3:211
12154 msgid "USENET news subsystem"
12155 msgstr ""
12156
12157 #. type: TP
12158 #: build/C/man3/syslog.3:211
12159 #, no-wrap
12160 msgid "B<LOG_SYSLOG>"
12161 msgstr ""
12162
12163 #. type: Plain text
12164 #: build/C/man3/syslog.3:215
12165 msgid "messages generated internally by B<syslogd>(8)"
12166 msgstr ""
12167
12168 #. type: TP
12169 #: build/C/man3/syslog.3:215
12170 #, no-wrap
12171 msgid "B<LOG_USER> (default)"
12172 msgstr ""
12173
12174 #. type: Plain text
12175 #: build/C/man3/syslog.3:218
12176 msgid "generic user-level messages"
12177 msgstr ""
12178
12179 #. type: TP
12180 #: build/C/man3/syslog.3:218
12181 #, no-wrap
12182 msgid "B<LOG_UUCP>"
12183 msgstr ""
12184
12185 #. type: Plain text
12186 #: build/C/man3/syslog.3:221
12187 msgid "UUCP subsystem"
12188 msgstr ""
12189
12190 #. type: SS
12191 #: build/C/man3/syslog.3:221
12192 #, no-wrap
12193 msgid "level"
12194 msgstr ""
12195
12196 #. type: Plain text
12197 #: build/C/man3/syslog.3:224
12198 msgid ""
12199 "This determines the importance of the message.  The levels are, in order of "
12200 "decreasing importance:"
12201 msgstr ""
12202
12203 #. type: TP
12204 #: build/C/man3/syslog.3:224
12205 #, no-wrap
12206 msgid "B<LOG_EMERG>"
12207 msgstr ""
12208
12209 #. type: Plain text
12210 #: build/C/man3/syslog.3:227
12211 msgid "system is unusable"
12212 msgstr ""
12213
12214 #. type: TP
12215 #: build/C/man3/syslog.3:227
12216 #, no-wrap
12217 msgid "B<LOG_ALERT>"
12218 msgstr ""
12219
12220 #. type: Plain text
12221 #: build/C/man3/syslog.3:230
12222 msgid "action must be taken immediately"
12223 msgstr ""
12224
12225 #. type: TP
12226 #: build/C/man3/syslog.3:230
12227 #, no-wrap
12228 msgid "B<LOG_CRIT>"
12229 msgstr ""
12230
12231 #. type: Plain text
12232 #: build/C/man3/syslog.3:233
12233 msgid "critical conditions"
12234 msgstr ""
12235
12236 #. type: TP
12237 #: build/C/man3/syslog.3:233
12238 #, no-wrap
12239 msgid "B<LOG_ERR>"
12240 msgstr ""
12241
12242 #. type: Plain text
12243 #: build/C/man3/syslog.3:236
12244 msgid "error conditions"
12245 msgstr ""
12246
12247 #. type: TP
12248 #: build/C/man3/syslog.3:236
12249 #, no-wrap
12250 msgid "B<LOG_WARNING>"
12251 msgstr ""
12252
12253 #. type: Plain text
12254 #: build/C/man3/syslog.3:239
12255 msgid "warning conditions"
12256 msgstr ""
12257
12258 #. type: TP
12259 #: build/C/man3/syslog.3:239
12260 #, no-wrap
12261 msgid "B<LOG_NOTICE>"
12262 msgstr ""
12263
12264 #. type: Plain text
12265 #: build/C/man3/syslog.3:242
12266 msgid "normal, but significant, condition"
12267 msgstr ""
12268
12269 #. type: TP
12270 #: build/C/man3/syslog.3:242
12271 #, no-wrap
12272 msgid "B<LOG_INFO>"
12273 msgstr ""
12274
12275 #. type: Plain text
12276 #: build/C/man3/syslog.3:245
12277 msgid "informational message"
12278 msgstr ""
12279
12280 #. type: TP
12281 #: build/C/man3/syslog.3:245
12282 #, no-wrap
12283 msgid "B<LOG_DEBUG>"
12284 msgstr ""
12285
12286 #. type: Plain text
12287 #: build/C/man3/syslog.3:248
12288 msgid "debug-level message"
12289 msgstr ""
12290
12291 #. type: Plain text
12292 #: build/C/man3/syslog.3:252
12293 msgid ""
12294 "The function B<setlogmask>(3)  can be used to restrict logging to specified "
12295 "levels only."
12296 msgstr ""
12297
12298 #.  .SH HISTORY
12299 #.  A
12300 #.  .BR syslog ()
12301 #.  function call appeared in 4.2BSD.
12302 #.  4.3BSD documents
12303 #.  .BR openlog (),
12304 #.  .BR syslog (),
12305 #.  .BR closelog (),
12306 #.  and
12307 #.  .BR setlogmask ().
12308 #.  4.3BSD-Reno also documents
12309 #.  .BR vsyslog ().
12310 #.  Of course early v* functions used the
12311 #.  .I <varargs.h>
12312 #.  mechanism, which is not compatible with
12313 #.  .IR <stdarg.h> .
12314 #. type: Plain text
12315 #: build/C/man3/syslog.3:296
12316 msgid ""
12317 "The functions B<openlog>(), B<closelog>(), and B<syslog>()  (but not "
12318 "B<vsyslog>())  are specified in SUSv2, POSIX.1-2001, and POSIX.1-2008.  "
12319 "POSIX.1-2001 specifies only the B<LOG_USER> and B<LOG_LOCAL*> values for "
12320 "I<facility>.  However, with the exception of B<LOG_AUTHPRIV> and B<LOG_FTP>, "
12321 "the other I<facility> values appear on most UNIX systems.  The B<LOG_PERROR> "
12322 "value for I<option> is not specified by POSIX.1-2001 or POSIX.1-2008, but is "
12323 "available in most versions of UNIX."
12324 msgstr ""
12325
12326 #. type: Plain text
12327 #: build/C/man3/syslog.3:308
12328 msgid ""
12329 "The argument I<ident> in the call of B<openlog>()  is probably stored "
12330 "as-is.  Thus, if the string it points to is changed, B<syslog>()  may start "
12331 "prepending the changed string, and if the string it points to ceases to "
12332 "exist, the results are undefined.  Most portable is to use a string "
12333 "constant."
12334 msgstr ""
12335
12336 #. type: Plain text
12337 #: build/C/man3/syslog.3:311
12338 msgid ""
12339 "Never pass a string with user-supplied data as a format, use the following "
12340 "instead:"
12341 msgstr ""
12342
12343 #. type: Plain text
12344 #: build/C/man3/syslog.3:314
12345 #, no-wrap
12346 msgid "    syslog(priority, \"%s\", string);\n"
12347 msgstr ""
12348
12349 #. type: Plain text
12350 #: build/C/man3/syslog.3:319
12351 msgid "B<logger>(1), B<setlogmask>(3), B<syslog.conf>(5), B<syslogd>(8)"
12352 msgstr ""
12353
12354 #. type: TH
12355 #: build/C/man4/ttyS.4:26
12356 #, no-wrap
12357 msgid "TTYS"
12358 msgstr ""
12359
12360 #. type: TH
12361 #: build/C/man4/ttyS.4:26
12362 #, no-wrap
12363 msgid "1992-12-19"
12364 msgstr ""
12365
12366 #. type: Plain text
12367 #: build/C/man4/ttyS.4:29
12368 msgid "ttyS - serial terminal lines"
12369 msgstr ""
12370
12371 #. type: Plain text
12372 #: build/C/man4/ttyS.4:32
12373 msgid "B<ttyS[0-3]> are character devices for the serial terminal lines."
12374 msgstr ""
12375
12376 #. type: Plain text
12377 #: build/C/man4/ttyS.4:37
12378 msgid "mknod -m 660 /dev/ttyS0 c 4 64 # base address 0x3f8"
12379 msgstr ""
12380
12381 #. type: Plain text
12382 #: build/C/man4/ttyS.4:39
12383 msgid "mknod -m 660 /dev/ttyS1 c 4 65 # base address 0x2f8"
12384 msgstr ""
12385
12386 #. type: Plain text
12387 #: build/C/man4/ttyS.4:41
12388 msgid "mknod -m 660 /dev/ttyS2 c 4 66 # base address 0x3e8"
12389 msgstr ""
12390
12391 #. type: Plain text
12392 #: build/C/man4/ttyS.4:43
12393 msgid "mknod -m 660 /dev/ttyS3 c 4 67 # base address 0x2e8"
12394 msgstr ""
12395
12396 #. type: Plain text
12397 #: build/C/man4/ttyS.4:45
12398 msgid "chown root:tty /dev/ttyS[0-3]"
12399 msgstr ""
12400
12401 #. type: Plain text
12402 #: build/C/man4/ttyS.4:48
12403 msgid "/dev/ttyS[0-3]"
12404 msgstr ""
12405
12406 #. type: Plain text
12407 #: build/C/man4/ttyS.4:54
12408 msgid ""
12409 "B<chown>(1), B<mknod>(1), B<tty>(4), B<agetty>(8), B<mingetty>(8), "
12410 "B<setserial>(8)"
12411 msgstr ""
12412
12413 #. type: TH
12414 #: build/C/man7/uri.7:48
12415 #, no-wrap
12416 msgid "URI"
12417 msgstr ""
12418
12419 #. type: TH
12420 #: build/C/man7/uri.7:48
12421 #, no-wrap
12422 msgid "2014-03-18"
12423 msgstr ""
12424
12425 #. type: Plain text
12426 #: build/C/man7/uri.7:51
12427 msgid "uri, url, urn - uniform resource identifier (URI), including a URL or URN"
12428 msgstr ""
12429
12430 #. type: Plain text
12431 #: build/C/man7/uri.7:55
12432 #, no-wrap
12433 msgid "URI = [ absoluteURI | relativeURI ] [ \"#\" fragment ]\n"
12434 msgstr ""
12435
12436 #. type: Plain text
12437 #: build/C/man7/uri.7:57
12438 #, no-wrap
12439 msgid "absoluteURI = scheme \":\" ( hierarchical_part | opaque_part )\n"
12440 msgstr ""
12441
12442 #. type: Plain text
12443 #: build/C/man7/uri.7:59
12444 #, no-wrap
12445 msgid "relativeURI = ( net_path | absolute_path | relative_path ) [ \"?\" query ]\n"
12446 msgstr ""
12447
12448 #. type: Plain text
12449 #: build/C/man7/uri.7:62
12450 #, no-wrap
12451 msgid ""
12452 "scheme = \"http\" | \"ftp\" | \"gopher\" | \"mailto\" | \"news\" | "
12453 "\"telnet\" |\n"
12454 "         \"file\" | \"man\" | \"info\" | \"whatis\" | \"ldap\" | \"wais\" | "
12455 "\\&...\n"
12456 msgstr ""
12457
12458 #. type: Plain text
12459 #: build/C/man7/uri.7:64
12460 #, no-wrap
12461 msgid "hierarchical_part = ( net_path | absolute_path ) [ \"?\" query ]\n"
12462 msgstr ""
12463
12464 #. type: Plain text
12465 #: build/C/man7/uri.7:66
12466 #, no-wrap
12467 msgid "net_path = \"//\" authority [ absolute_path ]\n"
12468 msgstr ""
12469
12470 #. type: Plain text
12471 #: build/C/man7/uri.7:68
12472 #, no-wrap
12473 msgid "absolute_path = \"/\"  path_segments\n"
12474 msgstr ""
12475
12476 #. type: Plain text
12477 #: build/C/man7/uri.7:70
12478 #, no-wrap
12479 msgid "relative_path = relative_segment [ absolute_path ]\n"
12480 msgstr ""
12481
12482 #. type: Plain text
12483 #: build/C/man7/uri.7:82
12484 msgid ""
12485 "A Uniform Resource Identifier (URI) is a short string of characters "
12486 "identifying an abstract or physical resource (for example, a web page).  A "
12487 "Uniform Resource Locator (URL) is a URI that identifies a resource through "
12488 "its primary access mechanism (e.g., its network \"location\"), rather than "
12489 "by name or some other attribute of that resource.  A Uniform Resource Name "
12490 "(URN) is a URI that must remain globally unique and persistent even when the "
12491 "resource ceases to exist or becomes unavailable."
12492 msgstr ""
12493
12494 #. type: Plain text
12495 #: build/C/man7/uri.7:89
12496 msgid ""
12497 "URIs are the standard way to name hypertext link destinations for tools such "
12498 "as web browsers.  The string \"http://www.kernelnotes.org\" is a URL (and "
12499 "thus it is also a URI).  Many people use the term URL loosely as a synonym "
12500 "for URI (though technically URLs are a subset of URIs)."
12501 msgstr ""
12502
12503 #. type: Plain text
12504 #: build/C/man7/uri.7:105
12505 msgid ""
12506 "URIs can be absolute or relative.  An absolute identifier refers to a "
12507 "resource independent of context, while a relative identifier refers to a "
12508 "resource by describing the difference from the current context.  Within a "
12509 "relative path reference, the complete path segments \".\" and \"..\" have "
12510 "special meanings: \"the current hierarchy level\" and \"the level above this "
12511 "hierarchy level\", respectively, just like they do in UNIX-like systems.  A "
12512 "path segment which contains a colon character can't be used as the first "
12513 "segment of a relative URI path (e.g., \"this:that\"), because it would be "
12514 "mistaken for a scheme name; precede such segments with ./ (e.g., "
12515 "\"./this:that\").  Note that descendants of MS-DOS (e.g., Microsoft Windows) "
12516 "replace devicename colons with the vertical bar (\"|\") in URIs, so \"C:\" "
12517 "becomes \"C|\"."
12518 msgstr ""
12519
12520 #. type: Plain text
12521 #: build/C/man7/uri.7:109
12522 msgid ""
12523 "A fragment identifier, if included, refers to a particular named portion "
12524 "(fragment) of a resource; text after a \\(aq#\\(aq identifies the fragment.  "
12525 "A URI beginning with \\(aq#\\(aq refers to that fragment in the current "
12526 "resource."
12527 msgstr ""
12528
12529 #. type: Plain text
12530 #: build/C/man7/uri.7:117
12531 msgid ""
12532 "There are many different URI schemes, each with specific additional rules "
12533 "and meanings, but they are intentionally made to be as similar as possible.  "
12534 "For example, many URL schemes permit the authority to be the following "
12535 "format, called here an I<ip_server> (square brackets show what's optional):"
12536 msgstr ""
12537
12538 #. type: Plain text
12539 #: build/C/man7/uri.7:119
12540 msgid "I<ip_server = >[I<user> [ : I<password> ] @ ] I<host> [ : I<port>]"
12541 msgstr ""
12542
12543 #. type: Plain text
12544 #: build/C/man7/uri.7:135
12545 msgid ""
12546 "This format allows you to optionally insert a username, a user plus "
12547 "password, and/or a port number.  The I<host> is the name of the host "
12548 "computer, either its name as determined by DNS or an IP address (numbers "
12549 "separated by periods).  Thus the URI "
12550 "E<lt>http://fred:fredpassword@xyz.com:8080/E<gt> logs into a web server on "
12551 "host xyz.com as fred (using fredpassword) using port 8080.  Avoid including "
12552 "a password in a URI if possible because of the many security risks of having "
12553 "a password written down.  If the URL supplies a username but no password, "
12554 "and the remote server requests a password, the program interpreting the URL "
12555 "should request one from the user."
12556 msgstr ""
12557
12558 #. type: Plain text
12559 #: build/C/man7/uri.7:140
12560 msgid ""
12561 "Here are some of the most common schemes in use on UNIX-like systems that "
12562 "are understood by many tools.  Note that many tools using URIs also have "
12563 "internal schemes or specialized schemes; see those tools' documentation for "
12564 "information on those schemes."
12565 msgstr ""
12566
12567 #. type: Plain text
12568 #: build/C/man7/uri.7:142
12569 msgid "B<http - Web (HTTP) server>"
12570 msgstr ""
12571
12572 #. type: Plain text
12573 #: build/C/man7/uri.7:144
12574 msgid "http://I<ip_server>/I<path>"
12575 msgstr ""
12576
12577 #. type: Plain text
12578 #: build/C/man7/uri.7:146
12579 msgid "http://I<ip_server>/I<path>?I<query>"
12580 msgstr ""
12581
12582 #. type: Plain text
12583 #: build/C/man7/uri.7:154
12584 msgid ""
12585 "This is a URL accessing a web (HTTP) server.  The default port is 80.  If "
12586 "the path refers to a directory, the web server will choose what to return; "
12587 "usually if there is a file named \"index.html\" or \"index.htm\" its content "
12588 "is returned, otherwise, a list of the files in the current directory (with "
12589 "appropriate links) is generated and returned.  An example is "
12590 "E<lt>http://lwn.netE<gt>."
12591 msgstr ""
12592
12593 #. type: Plain text
12594 #: build/C/man7/uri.7:177
12595 msgid ""
12596 "A query can be given in the archaic \"isindex\" format, consisting of a word "
12597 "or phrase and not including an equal sign (=).  A query can also be in the "
12598 "longer \"GET\" format, which has one or more query entries of the form "
12599 "I<key>=I<value> separated by the ampersand character (&).  Note that I<key> "
12600 "can be repeated more than once, though it's up to the web server and its "
12601 "application programs to determine if there's any meaning to that.  There is "
12602 "an unfortunate interaction with HTML/XML/SGML and the GET query format; when "
12603 "such URIs with more than one key are embedded in SGML/XML documents "
12604 "(including HTML), the ampersand (&) has to be rewritten as &amp;.  Note that "
12605 "not all queries use this format; larger forms may be too long to store as a "
12606 "URI, so they use a different interaction mechanism (called POST) which does "
12607 "not include the data in the URI.  See the Common Gateway Interface "
12608 "specification at E<.UR http://www.w3.org\\:/CGI> E<.UE> for more "
12609 "information."
12610 msgstr ""
12611
12612 #. type: Plain text
12613 #: build/C/man7/uri.7:179
12614 msgid "B<ftp - File Transfer Protocol (FTP)>"
12615 msgstr ""
12616
12617 #. type: Plain text
12618 #: build/C/man7/uri.7:181
12619 msgid "ftp://I<ip_server>/I<path>"
12620 msgstr ""
12621
12622 #. type: Plain text
12623 #: build/C/man7/uri.7:189
12624 msgid ""
12625 "This is a URL accessing a file through the file transfer protocol (FTP).  "
12626 "The default port (for control) is 21.  If no username is included, the "
12627 "username \"anonymous\" is supplied, and in that case many clients provide as "
12628 "the password the requestor's Internet email address.  An example is "
12629 "E<lt>ftp://ftp.is.co.za/rfc/rfc1808.txtE<gt>."
12630 msgstr ""
12631
12632 #. type: Plain text
12633 #: build/C/man7/uri.7:191
12634 msgid "B<gopher - Gopher server>"
12635 msgstr ""
12636
12637 #. type: Plain text
12638 #: build/C/man7/uri.7:193
12639 msgid "gopher://I<ip_server>/I<gophertype selector>"
12640 msgstr ""
12641
12642 #. type: Plain text
12643 #: build/C/man7/uri.7:195
12644 msgid "gopher://I<ip_server>/I<gophertype selector>%09I<search>"
12645 msgstr ""
12646
12647 #. type: Plain text
12648 #: build/C/man7/uri.7:197
12649 msgid "gopher://I<ip_server>/I<gophertype selector>%09I<search>%09I<gopher+_string>"
12650 msgstr ""
12651
12652 #. type: Plain text
12653 #: build/C/man7/uri.7:207
12654 msgid ""
12655 "The default gopher port is 70.  I<gophertype> is a single-character field to "
12656 "denote the Gopher type of the resource to which the URL refers.  The entire "
12657 "path may also be empty, in which case the delimiting \"/\" is also optional "
12658 "and the gophertype defaults to \"1\"."
12659 msgstr ""
12660
12661 #. type: Plain text
12662 #: build/C/man7/uri.7:214
12663 msgid ""
12664 "I<selector> is the Gopher selector string.  In the Gopher protocol, Gopher "
12665 "selector strings are a sequence of octets which may contain any octets "
12666 "except 09 hexadecimal (US-ASCII HT or tab), 0A hexadecimal (US-ASCII "
12667 "character LF), and 0D (US-ASCII character CR)."
12668 msgstr ""
12669
12670 #. type: Plain text
12671 #: build/C/man7/uri.7:216
12672 msgid "B<mailto - Email address>"
12673 msgstr ""
12674
12675 #. type: Plain text
12676 #: build/C/man7/uri.7:218
12677 msgid "mailto:I<email-address>"
12678 msgstr ""
12679
12680 #. type: Plain text
12681 #: build/C/man7/uri.7:226
12682 msgid ""
12683 "This is an email address, usually of the form I<name>@I<hostname>.  See "
12684 "B<mailaddr>(7)  for more information on the correct format of an email "
12685 "address.  Note that any % character must be rewritten as %25.  An example is "
12686 "E<lt>mailto:dwheeler@dwheeler.comE<gt>."
12687 msgstr ""
12688
12689 #. type: Plain text
12690 #: build/C/man7/uri.7:228
12691 msgid "B<news - Newsgroup or News message>"
12692 msgstr ""
12693
12694 #. type: Plain text
12695 #: build/C/man7/uri.7:230
12696 msgid "news:I<newsgroup-name>"
12697 msgstr ""
12698
12699 #. type: Plain text
12700 #: build/C/man7/uri.7:232
12701 msgid "news:I<message-id>"
12702 msgstr ""
12703
12704 #. type: Plain text
12705 #: build/C/man7/uri.7:240
12706 msgid ""
12707 "A I<newsgroup-name> is a period-delimited hierarchical name, such as "
12708 "\"comp.infosystems.www.misc\".  If E<lt>newsgroup-nameE<gt> is \"*\" (as in "
12709 "E<lt>news:*E<gt>), it is used to refer to \"all available news groups\".  An "
12710 "example is E<lt>news:comp.lang.adaE<gt>."
12711 msgstr ""
12712
12713 #. type: Plain text
12714 #: build/C/man7/uri.7:252
12715 msgid ""
12716 "A I<message-id> corresponds to the Message-ID of E<.UR "
12717 "http://www.ietf.org\\:/rfc\\:/rfc1036.txt> IETF RFC\\ 1036, E<.UE> without "
12718 "the enclosing \"E<lt>\" and \"E<gt>\"; it takes the form "
12719 "I<unique>@I<full_domain_name>.  A message identifier may be distinguished "
12720 "from a news group name by the presence of the \"@\" character."
12721 msgstr ""
12722
12723 #. type: Plain text
12724 #: build/C/man7/uri.7:254
12725 msgid "B<telnet - Telnet login>"
12726 msgstr ""
12727
12728 #. type: Plain text
12729 #: build/C/man7/uri.7:256
12730 msgid "telnet://I<ip_server>/"
12731 msgstr ""
12732
12733 #. type: Plain text
12734 #: build/C/man7/uri.7:262
12735 msgid ""
12736 "The Telnet URL scheme is used to designate interactive text services that "
12737 "may be accessed by the Telnet protocol.  The final \"/\" character may be "
12738 "omitted.  The default port is 23.  An example is "
12739 "E<lt>telnet://melvyl.ucop.edu/E<gt>."
12740 msgstr ""
12741
12742 #. type: Plain text
12743 #: build/C/man7/uri.7:264
12744 msgid "B<file - Normal file>"
12745 msgstr ""
12746
12747 #. type: Plain text
12748 #: build/C/man7/uri.7:266
12749 msgid "file://I<ip_server>/I<path_segments>"
12750 msgstr ""
12751
12752 #. type: Plain text
12753 #: build/C/man7/uri.7:268
12754 msgid "file:I<path_segments>"
12755 msgstr ""
12756
12757 #. type: Plain text
12758 #: build/C/man7/uri.7:285
12759 msgid ""
12760 "This represents a file or directory accessible locally.  As a special case, "
12761 "I<ip_server> can be the string \"localhost\" or the empty string; this is "
12762 "interpreted as \"the machine from which the URL is being interpreted\".  If "
12763 "the path is to a directory, the viewer should display the directory's "
12764 "contents with links to each containee; not all viewers currently do this.  "
12765 "KDE supports generated files through the URL E<lt>file:/cgi-binE<gt>.  If "
12766 "the given file isn't found, browser writers may want to try to expand the "
12767 "filename via filename globbing (see B<glob>(7)  and B<glob>(3))."
12768 msgstr ""
12769
12770 #. type: Plain text
12771 #: build/C/man7/uri.7:299
12772 msgid ""
12773 "The second format (e.g., E<lt>file:/etc/passwdE<gt>)  is a correct format "
12774 "for referring to a local file.  However, older standards did not permit this "
12775 "format, and some programs don't recognize this as a URI.  A more portable "
12776 "syntax is to use an empty string as the server name, for example, "
12777 "E<lt>file:///etc/passwdE<gt>; this form does the same thing and is easily "
12778 "recognized by pattern matchers and older programs as a URI.  Note that if "
12779 "you really mean to say \"start from the current location,\" don't specify "
12780 "the scheme at all; use a relative address like E<lt>../test.txtE<gt>, which "
12781 "has the side-effect of being scheme-independent.  An example of this scheme "
12782 "is E<lt>file:///etc/passwdE<gt>."
12783 msgstr ""
12784
12785 #. type: Plain text
12786 #: build/C/man7/uri.7:301
12787 msgid "B<man - Man page documentation>"
12788 msgstr ""
12789
12790 #. type: Plain text
12791 #: build/C/man7/uri.7:303
12792 msgid "man:I<command-name>"
12793 msgstr ""
12794
12795 #. type: Plain text
12796 #: build/C/man7/uri.7:305
12797 msgid "man:I<command-name>(I<section>)"
12798 msgstr ""
12799
12800 #. type: Plain text
12801 #: build/C/man7/uri.7:314
12802 msgid ""
12803 "This refers to local online manual (man) reference pages.  The command name "
12804 "can optionally be followed by a parenthesis and section number; see "
12805 "B<man>(7)  for more information on the meaning of the section numbers.  This "
12806 "URI scheme is unique to UNIX-like systems (such as Linux)  and is not "
12807 "currently registered by the IETF.  An example is E<lt>man:ls(1)E<gt>."
12808 msgstr ""
12809
12810 #. type: Plain text
12811 #: build/C/man7/uri.7:316
12812 msgid "B<info - Info page documentation>"
12813 msgstr ""
12814
12815 #. type: Plain text
12816 #: build/C/man7/uri.7:318
12817 msgid "info:I<virtual-filename>"
12818 msgstr ""
12819
12820 #. type: Plain text
12821 #: build/C/man7/uri.7:320
12822 msgid "info:I<virtual-filename>#I<nodename>"
12823 msgstr ""
12824
12825 #. type: Plain text
12826 #: build/C/man7/uri.7:322
12827 msgid "info:(I<virtual-filename>)"
12828 msgstr ""
12829
12830 #. type: Plain text
12831 #: build/C/man7/uri.7:324
12832 msgid "info:(I<virtual-filename>)I<nodename>"
12833 msgstr ""
12834
12835 #. type: Plain text
12836 #: build/C/man7/uri.7:343
12837 msgid ""
12838 "This scheme refers to online info reference pages (generated from texinfo "
12839 "files), a documentation format used by programs such as the GNU tools.  This "
12840 "URI scheme is unique to UNIX-like systems (such as Linux)  and is not "
12841 "currently registered by the IETF.  As of this writing, GNOME and KDE differ "
12842 "in their URI syntax and do not accept the other's syntax.  The first two "
12843 "formats are the GNOME format; in nodenames all spaces are written as "
12844 "underscores.  The second two formats are the KDE format; spaces in nodenames "
12845 "must be written as spaces, even though this is forbidden by the URI "
12846 "standards.  It's hoped that in the future most tools will understand all of "
12847 "these formats and will always accept underscores for spaces in nodenames.  "
12848 "In both GNOME and KDE, if the form without the nodename is used the nodename "
12849 "is assumed to be \"Top\".  Examples of the GNOME format are "
12850 "E<lt>info:gccE<gt> and E<lt>info:gcc#G++_and_GCCE<gt>.  Examples of the KDE "
12851 "format are E<lt>info:(gcc)E<gt> and E<lt>info:(gcc)G++ and GCCE<gt>."
12852 msgstr ""
12853
12854 #. type: Plain text
12855 #: build/C/man7/uri.7:345
12856 msgid "B<whatis - Documentation search>"
12857 msgstr ""
12858
12859 #. type: Plain text
12860 #: build/C/man7/uri.7:347
12861 msgid "whatis:I<string>"
12862 msgstr ""
12863
12864 #. type: Plain text
12865 #: build/C/man7/uri.7:355
12866 msgid ""
12867 "This scheme searches the database of short (one-line) descriptions of "
12868 "commands and returns a list of descriptions containing that string.  Only "
12869 "complete word matches are returned.  See B<whatis>(1).  This URI scheme is "
12870 "unique to UNIX-like systems (such as Linux)  and is not currently registered "
12871 "by the IETF."
12872 msgstr ""
12873
12874 #. type: Plain text
12875 #: build/C/man7/uri.7:357
12876 msgid "B<ghelp - GNOME help documentation>"
12877 msgstr ""
12878
12879 #. type: Plain text
12880 #: build/C/man7/uri.7:359
12881 msgid "ghelp:I<name-of-application>"
12882 msgstr ""
12883
12884 #. type: Plain text
12885 #: build/C/man7/uri.7:362
12886 msgid ""
12887 "This loads GNOME help for the given application.  Note that not much "
12888 "documentation currently exists in this format."
12889 msgstr ""
12890
12891 #. type: Plain text
12892 #: build/C/man7/uri.7:364
12893 msgid "B<ldap - Lightweight Directory Access Protocol>"
12894 msgstr ""
12895
12896 #. type: Plain text
12897 #: build/C/man7/uri.7:366
12898 msgid "ldap://I<hostport>"
12899 msgstr ""
12900
12901 #. type: Plain text
12902 #: build/C/man7/uri.7:368
12903 msgid "ldap://I<hostport>/"
12904 msgstr ""
12905
12906 #. type: Plain text
12907 #: build/C/man7/uri.7:370
12908 msgid "ldap://I<hostport>/I<dn>"
12909 msgstr ""
12910
12911 #. type: Plain text
12912 #: build/C/man7/uri.7:372
12913 msgid "ldap://I<hostport>/I<dn>?I<attributes>"
12914 msgstr ""
12915
12916 #. type: Plain text
12917 #: build/C/man7/uri.7:374
12918 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>"
12919 msgstr ""
12920
12921 #. type: Plain text
12922 #: build/C/man7/uri.7:376
12923 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>?I<filter>"
12924 msgstr ""
12925
12926 #. type: Plain text
12927 #: build/C/man7/uri.7:378
12928 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>?I<filter>?I<extensions>"
12929 msgstr ""
12930
12931 #. type: Plain text
12932 #: build/C/man7/uri.7:389
12933 msgid ""
12934 "This scheme supports queries to the Lightweight Directory Access Protocol "
12935 "(LDAP), a protocol for querying a set of servers for hierarchically "
12936 "organized information (such as people and computing resources).  See E<.UR "
12937 "http://www.ietf.org\\:/rfc\\:/rfc2255.txt> RFC\\ 2255 E<.UE> for more "
12938 "information on the LDAP URL scheme.  The components of this URL are:"
12939 msgstr ""
12940
12941 #. type: IP
12942 #: build/C/man7/uri.7:389
12943 #, no-wrap
12944 msgid "hostport"
12945 msgstr ""
12946
12947 #. type: Plain text
12948 #: build/C/man7/uri.7:394
12949 msgid ""
12950 "the LDAP server to query, written as a hostname optionally followed by a "
12951 "colon and the port number.  The default LDAP port is TCP port 389.  If "
12952 "empty, the client determines which the LDAP server to use."
12953 msgstr ""
12954
12955 #. type: IP
12956 #: build/C/man7/uri.7:394
12957 #, no-wrap
12958 msgid "dn"
12959 msgstr ""
12960
12961 #. type: Plain text
12962 #: build/C/man7/uri.7:401
12963 msgid ""
12964 "the LDAP Distinguished Name, which identifies the base object of the LDAP "
12965 "search (see E<.UR http://www.ietf.org\\:/rfc\\:/rfc2253.txt> RFC\\ 2253 "
12966 "E<.UE> section 3)."
12967 msgstr ""
12968
12969 #. type: IP
12970 #: build/C/man7/uri.7:401
12971 #, no-wrap
12972 msgid "attributes"
12973 msgstr ""
12974
12975 #. type: Plain text
12976 #: build/C/man7/uri.7:405
12977 msgid ""
12978 "a comma-separated list of attributes to be returned; see RFC\\ 2251 section "
12979 "4.1.5.  If omitted, all attributes should be returned."
12980 msgstr ""
12981
12982 #. type: IP
12983 #: build/C/man7/uri.7:405
12984 #, no-wrap
12985 msgid "scope"
12986 msgstr ""
12987
12988 #. type: Plain text
12989 #: build/C/man7/uri.7:410
12990 msgid ""
12991 "specifies the scope of the search, which can be one of \"base\" (for a base "
12992 "object search), \"one\" (for a one-level search), or \"sub\" (for a subtree "
12993 "search).  If scope is omitted, \"base\" is assumed."
12994 msgstr ""
12995
12996 #. type: IP
12997 #: build/C/man7/uri.7:410
12998 #, no-wrap
12999 msgid "filter"
13000 msgstr ""
13001
13002 #. type: Plain text
13003 #: build/C/man7/uri.7:419
13004 msgid ""
13005 "specifies the search filter (subset of entries to return).  If omitted, all "
13006 "entries should be returned.  See E<.UR "
13007 "http://www.ietf.org\\:/rfc\\:/rfc2254.txt> RFC\\ 2254 E<.UE> section 4."
13008 msgstr ""
13009
13010 #. type: IP
13011 #: build/C/man7/uri.7:419
13012 #, no-wrap
13013 msgid "extensions"
13014 msgstr ""
13015
13016 #. type: Plain text
13017 #: build/C/man7/uri.7:425
13018 msgid ""
13019 "a comma-separated list of type=value pairs, where the =value portion may be "
13020 "omitted for options not requiring it.  An extension prefixed with a "
13021 "\\(aq!\\(aq is critical (must be supported to be valid), otherwise it is "
13022 "noncritical (optional)."
13023 msgstr ""
13024
13025 #. type: Plain text
13026 #: build/C/man7/uri.7:429
13027 msgid ""
13028 "LDAP queries are easiest to explain by example.  Here's a query that asks "
13029 "ldap.itd.umich.edu for information about the University of Michigan in the "
13030 "U.S.:"
13031 msgstr ""
13032
13033 #. type: Plain text
13034 #: build/C/man7/uri.7:432
13035 #, no-wrap
13036 msgid "ldap://ldap.itd.umich.edu/o=University%20of%20Michigan,c=US\n"
13037 msgstr ""
13038
13039 #. type: Plain text
13040 #: build/C/man7/uri.7:435
13041 msgid "To just get its postal address attribute, request:"
13042 msgstr ""
13043
13044 #. type: Plain text
13045 #: build/C/man7/uri.7:438
13046 #, no-wrap
13047 msgid "ldap://ldap.itd.umich.edu/o=University%20of%20Michigan,c=US?postalAddress\n"
13048 msgstr ""
13049
13050 #. type: Plain text
13051 #: build/C/man7/uri.7:442
13052 msgid ""
13053 "To ask a host.com at port 6666 for information about the person with common "
13054 "name (cn) \"Babs Jensen\" at University of Michigan, request:"
13055 msgstr ""
13056
13057 #. type: Plain text
13058 #: build/C/man7/uri.7:445
13059 #, no-wrap
13060 msgid "ldap://host.com:6666/o=University%20of%20Michigan,c=US??sub?(cn=Babs%20Jensen)\n"
13061 msgstr ""
13062
13063 #. type: Plain text
13064 #: build/C/man7/uri.7:448
13065 msgid "B<wais - Wide Area Information Servers>"
13066 msgstr ""
13067
13068 #. type: Plain text
13069 #: build/C/man7/uri.7:450
13070 msgid "wais://I<hostport>/I<database>"
13071 msgstr ""
13072
13073 #. type: Plain text
13074 #: build/C/man7/uri.7:452
13075 msgid "wais://I<hostport>/I<database>?I<search>"
13076 msgstr ""
13077
13078 #. type: Plain text
13079 #: build/C/man7/uri.7:454
13080 msgid "wais://I<hostport>/I<database>/I<wtype>/I<wpath>"
13081 msgstr ""
13082
13083 #. type: Plain text
13084 #: build/C/man7/uri.7:463
13085 msgid ""
13086 "This scheme designates a WAIS database, search, or document (see E<.UR "
13087 "http://www.ietf.org\\:/rfc\\:/rfc1625.txt> IETF RFC\\ 1625 E<.UE> for more "
13088 "information on WAIS).  Hostport is the hostname, optionally followed by a "
13089 "colon and port number (the default port number is 210)."
13090 msgstr ""
13091
13092 #. type: Plain text
13093 #: build/C/man7/uri.7:473
13094 msgid ""
13095 "The first form designates a WAIS database for searching.  The second form "
13096 "designates a particular search of the WAIS database I<database>.  The third "
13097 "form designates a particular document within a WAIS database to be "
13098 "retrieved.  I<wtype> is the WAIS designation of the type of the object and "
13099 "I<wpath> is the WAIS document-id."
13100 msgstr ""
13101
13102 #. type: Plain text
13103 #: build/C/man7/uri.7:475
13104 msgid "B<other schemes>"
13105 msgstr ""
13106
13107 #. type: Plain text
13108 #: build/C/man7/uri.7:489
13109 msgid ""
13110 "There are many other URI schemes.  Most tools that accept URIs support a set "
13111 "of internal URIs (e.g., Mozilla has the about: scheme for internal "
13112 "information, and the GNOME help browser has the toc: scheme for various "
13113 "starting locations).  There are many schemes that have been defined but are "
13114 "not as widely used at the current time (e.g., prospero).  The nntp: scheme "
13115 "is deprecated in favor of the news: scheme.  URNs are to be supported by the "
13116 "urn: scheme, with a hierarchical name space (e.g., urn:ietf:... would "
13117 "identify IETF documents); at this time URNs are not widely implemented.  Not "
13118 "all tools support all schemes."
13119 msgstr ""
13120
13121 #. type: SS
13122 #: build/C/man7/uri.7:489
13123 #, no-wrap
13124 msgid "Character encoding"
13125 msgstr ""
13126
13127 #. type: Plain text
13128 #: build/C/man7/uri.7:493
13129 msgid ""
13130 "URIs use a limited number of characters so that they can be typed in and "
13131 "used in a variety of situations."
13132 msgstr ""
13133
13134 #. type: Plain text
13135 #: build/C/man7/uri.7:497
13136 msgid ""
13137 "The following characters are reserved, that is, they may appear in a URI but "
13138 "their use is limited to their reserved purpose (conflicting data must be "
13139 "escaped before forming the URI):"
13140 msgstr ""
13141
13142 #. type: Plain text
13143 #: build/C/man7/uri.7:499
13144 #, no-wrap
13145 msgid "   ; / ? : @ & = + $ ,\n"
13146 msgstr ""
13147
13148 #. type: Plain text
13149 #: build/C/man7/uri.7:505
13150 msgid ""
13151 "Unreserved characters may be included in a URI.  Unreserved characters "
13152 "include uppercase and lowercase English letters, decimal digits, and the "
13153 "following limited set of punctuation marks and symbols:"
13154 msgstr ""
13155
13156 #. type: Plain text
13157 #: build/C/man7/uri.7:507
13158 #, no-wrap
13159 msgid " - _ . ! ~ * ' ( )\n"
13160 msgstr ""
13161
13162 #. type: Plain text
13163 #: build/C/man7/uri.7:522
13164 msgid ""
13165 "All other characters must be escaped.  An escaped octet is encoded as a "
13166 "character triplet, consisting of the percent character \"%\" followed by the "
13167 "two hexadecimal digits representing the octet code (you can use uppercase or "
13168 "lowercase letters for the hexadecimal digits).  For example, a blank space "
13169 "must be escaped as \"%20\", a tab character as \"%09\", and the \"&\" as "
13170 "\"%26\".  Because the percent \"%\" character always has the reserved "
13171 "purpose of being the escape indicator, it must be escaped as \"%25\".  It is "
13172 "common practice to escape space characters as the plus symbol (+)  in query "
13173 "text; this practice isn't uniformly defined in the relevant RFCs (which "
13174 "recommend %20 instead) but any tool accepting URIs with query text should be "
13175 "prepared for them.  A URI is always shown in its \"escaped\" form."
13176 msgstr ""
13177
13178 #. type: Plain text
13179 #: build/C/man7/uri.7:528
13180 msgid ""
13181 "Unreserved characters can be escaped without changing the semantics of the "
13182 "URI, but this should not be done unless the URI is being used in a context "
13183 "that does not allow the unescaped character to appear.  For example, \"%7e\" "
13184 "is sometimes used instead of \"~\" in an HTTP URL path, but the two are "
13185 "equivalent for an HTTP URL."
13186 msgstr ""
13187
13188 #. type: Plain text
13189 #: build/C/man7/uri.7:532
13190 msgid ""
13191 "For URIs which must handle characters outside the US ASCII character set, "
13192 "the HTML 4.01 specification (section B.2) and IETF RFC\\ 2718 (section "
13193 "2.2.5) recommend the following approach:"
13194 msgstr ""
13195
13196 #. type: Plain text
13197 #: build/C/man7/uri.7:536
13198 msgid ""
13199 "translate the character sequences into UTF-8 (IETF RFC\\ 2279)\\(emsee "
13200 "B<utf-8>(7)\\(emand then"
13201 msgstr ""
13202
13203 #. type: Plain text
13204 #: build/C/man7/uri.7:539
13205 msgid ""
13206 "use the URI escaping mechanism, that is, use the %HH encoding for unsafe "
13207 "octets."
13208 msgstr ""
13209
13210 #. type: SS
13211 #: build/C/man7/uri.7:539
13212 #, no-wrap
13213 msgid "Writing a URI"
13214 msgstr ""
13215
13216 #. type: Plain text
13217 #: build/C/man7/uri.7:562
13218 msgid ""
13219 "When written, URIs should be placed inside double quotes (e.g., "
13220 "\"http://www.kernelnotes.org\"), enclosed in angle brackets (e.g., "
13221 "E<lt>http://lwn.netE<gt>), or placed on a line by themselves.  A warning for "
13222 "those who use double-quotes: B<never> move extraneous punctuation (such as "
13223 "the period ending a sentence or the comma in a list)  inside a URI, since "
13224 "this will change the value of the URI.  Instead, use angle brackets instead, "
13225 "or switch to a quoting system that never includes extraneous characters "
13226 "inside quotation marks.  This latter system, called the 'new' or 'logical' "
13227 "quoting system by \"Hart's Rules\" and the \"Oxford Dictionary for Writers "
13228 "and Editors\", is preferred practice in Great Britain and hackers worldwide "
13229 "(see the Jargon File's section on Hacker Writing Style, E<.UR "
13230 "http://www.fwi.uva.nl\\:/~mes\\:/jargon\\:/h\\:/HackerWritingStyle.html> "
13231 "E<.UE ,> for more information).  Older documents suggested inserting the "
13232 "prefix \"URL:\" just before the URI, but this form has never caught on."
13233 msgstr ""
13234
13235 #. type: Plain text
13236 #: build/C/man7/uri.7:584
13237 msgid ""
13238 "The URI syntax was designed to be unambiguous.  However, as URIs have become "
13239 "commonplace, traditional media (television, radio, newspapers, billboards, "
13240 "etc.) have increasingly used abbreviated URI references consisting of only "
13241 "the authority and path portions of the identified resource (e.g., "
13242 "E<lt>www.w3.org/AddressingE<gt>).  Such references are primarily intended "
13243 "for human interpretation rather than machine, with the assumption that "
13244 "context-based heuristics are sufficient to complete the URI (e.g., hostnames "
13245 "beginning with \"www\" are likely to have a URI prefix of \"http://\" and "
13246 "hostnames beginning with \"ftp\" likely to have a prefix of \"ftp://\").  "
13247 "Many client implementations heuristically resolve these references.  Such "
13248 "heuristics may change over time, particularly when new schemes are "
13249 "introduced.  Since an abbreviated URI has the same syntax as a relative URL "
13250 "path, abbreviated URI references cannot be used where relative URIs are "
13251 "permitted, and can be used only when there is no defined base (such as in "
13252 "dialog boxes).  Don't use abbreviated URIs as hypertext links inside a "
13253 "document; use the standard format as described here."
13254 msgstr ""
13255
13256 #. type: Plain text
13257 #: build/C/man7/uri.7:592
13258 msgid ""
13259 "E<.UR http://www.ietf.org\\:/rfc\\:/rfc2396.txt> (IETF RFC\\ 2396)  E<.UE ,> "
13260 "E<.UR http://www.w3.org\\:/TR\\:/REC-html40> (HTML 4.0)  E<.UE .>"
13261 msgstr ""
13262
13263 #. type: Plain text
13264 #: build/C/man7/uri.7:598
13265 msgid ""
13266 "Any tool accepting URIs (e.g., a web browser) on a Linux system should be "
13267 "able to handle (directly or indirectly) all of the schemes described here, "
13268 "including the man: and info: schemes.  Handling them by invoking some other "
13269 "program is fine and in fact encouraged."
13270 msgstr ""
13271
13272 #. type: Plain text
13273 #: build/C/man7/uri.7:600
13274 msgid "Technically the fragment isn't part of the URI."
13275 msgstr ""
13276
13277 #. type: Plain text
13278 #: build/C/man7/uri.7:609
13279 msgid ""
13280 "For information on how to embed URIs (including URLs) in a data format, see "
13281 "documentation on that format.  HTML uses the format E<lt>A "
13282 "HREF=\"I<uri>\"E<gt> I<text> E<lt>/AE<gt>.  Texinfo files use the format "
13283 "@uref{I<uri>}.  Man and mdoc have the recently added UR macro, or just "
13284 "include the URI in the text (viewers should be able to detect :// as part of "
13285 "a URI)."
13286 msgstr ""
13287
13288 #. type: Plain text
13289 #: build/C/man7/uri.7:630
13290 msgid ""
13291 "The GNOME and KDE desktop environments currently vary in the URIs they "
13292 "accept, in particular in their respective help browsers.  To list man pages, "
13293 "GNOME uses E<lt>toc:manE<gt> while KDE uses E<lt>man:(index)E<gt>, and to "
13294 "list info pages, GNOME uses E<lt>toc:infoE<gt> while KDE uses "
13295 "E<lt>info:(dir)E<gt> (the author of this man page prefers the KDE approach "
13296 "here, though a more regular format would be even better).  In general, KDE "
13297 "uses E<lt>file:/cgi-bin/E<gt> as a prefix to a set of generated files.  KDE "
13298 "prefers documentation in HTML, accessed via the "
13299 "E<lt>file:/cgi-bin/helpindexE<gt>.  GNOME prefers the ghelp scheme to store "
13300 "and find documentation.  Neither browser handles file: references to "
13301 "directories at the time of this writing, making it difficult to refer to an "
13302 "entire directory with a browsable URI.  As noted above, these environments "
13303 "differ in how they handle the info: scheme, probably the most important "
13304 "variation.  It is expected that GNOME and KDE will converge to common URI "
13305 "formats, and a future version of this man page will describe the converged "
13306 "result.  Efforts to aid this convergence are encouraged."
13307 msgstr ""
13308
13309 #. type: SS
13310 #: build/C/man7/uri.7:630
13311 #, no-wrap
13312 msgid "Security"
13313 msgstr ""
13314
13315 #. type: Plain text
13316 #: build/C/man7/uri.7:640
13317 msgid ""
13318 "A URI does not in itself pose a security threat.  There is no general "
13319 "guarantee that a URL, which at one time located a given resource, will "
13320 "continue to do so.  Nor is there any guarantee that a URL will not locate a "
13321 "different resource at some later point in time; such a guarantee can be "
13322 "obtained only from the person(s) controlling that namespace and the resource "
13323 "in question."
13324 msgstr ""
13325
13326 #. type: Plain text
13327 #: build/C/man7/uri.7:655
13328 msgid ""
13329 "It is sometimes possible to construct a URL such that an attempt to perform "
13330 "a seemingly harmless operation, such as the retrieval of an entity "
13331 "associated with the resource, will in fact cause a possibly damaging remote "
13332 "operation to occur.  The unsafe URL is typically constructed by specifying a "
13333 "port number other than that reserved for the network protocol in question.  "
13334 "The client unwittingly contacts a site that is in fact running a different "
13335 "protocol.  The content of the URL contains instructions that, when "
13336 "interpreted according to this other protocol, cause an unexpected "
13337 "operation.  An example has been the use of a gopher URL to cause an "
13338 "unintended or impersonating message to be sent via a SMTP server."
13339 msgstr ""
13340
13341 #. type: Plain text
13342 #: build/C/man7/uri.7:659
13343 msgid ""
13344 "Caution should be used when using any URL that specifies a port number other "
13345 "than the default for the protocol, especially when it is a number within the "
13346 "reserved space."
13347 msgstr ""
13348
13349 #. type: Plain text
13350 #: build/C/man7/uri.7:667
13351 msgid ""
13352 "Care should be taken when a URI contains escaped delimiters for a given "
13353 "protocol (for example, CR and LF characters for telnet protocols) that these "
13354 "are not unescaped before transmission.  This might violate the protocol, but "
13355 "avoids the potential for such characters to be used to simulate an extra "
13356 "operation or parameter in that protocol, which might lead to an unexpected "
13357 "and possibly harmful remote operation to be performed."
13358 msgstr ""
13359
13360 #. type: Plain text
13361 #: build/C/man7/uri.7:673
13362 msgid ""
13363 "It is clearly unwise to use a URI that contains a password which is intended "
13364 "to be secret.  In particular, the use of a password within the \"userinfo\" "
13365 "component of a URI is strongly recommended against except in those rare "
13366 "cases where the \"password\" parameter is intended to be public."
13367 msgstr ""
13368
13369 #. type: Plain text
13370 #: build/C/man7/uri.7:695
13371 msgid ""
13372 "Documentation may be placed in a variety of locations, so there currently "
13373 "isn't a good URI scheme for general online documentation in arbitrary "
13374 "formats.  References of the form E<lt>file:///usr/doc/ZZZE<gt> don't work "
13375 "because different distributions and local installation requirements may "
13376 "place the files in different directories (it may be in /usr/doc, or "
13377 "/usr/local/doc, or /usr/share, or somewhere else).  Also, the directory ZZZ "
13378 "usually changes when a version changes (though filename globbing could "
13379 "partially overcome this).  Finally, using the file: scheme doesn't easily "
13380 "support people who dynamically load documentation from the Internet (instead "
13381 "of loading the files onto a local filesystem).  A future URI scheme may be "
13382 "added (e.g., \"userdoc:\") to permit programs to include cross-references to "
13383 "more detailed documentation without having to know the exact location of "
13384 "that documentation.  Alternatively, a future version of the filesystem "
13385 "specification may specify file locations sufficiently so that the file: "
13386 "scheme will be able to locate documentation."
13387 msgstr ""
13388
13389 #. type: Plain text
13390 #: build/C/man7/uri.7:698
13391 msgid ""
13392 "Many programs and file formats don't include a way to incorporate or "
13393 "implement links using URIs."
13394 msgstr ""
13395
13396 #.  .SH AUTHOR
13397 #.  David A. Wheeler (dwheeler@dwheeler.com) wrote this man page.
13398 #. type: Plain text
13399 #: build/C/man7/uri.7:706
13400 msgid ""
13401 "Many programs can't handle all of these different URI formats; there should "
13402 "be a standard mechanism to load an arbitrary URI that automatically detects "
13403 "the users' environment (e.g., text or graphics, desktop environment, local "
13404 "user preferences, and currently executing tools) and invokes the right tool "
13405 "for any URI."
13406 msgstr ""
13407
13408 #. type: Plain text
13409 #: build/C/man7/uri.7:711
13410 msgid "B<lynx>(1), B<man2html>(1), B<mailaddr>(7), B<utf-8>(7)"
13411 msgstr ""
13412
13413 #. type: Plain text
13414 #: build/C/man7/uri.7:714
13415 msgid "E<.UR http://www.ietf.org\\:/rfc\\:/rfc2255.txt> IETF RFC\\ 2255 E<.UE>"
13416 msgstr ""
13417
13418 #. type: TH
13419 #: build/C/man4/vcs.4:29
13420 #, no-wrap
13421 msgid "VCS"
13422 msgstr ""
13423
13424 #. type: TH
13425 #: build/C/man4/vcs.4:29
13426 #, no-wrap
13427 msgid "2007-12-17"
13428 msgstr ""
13429
13430 #. type: Plain text
13431 #: build/C/man4/vcs.4:32
13432 msgid "vcs, vcsa - virtual console memory"
13433 msgstr ""
13434
13435 #. type: Plain text
13436 #: build/C/man4/vcs.4:38
13437 msgid ""
13438 "I</dev/vcs0> is a character device with major number 7 and minor number 0, "
13439 "usually of mode 0644 and owner root.tty.  It refers to the memory of the "
13440 "currently displayed virtual console terminal."
13441 msgstr ""
13442
13443 #. type: Plain text
13444 #: build/C/man4/vcs.4:58
13445 msgid ""
13446 "I</dev/vcs[1-63]> are character devices for virtual console terminals, they "
13447 "have major number 7 and minor number 1 to 63, usually mode 0644 and owner "
13448 "root.tty.  I</dev/vcsa[0-63]> are the same, but using I<unsigned short>s (in "
13449 "host byte order) that include attributes, and prefixed with four bytes "
13450 "giving the screen dimensions and cursor position: I<lines>, I<columns>, "
13451 "I<x>, I<y>.  (I<x> = I<y> = 0 at the top left corner of the screen.)"
13452 msgstr ""
13453
13454 #. type: Plain text
13455 #: build/C/man4/vcs.4:72
13456 msgid ""
13457 "When a 512-character font is loaded, the 9th bit position can be fetched by "
13458 "applying the B<ioctl>(2)  B<VT_GETHIFONTMASK> operation (available in Linux "
13459 "kernels 2.6.18 and above)  on I</dev/tty[1-63]>; the value is returned in "
13460 "the I<unsigned short> pointed to by the third B<ioctl>(2)  argument."
13461 msgstr ""
13462
13463 #. type: Plain text
13464 #: build/C/man4/vcs.4:79
13465 msgid ""
13466 "These devices replace the screendump B<ioctl>(2)  operations of "
13467 "B<console>(4), so the system administrator can control access using "
13468 "filesystem permissions."
13469 msgstr ""
13470
13471 #. type: Plain text
13472 #: build/C/man4/vcs.4:81
13473 msgid "The devices for the first eight virtual consoles may be created by:"
13474 msgstr ""
13475
13476 #. type: Plain text
13477 #: build/C/man4/vcs.4:88
13478 #, no-wrap
13479 msgid ""
13480 "    for x in 0 1 2 3 4 5 6 7 8; do\n"
13481 "        mknod -m 644 /dev/vcs$x c 7 $x;\n"
13482 "        mknod -m 644 /dev/vcsa$x c 7 $[$x+128];\n"
13483 "    done\n"
13484 "    chown root:tty /dev/vcs*\n"
13485 msgstr ""
13486
13487 #. type: Plain text
13488 #: build/C/man4/vcs.4:93
13489 msgid "No B<ioctl>(2)  requests are supported."
13490 msgstr ""
13491
13492 #. type: Plain text
13493 #: build/C/man4/vcs.4:95
13494 msgid "/dev/vcs[0-63]"
13495 msgstr ""
13496
13497 #.  .SH AUTHOR
13498 #.  Andries Brouwer <aeb@cwi.nl>
13499 #. type: Plain text
13500 #: build/C/man4/vcs.4:99
13501 msgid "/dev/vcsa[0-63]"
13502 msgstr ""
13503
13504 #. type: Plain text
13505 #: build/C/man4/vcs.4:101
13506 msgid "Introduced with version 1.1.92 of the Linux kernel."
13507 msgstr ""
13508
13509 #. type: Plain text
13510 #: build/C/man4/vcs.4:103
13511 msgid "You may do a screendump on vt3 by switching to vt1 and typing"
13512 msgstr ""
13513
13514 #. type: Plain text
13515 #: build/C/man4/vcs.4:105
13516 #, no-wrap
13517 msgid "    cat /dev/vcs3 E<gt>foo\n"
13518 msgstr ""
13519
13520 #. type: Plain text
13521 #: build/C/man4/vcs.4:109
13522 msgid ""
13523 "Note that the output does not contain newline characters, so some processing "
13524 "may be required, like in"
13525 msgstr ""
13526
13527 #. type: Plain text
13528 #: build/C/man4/vcs.4:111
13529 #, no-wrap
13530 msgid "    old -w 81 /dev/vcs3 | lpr\n"
13531 msgstr ""
13532
13533 #. type: Plain text
13534 #: build/C/man4/vcs.4:113
13535 msgid "or (horrors)"
13536 msgstr ""
13537
13538 #. type: Plain text
13539 #: build/C/man4/vcs.4:115
13540 #, no-wrap
13541 msgid "    xetterm -dump 3 -file /proc/self/fd/1\n"
13542 msgstr ""
13543
13544 #. type: Plain text
13545 #: build/C/man4/vcs.4:120
13546 msgid "The I</dev/vcsa0> device is used for Braille support."
13547 msgstr ""
13548
13549 #. type: Plain text
13550 #: build/C/man4/vcs.4:124
13551 msgid ""
13552 "This program displays the character and screen attributes under the cursor "
13553 "of the second virtual console, then changes the background color there:"
13554 msgstr ""
13555
13556 #. type: Plain text
13557 #: build/C/man4/vcs.4:132
13558 #, no-wrap
13559 msgid ""
13560 "#include E<lt>unistd.hE<gt>\n"
13561 "#include E<lt>stdlib.hE<gt>\n"
13562 "#include E<lt>stdio.hE<gt>\n"
13563 "#include E<lt>fcntl.hE<gt>\n"
13564 "#include E<lt>sys/ioctl.hE<gt>\n"
13565 "#include E<lt>linux/vt.hE<gt>\n"
13566 msgstr ""
13567
13568 #. type: Plain text
13569 #: build/C/man4/vcs.4:143
13570 #, no-wrap
13571 msgid ""
13572 "int\n"
13573 "main(void)\n"
13574 "{\n"
13575 "    int fd;\n"
13576 "    char *device = \"/dev/vcsa2\";\n"
13577 "    char *console = \"/dev/tty2\";\n"
13578 "    struct {unsigned char lines, cols, x, y;} scrn;\n"
13579 "    unsigned short s;\n"
13580 "    unsigned short mask;\n"
13581 "    unsigned char ch, attrib;\n"
13582 msgstr ""
13583
13584 #. type: Plain text
13585 #: build/C/man4/vcs.4:172
13586 #, no-wrap
13587 msgid ""
13588 "    fd = open(console, O_RDWR);\n"
13589 "    if (fd E<lt> 0) {\n"
13590 "        perror(console);\n"
13591 "        exit(EXIT_FAILURE);\n"
13592 "    }\n"
13593 "    if (ioctl(fd, VT_GETHIFONTMASK, &mask) E<lt> 0) {\n"
13594 "        perror(\"VT_GETHIFONTMASK\");\n"
13595 "        exit(EXIT_FAILURE);\n"
13596 "    }\n"
13597 "    (void) close(fd);\n"
13598 "    fd = open(device, O_RDWR);\n"
13599 "    if (fd E<lt> 0) {\n"
13600 "        perror(device);\n"
13601 "        exit(EXIT_FAILURE);\n"
13602 "    }\n"
13603 "    (void) read(fd, &scrn, 4);\n"
13604 "    (void) lseek(fd, 4 + 2*(scrn.y*scrn.cols + scrn.x), 0);\n"
13605 "    (void) read(fd, &s, 2);\n"
13606 "    ch = s & 0xff;\n"
13607 "    if (attrib & mask)\n"
13608 "        ch |= 0x100;\n"
13609 "    attrib = ((s & ~mask) E<gt>E<gt> 8);\n"
13610 "    printf(\"ch=\\(aq%c\\(aq attrib=0x%02x\\en\", ch, attrib);\n"
13611 "    attrib ^= 0x10;\n"
13612 "    (void) lseek(fd, -1, 1);\n"
13613 "    (void) write(fd, &attrib, 1);\n"
13614 "    exit(EXIT_SUCCESS);\n"
13615 "}\n"
13616 msgstr ""
13617
13618 #. type: Plain text
13619 #: build/C/man4/vcs.4:177
13620 msgid "B<console>(4), B<tty>(4), B<ttyS>(4), B<gpm>(8)"
13621 msgstr ""
13622
13623 #. type: TH
13624 #: build/C/man4/wavelan.4:15
13625 #, no-wrap
13626 msgid "WAVELAN"
13627 msgstr ""
13628
13629 #. type: TH
13630 #: build/C/man4/wavelan.4:15
13631 #, no-wrap
13632 msgid "2013-09-04"
13633 msgstr ""
13634
13635 #. type: Plain text
13636 #: build/C/man4/wavelan.4:18
13637 msgid "wavelan - AT&T GIS WaveLAN ISA device driver"
13638 msgstr ""
13639
13640 #. type: Plain text
13641 #: build/C/man4/wavelan.4:20
13642 msgid ""
13643 "B<insmod wavelan_cs.o [io=>I<B,B..>B<] [ irq=>I<I,I..>B<] "
13644 "[name=>I<N,N..>B<]>"
13645 msgstr ""
13646
13647 #. type: Plain text
13648 #: build/C/man4/wavelan.4:23
13649 msgid ""
13650 "I<This driver is obsolete:> it was removed from the kernel in version "
13651 "2.6.35."
13652 msgstr ""
13653
13654 #. type: Plain text
13655 #: build/C/man4/wavelan.4:39
13656 msgid ""
13657 "I<wavelan> is the low-level device driver for the NCR / AT&T / Lucent "
13658 "B<WaveLAN ISA> and Digital (DEC)  B<RoamAbout DS> wireless ethernet "
13659 "adapter.  This driver is available as a module or might be compiled in the "
13660 "kernel.  This driver supports multiple cards in both forms (up to 4) and "
13661 "allocates the next available ethernet device (eth0..eth#) for each card "
13662 "found, unless a device name is explicitly specified (see below).  This "
13663 "device name will be reported in the kernel log file with the MAC address, "
13664 "NWID and frequency used by the card."
13665 msgstr ""
13666
13667 #. type: Plain text
13668 #: build/C/man4/wavelan.4:46
13669 msgid ""
13670 "This section apply to the module form (parameters passed on the B<insmod>(8)  "
13671 "command line).  If the driver is included in the kernel, use the "
13672 "I<ether=IRQ,IO,NAME> syntax on the kernel command line."
13673 msgstr ""
13674
13675 #. type: TP
13676 #: build/C/man4/wavelan.4:46
13677 #, no-wrap
13678 msgid "B<io>"
13679 msgstr ""
13680
13681 #. type: Plain text
13682 #: build/C/man4/wavelan.4:53
13683 msgid ""
13684 "Specify the list of base address where to search for wavelan cards (setting "
13685 "by dip switch on the card).  If you don't specify any io address, the driver "
13686 "will scan 0x390 and 0x3E0 addresses, which might conflict with other "
13687 "hardware..."
13688 msgstr ""
13689
13690 #. type: TP
13691 #: build/C/man4/wavelan.4:53
13692 #, no-wrap
13693 msgid "B<irq>"
13694 msgstr ""
13695
13696 #. type: Plain text
13697 #: build/C/man4/wavelan.4:57
13698 msgid ""
13699 "Set the list of irq that each wavelan card should use (the value is saved in "
13700 "permanent storage for future use)."
13701 msgstr ""
13702
13703 #. type: TP
13704 #: build/C/man4/wavelan.4:57
13705 #, no-wrap
13706 msgid "B<name>"
13707 msgstr ""
13708
13709 #. type: Plain text
13710 #: build/C/man4/wavelan.4:62
13711 msgid ""
13712 "Set the list of name to be used for each wavelan cards device (name used by "
13713 "B<ifconfig>(8))."
13714 msgstr ""
13715
13716 #. type: SS
13717 #: build/C/man4/wavelan.4:62
13718 #, no-wrap
13719 msgid "Wireless extensions"
13720 msgstr ""
13721
13722 #. type: Plain text
13723 #: build/C/man4/wavelan.4:66
13724 msgid "Use B<iwconfig>(8)  to manipulate wireless extensions."
13725 msgstr ""
13726
13727 #. type: SS
13728 #: build/C/man4/wavelan.4:66
13729 #, no-wrap
13730 msgid "NWID (or domain)"
13731 msgstr ""
13732
13733 #. type: Plain text
13734 #: build/C/man4/wavelan.4:75
13735 msgid ""
13736 "Set the network ID [I<0> to I<FFFF>] or disable it [I<off>].  As the NWID is "
13737 "stored in the card Permanent Storage Area, it will be reuse at any further "
13738 "invocation of the driver."
13739 msgstr ""
13740
13741 #. type: SS
13742 #: build/C/man4/wavelan.4:75
13743 #, no-wrap
13744 msgid "Frequency & channels"
13745 msgstr ""
13746
13747 #. type: Plain text
13748 #: build/C/man4/wavelan.4:86
13749 msgid ""
13750 "For the 2.4GHz 2.00 Hardware, you are able to set the frequency by "
13751 "specifying one of the 10 defined channels (I<2.412,> I<2.422, 2.425, 2.4305, "
13752 "2.432, 2.442, 2.452, 2.460, 2.462> or I<2.484>)  or directly by its value.  "
13753 "The frequency is changed immediately and permanently.  Frequency "
13754 "availability depends on the regulations..."
13755 msgstr ""
13756
13757 #. type: SS
13758 #: build/C/man4/wavelan.4:86
13759 #, no-wrap
13760 msgid "Statistics spy"
13761 msgstr ""
13762
13763 #. type: Plain text
13764 #: build/C/man4/wavelan.4:90
13765 msgid ""
13766 "Set a list of MAC addresses in the driver (up to 8) and get the last quality "
13767 "of link for each of those (see B<iwspy>(8))."
13768 msgstr ""
13769
13770 #. type: SS
13771 #: build/C/man4/wavelan.4:90
13772 #, no-wrap
13773 msgid "/proc/net/wireless"
13774 msgstr ""
13775
13776 #. type: Plain text
13777 #: build/C/man4/wavelan.4:105
13778 msgid ""
13779 "I<status> is the status reported by the modem.  I<Link quality> reports the "
13780 "quality of the modulation on the air (direct sequence spread spectrum) [max "
13781 "= 16].  I<Level> and I<Noise> refer to the signal level and noise level [max "
13782 "= 64].  The I<crypt discarded packet> and I<misc discarded packet> counters "
13783 "are not implemented."
13784 msgstr ""
13785
13786 #. type: SS
13787 #: build/C/man4/wavelan.4:105
13788 #, no-wrap
13789 msgid "Private ioctl"
13790 msgstr ""
13791
13792 #. type: Plain text
13793 #: build/C/man4/wavelan.4:109
13794 msgid "You may use B<iwpriv>(8)  to manipulate private ioctls."
13795 msgstr ""
13796
13797 #. type: SS
13798 #: build/C/man4/wavelan.4:109
13799 #, no-wrap
13800 msgid "Quality and level threshold"
13801 msgstr ""
13802
13803 #. type: Plain text
13804 #: build/C/man4/wavelan.4:112
13805 msgid ""
13806 "Enable you the define the quality and level threshold used by the modem "
13807 "(packet below that level are discarded)."
13808 msgstr ""
13809
13810 #. type: SS
13811 #: build/C/man4/wavelan.4:112
13812 #, no-wrap
13813 msgid "Histogram"
13814 msgstr ""
13815
13816 #. type: Plain text
13817 #: build/C/man4/wavelan.4:119
13818 msgid ""
13819 "This functionality makes it possible to set a number of signal level "
13820 "intervals and to count the number of packets received in each of those "
13821 "defined intervals.  This distribution might be used to calculate the mean "
13822 "value and standard deviation of the signal level."
13823 msgstr ""
13824
13825 #. type: SS
13826 #: build/C/man4/wavelan.4:119
13827 #, no-wrap
13828 msgid "Specific notes"
13829 msgstr ""
13830
13831 #. type: Plain text
13832 #: build/C/man4/wavelan.4:125
13833 msgid ""
13834 "This driver will fail to detect some B<non-NCR/ATT&T/Lucent> Wavelan cards.  "
13835 "If this happens for you, you must look in the source code on how to add your "
13836 "card to the detection routine."
13837 msgstr ""
13838
13839 #.  .SH AUTHOR
13840 #.  Bruce Janson \(em bruce@cs.usyd.edu.au
13841 #.  .br
13842 #.  Jean Tourrilhes \(em jt@hplb.hpl.hp.com
13843 #.  .br
13844 #.  (and others; see source code for details)
13845 #
13846 #.  SEE ALSO part
13847 #. type: Plain text
13848 #: build/C/man4/wavelan.4:138
13849 msgid ""
13850 "Some of the mentioned features are optional.  You may enable to disable them "
13851 "by changing flags in the driver header and recompile."
13852 msgstr ""
13853
13854 #. type: Plain text
13855 #: build/C/man4/wavelan.4:144
13856 msgid ""
13857 "B<wavelan_cs>(4), B<ifconfig>(8), B<insmod>(8), B<iwconfig>(8), "
13858 "B<iwpriv>(8), B<iwspy>(8)"
13859 msgstr ""