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: 2013-07-15 16:09+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:14 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:27 build/C/man2/mknod.2:14 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:28 build/C/man2/mknod.2:15 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:30 build/C/man2/mknod.2:17 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:131 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:37 build/C/man2/mknod.2:39 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:194 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:587 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:243
 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 /proc file-system entry, which the \"block\" side of the driver creates "
 466 "as I</proc/driver/cciss/cciss*> at run time.  This is because at driver init "
 467 "time, the SCSI core may not yet be initialized (because the driver is a "
 468 "block driver) and attempting to register it with the SCSI core in such a "
 469 "case would cause a hang.  This is best done via an initialization script "
 470 "(typically in I</etc/init.d>, but could vary depending on distribution).  "
 471 "For example:"
 472 msgstr ""
 473
 474 #. type: Plain text
 475 #: build/C/man4/cciss.4:249
 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:253
 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:257
 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:257
 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:265
 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 /proc file system.  For example:"
 511 msgstr ""
 512
 513 #. type: Plain text
 514 #: build/C/man4/cciss.4:267
 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:269
 521 msgid "This causes the driver to:"
 522 msgstr ""
 523
 524 #. type: IP
 525 #: build/C/man4/cciss.4:270 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:273
 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:273 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:276
 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:283
 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:288
 560 msgid ""
 561 "Note that the naming convention of the /proc file-system entries contains a "
 562 "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:306
 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:306
 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:314
 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:314 build/C/man4/cciss.4:316 build/C/man4/cciss.4:318 build/C/man4/cciss.4:320 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:204 build/C/man5/core.5:208 build/C/man5/core.5:211 build/C/man5/core.5:215
 598 #, no-wrap
 599 msgid "*"
 600 msgstr ""
 601
 602 #. type: Plain text
 603 #: build/C/man4/cciss.4:316
 604 msgid "First, the device is told to abort the command."
 605 msgstr ""
 606
 607 #. type: Plain text
 608 #: build/C/man4/cciss.4:318
 609 msgid "If that doesn't work, the device is reset."
 610 msgstr ""
 611
 612 #. type: Plain text
 613 #: build/C/man4/cciss.4:320
 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:322
 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:340
 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:348
 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:348 build/C/man4/console.4:95 build/C/man4/console_codes.4:642 build/C/man4/console_ioctl.4:847 build/C/man5/core.5:409 build/C/man4/cpuid.4:89 build/C/man4/dsp56k.4:115 build/C/man4/fd.4:213 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:106 build/C/man2/mknod.2:209 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:611 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:135
 650 #, no-wrap
 651 msgid "SEE ALSO"
 652 msgstr ""
 653
 654 #. type: Plain text
 655 #: build/C/man4/cciss.4:353
 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:365
 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:365 build/C/man4/console.4:112 build/C/man4/console_codes.4:646 build/C/man4/console_ioctl.4:874 build/C/man5/core.5:420 build/C/man4/cpuid.4:96 build/C/man4/dsp56k.4:121 build/C/man4/fd.4:221 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:116 build/C/man2/mknod.2:223 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:615 build/C/man4/st.4:964 build/C/man3/stdarg.3:329 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:142
 673 #, no-wrap
 674 msgid "COLOPHON"
 675 msgstr ""
 676
 677 #. type: Plain text
 678 #: build/C/man4/cciss.4:372 build/C/man4/console.4:119 build/C/man4/console_codes.4:653 build/C/man4/console_ioctl.4:881 build/C/man5/core.5:427 build/C/man4/cpuid.4:103 build/C/man4/dsp56k.4:128 build/C/man4/fd.4:228 build/C/man7/fifo.7:81 build/C/man4/full.4:72 build/C/man3/gnu_get_libc_version.3:85 build/C/man4/hd.4:117 build/C/man4/hpsa.4:204 build/C/man4/initrd.4:491 build/C/man4/lp.4:148 build/C/man3/makedev.3:90 build/C/man4/mem.4:95 build/C/man3/mkfifo.3:123 build/C/man2/mknod.2:230 build/C/man4/mouse.4:194 build/C/man4/msr.4:66 build/C/man4/null.4:75 build/C/man7/pipe.7:251 build/C/man4/ram.4:54 build/C/man4/random.4:293 build/C/man4/sd.4:144 build/C/man3/setlogmask.3:89 build/C/man4/sk98lin.4:622 build/C/man4/st.4:971 build/C/man3/stdarg.3:336 build/C/man2/syslog.2:319 build/C/man3/syslog.3:327 build/C/man4/ttyS.4:62 build/C/man7/uri.7:722 build/C/man4/vcs.4:185 build/C/man4/wavelan.4:149
 679 msgid ""
 680 "This page is part of release 3.52 of the Linux I<man-pages> project.  A "
 681 "description of the project, and information about reporting bugs, can be "
 682 "found at \\%http://www.kernel.org/doc/man-pages/."
 683 msgstr ""
 684
 685 #. type: TH
 686 #: build/C/man4/console.4:12
 687 #, no-wrap
 688 msgid "CONSOLE"
 689 msgstr ""
 690
 691 #. type: TH
 692 #: build/C/man4/console.4:12
 693 #, no-wrap
 694 msgid "1994-10-31"
 695 msgstr ""
 696
 697 #. type: Plain text
 698 #: build/C/man4/console.4:15
 699 msgid "console - console terminal and virtual consoles"
 700 msgstr ""
 701
 702 #. type: Plain text
 703 #: build/C/man4/console.4:37
 704 msgid ""
 705 "A Linux system has up to 63 I<virtual consoles> (character devices with "
 706 "major number 4 and minor number 1 to 63), usually called I</dev/ttyn> with 1 "
 707 "\\(E<lt>= I<n> \\(E<lt>= 63.  The current console is also addressed by "
 708 "I</dev/console> or I</dev/tty0>, the character device with major number 4 "
 709 "and minor number 0.  The device files I</dev/*> are usually created using "
 710 "the script MAKEDEV, or using B<mknod>(1), usually with mode 0622 and owner "
 711 "I<root.tty>."
 712 msgstr ""
 713
 714 #. type: Plain text
 715 #: build/C/man4/console.4:45
 716 msgid ""
 717 "Before kernel version 1.1.54 the number of virtual consoles was compiled "
 718 "into the kernel (in I<tty.h>: #define NR_CONSOLES 8)  and could be changed "
 719 "by editing and recompiling.  Since version 1.1.54 virtual consoles are "
 720 "created on the fly, as soon as they are needed."
 721 msgstr ""
 722
 723 #. type: Plain text
 724 #: build/C/man4/console.4:63
 725 msgid ""
 726 "Common ways to start a process on a console are: (a) tell B<init>(8)  (in "
 727 "B<inittab>(5))  to start a B<mingetty>(8)  (or B<agetty>(8))  on the "
 728 "console; (b) ask B<openvt>(1)  to start a process on the console; (c) start "
 729 "X\\(emit will find the first unused console, and display its output there.  "
 730 "(There is also the ancient B<doshell>(8).)"
 731 msgstr ""
 732
 733 #. type: Plain text
 734 #: build/C/man4/console.4:76
 735 msgid ""
 736 "Common ways to switch consoles are: (a) use Alt+FI<n> or Ctrl+Alt+FI<n> to "
 737 "switch to console I<n>; AltGr+FI<n> might bring you to console I<n>+12 [here "
 738 "Alt and AltGr refer to the left and right Alt keys, respectively]; (b) use "
 739 "Alt+RightArrow or Alt+LeftArrow to cycle through the presently allocated "
 740 "consoles; (c) use the program B<chvt>(1).  (The key mapping is user "
 741 "settable, see B<loadkeys>(1); the above mentioned key combinations are "
 742 "according to the default settings.)"
 743 msgstr ""
 744
 745 #. type: Plain text
 746 #: build/C/man4/console.4:83
 747 msgid ""
 748 "The command B<deallocvt>(1)  (formerly B<disalloc>)  will free the memory "
 749 "taken by the screen buffers for consoles that no longer have any associated "
 750 "process."
 751 msgstr ""
 752
 753 #. type: SS
 754 #: build/C/man4/console.4:83
 755 #, no-wrap
 756 msgid "Properties"
 757 msgstr ""
 758
 759 #. type: Plain text
 760 #: build/C/man4/console.4:91
 761 msgid ""
 762 "Consoles carry a lot of state.  I hope to document that some other time.  "
 763 "The most important fact is that the consoles simulate vt100 terminals.  In "
 764 "particular, a console is reset to the initial state by printing the two "
 765 "characters ESC c.  All escape sequences can be found in B<console_codes>(4)."
 766 msgstr ""
 767
 768 #. type: Plain text
 769 #: build/C/man4/console.4:93
 770 msgid "I</dev/console>"
 771 msgstr ""
 772
 773 #. type: Plain text
 774 #: build/C/man4/console.4:95
 775 msgid "I</dev/tty*>"
 776 msgstr ""
 777
 778 #. type: Plain text
 779 #: build/C/man4/console.4:112
 780 msgid ""
 781 "B<chvt>(1), B<deallocvt>(1), B<loadkeys>(1), B<mknod>(1), B<openvt>(1), "
 782 "B<console_codes>(4), B<console_ioctl>(4), B<tty>(4), B<ttyS>(4), "
 783 "B<charsets>(7), B<agetty>(8), B<init>(8), B<mapscrn>(8), B<mingetty>(8), "
 784 "B<resizecons>(8), B<setfont>(8)"
 785 msgstr ""
 786
 787 #. type: TH
 788 #: build/C/man4/console_codes.4:23
 789 #, no-wrap
 790 msgid "CONSOLE_CODES"
 791 msgstr ""
 792
 793 #. type: Plain text
 794 #: build/C/man4/console_codes.4:26
 795 msgid "console_codes - Linux console escape and control sequences"
 796 msgstr ""
 797
 798 #. type: Plain text
 799 #: build/C/man4/console_codes.4:33
 800 msgid ""
 801 "The Linux console implements a large subset of the VT102 and ECMA-48/ISO "
 802 "6429/ANSI X3.64 terminal controls, plus certain private-mode sequences for "
 803 "changing the color palette, character-set mapping, and so on.  In the "
 804 "tabular descriptions below, the second column gives ECMA-48 or DEC mnemonics "
 805 "(the latter if prefixed with DEC) for the given function.  Sequences without "
 806 "a mnemonic are neither ECMA-48 nor VT102."
 807 msgstr ""
 808
 809 #. type: Plain text
 810 #: build/C/man4/console_codes.4:38
 811 msgid ""
 812 "After all the normal output processing has been done, and a stream of "
 813 "characters arrives at the console driver for actual printing, the first "
 814 "thing that happens is a translation from the code used for processing to the "
 815 "code used for printing."
 816 msgstr ""
 817
 818 #. type: Plain text
 819 #: build/C/man4/console_codes.4:44
 820 msgid ""
 821 "If the console is in UTF-8 mode, then the incoming bytes are first assembled "
 822 "into 16-bit Unicode codes.  Otherwise each byte is transformed according to "
 823 "the current mapping table (which translates it to a Unicode value).  See the "
 824 "B<Character Sets> section below for discussion."
 825 msgstr ""
 826
 827 #. type: Plain text
 828 #: build/C/man4/console_codes.4:50
 829 msgid ""
 830 "In the normal case, the Unicode value is converted to a font index, and this "
 831 "is stored in video memory, so that the corresponding glyph (as found in "
 832 "video ROM) appears on the screen.  Note that the use of Unicode (and the "
 833 "design of the PC hardware)  allows us to use 512 different glyphs "
 834 "simultaneously."
 835 msgstr ""
 836
 837 #. type: Plain text
 838 #: build/C/man4/console_codes.4:57
 839 msgid ""
 840 "If the current Unicode value is a control character, or we are currently "
 841 "processing an escape sequence, the value will treated specially.  Instead of "
 842 "being turned into a font index and rendered as a glyph, it may trigger "
 843 "cursor movement or other control functions.  See the B<Linux Console "
 844 "Controls> section below for discussion."
 845 msgstr ""
 846
 847 #. type: Plain text
 848 #: build/C/man4/console_codes.4:69
 849 msgid ""
 850 "It is generally not good practice to hard-wire terminal controls into "
 851 "programs.  Linux supports a B<terminfo>(5)  database of terminal "
 852 "capabilities.  Rather than emitting console escape sequences by hand, you "
 853 "will almost always want to use a terminfo-aware screen library or utility "
 854 "such as B<ncurses>(3), B<tput>(1), or B<reset>(1)."
 855 msgstr ""
 856
 857 #. type: SS
 858 #: build/C/man4/console_codes.4:69
 859 #, no-wrap
 860 msgid "Linux console controls"
 861 msgstr ""
 862
 863 #. type: Plain text
 864 #: build/C/man4/console_codes.4:73
 865 msgid ""
 866 "This section describes all the control characters and escape sequences that "
 867 "invoke special functions (i.e., anything other than writing a glyph at the "
 868 "current cursor location) on the Linux console."
 869 msgstr ""
 870
 871 #. type: Plain text
 872 #: build/C/man4/console_codes.4:75
 873 msgid "B<Control characters>"
 874 msgstr ""
 875
 876 #. type: Plain text
 877 #: build/C/man4/console_codes.4:86
 878 msgid ""
 879 "A character is a control character if (before transformation according to "
 880 "the mapping table) it has one of the 14 codes 00 (NUL), 07 (BEL), 08 (BS), "
 881 "09 (HT), 0a (LF), 0b (VT), 0c (FF), 0d (CR), 0e (SO), 0f (SI), 18 (CAN), 1a "
 882 "(SUB), 1b (ESC), 7f (DEL).  One can set a \"display control characters\" "
 883 "mode (see below), and allow 07, 09, 0b, 18, 1a, 7f to be displayed as "
 884 "glyphs.  On the other hand, in UTF-8 mode all codes 00-1f are regarded as "
 885 "control characters, regardless of any \"display control characters\" mode."
 886 msgstr ""
 887
 888 #. type: Plain text
 889 #: build/C/man4/console_codes.4:95
 890 msgid ""
 891 "If we have a control character, it is acted upon immediately and then "
 892 "discarded (even in the middle of an escape sequence)  and the escape "
 893 "sequence continues with the next character.  (However, ESC starts a new "
 894 "escape sequence, possibly aborting a previous unfinished one, and CAN and "
 895 "SUB abort any escape sequence.)  The recognized control characters are BEL, "
 896 "BS, HT, LF, VT, FF, CR, SO, SI, CAN, SUB, ESC, DEL, CSI.  They do what one "
 897 "would expect:"
 898 msgstr ""
 899
 900 #. type: Plain text
 901 #: build/C/man4/console_codes.4:97
 902 msgid "BEL (0x07, B<^G>) beeps;"
 903 msgstr ""
 904
 905 #. type: Plain text
 906 #: build/C/man4/console_codes.4:100
 907 msgid ""
 908 "BS (0x08, B<^H>) backspaces one column (but not past the beginning of the "
 909 "line);"
 910 msgstr ""
 911
 912 #. type: Plain text
 913 #: build/C/man4/console_codes.4:103
 914 msgid ""
 915 "HT (0x09, B<^I>) goes to the next tab stop or to the end of the line if "
 916 "there is no earlier tab stop;"
 917 msgstr ""
 918
 919 #. type: Plain text
 920 #: build/C/man4/console_codes.4:107
 921 msgid ""
 922 "LF (0x0A, B<^J>), VT (0x0B, B<^K>) and FF (0x0C, B<^L>) all give a linefeed, "
 923 "and if LF/NL (new-line mode) is set also a carriage return;"
 924 msgstr ""
 925
 926 #. type: Plain text
 927 #: build/C/man4/console_codes.4:109
 928 msgid "CR (0x0D, B<^M>) gives a carriage return;"
 929 msgstr ""
 930
 931 #. type: Plain text
 932 #: build/C/man4/console_codes.4:111
 933 msgid "SO (0x0E, B<^N>) activates the G1 character set;"
 934 msgstr ""
 935
 936 #. type: Plain text
 937 #: build/C/man4/console_codes.4:113
 938 msgid "SI (0x0F, B<^O>) activates the G0 character set;"
 939 msgstr ""
 940
 941 #. type: Plain text
 942 #: build/C/man4/console_codes.4:115
 943 msgid "CAN (0x18, B<^X>) and SUB (0x1A, B<^Z>) interrupt escape sequences;"
 944 msgstr ""
 945
 946 #. type: Plain text
 947 #: build/C/man4/console_codes.4:117
 948 msgid "ESC (0x1B, B<^[>) starts an escape sequence;"
 949 msgstr ""
 950
 951 #. type: Plain text
 952 #: build/C/man4/console_codes.4:119
 953 msgid "DEL (0x7F) is ignored;"
 954 msgstr ""
 955
 956 #. type: Plain text
 957 #: build/C/man4/console_codes.4:121
 958 msgid "CSI (0x9B) is equivalent to ESC [."
 959 msgstr ""
 960
 961 #. type: Plain text
 962 #: build/C/man4/console_codes.4:123
 963 msgid "B<ESC- but not CSI-sequences>"
 964 msgstr ""
 965
 966 #. type: tbl table
 967 #: build/C/man4/console_codes.4:125
 968 #, no-wrap
 969 msgid "ESC c\tRIS\tReset.\n"
 970 msgstr ""
 971
 972 #. type: tbl table
 973 #: build/C/man4/console_codes.4:126
 974 #, no-wrap
 975 msgid "ESC D\tIND\tLinefeed.\n"
 976 msgstr ""
 977
 978 #. type: tbl table
 979 #: build/C/man4/console_codes.4:127
 980 #, no-wrap
 981 msgid "ESC E\tNEL\tNewline.\n"
 982 msgstr ""
 983
 984 #. type: tbl table
 985 #: build/C/man4/console_codes.4:128
 986 #, no-wrap
 987 msgid "ESC H\tHTS\tSet tab stop at current column.\n"
 988 msgstr ""
 989
 990 #. type: tbl table
 991 #: build/C/man4/console_codes.4:129
 992 #, no-wrap
 993 msgid "ESC M\tRI\tReverse linefeed.\n"
 994 msgstr ""
 995
 996 #. type: tbl table
 997 #: build/C/man4/console_codes.4:130
 998 #, no-wrap
 999 msgid "ESC Z\tDECID\tT{\n"
1000 msgstr ""
1001
1002 #. type: tbl table
1003 #: build/C/man4/console_codes.4:131
1004 #, no-wrap
1005 msgid "DEC private identification. The kernel\n"
1006 msgstr ""
1007
1008 #. type: tbl table
1009 #: build/C/man4/console_codes.4:132
1010 #, no-wrap
1011 msgid "returns the string  ESC [ ? 6 c, claiming\n"
1012 msgstr ""
1013
1014 #. type: tbl table
1015 #: build/C/man4/console_codes.4:133
1016 #, no-wrap
1017 msgid "that it is a VT102.\n"
1018 msgstr ""
1019
1020 #. type: tbl table
1021 #: 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
1022 #, no-wrap
1023 msgid "T}\n"
1024 msgstr ""
1025
1026 #. type: tbl table
1027 #: build/C/man4/console_codes.4:135
1028 #, no-wrap
1029 msgid "ESC 7\tDECSC\tT{\n"
1030 msgstr ""
1031
1032 #. type: tbl table
1033 #: build/C/man4/console_codes.4:136
1034 #, no-wrap
1035 msgid "Save current state (cursor coordinates,\n"
1036 msgstr ""
1037
1038 #. type: tbl table
1039 #: build/C/man4/console_codes.4:137
1040 #, no-wrap
1041 msgid "attributes, character sets pointed at by G0, G1).\n"
1042 msgstr ""
1043
1044 #. type: tbl table
1045 #: build/C/man4/console_codes.4:139
1046 #, no-wrap
1047 msgid "ESC 8\tDECRC\tRestore state most recently saved by ESC 7.\n"
1048 msgstr ""
1049
1050 #. type: tbl table
1051 #: build/C/man4/console_codes.4:140
1052 #, no-wrap
1053 msgid "ESC [\tCSI\tControl sequence introducer\n"
1054 msgstr ""
1055
1056 #. type: tbl table
1057 #: build/C/man4/console_codes.4:141
1058 #, no-wrap
1059 msgid "ESC %\t\tStart sequence selecting character set\n"
1060 msgstr ""
1061
1062 #. type: tbl table
1063 #: build/C/man4/console_codes.4:142
1064 #, no-wrap
1065 msgid "ESC % @\t\t\\0\\0\\0Select default (ISO 646 / ISO 8859-1)\n"
1066 msgstr ""
1067
1068 #. type: tbl table
1069 #: build/C/man4/console_codes.4:143
1070 #, no-wrap
1071 msgid "ESC % G\t\t\\0\\0\\0Select UTF-8\n"
1072 msgstr ""
1073
1074 #. type: tbl table
1075 #: build/C/man4/console_codes.4:144
1076 #, no-wrap
1077 msgid "ESC % 8\t\t\\0\\0\\0Select UTF-8 (obsolete)\n"
1078 msgstr ""
1079
1080 #. type: tbl table
1081 #: build/C/man4/console_codes.4:145
1082 #, no-wrap
1083 msgid "ESC # 8\tDECALN\tDEC screen alignment test - fill screen with E's.\n"
1084 msgstr ""
1085
1086 #. type: tbl table
1087 #: build/C/man4/console_codes.4:146
1088 #, no-wrap
1089 msgid "ESC (\t\tStart sequence defining G0 character set\n"
1090 msgstr ""
1091
1092 #. type: tbl table
1093 #: build/C/man4/console_codes.4:147
1094 #, no-wrap
1095 msgid "ESC ( B\t\t\\0\\0\\0Select default (ISO 8859-1 mapping)\n"
1096 msgstr ""
1097
1098 #. type: tbl table
1099 #: build/C/man4/console_codes.4:148
1100 #, no-wrap
1101 msgid "ESC ( 0\t\t\\0\\0\\0Select VT100 graphics mapping\n"
1102 msgstr ""
1103
1104 #. type: tbl table
1105 #: build/C/man4/console_codes.4:149
1106 #, no-wrap
1107 msgid "ESC ( U\t\t\\0\\0\\0Select null mapping - straight to character ROM\n"
1108 msgstr ""
1109
1110 #. type: tbl table
1111 #: build/C/man4/console_codes.4:150
1112 #, no-wrap
1113 msgid "ESC ( K\t\t\\0\\0\\0Select user mapping - the map that is loaded by\n"
1114 msgstr ""
1115
1116 #. type: tbl table
1117 #: build/C/man4/console_codes.4:151
1118 #, no-wrap
1119 msgid "\t\t\\0\\0\\0the utility B<mapscrn>(8).\n"
1120 msgstr ""
1121
1122 #. type: tbl table
1123 #: build/C/man4/console_codes.4:152
1124 #, no-wrap
1125 msgid "ESC )\t\tStart sequence defining G1\n"
1126 msgstr ""
1127
1128 #. type: tbl table
1129 #: build/C/man4/console_codes.4:153
1130 #, no-wrap
1131 msgid "\t\t(followed by one of B, 0, U, K, as above).\n"
1132 msgstr ""
1133
1134 #. type: tbl table
1135 #: build/C/man4/console_codes.4:154
1136 #, no-wrap
1137 msgid "ESC E<gt>\tDECPNM\tSet numeric keypad mode\n"
1138 msgstr ""
1139
1140 #. type: tbl table
1141 #: build/C/man4/console_codes.4:155
1142 #, no-wrap
1143 msgid "ESC =\tDECPAM\tSet application keypad mode\n"
1144 msgstr ""
1145
1146 #. type: tbl table
1147 #: build/C/man4/console_codes.4:156
1148 #, no-wrap
1149 msgid "ESC ]\tOSC\tT{\n"
1150 msgstr ""
1151
1152 #. type: tbl table
1153 #: build/C/man4/console_codes.4:157
1154 #, no-wrap
1155 msgid "(Should be: Operating system command)\n"
1156 msgstr ""
1157
1158 #. type: tbl table
1159 #: build/C/man4/console_codes.4:158
1160 #, no-wrap
1161 msgid "ESC ] P I<nrrggbb>: set palette, with parameter\n"
1162 msgstr ""
1163
1164 #. type: tbl table
1165 #: build/C/man4/console_codes.4:159
1166 #, no-wrap
1167 msgid "given in 7 hexadecimal digits after the final P :-(.\n"
1168 msgstr ""
1169
1170 #. type: tbl table
1171 #: build/C/man4/console_codes.4:160
1172 #, no-wrap
1173 msgid "Here I<n> is the color (0-15), and I<rrggbb> indicates\n"
1174 msgstr ""
1175
1176 #. type: tbl table
1177 #: build/C/man4/console_codes.4:161
1178 #, no-wrap
1179 msgid "the red/green/blue values (0-255).\n"
1180 msgstr ""
1181
1182 #. type: tbl table
1183 #: build/C/man4/console_codes.4:162
1184 #, no-wrap
1185 msgid "ESC ] R: reset palette\n"
1186 msgstr ""
1187
1188 #. type: Plain text
1189 #: build/C/man4/console_codes.4:167
1190 msgid "B<ECMA-48 CSI sequences>"
1191 msgstr ""
1192
1193 #. type: Plain text
1194 #: build/C/man4/console_codes.4:173
1195 msgid ""
1196 "CSI (or ESC [) is followed by a sequence of parameters, at most NPAR (16), "
1197 "that are decimal numbers separated by semicolons.  An empty or absent "
1198 "parameter is taken to be 0.  The sequence of parameters may be preceded by a "
1199 "single question mark."
1200 msgstr ""
1201
1202 #. type: Plain text
1203 #: build/C/man4/console_codes.4:177
1204 msgid ""
1205 "However, after CSI [ (or ESC [ [) a single character is read and this entire "
1206 "sequence is ignored.  (The idea is to ignore an echoed function key.)"
1207 msgstr ""
1208
1209 #. type: Plain text
1210 #: build/C/man4/console_codes.4:179
1211 msgid "The action of a CSI sequence is determined by its final character."
1212 msgstr ""
1213
1214 #. type: tbl table
1215 #: build/C/man4/console_codes.4:181
1216 #, no-wrap
1217 msgid "@\tICH\tInsert the indicated # of blank characters.\n"
1218 msgstr ""
1219
1220 #. type: tbl table
1221 #: build/C/man4/console_codes.4:182
1222 #, no-wrap
1223 msgid "A\tCUU\tMove cursor up the indicated # of rows.\n"
1224 msgstr ""
1225
1226 #. type: tbl table
1227 #: build/C/man4/console_codes.4:183
1228 #, no-wrap
1229 msgid "B\tCUD\tMove cursor down the indicated # of rows.\n"
1230 msgstr ""
1231
1232 #. type: tbl table
1233 #: build/C/man4/console_codes.4:184
1234 #, no-wrap
1235 msgid "C\tCUF\tMove cursor right the indicated # of columns.\n"
1236 msgstr ""
1237
1238 #. type: tbl table
1239 #: build/C/man4/console_codes.4:185
1240 #, no-wrap
1241 msgid "D\tCUB\tMove cursor left the indicated # of columns.\n"
1242 msgstr ""
1243
1244 #. type: tbl table
1245 #: build/C/man4/console_codes.4:186
1246 #, no-wrap
1247 msgid "E\tCNL\tMove cursor down the indicated # of rows, to column 1.\n"
1248 msgstr ""
1249
1250 #. type: tbl table
1251 #: build/C/man4/console_codes.4:187
1252 #, no-wrap
1253 msgid "F\tCPL\tMove cursor up the indicated # of rows, to column 1.\n"
1254 msgstr ""
1255
1256 #. type: tbl table
1257 #: build/C/man4/console_codes.4:188
1258 #, no-wrap
1259 msgid "G\tCHA\tMove cursor to indicated column in current row.\n"
1260 msgstr ""
1261
1262 #. type: tbl table
1263 #: build/C/man4/console_codes.4:189
1264 #, no-wrap
1265 msgid "H\tCUP\tMove cursor to the indicated row, column (origin at 1,1).\n"
1266 msgstr ""
1267
1268 #. type: tbl table
1269 #: build/C/man4/console_codes.4:190
1270 #, no-wrap
1271 msgid "J\tED\tErase display (default: from cursor to end of display).\n"
1272 msgstr ""
1273
1274 #. type: tbl table
1275 #: build/C/man4/console_codes.4:191
1276 #, no-wrap
1277 msgid "\t\tESC [ 1 J: erase from start to cursor.\n"
1278 msgstr ""
1279
1280 #. type: tbl table
1281 #: build/C/man4/console_codes.4:192
1282 #, no-wrap
1283 msgid "\t\tESC [ 2 J: erase whole display.\n"
1284 msgstr ""
1285
1286 #. type: tbl table
1287 #: build/C/man4/console_codes.4:193
1288 #, no-wrap
1289 msgid "\t\tESC [ 3 J: erase whole display including scroll-back\n"
1290 msgstr ""
1291
1292 #. type: tbl table
1293 #: build/C/man4/console_codes.4:194
1294 #, no-wrap
1295 msgid "\t\t           buffer (since Linux 3.0).\n"
1296 msgstr ""
1297
1298 #.  ESC [ 3 J: commit f8df13e0a901fe55631fed66562369b4dba40f8b
1299 #. type: tbl table
1300 #: build/C/man4/console_codes.4:196
1301 #, no-wrap
1302 msgid "K\tEL\tErase line (default: from cursor to end of line).\n"
1303 msgstr ""
1304
1305 #. type: tbl table
1306 #: build/C/man4/console_codes.4:197
1307 #, no-wrap
1308 msgid "\t\tESC [ 1 K: erase from start of line to cursor.\n"
1309 msgstr ""
1310
1311 #. type: tbl table
1312 #: build/C/man4/console_codes.4:198
1313 #, no-wrap
1314 msgid "\t\tESC [ 2 K: erase whole line.\n"
1315 msgstr ""
1316
1317 #. type: tbl table
1318 #: build/C/man4/console_codes.4:199
1319 #, no-wrap
1320 msgid "L\tIL\tInsert the indicated # of blank lines.\n"
1321 msgstr ""
1322
1323 #. type: tbl table
1324 #: build/C/man4/console_codes.4:200
1325 #, no-wrap
1326 msgid "M\tDL\tDelete the indicated # of lines.\n"
1327 msgstr ""
1328
1329 #. type: tbl table
1330 #: build/C/man4/console_codes.4:201
1331 #, no-wrap
1332 msgid "P\tDCH\tDelete the indicated # of characters on current line.\n"
1333 msgstr ""
1334
1335 #. type: tbl table
1336 #: build/C/man4/console_codes.4:202
1337 #, no-wrap
1338 msgid "X\tECH\tErase the indicated # of characters on current line.\n"
1339 msgstr ""
1340
1341 #. type: tbl table
1342 #: build/C/man4/console_codes.4:203
1343 #, no-wrap
1344 msgid "a\tHPR\tMove cursor right the indicated # of columns.\n"
1345 msgstr ""
1346
1347 #. type: tbl table
1348 #: build/C/man4/console_codes.4:204
1349 #, no-wrap
1350 msgid "c\tDA\tAnswer ESC [ ? 6 c: \"I am a VT102\".\n"
1351 msgstr ""
1352
1353 #. type: tbl table
1354 #: build/C/man4/console_codes.4:205
1355 #, no-wrap
1356 msgid "d\tVPA\tMove cursor to the indicated row, current column.\n"
1357 msgstr ""
1358
1359 #. type: tbl table
1360 #: build/C/man4/console_codes.4:206
1361 #, no-wrap
1362 msgid "e\tVPR\tMove cursor down the indicated # of rows.\n"
1363 msgstr ""
1364
1365 #. type: tbl table
1366 #: build/C/man4/console_codes.4:207
1367 #, no-wrap
1368 msgid "f\tHVP\tMove cursor to the indicated row, column.\n"
1369 msgstr ""
1370
1371 #. type: tbl table
1372 #: build/C/man4/console_codes.4:208
1373 #, no-wrap
1374 msgid "g\tTBC\tWithout parameter: clear tab stop at current position.\n"
1375 msgstr ""
1376
1377 #. type: tbl table
1378 #: build/C/man4/console_codes.4:209
1379 #, no-wrap
1380 msgid "\t\tESC [ 3 g: delete all tab stops.\n"
1381 msgstr ""
1382
1383 #. type: tbl table
1384 #: build/C/man4/console_codes.4:210
1385 #, no-wrap
1386 msgid "h\tSM\tSet Mode (see below).\n"
1387 msgstr ""
1388
1389 #. type: tbl table
1390 #: build/C/man4/console_codes.4:211
1391 #, no-wrap
1392 msgid "l\tRM\tReset Mode (see below).\n"
1393 msgstr ""
1394
1395 #. type: tbl table
1396 #: build/C/man4/console_codes.4:212
1397 #, no-wrap
1398 msgid "m\tSGR\tSet attributes (see below).\n"
1399 msgstr ""
1400
1401 #. type: tbl table
1402 #: build/C/man4/console_codes.4:213
1403 #, no-wrap
1404 msgid "n\tDSR\tStatus report (see below).\n"
1405 msgstr ""
1406
1407 #. type: tbl table
1408 #: build/C/man4/console_codes.4:214
1409 #, no-wrap
1410 msgid "q\tDECLL\tSet keyboard LEDs.\n"
1411 msgstr ""
1412
1413 #. type: tbl table
1414 #: build/C/man4/console_codes.4:215
1415 #, no-wrap
1416 msgid "\t\tESC [ 0 q: clear all LEDs\n"
1417 msgstr ""
1418
1419 #. type: tbl table
1420 #: build/C/man4/console_codes.4:216
1421 #, no-wrap
1422 msgid "\t\tESC [ 1 q: set Scroll Lock LED\n"
1423 msgstr ""
1424
1425 #. type: tbl table
1426 #: build/C/man4/console_codes.4:217
1427 #, no-wrap
1428 msgid "\t\tESC [ 2 q: set Num Lock LED\n"
1429 msgstr ""
1430
1431 #. type: tbl table
1432 #: build/C/man4/console_codes.4:218
1433 #, no-wrap
1434 msgid "\t\tESC [ 3 q: set Caps Lock LED\n"
1435 msgstr ""
1436
1437 #. type: tbl table
1438 #: build/C/man4/console_codes.4:219
1439 #, no-wrap
1440 msgid "r\tDECSTBM\tSet scrolling region; parameters are top and bottom row.\n"
1441 msgstr ""
1442
1443 #. type: tbl table
1444 #: build/C/man4/console_codes.4:220
1445 #, no-wrap
1446 msgid "s\t?\tSave cursor location.\n"
1447 msgstr ""
1448
1449 #. type: tbl table
1450 #: build/C/man4/console_codes.4:221
1451 #, no-wrap
1452 msgid "u\t?\tRestore cursor location.\n"
1453 msgstr ""
1454
1455 #. type: tbl table
1456 #: build/C/man4/console_codes.4:222
1457 #, no-wrap
1458 msgid "\\`\tHPA\tMove cursor to indicated column in current row.\n"
1459 msgstr ""
1460
1461 #. type: Plain text
1462 #: build/C/man4/console_codes.4:226
1463 msgid "B<ECMA-48 Set Graphics Rendition>"
1464 msgstr ""
1465
1466 #. type: Plain text
1467 #: build/C/man4/console_codes.4:233
1468 msgid ""
1469 "The ECMA-48 SGR sequence ESC [ I<parameters> m sets display attributes.  "
1470 "Several attributes can be set in the same sequence, separated by "
1471 "semicolons.  An empty parameter (between semicolons or string initiator or "
1472 "terminator) is interpreted as a zero."
1473 msgstr ""
1474
1475 #. type: tbl table
1476 #: build/C/man4/console_codes.4:235
1477 #, no-wrap
1478 msgid "param\tresult\n"
1479 msgstr ""
1480
1481 #. type: tbl table
1482 #: build/C/man4/console_codes.4:236
1483 #, no-wrap
1484 msgid "0\treset all attributes to their defaults\n"
1485 msgstr ""
1486
1487 #. type: tbl table
1488 #: build/C/man4/console_codes.4:237
1489 #, no-wrap
1490 msgid "1\tset bold\n"
1491 msgstr ""
1492
1493 #. type: tbl table
1494 #: build/C/man4/console_codes.4:238
1495 #, no-wrap
1496 msgid "2\tset half-bright (simulated with color on a color display)\n"
1497 msgstr ""
1498
1499 #. type: tbl table
1500 #: build/C/man4/console_codes.4:239
1501 #, no-wrap
1502 msgid "4\tT{\n"
1503 msgstr ""
1504
1505 #. type: tbl table
1506 #: build/C/man4/console_codes.4:240
1507 #, no-wrap
1508 msgid "set underscore (simulated with color on a color display)\n"
1509 msgstr ""
1510
1511 #. type: tbl table
1512 #: build/C/man4/console_codes.4:241
1513 #, no-wrap
1514 msgid "(the colors used to simulate dim or underline are set\n"
1515 msgstr ""
1516
1517 #. type: tbl table
1518 #: build/C/man4/console_codes.4:242
1519 #, no-wrap
1520 msgid "using ESC ] ...)\n"
1521 msgstr ""
1522
1523 #. type: tbl table
1524 #: build/C/man4/console_codes.4:244
1525 #, no-wrap
1526 msgid "5\tset blink\n"
1527 msgstr ""
1528
1529 #. type: tbl table
1530 #: build/C/man4/console_codes.4:245
1531 #, no-wrap
1532 msgid "7\tset reverse video\n"
1533 msgstr ""
1534
1535 #. type: tbl table
1536 #: build/C/man4/console_codes.4:246
1537 #, no-wrap
1538 msgid "10\tT{\n"
1539 msgstr ""
1540
1541 #. type: tbl table
1542 #: build/C/man4/console_codes.4:247
1543 #, no-wrap
1544 msgid "reset selected mapping, display control flag,\n"
1545 msgstr ""
1546
1547 #. type: tbl table
1548 #: build/C/man4/console_codes.4:248
1549 #, no-wrap
1550 msgid "and toggle meta flag (ECMA-48 says \"primary font\").\n"
1551 msgstr ""
1552
1553 #. type: tbl table
1554 #: build/C/man4/console_codes.4:250
1555 #, no-wrap
1556 msgid "11\tT{\n"
1557 msgstr ""
1558
1559 #. type: tbl table
1560 #: build/C/man4/console_codes.4:251 build/C/man4/console_codes.4:255
1561 #, no-wrap
1562 msgid "select null mapping, set display control flag,\n"
1563 msgstr ""
1564
1565 #. type: tbl table
1566 #: build/C/man4/console_codes.4:252
1567 #, no-wrap
1568 msgid "reset toggle meta flag (ECMA-48 says \"first alternate font\").\n"
1569 msgstr ""
1570
1571 #. type: tbl table
1572 #: build/C/man4/console_codes.4:254
1573 #, no-wrap
1574 msgid "12\tT{\n"
1575 msgstr ""
1576
1577 #. type: tbl table
1578 #: build/C/man4/console_codes.4:256
1579 #, no-wrap
1580 msgid "set toggle meta flag (ECMA-48 says \"second alternate font\").\n"
1581 msgstr ""
1582
1583 #. type: tbl table
1584 #: build/C/man4/console_codes.4:257
1585 #, no-wrap
1586 msgid "The toggle meta flag\n"
1587 msgstr ""
1588
1589 #. type: tbl table
1590 #: build/C/man4/console_codes.4:258
1591 #, no-wrap
1592 msgid "causes the high bit of a byte to be toggled\n"
1593 msgstr ""
1594
1595 #. type: tbl table
1596 #: build/C/man4/console_codes.4:259
1597 #, no-wrap
1598 msgid "before the mapping table translation is done.\n"
1599 msgstr ""
1600
1601 #. type: tbl table
1602 #: build/C/man4/console_codes.4:261
1603 #, no-wrap
1604 msgid "21\tset normal intensity (ECMA-48 says \"doubly underlined\")\n"
1605 msgstr ""
1606
1607 #. type: tbl table
1608 #: build/C/man4/console_codes.4:262
1609 #, no-wrap
1610 msgid "22\tset normal intensity\n"
1611 msgstr ""
1612
1613 #. type: tbl table
1614 #: build/C/man4/console_codes.4:263
1615 #, no-wrap
1616 msgid "24\tunderline off\n"
1617 msgstr ""
1618
1619 #. type: tbl table
1620 #: build/C/man4/console_codes.4:264
1621 #, no-wrap
1622 msgid "25\tblink off\n"
1623 msgstr ""
1624
1625 #. type: tbl table
1626 #: build/C/man4/console_codes.4:265
1627 #, no-wrap
1628 msgid "27\treverse video off\n"
1629 msgstr ""
1630
1631 #. type: tbl table
1632 #: build/C/man4/console_codes.4:266
1633 #, no-wrap
1634 msgid "30\tset black foreground\n"
1635 msgstr ""
1636
1637 #. type: tbl table
1638 #: build/C/man4/console_codes.4:267
1639 #, no-wrap
1640 msgid "31\tset red foreground\n"
1641 msgstr ""
1642
1643 #. type: tbl table
1644 #: build/C/man4/console_codes.4:268
1645 #, no-wrap
1646 msgid "32\tset green foreground\n"
1647 msgstr ""
1648
1649 #. type: tbl table
1650 #: build/C/man4/console_codes.4:269
1651 #, no-wrap
1652 msgid "33\tset brown foreground\n"
1653 msgstr ""
1654
1655 #. type: tbl table
1656 #: build/C/man4/console_codes.4:270
1657 #, no-wrap
1658 msgid "34\tset blue foreground\n"
1659 msgstr ""
1660
1661 #. type: tbl table
1662 #: build/C/man4/console_codes.4:271
1663 #, no-wrap
1664 msgid "35\tset magenta foreground\n"
1665 msgstr ""
1666
1667 #. type: tbl table
1668 #: build/C/man4/console_codes.4:272
1669 #, no-wrap
1670 msgid "36\tset cyan foreground\n"
1671 msgstr ""
1672
1673 #. type: tbl table
1674 #: build/C/man4/console_codes.4:273
1675 #, no-wrap
1676 msgid "37\tset white foreground\n"
1677 msgstr ""
1678
1679 #. type: tbl table
1680 #: build/C/man4/console_codes.4:274
1681 #, no-wrap
1682 msgid "38\tset underscore on, set default foreground color\n"
1683 msgstr ""
1684
1685 #. type: tbl table
1686 #: build/C/man4/console_codes.4:275
1687 #, no-wrap
1688 msgid "39\tset underscore off, set default foreground color\n"
1689 msgstr ""
1690
1691 #. type: tbl table
1692 #: build/C/man4/console_codes.4:276
1693 #, no-wrap
1694 msgid "40\tset black background\n"
1695 msgstr ""
1696
1697 #. type: tbl table
1698 #: build/C/man4/console_codes.4:277
1699 #, no-wrap
1700 msgid "41\tset red background\n"
1701 msgstr ""
1702
1703 #. type: tbl table
1704 #: build/C/man4/console_codes.4:278
1705 #, no-wrap
1706 msgid "42\tset green background\n"
1707 msgstr ""
1708
1709 #. type: tbl table
1710 #: build/C/man4/console_codes.4:279
1711 #, no-wrap
1712 msgid "43\tset brown background\n"
1713 msgstr ""
1714
1715 #. type: tbl table
1716 #: build/C/man4/console_codes.4:280
1717 #, no-wrap
1718 msgid "44\tset blue background\n"
1719 msgstr ""
1720
1721 #. type: tbl table
1722 #: build/C/man4/console_codes.4:281
1723 #, no-wrap
1724 msgid "45\tset magenta background\n"
1725 msgstr ""
1726
1727 #. type: tbl table
1728 #: build/C/man4/console_codes.4:282
1729 #, no-wrap
1730 msgid "46\tset cyan background\n"
1731 msgstr ""
1732
1733 #. type: tbl table
1734 #: build/C/man4/console_codes.4:283
1735 #, no-wrap
1736 msgid "47\tset white background\n"
1737 msgstr ""
1738
1739 #. type: tbl table
1740 #: build/C/man4/console_codes.4:284
1741 #, no-wrap
1742 msgid "49\tset default background color\n"
1743 msgstr ""
1744
1745 #. type: Plain text
1746 #: build/C/man4/console_codes.4:288
1747 msgid "B<ECMA-48 Mode Switches>"
1748 msgstr ""
1749
1750 #. type: TP
1751 #: build/C/man4/console_codes.4:288
1752 #, no-wrap
1753 msgid "ESC [ 3 h"
1754 msgstr ""
1755
1756 #. type: Plain text
1757 #: build/C/man4/console_codes.4:291
1758 msgid "DECCRM (default off): Display control chars."
1759 msgstr ""
1760
1761 #. type: TP
1762 #: build/C/man4/console_codes.4:291
1763 #, no-wrap
1764 msgid "ESC [ 4 h"
1765 msgstr ""
1766
1767 #. type: Plain text
1768 #: build/C/man4/console_codes.4:294
1769 msgid "DECIM (default off): Set insert mode."
1770 msgstr ""
1771
1772 #. type: TP
1773 #: build/C/man4/console_codes.4:294
1774 #, no-wrap
1775 msgid "ESC [ 20 h"
1776 msgstr ""
1777
1778 #. type: Plain text
1779 #: build/C/man4/console_codes.4:298
1780 msgid "LF/NL (default off): Automatically follow echo of LF, VT or FF with CR."
1781 msgstr ""
1782
1783 #. type: Plain text
1784 #: build/C/man4/console_codes.4:301
1785 msgid "B<ECMA-48 Status Report Commands>"
1786 msgstr ""
1787
1788 #. type: TP
1789 #: build/C/man4/console_codes.4:301
1790 #, no-wrap
1791 msgid "ESC [ 5 n"
1792 msgstr ""
1793
1794 #. type: Plain text
1795 #: build/C/man4/console_codes.4:304
1796 msgid "Device status report (DSR): Answer is ESC [ 0 n (Terminal OK)."
1797 msgstr ""
1798
1799 #. type: TP
1800 #: build/C/man4/console_codes.4:304
1801 #, no-wrap
1802 msgid "ESC [ 6 n"
1803 msgstr ""
1804
1805 #. type: Plain text
1806 #: build/C/man4/console_codes.4:309
1807 msgid ""
1808 "Cursor position report (CPR): Answer is ESC [ I<y> ; I<x> R, where I<x,y> is "
1809 "the cursor location."
1810 msgstr ""
1811
1812 #. type: Plain text
1813 #: build/C/man4/console_codes.4:311
1814 msgid "B<DEC Private Mode (DECSET/DECRST) sequences>"
1815 msgstr ""
1816
1817 #. type: Plain text
1818 #: build/C/man4/console_codes.4:317
1819 msgid ""
1820 "These are not described in ECMA-48.  We list the Set Mode sequences; the "
1821 "Reset Mode sequences are obtained by replacing the final \\(aqh\\(aq by "
1822 "\\(aql\\(aq."
1823 msgstr ""
1824
1825 #. type: TP
1826 #: build/C/man4/console_codes.4:317
1827 #, no-wrap
1828 msgid "ESC [ ? 1 h"
1829 msgstr ""
1830
1831 #. type: Plain text
1832 #: build/C/man4/console_codes.4:321
1833 msgid ""
1834 "DECCKM (default off): When set, the cursor keys send an ESC O prefix, rather "
1835 "than ESC [."
1836 msgstr ""
1837
1838 #. type: TP
1839 #: build/C/man4/console_codes.4:321
1840 #, no-wrap
1841 msgid "ESC [ ? 3 h"
1842 msgstr ""
1843
1844 #. type: Plain text
1845 #: build/C/man4/console_codes.4:328
1846 msgid ""
1847 "DECCOLM (default off = 80 columns): 80/132 col mode switch.  The driver "
1848 "sources note that this alone does not suffice; some user-mode utility such "
1849 "as B<resizecons>(8)  has to change the hardware registers on the console "
1850 "video card."
1851 msgstr ""
1852
1853 #. type: TP
1854 #: build/C/man4/console_codes.4:328
1855 #, no-wrap
1856 msgid "ESC [ ? 5 h"
1857 msgstr ""
1858
1859 #. type: Plain text
1860 #: build/C/man4/console_codes.4:331
1861 msgid "DECSCNM (default off): Set reverse-video mode."
1862 msgstr ""
1863
1864 #. type: TP
1865 #: build/C/man4/console_codes.4:331
1866 #, no-wrap
1867 msgid "ESC [ ? 6 h"
1868 msgstr ""
1869
1870 #. type: Plain text
1871 #: build/C/man4/console_codes.4:335
1872 msgid ""
1873 "DECOM (default off): When set, cursor addressing is relative to the upper "
1874 "left corner of the scrolling region."
1875 msgstr ""
1876
1877 #. type: TP
1878 #: build/C/man4/console_codes.4:335
1879 #, no-wrap
1880 msgid "ESC [ ? 7 h"
1881 msgstr ""
1882
1883 #. type: Plain text
1884 #: build/C/man4/console_codes.4:341
1885 msgid ""
1886 "DECAWM (default on): Set autowrap on.  In this mode, a graphic character "
1887 "emitted after column 80 (or column 132 of DECCOLM is on)  forces a wrap to "
1888 "the beginning of the following line first."
1889 msgstr ""
1890
1891 #. type: TP
1892 #: build/C/man4/console_codes.4:341
1893 #, no-wrap
1894 msgid "ESC [ ? 8 h"
1895 msgstr ""
1896
1897 #. type: Plain text
1898 #: build/C/man4/console_codes.4:344
1899 msgid "DECARM (default on): Set keyboard autorepeat on."
1900 msgstr ""
1901
1902 #. type: TP
1903 #: build/C/man4/console_codes.4:344
1904 #, no-wrap
1905 msgid "ESC [ ? 9 h"
1906 msgstr ""
1907
1908 #. type: Plain text
1909 #: build/C/man4/console_codes.4:348
1910 msgid ""
1911 "X10 Mouse Reporting (default off): Set reporting mode to 1 (or reset to "
1912 "0)\\(emsee below."
1913 msgstr ""
1914
1915 #. type: TP
1916 #: build/C/man4/console_codes.4:348
1917 #, no-wrap
1918 msgid "ESC [ ? 25 h"
1919 msgstr ""
1920
1921 #. type: Plain text
1922 #: build/C/man4/console_codes.4:351
1923 msgid "DECTECM (default on): Make cursor visible."
1924 msgstr ""
1925
1926 #. type: TP
1927 #: build/C/man4/console_codes.4:351
1928 #, no-wrap
1929 msgid "ESC [ ? 1000 h"
1930 msgstr ""
1931
1932 #. type: Plain text
1933 #: build/C/man4/console_codes.4:356
1934 msgid ""
1935 "X11 Mouse Reporting (default off): Set reporting mode to 2 (or reset to "
1936 "0)\\(emsee below."
1937 msgstr ""
1938
1939 #. type: Plain text
1940 #: build/C/man4/console_codes.4:358
1941 msgid "B<Linux Console Private CSI Sequences>"
1942 msgstr ""
1943
1944 #. type: Plain text
1945 #: build/C/man4/console_codes.4:365
1946 msgid ""
1947 "The following sequences are neither ECMA-48 nor native VT102.  They are "
1948 "native to the Linux console driver.  Colors are in SGR parameters: 0 = "
1949 "black, 1 = red, 2 = green, 3 = brown, 4 = blue, 5 = magenta, 6 = cyan, 7 = "
1950 "white."
1951 msgstr ""
1952
1953 #. type: tbl table
1954 #: build/C/man4/console_codes.4:367
1955 #, no-wrap
1956 msgid "ESC [ 1 ; I<n> ]\tSet color I<n> as the underline color\n"
1957 msgstr ""
1958
1959 #. type: tbl table
1960 #: build/C/man4/console_codes.4:368
1961 #, no-wrap
1962 msgid "ESC [ 2 ; I<n> ]\tSet color I<n> as the dim color\n"
1963 msgstr ""
1964
1965 #. type: tbl table
1966 #: build/C/man4/console_codes.4:369
1967 #, no-wrap
1968 msgid "ESC [ 8 ]       \tMake the current color pair the default attributes.\n"
1969 msgstr ""
1970
1971 #. type: tbl table
1972 #: build/C/man4/console_codes.4:370
1973 #, no-wrap
1974 msgid "ESC [ 9 ; I<n> ]\tSet screen blank timeout to I<n> minutes.\n"
1975 msgstr ""
1976
1977 #. type: tbl table
1978 #: build/C/man4/console_codes.4:371
1979 #, no-wrap
1980 msgid "ESC [ 10 ; I<n> ]\tSet bell frequency in Hz.\n"
1981 msgstr ""
1982
1983 #. type: tbl table
1984 #: build/C/man4/console_codes.4:372
1985 #, no-wrap
1986 msgid "ESC [ 11 ; I<n> ]\tSet bell duration in msec.\n"
1987 msgstr ""
1988
1989 #. type: tbl table
1990 #: build/C/man4/console_codes.4:373
1991 #, no-wrap
1992 msgid "ESC [ 12 ; I<n> ]\tBring specified console to the front.\n"
1993 msgstr ""
1994
1995 #. type: tbl table
1996 #: build/C/man4/console_codes.4:374
1997 #, no-wrap
1998 msgid "ESC [ 13 ]      \tUnblank the screen.\n"
1999 msgstr ""
2000
2001 #. type: tbl table
2002 #: build/C/man4/console_codes.4:375
2003 #, no-wrap
2004 msgid "ESC [ 14 ; I<n> ]   \tSet the VESA powerdown interval in minutes.\n"
2005 msgstr ""
2006
2007 #. type: SS
2008 #: build/C/man4/console_codes.4:377
2009 #, no-wrap
2010 msgid "Character sets"
2011 msgstr ""
2012
2013 #. type: Plain text
2014 #: build/C/man4/console_codes.4:382
2015 msgid ""
2016 "The kernel knows about 4 translations of bytes into console-screen symbols.  "
2017 "The four tables are: a) Latin1 -E<gt> PC, b) VT100 graphics -E<gt> PC, c) PC "
2018 "-E<gt> PC, d) user-defined."
2019 msgstr ""
2020
2021 #. type: Plain text
2022 #: build/C/man4/console_codes.4:388
2023 msgid ""
2024 "There are two character sets, called G0 and G1, and one of them is the "
2025 "current character set.  (Initially G0.)  Typing B<^N> causes G1 to become "
2026 "current, B<^O> causes G0 to become current."
2027 msgstr ""
2028
2029 #. type: Plain text
2030 #: build/C/man4/console_codes.4:396
2031 msgid ""
2032 "These variables G0 and G1 point at a translation table, and can be changed "
2033 "by the user.  Initially they point at tables a) and b), respectively.  The "
2034 "sequences ESC ( B and ESC ( 0 and ESC ( U and ESC ( K cause G0 to point at "
2035 "translation table a), b), c) and d), respectively.  The sequences ESC ) B "
2036 "and ESC ) 0 and ESC ) U and ESC ) K cause G1 to point at translation table "
2037 "a), b), c) and d), respectively."
2038 msgstr ""
2039
2040 #. type: Plain text
2041 #: build/C/man4/console_codes.4:406
2042 msgid ""
2043 "The sequence ESC c causes a terminal reset, which is what you want if the "
2044 "screen is all garbled.  The oft-advised \"echo ^V^O\" will make only G0 "
2045 "current, but there is no guarantee that G0 points at table a).  In some "
2046 "distributions there is a program B<reset>(1)  that just does \"echo ^[c\".  "
2047 "If your terminfo entry for the console is correct (and has an entry "
2048 "rs1=\\eEc), then \"tput reset\" will also work."
2049 msgstr ""
2050
2051 #. type: Plain text
2052 #: build/C/man4/console_codes.4:414
2053 msgid ""
2054 "The user-defined mapping table can be set using B<mapscrn>(8).  The result "
2055 "of the mapping is that if a symbol c is printed, the symbol s = map[c] is "
2056 "sent to the video memory.  The bitmap that corresponds to s is found in the "
2057 "character ROM, and can be changed using B<setfont>(8)."
2058 msgstr ""
2059
2060 #. type: SS
2061 #: build/C/man4/console_codes.4:414
2062 #, no-wrap
2063 msgid "Mouse tracking"
2064 msgstr ""
2065
2066 #. type: Plain text
2067 #: build/C/man4/console_codes.4:426
2068 msgid ""
2069 "The mouse tracking facility is intended to return B<xterm>(1)-compatible "
2070 "mouse status reports.  Because the console driver has no way to know the "
2071 "device or type of the mouse, these reports are returned in the console input "
2072 "stream only when the virtual terminal driver receives a mouse update ioctl.  "
2073 "These ioctls must be generated by a mouse-aware user-mode application such "
2074 "as the B<gpm>(8)  daemon."
2075 msgstr ""
2076
2077 #. type: Plain text
2078 #: build/C/man4/console_codes.4:432
2079 msgid ""
2080 "The mouse tracking escape sequences generated by B<xterm>(1) encode numeric "
2081 "parameters in a single character as I<value>+040.  For example, \\(aq!\\(aq "
2082 "is 1.  The screen coordinate system is 1-based."
2083 msgstr ""
2084
2085 #. type: Plain text
2086 #: build/C/man4/console_codes.4:442
2087 msgid ""
2088 "The X10 compatibility mode sends an escape sequence on button press encoding "
2089 "the location and the mouse button pressed.  It is enabled by sending ESC [ ? "
2090 "9 h and disabled with ESC [ ? 9 l.  On button press, B<xterm>(1) sends ESC [ "
2091 "M I<bxy> (6 characters).  Here I<b> is button-1, and I<x> and I<y> are the x "
2092 "and y coordinates of the mouse when the button was pressed.  This is the "
2093 "same code the kernel also produces."
2094 msgstr ""
2095
2096 #. type: Plain text
2097 #: build/C/man4/console_codes.4:457
2098 msgid ""
2099 "Normal tracking mode (not implemented in Linux 2.0.24) sends an escape "
2100 "sequence on both button press and release.  Modifier information is also "
2101 "sent.  It is enabled by sending ESC [ ? 1000 h and disabled with ESC [ ? "
2102 "1000 l.  On button press or release, B<xterm>(1) sends ESC [ M I<bxy>.  The "
2103 "low two bits of I<b> encode button information: 0=MB1 pressed, 1=MB2 "
2104 "pressed, 2=MB3 pressed, 3=release.  The upper bits encode what modifiers "
2105 "were down when the button was pressed and are added together: 4=Shift, "
2106 "8=Meta, 16=Control.  Again I<x> and I<y> are the x and y coordinates of the "
2107 "mouse event.  The upper left corner is (1,1)."
2108 msgstr ""
2109
2110 #. type: SS
2111 #: build/C/man4/console_codes.4:457
2112 #, no-wrap
2113 msgid "Comparisons with other terminals"
2114 msgstr ""
2115
2116 #. type: Plain text
2117 #: build/C/man4/console_codes.4:464
2118 msgid ""
2119 "Many different terminal types are described, like the Linux console, as "
2120 "being \"VT100-compatible\".  Here we discuss differences between the Linux "
2121 "console and the two most important others, the DEC VT102 and B<xterm>(1)."
2122 msgstr ""
2123
2124 #. type: Plain text
2125 #: build/C/man4/console_codes.4:466
2126 msgid "B<Control-character handling>"
2127 msgstr ""
2128
2129 #. type: Plain text
2130 #: build/C/man4/console_codes.4:468
2131 msgid "The VT102 also recognized the following control characters:"
2132 msgstr ""
2133
2134 #. type: Plain text
2135 #: build/C/man4/console_codes.4:470
2136 msgid "NUL (0x00) was ignored;"
2137 msgstr ""
2138
2139 #. type: Plain text
2140 #: build/C/man4/console_codes.4:472
2141 msgid "ENQ (0x05) triggered an answerback message;"
2142 msgstr ""
2143
2144 #. type: Plain text
2145 #: build/C/man4/console_codes.4:474
2146 msgid "DC1 (0x11, B<^Q>, XON) resumed transmission;"
2147 msgstr ""
2148
2149 #. type: Plain text
2150 #: build/C/man4/console_codes.4:477
2151 msgid ""
2152 "DC3 (0x13, B<^S>, XOFF) caused VT100 to ignore (and stop transmitting)  all "
2153 "codes except XOFF and XON."
2154 msgstr ""
2155
2156 #. type: Plain text
2157 #: build/C/man4/console_codes.4:479
2158 msgid "VT100-like DC1/DC3 processing may be enabled by the terminal driver."
2159 msgstr ""
2160
2161 #. type: Plain text
2162 #: build/C/man4/console_codes.4:485
2163 msgid ""
2164 "The B<xterm>(1)  program (in VT100 mode) recognizes the control characters "
2165 "BEL, BS, HT, LF, VT, FF, CR, SO, SI, ESC."
2166 msgstr ""
2167
2168 #. type: Plain text
2169 #: build/C/man4/console_codes.4:487
2170 msgid "B<Escape sequences>"
2171 msgstr ""
2172
2173 #. type: Plain text
2174 #: build/C/man4/console_codes.4:489
2175 msgid "VT100 console sequences not implemented on the Linux console:"
2176 msgstr ""
2177
2178 #. type: tbl table
2179 #: build/C/man4/console_codes.4:491
2180 #, no-wrap
2181 msgid "ESC N\tSS2\tSingle shift 2. (Select G2 character set for the next\n"
2182 msgstr ""
2183
2184 #. type: tbl table
2185 #: build/C/man4/console_codes.4:492 build/C/man4/console_codes.4:494
2186 #, no-wrap
2187 msgid "\t\tcharacter only.)\n"
2188 msgstr ""
2189
2190 #. type: tbl table
2191 #: build/C/man4/console_codes.4:493
2192 #, no-wrap
2193 msgid "ESC O\tSS3\tSingle shift 3. (Select G3 character set for the next\n"
2194 msgstr ""
2195
2196 #. type: tbl table
2197 #: build/C/man4/console_codes.4:495
2198 #, no-wrap
2199 msgid "ESC P\tDCS\tDevice control string (ended by ESC \\e)\n"
2200 msgstr ""
2201
2202 #. type: tbl table
2203 #: build/C/man4/console_codes.4:496
2204 #, no-wrap
2205 msgid "ESC X\tSOS\tStart of string.\n"
2206 msgstr ""
2207
2208 #. type: tbl table
2209 #: build/C/man4/console_codes.4:497
2210 #, no-wrap
2211 msgid "ESC ^\tPM\tPrivacy message (ended by ESC \\e)\n"
2212 msgstr ""
2213
2214 #. type: tbl table
2215 #: build/C/man4/console_codes.4:498
2216 #, no-wrap
2217 msgid "ESC \\e\tST\tString terminator\n"
2218 msgstr ""
2219
2220 #. type: tbl table
2221 #: build/C/man4/console_codes.4:499
2222 #, no-wrap
2223 msgid "ESC * ...\t\tDesignate G2 character set\n"
2224 msgstr ""
2225
2226 #. type: tbl table
2227 #: build/C/man4/console_codes.4:500
2228 #, no-wrap
2229 msgid "ESC + ...\t\tDesignate G3 character set\n"
2230 msgstr ""
2231
2232 #. type: Plain text
2233 #: build/C/man4/console_codes.4:513
2234 msgid ""
2235 "The program B<xterm>(1)  (in VT100 mode) recognizes ESC c, ESC # 8, ESC "
2236 "E<gt>, ESC =, ESC D, ESC E, ESC H, ESC M, ESC N, ESC O, ESC P ... ESC \\e, "
2237 "ESC Z (it answers ESC [ ? 1 ; 2 c, \"I am a VT100 with advanced video "
2238 "option\")  and ESC ^ ... ESC \\e with the same meanings as indicated above.  "
2239 "It accepts ESC (, ESC ), ESC *, ESC + followed by 0, A, B for the DEC "
2240 "special character and line drawing set, UK, and US-ASCII, respectively."
2241 msgstr ""
2242
2243 #. type: Plain text
2244 #: build/C/man4/console_codes.4:517
2245 msgid ""
2246 "The user can configure B<xterm>(1) to respond to VT220-specific control "
2247 "sequences, and it will identify itself as a VT52, VT100, and up depending on "
2248 "the way it is configured and initialized."
2249 msgstr ""
2250
2251 #. type: Plain text
2252 #: build/C/man4/console_codes.4:522
2253 msgid ""
2254 "It accepts ESC ] (OSC) for the setting of certain resources.  In addition to "
2255 "the ECMA-48 string terminator (ST), B<xterm>(1) accepts a BEL to terminate "
2256 "an OSC string.  These are a few of the OSC control sequences recognized by "
2257 "B<xterm>(1):"
2258 msgstr ""
2259
2260 #. type: tbl table
2261 #: build/C/man4/console_codes.4:524
2262 #, no-wrap
2263 msgid "ESC ] 0 ; I<txt> ST\tSet icon name and window title to I<txt>.\n"
2264 msgstr ""
2265
2266 #. type: tbl table
2267 #: build/C/man4/console_codes.4:525
2268 #, no-wrap
2269 msgid "ESC ] 1 ; I<txt> ST\tSet icon name to I<txt>.\n"
2270 msgstr ""
2271
2272 #. type: tbl table
2273 #: build/C/man4/console_codes.4:526
2274 #, no-wrap
2275 msgid "ESC ] 2 ; I<txt> ST\tSet window title to I<txt>.\n"
2276 msgstr ""
2277
2278 #. type: tbl table
2279 #: build/C/man4/console_codes.4:527
2280 #, no-wrap
2281 msgid "ESC ] 4 ; I<num>; I<txt> ST\tSet ANSI color I<num> to I<txt>.\n"
2282 msgstr ""
2283
2284 #. type: tbl table
2285 #: build/C/man4/console_codes.4:528
2286 #, no-wrap
2287 msgid "ESC ] 10 ; I<txt> ST\tSet dynamic text color to I<txt>.\n"
2288 msgstr ""
2289
2290 #. type: tbl table
2291 #: build/C/man4/console_codes.4:529
2292 #, no-wrap
2293 msgid "ESC ] 4 6 ; I<name> ST\tChange log file to I<name> (normally disabled\n"
2294 msgstr ""
2295
2296 #. type: tbl table
2297 #: build/C/man4/console_codes.4:530
2298 #, no-wrap
2299 msgid "\tby a compile-time option)\n"
2300 msgstr ""
2301
2302 #. type: tbl table
2303 #: build/C/man4/console_codes.4:531
2304 #, no-wrap
2305 msgid "ESC ] 5 0 ; I<fn> ST\tSet font to I<fn>.\n"
2306 msgstr ""
2307
2308 #. type: Plain text
2309 #: build/C/man4/console_codes.4:536
2310 msgid ""
2311 "It recognizes the following with slightly modified meaning (saving more "
2312 "state, behaving closer to VT100/VT220):"
2313 msgstr ""
2314
2315 #. type: tbl table
2316 #: build/C/man4/console_codes.4:538
2317 #, no-wrap
2318 msgid "ESC 7  DECSC\tSave cursor\n"
2319 msgstr ""
2320
2321 #. type: tbl table
2322 #: build/C/man4/console_codes.4:539
2323 #, no-wrap
2324 msgid "ESC 8  DECRC\tRestore cursor\n"
2325 msgstr ""
2326
2327 #. type: Plain text
2328 #: build/C/man4/console_codes.4:543
2329 msgid "It also recognizes"
2330 msgstr ""
2331
2332 #. type: tbl table
2333 #: build/C/man4/console_codes.4:545
2334 #, no-wrap
2335 msgid "ESC F\t\tCursor to lower left corner of screen (if enabled by\n"
2336 msgstr ""
2337
2338 #. type: tbl table
2339 #: build/C/man4/console_codes.4:546
2340 #, no-wrap
2341 msgid "\t\tB<xterm>(1)'s B<hpLowerleftBugCompat> resource)\n"
2342 msgstr ""
2343
2344 #. type: tbl table
2345 #: build/C/man4/console_codes.4:547
2346 #, no-wrap
2347 msgid "ESC l\t\tMemory lock (per HP terminals).\n"
2348 msgstr ""
2349
2350 #. type: tbl table
2351 #: build/C/man4/console_codes.4:548
2352 #, no-wrap
2353 msgid "\t\tLocks memory above the cursor.\n"
2354 msgstr ""
2355
2356 #. type: tbl table
2357 #: build/C/man4/console_codes.4:549
2358 #, no-wrap
2359 msgid "ESC m\t\tMemory unlock (per HP terminals).\n"
2360 msgstr ""
2361
2362 #. type: tbl table
2363 #: build/C/man4/console_codes.4:550
2364 #, no-wrap
2365 msgid "ESC n\tLS2\tInvoke the G2 character set.\n"
2366 msgstr ""
2367
2368 #. type: tbl table
2369 #: build/C/man4/console_codes.4:551
2370 #, no-wrap
2371 msgid "ESC o\tLS3\tInvoke the G3 character set.\n"
2372 msgstr ""
2373
2374 #. type: tbl table
2375 #: build/C/man4/console_codes.4:552
2376 #, no-wrap
2377 msgid "ESC |\tLS3R\tInvoke the G3 character set as GR.\n"
2378 msgstr ""
2379
2380 #. type: tbl table
2381 #: build/C/man4/console_codes.4:553
2382 #, no-wrap
2383 msgid "ESC }\tLS2R\tInvoke the G2 character set as GR.\n"
2384 msgstr ""
2385
2386 #. type: tbl table
2387 #: build/C/man4/console_codes.4:554
2388 #, no-wrap
2389 msgid "ESC ~\tLS1R\tInvoke the G1 character set as GR.\n"
2390 msgstr ""
2391
2392 #. type: Plain text
2393 #: build/C/man4/console_codes.4:560
2394 msgid ""
2395 "It also recognizes ESC % and provides a more complete UTF-8 implementation "
2396 "than Linux console."
2397 msgstr ""
2398
2399 #. type: Plain text
2400 #: build/C/man4/console_codes.4:562
2401 msgid "B<CSI Sequences>"
2402 msgstr ""
2403
2404 #. type: Plain text
2405 #: build/C/man4/console_codes.4:576
2406 msgid ""
2407 "Old versions of B<xterm>(1), for example, from X11R5, interpret the blink "
2408 "SGR as a bold SGR.  Later versions which implemented ANSI colors, for "
2409 "example, XFree86 3.1.2A in 1995, improved this by allowing the blink "
2410 "attribute to be displayed as a color.  Modern versions of xterm implement "
2411 "blink SGR as blinking text and still allow colored text as an alternate "
2412 "rendering of SGRs.  Stock X11R6 versions did not recognize the color-setting "
2413 "SGRs until the X11R6.8 release, which incorporated XFree86 xterm.  All "
2414 "ECMA-48 CSI sequences recognized by Linux are also recognized by I<xterm>, "
2415 "however B<xterm>(1) implements several ECMA-48 and DEC control sequences not "
2416 "recognized by Linux."
2417 msgstr ""
2418
2419 #. type: Plain text
2420 #: build/C/man4/console_codes.4:590
2421 msgid ""
2422 "The B<xterm>(1)  program recognizes all of the DEC Private Mode sequences "
2423 "listed above, but none of the Linux private-mode sequences.  For discussion "
2424 "of B<xterm>(1)'s own private-mode sequences, refer to the I<Xterm Control "
2425 "Sequences> document by Edward Moy, Stephen Gildea, and Thomas E. Dickey "
2426 "available with the X distribution.  That document, though terse, is much "
2427 "longer than this manual page.  For a chronological overview,"
2428 msgstr ""
2429
2430 #. type: Plain text
2431 #: build/C/man4/console_codes.4:594
2432 msgid "E<.UR http://invisible-island.net\\:/xterm\\:/xterm.log.html> E<.UE>"
2433 msgstr ""
2434
2435 #. type: Plain text
2436 #: build/C/man4/console_codes.4:597
2437 msgid "details changes to xterm."
2438 msgstr ""
2439
2440 #. type: Plain text
2441 #: build/C/man4/console_codes.4:599
2442 msgid "The I<vttest> program"
2443 msgstr ""
2444
2445 #. type: Plain text
2446 #: build/C/man4/console_codes.4:603
2447 msgid "E<.UR http://invisible-island.net\\:/vttest/> E<.UE>"
2448 msgstr ""
2449
2450 #. type: Plain text
2451 #: build/C/man4/console_codes.4:608
2452 msgid ""
2453 "demonstrates many of these control sequences.  The B<xterm>(1) source "
2454 "distribution also contains sample scripts which exercise other features."
2455 msgstr ""
2456
2457 #. type: SH
2458 #: build/C/man4/console_codes.4:608 build/C/man4/console_ioctl.4:825 build/C/man5/core.5:297 build/C/man4/cpuid.4:62 build/C/man4/fd.4:196 build/C/man7/fifo.7:54 build/C/man4/initrd.4:429 build/C/man3/makedev.3:71 build/C/man2/mknod.2:182 build/C/man4/msr.4:47 build/C/man4/null.4:61 build/C/man4/st.4:891 build/C/man3/stdarg.3:239 build/C/man2/syslog.2:301 build/C/man3/syslog.3:296 build/C/man7/uri.7:592
2459 #, no-wrap
2460 msgid "NOTES"
2461 msgstr ""
2462
2463 #. type: Plain text
2464 #: build/C/man4/console_codes.4:611
2465 msgid "ESC 8 (DECRC) is not able to restore the character set changed with ESC %."
2466 msgstr ""
2467
2468 #. type: SH
2469 #: build/C/man4/console_codes.4:611 build/C/man4/sk98lin.4:605 build/C/man3/stdarg.3:275 build/C/man7/uri.7:673
2470 #, no-wrap
2471 msgid "BUGS"
2472 msgstr ""
2473
2474 #. type: Plain text
2475 #: build/C/man4/console_codes.4:614
2476 msgid "In 2.0.23, CSI is broken, and NUL is not ignored inside escape sequences."
2477 msgstr ""
2478
2479 #. type: Plain text
2480 #: build/C/man4/console_codes.4:623
2481 msgid ""
2482 "Some older kernel versions (after 2.0) interpret 8-bit control sequences.  "
2483 "These \"C1 controls\" use codes between 128 and 159 to replace ESC [, ESC ] "
2484 "and similar two-byte control sequence initiators.  There are fragments of "
2485 "that in modern kernels (either overlooked or broken by changes to support "
2486 "UTF-8), but the implementation is incomplete and should be regarded as "
2487 "unreliable."
2488 msgstr ""
2489
2490 #. type: Plain text
2491 #: build/C/man4/console_codes.4:638
2492 msgid ""
2493 "Linux \"private mode\" sequences do not follow the rules in ECMA-48 for "
2494 "private mode control sequences.  In particular, those ending with ] do not "
2495 "use a standard terminating character.  The OSC (set palette) sequence is a "
2496 "greater problem, since B<xterm>(1) may interpret this as a control sequence "
2497 "which requires a string terminator (ST).  Unlike the B<setterm>(1) sequences "
2498 "which will be ignored (since they are invalid control sequences), the "
2499 "palette sequence will make B<xterm>(1) appear to hang (though pressing the "
2500 "return-key will fix that).  To accommodate applications which have been "
2501 "hardcoded to use Linux control sequences, set the B<xterm>(1) resource "
2502 "B<brokenLinuxOSC> to true."
2503 msgstr ""
2504
2505 #. type: Plain text
2506 #: build/C/man4/console_codes.4:642
2507 msgid ""
2508 "An older version of this document implied that Linux recognizes the ECMA-48 "
2509 "control sequence for invisible text.  It is ignored."
2510 msgstr ""
2511
2512 #. type: Plain text
2513 #: build/C/man4/console_codes.4:646
2514 msgid "B<console>(4), B<console_ioctl>(4), B<charsets>(7)"
2515 msgstr ""
2516
2517 #. type: TH
2518 #: build/C/man4/console_ioctl.4:40
2519 #, no-wrap
2520 msgid "CONSOLE_IOCTL"
2521 msgstr ""
2522
2523 #. type: TH
2524 #: build/C/man4/console_ioctl.4:40
2525 #, no-wrap
2526 msgid "2009-02-28"
2527 msgstr ""
2528
2529 #. type: Plain text
2530 #: build/C/man4/console_ioctl.4:43
2531 msgid "console_ioctl - ioctls for console terminal and virtual consoles"
2532 msgstr ""
2533
2534 #. type: Plain text
2535 #: build/C/man4/console_ioctl.4:49
2536 msgid ""
2537 "The following Linux-specific B<ioctl>(2)  requests are supported.  Each "
2538 "requires a third argument, assumed here to be I<argp>."
2539 msgstr ""
2540
2541 #. type: TP
2542 #: build/C/man4/console_ioctl.4:49
2543 #, no-wrap
2544 msgid "B<KDGETLED>"
2545 msgstr ""
2546
2547 #. type: Plain text
2548 #: build/C/man4/console_ioctl.4:59
2549 msgid ""
2550 "Get state of LEDs.  I<argp> points to a I<char>.  The lower three bits of "
2551 "I<*argp> are set to the state of the LEDs, as follows:"
2552 msgstr ""
2553
2554 #. type: tbl table
2555 #: build/C/man4/console_ioctl.4:61
2556 #, no-wrap
2557 msgid "LED_CAP \t0x04\tcaps lock led\n"
2558 msgstr ""
2559
2560 #. type: tbl table
2561 #: build/C/man4/console_ioctl.4:62
2562 #, no-wrap
2563 msgid "LEC_NUM \t0x02\tnum lock led\n"
2564 msgstr ""
2565
2566 #. type: tbl table
2567 #: build/C/man4/console_ioctl.4:63
2568 #, no-wrap
2569 msgid "LED_SCR \t0x01\tscroll lock led\n"
2570 msgstr ""
2571
2572 #. type: TP
2573 #: build/C/man4/console_ioctl.4:65
2574 #, no-wrap
2575 msgid "B<KDSETLED>"
2576 msgstr ""
2577
2578 #. type: Plain text
2579 #: build/C/man4/console_ioctl.4:73
2580 msgid ""
2581 "Set the LEDs.  The LEDs are set to correspond to the lower three bits of "
2582 "I<argp>.  However, if a higher order bit is set, the LEDs revert to normal: "
2583 "displaying the state of the keyboard functions of caps lock, num lock, and "
2584 "scroll lock."
2585 msgstr ""
2586
2587 #. type: Plain text
2588 #: build/C/man4/console_ioctl.4:80
2589 msgid ""
2590 "Before 1.1.54, the LEDs just reflected the state of the corresponding "
2591 "keyboard flags, and KDGETLED/KDSETLED would also change the keyboard flags.  "
2592 "Since 1.1.54 the LEDs can be made to display arbitrary information, but by "
2593 "default they display the keyboard flags.  The following two ioctls are used "
2594 "to access the keyboard flags."
2595 msgstr ""
2596
2597 #. type: TP
2598 #: build/C/man4/console_ioctl.4:80
2599 #, no-wrap
2600 msgid "B<KDGKBLED>"
2601 msgstr ""
2602
2603 #. type: Plain text
2604 #: build/C/man4/console_ioctl.4:89
2605 msgid ""
2606 "Get keyboard flags CapsLock, NumLock, ScrollLock (not lights).  I<argp> "
2607 "points to a char which is set to the flag state.  The low order three bits "
2608 "(mask 0x7) get the current flag state, and the low order bits of the next "
2609 "nibble (mask 0x70) get the default flag state.  (Since 1.1.54.)"
2610 msgstr ""
2611
2612 #. type: TP
2613 #: build/C/man4/console_ioctl.4:89
2614 #, no-wrap
2615 msgid "B<KDSKBLED>"
2616 msgstr ""
2617
2618 #. type: Plain text
2619 #: build/C/man4/console_ioctl.4:98
2620 msgid ""
2621 "Set keyboard flags CapsLock, NumLock, ScrollLock (not lights).  I<argp> has "
2622 "the desired flag state.  The low order three bits (mask 0x7) have the flag "
2623 "state, and the low order bits of the next nibble (mask 0x70) have the "
2624 "default flag state.  (Since 1.1.54.)"
2625 msgstr ""
2626
2627 #. type: TP
2628 #: build/C/man4/console_ioctl.4:98
2629 #, no-wrap
2630 msgid "B<KDGKBTYPE>"
2631 msgstr ""
2632
2633 #. type: Plain text
2634 #: build/C/man4/console_ioctl.4:102
2635 msgid "Get keyboard type.  This returns the value KB_101, defined as 0x02."
2636 msgstr ""
2637
2638 #. type: TP
2639 #: build/C/man4/console_ioctl.4:102
2640 #, no-wrap
2641 msgid "B<KDADDIO>"
2642 msgstr ""
2643
2644 #. type: Plain text
2645 #: build/C/man4/console_ioctl.4:107
2646 msgid "Add I/O port as valid.  Equivalent to I<ioperm(arg,1,1)>."
2647 msgstr ""
2648
2649 #. type: TP
2650 #: build/C/man4/console_ioctl.4:107
2651 #, no-wrap
2652 msgid "B<KDDELIO>"
2653 msgstr ""
2654
2655 #. type: Plain text
2656 #: build/C/man4/console_ioctl.4:112
2657 msgid "Delete I/O port as valid.  Equivalent to I<ioperm(arg,1,0)>."
2658 msgstr ""
2659
2660 #. type: TP
2661 #: build/C/man4/console_ioctl.4:112
2662 #, no-wrap
2663 msgid "B<KDENABIO>"
2664 msgstr ""
2665
2666 #. type: Plain text
2667 #: build/C/man4/console_ioctl.4:117
2668 msgid ""
2669 "Enable I/O to video board.  Equivalent to I<ioperm(0x3b4, 0x3df-0x3b4+1, "
2670 "1)>."
2671 msgstr ""
2672
2673 #. type: TP
2674 #: build/C/man4/console_ioctl.4:117
2675 #, no-wrap
2676 msgid "B<KDDISABIO>"
2677 msgstr ""
2678
2679 #. type: Plain text
2680 #: build/C/man4/console_ioctl.4:122
2681 msgid ""
2682 "Disable I/O to video board.  Equivalent to I<ioperm(0x3b4, 0x3df-0x3b4+1, "
2683 "0)>."
2684 msgstr ""
2685
2686 #. type: TP
2687 #: build/C/man4/console_ioctl.4:122
2688 #, no-wrap
2689 msgid "B<KDSETMODE>"
2690 msgstr ""
2691
2692 #. type: Plain text
2693 #: build/C/man4/console_ioctl.4:127
2694 msgid "Set text/graphics mode.  I<argp> is one of these:"
2695 msgstr ""
2696
2697 #. type: tbl table
2698 #: build/C/man4/console_ioctl.4:130
2699 #, no-wrap
2700 msgid "KD_TEXT\t0x00\n"
2701 msgstr ""
2702
2703 #. type: tbl table
2704 #: build/C/man4/console_ioctl.4:131
2705 #, no-wrap
2706 msgid "KD_GRAPHICS\t0x01\n"
2707 msgstr ""
2708
2709 #. type: TP
2710 #: build/C/man4/console_ioctl.4:133
2711 #, no-wrap
2712 msgid "B<KDGETMODE>"
2713 msgstr ""
2714
2715 #. type: Plain text
2716 #: build/C/man4/console_ioctl.4:141
2717 msgid ""
2718 "Get text/graphics mode.  I<argp> points to a I<long> which is set to one of "
2719 "the above values."
2720 msgstr ""
2721
2722 #. type: TP
2723 #: build/C/man4/console_ioctl.4:141
2724 #, no-wrap
2725 msgid "B<KDMKTONE>"
2726 msgstr ""
2727
2728 #. type: Plain text
2729 #: build/C/man4/console_ioctl.4:155
2730 msgid ""
2731 "Generate tone of specified length.  The lower 16 bits of I<argp> specify the "
2732 "period in clock cycles, and the upper 16 bits give the duration in msec.  If "
2733 "the duration is zero, the sound is turned off.  Control returns "
2734 "immediately.  For example, I<argp> = (125E<lt>E<lt>16) + 0x637 would specify "
2735 "the beep normally associated with a ctrl-G.  (Thus since 0.99pl1; broken in "
2736 "2.1.49-50.)"
2737 msgstr ""
2738
2739 #. type: TP
2740 #: build/C/man4/console_ioctl.4:155
2741 #, no-wrap
2742 msgid "B<KIOCSOUND>"
2743 msgstr ""
2744
2745 #. type: Plain text
2746 #: build/C/man4/console_ioctl.4:167
2747 msgid ""
2748 "Start or stop sound generation.  The lower 16 bits of I<argp> specify the "
2749 "period in clock cycles (that is, I<argp> = 1193180/frequency).  I<argp> = 0 "
2750 "turns sound off.  In either case, control returns immediately."
2751 msgstr ""
2752
2753 #. type: TP
2754 #: build/C/man4/console_ioctl.4:167
2755 #, no-wrap
2756 msgid "B<GIO_CMAP>"
2757 msgstr ""
2758
2759 #. type: Plain text
2760 #: build/C/man4/console_ioctl.4:174
2761 msgid ""
2762 "Get the current default color map from kernel.  I<argp> points to a 48-byte "
2763 "array.  (Since 1.3.3.)"
2764 msgstr ""
2765
2766 #. type: TP
2767 #: build/C/man4/console_ioctl.4:174
2768 #, no-wrap
2769 msgid "B<PIO_CMAP>"
2770 msgstr ""
2771
2772 #. type: Plain text
2773 #: build/C/man4/console_ioctl.4:187
2774 msgid ""
2775 "Change the default text-mode color map.  I<argp> points to a 48-byte array "
2776 "which contains, in order, the Red, Green, and Blue values for the 16 "
2777 "available screen colors: 0 is off, and 255 is full intensity.  The default "
2778 "colors are, in order: black, dark red, dark green, brown, dark blue, dark "
2779 "purple, dark cyan, light grey, dark grey, bright red, bright green, yellow, "
2780 "bright blue, bright purple, bright cyan and white.  (Since 1.3.3.)"
2781 msgstr ""
2782
2783 #. type: TP
2784 #: build/C/man4/console_ioctl.4:187
2785 #, no-wrap
2786 msgid "B<GIO_FONT>"
2787 msgstr ""
2788
2789 #. type: Plain text
2790 #: build/C/man4/console_ioctl.4:197
2791 msgid ""
2792 "Gets 256-character screen font in expanded form.  I<argp> points to an 8192 "
2793 "byte array.  Fails with error code B<EINVAL> if the currently loaded font is "
2794 "a 512-character font, or if the console is not in text mode."
2795 msgstr ""
2796
2797 #. type: TP
2798 #: build/C/man4/console_ioctl.4:197
2799 #, no-wrap
2800 msgid "B<GIO_FONTX>"
2801 msgstr ""
2802
2803 #. type: Plain text
2804 #: build/C/man4/console_ioctl.4:225
2805 msgid ""
2806 "Gets screen font and associated information.  I<argp> points to a I<struct "
2807 "consolefontdesc> (see B<PIO_FONTX>).  On call, the I<charcount> field should "
2808 "be set to the maximum number of characters that would fit in the buffer "
2809 "pointed to by I<chardata>.  On return, the I<charcount> and I<charheight> "
2810 "are filled with the respective data for the currently loaded font, and the "
2811 "I<hardata> array contains the font data if the initial value of I<charcount> "
2812 "indicated enough space was available; otherwise the buffer is untouched and "
2813 "I<errno> is set to B<ENOMEM>.  (Since 1.3.1.)"
2814 msgstr ""
2815
2816 #. type: TP
2817 #: build/C/man4/console_ioctl.4:225
2818 #, no-wrap
2819 msgid "B<PIO_FONT>"
2820 msgstr ""
2821
2822 #. type: Plain text
2823 #: build/C/man4/console_ioctl.4:240
2824 msgid ""
2825 "Sets 256-character screen font.  Load font into the EGA/VGA character "
2826 "generator.  I<argp> points to a 8192 byte map, with 32 bytes per character.  "
2827 "Only the first I<N> of them are used for an 8xI<N> font (0 E<lt> I<N> E<lt>= "
2828 "32).  This call also invalidates the Unicode mapping."
2829 msgstr ""
2830
2831 #. type: TP
2832 #: build/C/man4/console_ioctl.4:240
2833 #, no-wrap
2834 msgid "B<PIO_FONTX>"
2835 msgstr ""
2836
2837 #. type: Plain text
2838 #: build/C/man4/console_ioctl.4:244
2839 msgid "Sets screen font and associated rendering information.  I<argp>"
2840 msgstr ""
2841
2842 #. type: Plain text
2843 #: build/C/man4/console_ioctl.4:246
2844 msgid "points to a"
2845 msgstr ""
2846
2847 #. type: Plain text
2848 #: build/C/man4/console_ioctl.4:257
2849 #, no-wrap
2850 msgid ""
2851 "struct consolefontdesc {\n"
2852 "    unsigned short charcount;  /* characters in font\n"
2853 "                                  (256 or 512) */\n"
2854 "    unsigned short charheight; /* scan lines per\n"
2855 "                                  character (1-32) */\n"
2856 "    char          *chardata;   /* font data in\n"
2857 "                                  expanded form */\n"
2858 "};\n"
2859 msgstr ""
2860
2861 #. type: Plain text
2862 #: build/C/man4/console_ioctl.4:265
2863 msgid ""
2864 "If necessary, the screen will be appropriately resized, and B<SIGWINCH> sent "
2865 "to the appropriate processes.  This call also invalidates the Unicode "
2866 "mapping.  (Since 1.3.1.)"
2867 msgstr ""
2868
2869 #. type: TP
2870 #: build/C/man4/console_ioctl.4:265
2871 #, no-wrap
2872 msgid "B<PIO_FONTRESET>"
2873 msgstr ""
2874
2875 #. type: Plain text
2876 #: build/C/man4/console_ioctl.4:273
2877 msgid ""
2878 "Resets the screen font, size and Unicode mapping to the bootup defaults.  "
2879 "I<argp> is unused, but should be set to NULL to ensure compatibility with "
2880 "future versions of Linux.  (Since 1.3.28.)"
2881 msgstr ""
2882
2883 #. type: TP
2884 #: build/C/man4/console_ioctl.4:273
2885 #, no-wrap
2886 msgid "B<GIO_SCRNMAP>"
2887 msgstr ""
2888
2889 #. type: Plain text
2890 #: build/C/man4/console_ioctl.4:282
2891 msgid ""
2892 "Get screen mapping from kernel.  I<argp> points to an area of size E_TABSZ, "
2893 "which is loaded with the font positions used to display each character.  "
2894 "This call is likely to return useless information if the currently loaded "
2895 "font is more than 256 characters."
2896 msgstr ""
2897
2898 #. type: TP
2899 #: build/C/man4/console_ioctl.4:282
2900 #, no-wrap
2901 msgid "B<GIO_UNISCRNMAP>"
2902 msgstr ""
2903
2904 #. type: Plain text
2905 #: build/C/man4/console_ioctl.4:294
2906 msgid ""
2907 "Get full Unicode screen mapping from kernel.  I<argp> points to an area of "
2908 "size I<E_TABSZ*sizeof(unsigned>short)I<,> which is loaded with the Unicodes "
2909 "each character represent.  A special set of Unicodes, starting at U+F000, "
2910 "are used to represent \"direct to font\" mappings.  (Since 1.3.1.)"
2911 msgstr ""
2912
2913 #. type: TP
2914 #: build/C/man4/console_ioctl.4:294
2915 #, no-wrap
2916 msgid "B<PIO_SCRNMAP>"
2917 msgstr ""
2918
2919 #. type: Plain text
2920 #: build/C/man4/console_ioctl.4:301
2921 msgid ""
2922 "Loads the \"user definable\" (fourth) table in the kernel which maps bytes "
2923 "into console screen symbols.  I<argp> points to an area of size E_TABSZ."
2924 msgstr ""
2925
2926 #. type: TP
2927 #: build/C/man4/console_ioctl.4:301
2928 #, no-wrap
2929 msgid "B<PIO_UNISCRNMAP>"
2930 msgstr ""
2931
2932 #. type: Plain text
2933 #: build/C/man4/console_ioctl.4:309
2934 msgid ""
2935 "Loads the \"user definable\" (fourth) table in the kernel which maps bytes "
2936 "into Unicodes, which are then translated into screen symbols according to "
2937 "the currently loaded Unicode-to-font map.  Special Unicodes starting at "
2938 "U+F000 can be used to map directly to the font symbols.  (Since 1.3.1.)"
2939 msgstr ""
2940
2941 #. type: TP
2942 #: build/C/man4/console_ioctl.4:309
2943 #, no-wrap
2944 msgid "B<GIO_UNIMAP>"
2945 msgstr ""
2946
2947 #. type: Plain text
2948 #: build/C/man4/console_ioctl.4:314
2949 msgid "Get Unicode-to-font mapping from kernel.  I<argp> points to a"
2950 msgstr ""
2951
2952 #. type: Plain text
2953 #: build/C/man4/console_ioctl.4:321
2954 #, no-wrap
2955 msgid ""
2956 "struct unimapdesc {\n"
2957 "    unsigned short  entry_ct;\n"
2958 "    struct unipair *entries;\n"
2959 "};\n"
2960 msgstr ""
2961
2962 #. type: Plain text
2963 #: build/C/man4/console_ioctl.4:327
2964 msgid "where I<entries> points to an array of"
2965 msgstr ""
2966
2967 #. type: Plain text
2968 #: build/C/man4/console_ioctl.4:334
2969 #, no-wrap
2970 msgid ""
2971 "struct unipair {\n"
2972 "    unsigned short unicode;\n"
2973 "    unsigned short fontpos;\n"
2974 "};\n"
2975 msgstr ""
2976
2977 #. type: Plain text
2978 #: build/C/man4/console_ioctl.4:338 build/C/man4/console_ioctl.4:362
2979 msgid "(Since 1.1.92.)"
2980 msgstr ""
2981
2982 #. type: TP
2983 #: build/C/man4/console_ioctl.4:338
2984 #, no-wrap
2985 msgid "B<PIO_UNIMAP>"
2986 msgstr ""
2987
2988 #. type: Plain text
2989 #: build/C/man4/console_ioctl.4:345
2990 msgid ""
2991 "Put unicode-to-font mapping in kernel.  I<argp> points to a I<struct "
2992 "unimapdesc>.  (Since 1.1.92)"
2993 msgstr ""
2994
2995 #. type: TP
2996 #: build/C/man4/console_ioctl.4:345
2997 #, no-wrap
2998 msgid "B<PIO_UNIMAPCLR>"
2999 msgstr ""
3000
3001 #. type: Plain text
3002 #: build/C/man4/console_ioctl.4:350
3003 msgid "Clear table, possibly advise hash algorithm.  I<argp> points to a"
3004 msgstr ""
3005
3006 #. type: Plain text
3007 #: build/C/man4/console_ioctl.4:358
3008 #, no-wrap
3009 msgid ""
3010 "struct unimapinit {\n"
3011 "    unsigned short advised_hashsize;  /* 0 if no opinion */\n"
3012 "    unsigned short advised_hashstep;  /* 0 if no opinion */\n"
3013 "    unsigned short advised_hashlevel; /* 0 if no opinion */\n"
3014 "};\n"
3015 msgstr ""
3016
3017 #. type: TP
3018 #: build/C/man4/console_ioctl.4:362
3019 #, no-wrap
3020 msgid "B<KDGKBMODE>"
3021 msgstr ""
3022
3023 #. type: Plain text
3024 #: build/C/man4/console_ioctl.4:370
3025 msgid ""
3026 "Gets current keyboard mode.  I<argp> points to a I<long> which is set to one "
3027 "of these:"
3028 msgstr ""
3029
3030 #. type: tbl table
3031 #: build/C/man4/console_ioctl.4:373
3032 #, no-wrap
3033 msgid "K_RAW\t0x00\n"
3034 msgstr ""
3035
3036 #. type: tbl table
3037 #: build/C/man4/console_ioctl.4:374
3038 #, no-wrap
3039 msgid "K_XLATE\t0x01\n"
3040 msgstr ""
3041
3042 #. type: tbl table
3043 #: build/C/man4/console_ioctl.4:375
3044 #, no-wrap
3045 msgid "K_MEDIUMRAW\t0x02\n"
3046 msgstr ""
3047
3048 #. type: tbl table
3049 #: build/C/man4/console_ioctl.4:376
3050 #, no-wrap
3051 msgid "K_UNICODE\t0x03\n"
3052 msgstr ""
3053
3054 #. type: TP
3055 #: build/C/man4/console_ioctl.4:378
3056 #, no-wrap
3057 msgid "B<KDSKBMODE>"
3058 msgstr ""
3059
3060 #. type: Plain text
3061 #: build/C/man4/console_ioctl.4:385
3062 msgid ""
3063 "Sets current keyboard mode.  I<argp> is a I<long> equal to one of the above "
3064 "values."
3065 msgstr ""
3066
3067 #. type: TP
3068 #: build/C/man4/console_ioctl.4:385
3069 #, no-wrap
3070 msgid "B<KDGKBMETA>"
3071 msgstr ""
3072
3073 #. type: Plain text
3074 #: build/C/man4/console_ioctl.4:393
3075 msgid ""
3076 "Gets meta key handling mode.  I<argp> points to a I<long> which is set to "
3077 "one of these:"
3078 msgstr ""
3079
3080 #. type: tbl table
3081 #: build/C/man4/console_ioctl.4:396
3082 #, no-wrap
3083 msgid "K_METABIT\t0x03\tset high order bit\n"
3084 msgstr ""
3085
3086 #. type: tbl table
3087 #: build/C/man4/console_ioctl.4:397
3088 #, no-wrap
3089 msgid "K_ESCPREFIX\t0x04\tescape prefix\n"
3090 msgstr ""
3091
3092 #. type: TP
3093 #: build/C/man4/console_ioctl.4:399
3094 #, no-wrap
3095 msgid "B<KDSKBMETA>"
3096 msgstr ""
3097
3098 #. type: Plain text
3099 #: build/C/man4/console_ioctl.4:406
3100 msgid ""
3101 "Sets meta key handling mode.  I<argp> is a I<long> equal to one of the above "
3102 "values."
3103 msgstr ""
3104
3105 #. type: TP
3106 #: build/C/man4/console_ioctl.4:406
3107 #, no-wrap
3108 msgid "B<KDGKBENT>"
3109 msgstr ""
3110
3111 #. type: Plain text
3112 #: build/C/man4/console_ioctl.4:411
3113 msgid ""
3114 "Gets one entry in key translation table (keycode to action code).  I<argp> "
3115 "points to a"
3116 msgstr ""
3117
3118 #. type: Plain text
3119 #: build/C/man4/console_ioctl.4:419
3120 #, no-wrap
3121 msgid ""
3122 "struct kbentry {\n"
3123 "    unsigned char  kb_table;\n"
3124 "    unsigned char  kb_index;\n"
3125 "    unsigned short kb_value;\n"
3126 "};\n"
3127 msgstr ""
3128
3129 #. type: Plain text
3130 #: build/C/man4/console_ioctl.4:438
3131 msgid ""
3132 "with the first two members filled in: I<kb_table> selects the key table (0 "
3133 "E<lt>= I<kb_table> E<lt> MAX_NR_KEYMAPS), and I<kb_index> is the keycode (0 "
3134 "E<lt>= I<kb_index> E<lt> NR_KEYS).  I<kb_value> is set to the corresponding "
3135 "action code, or K_HOLE if there is no such key, or K_NOSUCHMAP if "
3136 "I<kb_table> is invalid."
3137 msgstr ""
3138
3139 #. type: TP
3140 #: build/C/man4/console_ioctl.4:438
3141 #, no-wrap
3142 msgid "B<KDSKBENT>"
3143 msgstr ""
3144
3145 #. type: Plain text
3146 #: build/C/man4/console_ioctl.4:444
3147 msgid "Sets one entry in translation table.  I<argp> points to a I<struct kbentry>."
3148 msgstr ""
3149
3150 #. type: TP
3151 #: build/C/man4/console_ioctl.4:444
3152 #, no-wrap
3153 msgid "B<KDGKBSENT>"
3154 msgstr ""
3155
3156 #. type: Plain text
3157 #: build/C/man4/console_ioctl.4:449
3158 msgid "Gets one function key string.  I<argp> points to a"
3159 msgstr ""
3160
3161 #. type: Plain text
3162 #: build/C/man4/console_ioctl.4:456
3163 #, no-wrap
3164 msgid ""
3165 "struct kbsentry {\n"
3166 "    unsigned char kb_func;\n"
3167 "    unsigned char kb_string[512];\n"
3168 "};\n"
3169 msgstr ""
3170
3171 #. type: Plain text
3172 #: build/C/man4/console_ioctl.4:464
3173 msgid ""
3174 "I<kb_string> is set to the (null-terminated) string corresponding to the "
3175 "I<kb_func>th function key action code."
3176 msgstr ""
3177
3178 #. type: TP
3179 #: build/C/man4/console_ioctl.4:464
3180 #, no-wrap
3181 msgid "B<KDSKBSENT>"
3182 msgstr ""
3183
3184 #. type: Plain text
3185 #: build/C/man4/console_ioctl.4:470
3186 msgid "Sets one function key string entry.  I<argp> points to a I<struct kbsentry>."
3187 msgstr ""
3188
3189 #. type: TP
3190 #: build/C/man4/console_ioctl.4:470
3191 #, no-wrap
3192 msgid "B<KDGKBDIACR>"
3193 msgstr ""
3194
3195 #. type: Plain text
3196 #: build/C/man4/console_ioctl.4:475
3197 msgid "Read kernel accent table.  I<argp> points to a"
3198 msgstr ""
3199
3200 #. type: Plain text
3201 #: build/C/man4/console_ioctl.4:482
3202 #, no-wrap
3203 msgid ""
3204 "struct kbdiacrs {\n"
3205 "    unsigned int   kb_cnt;\n"
3206 "    struct kbdiacr kbdiacr[256];\n"
3207 "};\n"
3208 msgstr ""
3209
3210 #. type: Plain text
3211 #: build/C/man4/console_ioctl.4:489
3212 msgid "where I<kb_cnt> is the number of entries in the array, each of which is a"
3213 msgstr ""
3214
3215 #. type: Plain text
3216 #: build/C/man4/console_ioctl.4:497
3217 #, no-wrap
3218 msgid ""
3219 "struct kbdiacr {\n"
3220 "    unsigned char diacr;\n"
3221 "    unsigned char base;\n"
3222 "    unsigned char result;\n"
3223 "};\n"
3224 msgstr ""
3225
3226 #. type: TP
3227 #: build/C/man4/console_ioctl.4:499
3228 #, no-wrap
3229 msgid "B<KDGETKEYCODE>"
3230 msgstr ""
3231
3232 #. type: Plain text
3233 #: build/C/man4/console_ioctl.4:504
3234 msgid "Read kernel keycode table entry (scan code to keycode).  I<argp> points to a"
3235 msgstr ""
3236
3237 #. type: Plain text
3238 #: build/C/man4/console_ioctl.4:511
3239 #, no-wrap
3240 msgid ""
3241 "struct kbkeycode {\n"
3242 "    unsigned int scancode;\n"
3243 "    unsigned int keycode;\n"
3244 "};\n"
3245 msgstr ""
3246
3247 #. type: Plain text
3248 #: build/C/man4/console_ioctl.4:525
3249 msgid ""
3250 "I<keycode> is set to correspond to the given I<scancode>.  (89 E<lt>= "
3251 "I<scancode> E<lt>= 255 only.  For 1 E<lt>= I<scancode> E<lt>= 88, "
3252 "I<keycode>==I<scancode>.)  (Since 1.1.63.)"
3253 msgstr ""
3254
3255 #. type: TP
3256 #: build/C/man4/console_ioctl.4:525
3257 #, no-wrap
3258 msgid "B<KDSETKEYCODE>"
3259 msgstr ""
3260
3261 #. type: Plain text
3262 #: build/C/man4/console_ioctl.4:532
3263 msgid ""
3264 "Write kernel keycode table entry.  I<argp> points to a I<struct kbkeycode>.  "
3265 "(Since 1.1.63.)"
3266 msgstr ""
3267
3268 #. type: TP
3269 #: build/C/man4/console_ioctl.4:532
3270 #, no-wrap
3271 msgid "B<KDSIGACCEPT>"
3272 msgstr ""
3273
3274 #. type: Plain text
3275 #: build/C/man4/console_ioctl.4:544
3276 msgid ""
3277 "The calling process indicates its willingness to accept the signal I<argp> "
3278 "when it is generated by pressing an appropriate key combination.  (1 E<lt>= "
3279 "I<argp> E<lt>= NSIG).  (See I<spawn_console>()  in "
3280 "I<linux/drivers/char/keyboard.c>.)"
3281 msgstr ""
3282
3283 #. type: TP
3284 #: build/C/man4/console_ioctl.4:544
3285 #, no-wrap
3286 msgid "B<VT_OPENQRY>"
3287 msgstr ""
3288
3289 #. type: Plain text
3290 #: build/C/man4/console_ioctl.4:554
3291 msgid ""
3292 "Returns the first available (non-opened) console.  I<argp> points to an "
3293 "I<int> which is set to the number of the vt (1 E<lt>= I<*argp> E<lt>= "
3294 "MAX_NR_CONSOLES)."
3295 msgstr ""
3296
3297 #. type: TP
3298 #: build/C/man4/console_ioctl.4:554
3299 #, no-wrap
3300 msgid "B<VT_GETMODE>"
3301 msgstr ""
3302
3303 #. type: Plain text
3304 #: build/C/man4/console_ioctl.4:559
3305 msgid "Get mode of active vt.  I<argp> points to a"
3306 msgstr ""
3307
3308 #. type: Plain text
3309 #: build/C/man4/console_ioctl.4:569
3310 #, no-wrap
3311 msgid ""
3312 "struct vt_mode {\n"
3313 "    char  mode;    /* vt mode */\n"
3314 "    char  waitv;   /* if set, hang on writes if not active */\n"
3315 "    short relsig;  /* signal to raise on release req */\n"
3316 "    short acqsig;  /* signal to raise on acquisition */\n"
3317 "    short frsig;   /* unused (set to 0) */\n"
3318 "};\n"
3319 msgstr ""
3320
3321 #. type: Plain text
3322 #: build/C/man4/console_ioctl.4:575
3323 msgid ""
3324 "which is set to the mode of the active vt.  I<mode> is set to one of these "
3325 "values:"
3326 msgstr ""
3327
3328 #. type: tbl table
3329 #: build/C/man4/console_ioctl.4:578
3330 #, no-wrap
3331 msgid "VT_AUTO\tauto vt switching\n"
3332 msgstr ""
3333
3334 #. type: tbl table
3335 #: build/C/man4/console_ioctl.4:579
3336 #, no-wrap
3337 msgid "VT_PROCESS\tprocess controls switching\n"
3338 msgstr ""
3339
3340 #. type: tbl table
3341 #: build/C/man4/console_ioctl.4:580
3342 #, no-wrap
3343 msgid "VT_ACKACQ\tacknowledge switch\n"
3344 msgstr ""
3345
3346 #. type: TP
3347 #: build/C/man4/console_ioctl.4:582
3348 #, no-wrap
3349 msgid "B<VT_SETMODE>"
3350 msgstr ""
3351
3352 #. type: Plain text
3353 #: build/C/man4/console_ioctl.4:588
3354 msgid "Set mode of active vt.  I<argp> points to a I<struct vt_mode>."
3355 msgstr ""
3356
3357 #. type: TP
3358 #: build/C/man4/console_ioctl.4:588
3359 #, no-wrap
3360 msgid "B<VT_GETSTATE>"
3361 msgstr ""
3362
3363 #. type: Plain text
3364 #: build/C/man4/console_ioctl.4:593
3365 msgid "Get global vt state info.  I<argp> points to a"
3366 msgstr ""
3367
3368 #. type: Plain text
3369 #: build/C/man4/console_ioctl.4:601
3370 #, no-wrap
3371 msgid ""
3372 "struct vt_stat {\n"
3373 "    unsigned short v_active;  /* active vt */\n"
3374 "    unsigned short v_signal;  /* signal to send */\n"
3375 "    unsigned short v_state;   /* vt bit mask */\n"
3376 "};\n"
3377 msgstr ""
3378
3379 #. type: Plain text
3380 #: build/C/man4/console_ioctl.4:608
3381 msgid ""
3382 "For each vt in use, the corresponding bit in the I<v_state> member is set.  "
3383 "(Kernels 1.0 through 1.1.92.)"
3384 msgstr ""
3385
3386 #. type: TP
3387 #: build/C/man4/console_ioctl.4:608
3388 #, no-wrap
3389 msgid "B<VT_RELDISP>"
3390 msgstr ""
3391
3392 #. type: Plain text
3393 #: build/C/man4/console_ioctl.4:611
3394 msgid "Release a display."
3395 msgstr ""
3396
3397 #. type: TP
3398 #: build/C/man4/console_ioctl.4:611
3399 #, no-wrap
3400 msgid "B<VT_ACTIVATE>"
3401 msgstr ""
3402
3403 #. type: Plain text
3404 #: build/C/man4/console_ioctl.4:618
3405 msgid "Switch to vt I<argp> (1 E<lt>= I<argp> E<lt>= MAX_NR_CONSOLES)."
3406 msgstr ""
3407
3408 #. type: TP
3409 #: build/C/man4/console_ioctl.4:618
3410 #, no-wrap
3411 msgid "B<VT_WAITACTIVE>"
3412 msgstr ""
3413
3414 #. type: Plain text
3415 #: build/C/man4/console_ioctl.4:623
3416 msgid "Wait until vt I<argp> has been activated."
3417 msgstr ""
3418
3419 #. type: TP
3420 #: build/C/man4/console_ioctl.4:623
3421 #, no-wrap
3422 msgid "B<VT_DISALLOCATE>"
3423 msgstr ""
3424
3425 #. type: Plain text
3426 #: build/C/man4/console_ioctl.4:628
3427 msgid "Deallocate the memory associated with vt I<argp>.  (Since 1.1.54.)"
3428 msgstr ""
3429
3430 #. type: TP
3431 #: build/C/man4/console_ioctl.4:628
3432 #, no-wrap
3433 msgid "B<VT_RESIZE>"
3434 msgstr ""
3435
3436 #. type: Plain text
3437 #: build/C/man4/console_ioctl.4:633
3438 msgid "Set the kernel's idea of screensize.  I<argp> points to a"
3439 msgstr ""
3440
3441 #. type: Plain text
3442 #: build/C/man4/console_ioctl.4:641
3443 #, no-wrap
3444 msgid ""
3445 "struct vt_sizes {\n"
3446 "    unsigned short v_rows;       /* # rows */\n"
3447 "    unsigned short v_cols;       /* # columns */\n"
3448 "    unsigned short v_scrollsize; /* no longer used */\n"
3449 "};\n"
3450 msgstr ""
3451
3452 #. type: Plain text
3453 #: build/C/man4/console_ioctl.4:648
3454 msgid ""
3455 "Note that this does not change the videomode.  See B<resizecons>(8).  (Since "
3456 "1.1.54.)"
3457 msgstr ""
3458
3459 #. type: TP
3460 #: build/C/man4/console_ioctl.4:648
3461 #, no-wrap
3462 msgid "B<VT_RESIZEX>"
3463 msgstr ""
3464
3465 #. type: Plain text
3466 #: build/C/man4/console_ioctl.4:653
3467 msgid "Set the kernel's idea of various screen parameters.  I<argp> points to a"
3468 msgstr ""
3469
3470 #. type: Plain text
3471 #: build/C/man4/console_ioctl.4:668
3472 #, no-wrap
3473 msgid ""
3474 "struct vt_consize {\n"
3475 "    unsigned short v_rows;  /* number of rows */\n"
3476 "    unsigned short v_cols;  /* number of columns */\n"
3477 "    unsigned short v_vlin;  /* number of pixel rows\n"
3478 "                               on screen */\n"
3479 "    unsigned short v_clin;  /* number of pixel rows\n"
3480 "                               per character */\n"
3481 "    unsigned short v_vcol;  /* number of pixel columns\n"
3482 "                               on screen */\n"
3483 "    unsigned short v_ccol;  /* number of pixel columns\n"
3484 "                               per character */\n"
3485 "};\n"
3486 msgstr ""
3487
3488 #. type: Plain text
3489 #: build/C/man4/console_ioctl.4:677
3490 msgid ""
3491 "Any parameter may be set to zero, indicating \"no change\", but if multiple "
3492 "parameters are set, they must be self-consistent.  Note that this does not "
3493 "change the videomode.  See B<resizecons>(8).  (Since 1.3.3.)"
3494 msgstr ""
3495
3496 #. type: Plain text
3497 #: build/C/man4/console_ioctl.4:684
3498 msgid ""
3499 "The action of the following ioctls depends on the first byte in the struct "
3500 "pointed to by I<argp>, referred to here as the I<subcode>.  These are legal "
3501 "only for the superuser or the owner of the current terminal."
3502 msgstr ""
3503
3504 #. type: TP
3505 #: build/C/man4/console_ioctl.4:684
3506 #, no-wrap
3507 msgid "B<TIOCLINUX, subcode=0>"
3508 msgstr ""
3509
3510 #. type: Plain text
3511 #: build/C/man4/console_ioctl.4:692
3512 msgid ""
3513 "Dump the screen.  Disappeared in 1.1.92.  (With kernel 1.1.92 or later, read "
3514 "from I</dev/vcsN> or I</dev/vcsaN> instead.)"
3515 msgstr ""
3516
3517 #. type: TP
3518 #: build/C/man4/console_ioctl.4:692
3519 #, no-wrap
3520 msgid "B<TIOCLINUX, subcode=1>"
3521 msgstr ""
3522
3523 #. type: Plain text
3524 #: build/C/man4/console_ioctl.4:696
3525 msgid "Get task information.  Disappeared in 1.1.92."
3526 msgstr ""
3527
3528 #. type: TP
3529 #: build/C/man4/console_ioctl.4:696
3530 #, no-wrap
3531 msgid "B<TIOCLINUX, subcode=2>"
3532 msgstr ""
3533
3534 #. type: Plain text
3535 #: build/C/man4/console_ioctl.4:701
3536 msgid "Set selection.  I<argp> points to a"
3537 msgstr ""
3538
3539 #. type: Plain text
3540 #: build/C/man4/console_ioctl.4:709
3541 #, no-wrap
3542 msgid ""
3543 "struct {\n"
3544 "   char  subcode;\n"
3545 "   short xs, ys, xe, ye;\n"
3546 "   short sel_mode;\n"
3547 "};\n"
3548 msgstr ""
3549
3550 #. type: Plain text
3551 #: build/C/man4/console_ioctl.4:729
3552 msgid ""
3553 "I<xs> and I<ys> are the starting column and row.  I<xe> and I<ye> are the "
3554 "ending column and row.  (Upper left corner is row=column=1.)  I<sel_mode> is "
3555 "0 for character-by-character selection, 1 for word-by-word selection, or 2 "
3556 "for line-by-line selection.  The indicated screen characters are highlighted "
3557 "and saved in the static array sel_buffer in I<devices/char/console.c>."
3558 msgstr ""
3559
3560 #. type: TP
3561 #: build/C/man4/console_ioctl.4:729
3562 #, no-wrap
3563 msgid "B<TIOCLINUX, subcode=3>"
3564 msgstr ""
3565
3566 #. type: Plain text
3567 #: build/C/man4/console_ioctl.4:735
3568 msgid ""
3569 "Paste selection.  The characters in the selection buffer are written to "
3570 "I<fd>."
3571 msgstr ""
3572
3573 #. type: TP
3574 #: build/C/man4/console_ioctl.4:735
3575 #, no-wrap
3576 msgid "B<TIOCLINUX, subcode=4>"
3577 msgstr ""
3578
3579 #. type: Plain text
3580 #: build/C/man4/console_ioctl.4:738
3581 msgid "Unblank the screen."
3582 msgstr ""
3583
3584 #. type: TP
3585 #: build/C/man4/console_ioctl.4:738
3586 #, no-wrap
3587 msgid "B<TIOCLINUX, subcode=5>"
3588 msgstr ""
3589
3590 #. type: Plain text
3591 #: build/C/man4/console_ioctl.4:743
3592 msgid ""
3593 "Sets contents of a 256-bit look up table defining characters in a \"word\", "
3594 "for word-by-word selection.  (Since 1.1.32.)"
3595 msgstr ""
3596
3597 #. type: TP
3598 #: build/C/man4/console_ioctl.4:743
3599 #, no-wrap
3600 msgid "B<TIOCLINUX, subcode=6>"
3601 msgstr ""
3602
3603 #. type: Plain text
3604 #: build/C/man4/console_ioctl.4:750
3605 msgid ""
3606 "I<argp> points to a char which is set to the value of the kernel variable "
3607 "I<shift_state>.  (Since 1.1.32.)"
3608 msgstr ""
3609
3610 #. type: TP
3611 #: build/C/man4/console_ioctl.4:750
3612 #, no-wrap
3613 msgid "B<TIOCLINUX, subcode=7>"
3614 msgstr ""
3615
3616 #. type: Plain text
3617 #: build/C/man4/console_ioctl.4:757
3618 msgid ""
3619 "I<argp> points to a char which is set to the value of the kernel variable "
3620 "I<report_mouse>.  (Since 1.1.33.)"
3621 msgstr ""
3622
3623 #. type: TP
3624 #: build/C/man4/console_ioctl.4:757
3625 #, no-wrap
3626 msgid "B<TIOCLINUX, subcode=8>"
3627 msgstr ""
3628
3629 #. type: Plain text
3630 #: build/C/man4/console_ioctl.4:765
3631 msgid ""
3632 "Dump screen width and height, cursor position, and all the "
3633 "character-attribute pairs.  (Kernels 1.1.67 through 1.1.91 only.  With "
3634 "kernel 1.1.92 or later, read from I</dev/vcsa*> instead.)"
3635 msgstr ""
3636
3637 #. type: TP
3638 #: build/C/man4/console_ioctl.4:765
3639 #, no-wrap
3640 msgid "B<TIOCLINUX, subcode=9>"
3641 msgstr ""
3642
3643 #. type: Plain text
3644 #: build/C/man4/console_ioctl.4:773
3645 msgid ""
3646 "Restore screen width and height, cursor position, and all the "
3647 "character-attribute pairs.  (Kernels 1.1.67 through 1.1.91 only.  With "
3648 "kernel 1.1.92 or later, write to I</dev/vcsa*> instead.)"
3649 msgstr ""
3650
3651 #. type: TP
3652 #: build/C/man4/console_ioctl.4:773
3653 #, no-wrap
3654 msgid "B<TIOCLINUX, subcode=10>"
3655 msgstr ""
3656
3657 #. type: Plain text
3658 #: build/C/man4/console_ioctl.4:781
3659 msgid ""
3660 "Handles the Power Saving feature of the new generation of monitors.  VESA "
3661 "screen blanking mode is set to I<argp[1]>, which governs what screen "
3662 "blanking does:"
3663 msgstr ""
3664
3665 #. type: IP
3666 #: build/C/man4/console_ioctl.4:782
3667 #, no-wrap
3668 msgid "0:"
3669 msgstr ""
3670
3671 #. type: Plain text
3672 #: build/C/man4/console_ioctl.4:784
3673 msgid "Screen blanking is disabled."
3674 msgstr ""
3675
3676 #. type: IP
3677 #: build/C/man4/console_ioctl.4:784
3678 #, no-wrap
3679 msgid "1:"
3680 msgstr ""
3681
3682 #. type: Plain text
3683 #: build/C/man4/console_ioctl.4:791
3684 msgid ""
3685 "The current video adapter register settings are saved, then the controller "
3686 "is programmed to turn off the vertical synchronization pulses.  This puts "
3687 "the monitor into \"standby\" mode.  If your monitor has an Off_Mode timer, "
3688 "then it will eventually power down by itself."
3689 msgstr ""
3690
3691 #. type: IP
3692 #: build/C/man4/console_ioctl.4:791
3693 #, no-wrap
3694 msgid "2:"
3695 msgstr ""
3696
3697 #. type: Plain text
3698 #: build/C/man4/console_ioctl.4:801
3699 msgid ""
3700 "The current settings are saved, then both the vertical and horizontal "
3701 "synchronization pulses are turned off.  This puts the monitor into \"off\" "
3702 "mode.  If your monitor has no Off_Mode timer, or if you want your monitor to "
3703 "power down immediately when the blank_timer times out, then you choose this "
3704 "option.  (I<Caution:> Powering down frequently will damage the monitor.)  "
3705 "(Since 1.1.76.)"
3706 msgstr ""
3707
3708 #. type: SH
3709 #: build/C/man4/console_ioctl.4:802 build/C/man3/mkfifo.3:61 build/C/man2/mknod.2:101 build/C/man3/setlogmask.3:69 build/C/man4/st.4:827 build/C/man2/syslog.2:244
3710 #, no-wrap
3711 msgid "RETURN VALUE"
3712 msgstr ""
3713
3714 #. type: Plain text
3715 #: build/C/man4/console_ioctl.4:807
3716 msgid "On success, 0 is returned.  On error, -1 is returned, and I<errno> is set."
3717 msgstr ""
3718
3719 #. type: SH
3720 #: build/C/man4/console_ioctl.4:807 build/C/man3/mkfifo.3:67 build/C/man2/mknod.2:106 build/C/man3/setlogmask.3:71 build/C/man2/syslog.2:260
3721 #, no-wrap
3722 msgid "ERRORS"
3723 msgstr ""
3724
3725 #. type: Plain text
3726 #: build/C/man4/console_ioctl.4:810
3727 msgid "I<errno> may take on these values:"
3728 msgstr ""
3729
3730 #. type: TP
3731 #: build/C/man4/console_ioctl.4:810
3732 #, no-wrap
3733 msgid "B<EBADF>"
3734 msgstr ""
3735
3736 #. type: Plain text
3737 #: build/C/man4/console_ioctl.4:813
3738 msgid "The file descriptor is invalid."
3739 msgstr ""
3740
3741 #. type: TP
3742 #: build/C/man4/console_ioctl.4:813
3743 #, no-wrap
3744 msgid "B<ENOTTY>"
3745 msgstr ""
3746
3747 #. type: Plain text
3748 #: build/C/man4/console_ioctl.4:817
3749 msgid ""
3750 "The file descriptor is not associated with a character special device, or "
3751 "the specified request does not apply to it."
3752 msgstr ""
3753
3754 #. type: TP
3755 #: build/C/man4/console_ioctl.4:817 build/C/man2/mknod.2:129 build/C/man4/st.4:842 build/C/man2/syslog.2:261
3756 #, no-wrap
3757 msgid "B<EINVAL>"
3758 msgstr ""
3759
3760 #. type: Plain text
3761 #: build/C/man4/console_ioctl.4:822
3762 msgid "The file descriptor or I<argp> is invalid."
3763 msgstr ""
3764
3765 #. type: TP
3766 #: build/C/man4/console_ioctl.4:822 build/C/man2/mknod.2:159 build/C/man2/syslog.2:285
3767 #, no-wrap
3768 msgid "B<EPERM>"
3769 msgstr ""
3770
3771 #. type: Plain text
3772 #: build/C/man4/console_ioctl.4:825
3773 msgid "Insufficient permission."
3774 msgstr ""
3775
3776 #. type: Plain text
3777 #: build/C/man4/console_ioctl.4:836
3778 msgid ""
3779 "B<Warning>: Do not regard this man page as documentation of the Linux "
3780 "console ioctls.  This is provided for the curious only, as an alternative to "
3781 "reading the source.  Ioctl's are undocumented Linux internals, liable to be "
3782 "changed without warning.  (And indeed, this page more or less describes the "
3783 "situation as of kernel version 1.1.94; there are many minor and not-so-minor "
3784 "differences with earlier versions.)"
3785 msgstr ""
3786
3787 #. type: Plain text
3788 #: build/C/man4/console_ioctl.4:841
3789 msgid ""
3790 "Very often, ioctls are introduced for communication between the kernel and "
3791 "one particular well-known program (fdisk, hdparm, setserial, tunelp, "
3792 "loadkeys, selection, setfont, etc.), and their behavior will be changed when "
3793 "required by this particular program."
3794 msgstr ""
3795
3796 #. type: Plain text
3797 #: build/C/man4/console_ioctl.4:845
3798 msgid ""
3799 "Programs using these ioctls will not be portable to other versions of UNIX, "
3800 "will not work on older versions of Linux, and will not work on future "
3801 "versions of Linux."
3802 msgstr ""
3803
3804 #. type: Plain text
3805 #: build/C/man4/console_ioctl.4:847
3806 msgid "Use POSIX functions."
3807 msgstr ""
3808
3809 #. type: Plain text
3810 #: build/C/man4/console_ioctl.4:871
3811 msgid ""
3812 "B<dumpkeys>(1), B<kbd_mode>(1), B<loadkeys>(1), B<mknod>(1), B<setleds>(1), "
3813 "B<setmetamode>(1), B<execve>(2), B<fcntl>(2), B<ioperm>(2), B<termios>(3), "
3814 "B<console>(4), B<console_codes>(4), B<mt>(4), B<sd>(4), B<tty>(4), "
3815 "B<tty_ioctl>(4), B<ttyS>(4), B<vcs>(4), B<vcsa>(4), B<charsets>(7), "
3816 "B<mapscrn>(8), B<resizecons>(8), B<setfont>(8)"
3817 msgstr ""
3818
3819 #. type: Plain text
3820 #: build/C/man4/console_ioctl.4:874
3821 msgid "I</usr/include/linux/kd.h>, I</usr/include/linux/vt.h>"
3822 msgstr ""
3823
3824 #. type: TH
3825 #: build/C/man5/core.5:25
3826 #, no-wrap
3827 msgid "CORE"
3828 msgstr ""
3829
3830 #. type: TH
3831 #: build/C/man5/core.5:25
3832 #, no-wrap
3833 msgid "2013-06-08"
3834 msgstr ""
3835
3836 #. type: Plain text
3837 #: build/C/man5/core.5:28
3838 msgid "core - core dump file"
3839 msgstr ""
3840
3841 #. type: Plain text
3842 #: build/C/man5/core.5:39
3843 msgid ""
3844 "The default action of certain signals is to cause a process to terminate and "
3845 "produce a I<core dump file>, a disk file containing an image of the "
3846 "process's memory at the time of termination.  This image can be used in a "
3847 "debugger (e.g., B<gdb>(1))  to inspect the state of the program at the time "
3848 "that it terminated.  A list of the signals which cause a process to dump "
3849 "core can be found in B<signal>(7)."
3850 msgstr ""
3851
3852 #. type: Plain text
3853 #: build/C/man5/core.5:46
3854 msgid ""
3855 "A process can set its soft B<RLIMIT_CORE> resource limit to place an upper "
3856 "limit on the size of the core dump file that will be produced if it receives "
3857 "a \"core dump\" signal; see B<getrlimit>(2)  for details."
3858 msgstr ""
3859
3860 #. type: Plain text
3861 #: build/C/man5/core.5:49
3862 msgid "There are various circumstances in which a core dump file is not produced:"
3863 msgstr ""
3864
3865 #. type: Plain text
3866 #: build/C/man5/core.5:61
3867 msgid ""
3868 "The process does not have permission to write the core file.  (By default "
3869 "the core file is called I<core>, and is created in the current working "
3870 "directory.  See below for details on naming.)  Writing the core file will "
3871 "fail if the directory in which it is to be created is nonwritable, or if a "
3872 "file with the same name exists and is not writable or is not a regular file "
3873 "(e.g., it is a directory or a symbolic link)."
3874 msgstr ""
3875
3876 #. type: Plain text
3877 #: build/C/man5/core.5:65
3878 msgid ""
3879 "A (writable, regular) file with the same name as would be used for the core "
3880 "dump already exists, but there is more than one hard link to that file."
3881 msgstr ""
3882
3883 #. type: Plain text
3884 #: build/C/man5/core.5:69
3885 msgid ""
3886 "The file system where the core dump file would be created is full; or has "
3887 "run out of inodes; or is mounted read-only; or the user has reached their "
3888 "quota for the file system."
3889 msgstr ""
3890
3891 #. type: Plain text
3892 #: build/C/man5/core.5:72
3893 msgid "The directory in which the core dump file is to be created does not exist."
3894 msgstr ""
3895
3896 #. type: Plain text
3897 #: build/C/man5/core.5:85
3898 msgid ""
3899 "The B<RLIMIT_CORE> (core file size) or B<RLIMIT_FSIZE> (file size) resource "
3900 "limits for the process are set to zero; see B<getrlimit>(2)  and the "
3901 "documentation of the shell's I<ulimit> command (I<limit> in B<csh>(1))."
3902 msgstr ""
3903
3904 #. type: Plain text
3905 #: build/C/man5/core.5:88
3906 msgid ""
3907 "The binary being executed by the process does not have read permission "
3908 "enabled."
3909 msgstr ""
3910
3911 #.  FIXME . Perhaps relocate discussion of /proc/sys/fs/suid_dumpable
3912 #.  and PR_SET_DUMPABLE to this page?
3913 #. type: Plain text
3914 #: build/C/man5/core.5:101
3915 msgid ""
3916 "The process is executing a set-user-ID (set-group-ID) program that is owned "
3917 "by a user (group) other than the real user (group)  ID of the process.  "
3918 "(However, see the description of the B<prctl>(2)  B<PR_SET_DUMPABLE> "
3919 "operation, and the description of the I</proc/sys/fs/suid_dumpable> file in "
3920 "B<proc>(5).)"
3921 msgstr ""
3922
3923 #.  commit 046d662f481830e652ac34cd112249adde16452a
3924 #. type: Plain text
3925 #: build/C/man5/core.5:107
3926 msgid ""
3927 "(Since Linux 3.7)  The kernel was configured without the B<CONFIG_COREDUMP> "
3928 "option."
3929 msgstr ""
3930
3931 #. type: Plain text
3932 #: build/C/man5/core.5:113
3933 msgid ""
3934 "In addition, a core dump may exclude part of the address space of the "
3935 "process if the B<madvise>(2)  B<MADV_DONTDUMP> flag was employed."
3936 msgstr ""
3937
3938 #. type: SS
3939 #: build/C/man5/core.5:113
3940 #, no-wrap
3941 msgid "Naming of core dump files"
3942 msgstr ""
3943
3944 #. type: Plain text
3945 #: build/C/man5/core.5:122
3946 msgid ""
3947 "By default, a core dump file is named I<core>, but the "
3948 "I</proc/sys/kernel/core_pattern> file (since Linux 2.6 and 2.4.21)  can be "
3949 "set to define a template that is used to name core dump files.  The template "
3950 "can contain % specifiers which are substituted by the following values when "
3951 "a core file is created:"
3952 msgstr ""
3953
3954 #. type: TP
3955 #: build/C/man5/core.5:125
3956 #, no-wrap
3957 msgid "%%"
3958 msgstr ""
3959
3960 #. type: Plain text
3961 #: build/C/man5/core.5:128
3962 msgid "a single % character"
3963 msgstr ""
3964
3965 #. type: TP
3966 #: build/C/man5/core.5:128
3967 #, no-wrap
3968 msgid "%p"
3969 msgstr ""
3970
3971 #. type: Plain text
3972 #: build/C/man5/core.5:131
3973 msgid "PID of dumped process"
3974 msgstr ""
3975
3976 #. type: TP
3977 #: build/C/man5/core.5:131
3978 #, no-wrap
3979 msgid "%u"
3980 msgstr ""
3981
3982 #. type: Plain text
3983 #: build/C/man5/core.5:134
3984 msgid "(numeric) real UID of dumped process"
3985 msgstr ""
3986
3987 #. type: TP
3988 #: build/C/man5/core.5:134
3989 #, no-wrap
3990 msgid "%g"
3991 msgstr ""
3992
3993 #. type: Plain text
3994 #: build/C/man5/core.5:137
3995 msgid "(numeric) real GID of dumped process"
3996 msgstr ""
3997
3998 #. type: TP
3999 #: build/C/man5/core.5:137
4000 #, no-wrap
4001 msgid "%s"
4002 msgstr ""
4003
4004 #. type: Plain text
4005 #: build/C/man5/core.5:140
4006 msgid "number of signal causing dump"
4007 msgstr ""
4008
4009 #. type: TP
4010 #: build/C/man5/core.5:140
4011 #, no-wrap
4012 msgid "%t"
4013 msgstr ""
4014
4015 #. type: Plain text
4016 #: build/C/man5/core.5:144
4017 msgid ""
4018 "time of dump, expressed as seconds since the Epoch, 1970-01-01 00:00:00 "
4019 "+0000 (UTC)"
4020 msgstr ""
4021
4022 #. type: TP
4023 #: build/C/man5/core.5:144
4024 #, no-wrap
4025 msgid "%h"
4026 msgstr ""
4027
4028 #. type: Plain text
4029 #: build/C/man5/core.5:147
4030 msgid "hostname (same as I<nodename> returned by B<uname>(2))"
4031 msgstr ""
4032
4033 #. type: TP
4034 #: build/C/man5/core.5:147
4035 #, no-wrap
4036 msgid "%e"
4037 msgstr ""
4038
4039 #. type: Plain text
4040 #: build/C/man5/core.5:150
4041 msgid "executable filename (without path prefix)"
4042 msgstr ""
4043
4044 #. type: TP
4045 #: build/C/man5/core.5:150
4046 #, no-wrap
4047 msgid "%E"
4048 msgstr ""
4049
4050 #. type: Plain text
4051 #: build/C/man5/core.5:154
4052 msgid ""
4053 "pathname of executable, with slashes (\\(aq/\\(aq) replaced by exclamation "
4054 "marks (\\(aq!\\(aq)."
4055 msgstr ""
4056
4057 #. type: TP
4058 #: build/C/man5/core.5:154
4059 #, no-wrap
4060 msgid "%c"
4061 msgstr ""
4062
4063 #. type: Plain text
4064 #: build/C/man5/core.5:157
4065 msgid "core file size soft resource limit of crashing process (since Linux 2.6.24)"
4066 msgstr ""
4067
4068 #. type: Plain text
4069 #: build/C/man5/core.5:176
4070 msgid ""
4071 "A single % at the end of the template is dropped from the core filename, as "
4072 "is the combination of a % followed by any character other than those listed "
4073 "above.  All other characters in the template become a literal part of the "
4074 "core filename.  The template may include \\(aq/\\(aq characters, which are "
4075 "interpreted as delimiters for directory names.  The maximum size of the "
4076 "resulting core filename is 128 bytes (64 bytes in kernels before 2.6.19).  "
4077 "The default value in this file is \"core\".  For backward compatibility, if "
4078 "I</proc/sys/kernel/core_pattern> does not include \"%p\" and "
4079 "I</proc/sys/kernel/core_uses_pid> (see below)  is nonzero, then .PID will be "
4080 "appended to the core filename."
4081 msgstr ""
4082
4083 #. type: Plain text
4084 #: build/C/man5/core.5:187
4085 msgid ""
4086 "Since version 2.4, Linux has also provided a more primitive method of "
4087 "controlling the name of the core dump file.  If the "
4088 "I</proc/sys/kernel/core_uses_pid> file contains the value 0, then a core "
4089 "dump file is simply named I<core>.  If this file contains a nonzero value, "
4090 "then the core dump file includes the process ID in a name of the form "
4091 "I<core.PID>."
4092 msgstr ""
4093
4094 #.  9520628e8ceb69fa9a4aee6b57f22675d9e1b709
4095 #. type: Plain text
4096 #: build/C/man5/core.5:194
4097 msgid ""
4098 "Since Linux 3.6, if I</proc/sys/fs/suid_dumpable> is set to 2 "
4099 "(\"suidsafe\"), the pattern must be either an absolute pathname (starting "
4100 "with a leading \\(aq/\\(aq character) or a pipe, as defined below."
4101 msgstr ""
4102
4103 #. type: SS
4104 #: build/C/man5/core.5:194
4105 #, no-wrap
4106 msgid "Piping core dumps to a program"
4107 msgstr ""
4108
4109 #. type: Plain text
4110 #: build/C/man5/core.5:204
4111 msgid ""
4112 "Since kernel 2.6.19, Linux supports an alternate syntax for the "
4113 "I</proc/sys/kernel/core_pattern> file.  If the first character of this file "
4114 "is a pipe symbol (B<|>), then the remainder of the line is interpreted as a "
4115 "program to be executed.  Instead of being written to a disk file, the core "
4116 "dump is given as standard input to the program.  Note the following points:"
4117 msgstr ""
4118
4119 #. type: Plain text
4120 #: build/C/man5/core.5:208
4121 msgid ""
4122 "The program must be specified using an absolute pathname (or a pathname "
4123 "relative to the root directory, I</>), and must immediately follow the '|' "
4124 "character."
4125 msgstr ""
4126
4127 #. type: Plain text
4128 #: build/C/man5/core.5:211
4129 msgid "The process created to run the program runs as user and group I<root>."
4130 msgstr ""
4131
4132 #. type: Plain text
4133 #: build/C/man5/core.5:215
4134 msgid ""
4135 "Command-line arguments can be supplied to the program (since Linux 2.6.24), "
4136 "delimited by white space (up to a total line length of 128 bytes)."
4137 msgstr ""
4138
4139 #. type: Plain text
4140 #: build/C/man5/core.5:221
4141 msgid ""
4142 "The command-line arguments can include any of the % specifiers listed "
4143 "above.  For example, to pass the PID of the process that is being dumped, "
4144 "specify I<%p> in an argument."
4145 msgstr ""
4146
4147 #. type: SS
4148 #: build/C/man5/core.5:221
4149 #, no-wrap
4150 msgid "Controlling which mappings are written to the core dump"
4151 msgstr ""
4152
4153 #. type: Plain text
4154 #: build/C/man5/core.5:227
4155 msgid ""
4156 "Since kernel 2.6.23, the Linux-specific I</proc/PID/coredump_filter> file "
4157 "can be used to control which memory segments are written to the core dump "
4158 "file in the event that a core dump is performed for the process with the "
4159 "corresponding process ID."
4160 msgstr ""
4161
4162 #. type: Plain text
4163 #: build/C/man5/core.5:233
4164 msgid ""
4165 "The value in the file is a bit mask of memory mapping types (see "
4166 "B<mmap>(2)).  If a bit is set in the mask, then memory mappings of the "
4167 "corresponding type are dumped; otherwise they are not dumped.  The bits in "
4168 "this file have the following meanings:"
4169 msgstr ""
4170
4171 #. type: TP
4172 #: build/C/man5/core.5:236
4173 #, no-wrap
4174 msgid "bit 0"
4175 msgstr ""
4176
4177 #. type: Plain text
4178 #: build/C/man5/core.5:239
4179 msgid "Dump anonymous private mappings."
4180 msgstr ""
4181
4182 #. type: TP
4183 #: build/C/man5/core.5:239
4184 #, no-wrap
4185 msgid "bit 1"
4186 msgstr ""
4187
4188 #. type: Plain text
4189 #: build/C/man5/core.5:242
4190 msgid "Dump anonymous shared mappings."
4191 msgstr ""
4192
4193 #. type: TP
4194 #: build/C/man5/core.5:242
4195 #, no-wrap
4196 msgid "bit 2"
4197 msgstr ""
4198
4199 #. type: Plain text
4200 #: build/C/man5/core.5:245
4201 msgid "Dump file-backed private mappings."
4202 msgstr ""
4203
4204 #. type: TP
4205 #: build/C/man5/core.5:245
4206 #, no-wrap
4207 msgid "bit 3"
4208 msgstr ""
4209
4210 #.  file-backed shared mappings of course also update the underlying
4211 #.  mapped file.
4212 #. type: Plain text
4213 #: build/C/man5/core.5:250
4214 msgid "Dump file-backed shared mappings."
4215 msgstr ""
4216
4217 #. type: TP
4218 #: build/C/man5/core.5:250
4219 #, no-wrap
4220 msgid "bit 4 (since Linux 2.6.24)"
4221 msgstr ""
4222
4223 #. type: Plain text
4224 #: build/C/man5/core.5:253
4225 msgid "Dump ELF headers."
4226 msgstr ""
4227
4228 #. type: TP
4229 #: build/C/man5/core.5:253
4230 #, no-wrap
4231 msgid "bit 5 (since Linux 2.6.28)"
4232 msgstr ""
4233
4234 #. type: Plain text
4235 #: build/C/man5/core.5:256
4236 msgid "Dump private huge pages."
4237 msgstr ""
4238
4239 #. type: TP
4240 #: build/C/man5/core.5:256
4241 #, no-wrap
4242 msgid "bit 6 (since Linux 2.6.28)"
4243 msgstr ""
4244
4245 #. type: Plain text
4246 #: build/C/man5/core.5:259
4247 msgid "Dump shared huge pages."
4248 msgstr ""
4249
4250 #. type: Plain text
4251 #: build/C/man5/core.5:267
4252 msgid ""
4253 "By default, the following bits are set: 0, 1, 4 (if the "
4254 "B<CONFIG_CORE_DUMP_DEFAULT_ELF_HEADERS> kernel configuration option is "
4255 "enabled), and 5.  The value of this file is displayed in hexadecimal.  (The "
4256 "default value is thus displayed as 33.)"
4257 msgstr ""
4258
4259 #. type: Plain text
4260 #: build/C/man5/core.5:272
4261 msgid ""
4262 "Memory-mapped I/O pages such as frame buffer are never dumped, and virtual "
4263 "DSO pages are always dumped, regardless of the I<coredump_filter> value."
4264 msgstr ""
4265
4266 #. type: Plain text
4267 #: build/C/man5/core.5:282
4268 msgid ""
4269 "A child process created via B<fork>(2)  inherits its parent's "
4270 "I<coredump_filter> value; the I<coredump_filter> value is preserved across "
4271 "an B<execve>(2)."
4272 msgstr ""
4273
4274 #. type: Plain text
4275 #: build/C/man5/core.5:286
4276 msgid ""
4277 "It can be useful to set I<coredump_filter> in the parent shell before "
4278 "running a program, for example:"
4279 msgstr ""
4280
4281 #. type: Plain text
4282 #: build/C/man5/core.5:291
4283 #, no-wrap
4284 msgid ""
4285 "$B< echo 0x7 E<gt> /proc/self/coredump_filter>\n"
4286 "$B< ./some_program>\n"
4287 msgstr ""
4288
4289 #. type: Plain text
4290 #: build/C/man5/core.5:297
4291 msgid ""
4292 "This file is provided only if the kernel was built with the "
4293 "B<CONFIG_ELF_CORE> configuration option."
4294 msgstr ""
4295
4296 #. type: Plain text
4297 #: build/C/man5/core.5:302
4298 msgid ""
4299 "The B<gdb>(1)  I<gcore> command can be used to obtain a core dump of a "
4300 "running process."
4301 msgstr ""
4302
4303 #.  Changed with commit 6409324b385f3f63a03645b4422e3be67348d922
4304 #.  Always including the PID in the name of the core file made
4305 #.  sense for LinuxThreads, where each thread had a unique PID,
4306 #.  but doesn't seem to serve any purpose with NPTL, where all the
4307 #.  threads in a process share the same PID (as POSIX.1 requires).
4308 #.  Probably the behavior is maintained so that applications using
4309 #.  LinuxThreads continue appending the PID (the kernel has no easy
4310 #.  way of telling which threading implementation the user-space
4311 #.  application is using). -- mtk, April 2006
4312 #. type: Plain text
4313 #: build/C/man5/core.5:325
4314 msgid ""
4315 "In Linux versions up to and including 2.6.27, if a multithreaded process "
4316 "(or, more precisely, a process that shares its memory with another process "
4317 "by being created with the B<CLONE_VM> flag of B<clone>(2))  dumps core, then "
4318 "the process ID is always appended to the core filename, unless the process "
4319 "ID was already included elsewhere in the filename via a %p specification in "
4320 "I</proc/sys/kernel/core_pattern>.  (This is primarily useful when employing "
4321 "the obsolete LinuxThreads implementation, where each thread of a process has "
4322 "a different PID.)"
4323 msgstr ""
4324
4325 #. type: SH
4326 #: build/C/man5/core.5:325 build/C/man3/gnu_get_libc_version.3:51 build/C/man3/stdarg.3:291 build/C/man4/vcs.4:101
4327 #, no-wrap
4328 msgid "EXAMPLE"
4329 msgstr ""
4330
4331 #. type: Plain text
4332 #: build/C/man5/core.5:333
4333 msgid ""
4334 "The program below can be used to demonstrate the use of the pipe syntax in "
4335 "the I</proc/sys/kernel/core_pattern> file.  The following shell session "
4336 "demonstrates the use of this program (compiled to create an executable named "
4337 "I<core_pattern_pipe_test>):"
4338 msgstr ""
4339
4340 #. type: Plain text
4341 #: build/C/man5/core.5:354
4342 #, no-wrap
4343 msgid ""
4344 "$B< cc -o core_pattern_pipe_test core_pattern_pipe_test.c>\n"
4345 "$B< su>\n"
4346 "Password:\n"
4347 "#B< echo \"|$PWD/core_pattern_pipe_test %p UID=%u GID=%g sig=%s\" E<gt> "
4348 "\\e>\n"
4349 "B</proc/sys/kernel/core_pattern>\n"
4350 "#B< exit>\n"
4351 "$B< sleep 100>\n"
4352 "B<^\\e>                     # type control-backslash\n"
4353 "Quit (core dumped)\n"
4354 "$B< cat core.info>\n"
4355 "argc=5\n"
4356 "argc[0]=E<lt>/home/mtk/core_pattern_pipe_testE<gt>\n"
4357 "argc[1]=E<lt>20575E<gt>\n"
4358 "argc[2]=E<lt>UID=1000E<gt>\n"
4359 "argc[3]=E<lt>GID=100E<gt>\n"
4360 "argc[4]=E<lt>sig=3E<gt>\n"
4361 "Total bytes in core dump: 282624\n"
4362 msgstr ""
4363
4364 #. type: SS
4365 #: build/C/man5/core.5:356 build/C/man3/gnu_get_libc_version.3:61
4366 #, no-wrap
4367 msgid "Program source"
4368 msgstr ""
4369
4370 #. type: Plain text
4371 #: build/C/man5/core.5:360
4372 #, no-wrap
4373 msgid "/* core_pattern_pipe_test.c */\n"
4374 msgstr ""
4375
4376 #. type: Plain text
4377 #: build/C/man5/core.5:368
4378 #, no-wrap
4379 msgid ""
4380 "#define _GNU_SOURCE\n"
4381 "#include E<lt>sys/stat.hE<gt>\n"
4382 "#include E<lt>fcntl.hE<gt>\n"
4383 "#include E<lt>limits.hE<gt>\n"
4384 "#include E<lt>stdio.hE<gt>\n"
4385 "#include E<lt>stdlib.hE<gt>\n"
4386 "#include E<lt>unistd.hE<gt>\n"
4387 msgstr ""
4388
4389 #. type: Plain text
4390 #: build/C/man5/core.5:370
4391 #, no-wrap
4392 msgid "#define BUF_SIZE 1024\n"
4393 msgstr ""
4394
4395 #. type: Plain text
4396 #: build/C/man5/core.5:379
4397 #, no-wrap
4398 msgid ""
4399 "int\n"
4400 "main(int argc, char *argv[])\n"
4401 "{\n"
4402 "    int tot, j;\n"
4403 "    ssize_t nread;\n"
4404 "    char buf[BUF_SIZE];\n"
4405 "    FILE *fp;\n"
4406 "    char cwd[PATH_MAX];\n"
4407 msgstr ""
4408
4409 #. type: Plain text
4410 #: build/C/man5/core.5:382
4411 #, no-wrap
4412 msgid ""
4413 "    /* Change our current working directory to that of the\n"
4414 "       crashing process */\n"
4415 msgstr ""
4416
4417 #. type: Plain text
4418 #: build/C/man5/core.5:385
4419 #, no-wrap
4420 msgid ""
4421 "    snprintf(cwd, PATH_MAX, \"/proc/%s/cwd\", argv[1]);\n"
4422 "    chdir(cwd);\n"
4423 msgstr ""
4424
4425 #. type: Plain text
4426 #: build/C/man5/core.5:387
4427 #, no-wrap
4428 msgid "    /* Write output to file \"core.info\" in that directory */\n"
4429 msgstr ""
4430
4431 #. type: Plain text
4432 #: build/C/man5/core.5:391
4433 #, no-wrap
4434 msgid ""
4435 "    fp = fopen(\"core.info\", \"w+\");\n"
4436 "    if (fp == NULL)\n"
4437 "        exit(EXIT_FAILURE);\n"
4438 msgstr ""
4439
4440 #. type: Plain text
4441 #: build/C/man5/core.5:394
4442 #, no-wrap
4443 msgid ""
4444 "    /* Display command-line arguments given to core_pattern\n"
4445 "       pipe program */\n"
4446 msgstr ""
4447
4448 #. type: Plain text
4449 #: build/C/man5/core.5:398
4450 #, no-wrap
4451 msgid ""
4452 "    fprintf(fp, \"argc=%d\\en\", argc);\n"
4453 "    for (j = 0; j E<lt> argc; j++)\n"
4454 "        fprintf(fp, \"argc[%d]=E<lt>%sE<gt>\\en\", j, argv[j]);\n"
4455 msgstr ""
4456
4457 #. type: Plain text
4458 #: build/C/man5/core.5:400
4459 #, no-wrap
4460 msgid "    /* Count bytes in standard input (the core dump) */\n"
4461 msgstr ""
4462
4463 #. type: Plain text
4464 #: build/C/man5/core.5:405
4465 #, no-wrap
4466 msgid ""
4467 "    tot = 0;\n"
4468 "    while ((nread = read(STDIN_FILENO, buf, BUF_SIZE)) E<gt> 0)\n"
4469 "        tot += nread;\n"
4470 "    fprintf(fp, \"Total bytes in core dump: %d\\en\", tot);\n"
4471 msgstr ""
4472
4473 #. type: Plain text
4474 #: build/C/man5/core.5:408
4475 #, no-wrap
4476 msgid ""
4477 "    exit(EXIT_SUCCESS);\n"
4478 "}\n"
4479 msgstr ""
4480
4481 #. type: Plain text
4482 #: build/C/man5/core.5:420
4483 msgid ""
4484 "B<bash>(1), B<gdb>(1), B<getrlimit>(2), B<mmap>(2), B<prctl>(2), "
4485 "B<sigaction>(2), B<elf>(5), B<proc>(5), B<pthreads>(7), B<signal>(7)"
4486 msgstr ""
4487
4488 #. type: TH
4489 #: build/C/man4/cpuid.4:26
4490 #, no-wrap
4491 msgid "CPUID"
4492 msgstr ""
4493
4494 #. type: TH
4495 #: build/C/man4/cpuid.4:26 build/C/man4/msr.4:26
4496 #, no-wrap
4497 msgid "2009-03-31"
4498 msgstr ""
4499
4500 #. type: Plain text
4501 #: build/C/man4/cpuid.4:29
4502 msgid "cpuid - x86 CPUID access device"
4503 msgstr ""
4504
4505 #. type: Plain text
4506 #: build/C/man4/cpuid.4:31
4507 msgid "CPUID provides an interface for querying information about the x86 CPU."
4508 msgstr ""
4509
4510 #. type: Plain text
4511 #: build/C/man4/cpuid.4:38
4512 msgid ""
4513 "This device is accessed by B<lseek>(2)  or B<pread>(2)  to the appropriate "
4514 "CPUID level and reading in chunks of 16 bytes.  A larger read size means "
4515 "multiple reads of consecutive levels."
4516 msgstr ""
4517
4518 #. type: Plain text
4519 #: build/C/man4/cpuid.4:47
4520 msgid ""
4521 "The lower 32 bits of the file position is used as the incoming I<%eax>, and "
4522 "the upper 32 bits of the file position as the incoming I<%ecx>, the latter "
4523 "intended for \"counting\" I<eax> levels like I<eax=4>."
4524 msgstr ""
4525
4526 #. type: Plain text
4527 #: build/C/man4/cpuid.4:57
4528 msgid ""
4529 "This driver uses I</dev/cpu/CPUNUM/cpuid>, where I<CPUNUM> is the minor "
4530 "number, and on an SMP box will direct the access to CPU I<CPUNUM> as listed "
4531 "in I</proc/cpuinfo>."
4532 msgstr ""
4533
4534 #. type: Plain text
4535 #: build/C/man4/cpuid.4:62
4536 msgid ""
4537 "This file is protected so that it can be read only by the user I<root>, or "
4538 "members of the group I<root>."
4539 msgstr ""
4540
4541 #. type: Plain text
4542 #: build/C/man4/cpuid.4:67
4543 msgid ""
4544 "The CPUID instruction can be directly executed by a program using inline "
4545 "assembler.  However this device allows convenient access to all CPUs without "
4546 "changing process affinity."
4547 msgstr ""
4548
4549 #. type: Plain text
4550 #: build/C/man4/cpuid.4:76
4551 msgid ""
4552 "Most of the information in I<cpuid> is reported by the kernel in cooked form "
4553 "either in I</proc/cpuinfo> or through subdirectories in "
4554 "I</sys/devices/system/cpu>.  Direct CPUID access through this device should "
4555 "only be used in exceptional cases."
4556 msgstr ""
4557
4558 #. type: Plain text
4559 #: build/C/man4/cpuid.4:82
4560 msgid ""
4561 "The I<cpuid> driver is not auto-loaded.  On modular kernels you might need "
4562 "to use the following command to load it explicitly before use:"
4563 msgstr ""
4564
4565 #. type: Plain text
4566 #: build/C/man4/cpuid.4:84
4567 #, no-wrap
4568 msgid "     $ I<modprobe cpuid>\n"
4569 msgstr ""
4570
4571 #. type: Plain text
4572 #: build/C/man4/cpuid.4:87
4573 msgid ""
4574 "There is no support for CPUID functions that require additional input "
4575 "registers."
4576 msgstr ""
4577
4578 #. type: Plain text
4579 #: build/C/man4/cpuid.4:89
4580 msgid "Very old x86 CPUs don't support CPUID."
4581 msgstr ""
4582
4583 #. type: Plain text
4584 #: build/C/man4/cpuid.4:93
4585 msgid ""
4586 "Intel Corporation, Intel 64 and IA-32 Architectures Software Developer's "
4587 "Manual Volume 2A: Instruction Set Reference, A-M, 3-180 CPUID reference."
4588 msgstr ""
4589
4590 #. type: Plain text
4591 #: build/C/man4/cpuid.4:96
4592 msgid ""
4593 "Intel Corporation, Intel Processor Identification and the CPUID Instruction, "
4594 "Application note 485."
4595 msgstr ""
4596
4597 #. type: TH
4598 #: build/C/man4/dsp56k.4:27
4599 #, no-wrap
4600 msgid "DSP56K"
4601 msgstr ""
4602
4603 #. type: Plain text
4604 #: build/C/man4/dsp56k.4:30
4605 msgid "dsp56k - DSP56001 interface device"
4606 msgstr ""
4607
4608 #. type: Plain text
4609 #: build/C/man4/dsp56k.4:33
4610 #, no-wrap
4611 msgid "#include E<lt>asm/dsp56k.hE<gt>\n"
4612 msgstr ""
4613
4614 #. type: Plain text
4615 #: build/C/man4/dsp56k.4:36
4616 #, no-wrap
4617 msgid ""
4618 "B<ssize_t read(int >I<fd>B<, void *>I<data>B<, size_t >I<length>B<);>\n"
4619 "B<ssize_t write(int >I<fd>B<, void *>I<data>B<, size_t >I<length>B<);>\n"
4620 msgstr ""
4621
4622 #. type: Plain text
4623 #: build/C/man4/dsp56k.4:42
4624 #, no-wrap
4625 msgid ""
4626 "B<int ioctl(int >I<fd>B<, DSP56K_UPLOAD, struct dsp56k_upload "
4627 "*>I<program>B<);>\n"
4628 "B<int ioctl(int >I<fd>B<, DSP56K_SET_TX_WSIZE, int >I<wsize>B<);>\n"
4629 "B<int ioctl(int >I<fd>B<, DSP56K_SET_RX_WSIZE, int >I<wsize>B<);>\n"
4630 "B<int ioctl(int >I<fd>B<, DSP56K_HOST_FLAGS, struct dsp56k_host_flags "
4631 "*>I<flags>B<);>\n"
4632 "B<int ioctl(int >I<fd>B<, DSP56K_HOST_CMD, int >I<cmd>B<);>\n"
4633 msgstr ""
4634
4635 #. type: SH
4636 #: 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
4637 #, no-wrap
4638 msgid "CONFIGURATION"
4639 msgstr ""
4640
4641 #. type: Plain text
4642 #: build/C/man4/dsp56k.4:46
4643 msgid ""
4644 "The dsp56k device is a character device with major number 55 and minor "
4645 "number 0."
4646 msgstr ""
4647
4648 #. type: Plain text
4649 #: build/C/man4/dsp56k.4:52
4650 msgid ""
4651 "The Motorola DSP56001 is a fully programmable 24-bit digital signal "
4652 "processor found in Atari Falcon030-compatible computers.  The I<dsp56k> "
4653 "special file is used to control the DSP56001, and to send and receive data "
4654 "using the bidirectional handshaked host port."
4655 msgstr ""
4656
4657 #. type: Plain text
4658 #: build/C/man4/dsp56k.4:62
4659 msgid ""
4660 "To send a data stream to the signal processor, use B<write>(2)  to the "
4661 "device, and B<read>(2)  to receive processed data.  The data can be sent or "
4662 "received in 8, 16, 24, or 32-bit quantities on the host side, but will "
4663 "always be seen as 24-bit quantities in the DSP56001."
4664 msgstr ""
4665
4666 #. type: Plain text
4667 #: build/C/man4/dsp56k.4:67
4668 msgid "The following B<ioctl>(2)  calls are used to control the I<dsp56k> device:"
4669 msgstr ""
4670
4671 #. type: IP
4672 #: build/C/man4/dsp56k.4:67
4673 #, no-wrap
4674 msgid "B<DSP56K_UPLOAD>"
4675 msgstr ""
4676
4677 #. type: Plain text
4678 #: build/C/man4/dsp56k.4:74
4679 msgid ""
4680 "resets the DSP56001 and uploads a program.  The third B<ioctl>(2)  argument "
4681 "must be a pointer to a I<struct dsp56k_binary> with members I<bin> pointing "
4682 "to a DSP56001 binary program, and I<len> set to the length of the program, "
4683 "counted in 24-bit words."
4684 msgstr ""
4685
4686 #. type: IP
4687 #: build/C/man4/dsp56k.4:74
4688 #, no-wrap
4689 msgid "B<DSP56K_SET_TX_WSIZE>"
4690 msgstr ""
4691
4692 #. type: Plain text
4693 #: build/C/man4/dsp56k.4:82
4694 msgid ""
4695 "sets the transmit word size.  Allowed values are in the range 1 to 4, and is "
4696 "the number of bytes that will be sent at a time to the DSP56001.  These data "
4697 "quantities will either be padded with zero bytes, or truncated to fit the "
4698 "native 24-bit data format of the DSP56001."
4699 msgstr ""
4700
4701 #. type: IP
4702 #: build/C/man4/dsp56k.4:82
4703 #, no-wrap
4704 msgid "B<DSP56K_SET_RX_WSIZE>"
4705 msgstr ""
4706
4707 #. type: Plain text
4708 #: build/C/man4/dsp56k.4:89
4709 msgid ""
4710 "sets the receive word size.  Allowed values are in the range 1 to 4, and is "
4711 "the number of bytes that will be received at a time from the DSP56001.  "
4712 "These data quantities will either truncated, or padded with a null byte "
4713 "(\\(aq\\e0\\(aq) to fit the native 24-bit data format of the DSP56001."
4714 msgstr ""
4715
4716 #. type: IP
4717 #: build/C/man4/dsp56k.4:89
4718 #, no-wrap
4719 msgid "B<DSP56K_HOST_FLAGS>"
4720 msgstr ""
4721
4722 #. type: Plain text
4723 #: build/C/man4/dsp56k.4:96
4724 msgid ""
4725 "read and write the host flags.  The host flags are four general-purpose bits "
4726 "that can be read by both the hosting computer and the DSP56001.  Bits 0 and "
4727 "1 can be written by the host, and bits 2 and 3 can be written by the "
4728 "DSP56001."
4729 msgstr ""
4730
4731 #. type: Plain text
4732 #: build/C/man4/dsp56k.4:106
4733 msgid ""
4734 "To access the host flags, the third B<ioctl>(2)  argument must be a pointer "
4735 "to a I<struct dsp56k_host_flags>.  If bit 0 or 1 is set in the I<dir> "
4736 "member, the corresponding bit in I<out> will be written to the host flags.  "
4737 "The state of all host flags will be returned in the lower four bits of the "
4738 "I<status> member."
4739 msgstr ""
4740
4741 #. type: IP
4742 #: build/C/man4/dsp56k.4:106
4743 #, no-wrap
4744 msgid "B<DSP56K_HOST_CMD>"
4745 msgstr ""
4746
4747 #. type: Plain text
4748 #: build/C/man4/dsp56k.4:110
4749 msgid ""
4750 "sends a host command.  Allowed values are in the range 0 to 31, and is a "
4751 "user-defined command handled by the program running in the DSP56001."
4752 msgstr ""
4753
4754 #.  .SH AUTHORS
4755 #.  Fredrik Noring <noring@nocrew.org>, lars brinkhoff <lars@nocrew.org>,
4756 #.  Tomas Berndtsson <tomas@nocrew.org>.
4757 #. type: Plain text
4758 #: build/C/man4/dsp56k.4:115
4759 msgid "/dev/dsp56k"
4760 msgstr ""
4761
4762 #. type: Plain text
4763 #: build/C/man4/dsp56k.4:121
4764 msgid ""
4765 "I<linux/include/asm-m68k/dsp56k.h>, I<linux/drivers/char/dsp56k.c>, E<.UR "
4766 "http://dsp56k.nocrew.org/> E<.UE ,> DSP56000/DSP56001 Digital Signal "
4767 "Processor User's Manual"
4768 msgstr ""
4769
4770 #. type: TH
4771 #: build/C/man4/fd.4:28
4772 #, no-wrap
4773 msgid "FD"
4774 msgstr ""
4775
4776 #. type: TH
4777 #: build/C/man4/fd.4:28
4778 #, no-wrap
4779 msgid "2010-08-29"
4780 msgstr ""
4781
4782 #. type: Plain text
4783 #: build/C/man4/fd.4:31
4784 msgid "fd - floppy disk device"
4785 msgstr ""
4786
4787 #. type: Plain text
4788 #: build/C/man4/fd.4:48
4789 msgid ""
4790 "Floppy drives are block devices with major number 2.  Typically they are "
4791 "owned by I<root.floppy> (i.e., user root, group floppy) and have either mode "
4792 "0660 (access checking via group membership) or mode 0666 (everybody has "
4793 "access).  The minor numbers encode the device type, drive number, and "
4794 "controller number.  For each device type (that is, combination of density "
4795 "and track count)  there is a base minor number.  To this base number, add "
4796 "the drive's number on its controller and 128 if the drive is on the "
4797 "secondary controller.  In the following device tables, I<n> represents the "
4798 "drive number."
4799 msgstr ""
4800
4801 #. type: Plain text
4802 #: build/C/man4/fd.4:55
4803 msgid ""
4804 "B<Warning: If you use formats with more tracks than supported by your drive, "
4805 "you may cause it mechanical damage.> Trying once if more tracks than the "
4806 "usual 40/80 are supported should not damage it, but no warranty is given for "
4807 "that.  If you are not sure, don't create device entries for those formats, "
4808 "so as to prevent their usage."
4809 msgstr ""
4810
4811 #. type: Plain text
4812 #: build/C/man4/fd.4:58
4813 msgid ""
4814 "Drive-independent device files which automatically detect the media format "
4815 "and capacity:"
4816 msgstr ""
4817
4818 #. type: tbl table
4819 #: build/C/man4/fd.4:60
4820 #, no-wrap
4821 msgid "Name\tBase minor #\n"
4822 msgstr ""
4823
4824 #. type: tbl table
4825 #: build/C/man4/fd.4:61 build/C/man4/fd.4:69 build/C/man4/fd.4:77 build/C/man4/fd.4:93 build/C/man4/fd.4:105 build/C/man4/fd.4:124
4826 #, no-wrap
4827 msgid "_\n"
4828 msgstr ""
4829
4830 #. type: tbl table
4831 #: build/C/man4/fd.4:62
4832 #, no-wrap
4833 msgid "B<fd>I<n>\t0\n"
4834 msgstr ""
4835
4836 #. type: Plain text
4837 #: build/C/man4/fd.4:66
4838 msgid "5.25 inch double density device files:"
4839 msgstr ""
4840
4841 #. type: tbl table
4842 #: build/C/man4/fd.4:68 build/C/man4/fd.4:76 build/C/man4/fd.4:92 build/C/man4/fd.4:104 build/C/man4/fd.4:123
4843 #, no-wrap
4844 msgid "Name\tCapac.\tCyl.\tSect.\tHeads\tBase minor #\n"
4845 msgstr ""
4846
4847 #. type: tbl table
4848 #: build/C/man4/fd.4:70
4849 #, no-wrap
4850 msgid "B<fd>I<n>B<d360>\t360K\t40\t9\t2\t4\n"
4851 msgstr ""
4852
4853 #. type: Plain text
4854 #: build/C/man4/fd.4:74
4855 msgid "5.25 inch high density device files:"
4856 msgstr ""
4857
4858 #. type: tbl table
4859 #: build/C/man4/fd.4:78
4860 #, no-wrap
4861 msgid "B<fd>I<n>B<h360>\t360K\t40\t9\t2\t20\n"
4862 msgstr ""
4863
4864 #. type: tbl table
4865 #: build/C/man4/fd.4:79
4866 #, no-wrap
4867 msgid "B<fd>I<n>B<h410>\t410K\t41\t10\t2\t48\n"
4868 msgstr ""
4869
4870 #. type: tbl table
4871 #: build/C/man4/fd.4:80
4872 #, no-wrap
4873 msgid "B<fd>I<n>B<h420>\t420K\t42\t10\t2\t64\n"
4874 msgstr ""
4875
4876 #. type: tbl table
4877 #: build/C/man4/fd.4:81
4878 #, no-wrap
4879 msgid "B<fd>I<n>B<h720>\t720K\t80\t9\t2\t24\n"
4880 msgstr ""
4881
4882 #. type: tbl table
4883 #: build/C/man4/fd.4:82
4884 #, no-wrap
4885 msgid "B<fd>I<n>B<h880>\t880K\t80\t11\t2\t80\n"
4886 msgstr ""
4887
4888 #. type: tbl table
4889 #: build/C/man4/fd.4:83
4890 #, no-wrap
4891 msgid "B<fd>I<n>B<h1200>\t1200K\t80\t15\t2\t8\n"
4892 msgstr ""
4893
4894 #. type: tbl table
4895 #: build/C/man4/fd.4:84
4896 #, no-wrap
4897 msgid "B<fd>I<n>B<h1440>\t1440K\t80\t18\t2\t40\n"
4898 msgstr ""
4899
4900 #. type: tbl table
4901 #: build/C/man4/fd.4:85
4902 #, no-wrap
4903 msgid "B<fd>I<n>B<h1476>\t1476K\t82\t18\t2\t56\n"
4904 msgstr ""
4905
4906 #. type: tbl table
4907 #: build/C/man4/fd.4:86
4908 #, no-wrap
4909 msgid "B<fd>I<n>B<h1494>\t1494K\t83\t18\t2\t72\n"
4910 msgstr ""
4911
4912 #. type: tbl table
4913 #: build/C/man4/fd.4:87
4914 #, no-wrap
4915 msgid "B<fd>I<n>B<h1600>\t1600K\t80\t20\t2\t92\n"
4916 msgstr ""
4917
4918 #. type: Plain text
4919 #: build/C/man4/fd.4:90
4920 msgid "3.5 inch double density device files:"
4921 msgstr ""
4922
4923 #. type: tbl table
4924 #: build/C/man4/fd.4:94
4925 #, no-wrap
4926 msgid "B<fd>I<n>B<D360>\t360K\t80\t9\t1\t12\n"
4927 msgstr ""
4928
4929 #. type: tbl table
4930 #: build/C/man4/fd.4:95
4931 #, no-wrap
4932 msgid "B<fd>I<n>B<D720>\t720K\t80\t9\t2\t16\n"
4933 msgstr ""
4934
4935 #. type: tbl table
4936 #: build/C/man4/fd.4:96
4937 #, no-wrap
4938 msgid "B<fd>I<n>B<D800>\t800K\t80\t10\t2\t120\n"
4939 msgstr ""
4940
4941 #. type: tbl table
4942 #: build/C/man4/fd.4:97
4943 #, no-wrap
4944 msgid "B<fd>I<n>B<D1040>\t1040K\t80\t13\t2\t84\n"
4945 msgstr ""
4946
4947 #. type: tbl table
4948 #: build/C/man4/fd.4:98
4949 #, no-wrap
4950 msgid "B<fd>I<n>B<D1120>\t1120K\t80\t14\t2\t88\n"
4951 msgstr ""
4952
4953 #. type: Plain text
4954 #: build/C/man4/fd.4:102
4955 msgid "3.5 inch high density device files:"
4956 msgstr ""
4957
4958 #. type: tbl table
4959 #: build/C/man4/fd.4:106
4960 #, no-wrap
4961 msgid "B<fd>I<n>B<H360>\t360K\t40\t9\t2\t12\n"
4962 msgstr ""
4963
4964 #. type: tbl table
4965 #: build/C/man4/fd.4:107
4966 #, no-wrap
4967 msgid "B<fd>I<n>B<H720>\t720K\t80\t9\t2\t16\n"
4968 msgstr ""
4969
4970 #. type: tbl table
4971 #: build/C/man4/fd.4:108
4972 #, no-wrap
4973 msgid "B<fd>I<n>B<H820>\t820K\t82\t10\t2\t52\n"
4974 msgstr ""
4975
4976 #. type: tbl table
4977 #: build/C/man4/fd.4:109
4978 #, no-wrap
4979 msgid "B<fd>I<n>B<H830>\t830K\t83\t10\t2\t68\n"
4980 msgstr ""
4981
4982 #. type: tbl table
4983 #: build/C/man4/fd.4:110
4984 #, no-wrap
4985 msgid "B<fd>I<n>B<H1440>\t1440K\t80\t18\t2\t28\n"
4986 msgstr ""
4987
4988 #. type: tbl table
4989 #: build/C/man4/fd.4:111
4990 #, no-wrap
4991 msgid "B<fd>I<n>B<H1600>\t1600K\t80\t20\t2\t124\n"
4992 msgstr ""
4993
4994 #. type: tbl table
4995 #: build/C/man4/fd.4:112
4996 #, no-wrap
4997 msgid "B<fd>I<n>B<H1680>\t1680K\t80\t21\t2\t44\n"
4998 msgstr ""
4999
5000 #. type: tbl table
5001 #: build/C/man4/fd.4:113
5002 #, no-wrap
5003 msgid "B<fd>I<n>B<H1722>\t1722K\t82\t21\t2\t60\n"
5004 msgstr ""
5005
5006 #. type: tbl table
5007 #: build/C/man4/fd.4:114
5008 #, no-wrap
5009 msgid "B<fd>I<n>B<H1743>\t1743K\t83\t21\t2\t76\n"
5010 msgstr ""
5011
5012 #. type: tbl table
5013 #: build/C/man4/fd.4:115
5014 #, no-wrap
5015 msgid "B<fd>I<n>B<H1760>\t1760K\t80\t22\t2\t96\n"
5016 msgstr ""
5017
5018 #. type: tbl table
5019 #: build/C/man4/fd.4:116
5020 #, no-wrap
5021 msgid "B<fd>I<n>B<H1840>\t1840K\t80\t23\t2\t116\n"
5022 msgstr ""
5023
5024 #. type: tbl table
5025 #: build/C/man4/fd.4:117
5026 #, no-wrap
5027 msgid "B<fd>I<n>B<H1920>\t1920K\t80\t24\t2\t100\n"
5028 msgstr ""
5029
5030 #. type: Plain text
5031 #: build/C/man4/fd.4:121
5032 msgid "3.5 inch extra density device files:"
5033 msgstr ""
5034
5035 #. type: tbl table
5036 #: build/C/man4/fd.4:125
5037 #, no-wrap
5038 msgid "B<fd>I<n>B<E2880>\t2880K\t80\t36\t2\t32\n"
5039 msgstr ""
5040
5041 #. type: tbl table
5042 #: build/C/man4/fd.4:126
5043 #, no-wrap
5044 msgid "B<fd>I<n>B<CompaQ>\t2880K\t80\t36\t2\t36\n"
5045 msgstr ""
5046
5047 #. type: tbl table
5048 #: build/C/man4/fd.4:127
5049 #, no-wrap
5050 msgid "B<fd>I<n>B<E3200>\t3200K\t80\t40\t2\t104\n"
5051 msgstr ""
5052
5053 #. type: tbl table
5054 #: build/C/man4/fd.4:128
5055 #, no-wrap
5056 msgid "B<fd>I<n>B<E3520>\t3520K\t80\t44\t2\t108\n"
5057 msgstr ""
5058
5059 #. type: tbl table
5060 #: build/C/man4/fd.4:129
5061 #, no-wrap
5062 msgid "B<fd>I<n>B<E3840>\t3840K\t80\t48\t2\t112\n"
5063 msgstr ""
5064
5065 #. type: Plain text
5066 #: build/C/man4/fd.4:136
5067 msgid ""
5068 "B<fd> special files access the floppy disk drives in raw mode.  The "
5069 "following B<ioctl>(2)  calls are supported by B<fd> devices:"
5070 msgstr ""
5071
5072 #. type: IP
5073 #: build/C/man4/fd.4:136
5074 #, no-wrap
5075 msgid "B<FDCLRPRM>"
5076 msgstr ""
5077
5078 #. type: Plain text
5079 #: build/C/man4/fd.4:138
5080 msgid "clears the media information of a drive (geometry of disk in drive)."
5081 msgstr ""
5082
5083 #. type: IP
5084 #: build/C/man4/fd.4:138
5085 #, no-wrap
5086 msgid "B<FDSETPRM>"
5087 msgstr ""
5088
5089 #. type: Plain text
5090 #: build/C/man4/fd.4:142
5091 msgid ""
5092 "sets the media information of a drive.  The media information will be lost "
5093 "when the media is changed."
5094 msgstr ""
5095
5096 #. type: IP
5097 #: build/C/man4/fd.4:142
5098 #, no-wrap
5099 msgid "B<FDDEFPRM>"
5100 msgstr ""
5101
5102 #. type: Plain text
5103 #: build/C/man4/fd.4:148
5104 msgid ""
5105 "sets the media information of a drive (geometry of disk in drive).  The "
5106 "media information will not be lost when the media is changed.  This will "
5107 "disable autodetection.  In order to reenable autodetection, you have to "
5108 "issue an B<FDCLRPRM>."
5109 msgstr ""
5110
5111 #. type: IP
5112 #: build/C/man4/fd.4:148 build/C/man4/fd.4:160
5113 #, no-wrap
5114 msgid "B<FDGETDRVTYP>"
5115 msgstr ""
5116
5117 #. type: Plain text
5118 #: build/C/man4/fd.4:153
5119 msgid ""
5120 "returns the type of a drive (name parameter).  For formats which work in "
5121 "several drive types, B<FDGETDRVTYP> returns a name which is appropriate for "
5122 "the oldest drive type which supports this format."
5123 msgstr ""
5124
5125 #. type: IP
5126 #: build/C/man4/fd.4:153
5127 #, no-wrap
5128 msgid "B<FDFLUSH>"
5129 msgstr ""
5130
5131 #. type: Plain text
5132 #: build/C/man4/fd.4:155
5133 msgid "invalidates the buffer cache for the given drive."
5134 msgstr ""
5135
5136 #. type: IP
5137 #: build/C/man4/fd.4:155 build/C/man4/fd.4:158
5138 #, no-wrap
5139 msgid "B<FDSETMAXERRS>"
5140 msgstr ""
5141
5142 #. type: Plain text
5143 #: build/C/man4/fd.4:158
5144 msgid ""
5145 "sets the error thresholds for reporting errors, aborting the operation, "
5146 "recalibrating, resetting, and reading sector by sector."
5147 msgstr ""
5148
5149 #. type: Plain text
5150 #: build/C/man4/fd.4:160
5151 msgid "gets the current error thresholds."
5152 msgstr ""
5153
5154 #. type: Plain text
5155 #: build/C/man4/fd.4:162
5156 msgid "gets the internal name of the drive."
5157 msgstr ""
5158
5159 #. type: IP
5160 #: build/C/man4/fd.4:162
5161 #, no-wrap
5162 msgid "B<FDWERRORCLR>"
5163 msgstr ""
5164
5165 #. type: Plain text
5166 #: build/C/man4/fd.4:164
5167 msgid "clears the write error statistics."
5168 msgstr ""
5169
5170 #. type: IP
5171 #: build/C/man4/fd.4:164
5172 #, no-wrap
5173 msgid "B<FDWERRORGET>"
5174 msgstr ""
5175
5176 #. type: Plain text
5177 #: build/C/man4/fd.4:171
5178 msgid ""
5179 "reads the write error statistics.  These include the total number of write "
5180 "errors, the location and disk of the first write error, and the location and "
5181 "disk of the last write error.  Disks are identified by a generation number "
5182 "which is incremented at (almost) each disk change."
5183 msgstr ""
5184
5185 #. type: IP
5186 #: build/C/man4/fd.4:171
5187 #, no-wrap
5188 msgid "B<FDTWADDLE>"
5189 msgstr ""
5190
5191 #. type: Plain text
5192 #: build/C/man4/fd.4:175
5193 msgid ""
5194 "Switch the drive motor off for a few microseconds.  This might be needed in "
5195 "order to access a disk whose sectors are too close together."
5196 msgstr ""
5197
5198 #. type: IP
5199 #: build/C/man4/fd.4:175
5200 #, no-wrap
5201 msgid "B<FDSETDRVPRM>"
5202 msgstr ""
5203
5204 #. type: Plain text
5205 #: build/C/man4/fd.4:177
5206 msgid "sets various drive parameters."
5207 msgstr ""
5208
5209 #. type: IP
5210 #: build/C/man4/fd.4:177
5211 #, no-wrap
5212 msgid "B<FDGETDRVPRM>"
5213 msgstr ""
5214
5215 #. type: Plain text
5216 #: build/C/man4/fd.4:179
5217 msgid "reads these parameters back."
5218 msgstr ""
5219
5220 #. type: IP
5221 #: build/C/man4/fd.4:179
5222 #, no-wrap
5223 msgid "B<FDGETDRVSTAT>"
5224 msgstr ""
5225
5226 #. type: Plain text
5227 #: build/C/man4/fd.4:181
5228 msgid "gets the cached drive state (disk changed, write protected et al.)"
5229 msgstr ""
5230
5231 #. type: IP
5232 #: build/C/man4/fd.4:181
5233 #, no-wrap
5234 msgid "B<FDPOLLDRVSTAT>"
5235 msgstr ""
5236
5237 #. type: Plain text
5238 #: build/C/man4/fd.4:183
5239 msgid "polls the drive and return its state."
5240 msgstr ""
5241
5242 #. type: IP
5243 #: build/C/man4/fd.4:183
5244 #, no-wrap
5245 msgid "B<FDGETFDCSTAT>"
5246 msgstr ""
5247
5248 #. type: Plain text
5249 #: build/C/man4/fd.4:185
5250 msgid "gets the floppy controller state."
5251 msgstr ""
5252
5253 #. type: IP
5254 #: build/C/man4/fd.4:185
5255 #, no-wrap
5256 msgid "B<FDRESET>"
5257 msgstr ""
5258
5259 #. type: Plain text
5260 #: build/C/man4/fd.4:187
5261 msgid "resets the floppy controller under certain conditions."
5262 msgstr ""
5263
5264 #. type: IP
5265 #: build/C/man4/fd.4:187
5266 #, no-wrap
5267 msgid "B<FDRAWCMD>"
5268 msgstr ""
5269
5270 #. type: Plain text
5271 #: build/C/man4/fd.4:189
5272 msgid "sends a raw command to the floppy controller."
5273 msgstr ""
5274
5275 #. type: Plain text
5276 #: build/C/man4/fd.4:194
5277 msgid ""
5278 "For more precise information, consult also the I<E<lt>linux/fd.hE<gt>> and "
5279 "I<E<lt>linux/fdreg.hE<gt>> include files, as well as the B<floppycontrol>(1)  "
5280 "manual page."
5281 msgstr ""
5282
5283 #. type: Plain text
5284 #: build/C/man4/fd.4:196
5285 msgid "/dev/fd*"
5286 msgstr ""
5287
5288 #. type: Plain text
5289 #: build/C/man4/fd.4:202
5290 msgid ""
5291 "The various formats permit reading and writing many types of disks.  "
5292 "However, if a floppy is formatted with an inter-sector gap that is too "
5293 "small, performance may drop, to the point of needing a few seconds to access "
5294 "an entire track.  To prevent this, use interleaved formats."
5295 msgstr ""
5296
5297 #. type: Plain text
5298 #: build/C/man4/fd.4:206
5299 msgid ""
5300 "It is not possible to read floppies which are formatted using GCR (group "
5301 "code recording), which is used by Apple II and Macintosh computers (800k "
5302 "disks)."
5303 msgstr ""
5304
5305 #.  .SH AUTHORS
5306 #.  Alain Knaff (Alain.Knaff@imag.fr), David Niemi
5307 #.  (niemidc@clark.net), Bill Broadhurst (bbroad@netcom.com).
5308 #. type: Plain text
5309 #: build/C/man4/fd.4:213
5310 msgid ""
5311 "Reading floppies which are hard sectored (one hole per sector, with the "
5312 "index hole being a little skewed) is not supported.  This used to be common "
5313 "with older 8-inch floppies."
5314 msgstr ""
5315
5316 #. type: Plain text
5317 #: build/C/man4/fd.4:221
5318 msgid ""
5319 "B<chown>(1), B<floppycontrol>(1), B<getfdprm>(1), B<mknod>(1), "
5320 "B<superformat>(1), B<mount>(8), B<setfdprm>(8)"
5321 msgstr ""
5322
5323 #. type: TH
5324 #: build/C/man7/fifo.7:13
5325 #, no-wrap
5326 msgid "FIFO"
5327 msgstr ""
5328
5329 #. type: TH
5330 #: build/C/man7/fifo.7:13
5331 #, no-wrap
5332 msgid "2008-12-03"
5333 msgstr ""
5334
5335 #. type: Plain text
5336 #: build/C/man7/fifo.7:16
5337 msgid "fifo - first-in first-out special file, named pipe"
5338 msgstr ""
5339
5340 #. type: Plain text
5341 #: build/C/man7/fifo.7:28
5342 msgid ""
5343 "A FIFO special file (a named pipe) is similar to a pipe, except that it is "
5344 "accessed as part of the file system.  It can be opened by multiple processes "
5345 "for reading or writing.  When processes are exchanging data via the FIFO, "
5346 "the kernel passes all data internally without writing it to the file "
5347 "system.  Thus, the FIFO special file has no contents on the file system; the "
5348 "file system entry merely serves as a reference point so that processes can "
5349 "access the pipe using a name in the file system."
5350 msgstr ""
5351
5352 #. type: Plain text
5353 #: build/C/man7/fifo.7:35
5354 msgid ""
5355 "The kernel maintains exactly one pipe object for each FIFO special file that "
5356 "is opened by at least one process.  The FIFO must be opened on both ends "
5357 "(reading and writing)  before data can be passed.  Normally, opening the "
5358 "FIFO blocks until the other end is opened also."
5359 msgstr ""
5360
5361 #. type: Plain text
5362 #: build/C/man7/fifo.7:44
5363 msgid ""
5364 "A process can open a FIFO in nonblocking mode.  In this case, opening for "
5365 "read-only will succeed even if no-one has opened on the write side yet, "
5366 "opening for write-only will fail with B<ENXIO> (no such device or address) "
5367 "unless the other end has already been opened."
5368 msgstr ""
5369
5370 #. type: Plain text
5371 #: build/C/man7/fifo.7:54
5372 msgid ""
5373 "Under Linux, opening a FIFO for read and write will succeed both in blocking "
5374 "and nonblocking mode.  POSIX leaves this behavior undefined.  This can be "
5375 "used to open a FIFO for writing while there are no readers available.  A "
5376 "process that uses both ends of the connection in order to communicate with "
5377 "itself should be very careful to avoid deadlocks."
5378 msgstr ""
5379
5380 #. type: Plain text
5381 #: build/C/man7/fifo.7:59
5382 msgid ""
5383 "When a process tries to write to a FIFO that is not opened for read on the "
5384 "other side, the process is sent a B<SIGPIPE> signal."
5385 msgstr ""
5386
5387 #. type: Plain text
5388 #: build/C/man7/fifo.7:65
5389 msgid ""
5390 "FIFO special files can be created by B<mkfifo>(3), and are indicated by I<ls "
5391 "-l> with the file type \\(aqp\\(aq."
5392 msgstr ""
5393
5394 #. type: Plain text
5395 #: build/C/man7/fifo.7:74
5396 msgid ""
5397 "B<mkfifo>(1), B<open>(2), B<pipe>(2), B<sigaction>(2), B<signal>(2), "
5398 "B<socketpair>(2), B<mkfifo>(3), B<pipe>(7)"
5399 msgstr ""
5400
5401 #. type: TH
5402 #: build/C/man4/full.4:26
5403 #, no-wrap
5404 msgid "FULL"
5405 msgstr ""
5406
5407 #. type: TH
5408 #: build/C/man4/full.4:26
5409 #, no-wrap
5410 msgid "2007-11-24"
5411 msgstr ""
5412
5413 #. type: Plain text
5414 #: build/C/man4/full.4:29
5415 msgid "full - always full device"
5416 msgstr ""
5417
5418 #. type: Plain text
5419 #: build/C/man4/full.4:34
5420 msgid ""
5421 "If your system does not have I</dev/full> created already, it can be created "
5422 "with the following commands:"
5423 msgstr ""
5424
5425 #. type: Plain text
5426 #: build/C/man4/full.4:38
5427 #, no-wrap
5428 msgid ""
5429 "        mknod -m 666 /dev/full c 1 7\n"
5430 "        chown root:root /dev/full\n"
5431 msgstr ""
5432
5433 #. type: Plain text
5434 #: build/C/man4/full.4:44
5435 msgid "File I</dev/full> has major device number 1 and minor device number 7."
5436 msgstr ""
5437
5438 #. type: Plain text
5439 #: build/C/man4/full.4:51
5440 msgid ""
5441 "Writes to the I</dev/full> device will fail with an B<ENOSPC> error.  This "
5442 "can be used to test how a program handles disk-full errors."
5443 msgstr ""
5444
5445 #. type: Plain text
5446 #: build/C/man4/full.4:55
5447 msgid "Reads from the I</dev/full> device will return \\e0 characters."
5448 msgstr ""
5449
5450 #. type: Plain text
5451 #: build/C/man4/full.4:59
5452 msgid "Seeks on I</dev/full> will always succeed."
5453 msgstr ""
5454
5455 #. type: Plain text
5456 #: build/C/man4/full.4:61
5457 msgid "/dev/full"
5458 msgstr ""
5459
5460 #. type: Plain text
5461 #: build/C/man4/full.4:65
5462 msgid "B<mknod>(1), B<null>(4), B<zero>(4)"
5463 msgstr ""
5464
5465 #. type: TH
5466 #: build/C/man3/gnu_get_libc_version.3:26
5467 #, no-wrap
5468 msgid "GNU_GET_LIBC_VERSION"
5469 msgstr ""
5470
5471 #. type: TH
5472 #: build/C/man3/gnu_get_libc_version.3:26
5473 #, no-wrap
5474 msgid "2012-08-26"
5475 msgstr ""
5476
5477 #. type: Plain text
5478 #: build/C/man3/gnu_get_libc_version.3:29
5479 msgid "gnu_get_libc_version, gnu_get_libc_release - get glibc version and release"
5480 msgstr ""
5481
5482 #. type: Plain text
5483 #: build/C/man3/gnu_get_libc_version.3:32
5484 #, no-wrap
5485 msgid "B<#include E<lt>gnu/libc-version.hE<gt>>\n"
5486 msgstr ""
5487
5488 #. type: Plain text
5489 #: build/C/man3/gnu_get_libc_version.3:35
5490 #, no-wrap
5491 msgid ""
5492 "B<const char *gnu_get_libc_version(void);>\n"
5493 "B<const char *gnu_get_libc_release(void);>\n"
5494 msgstr ""
5495
5496 #. type: Plain text
5497 #: build/C/man3/gnu_get_libc_version.3:40
5498 msgid ""
5499 "The function B<gnu_get_libc_version>()  returns a string that identifies the "
5500 "glibc version available on the system."
5501 msgstr ""
5502
5503 #. type: Plain text
5504 #: build/C/man3/gnu_get_libc_version.3:47
5505 msgid ""
5506 "The function B<gnu_get_libc_release>()  returns a string indicates the "
5507 "release status of the glibc version available on the system.  This will be a "
5508 "string such as I<stable>."
5509 msgstr ""
5510
5511 #. type: SH
5512 #: build/C/man3/gnu_get_libc_version.3:47 build/C/man4/vcs.4:99
5513 #, no-wrap
5514 msgid "VERSIONS"
5515 msgstr ""
5516
5517 #. type: Plain text
5518 #: build/C/man3/gnu_get_libc_version.3:49
5519 msgid "These functions first appeared in glibc in version 2.1."
5520 msgstr ""
5521
5522 #. type: SH
5523 #: build/C/man3/gnu_get_libc_version.3:49 build/C/man3/makedev.3:62 build/C/man3/mkfifo.3:104 build/C/man2/mknod.2:177 build/C/man3/setlogmask.3:75 build/C/man3/stdarg.3:229 build/C/man2/syslog.2:298 build/C/man3/syslog.3:252 build/C/man7/uri.7:584
5524 #, no-wrap
5525 msgid "CONFORMING TO"
5526 msgstr ""
5527
5528 #. type: Plain text
5529 #: build/C/man3/gnu_get_libc_version.3:51
5530 msgid "These functions are glibc-specific."
5531 msgstr ""
5532
5533 #. type: Plain text
5534 #: build/C/man3/gnu_get_libc_version.3:53
5535 msgid "When run, the program below will produce output such as the following:"
5536 msgstr ""
5537
5538 #. type: Plain text
5539 #: build/C/man3/gnu_get_libc_version.3:59
5540 #, no-wrap
5541 msgid ""
5542 "$B< ./a.out>\n"
5543 "GNU libc version: 2.8\n"
5544 "GNU libc release: stable\n"
5545 msgstr ""
5546
5547 #. type: Plain text
5548 #: build/C/man3/gnu_get_libc_version.3:67
5549 #, no-wrap
5550 msgid ""
5551 "#include E<lt>gnu/libc-version.hE<gt>\n"
5552 "#include E<lt>stdlib.hE<gt>\n"
5553 "#include E<lt>stdio.hE<gt>\n"
5554 msgstr ""
5555
5556 #. type: Plain text
5557 #: build/C/man3/gnu_get_libc_version.3:75
5558 #, no-wrap
5559 msgid ""
5560 "int\n"
5561 "main(int argc, char *argv[])\n"
5562 "{\n"
5563 "    printf(\"GNU libc version: %s\\en\", gnu_get_libc_version());\n"
5564 "    printf(\"GNU libc release: %s\\en\", gnu_get_libc_release());\n"
5565 "    exit(EXIT_SUCCESS);\n"
5566 "}\n"
5567 msgstr ""
5568
5569 #. type: Plain text
5570 #: build/C/man3/gnu_get_libc_version.3:78
5571 msgid "B<confstr>(3)"
5572 msgstr ""
5573
5574 #. type: TH
5575 #: build/C/man4/hd.4:29
5576 #, no-wrap
5577 msgid "HD"
5578 msgstr ""
5579
5580 #. type: TH
5581 #: build/C/man4/hd.4:29
5582 #, no-wrap
5583 msgid "1992-12-17"
5584 msgstr ""
5585
5586 #. type: Plain text
5587 #: build/C/man4/hd.4:32
5588 msgid "hd - MFM/IDE hard disk devices"
5589 msgstr ""
5590
5591 #. type: Plain text
5592 #: build/C/man4/hd.4:47
5593 msgid ""
5594 "The B<hd*> devices are block devices to access MFM/IDE hard disk drives in "
5595 "raw mode.  The master drive on the primary IDE controller (major device "
5596 "number 3) is B<hda>; the slave drive is B<hdb>.  The master drive of the "
5597 "second controller (major device number 22)  is B<hdc> and the slave B<hdd>."
5598 msgstr ""
5599
5600 #. type: Plain text
5601 #: build/C/man4/hd.4:71
5602 msgid ""
5603 "General IDE block device names have the form B<hd>I<X>, or B<hd>I<XP>, where "
5604 "I<X> is a letter denoting the physical drive, and I<P> is a number denoting "
5605 "the partition on that physical drive.  The first form, B<hd>I<X,> is used to "
5606 "address the whole drive.  Partition numbers are assigned in the order the "
5607 "partitions are discovered, and only nonempty, nonextended partitions get a "
5608 "number.  However, partition numbers 1-4 are given to the four partitions "
5609 "described in the MBR (the \"primary\" partitions), regardless of whether "
5610 "they are unused or extended.  Thus, the first logical partition will be "
5611 "B<hd>I<X>B<5>\\&.  Both DOS-type partitioning and BSD-disklabel partitioning "
5612 "are supported.  You can have at most 63 partitions on an IDE disk."
5613 msgstr ""
5614
5615 #. type: Plain text
5616 #: build/C/man4/hd.4:77
5617 msgid ""
5618 "For example, I</dev/hda> refers to all of the first IDE drive in the system; "
5619 "and I</dev/hdb3> refers to the third DOS \"primary\" partition on the second "
5620 "one."
5621 msgstr ""
5622
5623 #. type: Plain text
5624 #: build/C/man4/hd.4:79 build/C/man4/ttyS.4:34
5625 msgid "They are typically created by:"
5626 msgstr ""
5627
5628 #. type: Plain text
5629 #: build/C/man4/hd.4:82
5630 msgid "mknod -m 660 /dev/hda b 3 0"
5631 msgstr ""
5632
5633 #. type: Plain text
5634 #: build/C/man4/hd.4:84
5635 msgid "mknod -m 660 /dev/hda1 b 3 1"
5636 msgstr ""
5637
5638 #. type: Plain text
5639 #: build/C/man4/hd.4:86
5640 msgid "mknod -m 660 /dev/hda2 b 3 2"
5641 msgstr ""
5642
5643 #. type: Plain text
5644 #: build/C/man4/hd.4:88 build/C/man4/hd.4:98
5645 msgid "\\&..."
5646 msgstr ""
5647
5648 #. type: Plain text
5649 #: build/C/man4/hd.4:90
5650 msgid "mknod -m 660 /dev/hda8 b 3 8"
5651 msgstr ""
5652
5653 #. type: Plain text
5654 #: build/C/man4/hd.4:92
5655 msgid "mknod -m 660 /dev/hdb b 3 64"
5656 msgstr ""
5657
5658 #. type: Plain text
5659 #: build/C/man4/hd.4:94
5660 msgid "mknod -m 660 /dev/hdb1 b 3 65"
5661 msgstr ""
5662
5663 #. type: Plain text
5664 #: build/C/man4/hd.4:96
5665 msgid "mknod -m 660 /dev/hdb2 b 3 66"
5666 msgstr ""
5667
5668 #. type: Plain text
5669 #: build/C/man4/hd.4:100
5670 msgid "mknod -m 660 /dev/hdb8 b 3 72"
5671 msgstr ""
5672
5673 #. type: Plain text
5674 #: build/C/man4/hd.4:102
5675 msgid "chown root:disk /dev/hd*"
5676 msgstr ""
5677
5678 #. type: Plain text
5679 #: build/C/man4/hd.4:105
5680 msgid "/dev/hd*"
5681 msgstr ""
5682
5683 #. type: Plain text
5684 #: build/C/man4/hd.4:110
5685 msgid "B<chown>(1), B<mknod>(1), B<sd>(4), B<mount>(8)"
5686 msgstr ""
5687
5688 #. type: TH
5689 #: build/C/man4/hpsa.4:10
5690 #, no-wrap
5691 msgid "HPSA"
5692 msgstr ""
5693
5694 #. type: Plain text
5695 #: build/C/man4/hpsa.4:13
5696 msgid "hpsa - HP Smart Array SCSI driver"
5697 msgstr ""
5698
5699 #. type: Plain text
5700 #: build/C/man4/hpsa.4:16
5701 #, no-wrap
5702 msgid "modprobe hpsa [ hpsa_allow_any=1 ]\n"
5703 msgstr ""
5704
5705 #. type: Plain text
5706 #: build/C/man4/hpsa.4:20
5707 msgid "B<hpsa> is a SCSI driver for HP Smart Array RAID controllers."
5708 msgstr ""
5709
5710 #. type: Plain text
5711 #: build/C/man4/hpsa.4:39
5712 msgid ""
5713 "I<hpsa_allow_any=1>: This option allows the driver to attempt to operate on "
5714 "any HP Smart Array hardware RAID controller, even if it is not explicitly "
5715 "known to the driver.  This allows newer hardware to work with older "
5716 "drivers.  Typically this is used to allow installation of operating systems "
5717 "from media that predates the RAID controller, though it may also be used to "
5718 "enable B<hpsa> to drive older controllers that would normally be handled by "
5719 "the B<cciss>(4)  driver.  These older boards have not been tested and are "
5720 "not supported with B<hpsa>, and B<cciss>(4)  should still be used for these."
5721 msgstr ""
5722
5723 #. type: Plain text
5724 #: build/C/man4/hpsa.4:43
5725 msgid "The B<hpsa> driver supports the following Smart Array boards:"
5726 msgstr ""
5727
5728 #. type: Plain text
5729 #: build/C/man4/hpsa.4:54
5730 #, no-wrap
5731 msgid ""
5732 "    Smart Array P700M\n"
5733 "    Smart Array P212\n"
5734 "    Smart Array P410\n"
5735 "    Smart Array P410i\n"
5736 "    Smart Array P411\n"
5737 "    Smart Array P812\n"
5738 "    Smart Array P712m\n"
5739 "    Smart Array P711m\n"
5740 "    StorageWorks P1210m\n"
5741 msgstr ""
5742
5743 #. type: Plain text
5744 #: build/C/man4/hpsa.4:78
5745 msgid ""
5746 "Logical drives are accessed via the SCSI disk driver (B<sd>(4)), tape drives "
5747 "via the SCSI tape driver (B<st>(4)), and the RAID controller via the SCSI "
5748 "generic driver (B<sg>(4)), with device nodes named I</dev/sd*,> I</dev/st*>, "
5749 "and I</dev/sg*>, respectively."
5750 msgstr ""
5751
5752 #. type: SS
5753 #: build/C/man4/hpsa.4:78
5754 #, no-wrap
5755 msgid "HPSA-specific host attribute files in /sys"
5756 msgstr ""
5757
5758 #. type: TP
5759 #: build/C/man4/hpsa.4:79
5760 #, no-wrap
5761 msgid "I</sys/class/scsi_host/host*/rescan>"
5762 msgstr ""
5763
5764 #. type: Plain text
5765 #: build/C/man4/hpsa.4:93
5766 msgid ""
5767 "This is a write-only attribute.  Writing to this attribute will cause the "
5768 "driver to scan for new, changed, or removed devices (e.g,. hot-plugged tape "
5769 "drives, or newly configured or deleted logical drives, etc.)  and notify the "
5770 "SCSI midlayer of any changes detected.  Normally a rescan is triggered "
5771 "automatically by HP's Array Configuration Utility (either the GUI or the "
5772 "command-line variety); thus, for logical drive changes, the user should not "
5773 "normally have to use this attribute.  This attribute may be useful when hot "
5774 "plugging devices like tape drives, or entire storage boxes containing "
5775 "pre-configured logical drives."
5776 msgstr ""
5777
5778 #. type: TP
5779 #: build/C/man4/hpsa.4:93
5780 #, no-wrap
5781 msgid "I</sys/class/scsi_host/host*/firmware_revision>"
5782 msgstr ""
5783
5784 #. type: Plain text
5785 #: build/C/man4/hpsa.4:96
5786 msgid "This attribute contains the firmware version of the Smart Array."
5787 msgstr ""
5788
5789 #. type: Plain text
5790 #: build/C/man4/hpsa.4:98
5791 msgid "For example:"
5792 msgstr ""
5793
5794 #. type: Plain text
5795 #: build/C/man4/hpsa.4:103
5796 #, no-wrap
5797 msgid ""
5798 "    # B<cd /sys/class/scsi_host/host4>\n"
5799 "    # B<cat firmware_revision>\n"
5800 "    7.14\n"
5801 msgstr ""
5802
5803 #. type: SS
5804 #: build/C/man4/hpsa.4:104
5805 #, no-wrap
5806 msgid "HPSA-specific disk attribute files in /sys"
5807 msgstr ""
5808
5809 #. type: TP
5810 #: build/C/man4/hpsa.4:105
5811 #, no-wrap
5812 msgid "I</sys/class/scsi_disk/c:b:t:l/device/unique_id>"
5813 msgstr ""
5814
5815 #. type: Plain text
5816 #: build/C/man4/hpsa.4:108
5817 msgid "This attribute contains a 32 hex-digit unique ID for each logical drive."
5818 msgstr ""
5819
5820 #. type: Plain text
5821 #: build/C/man4/hpsa.4:111 build/C/man4/hpsa.4:122 build/C/man4/hpsa.4:136
5822 #, no-wrap
5823 msgid "For example:\n"
5824 msgstr ""
5825
5826 #. type: Plain text
5827 #: build/C/man4/hpsa.4:115
5828 #, no-wrap
5829 msgid ""
5830 "    # B<cd /sys/class/scsi_disk/4:0:0:0/device>\n"
5831 "    # B<cat unique_id>\n"
5832 "    600508B1001044395355323037570F77\n"
5833 msgstr ""
5834
5835 #. type: TP
5836 #: build/C/man4/hpsa.4:116
5837 #, no-wrap
5838 msgid "I</sys/class/scsi_disk/c:b:t:l/device/raid_level>"
5839 msgstr ""
5840
5841 #. type: Plain text
5842 #: build/C/man4/hpsa.4:119
5843 msgid "This attribute contains the RAID level of each logical drive."
5844 msgstr ""
5845
5846 #. type: Plain text
5847 #: build/C/man4/hpsa.4:126
5848 #, no-wrap
5849 msgid ""
5850 "    # B<cd /sys/class/scsi_disk/4:0:0:0/device>\n"
5851 "    # B<cat raid_level>\n"
5852 "    RAID 0\n"
5853 msgstr ""
5854
5855 #. type: TP
5856 #: build/C/man4/hpsa.4:127
5857 #, no-wrap
5858 msgid "I</sys/class/scsi_disk/c:b:t:l/device/lunid>"
5859 msgstr ""
5860
5861 #. type: Plain text
5862 #: build/C/man4/hpsa.4:133
5863 msgid ""
5864 "This attribute contains the 16 hex-digit (8 byte) LUN ID by which a logical "
5865 "drive or physical device can be addressed.  I<c>:I<b>:I<t>:I<l> are the "
5866 "controller, bus, target and lun of the device."
5867 msgstr ""
5868
5869 #. type: Plain text
5870 #: build/C/man4/hpsa.4:140
5871 #, no-wrap
5872 msgid ""
5873 "    # B<cd /sys/class/scsi_disk/4:0:0:0/device>\n"
5874 "    # B<cat lunid>\n"
5875 "    0x0000004000000000\n"
5876 msgstr ""
5877
5878 #. type: SS
5879 #: build/C/man4/hpsa.4:141
5880 #, no-wrap
5881 msgid "Supported ioctl() operations"
5882 msgstr ""
5883
5884 #. type: Plain text
5885 #: build/C/man4/hpsa.4:153
5886 msgid ""
5887 "For compatibility with applications written for the B<cciss>(4)  driver, "
5888 "many, but not all of the ioctls supported by the B<cciss>(4)  driver are "
5889 "also supported by the B<hpsa> driver.  The data structures used by these "
5890 "ioctls are described in the Linux kernel source file "
5891 "I<include/linux/cciss_ioctl.h>."
5892 msgstr ""
5893
5894 #. type: TP
5895 #: build/C/man4/hpsa.4:153
5896 #, no-wrap
5897 msgid "B<CCISS_DEREGDISK>, B<CCISS_REGNEWDISK>, B<CCISS_REGNEWD>"
5898 msgstr ""
5899
5900 #. type: Plain text
5901 #: build/C/man4/hpsa.4:159
5902 msgid ""
5903 "These three ioctls all do exactly the same thing, which is to cause the "
5904 "driver to rescan for new devices.  This does exactly the same thing as "
5905 "writing to the hpsa-specific host \"rescan\" attribute."
5906 msgstr ""
5907
5908 #. type: TP
5909 #: build/C/man4/hpsa.4:159
5910 #, no-wrap
5911 msgid "B<CCISS_GETPCIINFO>"
5912 msgstr ""
5913
5914 #. type: Plain text
5915 #: build/C/man4/hpsa.4:162
5916 msgid ""
5917 "Returns PCI domain, bus, device and function and \"board ID\" (PCI subsystem "
5918 "ID)."
5919 msgstr ""
5920
5921 #. type: TP
5922 #: build/C/man4/hpsa.4:162
5923 #, no-wrap
5924 msgid "B<CCISS_GETDRIVVER>"
5925 msgstr ""
5926
5927 #. type: Plain text
5928 #: build/C/man4/hpsa.4:165
5929 msgid "Returns driver version in three bytes encoded as:"
5930 msgstr ""
5931
5932 #. type: Plain text
5933 #: build/C/man4/hpsa.4:168
5934 #, no-wrap
5935 msgid ""
5936 "    (major_version E<lt>E<lt> 16) | (minor_version E<lt>E<lt> 8) |\n"
5937 "        (subminor_version)\n"
5938 msgstr ""
5939
5940 #. type: TP
5941 #: build/C/man4/hpsa.4:168
5942 #, no-wrap
5943 msgid "B<CCISS_PASSTHRU>, B<CCISS_BIG_PASSTHRU>"
5944 msgstr ""
5945
5946 #. type: Plain text
5947 #: build/C/man4/hpsa.4:179
5948 msgid ""
5949 "Allows \"BMIC\" and \"CISS\" commands to be passed through to the Smart "
5950 "Array.  These are used extensively by the HP Array Configuration Utility, "
5951 "SNMP storage agents, etc.  See I<cciss_vol_status> at E<.UR "
5952 "http://cciss.sf.net> E<.UE> for some examples."
5953 msgstr ""
5954
5955 #. type: Plain text
5956 #: build/C/man4/hpsa.4:186
5957 msgid ""
5958 "B<cciss>(4), B<sd>(4), B<st>(4), B<cciss_vol_status>(8), B<hpacucli>(8), "
5959 "B<hpacuxe>(8),"
5960 msgstr ""
5961
5962 #.  .SH AUTHORS
5963 #.  Don Brace, Steve Cameron, Tom Lawler, Mike Miller, Scott Teel
5964 #.  and probably some other people.
5965 #. type: Plain text
5966 #: build/C/man4/hpsa.4:197
5967 msgid ""
5968 "E<.UR http://cciss.sf.net> E<.UE ,> and I<Documentation/scsi/hpsa.txt> and "
5969 "I<Documentation/ABI/testing/sysfs-bus-pci-devices-cciss> in the Linux kernel "
5970 "source tree"
5971 msgstr ""
5972
5973 #. type: TH
5974 #: build/C/man4/initrd.4:35
5975 #, no-wrap
5976 msgid "INITRD"
5977 msgstr ""
5978
5979 #. type: TH
5980 #: build/C/man4/initrd.4:35 build/C/man4/st.4:25
5981 #, no-wrap
5982 msgid "2010-09-04"
5983 msgstr ""
5984
5985 #. type: Plain text
5986 #: build/C/man4/initrd.4:38
5987 msgid "initrd - boot loader initialized RAM disk"
5988 msgstr ""
5989
5990 #. type: Plain text
5991 #: build/C/man4/initrd.4:51
5992 msgid ""
5993 "The I</dev/initrd> is a read-only block device assigned major number 1 and "
5994 "minor number 250.  Typically I</dev/initrd> is owned by I<root.disk> with "
5995 "mode 0400 (read access by root only).  If the Linux system does not have "
5996 "I</dev/initrd> already created, it can be created with the following "
5997 "commands:"
5998 msgstr ""
5999
6000 #. type: Plain text
6001 #: build/C/man4/initrd.4:56
6002 #, no-wrap
6003 msgid ""
6004 "B<\n"
6005 "        mknod -m 400 /dev/initrd b 1 250\n"
6006 "        chown root:disk /dev/initrd>\n"
6007 "\n"
6008 msgstr ""
6009
6010 #. type: Plain text
6011 #: build/C/man4/initrd.4:71
6012 msgid ""
6013 "Also, support for both \"RAM disk\" and \"Initial RAM disk\" (e.g., "
6014 "B<CONFIG_BLK_DEV_RAM=y> and B<CONFIG_BLK_DEV_INITRD=y>)  must be compiled "
6015 "directly into the Linux kernel to use I</dev/initrd>.  When using "
6016 "I</dev/initrd>, the RAM disk driver cannot be loaded as a module."
6017 msgstr ""
6018
6019 #. type: Plain text
6020 #: build/C/man4/initrd.4:80
6021 msgid ""
6022 "The special file I</dev/initrd> is a read-only block device.  This device is "
6023 "a RAM disk that is initialized (e.g., loaded)  by the boot loader before the "
6024 "kernel is started.  The kernel then can use I</dev/initrd>'s contents for a "
6025 "two-phase system boot-up."
6026 msgstr ""
6027
6028 #. type: Plain text
6029 #: build/C/man4/initrd.4:93
6030 msgid ""
6031 "In the first boot-up phase, the kernel starts up and mounts an initial root "
6032 "file-system from the contents of I</dev/initrd> (e.g., RAM disk initialized "
6033 "by the boot loader).  In the second phase, additional drivers or other "
6034 "modules are loaded from the initial root device's contents.  After loading "
6035 "the additional modules, a new root file system (i.e., the normal root file "
6036 "system) is mounted from a different device."
6037 msgstr ""
6038
6039 #. type: SS
6040 #: build/C/man4/initrd.4:93
6041 #, no-wrap
6042 msgid "Boot-up operation"
6043 msgstr ""
6044
6045 #. type: Plain text
6046 #: build/C/man4/initrd.4:97
6047 msgid "When booting up with B<initrd>, the system boots as follows:"
6048 msgstr ""
6049
6050 #. type: Plain text
6051 #: build/C/man4/initrd.4:101
6052 msgid ""
6053 "The boot loader loads the kernel program and I</dev/initrd>'s contents into "
6054 "memory."
6055 msgstr ""
6056
6057 #. type: Plain text
6058 #: build/C/man4/initrd.4:109
6059 msgid ""
6060 "On kernel startup, the kernel uncompresses and copies the contents of the "
6061 "device I</dev/initrd> onto device I</dev/ram0> and then frees the memory "
6062 "used by I</dev/initrd>."
6063 msgstr ""
6064
6065 #. type: IP
6066 #: build/C/man4/initrd.4:109 build/C/man4/initrd.4:339 build/C/man4/initrd.4:458 build/C/man4/st.4:919
6067 #, no-wrap
6068 msgid "3."
6069 msgstr ""
6070
6071 #. type: Plain text
6072 #: build/C/man4/initrd.4:113
6073 msgid ""
6074 "The kernel then read-write mounts the device I</dev/ram0> as the initial "
6075 "root file system."
6076 msgstr ""
6077
6078 #. type: IP
6079 #: build/C/man4/initrd.4:113 build/C/man4/initrd.4:343 build/C/man4/st.4:926
6080 #, no-wrap
6081 msgid "4."
6082 msgstr ""
6083
6084 #. type: Plain text
6085 #: build/C/man4/initrd.4:118
6086 msgid ""
6087 "If the indicated normal root file system is also the initial root "
6088 "file-system (e.g., I</dev/ram0>)  then the kernel skips to the last step for "
6089 "the usual boot sequence."
6090 msgstr ""
6091
6092 #. type: IP
6093 #: build/C/man4/initrd.4:118 build/C/man4/initrd.4:349 build/C/man4/st.4:931
6094 #, no-wrap
6095 msgid "5."
6096 msgstr ""
6097
6098 #. type: Plain text
6099 #: build/C/man4/initrd.4:130
6100 msgid ""
6101 "If the executable file I</linuxrc> is present in the initial root "
6102 "file-system, I</linuxrc> is executed with UID 0.  (The file I</linuxrc> must "
6103 "have executable permission.  The file I</linuxrc> can be any valid "
6104 "executable, including a shell script.)"
6105 msgstr ""
6106
6107 #. type: IP
6108 #: build/C/man4/initrd.4:130 build/C/man4/initrd.4:358
6109 #, no-wrap
6110 msgid "6."
6111 msgstr ""
6112
6113 #. type: Plain text
6114 #: build/C/man4/initrd.4:142
6115 msgid ""
6116 "If I</linuxrc> is not executed or when I</linuxrc> terminates, the normal "
6117 "root file system is mounted.  (If I</linuxrc> exits with any file-systems "
6118 "mounted on the initial root file-system, then the behavior of the kernel is "
6119 "B<UNSPECIFIED>.  See the NOTES section for the current kernel behavior.)"
6120 msgstr ""
6121
6122 #. type: IP
6123 #: build/C/man4/initrd.4:142 build/C/man4/initrd.4:360
6124 #, no-wrap
6125 msgid "7."
6126 msgstr ""
6127
6128 #. type: Plain text
6129 #: build/C/man4/initrd.4:173
6130 msgid ""
6131 "If the normal root file system has a directory I</initrd>, the device "
6132 "I</dev/ram0> is moved from I</> to I</initrd>.  Otherwise if the directory "
6133 "I</initrd> does not exist, the device I</dev/ram0> is unmounted.  (When "
6134 "moved from I</> to I</initrd>, I</dev/ram0> is not unmounted and therefore "
6135 "processes can remain running from I</dev/ram0>.  If directory I</initrd> "
6136 "does not exist on the normal root file system and any processes remain "
6137 "running from I</dev/ram0> when I</linuxrc> exits, the behavior of the kernel "
6138 "is B<UNSPECIFIED>.  See the NOTES section for the current kernel behavior.)"
6139 msgstr ""
6140
6141 #. type: IP
6142 #: build/C/man4/initrd.4:173 build/C/man4/initrd.4:363
6143 #, no-wrap
6144 msgid "8."
6145 msgstr ""
6146
6147 #. type: Plain text
6148 #: build/C/man4/initrd.4:180
6149 msgid ""
6150 "The usual boot sequence (e.g., invocation of I</sbin/init>)  is performed on "
6151 "the normal root file system."
6152 msgstr ""
6153
6154 #. type: Plain text
6155 #: build/C/man4/initrd.4:184
6156 msgid ""
6157 "The following boot loader options, when used with B<initrd>, affect the "
6158 "kernel's boot-up operation:"
6159 msgstr ""
6160
6161 #. type: TP
6162 #: build/C/man4/initrd.4:184
6163 #, no-wrap
6164 msgid "B<initrd=>I<filename>"
6165 msgstr ""
6166
6167 #. type: Plain text
6168 #: build/C/man4/initrd.4:199
6169 msgid ""
6170 "Specifies the file to load as the contents of I</dev/initrd>.  For "
6171 "B<LOADLIN> this is a command-line option.  For B<LILO> you have to use this "
6172 "command in the B<LILO> configuration file I</etc/lilo.config>.  The filename "
6173 "specified with this option will typically be a gzipped file-system image."
6174 msgstr ""
6175
6176 #. type: TP
6177 #: build/C/man4/initrd.4:199
6178 #, no-wrap
6179 msgid "I<noinitrd>"
6180 msgstr ""
6181
6182 #. type: Plain text
6183 #: build/C/man4/initrd.4:214
6184 msgid ""
6185 "This boot option disables the two-phase boot-up operation.  The kernel "
6186 "performs the usual boot sequence as if I</dev/initrd> was not initialized.  "
6187 "With this option, any contents of I</dev/initrd> loaded into memory by the "
6188 "boot loader contents are preserved.  This option permits the contents of "
6189 "I</dev/initrd> to be any data and need not be limited to a file system "
6190 "image.  However, device I</dev/initrd> is read-only and can be read only one "
6191 "time after system startup."
6192 msgstr ""
6193
6194 #. type: TP
6195 #: build/C/man4/initrd.4:214
6196 #, no-wrap
6197 msgid "B<root=>I<device-name>"
6198 msgstr ""
6199
6200 #. type: Plain text
6201 #: build/C/man4/initrd.4:232
6202 msgid ""
6203 "Specifies the device to be used as the normal root file system.  For "
6204 "B<LOADLIN> this is a command-line option.  For B<LILO> this is a boot time "
6205 "option or can be used as an option line in the B<LILO> configuration file "
6206 "I</etc/lilo.config>.  The device specified by the this option must be a "
6207 "mountable device having a suitable root file-system."
6208 msgstr ""
6209
6210 #. type: SS
6211 #: build/C/man4/initrd.4:232
6212 #, no-wrap
6213 msgid "Changing the normal root file system"
6214 msgstr ""
6215
6216 #. type: Plain text
6217 #: build/C/man4/initrd.4:252
6218 msgid ""
6219 "By default, the kernel's settings (e.g., set in the kernel file with "
6220 "B<rdev>(8)  or compiled into the kernel file), or the boot loader option "
6221 "setting is used for the normal root file systems.  For an NFS-mounted normal "
6222 "root file system, one has to use the B<nfs_root_name> and B<nfs_root_addrs> "
6223 "boot options to give the NFS settings.  For more information on NFS-mounted "
6224 "root see the kernel documentation file "
6225 "B<Documentation/filesystems/nfsroot.txt>.  For more information on setting "
6226 "the root file system see also the B<LILO> and B<LOADLIN> documentation."
6227 msgstr ""
6228
6229 #. type: Plain text
6230 #: build/C/man4/initrd.4:284
6231 msgid ""
6232 "It is also possible for the I</linuxrc> executable to change the normal root "
6233 "device.  For I</linuxrc> to change the normal root device, I</proc> must be "
6234 "mounted.  After mounting I</proc>, I</linuxrc> changes the normal root "
6235 "device by writing into the proc files I</proc/sys/kernel/real-root-dev>, "
6236 "I</proc/sys/kernel/nfs-root-name>, and I</proc/sys/kernel/nfs-root-addrs>.  "
6237 "For a physical root device, the root device is changed by having I</linuxrc> "
6238 "write the new root file system device number into "
6239 "I</proc/sys/kernel/real-root-dev>.  For an NFS root file system, the root "
6240 "device is changed by having I</linuxrc> write the NFS setting into files "
6241 "I</proc/sys/kernel/nfs-root-name> and I</proc/sys/kernel/nfs-root-addrs> and "
6242 "then writing 0xff (e.g., the pseudo-NFS-device number) into file "
6243 "I</proc/sys/kernel/real-root-dev>.  For example, the following shell command "
6244 "line would change the normal root device to I</dev/hdb1>:"
6245 msgstr ""
6246
6247 #. type: Plain text
6248 #: build/C/man4/initrd.4:287
6249 #, no-wrap
6250 msgid "    echo 0x365 E<gt>/proc/sys/kernel/real-root-dev\n"
6251 msgstr ""
6252
6253 #. type: Plain text
6254 #: build/C/man4/initrd.4:294
6255 msgid ""
6256 "For an NFS example, the following shell command lines would change the "
6257 "normal root device to the NFS directory I</var/nfsroot> on a local networked "
6258 "NFS server with IP number 193.8.232.7 for a system with IP number "
6259 "193.8.232.2 and named \"idefix\":"
6260 msgstr ""
6261
6262 #. type: Plain text
6263 #: build/C/man4/initrd.4:300
6264 #, no-wrap
6265 msgid ""
6266 "    echo /var/nfsroot E<gt>/proc/sys/kernel/nfs-root-name\n"
6267 "    echo 193.8.232.2:193.8.232.7::255.255.255.0:idefix \\e\n"
6268 "        E<gt>/proc/sys/kernel/nfs-root-addrs\n"
6269 "    echo 255 E<gt>/proc/sys/kernel/real-root-dev\n"
6270 msgstr ""
6271
6272 #.  FIXME the manual page should describe the pivot_root mechanism.
6273 #. type: Plain text
6274 #: build/C/man4/initrd.4:317
6275 msgid ""
6276 "B<Note>: The use of I</proc/sys/kernel/real-root-dev> to change the root "
6277 "file system is obsolete.  See the Linux kernel source file "
6278 "I<Documentation/initrd.txt> as well as B<pivot_root>(2)  and "
6279 "B<pivot_root>(8)  for information on the modern method of changing the root "
6280 "file system."
6281 msgstr ""
6282
6283 #. type: SS
6284 #: build/C/man4/initrd.4:317 build/C/man4/random.4:65 build/C/man7/uri.7:109
6285 #, no-wrap
6286 msgid "Usage"
6287 msgstr ""
6288
6289 #. type: Plain text
6290 #: build/C/man4/initrd.4:321
6291 msgid ""
6292 "The main motivation for implementing B<initrd> was to allow for modular "
6293 "kernel configuration at system installation."
6294 msgstr ""
6295
6296 #. type: Plain text
6297 #: build/C/man4/initrd.4:323
6298 msgid "A possible system installation scenario is as follows:"
6299 msgstr ""
6300
6301 #. type: Plain text
6302 #: build/C/man4/initrd.4:331
6303 msgid ""
6304 "The loader program boots from floppy or other media with a minimal kernel "
6305 "(e.g., support for I</dev/ram>, I</dev/initrd>, and the ext2 file-system) "
6306 "and loads I</dev/initrd> with a gzipped version of the initial file-system."
6307 msgstr ""
6308
6309 #. type: Plain text
6310 #: build/C/man4/initrd.4:339
6311 msgid ""
6312 "The executable I</linuxrc> determines what is needed to (1) mount the normal "
6313 "root file-system (i.e., device type, device drivers, file system) and (2) "
6314 "the distribution media (e.g., CD-ROM, network, tape, ...).  This can be done "
6315 "by asking the user, by auto-probing, or by using a hybrid approach."
6316 msgstr ""
6317
6318 #. type: Plain text
6319 #: build/C/man4/initrd.4:343
6320 msgid ""
6321 "The executable I</linuxrc> loads the necessary modules from the initial root "
6322 "file-system."
6323 msgstr ""
6324
6325 #. type: Plain text
6326 #: build/C/man4/initrd.4:349
6327 msgid ""
6328 "The executable I</linuxrc> creates and populates the root file system.  (At "
6329 "this stage the normal root file system does not have to be a completed "
6330 "system yet.)"
6331 msgstr ""
6332
6333 #. type: Plain text
6334 #: build/C/man4/initrd.4:358
6335 msgid ""
6336 "The executable I</linuxrc> sets I</proc/sys/kernel/real-root-dev>, unmount "
6337 "I</proc>, the normal root file system and any other file systems it has "
6338 "mounted, and then terminates."
6339 msgstr ""
6340
6341 #. type: Plain text
6342 #: build/C/man4/initrd.4:360
6343 msgid "The kernel then mounts the normal root file system."
6344 msgstr ""
6345
6346 #. type: Plain text
6347 #: build/C/man4/initrd.4:363
6348 msgid ""
6349 "Now that the file system is accessible and intact, the boot loader can be "
6350 "installed."
6351 msgstr ""
6352
6353 #. type: Plain text
6354 #: build/C/man4/initrd.4:372
6355 msgid ""
6356 "The boot loader is configured to load into I</dev/initrd> a file system with "
6357 "the set of modules that was used to bring up the system.  (e.g., Device "
6358 "I</dev/ram0> can be modified, then unmounted, and finally, the image is "
6359 "written from I</dev/ram0> to a file.)"
6360 msgstr ""
6361
6362 #. type: IP
6363 #: build/C/man4/initrd.4:372
6364 #, no-wrap
6365 msgid "9."
6366 msgstr ""
6367
6368 #. type: Plain text
6369 #: build/C/man4/initrd.4:375
6370 msgid ""
6371 "The system is now bootable and additional installation tasks can be "
6372 "performed."
6373 msgstr ""
6374
6375 #. type: Plain text
6376 #: build/C/man4/initrd.4:381
6377 msgid ""
6378 "The key role of I</dev/initrd> in the above is to reuse the configuration "
6379 "data during normal system operation without requiring initial kernel "
6380 "selection, a large generic kernel or, recompiling the kernel."
6381 msgstr ""
6382
6383 #. type: Plain text
6384 #: build/C/man4/initrd.4:394
6385 msgid ""
6386 "A second scenario is for installations where Linux runs on systems with "
6387 "different hardware configurations in a single administrative network.  In "
6388 "such cases, it may be desirable to use only a small set of kernels (ideally "
6389 "only one) and to keep the system-specific part of configuration information "
6390 "as small as possible.  In this case, create a common file with all needed "
6391 "modules.  Then, only the I</linuxrc> file or a file executed by I</linuxrc> "
6392 "would be different."
6393 msgstr ""
6394
6395 #. type: Plain text
6396 #: build/C/man4/initrd.4:401
6397 msgid ""
6398 "A third scenario is more convenient recovery disks.  Because information "
6399 "like the location of the root file-system partition is not needed at boot "
6400 "time, the system loaded from I</dev/initrd> can use a dialog and/or "
6401 "auto-detection followed by a possible sanity check."
6402 msgstr ""
6403
6404 #. type: Plain text
6405 #: build/C/man4/initrd.4:418
6406 msgid ""
6407 "Last but not least, Linux distributions on CD-ROM may use B<initrd> for easy "
6408 "installation from the CD-ROM.  The distribution can use B<LOADLIN> to "
6409 "directly load I</dev/initrd> from CD-ROM without the need of any floppies.  "
6410 "The distribution could also use a B<LILO> boot floppy and then bootstrap a "
6411 "bigger RAM disk via I</dev/initrd> from the CD-ROM."
6412 msgstr ""
6413
6414 #. type: Plain text
6415 #: build/C/man4/initrd.4:420
6416 msgid "I</dev/initrd>"
6417 msgstr ""
6418
6419 #. type: Plain text
6420 #: build/C/man4/initrd.4:422
6421 msgid "I</dev/ram0>"
6422 msgstr ""
6423
6424 #. type: Plain text
6425 #: build/C/man4/initrd.4:424
6426 msgid "I</linuxrc>"
6427 msgstr ""
6428
6429 #. type: Plain text
6430 #: build/C/man4/initrd.4:429
6431 msgid "I</initrd>"
6432 msgstr ""
6433
6434 #. type: Plain text
6435 #: build/C/man4/initrd.4:441
6436 msgid ""
6437 "With the current kernel, any file systems that remain mounted when "
6438 "I</dev/ram0> is moved from I</> to I</initrd> continue to be accessible.  "
6439 "However, the I</proc/mounts> entries are not updated."
6440 msgstr ""
6441
6442 #. type: Plain text
6443 #: build/C/man4/initrd.4:458
6444 msgid ""
6445 "With the current kernel, if directory I</initrd> does not exist, then "
6446 "I</dev/ram0> will B<not> be fully unmounted if I</dev/ram0> is used by any "
6447 "process or has any file-system mounted on it.  If I</dev/ram0> is B<not> "
6448 "fully unmounted, then I</dev/ram0> will remain in memory."
6449 msgstr ""
6450
6451 #
6452 #
6453 #
6454 #.  .SH AUTHORS
6455 #.  The kernel code for device
6456 #.  .BR initrd
6457 #.  was written by Werner Almesberger <almesber@lrc.epfl.ch> and
6458 #.  Hans Lermen <lermen@elserv.ffm.fgan.de>.
6459 #.  The code for
6460 #.  .BR initrd
6461 #.  was added to the baseline Linux kernel in development version 1.3.73.
6462 #. type: Plain text
6463 #: build/C/man4/initrd.4:474
6464 msgid ""
6465 "Users of I</dev/initrd> should not depend on the behavior give in the above "
6466 "notes.  The behavior may change in future versions of the Linux kernel."
6467 msgstr ""
6468
6469 #. type: Plain text
6470 #: build/C/man4/initrd.4:480
6471 msgid "B<chown>(1), B<mknod>(1), B<ram>(4), B<freeramdisk>(8), B<rdev>(8)"
6472 msgstr ""
6473
6474 #. type: Plain text
6475 #: build/C/man4/initrd.4:484
6476 msgid ""
6477 "I<Documentation/initrd.txt> in the Linux kernel source tree, the LILO "
6478 "documentation, the LOADLIN documentation, the SYSLINUX documentation"
6479 msgstr ""
6480
6481 #. type: TH
6482 #: build/C/man4/lp.4:27
6483 #, no-wrap
6484 msgid "LP"
6485 msgstr ""
6486
6487 #. type: TH
6488 #: build/C/man4/lp.4:27
6489 #, no-wrap
6490 msgid "1995-01-15"
6491 msgstr ""
6492
6493 #. type: Plain text
6494 #: build/C/man4/lp.4:30
6495 msgid "lp - line printer devices"
6496 msgstr ""
6497
6498 #. type: Plain text
6499 #: build/C/man4/lp.4:32
6500 msgid "B<#include E<lt>linux/lp.hE<gt>>"
6501 msgstr ""
6502
6503 #. type: Plain text
6504 #: build/C/man4/lp.4:43
6505 msgid ""
6506 "B<lp>[0\\(en2] are character devices for the parallel line printers; they "
6507 "have major number 6 and minor number 0\\(en2.  The minor numbers correspond "
6508 "to the printer port base addresses 0x03bc, 0x0378 and 0x0278.  Usually they "
6509 "have mode 220 and are owned by root and group lp.  You can use printer ports "
6510 "either with polling or with interrupts.  Interrupts are recommended when "
6511 "high traffic is expected, for example, for laser printers.  For usual dot "
6512 "matrix printers polling will usually be enough.  The default is polling."
6513 msgstr ""
6514
6515 #. type: Plain text
6516 #: build/C/man4/lp.4:47
6517 msgid "The following B<ioctl>(2)  calls are supported:"
6518 msgstr ""
6519
6520 #. type: IP
6521 #: build/C/man4/lp.4:47
6522 #, no-wrap
6523 msgid "B<int ioctl(int >I<fd>B<, LPTIME, int >I<arg>B<)>"
6524 msgstr ""
6525
6526 #. type: Plain text
6527 #: build/C/man4/lp.4:56
6528 msgid ""
6529 "Sets the amount of time that the driver sleeps before rechecking the printer "
6530 "when the printer's buffer appears to be filled to I<arg>.  If you have a "
6531 "fast printer, decrease this number; if you have a slow printer then increase "
6532 "it.  This is in hundredths of a second, the default 2 being 0.02 seconds.  "
6533 "It only influences the polling driver."
6534 msgstr ""
6535
6536 #. type: IP
6537 #: build/C/man4/lp.4:56
6538 #, no-wrap
6539 msgid "B<int ioctl(int >I<fd>B<, LPCHAR, int >I<arg>B<)>"
6540 msgstr ""
6541
6542 #. type: Plain text
6543 #: build/C/man4/lp.4:64
6544 msgid ""
6545 "Sets the maximum number of busy-wait iterations which the polling driver "
6546 "does while waiting for the printer to get ready for receiving a character to "
6547 "I<arg>.  If printing is too slow, increase this number; if the system gets "
6548 "too slow, decrease this number.  The default is 1000.  It only influences "
6549 "the polling driver."
6550 msgstr ""
6551
6552 #. type: IP
6553 #: build/C/man4/lp.4:64
6554 #, no-wrap
6555 msgid "B<int ioctl(int >I<fd>B<, LPABORT, int >I<arg>B<)>"
6556 msgstr ""
6557
6558 #. type: Plain text
6559 #: build/C/man4/lp.4:70
6560 msgid ""
6561 "If I<arg> is 0, the printer driver will retry on errors, otherwise it will "
6562 "abort.  The default is 0."
6563 msgstr ""
6564
6565 #. type: IP
6566 #: build/C/man4/lp.4:70
6567 #, no-wrap
6568 msgid "B<int ioctl(int >I<fd>B<, LPABORTOPEN, int >I<arg>B<)>"
6569 msgstr ""
6570
6571 #. type: Plain text
6572 #: build/C/man4/lp.4:77
6573 msgid ""
6574 "If I<arg> is 0, B<open>(2)  will be aborted on error, otherwise error will "
6575 "be ignored.  The default is to ignore it."
6576 msgstr ""
6577
6578 #. type: IP
6579 #: build/C/man4/lp.4:77
6580 #, no-wrap
6581 msgid "B<int ioctl(int >I<fd>B<, LPCAREFUL, int >I<arg>B<)>"
6582 msgstr ""
6583
6584 #. type: Plain text
6585 #: build/C/man4/lp.4:83
6586 msgid ""
6587 "If I<arg> is 0, then the out-of-paper, offline and error signals are "
6588 "required to be false on all writes, otherwise they are ignored.  The default "
6589 "is to ignore them."
6590 msgstr ""
6591
6592 #. type: IP
6593 #: build/C/man4/lp.4:83
6594 #, no-wrap
6595 msgid "B<int ioctl(int >I<fd>B<, LPWAIT, int >I<arg>B<)>"
6596 msgstr ""
6597
6598 #. type: Plain text
6599 #: build/C/man4/lp.4:94
6600 msgid ""
6601 "Sets the number of busy waiting iterations to wait before strobing the "
6602 "printer to accept a just-written character, and the number of iterations to "
6603 "wait before turning the strobe off again, to I<arg>.  The specification says "
6604 "this time should be 0.5 microseconds, but experience has shown the delay "
6605 "caused by the code is already enough.  For that reason, the default value is "
6606 "0.  This is used for both the polling and the interrupt driver."
6607 msgstr ""
6608
6609 #. type: IP
6610 #: build/C/man4/lp.4:94
6611 #, no-wrap
6612 msgid "B<int ioctl(int >I<fd>B<, LPSETIRQ, int >I<arg>B<)>"
6613 msgstr ""
6614
6615 #. type: Plain text
6616 #: build/C/man4/lp.4:105
6617 msgid ""
6618 "This B<ioctl>(2)  requires superuser privileges.  It takes an I<int> "
6619 "containing the new IRQ as argument.  As a side effect, the printer will be "
6620 "reset.  When I<arg> is 0, the polling driver will be used, which is also "
6621 "default."
6622 msgstr ""
6623
6624 #. type: IP
6625 #: build/C/man4/lp.4:105
6626 #, no-wrap
6627 msgid "B<int ioctl(int >I<fd>B<, LPGETIRQ, int *>I<arg>B<)>"
6628 msgstr ""
6629
6630 #. type: Plain text
6631 #: build/C/man4/lp.4:108
6632 msgid "Stores the currently used IRQ in I<arg>."
6633 msgstr ""
6634
6635 #. type: IP
6636 #: build/C/man4/lp.4:108
6637 #, no-wrap
6638 msgid "B<int ioctl(int >I<fd>B<, LPGETSTATUS, int *>I<arg>B<)>"
6639 msgstr ""
6640
6641 #. type: Plain text
6642 #: build/C/man4/lp.4:112
6643 msgid ""
6644 "Stores the value of the status port in I<arg>.  The bits have the following "
6645 "meaning:"
6646 msgstr ""
6647
6648 #. type: tbl table
6649 #: build/C/man4/lp.4:114
6650 #, no-wrap
6651 msgid "LP_PBUSY\tinverted busy input, active high\n"
6652 msgstr ""
6653
6654 #. type: tbl table
6655 #: build/C/man4/lp.4:115
6656 #, no-wrap
6657 msgid "LP_PACK\tunchanged acknowledge input, active low\n"
6658 msgstr ""
6659
6660 #. type: tbl table
6661 #: build/C/man4/lp.4:116
6662 #, no-wrap
6663 msgid "LP_POUTPA\tunchanged out-of-paper input, active high\n"
6664 msgstr ""
6665
6666 #. type: tbl table
6667 #: build/C/man4/lp.4:117
6668 #, no-wrap
6669 msgid "LP_PSELECD\tunchanged selected input, active high\n"
6670 msgstr ""
6671
6672 #. type: tbl table
6673 #: build/C/man4/lp.4:118
6674 #, no-wrap
6675 msgid "LP_PERRORP\tunchanged error input, active low\n"
6676 msgstr ""
6677
6678 #. type: Plain text
6679 #: build/C/man4/lp.4:123
6680 msgid ""
6681 "Refer to your printer manual for the meaning of the signals.  Note that "
6682 "undocumented bits may also be set, depending on your printer."
6683 msgstr ""
6684
6685 #. type: IP
6686 #: build/C/man4/lp.4:123
6687 #, no-wrap
6688 msgid "B<int ioctl(int >I<fd>B<, LPRESET)>"
6689 msgstr ""
6690
6691 #. type: Plain text
6692 #: build/C/man4/lp.4:126
6693 msgid "Resets the printer.  No argument is used."
6694 msgstr ""
6695
6696 #.  .SH AUTHORS
6697 #.  The printer driver was originally written by Jim Weigand and Linus
6698 #.  Torvalds.
6699 #.  It was further improved by Michael K.\& Johnson.
6700 #.  The interrupt code was written by Nigel Gamble.
6701 #.  Alan Cox modularized it.
6702 #.  LPCAREFUL, LPABORT, LPGETSTATUS were added by Chris Metcalf.
6703 #. type: Plain text
6704 #: build/C/man4/lp.4:135
6705 msgid "/dev/lp*"
6706 msgstr ""
6707
6708 #. type: Plain text
6709 #: build/C/man4/lp.4:141
6710 msgid "B<chmod>(1), B<chown>(1), B<mknod>(1), B<lpcntl>(8), B<tunelp>(8)"
6711 msgstr ""
6712
6713 #. type: TH
6714 #: build/C/man3/makedev.3:26
6715 #, no-wrap
6716 msgid "MAKEDEV"
6717 msgstr ""
6718
6719 #. type: TH
6720 #: build/C/man3/makedev.3:26
6721 #, no-wrap
6722 msgid "2012-05-10"
6723 msgstr ""
6724
6725 #. type: Plain text
6726 #: build/C/man3/makedev.3:29
6727 msgid "makedev, major, minor - manage a device number"
6728 msgstr ""
6729
6730 #. type: Plain text
6731 #: build/C/man3/makedev.3:33
6732 #, no-wrap
6733 msgid ""
6734 "B<#define _BSD_SOURCE>             /* See feature_test_macros(7) */\n"
6735 "B<#include E<lt>sys/types.hE<gt>>\n"
6736 msgstr ""
6737
6738 #. type: Plain text
6739 #: build/C/man3/makedev.3:35
6740 #, no-wrap
6741 msgid "B<dev_t makedev(int >I<maj>B<, int >I<min>B<);>\n"
6742 msgstr ""
6743
6744 #. type: Plain text
6745 #: build/C/man3/makedev.3:38
6746 #, no-wrap
6747 msgid ""
6748 "B<unsigned int major(dev_t >I<dev>B<);>\n"
6749 "B<unsigned int minor(dev_t >I<dev>B<);>\n"
6750 msgstr ""
6751
6752 #. type: Plain text
6753 #: build/C/man3/makedev.3:45
6754 msgid ""
6755 "A device ID consists of two parts: a major ID, identifying the class of the "
6756 "device, and a minor ID, identifying a specific instance of a device in that "
6757 "class.  A device ID is represented using the type I<dev_t>."
6758 msgstr ""
6759
6760 #. type: Plain text
6761 #: build/C/man3/makedev.3:52
6762 msgid ""
6763 "Given major and minor device IDs, B<makedev>()  combines these to produce a "
6764 "device ID, returned as the function result.  This device ID can be given to "
6765 "B<mknod>(2), for example."
6766 msgstr ""
6767
6768 #. type: Plain text
6769 #: build/C/man3/makedev.3:62
6770 msgid ""
6771 "The B<major>()  and B<minor>()  functions perform the converse task: given a "
6772 "device ID, they return, respectively, the major and minor components.  These "
6773 "macros can be useful to, for example, decompose the device IDs in the "
6774 "structure returned by B<stat>(2)."
6775 msgstr ""
6776
6777 #.  The BSDs, HP-UX, Solaris, AIX, Irix
6778 #. type: Plain text
6779 #: build/C/man3/makedev.3:71
6780 msgid ""
6781 "The B<makedev>(), B<major>(), and B<minor>()  functions are not specified in "
6782 "POSIX.1, but are present on many other systems."
6783 msgstr ""
6784
6785 #. type: Plain text
6786 #: build/C/man3/makedev.3:80
6787 msgid ""
6788 "These interfaces are defined as macros.  Since glibc 2.3.3, they have been "
6789 "aliases for three GNU-specific functions: B<gnu_dev_makedev>(), "
6790 "B<gnu_dev_major>(), and B<gnu_dev_minor>().  The latter names are exported, "
6791 "but the traditional names are more portable."
6792 msgstr ""
6793
6794 #. type: Plain text
6795 #: build/C/man3/makedev.3:83
6796 msgid "B<mknod>(2), B<stat>(2)"
6797 msgstr ""
6798
6799 #. type: TH
6800 #: build/C/man4/mem.4:26
6801 #, no-wrap
6802 msgid "MEM"
6803 msgstr ""
6804
6805 #. type: TH
6806 #: build/C/man4/mem.4:26 build/C/man4/ram.4:26
6807 #, no-wrap
6808 msgid "1992-11-21"
6809 msgstr ""
6810
6811 #. type: Plain text
6812 #: build/C/man4/mem.4:29
6813 msgid "mem, kmem, port - system memory, kernel memory and system ports"
6814 msgstr ""
6815
6816 #. type: Plain text
6817 #: build/C/man4/mem.4:34
6818 msgid ""
6819 "B<mem> is a character device file that is an image of the main memory of the "
6820 "computer.  It may be used, for example, to examine (and even patch) the "
6821 "system."
6822 msgstr ""
6823
6824 #. type: Plain text
6825 #: build/C/man4/mem.4:39
6826 msgid ""
6827 "Byte addresses in B<mem> are interpreted as physical memory addresses.  "
6828 "References to nonexistent locations cause errors to be returned."
6829 msgstr ""
6830
6831 #. type: Plain text
6832 #: build/C/man4/mem.4:42
6833 msgid ""
6834 "Examining and patching is likely to lead to unexpected results when "
6835 "read-only or write-only bits are present."
6836 msgstr ""
6837
6838 #. type: Plain text
6839 #: build/C/man4/mem.4:44 build/C/man4/mem.4:59 build/C/man4/mem.4:72 build/C/man4/ram.4:35
6840 msgid "It is typically created by:"
6841 msgstr ""
6842
6843 #. type: Plain text
6844 #: build/C/man4/mem.4:47
6845 msgid "mknod -m 660 /dev/mem c 1 1"
6846 msgstr ""
6847
6848 #. type: Plain text
6849 #: build/C/man4/mem.4:49
6850 msgid "chown root:kmem /dev/mem"
6851 msgstr ""
6852
6853 #. type: Plain text
6854 #: build/C/man4/mem.4:57
6855 msgid ""
6856 "The file B<kmem> is the same as B<mem>, except that the kernel virtual "
6857 "memory rather than physical memory is accessed."
6858 msgstr ""
6859
6860 #. type: Plain text
6861 #: build/C/man4/mem.4:62
6862 msgid "mknod -m 640 /dev/kmem c 1 2"
6863 msgstr ""
6864
6865 #. type: Plain text
6866 #: build/C/man4/mem.4:64
6867 msgid "chown root:kmem /dev/kmem"
6868 msgstr ""
6869
6870 #. type: Plain text
6871 #: build/C/man4/mem.4:70
6872 msgid "B<port> is similar to B<mem>, but the I/O ports are accessed."
6873 msgstr ""
6874
6875 #. type: Plain text
6876 #: build/C/man4/mem.4:75
6877 msgid "mknod -m 660 /dev/port c 1 4"
6878 msgstr ""
6879
6880 #. type: Plain text
6881 #: build/C/man4/mem.4:77
6882 msgid "chown root:mem /dev/port"
6883 msgstr ""
6884
6885 #. type: Plain text
6886 #: build/C/man4/mem.4:80
6887 msgid "I</dev/mem>"
6888 msgstr ""
6889
6890 #. type: Plain text
6891 #: build/C/man4/mem.4:82
6892 msgid "I</dev/kmem>"
6893 msgstr ""
6894
6895 #. type: Plain text
6896 #: build/C/man4/mem.4:84
6897 msgid "I</dev/port>"
6898 msgstr ""
6899
6900 #. type: Plain text
6901 #: build/C/man4/mem.4:88
6902 msgid "B<chown>(1), B<mknod>(1), B<ioperm>(2)"
6903 msgstr ""
6904
6905 #. type: TH
6906 #: build/C/man3/mkfifo.3:27
6907 #, no-wrap
6908 msgid "MKFIFO"
6909 msgstr ""
6910
6911 #. type: TH
6912 #: build/C/man3/mkfifo.3:27 build/C/man2/mknod.2:14
6913 #, no-wrap
6914 msgid "2013-01-27"
6915 msgstr ""
6916
6917 #. type: TH
6918 #: build/C/man3/mkfifo.3:27
6919 #, no-wrap
6920 msgid "GNU"
6921 msgstr ""
6922
6923 #. type: Plain text
6924 #: build/C/man3/mkfifo.3:30
6925 msgid "mkfifo - make a FIFO special file (a named pipe)"
6926 msgstr ""
6927
6928 #. type: Plain text
6929 #: build/C/man3/mkfifo.3:34
6930 #, no-wrap
6931 msgid ""
6932 "B<#include E<lt>sys/types.hE<gt>>\n"
6933 "B<#include E<lt>sys/stat.hE<gt>>\n"
6934 msgstr ""
6935
6936 #. type: Plain text
6937 #: build/C/man3/mkfifo.3:36
6938 #, no-wrap
6939 msgid "B<int mkfifo(const char *>I<pathname>B<, mode_t >I<mode>B<);>\n"
6940 msgstr ""
6941
6942 #. type: Plain text
6943 #: build/C/man3/mkfifo.3:44
6944 msgid ""
6945 "B<mkfifo>()  makes a FIFO special file with name I<pathname>.  I<mode> "
6946 "specifies the FIFO's permissions.  It is modified by the process's B<umask> "
6947 "in the usual way: the permissions of the created file are B<(>I<mode>B< & "
6948 "~umask)>."
6949 msgstr ""
6950
6951 #. type: Plain text
6952 #: build/C/man3/mkfifo.3:51
6953 msgid ""
6954 "A FIFO special file is similar to a pipe, except that it is created in a "
6955 "different way.  Instead of being an anonymous communications channel, a FIFO "
6956 "special file is entered into the file system by calling B<mkfifo>()."
6957 msgstr ""
6958
6959 #. type: Plain text
6960 #: build/C/man3/mkfifo.3:61
6961 msgid ""
6962 "Once you have created a FIFO special file in this way, any process can open "
6963 "it for reading or writing, in the same way as an ordinary file.  However, it "
6964 "has to be open at both ends simultaneously before you can proceed to do any "
6965 "input or output operations on it.  Opening a FIFO for reading normally "
6966 "blocks until some other process opens the same FIFO for writing, and vice "
6967 "versa.  See B<fifo>(7)  for nonblocking handling of FIFO special files."
6968 msgstr ""
6969
6970 #. type: Plain text
6971 #: build/C/man3/mkfifo.3:67
6972 msgid ""
6973 "On success B<mkfifo>()  returns 0.  In the case of an error, -1 is returned "
6974 "(in which case, I<errno> is set appropriately)."
6975 msgstr ""
6976
6977 #. type: TP
6978 #: build/C/man3/mkfifo.3:68 build/C/man2/mknod.2:107 build/C/man4/st.4:829
6979 #, no-wrap
6980 msgid "B<EACCES>"
6981 msgstr ""
6982
6983 #. type: Plain text
6984 #: build/C/man3/mkfifo.3:72
6985 msgid ""
6986 "One of the directories in I<pathname> did not allow search (execute) "
6987 "permission."
6988 msgstr ""
6989
6990 #. type: TP
6991 #: build/C/man3/mkfifo.3:72 build/C/man2/mknod.2:115
6992 #, no-wrap
6993 msgid "B<EDQUOT>"
6994 msgstr ""
6995
6996 #. type: Plain text
6997 #: build/C/man3/mkfifo.3:76 build/C/man2/mknod.2:119
6998 msgid ""
6999 "The user's quota of disk blocks or inodes on the file system has been "
7000 "exhausted."
7001 msgstr ""
7002
7003 #. type: TP
7004 #: build/C/man3/mkfifo.3:76 build/C/man2/mknod.2:119
7005 #, no-wrap
7006 msgid "B<EEXIST>"
7007 msgstr ""
7008
7009 #. type: Plain text
7010 #: build/C/man3/mkfifo.3:82 build/C/man2/mknod.2:126
7011 msgid ""
7012 "I<pathname> already exists.  This includes the case where I<pathname> is a "
7013 "symbolic link, dangling or not."
7014 msgstr ""
7015
7016 #. type: TP
7017 #: build/C/man3/mkfifo.3:82 build/C/man2/mknod.2:138
7018 #, no-wrap
7019 msgid "B<ENAMETOOLONG>"
7020 msgstr ""
7021
7022 #. type: Plain text
7023 #: build/C/man3/mkfifo.3:90
7024 msgid ""
7025 "Either the total length of I<pathname> is greater than B<PATH_MAX>, or an "
7026 "individual filename component has a length greater than B<NAME_MAX>.  In the "
7027 "GNU system, there is no imposed limit on overall filename length, but some "
7028 "file systems may place limits on the length of a component."
7029 msgstr ""
7030
7031 #. type: TP
7032 #: build/C/man3/mkfifo.3:90 build/C/man2/mknod.2:141
7033 #, no-wrap
7034 msgid "B<ENOENT>"
7035 msgstr ""
7036
7037 #. type: Plain text
7038 #: build/C/man3/mkfifo.3:94 build/C/man2/mknod.2:146
7039 msgid ""
7040 "A directory component in I<pathname> does not exist or is a dangling "
7041 "symbolic link."
7042 msgstr ""
7043
7044 #. type: TP
7045 #: build/C/man3/mkfifo.3:94 build/C/man2/mknod.2:149 build/C/man4/st.4:857
7046 #, no-wrap
7047 msgid "B<ENOSPC>"
7048 msgstr ""
7049
7050 #. type: Plain text
7051 #: build/C/man3/mkfifo.3:97
7052 msgid "The directory or file system has no room for the new file."
7053 msgstr ""
7054
7055 #. type: TP
7056 #: build/C/man3/mkfifo.3:97 build/C/man2/mknod.2:154
7057 #, no-wrap
7058 msgid "B<ENOTDIR>"
7059 msgstr ""
7060
7061 #. type: Plain text
7062 #: build/C/man3/mkfifo.3:101 build/C/man2/mknod.2:159
7063 msgid "A component used as a directory in I<pathname> is not, in fact, a directory."
7064 msgstr ""
7065
7066 #. type: TP
7067 #: build/C/man3/mkfifo.3:101 build/C/man2/mknod.2:173 build/C/man4/st.4:872
7068 #, no-wrap
7069 msgid "B<EROFS>"
7070 msgstr ""
7071
7072 #. type: Plain text
7073 #: build/C/man3/mkfifo.3:104
7074 msgid "I<pathname> refers to a read-only file system."
7075 msgstr ""
7076
7077 #. type: Plain text
7078 #: build/C/man3/mkfifo.3:106
7079 msgid "POSIX.1-2001."
7080 msgstr ""
7081
7082 #. type: Plain text
7083 #: build/C/man3/mkfifo.3:116
7084 msgid ""
7085 "B<mkfifo>(1), B<close>(2), B<open>(2), B<read>(2), B<stat>(2), B<umask>(2), "
7086 "B<write>(2), B<mkfifoat>(3), B<fifo>(7)"
7087 msgstr ""
7088
7089 #. type: TH
7090 #: build/C/man2/mknod.2:14
7091 #, no-wrap
7092 msgid "MKNOD"
7093 msgstr ""
7094
7095 #. type: Plain text
7096 #: build/C/man2/mknod.2:17
7097 msgid "mknod - create a special or ordinary file"
7098 msgstr ""
7099
7100 #. type: Plain text
7101 #: build/C/man2/mknod.2:23
7102 #, no-wrap
7103 msgid ""
7104 "B<#include E<lt>sys/types.hE<gt>>\n"
7105 "B<#include E<lt>sys/stat.hE<gt>>\n"
7106 "B<#include E<lt>fcntl.hE<gt>>\n"
7107 "B<#include E<lt>unistd.hE<gt>>\n"
7108 msgstr ""
7109
7110 #. type: Plain text
7111 #: build/C/man2/mknod.2:25
7112 #, no-wrap
7113 msgid ""
7114 "B<int mknod(const char *>I<pathname>B<, mode_t >I<mode>B<, dev_t "
7115 ">I<dev>B<);>\n"
7116 msgstr ""
7117
7118 #. type: Plain text
7119 #: build/C/man2/mknod.2:30 build/C/man3/syslog.3:55
7120 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
7121 msgstr ""
7122
7123 #. type: Plain text
7124 #: build/C/man2/mknod.2:33
7125 msgid "B<mknod>():"
7126 msgstr ""
7127
7128 #. type: Plain text
7129 #: build/C/man2/mknod.2:37
7130 msgid ""
7131 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
7132 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
7133 msgstr ""
7134
7135 #. type: Plain text
7136 #: build/C/man2/mknod.2:49
7137 msgid ""
7138 "The system call B<mknod>()  creates a file system node (file, device special "
7139 "file or named pipe) named I<pathname>, with attributes specified by I<mode> "
7140 "and I<dev>."
7141 msgstr ""
7142
7143 #. type: Plain text
7144 #: build/C/man2/mknod.2:56
7145 msgid ""
7146 "The I<mode> argument specifies both the permissions to use and the type of "
7147 "node to be created.  It should be a combination (using bitwise OR) of one of "
7148 "the file types listed below and the permissions for the new node."
7149 msgstr ""
7150
7151 #. type: Plain text
7152 #: build/C/man2/mknod.2:61
7153 msgid ""
7154 "The permissions are modified by the process's I<umask> in the usual way: the "
7155 "permissions of the created node are I<(mode & ~umask)>."
7156 msgstr ""
7157
7158 #.  (S_IFSOCK since Linux 1.2.4)
7159 #. type: Plain text
7160 #: build/C/man2/mknod.2:75
7161 msgid ""
7162 "The file type must be one of B<S_IFREG>, B<S_IFCHR>, B<S_IFBLK>, B<S_IFIFO> "
7163 "or B<S_IFSOCK> to specify a regular file (which will be created empty), "
7164 "character special file, block special file, FIFO (named pipe), or UNIX "
7165 "domain socket, respectively.  (Zero file type is equivalent to type "
7166 "B<S_IFREG>.)"
7167 msgstr ""
7168
7169 #. type: Plain text
7170 #: build/C/man2/mknod.2:88
7171 msgid ""
7172 "If the file type is B<S_IFCHR> or B<S_IFBLK> then I<dev> specifies the major "
7173 "and minor numbers of the newly created device special file (B<makedev>(3)  "
7174 "may be useful to build the value for I<dev>); otherwise it is ignored."
7175 msgstr ""
7176
7177 #. type: Plain text
7178 #: build/C/man2/mknod.2:94
7179 msgid ""
7180 "If I<pathname> already exists, or is a symbolic link, this call fails with "
7181 "an B<EEXIST> error."
7182 msgstr ""
7183
7184 #. type: Plain text
7185 #: build/C/man2/mknod.2:101
7186 msgid ""
7187 "The newly created node will be owned by the effective user ID of the "
7188 "process.  If the directory containing the node has the set-group-ID bit set, "
7189 "or if the file system is mounted with BSD group semantics, the new node will "
7190 "inherit the group ownership from its parent directory; otherwise it will be "
7191 "owned by the effective group ID of the process."
7192 msgstr ""
7193
7194 #. type: Plain text
7195 #: build/C/man2/mknod.2:106
7196 msgid ""
7197 "B<mknod>()  returns zero on success, or -1 if an error occurred (in which "
7198 "case, I<errno> is set appropriately)."
7199 msgstr ""
7200
7201 #. type: Plain text
7202 #: build/C/man2/mknod.2:115
7203 msgid ""
7204 "The parent directory does not allow write permission to the process, or one "
7205 "of the directories in the path prefix of I<pathname> did not allow search "
7206 "permission.  (See also B<path_resolution>(7).)"
7207 msgstr ""
7208
7209 #. type: TP
7210 #: build/C/man2/mknod.2:126 build/C/man4/st.4:838
7211 #, no-wrap
7212 msgid "B<EFAULT>"
7213 msgstr ""
7214
7215 #. type: Plain text
7216 #: build/C/man2/mknod.2:129
7217 msgid "I<pathname> points outside your accessible address space."
7218 msgstr ""
7219
7220 #. type: Plain text
7221 #: build/C/man2/mknod.2:134
7222 msgid ""
7223 "I<mode> requested creation of something other than a regular file, device "
7224 "special file, FIFO or socket."
7225 msgstr ""
7226
7227 #. type: TP
7228 #: build/C/man2/mknod.2:134
7229 #, no-wrap
7230 msgid "B<ELOOP>"
7231 msgstr ""
7232
7233 #. type: Plain text
7234 #: build/C/man2/mknod.2:138
7235 msgid "Too many symbolic links were encountered in resolving I<pathname>."
7236 msgstr ""
7237
7238 #. type: Plain text
7239 #: build/C/man2/mknod.2:141
7240 msgid "I<pathname> was too long."
7241 msgstr ""
7242
7243 #. type: TP
7244 #: build/C/man2/mknod.2:146 build/C/man4/st.4:850
7245 #, no-wrap
7246 msgid "B<ENOMEM>"
7247 msgstr ""
7248
7249 #. type: Plain text
7250 #: build/C/man2/mknod.2:149
7251 msgid "Insufficient kernel memory was available."
7252 msgstr ""
7253
7254 #. type: Plain text
7255 #: build/C/man2/mknod.2:154
7256 msgid "The device containing I<pathname> has no room for the new node."
7257 msgstr ""
7258
7259 #.  For UNIX domain sockets and regular files, EPERM is returned only in
7260 #.  Linux 2.2 and earlier; in Linux 2.4 and later, unprivileged can
7261 #.  use mknod() to make these files.
7262 #. type: Plain text
7263 #: build/C/man2/mknod.2:173
7264 msgid ""
7265 "I<mode> requested creation of something other than a regular file, FIFO "
7266 "(named pipe), or UNIX domain socket, and the caller is not privileged "
7267 "(Linux: does not have the B<CAP_MKNOD> capability); also returned if the "
7268 "file system containing I<pathname> does not support the type of node "
7269 "requested."
7270 msgstr ""
7271
7272 #. type: Plain text
7273 #: build/C/man2/mknod.2:177
7274 msgid "I<pathname> refers to a file on a read-only file system."
7275 msgstr ""
7276
7277 #.  The Linux version differs from the SVr4 version in that it
7278 #.  does not require root permission to create pipes, also in that no
7279 #.  EMULTIHOP, ENOLINK, or EINTR error is documented.
7280 #. type: Plain text
7281 #: build/C/man2/mknod.2:182
7282 msgid "SVr4, 4.4BSD, POSIX.1-2001 (but see below)."
7283 msgstr ""
7284
7285 #. type: Plain text
7286 #: build/C/man2/mknod.2:200
7287 msgid ""
7288 "POSIX.1-2001 says: \"The only portable use of B<mknod>()  is to create a "
7289 "FIFO-special file.  If I<mode> is not B<S_IFIFO> or I<dev> is not 0, the "
7290 "behavior of B<mknod>()  is unspecified.\" However, nowadays one should never "
7291 "use B<mknod>()  for this purpose; one should use B<mkfifo>(3), a function "
7292 "especially defined for this purpose."
7293 msgstr ""
7294
7295 #.  and one should make UNIX domain sockets with socket(2) and bind(2).
7296 #. type: Plain text
7297 #: build/C/man2/mknod.2:205
7298 msgid ""
7299 "Under Linux, this call cannot be used to create directories.  One should "
7300 "make directories with B<mkdir>(2)."
7301 msgstr ""
7302
7303 #. type: Plain text
7304 #: build/C/man2/mknod.2:209
7305 msgid ""
7306 "There are many infelicities in the protocol underlying NFS.  Some of these "
7307 "affect B<mknod>()."
7308 msgstr ""
7309
7310 #. type: Plain text
7311 #: build/C/man2/mknod.2:223
7312 msgid ""
7313 "B<chmod>(2), B<chown>(2), B<fcntl>(2), B<mkdir>(2), B<mknodat>(2), "
7314 "B<mount>(2), B<socket>(2), B<stat>(2), B<umask>(2), B<unlink>(2), "
7315 "B<makedev>(3), B<mkfifo>(3), B<path_resolution>(7)"
7316 msgstr ""
7317
7318 #. type: TH
7319 #: build/C/man4/mouse.4:26
7320 #, no-wrap
7321 msgid "MOUSE"
7322 msgstr ""
7323
7324 #. type: TH
7325 #: build/C/man4/mouse.4:26
7326 #, no-wrap
7327 msgid "1996-02-10"
7328 msgstr ""
7329
7330 #. type: Plain text
7331 #: build/C/man4/mouse.4:29
7332 msgid "mouse - serial mouse interface"
7333 msgstr ""
7334
7335 #. type: Plain text
7336 #: build/C/man4/mouse.4:33
7337 msgid ""
7338 "Serial mice are connected to a serial RS232/V24 dialout line, see B<ttyS>(4)  "
7339 "for a description."
7340 msgstr ""
7341
7342 #. type: SS
7343 #: build/C/man4/mouse.4:34
7344 #, no-wrap
7345 msgid "Introduction"
7346 msgstr ""
7347
7348 #. type: Plain text
7349 #: build/C/man4/mouse.4:36
7350 msgid "The pinout of the usual 9 pin plug as used for serial mice is:"
7351 msgstr ""
7352
7353 #. type: tbl table
7354 #: build/C/man4/mouse.4:39
7355 #, no-wrap
7356 msgid "pin\tname\tused for\n"
7357 msgstr ""
7358
7359 #. type: tbl table
7360 #: build/C/man4/mouse.4:40
7361 #, no-wrap
7362 msgid "2\tRX\tData\n"
7363 msgstr ""
7364
7365 #. type: tbl table
7366 #: build/C/man4/mouse.4:41
7367 #, no-wrap
7368 msgid "3\tTX\t-12 V, Imax = 10 mA\n"
7369 msgstr ""
7370
7371 #. type: tbl table
7372 #: build/C/man4/mouse.4:42
7373 #, no-wrap
7374 msgid "4\tDTR\t+12 V, Imax = 10 mA\n"
7375 msgstr ""
7376
7377 #. type: tbl table
7378 #: build/C/man4/mouse.4:43
7379 #, no-wrap
7380 msgid "7\tRTS\t+12 V, Imax = 10 mA\n"
7381 msgstr ""
7382
7383 #. type: tbl table
7384 #: build/C/man4/mouse.4:44
7385 #, no-wrap
7386 msgid "5\tGND\tGround\n"
7387 msgstr ""
7388
7389 #. type: Plain text
7390 #: build/C/man4/mouse.4:48
7391 msgid "This is the specification, in fact 9 V suffices with most mice."
7392 msgstr ""
7393
7394 #. type: Plain text
7395 #: build/C/man4/mouse.4:54
7396 msgid ""
7397 "The mouse driver can recognize a mouse by dropping RTS to low and raising it "
7398 "again.  About 14 ms later the mouse will send 0x4D (\\(aqM\\(aq) on the data "
7399 "line.  After a further 63 ms, a Microsoft-compatible 3-button mouse will "
7400 "send 0x33 (\\(aq3\\(aq)."
7401 msgstr ""
7402
7403 #. type: Plain text
7404 #: build/C/man4/mouse.4:66
7405 msgid ""
7406 "The relative mouse movement is sent as I<dx> (positive means right)  and "
7407 "I<dy> (positive means down).  Various mice can operate at different speeds.  "
7408 "To select speeds, cycle through the speeds 9600, 4800, 2400 and 1200 bit/s, "
7409 "each time writing the two characters from the table below and waiting 0.1 "
7410 "seconds.  The following table shows available speeds and the strings that "
7411 "select them:"
7412 msgstr ""
7413
7414 #. type: tbl table
7415 #: build/C/man4/mouse.4:69
7416 #, no-wrap
7417 msgid "bit/s\tstring\n"
7418 msgstr ""
7419
7420 #. type: tbl table
7421 #: build/C/man4/mouse.4:70
7422 #, no-wrap
7423 msgid "9600\t*q\n"
7424 msgstr ""
7425
7426 #. type: tbl table
7427 #: build/C/man4/mouse.4:71
7428 #, no-wrap
7429 msgid "4800\t*p\n"
7430 msgstr ""
7431
7432 #. type: tbl table
7433 #: build/C/man4/mouse.4:72
7434 #, no-wrap
7435 msgid "2400\t*o\n"
7436 msgstr ""
7437
7438 #. type: tbl table
7439 #: build/C/man4/mouse.4:73
7440 #, no-wrap
7441 msgid "1200\t*n\n"
7442 msgstr ""
7443
7444 #. type: Plain text
7445 #: build/C/man4/mouse.4:77
7446 msgid "The first byte of a data packet can be used to synchronization purposes."
7447 msgstr ""
7448
7449 #. type: SS
7450 #: build/C/man4/mouse.4:77
7451 #, no-wrap
7452 msgid "Microsoft protocol"
7453 msgstr ""
7454
7455 #. type: Plain text
7456 #: build/C/man4/mouse.4:93
7457 msgid ""
7458 "The B<Microsoft> protocol uses 1 start bit, 7 data bits, no parity and one "
7459 "stop bit at the speed of 1200 bits/sec.  Data is sent to RxD in 3-byte "
7460 "packets.  The I<dx> and I<dy> movements are sent as two's-complement, I<lb> "
7461 "(I<rb>)  are set when the left (right)  button is pressed:"
7462 msgstr ""
7463
7464 #. type: tbl table
7465 #: build/C/man4/mouse.4:96
7466 #, no-wrap
7467 msgid "byte\td6\td5\td4\td3\td2\td1\td0\n"
7468 msgstr ""
7469
7470 #. type: tbl table
7471 #: build/C/man4/mouse.4:97
7472 #, no-wrap
7473 msgid "1\t1\tlb\trb\tdy7\tdy6\tdx7\tdx6\n"
7474 msgstr ""
7475
7476 #. type: tbl table
7477 #: build/C/man4/mouse.4:98
7478 #, no-wrap
7479 msgid "2\t0\tdx5\tdx4\tdx3\tdx2\tdx1\tdx0\n"
7480 msgstr ""
7481
7482 #. type: tbl table
7483 #: build/C/man4/mouse.4:99
7484 #, no-wrap
7485 msgid "3\t0\tdy5\tdy4\tdy3\tdy2\tdy1\tdy0\n"
7486 msgstr ""
7487
7488 #. type: SS
7489 #: build/C/man4/mouse.4:101
7490 #, no-wrap
7491 msgid "3-button Microsoft protocol"
7492 msgstr ""
7493
7494 #. type: Plain text
7495 #: build/C/man4/mouse.4:110
7496 msgid ""
7497 "Original Microsoft mice only have two buttons.  However, there are some "
7498 "three button mice which also use the Microsoft protocol.  Pressing or "
7499 "releasing the middle button is reported by sending a packet with zero "
7500 "movement and no buttons pressed.  (Thus, unlike for the other two buttons, "
7501 "the status of the middle button is not reported in each packet.)"
7502 msgstr ""
7503
7504 #. type: SS
7505 #: build/C/man4/mouse.4:110
7506 #, no-wrap
7507 msgid "Logitech protocol"
7508 msgstr ""
7509
7510 #. type: Plain text
7511 #: build/C/man4/mouse.4:119
7512 msgid ""
7513 "Logitech serial 3-button mice use a different extension of the Microsoft "
7514 "protocol: when the middle button is up, the above 3-byte packet is sent.  "
7515 "When the middle button is down a 4-byte packet is sent, where the 4th byte "
7516 "has value 0x20 (or at least has the 0x20 bit set).  In particular, a press "
7517 "of the middle button is reported as 0,0,0,0x20 when no other buttons are "
7518 "down."
7519 msgstr ""
7520
7521 #. type: SS
7522 #: build/C/man4/mouse.4:119
7523 #, no-wrap
7524 msgid "Mousesystems protocol"
7525 msgstr ""
7526
7527 #. type: Plain text
7528 #: build/C/man4/mouse.4:137
7529 msgid ""
7530 "The B<Mousesystems> protocol uses 1 start bit, 8 data bits, no parity and "
7531 "two stop bits at the speed of 1200 bits/sec.  Data is sent to RxD in 5-byte "
7532 "packets.  I<dx> is sent as the sum of the two two's-complement values, I<dy> "
7533 "is send as negated sum of the two two's-complement values.  I<lb> (I<mb>, "
7534 "I<rb>)  are cleared when the left (middle, right) button is pressed:"
7535 msgstr ""
7536
7537 #. type: tbl table
7538 #: build/C/man4/mouse.4:140 build/C/man4/mouse.4:175
7539 #, no-wrap
7540 msgid "byte\td7\td6\td5\td4\td3\td2\td1\td0\n"
7541 msgstr ""
7542
7543 #. type: tbl table
7544 #: build/C/man4/mouse.4:141
7545 #, no-wrap
7546 msgid "1\t1\t0\t0\t0\t0\tlb\tmb\trb\n"
7547 msgstr ""
7548
7549 #. type: tbl table
7550 #: build/C/man4/mouse.4:142
7551 #, no-wrap
7552 msgid "2\t0\tdxa6\tdxa5\tdxa4\tdxa3\tdxa2\tdxa1\tdxa0\n"
7553 msgstr ""
7554
7555 #. type: tbl table
7556 #: build/C/man4/mouse.4:143
7557 #, no-wrap
7558 msgid "3\t0\tdya6\tdya5\tdya4\tdya3\tdya2\tdya1\tdya0\n"
7559 msgstr ""
7560
7561 #. type: tbl table
7562 #: build/C/man4/mouse.4:144
7563 #, no-wrap
7564 msgid "4\t0\tdxb6\tdxb5\tdxb4\tdxb3\tdxb2\tdxb1\tdxb0\n"
7565 msgstr ""
7566
7567 #. type: tbl table
7568 #: build/C/man4/mouse.4:145
7569 #, no-wrap
7570 msgid "5\t0\tdyb6\tdyb5\tdyb4\tdyb3\tdyb2\tdyb1\tdyb0\n"
7571 msgstr ""
7572
7573 #. type: Plain text
7574 #: build/C/man4/mouse.4:150
7575 msgid ""
7576 "Bytes 4 and 5 describe the change that occurred since bytes 2 and 3 were "
7577 "transmitted."
7578 msgstr ""
7579
7580 #. type: SS
7581 #: build/C/man4/mouse.4:150
7582 #, no-wrap
7583 msgid "Sun protocol"
7584 msgstr ""
7585
7586 #. type: Plain text
7587 #: build/C/man4/mouse.4:155
7588 msgid ""
7589 "The B<Sun> protocol is the 3-byte version of the above 5-byte Mousesystems "
7590 "protocol: the last two bytes are not sent."
7591 msgstr ""
7592
7593 #. type: SS
7594 #: build/C/man4/mouse.4:155
7595 #, no-wrap
7596 msgid "MM protocol"
7597 msgstr ""
7598
7599 #. type: Plain text
7600 #: build/C/man4/mouse.4:172
7601 msgid ""
7602 "The B<MM> protocol uses 1 start bit, 8 data bits, odd parity and one stop "
7603 "bit at the speed of 1200 bits/sec.  Data is sent to RxD in 3-byte packets.  "
7604 "I<dx> and I<dy> are sent as single signed values, the sign bit indicating a "
7605 "negative value.  I<lb> (I<mb>, I<rb>)  are set when the left (middle, right) "
7606 "button is pressed:"
7607 msgstr ""
7608
7609 #. type: tbl table
7610 #: build/C/man4/mouse.4:176
7611 #, no-wrap
7612 msgid "1\t1\t0\t0\tdxs\tdys\tlb\tmb\trb\n"
7613 msgstr ""
7614
7615 #. type: tbl table
7616 #: build/C/man4/mouse.4:177
7617 #, no-wrap
7618 msgid "2\t0\tdx6\tdx5\tdx4\tdx3\tdx2\tdx1\tdx0\n"
7619 msgstr ""
7620
7621 #. type: tbl table
7622 #: build/C/man4/mouse.4:178
7623 #, no-wrap
7624 msgid "3\t0\tdy6\tdy5\tdy4\tdy3\tdy2\tdy1\tdy0\n"
7625 msgstr ""
7626
7627 #. type: TP
7628 #: build/C/man4/mouse.4:181
7629 #, no-wrap
7630 msgid "I</dev/mouse>"
7631 msgstr ""
7632
7633 #. type: Plain text
7634 #: build/C/man4/mouse.4:184
7635 msgid "A commonly used symlink pointing to a mouse device."
7636 msgstr ""
7637
7638 #. type: Plain text
7639 #: build/C/man4/mouse.4:187
7640 msgid "B<ttyS>(4), B<gpm>(8)"
7641 msgstr ""
7642
7643 #. type: TH
7644 #: build/C/man4/msr.4:26
7645 #, no-wrap
7646 msgid "MSR"
7647 msgstr ""
7648
7649 #. type: Plain text
7650 #: build/C/man4/msr.4:29
7651 msgid "msr - x86 CPU MSR access device"
7652 msgstr ""
7653
7654 #. type: Plain text
7655 #: build/C/man4/msr.4:36
7656 msgid ""
7657 "I</dev/cpu/CPUNUM/msr> provides an interface to read and write the "
7658 "model-specific registers (MSRs) of an x86 CPU.  I<CPUNUM> is the number of "
7659 "the CPU to access as listed in I</proc/cpuinfo>."
7660 msgstr ""
7661
7662 #. type: Plain text
7663 #: build/C/man4/msr.4:42
7664 msgid ""
7665 "The register access is done by opening the file and seeking to the MSR "
7666 "number as offset in the file, and then reading or writing in chunks of 8 "
7667 "bytes.  An I/O transfer of more than 8 bytes means multiple reads or writes "
7668 "of the same register."
7669 msgstr ""
7670
7671 #. type: Plain text
7672 #: build/C/man4/msr.4:47
7673 msgid ""
7674 "This file is protected so that it can be read and written only by the user "
7675 "I<root>, or members of the group I<root>."
7676 msgstr ""
7677
7678 #. type: Plain text
7679 #: build/C/man4/msr.4:53
7680 msgid ""
7681 "The I<msr> driver is not auto-loaded.  On modular kernels you might need to "
7682 "use the following command to load it explicitly before use:"
7683 msgstr ""
7684
7685 #. type: Plain text
7686 #: build/C/man4/msr.4:55
7687 #, no-wrap
7688 msgid "    $ I<modprobe msr>\n"
7689 msgstr ""
7690
7691 #. type: Plain text
7692 #: build/C/man4/msr.4:59
7693 msgid ""
7694 "Intel Corporation Intel 64 and IA-32 Architectures Software Developer's "
7695 "Manual Volume 3B Appendix B, for an overview of the Intel CPU MSRs."
7696 msgstr ""
7697
7698 #. type: TH
7699 #: build/C/man4/null.4:26
7700 #, no-wrap
7701 msgid "NULL"
7702 msgstr ""
7703
7704 #. type: TH
7705 #: build/C/man4/null.4:26
7706 #, no-wrap
7707 msgid "2009-02-23"
7708 msgstr ""
7709
7710 #. type: Plain text
7711 #: build/C/man4/null.4:29
7712 msgid "null, zero - data sink"
7713 msgstr ""
7714
7715 #. type: Plain text
7716 #: build/C/man4/null.4:35
7717 msgid "Data written to a B<null> or B<zero> special file is discarded."
7718 msgstr ""
7719
7720 #. type: Plain text
7721 #: build/C/man4/null.4:44
7722 msgid ""
7723 "Reads from the B<null> special file always return end of file (i.e., "
7724 "B<read>(2)  returns 0), whereas reads from B<zero> always return bytes "
7725 "containing zero (\\e0 characters)."
7726 msgstr ""
7727
7728 #. type: Plain text
7729 #: build/C/man4/null.4:49
7730 msgid "B<null> and B<zero> are typically created by:"
7731 msgstr ""
7732
7733 #. type: Plain text
7734 #: build/C/man4/null.4:52
7735 msgid "mknod -m 666 /dev/null c 1 3"
7736 msgstr ""
7737
7738 #. type: Plain text
7739 #: build/C/man4/null.4:54
7740 msgid "mknod -m 666 /dev/zero c 1 5"
7741 msgstr ""
7742
7743 #. type: Plain text
7744 #: build/C/man4/null.4:56
7745 msgid "chown root:root /dev/null /dev/zero"
7746 msgstr ""
7747
7748 #. type: Plain text
7749 #: build/C/man4/null.4:59
7750 msgid "I</dev/null>"
7751 msgstr ""
7752
7753 #. type: Plain text
7754 #: build/C/man4/null.4:61
7755 msgid "I</dev/zero>"
7756 msgstr ""
7757
7758 #. type: Plain text
7759 #: build/C/man4/null.4:64
7760 msgid ""
7761 "If these devices are not writable and readable for all users, many programs "
7762 "will act strangely."
7763 msgstr ""
7764
7765 #. type: Plain text
7766 #: build/C/man4/null.4:68
7767 msgid "B<chown>(1), B<mknod>(1), B<full>(4)"
7768 msgstr ""
7769
7770 #. type: TH
7771 #: build/C/man7/pipe.7:25
7772 #, no-wrap
7773 msgid "PIPE"
7774 msgstr ""
7775
7776 #. type: TH
7777 #: build/C/man7/pipe.7:25
7778 #, no-wrap
7779 msgid "2005-12-08"
7780 msgstr ""
7781
7782 #. type: Plain text
7783 #: build/C/man7/pipe.7:28
7784 msgid "pipe - overview of pipes and FIFOs"
7785 msgstr ""
7786
7787 #. type: Plain text
7788 #: build/C/man7/pipe.7:37
7789 msgid ""
7790 "Pipes and FIFOs (also known as named pipes)  provide a unidirectional "
7791 "interprocess communication channel.  A pipe has a I<read end> and a I<write "
7792 "end>.  Data written to the write end of a pipe can be read from the read end "
7793 "of the pipe."
7794 msgstr ""
7795
7796 #. type: Plain text
7797 #: build/C/man7/pipe.7:47
7798 msgid ""
7799 "A pipe is created using B<pipe>(2), which creates a new pipe and returns two "
7800 "file descriptors, one referring to the read end of the pipe, the other "
7801 "referring to the write end.  Pipes can be used to create a communication "
7802 "channel between related processes; see B<pipe>(2)  for an example."
7803 msgstr ""
7804
7805 #. type: Plain text
7806 #: build/C/man7/pipe.7:66
7807 msgid ""
7808 "A FIFO (short for First In First Out) has a name within the file system "
7809 "(created using B<mkfifo>(3)), and is opened using B<open>(2).  Any process "
7810 "may open a FIFO, assuming the file permissions allow it.  The read end is "
7811 "opened using the B<O_RDONLY> flag; the write end is opened using the "
7812 "B<O_WRONLY> flag.  See B<fifo>(7)  for further details.  I<Note>: although "
7813 "FIFOs have a pathname in the file system, I/O on FIFOs does not involve "
7814 "operations on the underlying device (if there is one)."
7815 msgstr ""
7816
7817 #. type: SS
7818 #: build/C/man7/pipe.7:66
7819 #, no-wrap
7820 msgid "I/O on pipes and FIFOs"
7821 msgstr ""
7822
7823 #. type: Plain text
7824 #: build/C/man7/pipe.7:71
7825 msgid ""
7826 "The only difference between pipes and FIFOs is the manner in which they are "
7827 "created and opened.  Once these tasks have been accomplished, I/O on pipes "
7828 "and FIFOs has exactly the same semantics."
7829 msgstr ""
7830
7831 #. type: Plain text
7832 #: build/C/man7/pipe.7:85
7833 msgid ""
7834 "If a process attempts to read from an empty pipe, then B<read>(2)  will "
7835 "block until data is available.  If a process attempts to write to a full "
7836 "pipe (see below), then B<write>(2)  blocks until sufficient data has been "
7837 "read from the pipe to allow the write to complete.  Nonblocking I/O is "
7838 "possible by using the B<fcntl>(2)  B<F_SETFL> operation to enable the "
7839 "B<O_NONBLOCK> open file status flag."
7840 msgstr ""
7841
7842 #. type: Plain text
7843 #: build/C/man7/pipe.7:89
7844 msgid ""
7845 "The communication channel provided by a pipe is a I<byte stream>: there is "
7846 "no concept of message boundaries."
7847 msgstr ""
7848
7849 #. type: Plain text
7850 #: build/C/man7/pipe.7:116
7851 msgid ""
7852 "If all file descriptors referring to the write end of a pipe have been "
7853 "closed, then an attempt to B<read>(2)  from the pipe will see end-of-file "
7854 "(B<read>(2)  will return 0).  If all file descriptors referring to the read "
7855 "end of a pipe have been closed, then a B<write>(2)  will cause a B<SIGPIPE> "
7856 "signal to be generated for the calling process.  If the calling process is "
7857 "ignoring this signal, then B<write>(2)  fails with the error B<EPIPE>.  An "
7858 "application that uses B<pipe>(2)  and B<fork>(2)  should use suitable "
7859 "B<close>(2)  calls to close unnecessary duplicate file descriptors; this "
7860 "ensures that end-of-file and B<SIGPIPE>/B<EPIPE> are delivered when "
7861 "appropriate."
7862 msgstr ""
7863
7864 #. type: Plain text
7865 #: build/C/man7/pipe.7:120
7866 msgid "It is not possible to apply B<lseek>(2)  to a pipe."
7867 msgstr ""
7868
7869 #. type: SS
7870 #: build/C/man7/pipe.7:120
7871 #, no-wrap
7872 msgid "Pipe capacity"
7873 msgstr ""
7874
7875 #. type: Plain text
7876 #: build/C/man7/pipe.7:132
7877 msgid ""
7878 "A pipe has a limited capacity.  If the pipe is full, then a B<write>(2)  "
7879 "will block or fail, depending on whether the B<O_NONBLOCK> flag is set (see "
7880 "below).  Different implementations have different limits for the pipe "
7881 "capacity.  Applications should not rely on a particular capacity: an "
7882 "application should be designed so that a reading process consumes data as "
7883 "soon as it is available, so that a writing process does not remain blocked."
7884 msgstr ""
7885
7886 #. type: Plain text
7887 #: build/C/man7/pipe.7:136
7888 msgid ""
7889 "In Linux versions before 2.6.11, the capacity of a pipe was the same as the "
7890 "system page size (e.g., 4096 bytes on i386).  Since Linux 2.6.11, the pipe "
7891 "capacity is 65536 bytes."
7892 msgstr ""
7893
7894 #. type: SS
7895 #: build/C/man7/pipe.7:136
7896 #, no-wrap
7897 msgid "PIPE_BUF"
7898 msgstr ""
7899
7900 #. type: Plain text
7901 #: build/C/man7/pipe.7:158
7902 msgid ""
7903 "POSIX.1-2001 says that B<write>(2)s of less than B<PIPE_BUF> bytes must be "
7904 "atomic: the output data is written to the pipe as a contiguous sequence.  "
7905 "Writes of more than B<PIPE_BUF> bytes may be nonatomic: the kernel may "
7906 "interleave the data with data written by other processes.  POSIX.1-2001 "
7907 "requires B<PIPE_BUF> to be at least 512 bytes.  (On Linux, B<PIPE_BUF> is "
7908 "4096 bytes.)  The precise semantics depend on whether the file descriptor is "
7909 "nonblocking (B<O_NONBLOCK>), whether there are multiple writers to the pipe, "
7910 "and on I<n>, the number of bytes to be written:"
7911 msgstr ""
7912
7913 #. type: TP
7914 #: build/C/man7/pipe.7:158
7915 #, no-wrap
7916 msgid "B<O_NONBLOCK> disabled, I<n> E<lt>= B<PIPE_BUF>"
7917 msgstr ""
7918
7919 #. type: Plain text
7920 #: build/C/man7/pipe.7:167
7921 msgid ""
7922 "All I<n> bytes are written atomically; B<write>(2)  may block if there is "
7923 "not room for I<n> bytes to be written immediately"
7924 msgstr ""
7925
7926 #. type: TP
7927 #: build/C/man7/pipe.7:167
7928 #, no-wrap
7929 msgid "B<O_NONBLOCK> enabled, I<n> E<lt>= B<PIPE_BUF>"
7930 msgstr ""
7931
7932 #. type: Plain text
7933 #: build/C/man7/pipe.7:181
7934 msgid ""
7935 "If there is room to write I<n> bytes to the pipe, then B<write>(2)  succeeds "
7936 "immediately, writing all I<n> bytes; otherwise B<write>(2)  fails, with "
7937 "I<errno> set to B<EAGAIN>."
7938 msgstr ""
7939
7940 #. type: TP
7941 #: build/C/man7/pipe.7:181
7942 #, no-wrap
7943 msgid "B<O_NONBLOCK> disabled, I<n> E<gt> B<PIPE_BUF>"
7944 msgstr ""
7945
7946 #. type: Plain text
7947 #: build/C/man7/pipe.7:193
7948 msgid ""
7949 "The write is nonatomic: the data given to B<write>(2)  may be interleaved "
7950 "with B<write>(2)s by other process; the B<write>(2)  blocks until I<n> bytes "
7951 "have been written."
7952 msgstr ""
7953
7954 #. type: TP
7955 #: build/C/man7/pipe.7:193
7956 #, no-wrap
7957 msgid "B<O_NONBLOCK> enabled, I<n> E<gt> B<PIPE_BUF>"
7958 msgstr ""
7959
7960 #. type: Plain text
7961 #: build/C/man7/pipe.7:208
7962 msgid ""
7963 "If the pipe is full, then B<write>(2)  fails, with I<errno> set to "
7964 "B<EAGAIN>.  Otherwise, from 1 to I<n> bytes may be written (i.e., a "
7965 "\"partial write\" may occur; the caller should check the return value from "
7966 "B<write>(2)  to see how many bytes were actually written), and these bytes "
7967 "may be interleaved with writes by other processes."
7968 msgstr ""
7969
7970 #. type: SS
7971 #: build/C/man7/pipe.7:208
7972 #, no-wrap
7973 msgid "Open file status flags"
7974 msgstr ""
7975
7976 #. type: Plain text
7977 #: build/C/man7/pipe.7:214
7978 msgid ""
7979 "The only open file status flags that can be meaningfully applied to a pipe "
7980 "or FIFO are B<O_NONBLOCK> and B<O_ASYNC>."
7981 msgstr ""
7982
7983 #. type: Plain text
7984 #: build/C/man7/pipe.7:226
7985 msgid ""
7986 "Setting the B<O_ASYNC> flag for the read end of a pipe causes a signal "
7987 "(B<SIGIO> by default) to be generated when new input becomes available on "
7988 "the pipe (see B<fcntl>(2)  for details).  On Linux, B<O_ASYNC> is supported "
7989 "for pipes and FIFOs only since kernel 2.6."
7990 msgstr ""
7991
7992 #. type: SS
7993 #: build/C/man7/pipe.7:226
7994 #, no-wrap
7995 msgid "Portability notes"
7996 msgstr ""
7997
7998 #. type: Plain text
7999 #: build/C/man7/pipe.7:232
8000 msgid ""
8001 "On some systems (but not Linux), pipes are bidirectional: data can be "
8002 "transmitted in both directions between the pipe ends.  According to "
8003 "POSIX.1-2001, pipes only need to be unidirectional.  Portable applications "
8004 "should avoid reliance on bidirectional pipe semantics."
8005 msgstr ""
8006
8007 #. type: Plain text
8008 #: build/C/man7/pipe.7:244
8009 msgid ""
8010 "B<dup>(2), B<fcntl>(2), B<open>(2), B<pipe>(2), B<poll>(2), B<select>(2), "
8011 "B<socketpair>(2), B<stat>(2), B<mkfifo>(3), B<epoll>(7), B<fifo>(7)"
8012 msgstr ""
8013
8014 #. type: TH
8015 #: build/C/man4/ram.4:26
8016 #, no-wrap
8017 msgid "RAM"
8018 msgstr ""
8019
8020 #. type: Plain text
8021 #: build/C/man4/ram.4:29
8022 msgid "ram - ram disk device"
8023 msgstr ""
8024
8025 #. type: Plain text
8026 #: build/C/man4/ram.4:33
8027 msgid "The I<ram> device is a block device to access the ram disk in raw mode."
8028 msgstr ""
8029
8030 #. type: Plain text
8031 #: build/C/man4/ram.4:38
8032 msgid "mknod -m 660 /dev/ram b 1 1"
8033 msgstr ""
8034
8035 #. type: Plain text
8036 #: build/C/man4/ram.4:40
8037 msgid "chown root:disk /dev/ram"
8038 msgstr ""
8039
8040 #. type: Plain text
8041 #: build/C/man4/ram.4:43
8042 msgid "/dev/ram"
8043 msgstr ""
8044
8045 #. type: Plain text
8046 #: build/C/man4/ram.4:47
8047 msgid "B<chown>(1), B<mknod>(1), B<mount>(8)"
8048 msgstr ""
8049
8050 #. type: TH
8051 #: build/C/man4/random.4:19
8052 #, no-wrap
8053 msgid "RANDOM"
8054 msgstr ""
8055
8056 #. type: TH
8057 #: build/C/man4/random.4:19 build/C/man3/stdarg.3:43
8058 #, no-wrap
8059 msgid "2013-03-15"
8060 msgstr ""
8061
8062 #. type: Plain text
8063 #: build/C/man4/random.4:22
8064 msgid "random, urandom - kernel random number source devices"
8065 msgstr ""
8066
8067 #. type: Plain text
8068 #: build/C/man4/random.4:24
8069 msgid "#include E<lt>linux/random.hE<gt>"
8070 msgstr ""
8071
8072 #. type: Plain text
8073 #: build/C/man4/random.4:26
8074 msgid "B<int ioctl(>I<fd>B<, RND>I<request>B<, >I<param>B<);>"
8075 msgstr ""
8076
8077 #. type: Plain text
8078 #: build/C/man4/random.4:33
8079 msgid ""
8080 "The character special files I</dev/random> and I</dev/urandom> (present "
8081 "since Linux 1.3.30)  provide an interface to the kernel's random number "
8082 "generator.  File I</dev/random> has major device number 1 and minor device "
8083 "number 8.  File I</dev/urandom> has major device number 1 and minor device "
8084 "number 9."
8085 msgstr ""
8086
8087 #. type: Plain text
8088 #: build/C/man4/random.4:39
8089 msgid ""
8090 "The random number generator gathers environmental noise from device drivers "
8091 "and other sources into an entropy pool.  The generator also keeps an "
8092 "estimate of the number of bits of noise in the entropy pool.  From this "
8093 "entropy pool random numbers are created."
8094 msgstr ""
8095
8096 #. type: Plain text
8097 #: build/C/man4/random.4:47
8098 msgid ""
8099 "When read, the I</dev/random> device will only return random bytes within "
8100 "the estimated number of bits of noise in the entropy pool.  I</dev/random> "
8101 "should be suitable for uses that need very high quality randomness such as "
8102 "one-time pad or key generation.  When the entropy pool is empty, reads from "
8103 "I</dev/random> will block until additional environmental noise is gathered."
8104 msgstr ""
8105
8106 #. type: Plain text
8107 #: build/C/man4/random.4:58
8108 msgid ""
8109 "A read from the I</dev/urandom> device will not block waiting for more "
8110 "entropy.  As a result, if there is not sufficient entropy in the entropy "
8111 "pool, the returned values are theoretically vulnerable to a cryptographic "
8112 "attack on the algorithms used by the driver.  Knowledge of how to do this is "
8113 "not available in the current unclassified literature, but it is "
8114 "theoretically possible that such an attack may exist.  If this is a concern "
8115 "in your application, use I</dev/random> instead."
8116 msgstr ""
8117
8118 #. type: Plain text
8119 #: build/C/man4/random.4:65
8120 msgid ""
8121 "Writing to I</dev/random> or I</dev/urandom> will update the entropy pool "
8122 "with the data written, but this will not result in a higher entropy count.  "
8123 "This means that it will impact the contents read from both files, but it "
8124 "will not make reads from I</dev/random> faster."
8125 msgstr ""
8126
8127 #. type: Plain text
8128 #: build/C/man4/random.4:74
8129 msgid ""
8130 "If you are unsure about whether you should use I</dev/random> or "
8131 "I</dev/urandom>, then probably you want to use the latter.  As a general "
8132 "rule, I</dev/urandom> should be used for everything except long-lived "
8133 "GPG/SSL/SSH keys."
8134 msgstr ""
8135
8136 #. type: Plain text
8137 #: build/C/man4/random.4:86
8138 msgid ""
8139 "If a seed file is saved across reboots as recommended below (all major Linux "
8140 "distributions have done this since 2000 at least), the output is "
8141 "cryptographically secure against attackers without local root access as soon "
8142 "as it is reloaded in the boot sequence, and perfectly adequate for network "
8143 "encryption session keys.  Since reads from I</dev/random> may block, users "
8144 "will usually want to open it in nonblocking mode (or perform a read with "
8145 "timeout), and provide some sort of user notification if the desired entropy "
8146 "is not immediately available."
8147 msgstr ""
8148
8149 #. type: Plain text
8150 #: build/C/man4/random.4:99
8151 msgid ""
8152 "The kernel random-number generator is designed to produce a small amount of "
8153 "high-quality seed material to seed a cryptographic pseudo-random number "
8154 "generator (CPRNG).  It is designed for security, not speed, and is poorly "
8155 "suited to generating large amounts of random data.  Users should be very "
8156 "economical in the amount of seed material that they read from "
8157 "I</dev/urandom> (and I</dev/random>); unnecessarily reading large quantities "
8158 "of data from this device will have a negative impact on other users of the "
8159 "device."
8160 msgstr ""
8161
8162 #. type: Plain text
8163 #: build/C/man4/random.4:107
8164 msgid ""
8165 "The amount of seed material required to generate a cryptographic key equals "
8166 "the effective key size of the key.  For example, a 3072-bit RSA or "
8167 "Diffie-Hellman private key has an effective key size of 128 bits (it "
8168 "requires about 2^128 operations to break) so a key generator only needs 128 "
8169 "bits (16 bytes) of seed material from I</dev/random>."
8170 msgstr ""
8171
8172 #. type: Plain text
8173 #: build/C/man4/random.4:116
8174 msgid ""
8175 "While some safety margin above that minimum is reasonable, as a guard "
8176 "against flaws in the CPRNG algorithm, no cryptographic primitive available "
8177 "today can hope to promise more than 256 bits of security, so if any program "
8178 "reads more than 256 bits (32 bytes) from the kernel random pool per "
8179 "invocation, or per reasonable reseed interval (not less than one minute), "
8180 "that should be taken as a sign that its cryptography is I<not> skillfully "
8181 "implemented."
8182 msgstr ""
8183
8184 #. type: SS
8185 #: build/C/man4/random.4:116
8186 #, no-wrap
8187 msgid "Configuration"
8188 msgstr ""
8189
8190 #. type: Plain text
8191 #: build/C/man4/random.4:120
8192 msgid ""
8193 "If your system does not have I</dev/random> and I</dev/urandom> created "
8194 "already, they can be created with the following commands:"
8195 msgstr ""
8196
8197 #. type: Plain text
8198 #: build/C/man4/random.4:125
8199 #, no-wrap
8200 msgid ""
8201 "    mknod -m 644 /dev/random c 1 8\n"
8202 "    mknod -m 644 /dev/urandom c 1 9\n"
8203 "    chown root:root /dev/random /dev/urandom\n"
8204 msgstr ""
8205
8206 #. type: Plain text
8207 #: build/C/man4/random.4:135
8208 msgid ""
8209 "When a Linux system starts up without much operator interaction, the entropy "
8210 "pool may be in a fairly predictable state.  This reduces the actual amount "
8211 "of noise in the entropy pool below the estimate.  In order to counteract "
8212 "this effect, it helps to carry entropy pool information across shut-downs "
8213 "and start-ups.  To do this, add the following lines to an appropriate script "
8214 "which is run during the Linux system start-up sequence:"
8215 msgstr ""
8216
8217 #. type: Plain text
8218 #: build/C/man4/random.4:150
8219 #, no-wrap
8220 msgid ""
8221 "    echo \"Initializing random number generator...\"\n"
8222 "    random_seed=/var/run/random-seed\n"
8223 "    # Carry a random seed from start-up to start-up\n"
8224 "    # Load and then save the whole entropy pool\n"
8225 "    if [ -f $random_seed ]; then\n"
8226 "        cat $random_seed E<gt>/dev/urandom\n"
8227 "    else\n"
8228 "        touch $random_seed\n"
8229 "    fi\n"
8230 "    chmod 600 $random_seed\n"
8231 "    poolfile=/proc/sys/kernel/random/poolsize\n"
8232 "    [ -r $poolfile ] && bytes=\\`cat $poolfile\\` || bytes=512\n"
8233 "    dd if=/dev/urandom of=$random_seed count=1 bs=$bytes\n"
8234 msgstr ""
8235
8236 #. type: Plain text
8237 #: build/C/man4/random.4:154
8238 msgid ""
8239 "Also, add the following lines in an appropriate script which is run during "
8240 "the Linux system shutdown:"
8241 msgstr ""
8242
8243 #. type: Plain text
8244 #: build/C/man4/random.4:165
8245 #, no-wrap
8246 msgid ""
8247 "    # Carry a random seed from shut-down to start-up\n"
8248 "    # Save the whole entropy pool\n"
8249 "    echo \"Saving random seed...\"\n"
8250 "    random_seed=/var/run/random-seed\n"
8251 "    touch $random_seed\n"
8252 "    chmod 600 $random_seed\n"
8253 "    poolfile=/proc/sys/kernel/random/poolsize\n"
8254 "    [ -r $poolfile ] && bytes=\\`cat $poolfile\\` || bytes=512\n"
8255 "    dd if=/dev/urandom of=$random_seed count=1 bs=$bytes\n"
8256 msgstr ""
8257
8258 #. type: SS
8259 #: build/C/man4/random.4:166
8260 #, no-wrap
8261 msgid "/proc Interface"
8262 msgstr ""
8263
8264 #. type: Plain text
8265 #: build/C/man4/random.4:172
8266 msgid ""
8267 "The files in the directory I</proc/sys/kernel/random> (present since 2.3.16) "
8268 "provide an additional interface to the I</dev/random> device."
8269 msgstr ""
8270
8271 #. type: Plain text
8272 #: build/C/man4/random.4:178
8273 msgid ""
8274 "The read-only file I<entropy_avail> gives the available entropy.  Normally, "
8275 "this will be 4096 (bits), a full entropy pool."
8276 msgstr ""
8277
8278 #. type: Plain text
8279 #: build/C/man4/random.4:183
8280 msgid ""
8281 "The file I<poolsize> gives the size of the entropy pool.  The semantics of "
8282 "this file vary across kernel versions:"
8283 msgstr ""
8284
8285 #. type: TP
8286 #: build/C/man4/random.4:184
8287 #, no-wrap
8288 msgid "Linux 2.4:"
8289 msgstr ""
8290
8291 #. type: Plain text
8292 #: build/C/man4/random.4:191
8293 msgid ""
8294 "This file gives the size of the entropy pool in I<bytes>.  Normally, this "
8295 "file will have the value 512, but it is writable, and can be changed to any "
8296 "value for which an algorithm is available.  The choices are 32, 64, 128, "
8297 "256, 512, 1024, or 2048."
8298 msgstr ""
8299
8300 #. type: TP
8301 #: build/C/man4/random.4:191
8302 #, no-wrap
8303 msgid "Linux 2.6:"
8304 msgstr ""
8305
8306 #. type: Plain text
8307 #: build/C/man4/random.4:196
8308 msgid ""
8309 "This file is read-only, and gives the size of the entropy pool in I<bits>.  "
8310 "It contains the value 4096."
8311 msgstr ""
8312
8313 #. type: Plain text
8314 #: build/C/man4/random.4:214
8315 msgid ""
8316 "The file I<read_wakeup_threshold> contains the number of bits of entropy "
8317 "required for waking up processes that sleep waiting for entropy from "
8318 "I</dev/random>.  The default is 64.  The file I<write_wakeup_threshold> "
8319 "contains the number of bits of entropy below which we wake up processes that "
8320 "do a B<select>(2)  or B<poll>(2)  for write access to I</dev/random>.  These "
8321 "values can be changed by writing to the files."
8322 msgstr ""
8323
8324 #. type: Plain text
8325 #: build/C/man4/random.4:222
8326 msgid ""
8327 "The read-only files I<uuid> and I<boot_id> contain random strings like "
8328 "6fd5a44b-35f4-4ad4-a9b9-6b9be13e1fe9.  The former is generated afresh for "
8329 "each read, the latter was generated once."
8330 msgstr ""
8331
8332 #. type: SS
8333 #: build/C/man4/random.4:222
8334 #, no-wrap
8335 msgid "ioctl(2) interface"
8336 msgstr ""
8337
8338 #. type: Plain text
8339 #: build/C/man4/random.4:233
8340 msgid ""
8341 "The following B<ioctl>(2)  requests are defined on file descriptors "
8342 "connected to either I</dev/random> or I</dev/urandom>.  All requests "
8343 "performed will interact with the input entropy pool impacting both "
8344 "I</dev/random> and I</dev/urandom>.  The B<CAP_SYS_ADMIN> capability is "
8345 "required for all requests except B<RNDGETENTCNT>."
8346 msgstr ""
8347
8348 #. type: TP
8349 #: build/C/man4/random.4:233
8350 #, no-wrap
8351 msgid "B<RNDGETENTCNT>"
8352 msgstr ""
8353
8354 #. type: Plain text
8355 #: build/C/man4/random.4:240
8356 msgid ""
8357 "Retrieve the entropy count of the input pool, the contents will be the same "
8358 "as the I<entropy_avail> file under proc.  The result will be stored in the "
8359 "int pointed to by the argument."
8360 msgstr ""
8361
8362 #. type: TP
8363 #: build/C/man4/random.4:240
8364 #, no-wrap
8365 msgid "B<RNDADDTOENTCNT>"
8366 msgstr ""
8367
8368 #. type: Plain text
8369 #: build/C/man4/random.4:244
8370 msgid ""
8371 "Increment or decrement the entropy count of the input pool by the value "
8372 "pointed to by the argument."
8373 msgstr ""
8374
8375 #. type: TP
8376 #: build/C/man4/random.4:244
8377 #, no-wrap
8378 msgid "B<RNDGETPOOL>"
8379 msgstr ""
8380
8381 #. type: Plain text
8382 #: build/C/man4/random.4:247
8383 msgid "Removed in Linux 2.6.9."
8384 msgstr ""
8385
8386 #. type: TP
8387 #: build/C/man4/random.4:247
8388 #, no-wrap
8389 msgid "B<RNDADDENTROPY>"
8390 msgstr ""
8391
8392 #. type: Plain text
8393 #: build/C/man4/random.4:255
8394 msgid ""
8395 "Add some additional entropy to the input pool, incrementing the entropy "
8396 "count.  This differs from writing to I</dev/random> or I</dev/urandom>, "
8397 "which only adds some data but does not increment the entropy count.  The "
8398 "following structure is used:"
8399 msgstr ""
8400
8401 #. type: Plain text
8402 #: build/C/man4/random.4:262
8403 #, no-wrap
8404 msgid ""
8405 "    struct rand_pool_info {\n"
8406 "        int    entropy_count;\n"
8407 "        int    buf_size;\n"
8408 "        __u32  buf[0];\n"
8409 "    };\n"
8410 msgstr ""
8411
8412 #. type: Plain text
8413 #: build/C/man4/random.4:271
8414 msgid ""
8415 "Here I<entropy_count> is the value added to (or subtracted from) the entropy "
8416 "count, and I<buf> is the buffer of size I<buf_size> which gets added to the "
8417 "entropy pool."
8418 msgstr ""
8419
8420 #. type: TP
8421 #: build/C/man4/random.4:271
8422 #, no-wrap
8423 msgid "B<RNDZAPENTCNT>, B<RNDCLEARPOOL>"
8424 msgstr ""
8425
8426 #. type: Plain text
8427 #: build/C/man4/random.4:275
8428 msgid ""
8429 "Zero the entropy count of all pools and add some system data (such as wall "
8430 "clock) to the pools."
8431 msgstr ""
8432
8433 #. type: Plain text
8434 #: build/C/man4/random.4:277
8435 msgid "/dev/random"
8436 msgstr ""
8437
8438 #.  .SH AUTHOR
8439 #.  The kernel's random number generator was written by
8440 #.  Theodore Ts'o (tytso@athena.mit.edu).
8441 #. type: Plain text
8442 #: build/C/man4/random.4:282
8443 msgid "/dev/urandom"
8444 msgstr ""
8445
8446 #. type: Plain text
8447 #: build/C/man4/random.4:284
8448 msgid "B<mknod>(1)"
8449 msgstr ""
8450
8451 #. type: Plain text
8452 #: build/C/man4/random.4:286
8453 msgid "RFC\\ 1750, \"Randomness Recommendations for Security\""
8454 msgstr ""
8455
8456 #. type: TH
8457 #: build/C/man4/sd.4:26
8458 #, no-wrap
8459 msgid "SD"
8460 msgstr ""
8461
8462 #. type: TH
8463 #: build/C/man4/sd.4:26
8464 #, no-wrap
8465 msgid "2012-05-03"
8466 msgstr ""
8467
8468 #. type: Plain text
8469 #: build/C/man4/sd.4:29
8470 msgid "sd - driver for SCSI disk drives"
8471 msgstr ""
8472
8473 #. type: Plain text
8474 #: build/C/man4/sd.4:33
8475 #, no-wrap
8476 msgid ""
8477 "B<#include E<lt>linux/hdreg.hE<gt>        >/* for HDIO_GETGEO */\n"
8478 "B<#include E<lt>linux/fs.hE<gt>           >/* for BLKGETSIZE and BLKRRPART "
8479 "*/\n"
8480 msgstr ""
8481
8482 #. type: Plain text
8483 #: build/C/man4/sd.4:45
8484 msgid ""
8485 "The block device name has the following form: B<sd>I<lp,> where I<l> is a "
8486 "letter denoting the physical drive, and I<p> is a number denoting the "
8487 "partition on that physical drive.  Often, the partition number, I<p>, will "
8488 "be left off when the device corresponds to the whole drive."
8489 msgstr ""
8490
8491 #. type: Plain text
8492 #: build/C/man4/sd.4:54
8493 msgid ""
8494 "SCSI disks have a major device number of 8, and a minor device number of the "
8495 "form (16 * I<drive_number>) + I<partition_number>, where I<drive_number> is "
8496 "the number of the physical drive in order of detection, and "
8497 "I<partition_number> is as follows:"
8498 msgstr ""
8499
8500 #. type: Plain text
8501 #: build/C/man4/sd.4:56
8502 msgid "partition 0 is the whole drive"
8503 msgstr ""
8504
8505 #. type: Plain text
8506 #: build/C/man4/sd.4:58
8507 msgid "partitions 1-4 are the DOS \"primary\" partitions"
8508 msgstr ""
8509
8510 #. type: Plain text
8511 #: build/C/man4/sd.4:60
8512 msgid "partitions 5-8 are the DOS \"extended\" (or \"logical\") partitions"
8513 msgstr ""
8514
8515 #. type: Plain text
8516 #: build/C/man4/sd.4:68
8517 msgid ""
8518 "For example, I</dev/sda> will have major 8, minor 0, and will refer to all "
8519 "of the first SCSI drive in the system; and I</dev/sdb3> will have major 8, "
8520 "minor 19, and will refer to the third DOS \"primary\" partition on the "
8521 "second SCSI drive in the system."
8522 msgstr ""
8523
8524 #. type: Plain text
8525 #: build/C/man4/sd.4:71
8526 msgid ""
8527 "At this time, only block devices are provided.  Raw devices have not yet "
8528 "been implemented."
8529 msgstr ""
8530
8531 #. type: Plain text
8532 #: build/C/man4/sd.4:75
8533 msgid "The following I<ioctl>s are provided:"
8534 msgstr ""
8535
8536 #. type: TP
8537 #: build/C/man4/sd.4:75
8538 #, no-wrap
8539 msgid "B<HDIO_GETGEO>"
8540 msgstr ""
8541
8542 #. type: Plain text
8543 #: build/C/man4/sd.4:79
8544 msgid "Returns the BIOS disk parameters in the following structure:"
8545 msgstr ""
8546
8547 #. type: Plain text
8548 #: build/C/man4/sd.4:88
8549 #, no-wrap
8550 msgid ""
8551 "struct hd_geometry {\n"
8552 "    unsigned char  heads;\n"
8553 "    unsigned char  sectors;\n"
8554 "    unsigned short cylinders;\n"
8555 "    unsigned long  start;\n"
8556 "};\n"
8557 msgstr ""
8558
8559 #. type: Plain text
8560 #: build/C/man4/sd.4:94
8561 msgid "A pointer to this structure is passed as the B<ioctl>(2)  parameter."
8562 msgstr ""
8563
8564 #. type: Plain text
8565 #: build/C/man4/sd.4:109
8566 msgid ""
8567 "The information returned in the parameter is the disk geometry of the drive "
8568 "I<as understood by DOS!> This geometry is I<not> the physical geometry of "
8569 "the drive.  It is used when constructing the drive's partition table, "
8570 "however, and is needed for convenient operation of B<fdisk>(1), "
8571 "B<efdisk>(1), and B<lilo>(1).  If the geometry information is not available, "
8572 "zero will be returned for all of the parameters."
8573 msgstr ""
8574
8575 #. type: TP
8576 #: build/C/man4/sd.4:110
8577 #, no-wrap
8578 msgid "B<BLKGETSIZE>"
8579 msgstr ""
8580
8581 #. type: Plain text
8582 #: build/C/man4/sd.4:117
8583 msgid ""
8584 "Returns the device size in sectors.  The B<ioctl>(2)  parameter should be a "
8585 "pointer to a I<long>."
8586 msgstr ""
8587
8588 #. type: TP
8589 #: build/C/man4/sd.4:117
8590 #, no-wrap
8591 msgid "B<BLKRRPART>"
8592 msgstr ""
8593
8594 #. type: Plain text
8595 #: build/C/man4/sd.4:121
8596 msgid "Forces a reread of the SCSI disk partition tables.  No parameter is needed."
8597 msgstr ""
8598
8599 #. type: Plain text
8600 #: build/C/man4/sd.4:131
8601 msgid ""
8602 "The SCSI B<ioctl>(2)  operations are also supported.  If the B<ioctl>(2)  "
8603 "parameter is required, and it is NULL, then B<ioctl>(2)  will fail with the "
8604 "error B<EINVAL>."
8605 msgstr ""
8606
8607 #. type: Plain text
8608 #: build/C/man4/sd.4:133
8609 msgid "/dev/sd[a-h]: the whole device"
8610 msgstr ""
8611
8612 #. .SH "SEE ALSO"
8613 #. .BR scsi (4)
8614 #. type: Plain text
8615 #: build/C/man4/sd.4:137
8616 msgid "/dev/sd[a-h][0-8]: individual block partitions"
8617 msgstr ""
8618
8619 #. type: TH
8620 #: build/C/man3/setlogmask.3:25
8621 #, no-wrap
8622 msgid "SETLOGMASK"
8623 msgstr ""
8624
8625 #. type: TH
8626 #: build/C/man3/setlogmask.3:25
8627 #, no-wrap
8628 msgid "2001-10-05"
8629 msgstr ""
8630
8631 #. type: Plain text
8632 #: build/C/man3/setlogmask.3:28
8633 msgid "setlogmask - set log priority mask"
8634 msgstr ""
8635
8636 #. type: Plain text
8637 #: build/C/man3/setlogmask.3:31
8638 #, no-wrap
8639 msgid "B<#include E<lt>syslog.hE<gt>>\n"
8640 msgstr ""
8641
8642 #. type: Plain text
8643 #: build/C/man3/setlogmask.3:33
8644 #, no-wrap
8645 msgid "B<int setlogmask(int >I<mask>B<);>\n"
8646 msgstr ""
8647
8648 #. type: Plain text
8649 #: build/C/man3/setlogmask.3:43
8650 msgid ""
8651 "A process has a log priority mask that determines which calls to "
8652 "B<syslog>(3)  may be logged.  All other calls will be ignored.  Logging is "
8653 "enabled for the priorities that have the corresponding bit set in I<mask>.  "
8654 "The initial mask is such that logging is enabled for all priorities."
8655 msgstr ""
8656
8657 #. type: Plain text
8658 #: build/C/man3/setlogmask.3:49
8659 msgid ""
8660 "The B<setlogmask>()  function sets this logmask for the calling process, and "
8661 "returns the previous mask.  If the mask argument is 0, the current logmask "
8662 "is not modified."
8663 msgstr ""
8664
8665 #. type: Plain text
8666 #: build/C/man3/setlogmask.3:69
8667 msgid ""
8668 "The eight priorities are B<LOG_EMERG>, B<LOG_ALERT>, B<LOG_CRIT>, "
8669 "B<LOG_ERR>, B<LOG_WARNING>, B<LOG_NOTICE>, B<LOG_INFO>, and B<LOG_DEBUG>.  "
8670 "The bit corresponding to a priority I<p> is I<LOG_MASK(p)>.  Some systems "
8671 "also provide a macro I<LOG_UPTO(p)> for the mask of all priorities in the "
8672 "above list up to and including I<p>."
8673 msgstr ""
8674
8675 #. type: Plain text
8676 #: build/C/man3/setlogmask.3:71
8677 msgid "This function returns the previous log priority mask."
8678 msgstr ""
8679
8680 #.  .SH NOTES
8681 #.  The glibc logmask handling was broken in versions before glibc 2.1.1.
8682 #. type: Plain text
8683 #: build/C/man3/setlogmask.3:75
8684 msgid "None."
8685 msgstr ""
8686
8687 #. type: Plain text
8688 #: build/C/man3/setlogmask.3:78
8689 msgid "POSIX.1-2001.  Note that the description in POSIX.1-2001 is flawed."
8690 msgstr ""
8691
8692 #. type: Plain text
8693 #: build/C/man3/setlogmask.3:82
8694 msgid "B<closelog>(3), B<openlog>(3), B<syslog>(3)"
8695 msgstr ""
8696
8697 #. type: TH
8698 #: build/C/man4/sk98lin.4:27
8699 #, no-wrap
8700 msgid "SK98LIN"
8701 msgstr ""
8702
8703 #. type: Plain text
8704 #: build/C/man4/sk98lin.4:30
8705 msgid "sk98lin - Marvell/SysKonnect Gigabit Ethernet driver v6.21"
8706 msgstr ""
8707
8708 #. type: Plain text
8709 #: build/C/man4/sk98lin.4:62
8710 msgid ""
8711 "B<insmod sk98lin.o> [B<Speed_A=>I<i,j,...>] [B<Speed_B=>I<i,j,...>] "
8712 "[B<AutoNeg_A=>I<i,j,...>] [B<AutoNeg_B=>I<i,j,...>] [B<DupCap_A=>I<i,j,...>] "
8713 "[B<DupCap_B=>I<i,j,...>] [B<FlowCtrl_A=>I<i,j,...>] "
8714 "[B<FlowCtrl_B=>I<i,j,...>] [B<Role_A=>I<i,j,...>] [B<Role_B=>I<i,j,...>] "
8715 "[B<ConType=>I<i,j,...>] [B<Moderation=>I<i,j,...>] "
8716 "[B<IntsPerSec=>I<i,j,...>] [B<PrefPort=>I<i,j,...>] [B<RlmtMode=>I<i,j,...>]"
8717 msgstr ""
8718
8719 #. type: Plain text
8720 #: build/C/man4/sk98lin.4:67
8721 msgid "B<Note>: This obsolete driver was removed from the kernel in version 2.6.26."
8722 msgstr ""
8723
8724 #. type: Plain text
8725 #: build/C/man4/sk98lin.4:74
8726 msgid ""
8727 "B<sk98lin> is the Gigabit Ethernet driver for Marvell and SysKonnect network "
8728 "adapter cards.  It supports SysKonnect SK-98xx/SK-95xx compliant Gigabit "
8729 "Ethernet Adapter and any Yukon compliant chipset."
8730 msgstr ""
8731
8732 #. type: Plain text
8733 #: build/C/man4/sk98lin.4:81
8734 msgid ""
8735 "When loading the driver using insmod, parameters for the network adapter "
8736 "cards might be stated as a sequence of comma separated commands.  If for "
8737 "instance two network adapters are installed and AutoNegotiation on Port A of "
8738 "the first adapter should be ON, but on the Port A of the second adapter "
8739 "switched OFF, one must enter:"
8740 msgstr ""
8741
8742 #. type: Plain text
8743 #: build/C/man4/sk98lin.4:83
8744 #, no-wrap
8745 msgid "   insmod sk98lin.o AutoNeg_A=On,Off\n"
8746 msgstr ""
8747
8748 #. type: Plain text
8749 #: build/C/man4/sk98lin.4:98
8750 msgid ""
8751 "After B<sk98lin> is bound to one or more adapter cards and the I</proc> file "
8752 "system is mounted on your system, a dedicated statistics file will be "
8753 "created in folder I</proc/net/sk98lin> for all ports of the installed "
8754 "network adapter cards.  Those files are named I<eth[x]> whereas I<x> is the "
8755 "number of the interface that has been assigned to a dedicated port by the "
8756 "system."
8757 msgstr ""
8758
8759 #. type: Plain text
8760 #: build/C/man4/sk98lin.4:108
8761 msgid ""
8762 "If loading is finished, any desired IP address can be assigned to the "
8763 "respective I<eth[x]> interface using the B<ifconfig>(8)  command.  This "
8764 "causes the adapter to connect to the Ethernet and to display a status "
8765 "message on the console saying \"ethx: network connection up using port y\" "
8766 "followed by the configured or detected connection parameters."
8767 msgstr ""
8768
8769 #. type: Plain text
8770 #: build/C/man4/sk98lin.4:124
8771 msgid ""
8772 "The B<sk98lin> also supports large frames (also called jumbo frames).  Using "
8773 "jumbo frames can improve throughput tremendously when transferring large "
8774 "amounts of data.  To enable large frames, the MTU (maximum transfer unit) "
8775 "size for an interface is to be set to a high value.  The default MTU size is "
8776 "1500 and can be changed up to 9000 (bytes).  Setting the MTU size can be "
8777 "done when assigning the IP address to the interface or later by using the "
8778 "B<ifconfig>(8)  command with the mtu parameter.  If for instance eth0 needs "
8779 "an IP address and a large frame MTU size, the following two commands might "
8780 "be used:"
8781 msgstr ""
8782
8783 #. type: Plain text
8784 #: build/C/man4/sk98lin.4:127
8785 #, no-wrap
8786 msgid ""
8787 "    ifconfig eth0 10.1.1.1\n"
8788 "    ifconfig eth0 mtu 9000\n"
8789 msgstr ""
8790
8791 #. type: Plain text
8792 #: build/C/man4/sk98lin.4:129
8793 msgid "Those two commands might even be combined into one:"
8794 msgstr ""
8795
8796 #. type: Plain text
8797 #: build/C/man4/sk98lin.4:131
8798 #, no-wrap
8799 msgid "    ifconfig eth0 10.1.1.1 mtu 9000\n"
8800 msgstr ""
8801
8802 #. type: Plain text
8803 #: build/C/man4/sk98lin.4:144
8804 msgid ""
8805 "Note that large frames can be used only if permitted by your network "
8806 "infrastructure.  This means, that any switch being used in your Ethernet "
8807 "must also support large frames.  Quite some switches support large frames, "
8808 "but need to be configured to do so.  Most of the times, their default "
8809 "setting is to support only standard frames with an MTU size of 1500 "
8810 "(bytes).  In addition to the switches inside the network, all network "
8811 "adapters that are to be used must also be enabled regarding jumbo frames.  "
8812 "If an adapter is not set to receive large frames it will simply drop them."
8813 msgstr ""
8814
8815 #. type: Plain text
8816 #: build/C/man4/sk98lin.4:148
8817 msgid ""
8818 "Switching back to the standard Ethernet frame size can be done by using the "
8819 "B<ifconfig>(8)  command again:"
8820 msgstr ""
8821
8822 #. type: Plain text
8823 #: build/C/man4/sk98lin.4:150
8824 #, no-wrap
8825 msgid "    ifconfig eth0 mtu 1500\n"
8826 msgstr ""
8827
8828 #. type: Plain text
8829 #: build/C/man4/sk98lin.4:156
8830 msgid ""
8831 "The Marvell/SysKonnect Gigabit Ethernet driver for Linux is able to support "
8832 "VLAN and Link Aggregation according to IEEE standards 802.1, 802.1q, and "
8833 "802.3ad.  Those features are available only after installation of open "
8834 "source modules which can be found on the Internet:"
8835 msgstr ""
8836
8837 #. type: Plain text
8838 #: build/C/man4/sk98lin.4:161
8839 msgid "I<VLAN>: E<.UR http://www.candelatech.com\\:/~greear\\:/vlan.html> E<.UE>"
8840 msgstr ""
8841
8842 #. type: Plain text
8843 #: build/C/man4/sk98lin.4:167
8844 msgid "I<Link> I<Aggregation>: E<.UR http://www.st.rim.or.jp\\:/~yumo> E<.UE>"
8845 msgstr ""
8846
8847 #. type: Plain text
8848 #: build/C/man4/sk98lin.4:172
8849 msgid ""
8850 "Note that Marvell/SysKonnect does not offer any support for these open "
8851 "source modules and does not take the responsibility for any kind of failures "
8852 "or problems arising when using these modules."
8853 msgstr ""
8854
8855 #. type: SS
8856 #: build/C/man4/sk98lin.4:172 build/C/man4/wavelan.4:36
8857 #, no-wrap
8858 msgid "Parameters"
8859 msgstr ""
8860
8861 #. type: TP
8862 #: build/C/man4/sk98lin.4:173
8863 #, no-wrap
8864 msgid "B<Speed_A=>I<i,j,...>"
8865 msgstr ""
8866
8867 #. type: Plain text
8868 #: build/C/man4/sk98lin.4:191
8869 msgid ""
8870 "This parameter is used to set the speed capabilities of port A of an adapter "
8871 "card.  It is valid only for Yukon copper adapters.  Possible values are: "
8872 "I<10>, I<100>, I<1000> or I<Auto> whereas I<Auto> is the default.  Usually, "
8873 "the speed is negotiated between the two ports during link establishment.  If "
8874 "this fails, a port can be forced to a specific setting with this parameter."
8875 msgstr ""
8876
8877 #. type: TP
8878 #: build/C/man4/sk98lin.4:191
8879 #, no-wrap
8880 msgid "B<Speed_B=>I<i,j,...>"
8881 msgstr ""
8882
8883 #. type: Plain text
8884 #: build/C/man4/sk98lin.4:209
8885 msgid ""
8886 "This parameter is used to set the speed capabilities of port B of an adapter "
8887 "card.  It is valid only for Yukon copper adapters.  Possible values are: "
8888 "I<10>, I<100>, I<1000> or I<Auto> whereas I<Auto> is the default.  Usually, "
8889 "the speed is negotiated between the two ports during link establishment.  If "
8890 "this fails, a port can be forced to a specific setting with this parameter."
8891 msgstr ""
8892
8893 #. type: TP
8894 #: build/C/man4/sk98lin.4:209
8895 #, no-wrap
8896 msgid "B<AutoNeg_A=>I<i,j,...>"
8897 msgstr ""
8898
8899 #. type: Plain text
8900 #: build/C/man4/sk98lin.4:224
8901 msgid ""
8902 "Enables or disables the use of autonegotiation of port A of an adapter "
8903 "card.  Possible values are: I<On>, I<Off> or I<Sense> whereas I<On> is the "
8904 "default.  The I<Sense> mode automatically detects whether the link partner "
8905 "supports auto-negotiation or not."
8906 msgstr ""
8907
8908 #. type: TP
8909 #: build/C/man4/sk98lin.4:224
8910 #, no-wrap
8911 msgid "B<AutoNeg_B=>I<i,j,...>"
8912 msgstr ""
8913
8914 #. type: Plain text
8915 #: build/C/man4/sk98lin.4:239
8916 msgid ""
8917 "Enables or disables the use of autonegotiation of port B of an adapter "
8918 "card.  Possible values are: I<On>, I<Off> or I<Sense> whereas I<On> is the "
8919 "default.  The I<Sense> mode automatically detects whether the link partner "
8920 "supports auto-negotiation or not."
8921 msgstr ""
8922
8923 #. type: TP
8924 #: build/C/man4/sk98lin.4:239
8925 #, no-wrap
8926 msgid "B<DupCap_A=>I<i,j,...>"
8927 msgstr ""
8928
8929 #. type: Plain text
8930 #: build/C/man4/sk98lin.4:270
8931 msgid ""
8932 "This parameter indicates the duplex mode to be used for port A of an adapter "
8933 "card.  Possible values are: I<Half>, I<Full> or I<Both> whereas I<Both> is "
8934 "the default.  This parameter is relevant only if AutoNeg_A of port A is not "
8935 "set to I<Sense>.  If AutoNeg_A is set to I<On>, all three values of DupCap_A "
8936 "( I<Half>, I<Full> or I<Both>)  might be stated.  If AutoNeg_A is set to "
8937 "I<Off>, only DupCap_A values I<Full> and I<Half> are allowed.  This DupCap_A "
8938 "parameter is useful if your link partner does not support all possible "
8939 "duplex combinations."
8940 msgstr ""
8941
8942 #. type: TP
8943 #: build/C/man4/sk98lin.4:270
8944 #, no-wrap
8945 msgid "B<DupCap_B=>I<i,j,...>"
8946 msgstr ""
8947
8948 #. type: Plain text
8949 #: build/C/man4/sk98lin.4:301
8950 msgid ""
8951 "This parameter indicates the duplex mode to be used for port B of an adapter "
8952 "card.  Possible values are: I<Half>, I<Full> or I<Both> whereas I<Both> is "
8953 "the default.  This parameter is relevant only if AutoNeg_B of port B is not "
8954 "set to I<Sense>.  If AutoNeg_B is set to I<On>, all three values of DupCap_B "
8955 "( I<Half>, I<Full> or I<Both>)  might be stated.  If AutoNeg_B is set to "
8956 "I<Off>, only DupCap_B values I<Full> and I<Half> are allowed.  This DupCap_B "
8957 "parameter is useful if your link partner does not support all possible "
8958 "duplex combinations."
8959 msgstr ""
8960
8961 #. type: TP
8962 #: build/C/man4/sk98lin.4:301
8963 #, no-wrap
8964 msgid "B<FlowCtrl_A=>I<i,j,...>"
8965 msgstr ""
8966
8967 #. type: Plain text
8968 #: build/C/man4/sk98lin.4:315 build/C/man4/sk98lin.4:349
8969 msgid ""
8970 "This parameter can be used to set the flow control capabilities the port "
8971 "reports during auto-negotiation.  Possible values are: I<Sym>, I<SymOrRem>, "
8972 "I<LocSend> or I<None> whereas I<SymOrRem> is the default.  The different "
8973 "modes have the following meaning:"
8974 msgstr ""
8975
8976 #. type: Plain text
8977 #: build/C/man4/sk98lin.4:320 build/C/man4/sk98lin.4:353
8978 #, no-wrap
8979 msgid ""
8980 "I<Sym>\n"
8981 "= Symmetric\n"
8982 " both link partners are allowed to send PAUSE frames\n"
8983 msgstr ""
8984
8985 #. type: Plain text
8986 #: build/C/man4/sk98lin.4:324 build/C/man4/sk98lin.4:357
8987 #, no-wrap
8988 msgid ""
8989 "I<SymOrRem>\n"
8990 "= SymmetricOrRemote\n"
8991 " both or only remote partner are allowed to send PAUSE frames\n"
8992 msgstr ""
8993
8994 #. type: Plain text
8995 #: build/C/man4/sk98lin.4:328 build/C/man4/sk98lin.4:361
8996 #, no-wrap
8997 msgid ""
8998 "I<LocSend>\n"
8999 "= LocalSend\n"
9000 " only local link partner is allowed to send PAUSE frames\n"
9001 msgstr ""
9002
9003 #. type: Plain text
9004 #: build/C/man4/sk98lin.4:332 build/C/man4/sk98lin.4:365
9005 #, no-wrap
9006 msgid ""
9007 "I<None>\n"
9008 "= None\n"
9009 " no link partner is allowed to send PAUSE frames\n"
9010 msgstr ""
9011
9012 #. type: Plain text
9013 #: build/C/man4/sk98lin.4:335
9014 msgid "Note that this parameter is ignored if AutoNeg_A is set to I<Off>."
9015 msgstr ""
9016
9017 #. type: TP
9018 #: build/C/man4/sk98lin.4:335
9019 #, no-wrap
9020 msgid "B<FlowCtrl_B=>I<i,j,...>"
9021 msgstr ""
9022
9023 #. type: Plain text
9024 #: build/C/man4/sk98lin.4:369
9025 msgid "Note that this parameter is ignored if AutoNeg_B is set to I<Off>."
9026 msgstr ""
9027
9028 #. type: TP
9029 #: build/C/man4/sk98lin.4:369
9030 #, no-wrap
9031 msgid "B<Role_A=>I<i,j,...>"
9032 msgstr ""
9033
9034 #. type: Plain text
9035 #: build/C/man4/sk98lin.4:386
9036 msgid ""
9037 "This parameter is valid only for 1000Base-T adapter cards.  For two "
9038 "1000Base-T ports to communicate, one must take the role of the master "
9039 "(providing timing information), while the other must be the slave.  Possible "
9040 "values are: I<Auto>, I<Master> or I<Slave> whereas I<Auto> is the default.  "
9041 "Usually, the role of a port is negotiated between two ports during link "
9042 "establishment, but if that fails the port A of an adapter card can be forced "
9043 "to a specific setting with this parameter."
9044 msgstr ""
9045
9046 #. type: TP
9047 #: build/C/man4/sk98lin.4:386
9048 #, no-wrap
9049 msgid "B<Role_B=>I<i,j,...>"
9050 msgstr ""
9051
9052 #. type: Plain text
9053 #: build/C/man4/sk98lin.4:404
9054 msgid ""
9055 "This parameter is valid only for 1000Base-T adapter cards.  For two "
9056 "1000Base-T ports to communicate, one must take the role of the master "
9057 "(providing timing information), while the other must be the slave.  Possible "
9058 "values are: I<Auto>, I<Master> or I<Slave> whereas I<Auto> is the default.  "
9059 "Usually, the role of a port is negotiated between two ports during link "
9060 "establishment, but if that fails the port B of an adapter card can be forced "
9061 "to a specific setting with this parameter."
9062 msgstr ""
9063
9064 #. type: TP
9065 #: build/C/man4/sk98lin.4:404
9066 #, no-wrap
9067 msgid "B<ConType=>I<i,j,...>"
9068 msgstr ""
9069
9070 #. type: Plain text
9071 #: build/C/man4/sk98lin.4:412
9072 msgid ""
9073 "This parameter is a combination of all five per-port parameters within one "
9074 "single parameter.  This simplifies the configuration of both ports of an "
9075 "adapter card.  The different values of this variable reflect the most "
9076 "meaningful combinations of port parameters.  Possible values and their "
9077 "corresponding combination of per-port parameters:"
9078 msgstr ""
9079
9080 #. type: Plain text
9081 #: build/C/man4/sk98lin.4:417
9082 #, no-wrap
9083 msgid ""
9084 "ConType | DupCap   AutoNeg   FlowCtrl   Role   Speed\n"
9085 "--------+-------------------------------------------\n"
9086 "I<Auto>    |  Both      On      SymOrRem   Auto   Auto\n"
9087 msgstr ""
9088
9089 #. type: Plain text
9090 #: build/C/man4/sk98lin.4:419
9091 #, no-wrap
9092 msgid "I<100FD>   |  Full      Off       None     Auto   100\n"
9093 msgstr ""
9094
9095 #. type: Plain text
9096 #: build/C/man4/sk98lin.4:421
9097 #, no-wrap
9098 msgid "I<100HD>   |  Half      Off       None     Auto   100\n"
9099 msgstr ""
9100
9101 #. type: Plain text
9102 #: build/C/man4/sk98lin.4:423
9103 #, no-wrap
9104 msgid "I<10FD>    |  Full      Off       None     Auto   10\n"
9105 msgstr ""
9106
9107 #. type: Plain text
9108 #: build/C/man4/sk98lin.4:425
9109 #, no-wrap
9110 msgid "I<10HD>    |  Half      Off       None     Auto   10\n"
9111 msgstr ""
9112
9113 #. type: Plain text
9114 #: build/C/man4/sk98lin.4:435
9115 msgid ""
9116 "Stating any other port parameter together with this I<ConType> parameter "
9117 "will result in a merged configuration of those settings.  This is due to the "
9118 "fact, that the per-port parameters (e.g., I<Speed_A>)  have a higher "
9119 "priority than the combined variable I<ConType>."
9120 msgstr ""
9121
9122 #. type: TP
9123 #: build/C/man4/sk98lin.4:435
9124 #, no-wrap
9125 msgid "B<Moderation=>I<i,j,...>"
9126 msgstr ""
9127
9128 #. type: Plain text
9129 #: build/C/man4/sk98lin.4:453
9130 msgid ""
9131 "Interrupt moderation is employed to limit the maximum number of interrupts "
9132 "the driver has to serve.  That is, one or more interrupts (which indicate "
9133 "any transmit or receive packet to be processed) are queued until the driver "
9134 "processes them.  When queued interrupts are to be served, is determined by "
9135 "the I<IntsPerSec> parameter, which is explained later below.  Possible "
9136 "moderation modes are: I<None>, I<Static> or I<Dynamic> whereas I<None> is "
9137 "the default.  The different modes have the following meaning:"
9138 msgstr ""
9139
9140 #. type: Plain text
9141 #: build/C/man4/sk98lin.4:458
9142 msgid ""
9143 "I<None> No interrupt moderation is applied on the adapter card.  Therefore, "
9144 "each transmit or receive interrupt is served immediately as soon as it "
9145 "appears on the interrupt line of the adapter card."
9146 msgstr ""
9147
9148 #. type: Plain text
9149 #: build/C/man4/sk98lin.4:473
9150 msgid ""
9151 "I<Static> Interrupt moderation is applied on the adapter card.  All transmit "
9152 "and receive interrupts are queued until a complete moderation interval "
9153 "ends.  If such a moderation interval ends, all queued interrupts are "
9154 "processed in one big bunch without any delay.  The term I<Static> reflects "
9155 "the fact, that interrupt moderation is always enabled, regardless how much "
9156 "network load is currently passing via a particular interface.  In addition, "
9157 "the duration of the moderation interval has a fixed length that never "
9158 "changes while the driver is operational."
9159 msgstr ""
9160
9161 #. type: Plain text
9162 #: build/C/man4/sk98lin.4:484
9163 msgid ""
9164 "I<Dynamic> Interrupt moderation might be applied on the adapter card, "
9165 "depending on the load of the system.  If the driver detects that the system "
9166 "load is too high, the driver tries to shield the system against too much "
9167 "network load by enabling interrupt moderation.  If\\(emat a later "
9168 "time\\(emthe CPU utilization decreases again (or if the network load is "
9169 "negligible) the interrupt moderation will automatically be disabled."
9170 msgstr ""
9171
9172 #. type: Plain text
9173 #: build/C/man4/sk98lin.4:490
9174 msgid ""
9175 "Interrupt moderation should be used when the driver has to handle one or "
9176 "more interfaces with a high network load, which\\(emas a "
9177 "consequence\\(emleads also to a high CPU utilization.  When moderation is "
9178 "applied in such high network load situations, CPU load might be reduced by "
9179 "20-30% on slow computers."
9180 msgstr ""
9181
9182 #. type: Plain text
9183 #: build/C/man4/sk98lin.4:494
9184 msgid ""
9185 "Note that the drawback of using interrupt moderation is an increase of the "
9186 "round-trip-time (RTT), due to the queuing and serving of interrupts at "
9187 "dedicated moderation times."
9188 msgstr ""
9189
9190 #. type: TP
9191 #: build/C/man4/sk98lin.4:494
9192 #, no-wrap
9193 msgid "B<IntsPerSec=>I<i,j,...>"
9194 msgstr ""
9195
9196 #. type: Plain text
9197 #: build/C/man4/sk98lin.4:504
9198 msgid ""
9199 "This parameter determines the length of any interrupt moderation interval.  "
9200 "Assuming that static interrupt moderation is to be used, an I<IntsPerSec> "
9201 "parameter value of 2000 will lead to an interrupt moderation interval of 500 "
9202 "microseconds.  Possible values for this parameter are in the range of "
9203 "30...40000 (interrupts per second).  The default value is 2000."
9204 msgstr ""
9205
9206 #. type: Plain text
9207 #: build/C/man4/sk98lin.4:508
9208 msgid ""
9209 "This parameter is used only if either static or dynamic interrupt moderation "
9210 "is enabled on a network adapter card.  This parameter is ignored if no "
9211 "moderation is applied."
9212 msgstr ""
9213
9214 #. type: Plain text
9215 #: build/C/man4/sk98lin.4:515
9216 msgid ""
9217 "Note that the duration of the moderation interval is to be chosen with "
9218 "care.  At first glance, selecting a very long duration (e.g., only 100 "
9219 "interrupts per second) seems to be meaningful, but the increase of "
9220 "packet-processing delay is tremendous.  On the other hand, selecting a very "
9221 "short moderation time might compensate the use of any moderation being "
9222 "applied."
9223 msgstr ""
9224
9225 #. type: TP
9226 #: build/C/man4/sk98lin.4:515
9227 #, no-wrap
9228 msgid "B<PrefPort=>I<i,j,...>"
9229 msgstr ""
9230
9231 #. type: Plain text
9232 #: build/C/man4/sk98lin.4:528
9233 msgid ""
9234 "This parameter is used to force the preferred port to A or B (on dual-port "
9235 "network adapters).  The preferred port is the one that is used if both ports "
9236 "A and B are detected as fully functional.  Possible values are: I<A> or I<B> "
9237 "whereas I<A> is the default."
9238 msgstr ""
9239
9240 #. type: TP
9241 #: build/C/man4/sk98lin.4:528
9242 #, no-wrap
9243 msgid "B<RlmtMode=>I<i,j,...>"
9244 msgstr ""
9245
9246 #. type: Plain text
9247 #: build/C/man4/sk98lin.4:545
9248 msgid ""
9249 "RLMT monitors the status of the port.  If the link of the active port fails, "
9250 "RLMT switches immediately to the standby link.  The virtual link is "
9251 "maintained as long as at least one \"physical\" link is up.  This parameters "
9252 "states how RLMT should monitor both ports.  Possible values are: "
9253 "I<CheckLinkState>, I<CheckLocalPort>, I<CheckSeg> or I<DualNet> whereas "
9254 "I<CheckLinkState> is the default.  The different modes have the following "
9255 "meaning:"
9256 msgstr ""
9257
9258 #. type: Plain text
9259 #: build/C/man4/sk98lin.4:550
9260 msgid ""
9261 "I<CheckLinkState> Check link state only: RLMT uses the link state reported "
9262 "by the adapter hardware for each individual port to determine whether a port "
9263 "can be used for all network traffic or not."
9264 msgstr ""
9265
9266 #. type: Plain text
9267 #: build/C/man4/sk98lin.4:558
9268 msgid ""
9269 "I<CheckLocalPort> In this mode, RLMT monitors the network path between the "
9270 "two ports of an adapter by regularly exchanging packets between them.  This "
9271 "mode requires a network configuration in which the two ports are able to "
9272 "\"see\" each other (i.e., there must not be any router between the ports)."
9273 msgstr ""
9274
9275 #. type: Plain text
9276 #: build/C/man4/sk98lin.4:567
9277 msgid ""
9278 "I<CheckSeg> Check local port and segmentation: This mode supports the same "
9279 "functions as the CheckLocalPort mode and additionally checks network "
9280 "segmentation between the ports.  Therefore, this mode is to be used only if "
9281 "Gigabit Ethernet switches are installed on the network that have been "
9282 "configured to use the Spanning Tree protocol."
9283 msgstr ""
9284
9285 #. type: Plain text
9286 #: build/C/man4/sk98lin.4:578
9287 msgid ""
9288 "I<DualNet> In this mode, ports A and B are used as separate devices.  If you "
9289 "have a dual port adapter, port A will be configured as I<eth[x]> and port B "
9290 "as I<eth[x+1]>.  Both ports can be used independently with distinct IP "
9291 "addresses.  The preferred port setting is not used.  RLMT is turned off."
9292 msgstr ""
9293
9294 #. type: Plain text
9295 #: build/C/man4/sk98lin.4:587
9296 msgid ""
9297 "Note that RLMT modes I<CheckLocalPort> and I<CheckLinkState> are designed to "
9298 "operate in configurations where a network path between the ports on one "
9299 "adapter exists.  Moreover, they are not designed to work where adapters are "
9300 "connected back-to-back."
9301 msgstr ""
9302
9303 #. type: TP
9304 #: build/C/man4/sk98lin.4:588
9305 #, no-wrap
9306 msgid "I</proc/net/sk98lin/eth[x]>"
9307 msgstr ""
9308
9309 #. type: Plain text
9310 #: build/C/man4/sk98lin.4:594
9311 msgid ""
9312 "The statistics file of a particular interface of an adapter card.  It "
9313 "contains generic information about the adapter card plus a detailed summary "
9314 "of all transmit and receive counters."
9315 msgstr ""
9316
9317 #. type: TP
9318 #: build/C/man4/sk98lin.4:594
9319 #, no-wrap
9320 msgid "I</usr/src/linux/Documentation/networking/sk98lin.txt>"
9321 msgstr ""
9322
9323 #. type: Plain text
9324 #: build/C/man4/sk98lin.4:605
9325 msgid ""
9326 "This is the I<README> file of the I<sk98lin> driver.  It contains a detailed "
9327 "installation HOWTO and describes all parameters of the driver.  It denotes "
9328 "also common problems and provides the solution to them."
9329 msgstr ""
9330
9331 #.  .SH AUTHORS
9332 #.  Ralph Roesler \(em rroesler@syskonnect.de
9333 #.  .br
9334 #.  Mirko Lindner \(em mlindner@syskonnect.de
9335 #. type: Plain text
9336 #: build/C/man4/sk98lin.4:611
9337 msgid "Report any bugs to linux@syskonnect.de"
9338 msgstr ""
9339
9340 #. type: Plain text
9341 #: build/C/man4/sk98lin.4:615
9342 msgid "B<ifconfig>(8), B<insmod>(8), B<modprobe>(8)"
9343 msgstr ""
9344
9345 #. type: TH
9346 #: build/C/man4/st.4:25
9347 #, no-wrap
9348 msgid "ST"
9349 msgstr ""
9350
9351 #. type: Plain text
9352 #: build/C/man4/st.4:28
9353 msgid "st - SCSI tape device"
9354 msgstr ""
9355
9356 #. type: Plain text
9357 #: build/C/man4/st.4:31
9358 #, no-wrap
9359 msgid "B<#include E<lt>sys/mtio.hE<gt>>\n"
9360 msgstr ""
9361
9362 #. type: Plain text
9363 #: build/C/man4/st.4:36
9364 #, no-wrap
9365 msgid ""
9366 "B<int ioctl(int >I<fd>B<, int >I<request>B< [, (void *)>I<arg3>B<]);>\n"
9367 "B<int ioctl(int >I<fd>B<, MTIOCTOP, (struct mtop *)>I<mt_cmd>B<);>\n"
9368 "B<int ioctl(int >I<fd>B<, MTIOCGET, (struct mtget *)>I<mt_status>B<);>\n"
9369 "B<int ioctl(int >I<fd>B<, MTIOCPOS, (struct mtpos *)>I<mt_pos>B<);>\n"
9370 msgstr ""
9371
9372 #. type: Plain text
9373 #: build/C/man4/st.4:46
9374 msgid ""
9375 "The B<st> driver provides the interface to a variety of SCSI tape devices.  "
9376 "Currently, the driver takes control of all detected devices of type "
9377 "\\(lqsequential-access\\(rq.  The B<st> driver uses major device number 9."
9378 msgstr ""
9379
9380 #. type: Plain text
9381 #: build/C/man4/st.4:66
9382 msgid ""
9383 "Each device uses eight minor device numbers.  The lowermost five bits in the "
9384 "minor numbers are assigned sequentially in the order of detection.  In the "
9385 "2.6 kernel, the bits above the eight lowermost bits are concatenated to the "
9386 "five lowermost bits to form the tape number.  The minor numbers can be "
9387 "grouped into two sets of four numbers: the principal (auto-rewind) minor "
9388 "device numbers, I<n>, and the \\(lqno-rewind\\(rq device numbers, (I<n> + "
9389 "128).  Devices opened using the principal device number will be sent a "
9390 "B<REWIND> command when they are closed.  Devices opened using the "
9391 "\\(lqno-rewind\\(rq device number will not.  (Note that using an auto-rewind "
9392 "device for positioning the tape with, for instance, mt does not lead to the "
9393 "desired result: the tape is rewound after the mt command and the next "
9394 "command starts from the beginning of the tape)."
9395 msgstr ""
9396
9397 #. type: Plain text
9398 #: build/C/man4/st.4:80
9399 msgid ""
9400 "Within each group, four minor numbers are available to define devices with "
9401 "different characteristics (block size, compression, density, etc.)  When the "
9402 "system starts up, only the first device is available.  The other three are "
9403 "activated when the default characteristics are defined (see below).  (By "
9404 "changing compile-time constants, it is possible to change the balance "
9405 "between the maximum number of tape drives and the number of minor numbers "
9406 "for each drive.  The default allocation allows control of 32 tape drives.  "
9407 "For instance, it is possible to control up to 64 tape drives with two minor "
9408 "numbers for different options.)"
9409 msgstr ""
9410
9411 #. type: Plain text
9412 #: build/C/man4/st.4:82
9413 msgid "Devices are typically created by:"
9414 msgstr ""
9415
9416 #. type: Plain text
9417 #: build/C/man4/st.4:93
9418 #, no-wrap
9419 msgid ""
9420 "mknod -m 666 /dev/st0 c 9 0\n"
9421 "mknod -m 666 /dev/st0l c 9 32\n"
9422 "mknod -m 666 /dev/st0m c 9 64\n"
9423 "mknod -m 666 /dev/st0a c 9 96\n"
9424 "mknod -m 666 /dev/nst0 c 9 128\n"
9425 "mknod -m 666 /dev/nst0l c 9 160\n"
9426 "mknod -m 666 /dev/nst0m c 9 192\n"
9427 "mknod -m 666 /dev/nst0a c 9 224\n"
9428 msgstr ""
9429
9430 #. type: Plain text
9431 #: build/C/man4/st.4:97
9432 msgid "There is no corresponding block device."
9433 msgstr ""
9434
9435 #. type: Plain text
9436 #: build/C/man4/st.4:112
9437 msgid ""
9438 "The driver uses an internal buffer that has to be large enough to hold at "
9439 "least one tape block.  In kernels before 2.1.121, the buffer is allocated as "
9440 "one contiguous block.  This limits the block size to the largest contiguous "
9441 "block of memory the kernel allocator can provide.  The limit is currently "
9442 "128 kB for 32-bit architectures and 256 kB for 64-bit architectures.  In "
9443 "newer kernels the driver allocates the buffer in several parts if "
9444 "necessary.  By default, the maximum number of parts is 16.  This means that "
9445 "the maximum block size is very large (2 MB if allocation of 16 blocks of 128 "
9446 "kB succeeds)."
9447 msgstr ""
9448
9449 #. type: Plain text
9450 #: build/C/man4/st.4:121
9451 msgid ""
9452 "The driver's internal buffer size is determined by a compile-time constant "
9453 "which can be overridden with a kernel startup option.  In addition to this, "
9454 "the driver tries to allocate a larger temporary buffer at run time if "
9455 "necessary.  However, run-time allocation of large contiguous blocks of "
9456 "memory may fail and it is advisable not to rely too much on dynamic buffer "
9457 "allocation with kernels older than 2.1.121 (this applies also to "
9458 "demand-loading the driver with kerneld or kmod)."
9459 msgstr ""
9460
9461 #. type: Plain text
9462 #: build/C/man4/st.4:134
9463 msgid ""
9464 "The driver does not specifically support any tape drive brand or model.  "
9465 "After system start-up the tape device options are defined by the drive "
9466 "firmware.  For example, if the drive firmware selects fixed-block mode, the "
9467 "tape device uses fixed-block mode.  The options can be changed with explicit "
9468 "B<ioctl>(2)  calls and remain in effect when the device is closed and "
9469 "reopened.  Setting the options affects both the auto-rewind and the "
9470 "nonrewind device."
9471 msgstr ""
9472
9473 #. type: Plain text
9474 #: build/C/man4/st.4:143
9475 msgid ""
9476 "Different options can be specified for the different devices within the "
9477 "subgroup of four.  The options take effect when the device is opened.  For "
9478 "example, the system administrator can define one device that writes in "
9479 "fixed-block mode with a certain block size, and one which writes in "
9480 "variable-block mode (if the drive supports both modes)."
9481 msgstr ""
9482
9483 #. type: Plain text
9484 #: build/C/man4/st.4:166
9485 msgid ""
9486 "The driver supports B<tape partitions> if they are supported by the drive.  "
9487 "(Note that the tape partitions have nothing to do with disk partitions.  A "
9488 "partitioned tape can be seen as several logical tapes within one medium.)  "
9489 "Partition support has to be enabled with an B<ioctl>(2).  The tape location "
9490 "is preserved within each partition across partition changes.  The partition "
9491 "used for subsequent tape operations is selected with an B<ioctl>(2).  The "
9492 "partition switch is executed together with the next tape operation in order "
9493 "to avoid unnecessary tape movement.  The maximum number of partitions on a "
9494 "tape is defined by a compile-time constant (originally four).  The driver "
9495 "contains an B<ioctl>(2)  that can format a tape with either one or two "
9496 "partitions."
9497 msgstr ""
9498
9499 #. type: Plain text
9500 #: build/C/man4/st.4:171
9501 msgid ""
9502 "Device I</dev/tape> is usually created as a hard or soft link to the default "
9503 "tape device on the system."
9504 msgstr ""
9505
9506 #. type: Plain text
9507 #: build/C/man4/st.4:175
9508 msgid ""
9509 "Starting from kernel 2.6.2, the driver exports in the sysfs directory "
9510 "I</sys/class/scsi_tape> the attached devices and some parameters assigned to "
9511 "the devices."
9512 msgstr ""
9513
9514 #. type: SS
9515 #: build/C/man4/st.4:175
9516 #, no-wrap
9517 msgid "Data transfer"
9518 msgstr ""
9519
9520 #. type: Plain text
9521 #: build/C/man4/st.4:188
9522 msgid ""
9523 "The driver supports operation in both fixed-block mode and variable-block "
9524 "mode (if supported by the drive).  In fixed-block mode the drive writes "
9525 "blocks of the specified size and the block size is not dependent on the byte "
9526 "counts of the write system calls.  In variable-block mode one tape block is "
9527 "written for each write call and the byte count determines the size of the "
9528 "corresponding tape block.  Note that the blocks on the tape don't contain "
9529 "any information about the writing mode: when reading, the only important "
9530 "thing is to use commands that accept the block sizes on the tape."
9531 msgstr ""
9532
9533 #. type: Plain text
9534 #: build/C/man4/st.4:197
9535 msgid ""
9536 "In variable-block mode the read byte count does not have to match the tape "
9537 "block size exactly.  If the byte count is larger than the next block on "
9538 "tape, the driver returns the data and the function returns the actual block "
9539 "size.  If the block size is larger than the byte count, the requested amount "
9540 "of data from the start of the block is returned and the rest of the block is "
9541 "discarded."
9542 msgstr ""
9543
9544 #. type: Plain text
9545 #: build/C/man4/st.4:206
9546 msgid ""
9547 "In fixed-block mode the read byte counts can be arbitrary if buffering is "
9548 "enabled, or a multiple of the tape block size if buffering is disabled.  "
9549 "Kernels before 2.1.121 allow writes with arbitrary byte count if buffering "
9550 "is enabled.  In all other cases (kernel before 2.1.121 with buffering "
9551 "disabled or newer kernel) the write byte count must be a multiple of the "
9552 "tape block size."
9553 msgstr ""
9554
9555 #. type: Plain text
9556 #: build/C/man4/st.4:215
9557 msgid ""
9558 "In the 2.6 kernel, the driver tries to use direct transfers between the user "
9559 "buffer and the device.  If this is not possible, the driver's internal "
9560 "buffer is used.  The reasons for not using direct transfers include improper "
9561 "alignment of the user buffer (default is 512 bytes but this can be changed "
9562 "by the HBA driver), one of more pages of the user buffer not reachable by "
9563 "the SCSI adapter, etc."
9564 msgstr ""
9565
9566 #. type: Plain text
9567 #: build/C/man4/st.4:218
9568 msgid ""
9569 "A filemark is automatically written to tape if the last tape operation "
9570 "before close was a write."
9571 msgstr ""
9572
9573 #. type: Plain text
9574 #: build/C/man4/st.4:230
9575 msgid ""
9576 "When a filemark is encountered while reading, the following happens.  If "
9577 "there are data remaining in the buffer when the filemark is found, the "
9578 "buffered data is returned.  The next read returns zero bytes.  The following "
9579 "read returns data from the next file.  The end of recorded data is signaled "
9580 "by returning zero bytes for two consecutive read calls.  The third read "
9581 "returns an error."
9582 msgstr ""
9583
9584 #. type: SS
9585 #: build/C/man4/st.4:230
9586 #, no-wrap
9587 msgid "Ioctls"
9588 msgstr ""
9589
9590 #. type: Plain text
9591 #: build/C/man4/st.4:241
9592 msgid ""
9593 "The driver supports three B<ioctl>(2)  requests.  Requests not recognized by "
9594 "the B<st> driver are passed to the B<SCSI> driver.  The definitions below "
9595 "are from I</usr/include/linux/mtio.h>:"
9596 msgstr ""
9597
9598 #. type: SS
9599 #: build/C/man4/st.4:241
9600 #, no-wrap
9601 msgid "MTIOCTOP \\(em perform a tape operation"
9602 msgstr ""
9603
9604 #. type: Plain text
9605 #: build/C/man4/st.4:249
9606 msgid ""
9607 "This request takes an argument of type I<(struct mtop\\ *)>.  Not all drives "
9608 "support all operations.  The driver returns an B<EIO> error if the drive "
9609 "rejects an operation."
9610 msgstr ""
9611
9612 #. type: Plain text
9613 #: build/C/man4/st.4:257
9614 #, no-wrap
9615 msgid ""
9616 "/* Structure for MTIOCTOP - mag tape op command: */\n"
9617 "struct mtop {\n"
9618 "    short   mt_op;       /* operations defined below */\n"
9619 "    int     mt_count;    /* how many of them */\n"
9620 "};\n"
9621 msgstr ""
9622
9623 #. type: Plain text
9624 #: build/C/man4/st.4:261
9625 msgid "Magnetic Tape operations for normal tape use:"
9626 msgstr ""
9627
9628 #. type: TP
9629 #: build/C/man4/st.4:261
9630 #, no-wrap
9631 msgid "B<MTBSF>"
9632 msgstr ""
9633
9634 #. type: Plain text
9635 #: build/C/man4/st.4:266
9636 msgid "Backward space over I<mt_count> filemarks."
9637 msgstr ""
9638
9639 #. type: TP
9640 #: build/C/man4/st.4:266
9641 #, no-wrap
9642 msgid "B<MTBSFM>"
9643 msgstr ""
9644
9645 #. type: Plain text
9646 #: build/C/man4/st.4:272
9647 msgid ""
9648 "Backward space over I<mt_count> filemarks.  Reposition the tape to the EOT "
9649 "side of the last filemark."
9650 msgstr ""
9651
9652 #. type: TP
9653 #: build/C/man4/st.4:272
9654 #, no-wrap
9655 msgid "B<MTBSR>"
9656 msgstr ""
9657
9658 #. type: Plain text
9659 #: build/C/man4/st.4:277
9660 msgid "Backward space over I<mt_count> records (tape blocks)."
9661 msgstr ""
9662
9663 #. type: TP
9664 #: build/C/man4/st.4:277
9665 #, no-wrap
9666 msgid "B<MTBSS>"
9667 msgstr ""
9668
9669 #. type: Plain text
9670 #: build/C/man4/st.4:282
9671 msgid "Backward space over I<mt_count> setmarks."
9672 msgstr ""
9673
9674 #. type: TP
9675 #: build/C/man4/st.4:282
9676 #, no-wrap
9677 msgid "B<MTCOMPRESSION>"
9678 msgstr ""
9679
9680 #. type: Plain text
9681 #: build/C/man4/st.4:290
9682 msgid ""
9683 "Enable compression of tape data within the drive if I<mt_count> is nonzero "
9684 "and disable compression if I<mt_count> is zero.  This command uses the MODE "
9685 "page 15 supported by most DATs."
9686 msgstr ""
9687
9688 #. type: TP
9689 #: build/C/man4/st.4:290
9690 #, no-wrap
9691 msgid "B<MTEOM>"
9692 msgstr ""
9693
9694 #. type: Plain text
9695 #: build/C/man4/st.4:293
9696 msgid "Go to the end of the recorded media (for appending files)."
9697 msgstr ""
9698
9699 #. type: TP
9700 #: build/C/man4/st.4:293
9701 #, no-wrap
9702 msgid "B<MTERASE>"
9703 msgstr ""
9704
9705 #. type: Plain text
9706 #: build/C/man4/st.4:299
9707 msgid ""
9708 "Erase tape.  With 2.6 kernel, short erase (mark tape empty) is performed if "
9709 "the argument is zero.  Otherwise long erase (erase all) is done."
9710 msgstr ""
9711
9712 #. type: TP
9713 #: build/C/man4/st.4:299
9714 #, no-wrap
9715 msgid "B<MTFSF>"
9716 msgstr ""
9717
9718 #. type: Plain text
9719 #: build/C/man4/st.4:304
9720 msgid "Forward space over I<mt_count> filemarks."
9721 msgstr ""
9722
9723 #. type: TP
9724 #: build/C/man4/st.4:304
9725 #, no-wrap
9726 msgid "B<MTFSFM>"
9727 msgstr ""
9728
9729 #. type: Plain text
9730 #: build/C/man4/st.4:310
9731 msgid ""
9732 "Forward space over I<mt_count> filemarks.  Reposition the tape to the BOT "
9733 "side of the last filemark."
9734 msgstr ""
9735
9736 #. type: TP
9737 #: build/C/man4/st.4:310
9738 #, no-wrap
9739 msgid "B<MTFSR>"
9740 msgstr ""
9741
9742 #. type: Plain text
9743 #: build/C/man4/st.4:315
9744 msgid "Forward space over I<mt_count> records (tape blocks)."
9745 msgstr ""
9746
9747 #. type: TP
9748 #: build/C/man4/st.4:315
9749 #, no-wrap
9750 msgid "B<MTFSS>"
9751 msgstr ""
9752
9753 #. type: Plain text
9754 #: build/C/man4/st.4:320
9755 msgid "Forward space over I<mt_count> setmarks."
9756 msgstr ""
9757
9758 #. type: TP
9759 #: build/C/man4/st.4:320
9760 #, no-wrap
9761 msgid "B<MTLOAD>"
9762 msgstr ""
9763
9764 #. type: Plain text
9765 #: build/C/man4/st.4:331
9766 msgid ""
9767 "Execute the SCSI load command.  A special case is available for some HP "
9768 "autoloaders.  If I<mt_count> is the constant B<MT_ST_HPLOADER_OFFSET> plus a "
9769 "number, the number is sent to the drive to control the autoloader."
9770 msgstr ""
9771
9772 #. type: TP
9773 #: build/C/man4/st.4:331
9774 #, no-wrap
9775 msgid "B<MTLOCK>"
9776 msgstr ""
9777
9778 #. type: Plain text
9779 #: build/C/man4/st.4:334
9780 msgid "Lock the tape drive door."
9781 msgstr ""
9782
9783 #. type: TP
9784 #: build/C/man4/st.4:334
9785 #, no-wrap
9786 msgid "B<MTMKPART>"
9787 msgstr ""
9788
9789 #. type: Plain text
9790 #: build/C/man4/st.4:348
9791 msgid ""
9792 "Format the tape into one or two partitions.  If I<mt_count> is nonzero, it "
9793 "gives the size of the first partition and the second partition contains the "
9794 "rest of the tape.  If I<mt_count> is zero, the tape is formatted into one "
9795 "partition.  This command is not allowed for a drive unless the partition "
9796 "support is enabled for the drive (see B<MT_ST_CAN_PARTITIONS> below)."
9797 msgstr ""
9798
9799 #. type: TP
9800 #: build/C/man4/st.4:348
9801 #, no-wrap
9802 msgid "B<MTNOP>"
9803 msgstr ""
9804
9805 #. type: Plain text
9806 #: build/C/man4/st.4:353
9807 msgid ""
9808 "No op\\(emflushes the driver's buffer as a side effect.  Should be used "
9809 "before reading status with B<MTIOCGET>."
9810 msgstr ""
9811
9812 #. type: TP
9813 #: build/C/man4/st.4:353
9814 #, no-wrap
9815 msgid "B<MTOFFL>"
9816 msgstr ""
9817
9818 #. type: Plain text
9819 #: build/C/man4/st.4:356
9820 msgid "Rewind and put the drive off line."
9821 msgstr ""
9822
9823 #. type: TP
9824 #: build/C/man4/st.4:356
9825 #, no-wrap
9826 msgid "B<MTRESET>"
9827 msgstr ""
9828
9829 #. type: Plain text
9830 #: build/C/man4/st.4:359
9831 msgid "Reset drive."
9832 msgstr ""
9833
9834 #. type: TP
9835 #: build/C/man4/st.4:359
9836 #, no-wrap
9837 msgid "B<MTRETEN>"
9838 msgstr ""
9839
9840 #. type: Plain text
9841 #: build/C/man4/st.4:362
9842 msgid "Re-tension tape."
9843 msgstr ""
9844
9845 #. type: TP
9846 #: build/C/man4/st.4:362
9847 #, no-wrap
9848 msgid "B<MTREW>"
9849 msgstr ""
9850
9851 #. type: Plain text
9852 #: build/C/man4/st.4:365
9853 msgid "Rewind."
9854 msgstr ""
9855
9856 #. type: TP
9857 #: build/C/man4/st.4:365
9858 #, no-wrap
9859 msgid "B<MTSEEK>"
9860 msgstr ""
9861
9862 #. type: Plain text
9863 #: build/C/man4/st.4:377
9864 msgid ""
9865 "Seek to the tape block number specified in I<mt_count>.  This operation "
9866 "requires either a SCSI-2 drive that supports the B<LOCATE> command "
9867 "(device-specific address)  or a Tandberg-compatible SCSI-1 drive (Tandberg, "
9868 "Archive Viper, Wangtek, ...).  The block number should be one that was "
9869 "previously returned by B<MTIOCPOS> if device-specific addresses are used."
9870 msgstr ""
9871
9872 #. type: TP
9873 #: build/C/man4/st.4:377
9874 #, no-wrap
9875 msgid "B<MTSETBLK>"
9876 msgstr ""
9877
9878 #. type: Plain text
9879 #: build/C/man4/st.4:382
9880 msgid ""
9881 "Set the drive's block length to the value specified in I<mt_count>.  A block "
9882 "length of zero sets the drive to variable block size mode."
9883 msgstr ""
9884
9885 #. type: TP
9886 #: build/C/man4/st.4:382
9887 #, no-wrap
9888 msgid "B<MTSETDENSITY>"
9889 msgstr ""
9890
9891 #. type: Plain text
9892 #: build/C/man4/st.4:388
9893 msgid ""
9894 "Set the tape density to the code in I<mt_count>.  The density codes "
9895 "supported by a drive can be found from the drive documentation."
9896 msgstr ""
9897
9898 #. type: TP
9899 #: build/C/man4/st.4:388
9900 #, no-wrap
9901 msgid "B<MTSETPART>"
9902 msgstr ""
9903
9904 #. type: Plain text
9905 #: build/C/man4/st.4:397
9906 msgid ""
9907 "The active partition is switched to I<mt_count>.  The partitions are "
9908 "numbered from zero.  This command is not allowed for a drive unless the "
9909 "partition support is enabled for the drive (see B<MT_ST_CAN_PARTITIONS> "
9910 "below)."
9911 msgstr ""
9912
9913 #. type: TP
9914 #: build/C/man4/st.4:397
9915 #, no-wrap
9916 msgid "B<MTUNLOAD>"
9917 msgstr ""
9918
9919 #. type: Plain text
9920 #: build/C/man4/st.4:400
9921 msgid "Execute the SCSI unload command (does not eject the tape)."
9922 msgstr ""
9923
9924 #. type: TP
9925 #: build/C/man4/st.4:400
9926 #, no-wrap
9927 msgid "B<MTUNLOCK>"
9928 msgstr ""
9929
9930 #. type: Plain text
9931 #: build/C/man4/st.4:403
9932 msgid "Unlock the tape drive door."
9933 msgstr ""
9934
9935 #. type: TP
9936 #: build/C/man4/st.4:403
9937 #, no-wrap
9938 msgid "B<MTWEOF>"
9939 msgstr ""
9940
9941 #. type: Plain text
9942 #: build/C/man4/st.4:408
9943 msgid "Write I<mt_count> filemarks."
9944 msgstr ""
9945
9946 #. type: TP
9947 #: build/C/man4/st.4:408
9948 #, no-wrap
9949 msgid "B<MTWSM>"
9950 msgstr ""
9951
9952 #. type: Plain text
9953 #: build/C/man4/st.4:413
9954 msgid "Write I<mt_count> setmarks."
9955 msgstr ""
9956
9957 #. type: Plain text
9958 #: build/C/man4/st.4:415
9959 msgid "Magnetic Tape operations for setting of device options (by the superuser):"
9960 msgstr ""
9961
9962 #. type: TP
9963 #: build/C/man4/st.4:415
9964 #, no-wrap
9965 msgid "B<MTSETDRVBUFFER>"
9966 msgstr ""
9967
9968 #. type: Plain text
9969 #: build/C/man4/st.4:424
9970 msgid ""
9971 "Set various drive and driver options according to bits encoded in "
9972 "I<mt_count>.  These consist of the drive's buffering mode, a set of Boolean "
9973 "driver options, the buffer write threshold, defaults for the block size and "
9974 "density, and timeouts (only in kernels 2.1 and later).  A single operation "
9975 "can affect only one item in the list above (the Booleans counted as one "
9976 "item.)"
9977 msgstr ""
9978
9979 #. type: Plain text
9980 #: build/C/man4/st.4:428
9981 msgid ""
9982 "A value having zeros in the high-order 4 bits will be used to set the "
9983 "drive's buffering mode.  The buffering modes are:"
9984 msgstr ""
9985
9986 #. type: IP
9987 #: build/C/man4/st.4:429
9988 #, no-wrap
9989 msgid "0"
9990 msgstr ""
9991
9992 #. type: Plain text
9993 #: build/C/man4/st.4:434
9994 msgid ""
9995 "The drive will not report B<GOOD> status on write commands until the data "
9996 "blocks are actually written to the medium."
9997 msgstr ""
9998
9999 #. type: IP
10000 #: build/C/man4/st.4:434
10001 #, no-wrap
10002 msgid "1"
10003 msgstr ""
10004
10005 #. type: Plain text
10006 #: build/C/man4/st.4:439
10007 msgid ""
10008 "The drive may report B<GOOD> status on write commands as soon as all the "
10009 "data has been transferred to the drive's internal buffer."
10010 msgstr ""
10011
10012 #. type: IP
10013 #: build/C/man4/st.4:439
10014 #, no-wrap
10015 msgid "2"
10016 msgstr ""
10017
10018 #. type: Plain text
10019 #: build/C/man4/st.4:446
10020 msgid ""
10021 "The drive may report B<GOOD> status on write commands as soon as (a) all the "
10022 "data has been transferred to the drive's internal buffer, and (b) all "
10023 "buffered data from different initiators has been successfully written to the "
10024 "medium."
10025 msgstr ""
10026
10027 #. type: Plain text
10028 #: build/C/man4/st.4:457
10029 msgid ""
10030 "To control the write threshold the value in I<mt_count> must include the "
10031 "constant B<MT_ST_WRITE_THRESHOLD> bitwise ORed with a block count in the low "
10032 "28 bits.  The block count refers to 1024-byte blocks, not the physical block "
10033 "size on the tape.  The threshold cannot exceed the driver's internal buffer "
10034 "size (see DESCRIPTION, above)."
10035 msgstr ""
10036
10037 #. type: Plain text
10038 #: build/C/man4/st.4:478
10039 msgid ""
10040 "To set and clear the Boolean options the value in I<mt_count> must include "
10041 "one of the constants B<MT_ST_BOOLEANS>, B<MT_ST_SETBOOLEANS>, "
10042 "B<MT_ST_CLEARBOOLEANS>, or B<MT_ST_DEFBOOLEANS> bitwise ORed with whatever "
10043 "combination of the following options is desired.  Using B<MT_ST_BOOLEANS> "
10044 "the options can be set to the values defined in the corresponding bits.  "
10045 "With B<MT_ST_SETBOOLEANS> the options can be selectively set and with "
10046 "B<MT_ST_DEFBOOLEANS> selectively cleared."
10047 msgstr ""
10048
10049 #. type: Plain text
10050 #: build/C/man4/st.4:486
10051 msgid ""
10052 "The default options for a tape device are set with B<MT_ST_DEFBOOLEANS>.  A "
10053 "nonactive tape device (e.g., device with minor 32 or 160) is activated when "
10054 "the default options for it are defined the first time.  An activated device "
10055 "inherits from the device activated at start-up the options not set "
10056 "explicitly."
10057 msgstr ""
10058
10059 #. type: Plain text
10060 #: build/C/man4/st.4:488
10061 msgid "The Boolean options are:"
10062 msgstr ""
10063
10064 #. type: TP
10065 #: build/C/man4/st.4:489
10066 #, no-wrap
10067 msgid "B<MT_ST_BUFFER_WRITES> (Default: true)"
10068 msgstr ""
10069
10070 #. type: Plain text
10071 #: build/C/man4/st.4:495
10072 msgid ""
10073 "Buffer all write operations in fixed-block mode.  If this option is false "
10074 "and the drive uses a fixed block size, then all write operations must be for "
10075 "a multiple of the block size.  This option must be set false to write "
10076 "reliable multivolume archives."
10077 msgstr ""
10078
10079 #. type: TP
10080 #: build/C/man4/st.4:495
10081 #, no-wrap
10082 msgid "B<MT_ST_ASYNC_WRITES> (Default: true)"
10083 msgstr ""
10084
10085 #. type: Plain text
10086 #: build/C/man4/st.4:505
10087 msgid ""
10088 "When this option is true, write operations return immediately without "
10089 "waiting for the data to be transferred to the drive if the data fits into "
10090 "the driver's buffer.  The write threshold determines how full the buffer "
10091 "must be before a new SCSI write command is issued.  Any errors reported by "
10092 "the drive will be held until the next operation.  This option must be set "
10093 "false to write reliable multivolume archives."
10094 msgstr ""
10095
10096 #. type: TP
10097 #: build/C/man4/st.4:505
10098 #, no-wrap
10099 msgid "B<MT_ST_READ_AHEAD> (Default: true)"
10100 msgstr ""
10101
10102 #. type: Plain text
10103 #: build/C/man4/st.4:511
10104 msgid ""
10105 "This option causes the driver to provide read buffering and read-ahead in "
10106 "fixed-block mode.  If this option is false and the drive uses a fixed block "
10107 "size, then all read operations must be for a multiple of the block size."
10108 msgstr ""
10109
10110 #. type: TP
10111 #: build/C/man4/st.4:511
10112 #, no-wrap
10113 msgid "B<MT_ST_TWO_FM> (Default: false)"
10114 msgstr ""
10115
10116 #. type: Plain text
10117 #: build/C/man4/st.4:517
10118 msgid ""
10119 "This option modifies the driver behavior when a file is closed.  The normal "
10120 "action is to write a single filemark.  If the option is true the driver will "
10121 "write two filemarks and backspace over the second one."
10122 msgstr ""
10123
10124 #. type: Plain text
10125 #: build/C/man4/st.4:526
10126 msgid ""
10127 "Note: This option should not be set true for QIC tape drives since they are "
10128 "unable to overwrite a filemark.  These drives detect the end of recorded "
10129 "data by testing for blank tape rather than two consecutive filemarks.  Most "
10130 "other current drives also detect the end of recorded data and using two "
10131 "filemarks is usually necessary only when interchanging tapes with some other "
10132 "systems."
10133 msgstr ""
10134
10135 #. type: TP
10136 #: build/C/man4/st.4:526
10137 #, no-wrap
10138 msgid "B<MT_ST_DEBUGGING> (Default: false)"
10139 msgstr ""
10140
10141 #. type: Plain text
10142 #: build/C/man4/st.4:532
10143 msgid ""
10144 "This option turns on various debugging messages from the driver (effective "
10145 "only if the driver was compiled with B<DEBUG> defined nonzero)."
10146 msgstr ""
10147
10148 #. type: TP
10149 #: build/C/man4/st.4:532
10150 #, no-wrap
10151 msgid "B<MT_ST_FAST_EOM> (Default: false)"
10152 msgstr ""
10153
10154 #. type: Plain text
10155 #: build/C/man4/st.4:546
10156 msgid ""
10157 "This option causes the B<MTEOM> operation to be sent directly to the drive, "
10158 "potentially speeding up the operation but causing the driver to lose track "
10159 "of the current file number normally returned by the B<MTIOCGET> request.  If "
10160 "B<MT_ST_FAST_EOM> is false the driver will respond to an B<MTEOM> request by "
10161 "forward spacing over files."
10162 msgstr ""
10163
10164 #. type: TP
10165 #: build/C/man4/st.4:546
10166 #, no-wrap
10167 msgid "B<MT_ST_AUTO_LOCK> (Default: false)"
10168 msgstr ""
10169
10170 #. type: Plain text
10171 #: build/C/man4/st.4:550
10172 msgid ""
10173 "When this option is true, the drive door is locked when the device is opened "
10174 "and unlocked when it is closed."
10175 msgstr ""
10176
10177 #. type: TP
10178 #: build/C/man4/st.4:550
10179 #, no-wrap
10180 msgid "B<MT_ST_DEF_WRITES> (Default: false)"
10181 msgstr ""
10182
10183 #. type: Plain text
10184 #: build/C/man4/st.4:567
10185 msgid ""
10186 "The tape options (block size, mode, compression, etc.) may change when "
10187 "changing from one device linked to a drive to another device linked to the "
10188 "same drive depending on how the devices are defined.  This option defines "
10189 "when the changes are enforced by the driver using SCSI-commands and when the "
10190 "drives auto-detection capabilities are relied upon.  If this option is "
10191 "false, the driver sends the SCSI-commands immediately when the device is "
10192 "changed.  If the option is true, the SCSI-commands are not sent until a "
10193 "write is requested.  In this case the drive firmware is allowed to detect "
10194 "the tape structure when reading and the SCSI-commands are used only to make "
10195 "sure that a tape is written according to the correct specification."
10196 msgstr ""
10197
10198 #. type: TP
10199 #: build/C/man4/st.4:567
10200 #, no-wrap
10201 msgid "B<MT_ST_CAN_BSR> (Default: false)"
10202 msgstr ""
10203
10204 #. type: Plain text
10205 #: build/C/man4/st.4:580
10206 msgid ""
10207 "When read-ahead is used, the tape must sometimes be spaced backward to the "
10208 "correct position when the device is closed and the SCSI command to space "
10209 "backward over records is used for this purpose.  Some older drives can't "
10210 "process this command reliably and this option can be used to instruct the "
10211 "driver not to use the command.  The end result is that, with read-ahead and "
10212 "fixed-block mode, the tape may not be correctly positioned within a file "
10213 "when the device is closed.  With 2.6 kernel, the default is true for drives "
10214 "supporting SCSI-3."
10215 msgstr ""
10216
10217 #. type: TP
10218 #: build/C/man4/st.4:580
10219 #, no-wrap
10220 msgid "B<MT_ST_NO_BLKLIMS> (Default: false)"
10221 msgstr ""
10222
10223 #. type: Plain text
10224 #: build/C/man4/st.4:589
10225 msgid ""
10226 "Some drives don't accept the B<READ BLOCK LIMITS> SCSI command.  If this is "
10227 "used, the driver does not use the command.  The drawback is that the driver "
10228 "can't check before sending commands if the selected block size is acceptable "
10229 "to the drive."
10230 msgstr ""
10231
10232 #. type: TP
10233 #: build/C/man4/st.4:589
10234 #, no-wrap
10235 msgid "B<MT_ST_CAN_PARTITIONS> (Default: false)"
10236 msgstr ""
10237
10238 #. type: Plain text
10239 #: build/C/man4/st.4:594
10240 msgid ""
10241 "This option enables support for several partitions within a tape.  The "
10242 "option applies to all devices linked to a drive."
10243 msgstr ""
10244
10245 #. type: TP
10246 #: build/C/man4/st.4:594
10247 #, no-wrap
10248 msgid "B<MT_ST_SCSI2LOGICAL> (Default: false)"
10249 msgstr ""
10250
10251 #. type: Plain text
10252 #: build/C/man4/st.4:609
10253 msgid ""
10254 "This option instructs the driver to use the logical block addresses defined "
10255 "in the SCSI-2 standard when performing the seek and tell operations (both "
10256 "with B<MTSEEK> and B<MTIOCPOS> commands and when changing tape partition).  "
10257 "Otherwise the device-specific addresses are used.  It is highly advisable to "
10258 "set this option if the drive supports the logical addresses because they "
10259 "count also filemarks.  There are some drives that support only the logical "
10260 "block addresses."
10261 msgstr ""
10262
10263 #. type: TP
10264 #: build/C/man4/st.4:609
10265 #, no-wrap
10266 msgid "B<MT_ST_SYSV> (Default: false)"
10267 msgstr ""
10268
10269 #. type: Plain text
10270 #: build/C/man4/st.4:620
10271 msgid ""
10272 "When this option is enabled, the tape devices use the SystemV semantics.  "
10273 "Otherwise the BSD semantics are used.  The most important difference between "
10274 "the semantics is what happens when a device used for reading is closed: in "
10275 "System V semantics the tape is spaced forward past the next filemark if this "
10276 "has not happened while using the device.  In BSD semantics the tape position "
10277 "is not changed."
10278 msgstr ""
10279
10280 #. type: TP
10281 #: build/C/man4/st.4:620
10282 #, no-wrap
10283 msgid "B<MT_NO_WAIT> (Default: false)"
10284 msgstr ""
10285
10286 #. type: Plain text
10287 #: build/C/man4/st.4:624
10288 msgid ""
10289 "Enables immediate mode (i.e., don't wait for the command to finish) for some "
10290 "commands (e.g., rewind)."
10291 msgstr ""
10292
10293 #. type: Plain text
10294 #: build/C/man4/st.4:626
10295 msgid "An example:"
10296 msgstr ""
10297
10298 #. type: Plain text
10299 #: build/C/man4/st.4:634
10300 #, no-wrap
10301 msgid ""
10302 "struct mtop mt_cmd;\n"
10303 "mt_cmd.mt_op = MTSETDRVBUFFER;\n"
10304 "mt_cmd.mt_count = MT_ST_BOOLEANS |\n"
10305 "        MT_ST_BUFFER_WRITES | MT_ST_ASYNC_WRITES;\n"
10306 "ioctl(fd, MTIOCTOP, mt_cmd);\n"
10307 msgstr ""
10308
10309 #. type: Plain text
10310 #: build/C/man4/st.4:644
10311 msgid ""
10312 "The default block size for a device can be set with B<MT_ST_DEF_BLKSIZE> and "
10313 "the default density code can be set with B<MT_ST_DEFDENSITY>.  The values "
10314 "for the parameters are or'ed with the operation code."
10315 msgstr ""
10316
10317 #. type: Plain text
10318 #: build/C/man4/st.4:661
10319 msgid ""
10320 "With kernels 2.1.x and later, the timeout values can be set with the "
10321 "subcommand B<MT_ST_SET_TIMEOUT> ORed with the timeout in seconds.  The long "
10322 "timeout (used for rewinds and other commands that may take a long time) can "
10323 "be set with B<MT_ST_SET_LONG_TIMEOUT>.  The kernel defaults are very long to "
10324 "make sure that a successful command is not timed out with any drive.  "
10325 "Because of this the driver may seem stuck even if it is only waiting for the "
10326 "timeout.  These commands can be used to set more practical values for a "
10327 "specific drive.  The timeouts set for one device apply for all devices "
10328 "linked to the same drive."
10329 msgstr ""
10330
10331 #. type: Plain text
10332 #: build/C/man4/st.4:682
10333 msgid ""
10334 "Starting from kernels 2.4.19 and 2.5.43, the driver supports a status bit "
10335 "which indicates whether the drive requests cleaning.  The method used by the "
10336 "drive to return cleaning information is set using the B<MT_ST_SEL_CLN> "
10337 "subcommand.  If the value is zero, the cleaning bit is always zero.  If the "
10338 "value is one, the TapeAlert data defined in the SCSI-3 standard is used (not "
10339 "yet implemented).  Values 2-17 are reserved.  If the lowest eight bits are "
10340 "E<gt>= 18, bits from the extended sense data are used.  The bits 9-16 "
10341 "specify a mask to select the bits to look at and the bits 17-23 specify the "
10342 "bit pattern to look for.  If the bit pattern is zero, one or more bits under "
10343 "the mask indicate the cleaning request.  If the pattern is nonzero, the "
10344 "pattern must match the masked sense data byte."
10345 msgstr ""
10346
10347 #. type: SS
10348 #: build/C/man4/st.4:682
10349 #, no-wrap
10350 msgid "MTIOCGET \\(em get status"
10351 msgstr ""
10352
10353 #. type: Plain text
10354 #: build/C/man4/st.4:686
10355 msgid "This request takes an argument of type I<(struct mtget\\ *)>."
10356 msgstr ""
10357
10358 #. type: Plain text
10359 #: build/C/man4/st.4:701
10360 #, no-wrap
10361 msgid ""
10362 "/* structure for MTIOCGET - mag tape get status command */\n"
10363 "struct mtget {\n"
10364 "    long     mt_type;\n"
10365 "    long     mt_resid;\n"
10366 "    /* the following registers are device dependent */\n"
10367 "    long     mt_dsreg;\n"
10368 "    long     mt_gstat;\n"
10369 "    long     mt_erreg;\n"
10370 "    /* The next two fields are not always used */\n"
10371 "    daddr_t  mt_fileno;\n"
10372 "    daddr_t  mt_blkno;\n"
10373 "};\n"
10374 msgstr ""
10375
10376 #. type: IP
10377 #: build/C/man4/st.4:703
10378 #, no-wrap
10379 msgid "I<mt_type>"
10380 msgstr ""
10381
10382 #. type: Plain text
10383 #: build/C/man4/st.4:712
10384 msgid ""
10385 "The header file defines many values for I<mt_type>, but the current driver "
10386 "reports only the generic types B<MT_ISSCSI1> (Generic SCSI-1 tape)  and "
10387 "B<MT_ISSCSI2> (Generic SCSI-2 tape)."
10388 msgstr ""
10389
10390 #. type: IP
10391 #: build/C/man4/st.4:712
10392 #, no-wrap
10393 msgid "I<mt_resid>"
10394 msgstr ""
10395
10396 #. type: Plain text
10397 #: build/C/man4/st.4:714
10398 msgid "contains the current tape partition number."
10399 msgstr ""
10400
10401 #. type: IP
10402 #: build/C/man4/st.4:714
10403 #, no-wrap
10404 msgid "I<mt_dsreg>"
10405 msgstr ""
10406
10407 #. type: Plain text
10408 #: build/C/man4/st.4:723
10409 msgid ""
10410 "reports the drive's current settings for block size (in the low 24 bits) and "
10411 "density (in the high 8 bits).  These fields are defined by "
10412 "B<MT_ST_BLKSIZE_SHIFT>, B<MT_ST_BLKSIZE_MASK>, B<MT_ST_DENSITY_SHIFT>, and "
10413 "B<MT_ST_DENSITY_MASK>."
10414 msgstr ""
10415
10416 #. type: IP
10417 #: build/C/man4/st.4:723
10418 #, no-wrap
10419 msgid "I<mt_gstat>"
10420 msgstr ""
10421
10422 #. type: Plain text
10423 #: build/C/man4/st.4:726
10424 msgid ""
10425 "reports generic (device independent) status information.  The header file "
10426 "defines macros for testing these status bits:"
10427 msgstr ""
10428
10429 #. type: Plain text
10430 #: build/C/man4/st.4:733
10431 msgid ""
10432 "B<GMT_EOF>(I<x>): The tape is positioned just after a filemark (always false "
10433 "after an B<MTSEEK> operation)."
10434 msgstr ""
10435
10436 #. type: Plain text
10437 #: build/C/man4/st.4:739
10438 msgid ""
10439 "B<GMT_BOT>(I<x>): The tape is positioned at the beginning of the first file "
10440 "(always false after an B<MTSEEK> operation)."
10441 msgstr ""
10442
10443 #. type: Plain text
10444 #: build/C/man4/st.4:742
10445 msgid "B<GMT_EOT>(I<x>): A tape operation has reached the physical End Of Tape."
10446 msgstr ""
10447
10448 #. type: Plain text
10449 #: build/C/man4/st.4:748
10450 msgid ""
10451 "B<GMT_SM>(I<x>): The tape is currently positioned at a setmark (always false "
10452 "after an B<MTSEEK> operation)."
10453 msgstr ""
10454
10455 #. type: Plain text
10456 #: build/C/man4/st.4:751
10457 msgid "B<GMT_EOD>(I<x>): The tape is positioned at the end of recorded data."
10458 msgstr ""
10459
10460 #. type: Plain text
10461 #: build/C/man4/st.4:756
10462 msgid ""
10463 "B<GMT_WR_PROT>(I<x>): The drive is write-protected.  For some drives this "
10464 "can also mean that the drive does not support writing on the current medium "
10465 "type."
10466 msgstr ""
10467
10468 #. type: Plain text
10469 #: build/C/man4/st.4:761
10470 msgid ""
10471 "B<GMT_ONLINE>(I<x>): The last B<open>(2)  found the drive with a tape in "
10472 "place and ready for operation."
10473 msgstr ""
10474
10475 #. type: Plain text
10476 #: build/C/man4/st.4:765
10477 msgid ""
10478 "B<GMT_D_6250>(I<x>), B<GMT_D_1600>(I<x>), B<GMT_D_800>(I<x>): This "
10479 "\\(lqgeneric\\(rq status information reports the current density setting for "
10480 "9-track \\(12\" tape drives only."
10481 msgstr ""
10482
10483 #. type: Plain text
10484 #: build/C/man4/st.4:768
10485 msgid "B<GMT_DR_OPEN>(I<x>): The drive does not have a tape in place."
10486 msgstr ""
10487
10488 #. type: Plain text
10489 #: build/C/man4/st.4:776
10490 msgid ""
10491 "B<GMT_IM_REP_EN>(I<x>): Immediate report mode.  This bit is set if there are "
10492 "no guarantees that the data has been physically written to the tape when the "
10493 "write call returns.  It is set zero only when the driver does not buffer "
10494 "data and the drive is set not to buffer data."
10495 msgstr ""
10496
10497 #. type: Plain text
10498 #: build/C/man4/st.4:780
10499 msgid ""
10500 "B<GMT_CLN>(I<x>): The drive has requested cleaning.  Implemented in kernels "
10501 "since 2.4.19 and 2.5.43."
10502 msgstr ""
10503
10504 #. type: IP
10505 #: build/C/man4/st.4:781
10506 #, no-wrap
10507 msgid "I<mt_erreg>"
10508 msgstr ""
10509
10510 #. type: Plain text
10511 #: build/C/man4/st.4:791
10512 msgid ""
10513 "The only field defined in I<mt_erreg> is the recovered error count in the "
10514 "low 16 bits (as defined by B<MT_ST_SOFTERR_SHIFT> and "
10515 "B<MT_ST_SOFTERR_MASK>.  Due to inconsistencies in the way drives report "
10516 "recovered errors, this count is often not maintained (most drives do not by "
10517 "default report soft errors but this can be changed with a SCSI MODE SELECT "
10518 "command)."
10519 msgstr ""
10520
10521 #. type: IP
10522 #: build/C/man4/st.4:791
10523 #, no-wrap
10524 msgid "I<mt_fileno>"
10525 msgstr ""
10526
10527 #. type: Plain text
10528 #: build/C/man4/st.4:797
10529 msgid ""
10530 "reports the current file number (zero-based).  This value is set to -1 when "
10531 "the file number is unknown (e.g., after B<MTBSS> or B<MTSEEK>)."
10532 msgstr ""
10533
10534 #. type: IP
10535 #: build/C/man4/st.4:797
10536 #, no-wrap
10537 msgid "I<mt_blkno>"
10538 msgstr ""
10539
10540 #. type: Plain text
10541 #: build/C/man4/st.4:804
10542 msgid ""
10543 "reports the block number (zero-based) within the current file.  This value "
10544 "is set to -1 when the block number is unknown (e.g., after B<MTBSF>, "
10545 "B<MTBSS>, or B<MTSEEK>)."
10546 msgstr ""
10547
10548 #. type: SS
10549 #: build/C/man4/st.4:804
10550 #, no-wrap
10551 msgid "MTIOCPOS \\(em get tape position"
10552 msgstr ""
10553
10554 #. type: Plain text
10555 #: build/C/man4/st.4:818
10556 msgid ""
10557 "This request takes an argument of type I<(struct mtpos\\ *)> and reports the "
10558 "drive's notion of the current tape block number, which is not the same as "
10559 "I<mt_blkno> returned by B<MTIOCGET>.  This drive must be a SCSI-2 drive that "
10560 "supports the B<READ POSITION> command (device-specific address)  or a "
10561 "Tandberg-compatible SCSI-1 drive (Tandberg, Archive Viper, Wangtek, ... )."
10562 msgstr ""
10563
10564 #. type: Plain text
10565 #: build/C/man4/st.4:825
10566 #, no-wrap
10567 msgid ""
10568 "/* structure for MTIOCPOS - mag tape get position command */\n"
10569 "struct mtpos {\n"
10570 "    long mt_blkno;    /* current block number */\n"
10571 "};\n"
10572 msgstr ""
10573
10574 #. type: Plain text
10575 #: build/C/man4/st.4:834
10576 msgid ""
10577 "An attempt was made to write or erase a write-protected tape.  (This error "
10578 "is not detected during B<open>(2).)"
10579 msgstr ""
10580
10581 #. type: TP
10582 #: build/C/man4/st.4:834
10583 #, no-wrap
10584 msgid "B<EBUSY>"
10585 msgstr ""
10586
10587 #. type: Plain text
10588 #: build/C/man4/st.4:838
10589 msgid "The device is already in use or the driver was unable to allocate a buffer."
10590 msgstr ""
10591
10592 #. type: Plain text
10593 #: build/C/man4/st.4:842
10594 msgid "The command parameters point to memory not belonging to the calling process."
10595 msgstr ""
10596
10597 #. type: Plain text
10598 #: build/C/man4/st.4:847
10599 msgid ""
10600 "An B<ioctl>(2)  had an invalid argument, or a requested block size was "
10601 "invalid."
10602 msgstr ""
10603
10604 #. type: TP
10605 #: build/C/man4/st.4:847
10606 #, no-wrap
10607 msgid "B<EIO>"
10608 msgstr ""
10609
10610 #. type: Plain text
10611 #: build/C/man4/st.4:850
10612 msgid "The requested operation could not be completed."
10613 msgstr ""
10614
10615 #. type: Plain text
10616 #: build/C/man4/st.4:857
10617 msgid ""
10618 "The byte count in B<read>(2)  is smaller than the next physical block on the "
10619 "tape.  (Before 2.2.18 and 2.4.0-test6 the extra bytes have been silently "
10620 "ignored.)"
10621 msgstr ""
10622
10623 #. type: Plain text
10624 #: build/C/man4/st.4:861
10625 msgid ""
10626 "A write operation could not be completed because the tape reached "
10627 "end-of-medium."
10628 msgstr ""
10629
10630 #. type: TP
10631 #: build/C/man4/st.4:861 build/C/man2/syslog.2:278
10632 #, no-wrap
10633 msgid "B<ENOSYS>"
10634 msgstr ""
10635
10636 #. type: Plain text
10637 #: build/C/man4/st.4:865
10638 msgid "Unknown B<ioctl>(2)."
10639 msgstr ""
10640
10641 #. type: TP
10642 #: build/C/man4/st.4:865
10643 #, no-wrap
10644 msgid "B<ENXIO>"
10645 msgstr ""
10646
10647 #. type: Plain text
10648 #: build/C/man4/st.4:868
10649 msgid "During opening, the tape device does not exist."
10650 msgstr ""
10651
10652 #. type: TP
10653 #: build/C/man4/st.4:868
10654 #, no-wrap
10655 msgid "B<EOVERFLOW>"
10656 msgstr ""
10657
10658 #. type: Plain text
10659 #: build/C/man4/st.4:872
10660 msgid ""
10661 "An attempt was made to read or write a variable-length block that is larger "
10662 "than the driver's internal buffer."
10663 msgstr ""
10664
10665 #. type: Plain text
10666 #: build/C/man4/st.4:879
10667 msgid ""
10668 "Open is attempted with B<O_WRONLY> or B<O_RDWR> when the tape in the drive "
10669 "is write-protected."
10670 msgstr ""
10671
10672 #. type: TP
10673 #: build/C/man4/st.4:880
10674 #, no-wrap
10675 msgid "I</dev/st*>"
10676 msgstr ""
10677
10678 #. type: Plain text
10679 #: build/C/man4/st.4:883
10680 msgid "the auto-rewind SCSI tape devices"
10681 msgstr ""
10682
10683 #. type: TP
10684 #: build/C/man4/st.4:883
10685 #, no-wrap
10686 msgid "I</dev/nst*>"
10687 msgstr ""
10688
10689 #.  .SH AUTHOR
10690 #.  The driver has been written by Kai M\(:akisara (Kai.Makisara@metla.fi)
10691 #.  starting from a driver written by Dwayne Forsyth.
10692 #.  Several other
10693 #.  people have also contributed to the driver.
10694 #. type: Plain text
10695 #: build/C/man4/st.4:891
10696 msgid "the nonrewind SCSI tape devices"
10697 msgstr ""
10698
10699 #. type: Plain text
10700 #: build/C/man4/st.4:912
10701 msgid ""
10702 "When exchanging data between systems, both systems have to agree on the "
10703 "physical tape block size.  The parameters of a drive after startup are often "
10704 "not the ones most operating systems use with these devices.  Most systems "
10705 "use drives in variable-block mode if the drive supports that mode.  This "
10706 "applies to most modern drives, including DATs, 8mm helical scan drives, "
10707 "DLTs, etc.  It may be advisable to use these drives in variable-block mode "
10708 "also in Linux (i.e., use B<MTSETBLK> or B<MTSETDEFBLK> at system startup to "
10709 "set the mode), at least when exchanging data with a foreign system.  The "
10710 "drawback of this is that a fairly large tape block size has to be used to "
10711 "get acceptable data transfer rates on the SCSI bus."
10712 msgstr ""
10713
10714 #. type: Plain text
10715 #: build/C/man4/st.4:919
10716 msgid ""
10717 "Many programs (e.g., B<tar>(1))  allow the user to specify the blocking "
10718 "factor on the command line.  Note that this determines the physical block "
10719 "size on tape only in variable-block mode."
10720 msgstr ""
10721
10722 #. type: Plain text
10723 #: build/C/man4/st.4:926
10724 msgid ""
10725 "In order to use SCSI tape drives, the basic SCSI driver, a SCSI-adapter "
10726 "driver and the SCSI tape driver must be either configured into the kernel or "
10727 "loaded as modules.  If the SCSI-tape driver is not present, the drive is "
10728 "recognized but the tape support described in this page is not available."
10729 msgstr ""
10730
10731 #. type: Plain text
10732 #: build/C/man4/st.4:931
10733 msgid ""
10734 "The driver writes error messages to the console/log.  The SENSE codes "
10735 "written into some messages are automatically translated to text if verbose "
10736 "SCSI messages are enabled in kernel configuration."
10737 msgstr ""
10738
10739 #.  .SH COPYRIGHT
10740 #.  Copyright \(co 1995 Robert K. Nichols.
10741 #.  .br
10742 #.  Copyright \(co 1999-2005 Kai M\(:akisara.
10743 #.  .PP
10744 #.  %%%LICENSE_START(VERBATIM)
10745 #.  Permission is granted to make and distribute verbatim copies of this
10746 #.  manual provided the copyright notice and this permission notice are
10747 #.  preserved on all copies.
10748 #.  Additional permissions are contained in the header of the source file.
10749 #. type: Plain text
10750 #: build/C/man4/st.4:954
10751 msgid ""
10752 "The driver's internal buffering allows good throughput in fixed-block mode "
10753 "also with small B<read>(2)  and B<write>(2)  byte counts.  With direct "
10754 "transfers this is not possible and may cause a surprise when moving to the "
10755 "2.6 kernel.  The solution is to tell the software to use larger transfers "
10756 "(often telling it to use larger blocks).  If this is not possible, direct "
10757 "transfers can be disabled."
10758 msgstr ""
10759
10760 #. type: Plain text
10761 #: build/C/man4/st.4:956
10762 msgid "B<mt>(1)"
10763 msgstr ""
10764
10765 #. type: Plain text
10766 #: build/C/man4/st.4:964
10767 msgid ""
10768 "The file I<drivers/scsi/README.st> or I<Documentation/scsi/st.txt> (kernel "
10769 "E<gt>= 2.6) in the Linux kernel source tree contains the most recent "
10770 "information about the driver and its configuration possibilities"
10771 msgstr ""
10772
10773 #. type: TH
10774 #: build/C/man3/stdarg.3:43
10775 #, no-wrap
10776 msgid "STDARG"
10777 msgstr ""
10778
10779 #. type: Plain text
10780 #: build/C/man3/stdarg.3:46
10781 msgid "stdarg, va_start, va_arg, va_end, va_copy - variable argument lists"
10782 msgstr ""
10783
10784 #. type: Plain text
10785 #: build/C/man3/stdarg.3:48 build/C/man3/syslog.3:49
10786 msgid "B<#include E<lt>stdarg.hE<gt>>"
10787 msgstr ""
10788
10789 #. type: Plain text
10790 #: build/C/man3/stdarg.3:50
10791 msgid "B<void va_start(va_list >I<ap>B<, >I<last>B<);>"
10792 msgstr ""
10793
10794 #. type: Plain text
10795 #: build/C/man3/stdarg.3:52
10796 msgid "I<type>B< va_arg(va_list >I<ap>B<, >I<type>B<);>"
10797 msgstr ""
10798
10799 #. type: Plain text
10800 #: build/C/man3/stdarg.3:54
10801 msgid "B<void va_end(va_list >I<ap>B<);>"
10802 msgstr ""
10803
10804 #. type: Plain text
10805 #: build/C/man3/stdarg.3:56
10806 msgid "B<void va_copy(va_list >I<dest>B<, va_list >I<src>B<);>"
10807 msgstr ""
10808
10809 #. type: Plain text
10810 #: build/C/man3/stdarg.3:65
10811 msgid ""
10812 "A function may be called with a varying number of arguments of varying "
10813 "types.  The include file I<E<lt>stdarg.hE<gt>> declares a type I<va_list> "
10814 "and defines three macros for stepping through a list of arguments whose "
10815 "number and types are not known to the called function."
10816 msgstr ""
10817
10818 #. type: Plain text
10819 #: build/C/man3/stdarg.3:73
10820 msgid ""
10821 "The called function must declare an object of type I<va_list> which is used "
10822 "by the macros B<va_start>(), B<va_arg>(), and B<va_end>()."
10823 msgstr ""
10824
10825 #. type: SS
10826 #: build/C/man3/stdarg.3:73
10827 #, no-wrap
10828 msgid "va_start()"
10829 msgstr ""
10830
10831 #. type: Plain text
10832 #: build/C/man3/stdarg.3:83
10833 msgid ""
10834 "The B<va_start>()  macro initializes I<ap> for subsequent use by B<va_arg>()  "
10835 "and B<va_end>(), and must be called first."
10836 msgstr ""
10837
10838 #. type: Plain text
10839 #: build/C/man3/stdarg.3:88
10840 msgid ""
10841 "The argument I<last> is the name of the last argument before the variable "
10842 "argument list, that is, the last argument of which the calling function "
10843 "knows the type."
10844 msgstr ""
10845
10846 #. type: Plain text
10847 #: build/C/man3/stdarg.3:93
10848 msgid ""
10849 "Because the address of this argument may be used in the B<va_start>()  "
10850 "macro, it should not be declared as a register variable, or as a function or "
10851 "an array type."
10852 msgstr ""
10853
10854 #. type: SS
10855 #: build/C/man3/stdarg.3:93
10856 #, no-wrap
10857 msgid "va_arg()"
10858 msgstr ""
10859
10860 #. type: Plain text
10861 #: build/C/man3/stdarg.3:115
10862 msgid ""
10863 "The B<va_arg>()  macro expands to an expression that has the type and value "
10864 "of the next argument in the call.  The argument I<ap> is the I<va_list> "
10865 "I<ap> initialized by B<va_start>().  Each call to B<va_arg>()  modifies "
10866 "I<ap> so that the next call returns the next argument.  The argument I<type> "
10867 "is a type name specified so that the type of a pointer to an object that has "
10868 "the specified type can be obtained simply by adding a * to I<type>."
10869 msgstr ""
10870
10871 #. type: Plain text
10872 #: build/C/man3/stdarg.3:123
10873 msgid ""
10874 "The first use of the B<va_arg>()  macro after that of the B<va_start>()  "
10875 "macro returns the argument after I<last>.  Successive invocations return the "
10876 "values of the remaining arguments."
10877 msgstr ""
10878
10879 #. type: Plain text
10880 #: build/C/man3/stdarg.3:128
10881 msgid ""
10882 "If there is no next argument, or if I<type> is not compatible with the type "
10883 "of the actual next argument (as promoted according to the default argument "
10884 "promotions), random errors will occur."
10885 msgstr ""
10886
10887 #. type: Plain text
10888 #: build/C/man3/stdarg.3:136
10889 msgid ""
10890 "If I<ap> is passed to a function that uses B<va_arg(>I<ap>B<,>I<type>B<)> "
10891 "then the value of I<ap> is undefined after the return of that function."
10892 msgstr ""
10893
10894 #. type: SS
10895 #: build/C/man3/stdarg.3:136
10896 #, no-wrap
10897 msgid "va_end()"
10898 msgstr ""
10899
10900 #. type: Plain text
10901 #: build/C/man3/stdarg.3:155
10902 msgid ""
10903 "Each invocation of B<va_start>()  must be matched by a corresponding "
10904 "invocation of B<va_end>()  in the same function.  After the call "
10905 "B<va_end(>I<ap>B<)> the variable I<ap> is undefined.  Multiple traversals of "
10906 "the list, each bracketed by B<va_start>()  and B<va_end>()  are possible.  "
10907 "B<va_end>()  may be a macro or a function."
10908 msgstr ""
10909
10910 #. type: SS
10911 #: build/C/man3/stdarg.3:155
10912 #, no-wrap
10913 msgid "va_copy()"
10914 msgstr ""
10915
10916 #. type: Plain text
10917 #: build/C/man3/stdarg.3:172
10918 msgid ""
10919 "The B<va_copy>()  macro copies the (previously initialized) variable "
10920 "argument list I<src> to I<dest>.  The behavior is as if B<va_start>()  were "
10921 "applied to I<dest> with the same I<last> argument, followed by the same "
10922 "number of B<va_arg>()  invocations that was used to reach the current state "
10923 "of I<src>."
10924 msgstr ""
10925
10926 #.  Proposal from clive@demon.net, 1997-02-28
10927 #. type: Plain text
10928 #: build/C/man3/stdarg.3:179
10929 msgid ""
10930 "An obvious implementation would have a I<va_list> be a pointer to the stack "
10931 "frame of the variadic function.  In such a setup (by far the most common) "
10932 "there seems nothing against an assignment"
10933 msgstr ""
10934
10935 #. type: Plain text
10936 #: build/C/man3/stdarg.3:183
10937 #, no-wrap
10938 msgid "va_list aq = ap;\n"
10939 msgstr ""
10940
10941 #. type: Plain text
10942 #: build/C/man3/stdarg.3:188
10943 msgid ""
10944 "Unfortunately, there are also systems that make it an array of pointers (of "
10945 "length 1), and there one needs"
10946 msgstr ""
10947
10948 #. type: Plain text
10949 #: build/C/man3/stdarg.3:193
10950 #, no-wrap
10951 msgid ""
10952 "va_list aq;\n"
10953 "*aq = *ap;\n"
10954 msgstr ""
10955
10956 #. type: Plain text
10957 #: build/C/man3/stdarg.3:209
10958 msgid ""
10959 "Finally, on systems where arguments are passed in registers, it may be "
10960 "necessary for B<va_start>()  to allocate memory, store the arguments there, "
10961 "and also an indication of which argument is next, so that B<va_arg>()  can "
10962 "step through the list.  Now B<va_end>()  can free the allocated memory "
10963 "again.  To accommodate this situation, C99 adds a macro B<va_copy>(), so "
10964 "that the above assignment can be replaced by"
10965 msgstr ""
10966
10967 #. type: Plain text
10968 #: build/C/man3/stdarg.3:216
10969 #, no-wrap
10970 msgid ""
10971 "va_list aq;\n"
10972 "va_copy(aq, ap);\n"
10973 "\\&...\n"
10974 "va_end(aq);\n"
10975 msgstr ""
10976
10977 #. type: Plain text
10978 #: build/C/man3/stdarg.3:229
10979 msgid ""
10980 "Each invocation of B<va_copy>()  must be matched by a corresponding "
10981 "invocation of B<va_end>()  in the same function.  Some systems that do not "
10982 "supply B<va_copy>()  have B<__va_copy> instead, since that was the name used "
10983 "in the draft proposal."
10984 msgstr ""
10985
10986 #. type: Plain text
10987 #: build/C/man3/stdarg.3:239
10988 msgid ""
10989 "The B<va_start>(), B<va_arg>(), and B<va_end>()  macros conform to C89.  C99 "
10990 "defines the B<va_copy>()  macro."
10991 msgstr ""
10992
10993 #. type: Plain text
10994 #: build/C/man3/stdarg.3:245
10995 msgid ""
10996 "These macros are I<not> compatible with the historic macros they replace.  A "
10997 "backward-compatible version can be found in the include file "
10998 "I<E<lt>varargs.hE<gt>>."
10999 msgstr ""
11000
11001 #. type: Plain text
11002 #: build/C/man3/stdarg.3:247
11003 msgid "The historic setup is:"
11004 msgstr ""
11005
11006 #. type: Plain text
11007 #: build/C/man3/stdarg.3:251
11008 #, no-wrap
11009 msgid "#include E<lt>varargs.hE<gt>\n"
11010 msgstr ""
11011
11012 #. type: Plain text
11013 #: build/C/man3/stdarg.3:257
11014 #, no-wrap
11015 msgid ""
11016 "void\n"
11017 "foo(va_alist)\n"
11018 "    va_dcl\n"
11019 "{\n"
11020 "    va_list ap;\n"
11021 msgstr ""
11022
11023 #. type: Plain text
11024 #: build/C/man3/stdarg.3:266
11025 #, no-wrap
11026 msgid ""
11027 "    va_start(ap);\n"
11028 "    while (...) {\n"
11029 "        ...\n"
11030 "        x = va_arg(ap, type);\n"
11031 "        ...\n"
11032 "    }\n"
11033 "    va_end(ap);\n"
11034 "}\n"
11035 msgstr ""
11036
11037 #. type: Plain text
11038 #: build/C/man3/stdarg.3:275
11039 msgid ""
11040 "On some systems, I<va_end> contains a closing \\(aq}\\(aq matching a "
11041 "\\(aq{\\(aq in I<va_start>, so that both macros must occur in the same "
11042 "function, and in a way that allows this."
11043 msgstr ""
11044
11045 #. type: Plain text
11046 #: build/C/man3/stdarg.3:291
11047 msgid ""
11048 "Unlike the B<varargs> macros, the B<stdarg> macros do not permit programmers "
11049 "to code a function with no fixed arguments.  This problem generates work "
11050 "mainly when converting B<varargs> code to B<stdarg> code, but it also "
11051 "creates difficulties for variadic functions that wish to pass all of their "
11052 "arguments on to a function that takes a I<va_list> argument, such as "
11053 "B<vfprintf>(3)."
11054 msgstr ""
11055
11056 #. type: Plain text
11057 #: build/C/man3/stdarg.3:296
11058 msgid ""
11059 "The function I<foo> takes a string of format characters and prints out the "
11060 "argument associated with each format character based on the type."
11061 msgstr ""
11062
11063 #. type: Plain text
11064 #: build/C/man3/stdarg.3:300
11065 #, no-wrap
11066 msgid ""
11067 "#include E<lt>stdio.hE<gt>\n"
11068 "#include E<lt>stdarg.hE<gt>\n"
11069 msgstr ""
11070
11071 #. type: Plain text
11072 #: build/C/man3/stdarg.3:307
11073 #, no-wrap
11074 msgid ""
11075 "void\n"
11076 "foo(char *fmt, ...)\n"
11077 "{\n"
11078 "    va_list ap;\n"
11079 "    int d;\n"
11080 "    char c, *s;\n"
11081 msgstr ""
11082
11083 #. type: Plain text
11084 #: build/C/man3/stdarg.3:328
11085 #, no-wrap
11086 msgid ""
11087 "    va_start(ap, fmt);\n"
11088 "    while (*fmt)\n"
11089 "        switch (*fmt++) {\n"
11090 "        case \\(aqs\\(aq:              /* string */\n"
11091 "            s = va_arg(ap, char *);\n"
11092 "            printf(\"string %s\\en\", s);\n"
11093 "            break;\n"
11094 "        case \\(aqd\\(aq:              /* int */\n"
11095 "            d = va_arg(ap, int);\n"
11096 "            printf(\"int %d\\en\", d);\n"
11097 "            break;\n"
11098 "        case \\(aqc\\(aq:              /* char */\n"
11099 "            /* need a cast here since va_arg only\n"
11100 "               takes fully promoted types */\n"
11101 "            c = (char) va_arg(ap, int);\n"
11102 "            printf(\"char %c\\en\", c);\n"
11103 "            break;\n"
11104 "        }\n"
11105 "    va_end(ap);\n"
11106 "}\n"
11107 msgstr ""
11108
11109 #. type: TH
11110 #: build/C/man2/syslog.2:31 build/C/man3/syslog.3:36
11111 #, no-wrap
11112 msgid "SYSLOG"
11113 msgstr ""
11114
11115 #. type: TH
11116 #: build/C/man2/syslog.2:31
11117 #, no-wrap
11118 msgid "2012-11-29"
11119 msgstr ""
11120
11121 #. type: Plain text
11122 #: build/C/man2/syslog.2:35
11123 msgid ""
11124 "syslog, klogctl - read and/or clear kernel message ring buffer; set "
11125 "console_loglevel"
11126 msgstr ""
11127
11128 #. type: Plain text
11129 #: build/C/man2/syslog.2:39
11130 #, no-wrap
11131 msgid ""
11132 "B<int syslog(int >I<type>B<, char *>I<bufp>B<, int >I<len>B<);>\n"
11133 "B</* No wrapper provided in glibc */>\n"
11134 msgstr ""
11135
11136 #. type: Plain text
11137 #: build/C/man2/syslog.2:41
11138 #, no-wrap
11139 msgid "/* The glibc interface */\n"
11140 msgstr ""
11141
11142 #. type: Plain text
11143 #: build/C/man2/syslog.2:43
11144 #, no-wrap
11145 msgid "B<#include E<lt>sys/klog.hE<gt>>\n"
11146 msgstr ""
11147
11148 #. type: Plain text
11149 #: build/C/man2/syslog.2:45
11150 #, no-wrap
11151 msgid "B<int klogctl(int >I<type>B<, char *>I<bufp>B<, int >I<len>B<);>\n"
11152 msgstr ""
11153
11154 #. type: Plain text
11155 #: build/C/man2/syslog.2:57
11156 msgid ""
11157 "If you need the C library function B<syslog>()  (which talks to "
11158 "B<syslogd>(8)), then look at B<syslog>(3).  The system call of this name is "
11159 "about controlling the kernel I<printk>()  buffer, and the glibc wrapper "
11160 "function is called B<klogctl>()."
11161 msgstr ""
11162
11163 #. type: SS
11164 #: build/C/man2/syslog.2:57
11165 #, no-wrap
11166 msgid "The kernel log buffer"
11167 msgstr ""
11168
11169 #.  Under "General setup" ==> "Kernel log buffer size"
11170 #.  For 2.6, precisely the option seems to have appeared in 2.5.55.
11171 #. type: Plain text
11172 #: build/C/man2/syslog.2:73
11173 msgid ""
11174 "The kernel has a cyclic buffer of length B<LOG_BUF_LEN> in which messages "
11175 "given as arguments to the kernel function B<printk>()  are stored "
11176 "(regardless of their loglevel).  In early kernels, B<LOG_BUF_LEN> had the "
11177 "value 4096; from kernel 1.3.54, it was 8192; from kernel 2.1.113 it was "
11178 "16384; since 2.4.23/2.6 the value is a kernel configuration option "
11179 "(B<CONFIG_LOG_BUF_SHIFT>).  In recent kernels the size can be queried with "
11180 "command type 10 (see below)."
11181 msgstr ""
11182
11183 #. type: SS
11184 #: build/C/man2/syslog.2:73
11185 #, no-wrap
11186 msgid "Commands"
11187 msgstr ""
11188
11189 #. type: Plain text
11190 #: build/C/man2/syslog.2:80
11191 msgid ""
11192 "The I<type> argument determines the action taken by this function.  The list "
11193 "below specifies the values for I<type>.  The symbolic names are defined in "
11194 "the kernel source, but are not exported to user space; you will either need "
11195 "to use the numbers, or define the names yourself."
11196 msgstr ""
11197
11198 #. type: TP
11199 #: build/C/man2/syslog.2:80
11200 #, no-wrap
11201 msgid "B<SYSLOG_ACTION_CLOSE> (0)"
11202 msgstr ""
11203
11204 #. type: Plain text
11205 #: build/C/man2/syslog.2:84
11206 msgid "Close the log.  Currently a NOP."
11207 msgstr ""
11208
11209 #. type: TP
11210 #: build/C/man2/syslog.2:84
11211 #, no-wrap
11212 msgid "B<SYSLOG_ACTION_OPEN> (1)"
11213 msgstr ""
11214
11215 #. type: Plain text
11216 #: build/C/man2/syslog.2:88
11217 msgid "Open the log.  Currently a NOP."
11218 msgstr ""
11219
11220 #. type: TP
11221 #: build/C/man2/syslog.2:88
11222 #, no-wrap
11223 msgid "B<SYSLOG_ACTION_READ> (2)"
11224 msgstr ""
11225
11226 #. type: Plain text
11227 #: build/C/man2/syslog.2:100
11228 msgid ""
11229 "Read from the log.  The call waits until the kernel log buffer is nonempty, "
11230 "and then reads at most I<len> bytes into the buffer pointed to by I<bufp>.  "
11231 "The call returns the number of bytes read.  Bytes read from the log "
11232 "disappear from the log buffer: the information can be read only once.  This "
11233 "is the function executed by the kernel when a user program reads "
11234 "I</proc/kmsg>."
11235 msgstr ""
11236
11237 #. type: TP
11238 #: build/C/man2/syslog.2:100
11239 #, no-wrap
11240 msgid "B<SYSLOG_ACTION_READ_ALL> (3)"
11241 msgstr ""
11242
11243 #. type: Plain text
11244 #: build/C/man2/syslog.2:110
11245 msgid ""
11246 "Read all messages remaining in the ring buffer, placing then in the buffer "
11247 "pointed to by I<bufp>.  The call reads the last I<len> bytes from the log "
11248 "buffer (nondestructively), but will not read more than was written into the "
11249 "buffer since the last \"clear ring buffer\" command (see command 5 below)).  "
11250 "The call returns the number of bytes read."
11251 msgstr ""
11252
11253 #. type: TP
11254 #: build/C/man2/syslog.2:110
11255 #, no-wrap
11256 msgid "B<SYSLOG_ACTION_READ_CLEAR> (4)"
11257 msgstr ""
11258
11259 #. type: Plain text
11260 #: build/C/man2/syslog.2:116
11261 msgid ""
11262 "Read and clear all messages remaining in the ring buffer.  The call does "
11263 "precisely the same as for a I<type> of 3, but also executes the \"clear ring "
11264 "buffer\" command."
11265 msgstr ""
11266
11267 #. type: TP
11268 #: build/C/man2/syslog.2:116
11269 #, no-wrap
11270 msgid "B<SYSLOG_ACTION_CLEAR> (5)"
11271 msgstr ""
11272
11273 #. type: Plain text
11274 #: build/C/man2/syslog.2:124
11275 msgid ""
11276 "The call executes just the \"clear ring buffer\" command.  The I<bufp> and "
11277 "I<len> arguments are ignored."
11278 msgstr ""
11279
11280 #. type: Plain text
11281 #: build/C/man2/syslog.2:135
11282 msgid ""
11283 "This command does not really clear the ring buffer.  Rather, it sets a "
11284 "kernel bookkeeping variable that determines the results returned by commands "
11285 "3 (B<SYSLOG_ACTION_READ_ALL>)  and 4 (B<SYSLOG_ACTION_READ_CLEAR>).  This "
11286 "command has no effect on commands 2 (B<SYSLOG_ACTION_READ>)  and 9 "
11287 "(B<SYSLOG_ACTION_SIZE_UNREAD>)."
11288 msgstr ""
11289
11290 #. type: TP
11291 #: build/C/man2/syslog.2:135
11292 #, no-wrap
11293 msgid "B<SYSLOG_ACTION_CONSOLE_OFF> (6)"
11294 msgstr ""
11295
11296 #. type: Plain text
11297 #: build/C/man2/syslog.2:145
11298 msgid ""
11299 "Disable printk to console.  The call sets the console log level to the "
11300 "minimum, so that no messages are printed to the console.  The I<bufp> and "
11301 "I<len> arguments are ignored."
11302 msgstr ""
11303
11304 #. type: TP
11305 #: build/C/man2/syslog.2:145
11306 #, no-wrap
11307 msgid "B<SYSLOG_ACTION_CONSOLE_ON> (7)"
11308 msgstr ""
11309
11310 #. type: Plain text
11311 #: build/C/man2/syslog.2:154
11312 msgid ""
11313 "The call sets the console log level to the default, so that messages are "
11314 "printed to the console.  The I<bufp> and I<len> arguments are ignored."
11315 msgstr ""
11316
11317 #. type: TP
11318 #: build/C/man2/syslog.2:154
11319 #, no-wrap
11320 msgid "B<SYSLOG_ACTION_CONSOLE_LEVEL> (8)"
11321 msgstr ""
11322
11323 #. type: Plain text
11324 #: build/C/man2/syslog.2:165
11325 msgid ""
11326 "The call sets the console log level to the value given in I<len>, which must "
11327 "be an integer between 1 and 8 (inclusive).  See the B<loglevel> section for "
11328 "details.  The I<bufp> argument is ignored."
11329 msgstr ""
11330
11331 #. type: TP
11332 #: build/C/man2/syslog.2:165
11333 #, no-wrap
11334 msgid "B<SYSLOG_ACTION_SIZE_UNREAD> (9) (since Linux 2.4.10)"
11335 msgstr ""
11336
11337 #. type: Plain text
11338 #: build/C/man2/syslog.2:176
11339 msgid ""
11340 "The call returns the number of bytes currently available to be read from the "
11341 "kernel log buffer via command 2 (B<SYSLOG_ACTION_READ>).  The I<bufp> and "
11342 "I<len> arguments are ignored."
11343 msgstr ""
11344
11345 #. type: TP
11346 #: build/C/man2/syslog.2:176
11347 #, no-wrap
11348 msgid "B<SYSLOG_ACTION_SIZE_BUFFER> (10) (since Linux 2.6.6)"
11349 msgstr ""
11350
11351 #. type: Plain text
11352 #: build/C/man2/syslog.2:184
11353 msgid ""
11354 "This command returns the total size of the kernel log buffer.  The I<bufp> "
11355 "and I<len> arguments are ignored."
11356 msgstr ""
11357
11358 #. type: Plain text
11359 #: build/C/man2/syslog.2:201
11360 msgid ""
11361 "All commands except 3 and 10 require privilege.  In Linux kernels before "
11362 "2.6.37, command types 3 and 10 are allowed to unprivileged processes; since "
11363 "Linux 2.6.37, these commands are allowed to unprivileged processes only if "
11364 "I</proc/sys/kernel/dmesg_restrict> has the value 0.  Before Linux 2.6.37, "
11365 "\"privileged\" means that the caller has the B<CAP_SYS_ADMIN> capability.  "
11366 "Since Linux 2.6.37, \"privileged\" means that the caller has either the "
11367 "B<CAP_SYS_ADMIN> capability (now deprecated for this purpose) or the (new)  "
11368 "B<CAP_SYSLOG> capability."
11369 msgstr ""
11370
11371 #. type: SS
11372 #: build/C/man2/syslog.2:201
11373 #, no-wrap
11374 msgid "The loglevel"
11375 msgstr ""
11376
11377 #. type: Plain text
11378 #: build/C/man2/syslog.2:223
11379 msgid ""
11380 "The kernel routine B<printk>()  will only print a message on the console, if "
11381 "it has a loglevel less than the value of the variable I<console_loglevel>.  "
11382 "This variable initially has the value B<DEFAULT_CONSOLE_LOGLEVEL> (7), but "
11383 "is set to 10 if the kernel command line contains the word \"debug\", and to "
11384 "15 in case of a kernel fault (the 10 and 15 are just silly, and equivalent "
11385 "to 8).  This variable is set (to a value in the range 1-8) by a B<syslog>()  "
11386 "call with a I<type> of 8.  Calls to B<syslog>()  with I<type> equal to 6 or "
11387 "7 set the variable to 1 (kernel panics only)  or 7 (all except debugging "
11388 "messages), respectively."
11389 msgstr ""
11390
11391 #. type: Plain text
11392 #: build/C/man2/syslog.2:233
11393 msgid ""
11394 "Every text line in a message has its own loglevel.  This level is "
11395 "I<DEFAULT_MESSAGE_LOGLEVEL - 1> (6) unless the line starts with E<lt>dE<gt> "
11396 "where I<d> is a digit in the range 1-7, in which case the level is I<d>.  "
11397 "The conventional meaning of the loglevel is defined in "
11398 "I<E<lt>linux/kernel.hE<gt>> as follows:"
11399 msgstr ""
11400
11401 #. type: Plain text
11402 #: build/C/man2/syslog.2:243
11403 #, no-wrap
11404 msgid ""
11405 "#define KERN_EMERG    \"E<lt>0E<gt>\"  /* system is unusable               "
11406 "*/\n"
11407 "#define KERN_ALERT    \"E<lt>1E<gt>\"  /* action must be taken immediately "
11408 "*/\n"
11409 "#define KERN_CRIT     \"E<lt>2E<gt>\"  /* critical conditions              "
11410 "*/\n"
11411 "#define KERN_ERR      \"E<lt>3E<gt>\"  /* error conditions                 "
11412 "*/\n"
11413 "#define KERN_WARNING  \"E<lt>4E<gt>\"  /* warning conditions               "
11414 "*/\n"
11415 "#define KERN_NOTICE   \"E<lt>5E<gt>\"  /* normal but significant condition "
11416 "*/\n"
11417 "#define KERN_INFO     \"E<lt>6E<gt>\"  /* informational                    "
11418 "*/\n"
11419 "#define KERN_DEBUG    \"E<lt>7E<gt>\"  /* debug-level messages             "
11420 "*/\n"
11421 msgstr ""
11422
11423 #. type: Plain text
11424 #: build/C/man2/syslog.2:257
11425 msgid ""
11426 "For I<type> equal to 2, 3, or 4, a successful call to B<syslog>()  returns "
11427 "the number of bytes read.  For I<type> 9, B<syslog>()  returns the number of "
11428 "bytes currently available to be read on the kernel log buffer.  For I<type> "
11429 "10, B<syslog>()  returns the total size of the kernel log buffer.  For other "
11430 "values of I<type>, 0 is returned on success."
11431 msgstr ""
11432
11433 #. type: Plain text
11434 #: build/C/man2/syslog.2:260
11435 msgid "In case of error, -1 is returned, and I<errno> is set to indicate the error."
11436 msgstr ""
11437
11438 #. type: Plain text
11439 #: build/C/man2/syslog.2:278
11440 msgid ""
11441 "Bad arguments (e.g., bad I<type>; or for I<type> 2, 3, or 4, I<buf> is NULL, "
11442 "or I<len> is less than zero; or for I<type> 8, the I<level> is outside the "
11443 "range 1 to 8)."
11444 msgstr ""
11445
11446 #. type: Plain text
11447 #: build/C/man2/syslog.2:285
11448 msgid ""
11449 "This B<syslog>()  system call is not available, because the kernel was "
11450 "compiled with the B<CONFIG_PRINTK> kernel-configuration option disabled."
11451 msgstr ""
11452
11453 #. type: Plain text
11454 #: build/C/man2/syslog.2:294
11455 msgid ""
11456 "An attempt was made to change console_loglevel or clear the kernel message "
11457 "ring buffer by a process without sufficient privilege (more precisely: "
11458 "without the B<CAP_SYS_ADMIN> or B<CAP_SYSLOG> capability)."
11459 msgstr ""
11460
11461 #. type: TP
11462 #: build/C/man2/syslog.2:294
11463 #, no-wrap
11464 msgid "B<ERESTARTSYS>"
11465 msgstr ""
11466
11467 #. type: Plain text
11468 #: build/C/man2/syslog.2:298
11469 msgid ""
11470 "System call was interrupted by a signal; nothing was read.  (This can be "
11471 "seen only during a trace.)"
11472 msgstr ""
11473
11474 #. type: Plain text
11475 #: build/C/man2/syslog.2:301
11476 msgid ""
11477 "This system call is Linux-specific and should not be used in programs "
11478 "intended to be portable."
11479 msgstr ""
11480
11481 #.  In libc4 and libc5 the number of this call was defined by
11482 #.  .BR SYS_klog .
11483 #.  In glibc 2.0 the syscall is baptized
11484 #.  .BR klogctl ().
11485 #. type: Plain text
11486 #: build/C/man2/syslog.2:309
11487 msgid ""
11488 "From the very start people noted that it is unfortunate that a system call "
11489 "and a library routine of the same name are entirely different animals."
11490 msgstr ""
11491
11492 #. type: Plain text
11493 #: build/C/man2/syslog.2:312
11494 msgid "B<syslog>(3), B<capabilities>(7)"
11495 msgstr ""
11496
11497 #. type: TH
11498 #: build/C/man3/syslog.3:36
11499 #, no-wrap
11500 msgid "2012-08-17"
11501 msgstr ""
11502
11503 #. type: Plain text
11504 #: build/C/man3/syslog.3:39
11505 msgid "closelog, openlog, syslog, vsyslog - send messages to the system logger"
11506 msgstr ""
11507
11508 #. type: Plain text
11509 #: build/C/man3/syslog.3:41
11510 msgid "B<#include E<lt>syslog.hE<gt>>"
11511 msgstr ""
11512
11513 #. type: Plain text
11514 #: build/C/man3/syslog.3:43
11515 msgid ""
11516 "B<void openlog(const char *>I<ident>B<, int >I<option>B<, int "
11517 ">I<facility>B<);>"
11518 msgstr ""
11519
11520 #. type: Plain text
11521 #: build/C/man3/syslog.3:45
11522 msgid "B<void syslog(int >I<priority>B<, const char *>I<format>B<, ...);>"
11523 msgstr ""
11524
11525 #. type: Plain text
11526 #: build/C/man3/syslog.3:47
11527 msgid "B<void closelog(void);>"
11528 msgstr ""
11529
11530 #. type: Plain text
11531 #: build/C/man3/syslog.3:51
11532 msgid ""
11533 "B<void vsyslog(int >I<priority>B<, const char *>I<format>B<, va_list "
11534 ">I<ap>B<);>"
11535 msgstr ""
11536
11537 #. type: Plain text
11538 #: build/C/man3/syslog.3:59
11539 msgid "B<vsyslog>(): _BSD_SOURCE"
11540 msgstr ""
11541
11542 #. type: Plain text
11543 #: build/C/man3/syslog.3:65
11544 msgid ""
11545 "B<closelog>()  closes the descriptor being used to write to the system "
11546 "logger.  The use of B<closelog>()  is optional."
11547 msgstr ""
11548
11549 #. type: Plain text
11550 #: build/C/man3/syslog.3:77
11551 msgid ""
11552 "B<openlog>()  opens a connection to the system logger for a program.  The "
11553 "string pointed to by I<ident> is prepended to every message, and is "
11554 "typically set to the program name.  If I<ident> is NULL, the program name is "
11555 "used.  (POSIX.1-2008 does not specify the behavior when I<ident> is NULL.)"
11556 msgstr ""
11557
11558 #. type: Plain text
11559 #: build/C/man3/syslog.3:101
11560 msgid ""
11561 "The I<option> argument specifies flags which control the operation of "
11562 "B<openlog>()  and subsequent calls to B<syslog>().  The I<facility> argument "
11563 "establishes a default to be used if none is specified in subsequent calls to "
11564 "B<syslog>().  Values for I<option> and I<facility> are given below.  The use "
11565 "of B<openlog>()  is optional; it will automatically be called by B<syslog>()  "
11566 "if necessary, in which case I<ident> will default to NULL."
11567 msgstr ""
11568
11569 #. type: Plain text
11570 #: build/C/man3/syslog.3:125
11571 msgid ""
11572 "B<syslog>()  generates a log message, which will be distributed by "
11573 "B<syslogd>(8).  The I<priority> argument is formed by ORing the I<facility> "
11574 "and the I<level> values (explained below).  The remaining arguments are a "
11575 "I<format>, as in B<printf>(3)  and any arguments required by the I<format>, "
11576 "except that the two character sequence B<%m> will be replaced by the error "
11577 "message string I<strerror>(I<errno>).  A trailing newline may be added if "
11578 "needed."
11579 msgstr ""
11580
11581 #. type: Plain text
11582 #: build/C/man3/syslog.3:134
11583 msgid ""
11584 "The function B<vsyslog>()  performs the same task as B<syslog>()  with the "
11585 "difference that it takes a set of arguments which have been obtained using "
11586 "the B<stdarg>(3)  variable argument list macros."
11587 msgstr ""
11588
11589 #. type: Plain text
11590 #: build/C/man3/syslog.3:137
11591 msgid ""
11592 "The subsections below list the parameters used to set the values of "
11593 "I<option>,I< facility>, and I<priority>."
11594 msgstr ""
11595
11596 #. type: SS
11597 #: build/C/man3/syslog.3:137
11598 #, no-wrap
11599 msgid "option"
11600 msgstr ""
11601
11602 #. type: Plain text
11603 #: build/C/man3/syslog.3:143
11604 msgid "The I<option> argument to B<openlog>()  is an OR of any of these:"
11605 msgstr ""
11606
11607 #. type: TP
11608 #: build/C/man3/syslog.3:143
11609 #, no-wrap
11610 msgid "B<LOG_CONS>"
11611 msgstr ""
11612
11613 #. type: Plain text
11614 #: build/C/man3/syslog.3:147
11615 msgid ""
11616 "Write directly to system console if there is an error while sending to "
11617 "system logger."
11618 msgstr ""
11619
11620 #. type: TP
11621 #: build/C/man3/syslog.3:147
11622 #, no-wrap
11623 msgid "B<LOG_NDELAY>"
11624 msgstr ""
11625
11626 #. type: Plain text
11627 #: build/C/man3/syslog.3:151
11628 msgid ""
11629 "Open the connection immediately (normally, the connection is opened when the "
11630 "first message is logged)."
11631 msgstr ""
11632
11633 #. type: TP
11634 #: build/C/man3/syslog.3:151
11635 #, no-wrap
11636 msgid "B<LOG_NOWAIT>"
11637 msgstr ""
11638
11639 #. type: Plain text
11640 #: build/C/man3/syslog.3:157
11641 msgid ""
11642 "Don't wait for child processes that may have been created while logging the "
11643 "message.  (The GNU C library does not create a child process, so this option "
11644 "has no effect on Linux.)"
11645 msgstr ""
11646
11647 #. type: TP
11648 #: build/C/man3/syslog.3:157
11649 #, no-wrap
11650 msgid "B<LOG_ODELAY>"
11651 msgstr ""
11652
11653 #. type: Plain text
11654 #: build/C/man3/syslog.3:165
11655 msgid ""
11656 "The converse of B<LOG_NDELAY>; opening of the connection is delayed until "
11657 "B<syslog>()  is called.  (This is the default, and need not be specified.)"
11658 msgstr ""
11659
11660 #. type: TP
11661 #: build/C/man3/syslog.3:165
11662 #, no-wrap
11663 msgid "B<LOG_PERROR>"
11664 msgstr ""
11665
11666 #. type: Plain text
11667 #: build/C/man3/syslog.3:169
11668 msgid "(Not in POSIX.1-2001 or POSIX.1-2008.)  Print to I<stderr> as well."
11669 msgstr ""
11670
11671 #. type: TP
11672 #: build/C/man3/syslog.3:169
11673 #, no-wrap
11674 msgid "B<LOG_PID>"
11675 msgstr ""
11676
11677 #. type: Plain text
11678 #: build/C/man3/syslog.3:172
11679 msgid "Include PID with each message."
11680 msgstr ""
11681
11682 #. type: SS
11683 #: build/C/man3/syslog.3:172
11684 #, no-wrap
11685 msgid "facility"
11686 msgstr ""
11687
11688 #. type: Plain text
11689 #: build/C/man3/syslog.3:178
11690 msgid ""
11691 "The I<facility> argument is used to specify what type of program is logging "
11692 "the message.  This lets the configuration file specify that messages from "
11693 "different facilities will be handled differently."
11694 msgstr ""
11695
11696 #. type: TP
11697 #: build/C/man3/syslog.3:178
11698 #, no-wrap
11699 msgid "B<LOG_AUTH>"
11700 msgstr ""
11701
11702 #. type: Plain text
11703 #: build/C/man3/syslog.3:181
11704 msgid "security/authorization messages"
11705 msgstr ""
11706
11707 #. type: TP
11708 #: build/C/man3/syslog.3:181
11709 #, no-wrap
11710 msgid "B<LOG_AUTHPRIV>"
11711 msgstr ""
11712
11713 #. type: Plain text
11714 #: build/C/man3/syslog.3:184
11715 msgid "security/authorization messages (private)"
11716 msgstr ""
11717
11718 #. type: TP
11719 #: build/C/man3/syslog.3:184
11720 #, no-wrap
11721 msgid "B<LOG_CRON>"
11722 msgstr ""
11723
11724 #. type: Plain text
11725 #: build/C/man3/syslog.3:188
11726 msgid "clock daemon (B<cron> and B<at>)"
11727 msgstr ""
11728
11729 #. type: TP
11730 #: build/C/man3/syslog.3:188
11731 #, no-wrap
11732 msgid "B<LOG_DAEMON>"
11733 msgstr ""
11734
11735 #. type: Plain text
11736 #: build/C/man3/syslog.3:191
11737 msgid "system daemons without separate facility value"
11738 msgstr ""
11739
11740 #. type: TP
11741 #: build/C/man3/syslog.3:191
11742 #, no-wrap
11743 msgid "B<LOG_FTP>"
11744 msgstr ""
11745
11746 #. type: Plain text
11747 #: build/C/man3/syslog.3:194
11748 msgid "ftp daemon"
11749 msgstr ""
11750
11751 #. type: TP
11752 #: build/C/man3/syslog.3:194
11753 #, no-wrap
11754 msgid "B<LOG_KERN>"
11755 msgstr ""
11756
11757 #.  LOG_KERN has the value 0; if used as a facility, zero translates to:
11758 #.  "use the default facility".
11759 #. type: Plain text
11760 #: build/C/man3/syslog.3:199
11761 msgid "kernel messages (these can't be generated from user processes)"
11762 msgstr ""
11763
11764 #. type: TP
11765 #: build/C/man3/syslog.3:199
11766 #, no-wrap
11767 msgid "B<LOG_LOCAL0> through B<LOG_LOCAL7>"
11768 msgstr ""
11769
11770 #. type: Plain text
11771 #: build/C/man3/syslog.3:202
11772 msgid "reserved for local use"
11773 msgstr ""
11774
11775 #. type: TP
11776 #: build/C/man3/syslog.3:202
11777 #, no-wrap
11778 msgid "B<LOG_LPR>"
11779 msgstr ""
11780
11781 #. type: Plain text
11782 #: build/C/man3/syslog.3:205
11783 msgid "line printer subsystem"
11784 msgstr ""
11785
11786 #. type: TP
11787 #: build/C/man3/syslog.3:205
11788 #, no-wrap
11789 msgid "B<LOG_MAIL>"
11790 msgstr ""
11791
11792 #. type: Plain text
11793 #: build/C/man3/syslog.3:208
11794 msgid "mail subsystem"
11795 msgstr ""
11796
11797 #. type: TP
11798 #: build/C/man3/syslog.3:208
11799 #, no-wrap
11800 msgid "B<LOG_NEWS>"
11801 msgstr ""
11802
11803 #. type: Plain text
11804 #: build/C/man3/syslog.3:211
11805 msgid "USENET news subsystem"
11806 msgstr ""
11807
11808 #. type: TP
11809 #: build/C/man3/syslog.3:211
11810 #, no-wrap
11811 msgid "B<LOG_SYSLOG>"
11812 msgstr ""
11813
11814 #. type: Plain text
11815 #: build/C/man3/syslog.3:215
11816 msgid "messages generated internally by B<syslogd>(8)"
11817 msgstr ""
11818
11819 #. type: TP
11820 #: build/C/man3/syslog.3:215
11821 #, no-wrap
11822 msgid "B<LOG_USER> (default)"
11823 msgstr ""
11824
11825 #. type: Plain text
11826 #: build/C/man3/syslog.3:218
11827 msgid "generic user-level messages"
11828 msgstr ""
11829
11830 #. type: TP
11831 #: build/C/man3/syslog.3:218
11832 #, no-wrap
11833 msgid "B<LOG_UUCP>"
11834 msgstr ""
11835
11836 #. type: Plain text
11837 #: build/C/man3/syslog.3:221
11838 msgid "UUCP subsystem"
11839 msgstr ""
11840
11841 #. type: SS
11842 #: build/C/man3/syslog.3:221
11843 #, no-wrap
11844 msgid "level"
11845 msgstr ""
11846
11847 #. type: Plain text
11848 #: build/C/man3/syslog.3:224
11849 msgid ""
11850 "This determines the importance of the message.  The levels are, in order of "
11851 "decreasing importance:"
11852 msgstr ""
11853
11854 #. type: TP
11855 #: build/C/man3/syslog.3:224
11856 #, no-wrap
11857 msgid "B<LOG_EMERG>"
11858 msgstr ""
11859
11860 #. type: Plain text
11861 #: build/C/man3/syslog.3:227
11862 msgid "system is unusable"
11863 msgstr ""
11864
11865 #. type: TP
11866 #: build/C/man3/syslog.3:227
11867 #, no-wrap
11868 msgid "B<LOG_ALERT>"
11869 msgstr ""
11870
11871 #. type: Plain text
11872 #: build/C/man3/syslog.3:230
11873 msgid "action must be taken immediately"
11874 msgstr ""
11875
11876 #. type: TP
11877 #: build/C/man3/syslog.3:230
11878 #, no-wrap
11879 msgid "B<LOG_CRIT>"
11880 msgstr ""
11881
11882 #. type: Plain text
11883 #: build/C/man3/syslog.3:233
11884 msgid "critical conditions"
11885 msgstr ""
11886
11887 #. type: TP
11888 #: build/C/man3/syslog.3:233
11889 #, no-wrap
11890 msgid "B<LOG_ERR>"
11891 msgstr ""
11892
11893 #. type: Plain text
11894 #: build/C/man3/syslog.3:236
11895 msgid "error conditions"
11896 msgstr ""
11897
11898 #. type: TP
11899 #: build/C/man3/syslog.3:236
11900 #, no-wrap
11901 msgid "B<LOG_WARNING>"
11902 msgstr ""
11903
11904 #. type: Plain text
11905 #: build/C/man3/syslog.3:239
11906 msgid "warning conditions"
11907 msgstr ""
11908
11909 #. type: TP
11910 #: build/C/man3/syslog.3:239
11911 #, no-wrap
11912 msgid "B<LOG_NOTICE>"
11913 msgstr ""
11914
11915 #. type: Plain text
11916 #: build/C/man3/syslog.3:242
11917 msgid "normal, but significant, condition"
11918 msgstr ""
11919
11920 #. type: TP
11921 #: build/C/man3/syslog.3:242
11922 #, no-wrap
11923 msgid "B<LOG_INFO>"
11924 msgstr ""
11925
11926 #. type: Plain text
11927 #: build/C/man3/syslog.3:245
11928 msgid "informational message"
11929 msgstr ""
11930
11931 #. type: TP
11932 #: build/C/man3/syslog.3:245
11933 #, no-wrap
11934 msgid "B<LOG_DEBUG>"
11935 msgstr ""
11936
11937 #. type: Plain text
11938 #: build/C/man3/syslog.3:248
11939 msgid "debug-level message"
11940 msgstr ""
11941
11942 #. type: Plain text
11943 #: build/C/man3/syslog.3:252
11944 msgid ""
11945 "The function B<setlogmask>(3)  can be used to restrict logging to specified "
11946 "levels only."
11947 msgstr ""
11948
11949 #.  .SH HISTORY
11950 #.  A
11951 #.  .BR syslog ()
11952 #.  function call appeared in 4.2BSD.
11953 #.  4.3BSD documents
11954 #.  .BR openlog (),
11955 #.  .BR syslog (),
11956 #.  .BR closelog (),
11957 #.  and
11958 #.  .BR setlogmask ().
11959 #.  4.3BSD-Reno also documents
11960 #.  .BR vsyslog ().
11961 #.  Of course early v* functions used the
11962 #.  .I <varargs.h>
11963 #.  mechanism, which is not compatible with
11964 #.  .IR <stdarg.h> .
11965 #. type: Plain text
11966 #: build/C/man3/syslog.3:296
11967 msgid ""
11968 "The functions B<openlog>(), B<closelog>(), and B<syslog>()  (but not "
11969 "B<vsyslog>())  are specified in SUSv2, POSIX.1-2001, and POSIX.1-2008.  "
11970 "POSIX.1-2001 specifies only the B<LOG_USER> and B<LOG_LOCAL*> values for "
11971 "I<facility>.  However, with the exception of B<LOG_AUTHPRIV> and B<LOG_FTP>, "
11972 "the other I<facility> values appear on most UNIX systems.  The B<LOG_PERROR> "
11973 "value for I<option> is not specified by POSIX.1-2001 or POSIX.1-2008, but is "
11974 "available in most versions of UNIX."
11975 msgstr ""
11976
11977 #. type: Plain text
11978 #: build/C/man3/syslog.3:308
11979 msgid ""
11980 "The argument I<ident> in the call of B<openlog>()  is probably stored "
11981 "as-is.  Thus, if the string it points to is changed, B<syslog>()  may start "
11982 "prepending the changed string, and if the string it points to ceases to "
11983 "exist, the results are undefined.  Most portable is to use a string "
11984 "constant."
11985 msgstr ""
11986
11987 #. type: Plain text
11988 #: build/C/man3/syslog.3:311
11989 msgid ""
11990 "Never pass a string with user-supplied data as a format, use the following "
11991 "instead:"
11992 msgstr ""
11993
11994 #. type: Plain text
11995 #: build/C/man3/syslog.3:314
11996 #, no-wrap
11997 msgid "    syslog(priority, \"%s\", string);\n"
11998 msgstr ""
11999
12000 #. type: Plain text
12001 #: build/C/man3/syslog.3:320
12002 msgid "B<logger>(1), B<setlogmask>(3), B<syslog.conf>(5), B<syslogd>(8)"
12003 msgstr ""
12004
12005 #. type: TH
12006 #: build/C/man4/ttyS.4:26
12007 #, no-wrap
12008 msgid "TTYS"
12009 msgstr ""
12010
12011 #. type: TH
12012 #: build/C/man4/ttyS.4:26
12013 #, no-wrap
12014 msgid "1992-12-19"
12015 msgstr ""
12016
12017 #. type: Plain text
12018 #: build/C/man4/ttyS.4:29
12019 msgid "ttyS - serial terminal lines"
12020 msgstr ""
12021
12022 #. type: Plain text
12023 #: build/C/man4/ttyS.4:32
12024 msgid "B<ttyS[0-3]> are character devices for the serial terminal lines."
12025 msgstr ""
12026
12027 #. type: Plain text
12028 #: build/C/man4/ttyS.4:37
12029 msgid "mknod -m 660 /dev/ttyS0 c 4 64 # base address 0x3f8"
12030 msgstr ""
12031
12032 #. type: Plain text
12033 #: build/C/man4/ttyS.4:39
12034 msgid "mknod -m 660 /dev/ttyS1 c 4 65 # base address 0x2f8"
12035 msgstr ""
12036
12037 #. type: Plain text
12038 #: build/C/man4/ttyS.4:41
12039 msgid "mknod -m 660 /dev/ttyS2 c 4 66 # base address 0x3e8"
12040 msgstr ""
12041
12042 #. type: Plain text
12043 #: build/C/man4/ttyS.4:43
12044 msgid "mknod -m 660 /dev/ttyS3 c 4 67 # base address 0x2e8"
12045 msgstr ""
12046
12047 #. type: Plain text
12048 #: build/C/man4/ttyS.4:45
12049 msgid "chown root:tty /dev/ttyS[0-3]"
12050 msgstr ""
12051
12052 #. type: Plain text
12053 #: build/C/man4/ttyS.4:48
12054 msgid "/dev/ttyS[0-3]"
12055 msgstr ""
12056
12057 #. type: Plain text
12058 #: build/C/man4/ttyS.4:55
12059 msgid ""
12060 "B<chown>(1), B<mknod>(1), B<tty>(4), B<agetty>(8), B<mingetty>(8), "
12061 "B<setserial>(8)"
12062 msgstr ""
12063
12064 #. type: TH
12065 #: build/C/man7/uri.7:48
12066 #, no-wrap
12067 msgid "URI"
12068 msgstr ""
12069
12070 #. type: TH
12071 #: build/C/man7/uri.7:48
12072 #, no-wrap
12073 msgid "2013-05-18"
12074 msgstr ""
12075
12076 #. type: Plain text
12077 #: build/C/man7/uri.7:51
12078 msgid "uri, url, urn - uniform resource identifier (URI), including a URL or URN"
12079 msgstr ""
12080
12081 #. type: Plain text
12082 #: build/C/man7/uri.7:55
12083 #, no-wrap
12084 msgid "URI = [ absoluteURI | relativeURI ] [ \"#\" fragment ]\n"
12085 msgstr ""
12086
12087 #. type: Plain text
12088 #: build/C/man7/uri.7:57
12089 #, no-wrap
12090 msgid "absoluteURI = scheme \":\" ( hierarchical_part | opaque_part )\n"
12091 msgstr ""
12092
12093 #. type: Plain text
12094 #: build/C/man7/uri.7:59
12095 #, no-wrap
12096 msgid "relativeURI = ( net_path | absolute_path | relative_path ) [ \"?\" query ]\n"
12097 msgstr ""
12098
12099 #. type: Plain text
12100 #: build/C/man7/uri.7:62
12101 #, no-wrap
12102 msgid ""
12103 "scheme = \"http\" | \"ftp\" | \"gopher\" | \"mailto\" | \"news\" | "
12104 "\"telnet\" |\n"
12105 "         \"file\" | \"man\" | \"info\" | \"whatis\" | \"ldap\" | \"wais\" | "
12106 "\\&...\n"
12107 msgstr ""
12108
12109 #. type: Plain text
12110 #: build/C/man7/uri.7:64
12111 #, no-wrap
12112 msgid "hierarchical_part = ( net_path | absolute_path ) [ \"?\" query ]\n"
12113 msgstr ""
12114
12115 #. type: Plain text
12116 #: build/C/man7/uri.7:66
12117 #, no-wrap
12118 msgid "net_path = \"//\" authority [ absolute_path ]\n"
12119 msgstr ""
12120
12121 #. type: Plain text
12122 #: build/C/man7/uri.7:68
12123 #, no-wrap
12124 msgid "absolute_path = \"/\"  path_segments\n"
12125 msgstr ""
12126
12127 #. type: Plain text
12128 #: build/C/man7/uri.7:70
12129 #, no-wrap
12130 msgid "relative_path = relative_segment [ absolute_path ]\n"
12131 msgstr ""
12132
12133 #. type: Plain text
12134 #: build/C/man7/uri.7:82
12135 msgid ""
12136 "A Uniform Resource Identifier (URI) is a short string of characters "
12137 "identifying an abstract or physical resource (for example, a web page).  A "
12138 "Uniform Resource Locator (URL) is a URI that identifies a resource through "
12139 "its primary access mechanism (e.g., its network \"location\"), rather than "
12140 "by name or some other attribute of that resource.  A Uniform Resource Name "
12141 "(URN) is a URI that must remain globally unique and persistent even when the "
12142 "resource ceases to exist or becomes unavailable."
12143 msgstr ""
12144
12145 #. type: Plain text
12146 #: build/C/man7/uri.7:89
12147 msgid ""
12148 "URIs are the standard way to name hypertext link destinations for tools such "
12149 "as web browsers.  The string \"http://www.kernelnotes.org\" is a URL (and "
12150 "thus it is also a URI).  Many people use the term URL loosely as a synonym "
12151 "for URI (though technically URLs are a subset of URIs)."
12152 msgstr ""
12153
12154 #. type: Plain text
12155 #: build/C/man7/uri.7:105
12156 msgid ""
12157 "URIs can be absolute or relative.  An absolute identifier refers to a "
12158 "resource independent of context, while a relative identifier refers to a "
12159 "resource by describing the difference from the current context.  Within a "
12160 "relative path reference, the complete path segments \".\" and \"..\" have "
12161 "special meanings: \"the current hierarchy level\" and \"the level above this "
12162 "hierarchy level\", respectively, just like they do in UNIX-like systems.  A "
12163 "path segment which contains a colon character can't be used as the first "
12164 "segment of a relative URI path (e.g., \"this:that\"), because it would be "
12165 "mistaken for a scheme name; precede such segments with ./ (e.g., "
12166 "\"./this:that\").  Note that descendants of MS-DOS (e.g., Microsoft Windows) "
12167 "replace devicename colons with the vertical bar (\"|\") in URIs, so \"C:\" "
12168 "becomes \"C|\"."
12169 msgstr ""
12170
12171 #. type: Plain text
12172 #: build/C/man7/uri.7:109
12173 msgid ""
12174 "A fragment identifier, if included, refers to a particular named portion "
12175 "(fragment) of a resource; text after a \\(aq#\\(aq identifies the fragment.  "
12176 "A URI beginning with \\(aq#\\(aq refers to that fragment in the current "
12177 "resource."
12178 msgstr ""
12179
12180 #. type: Plain text
12181 #: build/C/man7/uri.7:117
12182 msgid ""
12183 "There are many different URI schemes, each with specific additional rules "
12184 "and meanings, but they are intentionally made to be as similar as possible.  "
12185 "For example, many URL schemes permit the authority to be the following "
12186 "format, called here an I<ip_server> (square brackets show what's optional):"
12187 msgstr ""
12188
12189 #. type: Plain text
12190 #: build/C/man7/uri.7:119
12191 msgid "I<ip_server = >[I<user> [ : I<password> ] @ ] I<host> [ : I<port>]"
12192 msgstr ""
12193
12194 #. type: Plain text
12195 #: build/C/man7/uri.7:135
12196 msgid ""
12197 "This format allows you to optionally insert a username, a user plus "
12198 "password, and/or a port number.  The I<host> is the name of the host "
12199 "computer, either its name as determined by DNS or an IP address (numbers "
12200 "separated by periods).  Thus the URI "
12201 "E<lt>http://fred:fredpassword@xyz.com:8080/E<gt> logs into a web server on "
12202 "host xyz.com as fred (using fredpassword) using port 8080.  Avoid including "
12203 "a password in a URI if possible because of the many security risks of having "
12204 "a password written down.  If the URL supplies a username but no password, "
12205 "and the remote server requests a password, the program interpreting the URL "
12206 "should request one from the user."
12207 msgstr ""
12208
12209 #. type: Plain text
12210 #: build/C/man7/uri.7:140
12211 msgid ""
12212 "Here are some of the most common schemes in use on UNIX-like systems that "
12213 "are understood by many tools.  Note that many tools using URIs also have "
12214 "internal schemes or specialized schemes; see those tools' documentation for "
12215 "information on those schemes."
12216 msgstr ""
12217
12218 #. type: Plain text
12219 #: build/C/man7/uri.7:142
12220 msgid "B<http - Web (HTTP) server>"
12221 msgstr ""
12222
12223 #. type: Plain text
12224 #: build/C/man7/uri.7:144
12225 msgid "http://I<ip_server>/I<path>"
12226 msgstr ""
12227
12228 #. type: Plain text
12229 #: build/C/man7/uri.7:146
12230 msgid "http://I<ip_server>/I<path>?I<query>"
12231 msgstr ""
12232
12233 #. type: Plain text
12234 #: build/C/man7/uri.7:154
12235 msgid ""
12236 "This is a URL accessing a web (HTTP) server.  The default port is 80.  If "
12237 "the path refers to a directory, the web server will choose what to return; "
12238 "usually if there is a file named \"index.html\" or \"index.htm\" its content "
12239 "is returned, otherwise, a list of the files in the current directory (with "
12240 "appropriate links) is generated and returned.  An example is "
12241 "E<lt>http://lwn.netE<gt>."
12242 msgstr ""
12243
12244 #. type: Plain text
12245 #: build/C/man7/uri.7:177
12246 msgid ""
12247 "A query can be given in the archaic \"isindex\" format, consisting of a word "
12248 "or phrase and not including an equal sign (=).  A query can also be in the "
12249 "longer \"GET\" format, which has one or more query entries of the form "
12250 "I<key>=I<value> separated by the ampersand character (&).  Note that I<key> "
12251 "can be repeated more than once, though it's up to the web server and its "
12252 "application programs to determine if there's any meaning to that.  There is "
12253 "an unfortunate interaction with HTML/XML/SGML and the GET query format; when "
12254 "such URIs with more than one key are embedded in SGML/XML documents "
12255 "(including HTML), the ampersand (&) has to be rewritten as &amp;.  Note that "
12256 "not all queries use this format; larger forms may be too long to store as a "
12257 "URI, so they use a different interaction mechanism (called POST) which does "
12258 "not include the data in the URI.  See the Common Gateway Interface "
12259 "specification at E<.UR http://www.w3.org\\:/CGI> E<.UE> for more "
12260 "information."
12261 msgstr ""
12262
12263 #. type: Plain text
12264 #: build/C/man7/uri.7:179
12265 msgid "B<ftp - File Transfer Protocol (FTP)>"
12266 msgstr ""
12267
12268 #. type: Plain text
12269 #: build/C/man7/uri.7:181
12270 msgid "ftp://I<ip_server>/I<path>"
12271 msgstr ""
12272
12273 #. type: Plain text
12274 #: build/C/man7/uri.7:189
12275 msgid ""
12276 "This is a URL accessing a file through the file transfer protocol (FTP).  "
12277 "The default port (for control) is 21.  If no username is included, the "
12278 "username \"anonymous\" is supplied, and in that case many clients provide as "
12279 "the password the requestor's Internet email address.  An example is "
12280 "E<lt>ftp://ftp.is.co.za/rfc/rfc1808.txtE<gt>."
12281 msgstr ""
12282
12283 #. type: Plain text
12284 #: build/C/man7/uri.7:191
12285 msgid "B<gopher - Gopher server>"
12286 msgstr ""
12287
12288 #. type: Plain text
12289 #: build/C/man7/uri.7:193
12290 msgid "gopher://I<ip_server>/I<gophertype selector>"
12291 msgstr ""
12292
12293 #. type: Plain text
12294 #: build/C/man7/uri.7:195
12295 msgid "gopher://I<ip_server>/I<gophertype selector>%09I<search>"
12296 msgstr ""
12297
12298 #. type: Plain text
12299 #: build/C/man7/uri.7:197
12300 msgid "gopher://I<ip_server>/I<gophertype selector>%09I<search>%09I<gopher+_string>"
12301 msgstr ""
12302
12303 #. type: Plain text
12304 #: build/C/man7/uri.7:207
12305 msgid ""
12306 "The default gopher port is 70.  I<gophertype> is a single-character field to "
12307 "denote the Gopher type of the resource to which the URL refers.  The entire "
12308 "path may also be empty, in which case the delimiting \"/\" is also optional "
12309 "and the gophertype defaults to \"1\"."
12310 msgstr ""
12311
12312 #. type: Plain text
12313 #: build/C/man7/uri.7:214
12314 msgid ""
12315 "I<selector> is the Gopher selector string.  In the Gopher protocol, Gopher "
12316 "selector strings are a sequence of octets which may contain any octets "
12317 "except 09 hexadecimal (US-ASCII HT or tab), 0A hexadecimal (US-ASCII "
12318 "character LF), and 0D (US-ASCII character CR)."
12319 msgstr ""
12320
12321 #. type: Plain text
12322 #: build/C/man7/uri.7:216
12323 msgid "B<mailto - Email address>"
12324 msgstr ""
12325
12326 #. type: Plain text
12327 #: build/C/man7/uri.7:218
12328 msgid "mailto:I<email-address>"
12329 msgstr ""
12330
12331 #. type: Plain text
12332 #: build/C/man7/uri.7:226
12333 msgid ""
12334 "This is an email address, usually of the form I<name>@I<hostname>.  See "
12335 "B<mailaddr>(7)  for more information on the correct format of an email "
12336 "address.  Note that any % character must be rewritten as %25.  An example is "
12337 "E<lt>mailto:dwheeler@dwheeler.comE<gt>."
12338 msgstr ""
12339
12340 #. type: Plain text
12341 #: build/C/man7/uri.7:228
12342 msgid "B<news - Newsgroup or News message>"
12343 msgstr ""
12344
12345 #. type: Plain text
12346 #: build/C/man7/uri.7:230
12347 msgid "news:I<newsgroup-name>"
12348 msgstr ""
12349
12350 #. type: Plain text
12351 #: build/C/man7/uri.7:232
12352 msgid "news:I<message-id>"
12353 msgstr ""
12354
12355 #. type: Plain text
12356 #: build/C/man7/uri.7:240
12357 msgid ""
12358 "A I<newsgroup-name> is a period-delimited hierarchical name, such as "
12359 "\"comp.infosystems.www.misc\".  If E<lt>newsgroup-nameE<gt> is \"*\" (as in "
12360 "E<lt>news:*E<gt>), it is used to refer to \"all available news groups\".  An "
12361 "example is E<lt>news:comp.lang.adaE<gt>."
12362 msgstr ""
12363
12364 #. type: Plain text
12365 #: build/C/man7/uri.7:252
12366 msgid ""
12367 "A I<message-id> corresponds to the Message-ID of E<.UR "
12368 "http://www.ietf.org\\:/rfc\\:/rfc1036.txt> IETF RFC\\ 1036, E<.UE> without "
12369 "the enclosing \"E<lt>\" and \"E<gt>\"; it takes the form "
12370 "I<unique>@I<full_domain_name>.  A message identifier may be distinguished "
12371 "from a news group name by the presence of the \"@\" character."
12372 msgstr ""
12373
12374 #. type: Plain text
12375 #: build/C/man7/uri.7:254
12376 msgid "B<telnet - Telnet login>"
12377 msgstr ""
12378
12379 #. type: Plain text
12380 #: build/C/man7/uri.7:256
12381 msgid "telnet://I<ip_server>/"
12382 msgstr ""
12383
12384 #. type: Plain text
12385 #: build/C/man7/uri.7:262
12386 msgid ""
12387 "The Telnet URL scheme is used to designate interactive text services that "
12388 "may be accessed by the Telnet protocol.  The final \"/\" character may be "
12389 "omitted.  The default port is 23.  An example is "
12390 "E<lt>telnet://melvyl.ucop.edu/E<gt>."
12391 msgstr ""
12392
12393 #. type: Plain text
12394 #: build/C/man7/uri.7:264
12395 msgid "B<file - Normal file>"
12396 msgstr ""
12397
12398 #. type: Plain text
12399 #: build/C/man7/uri.7:266
12400 msgid "file://I<ip_server>/I<path_segments>"
12401 msgstr ""
12402
12403 #. type: Plain text
12404 #: build/C/man7/uri.7:268
12405 msgid "file:I<path_segments>"
12406 msgstr ""
12407
12408 #. type: Plain text
12409 #: build/C/man7/uri.7:285
12410 msgid ""
12411 "This represents a file or directory accessible locally.  As a special case, "
12412 "I<ip_server> can be the string \"localhost\" or the empty string; this is "
12413 "interpreted as \"the machine from which the URL is being interpreted\".  If "
12414 "the path is to a directory, the viewer should display the directory's "
12415 "contents with links to each containee; not all viewers currently do this.  "
12416 "KDE supports generated files through the URL E<lt>file:/cgi-binE<gt>.  If "
12417 "the given file isn't found, browser writers may want to try to expand the "
12418 "filename via filename globbing (see B<glob>(7)  and B<glob>(3))."
12419 msgstr ""
12420
12421 #. type: Plain text
12422 #: build/C/man7/uri.7:299
12423 msgid ""
12424 "The second format (e.g., E<lt>file:/etc/passwdE<gt>)  is a correct format "
12425 "for referring to a local file.  However, older standards did not permit this "
12426 "format, and some programs don't recognize this as a URI.  A more portable "
12427 "syntax is to use an empty string as the server name, for example, "
12428 "E<lt>file:///etc/passwdE<gt>; this form does the same thing and is easily "
12429 "recognized by pattern matchers and older programs as a URI.  Note that if "
12430 "you really mean to say \"start from the current location,\" don't specify "
12431 "the scheme at all; use a relative address like E<lt>../test.txtE<gt>, which "
12432 "has the side-effect of being scheme-independent.  An example of this scheme "
12433 "is E<lt>file:///etc/passwdE<gt>."
12434 msgstr ""
12435
12436 #. type: Plain text
12437 #: build/C/man7/uri.7:301
12438 msgid "B<man - Man page documentation>"
12439 msgstr ""
12440
12441 #. type: Plain text
12442 #: build/C/man7/uri.7:303
12443 msgid "man:I<command-name>"
12444 msgstr ""
12445
12446 #. type: Plain text
12447 #: build/C/man7/uri.7:305
12448 msgid "man:I<command-name>(I<section>)"
12449 msgstr ""
12450
12451 #. type: Plain text
12452 #: build/C/man7/uri.7:314
12453 msgid ""
12454 "This refers to local online manual (man) reference pages.  The command name "
12455 "can optionally be followed by a parenthesis and section number; see "
12456 "B<man>(7)  for more information on the meaning of the section numbers.  This "
12457 "URI scheme is unique to UNIX-like systems (such as Linux)  and is not "
12458 "currently registered by the IETF.  An example is E<lt>man:ls(1)E<gt>."
12459 msgstr ""
12460
12461 #. type: Plain text
12462 #: build/C/man7/uri.7:316
12463 msgid "B<info - Info page documentation>"
12464 msgstr ""
12465
12466 #. type: Plain text
12467 #: build/C/man7/uri.7:318
12468 msgid "info:I<virtual-filename>"
12469 msgstr ""
12470
12471 #. type: Plain text
12472 #: build/C/man7/uri.7:320
12473 msgid "info:I<virtual-filename>#I<nodename>"
12474 msgstr ""
12475
12476 #. type: Plain text
12477 #: build/C/man7/uri.7:322
12478 msgid "info:(I<virtual-filename>)"
12479 msgstr ""
12480
12481 #. type: Plain text
12482 #: build/C/man7/uri.7:324
12483 msgid "info:(I<virtual-filename>)I<nodename>"
12484 msgstr ""
12485
12486 #. type: Plain text
12487 #: build/C/man7/uri.7:343
12488 msgid ""
12489 "This scheme refers to online info reference pages (generated from texinfo "
12490 "files), a documentation format used by programs such as the GNU tools.  This "
12491 "URI scheme is unique to UNIX-like systems (such as Linux)  and is not "
12492 "currently registered by the IETF.  As of this writing, GNOME and KDE differ "
12493 "in their URI syntax and do not accept the other's syntax.  The first two "
12494 "formats are the GNOME format; in nodenames all spaces are written as "
12495 "underscores.  The second two formats are the KDE format; spaces in nodenames "
12496 "must be written as spaces, even though this is forbidden by the URI "
12497 "standards.  It's hoped that in the future most tools will understand all of "
12498 "these formats and will always accept underscores for spaces in nodenames.  "
12499 "In both GNOME and KDE, if the form without the nodename is used the nodename "
12500 "is assumed to be \"Top\".  Examples of the GNOME format are "
12501 "E<lt>info:gccE<gt> and E<lt>info:gcc#G++_and_GCCE<gt>.  Examples of the KDE "
12502 "format are E<lt>info:(gcc)E<gt> and E<lt>info:(gcc)G++ and GCCE<gt>."
12503 msgstr ""
12504
12505 #. type: Plain text
12506 #: build/C/man7/uri.7:345
12507 msgid "B<whatis - Documentation search>"
12508 msgstr ""
12509
12510 #. type: Plain text
12511 #: build/C/man7/uri.7:347
12512 msgid "whatis:I<string>"
12513 msgstr ""
12514
12515 #. type: Plain text
12516 #: build/C/man7/uri.7:355
12517 msgid ""
12518 "This scheme searches the database of short (one-line) descriptions of "
12519 "commands and returns a list of descriptions containing that string.  Only "
12520 "complete word matches are returned.  See B<whatis>(1).  This URI scheme is "
12521 "unique to UNIX-like systems (such as Linux)  and is not currently registered "
12522 "by the IETF."
12523 msgstr ""
12524
12525 #. type: Plain text
12526 #: build/C/man7/uri.7:357
12527 msgid "B<ghelp - GNOME help documentation>"
12528 msgstr ""
12529
12530 #. type: Plain text
12531 #: build/C/man7/uri.7:359
12532 msgid "ghelp:I<name-of-application>"
12533 msgstr ""
12534
12535 #. type: Plain text
12536 #: build/C/man7/uri.7:362
12537 msgid ""
12538 "This loads GNOME help for the given application.  Note that not much "
12539 "documentation currently exists in this format."
12540 msgstr ""
12541
12542 #. type: Plain text
12543 #: build/C/man7/uri.7:364
12544 msgid "B<ldap - Lightweight Directory Access Protocol>"
12545 msgstr ""
12546
12547 #. type: Plain text
12548 #: build/C/man7/uri.7:366
12549 msgid "ldap://I<hostport>"
12550 msgstr ""
12551
12552 #. type: Plain text
12553 #: build/C/man7/uri.7:368
12554 msgid "ldap://I<hostport>/"
12555 msgstr ""
12556
12557 #. type: Plain text
12558 #: build/C/man7/uri.7:370
12559 msgid "ldap://I<hostport>/I<dn>"
12560 msgstr ""
12561
12562 #. type: Plain text
12563 #: build/C/man7/uri.7:372
12564 msgid "ldap://I<hostport>/I<dn>?I<attributes>"
12565 msgstr ""
12566
12567 #. type: Plain text
12568 #: build/C/man7/uri.7:374
12569 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>"
12570 msgstr ""
12571
12572 #. type: Plain text
12573 #: build/C/man7/uri.7:376
12574 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>?I<filter>"
12575 msgstr ""
12576
12577 #. type: Plain text
12578 #: build/C/man7/uri.7:378
12579 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>?I<filter>?I<extensions>"
12580 msgstr ""
12581
12582 #. type: Plain text
12583 #: build/C/man7/uri.7:389
12584 msgid ""
12585 "This scheme supports queries to the Lightweight Directory Access Protocol "
12586 "(LDAP), a protocol for querying a set of servers for hierarchically "
12587 "organized information (such as people and computing resources).  See E<.UR "
12588 "http://www.ietf.org\\:/rfc\\:/rfc2255.txt> RFC\\ 2255 E<.UE> for more "
12589 "information on the LDAP URL scheme.  The components of this URL are:"
12590 msgstr ""
12591
12592 #. type: IP
12593 #: build/C/man7/uri.7:389
12594 #, no-wrap
12595 msgid "hostport"
12596 msgstr ""
12597
12598 #. type: Plain text
12599 #: build/C/man7/uri.7:394
12600 msgid ""
12601 "the LDAP server to query, written as a hostname optionally followed by a "
12602 "colon and the port number.  The default LDAP port is TCP port 389.  If "
12603 "empty, the client determines which the LDAP server to use."
12604 msgstr ""
12605
12606 #. type: IP
12607 #: build/C/man7/uri.7:394
12608 #, no-wrap
12609 msgid "dn"
12610 msgstr ""
12611
12612 #. type: Plain text
12613 #: build/C/man7/uri.7:401
12614 msgid ""
12615 "the LDAP Distinguished Name, which identifies the base object of the LDAP "
12616 "search (see E<.UR http://www.ietf.org\\:/rfc\\:/rfc2253.txt> RFC\\ 2253 "
12617 "E<.UE> section 3)."
12618 msgstr ""
12619
12620 #. type: IP
12621 #: build/C/man7/uri.7:401
12622 #, no-wrap
12623 msgid "attributes"
12624 msgstr ""
12625
12626 #. type: Plain text
12627 #: build/C/man7/uri.7:405
12628 msgid ""
12629 "a comma-separated list of attributes to be returned; see RFC\\ 2251 section "
12630 "4.1.5.  If omitted, all attributes should be returned."
12631 msgstr ""
12632
12633 #. type: IP
12634 #: build/C/man7/uri.7:405
12635 #, no-wrap
12636 msgid "scope"
12637 msgstr ""
12638
12639 #. type: Plain text
12640 #: build/C/man7/uri.7:410
12641 msgid ""
12642 "specifies the scope of the search, which can be one of \"base\" (for a base "
12643 "object search), \"one\" (for a one-level search), or \"sub\" (for a subtree "
12644 "search).  If scope is omitted, \"base\" is assumed."
12645 msgstr ""
12646
12647 #. type: IP
12648 #: build/C/man7/uri.7:410
12649 #, no-wrap
12650 msgid "filter"
12651 msgstr ""
12652
12653 #. type: Plain text
12654 #: build/C/man7/uri.7:419
12655 msgid ""
12656 "specifies the search filter (subset of entries to return).  If omitted, all "
12657 "entries should be returned.  See E<.UR "
12658 "http://www.ietf.org\\:/rfc\\:/rfc2254.txt> RFC\\ 2254 E<.UE> section 4."
12659 msgstr ""
12660
12661 #. type: IP
12662 #: build/C/man7/uri.7:419
12663 #, no-wrap
12664 msgid "extensions"
12665 msgstr ""
12666
12667 #. type: Plain text
12668 #: build/C/man7/uri.7:425
12669 msgid ""
12670 "a comma-separated list of type=value pairs, where the =value portion may be "
12671 "omitted for options not requiring it.  An extension prefixed with a "
12672 "\\(aq!\\(aq is critical (must be supported to be valid), otherwise it is "
12673 "noncritical (optional)."
12674 msgstr ""
12675
12676 #. type: Plain text
12677 #: build/C/man7/uri.7:429
12678 msgid ""
12679 "LDAP queries are easiest to explain by example.  Here's a query that asks "
12680 "ldap.itd.umich.edu for information about the University of Michigan in the "
12681 "U.S.:"
12682 msgstr ""
12683
12684 #. type: Plain text
12685 #: build/C/man7/uri.7:432
12686 #, no-wrap
12687 msgid "ldap://ldap.itd.umich.edu/o=University%20of%20Michigan,c=US\n"
12688 msgstr ""
12689
12690 #. type: Plain text
12691 #: build/C/man7/uri.7:435
12692 msgid "To just get its postal address attribute, request:"
12693 msgstr ""
12694
12695 #. type: Plain text
12696 #: build/C/man7/uri.7:438
12697 #, no-wrap
12698 msgid "ldap://ldap.itd.umich.edu/o=University%20of%20Michigan,c=US?postalAddress\n"
12699 msgstr ""
12700
12701 #. type: Plain text
12702 #: build/C/man7/uri.7:442
12703 msgid ""
12704 "To ask a host.com at port 6666 for information about the person with common "
12705 "name (cn) \"Babs Jensen\" at University of Michigan, request:"
12706 msgstr ""
12707
12708 #. type: Plain text
12709 #: build/C/man7/uri.7:445
12710 #, no-wrap
12711 msgid "ldap://host.com:6666/o=University%20of%20Michigan,c=US??sub?(cn=Babs%20Jensen)\n"
12712 msgstr ""
12713
12714 #. type: Plain text
12715 #: build/C/man7/uri.7:448
12716 msgid "B<wais - Wide Area Information Servers>"
12717 msgstr ""
12718
12719 #. type: Plain text
12720 #: build/C/man7/uri.7:450
12721 msgid "wais://I<hostport>/I<database>"
12722 msgstr ""
12723
12724 #. type: Plain text
12725 #: build/C/man7/uri.7:452
12726 msgid "wais://I<hostport>/I<database>?I<search>"
12727 msgstr ""
12728
12729 #. type: Plain text
12730 #: build/C/man7/uri.7:454
12731 msgid "wais://I<hostport>/I<database>/I<wtype>/I<wpath>"
12732 msgstr ""
12733
12734 #. type: Plain text
12735 #: build/C/man7/uri.7:463
12736 msgid ""
12737 "This scheme designates a WAIS database, search, or document (see E<.UR "
12738 "http://www.ietf.org\\:/rfc\\:/rfc1625.txt> IETF RFC\\ 1625 E<.UE> for more "
12739 "information on WAIS).  Hostport is the hostname, optionally followed by a "
12740 "colon and port number (the default port number is 210)."
12741 msgstr ""
12742
12743 #. type: Plain text
12744 #: build/C/man7/uri.7:473
12745 msgid ""
12746 "The first form designates a WAIS database for searching.  The second form "
12747 "designates a particular search of the WAIS database I<database>.  The third "
12748 "form designates a particular document within a WAIS database to be "
12749 "retrieved.  I<wtype> is the WAIS designation of the type of the object and "
12750 "I<wpath> is the WAIS document-id."
12751 msgstr ""
12752
12753 #. type: Plain text
12754 #: build/C/man7/uri.7:475
12755 msgid "B<other schemes>"
12756 msgstr ""
12757
12758 #. type: Plain text
12759 #: build/C/man7/uri.7:489
12760 msgid ""
12761 "There are many other URI schemes.  Most tools that accept URIs support a set "
12762 "of internal URIs (e.g., Mozilla has the about: scheme for internal "
12763 "information, and the GNOME help browser has the toc: scheme for various "
12764 "starting locations).  There are many schemes that have been defined but are "
12765 "not as widely used at the current time (e.g., prospero).  The nntp: scheme "
12766 "is deprecated in favor of the news: scheme.  URNs are to be supported by the "
12767 "urn: scheme, with a hierarchical name space (e.g., urn:ietf:... would "
12768 "identify IETF documents); at this time URNs are not widely implemented.  Not "
12769 "all tools support all schemes."
12770 msgstr ""
12771
12772 #. type: SS
12773 #: build/C/man7/uri.7:489
12774 #, no-wrap
12775 msgid "Character encoding"
12776 msgstr ""
12777
12778 #. type: Plain text
12779 #: build/C/man7/uri.7:493
12780 msgid ""
12781 "URIs use a limited number of characters so that they can be typed in and "
12782 "used in a variety of situations."
12783 msgstr ""
12784
12785 #. type: Plain text
12786 #: build/C/man7/uri.7:497
12787 msgid ""
12788 "The following characters are reserved, that is, they may appear in a URI but "
12789 "their use is limited to their reserved purpose (conflicting data must be "
12790 "escaped before forming the URI):"
12791 msgstr ""
12792
12793 #. type: Plain text
12794 #: build/C/man7/uri.7:499
12795 #, no-wrap
12796 msgid "   ; / ? : @ & = + $ ,\n"
12797 msgstr ""
12798
12799 #. type: Plain text
12800 #: build/C/man7/uri.7:505
12801 msgid ""
12802 "Unreserved characters may be included in a URI.  Unreserved characters "
12803 "include upper and lower case English letters, decimal digits, and the "
12804 "following limited set of punctuation marks and symbols:"
12805 msgstr ""
12806
12807 #. type: Plain text
12808 #: build/C/man7/uri.7:507
12809 #, no-wrap
12810 msgid " - _ . ! ~ * ' ( )\n"
12811 msgstr ""
12812
12813 #. type: Plain text
12814 #: build/C/man7/uri.7:522
12815 msgid ""
12816 "All other characters must be escaped.  An escaped octet is encoded as a "
12817 "character triplet, consisting of the percent character \"%\" followed by the "
12818 "two hexadecimal digits representing the octet code (you can use upper or "
12819 "lower case letters for the hexadecimal digits).  For example, a blank space "
12820 "must be escaped as \"%20\", a tab character as \"%09\", and the \"&\" as "
12821 "\"%26\".  Because the percent \"%\" character always has the reserved "
12822 "purpose of being the escape indicator, it must be escaped as \"%25\".  It is "
12823 "common practice to escape space characters as the plus symbol (+)  in query "
12824 "text; this practice isn't uniformly defined in the relevant RFCs (which "
12825 "recommend %20 instead) but any tool accepting URIs with query text should be "
12826 "prepared for them.  A URI is always shown in its \"escaped\" form."
12827 msgstr ""
12828
12829 #. type: Plain text
12830 #: build/C/man7/uri.7:528
12831 msgid ""
12832 "Unreserved characters can be escaped without changing the semantics of the "
12833 "URI, but this should not be done unless the URI is being used in a context "
12834 "that does not allow the unescaped character to appear.  For example, \"%7e\" "
12835 "is sometimes used instead of \"~\" in an HTTP URL path, but the two are "
12836 "equivalent for an HTTP URL."
12837 msgstr ""
12838
12839 #. type: Plain text
12840 #: build/C/man7/uri.7:532
12841 msgid ""
12842 "For URIs which must handle characters outside the US ASCII character set, "
12843 "the HTML 4.01 specification (section B.2) and IETF RFC\\ 2718 (section "
12844 "2.2.5) recommend the following approach:"
12845 msgstr ""
12846
12847 #. type: Plain text
12848 #: build/C/man7/uri.7:536
12849 msgid ""
12850 "translate the character sequences into UTF-8 (IETF RFC\\ 2279)\\(emsee "
12851 "B<utf-8>(7)\\(emand then"
12852 msgstr ""
12853
12854 #. type: Plain text
12855 #: build/C/man7/uri.7:539
12856 msgid ""
12857 "use the URI escaping mechanism, that is, use the %HH encoding for unsafe "
12858 "octets."
12859 msgstr ""
12860
12861 #. type: SS
12862 #: build/C/man7/uri.7:539
12863 #, no-wrap
12864 msgid "Writing a URI"
12865 msgstr ""
12866
12867 #. type: Plain text
12868 #: build/C/man7/uri.7:562
12869 msgid ""
12870 "When written, URIs should be placed inside double quotes (e.g., "
12871 "\"http://www.kernelnotes.org\"), enclosed in angle brackets (e.g., "
12872 "E<lt>http://lwn.netE<gt>), or placed on a line by themselves.  A warning for "
12873 "those who use double-quotes: B<never> move extraneous punctuation (such as "
12874 "the period ending a sentence or the comma in a list)  inside a URI, since "
12875 "this will change the value of the URI.  Instead, use angle brackets instead, "
12876 "or switch to a quoting system that never includes extraneous characters "
12877 "inside quotation marks.  This latter system, called the 'new' or 'logical' "
12878 "quoting system by \"Hart's Rules\" and the \"Oxford Dictionary for Writers "
12879 "and Editors\", is preferred practice in Great Britain and hackers worldwide "
12880 "(see the Jargon File's section on Hacker Writing Style, E<.UR "
12881 "http://www.fwi.uva.nl\\:/~mes\\:/jargon\\:/h\\:/HackerWritingStyle.html> "
12882 "E<.UE ,> for more information).  Older documents suggested inserting the "
12883 "prefix \"URL:\" just before the URI, but this form has never caught on."
12884 msgstr ""
12885
12886 #. type: Plain text
12887 #: build/C/man7/uri.7:584
12888 msgid ""
12889 "The URI syntax was designed to be unambiguous.  However, as URIs have become "
12890 "commonplace, traditional media (television, radio, newspapers, billboards, "
12891 "etc.) have increasingly used abbreviated URI references consisting of only "
12892 "the authority and path portions of the identified resource (e.g., "
12893 "E<lt>www.w3.org/AddressingE<gt>).  Such references are primarily intended "
12894 "for human interpretation rather than machine, with the assumption that "
12895 "context-based heuristics are sufficient to complete the URI (e.g., hostnames "
12896 "beginning with \"www\" are likely to have a URI prefix of \"http://\" and "
12897 "hostnames beginning with \"ftp\" likely to have a prefix of \"ftp://\").  "
12898 "Many client implementations heuristically resolve these references.  Such "
12899 "heuristics may change over time, particularly when new schemes are "
12900 "introduced.  Since an abbreviated URI has the same syntax as a relative URL "
12901 "path, abbreviated URI references cannot be used where relative URIs are "
12902 "permitted, and can be used only when there is no defined base (such as in "
12903 "dialog boxes).  Don't use abbreviated URIs as hypertext links inside a "
12904 "document; use the standard format as described here."
12905 msgstr ""
12906
12907 #. type: Plain text
12908 #: build/C/man7/uri.7:592
12909 msgid ""
12910 "E<.UR http://www.ietf.org\\:/rfc\\:/rfc2396.txt> (IETF RFC\\ 2396)  E<.UE ,> "
12911 "E<.UR http://www.w3.org\\:/TR\\:/REC-html40> (HTML 4.0)  E<.UE .>"
12912 msgstr ""
12913
12914 #. type: Plain text
12915 #: build/C/man7/uri.7:598
12916 msgid ""
12917 "Any tool accepting URIs (e.g., a web browser) on a Linux system should be "
12918 "able to handle (directly or indirectly) all of the schemes described here, "
12919 "including the man: and info: schemes.  Handling them by invoking some other "
12920 "program is fine and in fact encouraged."
12921 msgstr ""
12922
12923 #. type: Plain text
12924 #: build/C/man7/uri.7:600
12925 msgid "Technically the fragment isn't part of the URI."
12926 msgstr ""
12927
12928 #. type: Plain text
12929 #: build/C/man7/uri.7:609
12930 msgid ""
12931 "For information on how to embed URIs (including URLs) in a data format, see "
12932 "documentation on that format.  HTML uses the format E<lt>A "
12933 "HREF=\"I<uri>\"E<gt> I<text> E<lt>/AE<gt>.  Texinfo files use the format "
12934 "@uref{I<uri>}.  Man and mdoc have the recently added UR macro, or just "
12935 "include the URI in the text (viewers should be able to detect :// as part of "
12936 "a URI)."
12937 msgstr ""
12938
12939 #. type: Plain text
12940 #: build/C/man7/uri.7:630
12941 msgid ""
12942 "The GNOME and KDE desktop environments currently vary in the URIs they "
12943 "accept, in particular in their respective help browsers.  To list man pages, "
12944 "GNOME uses E<lt>toc:manE<gt> while KDE uses E<lt>man:(index)E<gt>, and to "
12945 "list info pages, GNOME uses E<lt>toc:infoE<gt> while KDE uses "
12946 "E<lt>info:(dir)E<gt> (the author of this man page prefers the KDE approach "
12947 "here, though a more regular format would be even better).  In general, KDE "
12948 "uses E<lt>file:/cgi-bin/E<gt> as a prefix to a set of generated files.  KDE "
12949 "prefers documentation in HTML, accessed via the "
12950 "E<lt>file:/cgi-bin/helpindexE<gt>.  GNOME prefers the ghelp scheme to store "
12951 "and find documentation.  Neither browser handles file: references to "
12952 "directories at the time of this writing, making it difficult to refer to an "
12953 "entire directory with a browsable URI.  As noted above, these environments "
12954 "differ in how they handle the info: scheme, probably the most important "
12955 "variation.  It is expected that GNOME and KDE will converge to common URI "
12956 "formats, and a future version of this man page will describe the converged "
12957 "result.  Efforts to aid this convergence are encouraged."
12958 msgstr ""
12959
12960 #. type: SS
12961 #: build/C/man7/uri.7:630
12962 #, no-wrap
12963 msgid "Security"
12964 msgstr ""
12965
12966 #. type: Plain text
12967 #: build/C/man7/uri.7:640
12968 msgid ""
12969 "A URI does not in itself pose a security threat.  There is no general "
12970 "guarantee that a URL, which at one time located a given resource, will "
12971 "continue to do so.  Nor is there any guarantee that a URL will not locate a "
12972 "different resource at some later point in time; such a guarantee can be "
12973 "obtained only from the person(s) controlling that namespace and the resource "
12974 "in question."
12975 msgstr ""
12976
12977 #. type: Plain text
12978 #: build/C/man7/uri.7:655
12979 msgid ""
12980 "It is sometimes possible to construct a URL such that an attempt to perform "
12981 "a seemingly harmless operation, such as the retrieval of an entity "
12982 "associated with the resource, will in fact cause a possibly damaging remote "
12983 "operation to occur.  The unsafe URL is typically constructed by specifying a "
12984 "port number other than that reserved for the network protocol in question.  "
12985 "The client unwittingly contacts a site that is in fact running a different "
12986 "protocol.  The content of the URL contains instructions that, when "
12987 "interpreted according to this other protocol, cause an unexpected "
12988 "operation.  An example has been the use of a gopher URL to cause an "
12989 "unintended or impersonating message to be sent via a SMTP server."
12990 msgstr ""
12991
12992 #. type: Plain text
12993 #: build/C/man7/uri.7:659
12994 msgid ""
12995 "Caution should be used when using any URL that specifies a port number other "
12996 "than the default for the protocol, especially when it is a number within the "
12997 "reserved space."
12998 msgstr ""
12999
13000 #. type: Plain text
13001 #: build/C/man7/uri.7:667
13002 msgid ""
13003 "Care should be taken when a URI contains escaped delimiters for a given "
13004 "protocol (for example, CR and LF characters for telnet protocols) that these "
13005 "are not unescaped before transmission.  This might violate the protocol, but "
13006 "avoids the potential for such characters to be used to simulate an extra "
13007 "operation or parameter in that protocol, which might lead to an unexpected "
13008 "and possibly harmful remote operation to be performed."
13009 msgstr ""
13010
13011 #. type: Plain text
13012 #: build/C/man7/uri.7:673
13013 msgid ""
13014 "It is clearly unwise to use a URI that contains a password which is intended "
13015 "to be secret.  In particular, the use of a password within the \"userinfo\" "
13016 "component of a URI is strongly recommended against except in those rare "
13017 "cases where the \"password\" parameter is intended to be public."
13018 msgstr ""
13019
13020 #. type: Plain text
13021 #: build/C/man7/uri.7:695
13022 msgid ""
13023 "Documentation may be placed in a variety of locations, so there currently "
13024 "isn't a good URI scheme for general online documentation in arbitrary "
13025 "formats.  References of the form E<lt>file:///usr/doc/ZZZE<gt> don't work "
13026 "because different distributions and local installation requirements may "
13027 "place the files in different directories (it may be in /usr/doc, or "
13028 "/usr/local/doc, or /usr/share, or somewhere else).  Also, the directory ZZZ "
13029 "usually changes when a version changes (though filename globbing could "
13030 "partially overcome this).  Finally, using the file: scheme doesn't easily "
13031 "support people who dynamically load documentation from the Internet (instead "
13032 "of loading the files onto a local file system).  A future URI scheme may be "
13033 "added (e.g., \"userdoc:\") to permit programs to include cross-references to "
13034 "more detailed documentation without having to know the exact location of "
13035 "that documentation.  Alternatively, a future version of the file-system "
13036 "specification may specify file locations sufficiently so that the file: "
13037 "scheme will be able to locate documentation."
13038 msgstr ""
13039
13040 #. type: Plain text
13041 #: build/C/man7/uri.7:698
13042 msgid ""
13043 "Many programs and file formats don't include a way to incorporate or "
13044 "implement links using URIs."
13045 msgstr ""
13046
13047 #.  .SH AUTHOR
13048 #.  David A. Wheeler (dwheeler@dwheeler.com) wrote this man page.
13049 #. type: Plain text
13050 #: build/C/man7/uri.7:706
13051 msgid ""
13052 "Many programs can't handle all of these different URI formats; there should "
13053 "be a standard mechanism to load an arbitrary URI that automatically detects "
13054 "the users' environment (e.g., text or graphics, desktop environment, local "
13055 "user preferences, and currently executing tools) and invokes the right tool "
13056 "for any URI."
13057 msgstr ""
13058
13059 #. type: Plain text
13060 #: build/C/man7/uri.7:711
13061 msgid "B<lynx>(1), B<man2html>(1), B<mailaddr>(7), B<utf-8>(7)"
13062 msgstr ""
13063
13064 #. type: Plain text
13065 #: build/C/man7/uri.7:715
13066 msgid "E<.UR http://www.ietf.org\\:/rfc\\:/rfc2255.txt> IETF RFC\\ 2255 E<.UE>"
13067 msgstr ""
13068
13069 #. type: TH
13070 #: build/C/man4/vcs.4:29
13071 #, no-wrap
13072 msgid "VCS"
13073 msgstr ""
13074
13075 #. type: TH
13076 #: build/C/man4/vcs.4:29
13077 #, no-wrap
13078 msgid "2007-12-17"
13079 msgstr ""
13080
13081 #. type: Plain text
13082 #: build/C/man4/vcs.4:32
13083 msgid "vcs, vcsa - virtual console memory"
13084 msgstr ""
13085
13086 #. type: Plain text
13087 #: build/C/man4/vcs.4:38
13088 msgid ""
13089 "I</dev/vcs0> is a character device with major number 7 and minor number 0, "
13090 "usually of mode 0644 and owner root.tty.  It refers to the memory of the "
13091 "currently displayed virtual console terminal."
13092 msgstr ""
13093
13094 #. type: Plain text
13095 #: build/C/man4/vcs.4:58
13096 msgid ""
13097 "I</dev/vcs[1-63]> are character devices for virtual console terminals, they "
13098 "have major number 7 and minor number 1 to 63, usually mode 0644 and owner "
13099 "root.tty.  I</dev/vcsa[0-63]> are the same, but using I<unsigned short>s (in "
13100 "host byte order) that include attributes, and prefixed with four bytes "
13101 "giving the screen dimensions and cursor position: I<lines>, I<columns>, "
13102 "I<x>, I<y>.  (I<x> = I<y> = 0 at the top left corner of the screen.)"
13103 msgstr ""
13104
13105 #. type: Plain text
13106 #: build/C/man4/vcs.4:72
13107 msgid ""
13108 "When a 512-character font is loaded, the 9th bit position can be fetched by "
13109 "applying the B<ioctl>(2)  B<VT_GETHIFONTMASK> operation (available in Linux "
13110 "kernels 2.6.18 and above)  on I</dev/tty[1-63]>; the value is returned in "
13111 "the I<unsigned short> pointed to by the third B<ioctl>(2)  argument."
13112 msgstr ""
13113
13114 #. type: Plain text
13115 #: build/C/man4/vcs.4:79
13116 msgid ""
13117 "These devices replace the screendump B<ioctl>(2)  operations of "
13118 "B<console>(4), so the system administrator can control access using file "
13119 "system permissions."
13120 msgstr ""
13121
13122 #. type: Plain text
13123 #: build/C/man4/vcs.4:81
13124 msgid "The devices for the first eight virtual consoles may be created by:"
13125 msgstr ""
13126
13127 #. type: Plain text
13128 #: build/C/man4/vcs.4:88
13129 #, no-wrap
13130 msgid ""
13131 "    for x in 0 1 2 3 4 5 6 7 8; do\n"
13132 "        mknod -m 644 /dev/vcs$x c 7 $x;\n"
13133 "        mknod -m 644 /dev/vcsa$x c 7 $[$x+128];\n"
13134 "    done\n"
13135 "    chown root:tty /dev/vcs*\n"
13136 msgstr ""
13137
13138 #. type: Plain text
13139 #: build/C/man4/vcs.4:93
13140 msgid "No B<ioctl>(2)  requests are supported."
13141 msgstr ""
13142
13143 #. type: Plain text
13144 #: build/C/man4/vcs.4:95
13145 msgid "/dev/vcs[0-63]"
13146 msgstr ""
13147
13148 #.  .SH AUTHOR
13149 #.  Andries Brouwer <aeb@cwi.nl>
13150 #. type: Plain text
13151 #: build/C/man4/vcs.4:99
13152 msgid "/dev/vcsa[0-63]"
13153 msgstr ""
13154
13155 #. type: Plain text
13156 #: build/C/man4/vcs.4:101
13157 msgid "Introduced with version 1.1.92 of the Linux kernel."
13158 msgstr ""
13159
13160 #. type: Plain text
13161 #: build/C/man4/vcs.4:103
13162 msgid "You may do a screendump on vt3 by switching to vt1 and typing"
13163 msgstr ""
13164
13165 #. type: Plain text
13166 #: build/C/man4/vcs.4:105
13167 #, no-wrap
13168 msgid "    cat /dev/vcs3 E<gt>foo\n"
13169 msgstr ""
13170
13171 #. type: Plain text
13172 #: build/C/man4/vcs.4:109
13173 msgid ""
13174 "Note that the output does not contain newline characters, so some processing "
13175 "may be required, like in"
13176 msgstr ""
13177
13178 #. type: Plain text
13179 #: build/C/man4/vcs.4:111
13180 #, no-wrap
13181 msgid "    old -w 81 /dev/vcs3 | lpr\n"
13182 msgstr ""
13183
13184 #. type: Plain text
13185 #: build/C/man4/vcs.4:113
13186 msgid "or (horrors)"
13187 msgstr ""
13188
13189 #. type: Plain text
13190 #: build/C/man4/vcs.4:115
13191 #, no-wrap
13192 msgid "    xetterm -dump 3 -file /proc/self/fd/1\n"
13193 msgstr ""
13194
13195 #. type: Plain text
13196 #: build/C/man4/vcs.4:120
13197 msgid "The I</dev/vcsa0> device is used for Braille support."
13198 msgstr ""
13199
13200 #. type: Plain text
13201 #: build/C/man4/vcs.4:124
13202 msgid ""
13203 "This program displays the character and screen attributes under the cursor "
13204 "of the second virtual console, then changes the background color there:"
13205 msgstr ""
13206
13207 #. type: Plain text
13208 #: build/C/man4/vcs.4:132
13209 #, no-wrap
13210 msgid ""
13211 "#include E<lt>unistd.hE<gt>\n"
13212 "#include E<lt>stdlib.hE<gt>\n"
13213 "#include E<lt>stdio.hE<gt>\n"
13214 "#include E<lt>fcntl.hE<gt>\n"
13215 "#include E<lt>sys/ioctl.hE<gt>\n"
13216 "#include E<lt>linux/vt.hE<gt>\n"
13217 msgstr ""
13218
13219 #. type: Plain text
13220 #: build/C/man4/vcs.4:143
13221 #, no-wrap
13222 msgid ""
13223 "int\n"
13224 "main(void)\n"
13225 "{\n"
13226 "    int fd;\n"
13227 "    char *device = \"/dev/vcsa2\";\n"
13228 "    char *console = \"/dev/tty2\";\n"
13229 "    struct {unsigned char lines, cols, x, y;} scrn;\n"
13230 "    unsigned short s;\n"
13231 "    unsigned short mask;\n"
13232 "    unsigned char ch, attrib;\n"
13233 msgstr ""
13234
13235 #. type: Plain text
13236 #: build/C/man4/vcs.4:172
13237 #, no-wrap
13238 msgid ""
13239 "    fd = open(console, O_RDWR);\n"
13240 "    if (fd E<lt> 0) {\n"
13241 "        perror(console);\n"
13242 "        exit(EXIT_FAILURE);\n"
13243 "    }\n"
13244 "    if (ioctl(fd, VT_GETHIFONTMASK, &mask) E<lt> 0) {\n"
13245 "        perror(\"VT_GETHIFONTMASK\");\n"
13246 "        exit(EXIT_FAILURE);\n"
13247 "    }\n"
13248 "    (void) close(fd);\n"
13249 "    fd = open(device, O_RDWR);\n"
13250 "    if (fd E<lt> 0) {\n"
13251 "        perror(device);\n"
13252 "        exit(EXIT_FAILURE);\n"
13253 "    }\n"
13254 "    (void) read(fd, &scrn, 4);\n"
13255 "    (void) lseek(fd, 4 + 2*(scrn.y*scrn.cols + scrn.x), 0);\n"
13256 "    (void) read(fd, &s, 2);\n"
13257 "    ch = s & 0xff;\n"
13258 "    if (attrib & mask)\n"
13259 "        ch |= 0x100;\n"
13260 "    attrib = ((s & ~mask) E<gt>E<gt> 8);\n"
13261 "    printf(\"ch=\\(aq%c\\(aq attrib=0x%02x\\en\", ch, attrib);\n"
13262 "    attrib ^= 0x10;\n"
13263 "    (void) lseek(fd, -1, 1);\n"
13264 "    (void) write(fd, &attrib, 1);\n"
13265 "    exit(EXIT_SUCCESS);\n"
13266 "}\n"
13267 msgstr ""
13268
13269 #. type: Plain text
13270 #: build/C/man4/vcs.4:178
13271 msgid "B<console>(4), B<tty>(4), B<ttyS>(4), B<gpm>(8)"
13272 msgstr ""
13273
13274 #. type: TH
13275 #: build/C/man4/wavelan.4:15
13276 #, no-wrap
13277 msgid "WAVELAN"
13278 msgstr ""
13279
13280 #. type: TH
13281 #: build/C/man4/wavelan.4:15
13282 #, no-wrap
13283 msgid "1996-10-22"
13284 msgstr ""
13285
13286 #. type: Plain text
13287 #: build/C/man4/wavelan.4:18
13288 msgid "wavelan - AT&T GIS WaveLAN ISA device driver"
13289 msgstr ""
13290
13291 #. type: Plain text
13292 #: build/C/man4/wavelan.4:20
13293 msgid ""
13294 "B<insmod wavelan_cs.o [io=>I<B,B..>B<] [ irq=>I<I,I..>B<] "
13295 "[name=>I<N,N..>B<]>"
13296 msgstr ""
13297
13298 #. type: Plain text
13299 #: build/C/man4/wavelan.4:36
13300 msgid ""
13301 "I<wavelan> is the low-level device driver for the NCR / AT&T / Lucent "
13302 "B<WaveLAN ISA> and Digital (DEC)  B<RoamAbout DS> wireless ethernet "
13303 "adapter.  This driver is available as a module or might be compiled in the "
13304 "kernel.  This driver supports multiple cards in both forms (up to 4) and "
13305 "allocates the next available ethernet device (eth0..eth#) for each card "
13306 "found, unless a device name is explicitly specified (see below).  This "
13307 "device name will be reported in the kernel log file with the MAC address, "
13308 "NWID and frequency used by the card."
13309 msgstr ""
13310
13311 #. type: Plain text
13312 #: build/C/man4/wavelan.4:43
13313 msgid ""
13314 "This section apply to the module form (parameters passed on the B<insmod>(8)  "
13315 "command line).  If the driver is included in the kernel, use the "
13316 "I<ether=IRQ,IO,NAME> syntax on the kernel command line."
13317 msgstr ""
13318
13319 #. type: TP
13320 #: build/C/man4/wavelan.4:43
13321 #, no-wrap
13322 msgid "B<io>"
13323 msgstr ""
13324
13325 #. type: Plain text
13326 #: build/C/man4/wavelan.4:50
13327 msgid ""
13328 "Specify the list of base address where to search for wavelan cards (setting "
13329 "by dip switch on the card).  If you don't specify any io address, the driver "
13330 "will scan 0x390 and 0x3E0 addresses, which might conflict with other "
13331 "hardware..."
13332 msgstr ""
13333
13334 #. type: TP
13335 #: build/C/man4/wavelan.4:50
13336 #, no-wrap
13337 msgid "B<irq>"
13338 msgstr ""
13339
13340 #. type: Plain text
13341 #: build/C/man4/wavelan.4:54
13342 msgid ""
13343 "Set the list of irq that each wavelan card should use (the value is saved in "
13344 "permanent storage for future use)."
13345 msgstr ""
13346
13347 #. type: TP
13348 #: build/C/man4/wavelan.4:54
13349 #, no-wrap
13350 msgid "B<name>"
13351 msgstr ""
13352
13353 #. type: Plain text
13354 #: build/C/man4/wavelan.4:59
13355 msgid ""
13356 "Set the list of name to be used for each wavelan cards device (name used by "
13357 "B<ifconfig>(8))."
13358 msgstr ""
13359
13360 #. type: SS
13361 #: build/C/man4/wavelan.4:59
13362 #, no-wrap
13363 msgid "Wireless extensions"
13364 msgstr ""
13365
13366 #. type: Plain text
13367 #: build/C/man4/wavelan.4:63
13368 msgid "Use B<iwconfig>(8)  to manipulate wireless extensions."
13369 msgstr ""
13370
13371 #. type: SS
13372 #: build/C/man4/wavelan.4:63
13373 #, no-wrap
13374 msgid "NWID (or domain)"
13375 msgstr ""
13376
13377 #. type: Plain text
13378 #: build/C/man4/wavelan.4:72
13379 msgid ""
13380 "Set the network ID [I<0> to I<FFFF>] or disable it [I<off>].  As the NWID is "
13381 "stored in the card Permanent Storage Area, it will be reuse at any further "
13382 "invocation of the driver."
13383 msgstr ""
13384
13385 #. type: SS
13386 #: build/C/man4/wavelan.4:72
13387 #, no-wrap
13388 msgid "Frequency & channels"
13389 msgstr ""
13390
13391 #. type: Plain text
13392 #: build/C/man4/wavelan.4:83
13393 msgid ""
13394 "For the 2.4GHz 2.00 Hardware, you are able to set the frequency by "
13395 "specifying one of the 10 defined channels (I<2.412,> I<2.422, 2.425, 2.4305, "
13396 "2.432, 2.442, 2.452, 2.460, 2.462> or I<2.484>)  or directly by its value.  "
13397 "The frequency is changed immediately and permanently.  Frequency "
13398 "availability depends on the regulations..."
13399 msgstr ""
13400
13401 #. type: SS
13402 #: build/C/man4/wavelan.4:83
13403 #, no-wrap
13404 msgid "Statistics spy"
13405 msgstr ""
13406
13407 #. type: Plain text
13408 #: build/C/man4/wavelan.4:87
13409 msgid ""
13410 "Set a list of MAC addresses in the driver (up to 8) and get the last quality "
13411 "of link for each of those (see B<iwspy>(8))."
13412 msgstr ""
13413
13414 #. type: SS
13415 #: build/C/man4/wavelan.4:87
13416 #, no-wrap
13417 msgid "/proc/net/wireless"
13418 msgstr ""
13419
13420 #. type: Plain text
13421 #: build/C/man4/wavelan.4:102
13422 msgid ""
13423 "I<status> is the status reported by the modem.  I<Link quality> reports the "
13424 "quality of the modulation on the air (direct sequence spread spectrum) [max "
13425 "= 16].  I<Level> and I<Noise> refer to the signal level and noise level [max "
13426 "= 64].  The I<crypt discarded packet> and I<misc discarded packet> counters "
13427 "are not implemented."
13428 msgstr ""
13429
13430 #. type: SS
13431 #: build/C/man4/wavelan.4:102
13432 #, no-wrap
13433 msgid "Private ioctl"
13434 msgstr ""
13435
13436 #. type: Plain text
13437 #: build/C/man4/wavelan.4:106
13438 msgid "You may use B<iwpriv>(8)  to manipulate private ioctls."
13439 msgstr ""
13440
13441 #. type: SS
13442 #: build/C/man4/wavelan.4:106
13443 #, no-wrap
13444 msgid "Quality and level threshold"
13445 msgstr ""
13446
13447 #. type: Plain text
13448 #: build/C/man4/wavelan.4:109
13449 msgid ""
13450 "Enable you the define the quality and level threshold used by the modem "
13451 "(packet below that level are discarded)."
13452 msgstr ""
13453
13454 #. type: SS
13455 #: build/C/man4/wavelan.4:109
13456 #, no-wrap
13457 msgid "Histogram"
13458 msgstr ""
13459
13460 #. type: Plain text
13461 #: build/C/man4/wavelan.4:116
13462 msgid ""
13463 "This functionality makes it possible to set a number of signal level "
13464 "intervals and to count the number of packets received in each of those "
13465 "defined intervals.  This distribution might be used to calculate the mean "
13466 "value and standard deviation of the signal level."
13467 msgstr ""
13468
13469 #. type: SS
13470 #: build/C/man4/wavelan.4:116
13471 #, no-wrap
13472 msgid "Specific notes"
13473 msgstr ""
13474
13475 #. type: Plain text
13476 #: build/C/man4/wavelan.4:122
13477 msgid ""
13478 "This driver will fail to detect some B<non-NCR/ATT&T/Lucent> Wavelan cards.  "
13479 "If this happens for you, you must look in the source code on how to add your "
13480 "card to the detection routine."
13481 msgstr ""
13482
13483 #.  .SH AUTHOR
13484 #.  Bruce Janson \(em bruce@cs.usyd.edu.au
13485 #.  .br
13486 #.  Jean Tourrilhes \(em jt@hplb.hpl.hp.com
13487 #.  .br
13488 #.  (and others; see source code for details)
13489 #
13490 #.  SEE ALSO part
13491 #. type: Plain text
13492 #: build/C/man4/wavelan.4:135
13493 msgid ""
13494 "Some of the mentioned features are optional.  You may enable to disable them "
13495 "by changing flags in the driver header and recompile."
13496 msgstr ""
13497
13498 #. type: Plain text
13499 #: build/C/man4/wavelan.4:142
13500 msgid ""
13501 "B<wavelan_cs>(4), B<ifconfig>(8), B<insmod>(8), B<iwconfig>(8), "
13502 "B<iwpriv>(8), B<iwspy>(8)"
13503 msgstr ""