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: 2014-06-03 01:29+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:31 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:31 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:32 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:35 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:46 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:78 build/C/man4/mouse.4:180 build/C/man4/null.4:57 build/C/man4/ram.4:41 build/C/man4/random.4:275 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:61 build/C/man5/core.5:65 build/C/man5/core.5:69 build/C/man5/core.5:72 build/C/man5/core.5:85 build/C/man5/core.5:88 build/C/man5/core.5:101 build/C/man5/core.5:218 build/C/man5/core.5:222 build/C/man5/core.5:225 build/C/man5/core.5:229
 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, the "
 629 "B<cciss> driver implements only the first two of these actions, aborting the "
 630 "command, and resetting the device.  Note also that most tape drives will not "
 631 "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:423 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:84 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:232 build/C/man4/ram.4:43 build/C/man4/random.4:282 build/C/man3/setlogmask.3:78 build/C/man4/sk98lin.4:598 build/C/man4/st.4:954 build/C/man2/syslog.2:309 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 #.  .SH AUTHORS
 660 #.  Don Brace, Steve Cameron, Chase Maupin, Mike Miller, Michael Ni,
 661 #.  Charles White, Francis Wiran
 662 #.  and probably some other people.
 663 #. type: Plain text
 664 #: build/C/man4/cciss.4:370
 665 msgid ""
 666 "E<.UR http://cciss.sf.net> E<.UE ,> and I<Documentation/blockdev/cciss.txt> "
 667 "and I<Documentation/ABI/testing/sysfs-bus-pci-devices-cciss> in the Linux "
 668 "kernel source tree"
 669 msgstr ""
 670
 671 #. type: SH
 672 #: build/C/man4/cciss.4:370 build/C/man4/console.4:112 build/C/man4/console_codes.4:646 build/C/man4/console_ioctl.4:873 build/C/man5/core.5:434 build/C/man4/cpuid.4:96 build/C/man4/dsp56k.4:121 build/C/man4/fd.4:222 build/C/man7/fifo.7:74 build/C/man4/full.4:65 build/C/man3/gnu_get_libc_version.3:78 build/C/man4/hd.4:110 build/C/man4/hpsa.4:197 build/C/man4/initrd.4:484 build/C/man4/lp.4:141 build/C/man3/makedev.3:83 build/C/man4/mem.4:88 build/C/man3/mkfifo.3:206 build/C/man2/mknod.2:297 build/C/man4/mouse.4:187 build/C/man4/msr.4:59 build/C/man4/null.4:68 build/C/man7/pipe.7:244 build/C/man4/ram.4:47 build/C/man4/random.4:286 build/C/man4/sd.4:137 build/C/man3/setlogmask.3:82 build/C/man4/sk98lin.4:602 build/C/man4/st.4:964 build/C/man3/stdarg.3:338 build/C/man2/syslog.2:312 build/C/man3/syslog.3:320 build/C/man4/ttyS.4:55 build/C/man7/uri.7:715 build/C/man4/vcs.4:178 build/C/man4/wavelan.4:145
 673 #, no-wrap
 674 msgid "COLOPHON"
 675 msgstr ""
 676
 677 #. type: Plain text
 678 #: build/C/man4/cciss.4:378 build/C/man4/console.4:120 build/C/man4/console_codes.4:654 build/C/man4/console_ioctl.4:881 build/C/man5/core.5:442 build/C/man4/cpuid.4:104 build/C/man4/dsp56k.4:129 build/C/man4/fd.4:230 build/C/man7/fifo.7:82 build/C/man4/full.4:73 build/C/man3/gnu_get_libc_version.3:86 build/C/man4/hd.4:118 build/C/man4/hpsa.4:205 build/C/man4/initrd.4:492 build/C/man4/lp.4:149 build/C/man3/makedev.3:91 build/C/man4/mem.4:96 build/C/man3/mkfifo.3:214 build/C/man2/mknod.2:305 build/C/man4/mouse.4:195 build/C/man4/msr.4:67 build/C/man4/null.4:76 build/C/man7/pipe.7:252 build/C/man4/ram.4:55 build/C/man4/random.4:294 build/C/man4/sd.4:145 build/C/man3/setlogmask.3:90 build/C/man4/sk98lin.4:610 build/C/man4/st.4:972 build/C/man3/stdarg.3:346 build/C/man2/syslog.2:320 build/C/man3/syslog.3:328 build/C/man4/ttyS.4:63 build/C/man7/uri.7:723 build/C/man4/vcs.4:186 build/C/man4/wavelan.4:153
 679 msgid ""
 680 "This page is part of release 3.67 of the Linux I<man-pages> project.  A "
 681 "description of the project, information about reporting bugs, and the latest "
 682 "version of this page, can be found at "
 683 "\\%http://www.kernel.org/doc/man-pages/."
 684 msgstr ""
 685
 686 #. type: TH
 687 #: build/C/man4/console.4:12
 688 #, no-wrap
 689 msgid "CONSOLE"
 690 msgstr ""
 691
 692 #. type: TH
 693 #: build/C/man4/console.4:12
 694 #, no-wrap
 695 msgid "1994-10-31"
 696 msgstr ""
 697
 698 #. type: Plain text
 699 #: build/C/man4/console.4:15
 700 msgid "console - console terminal and virtual consoles"
 701 msgstr ""
 702
 703 #. type: Plain text
 704 #: build/C/man4/console.4:37
 705 msgid ""
 706 "A Linux system has up to 63 I<virtual consoles> (character devices with "
 707 "major number 4 and minor number 1 to 63), usually called I</dev/ttyn> with 1 "
 708 "\\(E<lt>= I<n> \\(E<lt>= 63.  The current console is also addressed by "
 709 "I</dev/console> or I</dev/tty0>, the character device with major number 4 "
 710 "and minor number 0.  The device files I</dev/*> are usually created using "
 711 "the script MAKEDEV, or using B<mknod>(1), usually with mode 0622 and owner "
 712 "I<root.tty>."
 713 msgstr ""
 714
 715 #. type: Plain text
 716 #: build/C/man4/console.4:45
 717 msgid ""
 718 "Before kernel version 1.1.54 the number of virtual consoles was compiled "
 719 "into the kernel (in I<tty.h>: #define NR_CONSOLES 8)  and could be changed "
 720 "by editing and recompiling.  Since version 1.1.54 virtual consoles are "
 721 "created on the fly, as soon as they are needed."
 722 msgstr ""
 723
 724 #. type: Plain text
 725 #: build/C/man4/console.4:63
 726 msgid ""
 727 "Common ways to start a process on a console are: (a) tell B<init>(8)  (in "
 728 "B<inittab>(5))  to start a B<mingetty>(8)  (or B<agetty>(8))  on the "
 729 "console; (b) ask B<openvt>(1)  to start a process on the console; (c) start "
 730 "X\\(emit will find the first unused console, and display its output there.  "
 731 "(There is also the ancient B<doshell>(8).)"
 732 msgstr ""
 733
 734 #. type: Plain text
 735 #: build/C/man4/console.4:76
 736 msgid ""
 737 "Common ways to switch consoles are: (a) use Alt+FI<n> or Ctrl+Alt+FI<n> to "
 738 "switch to console I<n>; AltGr+FI<n> might bring you to console I<n>+12 [here "
 739 "Alt and AltGr refer to the left and right Alt keys, respectively]; (b) use "
 740 "Alt+RightArrow or Alt+LeftArrow to cycle through the presently allocated "
 741 "consoles; (c) use the program B<chvt>(1).  (The key mapping is user "
 742 "settable, see B<loadkeys>(1); the above mentioned key combinations are "
 743 "according to the default settings.)"
 744 msgstr ""
 745
 746 #. type: Plain text
 747 #: build/C/man4/console.4:83
 748 msgid ""
 749 "The command B<deallocvt>(1)  (formerly B<disalloc>)  will free the memory "
 750 "taken by the screen buffers for consoles that no longer have any associated "
 751 "process."
 752 msgstr ""
 753
 754 #. type: SS
 755 #: build/C/man4/console.4:83
 756 #, no-wrap
 757 msgid "Properties"
 758 msgstr ""
 759
 760 #. type: Plain text
 761 #: build/C/man4/console.4:91
 762 msgid ""
 763 "Consoles carry a lot of state.  I hope to document that some other time.  "
 764 "The most important fact is that the consoles simulate vt100 terminals.  In "
 765 "particular, a console is reset to the initial state by printing the two "
 766 "characters ESC c.  All escape sequences can be found in B<console_codes>(4)."
 767 msgstr ""
 768
 769 #. type: Plain text
 770 #: build/C/man4/console.4:93
 771 msgid "I</dev/console>"
 772 msgstr ""
 773
 774 #. type: Plain text
 775 #: build/C/man4/console.4:95
 776 msgid "I</dev/tty*>"
 777 msgstr ""
 778
 779 #. type: Plain text
 780 #: build/C/man4/console.4:112
 781 msgid ""
 782 "B<chvt>(1), B<deallocvt>(1), B<loadkeys>(1), B<mknod>(1), B<openvt>(1), "
 783 "B<console_codes>(4), B<console_ioctl>(4), B<tty>(4), B<ttyS>(4), "
 784 "B<charsets>(7), B<agetty>(8), B<init>(8), B<mapscrn>(8), B<mingetty>(8), "
 785 "B<resizecons>(8), B<setfont>(8)"
 786 msgstr ""
 787
 788 #. type: TH
 789 #: build/C/man4/console_codes.4:23
 790 #, no-wrap
 791 msgid "CONSOLE_CODES"
 792 msgstr ""
 793
 794 #. type: Plain text
 795 #: build/C/man4/console_codes.4:26
 796 msgid "console_codes - Linux console escape and control sequences"
 797 msgstr ""
 798
 799 #. type: Plain text
 800 #: build/C/man4/console_codes.4:33
 801 msgid ""
 802 "The Linux console implements a large subset of the VT102 and ECMA-48/ISO "
 803 "6429/ANSI X3.64 terminal controls, plus certain private-mode sequences for "
 804 "changing the color palette, character-set mapping, and so on.  In the "
 805 "tabular descriptions below, the second column gives ECMA-48 or DEC mnemonics "
 806 "(the latter if prefixed with DEC) for the given function.  Sequences without "
 807 "a mnemonic are neither ECMA-48 nor VT102."
 808 msgstr ""
 809
 810 #. type: Plain text
 811 #: build/C/man4/console_codes.4:38
 812 msgid ""
 813 "After all the normal output processing has been done, and a stream of "
 814 "characters arrives at the console driver for actual printing, the first "
 815 "thing that happens is a translation from the code used for processing to the "
 816 "code used for printing."
 817 msgstr ""
 818
 819 #. type: Plain text
 820 #: build/C/man4/console_codes.4:44
 821 msgid ""
 822 "If the console is in UTF-8 mode, then the incoming bytes are first assembled "
 823 "into 16-bit Unicode codes.  Otherwise, each byte is transformed according to "
 824 "the current mapping table (which translates it to a Unicode value).  See the "
 825 "B<Character Sets> section below for discussion."
 826 msgstr ""
 827
 828 #. type: Plain text
 829 #: build/C/man4/console_codes.4:50
 830 msgid ""
 831 "In the normal case, the Unicode value is converted to a font index, and this "
 832 "is stored in video memory, so that the corresponding glyph (as found in "
 833 "video ROM) appears on the screen.  Note that the use of Unicode (and the "
 834 "design of the PC hardware)  allows us to use 512 different glyphs "
 835 "simultaneously."
 836 msgstr ""
 837
 838 #. type: Plain text
 839 #: build/C/man4/console_codes.4:57
 840 msgid ""
 841 "If the current Unicode value is a control character, or we are currently "
 842 "processing an escape sequence, the value will treated specially.  Instead of "
 843 "being turned into a font index and rendered as a glyph, it may trigger "
 844 "cursor movement or other control functions.  See the B<Linux Console "
 845 "Controls> section below for discussion."
 846 msgstr ""
 847
 848 #. type: Plain text
 849 #: build/C/man4/console_codes.4:69
 850 msgid ""
 851 "It is generally not good practice to hard-wire terminal controls into "
 852 "programs.  Linux supports a B<terminfo>(5)  database of terminal "
 853 "capabilities.  Rather than emitting console escape sequences by hand, you "
 854 "will almost always want to use a terminfo-aware screen library or utility "
 855 "such as B<ncurses>(3), B<tput>(1), or B<reset>(1)."
 856 msgstr ""
 857
 858 #. type: SS
 859 #: build/C/man4/console_codes.4:69
 860 #, no-wrap
 861 msgid "Linux console controls"
 862 msgstr ""
 863
 864 #. type: Plain text
 865 #: build/C/man4/console_codes.4:73
 866 msgid ""
 867 "This section describes all the control characters and escape sequences that "
 868 "invoke special functions (i.e., anything other than writing a glyph at the "
 869 "current cursor location) on the Linux console."
 870 msgstr ""
 871
 872 #. type: Plain text
 873 #: build/C/man4/console_codes.4:75
 874 msgid "B<Control characters>"
 875 msgstr ""
 876
 877 #. type: Plain text
 878 #: build/C/man4/console_codes.4:86
 879 msgid ""
 880 "A character is a control character if (before transformation according to "
 881 "the mapping table) it has one of the 14 codes 00 (NUL), 07 (BEL), 08 (BS), "
 882 "09 (HT), 0a (LF), 0b (VT), 0c (FF), 0d (CR), 0e (SO), 0f (SI), 18 (CAN), 1a "
 883 "(SUB), 1b (ESC), 7f (DEL).  One can set a \"display control characters\" "
 884 "mode (see below), and allow 07, 09, 0b, 18, 1a, 7f to be displayed as "
 885 "glyphs.  On the other hand, in UTF-8 mode all codes 00-1f are regarded as "
 886 "control characters, regardless of any \"display control characters\" mode."
 887 msgstr ""
 888
 889 #. type: Plain text
 890 #: build/C/man4/console_codes.4:95
 891 msgid ""
 892 "If we have a control character, it is acted upon immediately and then "
 893 "discarded (even in the middle of an escape sequence)  and the escape "
 894 "sequence continues with the next character.  (However, ESC starts a new "
 895 "escape sequence, possibly aborting a previous unfinished one, and CAN and "
 896 "SUB abort any escape sequence.)  The recognized control characters are BEL, "
 897 "BS, HT, LF, VT, FF, CR, SO, SI, CAN, SUB, ESC, DEL, CSI.  They do what one "
 898 "would expect:"
 899 msgstr ""
 900
 901 #. type: Plain text
 902 #: build/C/man4/console_codes.4:97
 903 msgid "BEL (0x07, B<^G>) beeps;"
 904 msgstr ""
 905
 906 #. type: Plain text
 907 #: build/C/man4/console_codes.4:100
 908 msgid ""
 909 "BS (0x08, B<^H>) backspaces one column (but not past the beginning of the "
 910 "line);"
 911 msgstr ""
 912
 913 #. type: Plain text
 914 #: build/C/man4/console_codes.4:103
 915 msgid ""
 916 "HT (0x09, B<^I>) goes to the next tab stop or to the end of the line if "
 917 "there is no earlier tab stop;"
 918 msgstr ""
 919
 920 #. type: Plain text
 921 #: build/C/man4/console_codes.4:107
 922 msgid ""
 923 "LF (0x0A, B<^J>), VT (0x0B, B<^K>) and FF (0x0C, B<^L>) all give a linefeed, "
 924 "and if LF/NL (new-line mode) is set also a carriage return;"
 925 msgstr ""
 926
 927 #. type: Plain text
 928 #: build/C/man4/console_codes.4:109
 929 msgid "CR (0x0D, B<^M>) gives a carriage return;"
 930 msgstr ""
 931
 932 #. type: Plain text
 933 #: build/C/man4/console_codes.4:111
 934 msgid "SO (0x0E, B<^N>) activates the G1 character set;"
 935 msgstr ""
 936
 937 #. type: Plain text
 938 #: build/C/man4/console_codes.4:113
 939 msgid "SI (0x0F, B<^O>) activates the G0 character set;"
 940 msgstr ""
 941
 942 #. type: Plain text
 943 #: build/C/man4/console_codes.4:115
 944 msgid "CAN (0x18, B<^X>) and SUB (0x1A, B<^Z>) interrupt escape sequences;"
 945 msgstr ""
 946
 947 #. type: Plain text
 948 #: build/C/man4/console_codes.4:117
 949 msgid "ESC (0x1B, B<^[>) starts an escape sequence;"
 950 msgstr ""
 951
 952 #. type: Plain text
 953 #: build/C/man4/console_codes.4:119
 954 msgid "DEL (0x7F) is ignored;"
 955 msgstr ""
 956
 957 #. type: Plain text
 958 #: build/C/man4/console_codes.4:121
 959 msgid "CSI (0x9B) is equivalent to ESC [."
 960 msgstr ""
 961
 962 #. type: Plain text
 963 #: build/C/man4/console_codes.4:123
 964 msgid "B<ESC- but not CSI-sequences>"
 965 msgstr ""
 966
 967 #. type: tbl table
 968 #: build/C/man4/console_codes.4:125
 969 #, no-wrap
 970 msgid "ESC c\tRIS\tReset.\n"
 971 msgstr ""
 972
 973 #. type: tbl table
 974 #: build/C/man4/console_codes.4:126
 975 #, no-wrap
 976 msgid "ESC D\tIND\tLinefeed.\n"
 977 msgstr ""
 978
 979 #. type: tbl table
 980 #: build/C/man4/console_codes.4:127
 981 #, no-wrap
 982 msgid "ESC E\tNEL\tNewline.\n"
 983 msgstr ""
 984
 985 #. type: tbl table
 986 #: build/C/man4/console_codes.4:128
 987 #, no-wrap
 988 msgid "ESC H\tHTS\tSet tab stop at current column.\n"
 989 msgstr ""
 990
 991 #. type: tbl table
 992 #: build/C/man4/console_codes.4:129
 993 #, no-wrap
 994 msgid "ESC M\tRI\tReverse linefeed.\n"
 995 msgstr ""
 996
 997 #. type: tbl table
 998 #: build/C/man4/console_codes.4:130
 999 #, no-wrap
1000 msgid "ESC Z\tDECID\tT{\n"
1001 msgstr ""
1002
1003 #. type: tbl table
1004 #: build/C/man4/console_codes.4:131
1005 #, no-wrap
1006 msgid "DEC private identification. The kernel\n"
1007 msgstr ""
1008
1009 #. type: tbl table
1010 #: build/C/man4/console_codes.4:132
1011 #, no-wrap
1012 msgid "returns the string  ESC [ ? 6 c, claiming\n"
1013 msgstr ""
1014
1015 #. type: tbl table
1016 #: build/C/man4/console_codes.4:133
1017 #, no-wrap
1018 msgid "that it is a VT102.\n"
1019 msgstr ""
1020
1021 #. type: tbl table
1022 #: 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
1023 #, no-wrap
1024 msgid "T}\n"
1025 msgstr ""
1026
1027 #. type: tbl table
1028 #: build/C/man4/console_codes.4:135
1029 #, no-wrap
1030 msgid "ESC 7\tDECSC\tT{\n"
1031 msgstr ""
1032
1033 #. type: tbl table
1034 #: build/C/man4/console_codes.4:136
1035 #, no-wrap
1036 msgid "Save current state (cursor coordinates,\n"
1037 msgstr ""
1038
1039 #. type: tbl table
1040 #: build/C/man4/console_codes.4:137
1041 #, no-wrap
1042 msgid "attributes, character sets pointed at by G0, G1).\n"
1043 msgstr ""
1044
1045 #. type: tbl table
1046 #: build/C/man4/console_codes.4:139
1047 #, no-wrap
1048 msgid "ESC 8\tDECRC\tRestore state most recently saved by ESC 7.\n"
1049 msgstr ""
1050
1051 #. type: tbl table
1052 #: build/C/man4/console_codes.4:140
1053 #, no-wrap
1054 msgid "ESC [\tCSI\tControl sequence introducer\n"
1055 msgstr ""
1056
1057 #. type: tbl table
1058 #: build/C/man4/console_codes.4:141
1059 #, no-wrap
1060 msgid "ESC %\t\tStart sequence selecting character set\n"
1061 msgstr ""
1062
1063 #. type: tbl table
1064 #: build/C/man4/console_codes.4:142
1065 #, no-wrap
1066 msgid "ESC % @\t\t\\0\\0\\0Select default (ISO 646 / ISO 8859-1)\n"
1067 msgstr ""
1068
1069 #. type: tbl table
1070 #: build/C/man4/console_codes.4:143
1071 #, no-wrap
1072 msgid "ESC % G\t\t\\0\\0\\0Select UTF-8\n"
1073 msgstr ""
1074
1075 #. type: tbl table
1076 #: build/C/man4/console_codes.4:144
1077 #, no-wrap
1078 msgid "ESC % 8\t\t\\0\\0\\0Select UTF-8 (obsolete)\n"
1079 msgstr ""
1080
1081 #. type: tbl table
1082 #: build/C/man4/console_codes.4:145
1083 #, no-wrap
1084 msgid "ESC # 8\tDECALN\tDEC screen alignment test - fill screen with E's.\n"
1085 msgstr ""
1086
1087 #. type: tbl table
1088 #: build/C/man4/console_codes.4:146
1089 #, no-wrap
1090 msgid "ESC (\t\tStart sequence defining G0 character set\n"
1091 msgstr ""
1092
1093 #. type: tbl table
1094 #: build/C/man4/console_codes.4:147
1095 #, no-wrap
1096 msgid "ESC ( B\t\t\\0\\0\\0Select default (ISO 8859-1 mapping)\n"
1097 msgstr ""
1098
1099 #. type: tbl table
1100 #: build/C/man4/console_codes.4:148
1101 #, no-wrap
1102 msgid "ESC ( 0\t\t\\0\\0\\0Select VT100 graphics mapping\n"
1103 msgstr ""
1104
1105 #. type: tbl table
1106 #: build/C/man4/console_codes.4:149
1107 #, no-wrap
1108 msgid "ESC ( U\t\t\\0\\0\\0Select null mapping - straight to character ROM\n"
1109 msgstr ""
1110
1111 #. type: tbl table
1112 #: build/C/man4/console_codes.4:150
1113 #, no-wrap
1114 msgid "ESC ( K\t\t\\0\\0\\0Select user mapping - the map that is loaded by\n"
1115 msgstr ""
1116
1117 #. type: tbl table
1118 #: build/C/man4/console_codes.4:151
1119 #, no-wrap
1120 msgid "\t\t\\0\\0\\0the utility B<mapscrn>(8).\n"
1121 msgstr ""
1122
1123 #. type: tbl table
1124 #: build/C/man4/console_codes.4:152
1125 #, no-wrap
1126 msgid "ESC )\t\tStart sequence defining G1\n"
1127 msgstr ""
1128
1129 #. type: tbl table
1130 #: build/C/man4/console_codes.4:153
1131 #, no-wrap
1132 msgid "\t\t(followed by one of B, 0, U, K, as above).\n"
1133 msgstr ""
1134
1135 #. type: tbl table
1136 #: build/C/man4/console_codes.4:154
1137 #, no-wrap
1138 msgid "ESC E<gt>\tDECPNM\tSet numeric keypad mode\n"
1139 msgstr ""
1140
1141 #. type: tbl table
1142 #: build/C/man4/console_codes.4:155
1143 #, no-wrap
1144 msgid "ESC =\tDECPAM\tSet application keypad mode\n"
1145 msgstr ""
1146
1147 #. type: tbl table
1148 #: build/C/man4/console_codes.4:156
1149 #, no-wrap
1150 msgid "ESC ]\tOSC\tT{\n"
1151 msgstr ""
1152
1153 #. type: tbl table
1154 #: build/C/man4/console_codes.4:157
1155 #, no-wrap
1156 msgid "(Should be: Operating system command)\n"
1157 msgstr ""
1158
1159 #. type: tbl table
1160 #: build/C/man4/console_codes.4:158
1161 #, no-wrap
1162 msgid "ESC ] P I<nrrggbb>: set palette, with parameter\n"
1163 msgstr ""
1164
1165 #. type: tbl table
1166 #: build/C/man4/console_codes.4:159
1167 #, no-wrap
1168 msgid "given in 7 hexadecimal digits after the final P :-(.\n"
1169 msgstr ""
1170
1171 #. type: tbl table
1172 #: build/C/man4/console_codes.4:160
1173 #, no-wrap
1174 msgid "Here I<n> is the color (0-15), and I<rrggbb> indicates\n"
1175 msgstr ""
1176
1177 #. type: tbl table
1178 #: build/C/man4/console_codes.4:161
1179 #, no-wrap
1180 msgid "the red/green/blue values (0-255).\n"
1181 msgstr ""
1182
1183 #. type: tbl table
1184 #: build/C/man4/console_codes.4:162
1185 #, no-wrap
1186 msgid "ESC ] R: reset palette\n"
1187 msgstr ""
1188
1189 #. type: Plain text
1190 #: build/C/man4/console_codes.4:167
1191 msgid "B<ECMA-48 CSI sequences>"
1192 msgstr ""
1193
1194 #. type: Plain text
1195 #: build/C/man4/console_codes.4:173
1196 msgid ""
1197 "CSI (or ESC [) is followed by a sequence of parameters, at most NPAR (16), "
1198 "that are decimal numbers separated by semicolons.  An empty or absent "
1199 "parameter is taken to be 0.  The sequence of parameters may be preceded by a "
1200 "single question mark."
1201 msgstr ""
1202
1203 #. type: Plain text
1204 #: build/C/man4/console_codes.4:177
1205 msgid ""
1206 "However, after CSI [ (or ESC [ [) a single character is read and this entire "
1207 "sequence is ignored.  (The idea is to ignore an echoed function key.)"
1208 msgstr ""
1209
1210 #. type: Plain text
1211 #: build/C/man4/console_codes.4:179
1212 msgid "The action of a CSI sequence is determined by its final character."
1213 msgstr ""
1214
1215 #. type: tbl table
1216 #: build/C/man4/console_codes.4:181
1217 #, no-wrap
1218 msgid "@\tICH\tInsert the indicated # of blank characters.\n"
1219 msgstr ""
1220
1221 #. type: tbl table
1222 #: build/C/man4/console_codes.4:182
1223 #, no-wrap
1224 msgid "A\tCUU\tMove cursor up the indicated # of rows.\n"
1225 msgstr ""
1226
1227 #. type: tbl table
1228 #: build/C/man4/console_codes.4:183
1229 #, no-wrap
1230 msgid "B\tCUD\tMove cursor down the indicated # of rows.\n"
1231 msgstr ""
1232
1233 #. type: tbl table
1234 #: build/C/man4/console_codes.4:184
1235 #, no-wrap
1236 msgid "C\tCUF\tMove cursor right the indicated # of columns.\n"
1237 msgstr ""
1238
1239 #. type: tbl table
1240 #: build/C/man4/console_codes.4:185
1241 #, no-wrap
1242 msgid "D\tCUB\tMove cursor left the indicated # of columns.\n"
1243 msgstr ""
1244
1245 #. type: tbl table
1246 #: build/C/man4/console_codes.4:186
1247 #, no-wrap
1248 msgid "E\tCNL\tMove cursor down the indicated # of rows, to column 1.\n"
1249 msgstr ""
1250
1251 #. type: tbl table
1252 #: build/C/man4/console_codes.4:187
1253 #, no-wrap
1254 msgid "F\tCPL\tMove cursor up the indicated # of rows, to column 1.\n"
1255 msgstr ""
1256
1257 #. type: tbl table
1258 #: build/C/man4/console_codes.4:188
1259 #, no-wrap
1260 msgid "G\tCHA\tMove cursor to indicated column in current row.\n"
1261 msgstr ""
1262
1263 #. type: tbl table
1264 #: build/C/man4/console_codes.4:189
1265 #, no-wrap
1266 msgid "H\tCUP\tMove cursor to the indicated row, column (origin at 1,1).\n"
1267 msgstr ""
1268
1269 #. type: tbl table
1270 #: build/C/man4/console_codes.4:190
1271 #, no-wrap
1272 msgid "J\tED\tErase display (default: from cursor to end of display).\n"
1273 msgstr ""
1274
1275 #. type: tbl table
1276 #: build/C/man4/console_codes.4:191
1277 #, no-wrap
1278 msgid "\t\tESC [ 1 J: erase from start to cursor.\n"
1279 msgstr ""
1280
1281 #. type: tbl table
1282 #: build/C/man4/console_codes.4:192
1283 #, no-wrap
1284 msgid "\t\tESC [ 2 J: erase whole display.\n"
1285 msgstr ""
1286
1287 #. type: tbl table
1288 #: build/C/man4/console_codes.4:193
1289 #, no-wrap
1290 msgid "\t\tESC [ 3 J: erase whole display including scroll-back\n"
1291 msgstr ""
1292
1293 #. type: tbl table
1294 #: build/C/man4/console_codes.4:194
1295 #, no-wrap
1296 msgid "\t\t           buffer (since Linux 3.0).\n"
1297 msgstr ""
1298
1299 #.  ESC [ 3 J: commit f8df13e0a901fe55631fed66562369b4dba40f8b
1300 #. type: tbl table
1301 #: build/C/man4/console_codes.4:196
1302 #, no-wrap
1303 msgid "K\tEL\tErase line (default: from cursor to end of line).\n"
1304 msgstr ""
1305
1306 #. type: tbl table
1307 #: build/C/man4/console_codes.4:197
1308 #, no-wrap
1309 msgid "\t\tESC [ 1 K: erase from start of line to cursor.\n"
1310 msgstr ""
1311
1312 #. type: tbl table
1313 #: build/C/man4/console_codes.4:198
1314 #, no-wrap
1315 msgid "\t\tESC [ 2 K: erase whole line.\n"
1316 msgstr ""
1317
1318 #. type: tbl table
1319 #: build/C/man4/console_codes.4:199
1320 #, no-wrap
1321 msgid "L\tIL\tInsert the indicated # of blank lines.\n"
1322 msgstr ""
1323
1324 #. type: tbl table
1325 #: build/C/man4/console_codes.4:200
1326 #, no-wrap
1327 msgid "M\tDL\tDelete the indicated # of lines.\n"
1328 msgstr ""
1329
1330 #. type: tbl table
1331 #: build/C/man4/console_codes.4:201
1332 #, no-wrap
1333 msgid "P\tDCH\tDelete the indicated # of characters on current line.\n"
1334 msgstr ""
1335
1336 #. type: tbl table
1337 #: build/C/man4/console_codes.4:202
1338 #, no-wrap
1339 msgid "X\tECH\tErase the indicated # of characters on current line.\n"
1340 msgstr ""
1341
1342 #. type: tbl table
1343 #: build/C/man4/console_codes.4:203
1344 #, no-wrap
1345 msgid "a\tHPR\tMove cursor right the indicated # of columns.\n"
1346 msgstr ""
1347
1348 #. type: tbl table
1349 #: build/C/man4/console_codes.4:204
1350 #, no-wrap
1351 msgid "c\tDA\tAnswer ESC [ ? 6 c: \"I am a VT102\".\n"
1352 msgstr ""
1353
1354 #. type: tbl table
1355 #: build/C/man4/console_codes.4:205
1356 #, no-wrap
1357 msgid "d\tVPA\tMove cursor to the indicated row, current column.\n"
1358 msgstr ""
1359
1360 #. type: tbl table
1361 #: build/C/man4/console_codes.4:206
1362 #, no-wrap
1363 msgid "e\tVPR\tMove cursor down the indicated # of rows.\n"
1364 msgstr ""
1365
1366 #. type: tbl table
1367 #: build/C/man4/console_codes.4:207
1368 #, no-wrap
1369 msgid "f\tHVP\tMove cursor to the indicated row, column.\n"
1370 msgstr ""
1371
1372 #. type: tbl table
1373 #: build/C/man4/console_codes.4:208
1374 #, no-wrap
1375 msgid "g\tTBC\tWithout parameter: clear tab stop at current position.\n"
1376 msgstr ""
1377
1378 #. type: tbl table
1379 #: build/C/man4/console_codes.4:209
1380 #, no-wrap
1381 msgid "\t\tESC [ 3 g: delete all tab stops.\n"
1382 msgstr ""
1383
1384 #. type: tbl table
1385 #: build/C/man4/console_codes.4:210
1386 #, no-wrap
1387 msgid "h\tSM\tSet Mode (see below).\n"
1388 msgstr ""
1389
1390 #. type: tbl table
1391 #: build/C/man4/console_codes.4:211
1392 #, no-wrap
1393 msgid "l\tRM\tReset Mode (see below).\n"
1394 msgstr ""
1395
1396 #. type: tbl table
1397 #: build/C/man4/console_codes.4:212
1398 #, no-wrap
1399 msgid "m\tSGR\tSet attributes (see below).\n"
1400 msgstr ""
1401
1402 #. type: tbl table
1403 #: build/C/man4/console_codes.4:213
1404 #, no-wrap
1405 msgid "n\tDSR\tStatus report (see below).\n"
1406 msgstr ""
1407
1408 #. type: tbl table
1409 #: build/C/man4/console_codes.4:214
1410 #, no-wrap
1411 msgid "q\tDECLL\tSet keyboard LEDs.\n"
1412 msgstr ""
1413
1414 #. type: tbl table
1415 #: build/C/man4/console_codes.4:215
1416 #, no-wrap
1417 msgid "\t\tESC [ 0 q: clear all LEDs\n"
1418 msgstr ""
1419
1420 #. type: tbl table
1421 #: build/C/man4/console_codes.4:216
1422 #, no-wrap
1423 msgid "\t\tESC [ 1 q: set Scroll Lock LED\n"
1424 msgstr ""
1425
1426 #. type: tbl table
1427 #: build/C/man4/console_codes.4:217
1428 #, no-wrap
1429 msgid "\t\tESC [ 2 q: set Num Lock LED\n"
1430 msgstr ""
1431
1432 #. type: tbl table
1433 #: build/C/man4/console_codes.4:218
1434 #, no-wrap
1435 msgid "\t\tESC [ 3 q: set Caps Lock LED\n"
1436 msgstr ""
1437
1438 #. type: tbl table
1439 #: build/C/man4/console_codes.4:219
1440 #, no-wrap
1441 msgid "r\tDECSTBM\tSet scrolling region; parameters are top and bottom row.\n"
1442 msgstr ""
1443
1444 #. type: tbl table
1445 #: build/C/man4/console_codes.4:220
1446 #, no-wrap
1447 msgid "s\t?\tSave cursor location.\n"
1448 msgstr ""
1449
1450 #. type: tbl table
1451 #: build/C/man4/console_codes.4:221
1452 #, no-wrap
1453 msgid "u\t?\tRestore cursor location.\n"
1454 msgstr ""
1455
1456 #. type: tbl table
1457 #: build/C/man4/console_codes.4:222
1458 #, no-wrap
1459 msgid "\\`\tHPA\tMove cursor to indicated column in current row.\n"
1460 msgstr ""
1461
1462 #. type: Plain text
1463 #: build/C/man4/console_codes.4:226
1464 msgid "B<ECMA-48 Set Graphics Rendition>"
1465 msgstr ""
1466
1467 #. type: Plain text
1468 #: build/C/man4/console_codes.4:233
1469 msgid ""
1470 "The ECMA-48 SGR sequence ESC [ I<parameters> m sets display attributes.  "
1471 "Several attributes can be set in the same sequence, separated by "
1472 "semicolons.  An empty parameter (between semicolons or string initiator or "
1473 "terminator) is interpreted as a zero."
1474 msgstr ""
1475
1476 #. type: tbl table
1477 #: build/C/man4/console_codes.4:235
1478 #, no-wrap
1479 msgid "param\tresult\n"
1480 msgstr ""
1481
1482 #. type: tbl table
1483 #: build/C/man4/console_codes.4:236
1484 #, no-wrap
1485 msgid "0\treset all attributes to their defaults\n"
1486 msgstr ""
1487
1488 #. type: tbl table
1489 #: build/C/man4/console_codes.4:237
1490 #, no-wrap
1491 msgid "1\tset bold\n"
1492 msgstr ""
1493
1494 #. type: tbl table
1495 #: build/C/man4/console_codes.4:238
1496 #, no-wrap
1497 msgid "2\tset half-bright (simulated with color on a color display)\n"
1498 msgstr ""
1499
1500 #. type: tbl table
1501 #: build/C/man4/console_codes.4:239
1502 #, no-wrap
1503 msgid "4\tT{\n"
1504 msgstr ""
1505
1506 #. type: tbl table
1507 #: build/C/man4/console_codes.4:240
1508 #, no-wrap
1509 msgid "set underscore (simulated with color on a color display)\n"
1510 msgstr ""
1511
1512 #. type: tbl table
1513 #: build/C/man4/console_codes.4:241
1514 #, no-wrap
1515 msgid "(the colors used to simulate dim or underline are set\n"
1516 msgstr ""
1517
1518 #. type: tbl table
1519 #: build/C/man4/console_codes.4:242
1520 #, no-wrap
1521 msgid "using ESC ] ...)\n"
1522 msgstr ""
1523
1524 #. type: tbl table
1525 #: build/C/man4/console_codes.4:244
1526 #, no-wrap
1527 msgid "5\tset blink\n"
1528 msgstr ""
1529
1530 #. type: tbl table
1531 #: build/C/man4/console_codes.4:245
1532 #, no-wrap
1533 msgid "7\tset reverse video\n"
1534 msgstr ""
1535
1536 #. type: tbl table
1537 #: build/C/man4/console_codes.4:246
1538 #, no-wrap
1539 msgid "10\tT{\n"
1540 msgstr ""
1541
1542 #. type: tbl table
1543 #: build/C/man4/console_codes.4:247
1544 #, no-wrap
1545 msgid "reset selected mapping, display control flag,\n"
1546 msgstr ""
1547
1548 #. type: tbl table
1549 #: build/C/man4/console_codes.4:248
1550 #, no-wrap
1551 msgid "and toggle meta flag (ECMA-48 says \"primary font\").\n"
1552 msgstr ""
1553
1554 #. type: tbl table
1555 #: build/C/man4/console_codes.4:250
1556 #, no-wrap
1557 msgid "11\tT{\n"
1558 msgstr ""
1559
1560 #. type: tbl table
1561 #: build/C/man4/console_codes.4:251 build/C/man4/console_codes.4:255
1562 #, no-wrap
1563 msgid "select null mapping, set display control flag,\n"
1564 msgstr ""
1565
1566 #. type: tbl table
1567 #: build/C/man4/console_codes.4:252
1568 #, no-wrap
1569 msgid "reset toggle meta flag (ECMA-48 says \"first alternate font\").\n"
1570 msgstr ""
1571
1572 #. type: tbl table
1573 #: build/C/man4/console_codes.4:254
1574 #, no-wrap
1575 msgid "12\tT{\n"
1576 msgstr ""
1577
1578 #. type: tbl table
1579 #: build/C/man4/console_codes.4:256
1580 #, no-wrap
1581 msgid "set toggle meta flag (ECMA-48 says \"second alternate font\").\n"
1582 msgstr ""
1583
1584 #. type: tbl table
1585 #: build/C/man4/console_codes.4:257
1586 #, no-wrap
1587 msgid "The toggle meta flag\n"
1588 msgstr ""
1589
1590 #. type: tbl table
1591 #: build/C/man4/console_codes.4:258
1592 #, no-wrap
1593 msgid "causes the high bit of a byte to be toggled\n"
1594 msgstr ""
1595
1596 #. type: tbl table
1597 #: build/C/man4/console_codes.4:259
1598 #, no-wrap
1599 msgid "before the mapping table translation is done.\n"
1600 msgstr ""
1601
1602 #. type: tbl table
1603 #: build/C/man4/console_codes.4:261
1604 #, no-wrap
1605 msgid "21\tset normal intensity (ECMA-48 says \"doubly underlined\")\n"
1606 msgstr ""
1607
1608 #. type: tbl table
1609 #: build/C/man4/console_codes.4:262
1610 #, no-wrap
1611 msgid "22\tset normal intensity\n"
1612 msgstr ""
1613
1614 #. type: tbl table
1615 #: build/C/man4/console_codes.4:263
1616 #, no-wrap
1617 msgid "24\tunderline off\n"
1618 msgstr ""
1619
1620 #. type: tbl table
1621 #: build/C/man4/console_codes.4:264
1622 #, no-wrap
1623 msgid "25\tblink off\n"
1624 msgstr ""
1625
1626 #. type: tbl table
1627 #: build/C/man4/console_codes.4:265
1628 #, no-wrap
1629 msgid "27\treverse video off\n"
1630 msgstr ""
1631
1632 #. type: tbl table
1633 #: build/C/man4/console_codes.4:266
1634 #, no-wrap
1635 msgid "30\tset black foreground\n"
1636 msgstr ""
1637
1638 #. type: tbl table
1639 #: build/C/man4/console_codes.4:267
1640 #, no-wrap
1641 msgid "31\tset red foreground\n"
1642 msgstr ""
1643
1644 #. type: tbl table
1645 #: build/C/man4/console_codes.4:268
1646 #, no-wrap
1647 msgid "32\tset green foreground\n"
1648 msgstr ""
1649
1650 #. type: tbl table
1651 #: build/C/man4/console_codes.4:269
1652 #, no-wrap
1653 msgid "33\tset brown foreground\n"
1654 msgstr ""
1655
1656 #. type: tbl table
1657 #: build/C/man4/console_codes.4:270
1658 #, no-wrap
1659 msgid "34\tset blue foreground\n"
1660 msgstr ""
1661
1662 #. type: tbl table
1663 #: build/C/man4/console_codes.4:271
1664 #, no-wrap
1665 msgid "35\tset magenta foreground\n"
1666 msgstr ""
1667
1668 #. type: tbl table
1669 #: build/C/man4/console_codes.4:272
1670 #, no-wrap
1671 msgid "36\tset cyan foreground\n"
1672 msgstr ""
1673
1674 #. type: tbl table
1675 #: build/C/man4/console_codes.4:273
1676 #, no-wrap
1677 msgid "37\tset white foreground\n"
1678 msgstr ""
1679
1680 #. type: tbl table
1681 #: build/C/man4/console_codes.4:274
1682 #, no-wrap
1683 msgid "38\tset underscore on, set default foreground color\n"
1684 msgstr ""
1685
1686 #. type: tbl table
1687 #: build/C/man4/console_codes.4:275
1688 #, no-wrap
1689 msgid "39\tset underscore off, set default foreground color\n"
1690 msgstr ""
1691
1692 #. type: tbl table
1693 #: build/C/man4/console_codes.4:276
1694 #, no-wrap
1695 msgid "40\tset black background\n"
1696 msgstr ""
1697
1698 #. type: tbl table
1699 #: build/C/man4/console_codes.4:277
1700 #, no-wrap
1701 msgid "41\tset red background\n"
1702 msgstr ""
1703
1704 #. type: tbl table
1705 #: build/C/man4/console_codes.4:278
1706 #, no-wrap
1707 msgid "42\tset green background\n"
1708 msgstr ""
1709
1710 #. type: tbl table
1711 #: build/C/man4/console_codes.4:279
1712 #, no-wrap
1713 msgid "43\tset brown background\n"
1714 msgstr ""
1715
1716 #. type: tbl table
1717 #: build/C/man4/console_codes.4:280
1718 #, no-wrap
1719 msgid "44\tset blue background\n"
1720 msgstr ""
1721
1722 #. type: tbl table
1723 #: build/C/man4/console_codes.4:281
1724 #, no-wrap
1725 msgid "45\tset magenta background\n"
1726 msgstr ""
1727
1728 #. type: tbl table
1729 #: build/C/man4/console_codes.4:282
1730 #, no-wrap
1731 msgid "46\tset cyan background\n"
1732 msgstr ""
1733
1734 #. type: tbl table
1735 #: build/C/man4/console_codes.4:283
1736 #, no-wrap
1737 msgid "47\tset white background\n"
1738 msgstr ""
1739
1740 #. type: tbl table
1741 #: build/C/man4/console_codes.4:284
1742 #, no-wrap
1743 msgid "49\tset default background color\n"
1744 msgstr ""
1745
1746 #. type: Plain text
1747 #: build/C/man4/console_codes.4:288
1748 msgid "B<ECMA-48 Mode Switches>"
1749 msgstr ""
1750
1751 #. type: TP
1752 #: build/C/man4/console_codes.4:288
1753 #, no-wrap
1754 msgid "ESC [ 3 h"
1755 msgstr ""
1756
1757 #. type: Plain text
1758 #: build/C/man4/console_codes.4:291
1759 msgid "DECCRM (default off): Display control chars."
1760 msgstr ""
1761
1762 #. type: TP
1763 #: build/C/man4/console_codes.4:291
1764 #, no-wrap
1765 msgid "ESC [ 4 h"
1766 msgstr ""
1767
1768 #. type: Plain text
1769 #: build/C/man4/console_codes.4:294
1770 msgid "DECIM (default off): Set insert mode."
1771 msgstr ""
1772
1773 #. type: TP
1774 #: build/C/man4/console_codes.4:294
1775 #, no-wrap
1776 msgid "ESC [ 20 h"
1777 msgstr ""
1778
1779 #. type: Plain text
1780 #: build/C/man4/console_codes.4:298
1781 msgid "LF/NL (default off): Automatically follow echo of LF, VT or FF with CR."
1782 msgstr ""
1783
1784 #. type: Plain text
1785 #: build/C/man4/console_codes.4:301
1786 msgid "B<ECMA-48 Status Report Commands>"
1787 msgstr ""
1788
1789 #. type: TP
1790 #: build/C/man4/console_codes.4:301
1791 #, no-wrap
1792 msgid "ESC [ 5 n"
1793 msgstr ""
1794
1795 #. type: Plain text
1796 #: build/C/man4/console_codes.4:304
1797 msgid "Device status report (DSR): Answer is ESC [ 0 n (Terminal OK)."
1798 msgstr ""
1799
1800 #. type: TP
1801 #: build/C/man4/console_codes.4:304
1802 #, no-wrap
1803 msgid "ESC [ 6 n"
1804 msgstr ""
1805
1806 #. type: Plain text
1807 #: build/C/man4/console_codes.4:309
1808 msgid ""
1809 "Cursor position report (CPR): Answer is ESC [ I<y> ; I<x> R, where I<x,y> is "
1810 "the cursor location."
1811 msgstr ""
1812
1813 #. type: Plain text
1814 #: build/C/man4/console_codes.4:311
1815 msgid "B<DEC Private Mode (DECSET/DECRST) sequences>"
1816 msgstr ""
1817
1818 #. type: Plain text
1819 #: build/C/man4/console_codes.4:317
1820 msgid ""
1821 "These are not described in ECMA-48.  We list the Set Mode sequences; the "
1822 "Reset Mode sequences are obtained by replacing the final \\(aqh\\(aq by "
1823 "\\(aql\\(aq."
1824 msgstr ""
1825
1826 #. type: TP
1827 #: build/C/man4/console_codes.4:317
1828 #, no-wrap
1829 msgid "ESC [ ? 1 h"
1830 msgstr ""
1831
1832 #. type: Plain text
1833 #: build/C/man4/console_codes.4:321
1834 msgid ""
1835 "DECCKM (default off): When set, the cursor keys send an ESC O prefix, rather "
1836 "than ESC [."
1837 msgstr ""
1838
1839 #. type: TP
1840 #: build/C/man4/console_codes.4:321
1841 #, no-wrap
1842 msgid "ESC [ ? 3 h"
1843 msgstr ""
1844
1845 #. type: Plain text
1846 #: build/C/man4/console_codes.4:328
1847 msgid ""
1848 "DECCOLM (default off = 80 columns): 80/132 col mode switch.  The driver "
1849 "sources note that this alone does not suffice; some user-mode utility such "
1850 "as B<resizecons>(8)  has to change the hardware registers on the console "
1851 "video card."
1852 msgstr ""
1853
1854 #. type: TP
1855 #: build/C/man4/console_codes.4:328
1856 #, no-wrap
1857 msgid "ESC [ ? 5 h"
1858 msgstr ""
1859
1860 #. type: Plain text
1861 #: build/C/man4/console_codes.4:331
1862 msgid "DECSCNM (default off): Set reverse-video mode."
1863 msgstr ""
1864
1865 #. type: TP
1866 #: build/C/man4/console_codes.4:331
1867 #, no-wrap
1868 msgid "ESC [ ? 6 h"
1869 msgstr ""
1870
1871 #. type: Plain text
1872 #: build/C/man4/console_codes.4:335
1873 msgid ""
1874 "DECOM (default off): When set, cursor addressing is relative to the upper "
1875 "left corner of the scrolling region."
1876 msgstr ""
1877
1878 #. type: TP
1879 #: build/C/man4/console_codes.4:335
1880 #, no-wrap
1881 msgid "ESC [ ? 7 h"
1882 msgstr ""
1883
1884 #. type: Plain text
1885 #: build/C/man4/console_codes.4:341
1886 msgid ""
1887 "DECAWM (default on): Set autowrap on.  In this mode, a graphic character "
1888 "emitted after column 80 (or column 132 of DECCOLM is on)  forces a wrap to "
1889 "the beginning of the following line first."
1890 msgstr ""
1891
1892 #. type: TP
1893 #: build/C/man4/console_codes.4:341
1894 #, no-wrap
1895 msgid "ESC [ ? 8 h"
1896 msgstr ""
1897
1898 #. type: Plain text
1899 #: build/C/man4/console_codes.4:344
1900 msgid "DECARM (default on): Set keyboard autorepeat on."
1901 msgstr ""
1902
1903 #. type: TP
1904 #: build/C/man4/console_codes.4:344
1905 #, no-wrap
1906 msgid "ESC [ ? 9 h"
1907 msgstr ""
1908
1909 #. type: Plain text
1910 #: build/C/man4/console_codes.4:348
1911 msgid ""
1912 "X10 Mouse Reporting (default off): Set reporting mode to 1 (or reset to "
1913 "0)\\(emsee below."
1914 msgstr ""
1915
1916 #. type: TP
1917 #: build/C/man4/console_codes.4:348
1918 #, no-wrap
1919 msgid "ESC [ ? 25 h"
1920 msgstr ""
1921
1922 #. type: Plain text
1923 #: build/C/man4/console_codes.4:351
1924 msgid "DECTECM (default on): Make cursor visible."
1925 msgstr ""
1926
1927 #. type: TP
1928 #: build/C/man4/console_codes.4:351
1929 #, no-wrap
1930 msgid "ESC [ ? 1000 h"
1931 msgstr ""
1932
1933 #. type: Plain text
1934 #: build/C/man4/console_codes.4:356
1935 msgid ""
1936 "X11 Mouse Reporting (default off): Set reporting mode to 2 (or reset to "
1937 "0)\\(emsee below."
1938 msgstr ""
1939
1940 #. type: Plain text
1941 #: build/C/man4/console_codes.4:358
1942 msgid "B<Linux Console Private CSI Sequences>"
1943 msgstr ""
1944
1945 #. type: Plain text
1946 #: build/C/man4/console_codes.4:365
1947 msgid ""
1948 "The following sequences are neither ECMA-48 nor native VT102.  They are "
1949 "native to the Linux console driver.  Colors are in SGR parameters: 0 = "
1950 "black, 1 = red, 2 = green, 3 = brown, 4 = blue, 5 = magenta, 6 = cyan, 7 = "
1951 "white."
1952 msgstr ""
1953
1954 #. type: tbl table
1955 #: build/C/man4/console_codes.4:367
1956 #, no-wrap
1957 msgid "ESC [ 1 ; I<n> ]\tSet color I<n> as the underline color\n"
1958 msgstr ""
1959
1960 #. type: tbl table
1961 #: build/C/man4/console_codes.4:368
1962 #, no-wrap
1963 msgid "ESC [ 2 ; I<n> ]\tSet color I<n> as the dim color\n"
1964 msgstr ""
1965
1966 #. type: tbl table
1967 #: build/C/man4/console_codes.4:369
1968 #, no-wrap
1969 msgid "ESC [ 8 ]       \tMake the current color pair the default attributes.\n"
1970 msgstr ""
1971
1972 #. type: tbl table
1973 #: build/C/man4/console_codes.4:370
1974 #, no-wrap
1975 msgid "ESC [ 9 ; I<n> ]\tSet screen blank timeout to I<n> minutes.\n"
1976 msgstr ""
1977
1978 #. type: tbl table
1979 #: build/C/man4/console_codes.4:371
1980 #, no-wrap
1981 msgid "ESC [ 10 ; I<n> ]\tSet bell frequency in Hz.\n"
1982 msgstr ""
1983
1984 #. type: tbl table
1985 #: build/C/man4/console_codes.4:372
1986 #, no-wrap
1987 msgid "ESC [ 11 ; I<n> ]\tSet bell duration in msec.\n"
1988 msgstr ""
1989
1990 #. type: tbl table
1991 #: build/C/man4/console_codes.4:373
1992 #, no-wrap
1993 msgid "ESC [ 12 ; I<n> ]\tBring specified console to the front.\n"
1994 msgstr ""
1995
1996 #. type: tbl table
1997 #: build/C/man4/console_codes.4:374
1998 #, no-wrap
1999 msgid "ESC [ 13 ]      \tUnblank the screen.\n"
2000 msgstr ""
2001
2002 #. type: tbl table
2003 #: build/C/man4/console_codes.4:375
2004 #, no-wrap
2005 msgid "ESC [ 14 ; I<n> ]   \tSet the VESA powerdown interval in minutes.\n"
2006 msgstr ""
2007
2008 #. type: SS
2009 #: build/C/man4/console_codes.4:377
2010 #, no-wrap
2011 msgid "Character sets"
2012 msgstr ""
2013
2014 #. type: Plain text
2015 #: build/C/man4/console_codes.4:382
2016 msgid ""
2017 "The kernel knows about 4 translations of bytes into console-screen symbols.  "
2018 "The four tables are: a) Latin1 -E<gt> PC, b) VT100 graphics -E<gt> PC, c) PC "
2019 "-E<gt> PC, d) user-defined."
2020 msgstr ""
2021
2022 #. type: Plain text
2023 #: build/C/man4/console_codes.4:388
2024 msgid ""
2025 "There are two character sets, called G0 and G1, and one of them is the "
2026 "current character set.  (Initially G0.)  Typing B<^N> causes G1 to become "
2027 "current, B<^O> causes G0 to become current."
2028 msgstr ""
2029
2030 #. type: Plain text
2031 #: build/C/man4/console_codes.4:396
2032 msgid ""
2033 "These variables G0 and G1 point at a translation table, and can be changed "
2034 "by the user.  Initially they point at tables a) and b), respectively.  The "
2035 "sequences ESC ( B and ESC ( 0 and ESC ( U and ESC ( K cause G0 to point at "
2036 "translation table a), b), c) and d), respectively.  The sequences ESC ) B "
2037 "and ESC ) 0 and ESC ) U and ESC ) K cause G1 to point at translation table "
2038 "a), b), c) and d), respectively."
2039 msgstr ""
2040
2041 #. type: Plain text
2042 #: build/C/man4/console_codes.4:406
2043 msgid ""
2044 "The sequence ESC c causes a terminal reset, which is what you want if the "
2045 "screen is all garbled.  The oft-advised \"echo ^V^O\" will make only G0 "
2046 "current, but there is no guarantee that G0 points at table a).  In some "
2047 "distributions there is a program B<reset>(1)  that just does \"echo ^[c\".  "
2048 "If your terminfo entry for the console is correct (and has an entry "
2049 "rs1=\\eEc), then \"tput reset\" will also work."
2050 msgstr ""
2051
2052 #. type: Plain text
2053 #: build/C/man4/console_codes.4:414
2054 msgid ""
2055 "The user-defined mapping table can be set using B<mapscrn>(8).  The result "
2056 "of the mapping is that if a symbol c is printed, the symbol s = map[c] is "
2057 "sent to the video memory.  The bitmap that corresponds to s is found in the "
2058 "character ROM, and can be changed using B<setfont>(8)."
2059 msgstr ""
2060
2061 #. type: SS
2062 #: build/C/man4/console_codes.4:414
2063 #, no-wrap
2064 msgid "Mouse tracking"
2065 msgstr ""
2066
2067 #. type: Plain text
2068 #: build/C/man4/console_codes.4:426
2069 msgid ""
2070 "The mouse tracking facility is intended to return B<xterm>(1)-compatible "
2071 "mouse status reports.  Because the console driver has no way to know the "
2072 "device or type of the mouse, these reports are returned in the console input "
2073 "stream only when the virtual terminal driver receives a mouse update ioctl.  "
2074 "These ioctls must be generated by a mouse-aware user-mode application such "
2075 "as the B<gpm>(8)  daemon."
2076 msgstr ""
2077
2078 #. type: Plain text
2079 #: build/C/man4/console_codes.4:432
2080 msgid ""
2081 "The mouse tracking escape sequences generated by B<xterm>(1) encode numeric "
2082 "parameters in a single character as I<value>+040.  For example, \\(aq!\\(aq "
2083 "is 1.  The screen coordinate system is 1-based."
2084 msgstr ""
2085
2086 #. type: Plain text
2087 #: build/C/man4/console_codes.4:442
2088 msgid ""
2089 "The X10 compatibility mode sends an escape sequence on button press encoding "
2090 "the location and the mouse button pressed.  It is enabled by sending ESC [ ? "
2091 "9 h and disabled with ESC [ ? 9 l.  On button press, B<xterm>(1) sends ESC [ "
2092 "M I<bxy> (6 characters).  Here I<b> is button-1, and I<x> and I<y> are the x "
2093 "and y coordinates of the mouse when the button was pressed.  This is the "
2094 "same code the kernel also produces."
2095 msgstr ""
2096
2097 #. type: Plain text
2098 #: build/C/man4/console_codes.4:457
2099 msgid ""
2100 "Normal tracking mode (not implemented in Linux 2.0.24) sends an escape "
2101 "sequence on both button press and release.  Modifier information is also "
2102 "sent.  It is enabled by sending ESC [ ? 1000 h and disabled with ESC [ ? "
2103 "1000 l.  On button press or release, B<xterm>(1) sends ESC [ M I<bxy>.  The "
2104 "low two bits of I<b> encode button information: 0=MB1 pressed, 1=MB2 "
2105 "pressed, 2=MB3 pressed, 3=release.  The upper bits encode what modifiers "
2106 "were down when the button was pressed and are added together: 4=Shift, "
2107 "8=Meta, 16=Control.  Again I<x> and I<y> are the x and y coordinates of the "
2108 "mouse event.  The upper left corner is (1,1)."
2109 msgstr ""
2110
2111 #. type: SS
2112 #: build/C/man4/console_codes.4:457
2113 #, no-wrap
2114 msgid "Comparisons with other terminals"
2115 msgstr ""
2116
2117 #. type: Plain text
2118 #: build/C/man4/console_codes.4:464
2119 msgid ""
2120 "Many different terminal types are described, like the Linux console, as "
2121 "being \"VT100-compatible\".  Here we discuss differences between the Linux "
2122 "console and the two most important others, the DEC VT102 and B<xterm>(1)."
2123 msgstr ""
2124
2125 #. type: Plain text
2126 #: build/C/man4/console_codes.4:466
2127 msgid "B<Control-character handling>"
2128 msgstr ""
2129
2130 #. type: Plain text
2131 #: build/C/man4/console_codes.4:468
2132 msgid "The VT102 also recognized the following control characters:"
2133 msgstr ""
2134
2135 #. type: Plain text
2136 #: build/C/man4/console_codes.4:470
2137 msgid "NUL (0x00) was ignored;"
2138 msgstr ""
2139
2140 #. type: Plain text
2141 #: build/C/man4/console_codes.4:472
2142 msgid "ENQ (0x05) triggered an answerback message;"
2143 msgstr ""
2144
2145 #. type: Plain text
2146 #: build/C/man4/console_codes.4:474
2147 msgid "DC1 (0x11, B<^Q>, XON) resumed transmission;"
2148 msgstr ""
2149
2150 #. type: Plain text
2151 #: build/C/man4/console_codes.4:477
2152 msgid ""
2153 "DC3 (0x13, B<^S>, XOFF) caused VT100 to ignore (and stop transmitting)  all "
2154 "codes except XOFF and XON."
2155 msgstr ""
2156
2157 #. type: Plain text
2158 #: build/C/man4/console_codes.4:479
2159 msgid "VT100-like DC1/DC3 processing may be enabled by the terminal driver."
2160 msgstr ""
2161
2162 #. type: Plain text
2163 #: build/C/man4/console_codes.4:485
2164 msgid ""
2165 "The B<xterm>(1)  program (in VT100 mode) recognizes the control characters "
2166 "BEL, BS, HT, LF, VT, FF, CR, SO, SI, ESC."
2167 msgstr ""
2168
2169 #. type: Plain text
2170 #: build/C/man4/console_codes.4:487
2171 msgid "B<Escape sequences>"
2172 msgstr ""
2173
2174 #. type: Plain text
2175 #: build/C/man4/console_codes.4:489
2176 msgid "VT100 console sequences not implemented on the Linux console:"
2177 msgstr ""
2178
2179 #. type: tbl table
2180 #: build/C/man4/console_codes.4:491
2181 #, no-wrap
2182 msgid "ESC N\tSS2\tSingle shift 2. (Select G2 character set for the next\n"
2183 msgstr ""
2184
2185 #. type: tbl table
2186 #: build/C/man4/console_codes.4:492 build/C/man4/console_codes.4:494
2187 #, no-wrap
2188 msgid "\t\tcharacter only.)\n"
2189 msgstr ""
2190
2191 #. type: tbl table
2192 #: build/C/man4/console_codes.4:493
2193 #, no-wrap
2194 msgid "ESC O\tSS3\tSingle shift 3. (Select G3 character set for the next\n"
2195 msgstr ""
2196
2197 #. type: tbl table
2198 #: build/C/man4/console_codes.4:495
2199 #, no-wrap
2200 msgid "ESC P\tDCS\tDevice control string (ended by ESC \\e)\n"
2201 msgstr ""
2202
2203 #. type: tbl table
2204 #: build/C/man4/console_codes.4:496
2205 #, no-wrap
2206 msgid "ESC X\tSOS\tStart of string.\n"
2207 msgstr ""
2208
2209 #. type: tbl table
2210 #: build/C/man4/console_codes.4:497
2211 #, no-wrap
2212 msgid "ESC ^\tPM\tPrivacy message (ended by ESC \\e)\n"
2213 msgstr ""
2214
2215 #. type: tbl table
2216 #: build/C/man4/console_codes.4:498
2217 #, no-wrap
2218 msgid "ESC \\e\tST\tString terminator\n"
2219 msgstr ""
2220
2221 #. type: tbl table
2222 #: build/C/man4/console_codes.4:499
2223 #, no-wrap
2224 msgid "ESC * ...\t\tDesignate G2 character set\n"
2225 msgstr ""
2226
2227 #. type: tbl table
2228 #: build/C/man4/console_codes.4:500
2229 #, no-wrap
2230 msgid "ESC + ...\t\tDesignate G3 character set\n"
2231 msgstr ""
2232
2233 #. type: Plain text
2234 #: build/C/man4/console_codes.4:513
2235 msgid ""
2236 "The program B<xterm>(1)  (in VT100 mode) recognizes ESC c, ESC # 8, ESC "
2237 "E<gt>, ESC =, ESC D, ESC E, ESC H, ESC M, ESC N, ESC O, ESC P ... ESC \\e, "
2238 "ESC Z (it answers ESC [ ? 1 ; 2 c, \"I am a VT100 with advanced video "
2239 "option\")  and ESC ^ ... ESC \\e with the same meanings as indicated above.  "
2240 "It accepts ESC (, ESC ), ESC *, ESC + followed by 0, A, B for the DEC "
2241 "special character and line drawing set, UK, and US-ASCII, respectively."
2242 msgstr ""
2243
2244 #. type: Plain text
2245 #: build/C/man4/console_codes.4:517
2246 msgid ""
2247 "The user can configure B<xterm>(1) to respond to VT220-specific control "
2248 "sequences, and it will identify itself as a VT52, VT100, and up depending on "
2249 "the way it is configured and initialized."
2250 msgstr ""
2251
2252 #. type: Plain text
2253 #: build/C/man4/console_codes.4:522
2254 msgid ""
2255 "It accepts ESC ] (OSC) for the setting of certain resources.  In addition to "
2256 "the ECMA-48 string terminator (ST), B<xterm>(1) accepts a BEL to terminate "
2257 "an OSC string.  These are a few of the OSC control sequences recognized by "
2258 "B<xterm>(1):"
2259 msgstr ""
2260
2261 #. type: tbl table
2262 #: build/C/man4/console_codes.4:524
2263 #, no-wrap
2264 msgid "ESC ] 0 ; I<txt> ST\tSet icon name and window title to I<txt>.\n"
2265 msgstr ""
2266
2267 #. type: tbl table
2268 #: build/C/man4/console_codes.4:525
2269 #, no-wrap
2270 msgid "ESC ] 1 ; I<txt> ST\tSet icon name to I<txt>.\n"
2271 msgstr ""
2272
2273 #. type: tbl table
2274 #: build/C/man4/console_codes.4:526
2275 #, no-wrap
2276 msgid "ESC ] 2 ; I<txt> ST\tSet window title to I<txt>.\n"
2277 msgstr ""
2278
2279 #. type: tbl table
2280 #: build/C/man4/console_codes.4:527
2281 #, no-wrap
2282 msgid "ESC ] 4 ; I<num>; I<txt> ST\tSet ANSI color I<num> to I<txt>.\n"
2283 msgstr ""
2284
2285 #. type: tbl table
2286 #: build/C/man4/console_codes.4:528
2287 #, no-wrap
2288 msgid "ESC ] 10 ; I<txt> ST\tSet dynamic text color to I<txt>.\n"
2289 msgstr ""
2290
2291 #. type: tbl table
2292 #: build/C/man4/console_codes.4:529
2293 #, no-wrap
2294 msgid "ESC ] 4 6 ; I<name> ST\tChange log file to I<name> (normally disabled\n"
2295 msgstr ""
2296
2297 #. type: tbl table
2298 #: build/C/man4/console_codes.4:530
2299 #, no-wrap
2300 msgid "\tby a compile-time option)\n"
2301 msgstr ""
2302
2303 #. type: tbl table
2304 #: build/C/man4/console_codes.4:531
2305 #, no-wrap
2306 msgid "ESC ] 5 0 ; I<fn> ST\tSet font to I<fn>.\n"
2307 msgstr ""
2308
2309 #. type: Plain text
2310 #: build/C/man4/console_codes.4:536
2311 msgid ""
2312 "It recognizes the following with slightly modified meaning (saving more "
2313 "state, behaving closer to VT100/VT220):"
2314 msgstr ""
2315
2316 #. type: tbl table
2317 #: build/C/man4/console_codes.4:538
2318 #, no-wrap
2319 msgid "ESC 7  DECSC\tSave cursor\n"
2320 msgstr ""
2321
2322 #. type: tbl table
2323 #: build/C/man4/console_codes.4:539
2324 #, no-wrap
2325 msgid "ESC 8  DECRC\tRestore cursor\n"
2326 msgstr ""
2327
2328 #. type: Plain text
2329 #: build/C/man4/console_codes.4:543
2330 msgid "It also recognizes"
2331 msgstr ""
2332
2333 #. type: tbl table
2334 #: build/C/man4/console_codes.4:545
2335 #, no-wrap
2336 msgid "ESC F\t\tCursor to lower left corner of screen (if enabled by\n"
2337 msgstr ""
2338
2339 #. type: tbl table
2340 #: build/C/man4/console_codes.4:546
2341 #, no-wrap
2342 msgid "\t\tB<xterm>(1)'s B<hpLowerleftBugCompat> resource)\n"
2343 msgstr ""
2344
2345 #. type: tbl table
2346 #: build/C/man4/console_codes.4:547
2347 #, no-wrap
2348 msgid "ESC l\t\tMemory lock (per HP terminals).\n"
2349 msgstr ""
2350
2351 #. type: tbl table
2352 #: build/C/man4/console_codes.4:548
2353 #, no-wrap
2354 msgid "\t\tLocks memory above the cursor.\n"
2355 msgstr ""
2356
2357 #. type: tbl table
2358 #: build/C/man4/console_codes.4:549
2359 #, no-wrap
2360 msgid "ESC m\t\tMemory unlock (per HP terminals).\n"
2361 msgstr ""
2362
2363 #. type: tbl table
2364 #: build/C/man4/console_codes.4:550
2365 #, no-wrap
2366 msgid "ESC n\tLS2\tInvoke the G2 character set.\n"
2367 msgstr ""
2368
2369 #. type: tbl table
2370 #: build/C/man4/console_codes.4:551
2371 #, no-wrap
2372 msgid "ESC o\tLS3\tInvoke the G3 character set.\n"
2373 msgstr ""
2374
2375 #. type: tbl table
2376 #: build/C/man4/console_codes.4:552
2377 #, no-wrap
2378 msgid "ESC |\tLS3R\tInvoke the G3 character set as GR.\n"
2379 msgstr ""
2380
2381 #. type: tbl table
2382 #: build/C/man4/console_codes.4:553
2383 #, no-wrap
2384 msgid "ESC }\tLS2R\tInvoke the G2 character set as GR.\n"
2385 msgstr ""
2386
2387 #. type: tbl table
2388 #: build/C/man4/console_codes.4:554
2389 #, no-wrap
2390 msgid "ESC ~\tLS1R\tInvoke the G1 character set as GR.\n"
2391 msgstr ""
2392
2393 #. type: Plain text
2394 #: build/C/man4/console_codes.4:560
2395 msgid ""
2396 "It also recognizes ESC % and provides a more complete UTF-8 implementation "
2397 "than Linux console."
2398 msgstr ""
2399
2400 #. type: Plain text
2401 #: build/C/man4/console_codes.4:562
2402 msgid "B<CSI Sequences>"
2403 msgstr ""
2404
2405 #. type: Plain text
2406 #: build/C/man4/console_codes.4:576
2407 msgid ""
2408 "Old versions of B<xterm>(1), for example, from X11R5, interpret the blink "
2409 "SGR as a bold SGR.  Later versions which implemented ANSI colors, for "
2410 "example, XFree86 3.1.2A in 1995, improved this by allowing the blink "
2411 "attribute to be displayed as a color.  Modern versions of xterm implement "
2412 "blink SGR as blinking text and still allow colored text as an alternate "
2413 "rendering of SGRs.  Stock X11R6 versions did not recognize the color-setting "
2414 "SGRs until the X11R6.8 release, which incorporated XFree86 xterm.  All "
2415 "ECMA-48 CSI sequences recognized by Linux are also recognized by I<xterm>, "
2416 "however B<xterm>(1) implements several ECMA-48 and DEC control sequences not "
2417 "recognized by Linux."
2418 msgstr ""
2419
2420 #. type: Plain text
2421 #: build/C/man4/console_codes.4:590
2422 msgid ""
2423 "The B<xterm>(1)  program recognizes all of the DEC Private Mode sequences "
2424 "listed above, but none of the Linux private-mode sequences.  For discussion "
2425 "of B<xterm>(1)'s own private-mode sequences, refer to the I<Xterm Control "
2426 "Sequences> document by Edward Moy, Stephen Gildea, and Thomas E. Dickey "
2427 "available with the X distribution.  That document, though terse, is much "
2428 "longer than this manual page.  For a chronological overview,"
2429 msgstr ""
2430
2431 #. type: Plain text
2432 #: build/C/man4/console_codes.4:594
2433 msgid "E<.UR http://invisible-island.net\\:/xterm\\:/xterm.log.html> E<.UE>"
2434 msgstr ""
2435
2436 #. type: Plain text
2437 #: build/C/man4/console_codes.4:597
2438 msgid "details changes to xterm."
2439 msgstr ""
2440
2441 #. type: Plain text
2442 #: build/C/man4/console_codes.4:599
2443 msgid "The I<vttest> program"
2444 msgstr ""
2445
2446 #. type: Plain text
2447 #: build/C/man4/console_codes.4:603
2448 msgid "E<.UR http://invisible-island.net\\:/vttest/> E<.UE>"
2449 msgstr ""
2450
2451 #. type: Plain text
2452 #: build/C/man4/console_codes.4:608
2453 msgid ""
2454 "demonstrates many of these control sequences.  The B<xterm>(1) source "
2455 "distribution also contains sample scripts which exercise other features."
2456 msgstr ""
2457
2458 #. type: SH
2459 #: build/C/man4/console_codes.4:608 build/C/man4/console_ioctl.4:824 build/C/man5/core.5:311 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:301 build/C/man3/syslog.3:296 build/C/man7/uri.7:592
2460 #, no-wrap
2461 msgid "NOTES"
2462 msgstr ""
2463
2464 #. type: Plain text
2465 #: build/C/man4/console_codes.4:611
2466 msgid "ESC 8 (DECRC) is not able to restore the character set changed with ESC %."
2467 msgstr ""
2468
2469 #. type: SH
2470 #: 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
2471 #, no-wrap
2472 msgid "BUGS"
2473 msgstr ""
2474
2475 #. type: Plain text
2476 #: build/C/man4/console_codes.4:614
2477 msgid "In 2.0.23, CSI is broken, and NUL is not ignored inside escape sequences."
2478 msgstr ""
2479
2480 #. type: Plain text
2481 #: build/C/man4/console_codes.4:623
2482 msgid ""
2483 "Some older kernel versions (after 2.0) interpret 8-bit control sequences.  "
2484 "These \"C1 controls\" use codes between 128 and 159 to replace ESC [, ESC ] "
2485 "and similar two-byte control sequence initiators.  There are fragments of "
2486 "that in modern kernels (either overlooked or broken by changes to support "
2487 "UTF-8), but the implementation is incomplete and should be regarded as "
2488 "unreliable."
2489 msgstr ""
2490
2491 #. type: Plain text
2492 #: build/C/man4/console_codes.4:638
2493 msgid ""
2494 "Linux \"private mode\" sequences do not follow the rules in ECMA-48 for "
2495 "private mode control sequences.  In particular, those ending with ] do not "
2496 "use a standard terminating character.  The OSC (set palette) sequence is a "
2497 "greater problem, since B<xterm>(1) may interpret this as a control sequence "
2498 "which requires a string terminator (ST).  Unlike the B<setterm>(1) sequences "
2499 "which will be ignored (since they are invalid control sequences), the "
2500 "palette sequence will make B<xterm>(1) appear to hang (though pressing the "
2501 "return-key will fix that).  To accommodate applications which have been "
2502 "hardcoded to use Linux control sequences, set the B<xterm>(1) resource "
2503 "B<brokenLinuxOSC> to true."
2504 msgstr ""
2505
2506 #. type: Plain text
2507 #: build/C/man4/console_codes.4:642
2508 msgid ""
2509 "An older version of this document implied that Linux recognizes the ECMA-48 "
2510 "control sequence for invisible text.  It is ignored."
2511 msgstr ""
2512
2513 #. type: Plain text
2514 #: build/C/man4/console_codes.4:646
2515 msgid "B<console>(4), B<console_ioctl>(4), B<charsets>(7)"
2516 msgstr ""
2517
2518 #. type: TH
2519 #: build/C/man4/console_ioctl.4:40
2520 #, no-wrap
2521 msgid "CONSOLE_IOCTL"
2522 msgstr ""
2523
2524 #. type: TH
2525 #: build/C/man4/console_ioctl.4:40
2526 #, no-wrap
2527 msgid "2009-02-28"
2528 msgstr ""
2529
2530 #. type: Plain text
2531 #: build/C/man4/console_ioctl.4:43
2532 msgid "console_ioctl - ioctls for console terminal and virtual consoles"
2533 msgstr ""
2534
2535 #. type: Plain text
2536 #: build/C/man4/console_ioctl.4:49
2537 msgid ""
2538 "The following Linux-specific B<ioctl>(2)  requests are supported.  Each "
2539 "requires a third argument, assumed here to be I<argp>."
2540 msgstr ""
2541
2542 #. type: TP
2543 #: build/C/man4/console_ioctl.4:49
2544 #, no-wrap
2545 msgid "B<KDGETLED>"
2546 msgstr ""
2547
2548 #. type: Plain text
2549 #: build/C/man4/console_ioctl.4:59
2550 msgid ""
2551 "Get state of LEDs.  I<argp> points to a I<char>.  The lower three bits of "
2552 "I<*argp> are set to the state of the LEDs, as follows:"
2553 msgstr ""
2554
2555 #. type: tbl table
2556 #: build/C/man4/console_ioctl.4:61
2557 #, no-wrap
2558 msgid "LED_CAP \t0x04\tcaps lock led\n"
2559 msgstr ""
2560
2561 #. type: tbl table
2562 #: build/C/man4/console_ioctl.4:62
2563 #, no-wrap
2564 msgid "LEC_NUM \t0x02\tnum lock led\n"
2565 msgstr ""
2566
2567 #. type: tbl table
2568 #: build/C/man4/console_ioctl.4:63
2569 #, no-wrap
2570 msgid "LED_SCR \t0x01\tscroll lock led\n"
2571 msgstr ""
2572
2573 #. type: TP
2574 #: build/C/man4/console_ioctl.4:65
2575 #, no-wrap
2576 msgid "B<KDSETLED>"
2577 msgstr ""
2578
2579 #. type: Plain text
2580 #: build/C/man4/console_ioctl.4:73
2581 msgid ""
2582 "Set the LEDs.  The LEDs are set to correspond to the lower three bits of "
2583 "I<argp>.  However, if a higher order bit is set, the LEDs revert to normal: "
2584 "displaying the state of the keyboard functions of caps lock, num lock, and "
2585 "scroll lock."
2586 msgstr ""
2587
2588 #. type: Plain text
2589 #: build/C/man4/console_ioctl.4:80
2590 msgid ""
2591 "Before 1.1.54, the LEDs just reflected the state of the corresponding "
2592 "keyboard flags, and KDGETLED/KDSETLED would also change the keyboard flags.  "
2593 "Since 1.1.54 the LEDs can be made to display arbitrary information, but by "
2594 "default they display the keyboard flags.  The following two ioctls are used "
2595 "to access the keyboard flags."
2596 msgstr ""
2597
2598 #. type: TP
2599 #: build/C/man4/console_ioctl.4:80
2600 #, no-wrap
2601 msgid "B<KDGKBLED>"
2602 msgstr ""
2603
2604 #. type: Plain text
2605 #: build/C/man4/console_ioctl.4:89
2606 msgid ""
2607 "Get keyboard flags CapsLock, NumLock, ScrollLock (not lights).  I<argp> "
2608 "points to a char which is set to the flag state.  The low order three bits "
2609 "(mask 0x7) get the current flag state, and the low order bits of the next "
2610 "nibble (mask 0x70) get the default flag state.  (Since 1.1.54.)"
2611 msgstr ""
2612
2613 #. type: TP
2614 #: build/C/man4/console_ioctl.4:89
2615 #, no-wrap
2616 msgid "B<KDSKBLED>"
2617 msgstr ""
2618
2619 #. type: Plain text
2620 #: build/C/man4/console_ioctl.4:98
2621 msgid ""
2622 "Set keyboard flags CapsLock, NumLock, ScrollLock (not lights).  I<argp> has "
2623 "the desired flag state.  The low order three bits (mask 0x7) have the flag "
2624 "state, and the low order bits of the next nibble (mask 0x70) have the "
2625 "default flag state.  (Since 1.1.54.)"
2626 msgstr ""
2627
2628 #. type: TP
2629 #: build/C/man4/console_ioctl.4:98
2630 #, no-wrap
2631 msgid "B<KDGKBTYPE>"
2632 msgstr ""
2633
2634 #. type: Plain text
2635 #: build/C/man4/console_ioctl.4:102
2636 msgid "Get keyboard type.  This returns the value KB_101, defined as 0x02."
2637 msgstr ""
2638
2639 #. type: TP
2640 #: build/C/man4/console_ioctl.4:102
2641 #, no-wrap
2642 msgid "B<KDADDIO>"
2643 msgstr ""
2644
2645 #. type: Plain text
2646 #: build/C/man4/console_ioctl.4:107
2647 msgid "Add I/O port as valid.  Equivalent to I<ioperm(arg,1,1)>."
2648 msgstr ""
2649
2650 #. type: TP
2651 #: build/C/man4/console_ioctl.4:107
2652 #, no-wrap
2653 msgid "B<KDDELIO>"
2654 msgstr ""
2655
2656 #. type: Plain text
2657 #: build/C/man4/console_ioctl.4:112
2658 msgid "Delete I/O port as valid.  Equivalent to I<ioperm(arg,1,0)>."
2659 msgstr ""
2660
2661 #. type: TP
2662 #: build/C/man4/console_ioctl.4:112
2663 #, no-wrap
2664 msgid "B<KDENABIO>"
2665 msgstr ""
2666
2667 #. type: Plain text
2668 #: build/C/man4/console_ioctl.4:117
2669 msgid ""
2670 "Enable I/O to video board.  Equivalent to I<ioperm(0x3b4, 0x3df-0x3b4+1, "
2671 "1)>."
2672 msgstr ""
2673
2674 #. type: TP
2675 #: build/C/man4/console_ioctl.4:117
2676 #, no-wrap
2677 msgid "B<KDDISABIO>"
2678 msgstr ""
2679
2680 #. type: Plain text
2681 #: build/C/man4/console_ioctl.4:122
2682 msgid ""
2683 "Disable I/O to video board.  Equivalent to I<ioperm(0x3b4, 0x3df-0x3b4+1, "
2684 "0)>."
2685 msgstr ""
2686
2687 #. type: TP
2688 #: build/C/man4/console_ioctl.4:122
2689 #, no-wrap
2690 msgid "B<KDSETMODE>"
2691 msgstr ""
2692
2693 #. type: Plain text
2694 #: build/C/man4/console_ioctl.4:127
2695 msgid "Set text/graphics mode.  I<argp> is one of these:"
2696 msgstr ""
2697
2698 #. type: tbl table
2699 #: build/C/man4/console_ioctl.4:130
2700 #, no-wrap
2701 msgid "KD_TEXT\t0x00\n"
2702 msgstr ""
2703
2704 #. type: tbl table
2705 #: build/C/man4/console_ioctl.4:131
2706 #, no-wrap
2707 msgid "KD_GRAPHICS\t0x01\n"
2708 msgstr ""
2709
2710 #. type: TP
2711 #: build/C/man4/console_ioctl.4:133
2712 #, no-wrap
2713 msgid "B<KDGETMODE>"
2714 msgstr ""
2715
2716 #. type: Plain text
2717 #: build/C/man4/console_ioctl.4:141
2718 msgid ""
2719 "Get text/graphics mode.  I<argp> points to a I<long> which is set to one of "
2720 "the above values."
2721 msgstr ""
2722
2723 #. type: TP
2724 #: build/C/man4/console_ioctl.4:141
2725 #, no-wrap
2726 msgid "B<KDMKTONE>"
2727 msgstr ""
2728
2729 #. type: Plain text
2730 #: build/C/man4/console_ioctl.4:155
2731 msgid ""
2732 "Generate tone of specified length.  The lower 16 bits of I<argp> specify the "
2733 "period in clock cycles, and the upper 16 bits give the duration in msec.  If "
2734 "the duration is zero, the sound is turned off.  Control returns "
2735 "immediately.  For example, I<argp> = (125E<lt>E<lt>16) + 0x637 would specify "
2736 "the beep normally associated with a ctrl-G.  (Thus since 0.99pl1; broken in "
2737 "2.1.49-50.)"
2738 msgstr ""
2739
2740 #. type: TP
2741 #: build/C/man4/console_ioctl.4:155
2742 #, no-wrap
2743 msgid "B<KIOCSOUND>"
2744 msgstr ""
2745
2746 #. type: Plain text
2747 #: build/C/man4/console_ioctl.4:167
2748 msgid ""
2749 "Start or stop sound generation.  The lower 16 bits of I<argp> specify the "
2750 "period in clock cycles (that is, I<argp> = 1193180/frequency).  I<argp> = 0 "
2751 "turns sound off.  In either case, control returns immediately."
2752 msgstr ""
2753
2754 #. type: TP
2755 #: build/C/man4/console_ioctl.4:167
2756 #, no-wrap
2757 msgid "B<GIO_CMAP>"
2758 msgstr ""
2759
2760 #. type: Plain text
2761 #: build/C/man4/console_ioctl.4:174
2762 msgid ""
2763 "Get the current default color map from kernel.  I<argp> points to a 48-byte "
2764 "array.  (Since 1.3.3.)"
2765 msgstr ""
2766
2767 #. type: TP
2768 #: build/C/man4/console_ioctl.4:174
2769 #, no-wrap
2770 msgid "B<PIO_CMAP>"
2771 msgstr ""
2772
2773 #. type: Plain text
2774 #: build/C/man4/console_ioctl.4:187
2775 msgid ""
2776 "Change the default text-mode color map.  I<argp> points to a 48-byte array "
2777 "which contains, in order, the Red, Green, and Blue values for the 16 "
2778 "available screen colors: 0 is off, and 255 is full intensity.  The default "
2779 "colors are, in order: black, dark red, dark green, brown, dark blue, dark "
2780 "purple, dark cyan, light grey, dark grey, bright red, bright green, yellow, "
2781 "bright blue, bright purple, bright cyan and white.  (Since 1.3.3.)"
2782 msgstr ""
2783
2784 #. type: TP
2785 #: build/C/man4/console_ioctl.4:187
2786 #, no-wrap
2787 msgid "B<GIO_FONT>"
2788 msgstr ""
2789
2790 #. type: Plain text
2791 #: build/C/man4/console_ioctl.4:197
2792 msgid ""
2793 "Gets 256-character screen font in expanded form.  I<argp> points to an 8192 "
2794 "byte array.  Fails with error code B<EINVAL> if the currently loaded font is "
2795 "a 512-character font, or if the console is not in text mode."
2796 msgstr ""
2797
2798 #. type: TP
2799 #: build/C/man4/console_ioctl.4:197
2800 #, no-wrap
2801 msgid "B<GIO_FONTX>"
2802 msgstr ""
2803
2804 #. type: Plain text
2805 #: build/C/man4/console_ioctl.4:225
2806 msgid ""
2807 "Gets screen font and associated information.  I<argp> points to a I<struct "
2808 "consolefontdesc> (see B<PIO_FONTX>).  On call, the I<charcount> field should "
2809 "be set to the maximum number of characters that would fit in the buffer "
2810 "pointed to by I<chardata>.  On return, the I<charcount> and I<charheight> "
2811 "are filled with the respective data for the currently loaded font, and the "
2812 "I<chardata> array contains the font data if the initial value of "
2813 "I<charcount> indicated enough space was available; otherwise the buffer is "
2814 "untouched and I<errno> is set to B<ENOMEM>.  (Since 1.3.1.)"
2815 msgstr ""
2816
2817 #. type: TP
2818 #: build/C/man4/console_ioctl.4:225
2819 #, no-wrap
2820 msgid "B<PIO_FONT>"
2821 msgstr ""
2822
2823 #. type: Plain text
2824 #: build/C/man4/console_ioctl.4:240
2825 msgid ""
2826 "Sets 256-character screen font.  Load font into the EGA/VGA character "
2827 "generator.  I<argp> points to a 8192 byte map, with 32 bytes per character.  "
2828 "Only the first I<N> of them are used for an 8xI<N> font (0 E<lt> I<N> E<lt>= "
2829 "32).  This call also invalidates the Unicode mapping."
2830 msgstr ""
2831
2832 #. type: TP
2833 #: build/C/man4/console_ioctl.4:240
2834 #, no-wrap
2835 msgid "B<PIO_FONTX>"
2836 msgstr ""
2837
2838 #. type: Plain text
2839 #: build/C/man4/console_ioctl.4:245
2840 msgid "Sets screen font and associated rendering information.  I<argp> points to a"
2841 msgstr ""
2842
2843 #. type: Plain text
2844 #: build/C/man4/console_ioctl.4:256
2845 #, no-wrap
2846 msgid ""
2847 "struct consolefontdesc {\n"
2848 "    unsigned short charcount;  /* characters in font\n"
2849 "                                  (256 or 512) */\n"
2850 "    unsigned short charheight; /* scan lines per\n"
2851 "                                  character (1-32) */\n"
2852 "    char          *chardata;   /* font data in\n"
2853 "                                  expanded form */\n"
2854 "};\n"
2855 msgstr ""
2856
2857 #. type: Plain text
2858 #: build/C/man4/console_ioctl.4:264
2859 msgid ""
2860 "If necessary, the screen will be appropriately resized, and B<SIGWINCH> sent "
2861 "to the appropriate processes.  This call also invalidates the Unicode "
2862 "mapping.  (Since 1.3.1.)"
2863 msgstr ""
2864
2865 #. type: TP
2866 #: build/C/man4/console_ioctl.4:264
2867 #, no-wrap
2868 msgid "B<PIO_FONTRESET>"
2869 msgstr ""
2870
2871 #. type: Plain text
2872 #: build/C/man4/console_ioctl.4:272
2873 msgid ""
2874 "Resets the screen font, size and Unicode mapping to the bootup defaults.  "
2875 "I<argp> is unused, but should be set to NULL to ensure compatibility with "
2876 "future versions of Linux.  (Since 1.3.28.)"
2877 msgstr ""
2878
2879 #. type: TP
2880 #: build/C/man4/console_ioctl.4:272
2881 #, no-wrap
2882 msgid "B<GIO_SCRNMAP>"
2883 msgstr ""
2884
2885 #. type: Plain text
2886 #: build/C/man4/console_ioctl.4:281
2887 msgid ""
2888 "Get screen mapping from kernel.  I<argp> points to an area of size E_TABSZ, "
2889 "which is loaded with the font positions used to display each character.  "
2890 "This call is likely to return useless information if the currently loaded "
2891 "font is more than 256 characters."
2892 msgstr ""
2893
2894 #. type: TP
2895 #: build/C/man4/console_ioctl.4:281
2896 #, no-wrap
2897 msgid "B<GIO_UNISCRNMAP>"
2898 msgstr ""
2899
2900 #. type: Plain text
2901 #: build/C/man4/console_ioctl.4:293
2902 msgid ""
2903 "Get full Unicode screen mapping from kernel.  I<argp> points to an area of "
2904 "size I<E_TABSZ*sizeof(unsigned short)>, which is loaded with the Unicodes "
2905 "each character represent.  A special set of Unicodes, starting at U+F000, "
2906 "are used to represent \"direct to font\" mappings.  (Since 1.3.1.)"
2907 msgstr ""
2908
2909 #. type: TP
2910 #: build/C/man4/console_ioctl.4:293
2911 #, no-wrap
2912 msgid "B<PIO_SCRNMAP>"
2913 msgstr ""
2914
2915 #. type: Plain text
2916 #: build/C/man4/console_ioctl.4:300
2917 msgid ""
2918 "Loads the \"user definable\" (fourth) table in the kernel which maps bytes "
2919 "into console screen symbols.  I<argp> points to an area of size E_TABSZ."
2920 msgstr ""
2921
2922 #. type: TP
2923 #: build/C/man4/console_ioctl.4:300
2924 #, no-wrap
2925 msgid "B<PIO_UNISCRNMAP>"
2926 msgstr ""
2927
2928 #. type: Plain text
2929 #: build/C/man4/console_ioctl.4:308
2930 msgid ""
2931 "Loads the \"user definable\" (fourth) table in the kernel which maps bytes "
2932 "into Unicodes, which are then translated into screen symbols according to "
2933 "the currently loaded Unicode-to-font map.  Special Unicodes starting at "
2934 "U+F000 can be used to map directly to the font symbols.  (Since 1.3.1.)"
2935 msgstr ""
2936
2937 #. type: TP
2938 #: build/C/man4/console_ioctl.4:308
2939 #, no-wrap
2940 msgid "B<GIO_UNIMAP>"
2941 msgstr ""
2942
2943 #. type: Plain text
2944 #: build/C/man4/console_ioctl.4:313
2945 msgid "Get Unicode-to-font mapping from kernel.  I<argp> points to a"
2946 msgstr ""
2947
2948 #. type: Plain text
2949 #: build/C/man4/console_ioctl.4:320
2950 #, no-wrap
2951 msgid ""
2952 "struct unimapdesc {\n"
2953 "    unsigned short  entry_ct;\n"
2954 "    struct unipair *entries;\n"
2955 "};\n"
2956 msgstr ""
2957
2958 #. type: Plain text
2959 #: build/C/man4/console_ioctl.4:326
2960 msgid "where I<entries> points to an array of"
2961 msgstr ""
2962
2963 #. type: Plain text
2964 #: build/C/man4/console_ioctl.4:333
2965 #, no-wrap
2966 msgid ""
2967 "struct unipair {\n"
2968 "    unsigned short unicode;\n"
2969 "    unsigned short fontpos;\n"
2970 "};\n"
2971 msgstr ""
2972
2973 #. type: Plain text
2974 #: build/C/man4/console_ioctl.4:337 build/C/man4/console_ioctl.4:361
2975 msgid "(Since 1.1.92.)"
2976 msgstr ""
2977
2978 #. type: TP
2979 #: build/C/man4/console_ioctl.4:337
2980 #, no-wrap
2981 msgid "B<PIO_UNIMAP>"
2982 msgstr ""
2983
2984 #. type: Plain text
2985 #: build/C/man4/console_ioctl.4:344
2986 msgid ""
2987 "Put unicode-to-font mapping in kernel.  I<argp> points to a I<struct "
2988 "unimapdesc>.  (Since 1.1.92)"
2989 msgstr ""
2990
2991 #. type: TP
2992 #: build/C/man4/console_ioctl.4:344
2993 #, no-wrap
2994 msgid "B<PIO_UNIMAPCLR>"
2995 msgstr ""
2996
2997 #. type: Plain text
2998 #: build/C/man4/console_ioctl.4:349
2999 msgid "Clear table, possibly advise hash algorithm.  I<argp> points to a"
3000 msgstr ""
3001
3002 #. type: Plain text
3003 #: build/C/man4/console_ioctl.4:357
3004 #, no-wrap
3005 msgid ""
3006 "struct unimapinit {\n"
3007 "    unsigned short advised_hashsize;  /* 0 if no opinion */\n"
3008 "    unsigned short advised_hashstep;  /* 0 if no opinion */\n"
3009 "    unsigned short advised_hashlevel; /* 0 if no opinion */\n"
3010 "};\n"
3011 msgstr ""
3012
3013 #. type: TP
3014 #: build/C/man4/console_ioctl.4:361
3015 #, no-wrap
3016 msgid "B<KDGKBMODE>"
3017 msgstr ""
3018
3019 #. type: Plain text
3020 #: build/C/man4/console_ioctl.4:369
3021 msgid ""
3022 "Gets current keyboard mode.  I<argp> points to a I<long> which is set to one "
3023 "of these:"
3024 msgstr ""
3025
3026 #. type: tbl table
3027 #: build/C/man4/console_ioctl.4:372
3028 #, no-wrap
3029 msgid "K_RAW\t0x00\n"
3030 msgstr ""
3031
3032 #. type: tbl table
3033 #: build/C/man4/console_ioctl.4:373
3034 #, no-wrap
3035 msgid "K_XLATE\t0x01\n"
3036 msgstr ""
3037
3038 #. type: tbl table
3039 #: build/C/man4/console_ioctl.4:374
3040 #, no-wrap
3041 msgid "K_MEDIUMRAW\t0x02\n"
3042 msgstr ""
3043
3044 #. type: tbl table
3045 #: build/C/man4/console_ioctl.4:375
3046 #, no-wrap
3047 msgid "K_UNICODE\t0x03\n"
3048 msgstr ""
3049
3050 #. type: TP
3051 #: build/C/man4/console_ioctl.4:377
3052 #, no-wrap
3053 msgid "B<KDSKBMODE>"
3054 msgstr ""
3055
3056 #. type: Plain text
3057 #: build/C/man4/console_ioctl.4:384
3058 msgid ""
3059 "Sets current keyboard mode.  I<argp> is a I<long> equal to one of the above "
3060 "values."
3061 msgstr ""
3062
3063 #. type: TP
3064 #: build/C/man4/console_ioctl.4:384
3065 #, no-wrap
3066 msgid "B<KDGKBMETA>"
3067 msgstr ""
3068
3069 #. type: Plain text
3070 #: build/C/man4/console_ioctl.4:392
3071 msgid ""
3072 "Gets meta key handling mode.  I<argp> points to a I<long> which is set to "
3073 "one of these:"
3074 msgstr ""
3075
3076 #. type: tbl table
3077 #: build/C/man4/console_ioctl.4:395
3078 #, no-wrap
3079 msgid "K_METABIT\t0x03\tset high order bit\n"
3080 msgstr ""
3081
3082 #. type: tbl table
3083 #: build/C/man4/console_ioctl.4:396
3084 #, no-wrap
3085 msgid "K_ESCPREFIX\t0x04\tescape prefix\n"
3086 msgstr ""
3087
3088 #. type: TP
3089 #: build/C/man4/console_ioctl.4:398
3090 #, no-wrap
3091 msgid "B<KDSKBMETA>"
3092 msgstr ""
3093
3094 #. type: Plain text
3095 #: build/C/man4/console_ioctl.4:405
3096 msgid ""
3097 "Sets meta key handling mode.  I<argp> is a I<long> equal to one of the above "
3098 "values."
3099 msgstr ""
3100
3101 #. type: TP
3102 #: build/C/man4/console_ioctl.4:405
3103 #, no-wrap
3104 msgid "B<KDGKBENT>"
3105 msgstr ""
3106
3107 #. type: Plain text
3108 #: build/C/man4/console_ioctl.4:410
3109 msgid ""
3110 "Gets one entry in key translation table (keycode to action code).  I<argp> "
3111 "points to a"
3112 msgstr ""
3113
3114 #. type: Plain text
3115 #: build/C/man4/console_ioctl.4:418
3116 #, no-wrap
3117 msgid ""
3118 "struct kbentry {\n"
3119 "    unsigned char  kb_table;\n"
3120 "    unsigned char  kb_index;\n"
3121 "    unsigned short kb_value;\n"
3122 "};\n"
3123 msgstr ""
3124
3125 #. type: Plain text
3126 #: build/C/man4/console_ioctl.4:437
3127 msgid ""
3128 "with the first two members filled in: I<kb_table> selects the key table (0 "
3129 "E<lt>= I<kb_table> E<lt> MAX_NR_KEYMAPS), and I<kb_index> is the keycode (0 "
3130 "E<lt>= I<kb_index> E<lt> NR_KEYS).  I<kb_value> is set to the corresponding "
3131 "action code, or K_HOLE if there is no such key, or K_NOSUCHMAP if "
3132 "I<kb_table> is invalid."
3133 msgstr ""
3134
3135 #. type: TP
3136 #: build/C/man4/console_ioctl.4:437
3137 #, no-wrap
3138 msgid "B<KDSKBENT>"
3139 msgstr ""
3140
3141 #. type: Plain text
3142 #: build/C/man4/console_ioctl.4:443
3143 msgid "Sets one entry in translation table.  I<argp> points to a I<struct kbentry>."
3144 msgstr ""
3145
3146 #. type: TP
3147 #: build/C/man4/console_ioctl.4:443
3148 #, no-wrap
3149 msgid "B<KDGKBSENT>"
3150 msgstr ""
3151
3152 #. type: Plain text
3153 #: build/C/man4/console_ioctl.4:448
3154 msgid "Gets one function key string.  I<argp> points to a"
3155 msgstr ""
3156
3157 #. type: Plain text
3158 #: build/C/man4/console_ioctl.4:455
3159 #, no-wrap
3160 msgid ""
3161 "struct kbsentry {\n"
3162 "    unsigned char kb_func;\n"
3163 "    unsigned char kb_string[512];\n"
3164 "};\n"
3165 msgstr ""
3166
3167 #. type: Plain text
3168 #: build/C/man4/console_ioctl.4:463
3169 msgid ""
3170 "I<kb_string> is set to the (null-terminated) string corresponding to the "
3171 "I<kb_func>th function key action code."
3172 msgstr ""
3173
3174 #. type: TP
3175 #: build/C/man4/console_ioctl.4:463
3176 #, no-wrap
3177 msgid "B<KDSKBSENT>"
3178 msgstr ""
3179
3180 #. type: Plain text
3181 #: build/C/man4/console_ioctl.4:469
3182 msgid "Sets one function key string entry.  I<argp> points to a I<struct kbsentry>."
3183 msgstr ""
3184
3185 #. type: TP
3186 #: build/C/man4/console_ioctl.4:469
3187 #, no-wrap
3188 msgid "B<KDGKBDIACR>"
3189 msgstr ""
3190
3191 #. type: Plain text
3192 #: build/C/man4/console_ioctl.4:474
3193 msgid "Read kernel accent table.  I<argp> points to a"
3194 msgstr ""
3195
3196 #. type: Plain text
3197 #: build/C/man4/console_ioctl.4:481
3198 #, no-wrap
3199 msgid ""
3200 "struct kbdiacrs {\n"
3201 "    unsigned int   kb_cnt;\n"
3202 "    struct kbdiacr kbdiacr[256];\n"
3203 "};\n"
3204 msgstr ""
3205
3206 #. type: Plain text
3207 #: build/C/man4/console_ioctl.4:488
3208 msgid "where I<kb_cnt> is the number of entries in the array, each of which is a"
3209 msgstr ""
3210
3211 #. type: Plain text
3212 #: build/C/man4/console_ioctl.4:496
3213 #, no-wrap
3214 msgid ""
3215 "struct kbdiacr {\n"
3216 "    unsigned char diacr;\n"
3217 "    unsigned char base;\n"
3218 "    unsigned char result;\n"
3219 "};\n"
3220 msgstr ""
3221
3222 #. type: TP
3223 #: build/C/man4/console_ioctl.4:498
3224 #, no-wrap
3225 msgid "B<KDGETKEYCODE>"
3226 msgstr ""
3227
3228 #. type: Plain text
3229 #: build/C/man4/console_ioctl.4:503
3230 msgid "Read kernel keycode table entry (scan code to keycode).  I<argp> points to a"
3231 msgstr ""
3232
3233 #. type: Plain text
3234 #: build/C/man4/console_ioctl.4:510
3235 #, no-wrap
3236 msgid ""
3237 "struct kbkeycode {\n"
3238 "    unsigned int scancode;\n"
3239 "    unsigned int keycode;\n"
3240 "};\n"
3241 msgstr ""
3242
3243 #. type: Plain text
3244 #: build/C/man4/console_ioctl.4:524
3245 msgid ""
3246 "I<keycode> is set to correspond to the given I<scancode>.  (89 E<lt>= "
3247 "I<scancode> E<lt>= 255 only.  For 1 E<lt>= I<scancode> E<lt>= 88, "
3248 "I<keycode>==I<scancode>.)  (Since 1.1.63.)"
3249 msgstr ""
3250
3251 #. type: TP
3252 #: build/C/man4/console_ioctl.4:524
3253 #, no-wrap
3254 msgid "B<KDSETKEYCODE>"
3255 msgstr ""
3256
3257 #. type: Plain text
3258 #: build/C/man4/console_ioctl.4:531
3259 msgid ""
3260 "Write kernel keycode table entry.  I<argp> points to a I<struct kbkeycode>.  "
3261 "(Since 1.1.63.)"
3262 msgstr ""
3263
3264 #. type: TP
3265 #: build/C/man4/console_ioctl.4:531
3266 #, no-wrap
3267 msgid "B<KDSIGACCEPT>"
3268 msgstr ""
3269
3270 #. type: Plain text
3271 #: build/C/man4/console_ioctl.4:543
3272 msgid ""
3273 "The calling process indicates its willingness to accept the signal I<argp> "
3274 "when it is generated by pressing an appropriate key combination.  (1 E<lt>= "
3275 "I<argp> E<lt>= NSIG).  (See I<spawn_console>()  in "
3276 "I<linux/drivers/char/keyboard.c>.)"
3277 msgstr ""
3278
3279 #. type: TP
3280 #: build/C/man4/console_ioctl.4:543
3281 #, no-wrap
3282 msgid "B<VT_OPENQRY>"
3283 msgstr ""
3284
3285 #. type: Plain text
3286 #: build/C/man4/console_ioctl.4:553
3287 msgid ""
3288 "Returns the first available (non-opened) console.  I<argp> points to an "
3289 "I<int> which is set to the number of the vt (1 E<lt>= I<*argp> E<lt>= "
3290 "MAX_NR_CONSOLES)."
3291 msgstr ""
3292
3293 #. type: TP
3294 #: build/C/man4/console_ioctl.4:553
3295 #, no-wrap
3296 msgid "B<VT_GETMODE>"
3297 msgstr ""
3298
3299 #. type: Plain text
3300 #: build/C/man4/console_ioctl.4:558
3301 msgid "Get mode of active vt.  I<argp> points to a"
3302 msgstr ""
3303
3304 #. type: Plain text
3305 #: build/C/man4/console_ioctl.4:568
3306 #, no-wrap
3307 msgid ""
3308 "struct vt_mode {\n"
3309 "    char  mode;    /* vt mode */\n"
3310 "    char  waitv;   /* if set, hang on writes if not active */\n"
3311 "    short relsig;  /* signal to raise on release req */\n"
3312 "    short acqsig;  /* signal to raise on acquisition */\n"
3313 "    short frsig;   /* unused (set to 0) */\n"
3314 "};\n"
3315 msgstr ""
3316
3317 #. type: Plain text
3318 #: build/C/man4/console_ioctl.4:574
3319 msgid ""
3320 "which is set to the mode of the active vt.  I<mode> is set to one of these "
3321 "values:"
3322 msgstr ""
3323
3324 #. type: tbl table
3325 #: build/C/man4/console_ioctl.4:577
3326 #, no-wrap
3327 msgid "VT_AUTO\tauto vt switching\n"
3328 msgstr ""
3329
3330 #. type: tbl table
3331 #: build/C/man4/console_ioctl.4:578
3332 #, no-wrap
3333 msgid "VT_PROCESS\tprocess controls switching\n"
3334 msgstr ""
3335
3336 #. type: tbl table
3337 #: build/C/man4/console_ioctl.4:579
3338 #, no-wrap
3339 msgid "VT_ACKACQ\tacknowledge switch\n"
3340 msgstr ""
3341
3342 #. type: TP
3343 #: build/C/man4/console_ioctl.4:581
3344 #, no-wrap
3345 msgid "B<VT_SETMODE>"
3346 msgstr ""
3347
3348 #. type: Plain text
3349 #: build/C/man4/console_ioctl.4:587
3350 msgid "Set mode of active vt.  I<argp> points to a I<struct vt_mode>."
3351 msgstr ""
3352
3353 #. type: TP
3354 #: build/C/man4/console_ioctl.4:587
3355 #, no-wrap
3356 msgid "B<VT_GETSTATE>"
3357 msgstr ""
3358
3359 #. type: Plain text
3360 #: build/C/man4/console_ioctl.4:592
3361 msgid "Get global vt state info.  I<argp> points to a"
3362 msgstr ""
3363
3364 #. type: Plain text
3365 #: build/C/man4/console_ioctl.4:600
3366 #, no-wrap
3367 msgid ""
3368 "struct vt_stat {\n"
3369 "    unsigned short v_active;  /* active vt */\n"
3370 "    unsigned short v_signal;  /* signal to send */\n"
3371 "    unsigned short v_state;   /* vt bit mask */\n"
3372 "};\n"
3373 msgstr ""
3374
3375 #. type: Plain text
3376 #: build/C/man4/console_ioctl.4:607
3377 msgid ""
3378 "For each vt in use, the corresponding bit in the I<v_state> member is set.  "
3379 "(Kernels 1.0 through 1.1.92.)"
3380 msgstr ""
3381
3382 #. type: TP
3383 #: build/C/man4/console_ioctl.4:607
3384 #, no-wrap
3385 msgid "B<VT_RELDISP>"
3386 msgstr ""
3387
3388 #. type: Plain text
3389 #: build/C/man4/console_ioctl.4:610
3390 msgid "Release a display."
3391 msgstr ""
3392
3393 #. type: TP
3394 #: build/C/man4/console_ioctl.4:610
3395 #, no-wrap
3396 msgid "B<VT_ACTIVATE>"
3397 msgstr ""
3398
3399 #. type: Plain text
3400 #: build/C/man4/console_ioctl.4:617
3401 msgid "Switch to vt I<argp> (1 E<lt>= I<argp> E<lt>= MAX_NR_CONSOLES)."
3402 msgstr ""
3403
3404 #. type: TP
3405 #: build/C/man4/console_ioctl.4:617
3406 #, no-wrap
3407 msgid "B<VT_WAITACTIVE>"
3408 msgstr ""
3409
3410 #. type: Plain text
3411 #: build/C/man4/console_ioctl.4:622
3412 msgid "Wait until vt I<argp> has been activated."
3413 msgstr ""
3414
3415 #. type: TP
3416 #: build/C/man4/console_ioctl.4:622
3417 #, no-wrap
3418 msgid "B<VT_DISALLOCATE>"
3419 msgstr ""
3420
3421 #. type: Plain text
3422 #: build/C/man4/console_ioctl.4:627
3423 msgid "Deallocate the memory associated with vt I<argp>.  (Since 1.1.54.)"
3424 msgstr ""
3425
3426 #. type: TP
3427 #: build/C/man4/console_ioctl.4:627
3428 #, no-wrap
3429 msgid "B<VT_RESIZE>"
3430 msgstr ""
3431
3432 #. type: Plain text
3433 #: build/C/man4/console_ioctl.4:632
3434 msgid "Set the kernel's idea of screensize.  I<argp> points to a"
3435 msgstr ""
3436
3437 #. type: Plain text
3438 #: build/C/man4/console_ioctl.4:640
3439 #, no-wrap
3440 msgid ""
3441 "struct vt_sizes {\n"
3442 "    unsigned short v_rows;       /* # rows */\n"
3443 "    unsigned short v_cols;       /* # columns */\n"
3444 "    unsigned short v_scrollsize; /* no longer used */\n"
3445 "};\n"
3446 msgstr ""
3447
3448 #. type: Plain text
3449 #: build/C/man4/console_ioctl.4:647
3450 msgid ""
3451 "Note that this does not change the videomode.  See B<resizecons>(8).  (Since "
3452 "1.1.54.)"
3453 msgstr ""
3454
3455 #. type: TP
3456 #: build/C/man4/console_ioctl.4:647
3457 #, no-wrap
3458 msgid "B<VT_RESIZEX>"
3459 msgstr ""
3460
3461 #. type: Plain text
3462 #: build/C/man4/console_ioctl.4:652
3463 msgid "Set the kernel's idea of various screen parameters.  I<argp> points to a"
3464 msgstr ""
3465
3466 #. type: Plain text
3467 #: build/C/man4/console_ioctl.4:667
3468 #, no-wrap
3469 msgid ""
3470 "struct vt_consize {\n"
3471 "    unsigned short v_rows;  /* number of rows */\n"
3472 "    unsigned short v_cols;  /* number of columns */\n"
3473 "    unsigned short v_vlin;  /* number of pixel rows\n"
3474 "                               on screen */\n"
3475 "    unsigned short v_clin;  /* number of pixel rows\n"
3476 "                               per character */\n"
3477 "    unsigned short v_vcol;  /* number of pixel columns\n"
3478 "                               on screen */\n"
3479 "    unsigned short v_ccol;  /* number of pixel columns\n"
3480 "                               per character */\n"
3481 "};\n"
3482 msgstr ""
3483
3484 #. type: Plain text
3485 #: build/C/man4/console_ioctl.4:676
3486 msgid ""
3487 "Any parameter may be set to zero, indicating \"no change\", but if multiple "
3488 "parameters are set, they must be self-consistent.  Note that this does not "
3489 "change the videomode.  See B<resizecons>(8).  (Since 1.3.3.)"
3490 msgstr ""
3491
3492 #. type: Plain text
3493 #: build/C/man4/console_ioctl.4:683
3494 msgid ""
3495 "The action of the following ioctls depends on the first byte in the struct "
3496 "pointed to by I<argp>, referred to here as the I<subcode>.  These are legal "
3497 "only for the superuser or the owner of the current terminal."
3498 msgstr ""
3499
3500 #. type: TP
3501 #: build/C/man4/console_ioctl.4:683
3502 #, no-wrap
3503 msgid "B<TIOCLINUX, subcode=0>"
3504 msgstr ""
3505
3506 #. type: Plain text
3507 #: build/C/man4/console_ioctl.4:691
3508 msgid ""
3509 "Dump the screen.  Disappeared in 1.1.92.  (With kernel 1.1.92 or later, read "
3510 "from I</dev/vcsN> or I</dev/vcsaN> instead.)"
3511 msgstr ""
3512
3513 #. type: TP
3514 #: build/C/man4/console_ioctl.4:691
3515 #, no-wrap
3516 msgid "B<TIOCLINUX, subcode=1>"
3517 msgstr ""
3518
3519 #. type: Plain text
3520 #: build/C/man4/console_ioctl.4:695
3521 msgid "Get task information.  Disappeared in 1.1.92."
3522 msgstr ""
3523
3524 #. type: TP
3525 #: build/C/man4/console_ioctl.4:695
3526 #, no-wrap
3527 msgid "B<TIOCLINUX, subcode=2>"
3528 msgstr ""
3529
3530 #. type: Plain text
3531 #: build/C/man4/console_ioctl.4:700
3532 msgid "Set selection.  I<argp> points to a"
3533 msgstr ""
3534
3535 #. type: Plain text
3536 #: build/C/man4/console_ioctl.4:708
3537 #, no-wrap
3538 msgid ""
3539 "struct {\n"
3540 "   char  subcode;\n"
3541 "   short xs, ys, xe, ye;\n"
3542 "   short sel_mode;\n"
3543 "};\n"
3544 msgstr ""
3545
3546 #. type: Plain text
3547 #: build/C/man4/console_ioctl.4:728
3548 msgid ""
3549 "I<xs> and I<ys> are the starting column and row.  I<xe> and I<ye> are the "
3550 "ending column and row.  (Upper left corner is row=column=1.)  I<sel_mode> is "
3551 "0 for character-by-character selection, 1 for word-by-word selection, or 2 "
3552 "for line-by-line selection.  The indicated screen characters are highlighted "
3553 "and saved in the static array sel_buffer in I<devices/char/console.c>."
3554 msgstr ""
3555
3556 #. type: TP
3557 #: build/C/man4/console_ioctl.4:728
3558 #, no-wrap
3559 msgid "B<TIOCLINUX, subcode=3>"
3560 msgstr ""
3561
3562 #. type: Plain text
3563 #: build/C/man4/console_ioctl.4:734
3564 msgid ""
3565 "Paste selection.  The characters in the selection buffer are written to "
3566 "I<fd>."
3567 msgstr ""
3568
3569 #. type: TP
3570 #: build/C/man4/console_ioctl.4:734
3571 #, no-wrap
3572 msgid "B<TIOCLINUX, subcode=4>"
3573 msgstr ""
3574
3575 #. type: Plain text
3576 #: build/C/man4/console_ioctl.4:737
3577 msgid "Unblank the screen."
3578 msgstr ""
3579
3580 #. type: TP
3581 #: build/C/man4/console_ioctl.4:737
3582 #, no-wrap
3583 msgid "B<TIOCLINUX, subcode=5>"
3584 msgstr ""
3585
3586 #. type: Plain text
3587 #: build/C/man4/console_ioctl.4:742
3588 msgid ""
3589 "Sets contents of a 256-bit look up table defining characters in a \"word\", "
3590 "for word-by-word selection.  (Since 1.1.32.)"
3591 msgstr ""
3592
3593 #. type: TP
3594 #: build/C/man4/console_ioctl.4:742
3595 #, no-wrap
3596 msgid "B<TIOCLINUX, subcode=6>"
3597 msgstr ""
3598
3599 #. type: Plain text
3600 #: build/C/man4/console_ioctl.4:749
3601 msgid ""
3602 "I<argp> points to a char which is set to the value of the kernel variable "
3603 "I<shift_state>.  (Since 1.1.32.)"
3604 msgstr ""
3605
3606 #. type: TP
3607 #: build/C/man4/console_ioctl.4:749
3608 #, no-wrap
3609 msgid "B<TIOCLINUX, subcode=7>"
3610 msgstr ""
3611
3612 #. type: Plain text
3613 #: build/C/man4/console_ioctl.4:756
3614 msgid ""
3615 "I<argp> points to a char which is set to the value of the kernel variable "
3616 "I<report_mouse>.  (Since 1.1.33.)"
3617 msgstr ""
3618
3619 #. type: TP
3620 #: build/C/man4/console_ioctl.4:756
3621 #, no-wrap
3622 msgid "B<TIOCLINUX, subcode=8>"
3623 msgstr ""
3624
3625 #. type: Plain text
3626 #: build/C/man4/console_ioctl.4:764
3627 msgid ""
3628 "Dump screen width and height, cursor position, and all the "
3629 "character-attribute pairs.  (Kernels 1.1.67 through 1.1.91 only.  With "
3630 "kernel 1.1.92 or later, read from I</dev/vcsa*> instead.)"
3631 msgstr ""
3632
3633 #. type: TP
3634 #: build/C/man4/console_ioctl.4:764
3635 #, no-wrap
3636 msgid "B<TIOCLINUX, subcode=9>"
3637 msgstr ""
3638
3639 #. type: Plain text
3640 #: build/C/man4/console_ioctl.4:772
3641 msgid ""
3642 "Restore screen width and height, cursor position, and all the "
3643 "character-attribute pairs.  (Kernels 1.1.67 through 1.1.91 only.  With "
3644 "kernel 1.1.92 or later, write to I</dev/vcsa*> instead.)"
3645 msgstr ""
3646
3647 #. type: TP
3648 #: build/C/man4/console_ioctl.4:772
3649 #, no-wrap
3650 msgid "B<TIOCLINUX, subcode=10>"
3651 msgstr ""
3652
3653 #. type: Plain text
3654 #: build/C/man4/console_ioctl.4:780
3655 msgid ""
3656 "Handles the Power Saving feature of the new generation of monitors.  VESA "
3657 "screen blanking mode is set to I<argp[1]>, which governs what screen "
3658 "blanking does:"
3659 msgstr ""
3660
3661 #. type: IP
3662 #: build/C/man4/console_ioctl.4:781
3663 #, no-wrap
3664 msgid "0:"
3665 msgstr ""
3666
3667 #. type: Plain text
3668 #: build/C/man4/console_ioctl.4:783
3669 msgid "Screen blanking is disabled."
3670 msgstr ""
3671
3672 #. type: IP
3673 #: build/C/man4/console_ioctl.4:783
3674 #, no-wrap
3675 msgid "1:"
3676 msgstr ""
3677
3678 #. type: Plain text
3679 #: build/C/man4/console_ioctl.4:790
3680 msgid ""
3681 "The current video adapter register settings are saved, then the controller "
3682 "is programmed to turn off the vertical synchronization pulses.  This puts "
3683 "the monitor into \"standby\" mode.  If your monitor has an Off_Mode timer, "
3684 "then it will eventually power down by itself."
3685 msgstr ""
3686
3687 #. type: IP
3688 #: build/C/man4/console_ioctl.4:790
3689 #, no-wrap
3690 msgid "2:"
3691 msgstr ""
3692
3693 #. type: Plain text
3694 #: build/C/man4/console_ioctl.4:800
3695 msgid ""
3696 "The current settings are saved, then both the vertical and horizontal "
3697 "synchronization pulses are turned off.  This puts the monitor into \"off\" "
3698 "mode.  If your monitor has no Off_Mode timer, or if you want your monitor to "
3699 "power down immediately when the blank_timer times out, then you choose this "
3700 "option.  (I<Caution:> Powering down frequently will damage the monitor.)  "
3701 "(Since 1.1.76.)"
3702 msgstr ""
3703
3704 #. type: SH
3705 #: 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:244
3706 #, no-wrap
3707 msgid "RETURN VALUE"
3708 msgstr ""
3709
3710 #. type: Plain text
3711 #: build/C/man4/console_ioctl.4:806
3712 msgid "On success, 0 is returned.  On error, -1 is returned, and I<errno> is set."
3713 msgstr ""
3714
3715 #. type: SH
3716 #: 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:260
3717 #, no-wrap
3718 msgid "ERRORS"
3719 msgstr ""
3720
3721 #. type: Plain text
3722 #: build/C/man4/console_ioctl.4:809
3723 msgid "I<errno> may take on these values:"
3724 msgstr ""
3725
3726 #. type: TP
3727 #: build/C/man4/console_ioctl.4:809 build/C/man3/mkfifo.3:168 build/C/man2/mknod.2:230
3728 #, no-wrap
3729 msgid "B<EBADF>"
3730 msgstr ""
3731
3732 #. type: Plain text
3733 #: build/C/man4/console_ioctl.4:812
3734 msgid "The file descriptor is invalid."
3735 msgstr ""
3736
3737 #. type: TP
3738 #: build/C/man4/console_ioctl.4:812
3739 #, no-wrap
3740 msgid "B<ENOTTY>"
3741 msgstr ""
3742
3743 #. type: Plain text
3744 #: build/C/man4/console_ioctl.4:816
3745 msgid ""
3746 "The file descriptor is not associated with a character special device, or "
3747 "the specified request does not apply to it."
3748 msgstr ""
3749
3750 #. type: TP
3751 #: build/C/man4/console_ioctl.4:816 build/C/man2/mknod.2:179 build/C/man4/st.4:842 build/C/man2/syslog.2:261
3752 #, no-wrap
3753 msgid "B<EINVAL>"
3754 msgstr ""
3755
3756 #. type: Plain text
3757 #: build/C/man4/console_ioctl.4:821
3758 msgid "The file descriptor or I<argp> is invalid."
3759 msgstr ""
3760
3761 #. type: TP
3762 #: build/C/man4/console_ioctl.4:821 build/C/man2/mknod.2:209 build/C/man2/syslog.2:285
3763 #, no-wrap
3764 msgid "B<EPERM>"
3765 msgstr ""
3766
3767 #. type: Plain text
3768 #: build/C/man4/console_ioctl.4:824
3769 msgid "Insufficient permission."
3770 msgstr ""
3771
3772 #. type: Plain text
3773 #: build/C/man4/console_ioctl.4:835
3774 msgid ""
3775 "B<Warning>: Do not regard this man page as documentation of the Linux "
3776 "console ioctls.  This is provided for the curious only, as an alternative to "
3777 "reading the source.  Ioctl's are undocumented Linux internals, liable to be "
3778 "changed without warning.  (And indeed, this page more or less describes the "
3779 "situation as of kernel version 1.1.94; there are many minor and not-so-minor "
3780 "differences with earlier versions.)"
3781 msgstr ""
3782
3783 #. type: Plain text
3784 #: build/C/man4/console_ioctl.4:840
3785 msgid ""
3786 "Very often, ioctls are introduced for communication between the kernel and "
3787 "one particular well-known program (fdisk, hdparm, setserial, tunelp, "
3788 "loadkeys, selection, setfont, etc.), and their behavior will be changed when "
3789 "required by this particular program."
3790 msgstr ""
3791
3792 #. type: Plain text
3793 #: build/C/man4/console_ioctl.4:844
3794 msgid ""
3795 "Programs using these ioctls will not be portable to other versions of UNIX, "
3796 "will not work on older versions of Linux, and will not work on future "
3797 "versions of Linux."
3798 msgstr ""
3799
3800 #. type: Plain text
3801 #: build/C/man4/console_ioctl.4:846
3802 msgid "Use POSIX functions."
3803 msgstr ""
3804
3805 #. type: Plain text
3806 #: build/C/man4/console_ioctl.4:870
3807 msgid ""
3808 "B<dumpkeys>(1), B<kbd_mode>(1), B<loadkeys>(1), B<mknod>(1), B<setleds>(1), "
3809 "B<setmetamode>(1), B<execve>(2), B<fcntl>(2), B<ioperm>(2), B<termios>(3), "
3810 "B<console>(4), B<console_codes>(4), B<mt>(4), B<sd>(4), B<tty>(4), "
3811 "B<tty_ioctl>(4), B<ttyS>(4), B<vcs>(4), B<vcsa>(4), B<charsets>(7), "
3812 "B<mapscrn>(8), B<resizecons>(8), B<setfont>(8)"
3813 msgstr ""
3814
3815 #. type: Plain text
3816 #: build/C/man4/console_ioctl.4:873
3817 msgid "I</usr/include/linux/kd.h>, I</usr/include/linux/vt.h>"
3818 msgstr ""
3819
3820 #. type: TH
3821 #: build/C/man5/core.5:25
3822 #, no-wrap
3823 msgid "CORE"
3824 msgstr ""
3825
3826 #. type: TH
3827 #: build/C/man5/core.5:25
3828 #, no-wrap
3829 msgid "2014-03-14"
3830 msgstr ""
3831
3832 #. type: Plain text
3833 #: build/C/man5/core.5:28
3834 msgid "core - core dump file"
3835 msgstr ""
3836
3837 #. type: Plain text
3838 #: build/C/man5/core.5:39
3839 msgid ""
3840 "The default action of certain signals is to cause a process to terminate and "
3841 "produce a I<core dump file>, a disk file containing an image of the "
3842 "process's memory at the time of termination.  This image can be used in a "
3843 "debugger (e.g., B<gdb>(1))  to inspect the state of the program at the time "
3844 "that it terminated.  A list of the signals which cause a process to dump "
3845 "core can be found in B<signal>(7)."
3846 msgstr ""
3847
3848 #. type: Plain text
3849 #: build/C/man5/core.5:46
3850 msgid ""
3851 "A process can set its soft B<RLIMIT_CORE> resource limit to place an upper "
3852 "limit on the size of the core dump file that will be produced if it receives "
3853 "a \"core dump\" signal; see B<getrlimit>(2)  for details."
3854 msgstr ""
3855
3856 #. type: Plain text
3857 #: build/C/man5/core.5:49
3858 msgid "There are various circumstances in which a core dump file is not produced:"
3859 msgstr ""
3860
3861 #. type: Plain text
3862 #: build/C/man5/core.5:61
3863 msgid ""
3864 "The process does not have permission to write the core file.  (By default "
3865 "the core file is called I<core>, and is created in the current working "
3866 "directory.  See below for details on naming.)  Writing the core file will "
3867 "fail if the directory in which it is to be created is nonwritable, or if a "
3868 "file with the same name exists and is not writable or is not a regular file "
3869 "(e.g., it is a directory or a symbolic link)."
3870 msgstr ""
3871
3872 #. type: Plain text
3873 #: build/C/man5/core.5:65
3874 msgid ""
3875 "A (writable, regular) file with the same name as would be used for the core "
3876 "dump already exists, but there is more than one hard link to that file."
3877 msgstr ""
3878
3879 #. type: Plain text
3880 #: build/C/man5/core.5:69
3881 msgid ""
3882 "The filesystem where the core dump file would be created is full; or has run "
3883 "out of inodes; or is mounted read-only; or the user has reached their quota "
3884 "for the filesystem."
3885 msgstr ""
3886
3887 #. type: Plain text
3888 #: build/C/man5/core.5:72
3889 msgid "The directory in which the core dump file is to be created does not exist."
3890 msgstr ""
3891
3892 #. type: Plain text
3893 #: build/C/man5/core.5:85
3894 msgid ""
3895 "The B<RLIMIT_CORE> (core file size) or B<RLIMIT_FSIZE> (file size) resource "
3896 "limits for the process are set to zero; see B<getrlimit>(2)  and the "
3897 "documentation of the shell's I<ulimit> command (I<limit> in B<csh>(1))."
3898 msgstr ""
3899
3900 #. type: Plain text
3901 #: build/C/man5/core.5:88
3902 msgid ""
3903 "The binary being executed by the process does not have read permission "
3904 "enabled."
3905 msgstr ""
3906
3907 #.  FIXME . Perhaps relocate discussion of /proc/sys/fs/suid_dumpable
3908 #.  and PR_SET_DUMPABLE to this page?
3909 #. type: Plain text
3910 #: build/C/man5/core.5:101
3911 msgid ""
3912 "The process is executing a set-user-ID (set-group-ID) program that is owned "
3913 "by a user (group) other than the real user (group)  ID of the process.  "
3914 "(However, see the description of the B<prctl>(2)  B<PR_SET_DUMPABLE> "
3915 "operation, and the description of the I</proc/sys/fs/suid_dumpable> file in "
3916 "B<proc>(5).)"
3917 msgstr ""
3918
3919 #.  commit 046d662f481830e652ac34cd112249adde16452a
3920 #. type: Plain text
3921 #: build/C/man5/core.5:107
3922 msgid ""
3923 "(Since Linux 3.7)  The kernel was configured without the B<CONFIG_COREDUMP> "
3924 "option."
3925 msgstr ""
3926
3927 #. type: Plain text
3928 #: build/C/man5/core.5:113
3929 msgid ""
3930 "In addition, a core dump may exclude part of the address space of the "
3931 "process if the B<madvise>(2)  B<MADV_DONTDUMP> flag was employed."
3932 msgstr ""
3933
3934 #. type: SS
3935 #: build/C/man5/core.5:113
3936 #, no-wrap
3937 msgid "Naming of core dump files"
3938 msgstr ""
3939
3940 #. type: Plain text
3941 #: build/C/man5/core.5:122
3942 msgid ""
3943 "By default, a core dump file is named I<core>, but the "
3944 "I</proc/sys/kernel/core_pattern> file (since Linux 2.6 and 2.4.21)  can be "
3945 "set to define a template that is used to name core dump files.  The template "
3946 "can contain % specifiers which are substituted by the following values when "
3947 "a core file is created:"
3948 msgstr ""
3949
3950 #. type: TP
3951 #: build/C/man5/core.5:125
3952 #, no-wrap
3953 msgid "%%"
3954 msgstr ""
3955
3956 #. type: Plain text
3957 #: build/C/man5/core.5:128
3958 msgid "a single % character"
3959 msgstr ""
3960
3961 #. type: TP
3962 #: build/C/man5/core.5:128
3963 #, no-wrap
3964 msgid "%c"
3965 msgstr ""
3966
3967 #. type: Plain text
3968 #: build/C/man5/core.5:131
3969 msgid "core file size soft resource limit of crashing process (since Linux 2.6.24)"
3970 msgstr ""
3971
3972 #. type: TP
3973 #: build/C/man5/core.5:131
3974 #, no-wrap
3975 msgid "%d"
3976 msgstr ""
3977
3978 #.  Added in git commit 12a2b4b2241e318b4f6df31228e4272d2c2968a1
3979 #. type: Plain text
3980 #: build/C/man5/core.5:138
3981 msgid ""
3982 "dump mode\\(emsame as value returned by B<prctl>(2)  B<PR_GET_DUMPABLE> "
3983 "(since Linux 3.7)"
3984 msgstr ""
3985
3986 #. type: TP
3987 #: build/C/man5/core.5:138
3988 #, no-wrap
3989 msgid "%e"
3990 msgstr ""
3991
3992 #. type: Plain text
3993 #: build/C/man5/core.5:141
3994 msgid "executable filename (without path prefix)"
3995 msgstr ""
3996
3997 #. type: TP
3998 #: build/C/man5/core.5:141
3999 #, no-wrap
4000 msgid "%E"
4001 msgstr ""
4002
4003 #. type: Plain text
4004 #: build/C/man5/core.5:146
4005 msgid ""
4006 "pathname of executable, with slashes (\\(aq/\\(aq) replaced by exclamation "
4007 "marks (\\(aq!\\(aq)  (since Linux 3.0)."
4008 msgstr ""
4009
4010 #. type: TP
4011 #: build/C/man5/core.5:146
4012 #, no-wrap
4013 msgid "%g"
4014 msgstr ""
4015
4016 #. type: Plain text
4017 #: build/C/man5/core.5:149
4018 msgid "(numeric) real GID of dumped process"
4019 msgstr ""
4020
4021 #. type: TP
4022 #: build/C/man5/core.5:149
4023 #, no-wrap
4024 msgid "%h"
4025 msgstr ""
4026
4027 #. type: Plain text
4028 #: build/C/man5/core.5:152
4029 msgid "hostname (same as I<nodename> returned by B<uname>(2))"
4030 msgstr ""
4031
4032 #. type: TP
4033 #: build/C/man5/core.5:152
4034 #, no-wrap
4035 msgid "%p"
4036 msgstr ""
4037
4038 #. type: Plain text
4039 #: build/C/man5/core.5:156
4040 msgid ""
4041 "PID of dumped process, as seen in the PID namespace in which the process "
4042 "resides"
4043 msgstr ""
4044
4045 #. type: TP
4046 #: build/C/man5/core.5:156
4047 #, no-wrap
4048 msgid "%P"
4049 msgstr ""
4050
4051 #.  Added in git commit 65aafb1e7484b7434a0c1d4c593191ebe5776a2f
4052 #. type: Plain text
4053 #: build/C/man5/core.5:161
4054 msgid ""
4055 "PID of dumped process, as seen in the initial PID namespace (since Linux "
4056 "3.12)"
4057 msgstr ""
4058
4059 #. type: TP
4060 #: build/C/man5/core.5:161
4061 #, no-wrap
4062 msgid "%s"
4063 msgstr ""
4064
4065 #. type: Plain text
4066 #: build/C/man5/core.5:164
4067 msgid "number of signal causing dump"
4068 msgstr ""
4069
4070 #. type: TP
4071 #: build/C/man5/core.5:164
4072 #, no-wrap
4073 msgid "%t"
4074 msgstr ""
4075
4076 #. type: Plain text
4077 #: build/C/man5/core.5:168
4078 msgid ""
4079 "time of dump, expressed as seconds since the Epoch, 1970-01-01 00:00:00 "
4080 "+0000 (UTC)"
4081 msgstr ""
4082
4083 #. type: TP
4084 #: build/C/man5/core.5:168
4085 #, no-wrap
4086 msgid "%u"
4087 msgstr ""
4088
4089 #. type: Plain text
4090 #: build/C/man5/core.5:171
4091 msgid "(numeric) real UID of dumped process"
4092 msgstr ""
4093
4094 #. type: Plain text
4095 #: build/C/man5/core.5:190
4096 msgid ""
4097 "A single % at the end of the template is dropped from the core filename, as "
4098 "is the combination of a % followed by any character other than those listed "
4099 "above.  All other characters in the template become a literal part of the "
4100 "core filename.  The template may include \\(aq/\\(aq characters, which are "
4101 "interpreted as delimiters for directory names.  The maximum size of the "
4102 "resulting core filename is 128 bytes (64 bytes in kernels before 2.6.19).  "
4103 "The default value in this file is \"core\".  For backward compatibility, if "
4104 "I</proc/sys/kernel/core_pattern> does not include \"%p\" and "
4105 "I</proc/sys/kernel/core_uses_pid> (see below)  is nonzero, then .PID will be "
4106 "appended to the core filename."
4107 msgstr ""
4108
4109 #. type: Plain text
4110 #: build/C/man5/core.5:201
4111 msgid ""
4112 "Since version 2.4, Linux has also provided a more primitive method of "
4113 "controlling the name of the core dump file.  If the "
4114 "I</proc/sys/kernel/core_uses_pid> file contains the value 0, then a core "
4115 "dump file is simply named I<core>.  If this file contains a nonzero value, "
4116 "then the core dump file includes the process ID in a name of the form "
4117 "I<core.PID>."
4118 msgstr ""
4119
4120 #.  9520628e8ceb69fa9a4aee6b57f22675d9e1b709
4121 #. type: Plain text
4122 #: build/C/man5/core.5:208
4123 msgid ""
4124 "Since Linux 3.6, if I</proc/sys/fs/suid_dumpable> is set to 2 "
4125 "(\"suidsafe\"), the pattern must be either an absolute pathname (starting "
4126 "with a leading \\(aq/\\(aq character) or a pipe, as defined below."
4127 msgstr ""
4128
4129 #. type: SS
4130 #: build/C/man5/core.5:208
4131 #, no-wrap
4132 msgid "Piping core dumps to a program"
4133 msgstr ""
4134
4135 #. type: Plain text
4136 #: build/C/man5/core.5:218
4137 msgid ""
4138 "Since kernel 2.6.19, Linux supports an alternate syntax for the "
4139 "I</proc/sys/kernel/core_pattern> file.  If the first character of this file "
4140 "is a pipe symbol (B<|>), then the remainder of the line is interpreted as a "
4141 "program to be executed.  Instead of being written to a disk file, the core "
4142 "dump is given as standard input to the program.  Note the following points:"
4143 msgstr ""
4144
4145 #. type: Plain text
4146 #: build/C/man5/core.5:222
4147 msgid ""
4148 "The program must be specified using an absolute pathname (or a pathname "
4149 "relative to the root directory, I</>), and must immediately follow the '|' "
4150 "character."
4151 msgstr ""
4152
4153 #. type: Plain text
4154 #: build/C/man5/core.5:225
4155 msgid "The process created to run the program runs as user and group I<root>."
4156 msgstr ""
4157
4158 #. type: Plain text
4159 #: build/C/man5/core.5:229
4160 msgid ""
4161 "Command-line arguments can be supplied to the program (since Linux 2.6.24), "
4162 "delimited by white space (up to a total line length of 128 bytes)."
4163 msgstr ""
4164
4165 #. type: Plain text
4166 #: build/C/man5/core.5:235
4167 msgid ""
4168 "The command-line arguments can include any of the % specifiers listed "
4169 "above.  For example, to pass the PID of the process that is being dumped, "
4170 "specify I<%p> in an argument."
4171 msgstr ""
4172
4173 #. type: SS
4174 #: build/C/man5/core.5:235
4175 #, no-wrap
4176 msgid "Controlling which mappings are written to the core dump"
4177 msgstr ""
4178
4179 #. type: Plain text
4180 #: build/C/man5/core.5:241
4181 msgid ""
4182 "Since kernel 2.6.23, the Linux-specific I</proc/PID/coredump_filter> file "
4183 "can be used to control which memory segments are written to the core dump "
4184 "file in the event that a core dump is performed for the process with the "
4185 "corresponding process ID."
4186 msgstr ""
4187
4188 #. type: Plain text
4189 #: build/C/man5/core.5:247
4190 msgid ""
4191 "The value in the file is a bit mask of memory mapping types (see "
4192 "B<mmap>(2)).  If a bit is set in the mask, then memory mappings of the "
4193 "corresponding type are dumped; otherwise they are not dumped.  The bits in "
4194 "this file have the following meanings:"
4195 msgstr ""
4196
4197 #. type: TP
4198 #: build/C/man5/core.5:250
4199 #, no-wrap
4200 msgid "bit 0"
4201 msgstr ""
4202
4203 #. type: Plain text
4204 #: build/C/man5/core.5:253
4205 msgid "Dump anonymous private mappings."
4206 msgstr ""
4207
4208 #. type: TP
4209 #: build/C/man5/core.5:253
4210 #, no-wrap
4211 msgid "bit 1"
4212 msgstr ""
4213
4214 #. type: Plain text
4215 #: build/C/man5/core.5:256
4216 msgid "Dump anonymous shared mappings."
4217 msgstr ""
4218
4219 #. type: TP
4220 #: build/C/man5/core.5:256
4221 #, no-wrap
4222 msgid "bit 2"
4223 msgstr ""
4224
4225 #. type: Plain text
4226 #: build/C/man5/core.5:259
4227 msgid "Dump file-backed private mappings."
4228 msgstr ""
4229
4230 #. type: TP
4231 #: build/C/man5/core.5:259
4232 #, no-wrap
4233 msgid "bit 3"
4234 msgstr ""
4235
4236 #.  file-backed shared mappings of course also update the underlying
4237 #.  mapped file.
4238 #. type: Plain text
4239 #: build/C/man5/core.5:264
4240 msgid "Dump file-backed shared mappings."
4241 msgstr ""
4242
4243 #. type: TP
4244 #: build/C/man5/core.5:264
4245 #, no-wrap
4246 msgid "bit 4 (since Linux 2.6.24)"
4247 msgstr ""
4248
4249 #. type: Plain text
4250 #: build/C/man5/core.5:267
4251 msgid "Dump ELF headers."
4252 msgstr ""
4253
4254 #. type: TP
4255 #: build/C/man5/core.5:267
4256 #, no-wrap
4257 msgid "bit 5 (since Linux 2.6.28)"
4258 msgstr ""
4259
4260 #. type: Plain text
4261 #: build/C/man5/core.5:270
4262 msgid "Dump private huge pages."
4263 msgstr ""
4264
4265 #. type: TP
4266 #: build/C/man5/core.5:270
4267 #, no-wrap
4268 msgid "bit 6 (since Linux 2.6.28)"
4269 msgstr ""
4270
4271 #. type: Plain text
4272 #: build/C/man5/core.5:273
4273 msgid "Dump shared huge pages."
4274 msgstr ""
4275
4276 #. type: Plain text
4277 #: build/C/man5/core.5:281
4278 msgid ""
4279 "By default, the following bits are set: 0, 1, 4 (if the "
4280 "B<CONFIG_CORE_DUMP_DEFAULT_ELF_HEADERS> kernel configuration option is "
4281 "enabled), and 5.  The value of this file is displayed in hexadecimal.  (The "
4282 "default value is thus displayed as 33.)"
4283 msgstr ""
4284
4285 #. type: Plain text
4286 #: build/C/man5/core.5:286
4287 msgid ""
4288 "Memory-mapped I/O pages such as frame buffer are never dumped, and virtual "
4289 "DSO pages are always dumped, regardless of the I<coredump_filter> value."
4290 msgstr ""
4291
4292 #. type: Plain text
4293 #: build/C/man5/core.5:296
4294 msgid ""
4295 "A child process created via B<fork>(2)  inherits its parent's "
4296 "I<coredump_filter> value; the I<coredump_filter> value is preserved across "
4297 "an B<execve>(2)."
4298 msgstr ""
4299
4300 #. type: Plain text
4301 #: build/C/man5/core.5:300
4302 msgid ""
4303 "It can be useful to set I<coredump_filter> in the parent shell before "
4304 "running a program, for example:"
4305 msgstr ""
4306
4307 #. type: Plain text
4308 #: build/C/man5/core.5:305
4309 #, no-wrap
4310 msgid ""
4311 "$B< echo 0x7 E<gt> /proc/self/coredump_filter>\n"
4312 "$B< ./some_program>\n"
4313 msgstr ""
4314
4315 #. type: Plain text
4316 #: build/C/man5/core.5:311
4317 msgid ""
4318 "This file is provided only if the kernel was built with the "
4319 "B<CONFIG_ELF_CORE> configuration option."
4320 msgstr ""
4321
4322 #. type: Plain text
4323 #: build/C/man5/core.5:316
4324 msgid ""
4325 "The B<gdb>(1)  I<gcore> command can be used to obtain a core dump of a "
4326 "running process."
4327 msgstr ""
4328
4329 #.  Changed with commit 6409324b385f3f63a03645b4422e3be67348d922
4330 #.  Always including the PID in the name of the core file made
4331 #.  sense for LinuxThreads, where each thread had a unique PID,
4332 #.  but doesn't seem to serve any purpose with NPTL, where all the
4333 #.  threads in a process share the same PID (as POSIX.1 requires).
4334 #.  Probably the behavior is maintained so that applications using
4335 #.  LinuxThreads continue appending the PID (the kernel has no easy
4336 #.  way of telling which threading implementation the user-space
4337 #.  application is using). -- mtk, April 2006
4338 #. type: Plain text
4339 #: build/C/man5/core.5:339
4340 msgid ""
4341 "In Linux versions up to and including 2.6.27, if a multithreaded process "
4342 "(or, more precisely, a process that shares its memory with another process "
4343 "by being created with the B<CLONE_VM> flag of B<clone>(2))  dumps core, then "
4344 "the process ID is always appended to the core filename, unless the process "
4345 "ID was already included elsewhere in the filename via a %p specification in "
4346 "I</proc/sys/kernel/core_pattern>.  (This is primarily useful when employing "
4347 "the obsolete LinuxThreads implementation, where each thread of a process has "
4348 "a different PID.)"
4349 msgstr ""
4350
4351 #. type: SH
4352 #: build/C/man5/core.5:339 build/C/man3/gnu_get_libc_version.3:51 build/C/man3/stdarg.3:300 build/C/man4/vcs.4:101
4353 #, no-wrap
4354 msgid "EXAMPLE"
4355 msgstr ""
4356
4357 #. type: Plain text
4358 #: build/C/man5/core.5:347
4359 msgid ""
4360 "The program below can be used to demonstrate the use of the pipe syntax in "
4361 "the I</proc/sys/kernel/core_pattern> file.  The following shell session "
4362 "demonstrates the use of this program (compiled to create an executable named "
4363 "I<core_pattern_pipe_test>):"
4364 msgstr ""
4365
4366 #. type: Plain text
4367 #: build/C/man5/core.5:368
4368 #, no-wrap
4369 msgid ""
4370 "$B< cc -o core_pattern_pipe_test core_pattern_pipe_test.c>\n"
4371 "$B< su>\n"
4372 "Password:\n"
4373 "#B< echo \"|$PWD/core_pattern_pipe_test %p UID=%u GID=%g sig=%s\" E<gt> "
4374 "\\e>\n"
4375 "B</proc/sys/kernel/core_pattern>\n"
4376 "#B< exit>\n"
4377 "$B< sleep 100>\n"
4378 "B<^\\e>                     # type control-backslash\n"
4379 "Quit (core dumped)\n"
4380 "$B< cat core.info>\n"
4381 "argc=5\n"
4382 "argc[0]=E<lt>/home/mtk/core_pattern_pipe_testE<gt>\n"
4383 "argc[1]=E<lt>20575E<gt>\n"
4384 "argc[2]=E<lt>UID=1000E<gt>\n"
4385 "argc[3]=E<lt>GID=100E<gt>\n"
4386 "argc[4]=E<lt>sig=3E<gt>\n"
4387 "Total bytes in core dump: 282624\n"
4388 msgstr ""
4389
4390 #. type: SS
4391 #: build/C/man5/core.5:370 build/C/man3/gnu_get_libc_version.3:61
4392 #, no-wrap
4393 msgid "Program source"
4394 msgstr ""
4395
4396 #. type: Plain text
4397 #: build/C/man5/core.5:374
4398 #, no-wrap
4399 msgid "/* core_pattern_pipe_test.c */\n"
4400 msgstr ""
4401
4402 #. type: Plain text
4403 #: build/C/man5/core.5:382
4404 #, no-wrap
4405 msgid ""
4406 "#define _GNU_SOURCE\n"
4407 "#include E<lt>sys/stat.hE<gt>\n"
4408 "#include E<lt>fcntl.hE<gt>\n"
4409 "#include E<lt>limits.hE<gt>\n"
4410 "#include E<lt>stdio.hE<gt>\n"
4411 "#include E<lt>stdlib.hE<gt>\n"
4412 "#include E<lt>unistd.hE<gt>\n"
4413 msgstr ""
4414
4415 #. type: Plain text
4416 #: build/C/man5/core.5:384
4417 #, no-wrap
4418 msgid "#define BUF_SIZE 1024\n"
4419 msgstr ""
4420
4421 #. type: Plain text
4422 #: build/C/man5/core.5:393
4423 #, no-wrap
4424 msgid ""
4425 "int\n"
4426 "main(int argc, char *argv[])\n"
4427 "{\n"
4428 "    int tot, j;\n"
4429 "    ssize_t nread;\n"
4430 "    char buf[BUF_SIZE];\n"
4431 "    FILE *fp;\n"
4432 "    char cwd[PATH_MAX];\n"
4433 msgstr ""
4434
4435 #. type: Plain text
4436 #: build/C/man5/core.5:396
4437 #, no-wrap
4438 msgid ""
4439 "    /* Change our current working directory to that of the\n"
4440 "       crashing process */\n"
4441 msgstr ""
4442
4443 #. type: Plain text
4444 #: build/C/man5/core.5:399
4445 #, no-wrap
4446 msgid ""
4447 "    snprintf(cwd, PATH_MAX, \"/proc/%s/cwd\", argv[1]);\n"
4448 "    chdir(cwd);\n"
4449 msgstr ""
4450
4451 #. type: Plain text
4452 #: build/C/man5/core.5:401
4453 #, no-wrap
4454 msgid "    /* Write output to file \"core.info\" in that directory */\n"
4455 msgstr ""
4456
4457 #. type: Plain text
4458 #: build/C/man5/core.5:405
4459 #, no-wrap
4460 msgid ""
4461 "    fp = fopen(\"core.info\", \"w+\");\n"
4462 "    if (fp == NULL)\n"
4463 "        exit(EXIT_FAILURE);\n"
4464 msgstr ""
4465
4466 #. type: Plain text
4467 #: build/C/man5/core.5:408
4468 #, no-wrap
4469 msgid ""
4470 "    /* Display command-line arguments given to core_pattern\n"
4471 "       pipe program */\n"
4472 msgstr ""
4473
4474 #. type: Plain text
4475 #: build/C/man5/core.5:412
4476 #, no-wrap
4477 msgid ""
4478 "    fprintf(fp, \"argc=%d\\en\", argc);\n"
4479 "    for (j = 0; j E<lt> argc; j++)\n"
4480 "        fprintf(fp, \"argc[%d]=E<lt>%sE<gt>\\en\", j, argv[j]);\n"
4481 msgstr ""
4482
4483 #. type: Plain text
4484 #: build/C/man5/core.5:414
4485 #, no-wrap
4486 msgid "    /* Count bytes in standard input (the core dump) */\n"
4487 msgstr ""
4488
4489 #. type: Plain text
4490 #: build/C/man5/core.5:419
4491 #, no-wrap
4492 msgid ""
4493 "    tot = 0;\n"
4494 "    while ((nread = read(STDIN_FILENO, buf, BUF_SIZE)) E<gt> 0)\n"
4495 "        tot += nread;\n"
4496 "    fprintf(fp, \"Total bytes in core dump: %d\\en\", tot);\n"
4497 msgstr ""
4498
4499 #. type: Plain text
4500 #: build/C/man5/core.5:422
4501 #, no-wrap
4502 msgid ""
4503 "    exit(EXIT_SUCCESS);\n"
4504 "}\n"
4505 msgstr ""
4506
4507 #. type: Plain text
4508 #: build/C/man5/core.5:434
4509 msgid ""
4510 "B<bash>(1), B<gdb>(1), B<getrlimit>(2), B<mmap>(2), B<prctl>(2), "
4511 "B<sigaction>(2), B<elf>(5), B<proc>(5), B<pthreads>(7), B<signal>(7)"
4512 msgstr ""
4513
4514 #. type: TH
4515 #: build/C/man4/cpuid.4:26
4516 #, no-wrap
4517 msgid "CPUID"
4518 msgstr ""
4519
4520 #. type: TH
4521 #: build/C/man4/cpuid.4:26 build/C/man4/msr.4:26
4522 #, no-wrap
4523 msgid "2009-03-31"
4524 msgstr ""
4525
4526 #. type: Plain text
4527 #: build/C/man4/cpuid.4:29
4528 msgid "cpuid - x86 CPUID access device"
4529 msgstr ""
4530
4531 #. type: Plain text
4532 #: build/C/man4/cpuid.4:31
4533 msgid "CPUID provides an interface for querying information about the x86 CPU."
4534 msgstr ""
4535
4536 #. type: Plain text
4537 #: build/C/man4/cpuid.4:38
4538 msgid ""
4539 "This device is accessed by B<lseek>(2)  or B<pread>(2)  to the appropriate "
4540 "CPUID level and reading in chunks of 16 bytes.  A larger read size means "
4541 "multiple reads of consecutive levels."
4542 msgstr ""
4543
4544 #. type: Plain text
4545 #: build/C/man4/cpuid.4:47
4546 msgid ""
4547 "The lower 32 bits of the file position is used as the incoming I<%eax>, and "
4548 "the upper 32 bits of the file position as the incoming I<%ecx>, the latter "
4549 "intended for \"counting\" I<eax> levels like I<eax=4>."
4550 msgstr ""
4551
4552 #. type: Plain text
4553 #: build/C/man4/cpuid.4:57
4554 msgid ""
4555 "This driver uses I</dev/cpu/CPUNUM/cpuid>, where I<CPUNUM> is the minor "
4556 "number, and on an SMP box will direct the access to CPU I<CPUNUM> as listed "
4557 "in I</proc/cpuinfo>."
4558 msgstr ""
4559
4560 #. type: Plain text
4561 #: build/C/man4/cpuid.4:62
4562 msgid ""
4563 "This file is protected so that it can be read only by the user I<root>, or "
4564 "members of the group I<root>."
4565 msgstr ""
4566
4567 #. type: Plain text
4568 #: build/C/man4/cpuid.4:67
4569 msgid ""
4570 "The CPUID instruction can be directly executed by a program using inline "
4571 "assembler.  However this device allows convenient access to all CPUs without "
4572 "changing process affinity."
4573 msgstr ""
4574
4575 #. type: Plain text
4576 #: build/C/man4/cpuid.4:76
4577 msgid ""
4578 "Most of the information in I<cpuid> is reported by the kernel in cooked form "
4579 "either in I</proc/cpuinfo> or through subdirectories in "
4580 "I</sys/devices/system/cpu>.  Direct CPUID access through this device should "
4581 "only be used in exceptional cases."
4582 msgstr ""
4583
4584 #. type: Plain text
4585 #: build/C/man4/cpuid.4:82
4586 msgid ""
4587 "The I<cpuid> driver is not auto-loaded.  On modular kernels you might need "
4588 "to use the following command to load it explicitly before use:"
4589 msgstr ""
4590
4591 #. type: Plain text
4592 #: build/C/man4/cpuid.4:84
4593 #, no-wrap
4594 msgid "     $ I<modprobe cpuid>\n"
4595 msgstr ""
4596
4597 #. type: Plain text
4598 #: build/C/man4/cpuid.4:87
4599 msgid ""
4600 "There is no support for CPUID functions that require additional input "
4601 "registers."
4602 msgstr ""
4603
4604 #. type: Plain text
4605 #: build/C/man4/cpuid.4:89
4606 msgid "Very old x86 CPUs don't support CPUID."
4607 msgstr ""
4608
4609 #. type: Plain text
4610 #: build/C/man4/cpuid.4:93
4611 msgid ""
4612 "Intel Corporation, Intel 64 and IA-32 Architectures Software Developer's "
4613 "Manual Volume 2A: Instruction Set Reference, A-M, 3-180 CPUID reference."
4614 msgstr ""
4615
4616 #. type: Plain text
4617 #: build/C/man4/cpuid.4:96
4618 msgid ""
4619 "Intel Corporation, Intel Processor Identification and the CPUID Instruction, "
4620 "Application note 485."
4621 msgstr ""
4622
4623 #. type: TH
4624 #: build/C/man4/dsp56k.4:27
4625 #, no-wrap
4626 msgid "DSP56K"
4627 msgstr ""
4628
4629 #. type: Plain text
4630 #: build/C/man4/dsp56k.4:30
4631 msgid "dsp56k - DSP56001 interface device"
4632 msgstr ""
4633
4634 #. type: Plain text
4635 #: build/C/man4/dsp56k.4:33
4636 #, no-wrap
4637 msgid "#include E<lt>asm/dsp56k.hE<gt>\n"
4638 msgstr ""
4639
4640 #. type: Plain text
4641 #: build/C/man4/dsp56k.4:36
4642 #, no-wrap
4643 msgid ""
4644 "B<ssize_t read(int >I<fd>B<, void *>I<data>B<, size_t >I<length>B<);>\n"
4645 "B<ssize_t write(int >I<fd>B<, void *>I<data>B<, size_t >I<length>B<);>\n"
4646 msgstr ""
4647
4648 #. type: Plain text
4649 #: build/C/man4/dsp56k.4:42
4650 #, no-wrap
4651 msgid ""
4652 "B<int ioctl(int >I<fd>B<, DSP56K_UPLOAD, struct dsp56k_upload "
4653 "*>I<program>B<);>\n"
4654 "B<int ioctl(int >I<fd>B<, DSP56K_SET_TX_WSIZE, int >I<wsize>B<);>\n"
4655 "B<int ioctl(int >I<fd>B<, DSP56K_SET_RX_WSIZE, int >I<wsize>B<);>\n"
4656 "B<int ioctl(int >I<fd>B<, DSP56K_HOST_FLAGS, struct dsp56k_host_flags "
4657 "*>I<flags>B<);>\n"
4658 "B<int ioctl(int >I<fd>B<, DSP56K_HOST_CMD, int >I<cmd>B<);>\n"
4659 msgstr ""
4660
4661 #. type: SH
4662 #: 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
4663 #, no-wrap
4664 msgid "CONFIGURATION"
4665 msgstr ""
4666
4667 #. type: Plain text
4668 #: build/C/man4/dsp56k.4:46
4669 msgid ""
4670 "The dsp56k device is a character device with major number 55 and minor "
4671 "number 0."
4672 msgstr ""
4673
4674 #. type: Plain text
4675 #: build/C/man4/dsp56k.4:52
4676 msgid ""
4677 "The Motorola DSP56001 is a fully programmable 24-bit digital signal "
4678 "processor found in Atari Falcon030-compatible computers.  The I<dsp56k> "
4679 "special file is used to control the DSP56001, and to send and receive data "
4680 "using the bidirectional handshaked host port."
4681 msgstr ""
4682
4683 #. type: Plain text
4684 #: build/C/man4/dsp56k.4:62
4685 msgid ""
4686 "To send a data stream to the signal processor, use B<write>(2)  to the "
4687 "device, and B<read>(2)  to receive processed data.  The data can be sent or "
4688 "received in 8, 16, 24, or 32-bit quantities on the host side, but will "
4689 "always be seen as 24-bit quantities in the DSP56001."
4690 msgstr ""
4691
4692 #. type: Plain text
4693 #: build/C/man4/dsp56k.4:67
4694 msgid "The following B<ioctl>(2)  calls are used to control the I<dsp56k> device:"
4695 msgstr ""
4696
4697 #. type: IP
4698 #: build/C/man4/dsp56k.4:67
4699 #, no-wrap
4700 msgid "B<DSP56K_UPLOAD>"
4701 msgstr ""
4702
4703 #. type: Plain text
4704 #: build/C/man4/dsp56k.4:74
4705 msgid ""
4706 "resets the DSP56001 and uploads a program.  The third B<ioctl>(2)  argument "
4707 "must be a pointer to a I<struct dsp56k_binary> with members I<bin> pointing "
4708 "to a DSP56001 binary program, and I<len> set to the length of the program, "
4709 "counted in 24-bit words."
4710 msgstr ""
4711
4712 #. type: IP
4713 #: build/C/man4/dsp56k.4:74
4714 #, no-wrap
4715 msgid "B<DSP56K_SET_TX_WSIZE>"
4716 msgstr ""
4717
4718 #. type: Plain text
4719 #: build/C/man4/dsp56k.4:82
4720 msgid ""
4721 "sets the transmit word size.  Allowed values are in the range 1 to 4, and is "
4722 "the number of bytes that will be sent at a time to the DSP56001.  These data "
4723 "quantities will either be padded with zero bytes, or truncated to fit the "
4724 "native 24-bit data format of the DSP56001."
4725 msgstr ""
4726
4727 #. type: IP
4728 #: build/C/man4/dsp56k.4:82
4729 #, no-wrap
4730 msgid "B<DSP56K_SET_RX_WSIZE>"
4731 msgstr ""
4732
4733 #. type: Plain text
4734 #: build/C/man4/dsp56k.4:89
4735 msgid ""
4736 "sets the receive word size.  Allowed values are in the range 1 to 4, and is "
4737 "the number of bytes that will be received at a time from the DSP56001.  "
4738 "These data quantities will either truncated, or padded with a null byte "
4739 "(\\(aq\\e0\\(aq) to fit the native 24-bit data format of the DSP56001."
4740 msgstr ""
4741
4742 #. type: IP
4743 #: build/C/man4/dsp56k.4:89
4744 #, no-wrap
4745 msgid "B<DSP56K_HOST_FLAGS>"
4746 msgstr ""
4747
4748 #. type: Plain text
4749 #: build/C/man4/dsp56k.4:96
4750 msgid ""
4751 "read and write the host flags.  The host flags are four general-purpose bits "
4752 "that can be read by both the hosting computer and the DSP56001.  Bits 0 and "
4753 "1 can be written by the host, and bits 2 and 3 can be written by the "
4754 "DSP56001."
4755 msgstr ""
4756
4757 #. type: Plain text
4758 #: build/C/man4/dsp56k.4:106
4759 msgid ""
4760 "To access the host flags, the third B<ioctl>(2)  argument must be a pointer "
4761 "to a I<struct dsp56k_host_flags>.  If bit 0 or 1 is set in the I<dir> "
4762 "member, the corresponding bit in I<out> will be written to the host flags.  "
4763 "The state of all host flags will be returned in the lower four bits of the "
4764 "I<status> member."
4765 msgstr ""
4766
4767 #. type: IP
4768 #: build/C/man4/dsp56k.4:106
4769 #, no-wrap
4770 msgid "B<DSP56K_HOST_CMD>"
4771 msgstr ""
4772
4773 #. type: Plain text
4774 #: build/C/man4/dsp56k.4:110
4775 msgid ""
4776 "sends a host command.  Allowed values are in the range 0 to 31, and is a "
4777 "user-defined command handled by the program running in the DSP56001."
4778 msgstr ""
4779
4780 #.  .SH AUTHORS
4781 #.  Fredrik Noring <noring@nocrew.org>, lars brinkhoff <lars@nocrew.org>,
4782 #.  Tomas Berndtsson <tomas@nocrew.org>.
4783 #. type: Plain text
4784 #: build/C/man4/dsp56k.4:115
4785 msgid "/dev/dsp56k"
4786 msgstr ""
4787
4788 #. type: Plain text
4789 #: build/C/man4/dsp56k.4:121
4790 msgid ""
4791 "I<linux/include/asm-m68k/dsp56k.h>, I<linux/drivers/char/dsp56k.c>, E<.UR "
4792 "http://dsp56k.nocrew.org/> E<.UE ,> DSP56000/DSP56001 Digital Signal "
4793 "Processor User's Manual"
4794 msgstr ""
4795
4796 #. type: TH
4797 #: build/C/man4/fd.4:28
4798 #, no-wrap
4799 msgid "FD"
4800 msgstr ""
4801
4802 #. type: TH
4803 #: build/C/man4/fd.4:28
4804 #, no-wrap
4805 msgid "2014-05-10"
4806 msgstr ""
4807
4808 #. type: Plain text
4809 #: build/C/man4/fd.4:31
4810 msgid "fd - floppy disk device"
4811 msgstr ""
4812
4813 #. type: Plain text
4814 #: build/C/man4/fd.4:48
4815 msgid ""
4816 "Floppy drives are block devices with major number 2.  Typically they are "
4817 "owned by I<root.floppy> (i.e., user root, group floppy) and have either mode "
4818 "0660 (access checking via group membership) or mode 0666 (everybody has "
4819 "access).  The minor numbers encode the device type, drive number, and "
4820 "controller number.  For each device type (that is, combination of density "
4821 "and track count)  there is a base minor number.  To this base number, add "
4822 "the drive's number on its controller and 128 if the drive is on the "
4823 "secondary controller.  In the following device tables, I<n> represents the "
4824 "drive number."
4825 msgstr ""
4826
4827 #. type: Plain text
4828 #: build/C/man4/fd.4:55
4829 msgid ""
4830 "B<Warning: If you use formats with more tracks than supported by your drive, "
4831 "you may cause it mechanical damage.> Trying once if more tracks than the "
4832 "usual 40/80 are supported should not damage it, but no warranty is given for "
4833 "that.  If you are not sure, don't create device entries for those formats, "
4834 "so as to prevent their usage."
4835 msgstr ""
4836
4837 #. type: Plain text
4838 #: build/C/man4/fd.4:58
4839 msgid ""
4840 "Drive-independent device files which automatically detect the media format "
4841 "and capacity:"
4842 msgstr ""
4843
4844 #. type: tbl table
4845 #: build/C/man4/fd.4:60
4846 #, no-wrap
4847 msgid "Name\tBase minor #\n"
4848 msgstr ""
4849
4850 #. type: tbl table
4851 #: 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
4852 #, no-wrap
4853 msgid "_\n"
4854 msgstr ""
4855
4856 #. type: tbl table
4857 #: build/C/man4/fd.4:62
4858 #, no-wrap
4859 msgid "B<fd>I<n>\t0\n"
4860 msgstr ""
4861
4862 #. type: Plain text
4863 #: build/C/man4/fd.4:66
4864 msgid "5.25 inch double-density device files:"
4865 msgstr ""
4866
4867 #. type: tbl table
4868 #: 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
4869 #, no-wrap
4870 msgid "Name\tCapac.\tCyl.\tSect.\tHeads\tBase minor #\n"
4871 msgstr ""
4872
4873 #. type: tbl table
4874 #: build/C/man4/fd.4:70
4875 #, no-wrap
4876 msgid "B<fd>I<n>B<d360>\t360K\t40\t9\t2\t4\n"
4877 msgstr ""
4878
4879 #. type: Plain text
4880 #: build/C/man4/fd.4:74
4881 msgid "5.25 inch high-density device files:"
4882 msgstr ""
4883
4884 #. type: tbl table
4885 #: build/C/man4/fd.4:78
4886 #, no-wrap
4887 msgid "B<fd>I<n>B<h360>\t360K\t40\t9\t2\t20\n"
4888 msgstr ""
4889
4890 #. type: tbl table
4891 #: build/C/man4/fd.4:79
4892 #, no-wrap
4893 msgid "B<fd>I<n>B<h410>\t410K\t41\t10\t2\t48\n"
4894 msgstr ""
4895
4896 #. type: tbl table
4897 #: build/C/man4/fd.4:80
4898 #, no-wrap
4899 msgid "B<fd>I<n>B<h420>\t420K\t42\t10\t2\t64\n"
4900 msgstr ""
4901
4902 #. type: tbl table
4903 #: build/C/man4/fd.4:81
4904 #, no-wrap
4905 msgid "B<fd>I<n>B<h720>\t720K\t80\t9\t2\t24\n"
4906 msgstr ""
4907
4908 #. type: tbl table
4909 #: build/C/man4/fd.4:82
4910 #, no-wrap
4911 msgid "B<fd>I<n>B<h880>\t880K\t80\t11\t2\t80\n"
4912 msgstr ""
4913
4914 #. type: tbl table
4915 #: build/C/man4/fd.4:83
4916 #, no-wrap
4917 msgid "B<fd>I<n>B<h1200>\t1200K\t80\t15\t2\t8\n"
4918 msgstr ""
4919
4920 #. type: tbl table
4921 #: build/C/man4/fd.4:84
4922 #, no-wrap
4923 msgid "B<fd>I<n>B<h1440>\t1440K\t80\t18\t2\t40\n"
4924 msgstr ""
4925
4926 #. type: tbl table
4927 #: build/C/man4/fd.4:85
4928 #, no-wrap
4929 msgid "B<fd>I<n>B<h1476>\t1476K\t82\t18\t2\t56\n"
4930 msgstr ""
4931
4932 #. type: tbl table
4933 #: build/C/man4/fd.4:86
4934 #, no-wrap
4935 msgid "B<fd>I<n>B<h1494>\t1494K\t83\t18\t2\t72\n"
4936 msgstr ""
4937
4938 #. type: tbl table
4939 #: build/C/man4/fd.4:87
4940 #, no-wrap
4941 msgid "B<fd>I<n>B<h1600>\t1600K\t80\t20\t2\t92\n"
4942 msgstr ""
4943
4944 #. type: Plain text
4945 #: build/C/man4/fd.4:91
4946 msgid "3.5 inch double-density device files:"
4947 msgstr ""
4948
4949 #. type: tbl table
4950 #: build/C/man4/fd.4:95
4951 #, no-wrap
4952 msgid "B<fd>I<n>B<u360>\t360K\t80\t9\t1\t12\n"
4953 msgstr ""
4954
4955 #. type: tbl table
4956 #: build/C/man4/fd.4:96 build/C/man4/fd.4:108
4957 #, no-wrap
4958 msgid "B<fd>I<n>B<u720>\t720K\t80\t9\t2\t16\n"
4959 msgstr ""
4960
4961 #. type: tbl table
4962 #: build/C/man4/fd.4:97
4963 #, no-wrap
4964 msgid "B<fd>I<n>B<u800>\t800K\t80\t10\t2\t120\n"
4965 msgstr ""
4966
4967 #. type: tbl table
4968 #: build/C/man4/fd.4:98
4969 #, no-wrap
4970 msgid "B<fd>I<n>B<u1040>\t1040K\t80\t13\t2\t84\n"
4971 msgstr ""
4972
4973 #. type: tbl table
4974 #: build/C/man4/fd.4:99
4975 #, no-wrap
4976 msgid "B<fd>I<n>B<u1120>\t1120K\t80\t14\t2\t88\n"
4977 msgstr ""
4978
4979 #. type: Plain text
4980 #: build/C/man4/fd.4:103
4981 msgid "3.5 inch high-density device files:"
4982 msgstr ""
4983
4984 #. type: tbl table
4985 #: build/C/man4/fd.4:107
4986 #, no-wrap
4987 msgid "B<fd>I<n>B<u360>\t360K\t40\t9\t2\t12\n"
4988 msgstr ""
4989
4990 #. type: tbl table
4991 #: build/C/man4/fd.4:109
4992 #, no-wrap
4993 msgid "B<fd>I<n>B<u820>\t820K\t82\t10\t2\t52\n"
4994 msgstr ""
4995
4996 #. type: tbl table
4997 #: build/C/man4/fd.4:110
4998 #, no-wrap
4999 msgid "B<fd>I<n>B<u830>\t830K\t83\t10\t2\t68\n"
5000 msgstr ""
5001
5002 #. type: tbl table
5003 #: build/C/man4/fd.4:111
5004 #, no-wrap
5005 msgid "B<fd>I<n>B<u1440>\t1440K\t80\t18\t2\t28\n"
5006 msgstr ""
5007
5008 #. type: tbl table
5009 #: build/C/man4/fd.4:112
5010 #, no-wrap
5011 msgid "B<fd>I<n>B<u1600>\t1600K\t80\t20\t2\t124\n"
5012 msgstr ""
5013
5014 #. type: tbl table
5015 #: build/C/man4/fd.4:113
5016 #, no-wrap
5017 msgid "B<fd>I<n>B<u1680>\t1680K\t80\t21\t2\t44\n"
5018 msgstr ""
5019
5020 #. type: tbl table
5021 #: build/C/man4/fd.4:114
5022 #, no-wrap
5023 msgid "B<fd>I<n>B<u1722>\t1722K\t82\t21\t2\t60\n"
5024 msgstr ""
5025
5026 #. type: tbl table
5027 #: build/C/man4/fd.4:115
5028 #, no-wrap
5029 msgid "B<fd>I<n>B<u1743>\t1743K\t83\t21\t2\t76\n"
5030 msgstr ""
5031
5032 #. type: tbl table
5033 #: build/C/man4/fd.4:116
5034 #, no-wrap
5035 msgid "B<fd>I<n>B<u1760>\t1760K\t80\t22\t2\t96\n"
5036 msgstr ""
5037
5038 #. type: tbl table
5039 #: build/C/man4/fd.4:117
5040 #, no-wrap
5041 msgid "B<fd>I<n>B<u1840>\t1840K\t80\t23\t2\t116\n"
5042 msgstr ""
5043
5044 #. type: tbl table
5045 #: build/C/man4/fd.4:118
5046 #, no-wrap
5047 msgid "B<fd>I<n>B<u1920>\t1920K\t80\t24\t2\t100\n"
5048 msgstr ""
5049
5050 #. type: Plain text
5051 #: build/C/man4/fd.4:122
5052 msgid "3.5 inch extra-density device files:"
5053 msgstr ""
5054
5055 #. type: tbl table
5056 #: build/C/man4/fd.4:126
5057 #, no-wrap
5058 msgid "B<fd>I<n>B<u2880>\t2880K\t80\t36\t2\t32\n"
5059 msgstr ""
5060
5061 #. type: tbl table
5062 #: build/C/man4/fd.4:127
5063 #, no-wrap
5064 msgid "B<fd>I<n>B<CompaQ>\t2880K\t80\t36\t2\t36\n"
5065 msgstr ""
5066
5067 #. type: tbl table
5068 #: build/C/man4/fd.4:128
5069 #, no-wrap
5070 msgid "B<fd>I<n>B<u3200>\t3200K\t80\t40\t2\t104\n"
5071 msgstr ""
5072
5073 #. type: tbl table
5074 #: build/C/man4/fd.4:129
5075 #, no-wrap
5076 msgid "B<fd>I<n>B<u3520>\t3520K\t80\t44\t2\t108\n"
5077 msgstr ""
5078
5079 #. type: tbl table
5080 #: build/C/man4/fd.4:130
5081 #, no-wrap
5082 msgid "B<fd>I<n>B<u3840>\t3840K\t80\t48\t2\t112\n"
5083 msgstr ""
5084
5085 #. type: Plain text
5086 #: build/C/man4/fd.4:137
5087 msgid ""
5088 "B<fd> special files access the floppy disk drives in raw mode.  The "
5089 "following B<ioctl>(2)  calls are supported by B<fd> devices:"
5090 msgstr ""
5091
5092 #. type: IP
5093 #: build/C/man4/fd.4:137
5094 #, no-wrap
5095 msgid "B<FDCLRPRM>"
5096 msgstr ""
5097
5098 #. type: Plain text
5099 #: build/C/man4/fd.4:139
5100 msgid "clears the media information of a drive (geometry of disk in drive)."
5101 msgstr ""
5102
5103 #. type: IP
5104 #: build/C/man4/fd.4:139
5105 #, no-wrap
5106 msgid "B<FDSETPRM>"
5107 msgstr ""
5108
5109 #. type: Plain text
5110 #: build/C/man4/fd.4:143
5111 msgid ""
5112 "sets the media information of a drive.  The media information will be lost "
5113 "when the media is changed."
5114 msgstr ""
5115
5116 #. type: IP
5117 #: build/C/man4/fd.4:143
5118 #, no-wrap
5119 msgid "B<FDDEFPRM>"
5120 msgstr ""
5121
5122 #. type: Plain text
5123 #: build/C/man4/fd.4:149
5124 msgid ""
5125 "sets the media information of a drive (geometry of disk in drive).  The "
5126 "media information will not be lost when the media is changed.  This will "
5127 "disable autodetection.  In order to reenable autodetection, you have to "
5128 "issue an B<FDCLRPRM>."
5129 msgstr ""
5130
5131 #. type: IP
5132 #: build/C/man4/fd.4:149 build/C/man4/fd.4:161
5133 #, no-wrap
5134 msgid "B<FDGETDRVTYP>"
5135 msgstr ""
5136
5137 #. type: Plain text
5138 #: build/C/man4/fd.4:154
5139 msgid ""
5140 "returns the type of a drive (name parameter).  For formats which work in "
5141 "several drive types, B<FDGETDRVTYP> returns a name which is appropriate for "
5142 "the oldest drive type which supports this format."
5143 msgstr ""
5144
5145 #. type: IP
5146 #: build/C/man4/fd.4:154
5147 #, no-wrap
5148 msgid "B<FDFLUSH>"
5149 msgstr ""
5150
5151 #. type: Plain text
5152 #: build/C/man4/fd.4:156
5153 msgid "invalidates the buffer cache for the given drive."
5154 msgstr ""
5155
5156 #. type: IP
5157 #: build/C/man4/fd.4:156 build/C/man4/fd.4:159
5158 #, no-wrap
5159 msgid "B<FDSETMAXERRS>"
5160 msgstr ""
5161
5162 #. type: Plain text
5163 #: build/C/man4/fd.4:159
5164 msgid ""
5165 "sets the error thresholds for reporting errors, aborting the operation, "
5166 "recalibrating, resetting, and reading sector by sector."
5167 msgstr ""
5168
5169 #. type: Plain text
5170 #: build/C/man4/fd.4:161
5171 msgid "gets the current error thresholds."
5172 msgstr ""
5173
5174 #. type: Plain text
5175 #: build/C/man4/fd.4:163
5176 msgid "gets the internal name of the drive."
5177 msgstr ""
5178
5179 #. type: IP
5180 #: build/C/man4/fd.4:163
5181 #, no-wrap
5182 msgid "B<FDWERRORCLR>"
5183 msgstr ""
5184
5185 #. type: Plain text
5186 #: build/C/man4/fd.4:165
5187 msgid "clears the write error statistics."
5188 msgstr ""
5189
5190 #. type: IP
5191 #: build/C/man4/fd.4:165
5192 #, no-wrap
5193 msgid "B<FDWERRORGET>"
5194 msgstr ""
5195
5196 #. type: Plain text
5197 #: build/C/man4/fd.4:172
5198 msgid ""
5199 "reads the write error statistics.  These include the total number of write "
5200 "errors, the location and disk of the first write error, and the location and "
5201 "disk of the last write error.  Disks are identified by a generation number "
5202 "which is incremented at (almost) each disk change."
5203 msgstr ""
5204
5205 #. type: IP
5206 #: build/C/man4/fd.4:172
5207 #, no-wrap
5208 msgid "B<FDTWADDLE>"
5209 msgstr ""
5210
5211 #. type: Plain text
5212 #: build/C/man4/fd.4:176
5213 msgid ""
5214 "Switch the drive motor off for a few microseconds.  This might be needed in "
5215 "order to access a disk whose sectors are too close together."
5216 msgstr ""
5217
5218 #. type: IP
5219 #: build/C/man4/fd.4:176
5220 #, no-wrap
5221 msgid "B<FDSETDRVPRM>"
5222 msgstr ""
5223
5224 #. type: Plain text
5225 #: build/C/man4/fd.4:178
5226 msgid "sets various drive parameters."
5227 msgstr ""
5228
5229 #. type: IP
5230 #: build/C/man4/fd.4:178
5231 #, no-wrap
5232 msgid "B<FDGETDRVPRM>"
5233 msgstr ""
5234
5235 #. type: Plain text
5236 #: build/C/man4/fd.4:180
5237 msgid "reads these parameters back."
5238 msgstr ""
5239
5240 #. type: IP
5241 #: build/C/man4/fd.4:180
5242 #, no-wrap
5243 msgid "B<FDGETDRVSTAT>"
5244 msgstr ""
5245
5246 #. type: Plain text
5247 #: build/C/man4/fd.4:182
5248 msgid "gets the cached drive state (disk changed, write protected et al.)"
5249 msgstr ""
5250
5251 #. type: IP
5252 #: build/C/man4/fd.4:182
5253 #, no-wrap
5254 msgid "B<FDPOLLDRVSTAT>"
5255 msgstr ""
5256
5257 #. type: Plain text
5258 #: build/C/man4/fd.4:184
5259 msgid "polls the drive and return its state."
5260 msgstr ""
5261
5262 #. type: IP
5263 #: build/C/man4/fd.4:184
5264 #, no-wrap
5265 msgid "B<FDGETFDCSTAT>"
5266 msgstr ""
5267
5268 #. type: Plain text
5269 #: build/C/man4/fd.4:186
5270 msgid "gets the floppy controller state."
5271 msgstr ""
5272
5273 #. type: IP
5274 #: build/C/man4/fd.4:186
5275 #, no-wrap
5276 msgid "B<FDRESET>"
5277 msgstr ""
5278
5279 #. type: Plain text
5280 #: build/C/man4/fd.4:188
5281 msgid "resets the floppy controller under certain conditions."
5282 msgstr ""
5283
5284 #. type: IP
5285 #: build/C/man4/fd.4:188
5286 #, no-wrap
5287 msgid "B<FDRAWCMD>"
5288 msgstr ""
5289
5290 #. type: Plain text
5291 #: build/C/man4/fd.4:190
5292 msgid "sends a raw command to the floppy controller."
5293 msgstr ""
5294
5295 #. type: Plain text
5296 #: build/C/man4/fd.4:195
5297 msgid ""
5298 "For more precise information, consult also the I<E<lt>linux/fd.hE<gt>> and "
5299 "I<E<lt>linux/fdreg.hE<gt>> include files, as well as the B<floppycontrol>(1)  "
5300 "manual page."
5301 msgstr ""
5302
5303 #. type: Plain text
5304 #: build/C/man4/fd.4:197
5305 msgid "/dev/fd*"
5306 msgstr ""
5307
5308 #. type: Plain text
5309 #: build/C/man4/fd.4:203
5310 msgid ""
5311 "The various formats permit reading and writing many types of disks.  "
5312 "However, if a floppy is formatted with an inter-sector gap that is too "
5313 "small, performance may drop, to the point of needing a few seconds to access "
5314 "an entire track.  To prevent this, use interleaved formats."
5315 msgstr ""
5316
5317 #. type: Plain text
5318 #: build/C/man4/fd.4:207
5319 msgid ""
5320 "It is not possible to read floppies which are formatted using GCR (group "
5321 "code recording), which is used by Apple II and Macintosh computers (800k "
5322 "disks)."
5323 msgstr ""
5324
5325 #.  .SH AUTHORS
5326 #.  Alain Knaff (Alain.Knaff@imag.fr), David Niemi
5327 #.  (niemidc@clark.net), Bill Broadhurst (bbroad@netcom.com).
5328 #. type: Plain text
5329 #: build/C/man4/fd.4:214
5330 msgid ""
5331 "Reading floppies which are hard sectored (one hole per sector, with the "
5332 "index hole being a little skewed) is not supported.  This used to be common "
5333 "with older 8-inch floppies."
5334 msgstr ""
5335
5336 #. type: Plain text
5337 #: build/C/man4/fd.4:222
5338 msgid ""
5339 "B<chown>(1), B<floppycontrol>(1), B<getfdprm>(1), B<mknod>(1), "
5340 "B<superformat>(1), B<mount>(8), B<setfdprm>(8)"
5341 msgstr ""
5342
5343 #. type: TH
5344 #: build/C/man7/fifo.7:13
5345 #, no-wrap
5346 msgid "FIFO"
5347 msgstr ""
5348
5349 #. type: TH
5350 #: build/C/man7/fifo.7:13
5351 #, no-wrap
5352 msgid "2008-12-03"
5353 msgstr ""
5354
5355 #. type: Plain text
5356 #: build/C/man7/fifo.7:16
5357 msgid "fifo - first-in first-out special file, named pipe"
5358 msgstr ""
5359
5360 #. type: Plain text
5361 #: build/C/man7/fifo.7:28
5362 msgid ""
5363 "A FIFO special file (a named pipe) is similar to a pipe, except that it is "
5364 "accessed as part of the filesystem.  It can be opened by multiple processes "
5365 "for reading or writing.  When processes are exchanging data via the FIFO, "
5366 "the kernel passes all data internally without writing it to the filesystem.  "
5367 "Thus, the FIFO special file has no contents on the filesystem; the "
5368 "filesystem entry merely serves as a reference point so that processes can "
5369 "access the pipe using a name in the filesystem."
5370 msgstr ""
5371
5372 #. type: Plain text
5373 #: build/C/man7/fifo.7:35
5374 msgid ""
5375 "The kernel maintains exactly one pipe object for each FIFO special file that "
5376 "is opened by at least one process.  The FIFO must be opened on both ends "
5377 "(reading and writing)  before data can be passed.  Normally, opening the "
5378 "FIFO blocks until the other end is opened also."
5379 msgstr ""
5380
5381 #. type: Plain text
5382 #: build/C/man7/fifo.7:44
5383 msgid ""
5384 "A process can open a FIFO in nonblocking mode.  In this case, opening for "
5385 "read-only will succeed even if no-one has opened on the write side yet, "
5386 "opening for write-only will fail with B<ENXIO> (no such device or address) "
5387 "unless the other end has already been opened."
5388 msgstr ""
5389
5390 #. type: Plain text
5391 #: build/C/man7/fifo.7:54
5392 msgid ""
5393 "Under Linux, opening a FIFO for read and write will succeed both in blocking "
5394 "and nonblocking mode.  POSIX leaves this behavior undefined.  This can be "
5395 "used to open a FIFO for writing while there are no readers available.  A "
5396 "process that uses both ends of the connection in order to communicate with "
5397 "itself should be very careful to avoid deadlocks."
5398 msgstr ""
5399
5400 #. type: Plain text
5401 #: build/C/man7/fifo.7:59
5402 msgid ""
5403 "When a process tries to write to a FIFO that is not opened for read on the "
5404 "other side, the process is sent a B<SIGPIPE> signal."
5405 msgstr ""
5406
5407 #. type: Plain text
5408 #: build/C/man7/fifo.7:65
5409 msgid ""
5410 "FIFO special files can be created by B<mkfifo>(3), and are indicated by I<ls "
5411 "-l> with the file type \\(aqp\\(aq."
5412 msgstr ""
5413
5414 #. type: Plain text
5415 #: build/C/man7/fifo.7:74
5416 msgid ""
5417 "B<mkfifo>(1), B<open>(2), B<pipe>(2), B<sigaction>(2), B<signal>(2), "
5418 "B<socketpair>(2), B<mkfifo>(3), B<pipe>(7)"
5419 msgstr ""
5420
5421 #. type: TH
5422 #: build/C/man4/full.4:26
5423 #, no-wrap
5424 msgid "FULL"
5425 msgstr ""
5426
5427 #. type: TH
5428 #: build/C/man4/full.4:26
5429 #, no-wrap
5430 msgid "2007-11-24"
5431 msgstr ""
5432
5433 #. type: Plain text
5434 #: build/C/man4/full.4:29
5435 msgid "full - always full device"
5436 msgstr ""
5437
5438 #. type: Plain text
5439 #: build/C/man4/full.4:34
5440 msgid ""
5441 "If your system does not have I</dev/full> created already, it can be created "
5442 "with the following commands:"
5443 msgstr ""
5444
5445 #. type: Plain text
5446 #: build/C/man4/full.4:38
5447 #, no-wrap
5448 msgid ""
5449 "        mknod -m 666 /dev/full c 1 7\n"
5450 "        chown root:root /dev/full\n"
5451 msgstr ""
5452
5453 #. type: Plain text
5454 #: build/C/man4/full.4:44
5455 msgid "File I</dev/full> has major device number 1 and minor device number 7."
5456 msgstr ""
5457
5458 #. type: Plain text
5459 #: build/C/man4/full.4:51
5460 msgid ""
5461 "Writes to the I</dev/full> device will fail with an B<ENOSPC> error.  This "
5462 "can be used to test how a program handles disk-full errors."
5463 msgstr ""
5464
5465 #. type: Plain text
5466 #: build/C/man4/full.4:55
5467 msgid "Reads from the I</dev/full> device will return \\e0 characters."
5468 msgstr ""
5469
5470 #. type: Plain text
5471 #: build/C/man4/full.4:59
5472 msgid "Seeks on I</dev/full> will always succeed."
5473 msgstr ""
5474
5475 #. type: Plain text
5476 #: build/C/man4/full.4:61
5477 msgid "/dev/full"
5478 msgstr ""
5479
5480 #. type: Plain text
5481 #: build/C/man4/full.4:65
5482 msgid "B<mknod>(1), B<null>(4), B<zero>(4)"
5483 msgstr ""
5484
5485 #. type: TH
5486 #: build/C/man3/gnu_get_libc_version.3:26
5487 #, no-wrap
5488 msgid "GNU_GET_LIBC_VERSION"
5489 msgstr ""
5490
5491 #. type: TH
5492 #: build/C/man3/gnu_get_libc_version.3:26
5493 #, no-wrap
5494 msgid "2012-08-26"
5495 msgstr ""
5496
5497 #. type: Plain text
5498 #: build/C/man3/gnu_get_libc_version.3:29
5499 msgid "gnu_get_libc_version, gnu_get_libc_release - get glibc version and release"
5500 msgstr ""
5501
5502 #. type: Plain text
5503 #: build/C/man3/gnu_get_libc_version.3:32
5504 #, no-wrap
5505 msgid "B<#include E<lt>gnu/libc-version.hE<gt>>\n"
5506 msgstr ""
5507
5508 #. type: Plain text
5509 #: build/C/man3/gnu_get_libc_version.3:35
5510 #, no-wrap
5511 msgid ""
5512 "B<const char *gnu_get_libc_version(void);>\n"
5513 "B<const char *gnu_get_libc_release(void);>\n"
5514 msgstr ""
5515
5516 #. type: Plain text
5517 #: build/C/man3/gnu_get_libc_version.3:40
5518 msgid ""
5519 "The function B<gnu_get_libc_version>()  returns a string that identifies the "
5520 "glibc version available on the system."
5521 msgstr ""
5522
5523 #. type: Plain text
5524 #: build/C/man3/gnu_get_libc_version.3:47
5525 msgid ""
5526 "The function B<gnu_get_libc_release>()  returns a string indicates the "
5527 "release status of the glibc version available on the system.  This will be a "
5528 "string such as I<stable>."
5529 msgstr ""
5530
5531 #. type: SH
5532 #: 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
5533 #, no-wrap
5534 msgid "VERSIONS"
5535 msgstr ""
5536
5537 #. type: Plain text
5538 #: build/C/man3/gnu_get_libc_version.3:49
5539 msgid "These functions first appeared in glibc in version 2.1."
5540 msgstr ""
5541
5542 #. type: SH
5543 #: 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:298 build/C/man3/syslog.3:252 build/C/man7/uri.7:584
5544 #, no-wrap
5545 msgid "CONFORMING TO"
5546 msgstr ""
5547
5548 #. type: Plain text
5549 #: build/C/man3/gnu_get_libc_version.3:51
5550 msgid "These functions are glibc-specific."
5551 msgstr ""
5552
5553 #. type: Plain text
5554 #: build/C/man3/gnu_get_libc_version.3:53
5555 msgid "When run, the program below will produce output such as the following:"
5556 msgstr ""
5557
5558 #. type: Plain text
5559 #: build/C/man3/gnu_get_libc_version.3:59
5560 #, no-wrap
5561 msgid ""
5562 "$B< ./a.out>\n"
5563 "GNU libc version: 2.8\n"
5564 "GNU libc release: stable\n"
5565 msgstr ""
5566
5567 #. type: Plain text
5568 #: build/C/man3/gnu_get_libc_version.3:67
5569 #, no-wrap
5570 msgid ""
5571 "#include E<lt>gnu/libc-version.hE<gt>\n"
5572 "#include E<lt>stdlib.hE<gt>\n"
5573 "#include E<lt>stdio.hE<gt>\n"
5574 msgstr ""
5575
5576 #. type: Plain text
5577 #: build/C/man3/gnu_get_libc_version.3:75
5578 #, no-wrap
5579 msgid ""
5580 "int\n"
5581 "main(int argc, char *argv[])\n"
5582 "{\n"
5583 "    printf(\"GNU libc version: %s\\en\", gnu_get_libc_version());\n"
5584 "    printf(\"GNU libc release: %s\\en\", gnu_get_libc_release());\n"
5585 "    exit(EXIT_SUCCESS);\n"
5586 "}\n"
5587 msgstr ""
5588
5589 #. type: Plain text
5590 #: build/C/man3/gnu_get_libc_version.3:78
5591 msgid "B<confstr>(3)"
5592 msgstr ""
5593
5594 #. type: TH
5595 #: build/C/man4/hd.4:29
5596 #, no-wrap
5597 msgid "HD"
5598 msgstr ""
5599
5600 #. type: TH
5601 #: build/C/man4/hd.4:29
5602 #, no-wrap
5603 msgid "1992-12-17"
5604 msgstr ""
5605
5606 #. type: Plain text
5607 #: build/C/man4/hd.4:32
5608 msgid "hd - MFM/IDE hard disk devices"
5609 msgstr ""
5610
5611 #. type: Plain text
5612 #: build/C/man4/hd.4:47
5613 msgid ""
5614 "The B<hd*> devices are block devices to access MFM/IDE hard disk drives in "
5615 "raw mode.  The master drive on the primary IDE controller (major device "
5616 "number 3) is B<hda>; the slave drive is B<hdb>.  The master drive of the "
5617 "second controller (major device number 22)  is B<hdc> and the slave is "
5618 "B<hdd>."
5619 msgstr ""
5620
5621 #. type: Plain text
5622 #: build/C/man4/hd.4:71
5623 msgid ""
5624 "General IDE block device names have the form B<hd>I<X>, or B<hd>I<XP>, where "
5625 "I<X> is a letter denoting the physical drive, and I<P> is a number denoting "
5626 "the partition on that physical drive.  The first form, B<hd>I<X>, is used to "
5627 "address the whole drive.  Partition numbers are assigned in the order the "
5628 "partitions are discovered, and only nonempty, nonextended partitions get a "
5629 "number.  However, partition numbers 1-4 are given to the four partitions "
5630 "described in the MBR (the \"primary\" partitions), regardless of whether "
5631 "they are unused or extended.  Thus, the first logical partition will be "
5632 "B<hd>I<X>B<5>\\&.  Both DOS-type partitioning and BSD-disklabel partitioning "
5633 "are supported.  You can have at most 63 partitions on an IDE disk."
5634 msgstr ""
5635
5636 #. type: Plain text
5637 #: build/C/man4/hd.4:77
5638 msgid ""
5639 "For example, I</dev/hda> refers to all of the first IDE drive in the system; "
5640 "and I</dev/hdb3> refers to the third DOS \"primary\" partition on the second "
5641 "one."
5642 msgstr ""
5643
5644 #. type: Plain text
5645 #: build/C/man4/hd.4:79 build/C/man4/ttyS.4:34
5646 msgid "They are typically created by:"
5647 msgstr ""
5648
5649 #. type: Plain text
5650 #: build/C/man4/hd.4:82
5651 msgid "mknod -m 660 /dev/hda b 3 0"
5652 msgstr ""
5653
5654 #. type: Plain text
5655 #: build/C/man4/hd.4:84
5656 msgid "mknod -m 660 /dev/hda1 b 3 1"
5657 msgstr ""
5658
5659 #. type: Plain text
5660 #: build/C/man4/hd.4:86
5661 msgid "mknod -m 660 /dev/hda2 b 3 2"
5662 msgstr ""
5663
5664 #. type: Plain text
5665 #: build/C/man4/hd.4:88 build/C/man4/hd.4:98
5666 msgid "\\&..."
5667 msgstr ""
5668
5669 #. type: Plain text
5670 #: build/C/man4/hd.4:90
5671 msgid "mknod -m 660 /dev/hda8 b 3 8"
5672 msgstr ""
5673
5674 #. type: Plain text
5675 #: build/C/man4/hd.4:92
5676 msgid "mknod -m 660 /dev/hdb b 3 64"
5677 msgstr ""
5678
5679 #. type: Plain text
5680 #: build/C/man4/hd.4:94
5681 msgid "mknod -m 660 /dev/hdb1 b 3 65"
5682 msgstr ""
5683
5684 #. type: Plain text
5685 #: build/C/man4/hd.4:96
5686 msgid "mknod -m 660 /dev/hdb2 b 3 66"
5687 msgstr ""
5688
5689 #. type: Plain text
5690 #: build/C/man4/hd.4:100
5691 msgid "mknod -m 660 /dev/hdb8 b 3 72"
5692 msgstr ""
5693
5694 #. type: Plain text
5695 #: build/C/man4/hd.4:102
5696 msgid "chown root:disk /dev/hd*"
5697 msgstr ""
5698
5699 #. type: Plain text
5700 #: build/C/man4/hd.4:105
5701 msgid "/dev/hd*"
5702 msgstr ""
5703
5704 #. type: Plain text
5705 #: build/C/man4/hd.4:110
5706 msgid "B<chown>(1), B<mknod>(1), B<sd>(4), B<mount>(8)"
5707 msgstr ""
5708
5709 #. type: TH
5710 #: build/C/man4/hpsa.4:10
5711 #, no-wrap
5712 msgid "HPSA"
5713 msgstr ""
5714
5715 #. type: Plain text
5716 #: build/C/man4/hpsa.4:13
5717 msgid "hpsa - HP Smart Array SCSI driver"
5718 msgstr ""
5719
5720 #. type: Plain text
5721 #: build/C/man4/hpsa.4:16
5722 #, no-wrap
5723 msgid "modprobe hpsa [ hpsa_allow_any=1 ]\n"
5724 msgstr ""
5725
5726 #. type: Plain text
5727 #: build/C/man4/hpsa.4:20
5728 msgid "B<hpsa> is a SCSI driver for HP Smart Array RAID controllers."
5729 msgstr ""
5730
5731 #. type: Plain text
5732 #: build/C/man4/hpsa.4:39
5733 msgid ""
5734 "I<hpsa_allow_any=1>: This option allows the driver to attempt to operate on "
5735 "any HP Smart Array hardware RAID controller, even if it is not explicitly "
5736 "known to the driver.  This allows newer hardware to work with older "
5737 "drivers.  Typically this is used to allow installation of operating systems "
5738 "from media that predates the RAID controller, though it may also be used to "
5739 "enable B<hpsa> to drive older controllers that would normally be handled by "
5740 "the B<cciss>(4)  driver.  These older boards have not been tested and are "
5741 "not supported with B<hpsa>, and B<cciss>(4)  should still be used for these."
5742 msgstr ""
5743
5744 #. type: Plain text
5745 #: build/C/man4/hpsa.4:43
5746 msgid "The B<hpsa> driver supports the following Smart Array boards:"
5747 msgstr ""
5748
5749 #. type: Plain text
5750 #: build/C/man4/hpsa.4:54
5751 #, no-wrap
5752 msgid ""
5753 "    Smart Array P700M\n"
5754 "    Smart Array P212\n"
5755 "    Smart Array P410\n"
5756 "    Smart Array P410i\n"
5757 "    Smart Array P411\n"
5758 "    Smart Array P812\n"
5759 "    Smart Array P712m\n"
5760 "    Smart Array P711m\n"
5761 "    StorageWorks P1210m\n"
5762 msgstr ""
5763
5764 #. type: Plain text
5765 #: build/C/man4/hpsa.4:78
5766 msgid ""
5767 "Logical drives are accessed via the SCSI disk driver (B<sd>(4)), tape drives "
5768 "via the SCSI tape driver (B<st>(4)), and the RAID controller via the SCSI "
5769 "generic driver (B<sg>(4)), with device nodes named I</dev/sd*>, I</dev/st*>, "
5770 "and I</dev/sg*>, respectively."
5771 msgstr ""
5772
5773 #. type: SS
5774 #: build/C/man4/hpsa.4:78
5775 #, no-wrap
5776 msgid "HPSA-specific host attribute files in /sys"
5777 msgstr ""
5778
5779 #. type: TP
5780 #: build/C/man4/hpsa.4:79
5781 #, no-wrap
5782 msgid "I</sys/class/scsi_host/host*/rescan>"
5783 msgstr ""
5784
5785 #. type: Plain text
5786 #: build/C/man4/hpsa.4:93
5787 msgid ""
5788 "This is a write-only attribute.  Writing to this attribute will cause the "
5789 "driver to scan for new, changed, or removed devices (e.g,. hot-plugged tape "
5790 "drives, or newly configured or deleted logical drives, etc.)  and notify the "
5791 "SCSI midlayer of any changes detected.  Normally a rescan is triggered "
5792 "automatically by HP's Array Configuration Utility (either the GUI or the "
5793 "command-line variety); thus, for logical drive changes, the user should not "
5794 "normally have to use this attribute.  This attribute may be useful when hot "
5795 "plugging devices like tape drives, or entire storage boxes containing "
5796 "preconfigured logical drives."
5797 msgstr ""
5798
5799 #. type: TP
5800 #: build/C/man4/hpsa.4:93
5801 #, no-wrap
5802 msgid "I</sys/class/scsi_host/host*/firmware_revision>"
5803 msgstr ""
5804
5805 #. type: Plain text
5806 #: build/C/man4/hpsa.4:96
5807 msgid "This attribute contains the firmware version of the Smart Array."
5808 msgstr ""
5809
5810 #. type: Plain text
5811 #: build/C/man4/hpsa.4:98
5812 msgid "For example:"
5813 msgstr ""
5814
5815 #. type: Plain text
5816 #: build/C/man4/hpsa.4:103
5817 #, no-wrap
5818 msgid ""
5819 "    # B<cd /sys/class/scsi_host/host4>\n"
5820 "    # B<cat firmware_revision>\n"
5821 "    7.14\n"
5822 msgstr ""
5823
5824 #. type: SS
5825 #: build/C/man4/hpsa.4:104
5826 #, no-wrap
5827 msgid "HPSA-specific disk attribute files in /sys"
5828 msgstr ""
5829
5830 #. type: TP
5831 #: build/C/man4/hpsa.4:105
5832 #, no-wrap
5833 msgid "I</sys/class/scsi_disk/c:b:t:l/device/unique_id>"
5834 msgstr ""
5835
5836 #. type: Plain text
5837 #: build/C/man4/hpsa.4:108
5838 msgid "This attribute contains a 32 hex-digit unique ID for each logical drive."
5839 msgstr ""
5840
5841 #. type: Plain text
5842 #: build/C/man4/hpsa.4:111 build/C/man4/hpsa.4:122 build/C/man4/hpsa.4:136
5843 #, no-wrap
5844 msgid "For example:\n"
5845 msgstr ""
5846
5847 #. type: Plain text
5848 #: build/C/man4/hpsa.4:115
5849 #, no-wrap
5850 msgid ""
5851 "    # B<cd /sys/class/scsi_disk/4:0:0:0/device>\n"
5852 "    # B<cat unique_id>\n"
5853 "    600508B1001044395355323037570F77\n"
5854 msgstr ""
5855
5856 #. type: TP
5857 #: build/C/man4/hpsa.4:116
5858 #, no-wrap
5859 msgid "I</sys/class/scsi_disk/c:b:t:l/device/raid_level>"
5860 msgstr ""
5861
5862 #. type: Plain text
5863 #: build/C/man4/hpsa.4:119
5864 msgid "This attribute contains the RAID level of each logical drive."
5865 msgstr ""
5866
5867 #. type: Plain text
5868 #: build/C/man4/hpsa.4:126
5869 #, no-wrap
5870 msgid ""
5871 "    # B<cd /sys/class/scsi_disk/4:0:0:0/device>\n"
5872 "    # B<cat raid_level>\n"
5873 "    RAID 0\n"
5874 msgstr ""
5875
5876 #. type: TP
5877 #: build/C/man4/hpsa.4:127
5878 #, no-wrap
5879 msgid "I</sys/class/scsi_disk/c:b:t:l/device/lunid>"
5880 msgstr ""
5881
5882 #. type: Plain text
5883 #: build/C/man4/hpsa.4:133
5884 msgid ""
5885 "This attribute contains the 16 hex-digit (8 byte) LUN ID by which a logical "
5886 "drive or physical device can be addressed.  I<c>:I<b>:I<t>:I<l> are the "
5887 "controller, bus, target, and lun of the device."
5888 msgstr ""
5889
5890 #. type: Plain text
5891 #: build/C/man4/hpsa.4:140
5892 #, no-wrap
5893 msgid ""
5894 "    # B<cd /sys/class/scsi_disk/4:0:0:0/device>\n"
5895 "    # B<cat lunid>\n"
5896 "    0x0000004000000000\n"
5897 msgstr ""
5898
5899 #. type: SS
5900 #: build/C/man4/hpsa.4:141
5901 #, no-wrap
5902 msgid "Supported ioctl() operations"
5903 msgstr ""
5904
5905 #. type: Plain text
5906 #: build/C/man4/hpsa.4:153
5907 msgid ""
5908 "For compatibility with applications written for the B<cciss>(4)  driver, "
5909 "many, but not all of the ioctls supported by the B<cciss>(4)  driver are "
5910 "also supported by the B<hpsa> driver.  The data structures used by these "
5911 "ioctls are described in the Linux kernel source file "
5912 "I<include/linux/cciss_ioctl.h>."
5913 msgstr ""
5914
5915 #. type: TP
5916 #: build/C/man4/hpsa.4:153
5917 #, no-wrap
5918 msgid "B<CCISS_DEREGDISK>, B<CCISS_REGNEWDISK>, B<CCISS_REGNEWD>"
5919 msgstr ""
5920
5921 #. type: Plain text
5922 #: build/C/man4/hpsa.4:159
5923 msgid ""
5924 "These three ioctls all do exactly the same thing, which is to cause the "
5925 "driver to rescan for new devices.  This does exactly the same thing as "
5926 "writing to the hpsa-specific host \"rescan\" attribute."
5927 msgstr ""
5928
5929 #. type: TP
5930 #: build/C/man4/hpsa.4:159
5931 #, no-wrap
5932 msgid "B<CCISS_GETPCIINFO>"
5933 msgstr ""
5934
5935 #. type: Plain text
5936 #: build/C/man4/hpsa.4:162
5937 msgid ""
5938 "Returns PCI domain, bus, device and function and \"board ID\" (PCI subsystem "
5939 "ID)."
5940 msgstr ""
5941
5942 #. type: TP
5943 #: build/C/man4/hpsa.4:162
5944 #, no-wrap
5945 msgid "B<CCISS_GETDRIVVER>"
5946 msgstr ""
5947
5948 #. type: Plain text
5949 #: build/C/man4/hpsa.4:165
5950 msgid "Returns driver version in three bytes encoded as:"
5951 msgstr ""
5952
5953 #. type: Plain text
5954 #: build/C/man4/hpsa.4:168
5955 #, no-wrap
5956 msgid ""
5957 "    (major_version E<lt>E<lt> 16) | (minor_version E<lt>E<lt> 8) |\n"
5958 "        (subminor_version)\n"
5959 msgstr ""
5960
5961 #. type: TP
5962 #: build/C/man4/hpsa.4:168
5963 #, no-wrap
5964 msgid "B<CCISS_PASSTHRU>, B<CCISS_BIG_PASSTHRU>"
5965 msgstr ""
5966
5967 #. type: Plain text
5968 #: build/C/man4/hpsa.4:179
5969 msgid ""
5970 "Allows \"BMIC\" and \"CISS\" commands to be passed through to the Smart "
5971 "Array.  These are used extensively by the HP Array Configuration Utility, "
5972 "SNMP storage agents, and so on.  See I<cciss_vol_status> at E<.UR "
5973 "http://cciss.sf.net> E<.UE> for some examples."
5974 msgstr ""
5975
5976 #. type: Plain text
5977 #: build/C/man4/hpsa.4:186
5978 msgid ""
5979 "B<cciss>(4), B<sd>(4), B<st>(4), B<cciss_vol_status>(8), B<hpacucli>(8), "
5980 "B<hpacuxe>(8),"
5981 msgstr ""
5982
5983 #.  .SH AUTHORS
5984 #.  Don Brace, Steve Cameron, Tom Lawler, Mike Miller, Scott Teel
5985 #.  and probably some other people.
5986 #. type: Plain text
5987 #: build/C/man4/hpsa.4:197
5988 msgid ""
5989 "E<.UR http://cciss.sf.net> E<.UE ,> and I<Documentation/scsi/hpsa.txt> and "
5990 "I<Documentation/ABI/testing/sysfs-bus-pci-devices-cciss> in the Linux kernel "
5991 "source tree"
5992 msgstr ""
5993
5994 #. type: TH
5995 #: build/C/man4/initrd.4:35
5996 #, no-wrap
5997 msgid "INITRD"
5998 msgstr ""
5999
6000 #. type: TH
6001 #: build/C/man4/initrd.4:35 build/C/man4/st.4:25
6002 #, no-wrap
6003 msgid "2010-09-04"
6004 msgstr ""
6005
6006 #. type: Plain text
6007 #: build/C/man4/initrd.4:38
6008 msgid "initrd - boot loader initialized RAM disk"
6009 msgstr ""
6010
6011 #. type: Plain text
6012 #: build/C/man4/initrd.4:51
6013 msgid ""
6014 "The I</dev/initrd> is a read-only block device assigned major number 1 and "
6015 "minor number 250.  Typically I</dev/initrd> is owned by I<root.disk> with "
6016 "mode 0400 (read access by root only).  If the Linux system does not have "
6017 "I</dev/initrd> already created, it can be created with the following "
6018 "commands:"
6019 msgstr ""
6020
6021 #. type: Plain text
6022 #: build/C/man4/initrd.4:56
6023 #, no-wrap
6024 msgid ""
6025 "B<\n"
6026 "        mknod -m 400 /dev/initrd b 1 250\n"
6027 "        chown root:disk /dev/initrd>\n"
6028 "\n"
6029 msgstr ""
6030
6031 #. type: Plain text
6032 #: build/C/man4/initrd.4:71
6033 msgid ""
6034 "Also, support for both \"RAM disk\" and \"Initial RAM disk\" (e.g., "
6035 "B<CONFIG_BLK_DEV_RAM=y> and B<CONFIG_BLK_DEV_INITRD=y>)  must be compiled "
6036 "directly into the Linux kernel to use I</dev/initrd>.  When using "
6037 "I</dev/initrd>, the RAM disk driver cannot be loaded as a module."
6038 msgstr ""
6039
6040 #. type: Plain text
6041 #: build/C/man4/initrd.4:80
6042 msgid ""
6043 "The special file I</dev/initrd> is a read-only block device.  This device is "
6044 "a RAM disk that is initialized (e.g., loaded)  by the boot loader before the "
6045 "kernel is started.  The kernel then can use I</dev/initrd>'s contents for a "
6046 "two-phase system boot-up."
6047 msgstr ""
6048
6049 #. type: Plain text
6050 #: build/C/man4/initrd.4:93
6051 msgid ""
6052 "In the first boot-up phase, the kernel starts up and mounts an initial root "
6053 "filesystem from the contents of I</dev/initrd> (e.g., RAM disk initialized "
6054 "by the boot loader).  In the second phase, additional drivers or other "
6055 "modules are loaded from the initial root device's contents.  After loading "
6056 "the additional modules, a new root filesystem (i.e., the normal root "
6057 "filesystem) is mounted from a different device."
6058 msgstr ""
6059
6060 #. type: SS
6061 #: build/C/man4/initrd.4:93
6062 #, no-wrap
6063 msgid "Boot-up operation"
6064 msgstr ""
6065
6066 #. type: Plain text
6067 #: build/C/man4/initrd.4:97
6068 msgid "When booting up with B<initrd>, the system boots as follows:"
6069 msgstr ""
6070
6071 #. type: Plain text
6072 #: build/C/man4/initrd.4:101
6073 msgid ""
6074 "The boot loader loads the kernel program and I</dev/initrd>'s contents into "
6075 "memory."
6076 msgstr ""
6077
6078 #. type: Plain text
6079 #: build/C/man4/initrd.4:109
6080 msgid ""
6081 "On kernel startup, the kernel uncompresses and copies the contents of the "
6082 "device I</dev/initrd> onto device I</dev/ram0> and then frees the memory "
6083 "used by I</dev/initrd>."
6084 msgstr ""
6085
6086 #. type: IP
6087 #: build/C/man4/initrd.4:109 build/C/man4/initrd.4:339 build/C/man4/initrd.4:458 build/C/man4/st.4:919
6088 #, no-wrap
6089 msgid "3."
6090 msgstr ""
6091
6092 #. type: Plain text
6093 #: build/C/man4/initrd.4:113
6094 msgid ""
6095 "The kernel then read-write mounts the device I</dev/ram0> as the initial "
6096 "root filesystem."
6097 msgstr ""
6098
6099 #. type: IP
6100 #: build/C/man4/initrd.4:113 build/C/man4/initrd.4:343 build/C/man4/st.4:926
6101 #, no-wrap
6102 msgid "4."
6103 msgstr ""
6104
6105 #. type: Plain text
6106 #: build/C/man4/initrd.4:118
6107 msgid ""
6108 "If the indicated normal root filesystem is also the initial root filesystem "
6109 "(e.g., I</dev/ram0>)  then the kernel skips to the last step for the usual "
6110 "boot sequence."
6111 msgstr ""
6112
6113 #. type: IP
6114 #: build/C/man4/initrd.4:118 build/C/man4/initrd.4:349 build/C/man4/st.4:931
6115 #, no-wrap
6116 msgid "5."
6117 msgstr ""
6118
6119 #. type: Plain text
6120 #: build/C/man4/initrd.4:130
6121 msgid ""
6122 "If the executable file I</linuxrc> is present in the initial root "
6123 "filesystem, I</linuxrc> is executed with UID 0.  (The file I</linuxrc> must "
6124 "have executable permission.  The file I</linuxrc> can be any valid "
6125 "executable, including a shell script.)"
6126 msgstr ""
6127
6128 #. type: IP
6129 #: build/C/man4/initrd.4:130 build/C/man4/initrd.4:358
6130 #, no-wrap
6131 msgid "6."
6132 msgstr ""
6133
6134 #. type: Plain text
6135 #: build/C/man4/initrd.4:142
6136 msgid ""
6137 "If I</linuxrc> is not executed or when I</linuxrc> terminates, the normal "
6138 "root filesystem is mounted.  (If I</linuxrc> exits with any filesystems "
6139 "mounted on the initial root filesystem, then the behavior of the kernel is "
6140 "B<UNSPECIFIED>.  See the NOTES section for the current kernel behavior.)"
6141 msgstr ""
6142
6143 #. type: IP
6144 #: build/C/man4/initrd.4:142 build/C/man4/initrd.4:360
6145 #, no-wrap
6146 msgid "7."
6147 msgstr ""
6148
6149 #. type: Plain text
6150 #: build/C/man4/initrd.4:173
6151 msgid ""
6152 "If the normal root filesystem has a directory I</initrd>, the device "
6153 "I</dev/ram0> is moved from I</> to I</initrd>.  Otherwise, if the directory "
6154 "I</initrd> does not exist, the device I</dev/ram0> is unmounted.  (When "
6155 "moved from I</> to I</initrd>, I</dev/ram0> is not unmounted and therefore "
6156 "processes can remain running from I</dev/ram0>.  If directory I</initrd> "
6157 "does not exist on the normal root filesystem and any processes remain "
6158 "running from I</dev/ram0> when I</linuxrc> exits, the behavior of the kernel "
6159 "is B<UNSPECIFIED>.  See the NOTES section for the current kernel behavior.)"
6160 msgstr ""
6161
6162 #. type: IP
6163 #: build/C/man4/initrd.4:173 build/C/man4/initrd.4:363
6164 #, no-wrap
6165 msgid "8."
6166 msgstr ""
6167
6168 #. type: Plain text
6169 #: build/C/man4/initrd.4:180
6170 msgid ""
6171 "The usual boot sequence (e.g., invocation of I</sbin/init>)  is performed on "
6172 "the normal root filesystem."
6173 msgstr ""
6174
6175 #. type: Plain text
6176 #: build/C/man4/initrd.4:184
6177 msgid ""
6178 "The following boot loader options, when used with B<initrd>, affect the "
6179 "kernel's boot-up operation:"
6180 msgstr ""
6181
6182 #. type: TP
6183 #: build/C/man4/initrd.4:184
6184 #, no-wrap
6185 msgid "B<initrd=>I<filename>"
6186 msgstr ""
6187
6188 #. type: Plain text
6189 #: build/C/man4/initrd.4:199
6190 msgid ""
6191 "Specifies the file to load as the contents of I</dev/initrd>.  For "
6192 "B<LOADLIN> this is a command-line option.  For B<LILO> you have to use this "
6193 "command in the B<LILO> configuration file I</etc/lilo.config>.  The filename "
6194 "specified with this option will typically be a gzipped filesystem image."
6195 msgstr ""
6196
6197 #. type: TP
6198 #: build/C/man4/initrd.4:199
6199 #, no-wrap
6200 msgid "I<noinitrd>"
6201 msgstr ""
6202
6203 #. type: Plain text
6204 #: build/C/man4/initrd.4:214
6205 msgid ""
6206 "This boot option disables the two-phase boot-up operation.  The kernel "
6207 "performs the usual boot sequence as if I</dev/initrd> was not initialized.  "
6208 "With this option, any contents of I</dev/initrd> loaded into memory by the "
6209 "boot loader contents are preserved.  This option permits the contents of "
6210 "I</dev/initrd> to be any data and need not be limited to a filesystem "
6211 "image.  However, device I</dev/initrd> is read-only and can be read only one "
6212 "time after system startup."
6213 msgstr ""
6214
6215 #. type: TP
6216 #: build/C/man4/initrd.4:214
6217 #, no-wrap
6218 msgid "B<root=>I<device-name>"
6219 msgstr ""
6220
6221 #. type: Plain text
6222 #: build/C/man4/initrd.4:232
6223 msgid ""
6224 "Specifies the device to be used as the normal root filesystem.  For "
6225 "B<LOADLIN> this is a command-line option.  For B<LILO> this is a boot time "
6226 "option or can be used as an option line in the B<LILO> configuration file "
6227 "I</etc/lilo.config>.  The device specified by the this option must be a "
6228 "mountable device having a suitable root filesystem."
6229 msgstr ""
6230
6231 #. type: SS
6232 #: build/C/man4/initrd.4:232
6233 #, no-wrap
6234 msgid "Changing the normal root filesystem"
6235 msgstr ""
6236
6237 #. type: Plain text
6238 #: build/C/man4/initrd.4:252
6239 msgid ""
6240 "By default, the kernel's settings (e.g., set in the kernel file with "
6241 "B<rdev>(8)  or compiled into the kernel file), or the boot loader option "
6242 "setting is used for the normal root filesystems.  For an NFS-mounted normal "
6243 "root filesystem, one has to use the B<nfs_root_name> and B<nfs_root_addrs> "
6244 "boot options to give the NFS settings.  For more information on NFS-mounted "
6245 "root see the kernel documentation file "
6246 "B<Documentation/filesystems/nfsroot.txt>.  For more information on setting "
6247 "the root filesystem see also the B<LILO> and B<LOADLIN> documentation."
6248 msgstr ""
6249
6250 #. type: Plain text
6251 #: build/C/man4/initrd.4:284
6252 msgid ""
6253 "It is also possible for the I</linuxrc> executable to change the normal root "
6254 "device.  For I</linuxrc> to change the normal root device, I</proc> must be "
6255 "mounted.  After mounting I</proc>, I</linuxrc> changes the normal root "
6256 "device by writing into the proc files I</proc/sys/kernel/real-root-dev>, "
6257 "I</proc/sys/kernel/nfs-root-name>, and I</proc/sys/kernel/nfs-root-addrs>.  "
6258 "For a physical root device, the root device is changed by having I</linuxrc> "
6259 "write the new root filesystem device number into "
6260 "I</proc/sys/kernel/real-root-dev>.  For an NFS root filesystem, the root "
6261 "device is changed by having I</linuxrc> write the NFS setting into files "
6262 "I</proc/sys/kernel/nfs-root-name> and I</proc/sys/kernel/nfs-root-addrs> and "
6263 "then writing 0xff (e.g., the pseudo-NFS-device number) into file "
6264 "I</proc/sys/kernel/real-root-dev>.  For example, the following shell command "
6265 "line would change the normal root device to I</dev/hdb1>:"
6266 msgstr ""
6267
6268 #. type: Plain text
6269 #: build/C/man4/initrd.4:287
6270 #, no-wrap
6271 msgid "    echo 0x365 E<gt>/proc/sys/kernel/real-root-dev\n"
6272 msgstr ""
6273
6274 #. type: Plain text
6275 #: build/C/man4/initrd.4:294
6276 msgid ""
6277 "For an NFS example, the following shell command lines would change the "
6278 "normal root device to the NFS directory I</var/nfsroot> on a local networked "
6279 "NFS server with IP number 193.8.232.7 for a system with IP number "
6280 "193.8.232.2 and named \"idefix\":"
6281 msgstr ""
6282
6283 #. type: Plain text
6284 #: build/C/man4/initrd.4:300
6285 #, no-wrap
6286 msgid ""
6287 "    echo /var/nfsroot E<gt>/proc/sys/kernel/nfs-root-name\n"
6288 "    echo 193.8.232.2:193.8.232.7::255.255.255.0:idefix \\e\n"
6289 "        E<gt>/proc/sys/kernel/nfs-root-addrs\n"
6290 "    echo 255 E<gt>/proc/sys/kernel/real-root-dev\n"
6291 msgstr ""
6292
6293 #.  FIXME the manual page should describe the pivot_root mechanism.
6294 #. type: Plain text
6295 #: build/C/man4/initrd.4:317
6296 msgid ""
6297 "B<Note>: The use of I</proc/sys/kernel/real-root-dev> to change the root "
6298 "filesystem is obsolete.  See the Linux kernel source file "
6299 "I<Documentation/initrd.txt> as well as B<pivot_root>(2)  and "
6300 "B<pivot_root>(8)  for information on the modern method of changing the root "
6301 "filesystem."
6302 msgstr ""
6303
6304 #. type: SS
6305 #: build/C/man4/initrd.4:317 build/C/man4/random.4:65 build/C/man7/uri.7:109
6306 #, no-wrap
6307 msgid "Usage"
6308 msgstr ""
6309
6310 #. type: Plain text
6311 #: build/C/man4/initrd.4:321
6312 msgid ""
6313 "The main motivation for implementing B<initrd> was to allow for modular "
6314 "kernel configuration at system installation."
6315 msgstr ""
6316
6317 #. type: Plain text
6318 #: build/C/man4/initrd.4:323
6319 msgid "A possible system installation scenario is as follows:"
6320 msgstr ""
6321
6322 #. type: Plain text
6323 #: build/C/man4/initrd.4:331
6324 msgid ""
6325 "The loader program boots from floppy or other media with a minimal kernel "
6326 "(e.g., support for I</dev/ram>, I</dev/initrd>, and the ext2 filesystem) and "
6327 "loads I</dev/initrd> with a gzipped version of the initial filesystem."
6328 msgstr ""
6329
6330 #. type: Plain text
6331 #: build/C/man4/initrd.4:339
6332 msgid ""
6333 "The executable I</linuxrc> determines what is needed to (1) mount the normal "
6334 "root filesystem (i.e., device type, device drivers, filesystem) and (2) the "
6335 "distribution media (e.g., CD-ROM, network, tape, ...).  This can be done by "
6336 "asking the user, by auto-probing, or by using a hybrid approach."
6337 msgstr ""
6338
6339 #. type: Plain text
6340 #: build/C/man4/initrd.4:343
6341 msgid ""
6342 "The executable I</linuxrc> loads the necessary modules from the initial root "
6343 "filesystem."
6344 msgstr ""
6345
6346 #. type: Plain text
6347 #: build/C/man4/initrd.4:349
6348 msgid ""
6349 "The executable I</linuxrc> creates and populates the root filesystem.  (At "
6350 "this stage the normal root filesystem does not have to be a completed system "
6351 "yet.)"
6352 msgstr ""
6353
6354 #. type: Plain text
6355 #: build/C/man4/initrd.4:358
6356 msgid ""
6357 "The executable I</linuxrc> sets I</proc/sys/kernel/real-root-dev>, unmount "
6358 "I</proc>, the normal root filesystem and any other filesystems it has "
6359 "mounted, and then terminates."
6360 msgstr ""
6361
6362 #. type: Plain text
6363 #: build/C/man4/initrd.4:360
6364 msgid "The kernel then mounts the normal root filesystem."
6365 msgstr ""
6366
6367 #. type: Plain text
6368 #: build/C/man4/initrd.4:363
6369 msgid ""
6370 "Now that the filesystem is accessible and intact, the boot loader can be "
6371 "installed."
6372 msgstr ""
6373
6374 #. type: Plain text
6375 #: build/C/man4/initrd.4:372
6376 msgid ""
6377 "The boot loader is configured to load into I</dev/initrd> a filesystem with "
6378 "the set of modules that was used to bring up the system.  (e.g., Device "
6379 "I</dev/ram0> can be modified, then unmounted, and finally, the image is "
6380 "written from I</dev/ram0> to a file.)"
6381 msgstr ""
6382
6383 #. type: IP
6384 #: build/C/man4/initrd.4:372
6385 #, no-wrap
6386 msgid "9."
6387 msgstr ""
6388
6389 #. type: Plain text
6390 #: build/C/man4/initrd.4:375
6391 msgid ""
6392 "The system is now bootable and additional installation tasks can be "
6393 "performed."
6394 msgstr ""
6395
6396 #. type: Plain text
6397 #: build/C/man4/initrd.4:381
6398 msgid ""
6399 "The key role of I</dev/initrd> in the above is to reuse the configuration "
6400 "data during normal system operation without requiring initial kernel "
6401 "selection, a large generic kernel or, recompiling the kernel."
6402 msgstr ""
6403
6404 #. type: Plain text
6405 #: build/C/man4/initrd.4:394
6406 msgid ""
6407 "A second scenario is for installations where Linux runs on systems with "
6408 "different hardware configurations in a single administrative network.  In "
6409 "such cases, it may be desirable to use only a small set of kernels (ideally "
6410 "only one) and to keep the system-specific part of configuration information "
6411 "as small as possible.  In this case, create a common file with all needed "
6412 "modules.  Then, only the I</linuxrc> file or a file executed by I</linuxrc> "
6413 "would be different."
6414 msgstr ""
6415
6416 #. type: Plain text
6417 #: build/C/man4/initrd.4:401
6418 msgid ""
6419 "A third scenario is more convenient recovery disks.  Because information "
6420 "like the location of the root filesystem partition is not needed at boot "
6421 "time, the system loaded from I</dev/initrd> can use a dialog and/or "
6422 "auto-detection followed by a possible sanity check."
6423 msgstr ""
6424
6425 #. type: Plain text
6426 #: build/C/man4/initrd.4:418
6427 msgid ""
6428 "Last but not least, Linux distributions on CD-ROM may use B<initrd> for easy "
6429 "installation from the CD-ROM.  The distribution can use B<LOADLIN> to "
6430 "directly load I</dev/initrd> from CD-ROM without the need of any floppies.  "
6431 "The distribution could also use a B<LILO> boot floppy and then bootstrap a "
6432 "bigger RAM disk via I</dev/initrd> from the CD-ROM."
6433 msgstr ""
6434
6435 #. type: Plain text
6436 #: build/C/man4/initrd.4:420
6437 msgid "I</dev/initrd>"
6438 msgstr ""
6439
6440 #. type: Plain text
6441 #: build/C/man4/initrd.4:422
6442 msgid "I</dev/ram0>"
6443 msgstr ""
6444
6445 #. type: Plain text
6446 #: build/C/man4/initrd.4:424
6447 msgid "I</linuxrc>"
6448 msgstr ""
6449
6450 #. type: Plain text
6451 #: build/C/man4/initrd.4:429
6452 msgid "I</initrd>"
6453 msgstr ""
6454
6455 #. type: Plain text
6456 #: build/C/man4/initrd.4:441
6457 msgid ""
6458 "With the current kernel, any filesystems that remain mounted when "
6459 "I</dev/ram0> is moved from I</> to I</initrd> continue to be accessible.  "
6460 "However, the I</proc/mounts> entries are not updated."
6461 msgstr ""
6462
6463 #. type: Plain text
6464 #: build/C/man4/initrd.4:458
6465 msgid ""
6466 "With the current kernel, if directory I</initrd> does not exist, then "
6467 "I</dev/ram0> will B<not> be fully unmounted if I</dev/ram0> is used by any "
6468 "process or has any filesystem mounted on it.  If I</dev/ram0> is B<not> "
6469 "fully unmounted, then I</dev/ram0> will remain in memory."
6470 msgstr ""
6471
6472 #
6473 #
6474 #
6475 #.  .SH AUTHORS
6476 #.  The kernel code for device
6477 #.  .BR initrd
6478 #.  was written by Werner Almesberger <almesber@lrc.epfl.ch> and
6479 #.  Hans Lermen <lermen@elserv.ffm.fgan.de>.
6480 #.  The code for
6481 #.  .BR initrd
6482 #.  was added to the baseline Linux kernel in development version 1.3.73.
6483 #. type: Plain text
6484 #: build/C/man4/initrd.4:474
6485 msgid ""
6486 "Users of I</dev/initrd> should not depend on the behavior give in the above "
6487 "notes.  The behavior may change in future versions of the Linux kernel."
6488 msgstr ""
6489
6490 #. type: Plain text
6491 #: build/C/man4/initrd.4:480
6492 msgid "B<chown>(1), B<mknod>(1), B<ram>(4), B<freeramdisk>(8), B<rdev>(8)"
6493 msgstr ""
6494
6495 #. type: Plain text
6496 #: build/C/man4/initrd.4:484
6497 msgid ""
6498 "I<Documentation/initrd.txt> in the Linux kernel source tree, the LILO "
6499 "documentation, the LOADLIN documentation, the SYSLINUX documentation"
6500 msgstr ""
6501
6502 #. type: TH
6503 #: build/C/man4/lp.4:27
6504 #, no-wrap
6505 msgid "LP"
6506 msgstr ""
6507
6508 #. type: TH
6509 #: build/C/man4/lp.4:27
6510 #, no-wrap
6511 msgid "1995-01-15"
6512 msgstr ""
6513
6514 #. type: Plain text
6515 #: build/C/man4/lp.4:30
6516 msgid "lp - line printer devices"
6517 msgstr ""
6518
6519 #. type: Plain text
6520 #: build/C/man4/lp.4:32
6521 msgid "B<#include E<lt>linux/lp.hE<gt>>"
6522 msgstr ""
6523
6524 #. type: Plain text
6525 #: build/C/man4/lp.4:43
6526 msgid ""
6527 "B<lp>[0\\(en2] are character devices for the parallel line printers; they "
6528 "have major number 6 and minor number 0\\(en2.  The minor numbers correspond "
6529 "to the printer port base addresses 0x03bc, 0x0378 and 0x0278.  Usually they "
6530 "have mode 220 and are owned by root and group lp.  You can use printer ports "
6531 "either with polling or with interrupts.  Interrupts are recommended when "
6532 "high traffic is expected, for example, for laser printers.  For usual dot "
6533 "matrix printers polling will usually be enough.  The default is polling."
6534 msgstr ""
6535
6536 #. type: Plain text
6537 #: build/C/man4/lp.4:47
6538 msgid "The following B<ioctl>(2)  calls are supported:"
6539 msgstr ""
6540
6541 #. type: IP
6542 #: build/C/man4/lp.4:47
6543 #, no-wrap
6544 msgid "B<int ioctl(int >I<fd>B<, LPTIME, int >I<arg>B<)>"
6545 msgstr ""
6546
6547 #. type: Plain text
6548 #: build/C/man4/lp.4:56
6549 msgid ""
6550 "Sets the amount of time that the driver sleeps before rechecking the printer "
6551 "when the printer's buffer appears to be filled to I<arg>.  If you have a "
6552 "fast printer, decrease this number; if you have a slow printer, then "
6553 "increase it.  This is in hundredths of a second, the default 2 being 0.02 "
6554 "seconds.  It only influences the polling driver."
6555 msgstr ""
6556
6557 #. type: IP
6558 #: build/C/man4/lp.4:56
6559 #, no-wrap
6560 msgid "B<int ioctl(int >I<fd>B<, LPCHAR, int >I<arg>B<)>"
6561 msgstr ""
6562
6563 #. type: Plain text
6564 #: build/C/man4/lp.4:64
6565 msgid ""
6566 "Sets the maximum number of busy-wait iterations which the polling driver "
6567 "does while waiting for the printer to get ready for receiving a character to "
6568 "I<arg>.  If printing is too slow, increase this number; if the system gets "
6569 "too slow, decrease this number.  The default is 1000.  It only influences "
6570 "the polling driver."
6571 msgstr ""
6572
6573 #. type: IP
6574 #: build/C/man4/lp.4:64
6575 #, no-wrap
6576 msgid "B<int ioctl(int >I<fd>B<, LPABORT, int >I<arg>B<)>"
6577 msgstr ""
6578
6579 #. type: Plain text
6580 #: build/C/man4/lp.4:70
6581 msgid ""
6582 "If I<arg> is 0, the printer driver will retry on errors, otherwise it will "
6583 "abort.  The default is 0."
6584 msgstr ""
6585
6586 #. type: IP
6587 #: build/C/man4/lp.4:70
6588 #, no-wrap
6589 msgid "B<int ioctl(int >I<fd>B<, LPABORTOPEN, int >I<arg>B<)>"
6590 msgstr ""
6591
6592 #. type: Plain text
6593 #: build/C/man4/lp.4:77
6594 msgid ""
6595 "If I<arg> is 0, B<open>(2)  will be aborted on error, otherwise error will "
6596 "be ignored.  The default is to ignore it."
6597 msgstr ""
6598
6599 #. type: IP
6600 #: build/C/man4/lp.4:77
6601 #, no-wrap
6602 msgid "B<int ioctl(int >I<fd>B<, LPCAREFUL, int >I<arg>B<)>"
6603 msgstr ""
6604
6605 #. type: Plain text
6606 #: build/C/man4/lp.4:83
6607 msgid ""
6608 "If I<arg> is 0, then the out-of-paper, offline and error signals are "
6609 "required to be false on all writes, otherwise they are ignored.  The default "
6610 "is to ignore them."
6611 msgstr ""
6612
6613 #. type: IP
6614 #: build/C/man4/lp.4:83
6615 #, no-wrap
6616 msgid "B<int ioctl(int >I<fd>B<, LPWAIT, int >I<arg>B<)>"
6617 msgstr ""
6618
6619 #. type: Plain text
6620 #: build/C/man4/lp.4:94
6621 msgid ""
6622 "Sets the number of busy waiting iterations to wait before strobing the "
6623 "printer to accept a just-written character, and the number of iterations to "
6624 "wait before turning the strobe off again, to I<arg>.  The specification says "
6625 "this time should be 0.5 microseconds, but experience has shown the delay "
6626 "caused by the code is already enough.  For that reason, the default value is "
6627 "0.  This is used for both the polling and the interrupt driver."
6628 msgstr ""
6629
6630 #. type: IP
6631 #: build/C/man4/lp.4:94
6632 #, no-wrap
6633 msgid "B<int ioctl(int >I<fd>B<, LPSETIRQ, int >I<arg>B<)>"
6634 msgstr ""
6635
6636 #. type: Plain text
6637 #: build/C/man4/lp.4:105
6638 msgid ""
6639 "This B<ioctl>(2)  requires superuser privileges.  It takes an I<int> "
6640 "containing the new IRQ as argument.  As a side effect, the printer will be "
6641 "reset.  When I<arg> is 0, the polling driver will be used, which is also "
6642 "default."
6643 msgstr ""
6644
6645 #. type: IP
6646 #: build/C/man4/lp.4:105
6647 #, no-wrap
6648 msgid "B<int ioctl(int >I<fd>B<, LPGETIRQ, int *>I<arg>B<)>"
6649 msgstr ""
6650
6651 #. type: Plain text
6652 #: build/C/man4/lp.4:108
6653 msgid "Stores the currently used IRQ in I<arg>."
6654 msgstr ""
6655
6656 #. type: IP
6657 #: build/C/man4/lp.4:108
6658 #, no-wrap
6659 msgid "B<int ioctl(int >I<fd>B<, LPGETSTATUS, int *>I<arg>B<)>"
6660 msgstr ""
6661
6662 #. type: Plain text
6663 #: build/C/man4/lp.4:112
6664 msgid ""
6665 "Stores the value of the status port in I<arg>.  The bits have the following "
6666 "meaning:"
6667 msgstr ""
6668
6669 #. type: tbl table
6670 #: build/C/man4/lp.4:114
6671 #, no-wrap
6672 msgid "LP_PBUSY\tinverted busy input, active high\n"
6673 msgstr ""
6674
6675 #. type: tbl table
6676 #: build/C/man4/lp.4:115
6677 #, no-wrap
6678 msgid "LP_PACK\tunchanged acknowledge input, active low\n"
6679 msgstr ""
6680
6681 #. type: tbl table
6682 #: build/C/man4/lp.4:116
6683 #, no-wrap
6684 msgid "LP_POUTPA\tunchanged out-of-paper input, active high\n"
6685 msgstr ""
6686
6687 #. type: tbl table
6688 #: build/C/man4/lp.4:117
6689 #, no-wrap
6690 msgid "LP_PSELECD\tunchanged selected input, active high\n"
6691 msgstr ""
6692
6693 #. type: tbl table
6694 #: build/C/man4/lp.4:118
6695 #, no-wrap
6696 msgid "LP_PERRORP\tunchanged error input, active low\n"
6697 msgstr ""
6698
6699 #. type: Plain text
6700 #: build/C/man4/lp.4:123
6701 msgid ""
6702 "Refer to your printer manual for the meaning of the signals.  Note that "
6703 "undocumented bits may also be set, depending on your printer."
6704 msgstr ""
6705
6706 #. type: IP
6707 #: build/C/man4/lp.4:123
6708 #, no-wrap
6709 msgid "B<int ioctl(int >I<fd>B<, LPRESET)>"
6710 msgstr ""
6711
6712 #. type: Plain text
6713 #: build/C/man4/lp.4:126
6714 msgid "Resets the printer.  No argument is used."
6715 msgstr ""
6716
6717 #.  .SH AUTHORS
6718 #.  The printer driver was originally written by Jim Weigand and Linus
6719 #.  Torvalds.
6720 #.  It was further improved by Michael K.\& Johnson.
6721 #.  The interrupt code was written by Nigel Gamble.
6722 #.  Alan Cox modularized it.
6723 #.  LPCAREFUL, LPABORT, LPGETSTATUS were added by Chris Metcalf.
6724 #. type: Plain text
6725 #: build/C/man4/lp.4:135
6726 msgid "/dev/lp*"
6727 msgstr ""
6728
6729 #. type: Plain text
6730 #: build/C/man4/lp.4:141
6731 msgid "B<chmod>(1), B<chown>(1), B<mknod>(1), B<lpcntl>(8), B<tunelp>(8)"
6732 msgstr ""
6733
6734 #. type: TH
6735 #: build/C/man3/makedev.3:26
6736 #, no-wrap
6737 msgid "MAKEDEV"
6738 msgstr ""
6739
6740 #. type: TH
6741 #: build/C/man3/makedev.3:26
6742 #, no-wrap
6743 msgid "2012-05-10"
6744 msgstr ""
6745
6746 #. type: Plain text
6747 #: build/C/man3/makedev.3:29
6748 msgid "makedev, major, minor - manage a device number"
6749 msgstr ""
6750
6751 #. type: Plain text
6752 #: build/C/man3/makedev.3:33
6753 #, no-wrap
6754 msgid ""
6755 "B<#define _BSD_SOURCE>             /* See feature_test_macros(7) */\n"
6756 "B<#include E<lt>sys/types.hE<gt>>\n"
6757 msgstr ""
6758
6759 #. type: Plain text
6760 #: build/C/man3/makedev.3:35
6761 #, no-wrap
6762 msgid "B<dev_t makedev(int >I<maj>B<, int >I<min>B<);>\n"
6763 msgstr ""
6764
6765 #. type: Plain text
6766 #: build/C/man3/makedev.3:38
6767 #, no-wrap
6768 msgid ""
6769 "B<unsigned int major(dev_t >I<dev>B<);>\n"
6770 "B<unsigned int minor(dev_t >I<dev>B<);>\n"
6771 msgstr ""
6772
6773 #. type: Plain text
6774 #: build/C/man3/makedev.3:45
6775 msgid ""
6776 "A device ID consists of two parts: a major ID, identifying the class of the "
6777 "device, and a minor ID, identifying a specific instance of a device in that "
6778 "class.  A device ID is represented using the type I<dev_t>."
6779 msgstr ""
6780
6781 #. type: Plain text
6782 #: build/C/man3/makedev.3:52
6783 msgid ""
6784 "Given major and minor device IDs, B<makedev>()  combines these to produce a "
6785 "device ID, returned as the function result.  This device ID can be given to "
6786 "B<mknod>(2), for example."
6787 msgstr ""
6788
6789 #. type: Plain text
6790 #: build/C/man3/makedev.3:62
6791 msgid ""
6792 "The B<major>()  and B<minor>()  functions perform the converse task: given a "
6793 "device ID, they return, respectively, the major and minor components.  These "
6794 "macros can be useful to, for example, decompose the device IDs in the "
6795 "structure returned by B<stat>(2)."
6796 msgstr ""
6797
6798 #.  The BSDs, HP-UX, Solaris, AIX, Irix
6799 #. type: Plain text
6800 #: build/C/man3/makedev.3:71
6801 msgid ""
6802 "The B<makedev>(), B<major>(), and B<minor>()  functions are not specified in "
6803 "POSIX.1, but are present on many other systems."
6804 msgstr ""
6805
6806 #. type: Plain text
6807 #: build/C/man3/makedev.3:80
6808 msgid ""
6809 "These interfaces are defined as macros.  Since glibc 2.3.3, they have been "
6810 "aliases for three GNU-specific functions: B<gnu_dev_makedev>(), "
6811 "B<gnu_dev_major>(), and B<gnu_dev_minor>().  The latter names are exported, "
6812 "but the traditional names are more portable."
6813 msgstr ""
6814
6815 #. type: Plain text
6816 #: build/C/man3/makedev.3:83
6817 msgid "B<mknod>(2), B<stat>(2)"
6818 msgstr ""
6819
6820 #. type: TH
6821 #: build/C/man4/mem.4:26
6822 #, no-wrap
6823 msgid "MEM"
6824 msgstr ""
6825
6826 #. type: TH
6827 #: build/C/man4/mem.4:26 build/C/man4/ram.4:26
6828 #, no-wrap
6829 msgid "1992-11-21"
6830 msgstr ""
6831
6832 #. type: Plain text
6833 #: build/C/man4/mem.4:29
6834 msgid "mem, kmem, port - system memory, kernel memory and system ports"
6835 msgstr ""
6836
6837 #. type: Plain text
6838 #: build/C/man4/mem.4:34
6839 msgid ""
6840 "B<mem> is a character device file that is an image of the main memory of the "
6841 "computer.  It may be used, for example, to examine (and even patch) the "
6842 "system."
6843 msgstr ""
6844
6845 #. type: Plain text
6846 #: build/C/man4/mem.4:39
6847 msgid ""
6848 "Byte addresses in B<mem> are interpreted as physical memory addresses.  "
6849 "References to nonexistent locations cause errors to be returned."
6850 msgstr ""
6851
6852 #. type: Plain text
6853 #: build/C/man4/mem.4:42
6854 msgid ""
6855 "Examining and patching is likely to lead to unexpected results when "
6856 "read-only or write-only bits are present."
6857 msgstr ""
6858
6859 #. type: Plain text
6860 #: build/C/man4/mem.4:44 build/C/man4/mem.4:59 build/C/man4/mem.4:72 build/C/man4/ram.4:35
6861 msgid "It is typically created by:"
6862 msgstr ""
6863
6864 #. type: Plain text
6865 #: build/C/man4/mem.4:47
6866 msgid "mknod -m 660 /dev/mem c 1 1"
6867 msgstr ""
6868
6869 #. type: Plain text
6870 #: build/C/man4/mem.4:49
6871 msgid "chown root:kmem /dev/mem"
6872 msgstr ""
6873
6874 #. type: Plain text
6875 #: build/C/man4/mem.4:57
6876 msgid ""
6877 "The file B<kmem> is the same as B<mem>, except that the kernel virtual "
6878 "memory rather than physical memory is accessed."
6879 msgstr ""
6880
6881 #. type: Plain text
6882 #: build/C/man4/mem.4:62
6883 msgid "mknod -m 640 /dev/kmem c 1 2"
6884 msgstr ""
6885
6886 #. type: Plain text
6887 #: build/C/man4/mem.4:64
6888 msgid "chown root:kmem /dev/kmem"
6889 msgstr ""
6890
6891 #. type: Plain text
6892 #: build/C/man4/mem.4:70
6893 msgid "B<port> is similar to B<mem>, but the I/O ports are accessed."
6894 msgstr ""
6895
6896 #. type: Plain text
6897 #: build/C/man4/mem.4:75
6898 msgid "mknod -m 660 /dev/port c 1 4"
6899 msgstr ""
6900
6901 #. type: Plain text
6902 #: build/C/man4/mem.4:77
6903 msgid "chown root:mem /dev/port"
6904 msgstr ""
6905
6906 #. type: Plain text
6907 #: build/C/man4/mem.4:80
6908 msgid "I</dev/mem>"
6909 msgstr ""
6910
6911 #. type: Plain text
6912 #: build/C/man4/mem.4:82
6913 msgid "I</dev/kmem>"
6914 msgstr ""
6915
6916 #. type: Plain text
6917 #: build/C/man4/mem.4:84
6918 msgid "I</dev/port>"
6919 msgstr ""
6920
6921 #. type: Plain text
6922 #: build/C/man4/mem.4:88
6923 msgid "B<chown>(1), B<mknod>(1), B<ioperm>(2)"
6924 msgstr ""
6925
6926 #. type: TH
6927 #: build/C/man3/mkfifo.3:28
6928 #, no-wrap
6929 msgid "MKFIFO"
6930 msgstr ""
6931
6932 #. type: TH
6933 #: build/C/man3/mkfifo.3:28
6934 #, no-wrap
6935 msgid "2014-03-24"
6936 msgstr ""
6937
6938 #. type: TH
6939 #: build/C/man3/mkfifo.3:28
6940 #, no-wrap
6941 msgid "GNU"
6942 msgstr ""
6943
6944 #. type: Plain text
6945 #: build/C/man3/mkfifo.3:31
6946 msgid "mkfifo, mkfifoat - make a FIFO special file (a named pipe)"
6947 msgstr ""
6948
6949 #. type: Plain text
6950 #: build/C/man3/mkfifo.3:35
6951 #, no-wrap
6952 msgid ""
6953 "B<#include E<lt>sys/types.hE<gt>>\n"
6954 "B<#include E<lt>sys/stat.hE<gt>>\n"
6955 msgstr ""
6956
6957 #. type: Plain text
6958 #: build/C/man3/mkfifo.3:37
6959 #, no-wrap
6960 msgid "B<int mkfifo(const char *>I<pathname>B<, mode_t >I<mode>B<);>\n"
6961 msgstr ""
6962
6963 #. type: Plain text
6964 #: build/C/man3/mkfifo.3:40 build/C/man2/mknod.2:29
6965 #, no-wrap
6966 msgid ""
6967 "B<#include E<lt>fcntl.hE<gt>           >/* Definition of AT_* constants */\n"
6968 "B<#include E<lt>sys/stat.hE<gt>>\n"
6969 msgstr ""
6970
6971 #. type: Plain text
6972 #: build/C/man3/mkfifo.3:42
6973 #, no-wrap
6974 msgid ""
6975 "B<int mkfifoat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
6976 ">I<mode>B<);>\n"
6977 msgstr ""
6978
6979 #. type: Plain text
6980 #: build/C/man3/mkfifo.3:47 build/C/man2/mknod.2:37 build/C/man3/syslog.3:55
6981 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
6982 msgstr ""
6983
6984 #. type: Plain text
6985 #: build/C/man3/mkfifo.3:50
6986 msgid "B<mkfifoat>():"
6987 msgstr ""
6988
6989 #. type: TP
6990 #: build/C/man3/mkfifo.3:53
6991 #, no-wrap
6992 msgid "Since glibc 2.10:"
6993 msgstr ""
6994
6995 #. type: Plain text
6996 #: build/C/man3/mkfifo.3:56
6997 msgid "_XOPEN_SOURCE\\ E<gt>=\\ 700 || _POSIX_C_SOURCE\\ E<gt>=\\ 200809L"
6998 msgstr ""
6999
7000 #. type: TP
7001 #: build/C/man3/mkfifo.3:56
7002 #, no-wrap
7003 msgid "Before glibc 2.10:"
7004 msgstr ""
7005
7006 #. type: Plain text
7007 #: build/C/man3/mkfifo.3:59
7008 msgid "_ATFILE_SOURCE"
7009 msgstr ""
7010
7011 #. type: Plain text
7012 #: build/C/man3/mkfifo.3:69
7013 msgid ""
7014 "B<mkfifo>()  makes a FIFO special file with name I<pathname>.  I<mode> "
7015 "specifies the FIFO's permissions.  It is modified by the process's B<umask> "
7016 "in the usual way: the permissions of the created file are B<(>I<mode>B< & "
7017 "~umask)>."
7018 msgstr ""
7019
7020 #. type: Plain text
7021 #: build/C/man3/mkfifo.3:76
7022 msgid ""
7023 "A FIFO special file is similar to a pipe, except that it is created in a "
7024 "different way.  Instead of being an anonymous communications channel, a FIFO "
7025 "special file is entered into the filesystem by calling B<mkfifo>()."
7026 msgstr ""
7027
7028 #. type: Plain text
7029 #: build/C/man3/mkfifo.3:86
7030 msgid ""
7031 "Once you have created a FIFO special file in this way, any process can open "
7032 "it for reading or writing, in the same way as an ordinary file.  However, it "
7033 "has to be open at both ends simultaneously before you can proceed to do any "
7034 "input or output operations on it.  Opening a FIFO for reading normally "
7035 "blocks until some other process opens the same FIFO for writing, and vice "
7036 "versa.  See B<fifo>(7)  for nonblocking handling of FIFO special files."
7037 msgstr ""
7038
7039 #. type: SS
7040 #: build/C/man3/mkfifo.3:86
7041 #, no-wrap
7042 msgid "mkfifoat()"
7043 msgstr ""
7044
7045 #. type: Plain text
7046 #: build/C/man3/mkfifo.3:92
7047 msgid ""
7048 "The B<mkfifoat>()  function operates in exactly the same way as B<mkfifo>(), "
7049 "except for the differences described here."
7050 msgstr ""
7051
7052 #. type: Plain text
7053 #: build/C/man3/mkfifo.3:102
7054 msgid ""
7055 "If the pathname given in I<pathname> is relative, then it is interpreted "
7056 "relative to the directory referred to by the file descriptor I<dirfd> "
7057 "(rather than relative to the current working directory of the calling "
7058 "process, as is done by B<mkfifo>()  for a relative pathname)."
7059 msgstr ""
7060
7061 #. type: Plain text
7062 #: build/C/man3/mkfifo.3:114
7063 msgid ""
7064 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
7065 "then I<pathname> is interpreted relative to the current working directory of "
7066 "the calling process (like B<mkfifo>())."
7067 msgstr ""
7068
7069 #. type: Plain text
7070 #: build/C/man3/mkfifo.3:120 build/C/man2/mknod.2:144
7071 msgid "If I<pathname> is absolute, then I<dirfd> is ignored."
7072 msgstr ""
7073
7074 #. type: Plain text
7075 #: build/C/man3/mkfifo.3:128
7076 msgid ""
7077 "On success B<mkfifo>()  and B<mkfifoat>()  return 0.  In the case of an "
7078 "error, -1 is returned (in which case, I<errno> is set appropriately)."
7079 msgstr ""
7080
7081 #. type: TP
7082 #: build/C/man3/mkfifo.3:129 build/C/man2/mknod.2:157 build/C/man4/st.4:829
7083 #, no-wrap
7084 msgid "B<EACCES>"
7085 msgstr ""
7086
7087 #. type: Plain text
7088 #: build/C/man3/mkfifo.3:133
7089 msgid ""
7090 "One of the directories in I<pathname> did not allow search (execute) "
7091 "permission."
7092 msgstr ""
7093
7094 #. type: TP
7095 #: build/C/man3/mkfifo.3:133 build/C/man2/mknod.2:165
7096 #, no-wrap
7097 msgid "B<EDQUOT>"
7098 msgstr ""
7099
7100 #. type: Plain text
7101 #: build/C/man3/mkfifo.3:137 build/C/man2/mknod.2:169
7102 msgid ""
7103 "The user's quota of disk blocks or inodes on the filesystem has been "
7104 "exhausted."
7105 msgstr ""
7106
7107 #. type: TP
7108 #: build/C/man3/mkfifo.3:137 build/C/man2/mknod.2:169
7109 #, no-wrap
7110 msgid "B<EEXIST>"
7111 msgstr ""
7112
7113 #. type: Plain text
7114 #: build/C/man3/mkfifo.3:143 build/C/man2/mknod.2:176
7115 msgid ""
7116 "I<pathname> already exists.  This includes the case where I<pathname> is a "
7117 "symbolic link, dangling or not."
7118 msgstr ""
7119
7120 #. type: TP
7121 #: build/C/man3/mkfifo.3:143 build/C/man2/mknod.2:188
7122 #, no-wrap
7123 msgid "B<ENAMETOOLONG>"
7124 msgstr ""
7125
7126 #. type: Plain text
7127 #: build/C/man3/mkfifo.3:151
7128 msgid ""
7129 "Either the total length of I<pathname> is greater than B<PATH_MAX>, or an "
7130 "individual filename component has a length greater than B<NAME_MAX>.  In the "
7131 "GNU system, there is no imposed limit on overall filename length, but some "
7132 "filesystems may place limits on the length of a component."
7133 msgstr ""
7134
7135 #. type: TP
7136 #: build/C/man3/mkfifo.3:151 build/C/man2/mknod.2:191
7137 #, no-wrap
7138 msgid "B<ENOENT>"
7139 msgstr ""
7140
7141 #. type: Plain text
7142 #: build/C/man3/mkfifo.3:155 build/C/man2/mknod.2:196
7143 msgid ""
7144 "A directory component in I<pathname> does not exist or is a dangling "
7145 "symbolic link."
7146 msgstr ""
7147
7148 #. type: TP
7149 #: build/C/man3/mkfifo.3:155 build/C/man2/mknod.2:199 build/C/man4/st.4:857
7150 #, no-wrap
7151 msgid "B<ENOSPC>"
7152 msgstr ""
7153
7154 #. type: Plain text
7155 #: build/C/man3/mkfifo.3:158
7156 msgid "The directory or filesystem has no room for the new file."
7157 msgstr ""
7158
7159 #. type: TP
7160 #: build/C/man3/mkfifo.3:158 build/C/man3/mkfifo.3:172 build/C/man2/mknod.2:204 build/C/man2/mknod.2:234
7161 #, no-wrap
7162 msgid "B<ENOTDIR>"
7163 msgstr ""
7164
7165 #. type: Plain text
7166 #: build/C/man3/mkfifo.3:162 build/C/man2/mknod.2:209
7167 msgid "A component used as a directory in I<pathname> is not, in fact, a directory."
7168 msgstr ""
7169
7170 #. type: TP
7171 #: build/C/man3/mkfifo.3:162 build/C/man2/mknod.2:223 build/C/man4/st.4:872
7172 #, no-wrap
7173 msgid "B<EROFS>"
7174 msgstr ""
7175
7176 #. type: Plain text
7177 #: build/C/man3/mkfifo.3:165
7178 msgid "I<pathname> refers to a read-only filesystem."
7179 msgstr ""
7180
7181 #. type: Plain text
7182 #: build/C/man3/mkfifo.3:168
7183 msgid "The following additional errors can occur for B<mkfifoat>():"
7184 msgstr ""
7185
7186 #. type: Plain text
7187 #: build/C/man3/mkfifo.3:172 build/C/man2/mknod.2:234
7188 msgid "I<dirfd> is not a valid file descriptor."
7189 msgstr ""
7190
7191 #. type: Plain text
7192 #: build/C/man3/mkfifo.3:178
7193 msgid ""
7194 "I<pathname> is a relative path and I<dirfd> is a file descriptor referring "
7195 "to a file other than a directory."
7196 msgstr ""
7197
7198 #. type: Plain text
7199 #: build/C/man3/mkfifo.3:184
7200 msgid ""
7201 "B<mkfifoat>()  was added to glibc in version 2.4.  It is implemented using "
7202 "B<mknodat>(2), available on Linux since kernel 2.6.16."
7203 msgstr ""
7204
7205 #. type: SH
7206 #: build/C/man3/mkfifo.3:184 build/C/man3/stdarg.3:229
7207 #, no-wrap
7208 msgid "ATTRIBUTES"
7209 msgstr ""
7210
7211 #. type: SS
7212 #: build/C/man3/mkfifo.3:185 build/C/man3/stdarg.3:230
7213 #, no-wrap
7214 msgid "Multithreading (see pthreads(7))"
7215 msgstr ""
7216
7217 #. type: Plain text
7218 #: build/C/man3/mkfifo.3:191
7219 msgid "The B<mkfifo>()  and B<mkfifoat>()  functions are thread-safe."
7220 msgstr ""
7221
7222 #. type: Plain text
7223 #: build/C/man3/mkfifo.3:194
7224 msgid "B<mkfifo>(): POSIX.1-2001, POSIX.1-2008."
7225 msgstr ""
7226
7227 #. type: Plain text
7228 #: build/C/man3/mkfifo.3:197
7229 msgid "B<mkfifoat>(): POSIX.1-2008."
7230 msgstr ""
7231
7232 #. type: Plain text
7233 #: build/C/man3/mkfifo.3:206
7234 msgid ""
7235 "B<mkfifo>(1), B<close>(2), B<open>(2), B<read>(2), B<stat>(2), B<umask>(2), "
7236 "B<write>(2), B<fifo>(7)"
7237 msgstr ""
7238
7239 #. type: TH
7240 #: build/C/man2/mknod.2:15
7241 #, no-wrap
7242 msgid "MKNOD"
7243 msgstr ""
7244
7245 #. type: TH
7246 #: build/C/man2/mknod.2:15
7247 #, no-wrap
7248 msgid "2014-02-21"
7249 msgstr ""
7250
7251 #. type: Plain text
7252 #: build/C/man2/mknod.2:18
7253 msgid "mknod, mknodat - create a special or ordinary file"
7254 msgstr ""
7255
7256 #. type: Plain text
7257 #: build/C/man2/mknod.2:24
7258 #, no-wrap
7259 msgid ""
7260 "B<#include E<lt>sys/types.hE<gt>>\n"
7261 "B<#include E<lt>sys/stat.hE<gt>>\n"
7262 "B<#include E<lt>fcntl.hE<gt>>\n"
7263 "B<#include E<lt>unistd.hE<gt>>\n"
7264 msgstr ""
7265
7266 #. type: Plain text
7267 #: build/C/man2/mknod.2:26
7268 #, no-wrap
7269 msgid ""
7270 "B<int mknod(const char *>I<pathname>B<, mode_t >I<mode>B<, dev_t "
7271 ">I<dev>B<);>\n"
7272 msgstr ""
7273
7274 #. type: Plain text
7275 #: build/C/man2/mknod.2:32
7276 #, no-wrap
7277 msgid ""
7278 "B<int mknodat(int >I<dirfd>B<, const char *>I<pathname>B<, mode_t "
7279 ">I<mode>B<, dev_t >I<dev>B<);>\n"
7280 msgstr ""
7281
7282 #. type: Plain text
7283 #: build/C/man2/mknod.2:40
7284 msgid "B<mknod>():"
7285 msgstr ""
7286
7287 #. type: Plain text
7288 #: build/C/man2/mknod.2:44
7289 msgid ""
7290 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
7291 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
7292 msgstr ""
7293
7294 #. type: Plain text
7295 #: build/C/man2/mknod.2:56
7296 msgid ""
7297 "The system call B<mknod>()  creates a filesystem node (file, device special "
7298 "file, or named pipe) named I<pathname>, with attributes specified by I<mode> "
7299 "and I<dev>."
7300 msgstr ""
7301
7302 #. type: Plain text
7303 #: build/C/man2/mknod.2:63
7304 msgid ""
7305 "The I<mode> argument specifies both the permissions to use and the type of "
7306 "node to be created.  It should be a combination (using bitwise OR) of one of "
7307 "the file types listed below and the permissions for the new node."
7308 msgstr ""
7309
7310 #. type: Plain text
7311 #: build/C/man2/mknod.2:68
7312 msgid ""
7313 "The permissions are modified by the process's I<umask> in the usual way: the "
7314 "permissions of the created node are I<(mode & ~umask)>."
7315 msgstr ""
7316
7317 #.  (S_IFSOCK since Linux 1.2.4)
7318 #. type: Plain text
7319 #: build/C/man2/mknod.2:82
7320 msgid ""
7321 "The file type must be one of B<S_IFREG>, B<S_IFCHR>, B<S_IFBLK>, B<S_IFIFO>, "
7322 "or B<S_IFSOCK> to specify a regular file (which will be created empty), "
7323 "character special file, block special file, FIFO (named pipe), or UNIX "
7324 "domain socket, respectively.  (Zero file type is equivalent to type "
7325 "B<S_IFREG>.)"
7326 msgstr ""
7327
7328 #. type: Plain text
7329 #: build/C/man2/mknod.2:95
7330 msgid ""
7331 "If the file type is B<S_IFCHR> or B<S_IFBLK>, then I<dev> specifies the "
7332 "major and minor numbers of the newly created device special file "
7333 "(B<makedev>(3)  may be useful to build the value for I<dev>); otherwise it "
7334 "is ignored."
7335 msgstr ""
7336
7337 #. type: Plain text
7338 #: build/C/man2/mknod.2:101
7339 msgid ""
7340 "If I<pathname> already exists, or is a symbolic link, this call fails with "
7341 "an B<EEXIST> error."
7342 msgstr ""
7343
7344 #. type: Plain text
7345 #: build/C/man2/mknod.2:110
7346 msgid ""
7347 "The newly created node will be owned by the effective user ID of the "
7348 "process.  If the directory containing the node has the set-group-ID bit set, "
7349 "or if the filesystem is mounted with BSD group semantics, the new node will "
7350 "inherit the group ownership from its parent directory; otherwise it will be "
7351 "owned by the effective group ID of the process."
7352 msgstr ""
7353
7354 #. type: SS
7355 #: build/C/man2/mknod.2:110
7356 #, no-wrap
7357 msgid "mknodat()"
7358 msgstr ""
7359
7360 #. type: Plain text
7361 #: build/C/man2/mknod.2:116
7362 msgid ""
7363 "The B<mknodat>()  system call operates in exactly the same way as "
7364 "B<mknod>(2), except for the differences described here."
7365 msgstr ""
7366
7367 #. type: Plain text
7368 #: build/C/man2/mknod.2:126
7369 msgid ""
7370 "If the pathname given in I<pathname> is relative, then it is interpreted "
7371 "relative to the directory referred to by the file descriptor I<dirfd> "
7372 "(rather than relative to the current working directory of the calling "
7373 "process, as is done by B<mknod>(2)  for a relative pathname)."
7374 msgstr ""
7375
7376 #. type: Plain text
7377 #: build/C/man2/mknod.2:138
7378 msgid ""
7379 "If I<pathname> is relative and I<dirfd> is the special value B<AT_FDCWD>, "
7380 "then I<pathname> is interpreted relative to the current working directory of "
7381 "the calling process (like B<mknod>(2))."
7382 msgstr ""
7383
7384 #. type: Plain text
7385 #: build/C/man2/mknod.2:149
7386 msgid "See B<openat>(2)  for an explanation of the need for B<mknodat>()."
7387 msgstr ""
7388
7389 #. type: Plain text
7390 #: build/C/man2/mknod.2:156
7391 msgid ""
7392 "B<mknod>()  and B<mknodat>()  return zero on success, or -1 if an error "
7393 "occurred (in which case, I<errno> is set appropriately)."
7394 msgstr ""
7395
7396 #. type: Plain text
7397 #: build/C/man2/mknod.2:165
7398 msgid ""
7399 "The parent directory does not allow write permission to the process, or one "
7400 "of the directories in the path prefix of I<pathname> did not allow search "
7401 "permission.  (See also B<path_resolution>(7).)"
7402 msgstr ""
7403
7404 #. type: TP
7405 #: build/C/man2/mknod.2:176 build/C/man4/st.4:838
7406 #, no-wrap
7407 msgid "B<EFAULT>"
7408 msgstr ""
7409
7410 #. type: Plain text
7411 #: build/C/man2/mknod.2:179
7412 msgid "I<pathname> points outside your accessible address space."
7413 msgstr ""
7414
7415 #. type: Plain text
7416 #: build/C/man2/mknod.2:184
7417 msgid ""
7418 "I<mode> requested creation of something other than a regular file, device "
7419 "special file, FIFO or socket."
7420 msgstr ""
7421
7422 #. type: TP
7423 #: build/C/man2/mknod.2:184
7424 #, no-wrap
7425 msgid "B<ELOOP>"
7426 msgstr ""
7427
7428 #. type: Plain text
7429 #: build/C/man2/mknod.2:188
7430 msgid "Too many symbolic links were encountered in resolving I<pathname>."
7431 msgstr ""
7432
7433 #. type: Plain text
7434 #: build/C/man2/mknod.2:191
7435 msgid "I<pathname> was too long."
7436 msgstr ""
7437
7438 #. type: TP
7439 #: build/C/man2/mknod.2:196 build/C/man4/st.4:850
7440 #, no-wrap
7441 msgid "B<ENOMEM>"
7442 msgstr ""
7443
7444 #. type: Plain text
7445 #: build/C/man2/mknod.2:199
7446 msgid "Insufficient kernel memory was available."
7447 msgstr ""
7448
7449 #. type: Plain text
7450 #: build/C/man2/mknod.2:204
7451 msgid "The device containing I<pathname> has no room for the new node."
7452 msgstr ""
7453
7454 #.  For UNIX domain sockets and regular files, EPERM is returned only in
7455 #.  Linux 2.2 and earlier; in Linux 2.4 and later, unprivileged can
7456 #.  use mknod() to make these files.
7457 #. type: Plain text
7458 #: build/C/man2/mknod.2:223
7459 msgid ""
7460 "I<mode> requested creation of something other than a regular file, FIFO "
7461 "(named pipe), or UNIX domain socket, and the caller is not privileged "
7462 "(Linux: does not have the B<CAP_MKNOD> capability); also returned if the "
7463 "filesystem containing I<pathname> does not support the type of node "
7464 "requested."
7465 msgstr ""
7466
7467 #. type: Plain text
7468 #: build/C/man2/mknod.2:227
7469 msgid "I<pathname> refers to a file on a read-only filesystem."
7470 msgstr ""
7471
7472 #. type: Plain text
7473 #: build/C/man2/mknod.2:230
7474 msgid "The following additional errors can occur for B<mknodat>():"
7475 msgstr ""
7476
7477 #. type: Plain text
7478 #: build/C/man2/mknod.2:240
7479 msgid ""
7480 "I<pathname> is relative and I<dirfd> is a file descriptor referring to a "
7481 "file other than a directory."
7482 msgstr ""
7483
7484 #. type: Plain text
7485 #: build/C/man2/mknod.2:244
7486 msgid ""
7487 "B<mknodat>()  was added to Linux in kernel 2.6.16; library support was added "
7488 "to glibc in version 2.4."
7489 msgstr ""
7490
7491 #.  The Linux version differs from the SVr4 version in that it
7492 #.  does not require root permission to create pipes, also in that no
7493 #.  EMULTIHOP, ENOLINK, or EINTR error is documented.
7494 #. type: Plain text
7495 #: build/C/man2/mknod.2:250
7496 msgid "B<mknod>(): SVr4, 4.4BSD, POSIX.1-2001 (but see below), POSIX.1-2008."
7497 msgstr ""
7498
7499 #. type: Plain text
7500 #: build/C/man2/mknod.2:253
7501 msgid "B<mknodat>(): POSIX.1-2008."
7502 msgstr ""
7503
7504 #. type: Plain text
7505 #: build/C/man2/mknod.2:271
7506 msgid ""
7507 "POSIX.1-2001 says: \"The only portable use of B<mknod>()  is to create a "
7508 "FIFO-special file.  If I<mode> is not B<S_IFIFO> or I<dev> is not 0, the "
7509 "behavior of B<mknod>()  is unspecified.\" However, nowadays one should never "
7510 "use B<mknod>()  for this purpose; one should use B<mkfifo>(3), a function "
7511 "especially defined for this purpose."
7512 msgstr ""
7513
7514 #.  and one should make UNIX domain sockets with socket(2) and bind(2).
7515 #. type: Plain text
7516 #: build/C/man2/mknod.2:278
7517 msgid ""
7518 "Under Linux, B<mknod>()  cannot be used to create directories.  One should "
7519 "make directories with B<mkdir>(2)."
7520 msgstr ""
7521
7522 #. type: Plain text
7523 #: build/C/man2/mknod.2:284
7524 msgid ""
7525 "There are many infelicities in the protocol underlying NFS.  Some of these "
7526 "affect B<mknod>()  and B<mknodat>(2)."
7527 msgstr ""
7528
7529 #. type: Plain text
7530 #: build/C/man2/mknod.2:297
7531 msgid ""
7532 "B<chmod>(2), B<chown>(2), B<fcntl>(2), B<mkdir>(2), B<mount>(2), "
7533 "B<socket>(2), B<stat>(2), B<umask>(2), B<unlink>(2), B<makedev>(3), "
7534 "B<mkfifo>(3), B<path_resolution>(7)"
7535 msgstr ""
7536
7537 #. type: TH
7538 #: build/C/man4/mouse.4:26
7539 #, no-wrap
7540 msgid "MOUSE"
7541 msgstr ""
7542
7543 #. type: TH
7544 #: build/C/man4/mouse.4:26
7545 #, no-wrap
7546 msgid "1996-02-10"
7547 msgstr ""
7548
7549 #. type: Plain text
7550 #: build/C/man4/mouse.4:29
7551 msgid "mouse - serial mouse interface"
7552 msgstr ""
7553
7554 #. type: Plain text
7555 #: build/C/man4/mouse.4:33
7556 msgid ""
7557 "Serial mice are connected to a serial RS232/V24 dialout line, see B<ttyS>(4)  "
7558 "for a description."
7559 msgstr ""
7560
7561 #. type: SS
7562 #: build/C/man4/mouse.4:34
7563 #, no-wrap
7564 msgid "Introduction"
7565 msgstr ""
7566
7567 #. type: Plain text
7568 #: build/C/man4/mouse.4:36
7569 msgid "The pinout of the usual 9 pin plug as used for serial mice is:"
7570 msgstr ""
7571
7572 #. type: tbl table
7573 #: build/C/man4/mouse.4:39
7574 #, no-wrap
7575 msgid "pin\tname\tused for\n"
7576 msgstr ""
7577
7578 #. type: tbl table
7579 #: build/C/man4/mouse.4:40
7580 #, no-wrap
7581 msgid "2\tRX\tData\n"
7582 msgstr ""
7583
7584 #. type: tbl table
7585 #: build/C/man4/mouse.4:41
7586 #, no-wrap
7587 msgid "3\tTX\t-12 V, Imax = 10 mA\n"
7588 msgstr ""
7589
7590 #. type: tbl table
7591 #: build/C/man4/mouse.4:42
7592 #, no-wrap
7593 msgid "4\tDTR\t+12 V, Imax = 10 mA\n"
7594 msgstr ""
7595
7596 #. type: tbl table
7597 #: build/C/man4/mouse.4:43
7598 #, no-wrap
7599 msgid "7\tRTS\t+12 V, Imax = 10 mA\n"
7600 msgstr ""
7601
7602 #. type: tbl table
7603 #: build/C/man4/mouse.4:44
7604 #, no-wrap
7605 msgid "5\tGND\tGround\n"
7606 msgstr ""
7607
7608 #. type: Plain text
7609 #: build/C/man4/mouse.4:48
7610 msgid "This is the specification, in fact 9 V suffices with most mice."
7611 msgstr ""
7612
7613 #. type: Plain text
7614 #: build/C/man4/mouse.4:54
7615 msgid ""
7616 "The mouse driver can recognize a mouse by dropping RTS to low and raising it "
7617 "again.  About 14 ms later the mouse will send 0x4D (\\(aqM\\(aq) on the data "
7618 "line.  After a further 63 ms, a Microsoft-compatible 3-button mouse will "
7619 "send 0x33 (\\(aq3\\(aq)."
7620 msgstr ""
7621
7622 #. type: Plain text
7623 #: build/C/man4/mouse.4:66
7624 msgid ""
7625 "The relative mouse movement is sent as I<dx> (positive means right)  and "
7626 "I<dy> (positive means down).  Various mice can operate at different speeds.  "
7627 "To select speeds, cycle through the speeds 9600, 4800, 2400, and 1200 bit/s, "
7628 "each time writing the two characters from the table below and waiting 0.1 "
7629 "seconds.  The following table shows available speeds and the strings that "
7630 "select them:"
7631 msgstr ""
7632
7633 #. type: tbl table
7634 #: build/C/man4/mouse.4:69
7635 #, no-wrap
7636 msgid "bit/s\tstring\n"
7637 msgstr ""
7638
7639 #. type: tbl table
7640 #: build/C/man4/mouse.4:70
7641 #, no-wrap
7642 msgid "9600\t*q\n"
7643 msgstr ""
7644
7645 #. type: tbl table
7646 #: build/C/man4/mouse.4:71
7647 #, no-wrap
7648 msgid "4800\t*p\n"
7649 msgstr ""
7650
7651 #. type: tbl table
7652 #: build/C/man4/mouse.4:72
7653 #, no-wrap
7654 msgid "2400\t*o\n"
7655 msgstr ""
7656
7657 #. type: tbl table
7658 #: build/C/man4/mouse.4:73
7659 #, no-wrap
7660 msgid "1200\t*n\n"
7661 msgstr ""
7662
7663 #. type: Plain text
7664 #: build/C/man4/mouse.4:77
7665 msgid "The first byte of a data packet can be used to synchronization purposes."
7666 msgstr ""
7667
7668 #. type: SS
7669 #: build/C/man4/mouse.4:77
7670 #, no-wrap
7671 msgid "Microsoft protocol"
7672 msgstr ""
7673
7674 #. type: Plain text
7675 #: build/C/man4/mouse.4:93
7676 msgid ""
7677 "The B<Microsoft> protocol uses 1 start bit, 7 data bits, no parity and one "
7678 "stop bit at the speed of 1200 bits/sec.  Data is sent to RxD in 3-byte "
7679 "packets.  The I<dx> and I<dy> movements are sent as two's-complement, I<lb> "
7680 "(I<rb>)  are set when the left (right)  button is pressed:"
7681 msgstr ""
7682
7683 #. type: tbl table
7684 #: build/C/man4/mouse.4:96
7685 #, no-wrap
7686 msgid "byte\td6\td5\td4\td3\td2\td1\td0\n"
7687 msgstr ""
7688
7689 #. type: tbl table
7690 #: build/C/man4/mouse.4:97
7691 #, no-wrap
7692 msgid "1\t1\tlb\trb\tdy7\tdy6\tdx7\tdx6\n"
7693 msgstr ""
7694
7695 #. type: tbl table
7696 #: build/C/man4/mouse.4:98
7697 #, no-wrap
7698 msgid "2\t0\tdx5\tdx4\tdx3\tdx2\tdx1\tdx0\n"
7699 msgstr ""
7700
7701 #. type: tbl table
7702 #: build/C/man4/mouse.4:99
7703 #, no-wrap
7704 msgid "3\t0\tdy5\tdy4\tdy3\tdy2\tdy1\tdy0\n"
7705 msgstr ""
7706
7707 #. type: SS
7708 #: build/C/man4/mouse.4:101
7709 #, no-wrap
7710 msgid "3-button Microsoft protocol"
7711 msgstr ""
7712
7713 #. type: Plain text
7714 #: build/C/man4/mouse.4:110
7715 msgid ""
7716 "Original Microsoft mice only have two buttons.  However, there are some "
7717 "three button mice which also use the Microsoft protocol.  Pressing or "
7718 "releasing the middle button is reported by sending a packet with zero "
7719 "movement and no buttons pressed.  (Thus, unlike for the other two buttons, "
7720 "the status of the middle button is not reported in each packet.)"
7721 msgstr ""
7722
7723 #. type: SS
7724 #: build/C/man4/mouse.4:110
7725 #, no-wrap
7726 msgid "Logitech protocol"
7727 msgstr ""
7728
7729 #. type: Plain text
7730 #: build/C/man4/mouse.4:119
7731 msgid ""
7732 "Logitech serial 3-button mice use a different extension of the Microsoft "
7733 "protocol: when the middle button is up, the above 3-byte packet is sent.  "
7734 "When the middle button is down a 4-byte packet is sent, where the 4th byte "
7735 "has value 0x20 (or at least has the 0x20 bit set).  In particular, a press "
7736 "of the middle button is reported as 0,0,0,0x20 when no other buttons are "
7737 "down."
7738 msgstr ""
7739
7740 #. type: SS
7741 #: build/C/man4/mouse.4:119
7742 #, no-wrap
7743 msgid "Mousesystems protocol"
7744 msgstr ""
7745
7746 #. type: Plain text
7747 #: build/C/man4/mouse.4:137
7748 msgid ""
7749 "The B<Mousesystems> protocol uses 1 start bit, 8 data bits, no parity and "
7750 "two stop bits at the speed of 1200 bits/sec.  Data is sent to RxD in 5-byte "
7751 "packets.  I<dx> is sent as the sum of the two two's-complement values, I<dy> "
7752 "is send as negated sum of the two two's-complement values.  I<lb> (I<mb>, "
7753 "I<rb>)  are cleared when the left (middle, right) button is pressed:"
7754 msgstr ""
7755
7756 #. type: tbl table
7757 #: build/C/man4/mouse.4:140 build/C/man4/mouse.4:175
7758 #, no-wrap
7759 msgid "byte\td7\td6\td5\td4\td3\td2\td1\td0\n"
7760 msgstr ""
7761
7762 #. type: tbl table
7763 #: build/C/man4/mouse.4:141
7764 #, no-wrap
7765 msgid "1\t1\t0\t0\t0\t0\tlb\tmb\trb\n"
7766 msgstr ""
7767
7768 #. type: tbl table
7769 #: build/C/man4/mouse.4:142
7770 #, no-wrap
7771 msgid "2\t0\tdxa6\tdxa5\tdxa4\tdxa3\tdxa2\tdxa1\tdxa0\n"
7772 msgstr ""
7773
7774 #. type: tbl table
7775 #: build/C/man4/mouse.4:143
7776 #, no-wrap
7777 msgid "3\t0\tdya6\tdya5\tdya4\tdya3\tdya2\tdya1\tdya0\n"
7778 msgstr ""
7779
7780 #. type: tbl table
7781 #: build/C/man4/mouse.4:144
7782 #, no-wrap
7783 msgid "4\t0\tdxb6\tdxb5\tdxb4\tdxb3\tdxb2\tdxb1\tdxb0\n"
7784 msgstr ""
7785
7786 #. type: tbl table
7787 #: build/C/man4/mouse.4:145
7788 #, no-wrap
7789 msgid "5\t0\tdyb6\tdyb5\tdyb4\tdyb3\tdyb2\tdyb1\tdyb0\n"
7790 msgstr ""
7791
7792 #. type: Plain text
7793 #: build/C/man4/mouse.4:150
7794 msgid ""
7795 "Bytes 4 and 5 describe the change that occurred since bytes 2 and 3 were "
7796 "transmitted."
7797 msgstr ""
7798
7799 #. type: SS
7800 #: build/C/man4/mouse.4:150
7801 #, no-wrap
7802 msgid "Sun protocol"
7803 msgstr ""
7804
7805 #. type: Plain text
7806 #: build/C/man4/mouse.4:155
7807 msgid ""
7808 "The B<Sun> protocol is the 3-byte version of the above 5-byte Mousesystems "
7809 "protocol: the last two bytes are not sent."
7810 msgstr ""
7811
7812 #. type: SS
7813 #: build/C/man4/mouse.4:155
7814 #, no-wrap
7815 msgid "MM protocol"
7816 msgstr ""
7817
7818 #. type: Plain text
7819 #: build/C/man4/mouse.4:172
7820 msgid ""
7821 "The B<MM> protocol uses 1 start bit, 8 data bits, odd parity and one stop "
7822 "bit at the speed of 1200 bits/sec.  Data is sent to RxD in 3-byte packets.  "
7823 "I<dx> and I<dy> are sent as single signed values, the sign bit indicating a "
7824 "negative value.  I<lb> (I<mb>, I<rb>)  are set when the left (middle, right) "
7825 "button is pressed:"
7826 msgstr ""
7827
7828 #. type: tbl table
7829 #: build/C/man4/mouse.4:176
7830 #, no-wrap
7831 msgid "1\t1\t0\t0\tdxs\tdys\tlb\tmb\trb\n"
7832 msgstr ""
7833
7834 #. type: tbl table
7835 #: build/C/man4/mouse.4:177
7836 #, no-wrap
7837 msgid "2\t0\tdx6\tdx5\tdx4\tdx3\tdx2\tdx1\tdx0\n"
7838 msgstr ""
7839
7840 #. type: tbl table
7841 #: build/C/man4/mouse.4:178
7842 #, no-wrap
7843 msgid "3\t0\tdy6\tdy5\tdy4\tdy3\tdy2\tdy1\tdy0\n"
7844 msgstr ""
7845
7846 #. type: TP
7847 #: build/C/man4/mouse.4:181
7848 #, no-wrap
7849 msgid "I</dev/mouse>"
7850 msgstr ""
7851
7852 #. type: Plain text
7853 #: build/C/man4/mouse.4:184
7854 msgid "A commonly used symlink pointing to a mouse device."
7855 msgstr ""
7856
7857 #. type: Plain text
7858 #: build/C/man4/mouse.4:187
7859 msgid "B<ttyS>(4), B<gpm>(8)"
7860 msgstr ""
7861
7862 #. type: TH
7863 #: build/C/man4/msr.4:26
7864 #, no-wrap
7865 msgid "MSR"
7866 msgstr ""
7867
7868 #. type: Plain text
7869 #: build/C/man4/msr.4:29
7870 msgid "msr - x86 CPU MSR access device"
7871 msgstr ""
7872
7873 #. type: Plain text
7874 #: build/C/man4/msr.4:36
7875 msgid ""
7876 "I</dev/cpu/CPUNUM/msr> provides an interface to read and write the "
7877 "model-specific registers (MSRs) of an x86 CPU.  I<CPUNUM> is the number of "
7878 "the CPU to access as listed in I</proc/cpuinfo>."
7879 msgstr ""
7880
7881 #. type: Plain text
7882 #: build/C/man4/msr.4:42
7883 msgid ""
7884 "The register access is done by opening the file and seeking to the MSR "
7885 "number as offset in the file, and then reading or writing in chunks of 8 "
7886 "bytes.  An I/O transfer of more than 8 bytes means multiple reads or writes "
7887 "of the same register."
7888 msgstr ""
7889
7890 #. type: Plain text
7891 #: build/C/man4/msr.4:47
7892 msgid ""
7893 "This file is protected so that it can be read and written only by the user "
7894 "I<root>, or members of the group I<root>."
7895 msgstr ""
7896
7897 #. type: Plain text
7898 #: build/C/man4/msr.4:53
7899 msgid ""
7900 "The I<msr> driver is not auto-loaded.  On modular kernels you might need to "
7901 "use the following command to load it explicitly before use:"
7902 msgstr ""
7903
7904 #. type: Plain text
7905 #: build/C/man4/msr.4:55
7906 #, no-wrap
7907 msgid "    $ I<modprobe msr>\n"
7908 msgstr ""
7909
7910 #. type: Plain text
7911 #: build/C/man4/msr.4:59
7912 msgid ""
7913 "Intel Corporation Intel 64 and IA-32 Architectures Software Developer's "
7914 "Manual Volume 3B Appendix B, for an overview of the Intel CPU MSRs."
7915 msgstr ""
7916
7917 #. type: TH
7918 #: build/C/man4/null.4:26
7919 #, no-wrap
7920 msgid "NULL"
7921 msgstr ""
7922
7923 #. type: TH
7924 #: build/C/man4/null.4:26
7925 #, no-wrap
7926 msgid "2009-02-23"
7927 msgstr ""
7928
7929 #. type: Plain text
7930 #: build/C/man4/null.4:29
7931 msgid "null, zero - data sink"
7932 msgstr ""
7933
7934 #. type: Plain text
7935 #: build/C/man4/null.4:35
7936 msgid "Data written to a B<null> or B<zero> special file is discarded."
7937 msgstr ""
7938
7939 #. type: Plain text
7940 #: build/C/man4/null.4:44
7941 msgid ""
7942 "Reads from the B<null> special file always return end of file (i.e., "
7943 "B<read>(2)  returns 0), whereas reads from B<zero> always return bytes "
7944 "containing zero (\\e0 characters)."
7945 msgstr ""
7946
7947 #. type: Plain text
7948 #: build/C/man4/null.4:49
7949 msgid "B<null> and B<zero> are typically created by:"
7950 msgstr ""
7951
7952 #. type: Plain text
7953 #: build/C/man4/null.4:52
7954 msgid "mknod -m 666 /dev/null c 1 3"
7955 msgstr ""
7956
7957 #. type: Plain text
7958 #: build/C/man4/null.4:54
7959 msgid "mknod -m 666 /dev/zero c 1 5"
7960 msgstr ""
7961
7962 #. type: Plain text
7963 #: build/C/man4/null.4:56
7964 msgid "chown root:root /dev/null /dev/zero"
7965 msgstr ""
7966
7967 #. type: Plain text
7968 #: build/C/man4/null.4:59
7969 msgid "I</dev/null>"
7970 msgstr ""
7971
7972 #. type: Plain text
7973 #: build/C/man4/null.4:61
7974 msgid "I</dev/zero>"
7975 msgstr ""
7976
7977 #. type: Plain text
7978 #: build/C/man4/null.4:64
7979 msgid ""
7980 "If these devices are not writable and readable for all users, many programs "
7981 "will act strangely."
7982 msgstr ""
7983
7984 #. type: Plain text
7985 #: build/C/man4/null.4:68
7986 msgid "B<chown>(1), B<mknod>(1), B<full>(4)"
7987 msgstr ""
7988
7989 #. type: TH
7990 #: build/C/man7/pipe.7:25
7991 #, no-wrap
7992 msgid "PIPE"
7993 msgstr ""
7994
7995 #. type: TH
7996 #: build/C/man7/pipe.7:25
7997 #, no-wrap
7998 msgid "2005-12-08"
7999 msgstr ""
8000
8001 #. type: Plain text
8002 #: build/C/man7/pipe.7:28
8003 msgid "pipe - overview of pipes and FIFOs"
8004 msgstr ""
8005
8006 #. type: Plain text
8007 #: build/C/man7/pipe.7:37
8008 msgid ""
8009 "Pipes and FIFOs (also known as named pipes)  provide a unidirectional "
8010 "interprocess communication channel.  A pipe has a I<read end> and a I<write "
8011 "end>.  Data written to the write end of a pipe can be read from the read end "
8012 "of the pipe."
8013 msgstr ""
8014
8015 #. type: Plain text
8016 #: build/C/man7/pipe.7:47
8017 msgid ""
8018 "A pipe is created using B<pipe>(2), which creates a new pipe and returns two "
8019 "file descriptors, one referring to the read end of the pipe, the other "
8020 "referring to the write end.  Pipes can be used to create a communication "
8021 "channel between related processes; see B<pipe>(2)  for an example."
8022 msgstr ""
8023
8024 #. type: Plain text
8025 #: build/C/man7/pipe.7:66
8026 msgid ""
8027 "A FIFO (short for First In First Out) has a name within the filesystem "
8028 "(created using B<mkfifo>(3)), and is opened using B<open>(2).  Any process "
8029 "may open a FIFO, assuming the file permissions allow it.  The read end is "
8030 "opened using the B<O_RDONLY> flag; the write end is opened using the "
8031 "B<O_WRONLY> flag.  See B<fifo>(7)  for further details.  I<Note>: although "
8032 "FIFOs have a pathname in the filesystem, I/O on FIFOs does not involve "
8033 "operations on the underlying device (if there is one)."
8034 msgstr ""
8035
8036 #. type: SS
8037 #: build/C/man7/pipe.7:66
8038 #, no-wrap
8039 msgid "I/O on pipes and FIFOs"
8040 msgstr ""
8041
8042 #. type: Plain text
8043 #: build/C/man7/pipe.7:71
8044 msgid ""
8045 "The only difference between pipes and FIFOs is the manner in which they are "
8046 "created and opened.  Once these tasks have been accomplished, I/O on pipes "
8047 "and FIFOs has exactly the same semantics."
8048 msgstr ""
8049
8050 #. type: Plain text
8051 #: build/C/man7/pipe.7:85
8052 msgid ""
8053 "If a process attempts to read from an empty pipe, then B<read>(2)  will "
8054 "block until data is available.  If a process attempts to write to a full "
8055 "pipe (see below), then B<write>(2)  blocks until sufficient data has been "
8056 "read from the pipe to allow the write to complete.  Nonblocking I/O is "
8057 "possible by using the B<fcntl>(2)  B<F_SETFL> operation to enable the "
8058 "B<O_NONBLOCK> open file status flag."
8059 msgstr ""
8060
8061 #. type: Plain text
8062 #: build/C/man7/pipe.7:89
8063 msgid ""
8064 "The communication channel provided by a pipe is a I<byte stream>: there is "
8065 "no concept of message boundaries."
8066 msgstr ""
8067
8068 #. type: Plain text
8069 #: build/C/man7/pipe.7:116
8070 msgid ""
8071 "If all file descriptors referring to the write end of a pipe have been "
8072 "closed, then an attempt to B<read>(2)  from the pipe will see end-of-file "
8073 "(B<read>(2)  will return 0).  If all file descriptors referring to the read "
8074 "end of a pipe have been closed, then a B<write>(2)  will cause a B<SIGPIPE> "
8075 "signal to be generated for the calling process.  If the calling process is "
8076 "ignoring this signal, then B<write>(2)  fails with the error B<EPIPE>.  An "
8077 "application that uses B<pipe>(2)  and B<fork>(2)  should use suitable "
8078 "B<close>(2)  calls to close unnecessary duplicate file descriptors; this "
8079 "ensures that end-of-file and B<SIGPIPE>/B<EPIPE> are delivered when "
8080 "appropriate."
8081 msgstr ""
8082
8083 #. type: Plain text
8084 #: build/C/man7/pipe.7:120
8085 msgid "It is not possible to apply B<lseek>(2)  to a pipe."
8086 msgstr ""
8087
8088 #. type: SS
8089 #: build/C/man7/pipe.7:120
8090 #, no-wrap
8091 msgid "Pipe capacity"
8092 msgstr ""
8093
8094 #. type: Plain text
8095 #: build/C/man7/pipe.7:132
8096 msgid ""
8097 "A pipe has a limited capacity.  If the pipe is full, then a B<write>(2)  "
8098 "will block or fail, depending on whether the B<O_NONBLOCK> flag is set (see "
8099 "below).  Different implementations have different limits for the pipe "
8100 "capacity.  Applications should not rely on a particular capacity: an "
8101 "application should be designed so that a reading process consumes data as "
8102 "soon as it is available, so that a writing process does not remain blocked."
8103 msgstr ""
8104
8105 #. type: Plain text
8106 #: build/C/man7/pipe.7:136
8107 msgid ""
8108 "In Linux versions before 2.6.11, the capacity of a pipe was the same as the "
8109 "system page size (e.g., 4096 bytes on i386).  Since Linux 2.6.11, the pipe "
8110 "capacity is 65536 bytes."
8111 msgstr ""
8112
8113 #. type: SS
8114 #: build/C/man7/pipe.7:136
8115 #, no-wrap
8116 msgid "PIPE_BUF"
8117 msgstr ""
8118
8119 #. type: Plain text
8120 #: build/C/man7/pipe.7:158
8121 msgid ""
8122 "POSIX.1-2001 says that B<write>(2)s of less than B<PIPE_BUF> bytes must be "
8123 "atomic: the output data is written to the pipe as a contiguous sequence.  "
8124 "Writes of more than B<PIPE_BUF> bytes may be nonatomic: the kernel may "
8125 "interleave the data with data written by other processes.  POSIX.1-2001 "
8126 "requires B<PIPE_BUF> to be at least 512 bytes.  (On Linux, B<PIPE_BUF> is "
8127 "4096 bytes.)  The precise semantics depend on whether the file descriptor is "
8128 "nonblocking (B<O_NONBLOCK>), whether there are multiple writers to the pipe, "
8129 "and on I<n>, the number of bytes to be written:"
8130 msgstr ""
8131
8132 #. type: TP
8133 #: build/C/man7/pipe.7:158
8134 #, no-wrap
8135 msgid "B<O_NONBLOCK> disabled, I<n> E<lt>= B<PIPE_BUF>"
8136 msgstr ""
8137
8138 #. type: Plain text
8139 #: build/C/man7/pipe.7:167
8140 msgid ""
8141 "All I<n> bytes are written atomically; B<write>(2)  may block if there is "
8142 "not room for I<n> bytes to be written immediately"
8143 msgstr ""
8144
8145 #. type: TP
8146 #: build/C/man7/pipe.7:167
8147 #, no-wrap
8148 msgid "B<O_NONBLOCK> enabled, I<n> E<lt>= B<PIPE_BUF>"
8149 msgstr ""
8150
8151 #. type: Plain text
8152 #: build/C/man7/pipe.7:181
8153 msgid ""
8154 "If there is room to write I<n> bytes to the pipe, then B<write>(2)  succeeds "
8155 "immediately, writing all I<n> bytes; otherwise B<write>(2)  fails, with "
8156 "I<errno> set to B<EAGAIN>."
8157 msgstr ""
8158
8159 #. type: TP
8160 #: build/C/man7/pipe.7:181
8161 #, no-wrap
8162 msgid "B<O_NONBLOCK> disabled, I<n> E<gt> B<PIPE_BUF>"
8163 msgstr ""
8164
8165 #. type: Plain text
8166 #: build/C/man7/pipe.7:193
8167 msgid ""
8168 "The write is nonatomic: the data given to B<write>(2)  may be interleaved "
8169 "with B<write>(2)s by other process; the B<write>(2)  blocks until I<n> bytes "
8170 "have been written."
8171 msgstr ""
8172
8173 #. type: TP
8174 #: build/C/man7/pipe.7:193
8175 #, no-wrap
8176 msgid "B<O_NONBLOCK> enabled, I<n> E<gt> B<PIPE_BUF>"
8177 msgstr ""
8178
8179 #. type: Plain text
8180 #: build/C/man7/pipe.7:208
8181 msgid ""
8182 "If the pipe is full, then B<write>(2)  fails, with I<errno> set to "
8183 "B<EAGAIN>.  Otherwise, from 1 to I<n> bytes may be written (i.e., a "
8184 "\"partial write\" may occur; the caller should check the return value from "
8185 "B<write>(2)  to see how many bytes were actually written), and these bytes "
8186 "may be interleaved with writes by other processes."
8187 msgstr ""
8188
8189 #. type: SS
8190 #: build/C/man7/pipe.7:208
8191 #, no-wrap
8192 msgid "Open file status flags"
8193 msgstr ""
8194
8195 #. type: Plain text
8196 #: build/C/man7/pipe.7:214
8197 msgid ""
8198 "The only open file status flags that can be meaningfully applied to a pipe "
8199 "or FIFO are B<O_NONBLOCK> and B<O_ASYNC>."
8200 msgstr ""
8201
8202 #. type: Plain text
8203 #: build/C/man7/pipe.7:226
8204 msgid ""
8205 "Setting the B<O_ASYNC> flag for the read end of a pipe causes a signal "
8206 "(B<SIGIO> by default) to be generated when new input becomes available on "
8207 "the pipe (see B<fcntl>(2)  for details).  On Linux, B<O_ASYNC> is supported "
8208 "for pipes and FIFOs only since kernel 2.6."
8209 msgstr ""
8210
8211 #. type: SS
8212 #: build/C/man7/pipe.7:226
8213 #, no-wrap
8214 msgid "Portability notes"
8215 msgstr ""
8216
8217 #. type: Plain text
8218 #: build/C/man7/pipe.7:232
8219 msgid ""
8220 "On some systems (but not Linux), pipes are bidirectional: data can be "
8221 "transmitted in both directions between the pipe ends.  According to "
8222 "POSIX.1-2001, pipes only need to be unidirectional.  Portable applications "
8223 "should avoid reliance on bidirectional pipe semantics."
8224 msgstr ""
8225
8226 #. type: Plain text
8227 #: build/C/man7/pipe.7:244
8228 msgid ""
8229 "B<dup>(2), B<fcntl>(2), B<open>(2), B<pipe>(2), B<poll>(2), B<select>(2), "
8230 "B<socketpair>(2), B<stat>(2), B<mkfifo>(3), B<epoll>(7), B<fifo>(7)"
8231 msgstr ""
8232
8233 #. type: TH
8234 #: build/C/man4/ram.4:26
8235 #, no-wrap
8236 msgid "RAM"
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:47
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 "2013-03-15"
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:47
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 msgstr ""
8324
8325 #. type: Plain text
8326 #: build/C/man4/random.4:58
8327 msgid ""
8328 "A read from the I</dev/urandom> device will not block waiting for more "
8329 "entropy.  As a result, if there is not sufficient entropy in the entropy "
8330 "pool, the returned values are theoretically vulnerable to a cryptographic "
8331 "attack on the algorithms used by the driver.  Knowledge of how to do this is "
8332 "not available in the current unclassified literature, but it is "
8333 "theoretically possible that such an attack may exist.  If this is a concern "
8334 "in your application, use I</dev/random> instead."
8335 msgstr ""
8336
8337 #. type: Plain text
8338 #: build/C/man4/random.4:65
8339 msgid ""
8340 "Writing to I</dev/random> or I</dev/urandom> will update the entropy pool "
8341 "with the data written, but this will not result in a higher entropy count.  "
8342 "This means that it will impact the contents read from both files, but it "
8343 "will not make reads from I</dev/random> faster."
8344 msgstr ""
8345
8346 #. type: Plain text
8347 #: build/C/man4/random.4:74
8348 msgid ""
8349 "If you are unsure about whether you should use I</dev/random> or "
8350 "I</dev/urandom>, then probably you want to use the latter.  As a general "
8351 "rule, I</dev/urandom> should be used for everything except long-lived "
8352 "GPG/SSL/SSH keys."
8353 msgstr ""
8354
8355 #. type: Plain text
8356 #: build/C/man4/random.4:86
8357 msgid ""
8358 "If a seed file is saved across reboots as recommended below (all major Linux "
8359 "distributions have done this since 2000 at least), the output is "
8360 "cryptographically secure against attackers without local root access as soon "
8361 "as it is reloaded in the boot sequence, and perfectly adequate for network "
8362 "encryption session keys.  Since reads from I</dev/random> may block, users "
8363 "will usually want to open it in nonblocking mode (or perform a read with "
8364 "timeout), and provide some sort of user notification if the desired entropy "
8365 "is not immediately available."
8366 msgstr ""
8367
8368 #. type: Plain text
8369 #: build/C/man4/random.4:99
8370 msgid ""
8371 "The kernel random-number generator is designed to produce a small amount of "
8372 "high-quality seed material to seed a cryptographic pseudo-random number "
8373 "generator (CPRNG).  It is designed for security, not speed, and is poorly "
8374 "suited to generating large amounts of random data.  Users should be very "
8375 "economical in the amount of seed material that they read from "
8376 "I</dev/urandom> (and I</dev/random>); unnecessarily reading large quantities "
8377 "of data from this device will have a negative impact on other users of the "
8378 "device."
8379 msgstr ""
8380
8381 #. type: Plain text
8382 #: build/C/man4/random.4:107
8383 msgid ""
8384 "The amount of seed material required to generate a cryptographic key equals "
8385 "the effective key size of the key.  For example, a 3072-bit RSA or "
8386 "Diffie-Hellman private key has an effective key size of 128 bits (it "
8387 "requires about 2^128 operations to break) so a key generator only needs 128 "
8388 "bits (16 bytes) of seed material from I</dev/random>."
8389 msgstr ""
8390
8391 #. type: Plain text
8392 #: build/C/man4/random.4:116
8393 msgid ""
8394 "While some safety margin above that minimum is reasonable, as a guard "
8395 "against flaws in the CPRNG algorithm, no cryptographic primitive available "
8396 "today can hope to promise more than 256 bits of security, so if any program "
8397 "reads more than 256 bits (32 bytes) from the kernel random pool per "
8398 "invocation, or per reasonable reseed interval (not less than one minute), "
8399 "that should be taken as a sign that its cryptography is I<not> skillfully "
8400 "implemented."
8401 msgstr ""
8402
8403 #. type: SS
8404 #: build/C/man4/random.4:116
8405 #, no-wrap
8406 msgid "Configuration"
8407 msgstr ""
8408
8409 #. type: Plain text
8410 #: build/C/man4/random.4:120
8411 msgid ""
8412 "If your system does not have I</dev/random> and I</dev/urandom> created "
8413 "already, they can be created with the following commands:"
8414 msgstr ""
8415
8416 #. type: Plain text
8417 #: build/C/man4/random.4:125
8418 #, no-wrap
8419 msgid ""
8420 "    mknod -m 644 /dev/random c 1 8\n"
8421 "    mknod -m 644 /dev/urandom c 1 9\n"
8422 "    chown root:root /dev/random /dev/urandom\n"
8423 msgstr ""
8424
8425 #. type: Plain text
8426 #: build/C/man4/random.4:135
8427 msgid ""
8428 "When a Linux system starts up without much operator interaction, the entropy "
8429 "pool may be in a fairly predictable state.  This reduces the actual amount "
8430 "of noise in the entropy pool below the estimate.  In order to counteract "
8431 "this effect, it helps to carry entropy pool information across shut-downs "
8432 "and start-ups.  To do this, add the following lines to an appropriate script "
8433 "which is run during the Linux system start-up sequence:"
8434 msgstr ""
8435
8436 #. type: Plain text
8437 #: build/C/man4/random.4:150
8438 #, no-wrap
8439 msgid ""
8440 "    echo \"Initializing random number generator...\"\n"
8441 "    random_seed=/var/run/random-seed\n"
8442 "    # Carry a random seed from start-up to start-up\n"
8443 "    # Load and then save the whole entropy pool\n"
8444 "    if [ -f $random_seed ]; then\n"
8445 "        cat $random_seed E<gt>/dev/urandom\n"
8446 "    else\n"
8447 "        touch $random_seed\n"
8448 "    fi\n"
8449 "    chmod 600 $random_seed\n"
8450 "    poolfile=/proc/sys/kernel/random/poolsize\n"
8451 "    [ -r $poolfile ] && bytes=\\`cat $poolfile\\` || bytes=512\n"
8452 "    dd if=/dev/urandom of=$random_seed count=1 bs=$bytes\n"
8453 msgstr ""
8454
8455 #. type: Plain text
8456 #: build/C/man4/random.4:154
8457 msgid ""
8458 "Also, add the following lines in an appropriate script which is run during "
8459 "the Linux system shutdown:"
8460 msgstr ""
8461
8462 #. type: Plain text
8463 #: build/C/man4/random.4:165
8464 #, no-wrap
8465 msgid ""
8466 "    # Carry a random seed from shut-down to start-up\n"
8467 "    # Save the whole entropy pool\n"
8468 "    echo \"Saving random seed...\"\n"
8469 "    random_seed=/var/run/random-seed\n"
8470 "    touch $random_seed\n"
8471 "    chmod 600 $random_seed\n"
8472 "    poolfile=/proc/sys/kernel/random/poolsize\n"
8473 "    [ -r $poolfile ] && bytes=\\`cat $poolfile\\` || bytes=512\n"
8474 "    dd if=/dev/urandom of=$random_seed count=1 bs=$bytes\n"
8475 msgstr ""
8476
8477 #. type: SS
8478 #: build/C/man4/random.4:166
8479 #, no-wrap
8480 msgid "/proc Interface"
8481 msgstr ""
8482
8483 #. type: Plain text
8484 #: build/C/man4/random.4:172
8485 msgid ""
8486 "The files in the directory I</proc/sys/kernel/random> (present since 2.3.16) "
8487 "provide an additional interface to the I</dev/random> device."
8488 msgstr ""
8489
8490 #. type: Plain text
8491 #: build/C/man4/random.4:178
8492 msgid ""
8493 "The read-only file I<entropy_avail> gives the available entropy.  Normally, "
8494 "this will be 4096 (bits), a full entropy pool."
8495 msgstr ""
8496
8497 #. type: Plain text
8498 #: build/C/man4/random.4:183
8499 msgid ""
8500 "The file I<poolsize> gives the size of the entropy pool.  The semantics of "
8501 "this file vary across kernel versions:"
8502 msgstr ""
8503
8504 #. type: TP
8505 #: build/C/man4/random.4:184
8506 #, no-wrap
8507 msgid "Linux 2.4:"
8508 msgstr ""
8509
8510 #. type: Plain text
8511 #: build/C/man4/random.4:191
8512 msgid ""
8513 "This file gives the size of the entropy pool in I<bytes>.  Normally, this "
8514 "file will have the value 512, but it is writable, and can be changed to any "
8515 "value for which an algorithm is available.  The choices are 32, 64, 128, "
8516 "256, 512, 1024, or 2048."
8517 msgstr ""
8518
8519 #. type: TP
8520 #: build/C/man4/random.4:191
8521 #, no-wrap
8522 msgid "Linux 2.6:"
8523 msgstr ""
8524
8525 #. type: Plain text
8526 #: build/C/man4/random.4:196
8527 msgid ""
8528 "This file is read-only, and gives the size of the entropy pool in I<bits>.  "
8529 "It contains the value 4096."
8530 msgstr ""
8531
8532 #. type: Plain text
8533 #: build/C/man4/random.4:214
8534 msgid ""
8535 "The file I<read_wakeup_threshold> contains the number of bits of entropy "
8536 "required for waking up processes that sleep waiting for entropy from "
8537 "I</dev/random>.  The default is 64.  The file I<write_wakeup_threshold> "
8538 "contains the number of bits of entropy below which we wake up processes that "
8539 "do a B<select>(2)  or B<poll>(2)  for write access to I</dev/random>.  These "
8540 "values can be changed by writing to the files."
8541 msgstr ""
8542
8543 #. type: Plain text
8544 #: build/C/man4/random.4:222
8545 msgid ""
8546 "The read-only files I<uuid> and I<boot_id> contain random strings like "
8547 "6fd5a44b-35f4-4ad4-a9b9-6b9be13e1fe9.  The former is generated afresh for "
8548 "each read, the latter was generated once."
8549 msgstr ""
8550
8551 #. type: SS
8552 #: build/C/man4/random.4:222
8553 #, no-wrap
8554 msgid "ioctl(2) interface"
8555 msgstr ""
8556
8557 #. type: Plain text
8558 #: build/C/man4/random.4:233
8559 msgid ""
8560 "The following B<ioctl>(2)  requests are defined on file descriptors "
8561 "connected to either I</dev/random> or I</dev/urandom>.  All requests "
8562 "performed will interact with the input entropy pool impacting both "
8563 "I</dev/random> and I</dev/urandom>.  The B<CAP_SYS_ADMIN> capability is "
8564 "required for all requests except B<RNDGETENTCNT>."
8565 msgstr ""
8566
8567 #. type: TP
8568 #: build/C/man4/random.4:233
8569 #, no-wrap
8570 msgid "B<RNDGETENTCNT>"
8571 msgstr ""
8572
8573 #. type: Plain text
8574 #: build/C/man4/random.4:240
8575 msgid ""
8576 "Retrieve the entropy count of the input pool, the contents will be the same "
8577 "as the I<entropy_avail> file under proc.  The result will be stored in the "
8578 "int pointed to by the argument."
8579 msgstr ""
8580
8581 #. type: TP
8582 #: build/C/man4/random.4:240
8583 #, no-wrap
8584 msgid "B<RNDADDTOENTCNT>"
8585 msgstr ""
8586
8587 #. type: Plain text
8588 #: build/C/man4/random.4:244
8589 msgid ""
8590 "Increment or decrement the entropy count of the input pool by the value "
8591 "pointed to by the argument."
8592 msgstr ""
8593
8594 #. type: TP
8595 #: build/C/man4/random.4:244
8596 #, no-wrap
8597 msgid "B<RNDGETPOOL>"
8598 msgstr ""
8599
8600 #. type: Plain text
8601 #: build/C/man4/random.4:247
8602 msgid "Removed in Linux 2.6.9."
8603 msgstr ""
8604
8605 #. type: TP
8606 #: build/C/man4/random.4:247
8607 #, no-wrap
8608 msgid "B<RNDADDENTROPY>"
8609 msgstr ""
8610
8611 #. type: Plain text
8612 #: build/C/man4/random.4:255
8613 msgid ""
8614 "Add some additional entropy to the input pool, incrementing the entropy "
8615 "count.  This differs from writing to I</dev/random> or I</dev/urandom>, "
8616 "which only adds some data but does not increment the entropy count.  The "
8617 "following structure is used:"
8618 msgstr ""
8619
8620 #. type: Plain text
8621 #: build/C/man4/random.4:262
8622 #, no-wrap
8623 msgid ""
8624 "    struct rand_pool_info {\n"
8625 "        int    entropy_count;\n"
8626 "        int    buf_size;\n"
8627 "        __u32  buf[0];\n"
8628 "    };\n"
8629 msgstr ""
8630
8631 #. type: Plain text
8632 #: build/C/man4/random.4:271
8633 msgid ""
8634 "Here I<entropy_count> is the value added to (or subtracted from) the entropy "
8635 "count, and I<buf> is the buffer of size I<buf_size> which gets added to the "
8636 "entropy pool."
8637 msgstr ""
8638
8639 #. type: TP
8640 #: build/C/man4/random.4:271
8641 #, no-wrap
8642 msgid "B<RNDZAPENTCNT>, B<RNDCLEARPOOL>"
8643 msgstr ""
8644
8645 #. type: Plain text
8646 #: build/C/man4/random.4:275
8647 msgid ""
8648 "Zero the entropy count of all pools and add some system data (such as wall "
8649 "clock) to the pools."
8650 msgstr ""
8651
8652 #. type: Plain text
8653 #: build/C/man4/random.4:277
8654 msgid "/dev/random"
8655 msgstr ""
8656
8657 #.  .SH AUTHOR
8658 #.  The kernel's random number generator was written by
8659 #.  Theodore Ts'o (tytso@athena.mit.edu).
8660 #. type: Plain text
8661 #: build/C/man4/random.4:282
8662 msgid "/dev/urandom"
8663 msgstr ""
8664
8665 #. type: Plain text
8666 #: build/C/man4/random.4:284
8667 msgid "B<mknod>(1)"
8668 msgstr ""
8669
8670 #. type: Plain text
8671 #: build/C/man4/random.4:286
8672 msgid "RFC\\ 1750, \"Randomness Recommendations for Security\""
8673 msgstr ""
8674
8675 #. type: TH
8676 #: build/C/man4/sd.4:26
8677 #, no-wrap
8678 msgid "SD"
8679 msgstr ""
8680
8681 #. type: TH
8682 #: build/C/man4/sd.4:26
8683 #, no-wrap
8684 msgid "2012-05-03"
8685 msgstr ""
8686
8687 #. type: Plain text
8688 #: build/C/man4/sd.4:29
8689 msgid "sd - driver for SCSI disk drives"
8690 msgstr ""
8691
8692 #. type: Plain text
8693 #: build/C/man4/sd.4:33
8694 #, no-wrap
8695 msgid ""
8696 "B<#include E<lt>linux/hdreg.hE<gt>        >/* for HDIO_GETGEO */\n"
8697 "B<#include E<lt>linux/fs.hE<gt>           >/* for BLKGETSIZE and BLKRRPART "
8698 "*/\n"
8699 msgstr ""
8700
8701 #. type: Plain text
8702 #: build/C/man4/sd.4:45
8703 msgid ""
8704 "The block device name has the following form: B<sd>I<lp,> where I<l> is a "
8705 "letter denoting the physical drive, and I<p> is a number denoting the "
8706 "partition on that physical drive.  Often, the partition number, I<p>, will "
8707 "be left off when the device corresponds to the whole drive."
8708 msgstr ""
8709
8710 #. type: Plain text
8711 #: build/C/man4/sd.4:54
8712 msgid ""
8713 "SCSI disks have a major device number of 8, and a minor device number of the "
8714 "form (16 * I<drive_number>) + I<partition_number>, where I<drive_number> is "
8715 "the number of the physical drive in order of detection, and "
8716 "I<partition_number> is as follows:"
8717 msgstr ""
8718
8719 #. type: Plain text
8720 #: build/C/man4/sd.4:56
8721 msgid "partition 0 is the whole drive"
8722 msgstr ""
8723
8724 #. type: Plain text
8725 #: build/C/man4/sd.4:58
8726 msgid "partitions 1-4 are the DOS \"primary\" partitions"
8727 msgstr ""
8728
8729 #. type: Plain text
8730 #: build/C/man4/sd.4:60
8731 msgid "partitions 5-8 are the DOS \"extended\" (or \"logical\") partitions"
8732 msgstr ""
8733
8734 #. type: Plain text
8735 #: build/C/man4/sd.4:68
8736 msgid ""
8737 "For example, I</dev/sda> will have major 8, minor 0, and will refer to all "
8738 "of the first SCSI drive in the system; and I</dev/sdb3> will have major 8, "
8739 "minor 19, and will refer to the third DOS \"primary\" partition on the "
8740 "second SCSI drive in the system."
8741 msgstr ""
8742
8743 #. type: Plain text
8744 #: build/C/man4/sd.4:71
8745 msgid ""
8746 "At this time, only block devices are provided.  Raw devices have not yet "
8747 "been implemented."
8748 msgstr ""
8749
8750 #. type: Plain text
8751 #: build/C/man4/sd.4:75
8752 msgid "The following I<ioctl>s are provided:"
8753 msgstr ""
8754
8755 #. type: TP
8756 #: build/C/man4/sd.4:75
8757 #, no-wrap
8758 msgid "B<HDIO_GETGEO>"
8759 msgstr ""
8760
8761 #. type: Plain text
8762 #: build/C/man4/sd.4:79
8763 msgid "Returns the BIOS disk parameters in the following structure:"
8764 msgstr ""
8765
8766 #. type: Plain text
8767 #: build/C/man4/sd.4:88
8768 #, no-wrap
8769 msgid ""
8770 "struct hd_geometry {\n"
8771 "    unsigned char  heads;\n"
8772 "    unsigned char  sectors;\n"
8773 "    unsigned short cylinders;\n"
8774 "    unsigned long  start;\n"
8775 "};\n"
8776 msgstr ""
8777
8778 #. type: Plain text
8779 #: build/C/man4/sd.4:94
8780 msgid "A pointer to this structure is passed as the B<ioctl>(2)  parameter."
8781 msgstr ""
8782
8783 #. type: Plain text
8784 #: build/C/man4/sd.4:109
8785 msgid ""
8786 "The information returned in the parameter is the disk geometry of the drive "
8787 "I<as understood by DOS!> This geometry is I<not> the physical geometry of "
8788 "the drive.  It is used when constructing the drive's partition table, "
8789 "however, and is needed for convenient operation of B<fdisk>(1), "
8790 "B<efdisk>(1), and B<lilo>(1).  If the geometry information is not available, "
8791 "zero will be returned for all of the parameters."
8792 msgstr ""
8793
8794 #. type: TP
8795 #: build/C/man4/sd.4:110
8796 #, no-wrap
8797 msgid "B<BLKGETSIZE>"
8798 msgstr ""
8799
8800 #. type: Plain text
8801 #: build/C/man4/sd.4:117
8802 msgid ""
8803 "Returns the device size in sectors.  The B<ioctl>(2)  parameter should be a "
8804 "pointer to a I<long>."
8805 msgstr ""
8806
8807 #. type: TP
8808 #: build/C/man4/sd.4:117
8809 #, no-wrap
8810 msgid "B<BLKRRPART>"
8811 msgstr ""
8812
8813 #. type: Plain text
8814 #: build/C/man4/sd.4:121
8815 msgid "Forces a reread of the SCSI disk partition tables.  No parameter is needed."
8816 msgstr ""
8817
8818 #. type: Plain text
8819 #: build/C/man4/sd.4:131
8820 msgid ""
8821 "The SCSI B<ioctl>(2)  operations are also supported.  If the B<ioctl>(2)  "
8822 "parameter is required, and it is NULL, then B<ioctl>(2)  will fail with the "
8823 "error B<EINVAL>."
8824 msgstr ""
8825
8826 #. type: Plain text
8827 #: build/C/man4/sd.4:133
8828 msgid "/dev/sd[a-h]: the whole device"
8829 msgstr ""
8830
8831 #. .SH "SEE ALSO"
8832 #. .BR scsi (4)
8833 #. type: Plain text
8834 #: build/C/man4/sd.4:137
8835 msgid "/dev/sd[a-h][0-8]: individual block partitions"
8836 msgstr ""
8837
8838 #. type: TH
8839 #: build/C/man3/setlogmask.3:25
8840 #, no-wrap
8841 msgid "SETLOGMASK"
8842 msgstr ""
8843
8844 #. type: TH
8845 #: build/C/man3/setlogmask.3:25
8846 #, no-wrap
8847 msgid "2001-10-05"
8848 msgstr ""
8849
8850 #. type: Plain text
8851 #: build/C/man3/setlogmask.3:28
8852 msgid "setlogmask - set log priority mask"
8853 msgstr ""
8854
8855 #. type: Plain text
8856 #: build/C/man3/setlogmask.3:31
8857 #, no-wrap
8858 msgid "B<#include E<lt>syslog.hE<gt>>\n"
8859 msgstr ""
8860
8861 #. type: Plain text
8862 #: build/C/man3/setlogmask.3:33
8863 #, no-wrap
8864 msgid "B<int setlogmask(int >I<mask>B<);>\n"
8865 msgstr ""
8866
8867 #. type: Plain text
8868 #: build/C/man3/setlogmask.3:43
8869 msgid ""
8870 "A process has a log priority mask that determines which calls to "
8871 "B<syslog>(3)  may be logged.  All other calls will be ignored.  Logging is "
8872 "enabled for the priorities that have the corresponding bit set in I<mask>.  "
8873 "The initial mask is such that logging is enabled for all priorities."
8874 msgstr ""
8875
8876 #. type: Plain text
8877 #: build/C/man3/setlogmask.3:49
8878 msgid ""
8879 "The B<setlogmask>()  function sets this logmask for the calling process, and "
8880 "returns the previous mask.  If the mask argument is 0, the current logmask "
8881 "is not modified."
8882 msgstr ""
8883
8884 #. type: Plain text
8885 #: build/C/man3/setlogmask.3:69
8886 msgid ""
8887 "The eight priorities are B<LOG_EMERG>, B<LOG_ALERT>, B<LOG_CRIT>, "
8888 "B<LOG_ERR>, B<LOG_WARNING>, B<LOG_NOTICE>, B<LOG_INFO>, and B<LOG_DEBUG>.  "
8889 "The bit corresponding to a priority I<p> is I<LOG_MASK(p)>.  Some systems "
8890 "also provide a macro I<LOG_UPTO(p)> for the mask of all priorities in the "
8891 "above list up to and including I<p>."
8892 msgstr ""
8893
8894 #. type: Plain text
8895 #: build/C/man3/setlogmask.3:71
8896 msgid "This function returns the previous log priority mask."
8897 msgstr ""
8898
8899 #.  .SH NOTES
8900 #.  The glibc logmask handling was broken in versions before glibc 2.1.1.
8901 #. type: Plain text
8902 #: build/C/man3/setlogmask.3:75
8903 msgid "None."
8904 msgstr ""
8905
8906 #. type: Plain text
8907 #: build/C/man3/setlogmask.3:78
8908 msgid "POSIX.1-2001.  Note that the description in POSIX.1-2001 is flawed."
8909 msgstr ""
8910
8911 #. type: Plain text
8912 #: build/C/man3/setlogmask.3:82
8913 msgid "B<closelog>(3), B<openlog>(3), B<syslog>(3)"
8914 msgstr ""
8915
8916 #. type: TH
8917 #: build/C/man4/sk98lin.4:27
8918 #, no-wrap
8919 msgid "SK98LIN"
8920 msgstr ""
8921
8922 #. type: Plain text
8923 #: build/C/man4/sk98lin.4:30
8924 msgid "sk98lin - Marvell/SysKonnect Gigabit Ethernet driver v6.21"
8925 msgstr ""
8926
8927 #. type: Plain text
8928 #: build/C/man4/sk98lin.4:62
8929 msgid ""
8930 "B<insmod sk98lin.o> [B<Speed_A=>I<i,j,...>] [B<Speed_B=>I<i,j,...>] "
8931 "[B<AutoNeg_A=>I<i,j,...>] [B<AutoNeg_B=>I<i,j,...>] [B<DupCap_A=>I<i,j,...>] "
8932 "[B<DupCap_B=>I<i,j,...>] [B<FlowCtrl_A=>I<i,j,...>] "
8933 "[B<FlowCtrl_B=>I<i,j,...>] [B<Role_A=>I<i,j,...>] [B<Role_B=>I<i,j,...>] "
8934 "[B<ConType=>I<i,j,...>] [B<Moderation=>I<i,j,...>] "
8935 "[B<IntsPerSec=>I<i,j,...>] [B<PrefPort=>I<i,j,...>] [B<RlmtMode=>I<i,j,...>]"
8936 msgstr ""
8937
8938 #. type: Plain text
8939 #: build/C/man4/sk98lin.4:67
8940 msgid "B<Note>: This obsolete driver was removed from the kernel in version 2.6.26."
8941 msgstr ""
8942
8943 #. type: Plain text
8944 #: build/C/man4/sk98lin.4:74
8945 msgid ""
8946 "B<sk98lin> is the Gigabit Ethernet driver for Marvell and SysKonnect network "
8947 "adapter cards.  It supports SysKonnect SK-98xx/SK-95xx compliant Gigabit "
8948 "Ethernet Adapter and any Yukon compliant chipset."
8949 msgstr ""
8950
8951 #. type: Plain text
8952 #: build/C/man4/sk98lin.4:81
8953 msgid ""
8954 "When loading the driver using insmod, parameters for the network adapter "
8955 "cards might be stated as a sequence of comma separated commands.  If for "
8956 "instance two network adapters are installed and AutoNegotiation on Port A of "
8957 "the first adapter should be ON, but on the Port A of the second adapter "
8958 "switched OFF, one must enter:"
8959 msgstr ""
8960
8961 #. type: Plain text
8962 #: build/C/man4/sk98lin.4:83
8963 #, no-wrap
8964 msgid "   insmod sk98lin.o AutoNeg_A=On,Off\n"
8965 msgstr ""
8966
8967 #. type: Plain text
8968 #: build/C/man4/sk98lin.4:98
8969 msgid ""
8970 "After B<sk98lin> is bound to one or more adapter cards and the I</proc> "
8971 "filesystem is mounted on your system, a dedicated statistics file will be "
8972 "created in the folder I</proc/net/sk98lin> for all ports of the installed "
8973 "network adapter cards.  Those files are named I<eth[x]>, where I<x> is the "
8974 "number of the interface that has been assigned to a dedicated port by the "
8975 "system."
8976 msgstr ""
8977
8978 #. type: Plain text
8979 #: build/C/man4/sk98lin.4:108
8980 msgid ""
8981 "If loading is finished, any desired IP address can be assigned to the "
8982 "respective I<eth[x]> interface using the B<ifconfig>(8)  command.  This "
8983 "causes the adapter to connect to the Ethernet and to display a status "
8984 "message on the console saying \"ethx: network connection up using port y\" "
8985 "followed by the configured or detected connection parameters."
8986 msgstr ""
8987
8988 #. type: Plain text
8989 #: build/C/man4/sk98lin.4:124
8990 msgid ""
8991 "The B<sk98lin> also supports large frames (also called jumbo frames).  Using "
8992 "jumbo frames can improve throughput tremendously when transferring large "
8993 "amounts of data.  To enable large frames, the MTU (maximum transfer unit) "
8994 "size for an interface is to be set to a high value.  The default MTU size is "
8995 "1500 and can be changed up to 9000 (bytes).  Setting the MTU size can be "
8996 "done when assigning the IP address to the interface or later by using the "
8997 "B<ifconfig>(8)  command with the mtu parameter.  If for instance eth0 needs "
8998 "an IP address and a large frame MTU size, the following two commands might "
8999 "be used:"
9000 msgstr ""
9001
9002 #. type: Plain text
9003 #: build/C/man4/sk98lin.4:127
9004 #, no-wrap
9005 msgid ""
9006 "    ifconfig eth0 10.1.1.1\n"
9007 "    ifconfig eth0 mtu 9000\n"
9008 msgstr ""
9009
9010 #. type: Plain text
9011 #: build/C/man4/sk98lin.4:129
9012 msgid "Those two commands might even be combined into one:"
9013 msgstr ""
9014
9015 #. type: Plain text
9016 #: build/C/man4/sk98lin.4:131
9017 #, no-wrap
9018 msgid "    ifconfig eth0 10.1.1.1 mtu 9000\n"
9019 msgstr ""
9020
9021 #. type: Plain text
9022 #: build/C/man4/sk98lin.4:144
9023 msgid ""
9024 "Note that large frames can be used only if permitted by your network "
9025 "infrastructure.  This means, that any switch being used in your Ethernet "
9026 "must also support large frames.  Quite some switches support large frames, "
9027 "but need to be configured to do so.  Most of the times, their default "
9028 "setting is to support only standard frames with an MTU size of 1500 "
9029 "(bytes).  In addition to the switches inside the network, all network "
9030 "adapters that are to be used must also be enabled regarding jumbo frames.  "
9031 "If an adapter is not set to receive large frames, it will simply drop them."
9032 msgstr ""
9033
9034 #. type: Plain text
9035 #: build/C/man4/sk98lin.4:148
9036 msgid ""
9037 "Switching back to the standard Ethernet frame size can be done by using the "
9038 "B<ifconfig>(8)  command again:"
9039 msgstr ""
9040
9041 #. type: Plain text
9042 #: build/C/man4/sk98lin.4:150
9043 #, no-wrap
9044 msgid "    ifconfig eth0 mtu 1500\n"
9045 msgstr ""
9046
9047 #. type: Plain text
9048 #: build/C/man4/sk98lin.4:156
9049 msgid ""
9050 "The Marvell/SysKonnect Gigabit Ethernet driver for Linux is able to support "
9051 "VLAN and Link Aggregation according to IEEE standards 802.1, 802.1q, and "
9052 "802.3ad.  Those features are available only after installation of open "
9053 "source modules which can be found on the Internet:"
9054 msgstr ""
9055
9056 #. type: Plain text
9057 #: build/C/man4/sk98lin.4:161
9058 msgid "I<VLAN>: E<.UR http://www.candelatech.com\\:/~greear\\:/vlan.html> E<.UE>"
9059 msgstr ""
9060
9061 #. type: Plain text
9062 #: build/C/man4/sk98lin.4:167
9063 msgid "I<Link> I<Aggregation>: E<.UR http://www.st.rim.or.jp\\:/~yumo> E<.UE>"
9064 msgstr ""
9065
9066 #. type: Plain text
9067 #: build/C/man4/sk98lin.4:172
9068 msgid ""
9069 "Note that Marvell/SysKonnect does not offer any support for these open "
9070 "source modules and does not take the responsibility for any kind of failures "
9071 "or problems arising when using these modules."
9072 msgstr ""
9073
9074 #. type: SS
9075 #: build/C/man4/sk98lin.4:172 build/C/man4/wavelan.4:39
9076 #, no-wrap
9077 msgid "Parameters"
9078 msgstr ""
9079
9080 #. type: TP
9081 #: build/C/man4/sk98lin.4:173
9082 #, no-wrap
9083 msgid "B<Speed_A=>I<i,j,...>"
9084 msgstr ""
9085
9086 #. type: Plain text
9087 #: build/C/man4/sk98lin.4:190
9088 msgid ""
9089 "This parameter is used to set the speed capabilities of port A of an adapter "
9090 "card.  It is valid only for Yukon copper adapters.  Possible values are: "
9091 "I<10>, I<100>, I<1000>, or I<Auto>; I<Auto> is the default.  Usually, the "
9092 "speed is negotiated between the two ports during link establishment.  If "
9093 "this fails, a port can be forced to a specific setting with this parameter."
9094 msgstr ""
9095
9096 #. type: TP
9097 #: build/C/man4/sk98lin.4:190
9098 #, no-wrap
9099 msgid "B<Speed_B=>I<i,j,...>"
9100 msgstr ""
9101
9102 #. type: Plain text
9103 #: build/C/man4/sk98lin.4:207
9104 msgid ""
9105 "This parameter is used to set the speed capabilities of port B of an adapter "
9106 "card.  It is valid only for Yukon copper adapters.  Possible values are: "
9107 "I<10>, I<100>, I<1000>, or I<Auto>; I<Auto> is the default.  Usually, the "
9108 "speed is negotiated between the two ports during link establishment.  If "
9109 "this fails, a port can be forced to a specific setting with this parameter."
9110 msgstr ""
9111
9112 #. type: TP
9113 #: build/C/man4/sk98lin.4:207
9114 #, no-wrap
9115 msgid "B<AutoNeg_A=>I<i,j,...>"
9116 msgstr ""
9117
9118 #. type: Plain text
9119 #: build/C/man4/sk98lin.4:221
9120 msgid ""
9121 "Enables or disables the use of autonegotiation of port A of an adapter "
9122 "card.  Possible values are: I<On>, I<Off>, or I<Sense>; I<On> is the "
9123 "default.  The I<Sense> mode automatically detects whether the link partner "
9124 "supports auto-negotiation or not."
9125 msgstr ""
9126
9127 #. type: TP
9128 #: build/C/man4/sk98lin.4:221
9129 #, no-wrap
9130 msgid "B<AutoNeg_B=>I<i,j,...>"
9131 msgstr ""
9132
9133 #. type: Plain text
9134 #: build/C/man4/sk98lin.4:235
9135 msgid ""
9136 "Enables or disables the use of autonegotiation of port B of an adapter "
9137 "card.  Possible values are: I<On>, I<Off>, or I<Sense>; I<On> is the "
9138 "default.  The I<Sense> mode automatically detects whether the link partner "
9139 "supports auto-negotiation or not."
9140 msgstr ""
9141
9142 #. type: TP
9143 #: build/C/man4/sk98lin.4:235
9144 #, no-wrap
9145 msgid "B<DupCap_A=>I<i,j,...>"
9146 msgstr ""
9147
9148 #. type: Plain text
9149 #: build/C/man4/sk98lin.4:265
9150 msgid ""
9151 "This parameter indicates the duplex mode to be used for port A of an adapter "
9152 "card.  Possible values are: I<Half>, I<Full>, or I<Both>; I<Both> is the "
9153 "default.  This parameter is relevant only if AutoNeg_A of port A is not set "
9154 "to I<Sense>.  If AutoNeg_A is set to I<On>, all three values of DupCap_A ( "
9155 "I<Half>, I<Full> or I<Both>)  might be stated.  If AutoNeg_A is set to "
9156 "I<Off>, only DupCap_A values I<Full> and I<Half> are allowed.  This DupCap_A "
9157 "parameter is useful if your link partner does not support all possible "
9158 "duplex combinations."
9159 msgstr ""
9160
9161 #. type: TP
9162 #: build/C/man4/sk98lin.4:265
9163 #, no-wrap
9164 msgid "B<DupCap_B=>I<i,j,...>"
9165 msgstr ""
9166
9167 #. type: Plain text
9168 #: build/C/man4/sk98lin.4:295
9169 msgid ""
9170 "This parameter indicates the duplex mode to be used for port B of an adapter "
9171 "card.  Possible values are: I<Half>, I<Full>, or I<Both>; I<Both> is the "
9172 "default.  This parameter is relevant only if AutoNeg_B of port B is not set "
9173 "to I<Sense>.  If AutoNeg_B is set to I<On>, all three values of DupCap_B ( "
9174 "I<Half>, I<Full> or I<Both>)  might be stated.  If AutoNeg_B is set to "
9175 "I<Off>, only DupCap_B values I<Full> and I<Half> are allowed.  This DupCap_B "
9176 "parameter is useful if your link partner does not support all possible "
9177 "duplex combinations."
9178 msgstr ""
9179
9180 #. type: TP
9181 #: build/C/man4/sk98lin.4:295
9182 #, no-wrap
9183 msgid "B<FlowCtrl_A=>I<i,j,...>"
9184 msgstr ""
9185
9186 #. type: Plain text
9187 #: build/C/man4/sk98lin.4:308 build/C/man4/sk98lin.4:341
9188 msgid ""
9189 "This parameter can be used to set the flow control capabilities the port "
9190 "reports during auto-negotiation.  Possible values are: I<Sym>, I<SymOrRem>, "
9191 "I<LocSend>, or I<None>; I<SymOrRem> is the default.  The different modes "
9192 "have the following meaning:"
9193 msgstr ""
9194
9195 #. type: Plain text
9196 #: build/C/man4/sk98lin.4:313 build/C/man4/sk98lin.4:345
9197 #, no-wrap
9198 msgid ""
9199 "I<Sym>\n"
9200 "= Symmetric\n"
9201 " both link partners are allowed to send PAUSE frames\n"
9202 msgstr ""
9203
9204 #. type: Plain text
9205 #: build/C/man4/sk98lin.4:317 build/C/man4/sk98lin.4:349
9206 #, no-wrap
9207 msgid ""
9208 "I<SymOrRem>\n"
9209 "= SymmetricOrRemote\n"
9210 " both or only remote partner are allowed to send PAUSE frames\n"
9211 msgstr ""
9212
9213 #. type: Plain text
9214 #: build/C/man4/sk98lin.4:321 build/C/man4/sk98lin.4:353
9215 #, no-wrap
9216 msgid ""
9217 "I<LocSend>\n"
9218 "= LocalSend\n"
9219 " only local link partner is allowed to send PAUSE frames\n"
9220 msgstr ""
9221
9222 #. type: Plain text
9223 #: build/C/man4/sk98lin.4:325 build/C/man4/sk98lin.4:357
9224 #, no-wrap
9225 msgid ""
9226 "I<None>\n"
9227 "= None\n"
9228 " no link partner is allowed to send PAUSE frames\n"
9229 msgstr ""
9230
9231 #. type: Plain text
9232 #: build/C/man4/sk98lin.4:328
9233 msgid "Note that this parameter is ignored if AutoNeg_A is set to I<Off>."
9234 msgstr ""
9235
9236 #. type: TP
9237 #: build/C/man4/sk98lin.4:328
9238 #, no-wrap
9239 msgid "B<FlowCtrl_B=>I<i,j,...>"
9240 msgstr ""
9241
9242 #. type: Plain text
9243 #: build/C/man4/sk98lin.4:361
9244 msgid "Note that this parameter is ignored if AutoNeg_B is set to I<Off>."
9245 msgstr ""
9246
9247 #. type: TP
9248 #: build/C/man4/sk98lin.4:361
9249 #, no-wrap
9250 msgid "B<Role_A=>I<i,j,...>"
9251 msgstr ""
9252
9253 #. type: Plain text
9254 #: build/C/man4/sk98lin.4:377
9255 msgid ""
9256 "This parameter is valid only for 1000Base-T adapter cards.  For two "
9257 "1000Base-T ports to communicate, one must take the role of the master "
9258 "(providing timing information), while the other must be the slave.  Possible "
9259 "values are: I<Auto>, I<Master>, or I<Slave>; I<Auto> is the default.  "
9260 "Usually, the role of a port is negotiated between two ports during link "
9261 "establishment, but if that fails the port A of an adapter card can be forced "
9262 "to a specific setting with this parameter."
9263 msgstr ""
9264
9265 #. type: TP
9266 #: build/C/man4/sk98lin.4:377
9267 #, no-wrap
9268 msgid "B<Role_B=>I<i,j,...>"
9269 msgstr ""
9270
9271 #. type: Plain text
9272 #: build/C/man4/sk98lin.4:394
9273 msgid ""
9274 "This parameter is valid only for 1000Base-T adapter cards.  For two "
9275 "1000Base-T ports to communicate, one must take the role of the master "
9276 "(providing timing information), while the other must be the slave.  Possible "
9277 "values are: I<Auto>, I<Master>, or I<Slave>; I<Auto> is the default.  "
9278 "Usually, the role of a port is negotiated between two ports during link "
9279 "establishment, but if that fails the port B of an adapter card can be forced "
9280 "to a specific setting with this parameter."
9281 msgstr ""
9282
9283 #. type: TP
9284 #: build/C/man4/sk98lin.4:394
9285 #, no-wrap
9286 msgid "B<ConType=>I<i,j,...>"
9287 msgstr ""
9288
9289 #. type: Plain text
9290 #: build/C/man4/sk98lin.4:402
9291 msgid ""
9292 "This parameter is a combination of all five per-port parameters within one "
9293 "single parameter.  This simplifies the configuration of both ports of an "
9294 "adapter card.  The different values of this variable reflect the most "
9295 "meaningful combinations of port parameters.  Possible values and their "
9296 "corresponding combination of per-port parameters:"
9297 msgstr ""
9298
9299 #. type: Plain text
9300 #: build/C/man4/sk98lin.4:407
9301 #, no-wrap
9302 msgid ""
9303 "ConType | DupCap   AutoNeg   FlowCtrl   Role   Speed\n"
9304 "--------+-------------------------------------------\n"
9305 "I<Auto>    |  Both      On      SymOrRem   Auto   Auto\n"
9306 msgstr ""
9307
9308 #. type: Plain text
9309 #: build/C/man4/sk98lin.4:409
9310 #, no-wrap
9311 msgid "I<100FD>   |  Full      Off       None     Auto   100\n"
9312 msgstr ""
9313
9314 #. type: Plain text
9315 #: build/C/man4/sk98lin.4:411
9316 #, no-wrap
9317 msgid "I<100HD>   |  Half      Off       None     Auto   100\n"
9318 msgstr ""
9319
9320 #. type: Plain text
9321 #: build/C/man4/sk98lin.4:413
9322 #, no-wrap
9323 msgid "I<10FD>    |  Full      Off       None     Auto   10\n"
9324 msgstr ""
9325
9326 #. type: Plain text
9327 #: build/C/man4/sk98lin.4:415
9328 #, no-wrap
9329 msgid "I<10HD>    |  Half      Off       None     Auto   10\n"
9330 msgstr ""
9331
9332 #. type: Plain text
9333 #: build/C/man4/sk98lin.4:425
9334 msgid ""
9335 "Stating any other port parameter together with this I<ConType> parameter "
9336 "will result in a merged configuration of those settings.  This is due to the "
9337 "fact, that the per-port parameters (e.g., I<Speed_A>)  have a higher "
9338 "priority than the combined variable I<ConType>."
9339 msgstr ""
9340
9341 #. type: TP
9342 #: build/C/man4/sk98lin.4:425
9343 #, no-wrap
9344 msgid "B<Moderation=>I<i,j,...>"
9345 msgstr ""
9346
9347 #. type: Plain text
9348 #: build/C/man4/sk98lin.4:442
9349 msgid ""
9350 "Interrupt moderation is employed to limit the maximum number of interrupts "
9351 "the driver has to serve.  That is, one or more interrupts (which indicate "
9352 "any transmit or receive packet to be processed) are queued until the driver "
9353 "processes them.  When queued interrupts are to be served, is determined by "
9354 "the I<IntsPerSec> parameter, which is explained later below.  Possible "
9355 "moderation modes are: I<None>, I<Static>, or I<Dynamic>; I<None> is the "
9356 "default.  The different modes have the following meaning:"
9357 msgstr ""
9358
9359 #. type: Plain text
9360 #: build/C/man4/sk98lin.4:447
9361 msgid ""
9362 "I<None> No interrupt moderation is applied on the adapter card.  Therefore, "
9363 "each transmit or receive interrupt is served immediately as soon as it "
9364 "appears on the interrupt line of the adapter card."
9365 msgstr ""
9366
9367 #. type: Plain text
9368 #: build/C/man4/sk98lin.4:462
9369 msgid ""
9370 "I<Static> Interrupt moderation is applied on the adapter card.  All transmit "
9371 "and receive interrupts are queued until a complete moderation interval "
9372 "ends.  If such a moderation interval ends, all queued interrupts are "
9373 "processed in one big bunch without any delay.  The term I<Static> reflects "
9374 "the fact, that interrupt moderation is always enabled, regardless how much "
9375 "network load is currently passing via a particular interface.  In addition, "
9376 "the duration of the moderation interval has a fixed length that never "
9377 "changes while the driver is operational."
9378 msgstr ""
9379
9380 #. type: Plain text
9381 #: build/C/man4/sk98lin.4:473
9382 msgid ""
9383 "I<Dynamic> Interrupt moderation might be applied on the adapter card, "
9384 "depending on the load of the system.  If the driver detects that the system "
9385 "load is too high, the driver tries to shield the system against too much "
9386 "network load by enabling interrupt moderation.  If\\(emat a later "
9387 "time\\(emthe CPU utilization decreases again (or if the network load is "
9388 "negligible), the interrupt moderation will automatically be disabled."
9389 msgstr ""
9390
9391 #. type: Plain text
9392 #: build/C/man4/sk98lin.4:479
9393 msgid ""
9394 "Interrupt moderation should be used when the driver has to handle one or "
9395 "more interfaces with a high network load, which\\(emas a "
9396 "consequence\\(emleads also to a high CPU utilization.  When moderation is "
9397 "applied in such high network load situations, CPU load might be reduced by "
9398 "20-30% on slow computers."
9399 msgstr ""
9400
9401 #. type: Plain text
9402 #: build/C/man4/sk98lin.4:483
9403 msgid ""
9404 "Note that the drawback of using interrupt moderation is an increase of the "
9405 "round-trip-time (RTT), due to the queuing and serving of interrupts at "
9406 "dedicated moderation times."
9407 msgstr ""
9408
9409 #. type: TP
9410 #: build/C/man4/sk98lin.4:483
9411 #, no-wrap
9412 msgid "B<IntsPerSec=>I<i,j,...>"
9413 msgstr ""
9414
9415 #. type: Plain text
9416 #: build/C/man4/sk98lin.4:493
9417 msgid ""
9418 "This parameter determines the length of any interrupt moderation interval.  "
9419 "Assuming that static interrupt moderation is to be used, an I<IntsPerSec> "
9420 "parameter value of 2000 will lead to an interrupt moderation interval of 500 "
9421 "microseconds.  Possible values for this parameter are in the range of "
9422 "30...40000 (interrupts per second).  The default value is 2000."
9423 msgstr ""
9424
9425 #. type: Plain text
9426 #: build/C/man4/sk98lin.4:497
9427 msgid ""
9428 "This parameter is used only if either static or dynamic interrupt moderation "
9429 "is enabled on a network adapter card.  This parameter is ignored if no "
9430 "moderation is applied."
9431 msgstr ""
9432
9433 #. type: Plain text
9434 #: build/C/man4/sk98lin.4:504
9435 msgid ""
9436 "Note that the duration of the moderation interval is to be chosen with "
9437 "care.  At first glance, selecting a very long duration (e.g., only 100 "
9438 "interrupts per second) seems to be meaningful, but the increase of "
9439 "packet-processing delay is tremendous.  On the other hand, selecting a very "
9440 "short moderation time might compensate the use of any moderation being "
9441 "applied."
9442 msgstr ""
9443
9444 #. type: TP
9445 #: build/C/man4/sk98lin.4:504
9446 #, no-wrap
9447 msgid "B<PrefPort=>I<i,j,...>"
9448 msgstr ""
9449
9450 #. type: Plain text
9451 #: build/C/man4/sk98lin.4:516
9452 msgid ""
9453 "This parameter is used to force the preferred port to A or B (on dual-port "
9454 "network adapters).  The preferred port is the one that is used if both ports "
9455 "A and B are detected as fully functional.  Possible values are: I<A> or "
9456 "I<B>; I<A> is the default."
9457 msgstr ""
9458
9459 #. type: TP
9460 #: build/C/man4/sk98lin.4:516
9461 #, no-wrap
9462 msgid "B<RlmtMode=>I<i,j,...>"
9463 msgstr ""
9464
9465 #. type: Plain text
9466 #: build/C/man4/sk98lin.4:532
9467 msgid ""
9468 "RLMT monitors the status of the port.  If the link of the active port fails, "
9469 "RLMT switches immediately to the standby link.  The virtual link is "
9470 "maintained as long as at least one \"physical\" link is up.  This parameters "
9471 "states how RLMT should monitor both ports.  Possible values are: "
9472 "I<CheckLinkState>, I<CheckLocalPort>, I<CheckSeg>, or I<DualNet>; "
9473 "I<CheckLinkState> is the default.  The different modes have the following "
9474 "meaning:"
9475 msgstr ""
9476
9477 #. type: Plain text
9478 #: build/C/man4/sk98lin.4:537
9479 msgid ""
9480 "I<CheckLinkState> Check link state only: RLMT uses the link state reported "
9481 "by the adapter hardware for each individual port to determine whether a port "
9482 "can be used for all network traffic or not."
9483 msgstr ""
9484
9485 #. type: Plain text
9486 #: build/C/man4/sk98lin.4:545
9487 msgid ""
9488 "I<CheckLocalPort> In this mode, RLMT monitors the network path between the "
9489 "two ports of an adapter by regularly exchanging packets between them.  This "
9490 "mode requires a network configuration in which the two ports are able to "
9491 "\"see\" each other (i.e., there must not be any router between the ports)."
9492 msgstr ""
9493
9494 #. type: Plain text
9495 #: build/C/man4/sk98lin.4:554
9496 msgid ""
9497 "I<CheckSeg> Check local port and segmentation: This mode supports the same "
9498 "functions as the CheckLocalPort mode and additionally checks network "
9499 "segmentation between the ports.  Therefore, this mode is to be used only if "
9500 "Gigabit Ethernet switches are installed on the network that have been "
9501 "configured to use the Spanning Tree protocol."
9502 msgstr ""
9503
9504 #. type: Plain text
9505 #: build/C/man4/sk98lin.4:565
9506 msgid ""
9507 "I<DualNet> In this mode, ports A and B are used as separate devices.  If you "
9508 "have a dual port adapter, port A will be configured as I<eth[x]> and port B "
9509 "as I<eth[x+1]>.  Both ports can be used independently with distinct IP "
9510 "addresses.  The preferred port setting is not used.  RLMT is turned off."
9511 msgstr ""
9512
9513 #. type: Plain text
9514 #: build/C/man4/sk98lin.4:574
9515 msgid ""
9516 "Note that RLMT modes I<CheckLocalPort> and I<CheckLinkState> are designed to "
9517 "operate in configurations where a network path between the ports on one "
9518 "adapter exists.  Moreover, they are not designed to work where adapters are "
9519 "connected back-to-back."
9520 msgstr ""
9521
9522 #. type: TP
9523 #: build/C/man4/sk98lin.4:575
9524 #, no-wrap
9525 msgid "I</proc/net/sk98lin/eth[x]>"
9526 msgstr ""
9527
9528 #. type: Plain text
9529 #: build/C/man4/sk98lin.4:581
9530 msgid ""
9531 "The statistics file of a particular interface of an adapter card.  It "
9532 "contains generic information about the adapter card plus a detailed summary "
9533 "of all transmit and receive counters."
9534 msgstr ""
9535
9536 #. type: TP
9537 #: build/C/man4/sk98lin.4:581
9538 #, no-wrap
9539 msgid "I</usr/src/linux/Documentation/networking/sk98lin.txt>"
9540 msgstr ""
9541
9542 #. type: Plain text
9543 #: build/C/man4/sk98lin.4:592
9544 msgid ""
9545 "This is the I<README> file of the I<sk98lin> driver.  It contains a detailed "
9546 "installation HOWTO and describes all parameters of the driver.  It denotes "
9547 "also common problems and provides the solution to them."
9548 msgstr ""
9549
9550 #.  .SH AUTHORS
9551 #.  Ralph Roesler \(em rroesler@syskonnect.de
9552 #.  .br
9553 #.  Mirko Lindner \(em mlindner@syskonnect.de
9554 #. type: Plain text
9555 #: build/C/man4/sk98lin.4:598
9556 msgid "Report any bugs to linux@syskonnect.de"
9557 msgstr ""
9558
9559 #. type: Plain text
9560 #: build/C/man4/sk98lin.4:602
9561 msgid "B<ifconfig>(8), B<insmod>(8), B<modprobe>(8)"
9562 msgstr ""
9563
9564 #. type: TH
9565 #: build/C/man4/st.4:25
9566 #, no-wrap
9567 msgid "ST"
9568 msgstr ""
9569
9570 #. type: Plain text
9571 #: build/C/man4/st.4:28
9572 msgid "st - SCSI tape device"
9573 msgstr ""
9574
9575 #. type: Plain text
9576 #: build/C/man4/st.4:31
9577 #, no-wrap
9578 msgid "B<#include E<lt>sys/mtio.hE<gt>>\n"
9579 msgstr ""
9580
9581 #. type: Plain text
9582 #: build/C/man4/st.4:36
9583 #, no-wrap
9584 msgid ""
9585 "B<int ioctl(int >I<fd>B<, int >I<request>B< [, (void *)>I<arg3>B<]);>\n"
9586 "B<int ioctl(int >I<fd>B<, MTIOCTOP, (struct mtop *)>I<mt_cmd>B<);>\n"
9587 "B<int ioctl(int >I<fd>B<, MTIOCGET, (struct mtget *)>I<mt_status>B<);>\n"
9588 "B<int ioctl(int >I<fd>B<, MTIOCPOS, (struct mtpos *)>I<mt_pos>B<);>\n"
9589 msgstr ""
9590
9591 #. type: Plain text
9592 #: build/C/man4/st.4:46
9593 msgid ""
9594 "The B<st> driver provides the interface to a variety of SCSI tape devices.  "
9595 "Currently, the driver takes control of all detected devices of type "
9596 "\\(lqsequential-access\\(rq.  The B<st> driver uses major device number 9."
9597 msgstr ""
9598
9599 #. type: Plain text
9600 #: build/C/man4/st.4:66
9601 msgid ""
9602 "Each device uses eight minor device numbers.  The lowermost five bits in the "
9603 "minor numbers are assigned sequentially in the order of detection.  In the "
9604 "2.6 kernel, the bits above the eight lowermost bits are concatenated to the "
9605 "five lowermost bits to form the tape number.  The minor numbers can be "
9606 "grouped into two sets of four numbers: the principal (auto-rewind) minor "
9607 "device numbers, I<n>, and the \\(lqno-rewind\\(rq device numbers, (I<n> + "
9608 "128).  Devices opened using the principal device number will be sent a "
9609 "B<REWIND> command when they are closed.  Devices opened using the "
9610 "\\(lqno-rewind\\(rq device number will not.  (Note that using an auto-rewind "
9611 "device for positioning the tape with, for instance, mt does not lead to the "
9612 "desired result: the tape is rewound after the mt command and the next "
9613 "command starts from the beginning of the tape)."
9614 msgstr ""
9615
9616 #. type: Plain text
9617 #: build/C/man4/st.4:80
9618 msgid ""
9619 "Within each group, four minor numbers are available to define devices with "
9620 "different characteristics (block size, compression, density, etc.)  When the "
9621 "system starts up, only the first device is available.  The other three are "
9622 "activated when the default characteristics are defined (see below).  (By "
9623 "changing compile-time constants, it is possible to change the balance "
9624 "between the maximum number of tape drives and the number of minor numbers "
9625 "for each drive.  The default allocation allows control of 32 tape drives.  "
9626 "For instance, it is possible to control up to 64 tape drives with two minor "
9627 "numbers for different options.)"
9628 msgstr ""
9629
9630 #. type: Plain text
9631 #: build/C/man4/st.4:82
9632 msgid "Devices are typically created by:"
9633 msgstr ""
9634
9635 #. type: Plain text
9636 #: build/C/man4/st.4:93
9637 #, no-wrap
9638 msgid ""
9639 "mknod -m 666 /dev/st0 c 9 0\n"
9640 "mknod -m 666 /dev/st0l c 9 32\n"
9641 "mknod -m 666 /dev/st0m c 9 64\n"
9642 "mknod -m 666 /dev/st0a c 9 96\n"
9643 "mknod -m 666 /dev/nst0 c 9 128\n"
9644 "mknod -m 666 /dev/nst0l c 9 160\n"
9645 "mknod -m 666 /dev/nst0m c 9 192\n"
9646 "mknod -m 666 /dev/nst0a c 9 224\n"
9647 msgstr ""
9648
9649 #. type: Plain text
9650 #: build/C/man4/st.4:97
9651 msgid "There is no corresponding block device."
9652 msgstr ""
9653
9654 #. type: Plain text
9655 #: build/C/man4/st.4:112
9656 msgid ""
9657 "The driver uses an internal buffer that has to be large enough to hold at "
9658 "least one tape block.  In kernels before 2.1.121, the buffer is allocated as "
9659 "one contiguous block.  This limits the block size to the largest contiguous "
9660 "block of memory the kernel allocator can provide.  The limit is currently "
9661 "128 kB for 32-bit architectures and 256 kB for 64-bit architectures.  In "
9662 "newer kernels the driver allocates the buffer in several parts if "
9663 "necessary.  By default, the maximum number of parts is 16.  This means that "
9664 "the maximum block size is very large (2 MB if allocation of 16 blocks of 128 "
9665 "kB succeeds)."
9666 msgstr ""
9667
9668 #. type: Plain text
9669 #: build/C/man4/st.4:121
9670 msgid ""
9671 "The driver's internal buffer size is determined by a compile-time constant "
9672 "which can be overridden with a kernel startup option.  In addition to this, "
9673 "the driver tries to allocate a larger temporary buffer at run time if "
9674 "necessary.  However, run-time allocation of large contiguous blocks of "
9675 "memory may fail and it is advisable not to rely too much on dynamic buffer "
9676 "allocation with kernels older than 2.1.121 (this applies also to "
9677 "demand-loading the driver with kerneld or kmod)."
9678 msgstr ""
9679
9680 #. type: Plain text
9681 #: build/C/man4/st.4:134
9682 msgid ""
9683 "The driver does not specifically support any tape drive brand or model.  "
9684 "After system start-up the tape device options are defined by the drive "
9685 "firmware.  For example, if the drive firmware selects fixed-block mode, the "
9686 "tape device uses fixed-block mode.  The options can be changed with explicit "
9687 "B<ioctl>(2)  calls and remain in effect when the device is closed and "
9688 "reopened.  Setting the options affects both the auto-rewind and the "
9689 "nonrewind device."
9690 msgstr ""
9691
9692 #. type: Plain text
9693 #: build/C/man4/st.4:143
9694 msgid ""
9695 "Different options can be specified for the different devices within the "
9696 "subgroup of four.  The options take effect when the device is opened.  For "
9697 "example, the system administrator can define one device that writes in "
9698 "fixed-block mode with a certain block size, and one which writes in "
9699 "variable-block mode (if the drive supports both modes)."
9700 msgstr ""
9701
9702 #. type: Plain text
9703 #: build/C/man4/st.4:166
9704 msgid ""
9705 "The driver supports B<tape partitions> if they are supported by the drive.  "
9706 "(Note that the tape partitions have nothing to do with disk partitions.  A "
9707 "partitioned tape can be seen as several logical tapes within one medium.)  "
9708 "Partition support has to be enabled with an B<ioctl>(2).  The tape location "
9709 "is preserved within each partition across partition changes.  The partition "
9710 "used for subsequent tape operations is selected with an B<ioctl>(2).  The "
9711 "partition switch is executed together with the next tape operation in order "
9712 "to avoid unnecessary tape movement.  The maximum number of partitions on a "
9713 "tape is defined by a compile-time constant (originally four).  The driver "
9714 "contains an B<ioctl>(2)  that can format a tape with either one or two "
9715 "partitions."
9716 msgstr ""
9717
9718 #. type: Plain text
9719 #: build/C/man4/st.4:171
9720 msgid ""
9721 "Device I</dev/tape> is usually created as a hard or soft link to the default "
9722 "tape device on the system."
9723 msgstr ""
9724
9725 #. type: Plain text
9726 #: build/C/man4/st.4:175
9727 msgid ""
9728 "Starting from kernel 2.6.2, the driver exports in the sysfs directory "
9729 "I</sys/class/scsi_tape> the attached devices and some parameters assigned to "
9730 "the devices."
9731 msgstr ""
9732
9733 #. type: SS
9734 #: build/C/man4/st.4:175
9735 #, no-wrap
9736 msgid "Data transfer"
9737 msgstr ""
9738
9739 #. type: Plain text
9740 #: build/C/man4/st.4:188
9741 msgid ""
9742 "The driver supports operation in both fixed-block mode and variable-block "
9743 "mode (if supported by the drive).  In fixed-block mode the drive writes "
9744 "blocks of the specified size and the block size is not dependent on the byte "
9745 "counts of the write system calls.  In variable-block mode one tape block is "
9746 "written for each write call and the byte count determines the size of the "
9747 "corresponding tape block.  Note that the blocks on the tape don't contain "
9748 "any information about the writing mode: when reading, the only important "
9749 "thing is to use commands that accept the block sizes on the tape."
9750 msgstr ""
9751
9752 #. type: Plain text
9753 #: build/C/man4/st.4:197
9754 msgid ""
9755 "In variable-block mode the read byte count does not have to match the tape "
9756 "block size exactly.  If the byte count is larger than the next block on "
9757 "tape, the driver returns the data and the function returns the actual block "
9758 "size.  If the block size is larger than the byte count, the requested amount "
9759 "of data from the start of the block is returned and the rest of the block is "
9760 "discarded."
9761 msgstr ""
9762
9763 #. type: Plain text
9764 #: build/C/man4/st.4:206
9765 msgid ""
9766 "In fixed-block mode the read byte counts can be arbitrary if buffering is "
9767 "enabled, or a multiple of the tape block size if buffering is disabled.  "
9768 "Kernels before 2.1.121 allow writes with arbitrary byte count if buffering "
9769 "is enabled.  In all other cases (kernel before 2.1.121 with buffering "
9770 "disabled or newer kernel) the write byte count must be a multiple of the "
9771 "tape block size."
9772 msgstr ""
9773
9774 #. type: Plain text
9775 #: build/C/man4/st.4:215
9776 msgid ""
9777 "In the 2.6 kernel, the driver tries to use direct transfers between the user "
9778 "buffer and the device.  If this is not possible, the driver's internal "
9779 "buffer is used.  The reasons for not using direct transfers include improper "
9780 "alignment of the user buffer (default is 512 bytes but this can be changed "
9781 "by the HBA driver), one or more pages of the user buffer not reachable by "
9782 "the SCSI adapter, and so on."
9783 msgstr ""
9784
9785 #. type: Plain text
9786 #: build/C/man4/st.4:218
9787 msgid ""
9788 "A filemark is automatically written to tape if the last tape operation "
9789 "before close was a write."
9790 msgstr ""
9791
9792 #. type: Plain text
9793 #: build/C/man4/st.4:230
9794 msgid ""
9795 "When a filemark is encountered while reading, the following happens.  If "
9796 "there are data remaining in the buffer when the filemark is found, the "
9797 "buffered data is returned.  The next read returns zero bytes.  The following "
9798 "read returns data from the next file.  The end of recorded data is signaled "
9799 "by returning zero bytes for two consecutive read calls.  The third read "
9800 "returns an error."
9801 msgstr ""
9802
9803 #. type: SS
9804 #: build/C/man4/st.4:230
9805 #, no-wrap
9806 msgid "Ioctls"
9807 msgstr ""
9808
9809 #. type: Plain text
9810 #: build/C/man4/st.4:241
9811 msgid ""
9812 "The driver supports three B<ioctl>(2)  requests.  Requests not recognized by "
9813 "the B<st> driver are passed to the B<SCSI> driver.  The definitions below "
9814 "are from I</usr/include/linux/mtio.h>:"
9815 msgstr ""
9816
9817 #. type: SS
9818 #: build/C/man4/st.4:241
9819 #, no-wrap
9820 msgid "MTIOCTOP \\(em perform a tape operation"
9821 msgstr ""
9822
9823 #. type: Plain text
9824 #: build/C/man4/st.4:249
9825 msgid ""
9826 "This request takes an argument of type I<(struct mtop\\ *)>.  Not all drives "
9827 "support all operations.  The driver returns an B<EIO> error if the drive "
9828 "rejects an operation."
9829 msgstr ""
9830
9831 #. type: Plain text
9832 #: build/C/man4/st.4:257
9833 #, no-wrap
9834 msgid ""
9835 "/* Structure for MTIOCTOP - mag tape op command: */\n"
9836 "struct mtop {\n"
9837 "    short   mt_op;       /* operations defined below */\n"
9838 "    int     mt_count;    /* how many of them */\n"
9839 "};\n"
9840 msgstr ""
9841
9842 #. type: Plain text
9843 #: build/C/man4/st.4:261
9844 msgid "Magnetic Tape operations for normal tape use:"
9845 msgstr ""
9846
9847 #. type: TP
9848 #: build/C/man4/st.4:261
9849 #, no-wrap
9850 msgid "B<MTBSF>"
9851 msgstr ""
9852
9853 #. type: Plain text
9854 #: build/C/man4/st.4:266
9855 msgid "Backward space over I<mt_count> filemarks."
9856 msgstr ""
9857
9858 #. type: TP
9859 #: build/C/man4/st.4:266
9860 #, no-wrap
9861 msgid "B<MTBSFM>"
9862 msgstr ""
9863
9864 #. type: Plain text
9865 #: build/C/man4/st.4:272
9866 msgid ""
9867 "Backward space over I<mt_count> filemarks.  Reposition the tape to the EOT "
9868 "side of the last filemark."
9869 msgstr ""
9870
9871 #. type: TP
9872 #: build/C/man4/st.4:272
9873 #, no-wrap
9874 msgid "B<MTBSR>"
9875 msgstr ""
9876
9877 #. type: Plain text
9878 #: build/C/man4/st.4:277
9879 msgid "Backward space over I<mt_count> records (tape blocks)."
9880 msgstr ""
9881
9882 #. type: TP
9883 #: build/C/man4/st.4:277
9884 #, no-wrap
9885 msgid "B<MTBSS>"
9886 msgstr ""
9887
9888 #. type: Plain text
9889 #: build/C/man4/st.4:282
9890 msgid "Backward space over I<mt_count> setmarks."
9891 msgstr ""
9892
9893 #. type: TP
9894 #: build/C/man4/st.4:282
9895 #, no-wrap
9896 msgid "B<MTCOMPRESSION>"
9897 msgstr ""
9898
9899 #. type: Plain text
9900 #: build/C/man4/st.4:290
9901 msgid ""
9902 "Enable compression of tape data within the drive if I<mt_count> is nonzero "
9903 "and disable compression if I<mt_count> is zero.  This command uses the MODE "
9904 "page 15 supported by most DATs."
9905 msgstr ""
9906
9907 #. type: TP
9908 #: build/C/man4/st.4:290
9909 #, no-wrap
9910 msgid "B<MTEOM>"
9911 msgstr ""
9912
9913 #. type: Plain text
9914 #: build/C/man4/st.4:293
9915 msgid "Go to the end of the recorded media (for appending files)."
9916 msgstr ""
9917
9918 #. type: TP
9919 #: build/C/man4/st.4:293
9920 #, no-wrap
9921 msgid "B<MTERASE>"
9922 msgstr ""
9923
9924 #. type: Plain text
9925 #: build/C/man4/st.4:299
9926 msgid ""
9927 "Erase tape.  With 2.6 kernel, short erase (mark tape empty) is performed if "
9928 "the argument is zero.  Otherwise, long erase (erase all) is done."
9929 msgstr ""
9930
9931 #. type: TP
9932 #: build/C/man4/st.4:299
9933 #, no-wrap
9934 msgid "B<MTFSF>"
9935 msgstr ""
9936
9937 #. type: Plain text
9938 #: build/C/man4/st.4:304
9939 msgid "Forward space over I<mt_count> filemarks."
9940 msgstr ""
9941
9942 #. type: TP
9943 #: build/C/man4/st.4:304
9944 #, no-wrap
9945 msgid "B<MTFSFM>"
9946 msgstr ""
9947
9948 #. type: Plain text
9949 #: build/C/man4/st.4:310
9950 msgid ""
9951 "Forward space over I<mt_count> filemarks.  Reposition the tape to the BOT "
9952 "side of the last filemark."
9953 msgstr ""
9954
9955 #. type: TP
9956 #: build/C/man4/st.4:310
9957 #, no-wrap
9958 msgid "B<MTFSR>"
9959 msgstr ""
9960
9961 #. type: Plain text
9962 #: build/C/man4/st.4:315
9963 msgid "Forward space over I<mt_count> records (tape blocks)."
9964 msgstr ""
9965
9966 #. type: TP
9967 #: build/C/man4/st.4:315
9968 #, no-wrap
9969 msgid "B<MTFSS>"
9970 msgstr ""
9971
9972 #. type: Plain text
9973 #: build/C/man4/st.4:320
9974 msgid "Forward space over I<mt_count> setmarks."
9975 msgstr ""
9976
9977 #. type: TP
9978 #: build/C/man4/st.4:320
9979 #, no-wrap
9980 msgid "B<MTLOAD>"
9981 msgstr ""
9982
9983 #. type: Plain text
9984 #: build/C/man4/st.4:331
9985 msgid ""
9986 "Execute the SCSI load command.  A special case is available for some HP "
9987 "autoloaders.  If I<mt_count> is the constant B<MT_ST_HPLOADER_OFFSET> plus a "
9988 "number, the number is sent to the drive to control the autoloader."
9989 msgstr ""
9990
9991 #. type: TP
9992 #: build/C/man4/st.4:331
9993 #, no-wrap
9994 msgid "B<MTLOCK>"
9995 msgstr ""
9996
9997 #. type: Plain text
9998 #: build/C/man4/st.4:334
9999 msgid "Lock the tape drive door."
10000 msgstr ""
10001
10002 #. type: TP
10003 #: build/C/man4/st.4:334
10004 #, no-wrap
10005 msgid "B<MTMKPART>"
10006 msgstr ""
10007
10008 #. type: Plain text
10009 #: build/C/man4/st.4:348
10010 msgid ""
10011 "Format the tape into one or two partitions.  If I<mt_count> is nonzero, it "
10012 "gives the size of the first partition and the second partition contains the "
10013 "rest of the tape.  If I<mt_count> is zero, the tape is formatted into one "
10014 "partition.  This command is not allowed for a drive unless the partition "
10015 "support is enabled for the drive (see B<MT_ST_CAN_PARTITIONS> below)."
10016 msgstr ""
10017
10018 #. type: TP
10019 #: build/C/man4/st.4:348
10020 #, no-wrap
10021 msgid "B<MTNOP>"
10022 msgstr ""
10023
10024 #. type: Plain text
10025 #: build/C/man4/st.4:353
10026 msgid ""
10027 "No op\\(emflushes the driver's buffer as a side effect.  Should be used "
10028 "before reading status with B<MTIOCGET>."
10029 msgstr ""
10030
10031 #. type: TP
10032 #: build/C/man4/st.4:353
10033 #, no-wrap
10034 msgid "B<MTOFFL>"
10035 msgstr ""
10036
10037 #. type: Plain text
10038 #: build/C/man4/st.4:356
10039 msgid "Rewind and put the drive off line."
10040 msgstr ""
10041
10042 #. type: TP
10043 #: build/C/man4/st.4:356
10044 #, no-wrap
10045 msgid "B<MTRESET>"
10046 msgstr ""
10047
10048 #. type: Plain text
10049 #: build/C/man4/st.4:359
10050 msgid "Reset drive."
10051 msgstr ""
10052
10053 #. type: TP
10054 #: build/C/man4/st.4:359
10055 #, no-wrap
10056 msgid "B<MTRETEN>"
10057 msgstr ""
10058
10059 #. type: Plain text
10060 #: build/C/man4/st.4:362
10061 msgid "Re-tension tape."
10062 msgstr ""
10063
10064 #. type: TP
10065 #: build/C/man4/st.4:362
10066 #, no-wrap
10067 msgid "B<MTREW>"
10068 msgstr ""
10069
10070 #. type: Plain text
10071 #: build/C/man4/st.4:365
10072 msgid "Rewind."
10073 msgstr ""
10074
10075 #. type: TP
10076 #: build/C/man4/st.4:365
10077 #, no-wrap
10078 msgid "B<MTSEEK>"
10079 msgstr ""
10080
10081 #. type: Plain text
10082 #: build/C/man4/st.4:377
10083 msgid ""
10084 "Seek to the tape block number specified in I<mt_count>.  This operation "
10085 "requires either a SCSI-2 drive that supports the B<LOCATE> command "
10086 "(device-specific address)  or a Tandberg-compatible SCSI-1 drive (Tandberg, "
10087 "Archive Viper, Wangtek, ...).  The block number should be one that was "
10088 "previously returned by B<MTIOCPOS> if device-specific addresses are used."
10089 msgstr ""
10090
10091 #. type: TP
10092 #: build/C/man4/st.4:377
10093 #, no-wrap
10094 msgid "B<MTSETBLK>"
10095 msgstr ""
10096
10097 #. type: Plain text
10098 #: build/C/man4/st.4:382
10099 msgid ""
10100 "Set the drive's block length to the value specified in I<mt_count>.  A block "
10101 "length of zero sets the drive to variable block size mode."
10102 msgstr ""
10103
10104 #. type: TP
10105 #: build/C/man4/st.4:382
10106 #, no-wrap
10107 msgid "B<MTSETDENSITY>"
10108 msgstr ""
10109
10110 #. type: Plain text
10111 #: build/C/man4/st.4:388
10112 msgid ""
10113 "Set the tape density to the code in I<mt_count>.  The density codes "
10114 "supported by a drive can be found from the drive documentation."
10115 msgstr ""
10116
10117 #. type: TP
10118 #: build/C/man4/st.4:388
10119 #, no-wrap
10120 msgid "B<MTSETPART>"
10121 msgstr ""
10122
10123 #. type: Plain text
10124 #: build/C/man4/st.4:397
10125 msgid ""
10126 "The active partition is switched to I<mt_count>.  The partitions are "
10127 "numbered from zero.  This command is not allowed for a drive unless the "
10128 "partition support is enabled for the drive (see B<MT_ST_CAN_PARTITIONS> "
10129 "below)."
10130 msgstr ""
10131
10132 #. type: TP
10133 #: build/C/man4/st.4:397
10134 #, no-wrap
10135 msgid "B<MTUNLOAD>"
10136 msgstr ""
10137
10138 #. type: Plain text
10139 #: build/C/man4/st.4:400
10140 msgid "Execute the SCSI unload command (does not eject the tape)."
10141 msgstr ""
10142
10143 #. type: TP
10144 #: build/C/man4/st.4:400
10145 #, no-wrap
10146 msgid "B<MTUNLOCK>"
10147 msgstr ""
10148
10149 #. type: Plain text
10150 #: build/C/man4/st.4:403
10151 msgid "Unlock the tape drive door."
10152 msgstr ""
10153
10154 #. type: TP
10155 #: build/C/man4/st.4:403
10156 #, no-wrap
10157 msgid "B<MTWEOF>"
10158 msgstr ""
10159
10160 #. type: Plain text
10161 #: build/C/man4/st.4:408
10162 msgid "Write I<mt_count> filemarks."
10163 msgstr ""
10164
10165 #. type: TP
10166 #: build/C/man4/st.4:408
10167 #, no-wrap
10168 msgid "B<MTWSM>"
10169 msgstr ""
10170
10171 #. type: Plain text
10172 #: build/C/man4/st.4:413
10173 msgid "Write I<mt_count> setmarks."
10174 msgstr ""
10175
10176 #. type: Plain text
10177 #: build/C/man4/st.4:415
10178 msgid "Magnetic Tape operations for setting of device options (by the superuser):"
10179 msgstr ""
10180
10181 #. type: TP
10182 #: build/C/man4/st.4:415
10183 #, no-wrap
10184 msgid "B<MTSETDRVBUFFER>"
10185 msgstr ""
10186
10187 #. type: Plain text
10188 #: build/C/man4/st.4:424
10189 msgid ""
10190 "Set various drive and driver options according to bits encoded in "
10191 "I<mt_count>.  These consist of the drive's buffering mode, a set of Boolean "
10192 "driver options, the buffer write threshold, defaults for the block size and "
10193 "density, and timeouts (only in kernels 2.1 and later).  A single operation "
10194 "can affect only one item in the list above (the Booleans counted as one "
10195 "item.)"
10196 msgstr ""
10197
10198 #. type: Plain text
10199 #: build/C/man4/st.4:428
10200 msgid ""
10201 "A value having zeros in the high-order 4 bits will be used to set the "
10202 "drive's buffering mode.  The buffering modes are:"
10203 msgstr ""
10204
10205 #. type: IP
10206 #: build/C/man4/st.4:429
10207 #, no-wrap
10208 msgid "0"
10209 msgstr ""
10210
10211 #. type: Plain text
10212 #: build/C/man4/st.4:434
10213 msgid ""
10214 "The drive will not report B<GOOD> status on write commands until the data "
10215 "blocks are actually written to the medium."
10216 msgstr ""
10217
10218 #. type: IP
10219 #: build/C/man4/st.4:434
10220 #, no-wrap
10221 msgid "1"
10222 msgstr ""
10223
10224 #. type: Plain text
10225 #: build/C/man4/st.4:439
10226 msgid ""
10227 "The drive may report B<GOOD> status on write commands as soon as all the "
10228 "data has been transferred to the drive's internal buffer."
10229 msgstr ""
10230
10231 #. type: IP
10232 #: build/C/man4/st.4:439
10233 #, no-wrap
10234 msgid "2"
10235 msgstr ""
10236
10237 #. type: Plain text
10238 #: build/C/man4/st.4:446
10239 msgid ""
10240 "The drive may report B<GOOD> status on write commands as soon as (a) all the "
10241 "data has been transferred to the drive's internal buffer, and (b) all "
10242 "buffered data from different initiators has been successfully written to the "
10243 "medium."
10244 msgstr ""
10245
10246 #. type: Plain text
10247 #: build/C/man4/st.4:457
10248 msgid ""
10249 "To control the write threshold the value in I<mt_count> must include the "
10250 "constant B<MT_ST_WRITE_THRESHOLD> bitwise ORed with a block count in the low "
10251 "28 bits.  The block count refers to 1024-byte blocks, not the physical block "
10252 "size on the tape.  The threshold cannot exceed the driver's internal buffer "
10253 "size (see DESCRIPTION, above)."
10254 msgstr ""
10255
10256 #. type: Plain text
10257 #: build/C/man4/st.4:478
10258 msgid ""
10259 "To set and clear the Boolean options the value in I<mt_count> must include "
10260 "one of the constants B<MT_ST_BOOLEANS>, B<MT_ST_SETBOOLEANS>, "
10261 "B<MT_ST_CLEARBOOLEANS>, or B<MT_ST_DEFBOOLEANS> bitwise ORed with whatever "
10262 "combination of the following options is desired.  Using B<MT_ST_BOOLEANS> "
10263 "the options can be set to the values defined in the corresponding bits.  "
10264 "With B<MT_ST_SETBOOLEANS> the options can be selectively set and with "
10265 "B<MT_ST_DEFBOOLEANS> selectively cleared."
10266 msgstr ""
10267
10268 #. type: Plain text
10269 #: build/C/man4/st.4:486
10270 msgid ""
10271 "The default options for a tape device are set with B<MT_ST_DEFBOOLEANS>.  A "
10272 "nonactive tape device (e.g., device with minor 32 or 160) is activated when "
10273 "the default options for it are defined the first time.  An activated device "
10274 "inherits from the device activated at start-up the options not set "
10275 "explicitly."
10276 msgstr ""
10277
10278 #. type: Plain text
10279 #: build/C/man4/st.4:488
10280 msgid "The Boolean options are:"
10281 msgstr ""
10282
10283 #. type: TP
10284 #: build/C/man4/st.4:489
10285 #, no-wrap
10286 msgid "B<MT_ST_BUFFER_WRITES> (Default: true)"
10287 msgstr ""
10288
10289 #. type: Plain text
10290 #: build/C/man4/st.4:495
10291 msgid ""
10292 "Buffer all write operations in fixed-block mode.  If this option is false "
10293 "and the drive uses a fixed block size, then all write operations must be for "
10294 "a multiple of the block size.  This option must be set false to write "
10295 "reliable multivolume archives."
10296 msgstr ""
10297
10298 #. type: TP
10299 #: build/C/man4/st.4:495
10300 #, no-wrap
10301 msgid "B<MT_ST_ASYNC_WRITES> (Default: true)"
10302 msgstr ""
10303
10304 #. type: Plain text
10305 #: build/C/man4/st.4:505
10306 msgid ""
10307 "When this option is true, write operations return immediately without "
10308 "waiting for the data to be transferred to the drive if the data fits into "
10309 "the driver's buffer.  The write threshold determines how full the buffer "
10310 "must be before a new SCSI write command is issued.  Any errors reported by "
10311 "the drive will be held until the next operation.  This option must be set "
10312 "false to write reliable multivolume archives."
10313 msgstr ""
10314
10315 #. type: TP
10316 #: build/C/man4/st.4:505
10317 #, no-wrap
10318 msgid "B<MT_ST_READ_AHEAD> (Default: true)"
10319 msgstr ""
10320
10321 #. type: Plain text
10322 #: build/C/man4/st.4:511
10323 msgid ""
10324 "This option causes the driver to provide read buffering and read-ahead in "
10325 "fixed-block mode.  If this option is false and the drive uses a fixed block "
10326 "size, then all read operations must be for a multiple of the block size."
10327 msgstr ""
10328
10329 #. type: TP
10330 #: build/C/man4/st.4:511
10331 #, no-wrap
10332 msgid "B<MT_ST_TWO_FM> (Default: false)"
10333 msgstr ""
10334
10335 #. type: Plain text
10336 #: build/C/man4/st.4:517
10337 msgid ""
10338 "This option modifies the driver behavior when a file is closed.  The normal "
10339 "action is to write a single filemark.  If the option is true, the driver "
10340 "will write two filemarks and backspace over the second one."
10341 msgstr ""
10342
10343 #. type: Plain text
10344 #: build/C/man4/st.4:526
10345 msgid ""
10346 "Note: This option should not be set true for QIC tape drives since they are "
10347 "unable to overwrite a filemark.  These drives detect the end of recorded "
10348 "data by testing for blank tape rather than two consecutive filemarks.  Most "
10349 "other current drives also detect the end of recorded data and using two "
10350 "filemarks is usually necessary only when interchanging tapes with some other "
10351 "systems."
10352 msgstr ""
10353
10354 #. type: TP
10355 #: build/C/man4/st.4:526
10356 #, no-wrap
10357 msgid "B<MT_ST_DEBUGGING> (Default: false)"
10358 msgstr ""
10359
10360 #. type: Plain text
10361 #: build/C/man4/st.4:532
10362 msgid ""
10363 "This option turns on various debugging messages from the driver (effective "
10364 "only if the driver was compiled with B<DEBUG> defined nonzero)."
10365 msgstr ""
10366
10367 #. type: TP
10368 #: build/C/man4/st.4:532
10369 #, no-wrap
10370 msgid "B<MT_ST_FAST_EOM> (Default: false)"
10371 msgstr ""
10372
10373 #. type: Plain text
10374 #: build/C/man4/st.4:546
10375 msgid ""
10376 "This option causes the B<MTEOM> operation to be sent directly to the drive, "
10377 "potentially speeding up the operation but causing the driver to lose track "
10378 "of the current file number normally returned by the B<MTIOCGET> request.  If "
10379 "B<MT_ST_FAST_EOM> is false, the driver will respond to an B<MTEOM> request "
10380 "by forward spacing over files."
10381 msgstr ""
10382
10383 #. type: TP
10384 #: build/C/man4/st.4:546
10385 #, no-wrap
10386 msgid "B<MT_ST_AUTO_LOCK> (Default: false)"
10387 msgstr ""
10388
10389 #. type: Plain text
10390 #: build/C/man4/st.4:550
10391 msgid ""
10392 "When this option is true, the drive door is locked when the device is opened "
10393 "and unlocked when it is closed."
10394 msgstr ""
10395
10396 #. type: TP
10397 #: build/C/man4/st.4:550
10398 #, no-wrap
10399 msgid "B<MT_ST_DEF_WRITES> (Default: false)"
10400 msgstr ""
10401
10402 #. type: Plain text
10403 #: build/C/man4/st.4:567
10404 msgid ""
10405 "The tape options (block size, mode, compression, etc.) may change when "
10406 "changing from one device linked to a drive to another device linked to the "
10407 "same drive depending on how the devices are defined.  This option defines "
10408 "when the changes are enforced by the driver using SCSI-commands and when the "
10409 "drives auto-detection capabilities are relied upon.  If this option is "
10410 "false, the driver sends the SCSI-commands immediately when the device is "
10411 "changed.  If the option is true, the SCSI-commands are not sent until a "
10412 "write is requested.  In this case, the drive firmware is allowed to detect "
10413 "the tape structure when reading and the SCSI-commands are used only to make "
10414 "sure that a tape is written according to the correct specification."
10415 msgstr ""
10416
10417 #. type: TP
10418 #: build/C/man4/st.4:567
10419 #, no-wrap
10420 msgid "B<MT_ST_CAN_BSR> (Default: false)"
10421 msgstr ""
10422
10423 #. type: Plain text
10424 #: build/C/man4/st.4:580
10425 msgid ""
10426 "When read-ahead is used, the tape must sometimes be spaced backward to the "
10427 "correct position when the device is closed and the SCSI command to space "
10428 "backward over records is used for this purpose.  Some older drives can't "
10429 "process this command reliably and this option can be used to instruct the "
10430 "driver not to use the command.  The end result is that, with read-ahead and "
10431 "fixed-block mode, the tape may not be correctly positioned within a file "
10432 "when the device is closed.  With 2.6 kernel, the default is true for drives "
10433 "supporting SCSI-3."
10434 msgstr ""
10435
10436 #. type: TP
10437 #: build/C/man4/st.4:580
10438 #, no-wrap
10439 msgid "B<MT_ST_NO_BLKLIMS> (Default: false)"
10440 msgstr ""
10441
10442 #. type: Plain text
10443 #: build/C/man4/st.4:589
10444 msgid ""
10445 "Some drives don't accept the B<READ BLOCK LIMITS> SCSI command.  If this is "
10446 "used, the driver does not use the command.  The drawback is that the driver "
10447 "can't check before sending commands if the selected block size is acceptable "
10448 "to the drive."
10449 msgstr ""
10450
10451 #. type: TP
10452 #: build/C/man4/st.4:589
10453 #, no-wrap
10454 msgid "B<MT_ST_CAN_PARTITIONS> (Default: false)"
10455 msgstr ""
10456
10457 #. type: Plain text
10458 #: build/C/man4/st.4:594
10459 msgid ""
10460 "This option enables support for several partitions within a tape.  The "
10461 "option applies to all devices linked to a drive."
10462 msgstr ""
10463
10464 #. type: TP
10465 #: build/C/man4/st.4:594
10466 #, no-wrap
10467 msgid "B<MT_ST_SCSI2LOGICAL> (Default: false)"
10468 msgstr ""
10469
10470 #. type: Plain text
10471 #: build/C/man4/st.4:609
10472 msgid ""
10473 "This option instructs the driver to use the logical block addresses defined "
10474 "in the SCSI-2 standard when performing the seek and tell operations (both "
10475 "with B<MTSEEK> and B<MTIOCPOS> commands and when changing tape partition).  "
10476 "Otherwise, the device-specific addresses are used.  It is highly advisable "
10477 "to set this option if the drive supports the logical addresses because they "
10478 "count also filemarks.  There are some drives that support only the logical "
10479 "block addresses."
10480 msgstr ""
10481
10482 #. type: TP
10483 #: build/C/man4/st.4:609
10484 #, no-wrap
10485 msgid "B<MT_ST_SYSV> (Default: false)"
10486 msgstr ""
10487
10488 #. type: Plain text
10489 #: build/C/man4/st.4:620
10490 msgid ""
10491 "When this option is enabled, the tape devices use the SystemV semantics.  "
10492 "Otherwise, the BSD semantics are used.  The most important difference "
10493 "between the semantics is what happens when a device used for reading is "
10494 "closed: in System V semantics the tape is spaced forward past the next "
10495 "filemark if this has not happened while using the device.  In BSD semantics "
10496 "the tape position is not changed."
10497 msgstr ""
10498
10499 #. type: TP
10500 #: build/C/man4/st.4:620
10501 #, no-wrap
10502 msgid "B<MT_NO_WAIT> (Default: false)"
10503 msgstr ""
10504
10505 #. type: Plain text
10506 #: build/C/man4/st.4:624
10507 msgid ""
10508 "Enables immediate mode (i.e., don't wait for the command to finish) for some "
10509 "commands (e.g., rewind)."
10510 msgstr ""
10511
10512 #. type: Plain text
10513 #: build/C/man4/st.4:626
10514 msgid "An example:"
10515 msgstr ""
10516
10517 #. type: Plain text
10518 #: build/C/man4/st.4:634
10519 #, no-wrap
10520 msgid ""
10521 "struct mtop mt_cmd;\n"
10522 "mt_cmd.mt_op = MTSETDRVBUFFER;\n"
10523 "mt_cmd.mt_count = MT_ST_BOOLEANS |\n"
10524 "        MT_ST_BUFFER_WRITES | MT_ST_ASYNC_WRITES;\n"
10525 "ioctl(fd, MTIOCTOP, mt_cmd);\n"
10526 msgstr ""
10527
10528 #. type: Plain text
10529 #: build/C/man4/st.4:644
10530 msgid ""
10531 "The default block size for a device can be set with B<MT_ST_DEF_BLKSIZE> and "
10532 "the default density code can be set with B<MT_ST_DEFDENSITY>.  The values "
10533 "for the parameters are or'ed with the operation code."
10534 msgstr ""
10535
10536 #. type: Plain text
10537 #: build/C/man4/st.4:661
10538 msgid ""
10539 "With kernels 2.1.x and later, the timeout values can be set with the "
10540 "subcommand B<MT_ST_SET_TIMEOUT> ORed with the timeout in seconds.  The long "
10541 "timeout (used for rewinds and other commands that may take a long time) can "
10542 "be set with B<MT_ST_SET_LONG_TIMEOUT>.  The kernel defaults are very long to "
10543 "make sure that a successful command is not timed out with any drive.  "
10544 "Because of this the driver may seem stuck even if it is only waiting for the "
10545 "timeout.  These commands can be used to set more practical values for a "
10546 "specific drive.  The timeouts set for one device apply for all devices "
10547 "linked to the same drive."
10548 msgstr ""
10549
10550 #. type: Plain text
10551 #: build/C/man4/st.4:682
10552 msgid ""
10553 "Starting from kernels 2.4.19 and 2.5.43, the driver supports a status bit "
10554 "which indicates whether the drive requests cleaning.  The method used by the "
10555 "drive to return cleaning information is set using the B<MT_ST_SEL_CLN> "
10556 "subcommand.  If the value is zero, the cleaning bit is always zero.  If the "
10557 "value is one, the TapeAlert data defined in the SCSI-3 standard is used (not "
10558 "yet implemented).  Values 2-17 are reserved.  If the lowest eight bits are "
10559 "E<gt>= 18, bits from the extended sense data are used.  The bits 9-16 "
10560 "specify a mask to select the bits to look at and the bits 17-23 specify the "
10561 "bit pattern to look for.  If the bit pattern is zero, one or more bits under "
10562 "the mask indicate the cleaning request.  If the pattern is nonzero, the "
10563 "pattern must match the masked sense data byte."
10564 msgstr ""
10565
10566 #. type: SS
10567 #: build/C/man4/st.4:682
10568 #, no-wrap
10569 msgid "MTIOCGET \\(em get status"
10570 msgstr ""
10571
10572 #. type: Plain text
10573 #: build/C/man4/st.4:686
10574 msgid "This request takes an argument of type I<(struct mtget\\ *)>."
10575 msgstr ""
10576
10577 #. type: Plain text
10578 #: build/C/man4/st.4:701
10579 #, no-wrap
10580 msgid ""
10581 "/* structure for MTIOCGET - mag tape get status command */\n"
10582 "struct mtget {\n"
10583 "    long     mt_type;\n"
10584 "    long     mt_resid;\n"
10585 "    /* the following registers are device dependent */\n"
10586 "    long     mt_dsreg;\n"
10587 "    long     mt_gstat;\n"
10588 "    long     mt_erreg;\n"
10589 "    /* The next two fields are not always used */\n"
10590 "    daddr_t  mt_fileno;\n"
10591 "    daddr_t  mt_blkno;\n"
10592 "};\n"
10593 msgstr ""
10594
10595 #. type: IP
10596 #: build/C/man4/st.4:703
10597 #, no-wrap
10598 msgid "I<mt_type>"
10599 msgstr ""
10600
10601 #. type: Plain text
10602 #: build/C/man4/st.4:712
10603 msgid ""
10604 "The header file defines many values for I<mt_type>, but the current driver "
10605 "reports only the generic types B<MT_ISSCSI1> (Generic SCSI-1 tape)  and "
10606 "B<MT_ISSCSI2> (Generic SCSI-2 tape)."
10607 msgstr ""
10608
10609 #. type: IP
10610 #: build/C/man4/st.4:712
10611 #, no-wrap
10612 msgid "I<mt_resid>"
10613 msgstr ""
10614
10615 #. type: Plain text
10616 #: build/C/man4/st.4:714
10617 msgid "contains the current tape partition number."
10618 msgstr ""
10619
10620 #. type: IP
10621 #: build/C/man4/st.4:714
10622 #, no-wrap
10623 msgid "I<mt_dsreg>"
10624 msgstr ""
10625
10626 #. type: Plain text
10627 #: build/C/man4/st.4:723
10628 msgid ""
10629 "reports the drive's current settings for block size (in the low 24 bits) and "
10630 "density (in the high 8 bits).  These fields are defined by "
10631 "B<MT_ST_BLKSIZE_SHIFT>, B<MT_ST_BLKSIZE_MASK>, B<MT_ST_DENSITY_SHIFT>, and "
10632 "B<MT_ST_DENSITY_MASK>."
10633 msgstr ""
10634
10635 #. type: IP
10636 #: build/C/man4/st.4:723
10637 #, no-wrap
10638 msgid "I<mt_gstat>"
10639 msgstr ""
10640
10641 #. type: Plain text
10642 #: build/C/man4/st.4:726
10643 msgid ""
10644 "reports generic (device independent) status information.  The header file "
10645 "defines macros for testing these status bits:"
10646 msgstr ""
10647
10648 #. type: Plain text
10649 #: build/C/man4/st.4:733
10650 msgid ""
10651 "B<GMT_EOF>(I<x>): The tape is positioned just after a filemark (always false "
10652 "after an B<MTSEEK> operation)."
10653 msgstr ""
10654
10655 #. type: Plain text
10656 #: build/C/man4/st.4:739
10657 msgid ""
10658 "B<GMT_BOT>(I<x>): The tape is positioned at the beginning of the first file "
10659 "(always false after an B<MTSEEK> operation)."
10660 msgstr ""
10661
10662 #. type: Plain text
10663 #: build/C/man4/st.4:742
10664 msgid "B<GMT_EOT>(I<x>): A tape operation has reached the physical End Of Tape."
10665 msgstr ""
10666
10667 #. type: Plain text
10668 #: build/C/man4/st.4:748
10669 msgid ""
10670 "B<GMT_SM>(I<x>): The tape is currently positioned at a setmark (always false "
10671 "after an B<MTSEEK> operation)."
10672 msgstr ""
10673
10674 #. type: Plain text
10675 #: build/C/man4/st.4:751
10676 msgid "B<GMT_EOD>(I<x>): The tape is positioned at the end of recorded data."
10677 msgstr ""
10678
10679 #. type: Plain text
10680 #: build/C/man4/st.4:756
10681 msgid ""
10682 "B<GMT_WR_PROT>(I<x>): The drive is write-protected.  For some drives this "
10683 "can also mean that the drive does not support writing on the current medium "
10684 "type."
10685 msgstr ""
10686
10687 #. type: Plain text
10688 #: build/C/man4/st.4:761
10689 msgid ""
10690 "B<GMT_ONLINE>(I<x>): The last B<open>(2)  found the drive with a tape in "
10691 "place and ready for operation."
10692 msgstr ""
10693
10694 #. type: Plain text
10695 #: build/C/man4/st.4:765
10696 msgid ""
10697 "B<GMT_D_6250>(I<x>), B<GMT_D_1600>(I<x>), B<GMT_D_800>(I<x>): This "
10698 "\\(lqgeneric\\(rq status information reports the current density setting for "
10699 "9-track \\(12\" tape drives only."
10700 msgstr ""
10701
10702 #. type: Plain text
10703 #: build/C/man4/st.4:768
10704 msgid "B<GMT_DR_OPEN>(I<x>): The drive does not have a tape in place."
10705 msgstr ""
10706
10707 #. type: Plain text
10708 #: build/C/man4/st.4:776
10709 msgid ""
10710 "B<GMT_IM_REP_EN>(I<x>): Immediate report mode.  This bit is set if there are "
10711 "no guarantees that the data has been physically written to the tape when the "
10712 "write call returns.  It is set zero only when the driver does not buffer "
10713 "data and the drive is set not to buffer data."
10714 msgstr ""
10715
10716 #. type: Plain text
10717 #: build/C/man4/st.4:780
10718 msgid ""
10719 "B<GMT_CLN>(I<x>): The drive has requested cleaning.  Implemented in kernels "
10720 "since 2.4.19 and 2.5.43."
10721 msgstr ""
10722
10723 #. type: IP
10724 #: build/C/man4/st.4:781
10725 #, no-wrap
10726 msgid "I<mt_erreg>"
10727 msgstr ""
10728
10729 #. type: Plain text
10730 #: build/C/man4/st.4:791
10731 msgid ""
10732 "The only field defined in I<mt_erreg> is the recovered error count in the "
10733 "low 16 bits (as defined by B<MT_ST_SOFTERR_SHIFT> and "
10734 "B<MT_ST_SOFTERR_MASK>.  Due to inconsistencies in the way drives report "
10735 "recovered errors, this count is often not maintained (most drives do not by "
10736 "default report soft errors but this can be changed with a SCSI MODE SELECT "
10737 "command)."
10738 msgstr ""
10739
10740 #. type: IP
10741 #: build/C/man4/st.4:791
10742 #, no-wrap
10743 msgid "I<mt_fileno>"
10744 msgstr ""
10745
10746 #. type: Plain text
10747 #: build/C/man4/st.4:797
10748 msgid ""
10749 "reports the current file number (zero-based).  This value is set to -1 when "
10750 "the file number is unknown (e.g., after B<MTBSS> or B<MTSEEK>)."
10751 msgstr ""
10752
10753 #. type: IP
10754 #: build/C/man4/st.4:797
10755 #, no-wrap
10756 msgid "I<mt_blkno>"
10757 msgstr ""
10758
10759 #. type: Plain text
10760 #: build/C/man4/st.4:804
10761 msgid ""
10762 "reports the block number (zero-based) within the current file.  This value "
10763 "is set to -1 when the block number is unknown (e.g., after B<MTBSF>, "
10764 "B<MTBSS>, or B<MTSEEK>)."
10765 msgstr ""
10766
10767 #. type: SS
10768 #: build/C/man4/st.4:804
10769 #, no-wrap
10770 msgid "MTIOCPOS \\(em get tape position"
10771 msgstr ""
10772
10773 #. type: Plain text
10774 #: build/C/man4/st.4:818
10775 msgid ""
10776 "This request takes an argument of type I<(struct mtpos\\ *)> and reports the "
10777 "drive's notion of the current tape block number, which is not the same as "
10778 "I<mt_blkno> returned by B<MTIOCGET>.  This drive must be a SCSI-2 drive that "
10779 "supports the B<READ POSITION> command (device-specific address)  or a "
10780 "Tandberg-compatible SCSI-1 drive (Tandberg, Archive Viper, Wangtek, ... )."
10781 msgstr ""
10782
10783 #. type: Plain text
10784 #: build/C/man4/st.4:825
10785 #, no-wrap
10786 msgid ""
10787 "/* structure for MTIOCPOS - mag tape get position command */\n"
10788 "struct mtpos {\n"
10789 "    long mt_blkno;    /* current block number */\n"
10790 "};\n"
10791 msgstr ""
10792
10793 #. type: Plain text
10794 #: build/C/man4/st.4:834
10795 msgid ""
10796 "An attempt was made to write or erase a write-protected tape.  (This error "
10797 "is not detected during B<open>(2).)"
10798 msgstr ""
10799
10800 #. type: TP
10801 #: build/C/man4/st.4:834
10802 #, no-wrap
10803 msgid "B<EBUSY>"
10804 msgstr ""
10805
10806 #. type: Plain text
10807 #: build/C/man4/st.4:838
10808 msgid "The device is already in use or the driver was unable to allocate a buffer."
10809 msgstr ""
10810
10811 #. type: Plain text
10812 #: build/C/man4/st.4:842
10813 msgid "The command parameters point to memory not belonging to the calling process."
10814 msgstr ""
10815
10816 #. type: Plain text
10817 #: build/C/man4/st.4:847
10818 msgid ""
10819 "An B<ioctl>(2)  had an invalid argument, or a requested block size was "
10820 "invalid."
10821 msgstr ""
10822
10823 #. type: TP
10824 #: build/C/man4/st.4:847
10825 #, no-wrap
10826 msgid "B<EIO>"
10827 msgstr ""
10828
10829 #. type: Plain text
10830 #: build/C/man4/st.4:850
10831 msgid "The requested operation could not be completed."
10832 msgstr ""
10833
10834 #. type: Plain text
10835 #: build/C/man4/st.4:857
10836 msgid ""
10837 "The byte count in B<read>(2)  is smaller than the next physical block on the "
10838 "tape.  (Before 2.2.18 and 2.4.0-test6 the extra bytes have been silently "
10839 "ignored.)"
10840 msgstr ""
10841
10842 #. type: Plain text
10843 #: build/C/man4/st.4:861
10844 msgid ""
10845 "A write operation could not be completed because the tape reached "
10846 "end-of-medium."
10847 msgstr ""
10848
10849 #. type: TP
10850 #: build/C/man4/st.4:861 build/C/man2/syslog.2:278
10851 #, no-wrap
10852 msgid "B<ENOSYS>"
10853 msgstr ""
10854
10855 #. type: Plain text
10856 #: build/C/man4/st.4:865
10857 msgid "Unknown B<ioctl>(2)."
10858 msgstr ""
10859
10860 #. type: TP
10861 #: build/C/man4/st.4:865
10862 #, no-wrap
10863 msgid "B<ENXIO>"
10864 msgstr ""
10865
10866 #. type: Plain text
10867 #: build/C/man4/st.4:868
10868 msgid "During opening, the tape device does not exist."
10869 msgstr ""
10870
10871 #. type: TP
10872 #: build/C/man4/st.4:868
10873 #, no-wrap
10874 msgid "B<EOVERFLOW>"
10875 msgstr ""
10876
10877 #. type: Plain text
10878 #: build/C/man4/st.4:872
10879 msgid ""
10880 "An attempt was made to read or write a variable-length block that is larger "
10881 "than the driver's internal buffer."
10882 msgstr ""
10883
10884 #. type: Plain text
10885 #: build/C/man4/st.4:879
10886 msgid ""
10887 "Open is attempted with B<O_WRONLY> or B<O_RDWR> when the tape in the drive "
10888 "is write-protected."
10889 msgstr ""
10890
10891 #. type: TP
10892 #: build/C/man4/st.4:880
10893 #, no-wrap
10894 msgid "I</dev/st*>"
10895 msgstr ""
10896
10897 #. type: Plain text
10898 #: build/C/man4/st.4:883
10899 msgid "the auto-rewind SCSI tape devices"
10900 msgstr ""
10901
10902 #. type: TP
10903 #: build/C/man4/st.4:883
10904 #, no-wrap
10905 msgid "I</dev/nst*>"
10906 msgstr ""
10907
10908 #.  .SH AUTHOR
10909 #.  The driver has been written by Kai M\(:akisara (Kai.Makisara@metla.fi)
10910 #.  starting from a driver written by Dwayne Forsyth.
10911 #.  Several other
10912 #.  people have also contributed to the driver.
10913 #. type: Plain text
10914 #: build/C/man4/st.4:891
10915 msgid "the nonrewind SCSI tape devices"
10916 msgstr ""
10917
10918 #. type: Plain text
10919 #: build/C/man4/st.4:912
10920 msgid ""
10921 "When exchanging data between systems, both systems have to agree on the "
10922 "physical tape block size.  The parameters of a drive after startup are often "
10923 "not the ones most operating systems use with these devices.  Most systems "
10924 "use drives in variable-block mode if the drive supports that mode.  This "
10925 "applies to most modern drives, including DATs, 8mm helical scan drives, "
10926 "DLTs, etc.  It may be advisable to use these drives in variable-block mode "
10927 "also in Linux (i.e., use B<MTSETBLK> or B<MTSETDEFBLK> at system startup to "
10928 "set the mode), at least when exchanging data with a foreign system.  The "
10929 "drawback of this is that a fairly large tape block size has to be used to "
10930 "get acceptable data transfer rates on the SCSI bus."
10931 msgstr ""
10932
10933 #. type: Plain text
10934 #: build/C/man4/st.4:919
10935 msgid ""
10936 "Many programs (e.g., B<tar>(1))  allow the user to specify the blocking "
10937 "factor on the command line.  Note that this determines the physical block "
10938 "size on tape only in variable-block mode."
10939 msgstr ""
10940
10941 #. type: Plain text
10942 #: build/C/man4/st.4:926
10943 msgid ""
10944 "In order to use SCSI tape drives, the basic SCSI driver, a SCSI-adapter "
10945 "driver and the SCSI tape driver must be either configured into the kernel or "
10946 "loaded as modules.  If the SCSI-tape driver is not present, the drive is "
10947 "recognized but the tape support described in this page is not available."
10948 msgstr ""
10949
10950 #. type: Plain text
10951 #: build/C/man4/st.4:931
10952 msgid ""
10953 "The driver writes error messages to the console/log.  The SENSE codes "
10954 "written into some messages are automatically translated to text if verbose "
10955 "SCSI messages are enabled in kernel configuration."
10956 msgstr ""
10957
10958 #.  .SH COPYRIGHT
10959 #.  Copyright \(co 1995 Robert K. Nichols.
10960 #.  .br
10961 #.  Copyright \(co 1999-2005 Kai M\(:akisara.
10962 #.  .PP
10963 #.  %%%LICENSE_START(VERBATIM)
10964 #.  Permission is granted to make and distribute verbatim copies of this
10965 #.  manual provided the copyright notice and this permission notice are
10966 #.  preserved on all copies.
10967 #.  Additional permissions are contained in the header of the source file.
10968 #. type: Plain text
10969 #: build/C/man4/st.4:954
10970 msgid ""
10971 "The driver's internal buffering allows good throughput in fixed-block mode "
10972 "also with small B<read>(2)  and B<write>(2)  byte counts.  With direct "
10973 "transfers this is not possible and may cause a surprise when moving to the "
10974 "2.6 kernel.  The solution is to tell the software to use larger transfers "
10975 "(often telling it to use larger blocks).  If this is not possible, direct "
10976 "transfers can be disabled."
10977 msgstr ""
10978
10979 #. type: Plain text
10980 #: build/C/man4/st.4:956
10981 msgid "B<mt>(1)"
10982 msgstr ""
10983
10984 #. type: Plain text
10985 #: build/C/man4/st.4:964
10986 msgid ""
10987 "The file I<drivers/scsi/README.st> or I<Documentation/scsi/st.txt> (kernel "
10988 "E<gt>= 2.6) in the Linux kernel source tree contains the most recent "
10989 "information about the driver and its configuration possibilities"
10990 msgstr ""
10991
10992 #. type: TH
10993 #: build/C/man3/stdarg.3:43
10994 #, no-wrap
10995 msgid "STDARG"
10996 msgstr ""
10997
10998 #. type: TH
10999 #: build/C/man3/stdarg.3:43
11000 #, no-wrap
11001 msgid "2013-12-10"
11002 msgstr ""
11003
11004 #. type: Plain text
11005 #: build/C/man3/stdarg.3:46
11006 msgid "stdarg, va_start, va_arg, va_end, va_copy - variable argument lists"
11007 msgstr ""
11008
11009 #. type: Plain text
11010 #: build/C/man3/stdarg.3:48 build/C/man3/syslog.3:49
11011 msgid "B<#include E<lt>stdarg.hE<gt>>"
11012 msgstr ""
11013
11014 #. type: Plain text
11015 #: build/C/man3/stdarg.3:50
11016 msgid "B<void va_start(va_list >I<ap>B<, >I<last>B<);>"
11017 msgstr ""
11018
11019 #. type: Plain text
11020 #: build/C/man3/stdarg.3:52
11021 msgid "I<type>B< va_arg(va_list >I<ap>B<, >I<type>B<);>"
11022 msgstr ""
11023
11024 #. type: Plain text
11025 #: build/C/man3/stdarg.3:54
11026 msgid "B<void va_end(va_list >I<ap>B<);>"
11027 msgstr ""
11028
11029 #. type: Plain text
11030 #: build/C/man3/stdarg.3:56
11031 msgid "B<void va_copy(va_list >I<dest>B<, va_list >I<src>B<);>"
11032 msgstr ""
11033
11034 #. type: Plain text
11035 #: build/C/man3/stdarg.3:65
11036 msgid ""
11037 "A function may be called with a varying number of arguments of varying "
11038 "types.  The include file I<E<lt>stdarg.hE<gt>> declares a type I<va_list> "
11039 "and defines three macros for stepping through a list of arguments whose "
11040 "number and types are not known to the called function."
11041 msgstr ""
11042
11043 #. type: Plain text
11044 #: build/C/man3/stdarg.3:73
11045 msgid ""
11046 "The called function must declare an object of type I<va_list> which is used "
11047 "by the macros B<va_start>(), B<va_arg>(), and B<va_end>()."
11048 msgstr ""
11049
11050 #. type: SS
11051 #: build/C/man3/stdarg.3:73
11052 #, no-wrap
11053 msgid "va_start()"
11054 msgstr ""
11055
11056 #. type: Plain text
11057 #: build/C/man3/stdarg.3:83
11058 msgid ""
11059 "The B<va_start>()  macro initializes I<ap> for subsequent use by B<va_arg>()  "
11060 "and B<va_end>(), and must be called first."
11061 msgstr ""
11062
11063 #. type: Plain text
11064 #: build/C/man3/stdarg.3:88
11065 msgid ""
11066 "The argument I<last> is the name of the last argument before the variable "
11067 "argument list, that is, the last argument of which the calling function "
11068 "knows the type."
11069 msgstr ""
11070
11071 #. type: Plain text
11072 #: build/C/man3/stdarg.3:93
11073 msgid ""
11074 "Because the address of this argument may be used in the B<va_start>()  "
11075 "macro, it should not be declared as a register variable, or as a function or "
11076 "an array type."
11077 msgstr ""
11078
11079 #. type: SS
11080 #: build/C/man3/stdarg.3:93
11081 #, no-wrap
11082 msgid "va_arg()"
11083 msgstr ""
11084
11085 #. type: Plain text
11086 #: build/C/man3/stdarg.3:115
11087 msgid ""
11088 "The B<va_arg>()  macro expands to an expression that has the type and value "
11089 "of the next argument in the call.  The argument I<ap> is the I<va_list> "
11090 "I<ap> initialized by B<va_start>().  Each call to B<va_arg>()  modifies "
11091 "I<ap> so that the next call returns the next argument.  The argument I<type> "
11092 "is a type name specified so that the type of a pointer to an object that has "
11093 "the specified type can be obtained simply by adding a * to I<type>."
11094 msgstr ""
11095
11096 #. type: Plain text
11097 #: build/C/man3/stdarg.3:123
11098 msgid ""
11099 "The first use of the B<va_arg>()  macro after that of the B<va_start>()  "
11100 "macro returns the argument after I<last>.  Successive invocations return the "
11101 "values of the remaining arguments."
11102 msgstr ""
11103
11104 #. type: Plain text
11105 #: build/C/man3/stdarg.3:128
11106 msgid ""
11107 "If there is no next argument, or if I<type> is not compatible with the type "
11108 "of the actual next argument (as promoted according to the default argument "
11109 "promotions), random errors will occur."
11110 msgstr ""
11111
11112 #. type: Plain text
11113 #: build/C/man3/stdarg.3:136
11114 msgid ""
11115 "If I<ap> is passed to a function that uses B<va_arg(>I<ap>B<,>I<type>B<),> "
11116 "then the value of I<ap> is undefined after the return of that function."
11117 msgstr ""
11118
11119 #. type: SS
11120 #: build/C/man3/stdarg.3:136
11121 #, no-wrap
11122 msgid "va_end()"
11123 msgstr ""
11124
11125 #. type: Plain text
11126 #: build/C/man3/stdarg.3:155
11127 msgid ""
11128 "Each invocation of B<va_start>()  must be matched by a corresponding "
11129 "invocation of B<va_end>()  in the same function.  After the call "
11130 "B<va_end(>I<ap>B<)> the variable I<ap> is undefined.  Multiple traversals of "
11131 "the list, each bracketed by B<va_start>()  and B<va_end>()  are possible.  "
11132 "B<va_end>()  may be a macro or a function."
11133 msgstr ""
11134
11135 #. type: SS
11136 #: build/C/man3/stdarg.3:155
11137 #, no-wrap
11138 msgid "va_copy()"
11139 msgstr ""
11140
11141 #. type: Plain text
11142 #: build/C/man3/stdarg.3:172
11143 msgid ""
11144 "The B<va_copy>()  macro copies the (previously initialized) variable "
11145 "argument list I<src> to I<dest>.  The behavior is as if B<va_start>()  were "
11146 "applied to I<dest> with the same I<last> argument, followed by the same "
11147 "number of B<va_arg>()  invocations that was used to reach the current state "
11148 "of I<src>."
11149 msgstr ""
11150
11151 #.  Proposal from clive@demon.net, 1997-02-28
11152 #. type: Plain text
11153 #: build/C/man3/stdarg.3:179
11154 msgid ""
11155 "An obvious implementation would have a I<va_list> be a pointer to the stack "
11156 "frame of the variadic function.  In such a setup (by far the most common) "
11157 "there seems nothing against an assignment"
11158 msgstr ""
11159
11160 #. type: Plain text
11161 #: build/C/man3/stdarg.3:183
11162 #, no-wrap
11163 msgid "va_list aq = ap;\n"
11164 msgstr ""
11165
11166 #. type: Plain text
11167 #: build/C/man3/stdarg.3:188
11168 msgid ""
11169 "Unfortunately, there are also systems that make it an array of pointers (of "
11170 "length 1), and there one needs"
11171 msgstr ""
11172
11173 #. type: Plain text
11174 #: build/C/man3/stdarg.3:193
11175 #, no-wrap
11176 msgid ""
11177 "va_list aq;\n"
11178 "*aq = *ap;\n"
11179 msgstr ""
11180
11181 #. type: Plain text
11182 #: build/C/man3/stdarg.3:209
11183 msgid ""
11184 "Finally, on systems where arguments are passed in registers, it may be "
11185 "necessary for B<va_start>()  to allocate memory, store the arguments there, "
11186 "and also an indication of which argument is next, so that B<va_arg>()  can "
11187 "step through the list.  Now B<va_end>()  can free the allocated memory "
11188 "again.  To accommodate this situation, C99 adds a macro B<va_copy>(), so "
11189 "that the above assignment can be replaced by"
11190 msgstr ""
11191
11192 #. type: Plain text
11193 #: build/C/man3/stdarg.3:216
11194 #, no-wrap
11195 msgid ""
11196 "va_list aq;\n"
11197 "va_copy(aq, ap);\n"
11198 "\\&...\n"
11199 "va_end(aq);\n"
11200 msgstr ""
11201
11202 #. type: Plain text
11203 #: build/C/man3/stdarg.3:229
11204 msgid ""
11205 "Each invocation of B<va_copy>()  must be matched by a corresponding "
11206 "invocation of B<va_end>()  in the same function.  Some systems that do not "
11207 "supply B<va_copy>()  have B<__va_copy> instead, since that was the name used "
11208 "in the draft proposal."
11209 msgstr ""
11210
11211 #. type: Plain text
11212 #: build/C/man3/stdarg.3:238
11213 msgid ""
11214 "The B<va_start>(), B<va_arg>(), B<va_end>(), and B<va_copy>()  macros are "
11215 "thread-safe."
11216 msgstr ""
11217
11218 #. type: Plain text
11219 #: build/C/man3/stdarg.3:248
11220 msgid ""
11221 "The B<va_start>(), B<va_arg>(), and B<va_end>()  macros conform to C89.  C99 "
11222 "defines the B<va_copy>()  macro."
11223 msgstr ""
11224
11225 #. type: Plain text
11226 #: build/C/man3/stdarg.3:254
11227 msgid ""
11228 "These macros are I<not> compatible with the historic macros they replace.  A "
11229 "backward-compatible version can be found in the include file "
11230 "I<E<lt>varargs.hE<gt>>."
11231 msgstr ""
11232
11233 #. type: Plain text
11234 #: build/C/man3/stdarg.3:256
11235 msgid "The historic setup is:"
11236 msgstr ""
11237
11238 #. type: Plain text
11239 #: build/C/man3/stdarg.3:260
11240 #, no-wrap
11241 msgid "#include E<lt>varargs.hE<gt>\n"
11242 msgstr ""
11243
11244 #. type: Plain text
11245 #: build/C/man3/stdarg.3:266
11246 #, no-wrap
11247 msgid ""
11248 "void\n"
11249 "foo(va_alist)\n"
11250 "    va_dcl\n"
11251 "{\n"
11252 "    va_list ap;\n"
11253 msgstr ""
11254
11255 #. type: Plain text
11256 #: build/C/man3/stdarg.3:275
11257 #, no-wrap
11258 msgid ""
11259 "    va_start(ap);\n"
11260 "    while (...) {\n"
11261 "        ...\n"
11262 "        x = va_arg(ap, type);\n"
11263 "        ...\n"
11264 "    }\n"
11265 "    va_end(ap);\n"
11266 "}\n"
11267 msgstr ""
11268
11269 #. type: Plain text
11270 #: build/C/man3/stdarg.3:284
11271 msgid ""
11272 "On some systems, I<va_end> contains a closing \\(aq}\\(aq matching a "
11273 "\\(aq{\\(aq in I<va_start>, so that both macros must occur in the same "
11274 "function, and in a way that allows this."
11275 msgstr ""
11276
11277 #. type: Plain text
11278 #: build/C/man3/stdarg.3:300
11279 msgid ""
11280 "Unlike the B<varargs> macros, the B<stdarg> macros do not permit programmers "
11281 "to code a function with no fixed arguments.  This problem generates work "
11282 "mainly when converting B<varargs> code to B<stdarg> code, but it also "
11283 "creates difficulties for variadic functions that wish to pass all of their "
11284 "arguments on to a function that takes a I<va_list> argument, such as "
11285 "B<vfprintf>(3)."
11286 msgstr ""
11287
11288 #. type: Plain text
11289 #: build/C/man3/stdarg.3:305
11290 msgid ""
11291 "The function I<foo> takes a string of format characters and prints out the "
11292 "argument associated with each format character based on the type."
11293 msgstr ""
11294
11295 #. type: Plain text
11296 #: build/C/man3/stdarg.3:309
11297 #, no-wrap
11298 msgid ""
11299 "#include E<lt>stdio.hE<gt>\n"
11300 "#include E<lt>stdarg.hE<gt>\n"
11301 msgstr ""
11302
11303 #. type: Plain text
11304 #: build/C/man3/stdarg.3:316
11305 #, no-wrap
11306 msgid ""
11307 "void\n"
11308 "foo(char *fmt, ...)\n"
11309 "{\n"
11310 "    va_list ap;\n"
11311 "    int d;\n"
11312 "    char c, *s;\n"
11313 msgstr ""
11314
11315 #. type: Plain text
11316 #: build/C/man3/stdarg.3:337
11317 #, no-wrap
11318 msgid ""
11319 "    va_start(ap, fmt);\n"
11320 "    while (*fmt)\n"
11321 "        switch (*fmt++) {\n"
11322 "        case \\(aqs\\(aq:              /* string */\n"
11323 "            s = va_arg(ap, char *);\n"
11324 "            printf(\"string %s\\en\", s);\n"
11325 "            break;\n"
11326 "        case \\(aqd\\(aq:              /* int */\n"
11327 "            d = va_arg(ap, int);\n"
11328 "            printf(\"int %d\\en\", d);\n"
11329 "            break;\n"
11330 "        case \\(aqc\\(aq:              /* char */\n"
11331 "            /* need a cast here since va_arg only\n"
11332 "               takes fully promoted types */\n"
11333 "            c = (char) va_arg(ap, int);\n"
11334 "            printf(\"char %c\\en\", c);\n"
11335 "            break;\n"
11336 "        }\n"
11337 "    va_end(ap);\n"
11338 "}\n"
11339 msgstr ""
11340
11341 #. type: TH
11342 #: build/C/man2/syslog.2:31 build/C/man3/syslog.3:36
11343 #, no-wrap
11344 msgid "SYSLOG"
11345 msgstr ""
11346
11347 #. type: TH
11348 #: build/C/man2/syslog.2:31
11349 #, no-wrap
11350 msgid "2012-11-29"
11351 msgstr ""
11352
11353 #. type: Plain text
11354 #: build/C/man2/syslog.2:35
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:39
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:41
11370 #, no-wrap
11371 msgid "/* The glibc interface */\n"
11372 msgstr ""
11373
11374 #. type: Plain text
11375 #: build/C/man2/syslog.2:43
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:45
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 "If you need the C library function B<syslog>()  (which talks to "
11390 "B<syslogd>(8)), then look at B<syslog>(3).  The system call of this name is "
11391 "about controlling the kernel I<printk>()  buffer, and the glibc wrapper "
11392 "function is called B<klogctl>()."
11393 msgstr ""
11394
11395 #. type: SS
11396 #: build/C/man2/syslog.2:57
11397 #, no-wrap
11398 msgid "The kernel log buffer"
11399 msgstr ""
11400
11401 #.  Under "General setup" ==> "Kernel log buffer size"
11402 #.  For 2.6, precisely the option seems to have appeared in 2.5.55.
11403 #. type: Plain text
11404 #: build/C/man2/syslog.2:73
11405 msgid ""
11406 "The kernel has a cyclic buffer of length B<LOG_BUF_LEN> in which messages "
11407 "given as arguments to the kernel function B<printk>()  are stored "
11408 "(regardless of their loglevel).  In early kernels, B<LOG_BUF_LEN> had the "
11409 "value 4096; from kernel 1.3.54, it was 8192; from kernel 2.1.113 it was "
11410 "16384; since 2.4.23/2.6 the value is a kernel configuration option "
11411 "(B<CONFIG_LOG_BUF_SHIFT>).  In recent kernels the size can be queried with "
11412 "command type 10 (see below)."
11413 msgstr ""
11414
11415 #. type: SS
11416 #: build/C/man2/syslog.2:73
11417 #, no-wrap
11418 msgid "Commands"
11419 msgstr ""
11420
11421 #. type: Plain text
11422 #: build/C/man2/syslog.2:80
11423 msgid ""
11424 "The I<type> argument determines the action taken by this function.  The list "
11425 "below specifies the values for I<type>.  The symbolic names are defined in "
11426 "the kernel source, but are not exported to user space; you will either need "
11427 "to use the numbers, or define the names yourself."
11428 msgstr ""
11429
11430 #. type: TP
11431 #: build/C/man2/syslog.2:80
11432 #, no-wrap
11433 msgid "B<SYSLOG_ACTION_CLOSE> (0)"
11434 msgstr ""
11435
11436 #. type: Plain text
11437 #: build/C/man2/syslog.2:84
11438 msgid "Close the log.  Currently a NOP."
11439 msgstr ""
11440
11441 #. type: TP
11442 #: build/C/man2/syslog.2:84
11443 #, no-wrap
11444 msgid "B<SYSLOG_ACTION_OPEN> (1)"
11445 msgstr ""
11446
11447 #. type: Plain text
11448 #: build/C/man2/syslog.2:88
11449 msgid "Open the log.  Currently a NOP."
11450 msgstr ""
11451
11452 #. type: TP
11453 #: build/C/man2/syslog.2:88
11454 #, no-wrap
11455 msgid "B<SYSLOG_ACTION_READ> (2)"
11456 msgstr ""
11457
11458 #. type: Plain text
11459 #: build/C/man2/syslog.2:100
11460 msgid ""
11461 "Read from the log.  The call waits until the kernel log buffer is nonempty, "
11462 "and then reads at most I<len> bytes into the buffer pointed to by I<bufp>.  "
11463 "The call returns the number of bytes read.  Bytes read from the log "
11464 "disappear from the log buffer: the information can be read only once.  This "
11465 "is the function executed by the kernel when a user program reads "
11466 "I</proc/kmsg>."
11467 msgstr ""
11468
11469 #. type: TP
11470 #: build/C/man2/syslog.2:100
11471 #, no-wrap
11472 msgid "B<SYSLOG_ACTION_READ_ALL> (3)"
11473 msgstr ""
11474
11475 #. type: Plain text
11476 #: build/C/man2/syslog.2:110
11477 msgid ""
11478 "Read all messages remaining in the ring buffer, placing then in the buffer "
11479 "pointed to by I<bufp>.  The call reads the last I<len> bytes from the log "
11480 "buffer (nondestructively), but will not read more than was written into the "
11481 "buffer since the last \"clear ring buffer\" command (see command 5 below)).  "
11482 "The call returns the number of bytes read."
11483 msgstr ""
11484
11485 #. type: TP
11486 #: build/C/man2/syslog.2:110
11487 #, no-wrap
11488 msgid "B<SYSLOG_ACTION_READ_CLEAR> (4)"
11489 msgstr ""
11490
11491 #. type: Plain text
11492 #: build/C/man2/syslog.2:116
11493 msgid ""
11494 "Read and clear all messages remaining in the ring buffer.  The call does "
11495 "precisely the same as for a I<type> of 3, but also executes the \"clear ring "
11496 "buffer\" command."
11497 msgstr ""
11498
11499 #. type: TP
11500 #: build/C/man2/syslog.2:116
11501 #, no-wrap
11502 msgid "B<SYSLOG_ACTION_CLEAR> (5)"
11503 msgstr ""
11504
11505 #. type: Plain text
11506 #: build/C/man2/syslog.2:124
11507 msgid ""
11508 "The call executes just the \"clear ring buffer\" command.  The I<bufp> and "
11509 "I<len> arguments are ignored."
11510 msgstr ""
11511
11512 #. type: Plain text
11513 #: build/C/man2/syslog.2:135
11514 msgid ""
11515 "This command does not really clear the ring buffer.  Rather, it sets a "
11516 "kernel bookkeeping variable that determines the results returned by commands "
11517 "3 (B<SYSLOG_ACTION_READ_ALL>)  and 4 (B<SYSLOG_ACTION_READ_CLEAR>).  This "
11518 "command has no effect on commands 2 (B<SYSLOG_ACTION_READ>)  and 9 "
11519 "(B<SYSLOG_ACTION_SIZE_UNREAD>)."
11520 msgstr ""
11521
11522 #. type: TP
11523 #: build/C/man2/syslog.2:135
11524 #, no-wrap
11525 msgid "B<SYSLOG_ACTION_CONSOLE_OFF> (6)"
11526 msgstr ""
11527
11528 #. type: Plain text
11529 #: build/C/man2/syslog.2:145
11530 msgid ""
11531 "Disable printk to console.  The call sets the console log level to the "
11532 "minimum, so that no messages are printed to the console.  The I<bufp> and "
11533 "I<len> arguments are ignored."
11534 msgstr ""
11535
11536 #. type: TP
11537 #: build/C/man2/syslog.2:145
11538 #, no-wrap
11539 msgid "B<SYSLOG_ACTION_CONSOLE_ON> (7)"
11540 msgstr ""
11541
11542 #. type: Plain text
11543 #: build/C/man2/syslog.2:154
11544 msgid ""
11545 "The call sets the console log level to the default, so that messages are "
11546 "printed to the console.  The I<bufp> and I<len> arguments are ignored."
11547 msgstr ""
11548
11549 #. type: TP
11550 #: build/C/man2/syslog.2:154
11551 #, no-wrap
11552 msgid "B<SYSLOG_ACTION_CONSOLE_LEVEL> (8)"
11553 msgstr ""
11554
11555 #. type: Plain text
11556 #: build/C/man2/syslog.2:165
11557 msgid ""
11558 "The call sets the console log level to the value given in I<len>, which must "
11559 "be an integer between 1 and 8 (inclusive).  See the B<loglevel> section for "
11560 "details.  The I<bufp> argument is ignored."
11561 msgstr ""
11562
11563 #. type: TP
11564 #: build/C/man2/syslog.2:165
11565 #, no-wrap
11566 msgid "B<SYSLOG_ACTION_SIZE_UNREAD> (9) (since Linux 2.4.10)"
11567 msgstr ""
11568
11569 #. type: Plain text
11570 #: build/C/man2/syslog.2:176
11571 msgid ""
11572 "The call returns the number of bytes currently available to be read from the "
11573 "kernel log buffer via command 2 (B<SYSLOG_ACTION_READ>).  The I<bufp> and "
11574 "I<len> arguments are ignored."
11575 msgstr ""
11576
11577 #. type: TP
11578 #: build/C/man2/syslog.2:176
11579 #, no-wrap
11580 msgid "B<SYSLOG_ACTION_SIZE_BUFFER> (10) (since Linux 2.6.6)"
11581 msgstr ""
11582
11583 #. type: Plain text
11584 #: build/C/man2/syslog.2:184
11585 msgid ""
11586 "This command returns the total size of the kernel log buffer.  The I<bufp> "
11587 "and I<len> arguments are ignored."
11588 msgstr ""
11589
11590 #. type: Plain text
11591 #: build/C/man2/syslog.2:201
11592 msgid ""
11593 "All commands except 3 and 10 require privilege.  In Linux kernels before "
11594 "2.6.37, command types 3 and 10 are allowed to unprivileged processes; since "
11595 "Linux 2.6.37, these commands are allowed to unprivileged processes only if "
11596 "I</proc/sys/kernel/dmesg_restrict> has the value 0.  Before Linux 2.6.37, "
11597 "\"privileged\" means that the caller has the B<CAP_SYS_ADMIN> capability.  "
11598 "Since Linux 2.6.37, \"privileged\" means that the caller has either the "
11599 "B<CAP_SYS_ADMIN> capability (now deprecated for this purpose) or the (new)  "
11600 "B<CAP_SYSLOG> capability."
11601 msgstr ""
11602
11603 #. type: SS
11604 #: build/C/man2/syslog.2:201
11605 #, no-wrap
11606 msgid "The loglevel"
11607 msgstr ""
11608
11609 #. type: Plain text
11610 #: build/C/man2/syslog.2:223
11611 msgid ""
11612 "The kernel routine B<printk>()  will only print a message on the console, if "
11613 "it has a loglevel less than the value of the variable I<console_loglevel>.  "
11614 "This variable initially has the value B<DEFAULT_CONSOLE_LOGLEVEL> (7), but "
11615 "is set to 10 if the kernel command line contains the word \"debug\", and to "
11616 "15 in case of a kernel fault (the 10 and 15 are just silly, and equivalent "
11617 "to 8).  This variable is set (to a value in the range 1-8) by a B<syslog>()  "
11618 "call with a I<type> of 8.  Calls to B<syslog>()  with I<type> equal to 6 or "
11619 "7 set the variable to 1 (kernel panics only)  or 7 (all except debugging "
11620 "messages), respectively."
11621 msgstr ""
11622
11623 #. type: Plain text
11624 #: build/C/man2/syslog.2:233
11625 msgid ""
11626 "Every text line in a message has its own loglevel.  This level is "
11627 "I<DEFAULT_MESSAGE_LOGLEVEL - 1> (6) unless the line starts with E<lt>dE<gt> "
11628 "where I<d> is a digit in the range 1-7, in which case the level is I<d>.  "
11629 "The conventional meaning of the loglevel is defined in "
11630 "I<E<lt>linux/kernel.hE<gt>> as follows:"
11631 msgstr ""
11632
11633 #. type: Plain text
11634 #: build/C/man2/syslog.2:243
11635 #, no-wrap
11636 msgid ""
11637 "#define KERN_EMERG    \"E<lt>0E<gt>\"  /* system is unusable               "
11638 "*/\n"
11639 "#define KERN_ALERT    \"E<lt>1E<gt>\"  /* action must be taken immediately "
11640 "*/\n"
11641 "#define KERN_CRIT     \"E<lt>2E<gt>\"  /* critical conditions              "
11642 "*/\n"
11643 "#define KERN_ERR      \"E<lt>3E<gt>\"  /* error conditions                 "
11644 "*/\n"
11645 "#define KERN_WARNING  \"E<lt>4E<gt>\"  /* warning conditions               "
11646 "*/\n"
11647 "#define KERN_NOTICE   \"E<lt>5E<gt>\"  /* normal but significant condition "
11648 "*/\n"
11649 "#define KERN_INFO     \"E<lt>6E<gt>\"  /* informational                    "
11650 "*/\n"
11651 "#define KERN_DEBUG    \"E<lt>7E<gt>\"  /* debug-level messages             "
11652 "*/\n"
11653 msgstr ""
11654
11655 #. type: Plain text
11656 #: build/C/man2/syslog.2:257
11657 msgid ""
11658 "For I<type> equal to 2, 3, or 4, a successful call to B<syslog>()  returns "
11659 "the number of bytes read.  For I<type> 9, B<syslog>()  returns the number of "
11660 "bytes currently available to be read on the kernel log buffer.  For I<type> "
11661 "10, B<syslog>()  returns the total size of the kernel log buffer.  For other "
11662 "values of I<type>, 0 is returned on success."
11663 msgstr ""
11664
11665 #. type: Plain text
11666 #: build/C/man2/syslog.2:260
11667 msgid "In case of error, -1 is returned, and I<errno> is set to indicate the error."
11668 msgstr ""
11669
11670 #. type: Plain text
11671 #: build/C/man2/syslog.2:278
11672 msgid ""
11673 "Bad arguments (e.g., bad I<type>; or for I<type> 2, 3, or 4, I<buf> is NULL, "
11674 "or I<len> is less than zero; or for I<type> 8, the I<level> is outside the "
11675 "range 1 to 8)."
11676 msgstr ""
11677
11678 #. type: Plain text
11679 #: build/C/man2/syslog.2:285
11680 msgid ""
11681 "This B<syslog>()  system call is not available, because the kernel was "
11682 "compiled with the B<CONFIG_PRINTK> kernel-configuration option disabled."
11683 msgstr ""
11684
11685 #. type: Plain text
11686 #: build/C/man2/syslog.2:294
11687 msgid ""
11688 "An attempt was made to change console_loglevel or clear the kernel message "
11689 "ring buffer by a process without sufficient privilege (more precisely: "
11690 "without the B<CAP_SYS_ADMIN> or B<CAP_SYSLOG> capability)."
11691 msgstr ""
11692
11693 #. type: TP
11694 #: build/C/man2/syslog.2:294
11695 #, no-wrap
11696 msgid "B<ERESTARTSYS>"
11697 msgstr ""
11698
11699 #. type: Plain text
11700 #: build/C/man2/syslog.2:298
11701 msgid ""
11702 "System call was interrupted by a signal; nothing was read.  (This can be "
11703 "seen only during a trace.)"
11704 msgstr ""
11705
11706 #. type: Plain text
11707 #: build/C/man2/syslog.2:301
11708 msgid ""
11709 "This system call is Linux-specific and should not be used in programs "
11710 "intended to be portable."
11711 msgstr ""
11712
11713 #.  In libc4 and libc5 the number of this call was defined by
11714 #.  .BR SYS_klog .
11715 #.  In glibc 2.0 the syscall is baptized
11716 #.  .BR klogctl ().
11717 #. type: Plain text
11718 #: build/C/man2/syslog.2:309
11719 msgid ""
11720 "From the very start people noted that it is unfortunate that a system call "
11721 "and a library routine of the same name are entirely different animals."
11722 msgstr ""
11723
11724 #. type: Plain text
11725 #: build/C/man2/syslog.2:312
11726 msgid "B<syslog>(3), B<capabilities>(7)"
11727 msgstr ""
11728
11729 #. type: TH
11730 #: build/C/man3/syslog.3:36
11731 #, no-wrap
11732 msgid "2012-08-17"
11733 msgstr ""
11734
11735 #. type: Plain text
11736 #: build/C/man3/syslog.3:39
11737 msgid "closelog, openlog, syslog, vsyslog - send messages to the system logger"
11738 msgstr ""
11739
11740 #. type: Plain text
11741 #: build/C/man3/syslog.3:41
11742 msgid "B<#include E<lt>syslog.hE<gt>>"
11743 msgstr ""
11744
11745 #. type: Plain text
11746 #: build/C/man3/syslog.3:43
11747 msgid ""
11748 "B<void openlog(const char *>I<ident>B<, int >I<option>B<, int "
11749 ">I<facility>B<);>"
11750 msgstr ""
11751
11752 #. type: Plain text
11753 #: build/C/man3/syslog.3:45
11754 msgid "B<void syslog(int >I<priority>B<, const char *>I<format>B<, ...);>"
11755 msgstr ""
11756
11757 #. type: Plain text
11758 #: build/C/man3/syslog.3:47
11759 msgid "B<void closelog(void);>"
11760 msgstr ""
11761
11762 #. type: Plain text
11763 #: build/C/man3/syslog.3:51
11764 msgid ""
11765 "B<void vsyslog(int >I<priority>B<, const char *>I<format>B<, va_list "
11766 ">I<ap>B<);>"
11767 msgstr ""
11768
11769 #. type: Plain text
11770 #: build/C/man3/syslog.3:59
11771 msgid "B<vsyslog>(): _BSD_SOURCE"
11772 msgstr ""
11773
11774 #. type: Plain text
11775 #: build/C/man3/syslog.3:65
11776 msgid ""
11777 "B<closelog>()  closes the descriptor being used to write to the system "
11778 "logger.  The use of B<closelog>()  is optional."
11779 msgstr ""
11780
11781 #. type: Plain text
11782 #: build/C/man3/syslog.3:77
11783 msgid ""
11784 "B<openlog>()  opens a connection to the system logger for a program.  The "
11785 "string pointed to by I<ident> is prepended to every message, and is "
11786 "typically set to the program name.  If I<ident> is NULL, the program name is "
11787 "used.  (POSIX.1-2008 does not specify the behavior when I<ident> is NULL.)"
11788 msgstr ""
11789
11790 #. type: Plain text
11791 #: build/C/man3/syslog.3:101
11792 msgid ""
11793 "The I<option> argument specifies flags which control the operation of "
11794 "B<openlog>()  and subsequent calls to B<syslog>().  The I<facility> argument "
11795 "establishes a default to be used if none is specified in subsequent calls to "
11796 "B<syslog>().  Values for I<option> and I<facility> are given below.  The use "
11797 "of B<openlog>()  is optional; it will automatically be called by B<syslog>()  "
11798 "if necessary, in which case I<ident> will default to NULL."
11799 msgstr ""
11800
11801 #. type: Plain text
11802 #: build/C/man3/syslog.3:125
11803 msgid ""
11804 "B<syslog>()  generates a log message, which will be distributed by "
11805 "B<syslogd>(8).  The I<priority> argument is formed by ORing the I<facility> "
11806 "and the I<level> values (explained below).  The remaining arguments are a "
11807 "I<format>, as in B<printf>(3)  and any arguments required by the I<format>, "
11808 "except that the two character sequence B<%m> will be replaced by the error "
11809 "message string I<strerror>(I<errno>).  A trailing newline may be added if "
11810 "needed."
11811 msgstr ""
11812
11813 #. type: Plain text
11814 #: build/C/man3/syslog.3:134
11815 msgid ""
11816 "The function B<vsyslog>()  performs the same task as B<syslog>()  with the "
11817 "difference that it takes a set of arguments which have been obtained using "
11818 "the B<stdarg>(3)  variable argument list macros."
11819 msgstr ""
11820
11821 #. type: Plain text
11822 #: build/C/man3/syslog.3:137
11823 msgid ""
11824 "The subsections below list the parameters used to set the values of "
11825 "I<option>,I< facility>, and I<priority>."
11826 msgstr ""
11827
11828 #. type: SS
11829 #: build/C/man3/syslog.3:137
11830 #, no-wrap
11831 msgid "option"
11832 msgstr ""
11833
11834 #. type: Plain text
11835 #: build/C/man3/syslog.3:143
11836 msgid "The I<option> argument to B<openlog>()  is an OR of any of these:"
11837 msgstr ""
11838
11839 #. type: TP
11840 #: build/C/man3/syslog.3:143
11841 #, no-wrap
11842 msgid "B<LOG_CONS>"
11843 msgstr ""
11844
11845 #. type: Plain text
11846 #: build/C/man3/syslog.3:147
11847 msgid ""
11848 "Write directly to system console if there is an error while sending to "
11849 "system logger."
11850 msgstr ""
11851
11852 #. type: TP
11853 #: build/C/man3/syslog.3:147
11854 #, no-wrap
11855 msgid "B<LOG_NDELAY>"
11856 msgstr ""
11857
11858 #. type: Plain text
11859 #: build/C/man3/syslog.3:151
11860 msgid ""
11861 "Open the connection immediately (normally, the connection is opened when the "
11862 "first message is logged)."
11863 msgstr ""
11864
11865 #. type: TP
11866 #: build/C/man3/syslog.3:151
11867 #, no-wrap
11868 msgid "B<LOG_NOWAIT>"
11869 msgstr ""
11870
11871 #. type: Plain text
11872 #: build/C/man3/syslog.3:157
11873 msgid ""
11874 "Don't wait for child processes that may have been created while logging the "
11875 "message.  (The GNU C library does not create a child process, so this option "
11876 "has no effect on Linux.)"
11877 msgstr ""
11878
11879 #. type: TP
11880 #: build/C/man3/syslog.3:157
11881 #, no-wrap
11882 msgid "B<LOG_ODELAY>"
11883 msgstr ""
11884
11885 #. type: Plain text
11886 #: build/C/man3/syslog.3:165
11887 msgid ""
11888 "The converse of B<LOG_NDELAY>; opening of the connection is delayed until "
11889 "B<syslog>()  is called.  (This is the default, and need not be specified.)"
11890 msgstr ""
11891
11892 #. type: TP
11893 #: build/C/man3/syslog.3:165
11894 #, no-wrap
11895 msgid "B<LOG_PERROR>"
11896 msgstr ""
11897
11898 #. type: Plain text
11899 #: build/C/man3/syslog.3:169
11900 msgid "(Not in POSIX.1-2001 or POSIX.1-2008.)  Print to I<stderr> as well."
11901 msgstr ""
11902
11903 #. type: TP
11904 #: build/C/man3/syslog.3:169
11905 #, no-wrap
11906 msgid "B<LOG_PID>"
11907 msgstr ""
11908
11909 #. type: Plain text
11910 #: build/C/man3/syslog.3:172
11911 msgid "Include PID with each message."
11912 msgstr ""
11913
11914 #. type: SS
11915 #: build/C/man3/syslog.3:172
11916 #, no-wrap
11917 msgid "facility"
11918 msgstr ""
11919
11920 #. type: Plain text
11921 #: build/C/man3/syslog.3:178
11922 msgid ""
11923 "The I<facility> argument is used to specify what type of program is logging "
11924 "the message.  This lets the configuration file specify that messages from "
11925 "different facilities will be handled differently."
11926 msgstr ""
11927
11928 #. type: TP
11929 #: build/C/man3/syslog.3:178
11930 #, no-wrap
11931 msgid "B<LOG_AUTH>"
11932 msgstr ""
11933
11934 #. type: Plain text
11935 #: build/C/man3/syslog.3:181
11936 msgid "security/authorization messages"
11937 msgstr ""
11938
11939 #. type: TP
11940 #: build/C/man3/syslog.3:181
11941 #, no-wrap
11942 msgid "B<LOG_AUTHPRIV>"
11943 msgstr ""
11944
11945 #. type: Plain text
11946 #: build/C/man3/syslog.3:184
11947 msgid "security/authorization messages (private)"
11948 msgstr ""
11949
11950 #. type: TP
11951 #: build/C/man3/syslog.3:184
11952 #, no-wrap
11953 msgid "B<LOG_CRON>"
11954 msgstr ""
11955
11956 #. type: Plain text
11957 #: build/C/man3/syslog.3:188
11958 msgid "clock daemon (B<cron> and B<at>)"
11959 msgstr ""
11960
11961 #. type: TP
11962 #: build/C/man3/syslog.3:188
11963 #, no-wrap
11964 msgid "B<LOG_DAEMON>"
11965 msgstr ""
11966
11967 #. type: Plain text
11968 #: build/C/man3/syslog.3:191
11969 msgid "system daemons without separate facility value"
11970 msgstr ""
11971
11972 #. type: TP
11973 #: build/C/man3/syslog.3:191
11974 #, no-wrap
11975 msgid "B<LOG_FTP>"
11976 msgstr ""
11977
11978 #. type: Plain text
11979 #: build/C/man3/syslog.3:194
11980 msgid "ftp daemon"
11981 msgstr ""
11982
11983 #. type: TP
11984 #: build/C/man3/syslog.3:194
11985 #, no-wrap
11986 msgid "B<LOG_KERN>"
11987 msgstr ""
11988
11989 #.  LOG_KERN has the value 0; if used as a facility, zero translates to:
11990 #.  "use the default facility".
11991 #. type: Plain text
11992 #: build/C/man3/syslog.3:199
11993 msgid "kernel messages (these can't be generated from user processes)"
11994 msgstr ""
11995
11996 #. type: TP
11997 #: build/C/man3/syslog.3:199
11998 #, no-wrap
11999 msgid "B<LOG_LOCAL0> through B<LOG_LOCAL7>"
12000 msgstr ""
12001
12002 #. type: Plain text
12003 #: build/C/man3/syslog.3:202
12004 msgid "reserved for local use"
12005 msgstr ""
12006
12007 #. type: TP
12008 #: build/C/man3/syslog.3:202
12009 #, no-wrap
12010 msgid "B<LOG_LPR>"
12011 msgstr ""
12012
12013 #. type: Plain text
12014 #: build/C/man3/syslog.3:205
12015 msgid "line printer subsystem"
12016 msgstr ""
12017
12018 #. type: TP
12019 #: build/C/man3/syslog.3:205
12020 #, no-wrap
12021 msgid "B<LOG_MAIL>"
12022 msgstr ""
12023
12024 #. type: Plain text
12025 #: build/C/man3/syslog.3:208
12026 msgid "mail subsystem"
12027 msgstr ""
12028
12029 #. type: TP
12030 #: build/C/man3/syslog.3:208
12031 #, no-wrap
12032 msgid "B<LOG_NEWS>"
12033 msgstr ""
12034
12035 #. type: Plain text
12036 #: build/C/man3/syslog.3:211
12037 msgid "USENET news subsystem"
12038 msgstr ""
12039
12040 #. type: TP
12041 #: build/C/man3/syslog.3:211
12042 #, no-wrap
12043 msgid "B<LOG_SYSLOG>"
12044 msgstr ""
12045
12046 #. type: Plain text
12047 #: build/C/man3/syslog.3:215
12048 msgid "messages generated internally by B<syslogd>(8)"
12049 msgstr ""
12050
12051 #. type: TP
12052 #: build/C/man3/syslog.3:215
12053 #, no-wrap
12054 msgid "B<LOG_USER> (default)"
12055 msgstr ""
12056
12057 #. type: Plain text
12058 #: build/C/man3/syslog.3:218
12059 msgid "generic user-level messages"
12060 msgstr ""
12061
12062 #. type: TP
12063 #: build/C/man3/syslog.3:218
12064 #, no-wrap
12065 msgid "B<LOG_UUCP>"
12066 msgstr ""
12067
12068 #. type: Plain text
12069 #: build/C/man3/syslog.3:221
12070 msgid "UUCP subsystem"
12071 msgstr ""
12072
12073 #. type: SS
12074 #: build/C/man3/syslog.3:221
12075 #, no-wrap
12076 msgid "level"
12077 msgstr ""
12078
12079 #. type: Plain text
12080 #: build/C/man3/syslog.3:224
12081 msgid ""
12082 "This determines the importance of the message.  The levels are, in order of "
12083 "decreasing importance:"
12084 msgstr ""
12085
12086 #. type: TP
12087 #: build/C/man3/syslog.3:224
12088 #, no-wrap
12089 msgid "B<LOG_EMERG>"
12090 msgstr ""
12091
12092 #. type: Plain text
12093 #: build/C/man3/syslog.3:227
12094 msgid "system is unusable"
12095 msgstr ""
12096
12097 #. type: TP
12098 #: build/C/man3/syslog.3:227
12099 #, no-wrap
12100 msgid "B<LOG_ALERT>"
12101 msgstr ""
12102
12103 #. type: Plain text
12104 #: build/C/man3/syslog.3:230
12105 msgid "action must be taken immediately"
12106 msgstr ""
12107
12108 #. type: TP
12109 #: build/C/man3/syslog.3:230
12110 #, no-wrap
12111 msgid "B<LOG_CRIT>"
12112 msgstr ""
12113
12114 #. type: Plain text
12115 #: build/C/man3/syslog.3:233
12116 msgid "critical conditions"
12117 msgstr ""
12118
12119 #. type: TP
12120 #: build/C/man3/syslog.3:233
12121 #, no-wrap
12122 msgid "B<LOG_ERR>"
12123 msgstr ""
12124
12125 #. type: Plain text
12126 #: build/C/man3/syslog.3:236
12127 msgid "error conditions"
12128 msgstr ""
12129
12130 #. type: TP
12131 #: build/C/man3/syslog.3:236
12132 #, no-wrap
12133 msgid "B<LOG_WARNING>"
12134 msgstr ""
12135
12136 #. type: Plain text
12137 #: build/C/man3/syslog.3:239
12138 msgid "warning conditions"
12139 msgstr ""
12140
12141 #. type: TP
12142 #: build/C/man3/syslog.3:239
12143 #, no-wrap
12144 msgid "B<LOG_NOTICE>"
12145 msgstr ""
12146
12147 #. type: Plain text
12148 #: build/C/man3/syslog.3:242
12149 msgid "normal, but significant, condition"
12150 msgstr ""
12151
12152 #. type: TP
12153 #: build/C/man3/syslog.3:242
12154 #, no-wrap
12155 msgid "B<LOG_INFO>"
12156 msgstr ""
12157
12158 #. type: Plain text
12159 #: build/C/man3/syslog.3:245
12160 msgid "informational message"
12161 msgstr ""
12162
12163 #. type: TP
12164 #: build/C/man3/syslog.3:245
12165 #, no-wrap
12166 msgid "B<LOG_DEBUG>"
12167 msgstr ""
12168
12169 #. type: Plain text
12170 #: build/C/man3/syslog.3:248
12171 msgid "debug-level message"
12172 msgstr ""
12173
12174 #. type: Plain text
12175 #: build/C/man3/syslog.3:252
12176 msgid ""
12177 "The function B<setlogmask>(3)  can be used to restrict logging to specified "
12178 "levels only."
12179 msgstr ""
12180
12181 #.  .SH HISTORY
12182 #.  A
12183 #.  .BR syslog ()
12184 #.  function call appeared in 4.2BSD.
12185 #.  4.3BSD documents
12186 #.  .BR openlog (),
12187 #.  .BR syslog (),
12188 #.  .BR closelog (),
12189 #.  and
12190 #.  .BR setlogmask ().
12191 #.  4.3BSD-Reno also documents
12192 #.  .BR vsyslog ().
12193 #.  Of course early v* functions used the
12194 #.  .I <varargs.h>
12195 #.  mechanism, which is not compatible with
12196 #.  .IR <stdarg.h> .
12197 #. type: Plain text
12198 #: build/C/man3/syslog.3:296
12199 msgid ""
12200 "The functions B<openlog>(), B<closelog>(), and B<syslog>()  (but not "
12201 "B<vsyslog>())  are specified in SUSv2, POSIX.1-2001, and POSIX.1-2008.  "
12202 "POSIX.1-2001 specifies only the B<LOG_USER> and B<LOG_LOCAL*> values for "
12203 "I<facility>.  However, with the exception of B<LOG_AUTHPRIV> and B<LOG_FTP>, "
12204 "the other I<facility> values appear on most UNIX systems.  The B<LOG_PERROR> "
12205 "value for I<option> is not specified by POSIX.1-2001 or POSIX.1-2008, but is "
12206 "available in most versions of UNIX."
12207 msgstr ""
12208
12209 #. type: Plain text
12210 #: build/C/man3/syslog.3:308
12211 msgid ""
12212 "The argument I<ident> in the call of B<openlog>()  is probably stored "
12213 "as-is.  Thus, if the string it points to is changed, B<syslog>()  may start "
12214 "prepending the changed string, and if the string it points to ceases to "
12215 "exist, the results are undefined.  Most portable is to use a string "
12216 "constant."
12217 msgstr ""
12218
12219 #. type: Plain text
12220 #: build/C/man3/syslog.3:311
12221 msgid ""
12222 "Never pass a string with user-supplied data as a format, use the following "
12223 "instead:"
12224 msgstr ""
12225
12226 #. type: Plain text
12227 #: build/C/man3/syslog.3:314
12228 #, no-wrap
12229 msgid "    syslog(priority, \"%s\", string);\n"
12230 msgstr ""
12231
12232 #. type: Plain text
12233 #: build/C/man3/syslog.3:320
12234 msgid "B<logger>(1), B<setlogmask>(3), B<syslog.conf>(5), B<syslogd>(8)"
12235 msgstr ""
12236
12237 #. type: TH
12238 #: build/C/man4/ttyS.4:26
12239 #, no-wrap
12240 msgid "TTYS"
12241 msgstr ""
12242
12243 #. type: TH
12244 #: build/C/man4/ttyS.4:26
12245 #, no-wrap
12246 msgid "1992-12-19"
12247 msgstr ""
12248
12249 #. type: Plain text
12250 #: build/C/man4/ttyS.4:29
12251 msgid "ttyS - serial terminal lines"
12252 msgstr ""
12253
12254 #. type: Plain text
12255 #: build/C/man4/ttyS.4:32
12256 msgid "B<ttyS[0-3]> are character devices for the serial terminal lines."
12257 msgstr ""
12258
12259 #. type: Plain text
12260 #: build/C/man4/ttyS.4:37
12261 msgid "mknod -m 660 /dev/ttyS0 c 4 64 # base address 0x3f8"
12262 msgstr ""
12263
12264 #. type: Plain text
12265 #: build/C/man4/ttyS.4:39
12266 msgid "mknod -m 660 /dev/ttyS1 c 4 65 # base address 0x2f8"
12267 msgstr ""
12268
12269 #. type: Plain text
12270 #: build/C/man4/ttyS.4:41
12271 msgid "mknod -m 660 /dev/ttyS2 c 4 66 # base address 0x3e8"
12272 msgstr ""
12273
12274 #. type: Plain text
12275 #: build/C/man4/ttyS.4:43
12276 msgid "mknod -m 660 /dev/ttyS3 c 4 67 # base address 0x2e8"
12277 msgstr ""
12278
12279 #. type: Plain text
12280 #: build/C/man4/ttyS.4:45
12281 msgid "chown root:tty /dev/ttyS[0-3]"
12282 msgstr ""
12283
12284 #. type: Plain text
12285 #: build/C/man4/ttyS.4:48
12286 msgid "/dev/ttyS[0-3]"
12287 msgstr ""
12288
12289 #. type: Plain text
12290 #: build/C/man4/ttyS.4:55
12291 msgid ""
12292 "B<chown>(1), B<mknod>(1), B<tty>(4), B<agetty>(8), B<mingetty>(8), "
12293 "B<setserial>(8)"
12294 msgstr ""
12295
12296 #. type: TH
12297 #: build/C/man7/uri.7:48
12298 #, no-wrap
12299 msgid "URI"
12300 msgstr ""
12301
12302 #. type: TH
12303 #: build/C/man7/uri.7:48
12304 #, no-wrap
12305 msgid "2014-03-18"
12306 msgstr ""
12307
12308 #. type: Plain text
12309 #: build/C/man7/uri.7:51
12310 msgid "uri, url, urn - uniform resource identifier (URI), including a URL or URN"
12311 msgstr ""
12312
12313 #. type: Plain text
12314 #: build/C/man7/uri.7:55
12315 #, no-wrap
12316 msgid "URI = [ absoluteURI | relativeURI ] [ \"#\" fragment ]\n"
12317 msgstr ""
12318
12319 #. type: Plain text
12320 #: build/C/man7/uri.7:57
12321 #, no-wrap
12322 msgid "absoluteURI = scheme \":\" ( hierarchical_part | opaque_part )\n"
12323 msgstr ""
12324
12325 #. type: Plain text
12326 #: build/C/man7/uri.7:59
12327 #, no-wrap
12328 msgid "relativeURI = ( net_path | absolute_path | relative_path ) [ \"?\" query ]\n"
12329 msgstr ""
12330
12331 #. type: Plain text
12332 #: build/C/man7/uri.7:62
12333 #, no-wrap
12334 msgid ""
12335 "scheme = \"http\" | \"ftp\" | \"gopher\" | \"mailto\" | \"news\" | "
12336 "\"telnet\" |\n"
12337 "         \"file\" | \"man\" | \"info\" | \"whatis\" | \"ldap\" | \"wais\" | "
12338 "\\&...\n"
12339 msgstr ""
12340
12341 #. type: Plain text
12342 #: build/C/man7/uri.7:64
12343 #, no-wrap
12344 msgid "hierarchical_part = ( net_path | absolute_path ) [ \"?\" query ]\n"
12345 msgstr ""
12346
12347 #. type: Plain text
12348 #: build/C/man7/uri.7:66
12349 #, no-wrap
12350 msgid "net_path = \"//\" authority [ absolute_path ]\n"
12351 msgstr ""
12352
12353 #. type: Plain text
12354 #: build/C/man7/uri.7:68
12355 #, no-wrap
12356 msgid "absolute_path = \"/\"  path_segments\n"
12357 msgstr ""
12358
12359 #. type: Plain text
12360 #: build/C/man7/uri.7:70
12361 #, no-wrap
12362 msgid "relative_path = relative_segment [ absolute_path ]\n"
12363 msgstr ""
12364
12365 #. type: Plain text
12366 #: build/C/man7/uri.7:82
12367 msgid ""
12368 "A Uniform Resource Identifier (URI) is a short string of characters "
12369 "identifying an abstract or physical resource (for example, a web page).  A "
12370 "Uniform Resource Locator (URL) is a URI that identifies a resource through "
12371 "its primary access mechanism (e.g., its network \"location\"), rather than "
12372 "by name or some other attribute of that resource.  A Uniform Resource Name "
12373 "(URN) is a URI that must remain globally unique and persistent even when the "
12374 "resource ceases to exist or becomes unavailable."
12375 msgstr ""
12376
12377 #. type: Plain text
12378 #: build/C/man7/uri.7:89
12379 msgid ""
12380 "URIs are the standard way to name hypertext link destinations for tools such "
12381 "as web browsers.  The string \"http://www.kernelnotes.org\" is a URL (and "
12382 "thus it is also a URI).  Many people use the term URL loosely as a synonym "
12383 "for URI (though technically URLs are a subset of URIs)."
12384 msgstr ""
12385
12386 #. type: Plain text
12387 #: build/C/man7/uri.7:105
12388 msgid ""
12389 "URIs can be absolute or relative.  An absolute identifier refers to a "
12390 "resource independent of context, while a relative identifier refers to a "
12391 "resource by describing the difference from the current context.  Within a "
12392 "relative path reference, the complete path segments \".\" and \"..\" have "
12393 "special meanings: \"the current hierarchy level\" and \"the level above this "
12394 "hierarchy level\", respectively, just like they do in UNIX-like systems.  A "
12395 "path segment which contains a colon character can't be used as the first "
12396 "segment of a relative URI path (e.g., \"this:that\"), because it would be "
12397 "mistaken for a scheme name; precede such segments with ./ (e.g., "
12398 "\"./this:that\").  Note that descendants of MS-DOS (e.g., Microsoft Windows) "
12399 "replace devicename colons with the vertical bar (\"|\") in URIs, so \"C:\" "
12400 "becomes \"C|\"."
12401 msgstr ""
12402
12403 #. type: Plain text
12404 #: build/C/man7/uri.7:109
12405 msgid ""
12406 "A fragment identifier, if included, refers to a particular named portion "
12407 "(fragment) of a resource; text after a \\(aq#\\(aq identifies the fragment.  "
12408 "A URI beginning with \\(aq#\\(aq refers to that fragment in the current "
12409 "resource."
12410 msgstr ""
12411
12412 #. type: Plain text
12413 #: build/C/man7/uri.7:117
12414 msgid ""
12415 "There are many different URI schemes, each with specific additional rules "
12416 "and meanings, but they are intentionally made to be as similar as possible.  "
12417 "For example, many URL schemes permit the authority to be the following "
12418 "format, called here an I<ip_server> (square brackets show what's optional):"
12419 msgstr ""
12420
12421 #. type: Plain text
12422 #: build/C/man7/uri.7:119
12423 msgid "I<ip_server = >[I<user> [ : I<password> ] @ ] I<host> [ : I<port>]"
12424 msgstr ""
12425
12426 #. type: Plain text
12427 #: build/C/man7/uri.7:135
12428 msgid ""
12429 "This format allows you to optionally insert a username, a user plus "
12430 "password, and/or a port number.  The I<host> is the name of the host "
12431 "computer, either its name as determined by DNS or an IP address (numbers "
12432 "separated by periods).  Thus the URI "
12433 "E<lt>http://fred:fredpassword@xyz.com:8080/E<gt> logs into a web server on "
12434 "host xyz.com as fred (using fredpassword) using port 8080.  Avoid including "
12435 "a password in a URI if possible because of the many security risks of having "
12436 "a password written down.  If the URL supplies a username but no password, "
12437 "and the remote server requests a password, the program interpreting the URL "
12438 "should request one from the user."
12439 msgstr ""
12440
12441 #. type: Plain text
12442 #: build/C/man7/uri.7:140
12443 msgid ""
12444 "Here are some of the most common schemes in use on UNIX-like systems that "
12445 "are understood by many tools.  Note that many tools using URIs also have "
12446 "internal schemes or specialized schemes; see those tools' documentation for "
12447 "information on those schemes."
12448 msgstr ""
12449
12450 #. type: Plain text
12451 #: build/C/man7/uri.7:142
12452 msgid "B<http - Web (HTTP) server>"
12453 msgstr ""
12454
12455 #. type: Plain text
12456 #: build/C/man7/uri.7:144
12457 msgid "http://I<ip_server>/I<path>"
12458 msgstr ""
12459
12460 #. type: Plain text
12461 #: build/C/man7/uri.7:146
12462 msgid "http://I<ip_server>/I<path>?I<query>"
12463 msgstr ""
12464
12465 #. type: Plain text
12466 #: build/C/man7/uri.7:154
12467 msgid ""
12468 "This is a URL accessing a web (HTTP) server.  The default port is 80.  If "
12469 "the path refers to a directory, the web server will choose what to return; "
12470 "usually if there is a file named \"index.html\" or \"index.htm\" its content "
12471 "is returned, otherwise, a list of the files in the current directory (with "
12472 "appropriate links) is generated and returned.  An example is "
12473 "E<lt>http://lwn.netE<gt>."
12474 msgstr ""
12475
12476 #. type: Plain text
12477 #: build/C/man7/uri.7:177
12478 msgid ""
12479 "A query can be given in the archaic \"isindex\" format, consisting of a word "
12480 "or phrase and not including an equal sign (=).  A query can also be in the "
12481 "longer \"GET\" format, which has one or more query entries of the form "
12482 "I<key>=I<value> separated by the ampersand character (&).  Note that I<key> "
12483 "can be repeated more than once, though it's up to the web server and its "
12484 "application programs to determine if there's any meaning to that.  There is "
12485 "an unfortunate interaction with HTML/XML/SGML and the GET query format; when "
12486 "such URIs with more than one key are embedded in SGML/XML documents "
12487 "(including HTML), the ampersand (&) has to be rewritten as &amp;.  Note that "
12488 "not all queries use this format; larger forms may be too long to store as a "
12489 "URI, so they use a different interaction mechanism (called POST) which does "
12490 "not include the data in the URI.  See the Common Gateway Interface "
12491 "specification at E<.UR http://www.w3.org\\:/CGI> E<.UE> for more "
12492 "information."
12493 msgstr ""
12494
12495 #. type: Plain text
12496 #: build/C/man7/uri.7:179
12497 msgid "B<ftp - File Transfer Protocol (FTP)>"
12498 msgstr ""
12499
12500 #. type: Plain text
12501 #: build/C/man7/uri.7:181
12502 msgid "ftp://I<ip_server>/I<path>"
12503 msgstr ""
12504
12505 #. type: Plain text
12506 #: build/C/man7/uri.7:189
12507 msgid ""
12508 "This is a URL accessing a file through the file transfer protocol (FTP).  "
12509 "The default port (for control) is 21.  If no username is included, the "
12510 "username \"anonymous\" is supplied, and in that case many clients provide as "
12511 "the password the requestor's Internet email address.  An example is "
12512 "E<lt>ftp://ftp.is.co.za/rfc/rfc1808.txtE<gt>."
12513 msgstr ""
12514
12515 #. type: Plain text
12516 #: build/C/man7/uri.7:191
12517 msgid "B<gopher - Gopher server>"
12518 msgstr ""
12519
12520 #. type: Plain text
12521 #: build/C/man7/uri.7:193
12522 msgid "gopher://I<ip_server>/I<gophertype selector>"
12523 msgstr ""
12524
12525 #. type: Plain text
12526 #: build/C/man7/uri.7:195
12527 msgid "gopher://I<ip_server>/I<gophertype selector>%09I<search>"
12528 msgstr ""
12529
12530 #. type: Plain text
12531 #: build/C/man7/uri.7:197
12532 msgid "gopher://I<ip_server>/I<gophertype selector>%09I<search>%09I<gopher+_string>"
12533 msgstr ""
12534
12535 #. type: Plain text
12536 #: build/C/man7/uri.7:207
12537 msgid ""
12538 "The default gopher port is 70.  I<gophertype> is a single-character field to "
12539 "denote the Gopher type of the resource to which the URL refers.  The entire "
12540 "path may also be empty, in which case the delimiting \"/\" is also optional "
12541 "and the gophertype defaults to \"1\"."
12542 msgstr ""
12543
12544 #. type: Plain text
12545 #: build/C/man7/uri.7:214
12546 msgid ""
12547 "I<selector> is the Gopher selector string.  In the Gopher protocol, Gopher "
12548 "selector strings are a sequence of octets which may contain any octets "
12549 "except 09 hexadecimal (US-ASCII HT or tab), 0A hexadecimal (US-ASCII "
12550 "character LF), and 0D (US-ASCII character CR)."
12551 msgstr ""
12552
12553 #. type: Plain text
12554 #: build/C/man7/uri.7:216
12555 msgid "B<mailto - Email address>"
12556 msgstr ""
12557
12558 #. type: Plain text
12559 #: build/C/man7/uri.7:218
12560 msgid "mailto:I<email-address>"
12561 msgstr ""
12562
12563 #. type: Plain text
12564 #: build/C/man7/uri.7:226
12565 msgid ""
12566 "This is an email address, usually of the form I<name>@I<hostname>.  See "
12567 "B<mailaddr>(7)  for more information on the correct format of an email "
12568 "address.  Note that any % character must be rewritten as %25.  An example is "
12569 "E<lt>mailto:dwheeler@dwheeler.comE<gt>."
12570 msgstr ""
12571
12572 #. type: Plain text
12573 #: build/C/man7/uri.7:228
12574 msgid "B<news - Newsgroup or News message>"
12575 msgstr ""
12576
12577 #. type: Plain text
12578 #: build/C/man7/uri.7:230
12579 msgid "news:I<newsgroup-name>"
12580 msgstr ""
12581
12582 #. type: Plain text
12583 #: build/C/man7/uri.7:232
12584 msgid "news:I<message-id>"
12585 msgstr ""
12586
12587 #. type: Plain text
12588 #: build/C/man7/uri.7:240
12589 msgid ""
12590 "A I<newsgroup-name> is a period-delimited hierarchical name, such as "
12591 "\"comp.infosystems.www.misc\".  If E<lt>newsgroup-nameE<gt> is \"*\" (as in "
12592 "E<lt>news:*E<gt>), it is used to refer to \"all available news groups\".  An "
12593 "example is E<lt>news:comp.lang.adaE<gt>."
12594 msgstr ""
12595
12596 #. type: Plain text
12597 #: build/C/man7/uri.7:252
12598 msgid ""
12599 "A I<message-id> corresponds to the Message-ID of E<.UR "
12600 "http://www.ietf.org\\:/rfc\\:/rfc1036.txt> IETF RFC\\ 1036, E<.UE> without "
12601 "the enclosing \"E<lt>\" and \"E<gt>\"; it takes the form "
12602 "I<unique>@I<full_domain_name>.  A message identifier may be distinguished "
12603 "from a news group name by the presence of the \"@\" character."
12604 msgstr ""
12605
12606 #. type: Plain text
12607 #: build/C/man7/uri.7:254
12608 msgid "B<telnet - Telnet login>"
12609 msgstr ""
12610
12611 #. type: Plain text
12612 #: build/C/man7/uri.7:256
12613 msgid "telnet://I<ip_server>/"
12614 msgstr ""
12615
12616 #. type: Plain text
12617 #: build/C/man7/uri.7:262
12618 msgid ""
12619 "The Telnet URL scheme is used to designate interactive text services that "
12620 "may be accessed by the Telnet protocol.  The final \"/\" character may be "
12621 "omitted.  The default port is 23.  An example is "
12622 "E<lt>telnet://melvyl.ucop.edu/E<gt>."
12623 msgstr ""
12624
12625 #. type: Plain text
12626 #: build/C/man7/uri.7:264
12627 msgid "B<file - Normal file>"
12628 msgstr ""
12629
12630 #. type: Plain text
12631 #: build/C/man7/uri.7:266
12632 msgid "file://I<ip_server>/I<path_segments>"
12633 msgstr ""
12634
12635 #. type: Plain text
12636 #: build/C/man7/uri.7:268
12637 msgid "file:I<path_segments>"
12638 msgstr ""
12639
12640 #. type: Plain text
12641 #: build/C/man7/uri.7:285
12642 msgid ""
12643 "This represents a file or directory accessible locally.  As a special case, "
12644 "I<ip_server> can be the string \"localhost\" or the empty string; this is "
12645 "interpreted as \"the machine from which the URL is being interpreted\".  If "
12646 "the path is to a directory, the viewer should display the directory's "
12647 "contents with links to each containee; not all viewers currently do this.  "
12648 "KDE supports generated files through the URL E<lt>file:/cgi-binE<gt>.  If "
12649 "the given file isn't found, browser writers may want to try to expand the "
12650 "filename via filename globbing (see B<glob>(7)  and B<glob>(3))."
12651 msgstr ""
12652
12653 #. type: Plain text
12654 #: build/C/man7/uri.7:299
12655 msgid ""
12656 "The second format (e.g., E<lt>file:/etc/passwdE<gt>)  is a correct format "
12657 "for referring to a local file.  However, older standards did not permit this "
12658 "format, and some programs don't recognize this as a URI.  A more portable "
12659 "syntax is to use an empty string as the server name, for example, "
12660 "E<lt>file:///etc/passwdE<gt>; this form does the same thing and is easily "
12661 "recognized by pattern matchers and older programs as a URI.  Note that if "
12662 "you really mean to say \"start from the current location,\" don't specify "
12663 "the scheme at all; use a relative address like E<lt>../test.txtE<gt>, which "
12664 "has the side-effect of being scheme-independent.  An example of this scheme "
12665 "is E<lt>file:///etc/passwdE<gt>."
12666 msgstr ""
12667
12668 #. type: Plain text
12669 #: build/C/man7/uri.7:301
12670 msgid "B<man - Man page documentation>"
12671 msgstr ""
12672
12673 #. type: Plain text
12674 #: build/C/man7/uri.7:303
12675 msgid "man:I<command-name>"
12676 msgstr ""
12677
12678 #. type: Plain text
12679 #: build/C/man7/uri.7:305
12680 msgid "man:I<command-name>(I<section>)"
12681 msgstr ""
12682
12683 #. type: Plain text
12684 #: build/C/man7/uri.7:314
12685 msgid ""
12686 "This refers to local online manual (man) reference pages.  The command name "
12687 "can optionally be followed by a parenthesis and section number; see "
12688 "B<man>(7)  for more information on the meaning of the section numbers.  This "
12689 "URI scheme is unique to UNIX-like systems (such as Linux)  and is not "
12690 "currently registered by the IETF.  An example is E<lt>man:ls(1)E<gt>."
12691 msgstr ""
12692
12693 #. type: Plain text
12694 #: build/C/man7/uri.7:316
12695 msgid "B<info - Info page documentation>"
12696 msgstr ""
12697
12698 #. type: Plain text
12699 #: build/C/man7/uri.7:318
12700 msgid "info:I<virtual-filename>"
12701 msgstr ""
12702
12703 #. type: Plain text
12704 #: build/C/man7/uri.7:320
12705 msgid "info:I<virtual-filename>#I<nodename>"
12706 msgstr ""
12707
12708 #. type: Plain text
12709 #: build/C/man7/uri.7:322
12710 msgid "info:(I<virtual-filename>)"
12711 msgstr ""
12712
12713 #. type: Plain text
12714 #: build/C/man7/uri.7:324
12715 msgid "info:(I<virtual-filename>)I<nodename>"
12716 msgstr ""
12717
12718 #. type: Plain text
12719 #: build/C/man7/uri.7:343
12720 msgid ""
12721 "This scheme refers to online info reference pages (generated from texinfo "
12722 "files), a documentation format used by programs such as the GNU tools.  This "
12723 "URI scheme is unique to UNIX-like systems (such as Linux)  and is not "
12724 "currently registered by the IETF.  As of this writing, GNOME and KDE differ "
12725 "in their URI syntax and do not accept the other's syntax.  The first two "
12726 "formats are the GNOME format; in nodenames all spaces are written as "
12727 "underscores.  The second two formats are the KDE format; spaces in nodenames "
12728 "must be written as spaces, even though this is forbidden by the URI "
12729 "standards.  It's hoped that in the future most tools will understand all of "
12730 "these formats and will always accept underscores for spaces in nodenames.  "
12731 "In both GNOME and KDE, if the form without the nodename is used the nodename "
12732 "is assumed to be \"Top\".  Examples of the GNOME format are "
12733 "E<lt>info:gccE<gt> and E<lt>info:gcc#G++_and_GCCE<gt>.  Examples of the KDE "
12734 "format are E<lt>info:(gcc)E<gt> and E<lt>info:(gcc)G++ and GCCE<gt>."
12735 msgstr ""
12736
12737 #. type: Plain text
12738 #: build/C/man7/uri.7:345
12739 msgid "B<whatis - Documentation search>"
12740 msgstr ""
12741
12742 #. type: Plain text
12743 #: build/C/man7/uri.7:347
12744 msgid "whatis:I<string>"
12745 msgstr ""
12746
12747 #. type: Plain text
12748 #: build/C/man7/uri.7:355
12749 msgid ""
12750 "This scheme searches the database of short (one-line) descriptions of "
12751 "commands and returns a list of descriptions containing that string.  Only "
12752 "complete word matches are returned.  See B<whatis>(1).  This URI scheme is "
12753 "unique to UNIX-like systems (such as Linux)  and is not currently registered "
12754 "by the IETF."
12755 msgstr ""
12756
12757 #. type: Plain text
12758 #: build/C/man7/uri.7:357
12759 msgid "B<ghelp - GNOME help documentation>"
12760 msgstr ""
12761
12762 #. type: Plain text
12763 #: build/C/man7/uri.7:359
12764 msgid "ghelp:I<name-of-application>"
12765 msgstr ""
12766
12767 #. type: Plain text
12768 #: build/C/man7/uri.7:362
12769 msgid ""
12770 "This loads GNOME help for the given application.  Note that not much "
12771 "documentation currently exists in this format."
12772 msgstr ""
12773
12774 #. type: Plain text
12775 #: build/C/man7/uri.7:364
12776 msgid "B<ldap - Lightweight Directory Access Protocol>"
12777 msgstr ""
12778
12779 #. type: Plain text
12780 #: build/C/man7/uri.7:366
12781 msgid "ldap://I<hostport>"
12782 msgstr ""
12783
12784 #. type: Plain text
12785 #: build/C/man7/uri.7:368
12786 msgid "ldap://I<hostport>/"
12787 msgstr ""
12788
12789 #. type: Plain text
12790 #: build/C/man7/uri.7:370
12791 msgid "ldap://I<hostport>/I<dn>"
12792 msgstr ""
12793
12794 #. type: Plain text
12795 #: build/C/man7/uri.7:372
12796 msgid "ldap://I<hostport>/I<dn>?I<attributes>"
12797 msgstr ""
12798
12799 #. type: Plain text
12800 #: build/C/man7/uri.7:374
12801 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>"
12802 msgstr ""
12803
12804 #. type: Plain text
12805 #: build/C/man7/uri.7:376
12806 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>?I<filter>"
12807 msgstr ""
12808
12809 #. type: Plain text
12810 #: build/C/man7/uri.7:378
12811 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>?I<filter>?I<extensions>"
12812 msgstr ""
12813
12814 #. type: Plain text
12815 #: build/C/man7/uri.7:389
12816 msgid ""
12817 "This scheme supports queries to the Lightweight Directory Access Protocol "
12818 "(LDAP), a protocol for querying a set of servers for hierarchically "
12819 "organized information (such as people and computing resources).  See E<.UR "
12820 "http://www.ietf.org\\:/rfc\\:/rfc2255.txt> RFC\\ 2255 E<.UE> for more "
12821 "information on the LDAP URL scheme.  The components of this URL are:"
12822 msgstr ""
12823
12824 #. type: IP
12825 #: build/C/man7/uri.7:389
12826 #, no-wrap
12827 msgid "hostport"
12828 msgstr ""
12829
12830 #. type: Plain text
12831 #: build/C/man7/uri.7:394
12832 msgid ""
12833 "the LDAP server to query, written as a hostname optionally followed by a "
12834 "colon and the port number.  The default LDAP port is TCP port 389.  If "
12835 "empty, the client determines which the LDAP server to use."
12836 msgstr ""
12837
12838 #. type: IP
12839 #: build/C/man7/uri.7:394
12840 #, no-wrap
12841 msgid "dn"
12842 msgstr ""
12843
12844 #. type: Plain text
12845 #: build/C/man7/uri.7:401
12846 msgid ""
12847 "the LDAP Distinguished Name, which identifies the base object of the LDAP "
12848 "search (see E<.UR http://www.ietf.org\\:/rfc\\:/rfc2253.txt> RFC\\ 2253 "
12849 "E<.UE> section 3)."
12850 msgstr ""
12851
12852 #. type: IP
12853 #: build/C/man7/uri.7:401
12854 #, no-wrap
12855 msgid "attributes"
12856 msgstr ""
12857
12858 #. type: Plain text
12859 #: build/C/man7/uri.7:405
12860 msgid ""
12861 "a comma-separated list of attributes to be returned; see RFC\\ 2251 section "
12862 "4.1.5.  If omitted, all attributes should be returned."
12863 msgstr ""
12864
12865 #. type: IP
12866 #: build/C/man7/uri.7:405
12867 #, no-wrap
12868 msgid "scope"
12869 msgstr ""
12870
12871 #. type: Plain text
12872 #: build/C/man7/uri.7:410
12873 msgid ""
12874 "specifies the scope of the search, which can be one of \"base\" (for a base "
12875 "object search), \"one\" (for a one-level search), or \"sub\" (for a subtree "
12876 "search).  If scope is omitted, \"base\" is assumed."
12877 msgstr ""
12878
12879 #. type: IP
12880 #: build/C/man7/uri.7:410
12881 #, no-wrap
12882 msgid "filter"
12883 msgstr ""
12884
12885 #. type: Plain text
12886 #: build/C/man7/uri.7:419
12887 msgid ""
12888 "specifies the search filter (subset of entries to return).  If omitted, all "
12889 "entries should be returned.  See E<.UR "
12890 "http://www.ietf.org\\:/rfc\\:/rfc2254.txt> RFC\\ 2254 E<.UE> section 4."
12891 msgstr ""
12892
12893 #. type: IP
12894 #: build/C/man7/uri.7:419
12895 #, no-wrap
12896 msgid "extensions"
12897 msgstr ""
12898
12899 #. type: Plain text
12900 #: build/C/man7/uri.7:425
12901 msgid ""
12902 "a comma-separated list of type=value pairs, where the =value portion may be "
12903 "omitted for options not requiring it.  An extension prefixed with a "
12904 "\\(aq!\\(aq is critical (must be supported to be valid), otherwise it is "
12905 "noncritical (optional)."
12906 msgstr ""
12907
12908 #. type: Plain text
12909 #: build/C/man7/uri.7:429
12910 msgid ""
12911 "LDAP queries are easiest to explain by example.  Here's a query that asks "
12912 "ldap.itd.umich.edu for information about the University of Michigan in the "
12913 "U.S.:"
12914 msgstr ""
12915
12916 #. type: Plain text
12917 #: build/C/man7/uri.7:432
12918 #, no-wrap
12919 msgid "ldap://ldap.itd.umich.edu/o=University%20of%20Michigan,c=US\n"
12920 msgstr ""
12921
12922 #. type: Plain text
12923 #: build/C/man7/uri.7:435
12924 msgid "To just get its postal address attribute, request:"
12925 msgstr ""
12926
12927 #. type: Plain text
12928 #: build/C/man7/uri.7:438
12929 #, no-wrap
12930 msgid "ldap://ldap.itd.umich.edu/o=University%20of%20Michigan,c=US?postalAddress\n"
12931 msgstr ""
12932
12933 #. type: Plain text
12934 #: build/C/man7/uri.7:442
12935 msgid ""
12936 "To ask a host.com at port 6666 for information about the person with common "
12937 "name (cn) \"Babs Jensen\" at University of Michigan, request:"
12938 msgstr ""
12939
12940 #. type: Plain text
12941 #: build/C/man7/uri.7:445
12942 #, no-wrap
12943 msgid "ldap://host.com:6666/o=University%20of%20Michigan,c=US??sub?(cn=Babs%20Jensen)\n"
12944 msgstr ""
12945
12946 #. type: Plain text
12947 #: build/C/man7/uri.7:448
12948 msgid "B<wais - Wide Area Information Servers>"
12949 msgstr ""
12950
12951 #. type: Plain text
12952 #: build/C/man7/uri.7:450
12953 msgid "wais://I<hostport>/I<database>"
12954 msgstr ""
12955
12956 #. type: Plain text
12957 #: build/C/man7/uri.7:452
12958 msgid "wais://I<hostport>/I<database>?I<search>"
12959 msgstr ""
12960
12961 #. type: Plain text
12962 #: build/C/man7/uri.7:454
12963 msgid "wais://I<hostport>/I<database>/I<wtype>/I<wpath>"
12964 msgstr ""
12965
12966 #. type: Plain text
12967 #: build/C/man7/uri.7:463
12968 msgid ""
12969 "This scheme designates a WAIS database, search, or document (see E<.UR "
12970 "http://www.ietf.org\\:/rfc\\:/rfc1625.txt> IETF RFC\\ 1625 E<.UE> for more "
12971 "information on WAIS).  Hostport is the hostname, optionally followed by a "
12972 "colon and port number (the default port number is 210)."
12973 msgstr ""
12974
12975 #. type: Plain text
12976 #: build/C/man7/uri.7:473
12977 msgid ""
12978 "The first form designates a WAIS database for searching.  The second form "
12979 "designates a particular search of the WAIS database I<database>.  The third "
12980 "form designates a particular document within a WAIS database to be "
12981 "retrieved.  I<wtype> is the WAIS designation of the type of the object and "
12982 "I<wpath> is the WAIS document-id."
12983 msgstr ""
12984
12985 #. type: Plain text
12986 #: build/C/man7/uri.7:475
12987 msgid "B<other schemes>"
12988 msgstr ""
12989
12990 #. type: Plain text
12991 #: build/C/man7/uri.7:489
12992 msgid ""
12993 "There are many other URI schemes.  Most tools that accept URIs support a set "
12994 "of internal URIs (e.g., Mozilla has the about: scheme for internal "
12995 "information, and the GNOME help browser has the toc: scheme for various "
12996 "starting locations).  There are many schemes that have been defined but are "
12997 "not as widely used at the current time (e.g., prospero).  The nntp: scheme "
12998 "is deprecated in favor of the news: scheme.  URNs are to be supported by the "
12999 "urn: scheme, with a hierarchical name space (e.g., urn:ietf:... would "
13000 "identify IETF documents); at this time URNs are not widely implemented.  Not "
13001 "all tools support all schemes."
13002 msgstr ""
13003
13004 #. type: SS
13005 #: build/C/man7/uri.7:489
13006 #, no-wrap
13007 msgid "Character encoding"
13008 msgstr ""
13009
13010 #. type: Plain text
13011 #: build/C/man7/uri.7:493
13012 msgid ""
13013 "URIs use a limited number of characters so that they can be typed in and "
13014 "used in a variety of situations."
13015 msgstr ""
13016
13017 #. type: Plain text
13018 #: build/C/man7/uri.7:497
13019 msgid ""
13020 "The following characters are reserved, that is, they may appear in a URI but "
13021 "their use is limited to their reserved purpose (conflicting data must be "
13022 "escaped before forming the URI):"
13023 msgstr ""
13024
13025 #. type: Plain text
13026 #: build/C/man7/uri.7:499
13027 #, no-wrap
13028 msgid "   ; / ? : @ & = + $ ,\n"
13029 msgstr ""
13030
13031 #. type: Plain text
13032 #: build/C/man7/uri.7:505
13033 msgid ""
13034 "Unreserved characters may be included in a URI.  Unreserved characters "
13035 "include uppercase and lowercase English letters, decimal digits, and the "
13036 "following limited set of punctuation marks and symbols:"
13037 msgstr ""
13038
13039 #. type: Plain text
13040 #: build/C/man7/uri.7:507
13041 #, no-wrap
13042 msgid " - _ . ! ~ * ' ( )\n"
13043 msgstr ""
13044
13045 #. type: Plain text
13046 #: build/C/man7/uri.7:522
13047 msgid ""
13048 "All other characters must be escaped.  An escaped octet is encoded as a "
13049 "character triplet, consisting of the percent character \"%\" followed by the "
13050 "two hexadecimal digits representing the octet code (you can use uppercase or "
13051 "lowercase letters for the hexadecimal digits).  For example, a blank space "
13052 "must be escaped as \"%20\", a tab character as \"%09\", and the \"&\" as "
13053 "\"%26\".  Because the percent \"%\" character always has the reserved "
13054 "purpose of being the escape indicator, it must be escaped as \"%25\".  It is "
13055 "common practice to escape space characters as the plus symbol (+)  in query "
13056 "text; this practice isn't uniformly defined in the relevant RFCs (which "
13057 "recommend %20 instead) but any tool accepting URIs with query text should be "
13058 "prepared for them.  A URI is always shown in its \"escaped\" form."
13059 msgstr ""
13060
13061 #. type: Plain text
13062 #: build/C/man7/uri.7:528
13063 msgid ""
13064 "Unreserved characters can be escaped without changing the semantics of the "
13065 "URI, but this should not be done unless the URI is being used in a context "
13066 "that does not allow the unescaped character to appear.  For example, \"%7e\" "
13067 "is sometimes used instead of \"~\" in an HTTP URL path, but the two are "
13068 "equivalent for an HTTP URL."
13069 msgstr ""
13070
13071 #. type: Plain text
13072 #: build/C/man7/uri.7:532
13073 msgid ""
13074 "For URIs which must handle characters outside the US ASCII character set, "
13075 "the HTML 4.01 specification (section B.2) and IETF RFC\\ 2718 (section "
13076 "2.2.5) recommend the following approach:"
13077 msgstr ""
13078
13079 #. type: Plain text
13080 #: build/C/man7/uri.7:536
13081 msgid ""
13082 "translate the character sequences into UTF-8 (IETF RFC\\ 2279)\\(emsee "
13083 "B<utf-8>(7)\\(emand then"
13084 msgstr ""
13085
13086 #. type: Plain text
13087 #: build/C/man7/uri.7:539
13088 msgid ""
13089 "use the URI escaping mechanism, that is, use the %HH encoding for unsafe "
13090 "octets."
13091 msgstr ""
13092
13093 #. type: SS
13094 #: build/C/man7/uri.7:539
13095 #, no-wrap
13096 msgid "Writing a URI"
13097 msgstr ""
13098
13099 #. type: Plain text
13100 #: build/C/man7/uri.7:562
13101 msgid ""
13102 "When written, URIs should be placed inside double quotes (e.g., "
13103 "\"http://www.kernelnotes.org\"), enclosed in angle brackets (e.g., "
13104 "E<lt>http://lwn.netE<gt>), or placed on a line by themselves.  A warning for "
13105 "those who use double-quotes: B<never> move extraneous punctuation (such as "
13106 "the period ending a sentence or the comma in a list)  inside a URI, since "
13107 "this will change the value of the URI.  Instead, use angle brackets instead, "
13108 "or switch to a quoting system that never includes extraneous characters "
13109 "inside quotation marks.  This latter system, called the 'new' or 'logical' "
13110 "quoting system by \"Hart's Rules\" and the \"Oxford Dictionary for Writers "
13111 "and Editors\", is preferred practice in Great Britain and hackers worldwide "
13112 "(see the Jargon File's section on Hacker Writing Style, E<.UR "
13113 "http://www.fwi.uva.nl\\:/~mes\\:/jargon\\:/h\\:/HackerWritingStyle.html> "
13114 "E<.UE ,> for more information).  Older documents suggested inserting the "
13115 "prefix \"URL:\" just before the URI, but this form has never caught on."
13116 msgstr ""
13117
13118 #. type: Plain text
13119 #: build/C/man7/uri.7:584
13120 msgid ""
13121 "The URI syntax was designed to be unambiguous.  However, as URIs have become "
13122 "commonplace, traditional media (television, radio, newspapers, billboards, "
13123 "etc.) have increasingly used abbreviated URI references consisting of only "
13124 "the authority and path portions of the identified resource (e.g., "
13125 "E<lt>www.w3.org/AddressingE<gt>).  Such references are primarily intended "
13126 "for human interpretation rather than machine, with the assumption that "
13127 "context-based heuristics are sufficient to complete the URI (e.g., hostnames "
13128 "beginning with \"www\" are likely to have a URI prefix of \"http://\" and "
13129 "hostnames beginning with \"ftp\" likely to have a prefix of \"ftp://\").  "
13130 "Many client implementations heuristically resolve these references.  Such "
13131 "heuristics may change over time, particularly when new schemes are "
13132 "introduced.  Since an abbreviated URI has the same syntax as a relative URL "
13133 "path, abbreviated URI references cannot be used where relative URIs are "
13134 "permitted, and can be used only when there is no defined base (such as in "
13135 "dialog boxes).  Don't use abbreviated URIs as hypertext links inside a "
13136 "document; use the standard format as described here."
13137 msgstr ""
13138
13139 #. type: Plain text
13140 #: build/C/man7/uri.7:592
13141 msgid ""
13142 "E<.UR http://www.ietf.org\\:/rfc\\:/rfc2396.txt> (IETF RFC\\ 2396)  E<.UE ,> "
13143 "E<.UR http://www.w3.org\\:/TR\\:/REC-html40> (HTML 4.0)  E<.UE .>"
13144 msgstr ""
13145
13146 #. type: Plain text
13147 #: build/C/man7/uri.7:598
13148 msgid ""
13149 "Any tool accepting URIs (e.g., a web browser) on a Linux system should be "
13150 "able to handle (directly or indirectly) all of the schemes described here, "
13151 "including the man: and info: schemes.  Handling them by invoking some other "
13152 "program is fine and in fact encouraged."
13153 msgstr ""
13154
13155 #. type: Plain text
13156 #: build/C/man7/uri.7:600
13157 msgid "Technically the fragment isn't part of the URI."
13158 msgstr ""
13159
13160 #. type: Plain text
13161 #: build/C/man7/uri.7:609
13162 msgid ""
13163 "For information on how to embed URIs (including URLs) in a data format, see "
13164 "documentation on that format.  HTML uses the format E<lt>A "
13165 "HREF=\"I<uri>\"E<gt> I<text> E<lt>/AE<gt>.  Texinfo files use the format "
13166 "@uref{I<uri>}.  Man and mdoc have the recently added UR macro, or just "
13167 "include the URI in the text (viewers should be able to detect :// as part of "
13168 "a URI)."
13169 msgstr ""
13170
13171 #. type: Plain text
13172 #: build/C/man7/uri.7:630
13173 msgid ""
13174 "The GNOME and KDE desktop environments currently vary in the URIs they "
13175 "accept, in particular in their respective help browsers.  To list man pages, "
13176 "GNOME uses E<lt>toc:manE<gt> while KDE uses E<lt>man:(index)E<gt>, and to "
13177 "list info pages, GNOME uses E<lt>toc:infoE<gt> while KDE uses "
13178 "E<lt>info:(dir)E<gt> (the author of this man page prefers the KDE approach "
13179 "here, though a more regular format would be even better).  In general, KDE "
13180 "uses E<lt>file:/cgi-bin/E<gt> as a prefix to a set of generated files.  KDE "
13181 "prefers documentation in HTML, accessed via the "
13182 "E<lt>file:/cgi-bin/helpindexE<gt>.  GNOME prefers the ghelp scheme to store "
13183 "and find documentation.  Neither browser handles file: references to "
13184 "directories at the time of this writing, making it difficult to refer to an "
13185 "entire directory with a browsable URI.  As noted above, these environments "
13186 "differ in how they handle the info: scheme, probably the most important "
13187 "variation.  It is expected that GNOME and KDE will converge to common URI "
13188 "formats, and a future version of this man page will describe the converged "
13189 "result.  Efforts to aid this convergence are encouraged."
13190 msgstr ""
13191
13192 #. type: SS
13193 #: build/C/man7/uri.7:630
13194 #, no-wrap
13195 msgid "Security"
13196 msgstr ""
13197
13198 #. type: Plain text
13199 #: build/C/man7/uri.7:640
13200 msgid ""
13201 "A URI does not in itself pose a security threat.  There is no general "
13202 "guarantee that a URL, which at one time located a given resource, will "
13203 "continue to do so.  Nor is there any guarantee that a URL will not locate a "
13204 "different resource at some later point in time; such a guarantee can be "
13205 "obtained only from the person(s) controlling that namespace and the resource "
13206 "in question."
13207 msgstr ""
13208
13209 #. type: Plain text
13210 #: build/C/man7/uri.7:655
13211 msgid ""
13212 "It is sometimes possible to construct a URL such that an attempt to perform "
13213 "a seemingly harmless operation, such as the retrieval of an entity "
13214 "associated with the resource, will in fact cause a possibly damaging remote "
13215 "operation to occur.  The unsafe URL is typically constructed by specifying a "
13216 "port number other than that reserved for the network protocol in question.  "
13217 "The client unwittingly contacts a site that is in fact running a different "
13218 "protocol.  The content of the URL contains instructions that, when "
13219 "interpreted according to this other protocol, cause an unexpected "
13220 "operation.  An example has been the use of a gopher URL to cause an "
13221 "unintended or impersonating message to be sent via a SMTP server."
13222 msgstr ""
13223
13224 #. type: Plain text
13225 #: build/C/man7/uri.7:659
13226 msgid ""
13227 "Caution should be used when using any URL that specifies a port number other "
13228 "than the default for the protocol, especially when it is a number within the "
13229 "reserved space."
13230 msgstr ""
13231
13232 #. type: Plain text
13233 #: build/C/man7/uri.7:667
13234 msgid ""
13235 "Care should be taken when a URI contains escaped delimiters for a given "
13236 "protocol (for example, CR and LF characters for telnet protocols) that these "
13237 "are not unescaped before transmission.  This might violate the protocol, but "
13238 "avoids the potential for such characters to be used to simulate an extra "
13239 "operation or parameter in that protocol, which might lead to an unexpected "
13240 "and possibly harmful remote operation to be performed."
13241 msgstr ""
13242
13243 #. type: Plain text
13244 #: build/C/man7/uri.7:673
13245 msgid ""
13246 "It is clearly unwise to use a URI that contains a password which is intended "
13247 "to be secret.  In particular, the use of a password within the \"userinfo\" "
13248 "component of a URI is strongly recommended against except in those rare "
13249 "cases where the \"password\" parameter is intended to be public."
13250 msgstr ""
13251
13252 #. type: Plain text
13253 #: build/C/man7/uri.7:695
13254 msgid ""
13255 "Documentation may be placed in a variety of locations, so there currently "
13256 "isn't a good URI scheme for general online documentation in arbitrary "
13257 "formats.  References of the form E<lt>file:///usr/doc/ZZZE<gt> don't work "
13258 "because different distributions and local installation requirements may "
13259 "place the files in different directories (it may be in /usr/doc, or "
13260 "/usr/local/doc, or /usr/share, or somewhere else).  Also, the directory ZZZ "
13261 "usually changes when a version changes (though filename globbing could "
13262 "partially overcome this).  Finally, using the file: scheme doesn't easily "
13263 "support people who dynamically load documentation from the Internet (instead "
13264 "of loading the files onto a local filesystem).  A future URI scheme may be "
13265 "added (e.g., \"userdoc:\") to permit programs to include cross-references to "
13266 "more detailed documentation without having to know the exact location of "
13267 "that documentation.  Alternatively, a future version of the filesystem "
13268 "specification may specify file locations sufficiently so that the file: "
13269 "scheme will be able to locate documentation."
13270 msgstr ""
13271
13272 #. type: Plain text
13273 #: build/C/man7/uri.7:698
13274 msgid ""
13275 "Many programs and file formats don't include a way to incorporate or "
13276 "implement links using URIs."
13277 msgstr ""
13278
13279 #.  .SH AUTHOR
13280 #.  David A. Wheeler (dwheeler@dwheeler.com) wrote this man page.
13281 #. type: Plain text
13282 #: build/C/man7/uri.7:706
13283 msgid ""
13284 "Many programs can't handle all of these different URI formats; there should "
13285 "be a standard mechanism to load an arbitrary URI that automatically detects "
13286 "the users' environment (e.g., text or graphics, desktop environment, local "
13287 "user preferences, and currently executing tools) and invokes the right tool "
13288 "for any URI."
13289 msgstr ""
13290
13291 #. type: Plain text
13292 #: build/C/man7/uri.7:711
13293 msgid "B<lynx>(1), B<man2html>(1), B<mailaddr>(7), B<utf-8>(7)"
13294 msgstr ""
13295
13296 #. type: Plain text
13297 #: build/C/man7/uri.7:715
13298 msgid "E<.UR http://www.ietf.org\\:/rfc\\:/rfc2255.txt> IETF RFC\\ 2255 E<.UE>"
13299 msgstr ""
13300
13301 #. type: TH
13302 #: build/C/man4/vcs.4:29
13303 #, no-wrap
13304 msgid "VCS"
13305 msgstr ""
13306
13307 #. type: TH
13308 #: build/C/man4/vcs.4:29
13309 #, no-wrap
13310 msgid "2007-12-17"
13311 msgstr ""
13312
13313 #. type: Plain text
13314 #: build/C/man4/vcs.4:32
13315 msgid "vcs, vcsa - virtual console memory"
13316 msgstr ""
13317
13318 #. type: Plain text
13319 #: build/C/man4/vcs.4:38
13320 msgid ""
13321 "I</dev/vcs0> is a character device with major number 7 and minor number 0, "
13322 "usually of mode 0644 and owner root.tty.  It refers to the memory of the "
13323 "currently displayed virtual console terminal."
13324 msgstr ""
13325
13326 #. type: Plain text
13327 #: build/C/man4/vcs.4:58
13328 msgid ""
13329 "I</dev/vcs[1-63]> are character devices for virtual console terminals, they "
13330 "have major number 7 and minor number 1 to 63, usually mode 0644 and owner "
13331 "root.tty.  I</dev/vcsa[0-63]> are the same, but using I<unsigned short>s (in "
13332 "host byte order) that include attributes, and prefixed with four bytes "
13333 "giving the screen dimensions and cursor position: I<lines>, I<columns>, "
13334 "I<x>, I<y>.  (I<x> = I<y> = 0 at the top left corner of the screen.)"
13335 msgstr ""
13336
13337 #. type: Plain text
13338 #: build/C/man4/vcs.4:72
13339 msgid ""
13340 "When a 512-character font is loaded, the 9th bit position can be fetched by "
13341 "applying the B<ioctl>(2)  B<VT_GETHIFONTMASK> operation (available in Linux "
13342 "kernels 2.6.18 and above)  on I</dev/tty[1-63]>; the value is returned in "
13343 "the I<unsigned short> pointed to by the third B<ioctl>(2)  argument."
13344 msgstr ""
13345
13346 #. type: Plain text
13347 #: build/C/man4/vcs.4:79
13348 msgid ""
13349 "These devices replace the screendump B<ioctl>(2)  operations of "
13350 "B<console>(4), so the system administrator can control access using "
13351 "filesystem permissions."
13352 msgstr ""
13353
13354 #. type: Plain text
13355 #: build/C/man4/vcs.4:81
13356 msgid "The devices for the first eight virtual consoles may be created by:"
13357 msgstr ""
13358
13359 #. type: Plain text
13360 #: build/C/man4/vcs.4:88
13361 #, no-wrap
13362 msgid ""
13363 "    for x in 0 1 2 3 4 5 6 7 8; do\n"
13364 "        mknod -m 644 /dev/vcs$x c 7 $x;\n"
13365 "        mknod -m 644 /dev/vcsa$x c 7 $[$x+128];\n"
13366 "    done\n"
13367 "    chown root:tty /dev/vcs*\n"
13368 msgstr ""
13369
13370 #. type: Plain text
13371 #: build/C/man4/vcs.4:93
13372 msgid "No B<ioctl>(2)  requests are supported."
13373 msgstr ""
13374
13375 #. type: Plain text
13376 #: build/C/man4/vcs.4:95
13377 msgid "/dev/vcs[0-63]"
13378 msgstr ""
13379
13380 #.  .SH AUTHOR
13381 #.  Andries Brouwer <aeb@cwi.nl>
13382 #. type: Plain text
13383 #: build/C/man4/vcs.4:99
13384 msgid "/dev/vcsa[0-63]"
13385 msgstr ""
13386
13387 #. type: Plain text
13388 #: build/C/man4/vcs.4:101
13389 msgid "Introduced with version 1.1.92 of the Linux kernel."
13390 msgstr ""
13391
13392 #. type: Plain text
13393 #: build/C/man4/vcs.4:103
13394 msgid "You may do a screendump on vt3 by switching to vt1 and typing"
13395 msgstr ""
13396
13397 #. type: Plain text
13398 #: build/C/man4/vcs.4:105
13399 #, no-wrap
13400 msgid "    cat /dev/vcs3 E<gt>foo\n"
13401 msgstr ""
13402
13403 #. type: Plain text
13404 #: build/C/man4/vcs.4:109
13405 msgid ""
13406 "Note that the output does not contain newline characters, so some processing "
13407 "may be required, like in"
13408 msgstr ""
13409
13410 #. type: Plain text
13411 #: build/C/man4/vcs.4:111
13412 #, no-wrap
13413 msgid "    old -w 81 /dev/vcs3 | lpr\n"
13414 msgstr ""
13415
13416 #. type: Plain text
13417 #: build/C/man4/vcs.4:113
13418 msgid "or (horrors)"
13419 msgstr ""
13420
13421 #. type: Plain text
13422 #: build/C/man4/vcs.4:115
13423 #, no-wrap
13424 msgid "    xetterm -dump 3 -file /proc/self/fd/1\n"
13425 msgstr ""
13426
13427 #. type: Plain text
13428 #: build/C/man4/vcs.4:120
13429 msgid "The I</dev/vcsa0> device is used for Braille support."
13430 msgstr ""
13431
13432 #. type: Plain text
13433 #: build/C/man4/vcs.4:124
13434 msgid ""
13435 "This program displays the character and screen attributes under the cursor "
13436 "of the second virtual console, then changes the background color there:"
13437 msgstr ""
13438
13439 #. type: Plain text
13440 #: build/C/man4/vcs.4:132
13441 #, no-wrap
13442 msgid ""
13443 "#include E<lt>unistd.hE<gt>\n"
13444 "#include E<lt>stdlib.hE<gt>\n"
13445 "#include E<lt>stdio.hE<gt>\n"
13446 "#include E<lt>fcntl.hE<gt>\n"
13447 "#include E<lt>sys/ioctl.hE<gt>\n"
13448 "#include E<lt>linux/vt.hE<gt>\n"
13449 msgstr ""
13450
13451 #. type: Plain text
13452 #: build/C/man4/vcs.4:143
13453 #, no-wrap
13454 msgid ""
13455 "int\n"
13456 "main(void)\n"
13457 "{\n"
13458 "    int fd;\n"
13459 "    char *device = \"/dev/vcsa2\";\n"
13460 "    char *console = \"/dev/tty2\";\n"
13461 "    struct {unsigned char lines, cols, x, y;} scrn;\n"
13462 "    unsigned short s;\n"
13463 "    unsigned short mask;\n"
13464 "    unsigned char ch, attrib;\n"
13465 msgstr ""
13466
13467 #. type: Plain text
13468 #: build/C/man4/vcs.4:172
13469 #, no-wrap
13470 msgid ""
13471 "    fd = open(console, O_RDWR);\n"
13472 "    if (fd E<lt> 0) {\n"
13473 "        perror(console);\n"
13474 "        exit(EXIT_FAILURE);\n"
13475 "    }\n"
13476 "    if (ioctl(fd, VT_GETHIFONTMASK, &mask) E<lt> 0) {\n"
13477 "        perror(\"VT_GETHIFONTMASK\");\n"
13478 "        exit(EXIT_FAILURE);\n"
13479 "    }\n"
13480 "    (void) close(fd);\n"
13481 "    fd = open(device, O_RDWR);\n"
13482 "    if (fd E<lt> 0) {\n"
13483 "        perror(device);\n"
13484 "        exit(EXIT_FAILURE);\n"
13485 "    }\n"
13486 "    (void) read(fd, &scrn, 4);\n"
13487 "    (void) lseek(fd, 4 + 2*(scrn.y*scrn.cols + scrn.x), 0);\n"
13488 "    (void) read(fd, &s, 2);\n"
13489 "    ch = s & 0xff;\n"
13490 "    if (attrib & mask)\n"
13491 "        ch |= 0x100;\n"
13492 "    attrib = ((s & ~mask) E<gt>E<gt> 8);\n"
13493 "    printf(\"ch=\\(aq%c\\(aq attrib=0x%02x\\en\", ch, attrib);\n"
13494 "    attrib ^= 0x10;\n"
13495 "    (void) lseek(fd, -1, 1);\n"
13496 "    (void) write(fd, &attrib, 1);\n"
13497 "    exit(EXIT_SUCCESS);\n"
13498 "}\n"
13499 msgstr ""
13500
13501 #. type: Plain text
13502 #: build/C/man4/vcs.4:178
13503 msgid "B<console>(4), B<tty>(4), B<ttyS>(4), B<gpm>(8)"
13504 msgstr ""
13505
13506 #. type: TH
13507 #: build/C/man4/wavelan.4:15
13508 #, no-wrap
13509 msgid "WAVELAN"
13510 msgstr ""
13511
13512 #. type: TH
13513 #: build/C/man4/wavelan.4:15
13514 #, no-wrap
13515 msgid "2013-09-04"
13516 msgstr ""
13517
13518 #. type: Plain text
13519 #: build/C/man4/wavelan.4:18
13520 msgid "wavelan - AT&T GIS WaveLAN ISA device driver"
13521 msgstr ""
13522
13523 #. type: Plain text
13524 #: build/C/man4/wavelan.4:20
13525 msgid ""
13526 "B<insmod wavelan_cs.o [io=>I<B,B..>B<] [ irq=>I<I,I..>B<] "
13527 "[name=>I<N,N..>B<]>"
13528 msgstr ""
13529
13530 #. type: Plain text
13531 #: build/C/man4/wavelan.4:23
13532 msgid ""
13533 "I<This driver is obsolete:> it was removed from the kernel in version "
13534 "2.6.35."
13535 msgstr ""
13536
13537 #. type: Plain text
13538 #: build/C/man4/wavelan.4:39
13539 msgid ""
13540 "I<wavelan> is the low-level device driver for the NCR / AT&T / Lucent "
13541 "B<WaveLAN ISA> and Digital (DEC)  B<RoamAbout DS> wireless ethernet "
13542 "adapter.  This driver is available as a module or might be compiled in the "
13543 "kernel.  This driver supports multiple cards in both forms (up to 4) and "
13544 "allocates the next available ethernet device (eth0..eth#) for each card "
13545 "found, unless a device name is explicitly specified (see below).  This "
13546 "device name will be reported in the kernel log file with the MAC address, "
13547 "NWID and frequency used by the card."
13548 msgstr ""
13549
13550 #. type: Plain text
13551 #: build/C/man4/wavelan.4:46
13552 msgid ""
13553 "This section apply to the module form (parameters passed on the B<insmod>(8)  "
13554 "command line).  If the driver is included in the kernel, use the "
13555 "I<ether=IRQ,IO,NAME> syntax on the kernel command line."
13556 msgstr ""
13557
13558 #. type: TP
13559 #: build/C/man4/wavelan.4:46
13560 #, no-wrap
13561 msgid "B<io>"
13562 msgstr ""
13563
13564 #. type: Plain text
13565 #: build/C/man4/wavelan.4:53
13566 msgid ""
13567 "Specify the list of base address where to search for wavelan cards (setting "
13568 "by dip switch on the card).  If you don't specify any io address, the driver "
13569 "will scan 0x390 and 0x3E0 addresses, which might conflict with other "
13570 "hardware..."
13571 msgstr ""
13572
13573 #. type: TP
13574 #: build/C/man4/wavelan.4:53
13575 #, no-wrap
13576 msgid "B<irq>"
13577 msgstr ""
13578
13579 #. type: Plain text
13580 #: build/C/man4/wavelan.4:57
13581 msgid ""
13582 "Set the list of irq that each wavelan card should use (the value is saved in "
13583 "permanent storage for future use)."
13584 msgstr ""
13585
13586 #. type: TP
13587 #: build/C/man4/wavelan.4:57
13588 #, no-wrap
13589 msgid "B<name>"
13590 msgstr ""
13591
13592 #. type: Plain text
13593 #: build/C/man4/wavelan.4:62
13594 msgid ""
13595 "Set the list of name to be used for each wavelan cards device (name used by "
13596 "B<ifconfig>(8))."
13597 msgstr ""
13598
13599 #. type: SS
13600 #: build/C/man4/wavelan.4:62
13601 #, no-wrap
13602 msgid "Wireless extensions"
13603 msgstr ""
13604
13605 #. type: Plain text
13606 #: build/C/man4/wavelan.4:66
13607 msgid "Use B<iwconfig>(8)  to manipulate wireless extensions."
13608 msgstr ""
13609
13610 #. type: SS
13611 #: build/C/man4/wavelan.4:66
13612 #, no-wrap
13613 msgid "NWID (or domain)"
13614 msgstr ""
13615
13616 #. type: Plain text
13617 #: build/C/man4/wavelan.4:75
13618 msgid ""
13619 "Set the network ID [I<0> to I<FFFF>] or disable it [I<off>].  As the NWID is "
13620 "stored in the card Permanent Storage Area, it will be reuse at any further "
13621 "invocation of the driver."
13622 msgstr ""
13623
13624 #. type: SS
13625 #: build/C/man4/wavelan.4:75
13626 #, no-wrap
13627 msgid "Frequency & channels"
13628 msgstr ""
13629
13630 #. type: Plain text
13631 #: build/C/man4/wavelan.4:86
13632 msgid ""
13633 "For the 2.4GHz 2.00 Hardware, you are able to set the frequency by "
13634 "specifying one of the 10 defined channels (I<2.412,> I<2.422, 2.425, 2.4305, "
13635 "2.432, 2.442, 2.452, 2.460, 2.462> or I<2.484>)  or directly by its value.  "
13636 "The frequency is changed immediately and permanently.  Frequency "
13637 "availability depends on the regulations..."
13638 msgstr ""
13639
13640 #. type: SS
13641 #: build/C/man4/wavelan.4:86
13642 #, no-wrap
13643 msgid "Statistics spy"
13644 msgstr ""
13645
13646 #. type: Plain text
13647 #: build/C/man4/wavelan.4:90
13648 msgid ""
13649 "Set a list of MAC addresses in the driver (up to 8) and get the last quality "
13650 "of link for each of those (see B<iwspy>(8))."
13651 msgstr ""
13652
13653 #. type: SS
13654 #: build/C/man4/wavelan.4:90
13655 #, no-wrap
13656 msgid "/proc/net/wireless"
13657 msgstr ""
13658
13659 #. type: Plain text
13660 #: build/C/man4/wavelan.4:105
13661 msgid ""
13662 "I<status> is the status reported by the modem.  I<Link quality> reports the "
13663 "quality of the modulation on the air (direct sequence spread spectrum) [max "
13664 "= 16].  I<Level> and I<Noise> refer to the signal level and noise level [max "
13665 "= 64].  The I<crypt discarded packet> and I<misc discarded packet> counters "
13666 "are not implemented."
13667 msgstr ""
13668
13669 #. type: SS
13670 #: build/C/man4/wavelan.4:105
13671 #, no-wrap
13672 msgid "Private ioctl"
13673 msgstr ""
13674
13675 #. type: Plain text
13676 #: build/C/man4/wavelan.4:109
13677 msgid "You may use B<iwpriv>(8)  to manipulate private ioctls."
13678 msgstr ""
13679
13680 #. type: SS
13681 #: build/C/man4/wavelan.4:109
13682 #, no-wrap
13683 msgid "Quality and level threshold"
13684 msgstr ""
13685
13686 #. type: Plain text
13687 #: build/C/man4/wavelan.4:112
13688 msgid ""
13689 "Enable you the define the quality and level threshold used by the modem "
13690 "(packet below that level are discarded)."
13691 msgstr ""
13692
13693 #. type: SS
13694 #: build/C/man4/wavelan.4:112
13695 #, no-wrap
13696 msgid "Histogram"
13697 msgstr ""
13698
13699 #. type: Plain text
13700 #: build/C/man4/wavelan.4:119
13701 msgid ""
13702 "This functionality makes it possible to set a number of signal level "
13703 "intervals and to count the number of packets received in each of those "
13704 "defined intervals.  This distribution might be used to calculate the mean "
13705 "value and standard deviation of the signal level."
13706 msgstr ""
13707
13708 #. type: SS
13709 #: build/C/man4/wavelan.4:119
13710 #, no-wrap
13711 msgid "Specific notes"
13712 msgstr ""
13713
13714 #. type: Plain text
13715 #: build/C/man4/wavelan.4:125
13716 msgid ""
13717 "This driver will fail to detect some B<non-NCR/ATT&T/Lucent> Wavelan cards.  "
13718 "If this happens for you, you must look in the source code on how to add your "
13719 "card to the detection routine."
13720 msgstr ""
13721
13722 #.  .SH AUTHOR
13723 #.  Bruce Janson \(em bruce@cs.usyd.edu.au
13724 #.  .br
13725 #.  Jean Tourrilhes \(em jt@hplb.hpl.hp.com
13726 #.  .br
13727 #.  (and others; see source code for details)
13728 #
13729 #.  SEE ALSO part
13730 #. type: Plain text
13731 #: build/C/man4/wavelan.4:138
13732 msgid ""
13733 "Some of the mentioned features are optional.  You may enable to disable them "
13734 "by changing flags in the driver header and recompile."
13735 msgstr ""
13736
13737 #. type: Plain text
13738 #: build/C/man4/wavelan.4:145
13739 msgid ""
13740 "B<wavelan_cs>(4), B<ifconfig>(8), B<insmod>(8), B<iwconfig>(8), "
13741 "B<iwpriv>(8), B<iwspy>(8)"
13742 msgstr ""