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: 2012-05-01 04:39+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 #.  Licensed under GNU General Public License version 2 (GPLv2)
  22 #
  23 #.  shorthand for double quote that works everywhere.
  24 #. type: ds q
  25 #: build/C/man4/cciss.4:6 build/C/man4/hpsa.4:6
  26 #, no-wrap
  27 msgid "\\N'34'"
  28 msgstr ""
  29
  30 #. type: TH
  31 #: build/C/man4/cciss.4:7
  32 #, no-wrap
  33 msgid "CCISS"
  34 msgstr ""
  35
  36 #. type: TH
  37 #: build/C/man4/cciss.4:7 build/C/man4/hpsa.4:7
  38 #, no-wrap
  39 msgid "2011-09-21"
  40 msgstr ""
  41
  42 #. type: TH
  43 #: build/C/man4/cciss.4:7 build/C/man4/console.4:10 build/C/man4/console_codes.4:21 build/C/man4/console_ioctl.4:39 build/C/man5/core.5:23 build/C/man4/cpuid.4:24 build/C/man4/dsp56k.4:26 build/C/man4/fd.4:27 build/C/man7/fifo.7:10 build/C/man4/full.4:26 build/C/man3/gnu_get_libc_version.3:24 build/C/man4/hd.4:28 build/C/man4/hpsa.4:7 build/C/man4/initrd.4:34 build/C/man4/lp.4:26 build/C/man3/makedev.3:24 build/C/man4/mem.4:25 build/C/man2/mknod.2:13 build/C/man4/mouse.4:25 build/C/man4/msr.4:24 build/C/man4/null.4:25 build/C/man7/pipe.7:25 build/C/man4/ram.4:25 build/C/man4/random.4:17 build/C/man4/sd.4:24 build/C/man4/sk98lin.4:25 build/C/man4/st.4:23 build/C/man2/syslog.2:29 build/C/man3/syslog.3:34 build/C/man4/ttyS.4:25 build/C/man7/uri.7:47 build/C/man4/vcs.4:28 build/C/man4/wavelan.4:11
  44 #, no-wrap
  45 msgid "Linux"
  46 msgstr ""
  47
  48 #. type: TH
  49 #: build/C/man4/cciss.4:7 build/C/man4/console.4:10 build/C/man4/console_codes.4:21 build/C/man4/console_ioctl.4:39 build/C/man5/core.5:23 build/C/man4/cpuid.4:24 build/C/man4/dsp56k.4:26 build/C/man4/fd.4:27 build/C/man7/fifo.7:10 build/C/man4/full.4:26 build/C/man3/gnu_get_libc_version.3:24 build/C/man4/hd.4:28 build/C/man4/hpsa.4:7 build/C/man4/initrd.4:34 build/C/man4/lp.4:26 build/C/man3/makedev.3:24 build/C/man4/mem.4:25 build/C/man3/mkfifo.3:27 build/C/man2/mknod.2:13 build/C/man4/mouse.4:25 build/C/man4/msr.4:24 build/C/man4/null.4:25 build/C/man7/pipe.7:25 build/C/man4/ram.4:25 build/C/man4/random.4:17 build/C/man4/sd.4:24 build/C/man3/setlogmask.3:23 build/C/man4/sk98lin.4:25 build/C/man4/st.4:23 build/C/man3/stdarg.3:41 build/C/man2/syslog.2:29 build/C/man3/syslog.3:34 build/C/man4/ttyS.4:25 build/C/man7/uri.7:47 build/C/man4/vcs.4:28 build/C/man4/wavelan.4:11
  50 #, no-wrap
  51 msgid "Linux Programmer's Manual"
  52 msgstr ""
  53
  54 #. type: SH
  55 #: build/C/man4/cciss.4:8 build/C/man4/console.4:11 build/C/man4/console_codes.4:22 build/C/man4/console_ioctl.4:40 build/C/man5/core.5:24 build/C/man4/cpuid.4:25 build/C/man4/dsp56k.4:27 build/C/man4/fd.4:28 build/C/man7/fifo.7:11 build/C/man4/full.4:27 build/C/man3/gnu_get_libc_version.3:25 build/C/man4/hd.4:29 build/C/man4/hpsa.4:8 build/C/man4/initrd.4:35 build/C/man4/lp.4:27 build/C/man3/makedev.3:25 build/C/man4/mem.4:26 build/C/man3/mkfifo.3:28 build/C/man2/mknod.2:14 build/C/man4/mouse.4:26 build/C/man4/msr.4:25 build/C/man4/null.4:26 build/C/man7/pipe.7:26 build/C/man4/ram.4:26 build/C/man4/random.4:18 build/C/man4/sd.4:25 build/C/man3/setlogmask.3:24 build/C/man4/sk98lin.4:26 build/C/man4/st.4:24 build/C/man3/stdarg.3:42 build/C/man2/syslog.2:30 build/C/man3/syslog.3:35 build/C/man4/ttyS.4:26 build/C/man7/uri.7:48 build/C/man4/vcs.4:29 build/C/man4/wavelan.4:12
  56 #, no-wrap
  57 msgid "NAME"
  58 msgstr ""
  59
  60 #. type: Plain text
  61 #: build/C/man4/cciss.4:10
  62 msgid "cciss - HP Smart Array block driver"
  63 msgstr ""
  64
  65 #. type: SH
  66 #: build/C/man4/cciss.4:10 build/C/man4/dsp56k.4:29 build/C/man3/gnu_get_libc_version.3:27 build/C/man4/hpsa.4:10 build/C/man4/lp.4:29 build/C/man3/makedev.3:27 build/C/man3/mkfifo.3:30 build/C/man2/mknod.2:16 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:33 build/C/man3/syslog.3:37 build/C/man7/uri.7:50 build/C/man4/wavelan.4:14
  67 #, no-wrap
  68 msgid "SYNOPSIS"
  69 msgstr ""
  70
  71 #. type: Plain text
  72 #: build/C/man4/cciss.4:13
  73 #, no-wrap
  74 msgid "modprobe cciss [ cciss_allow_hpsa=1 ]\n"
  75 msgstr ""
  76
  77 #. type: SH
  78 #: build/C/man4/cciss.4:14 build/C/man4/console.4:13 build/C/man4/console_codes.4:24 build/C/man4/console_ioctl.4:42 build/C/man5/core.5:26 build/C/man4/cpuid.4:27 build/C/man4/dsp56k.4:45 build/C/man4/fd.4:131 build/C/man7/fifo.7:13 build/C/man4/full.4:37 build/C/man3/gnu_get_libc_version.3:35 build/C/man4/hd.4:31 build/C/man4/hpsa.4:14 build/C/man4/initrd.4:70 build/C/man4/lp.4:42 build/C/man3/makedev.3:38 build/C/man4/mem.4:28 build/C/man3/mkfifo.3:37 build/C/man2/mknod.2:38 build/C/man4/mouse.4:32 build/C/man4/msr.4:27 build/C/man4/null.4:28 build/C/man7/pipe.7:28 build/C/man4/ram.4:28 build/C/man4/random.4:20 build/C/man4/sd.4:69 build/C/man3/setlogmask.3:32 build/C/man4/sk98lin.4:60 build/C/man4/st.4:35 build/C/man3/stdarg.3:54 build/C/man2/syslog.2:44 build/C/man3/syslog.3:57 build/C/man4/ttyS.4:28 build/C/man7/uri.7:70 build/C/man4/vcs.4:31 build/C/man4/wavelan.4:16
  79 #, no-wrap
  80 msgid "DESCRIPTION"
  81 msgstr ""
  82
  83 #. type: Plain text
  84 #: build/C/man4/cciss.4:17
  85 msgid "B<cciss> is a block driver for older HP Smart Array RAID controllers."
  86 msgstr ""
  87
  88 #. type: SS
  89 #: build/C/man4/cciss.4:17 build/C/man4/hpsa.4:17 build/C/man4/initrd.4:179
  90 #, no-wrap
  91 msgid "Options"
  92 msgstr ""
  93
  94 #. type: Plain text
  95 #: build/C/man4/cciss.4:26
  96 msgid ""
  97 "I<cciss_allow_hpsa=1>: This option prevents the B<cciss> driver from "
  98 "attempting to drive any controllers that the B<hpsa>(4)  driver is capable "
  99 "of controlling, which is to say, the B<cciss> driver is restricted by this "
 100 "option to the following controllers:"
 101 msgstr ""
 102
 103 #. type: Plain text
 104 #: build/C/man4/cciss.4:45
 105 #, no-wrap
 106 msgid ""
 107 "    Smart Array 5300\n"
 108 "    Smart Array 5i\n"
 109 "    Smart Array 532\n"
 110 "    Smart Array 5312\n"
 111 "    Smart Array 641\n"
 112 "    Smart Array 642\n"
 113 "    Smart Array 6400\n"
 114 "    Smart Array 6400 EM\n"
 115 "    Smart Array 6i\n"
 116 "    Smart Array P600\n"
 117 "    Smart Array P400i\n"
 118 "    Smart Array E200i\n"
 119 "    Smart Array E200\n"
 120 "    Smart Array E200i\n"
 121 "    Smart Array E200i\n"
 122 "    Smart Array E200i\n"
 123 "    Smart Array E500\n"
 124 msgstr ""
 125
 126 #. type: SS
 127 #: build/C/man4/cciss.4:46 build/C/man4/hpsa.4:36
 128 #, no-wrap
 129 msgid "Supported Hardware"
 130 msgstr ""
 131
 132 #. type: Plain text
 133 #: build/C/man4/cciss.4:50
 134 msgid "The B<cciss> driver supports the following Smart Array boards:"
 135 msgstr ""
 136
 137 #. type: Plain text
 138 #: build/C/man4/cciss.4:76
 139 #, no-wrap
 140 msgid ""
 141 "    Smart Array 5300\n"
 142 "    Smart Array 5i\n"
 143 "    Smart Array 532\n"
 144 "    Smart Array 5312\n"
 145 "    Smart Array 641\n"
 146 "    Smart Array 642\n"
 147 "    Smart Array 6400\n"
 148 "    Smart Array 6400 U320 Expansion Module\n"
 149 "    Smart Array 6i\n"
 150 "    Smart Array P600\n"
 151 "    Smart Array P800\n"
 152 "    Smart Array E400\n"
 153 "    Smart Array P400i\n"
 154 "    Smart Array E200\n"
 155 "    Smart Array E200i\n"
 156 "    Smart Array E500\n"
 157 "    Smart Array P700m\n"
 158 "    Smart Array P212\n"
 159 "    Smart Array P410\n"
 160 "    Smart Array P410i\n"
 161 "    Smart Array P411\n"
 162 "    Smart Array P812\n"
 163 "    Smart Array P712m\n"
 164 "    Smart Array P711m\n"
 165 msgstr ""
 166
 167 #. type: SS
 168 #: build/C/man4/cciss.4:77 build/C/man4/hpsa.4:53
 169 #, no-wrap
 170 msgid "Configuration Details"
 171 msgstr ""
 172
 173 #. type: Plain text
 174 #: build/C/man4/cciss.4:86 build/C/man4/hpsa.4:61
 175 msgid ""
 176 "To configure HP Smart Array controllers, use the HP Array Configuration "
 177 "Utility (either B<hpacuxe>(8)  or B<hpacucli>(8))  or the Offline ROM-based "
 178 "Configuration Utility (ORCA)  run from the Smart Array's option ROM at boot "
 179 "time."
 180 msgstr ""
 181
 182 #. type: SH
 183 #: build/C/man4/cciss.4:86 build/C/man4/console.4:73 build/C/man4/dsp56k.4:109 build/C/man4/fd.4:194 build/C/man4/full.4:49 build/C/man4/hd.4:94 build/C/man4/hpsa.4:61 build/C/man4/initrd.4:417 build/C/man4/lp.4:113 build/C/man4/mem.4:75 build/C/man4/mouse.4:148 build/C/man4/null.4:45 build/C/man4/ram.4:38 build/C/man4/random.4:209 build/C/man4/sd.4:130 build/C/man4/sk98lin.4:578 build/C/man4/st.4:878 build/C/man4/ttyS.4:44 build/C/man4/vcs.4:80
 184 #, no-wrap
 185 msgid "FILES"
 186 msgstr ""
 187
 188 #. type: SS
 189 #: build/C/man4/cciss.4:87 build/C/man4/hpsa.4:62
 190 #, no-wrap
 191 msgid "Device Nodes"
 192 msgstr ""
 193
 194 #. type: Plain text
 195 #: build/C/man4/cciss.4:89
 196 msgid "The device naming scheme is as follows:"
 197 msgstr ""
 198
 199 #. type: Plain text
 200 #: build/C/man4/cciss.4:92
 201 #, no-wrap
 202 msgid "Major numbers:\n"
 203 msgstr ""
 204
 205 #. type: Plain text
 206 #: build/C/man4/cciss.4:101
 207 #, no-wrap
 208 msgid ""
 209 "    104     cciss0\n"
 210 "    105     cciss1\n"
 211 "    106     cciss2\n"
 212 "    105     cciss3\n"
 213 "    108     cciss4\n"
 214 "    109     cciss5\n"
 215 "    110     cciss6\n"
 216 "    111     cciss7\n"
 217 msgstr ""
 218
 219 #. type: Plain text
 220 #: build/C/man4/cciss.4:103
 221 #, no-wrap
 222 msgid "Minor numbers:\n"
 223 msgstr ""
 224
 225 #. type: Plain text
 226 #: build/C/man4/cciss.4:110
 227 #, no-wrap
 228 msgid ""
 229 "    b7 b6 b5 b4 b3 b2 b1 b0\n"
 230 "    |----+----| |----+----|\n"
 231 "         |           |\n"
 232 "         |           +-------- Partition ID (0=wholedev, 1-15 partition)\n"
 233 "         |\n"
 234 "         +-------------------- Logical Volume number\n"
 235 msgstr ""
 236
 237 #. type: Plain text
 238 #: build/C/man4/cciss.4:112
 239 #, no-wrap
 240 msgid "The device naming scheme is:\n"
 241 msgstr ""
 242
 243 #. type: Plain text
 244 #: build/C/man4/cciss.4:117
 245 #, no-wrap
 246 msgid ""
 247 "    /dev/cciss/c0d0         Controller 0, disk 0, whole device\n"
 248 "    /dev/cciss/c0d0p1       Controller 0, disk 0, partition 1\n"
 249 "    /dev/cciss/c0d0p2       Controller 0, disk 0, partition 2\n"
 250 "    /dev/cciss/c0d0p3       Controller 0, disk 0, partition 3\n"
 251 msgstr ""
 252
 253 #. type: Plain text
 254 #: build/C/man4/cciss.4:122
 255 #, no-wrap
 256 msgid ""
 257 "    /dev/cciss/c1d1         Controller 1, disk 1, whole device\n"
 258 "    /dev/cciss/c1d1p1       Controller 1, disk 1, partition 1\n"
 259 "    /dev/cciss/c1d1p2       Controller 1, disk 1, partition 2\n"
 260 "    /dev/cciss/c1d1p3       Controller 1, disk 1, partition 3\n"
 261 msgstr ""
 262
 263 #. type: SS
 264 #: build/C/man4/cciss.4:124
 265 #, no-wrap
 266 msgid "Files in /proc"
 267 msgstr ""
 268
 269 #. type: Plain text
 270 #: build/C/man4/cciss.4:130
 271 msgid ""
 272 "The files I</proc/driver/cciss/cciss[0-9]+> contain information about the "
 273 "configuration of each controller.  For example:"
 274 msgstr ""
 275
 276 #. type: Plain text
 277 #: build/C/man4/cciss.4:150
 278 #, no-wrap
 279 msgid ""
 280 "    $ B<cd /proc/driver/cciss>\n"
 281 "    $ B<ls -l>\n"
 282 "    total 0\n"
 283 "    -rw-r--r-- 1 root root 0 2010-09-10 10:38 cciss0\n"
 284 "    -rw-r--r-- 1 root root 0 2010-09-10 10:38 cciss1\n"
 285 "    -rw-r--r-- 1 root root 0 2010-09-10 10:38 cciss2\n"
 286 "    $ B<cat cciss2>\n"
 287 "    cciss2: HP Smart Array P800 Controller\n"
 288 "    Board ID: 0x3223103c\n"
 289 "    Firmware Version: 7.14\n"
 290 "    IRQ: 16\n"
 291 "    Logical drives: 1\n"
 292 "    Current Q depth: 0\n"
 293 "    Current # commands on controller: 0\n"
 294 "    Max Q depth since init: 1\n"
 295 "    Max # commands on controller since init: 2\n"
 296 "    Max SG entries since init: 32\n"
 297 "    Sequential access devices: 0\n"
 298 msgstr ""
 299
 300 #. type: Plain text
 301 #: build/C/man4/cciss.4:152
 302 #, no-wrap
 303 msgid "    cciss/c2d0:   36.38GB       RAID 0\n"
 304 msgstr ""
 305
 306 #. type: SS
 307 #: build/C/man4/cciss.4:154
 308 #, no-wrap
 309 msgid "Files in /sys"
 310 msgstr ""
 311
 312 #. type: TP
 313 #: build/C/man4/cciss.4:155
 314 #, no-wrap
 315 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/model>"
 316 msgstr ""
 317
 318 #. type: Plain text
 319 #: build/C/man4/cciss.4:161
 320 msgid ""
 321 "Displays the SCSI INQUIRY page 0 model for logical drive I<Y> of controller "
 322 "I<X>."
 323 msgstr ""
 324
 325 #. type: TP
 326 #: build/C/man4/cciss.4:161
 327 #, no-wrap
 328 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/rev>"
 329 msgstr ""
 330
 331 #. type: Plain text
 332 #: build/C/man4/cciss.4:167
 333 msgid ""
 334 "Displays the SCSI INQUIRY page 0 revision for logical drive I<Y> of "
 335 "controller I<X>."
 336 msgstr ""
 337
 338 #. type: TP
 339 #: build/C/man4/cciss.4:167
 340 #, no-wrap
 341 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/unique_id>"
 342 msgstr ""
 343
 344 #. type: Plain text
 345 #: build/C/man4/cciss.4:173
 346 msgid ""
 347 "Displays the SCSI INQUIRY page 83 serial number for logical drive I<Y> of "
 348 "controller I<X>."
 349 msgstr ""
 350
 351 #. type: TP
 352 #: build/C/man4/cciss.4:173
 353 #, no-wrap
 354 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/vendor>"
 355 msgstr ""
 356
 357 #. type: Plain text
 358 #: build/C/man4/cciss.4:179
 359 msgid ""
 360 "Displays the SCSI INQUIRY page 0 vendor for logical drive I<Y> of controller "
 361 "I<X>."
 362 msgstr ""
 363
 364 #. type: TP
 365 #: build/C/man4/cciss.4:179
 366 #, no-wrap
 367 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/block:cciss!cXdY>"
 368 msgstr ""
 369
 370 #. type: Plain text
 371 #: build/C/man4/cciss.4:183
 372 msgid "A symbolic link to I</sys/block/cciss!cXdY>."
 373 msgstr ""
 374
 375 #. type: TP
 376 #: build/C/man4/cciss.4:183
 377 #, no-wrap
 378 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/rescan>"
 379 msgstr ""
 380
 381 #. type: Plain text
 382 #: build/C/man4/cciss.4:187
 383 msgid ""
 384 "When this file is written to, the driver rescans the controller to discover "
 385 "any new, removed, or modified logical drives."
 386 msgstr ""
 387
 388 #. type: TP
 389 #: build/C/man4/cciss.4:187
 390 #, no-wrap
 391 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/resettable>"
 392 msgstr ""
 393
 394 #. type: Plain text
 395 #: build/C/man4/cciss.4:196
 396 msgid ""
 397 "A value of 1 displayed in this file indicates that the \"reset_devices=1\" "
 398 "kernel parameter (used by B<kdump>)  is honored by this controller.  A value "
 399 "of 0 indicates that the \"reset_devices=1\" kernel parameter will not be "
 400 "honored.  Some models of Smart Array are not able to honor this parameter."
 401 msgstr ""
 402
 403 #. type: TP
 404 #: build/C/man4/cciss.4:196
 405 #, no-wrap
 406 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/lunid>"
 407 msgstr ""
 408
 409 #. type: Plain text
 410 #: build/C/man4/cciss.4:202
 411 msgid ""
 412 "Displays the 8-byte LUN ID used to address logical drive I<Y> of controller "
 413 "I<X>."
 414 msgstr ""
 415
 416 #. type: TP
 417 #: build/C/man4/cciss.4:202
 418 #, no-wrap
 419 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/raid_level>"
 420 msgstr ""
 421
 422 #. type: Plain text
 423 #: build/C/man4/cciss.4:208
 424 msgid "Displays the RAID level of logical drive I<Y> of controller I<X>."
 425 msgstr ""
 426
 427 #. type: TP
 428 #: build/C/man4/cciss.4:208
 429 #, no-wrap
 430 msgid "I</sys/bus/pci/devices/E<lt>devE<gt>/ccissX/cXdY/usage_count>"
 431 msgstr ""
 432
 433 #. type: Plain text
 434 #: build/C/man4/cciss.4:214
 435 msgid ""
 436 "Displays the usage count (number of opens) of logical drive I<Y> of "
 437 "controller I<X>."
 438 msgstr ""
 439
 440 #. type: SS
 441 #: build/C/man4/cciss.4:214
 442 #, no-wrap
 443 msgid "SCSI tape drive and medium changer support"
 444 msgstr ""
 445
 446 #. type: Plain text
 447 #: build/C/man4/cciss.4:225
 448 msgid ""
 449 "SCSI sequential access devices and medium changer devices are supported and "
 450 "appropriate device nodes are automatically created (e.g., I</dev/st0>, "
 451 "I</dev/st1>, etc.; see B<st>(4)  for more details.)  You must enable \"SCSI "
 452 "tape drive support for Smart Array 5xxx\" and \"SCSI support\" in your "
 453 "kernel configuration to be able to use SCSI tape drives with your Smart "
 454 "Array 5xxx controller."
 455 msgstr ""
 456
 457 #. type: Plain text
 458 #: build/C/man4/cciss.4:242
 459 msgid ""
 460 "Additionally, note that the driver will not engage the SCSI core at init "
 461 "time.  The driver must be directed to dynamically engage the SCSI core via "
 462 "the /proc file-system entry, which the \"block\" side of the driver creates "
 463 "as I</proc/driver/cciss/cciss*> at runtime.  This is because at driver init "
 464 "time, the SCSI core may not yet be initialized (because the driver is a "
 465 "block driver) and attempting to register it with the SCSI core in such a "
 466 "case would cause a hang.  This is best done via an initialization script "
 467 "(typically in I</etc/init.d>, but could vary depending on distribution).  "
 468 "For example:"
 469 msgstr ""
 470
 471 #. type: Plain text
 472 #: build/C/man4/cciss.4:248
 473 #, no-wrap
 474 msgid ""
 475 "    for x in /proc/driver/cciss/cciss[0-9]*\n"
 476 "    do\n"
 477 "        echo \"engage scsi\" E<gt> $x\n"
 478 "    done\n"
 479 msgstr ""
 480
 481 #. type: Plain text
 482 #: build/C/man4/cciss.4:252
 483 msgid ""
 484 "Once the SCSI core is engaged by the driver, it cannot be disengaged (except "
 485 "by unloading the driver, if it happens to be linked as a module.)"
 486 msgstr ""
 487
 488 #. type: Plain text
 489 #: build/C/man4/cciss.4:256
 490 msgid ""
 491 "Note also that if no sequential access devices or medium changers are "
 492 "detected, the SCSI core will not be engaged by the action of the above "
 493 "script."
 494 msgstr ""
 495
 496 #. type: SS
 497 #: build/C/man4/cciss.4:257
 498 #, no-wrap
 499 msgid "Hot plug support for SCSI tape drives"
 500 msgstr ""
 501
 502 #. type: Plain text
 503 #: build/C/man4/cciss.4:266
 504 msgid ""
 505 "Hot plugging of SCSI tape drives is supported, with some caveats.  The "
 506 "B<cciss> driver must be informed that changes to the SCSI bus have been "
 507 "made.  This may be done via the /proc file system.  For example:"
 508 msgstr ""
 509
 510 #. type: Plain text
 511 #: build/C/man4/cciss.4:268
 512 #, no-wrap
 513 msgid "    echo \"rescan\" E<gt> /proc/scsi/cciss0/1\n"
 514 msgstr ""
 515
 516 #. type: Plain text
 517 #: build/C/man4/cciss.4:270
 518 msgid "This causes the driver to:"
 519 msgstr ""
 520
 521 #. type: IP
 522 #: build/C/man4/cciss.4:271 build/C/man4/initrd.4:96 build/C/man4/initrd.4:322 build/C/man4/initrd.4:429 build/C/man4/st.4:891 build/C/man7/uri.7:528
 523 #, no-wrap
 524 msgid "1."
 525 msgstr ""
 526
 527 #. type: Plain text
 528 #: build/C/man4/cciss.4:274
 529 msgid ""
 530 "query the adapter about changes to the physical SCSI buses and/or fibre "
 531 "channel arbitrated loop, and"
 532 msgstr ""
 533
 534 #. type: IP
 535 #: build/C/man4/cciss.4:274 build/C/man4/initrd.4:100 build/C/man4/initrd.4:330 build/C/man4/initrd.4:440 build/C/man4/st.4:911 build/C/man7/uri.7:532
 536 #, no-wrap
 537 msgid "2."
 538 msgstr ""
 539
 540 #. type: Plain text
 541 #: build/C/man4/cciss.4:277
 542 msgid ""
 543 "make note of any new or removed sequential access devices or medium "
 544 "changers."
 545 msgstr ""
 546
 547 #. type: Plain text
 548 #: build/C/man4/cciss.4:284
 549 msgid ""
 550 "The driver will output messages indicating which devices have been added or "
 551 "removed and the controller, bus, target and lun used to address each "
 552 "device.  The driver then notifies the SCSI midlayer of these changes."
 553 msgstr ""
 554
 555 #. type: Plain text
 556 #: build/C/man4/cciss.4:289
 557 msgid ""
 558 "Note that the naming convention of the /proc file-system entries contains a "
 559 "number in addition to the driver name (e.g., \"cciss0\" instead of just "
 560 "\"cciss\", which you might expect)."
 561 msgstr ""
 562
 563 #. type: Plain text
 564 #: build/C/man4/cciss.4:307
 565 msgid ""
 566 "Note: I<Only> sequential access devices and medium changers are presented as "
 567 "SCSI devices to the SCSI midlayer by the B<cciss> driver.  Specifically, "
 568 "physical SCSI disk drives are I<not> presented to the SCSI midlayer.  The "
 569 "only disk devices that are presented to the kernel are logical drives that "
 570 "the array controller constructs from regions on the physical drives.  The "
 571 "logical drives are presented to the block layer (not to the SCSI midlayer).  "
 572 "It is important for the driver to prevent the kernel from accessing the "
 573 "physical drives directlyi, since these drives are used by the array "
 574 "controller to construct the logical drives."
 575 msgstr ""
 576
 577 #. type: SS
 578 #: build/C/man4/cciss.4:307
 579 #, no-wrap
 580 msgid "SCSI error handling for tape drives and medium changers"
 581 msgstr ""
 582
 583 #. type: Plain text
 584 #: build/C/man4/cciss.4:315
 585 msgid ""
 586 "The Linux SCSI midlayer provides an error-handling protocol that is "
 587 "initiated whenever a SCSI command fails to complete within a certain amount "
 588 "of time (which can vary depending on the command).  The B<cciss> driver "
 589 "participates in this protocol to some extent.  The normal protocol is a "
 590 "four-step process:"
 591 msgstr ""
 592
 593 #. type: IP
 594 #: build/C/man4/cciss.4:315 build/C/man4/cciss.4:317 build/C/man4/cciss.4:319 build/C/man4/cciss.4:321 build/C/man5/core.5:47 build/C/man5/core.5:59 build/C/man5/core.5:63 build/C/man5/core.5:67 build/C/man5/core.5:70 build/C/man5/core.5:83 build/C/man5/core.5:86 build/C/man5/core.5:183 build/C/man5/core.5:187 build/C/man5/core.5:190 build/C/man5/core.5:194
 595 #, no-wrap
 596 msgid "*"
 597 msgstr ""
 598
 599 #. type: Plain text
 600 #: build/C/man4/cciss.4:317
 601 msgid "First, the device is told to abort the command."
 602 msgstr ""
 603
 604 #. type: Plain text
 605 #: build/C/man4/cciss.4:319
 606 msgid "If that doesn't work, the device is reset."
 607 msgstr ""
 608
 609 #. type: Plain text
 610 #: build/C/man4/cciss.4:321
 611 msgid "If that doesn't work, the SCSI bus is reset."
 612 msgstr ""
 613
 614 #. type: Plain text
 615 #: build/C/man4/cciss.4:323
 616 msgid "If that doesn't work the host bus adapter is reset."
 617 msgstr ""
 618
 619 #. type: Plain text
 620 #: build/C/man4/cciss.4:341
 621 msgid ""
 622 "The B<cciss> driver is a block driver as well as a SCSI driver and only the "
 623 "tape drives and medium changers are presented to the SCSI midlayer "
 624 "Furthermore, unlike more straightforward SCSI drivers, disk I/O continues "
 625 "through the block side during the SCSI error-recovery process Therefore, the "
 626 "B<cciss> driver implements only the first two of these actions, aborting the "
 627 "command, and resetting the device.  Note also that most tape drives will not "
 628 "oblige in aborting commands, and sometimes it appears they will not even "
 629 "obey a reset command, though in most circumstances they will.  If the "
 630 "command cannot be aborted and the device cannot be reset, the device will be "
 631 "set offline."
 632 msgstr ""
 633
 634 #. type: Plain text
 635 #: build/C/man4/cciss.4:349
 636 msgid ""
 637 "In the event that the error-handling code is triggered and a tape drive is "
 638 "successfully reset or the tardy command is successfully aborted, the tape "
 639 "drive may still not allow I/O to continue until some command is issued that "
 640 "positions the tape to a known position.  Typically you must rewind the tape "
 641 "(by issuing I<mt -f /dev/st0 rewind> for example) before I/O can proceed "
 642 "again to a tape drive that was reset."
 643 msgstr ""
 644
 645 #. type: SH
 646 #: build/C/man4/cciss.4:349 build/C/man4/console.4:77 build/C/man4/console_codes.4:638 build/C/man4/console_ioctl.4:613 build/C/man5/core.5:385 build/C/man4/cpuid.4:87 build/C/man4/dsp56k.4:114 build/C/man4/fd.4:213 build/C/man7/fifo.7:62 build/C/man4/full.4:51 build/C/man3/gnu_get_libc_version.3:75 build/C/man4/hd.4:96 build/C/man4/hpsa.4:177 build/C/man4/initrd.4:473 build/C/man4/lp.4:122 build/C/man3/makedev.3:79 build/C/man4/mem.4:81 build/C/man3/mkfifo.3:102 build/C/man2/mknod.2:204 build/C/man4/mouse.4:152 build/C/man4/msr.4:53 build/C/man4/null.4:52 build/C/man7/pipe.7:232 build/C/man4/ram.4:40 build/C/man4/random.4:216 build/C/man3/setlogmask.3:70 build/C/man4/sk98lin.4:602 build/C/man4/st.4:952 build/C/man2/syslog.2:268 build/C/man3/syslog.3:308 build/C/man4/ttyS.4:46 build/C/man7/uri.7:699 build/C/man4/vcs.4:150 build/C/man4/wavelan.4:131
 647 #, no-wrap
 648 msgid "SEE ALSO"
 649 msgstr ""
 650
 651 #.  .SH AUTHORS
 652 #.  Don Brace, Steve Cameron, Chase Maupin, Mike Miller, Michael Ni,
 653 #.  Charles White, Francis Wiran
 654 #.  and probably some other people.
 655 #. type: Plain text
 656 #: build/C/man4/cciss.4:363
 657 msgid ""
 658 "B<cciss_vol_status>(8), B<hpsa>(4), B<hpacucli>(8), B<hpacuxe>(8), "
 659 "I<http://cciss.sf.net>, and the Linux kernel source files "
 660 "I<Documentation/blockdev/cciss.txt> and "
 661 "I<Documentation/ABI/testing/sysfs-bus-pci-devices-cciss>"
 662 msgstr ""
 663
 664 #. type: SH
 665 #: build/C/man4/cciss.4:363 build/C/man4/console.4:94 build/C/man4/console_codes.4:642 build/C/man4/console_ioctl.4:639 build/C/man5/core.5:396 build/C/man4/cpuid.4:94 build/C/man4/dsp56k.4:119 build/C/man4/fd.4:221 build/C/man7/fifo.7:71 build/C/man4/full.4:55 build/C/man3/gnu_get_libc_version.3:77 build/C/man4/hd.4:101 build/C/man4/hpsa.4:192 build/C/man4/initrd.4:484 build/C/man4/lp.4:128 build/C/man3/makedev.3:82 build/C/man4/mem.4:85 build/C/man3/mkfifo.3:112 build/C/man2/mknod.2:218 build/C/man4/mouse.4:155 build/C/man4/msr.4:57 build/C/man4/null.4:56 build/C/man7/pipe.7:244 build/C/man4/ram.4:44 build/C/man4/random.4:220 build/C/man4/sd.4:136 build/C/man3/setlogmask.3:74 build/C/man4/sk98lin.4:606 build/C/man4/st.4:962 build/C/man3/stdarg.3:310 build/C/man2/syslog.2:271 build/C/man3/syslog.3:313 build/C/man4/ttyS.4:53 build/C/man7/uri.7:707 build/C/man4/vcs.4:155 build/C/man4/wavelan.4:138
 666 #, no-wrap
 667 msgid "COLOPHON"
 668 msgstr ""
 669
 670 #. type: Plain text
 671 #: build/C/man4/cciss.4:370 build/C/man4/console.4:101 build/C/man4/console_codes.4:649 build/C/man4/console_ioctl.4:646 build/C/man5/core.5:403 build/C/man4/cpuid.4:101 build/C/man4/dsp56k.4:126 build/C/man4/fd.4:228 build/C/man7/fifo.7:78 build/C/man4/full.4:62 build/C/man3/gnu_get_libc_version.3:84 build/C/man4/hd.4:108 build/C/man4/hpsa.4:199 build/C/man4/initrd.4:491 build/C/man4/lp.4:135 build/C/man3/makedev.3:89 build/C/man4/mem.4:92 build/C/man3/mkfifo.3:119 build/C/man2/mknod.2:225 build/C/man4/mouse.4:162 build/C/man4/msr.4:64 build/C/man4/null.4:63 build/C/man7/pipe.7:251 build/C/man4/ram.4:51 build/C/man4/random.4:227 build/C/man4/sd.4:143 build/C/man3/setlogmask.3:81 build/C/man4/sk98lin.4:613 build/C/man4/st.4:969 build/C/man3/stdarg.3:317 build/C/man2/syslog.2:278 build/C/man3/syslog.3:320 build/C/man4/ttyS.4:60 build/C/man7/uri.7:714 build/C/man4/vcs.4:162 build/C/man4/wavelan.4:145
 672 msgid ""
 673 "This page is part of release 3.40 of the Linux I<man-pages> project.  A "
 674 "description of the project, and information about reporting bugs, can be "
 675 "found at http://www.kernel.org/doc/man-pages/."
 676 msgstr ""
 677
 678 #. type: TH
 679 #: build/C/man4/console.4:10
 680 #, no-wrap
 681 msgid "CONSOLE"
 682 msgstr ""
 683
 684 #. type: TH
 685 #: build/C/man4/console.4:10
 686 #, no-wrap
 687 msgid "1994-10-31"
 688 msgstr ""
 689
 690 #. type: Plain text
 691 #: build/C/man4/console.4:13
 692 msgid "console - console terminal and virtual consoles"
 693 msgstr ""
 694
 695 #. type: Plain text
 696 #: build/C/man4/console.4:24
 697 msgid ""
 698 "A Linux system has up to 63 I<virtual consoles> (character devices with "
 699 "major number 4 and minor number 1 to 63), usually called I</dev/tty>I<n> "
 700 "with 1 \\(E<lt>= I<n> \\(E<lt>= 63.  The current console is also addressed "
 701 "by I</dev/console> or I</dev/tty0>, the character device with major number 4 "
 702 "and minor number 0.  The device files /dev/* are usually created using the "
 703 "script MAKEDEV, or using B<mknod>(1), usually with mode 0622 and owner "
 704 "root.tty."
 705 msgstr ""
 706
 707 #. type: Plain text
 708 #: build/C/man4/console.4:30
 709 msgid ""
 710 "Before kernel version 1.1.54 the number of virtual consoles was compiled "
 711 "into the kernel (in tty.h: #define NR_CONSOLES 8)  and could be changed by "
 712 "editing and recompiling.  Since version 1.1.54 virtual consoles are created "
 713 "on the fly, as soon as they are needed."
 714 msgstr ""
 715
 716 #. type: Plain text
 717 #: build/C/man4/console.4:48
 718 msgid ""
 719 "Common ways to start a process on a console are: (a) tell B<init>(8)  (in "
 720 "B<inittab>(5))  to start a B<mingetty>(8)  (or B<agetty>(8))  on the "
 721 "console; (b) ask B<openvt>(1)  to start a process on the console; (c) start "
 722 "X\\(emit will find the first unused console, and display its output there.  "
 723 "(There is also the ancient B<doshell>(8).)"
 724 msgstr ""
 725
 726 #. type: Plain text
 727 #: build/C/man4/console.4:59
 728 msgid ""
 729 "Common ways to switch consoles are: (a) use Alt+FI<n> or Ctrl+Alt+FI<n> to "
 730 "switch to console I<n>; AltGr+FI<n> might bring you to console I<n>+12 [here "
 731 "Alt and AltGr refer to the left and right Alt keys, respectively]; (b) use "
 732 "Alt+RightArrow or Alt+LeftArrow to cycle through the presently allocated "
 733 "consoles; (c) use the program B<chvt>(1).  (The key mapping is user "
 734 "settable, see B<loadkeys>(1); the above mentioned key combinations are "
 735 "according to the default settings.)"
 736 msgstr ""
 737
 738 #. type: Plain text
 739 #: build/C/man4/console.4:65
 740 msgid ""
 741 "The command B<deallocvt>(1)  (formerly B<disalloc>)  will free the memory "
 742 "taken by the screen buffers for consoles that no longer have any associated "
 743 "process."
 744 msgstr ""
 745
 746 #. type: SS
 747 #: build/C/man4/console.4:65
 748 #, no-wrap
 749 msgid "Properties"
 750 msgstr ""
 751
 752 #. type: Plain text
 753 #: build/C/man4/console.4:73
 754 msgid ""
 755 "Consoles carry a lot of state.  I hope to document that some other time.  "
 756 "The most important fact is that the consoles simulate vt100 terminals.  In "
 757 "particular, a console is reset to the initial state by printing the two "
 758 "characters ESC c.  All escape sequences can be found in B<console_codes>(4)."
 759 msgstr ""
 760
 761 #. type: Plain text
 762 #: build/C/man4/console.4:75
 763 msgid "I</dev/console>"
 764 msgstr ""
 765
 766 #. type: Plain text
 767 #: build/C/man4/console.4:77
 768 msgid "I</dev/tty*>"
 769 msgstr ""
 770
 771 #. type: Plain text
 772 #: build/C/man4/console.4:94
 773 msgid ""
 774 "B<chvt>(1), B<deallocvt>(1), B<loadkeys>(1), B<mknod>(1), B<openvt>(1), "
 775 "B<console_codes>(4), B<console_ioctl>(4), B<tty>(4), B<ttyS>(4), "
 776 "B<charsets>(7), B<agetty>(8), B<init>(8), B<mapscrn>(8), B<mingetty>(8), "
 777 "B<resizecons>(8), B<setfont>(8)"
 778 msgstr ""
 779
 780 #. type: TH
 781 #: build/C/man4/console_codes.4:21
 782 #, no-wrap
 783 msgid "CONSOLE_CODES"
 784 msgstr ""
 785
 786 #. type: TH
 787 #: build/C/man4/console_codes.4:21
 788 #, no-wrap
 789 msgid "2011-09-15"
 790 msgstr ""
 791
 792 #. type: Plain text
 793 #: build/C/man4/console_codes.4:24
 794 msgid "console_codes - Linux console escape and control sequences"
 795 msgstr ""
 796
 797 #. type: Plain text
 798 #: build/C/man4/console_codes.4:31
 799 msgid ""
 800 "The Linux console implements a large subset of the VT102 and ECMA-48/ISO "
 801 "6429/ANSI X3.64 terminal controls, plus certain private-mode sequences for "
 802 "changing the color palette, character-set mapping, etc.  In the tabular "
 803 "descriptions below, the second column gives ECMA-48 or DEC mnemonics (the "
 804 "latter if prefixed with DEC) for the given function.  Sequences without a "
 805 "mnemonic are neither ECMA-48 nor VT102."
 806 msgstr ""
 807
 808 #. type: Plain text
 809 #: build/C/man4/console_codes.4:36
 810 msgid ""
 811 "After all the normal output processing has been done, and a stream of "
 812 "characters arrives at the console driver for actual printing, the first "
 813 "thing that happens is a translation from the code used for processing to the "
 814 "code used for printing."
 815 msgstr ""
 816
 817 #. type: Plain text
 818 #: build/C/man4/console_codes.4:42
 819 msgid ""
 820 "If the console is in UTF-8 mode, then the incoming bytes are first assembled "
 821 "into 16-bit Unicode codes.  Otherwise each byte is transformed according to "
 822 "the current mapping table (which translates it to a Unicode value).  See the "
 823 "B<Character Sets> section below for discussion."
 824 msgstr ""
 825
 826 #. type: Plain text
 827 #: build/C/man4/console_codes.4:48
 828 msgid ""
 829 "In the normal case, the Unicode value is converted to a font index, and this "
 830 "is stored in video memory, so that the corresponding glyph (as found in "
 831 "video ROM) appears on the screen.  Note that the use of Unicode (and the "
 832 "design of the PC hardware)  allows us to use 512 different glyphs "
 833 "simultaneously."
 834 msgstr ""
 835
 836 #. type: Plain text
 837 #: build/C/man4/console_codes.4:55
 838 msgid ""
 839 "If the current Unicode value is a control character, or we are currently "
 840 "processing an escape sequence, the value will treated specially.  Instead of "
 841 "being turned into a font index and rendered as a glyph, it may trigger "
 842 "cursor movement or other control functions.  See the B<Linux Console "
 843 "Controls> section below for discussion."
 844 msgstr ""
 845
 846 #. type: Plain text
 847 #: build/C/man4/console_codes.4:67
 848 msgid ""
 849 "It is generally not good practice to hard-wire terminal controls into "
 850 "programs.  Linux supports a B<terminfo>(5)  database of terminal "
 851 "capabilities.  Rather than emitting console escape sequences by hand, you "
 852 "will almost always want to use a terminfo-aware screen library or utility "
 853 "such as B<ncurses>(3), B<tput>(1), or B<reset>(1)."
 854 msgstr ""
 855
 856 #. type: SS
 857 #: build/C/man4/console_codes.4:67
 858 #, no-wrap
 859 msgid "Linux Console Controls"
 860 msgstr ""
 861
 862 #. type: Plain text
 863 #: build/C/man4/console_codes.4:71
 864 msgid ""
 865 "This section describes all the control characters and escape sequences that "
 866 "invoke special functions (i.e., anything other than writing a glyph at the "
 867 "current cursor location) on the Linux console."
 868 msgstr ""
 869
 870 #. type: Plain text
 871 #: build/C/man4/console_codes.4:73
 872 msgid "B<Control characters>"
 873 msgstr ""
 874
 875 #. type: Plain text
 876 #: build/C/man4/console_codes.4:84
 877 msgid ""
 878 "A character is a control character if (before transformation according to "
 879 "the mapping table) it has one of the 14 codes 00 (NUL), 07 (BEL), 08 (BS), "
 880 "09 (HT), 0a (LF), 0b (VT), 0c (FF), 0d (CR), 0e (SO), 0f (SI), 18 (CAN), 1a "
 881 "(SUB), 1b (ESC), 7f (DEL).  One can set a \"display control characters\" "
 882 "mode (see below), and allow 07, 09, 0b, 18, 1a, 7f to be displayed as "
 883 "glyphs.  On the other hand, in UTF-8 mode all codes 00-1f are regarded as "
 884 "control characters, regardless of any \"display control characters\" mode."
 885 msgstr ""
 886
 887 #. type: Plain text
 888 #: build/C/man4/console_codes.4:93
 889 msgid ""
 890 "If we have a control character, it is acted upon immediately and then "
 891 "discarded (even in the middle of an escape sequence)  and the escape "
 892 "sequence continues with the next character.  (However, ESC starts a new "
 893 "escape sequence, possibly aborting a previous unfinished one, and CAN and "
 894 "SUB abort any escape sequence.)  The recognized control characters are BEL, "
 895 "BS, HT, LF, VT, FF, CR, SO, SI, CAN, SUB, ESC, DEL, CSI.  They do what one "
 896 "would expect:"
 897 msgstr ""
 898
 899 #. type: Plain text
 900 #: build/C/man4/console_codes.4:95
 901 msgid "BEL (0x07, B<^G>) beeps;"
 902 msgstr ""
 903
 904 #. type: Plain text
 905 #: build/C/man4/console_codes.4:98
 906 msgid ""
 907 "BS (0x08, B<^H>) backspaces one column (but not past the beginning of the "
 908 "line);"
 909 msgstr ""
 910
 911 #. type: Plain text
 912 #: build/C/man4/console_codes.4:101
 913 msgid ""
 914 "HT (0x09, B<^I>) goes to the next tab stop or to the end of the line if "
 915 "there is no earlier tab stop;"
 916 msgstr ""
 917
 918 #. type: Plain text
 919 #: build/C/man4/console_codes.4:105
 920 msgid ""
 921 "LF (0x0A, B<^J>), VT (0x0B, B<^K>) and FF (0x0C, B<^L>) all give a linefeed, "
 922 "and if LF/NL (new-line mode) is set also a carriage return;"
 923 msgstr ""
 924
 925 #. type: Plain text
 926 #: build/C/man4/console_codes.4:107
 927 msgid "CR (0x0D, B<^M>) gives a carriage return;"
 928 msgstr ""
 929
 930 #. type: Plain text
 931 #: build/C/man4/console_codes.4:109
 932 msgid "SO (0x0E, B<^N>) activates the G1 character set;"
 933 msgstr ""
 934
 935 #. type: Plain text
 936 #: build/C/man4/console_codes.4:111
 937 msgid "SI (0x0F, B<^O>) activates the G0 character set;"
 938 msgstr ""
 939
 940 #. type: Plain text
 941 #: build/C/man4/console_codes.4:113
 942 msgid "CAN (0x18, B<^X>) and SUB (0x1A, B<^Z>) interrupt escape sequences;"
 943 msgstr ""
 944
 945 #. type: Plain text
 946 #: build/C/man4/console_codes.4:115
 947 msgid "ESC (0x1B, B<^[>) starts an escape sequence;"
 948 msgstr ""
 949
 950 #. type: Plain text
 951 #: build/C/man4/console_codes.4:117
 952 msgid "DEL (0x7F) is ignored;"
 953 msgstr ""
 954
 955 #. type: Plain text
 956 #: build/C/man4/console_codes.4:119
 957 msgid "CSI (0x9B) is equivalent to ESC [."
 958 msgstr ""
 959
 960 #. type: Plain text
 961 #: build/C/man4/console_codes.4:121
 962 msgid "B<ESC- but not CSI-sequences>"
 963 msgstr ""
 964
 965 #. type: tbl table
 966 #: build/C/man4/console_codes.4:123
 967 #, no-wrap
 968 msgid "ESC c\tRIS\tReset.\n"
 969 msgstr ""
 970
 971 #. type: tbl table
 972 #: build/C/man4/console_codes.4:124
 973 #, no-wrap
 974 msgid "ESC D\tIND\tLinefeed.\n"
 975 msgstr ""
 976
 977 #. type: tbl table
 978 #: build/C/man4/console_codes.4:125
 979 #, no-wrap
 980 msgid "ESC E\tNEL\tNewline.\n"
 981 msgstr ""
 982
 983 #. type: tbl table
 984 #: build/C/man4/console_codes.4:126
 985 #, no-wrap
 986 msgid "ESC H\tHTS\tSet tab stop at current column.\n"
 987 msgstr ""
 988
 989 #. type: tbl table
 990 #: build/C/man4/console_codes.4:127
 991 #, no-wrap
 992 msgid "ESC M\tRI\tReverse linefeed.\n"
 993 msgstr ""
 994
 995 #. type: tbl table
 996 #: build/C/man4/console_codes.4:128
 997 #, no-wrap
 998 msgid "ESC Z\tDECID\tT{\n"
 999 msgstr ""
1000
1001 #. type: tbl table
1002 #: build/C/man4/console_codes.4:129
1003 #, no-wrap
1004 msgid "DEC private identification. The kernel\n"
1005 msgstr ""
1006
1007 #. type: tbl table
1008 #: build/C/man4/console_codes.4:130
1009 #, no-wrap
1010 msgid "returns the string  ESC [ ? 6 c, claiming\n"
1011 msgstr ""
1012
1013 #. type: tbl table
1014 #: build/C/man4/console_codes.4:131
1015 #, no-wrap
1016 msgid "that it is a VT102.\n"
1017 msgstr ""
1018
1019 #. type: tbl table
1020 #: build/C/man4/console_codes.4:132 build/C/man4/console_codes.4:136 build/C/man4/console_codes.4:161 build/C/man4/console_codes.4:241 build/C/man4/console_codes.4:247 build/C/man4/console_codes.4:251 build/C/man4/console_codes.4:258
1021 #, no-wrap
1022 msgid "T}\n"
1023 msgstr ""
1024
1025 #. type: tbl table
1026 #: build/C/man4/console_codes.4:133
1027 #, no-wrap
1028 msgid "ESC 7\tDECSC\tT{\n"
1029 msgstr ""
1030
1031 #. type: tbl table
1032 #: build/C/man4/console_codes.4:134
1033 #, no-wrap
1034 msgid "Save current state (cursor coordinates,\n"
1035 msgstr ""
1036
1037 #. type: tbl table
1038 #: build/C/man4/console_codes.4:135
1039 #, no-wrap
1040 msgid "attributes, character sets pointed at by G0, G1).\n"
1041 msgstr ""
1042
1043 #. type: tbl table
1044 #: build/C/man4/console_codes.4:137
1045 #, no-wrap
1046 msgid "ESC 8\tDECRC\tRestore state most recently saved by ESC 7.\n"
1047 msgstr ""
1048
1049 #. type: tbl table
1050 #: build/C/man4/console_codes.4:138
1051 #, no-wrap
1052 msgid "ESC [\tCSI\tControl sequence introducer\n"
1053 msgstr ""
1054
1055 #. type: tbl table
1056 #: build/C/man4/console_codes.4:139
1057 #, no-wrap
1058 msgid "ESC %\t\tStart sequence selecting character set\n"
1059 msgstr ""
1060
1061 #. type: tbl table
1062 #: build/C/man4/console_codes.4:140
1063 #, no-wrap
1064 msgid "ESC % @\t\t\\0\\0\\0Select default (ISO 646 / ISO 8859-1)\n"
1065 msgstr ""
1066
1067 #. type: tbl table
1068 #: build/C/man4/console_codes.4:141
1069 #, no-wrap
1070 msgid "ESC % G\t\t\\0\\0\\0Select UTF-8\n"
1071 msgstr ""
1072
1073 #. type: tbl table
1074 #: build/C/man4/console_codes.4:142
1075 #, no-wrap
1076 msgid "ESC % 8\t\t\\0\\0\\0Select UTF-8 (obsolete)\n"
1077 msgstr ""
1078
1079 #. type: tbl table
1080 #: build/C/man4/console_codes.4:143
1081 #, no-wrap
1082 msgid "ESC # 8\tDECALN\tDEC screen alignment test - fill screen with E's.\n"
1083 msgstr ""
1084
1085 #. type: tbl table
1086 #: build/C/man4/console_codes.4:144
1087 #, no-wrap
1088 msgid "ESC (\t\tStart sequence defining G0 character set\n"
1089 msgstr ""
1090
1091 #. type: tbl table
1092 #: build/C/man4/console_codes.4:145
1093 #, no-wrap
1094 msgid "ESC ( B\t\t\\0\\0\\0Select default (ISO 8859-1 mapping)\n"
1095 msgstr ""
1096
1097 #. type: tbl table
1098 #: build/C/man4/console_codes.4:146
1099 #, no-wrap
1100 msgid "ESC ( 0\t\t\\0\\0\\0Select VT100 graphics mapping\n"
1101 msgstr ""
1102
1103 #. type: tbl table
1104 #: build/C/man4/console_codes.4:147
1105 #, no-wrap
1106 msgid "ESC ( U\t\t\\0\\0\\0Select null mapping - straight to character ROM\n"
1107 msgstr ""
1108
1109 #. type: tbl table
1110 #: build/C/man4/console_codes.4:148
1111 #, no-wrap
1112 msgid "ESC ( K\t\t\\0\\0\\0Select user mapping - the map that is loaded by\n"
1113 msgstr ""
1114
1115 #. type: tbl table
1116 #: build/C/man4/console_codes.4:149
1117 #, no-wrap
1118 msgid "\t\t\\0\\0\\0the utility B<mapscrn>(8).\n"
1119 msgstr ""
1120
1121 #. type: tbl table
1122 #: build/C/man4/console_codes.4:150
1123 #, no-wrap
1124 msgid "ESC )\t\tStart sequence defining G1\n"
1125 msgstr ""
1126
1127 #. type: tbl table
1128 #: build/C/man4/console_codes.4:151
1129 #, no-wrap
1130 msgid "\t\t(followed by one of B, 0, U, K, as above).\n"
1131 msgstr ""
1132
1133 #. type: tbl table
1134 #: build/C/man4/console_codes.4:152
1135 #, no-wrap
1136 msgid "ESC E<gt>\tDECPNM\tSet numeric keypad mode\n"
1137 msgstr ""
1138
1139 #. type: tbl table
1140 #: build/C/man4/console_codes.4:153
1141 #, no-wrap
1142 msgid "ESC =\tDECPAM\tSet application keypad mode\n"
1143 msgstr ""
1144
1145 #. type: tbl table
1146 #: build/C/man4/console_codes.4:154
1147 #, no-wrap
1148 msgid "ESC ]\tOSC\tT{\n"
1149 msgstr ""
1150
1151 #. type: tbl table
1152 #: build/C/man4/console_codes.4:155
1153 #, no-wrap
1154 msgid "(Should be: Operating system command)\n"
1155 msgstr ""
1156
1157 #. type: tbl table
1158 #: build/C/man4/console_codes.4:156
1159 #, no-wrap
1160 msgid "ESC ] P I<nrrggbb>: set palette, with parameter\n"
1161 msgstr ""
1162
1163 #. type: tbl table
1164 #: build/C/man4/console_codes.4:157
1165 #, no-wrap
1166 msgid "given in 7 hexadecimal digits after the final P :-(.\n"
1167 msgstr ""
1168
1169 #. type: tbl table
1170 #: build/C/man4/console_codes.4:158
1171 #, no-wrap
1172 msgid "Here I<n> is the color (0-15), and I<rrggbb> indicates\n"
1173 msgstr ""
1174
1175 #. type: tbl table
1176 #: build/C/man4/console_codes.4:159
1177 #, no-wrap
1178 msgid "the red/green/blue values (0-255).\n"
1179 msgstr ""
1180
1181 #. type: tbl table
1182 #: build/C/man4/console_codes.4:160
1183 #, no-wrap
1184 msgid "ESC ] R: reset palette\n"
1185 msgstr ""
1186
1187 #. type: Plain text
1188 #: build/C/man4/console_codes.4:165
1189 msgid "B<ECMA-48 CSI sequences>"
1190 msgstr ""
1191
1192 #. type: Plain text
1193 #: build/C/man4/console_codes.4:171
1194 msgid ""
1195 "CSI (or ESC [) is followed by a sequence of parameters, at most NPAR (16), "
1196 "that are decimal numbers separated by semicolons.  An empty or absent "
1197 "parameter is taken to be 0.  The sequence of parameters may be preceded by a "
1198 "single question mark."
1199 msgstr ""
1200
1201 #. type: Plain text
1202 #: build/C/man4/console_codes.4:175
1203 msgid ""
1204 "However, after CSI [ (or ESC [ [) a single character is read and this entire "
1205 "sequence is ignored.  (The idea is to ignore an echoed function key.)"
1206 msgstr ""
1207
1208 #. type: Plain text
1209 #: build/C/man4/console_codes.4:177
1210 msgid "The action of a CSI sequence is determined by its final character."
1211 msgstr ""
1212
1213 #. type: tbl table
1214 #: build/C/man4/console_codes.4:179
1215 #, no-wrap
1216 msgid "@\tICH\tInsert the indicated # of blank characters.\n"
1217 msgstr ""
1218
1219 #. type: tbl table
1220 #: build/C/man4/console_codes.4:180
1221 #, no-wrap
1222 msgid "A\tCUU\tMove cursor up the indicated # of rows.\n"
1223 msgstr ""
1224
1225 #. type: tbl table
1226 #: build/C/man4/console_codes.4:181
1227 #, no-wrap
1228 msgid "B\tCUD\tMove cursor down the indicated # of rows.\n"
1229 msgstr ""
1230
1231 #. type: tbl table
1232 #: build/C/man4/console_codes.4:182
1233 #, no-wrap
1234 msgid "C\tCUF\tMove cursor right the indicated # of columns.\n"
1235 msgstr ""
1236
1237 #. type: tbl table
1238 #: build/C/man4/console_codes.4:183
1239 #, no-wrap
1240 msgid "D\tCUB\tMove cursor left the indicated # of columns.\n"
1241 msgstr ""
1242
1243 #. type: tbl table
1244 #: build/C/man4/console_codes.4:184
1245 #, no-wrap
1246 msgid "E\tCNL\tMove cursor down the indicated # of rows, to column 1.\n"
1247 msgstr ""
1248
1249 #. type: tbl table
1250 #: build/C/man4/console_codes.4:185
1251 #, no-wrap
1252 msgid "F\tCPL\tMove cursor up the indicated # of rows, to column 1.\n"
1253 msgstr ""
1254
1255 #. type: tbl table
1256 #: build/C/man4/console_codes.4:186
1257 #, no-wrap
1258 msgid "G\tCHA\tMove cursor to indicated column in current row.\n"
1259 msgstr ""
1260
1261 #. type: tbl table
1262 #: build/C/man4/console_codes.4:187
1263 #, no-wrap
1264 msgid "H\tCUP\tMove cursor to the indicated row, column (origin at 1,1).\n"
1265 msgstr ""
1266
1267 #. type: tbl table
1268 #: build/C/man4/console_codes.4:188
1269 #, no-wrap
1270 msgid "J\tED\tErase display (default: from cursor to end of display).\n"
1271 msgstr ""
1272
1273 #. type: tbl table
1274 #: build/C/man4/console_codes.4:189
1275 #, no-wrap
1276 msgid "\t\tESC [ 1 J: erase from start to cursor.\n"
1277 msgstr ""
1278
1279 #. type: tbl table
1280 #: build/C/man4/console_codes.4:190
1281 #, no-wrap
1282 msgid "\t\tESC [ 2 J: erase whole display.\n"
1283 msgstr ""
1284
1285 #. type: tbl table
1286 #: build/C/man4/console_codes.4:191
1287 #, no-wrap
1288 msgid "\t\tESC [ 3 J: erase whole display including scroll-back\n"
1289 msgstr ""
1290
1291 #. type: tbl table
1292 #: build/C/man4/console_codes.4:192
1293 #, no-wrap
1294 msgid "\t\t           buffer (since Linux 3.0).\n"
1295 msgstr ""
1296
1297 #.  ESC [ 3 J: commit f8df13e0a901fe55631fed66562369b4dba40f8b
1298 #. type: tbl table
1299 #: build/C/man4/console_codes.4:194
1300 #, no-wrap
1301 msgid "K\tEL\tErase line (default: from cursor to end of line).\n"
1302 msgstr ""
1303
1304 #. type: tbl table
1305 #: build/C/man4/console_codes.4:195
1306 #, no-wrap
1307 msgid "\t\tESC [ 1 K: erase from start of line to cursor.\n"
1308 msgstr ""
1309
1310 #. type: tbl table
1311 #: build/C/man4/console_codes.4:196
1312 #, no-wrap
1313 msgid "\t\tESC [ 2 K: erase whole line.\n"
1314 msgstr ""
1315
1316 #. type: tbl table
1317 #: build/C/man4/console_codes.4:197
1318 #, no-wrap
1319 msgid "L\tIL\tInsert the indicated # of blank lines.\n"
1320 msgstr ""
1321
1322 #. type: tbl table
1323 #: build/C/man4/console_codes.4:198
1324 #, no-wrap
1325 msgid "M\tDL\tDelete the indicated # of lines.\n"
1326 msgstr ""
1327
1328 #. type: tbl table
1329 #: build/C/man4/console_codes.4:199
1330 #, no-wrap
1331 msgid "P\tDCH\tDelete the indicated # of characters on the current line.\n"
1332 msgstr ""
1333
1334 #. type: tbl table
1335 #: build/C/man4/console_codes.4:200
1336 #, no-wrap
1337 msgid "X\tECH\tErase the indicated # of characters on the current line.\n"
1338 msgstr ""
1339
1340 #. type: tbl table
1341 #: build/C/man4/console_codes.4:201
1342 #, no-wrap
1343 msgid "a\tHPR\tMove cursor right the indicated # of columns.\n"
1344 msgstr ""
1345
1346 #. type: tbl table
1347 #: build/C/man4/console_codes.4:202
1348 #, no-wrap
1349 msgid "c\tDA\tAnswer ESC [ ? 6 c: \"I am a VT102\".\n"
1350 msgstr ""
1351
1352 #. type: tbl table
1353 #: build/C/man4/console_codes.4:203
1354 #, no-wrap
1355 msgid "d\tVPA\tMove cursor to the indicated row, current column.\n"
1356 msgstr ""
1357
1358 #. type: tbl table
1359 #: build/C/man4/console_codes.4:204
1360 #, no-wrap
1361 msgid "e\tVPR\tMove cursor down the indicated # of rows.\n"
1362 msgstr ""
1363
1364 #. type: tbl table
1365 #: build/C/man4/console_codes.4:205
1366 #, no-wrap
1367 msgid "f\tHVP\tMove cursor to the indicated row, column.\n"
1368 msgstr ""
1369
1370 #. type: tbl table
1371 #: build/C/man4/console_codes.4:206
1372 #, no-wrap
1373 msgid "g\tTBC\tWithout parameter: clear tab stop at the current position.\n"
1374 msgstr ""
1375
1376 #. type: tbl table
1377 #: build/C/man4/console_codes.4:207
1378 #, no-wrap
1379 msgid "\t\tESC [ 3 g: delete all tab stops.\n"
1380 msgstr ""
1381
1382 #. type: tbl table
1383 #: build/C/man4/console_codes.4:208
1384 #, no-wrap
1385 msgid "h\tSM\tSet Mode (see below).\n"
1386 msgstr ""
1387
1388 #. type: tbl table
1389 #: build/C/man4/console_codes.4:209
1390 #, no-wrap
1391 msgid "l\tRM\tReset Mode (see below).\n"
1392 msgstr ""
1393
1394 #. type: tbl table
1395 #: build/C/man4/console_codes.4:210
1396 #, no-wrap
1397 msgid "m\tSGR\tSet attributes (see below).\n"
1398 msgstr ""
1399
1400 #. type: tbl table
1401 #: build/C/man4/console_codes.4:211
1402 #, no-wrap
1403 msgid "n\tDSR\tStatus report (see below).\n"
1404 msgstr ""
1405
1406 #. type: tbl table
1407 #: build/C/man4/console_codes.4:212
1408 #, no-wrap
1409 msgid "q\tDECLL\tSet keyboard LEDs.\n"
1410 msgstr ""
1411
1412 #. type: tbl table
1413 #: build/C/man4/console_codes.4:213
1414 #, no-wrap
1415 msgid "\t\tESC [ 0 q: clear all LEDs\n"
1416 msgstr ""
1417
1418 #. type: tbl table
1419 #: build/C/man4/console_codes.4:214
1420 #, no-wrap
1421 msgid "\t\tESC [ 1 q: set Scroll Lock LED\n"
1422 msgstr ""
1423
1424 #. type: tbl table
1425 #: build/C/man4/console_codes.4:215
1426 #, no-wrap
1427 msgid "\t\tESC [ 2 q: set Num Lock LED\n"
1428 msgstr ""
1429
1430 #. type: tbl table
1431 #: build/C/man4/console_codes.4:216
1432 #, no-wrap
1433 msgid "\t\tESC [ 3 q: set Caps Lock LED\n"
1434 msgstr ""
1435
1436 #. type: tbl table
1437 #: build/C/man4/console_codes.4:217
1438 #, no-wrap
1439 msgid "r\tDECSTBM\tSet scrolling region; parameters are top and bottom row.\n"
1440 msgstr ""
1441
1442 #. type: tbl table
1443 #: build/C/man4/console_codes.4:218
1444 #, no-wrap
1445 msgid "s\t?\tSave cursor location.\n"
1446 msgstr ""
1447
1448 #. type: tbl table
1449 #: build/C/man4/console_codes.4:219
1450 #, no-wrap
1451 msgid "u\t?\tRestore cursor location.\n"
1452 msgstr ""
1453
1454 #. type: tbl table
1455 #: build/C/man4/console_codes.4:220
1456 #, no-wrap
1457 msgid "\\`\tHPA\tMove cursor to indicated column in current row.\n"
1458 msgstr ""
1459
1460 #. type: Plain text
1461 #: build/C/man4/console_codes.4:224
1462 msgid "B<ECMA-48 Set Graphics Rendition>"
1463 msgstr ""
1464
1465 #. type: Plain text
1466 #: build/C/man4/console_codes.4:231
1467 msgid ""
1468 "The ECMA-48 SGR sequence ESC [ I<parameters> m sets display attributes.  "
1469 "Several attributes can be set in the same sequence, separated by "
1470 "semicolons.  An empty parameter (between semicolons or string initiator or "
1471 "terminator) is interpreted as a zero."
1472 msgstr ""
1473
1474 #. type: tbl table
1475 #: build/C/man4/console_codes.4:233
1476 #, no-wrap
1477 msgid "param\tresult\n"
1478 msgstr ""
1479
1480 #. type: tbl table
1481 #: build/C/man4/console_codes.4:234
1482 #, no-wrap
1483 msgid "0\treset all attributes to their defaults\n"
1484 msgstr ""
1485
1486 #. type: tbl table
1487 #: build/C/man4/console_codes.4:235
1488 #, no-wrap
1489 msgid "1\tset bold\n"
1490 msgstr ""
1491
1492 #. type: tbl table
1493 #: build/C/man4/console_codes.4:236
1494 #, no-wrap
1495 msgid "2\tset half-bright (simulated with color on a color display)\n"
1496 msgstr ""
1497
1498 #. type: tbl table
1499 #: build/C/man4/console_codes.4:237
1500 #, no-wrap
1501 msgid "4\tT{\n"
1502 msgstr ""
1503
1504 #. type: tbl table
1505 #: build/C/man4/console_codes.4:238
1506 #, no-wrap
1507 msgid "set underscore (simulated with color on a color display)\n"
1508 msgstr ""
1509
1510 #. type: tbl table
1511 #: build/C/man4/console_codes.4:239
1512 #, no-wrap
1513 msgid "(the colors used to simulate dim or underline are set\n"
1514 msgstr ""
1515
1516 #. type: tbl table
1517 #: build/C/man4/console_codes.4:240
1518 #, no-wrap
1519 msgid "using ESC ] ...)\n"
1520 msgstr ""
1521
1522 #. type: tbl table
1523 #: build/C/man4/console_codes.4:242
1524 #, no-wrap
1525 msgid "5\tset blink\n"
1526 msgstr ""
1527
1528 #. type: tbl table
1529 #: build/C/man4/console_codes.4:243
1530 #, no-wrap
1531 msgid "7\tset reverse video\n"
1532 msgstr ""
1533
1534 #. type: tbl table
1535 #: build/C/man4/console_codes.4:244
1536 #, no-wrap
1537 msgid "10\tT{\n"
1538 msgstr ""
1539
1540 #. type: tbl table
1541 #: build/C/man4/console_codes.4:245
1542 #, no-wrap
1543 msgid "reset selected mapping, display control flag,\n"
1544 msgstr ""
1545
1546 #. type: tbl table
1547 #: build/C/man4/console_codes.4:246
1548 #, no-wrap
1549 msgid "and toggle meta flag (ECMA-48 says \"primary font\").\n"
1550 msgstr ""
1551
1552 #. type: tbl table
1553 #: build/C/man4/console_codes.4:248
1554 #, no-wrap
1555 msgid "11\tT{\n"
1556 msgstr ""
1557
1558 #. type: tbl table
1559 #: build/C/man4/console_codes.4:249 build/C/man4/console_codes.4:253
1560 #, no-wrap
1561 msgid "select null mapping, set display control flag,\n"
1562 msgstr ""
1563
1564 #. type: tbl table
1565 #: build/C/man4/console_codes.4:250
1566 #, no-wrap
1567 msgid "reset toggle meta flag (ECMA-48 says \"first alternate font\").\n"
1568 msgstr ""
1569
1570 #. type: tbl table
1571 #: build/C/man4/console_codes.4:252
1572 #, no-wrap
1573 msgid "12\tT{\n"
1574 msgstr ""
1575
1576 #. type: tbl table
1577 #: build/C/man4/console_codes.4:254
1578 #, no-wrap
1579 msgid "set toggle meta flag (ECMA-48 says \"second alternate font\").\n"
1580 msgstr ""
1581
1582 #. type: tbl table
1583 #: build/C/man4/console_codes.4:255
1584 #, no-wrap
1585 msgid "The toggle meta flag\n"
1586 msgstr ""
1587
1588 #. type: tbl table
1589 #: build/C/man4/console_codes.4:256
1590 #, no-wrap
1591 msgid "causes the high bit of a byte to be toggled\n"
1592 msgstr ""
1593
1594 #. type: tbl table
1595 #: build/C/man4/console_codes.4:257
1596 #, no-wrap
1597 msgid "before the mapping table translation is done.\n"
1598 msgstr ""
1599
1600 #. type: tbl table
1601 #: build/C/man4/console_codes.4:259
1602 #, no-wrap
1603 msgid "21\tset normal intensity (ECMA-48 says \"doubly underlined\")\n"
1604 msgstr ""
1605
1606 #. type: tbl table
1607 #: build/C/man4/console_codes.4:260
1608 #, no-wrap
1609 msgid "22\tset normal intensity\n"
1610 msgstr ""
1611
1612 #. type: tbl table
1613 #: build/C/man4/console_codes.4:261
1614 #, no-wrap
1615 msgid "24\tunderline off\n"
1616 msgstr ""
1617
1618 #. type: tbl table
1619 #: build/C/man4/console_codes.4:262
1620 #, no-wrap
1621 msgid "25\tblink off\n"
1622 msgstr ""
1623
1624 #. type: tbl table
1625 #: build/C/man4/console_codes.4:263
1626 #, no-wrap
1627 msgid "27\treverse video off\n"
1628 msgstr ""
1629
1630 #. type: tbl table
1631 #: build/C/man4/console_codes.4:264
1632 #, no-wrap
1633 msgid "30\tset black foreground\n"
1634 msgstr ""
1635
1636 #. type: tbl table
1637 #: build/C/man4/console_codes.4:265
1638 #, no-wrap
1639 msgid "31\tset red foreground\n"
1640 msgstr ""
1641
1642 #. type: tbl table
1643 #: build/C/man4/console_codes.4:266
1644 #, no-wrap
1645 msgid "32\tset green foreground\n"
1646 msgstr ""
1647
1648 #. type: tbl table
1649 #: build/C/man4/console_codes.4:267
1650 #, no-wrap
1651 msgid "33\tset brown foreground\n"
1652 msgstr ""
1653
1654 #. type: tbl table
1655 #: build/C/man4/console_codes.4:268
1656 #, no-wrap
1657 msgid "34\tset blue foreground\n"
1658 msgstr ""
1659
1660 #. type: tbl table
1661 #: build/C/man4/console_codes.4:269
1662 #, no-wrap
1663 msgid "35\tset magenta foreground\n"
1664 msgstr ""
1665
1666 #. type: tbl table
1667 #: build/C/man4/console_codes.4:270
1668 #, no-wrap
1669 msgid "36\tset cyan foreground\n"
1670 msgstr ""
1671
1672 #. type: tbl table
1673 #: build/C/man4/console_codes.4:271
1674 #, no-wrap
1675 msgid "37\tset white foreground\n"
1676 msgstr ""
1677
1678 #. type: tbl table
1679 #: build/C/man4/console_codes.4:272
1680 #, no-wrap
1681 msgid "38\tset underscore on, set default foreground color\n"
1682 msgstr ""
1683
1684 #. type: tbl table
1685 #: build/C/man4/console_codes.4:273
1686 #, no-wrap
1687 msgid "39\tset underscore off, set default foreground color\n"
1688 msgstr ""
1689
1690 #. type: tbl table
1691 #: build/C/man4/console_codes.4:274
1692 #, no-wrap
1693 msgid "40\tset black background\n"
1694 msgstr ""
1695
1696 #. type: tbl table
1697 #: build/C/man4/console_codes.4:275
1698 #, no-wrap
1699 msgid "41\tset red background\n"
1700 msgstr ""
1701
1702 #. type: tbl table
1703 #: build/C/man4/console_codes.4:276
1704 #, no-wrap
1705 msgid "42\tset green background\n"
1706 msgstr ""
1707
1708 #. type: tbl table
1709 #: build/C/man4/console_codes.4:277
1710 #, no-wrap
1711 msgid "43\tset brown background\n"
1712 msgstr ""
1713
1714 #. type: tbl table
1715 #: build/C/man4/console_codes.4:278
1716 #, no-wrap
1717 msgid "44\tset blue background\n"
1718 msgstr ""
1719
1720 #. type: tbl table
1721 #: build/C/man4/console_codes.4:279
1722 #, no-wrap
1723 msgid "45\tset magenta background\n"
1724 msgstr ""
1725
1726 #. type: tbl table
1727 #: build/C/man4/console_codes.4:280
1728 #, no-wrap
1729 msgid "46\tset cyan background\n"
1730 msgstr ""
1731
1732 #. type: tbl table
1733 #: build/C/man4/console_codes.4:281
1734 #, no-wrap
1735 msgid "47\tset white background\n"
1736 msgstr ""
1737
1738 #. type: tbl table
1739 #: build/C/man4/console_codes.4:282
1740 #, no-wrap
1741 msgid "49\tset default background color\n"
1742 msgstr ""
1743
1744 #. type: Plain text
1745 #: build/C/man4/console_codes.4:286
1746 msgid "B<ECMA-48 Mode Switches>"
1747 msgstr ""
1748
1749 #. type: TP
1750 #: build/C/man4/console_codes.4:286
1751 #, no-wrap
1752 msgid "ESC [ 3 h"
1753 msgstr ""
1754
1755 #. type: Plain text
1756 #: build/C/man4/console_codes.4:289
1757 msgid "DECCRM (default off): Display control chars."
1758 msgstr ""
1759
1760 #. type: TP
1761 #: build/C/man4/console_codes.4:289
1762 #, no-wrap
1763 msgid "ESC [ 4 h"
1764 msgstr ""
1765
1766 #. type: Plain text
1767 #: build/C/man4/console_codes.4:292
1768 msgid "DECIM (default off): Set insert mode."
1769 msgstr ""
1770
1771 #. type: TP
1772 #: build/C/man4/console_codes.4:292
1773 #, no-wrap
1774 msgid "ESC [ 20 h"
1775 msgstr ""
1776
1777 #. type: Plain text
1778 #: build/C/man4/console_codes.4:296
1779 msgid "LF/NL (default off): Automatically follow echo of LF, VT or FF with CR."
1780 msgstr ""
1781
1782 #. type: Plain text
1783 #: build/C/man4/console_codes.4:299
1784 msgid "B<ECMA-48 Status Report Commands>"
1785 msgstr ""
1786
1787 #. type: TP
1788 #: build/C/man4/console_codes.4:299
1789 #, no-wrap
1790 msgid "ESC [ 5 n"
1791 msgstr ""
1792
1793 #. type: Plain text
1794 #: build/C/man4/console_codes.4:302
1795 msgid "Device status report (DSR): Answer is ESC [ 0 n (Terminal OK)."
1796 msgstr ""
1797
1798 #. type: TP
1799 #: build/C/man4/console_codes.4:302
1800 #, no-wrap
1801 msgid "ESC [ 6 n"
1802 msgstr ""
1803
1804 #. type: Plain text
1805 #: build/C/man4/console_codes.4:307
1806 msgid ""
1807 "Cursor position report (CPR): Answer is ESC [ I<y> ; I<x> R, where I<x,y> is "
1808 "the cursor location."
1809 msgstr ""
1810
1811 #. type: Plain text
1812 #: build/C/man4/console_codes.4:309
1813 msgid "B<DEC Private Mode (DECSET/DECRST) sequences>"
1814 msgstr ""
1815
1816 #. type: Plain text
1817 #: build/C/man4/console_codes.4:315
1818 msgid ""
1819 "These are not described in ECMA-48.  We list the Set Mode sequences; the "
1820 "Reset Mode sequences are obtained by replacing the final \\(aqh\\(aq by "
1821 "\\(aql\\(aq."
1822 msgstr ""
1823
1824 #. type: TP
1825 #: build/C/man4/console_codes.4:315
1826 #, no-wrap
1827 msgid "ESC [ ? 1 h"
1828 msgstr ""
1829
1830 #. type: Plain text
1831 #: build/C/man4/console_codes.4:319
1832 msgid ""
1833 "DECCKM (default off): When set, the cursor keys send an ESC O prefix, rather "
1834 "than ESC [."
1835 msgstr ""
1836
1837 #. type: TP
1838 #: build/C/man4/console_codes.4:319
1839 #, no-wrap
1840 msgid "ESC [ ? 3 h"
1841 msgstr ""
1842
1843 #. type: Plain text
1844 #: build/C/man4/console_codes.4:326
1845 msgid ""
1846 "DECCOLM (default off = 80 columns): 80/132 col mode switch.  The driver "
1847 "sources note that this alone does not suffice; some user-mode utility such "
1848 "as B<resizecons>(8)  has to change the hardware registers on the console "
1849 "video card."
1850 msgstr ""
1851
1852 #. type: TP
1853 #: build/C/man4/console_codes.4:326
1854 #, no-wrap
1855 msgid "ESC [ ? 5 h"
1856 msgstr ""
1857
1858 #. type: Plain text
1859 #: build/C/man4/console_codes.4:329
1860 msgid "DECSCNM (default off): Set reverse-video mode."
1861 msgstr ""
1862
1863 #. type: TP
1864 #: build/C/man4/console_codes.4:329
1865 #, no-wrap
1866 msgid "ESC [ ? 6 h"
1867 msgstr ""
1868
1869 #. type: Plain text
1870 #: build/C/man4/console_codes.4:333
1871 msgid ""
1872 "DECOM (default off): When set, cursor addressing is relative to the upper "
1873 "left corner of the scrolling region."
1874 msgstr ""
1875
1876 #. type: TP
1877 #: build/C/man4/console_codes.4:333
1878 #, no-wrap
1879 msgid "ESC [ ? 7 h"
1880 msgstr ""
1881
1882 #. type: Plain text
1883 #: build/C/man4/console_codes.4:339
1884 msgid ""
1885 "DECAWM (default on): Set autowrap on.  In this mode, a graphic character "
1886 "emitted after column 80 (or column 132 of DECCOLM is on)  forces a wrap to "
1887 "the beginning of the following line first."
1888 msgstr ""
1889
1890 #. type: TP
1891 #: build/C/man4/console_codes.4:339
1892 #, no-wrap
1893 msgid "ESC [ ? 8 h"
1894 msgstr ""
1895
1896 #. type: Plain text
1897 #: build/C/man4/console_codes.4:342
1898 msgid "DECARM (default on): Set keyboard autorepeat on."
1899 msgstr ""
1900
1901 #. type: TP
1902 #: build/C/man4/console_codes.4:342
1903 #, no-wrap
1904 msgid "ESC [ ? 9 h"
1905 msgstr ""
1906
1907 #. type: Plain text
1908 #: build/C/man4/console_codes.4:346
1909 msgid ""
1910 "X10 Mouse Reporting (default off): Set reporting mode to 1 (or reset to "
1911 "0)\\(emsee below."
1912 msgstr ""
1913
1914 #. type: TP
1915 #: build/C/man4/console_codes.4:346
1916 #, no-wrap
1917 msgid "ESC [ ? 25 h"
1918 msgstr ""
1919
1920 #. type: Plain text
1921 #: build/C/man4/console_codes.4:349
1922 msgid "DECTECM (default on): Make cursor visible."
1923 msgstr ""
1924
1925 #. type: TP
1926 #: build/C/man4/console_codes.4:349
1927 #, no-wrap
1928 msgid "ESC [ ? 1000 h"
1929 msgstr ""
1930
1931 #. type: Plain text
1932 #: build/C/man4/console_codes.4:354
1933 msgid ""
1934 "X11 Mouse Reporting (default off): Set reporting mode to 2 (or reset to "
1935 "0)\\(emsee below."
1936 msgstr ""
1937
1938 #. type: Plain text
1939 #: build/C/man4/console_codes.4:356
1940 msgid "B<Linux Console Private CSI Sequences>"
1941 msgstr ""
1942
1943 #. type: Plain text
1944 #: build/C/man4/console_codes.4:363
1945 msgid ""
1946 "The following sequences are neither ECMA-48 nor native VT102.  They are "
1947 "native to the Linux console driver.  Colors are in SGR parameters: 0 = "
1948 "black, 1 = red, 2 = green, 3 = brown, 4 = blue, 5 = magenta, 6 = cyan, 7 = "
1949 "white."
1950 msgstr ""
1951
1952 #. type: tbl table
1953 #: build/C/man4/console_codes.4:365
1954 #, no-wrap
1955 msgid "ESC [ 1 ; I<n> ]\tSet color I<n> as the underline color\n"
1956 msgstr ""
1957
1958 #. type: tbl table
1959 #: build/C/man4/console_codes.4:366
1960 #, no-wrap
1961 msgid "ESC [ 2 ; I<n> ]\tSet color I<n> as the dim color\n"
1962 msgstr ""
1963
1964 #. type: tbl table
1965 #: build/C/man4/console_codes.4:367
1966 #, no-wrap
1967 msgid "ESC [ 8 ]       \tMake the current color pair the default attributes.\n"
1968 msgstr ""
1969
1970 #. type: tbl table
1971 #: build/C/man4/console_codes.4:368
1972 #, no-wrap
1973 msgid "ESC [ 9 ; I<n> ]\tSet screen blank timeout to I<n> minutes.\n"
1974 msgstr ""
1975
1976 #. type: tbl table
1977 #: build/C/man4/console_codes.4:369
1978 #, no-wrap
1979 msgid "ESC [ 10 ; I<n> ]\tSet bell frequency in Hz.\n"
1980 msgstr ""
1981
1982 #. type: tbl table
1983 #: build/C/man4/console_codes.4:370
1984 #, no-wrap
1985 msgid "ESC [ 11 ; I<n> ]\tSet bell duration in msec.\n"
1986 msgstr ""
1987
1988 #. type: tbl table
1989 #: build/C/man4/console_codes.4:371
1990 #, no-wrap
1991 msgid "ESC [ 12 ; I<n> ]\tBring specified console to the front.\n"
1992 msgstr ""
1993
1994 #. type: tbl table
1995 #: build/C/man4/console_codes.4:372
1996 #, no-wrap
1997 msgid "ESC [ 13 ]      \tUnblank the screen.\n"
1998 msgstr ""
1999
2000 #. type: tbl table
2001 #: build/C/man4/console_codes.4:373
2002 #, no-wrap
2003 msgid "ESC [ 14 ; I<n> ]   \tSet the VESA powerdown interval in minutes.\n"
2004 msgstr ""
2005
2006 #. type: SS
2007 #: build/C/man4/console_codes.4:375
2008 #, no-wrap
2009 msgid "Character Sets"
2010 msgstr ""
2011
2012 #. type: Plain text
2013 #: build/C/man4/console_codes.4:380
2014 msgid ""
2015 "The kernel knows about 4 translations of bytes into console-screen symbols.  "
2016 "The four tables are: a) Latin1 -E<gt> PC, b) VT100 graphics -E<gt> PC, c) PC "
2017 "-E<gt> PC, d) user-defined."
2018 msgstr ""
2019
2020 #. type: Plain text
2021 #: build/C/man4/console_codes.4:386
2022 msgid ""
2023 "There are two character sets, called G0 and G1, and one of them is the "
2024 "current character set.  (Initially G0.)  Typing B<^N> causes G1 to become "
2025 "current, B<^O> causes G0 to become current."
2026 msgstr ""
2027
2028 #. type: Plain text
2029 #: build/C/man4/console_codes.4:394
2030 msgid ""
2031 "These variables G0 and G1 point at a translation table, and can be changed "
2032 "by the user.  Initially they point at tables a) and b), respectively.  The "
2033 "sequences ESC ( B and ESC ( 0 and ESC ( U and ESC ( K cause G0 to point at "
2034 "translation table a), b), c) and d), respectively.  The sequences ESC ) B "
2035 "and ESC ) 0 and ESC ) U and ESC ) K cause G1 to point at translation table "
2036 "a), b), c) and d), respectively."
2037 msgstr ""
2038
2039 #. type: Plain text
2040 #: build/C/man4/console_codes.4:404
2041 msgid ""
2042 "The sequence ESC c causes a terminal reset, which is what you want if the "
2043 "screen is all garbled.  The oft-advised \"echo ^V^O\" will only make G0 "
2044 "current, but there is no guarantee that G0 points at table a).  In some "
2045 "distributions there is a program B<reset>(1)  that just does \"echo ^[c\".  "
2046 "If your terminfo entry for the console is correct (and has an entry "
2047 "rs1=\\eEc), then \"tput reset\" will also work."
2048 msgstr ""
2049
2050 #. type: Plain text
2051 #: build/C/man4/console_codes.4:412
2052 msgid ""
2053 "The user-defined mapping table can be set using B<mapscrn>(8).  The result "
2054 "of the mapping is that if a symbol c is printed, the symbol s = map[c] is "
2055 "sent to the video memory.  The bitmap that corresponds to s is found in the "
2056 "character ROM, and can be changed using B<setfont>(8)."
2057 msgstr ""
2058
2059 #. type: SS
2060 #: build/C/man4/console_codes.4:412
2061 #, no-wrap
2062 msgid "Mouse Tracking"
2063 msgstr ""
2064
2065 #. type: Plain text
2066 #: build/C/man4/console_codes.4:424
2067 msgid ""
2068 "The mouse tracking facility is intended to return B<xterm>(1)-compatible "
2069 "mouse status reports.  Because the console driver has no way to know the "
2070 "device or type of the mouse, these reports are returned in the console input "
2071 "stream only when the virtual terminal driver receives a mouse update ioctl.  "
2072 "These ioctls must be generated by a mouse-aware user-mode application such "
2073 "as the B<gpm>(8)  daemon."
2074 msgstr ""
2075
2076 #. type: Plain text
2077 #: build/C/man4/console_codes.4:430
2078 msgid ""
2079 "The mouse tracking escape sequences generated by B<xterm>(1) encode numeric "
2080 "parameters in a single character as I<value>+040.  For example, \\(aq!\\(aq "
2081 "is 1.  The screen coordinate system is 1-based."
2082 msgstr ""
2083
2084 #. type: Plain text
2085 #: build/C/man4/console_codes.4:440
2086 msgid ""
2087 "The X10 compatibility mode sends an escape sequence on button press encoding "
2088 "the location and the mouse button pressed.  It is enabled by sending ESC [ ? "
2089 "9 h and disabled with ESC [ ? 9 l.  On button press, B<xterm>(1) sends ESC [ "
2090 "M I<bxy> (6 characters).  Here I<b> is button-1, and I<x> and I<y> are the x "
2091 "and y coordinates of the mouse when the button was pressed.  This is the "
2092 "same code the kernel also produces."
2093 msgstr ""
2094
2095 #. type: Plain text
2096 #: build/C/man4/console_codes.4:455
2097 msgid ""
2098 "Normal tracking mode (not implemented in Linux 2.0.24) sends an escape "
2099 "sequence on both button press and release.  Modifier information is also "
2100 "sent.  It is enabled by sending ESC [ ? 1000 h and disabled with ESC [ ? "
2101 "1000 l.  On button press or release, B<xterm>(1) sends ESC [ M I<bxy>.  The "
2102 "low two bits of I<b> encode button information: 0=MB1 pressed, 1=MB2 "
2103 "pressed, 2=MB3 pressed, 3=release.  The upper bits encode what modifiers "
2104 "were down when the button was pressed and are added together: 4=Shift, "
2105 "8=Meta, 16=Control.  Again I<x> and I<y> are the x and y coordinates of the "
2106 "mouse event.  The upper left corner is (1,1)."
2107 msgstr ""
2108
2109 #. type: SS
2110 #: build/C/man4/console_codes.4:455
2111 #, no-wrap
2112 msgid "Comparisons With Other Terminals"
2113 msgstr ""
2114
2115 #. type: Plain text
2116 #: build/C/man4/console_codes.4:462
2117 msgid ""
2118 "Many different terminal types are described, like the Linux console, as "
2119 "being \"VT100-compatible\".  Here we discuss differences between the Linux "
2120 "console and the two most important others, the DEC VT102 and B<xterm>(1)."
2121 msgstr ""
2122
2123 #. type: Plain text
2124 #: build/C/man4/console_codes.4:464
2125 msgid "B<Control-character handling>"
2126 msgstr ""
2127
2128 #. type: Plain text
2129 #: build/C/man4/console_codes.4:466
2130 msgid "The VT102 also recognized the following control characters:"
2131 msgstr ""
2132
2133 #. type: Plain text
2134 #: build/C/man4/console_codes.4:468
2135 msgid "NUL (0x00) was ignored;"
2136 msgstr ""
2137
2138 #. type: Plain text
2139 #: build/C/man4/console_codes.4:470
2140 msgid "ENQ (0x05) triggered an answerback message;"
2141 msgstr ""
2142
2143 #. type: Plain text
2144 #: build/C/man4/console_codes.4:472
2145 msgid "DC1 (0x11, B<^Q>, XON) resumed transmission;"
2146 msgstr ""
2147
2148 #. type: Plain text
2149 #: build/C/man4/console_codes.4:475
2150 msgid ""
2151 "DC3 (0x13, B<^S>, XOFF) caused VT100 to ignore (and stop transmitting)  all "
2152 "codes except XOFF and XON."
2153 msgstr ""
2154
2155 #. type: Plain text
2156 #: build/C/man4/console_codes.4:477
2157 msgid "VT100-like DC1/DC3 processing may be enabled by the tty driver."
2158 msgstr ""
2159
2160 #. type: Plain text
2161 #: build/C/man4/console_codes.4:483
2162 msgid ""
2163 "The B<xterm>(1)  program (in VT100 mode) recognizes the control characters "
2164 "BEL, BS, HT, LF, VT, FF, CR, SO, SI, ESC."
2165 msgstr ""
2166
2167 #. type: Plain text
2168 #: build/C/man4/console_codes.4:485
2169 msgid "B<Escape sequences>"
2170 msgstr ""
2171
2172 #. type: Plain text
2173 #: build/C/man4/console_codes.4:487
2174 msgid "VT100 console sequences not implemented on the Linux console:"
2175 msgstr ""
2176
2177 #. type: tbl table
2178 #: build/C/man4/console_codes.4:489
2179 #, no-wrap
2180 msgid "ESC N\tSS2\tSingle shift 2. (Select G2 character set for the next\n"
2181 msgstr ""
2182
2183 #. type: tbl table
2184 #: build/C/man4/console_codes.4:490 build/C/man4/console_codes.4:492
2185 #, no-wrap
2186 msgid "\t\tcharacter only.)\n"
2187 msgstr ""
2188
2189 #. type: tbl table
2190 #: build/C/man4/console_codes.4:491
2191 #, no-wrap
2192 msgid "ESC O\tSS3\tSingle shift 3. (Select G3 character set for the next\n"
2193 msgstr ""
2194
2195 #. type: tbl table
2196 #: build/C/man4/console_codes.4:493
2197 #, no-wrap
2198 msgid "ESC P\tDCS\tDevice control string (ended by ESC \\e)\n"
2199 msgstr ""
2200
2201 #. type: tbl table
2202 #: build/C/man4/console_codes.4:494
2203 #, no-wrap
2204 msgid "ESC X\tSOS\tStart of string.\n"
2205 msgstr ""
2206
2207 #. type: tbl table
2208 #: build/C/man4/console_codes.4:495
2209 #, no-wrap
2210 msgid "ESC ^\tPM\tPrivacy message (ended by ESC \\e)\n"
2211 msgstr ""
2212
2213 #. type: tbl table
2214 #: build/C/man4/console_codes.4:496
2215 #, no-wrap
2216 msgid "ESC \\e\tST\tString terminator\n"
2217 msgstr ""
2218
2219 #. type: tbl table
2220 #: build/C/man4/console_codes.4:497
2221 #, no-wrap
2222 msgid "ESC * ...\t\tDesignate G2 character set\n"
2223 msgstr ""
2224
2225 #. type: tbl table
2226 #: build/C/man4/console_codes.4:498
2227 #, no-wrap
2228 msgid "ESC + ...\t\tDesignate G3 character set\n"
2229 msgstr ""
2230
2231 #. type: Plain text
2232 #: build/C/man4/console_codes.4:511
2233 msgid ""
2234 "The program B<xterm>(1)  (in VT100 mode) recognizes ESC c, ESC # 8, ESC "
2235 "E<gt>, ESC =, ESC D, ESC E, ESC H, ESC M, ESC N, ESC O, ESC P ... ESC \\e, "
2236 "ESC Z (it answers ESC [ ? 1 ; 2 c, \"I am a VT100 with advanced video "
2237 "option\")  and ESC ^ ... ESC \\e with the same meanings as indicated above.  "
2238 "It accepts ESC (, ESC ), ESC *, ESC + followed by 0, A, B for the DEC "
2239 "special character and line drawing set, UK, and US-ASCII, respectively."
2240 msgstr ""
2241
2242 #. type: Plain text
2243 #: build/C/man4/console_codes.4:515
2244 msgid ""
2245 "The user can configure B<xterm>(1) to respond to VT220-specific control "
2246 "sequences, and it will identify itself as a VT52, VT100, and up depending on "
2247 "the way it is configured and initialized."
2248 msgstr ""
2249
2250 #. type: Plain text
2251 #: build/C/man4/console_codes.4:520
2252 msgid ""
2253 "It accepts ESC ] (OSC) for the setting of certain resources.  In addition to "
2254 "the ECMA-48 string terminator (ST), B<xterm>(1) accepts a BEL to terminate "
2255 "an OSC string.  These are a few of the OSC control sequences recognized by "
2256 "B<xterm>(1):"
2257 msgstr ""
2258
2259 #. type: tbl table
2260 #: build/C/man4/console_codes.4:522
2261 #, no-wrap
2262 msgid "ESC ] 0 ; I<txt> ST\tSet icon name and window title to I<txt>.\n"
2263 msgstr ""
2264
2265 #. type: tbl table
2266 #: build/C/man4/console_codes.4:523
2267 #, no-wrap
2268 msgid "ESC ] 1 ; I<txt> ST\tSet icon name to I<txt>.\n"
2269 msgstr ""
2270
2271 #. type: tbl table
2272 #: build/C/man4/console_codes.4:524
2273 #, no-wrap
2274 msgid "ESC ] 2 ; I<txt> ST\tSet window title to I<txt>.\n"
2275 msgstr ""
2276
2277 #. type: tbl table
2278 #: build/C/man4/console_codes.4:525
2279 #, no-wrap
2280 msgid "ESC ] 4 ; I<num>; I<txt> ST\tSet ANSI color I<num> to I<txt>.\n"
2281 msgstr ""
2282
2283 #. type: tbl table
2284 #: build/C/man4/console_codes.4:526
2285 #, no-wrap
2286 msgid "ESC ] 10 ; I<txt> ST\tSet dynamic text color to I<txt>.\n"
2287 msgstr ""
2288
2289 #. type: tbl table
2290 #: build/C/man4/console_codes.4:527
2291 #, no-wrap
2292 msgid "ESC ] 4 6 ; I<name> ST\tChange log file to I<name> (normally disabled\n"
2293 msgstr ""
2294
2295 #. type: tbl table
2296 #: build/C/man4/console_codes.4:528
2297 #, no-wrap
2298 msgid "\tby a compile-time option)\n"
2299 msgstr ""
2300
2301 #. type: tbl table
2302 #: build/C/man4/console_codes.4:529
2303 #, no-wrap
2304 msgid "ESC ] 5 0 ; I<fn> ST\tSet font to I<fn>.\n"
2305 msgstr ""
2306
2307 #. type: Plain text
2308 #: build/C/man4/console_codes.4:534
2309 msgid ""
2310 "It recognizes the following with slightly modified meaning (saving more "
2311 "state, behaving closer to VT100/VT220):"
2312 msgstr ""
2313
2314 #. type: tbl table
2315 #: build/C/man4/console_codes.4:536
2316 #, no-wrap
2317 msgid "ESC 7  DECSC\tSave cursor\n"
2318 msgstr ""
2319
2320 #. type: tbl table
2321 #: build/C/man4/console_codes.4:537
2322 #, no-wrap
2323 msgid "ESC 8  DECRC\tRestore cursor\n"
2324 msgstr ""
2325
2326 #. type: Plain text
2327 #: build/C/man4/console_codes.4:541
2328 msgid "It also recognizes"
2329 msgstr ""
2330
2331 #. type: tbl table
2332 #: build/C/man4/console_codes.4:543
2333 #, no-wrap
2334 msgid "ESC F\t\tCursor to lower left corner of screen (if enabled by\n"
2335 msgstr ""
2336
2337 #. type: tbl table
2338 #: build/C/man4/console_codes.4:544
2339 #, no-wrap
2340 msgid "\t\tB<xterm>(1)'s B<hpLowerleftBugCompat> resource)\n"
2341 msgstr ""
2342
2343 #. type: tbl table
2344 #: build/C/man4/console_codes.4:545
2345 #, no-wrap
2346 msgid "ESC l\t\tMemory lock (per HP terminals).\n"
2347 msgstr ""
2348
2349 #. type: tbl table
2350 #: build/C/man4/console_codes.4:546
2351 #, no-wrap
2352 msgid "\t\tLocks memory above the cursor.\n"
2353 msgstr ""
2354
2355 #. type: tbl table
2356 #: build/C/man4/console_codes.4:547
2357 #, no-wrap
2358 msgid "ESC m\t\tMemory unlock (per HP terminals).\n"
2359 msgstr ""
2360
2361 #. type: tbl table
2362 #: build/C/man4/console_codes.4:548
2363 #, no-wrap
2364 msgid "ESC n\tLS2\tInvoke the G2 character set.\n"
2365 msgstr ""
2366
2367 #. type: tbl table
2368 #: build/C/man4/console_codes.4:549
2369 #, no-wrap
2370 msgid "ESC o\tLS3\tInvoke the G3 character set.\n"
2371 msgstr ""
2372
2373 #. type: tbl table
2374 #: build/C/man4/console_codes.4:550
2375 #, no-wrap
2376 msgid "ESC |\tLS3R\tInvoke the G3 character set as GR.\n"
2377 msgstr ""
2378
2379 #. type: tbl table
2380 #: build/C/man4/console_codes.4:551
2381 #, no-wrap
2382 msgid "ESC }\tLS2R\tInvoke the G2 character set as GR.\n"
2383 msgstr ""
2384
2385 #. type: tbl table
2386 #: build/C/man4/console_codes.4:552
2387 #, no-wrap
2388 msgid "ESC ~\tLS1R\tInvoke the G1 character set as GR.\n"
2389 msgstr ""
2390
2391 #. type: Plain text
2392 #: build/C/man4/console_codes.4:558
2393 msgid ""
2394 "It also recognizes ESC % and provides a more complete UTF-8 implementation "
2395 "than Linux console."
2396 msgstr ""
2397
2398 #. type: Plain text
2399 #: build/C/man4/console_codes.4:560
2400 msgid "B<CSI Sequences>"
2401 msgstr ""
2402
2403 #. type: Plain text
2404 #: build/C/man4/console_codes.4:574
2405 msgid ""
2406 "Old versions of B<xterm>(1), for example, from X11R5, interpret the blink "
2407 "SGR as a bold SGR.  Later versions which implemented ANSI colors, for "
2408 "example, XFree86 3.1.2A in 1995, improved this by allowing the blink "
2409 "attribute to be displayed as a color.  Modern versions of xterm implement "
2410 "blink SGR as blinking text and still allow colored text as an alternate "
2411 "rendering of SGRs.  Stock X11R6 versions did not recognize the color-setting "
2412 "SGRs until the X11R6.8 release, which incorporated XFree86 xterm.  All "
2413 "ECMA-48 CSI sequences recognized by Linux are also recognized by I<xterm>, "
2414 "however B<xterm>(1) implements several ECMA-48 and DEC control sequences not "
2415 "recognized by Linux."
2416 msgstr ""
2417
2418 #. type: Plain text
2419 #: build/C/man4/console_codes.4:588
2420 msgid ""
2421 "The B<xterm>(1)  program recognizes all of the DEC Private Mode sequences "
2422 "listed above, but none of the Linux private-mode sequences.  For discussion "
2423 "of B<xterm>(1)'s own private-mode sequences, refer to the I<Xterm Control "
2424 "Sequences> document by Edward Moy, Stephen Gildea, and Thomas E. Dickey "
2425 "available with the X distribution.  That document, though terse, is much "
2426 "longer than this manual page.  For a chronological overview,"
2427 msgstr ""
2428
2429 #. type: Plain text
2430 #: build/C/man4/console_codes.4:591
2431 msgid "http://invisible-island.net/xterm/xterm.log.html"
2432 msgstr ""
2433
2434 #. type: Plain text
2435 #: build/C/man4/console_codes.4:594
2436 msgid "details changes to xterm."
2437 msgstr ""
2438
2439 #. type: Plain text
2440 #: build/C/man4/console_codes.4:596
2441 msgid "The I<vttest> program"
2442 msgstr ""
2443
2444 #. type: Plain text
2445 #: build/C/man4/console_codes.4:599
2446 msgid "http://invisible-island.net/vttest/"
2447 msgstr ""
2448
2449 #. type: Plain text
2450 #: build/C/man4/console_codes.4:604
2451 msgid ""
2452 "demonstrates many of these control sequences.  The B<xterm>(1) source "
2453 "distribution also contains sample scripts which exercise other features."
2454 msgstr ""
2455
2456 #. type: SH
2457 #: build/C/man4/console_codes.4:604 build/C/man4/console_ioctl.4:591 build/C/man5/core.5:276 build/C/man4/cpuid.4:60 build/C/man4/fd.4:196 build/C/man7/fifo.7:51 build/C/man4/initrd.4:428 build/C/man3/makedev.3:70 build/C/man2/mknod.2:177 build/C/man4/msr.4:45 build/C/man4/null.4:49 build/C/man4/st.4:890 build/C/man3/stdarg.3:220 build/C/man2/syslog.2:260 build/C/man3/syslog.3:289 build/C/man7/uri.7:585
2458 #, no-wrap
2459 msgid "NOTES"
2460 msgstr ""
2461
2462 #. type: Plain text
2463 #: build/C/man4/console_codes.4:607
2464 msgid "ESC 8 (DECRC) is not able to restore the character set changed with ESC %."
2465 msgstr ""
2466
2467 #. type: SH
2468 #: build/C/man4/console_codes.4:607 build/C/man4/sk98lin.4:596 build/C/man3/stdarg.3:256 build/C/man7/uri.7:666
2469 #, no-wrap
2470 msgid "BUGS"
2471 msgstr ""
2472
2473 #. type: Plain text
2474 #: build/C/man4/console_codes.4:610
2475 msgid "In 2.0.23, CSI is broken, and NUL is not ignored inside escape sequences."
2476 msgstr ""
2477
2478 #. type: Plain text
2479 #: build/C/man4/console_codes.4:619
2480 msgid ""
2481 "Some older kernel versions (after 2.0) interpret 8-bit control sequences.  "
2482 "These \"C1 controls\" use codes between 128 and 159 to replace ESC [, ESC ] "
2483 "and similar two-byte control sequence initiators.  There are fragments of "
2484 "that in modern kernels (either overlooked or broken by changes to support "
2485 "UTF-8), but the implementation is incomplete and should be regarded as "
2486 "unreliable."
2487 msgstr ""
2488
2489 #. type: Plain text
2490 #: build/C/man4/console_codes.4:634
2491 msgid ""
2492 "Linux \"private mode\" sequences do not follow the rules in ECMA-48 for "
2493 "private mode control sequences.  In particular, those ending with ] do not "
2494 "use a standard terminating character.  The OSC (set palette) sequence is a "
2495 "greater problem, since B<xterm>(1) may interpret this as a control sequence "
2496 "which requires a string terminator (ST).  Unlike the B<setterm>(1) sequences "
2497 "which will be ignored (since they are invalid control sequences), the "
2498 "palette sequence will make B<xterm>(1) appear to hang (though pressing the "
2499 "return-key will fix that).  To accommodate applications which have been "
2500 "hardcoded to use Linux control sequences, set the B<xterm>(1) resource "
2501 "B<brokenLinuxOSC> to true."
2502 msgstr ""
2503
2504 #. type: Plain text
2505 #: build/C/man4/console_codes.4:638
2506 msgid ""
2507 "An older version of this document implied that Linux recognizes the ECMA-48 "
2508 "control sequence for invisible text.  It is ignored."
2509 msgstr ""
2510
2511 #. type: Plain text
2512 #: build/C/man4/console_codes.4:642
2513 msgid "B<console>(4), B<console_ioctl>(4), B<charsets>(7)"
2514 msgstr ""
2515
2516 #. type: TH
2517 #: build/C/man4/console_ioctl.4:39
2518 #, no-wrap
2519 msgid "CONSOLE_IOCTL"
2520 msgstr ""
2521
2522 #. type: TH
2523 #: build/C/man4/console_ioctl.4:39
2524 #, no-wrap
2525 msgid "2009-02-28"
2526 msgstr ""
2527
2528 #. type: Plain text
2529 #: build/C/man4/console_ioctl.4:42
2530 msgid "console_ioctl - ioctl's for console terminal and virtual consoles"
2531 msgstr ""
2532
2533 #. type: Plain text
2534 #: build/C/man4/console_ioctl.4:47
2535 msgid ""
2536 "The following Linux-specific B<ioctl>(2)  requests are supported.  Each "
2537 "requires a third argument, assumed here to be I<argp>."
2538 msgstr ""
2539
2540 #. type: IP
2541 #: build/C/man4/console_ioctl.4:47
2542 #, no-wrap
2543 msgid "B<KDGETLED>"
2544 msgstr ""
2545
2546 #. type: Plain text
2547 #: build/C/man4/console_ioctl.4:52
2548 msgid ""
2549 "Get state of LEDs.  I<argp> points to a I<char>.  The lower three bits of "
2550 "I<*argp> are set to the state of the LEDs, as follows:"
2551 msgstr ""
2552
2553 #. type: Plain text
2554 #: build/C/man4/console_ioctl.4:56
2555 #, no-wrap
2556 msgid ""
2557 "    LED_CAP       0x04   caps lock led\n"
2558 "    LEC_NUM       0x02   num lock led\n"
2559 "    LED_SCR       0x01   scroll lock led\n"
2560 msgstr ""
2561
2562 #. type: IP
2563 #: build/C/man4/console_ioctl.4:56
2564 #, no-wrap
2565 msgid "B<KDSETLED>"
2566 msgstr ""
2567
2568 #. type: Plain text
2569 #: build/C/man4/console_ioctl.4:63
2570 msgid ""
2571 "Set the LEDs.  The LEDs are set to correspond to the lower three bits of "
2572 "I<argp>.  However, if a higher order bit is set, the LEDs revert to normal: "
2573 "displaying the state of the keyboard functions of caps lock, num lock, and "
2574 "scroll lock."
2575 msgstr ""
2576
2577 #. type: Plain text
2578 #: build/C/man4/console_ioctl.4:70
2579 msgid ""
2580 "Before 1.1.54, the LEDs just reflected the state of the corresponding "
2581 "keyboard flags, and KDGETLED/KDSETLED would also change the keyboard flags.  "
2582 "Since 1.1.54 the leds can be made to display arbitrary information, but by "
2583 "default they display the keyboard flags.  The following two ioctl's are used "
2584 "to access the keyboard flags."
2585 msgstr ""
2586
2587 #. type: IP
2588 #: build/C/man4/console_ioctl.4:70
2589 #, no-wrap
2590 msgid "B<KDGKBLED>"
2591 msgstr ""
2592
2593 #. type: Plain text
2594 #: build/C/man4/console_ioctl.4:77
2595 msgid ""
2596 "Get keyboard flags CapsLock, NumLock, ScrollLock (not lights).  I<argp> "
2597 "points to a char which is set to the flag state.  The low order three bits "
2598 "(mask 0x7) get the current flag state, and the low order bits of the next "
2599 "nibble (mask 0x70) get the default flag state.  (Since 1.1.54.)"
2600 msgstr ""
2601
2602 #. type: IP
2603 #: build/C/man4/console_ioctl.4:77
2604 #, no-wrap
2605 msgid "B<KDSKBLED>"
2606 msgstr ""
2607
2608 #. type: Plain text
2609 #: build/C/man4/console_ioctl.4:84
2610 msgid ""
2611 "Set keyboard flags CapsLock, NumLock, ScrollLock (not lights).  I<argp> has "
2612 "the desired flag state.  The low order three bits (mask 0x7) have the flag "
2613 "state, and the low order bits of the next nibble (mask 0x70) have the "
2614 "default flag state.  (Since 1.1.54.)"
2615 msgstr ""
2616
2617 #. type: IP
2618 #: build/C/man4/console_ioctl.4:84
2619 #, no-wrap
2620 msgid "B<KDGKBTYPE>"
2621 msgstr ""
2622
2623 #. type: Plain text
2624 #: build/C/man4/console_ioctl.4:87
2625 msgid "Get keyboard type.  This returns the value KB_101, defined as 0x02."
2626 msgstr ""
2627
2628 #. type: IP
2629 #: build/C/man4/console_ioctl.4:87
2630 #, no-wrap
2631 msgid "B<KDADDIO>"
2632 msgstr ""
2633
2634 #. type: Plain text
2635 #: build/C/man4/console_ioctl.4:90
2636 msgid "Add I/O port as valid.  Equivalent to I<ioperm(arg,1,1)>."
2637 msgstr ""
2638
2639 #. type: IP
2640 #: build/C/man4/console_ioctl.4:90
2641 #, no-wrap
2642 msgid "B<KDDELIO>"
2643 msgstr ""
2644
2645 #. type: Plain text
2646 #: build/C/man4/console_ioctl.4:93
2647 msgid "Delete I/O port as valid.  Equivalent to I<ioperm(arg,1,0)>."
2648 msgstr ""
2649
2650 #. type: IP
2651 #: build/C/man4/console_ioctl.4:93
2652 #, no-wrap
2653 msgid "B<KDENABIO>"
2654 msgstr ""
2655
2656 #. type: Plain text
2657 #: build/C/man4/console_ioctl.4:96
2658 msgid ""
2659 "Enable I/O to video board.  Equivalent to I<ioperm(0x3b4, 0x3df-0x3b4+1, "
2660 "1)>."
2661 msgstr ""
2662
2663 #. type: IP
2664 #: build/C/man4/console_ioctl.4:96
2665 #, no-wrap
2666 msgid "B<KDDISABIO>"
2667 msgstr ""
2668
2669 #. type: Plain text
2670 #: build/C/man4/console_ioctl.4:99
2671 msgid ""
2672 "Disable I/O to video board.  Equivalent to I<ioperm(0x3b4, 0x3df-0x3b4+1, "
2673 "0)>."
2674 msgstr ""
2675
2676 #. type: IP
2677 #: build/C/man4/console_ioctl.4:99
2678 #, no-wrap
2679 msgid "B<KDSETMODE>"
2680 msgstr ""
2681
2682 #. type: Plain text
2683 #: build/C/man4/console_ioctl.4:102
2684 msgid "Set text/graphics mode.  I<argp> is one of these:"
2685 msgstr ""
2686
2687 #. type: Plain text
2688 #: build/C/man4/console_ioctl.4:105
2689 #, no-wrap
2690 msgid ""
2691 "    KD_TEXT       0x00\n"
2692 "    KD_GRAPHICS   0x01\n"
2693 msgstr ""
2694
2695 #. type: IP
2696 #: build/C/man4/console_ioctl.4:105
2697 #, no-wrap
2698 msgid "B<KDGETMODE>"
2699 msgstr ""
2700
2701 #. type: Plain text
2702 #: build/C/man4/console_ioctl.4:109
2703 msgid ""
2704 "Get text/graphics mode.  I<argp> points to a I<long> which is set to one of "
2705 "the above values."
2706 msgstr ""
2707
2708 #. type: IP
2709 #: build/C/man4/console_ioctl.4:109
2710 #, no-wrap
2711 msgid "B<KDMKTONE>"
2712 msgstr ""
2713
2714 #. type: Plain text
2715 #: build/C/man4/console_ioctl.4:118
2716 msgid ""
2717 "Generate tone of specified length.  The lower 16 bits of I<argp> specify the "
2718 "period in clock cycles, and the upper 16 bits give the duration in msec.  If "
2719 "the duration is zero, the sound is turned off.  Control returns "
2720 "immediately.  For example, I<argp> = (125E<lt>E<lt>16) + 0x637 would specify "
2721 "the beep normally associated with a ctrl-G.  (Thus since 0.99pl1; broken in "
2722 "2.1.49-50.)"
2723 msgstr ""
2724
2725 #. type: IP
2726 #: build/C/man4/console_ioctl.4:118
2727 #, no-wrap
2728 msgid "B<KIOCSOUND>"
2729 msgstr ""
2730
2731 #. type: Plain text
2732 #: build/C/man4/console_ioctl.4:125
2733 msgid ""
2734 "Start or stop sound generation.  The lower 16 bits of I<argp> specify the "
2735 "period in clock cycles (that is, I<argp> = 1193180/frequency).  I<argp> = 0 "
2736 "turns sound off.  In either case, control returns immediately."
2737 msgstr ""
2738
2739 #. type: IP
2740 #: build/C/man4/console_ioctl.4:125
2741 #, no-wrap
2742 msgid "B<GIO_CMAP>"
2743 msgstr ""
2744
2745 #. type: Plain text
2746 #: build/C/man4/console_ioctl.4:130
2747 msgid ""
2748 "Get the current default color map from kernel.  I<argp> points to a 48-byte "
2749 "array.  (Since 1.3.3.)"
2750 msgstr ""
2751
2752 #. type: IP
2753 #: build/C/man4/console_ioctl.4:130
2754 #, no-wrap
2755 msgid "B<PIO_CMAP>"
2756 msgstr ""
2757
2758 #. type: Plain text
2759 #: build/C/man4/console_ioctl.4:141
2760 msgid ""
2761 "Change the default text-mode color map.  I<argp> points to a 48-byte array "
2762 "which contains, in order, the Red, Green, and Blue values for the 16 "
2763 "available screen colors: 0 is off, and 255 is full intensity.  The default "
2764 "colors are, in order: black, dark red, dark green, brown, dark blue, dark "
2765 "purple, dark cyan, light grey, dark grey, bright red, bright green, yellow, "
2766 "bright blue, bright purple, bright cyan and white.  (Since 1.3.3.)"
2767 msgstr ""
2768
2769 #. type: IP
2770 #: build/C/man4/console_ioctl.4:141
2771 #, no-wrap
2772 msgid "B<GIO_FONT>"
2773 msgstr ""
2774
2775 #. type: Plain text
2776 #: build/C/man4/console_ioctl.4:147
2777 msgid ""
2778 "Gets 256-character screen font in expanded form.  I<argp> points to an 8192 "
2779 "byte array.  Fails with error code B<EINVAL> if the currently loaded font is "
2780 "a 512-character font, or if the console is not in text mode."
2781 msgstr ""
2782
2783 #. type: IP
2784 #: build/C/man4/console_ioctl.4:147
2785 #, no-wrap
2786 msgid "B<GIO_FONTX>"
2787 msgstr ""
2788
2789 #. type: Plain text
2790 #: build/C/man4/console_ioctl.4:160
2791 msgid ""
2792 "Gets screen font and associated information.  I<argp> points to a I<struct "
2793 "consolefontdesc> (see B<PIO_FONTX>).  On call, the I<charcount> field should "
2794 "be set to the maximum number of characters that would fit in the buffer "
2795 "pointed to by I<chardata>.  On return, the I<charcount> and I<charheight> "
2796 "are filled with the respective data for the currently loaded font, and the "
2797 "I<chardata> array contains the font data if the initial value of "
2798 "I<charcount> indicated enough space was available; otherwise the buffer is "
2799 "untouched and I<errno> is set to B<ENOMEM>.  (Since 1.3.1.)"
2800 msgstr ""
2801
2802 #. type: IP
2803 #: build/C/man4/console_ioctl.4:160
2804 #, no-wrap
2805 msgid "B<PIO_FONT>"
2806 msgstr ""
2807
2808 #. type: Plain text
2809 #: build/C/man4/console_ioctl.4:169
2810 msgid ""
2811 "Sets 256-character screen font.  Load font into the EGA/VGA character "
2812 "generator.  I<argp> points to a 8192 byte map, with 32 bytes per character.  "
2813 "Only first I<N> of them are used for an 8xI<N> font (0 E<lt> I<N> E<lt>= "
2814 "32).  This call also invalidates the Unicode mapping."
2815 msgstr ""
2816
2817 #. type: IP
2818 #: build/C/man4/console_ioctl.4:169
2819 #, no-wrap
2820 msgid "B<PIO_FONTX>"
2821 msgstr ""
2822
2823 #. type: Plain text
2824 #: build/C/man4/console_ioctl.4:173
2825 msgid "Sets screen font and associated rendering information.  I<argp> points to a"
2826 msgstr ""
2827
2828 #. type: Plain text
2829 #: build/C/man4/console_ioctl.4:184
2830 #, no-wrap
2831 msgid ""
2832 "struct consolefontdesc {\n"
2833 "    unsigned short charcount;  /* characters in font\n"
2834 "                                  (256 or 512) */\n"
2835 "    unsigned short charheight; /* scan lines per\n"
2836 "                                  character (1-32) */\n"
2837 "    char          *chardata;   /* font data in\n"
2838 "                                  expanded form */\n"
2839 "};\n"
2840 msgstr ""
2841
2842 #. type: Plain text
2843 #: build/C/man4/console_ioctl.4:191
2844 msgid ""
2845 "If necessary, the screen will be appropriately resized, and B<SIGWINCH> sent "
2846 "to the appropriate processes.  This call also invalidates the Unicode "
2847 "mapping.  (Since 1.3.1.)"
2848 msgstr ""
2849
2850 #. type: IP
2851 #: build/C/man4/console_ioctl.4:191
2852 #, no-wrap
2853 msgid "B<PIO_FONTRESET>"
2854 msgstr ""
2855
2856 #. type: Plain text
2857 #: build/C/man4/console_ioctl.4:197
2858 msgid ""
2859 "Resets the screen font, size and Unicode mapping to the bootup defaults.  "
2860 "I<argp> is unused, but should be set to NULL to ensure compatibility with "
2861 "future versions of Linux.  (Since 1.3.28.)"
2862 msgstr ""
2863
2864 #. type: IP
2865 #: build/C/man4/console_ioctl.4:197
2866 #, no-wrap
2867 msgid "B<GIO_SCRNMAP>"
2868 msgstr ""
2869
2870 #. type: Plain text
2871 #: build/C/man4/console_ioctl.4:204
2872 msgid ""
2873 "Get screen mapping from kernel.  I<argp> points to an area of size E_TABSZ, "
2874 "which is loaded with the font positions used to display each character.  "
2875 "This call is likely to return useless information if the currently loaded "
2876 "font is more than 256 characters."
2877 msgstr ""
2878
2879 #. type: IP
2880 #: build/C/man4/console_ioctl.4:204
2881 #, no-wrap
2882 msgid "B<GIO_UNISCRNMAP>"
2883 msgstr ""
2884
2885 #. type: Plain text
2886 #: build/C/man4/console_ioctl.4:212
2887 msgid ""
2888 "Get full Unicode screen mapping from kernel.  I<argp> points to an area of "
2889 "size E_TABSZ*sizeof(unsigned short), which is loaded with the Unicodes each "
2890 "character represent.  A special set of Unicodes, starting at U+F000, are "
2891 "used to represent \"direct to font\" mappings.  (Since 1.3.1.)"
2892 msgstr ""
2893
2894 #. type: IP
2895 #: build/C/man4/console_ioctl.4:212
2896 #, no-wrap
2897 msgid "B<PIO_SCRNMAP>"
2898 msgstr ""
2899
2900 #. type: Plain text
2901 #: build/C/man4/console_ioctl.4:217
2902 msgid ""
2903 "Loads the \"user definable\" (fourth) table in the kernel which maps bytes "
2904 "into console screen symbols.  I<argp> points to an area of size E_TABSZ."
2905 msgstr ""
2906
2907 #. type: IP
2908 #: build/C/man4/console_ioctl.4:217
2909 #, no-wrap
2910 msgid "B<PIO_UNISCRNMAP>"
2911 msgstr ""
2912
2913 #. type: Plain text
2914 #: build/C/man4/console_ioctl.4:224
2915 msgid ""
2916 "Loads the \"user definable\" (fourth) table in the kernel which maps bytes "
2917 "into Unicodes, which are then translated into screen symbols according to "
2918 "the currently loaded Unicode-to-font map.  Special Unicodes starting at "
2919 "U+F000 can be used to map directly to the font symbols.  (Since 1.3.1.)"
2920 msgstr ""
2921
2922 #. type: IP
2923 #: build/C/man4/console_ioctl.4:224
2924 #, no-wrap
2925 msgid "B<GIO_UNIMAP>"
2926 msgstr ""
2927
2928 #. type: Plain text
2929 #: build/C/man4/console_ioctl.4:227
2930 msgid "Get Unicode-to-font mapping from kernel.  I<argp> points to a"
2931 msgstr ""
2932
2933 #. type: Plain text
2934 #: build/C/man4/console_ioctl.4:234
2935 #, no-wrap
2936 msgid ""
2937 "struct unimapdesc {\n"
2938 "    unsigned short  entry_ct;\n"
2939 "    struct unipair *entries;\n"
2940 "};\n"
2941 msgstr ""
2942
2943 #. type: Plain text
2944 #: build/C/man4/console_ioctl.4:238
2945 msgid "where I<entries> points to an array of"
2946 msgstr ""
2947
2948 #. type: Plain text
2949 #: build/C/man4/console_ioctl.4:245
2950 #, no-wrap
2951 msgid ""
2952 "struct unipair {\n"
2953 "    unsigned short unicode;\n"
2954 "    unsigned short fontpos;\n"
2955 "};\n"
2956 msgstr ""
2957
2958 #. type: Plain text
2959 #: build/C/man4/console_ioctl.4:249 build/C/man4/console_ioctl.4:269
2960 msgid "(Since 1.1.92.)"
2961 msgstr ""
2962
2963 #. type: IP
2964 #: build/C/man4/console_ioctl.4:249
2965 #, no-wrap
2966 msgid "B<PIO_UNIMAP>"
2967 msgstr ""
2968
2969 #. type: Plain text
2970 #: build/C/man4/console_ioctl.4:254
2971 #, no-wrap
2972 msgid ""
2973 "Put unicode-to-font mapping in kernel.\n"
2974 "    I<argp> points to a\n"
2975 "I<struct unimapdesc>.\n"
2976 "(Since 1.1.92)\n"
2977 msgstr ""
2978
2979 #. type: IP
2980 #: build/C/man4/console_ioctl.4:254
2981 #, no-wrap
2982 msgid "B<PIO_UNIMAPCLR>"
2983 msgstr ""
2984
2985 #. type: Plain text
2986 #: build/C/man4/console_ioctl.4:257
2987 msgid "Clear table, possibly advise hash algorithm.  I<argp> points to a"
2988 msgstr ""
2989
2990 #. type: Plain text
2991 #: build/C/man4/console_ioctl.4:265
2992 #, no-wrap
2993 msgid ""
2994 "struct unimapinit {\n"
2995 "    unsigned short advised_hashsize;  /* 0 if no opinion */\n"
2996 "    unsigned short advised_hashstep;  /* 0 if no opinion */\n"
2997 "    unsigned short advised_hashlevel; /* 0 if no opinion */\n"
2998 "};\n"
2999 msgstr ""
3000
3001 #. type: IP
3002 #: build/C/man4/console_ioctl.4:269
3003 #, no-wrap
3004 msgid "B<KDGKBMODE>"
3005 msgstr ""
3006
3007 #. type: Plain text
3008 #: build/C/man4/console_ioctl.4:273
3009 msgid ""
3010 "Gets current keyboard mode.  I<argp> points to a I<long> which is set to one "
3011 "of these:"
3012 msgstr ""
3013
3014 #. type: Plain text
3015 #: build/C/man4/console_ioctl.4:278
3016 #, no-wrap
3017 msgid ""
3018 "    K_RAW         0x00\n"
3019 "    K_XLATE       0x01\n"
3020 "    K_MEDIUMRAW   0x02\n"
3021 "    K_UNICODE     0x03\n"
3022 msgstr ""
3023
3024 #. type: IP
3025 #: build/C/man4/console_ioctl.4:278
3026 #, no-wrap
3027 msgid "B<KDSKBMODE>"
3028 msgstr ""
3029
3030 #. type: Plain text
3031 #: build/C/man4/console_ioctl.4:281
3032 msgid ""
3033 "Sets current keyboard mode.  I<argp> is a I<long> equal to one of the above "
3034 "values."
3035 msgstr ""
3036
3037 #. type: IP
3038 #: build/C/man4/console_ioctl.4:281
3039 #, no-wrap
3040 msgid "B<KDGKBMETA>"
3041 msgstr ""
3042
3043 #. type: Plain text
3044 #: build/C/man4/console_ioctl.4:285
3045 msgid ""
3046 "Gets meta key handling mode.  I<argp> points to a I<long> which is set to "
3047 "one of these:"
3048 msgstr ""
3049
3050 #. type: Plain text
3051 #: build/C/man4/console_ioctl.4:288
3052 #, no-wrap
3053 msgid ""
3054 "    K_METABIT     0x03   set high order bit\n"
3055 "    K_ESCPREFIX   0x04   escape prefix\n"
3056 msgstr ""
3057
3058 #. type: IP
3059 #: build/C/man4/console_ioctl.4:288
3060 #, no-wrap
3061 msgid "B<KDSKBMETA>"
3062 msgstr ""
3063
3064 #. type: Plain text
3065 #: build/C/man4/console_ioctl.4:291
3066 msgid ""
3067 "Sets meta key handling mode.  I<argp> is a I<long> equal to one of the above "
3068 "values."
3069 msgstr ""
3070
3071 #. type: IP
3072 #: build/C/man4/console_ioctl.4:291
3073 #, no-wrap
3074 msgid "B<KDGKBENT>"
3075 msgstr ""
3076
3077 #. type: Plain text
3078 #: build/C/man4/console_ioctl.4:294
3079 msgid ""
3080 "Gets one entry in key translation table (keycode to action code).  I<argp> "
3081 "points to a"
3082 msgstr ""
3083
3084 #. type: Plain text
3085 #: build/C/man4/console_ioctl.4:302
3086 #, no-wrap
3087 msgid ""
3088 "struct kbentry {\n"
3089 "    unsigned char  kb_table;\n"
3090 "    unsigned char  kb_index;\n"
3091 "    unsigned short kb_value;\n"
3092 "};\n"
3093 msgstr ""
3094
3095 #. type: Plain text
3096 #: build/C/man4/console_ioctl.4:311
3097 msgid ""
3098 "with the first two members filled in: I<kb_table> selects the key table (0 "
3099 "E<lt>= I<kb_table> E<lt> MAX_NR_KEYMAPS), and I<kb_index> is the keycode (0 "
3100 "E<lt>= I<kb_index> E<lt> NR_KEYS).  I<kb_value> is set to the corresponding "
3101 "action code, or K_HOLE if there is no such key, or K_NOSUCHMAP if "
3102 "I<kb_table> is invalid."
3103 msgstr ""
3104
3105 #. type: IP
3106 #: build/C/man4/console_ioctl.4:311
3107 #, no-wrap
3108 msgid "B<KDSKBENT>"
3109 msgstr ""
3110
3111 #. type: Plain text
3112 #: build/C/man4/console_ioctl.4:315
3113 msgid "Sets one entry in translation table.  I<argp> points to a I<struct kbentry>."
3114 msgstr ""
3115
3116 #. type: IP
3117 #: build/C/man4/console_ioctl.4:315
3118 #, no-wrap
3119 msgid "B<KDGKBSENT>"
3120 msgstr ""
3121
3122 #. type: Plain text
3123 #: build/C/man4/console_ioctl.4:318
3124 msgid "Gets one function key string.  I<argp> points to a"
3125 msgstr ""
3126
3127 #. type: Plain text
3128 #: build/C/man4/console_ioctl.4:325
3129 #, no-wrap
3130 msgid ""
3131 "struct kbsentry {\n"
3132 "    unsigned char kb_func;\n"
3133 "    unsigned char kb_string[512];\n"
3134 "};\n"
3135 msgstr ""
3136
3137 #. type: Plain text
3138 #: build/C/man4/console_ioctl.4:330
3139 msgid ""
3140 "I<kb_string> is set to the (null-terminated) string corresponding to the "
3141 "I<kb_func>th function key action code."
3142 msgstr ""
3143
3144 #. type: IP
3145 #: build/C/man4/console_ioctl.4:330
3146 #, no-wrap
3147 msgid "B<KDSKBSENT>"
3148 msgstr ""
3149
3150 #. type: Plain text
3151 #: build/C/man4/console_ioctl.4:334
3152 msgid "Sets one function key string entry.  I<argp> points to a I<struct kbsentry>."
3153 msgstr ""
3154
3155 #. type: IP
3156 #: build/C/man4/console_ioctl.4:334
3157 #, no-wrap
3158 msgid "B<KDGKBDIACR>"
3159 msgstr ""
3160
3161 #. type: Plain text
3162 #: build/C/man4/console_ioctl.4:337
3163 msgid "Read kernel accent table.  I<argp> points to a"
3164 msgstr ""
3165
3166 #. type: Plain text
3167 #: build/C/man4/console_ioctl.4:344
3168 #, no-wrap
3169 msgid ""
3170 "struct kbdiacrs {\n"
3171 "    unsigned int   kb_cnt;\n"
3172 "    struct kbdiacr kbdiacr[256];\n"
3173 "};\n"
3174 msgstr ""
3175
3176 #. type: Plain text
3177 #: build/C/man4/console_ioctl.4:349
3178 msgid "where I<kb_cnt> is the number of entries in the array, each of which is a"
3179 msgstr ""
3180
3181 #. type: Plain text
3182 #: build/C/man4/console_ioctl.4:357
3183 #, no-wrap
3184 msgid ""
3185 "struct kbdiacr {\n"
3186 "    unsigned char diacr;\n"
3187 "    unsigned char base;\n"
3188 "    unsigned char result;\n"
3189 "};\n"
3190 msgstr ""
3191
3192 #. type: IP
3193 #: build/C/man4/console_ioctl.4:359
3194 #, no-wrap
3195 msgid "B<KDGETKEYCODE>"
3196 msgstr ""
3197
3198 #. type: Plain text
3199 #: build/C/man4/console_ioctl.4:362
3200 msgid "Read kernel keycode table entry (scan code to keycode).  I<argp> points to a"
3201 msgstr ""
3202
3203 #. type: Plain text
3204 #: build/C/man4/console_ioctl.4:369
3205 #, no-wrap
3206 msgid ""
3207 "struct kbkeycode {\n"
3208 "    unsigned int scancode;\n"
3209 "    unsigned int keycode;\n"
3210 "};\n"
3211 msgstr ""
3212
3213 #. type: Plain text
3214 #: build/C/man4/console_ioctl.4:376
3215 msgid ""
3216 "I<keycode> is set to correspond to the given I<scancode>.  (89 E<lt>= "
3217 "I<scancode> E<lt>= 255 only.  For 1 E<lt>= I<scancode> E<lt>= 88, "
3218 "I<keycode>==I<scancode>.)  (Since 1.1.63.)"
3219 msgstr ""
3220
3221 #. type: IP
3222 #: build/C/man4/console_ioctl.4:376
3223 #, no-wrap
3224 msgid "B<KDSETKEYCODE>"
3225 msgstr ""
3226
3227 #. type: Plain text
3228 #: build/C/man4/console_ioctl.4:381
3229 msgid ""
3230 "Write kernel keycode table entry.  I<argp> points to a I<struct kbkeycode>.  "
3231 "(Since 1.1.63.)"
3232 msgstr ""
3233
3234 #. type: IP
3235 #: build/C/man4/console_ioctl.4:381
3236 #, no-wrap
3237 msgid "B<KDSIGACCEPT>"
3238 msgstr ""
3239
3240 #. type: Plain text
3241 #: build/C/man4/console_ioctl.4:386
3242 msgid ""
3243 "The calling process indicates its willingness to accept the signal I<argp> "
3244 "when it is generated by pressing an appropriate key combination.  (1 E<lt>= "
3245 "I<argp> E<lt>= NSIG).  (See spawn_console() in "
3246 "linux/drivers/char/keyboard.c.)"
3247 msgstr ""
3248
3249 #. type: IP
3250 #: build/C/man4/console_ioctl.4:386
3251 #, no-wrap
3252 msgid "B<VT_OPENQRY>"
3253 msgstr ""
3254
3255 #. type: Plain text
3256 #: build/C/man4/console_ioctl.4:390
3257 msgid ""
3258 "Returns the first available (non-opened) console.  I<argp> points to an "
3259 "I<int> which is set to the number of the vt (1 E<lt>= I<*argp> E<lt>= "
3260 "MAX_NR_CONSOLES)."
3261 msgstr ""
3262
3263 #. type: IP
3264 #: build/C/man4/console_ioctl.4:390
3265 #, no-wrap
3266 msgid "B<VT_GETMODE>"
3267 msgstr ""
3268
3269 #. type: Plain text
3270 #: build/C/man4/console_ioctl.4:393
3271 msgid "Get mode of active vt.  I<argp> points to a"
3272 msgstr ""
3273
3274 #. type: Plain text
3275 #: build/C/man4/console_ioctl.4:403
3276 #, no-wrap
3277 msgid ""
3278 "struct vt_mode {\n"
3279 "    char  mode;    /* vt mode */\n"
3280 "    char  waitv;   /* if set, hang on writes if not active */\n"
3281 "    short relsig;  /* signal to raise on release req */\n"
3282 "    short acqsig;  /* signal to raise on acquisition */\n"
3283 "    short frsig;   /* unused (set to 0) */\n"
3284 "};\n"
3285 msgstr ""
3286
3287 #. type: Plain text
3288 #: build/C/man4/console_ioctl.4:408
3289 msgid ""
3290 "which is set to the mode of the active vt.  I<mode> is set to one of these "
3291 "values:"
3292 msgstr ""
3293
3294 #. type: Plain text
3295 #: build/C/man4/console_ioctl.4:412
3296 #, no-wrap
3297 msgid ""
3298 "    VT_AUTO       auto vt switching\n"
3299 "    VT_PROCESS    process controls switching\n"
3300 "    VT_ACKACQ     acknowledge switch\n"
3301 msgstr ""
3302
3303 #. type: IP
3304 #: build/C/man4/console_ioctl.4:412
3305 #, no-wrap
3306 msgid "B<VT_SETMODE>"
3307 msgstr ""
3308
3309 #. type: Plain text
3310 #: build/C/man4/console_ioctl.4:416
3311 msgid "Set mode of active vt.  I<argp> points to a I<struct vt_mode>."
3312 msgstr ""
3313
3314 #. type: IP
3315 #: build/C/man4/console_ioctl.4:416
3316 #, no-wrap
3317 msgid "B<VT_GETSTATE>"
3318 msgstr ""
3319
3320 #. type: Plain text
3321 #: build/C/man4/console_ioctl.4:419
3322 msgid "Get global vt state info.  I<argp> points to a"
3323 msgstr ""
3324
3325 #. type: Plain text
3326 #: build/C/man4/console_ioctl.4:427
3327 #, no-wrap
3328 msgid ""
3329 "struct vt_stat {\n"
3330 "    unsigned short v_active;  /* active vt */\n"
3331 "    unsigned short v_signal;  /* signal to send */\n"
3332 "    unsigned short v_state;   /* vt bit mask */\n"
3333 "};\n"
3334 msgstr ""
3335
3336 #. type: Plain text
3337 #: build/C/man4/console_ioctl.4:432
3338 msgid ""
3339 "For each vt in use, the corresponding bit in the I<v_state> member is set.  "
3340 "(Kernels 1.0 through 1.1.92.)"
3341 msgstr ""
3342
3343 #. type: IP
3344 #: build/C/man4/console_ioctl.4:432
3345 #, no-wrap
3346 msgid "B<VT_RELDISP>"
3347 msgstr ""
3348
3349 #. type: Plain text
3350 #: build/C/man4/console_ioctl.4:434
3351 msgid "Release a display."
3352 msgstr ""
3353
3354 #. type: IP
3355 #: build/C/man4/console_ioctl.4:434
3356 #, no-wrap
3357 msgid "B<VT_ACTIVATE>"
3358 msgstr ""
3359
3360 #. type: Plain text
3361 #: build/C/man4/console_ioctl.4:436
3362 msgid "Switch to vt I<argp> (1 E<lt>= I<argp> E<lt>= MAX_NR_CONSOLES)."
3363 msgstr ""
3364
3365 #. type: IP
3366 #: build/C/man4/console_ioctl.4:436
3367 #, no-wrap
3368 msgid "B<VT_WAITACTIVE>"
3369 msgstr ""
3370
3371 #. type: Plain text
3372 #: build/C/man4/console_ioctl.4:438
3373 msgid "Wait until vt I<argp> has been activated."
3374 msgstr ""
3375
3376 #. type: IP
3377 #: build/C/man4/console_ioctl.4:438
3378 #, no-wrap
3379 msgid "B<VT_DISALLOCATE>"
3380 msgstr ""
3381
3382 #. type: Plain text
3383 #: build/C/man4/console_ioctl.4:441
3384 msgid "Deallocate the memory associated with vt I<argp>.  (Since 1.1.54.)"
3385 msgstr ""
3386
3387 #. type: IP
3388 #: build/C/man4/console_ioctl.4:441
3389 #, no-wrap
3390 msgid "B<VT_RESIZE>"
3391 msgstr ""
3392
3393 #. type: Plain text
3394 #: build/C/man4/console_ioctl.4:444
3395 msgid "Set the kernel's idea of screensize.  I<argp> points to a"
3396 msgstr ""
3397
3398 #. type: Plain text
3399 #: build/C/man4/console_ioctl.4:452
3400 #, no-wrap
3401 msgid ""
3402 "struct vt_sizes {\n"
3403 "    unsigned short v_rows;       /* # rows */\n"
3404 "    unsigned short v_cols;       /* # columns */\n"
3405 "    unsigned short v_scrollsize; /* no longer used */\n"
3406 "};\n"
3407 msgstr ""
3408
3409 #. type: Plain text
3410 #: build/C/man4/console_ioctl.4:459
3411 msgid ""
3412 "Note that this does not change the videomode.  See B<resizecons>(8).  (Since "
3413 "1.1.54.)"
3414 msgstr ""
3415
3416 #. type: IP
3417 #: build/C/man4/console_ioctl.4:459
3418 #, no-wrap
3419 msgid "B<VT_RESIZEX>"
3420 msgstr ""
3421
3422 #. type: Plain text
3423 #: build/C/man4/console_ioctl.4:462
3424 msgid "Set the kernel's idea of various screen parameters.  I<argp> points to a"
3425 msgstr ""
3426
3427 #. type: Plain text
3428 #: build/C/man4/console_ioctl.4:477
3429 #, no-wrap
3430 msgid ""
3431 "struct vt_consize {\n"
3432 "    unsigned short v_rows;  /* number of rows */\n"
3433 "    unsigned short v_cols;  /* number of columns */\n"
3434 "    unsigned short v_vlin;  /* number of pixel rows\n"
3435 "                               on screen */\n"
3436 "    unsigned short v_clin;  /* number of pixel rows\n"
3437 "                               per character */\n"
3438 "    unsigned short v_vcol;  /* number of pixel columns\n"
3439 "                               on screen */\n"
3440 "    unsigned short v_ccol;  /* number of pixel columns\n"
3441 "                               per character */\n"
3442 "};\n"
3443 msgstr ""
3444
3445 #. type: Plain text
3446 #: build/C/man4/console_ioctl.4:486
3447 msgid ""
3448 "Any parameter may be set to zero, indicating \"no change\", but if multiple "
3449 "parameters are set, they must be self-consistent.  Note that this does not "
3450 "change the videomode.  See B<resizecons>(8).  (Since 1.3.3.)"
3451 msgstr ""
3452
3453 #. type: Plain text
3454 #: build/C/man4/console_ioctl.4:490
3455 msgid ""
3456 "The action of the following ioctls depends on the first byte in the struct "
3457 "pointed to by I<argp>, referred to here as the I<subcode>.  These are legal "
3458 "only for the superuser or the owner of the current tty."
3459 msgstr ""
3460
3461 #. type: IP
3462 #: build/C/man4/console_ioctl.4:490
3463 #, no-wrap
3464 msgid "B<TIOCLINUX, subcode=0>"
3465 msgstr ""
3466
3467 #. type: Plain text
3468 #: build/C/man4/console_ioctl.4:494
3469 msgid ""
3470 "Dump the screen.  Disappeared in 1.1.92.  (With kernel 1.1.92 or later, read "
3471 "from /dev/vcsN or /dev/vcsaN instead.)"
3472 msgstr ""
3473
3474 #. type: IP
3475 #: build/C/man4/console_ioctl.4:494
3476 #, no-wrap
3477 msgid "B<TIOCLINUX, subcode=1>"
3478 msgstr ""
3479
3480 #. type: Plain text
3481 #: build/C/man4/console_ioctl.4:497
3482 msgid "Get task information.  Disappeared in 1.1.92."
3483 msgstr ""
3484
3485 #. type: IP
3486 #: build/C/man4/console_ioctl.4:497
3487 #, no-wrap
3488 msgid "B<TIOCLINUX, subcode=2>"
3489 msgstr ""
3490
3491 #. type: Plain text
3492 #: build/C/man4/console_ioctl.4:500
3493 msgid "Set selection.  I<argp> points to a"
3494 msgstr ""
3495
3496 #. type: Plain text
3497 #: build/C/man4/console_ioctl.4:508
3498 #, no-wrap
3499 msgid ""
3500 "struct {\n"
3501 "   char  subcode;\n"
3502 "   short xs, ys, xe, ye;\n"
3503 "   short sel_mode;\n"
3504 "};\n"
3505 msgstr ""
3506
3507 #. type: Plain text
3508 #: build/C/man4/console_ioctl.4:520
3509 msgid ""
3510 "I<xs> and I<ys> are the starting column and row.  I<xe> and I<ye> are the "
3511 "ending column and row.  (Upper left corner is row=column=1.)  I<sel_mode> is "
3512 "0 for character-by-character selection, 1 for word-by-word selection, or 2 "
3513 "for line-by-line selection.  The indicated screen characters are highlighted "
3514 "and saved in the static array sel_buffer in devices/char/console.c."
3515 msgstr ""
3516
3517 #. type: IP
3518 #: build/C/man4/console_ioctl.4:520
3519 #, no-wrap
3520 msgid "B<TIOCLINUX, subcode=3>"
3521 msgstr ""
3522
3523 #. type: Plain text
3524 #: build/C/man4/console_ioctl.4:524
3525 msgid ""
3526 "Paste selection.  The characters in the selection buffer are written to "
3527 "I<fd>."
3528 msgstr ""
3529
3530 #. type: IP
3531 #: build/C/man4/console_ioctl.4:524
3532 #, no-wrap
3533 msgid "B<TIOCLINUX, subcode=4>"
3534 msgstr ""
3535
3536 #. type: Plain text
3537 #: build/C/man4/console_ioctl.4:526
3538 msgid "Unblank the screen."
3539 msgstr ""
3540
3541 #. type: IP
3542 #: build/C/man4/console_ioctl.4:526
3543 #, no-wrap
3544 msgid "B<TIOCLINUX, subcode=5>"
3545 msgstr ""
3546
3547 #. type: Plain text
3548 #: build/C/man4/console_ioctl.4:530
3549 msgid ""
3550 "Sets contents of a 256-bit look up table defining characters in a \"word\", "
3551 "for word-by-word selection.  (Since 1.1.32.)"
3552 msgstr ""
3553
3554 #. type: IP
3555 #: build/C/man4/console_ioctl.4:530
3556 #, no-wrap
3557 msgid "B<TIOCLINUX, subcode=6>"
3558 msgstr ""
3559
3560 #. type: Plain text
3561 #: build/C/man4/console_ioctl.4:534
3562 msgid ""
3563 "I<argp> points to a char which is set to the value of the kernel variable "
3564 "I<shift_state>.  (Since 1.1.32.)"
3565 msgstr ""
3566
3567 #. type: IP
3568 #: build/C/man4/console_ioctl.4:534
3569 #, no-wrap
3570 msgid "B<TIOCLINUX, subcode=7>"
3571 msgstr ""
3572
3573 #. type: Plain text
3574 #: build/C/man4/console_ioctl.4:538
3575 msgid ""
3576 "I<argp> points to a char which is set to the value of the kernel variable "
3577 "I<report_mouse>.  (Since 1.1.33.)"
3578 msgstr ""
3579
3580 #. type: IP
3581 #: build/C/man4/console_ioctl.4:538
3582 #, no-wrap
3583 msgid "B<TIOCLINUX, subcode=8>"
3584 msgstr ""
3585
3586 #. type: Plain text
3587 #: build/C/man4/console_ioctl.4:543
3588 msgid ""
3589 "Dump screen width and height, cursor position, and all the "
3590 "character-attribute pairs.  (Kernels 1.1.67 through 1.1.91 only.  With "
3591 "kernel 1.1.92 or later, read from /dev/vcsa* instead.)"
3592 msgstr ""
3593
3594 #. type: IP
3595 #: build/C/man4/console_ioctl.4:543
3596 #, no-wrap
3597 msgid "B<TIOCLINUX, subcode=9>"
3598 msgstr ""
3599
3600 #. type: Plain text
3601 #: build/C/man4/console_ioctl.4:548
3602 msgid ""
3603 "Restore screen width and height, cursor position, and all the "
3604 "character-attribute pairs.  (Kernels 1.1.67 through 1.1.91 only.  With "
3605 "kernel 1.1.92 or later, write to /dev/vcsa* instead.)"
3606 msgstr ""
3607
3608 #. type: IP
3609 #: build/C/man4/console_ioctl.4:548
3610 #, no-wrap
3611 msgid "B<TIOCLINUX, subcode=10>"
3612 msgstr ""
3613
3614 #. type: Plain text
3615 #: build/C/man4/console_ioctl.4:553
3616 msgid ""
3617 "Handles the Power Saving feature of the new generation of monitors.  VESA "
3618 "screen blanking mode is set to I<argp>[1], which governs what screen "
3619 "blanking does:"
3620 msgstr ""
3621
3622 #. type: Plain text
3623 #: build/C/man4/console_ioctl.4:555
3624 #, no-wrap
3625 msgid "    I<0>: Screen blanking is disabled.\n"
3626 msgstr ""
3627
3628 #. type: Plain text
3629 #: build/C/man4/console_ioctl.4:562
3630 #, no-wrap
3631 msgid ""
3632 "    I<1>: The current video adapter\n"
3633 "register settings are saved, then the controller is programmed to turn off\n"
3634 "the vertical synchronization pulses.\n"
3635 "This puts the monitor into \"standby\" mode.\n"
3636 "If your monitor has an Off_Mode timer, then\n"
3637 "it will eventually power down by itself.\n"
3638 msgstr ""
3639
3640 #. type: Plain text
3641 #: build/C/man4/console_ioctl.4:571
3642 #, no-wrap
3643 msgid ""
3644 "    I<2>: The current\n"
3645 "settings are saved, then both the vertical and horizontal\n"
3646 "synchronization pulses are turned off.\n"
3647 "This puts the monitor into \"off\" mode.\n"
3648 "If your monitor has no Off_Mode timer,\n"
3649 "or if you want your monitor to power down immediately when the\n"
3650 "blank_timer times out, then you choose this option.\n"
3651 "(I<Caution:> Powering down frequently will damage the monitor.)\n"
3652 msgstr ""
3653
3654 #. type: Plain text
3655 #: build/C/man4/console_ioctl.4:573
3656 msgid "(Since 1.1.76.)"
3657 msgstr ""
3658
3659 #. type: SH
3660 #: build/C/man4/console_ioctl.4:573 build/C/man3/mkfifo.3:61 build/C/man2/mknod.2:100 build/C/man3/setlogmask.3:61 build/C/man4/st.4:826 build/C/man2/syslog.2:203
3661 #, no-wrap
3662 msgid "RETURN VALUE"
3663 msgstr ""
3664
3665 #. type: Plain text
3666 #: build/C/man4/console_ioctl.4:576
3667 msgid "On success, 0 is returned.  On error -1 is returned, and I<errno> is set."
3668 msgstr ""
3669
3670 #. type: SH
3671 #: build/C/man4/console_ioctl.4:576 build/C/man3/mkfifo.3:67 build/C/man2/mknod.2:105 build/C/man3/setlogmask.3:63 build/C/man2/syslog.2:219
3672 #, no-wrap
3673 msgid "ERRORS"
3674 msgstr ""
3675
3676 #. type: Plain text
3677 #: build/C/man4/console_ioctl.4:578
3678 msgid "I<errno> may take on these values:"
3679 msgstr ""
3680
3681 #. type: TP
3682 #: build/C/man4/console_ioctl.4:578
3683 #, no-wrap
3684 msgid "B<EBADF>"
3685 msgstr ""
3686
3687 #. type: Plain text
3688 #: build/C/man4/console_ioctl.4:581
3689 msgid "The file descriptor is invalid."
3690 msgstr ""
3691
3692 #. type: TP
3693 #: build/C/man4/console_ioctl.4:581
3694 #, no-wrap
3695 msgid "B<ENOTTY>"
3696 msgstr ""
3697
3698 #. type: Plain text
3699 #: build/C/man4/console_ioctl.4:585
3700 msgid ""
3701 "The file descriptor is not associated with a character special device, or "
3702 "the specified request does not apply to it."
3703 msgstr ""
3704
3705 #. type: TP
3706 #: build/C/man4/console_ioctl.4:585 build/C/man2/mknod.2:124 build/C/man4/st.4:841 build/C/man2/syslog.2:220
3707 #, no-wrap
3708 msgid "B<EINVAL>"
3709 msgstr ""
3710
3711 #. type: Plain text
3712 #: build/C/man4/console_ioctl.4:588
3713 msgid "The file descriptor or I<argp> is invalid."
3714 msgstr ""
3715
3716 #. type: TP
3717 #: build/C/man4/console_ioctl.4:588 build/C/man2/mknod.2:154 build/C/man2/syslog.2:244
3718 #, no-wrap
3719 msgid "B<EPERM>"
3720 msgstr ""
3721
3722 #. type: Plain text
3723 #: build/C/man4/console_ioctl.4:591
3724 msgid "Insufficient permission."
3725 msgstr ""
3726
3727 #. type: Plain text
3728 #: build/C/man4/console_ioctl.4:602
3729 msgid ""
3730 "B<Warning>: Do not regard this man page as documentation of the Linux "
3731 "console ioctl's.  This is provided for the curious only, as an alternative "
3732 "to reading the source.  Ioctl's are undocumented Linux internals, liable to "
3733 "be changed without warning.  (And indeed, this page more or less describes "
3734 "the situation as of kernel version 1.1.94; there are many minor and "
3735 "not-so-minor differences with earlier versions.)"
3736 msgstr ""
3737
3738 #. type: Plain text
3739 #: build/C/man4/console_ioctl.4:607
3740 msgid ""
3741 "Very often, ioctl's are introduced for communication between the kernel and "
3742 "one particular well-known program (fdisk, hdparm, setserial, tunelp, "
3743 "loadkeys, selection, setfont, etc.), and their behavior will be changed when "
3744 "required by this particular program."
3745 msgstr ""
3746
3747 #. type: Plain text
3748 #: build/C/man4/console_ioctl.4:611
3749 msgid ""
3750 "Programs using these ioctl's will not be portable to other versions of UNIX, "
3751 "will not work on older versions of Linux, and will not work on future "
3752 "versions of Linux."
3753 msgstr ""
3754
3755 #. type: Plain text
3756 #: build/C/man4/console_ioctl.4:613
3757 msgid "Use POSIX functions."
3758 msgstr ""
3759
3760 #. type: Plain text
3761 #: build/C/man4/console_ioctl.4:639
3762 msgid ""
3763 "B<dumpkeys>(1), B<kbd_mode>(1), B<loadkeys>(1), B<mknod>(1), B<setleds>(1), "
3764 "B<setmetamode>(1), B<execve>(2), B<fcntl>(2), B<ioperm>(2), B<termios>(3), "
3765 "B<console>(4), B<console_codes>(4), B<mt>(4), B<sd>(4), B<tty>(4), "
3766 "B<tty_ioctl>(4), B<ttyS>(4), B<vcs>(4), B<vcsa>(4), B<charsets>(7), "
3767 "B<mapscrn>(8), B<resizecons>(8), B<setfont>(8), I</usr/include/linux/kd.h>, "
3768 "I</usr/include/linux/vt.h>"
3769 msgstr ""
3770
3771 #. type: TH
3772 #: build/C/man5/core.5:23
3773 #, no-wrap
3774 msgid "CORE"
3775 msgstr ""
3776
3777 #. type: TH
3778 #: build/C/man5/core.5:23
3779 #, no-wrap
3780 msgid "2012-01-17"
3781 msgstr ""
3782
3783 #. type: Plain text
3784 #: build/C/man5/core.5:26
3785 msgid "core - core dump file"
3786 msgstr ""
3787
3788 #. type: Plain text
3789 #: build/C/man5/core.5:37
3790 msgid ""
3791 "The default action of certain signals is to cause a process to terminate and "
3792 "produce a I<core dump file>, a disk file containing an image of the "
3793 "process's memory at the time of termination.  This image can be used in a "
3794 "debugger (e.g., B<gdb>(1))  to inspect the state of the program at the time "
3795 "that it terminated.  A list of the signals which cause a process to dump "
3796 "core can be found in B<signal>(7)."
3797 msgstr ""
3798
3799 #. type: Plain text
3800 #: build/C/man5/core.5:44
3801 msgid ""
3802 "A process can set its soft B<RLIMIT_CORE> resource limit to place an upper "
3803 "limit on the size of the core dump file that will be produced if it receives "
3804 "a \"core dump\" signal; see B<getrlimit>(2)  for details."
3805 msgstr ""
3806
3807 #. type: Plain text
3808 #: build/C/man5/core.5:47
3809 msgid "There are various circumstances in which a core dump file is not produced:"
3810 msgstr ""
3811
3812 #. type: Plain text
3813 #: build/C/man5/core.5:59
3814 msgid ""
3815 "The process does not have permission to write the core file.  (By default "
3816 "the core file is called I<core>, and is created in the current working "
3817 "directory.  See below for details on naming.)  Writing the core file will "
3818 "fail if the directory in which it is to be created is nonwritable, or if a "
3819 "file with the same name exists and is not writable or is not a regular file "
3820 "(e.g., it is a directory or a symbolic link)."
3821 msgstr ""
3822
3823 #. type: Plain text
3824 #: build/C/man5/core.5:63
3825 msgid ""
3826 "A (writable, regular) file with the same name as would be used for the core "
3827 "dump already exists, but there is more than one hard link to that file."
3828 msgstr ""
3829
3830 #. type: Plain text
3831 #: build/C/man5/core.5:67
3832 msgid ""
3833 "The file system where the core dump file would be created is full; or has "
3834 "run out of inodes; or is mounted read-only; or the user has reached their "
3835 "quota for the file system."
3836 msgstr ""
3837
3838 #. type: Plain text
3839 #: build/C/man5/core.5:70
3840 msgid "The directory in which the core dump file is to be created does not exist."
3841 msgstr ""
3842
3843 #. type: Plain text
3844 #: build/C/man5/core.5:83
3845 msgid ""
3846 "The B<RLIMIT_CORE> (core file size) or B<RLIMIT_FSIZE> (file size) resource "
3847 "limits for the process are set to zero; see B<getrlimit>(2)  and the "
3848 "documentation of the shell's I<ulimit> command (I<limit> in B<csh>(1))."
3849 msgstr ""
3850
3851 #. type: Plain text
3852 #: build/C/man5/core.5:86
3853 msgid ""
3854 "The binary being executed by the process does not have read permission "
3855 "enabled."
3856 msgstr ""
3857
3858 #.  FIXME . Perhaps relocate discussion of /proc/sys/fs/suid_dumpable
3859 #.  and PR_SET_DUMPABLE to this page?
3860 #. type: Plain text
3861 #: build/C/man5/core.5:99
3862 msgid ""
3863 "The process is executing a set-user-ID (set-group-ID) program that is owned "
3864 "by a user (group) other than the real user (group)  ID of the process.  "
3865 "(However, see the description of the B<prctl>(2)  B<PR_SET_DUMPABLE> "
3866 "operation, and the description of the I</proc/sys/fs/suid_dumpable> file in "
3867 "B<proc>(5).)"
3868 msgstr ""
3869
3870 #. type: SS
3871 #: build/C/man5/core.5:99
3872 #, no-wrap
3873 msgid "Naming of core dump files"
3874 msgstr ""
3875
3876 #. type: Plain text
3877 #: build/C/man5/core.5:108
3878 msgid ""
3879 "By default, a core dump file is named I<core>, but the "
3880 "I</proc/sys/kernel/core_pattern> file (since Linux 2.6 and 2.4.21)  can be "
3881 "set to define a template that is used to name core dump files.  The template "
3882 "can contain % specifiers which are substituted by the following values when "
3883 "a core file is created:"
3884 msgstr ""
3885
3886 #. type: TP
3887 #: build/C/man5/core.5:111
3888 #, no-wrap
3889 msgid "%%"
3890 msgstr ""
3891
3892 #. type: Plain text
3893 #: build/C/man5/core.5:114
3894 msgid "a single % character"
3895 msgstr ""
3896
3897 #. type: TP
3898 #: build/C/man5/core.5:114
3899 #, no-wrap
3900 msgid "%p"
3901 msgstr ""
3902
3903 #. type: Plain text
3904 #: build/C/man5/core.5:117
3905 msgid "PID of dumped process"
3906 msgstr ""
3907
3908 #. type: TP
3909 #: build/C/man5/core.5:117
3910 #, no-wrap
3911 msgid "%u"
3912 msgstr ""
3913
3914 #. type: Plain text
3915 #: build/C/man5/core.5:120
3916 msgid "(numeric) real UID of dumped process"
3917 msgstr ""
3918
3919 #. type: TP
3920 #: build/C/man5/core.5:120
3921 #, no-wrap
3922 msgid "%g"
3923 msgstr ""
3924
3925 #. type: Plain text
3926 #: build/C/man5/core.5:123
3927 msgid "(numeric) real GID of dumped process"
3928 msgstr ""
3929
3930 #. type: TP
3931 #: build/C/man5/core.5:123
3932 #, no-wrap
3933 msgid "%s"
3934 msgstr ""
3935
3936 #. type: Plain text
3937 #: build/C/man5/core.5:126
3938 msgid "number of signal causing dump"
3939 msgstr ""
3940
3941 #. type: TP
3942 #: build/C/man5/core.5:126
3943 #, no-wrap
3944 msgid "%t"
3945 msgstr ""
3946
3947 #. type: Plain text
3948 #: build/C/man5/core.5:130
3949 msgid ""
3950 "time of dump, expressed as seconds since the Epoch, 1970-01-01 00:00:00 "
3951 "+0000 (UTC)"
3952 msgstr ""
3953
3954 #. type: TP
3955 #: build/C/man5/core.5:130
3956 #, no-wrap
3957 msgid "%h"
3958 msgstr ""
3959
3960 #. type: Plain text
3961 #: build/C/man5/core.5:133
3962 msgid "hostname (same as I<nodename> returned by B<uname>(2))"
3963 msgstr ""
3964
3965 #. type: TP
3966 #: build/C/man5/core.5:133
3967 #, no-wrap
3968 msgid "%e"
3969 msgstr ""
3970
3971 #. type: Plain text
3972 #: build/C/man5/core.5:136
3973 msgid "executable filename (without path prefix)"
3974 msgstr ""
3975
3976 #. type: TP
3977 #: build/C/man5/core.5:136
3978 #, no-wrap
3979 msgid "%E"
3980 msgstr ""
3981
3982 #. type: Plain text
3983 #: build/C/man5/core.5:140
3984 msgid ""
3985 "pathname of executable, with slashes (\\(aq/\\(aq) replaced by exclamation "
3986 "marks (\\(aq!\\(aq)."
3987 msgstr ""
3988
3989 #. type: TP
3990 #: build/C/man5/core.5:140
3991 #, no-wrap
3992 msgid "%c"
3993 msgstr ""
3994
3995 #. type: Plain text
3996 #: build/C/man5/core.5:143
3997 msgid "core file size soft resource limit of crashing process (since Linux 2.6.24)"
3998 msgstr ""
3999
4000 #. type: Plain text
4001 #: build/C/man5/core.5:162
4002 msgid ""
4003 "A single % at the end of the template is dropped from the core filename, as "
4004 "is the combination of a % followed by any character other than those listed "
4005 "above.  All other characters in the template become a literal part of the "
4006 "core filename.  The template may include \\(aq/\\(aq characters, which are "
4007 "interpreted as delimiters for directory names.  The maximum size of the "
4008 "resulting core filename is 128 bytes (64 bytes in kernels before 2.6.19).  "
4009 "The default value in this file is \"core\".  For backward compatibility, if "
4010 "I</proc/sys/kernel/core_pattern> does not include \"%p\" and "
4011 "I</proc/sys/kernel/core_uses_pid> (see below)  is nonzero, then .PID will be "
4012 "appended to the core filename."
4013 msgstr ""
4014
4015 #. type: Plain text
4016 #: build/C/man5/core.5:173
4017 msgid ""
4018 "Since version 2.4, Linux has also provided a more primitive method of "
4019 "controlling the name of the core dump file.  If the "
4020 "I</proc/sys/kernel/core_uses_pid> file contains the value 0, then a core "
4021 "dump file is simply named I<core>.  If this file contains a nonzero value, "
4022 "then the core dump file includes the process ID in a name of the form "
4023 "I<core.PID>."
4024 msgstr ""
4025
4026 #. type: SS
4027 #: build/C/man5/core.5:173
4028 #, no-wrap
4029 msgid "Piping core dumps to a program"
4030 msgstr ""
4031
4032 #. type: Plain text
4033 #: build/C/man5/core.5:183
4034 msgid ""
4035 "Since kernel 2.6.19, Linux supports an alternate syntax for the "
4036 "I</proc/sys/kernel/core_pattern> file.  If the first character of this file "
4037 "is a pipe symbol (B<|>), then the remainder of the line is interpreted as a "
4038 "program to be executed.  Instead of being written to a disk file, the core "
4039 "dump is given as standard input to the program.  Note the following points:"
4040 msgstr ""
4041
4042 #. type: Plain text
4043 #: build/C/man5/core.5:187
4044 msgid ""
4045 "The program must be specified using an absolute pathname (or a pathname "
4046 "relative to the root directory, I</>), and must immediately follow the '|' "
4047 "character."
4048 msgstr ""
4049
4050 #. type: Plain text
4051 #: build/C/man5/core.5:190
4052 msgid "The process created to run the program runs as user and group I<root>."
4053 msgstr ""
4054
4055 #. type: Plain text
4056 #: build/C/man5/core.5:194
4057 msgid ""
4058 "Command-line arguments can be supplied to the program (since kernel 2.6.24), "
4059 "delimited by white space (up to a total line length of 128 bytes)."
4060 msgstr ""
4061
4062 #. type: Plain text
4063 #: build/C/man5/core.5:200
4064 msgid ""
4065 "The command-line arguments can include any of the % specifiers listed "
4066 "above.  For example, to pass the PID of the process that is being dumped, "
4067 "specify I<%p> in an argument."
4068 msgstr ""
4069
4070 #. type: SS
4071 #: build/C/man5/core.5:200
4072 #, no-wrap
4073 msgid "Controlling which mappings are written to the core dump"
4074 msgstr ""
4075
4076 #. type: Plain text
4077 #: build/C/man5/core.5:206
4078 msgid ""
4079 "Since kernel 2.6.23, the Linux-specific I</proc/PID/coredump_filter> file "
4080 "can be used to control which memory segments are written to the core dump "
4081 "file in the event that a core dump is performed for the process with the "
4082 "corresponding process ID."
4083 msgstr ""
4084
4085 #. type: Plain text
4086 #: build/C/man5/core.5:212
4087 msgid ""
4088 "The value in the file is a bit mask of memory mapping types (see "
4089 "B<mmap>(2)).  If a bit is set in the mask, then memory mappings of the "
4090 "corresponding type are dumped; otherwise they are not dumped.  The bits in "
4091 "this file have the following meanings:"
4092 msgstr ""
4093
4094 #. type: TP
4095 #: build/C/man5/core.5:215
4096 #, no-wrap
4097 msgid "bit 0"
4098 msgstr ""
4099
4100 #. type: Plain text
4101 #: build/C/man5/core.5:218
4102 msgid "Dump anonymous private mappings."
4103 msgstr ""
4104
4105 #. type: TP
4106 #: build/C/man5/core.5:218
4107 #, no-wrap
4108 msgid "bit 1"
4109 msgstr ""
4110
4111 #. type: Plain text
4112 #: build/C/man5/core.5:221
4113 msgid "Dump anonymous shared mappings."
4114 msgstr ""
4115
4116 #. type: TP
4117 #: build/C/man5/core.5:221
4118 #, no-wrap
4119 msgid "bit 2"
4120 msgstr ""
4121
4122 #. type: Plain text
4123 #: build/C/man5/core.5:224
4124 msgid "Dump file-backed private mappings."
4125 msgstr ""
4126
4127 #. type: TP
4128 #: build/C/man5/core.5:224
4129 #, no-wrap
4130 msgid "bit 3"
4131 msgstr ""
4132
4133 #.  file-backed shared mappings of course also update the underlying
4134 #.  mapped file.
4135 #. type: Plain text
4136 #: build/C/man5/core.5:229
4137 msgid "Dump file-backed shared mappings."
4138 msgstr ""
4139
4140 #. type: TP
4141 #: build/C/man5/core.5:229
4142 #, no-wrap
4143 msgid "bit 4 (since Linux 2.6.24)"
4144 msgstr ""
4145
4146 #. type: Plain text
4147 #: build/C/man5/core.5:232
4148 msgid "Dump ELF headers."
4149 msgstr ""
4150
4151 #. type: TP
4152 #: build/C/man5/core.5:232
4153 #, no-wrap
4154 msgid "bit 5 (since Linux 2.6.28)"
4155 msgstr ""
4156
4157 #. type: Plain text
4158 #: build/C/man5/core.5:235
4159 msgid "Dump private huge pages."
4160 msgstr ""
4161
4162 #. type: TP
4163 #: build/C/man5/core.5:235
4164 #, no-wrap
4165 msgid "bit 6 (since Linux 2.6.28)"
4166 msgstr ""
4167
4168 #. type: Plain text
4169 #: build/C/man5/core.5:238
4170 msgid "Dump shared huge pages."
4171 msgstr ""
4172
4173 #. type: Plain text
4174 #: build/C/man5/core.5:246
4175 msgid ""
4176 "By default, the following bits are set: 0, 1, 4 (if the "
4177 "B<CONFIG_CORE_DUMP_DEFAULT_ELF_HEADERS> kernel configuration option is "
4178 "enabled), and 5.  The value of this file is displayed in hexadecimal.  (The "
4179 "default value is thus displayed as 33.)"
4180 msgstr ""
4181
4182 #. type: Plain text
4183 #: build/C/man5/core.5:251
4184 msgid ""
4185 "Memory-mapped I/O pages such as frame buffer are never dumped, and virtual "
4186 "DSO pages are always dumped, regardless of the I<coredump_filter> value."
4187 msgstr ""
4188
4189 #. type: Plain text
4190 #: build/C/man5/core.5:261
4191 msgid ""
4192 "A child process created via B<fork>(2)  inherits its parent's "
4193 "I<coredump_filter> value; the I<coredump_filter> value is preserved across "
4194 "an B<execve>(2)."
4195 msgstr ""
4196
4197 #. type: Plain text
4198 #: build/C/man5/core.5:265
4199 msgid ""
4200 "It can be useful to set I<coredump_filter> in the parent shell before "
4201 "running a program, for example:"
4202 msgstr ""
4203
4204 #. type: Plain text
4205 #: build/C/man5/core.5:270
4206 #, no-wrap
4207 msgid ""
4208 "$B< echo 0x7 E<gt> /proc/self/coredump_filter>\n"
4209 "$B< ./some_program>\n"
4210 msgstr ""
4211
4212 #. type: Plain text
4213 #: build/C/man5/core.5:276
4214 msgid ""
4215 "This file is only provided if the kernel was built with the "
4216 "B<CONFIG_ELF_CORE> configuration option."
4217 msgstr ""
4218
4219 #. type: Plain text
4220 #: build/C/man5/core.5:281
4221 msgid ""
4222 "The B<gdb>(1)  I<gcore> command can be used to obtain a core dump of a "
4223 "running process."
4224 msgstr ""
4225
4226 #.  Always including the PID in the name of the core file made
4227 #.  sense for LinuxThreads, where each thread had a unique PID,
4228 #.  but doesn't seem to serve any purpose with NPTL, where all the
4229 #.  threads in a process share the same PID (as POSIX.1 requires).
4230 #.  Probably the behavior is maintained so that applications using
4231 #.  LinuxThreads continue appending the PID (the kernel has no easy
4232 #.  way of telling which threading implementation the userspace
4233 #.  application is using). -- mtk, April 2006
4234 #. type: Plain text
4235 #: build/C/man5/core.5:301
4236 msgid ""
4237 "If a multithreaded process (or, more precisely, a process that shares its "
4238 "memory with another process by being created with the B<CLONE_VM> flag of "
4239 "B<clone>(2))  dumps core, then the process ID is always appended to the core "
4240 "filename, unless the process ID was already included elsewhere in the "
4241 "filename via a %p specification in I</proc/sys/kernel/core_pattern>.  (This "
4242 "is primarily useful when employing the LinuxThreads implementation, where "
4243 "each thread of a process has a different PID.)"
4244 msgstr ""
4245
4246 #. type: SH
4247 #: build/C/man5/core.5:301 build/C/man3/gnu_get_libc_version.3:50 build/C/man3/stdarg.3:272 build/C/man4/vcs.4:88
4248 #, no-wrap
4249 msgid "EXAMPLE"
4250 msgstr ""
4251
4252 #. type: Plain text
4253 #: build/C/man5/core.5:309
4254 msgid ""
4255 "The program below can be used to demonstrate the use of the pipe syntax in "
4256 "the I</proc/sys/kernel/core_pattern> file.  The following shell session "
4257 "demonstrates the use of this program (compiled to create an executable named "
4258 "I<core_pattern_pipe_test>):"
4259 msgstr ""
4260
4261 #. type: Plain text
4262 #: build/C/man5/core.5:330
4263 #, no-wrap
4264 msgid ""
4265 "$B< cc -o core_pattern_pipe_test core_pattern_pipe_test.c>\n"
4266 "$B< su>\n"
4267 "Password:\n"
4268 "#B< echo \"|$PWD/core_pattern_pipe_test %p UID=%u GID=%g sig=%s\" E<gt> "
4269 "\\e>\n"
4270 "B</proc/sys/kernel/core_pattern>\n"
4271 "#B< exit>\n"
4272 "$B< sleep 100>\n"
4273 "B<^\\e>                     # type control-backslash\n"
4274 "Quit (core dumped)\n"
4275 "$B< cat core.info>\n"
4276 "argc=5\n"
4277 "argc[0]=E<lt>/home/mtk/core_pattern_pipe_testE<gt>\n"
4278 "argc[1]=E<lt>20575E<gt>\n"
4279 "argc[2]=E<lt>UID=1000E<gt>\n"
4280 "argc[3]=E<lt>GID=100E<gt>\n"
4281 "argc[4]=E<lt>sig=3E<gt>\n"
4282 "Total bytes in core dump: 282624\n"
4283 msgstr ""
4284
4285 #. type: SS
4286 #: build/C/man5/core.5:332 build/C/man3/gnu_get_libc_version.3:60
4287 #, no-wrap
4288 msgid "Program source"
4289 msgstr ""
4290
4291 #. type: Plain text
4292 #: build/C/man5/core.5:336
4293 #, no-wrap
4294 msgid "/* core_pattern_pipe_test.c */\n"
4295 msgstr ""
4296
4297 #. type: Plain text
4298 #: build/C/man5/core.5:344
4299 #, no-wrap
4300 msgid ""
4301 "#define _GNU_SOURCE\n"
4302 "#include E<lt>sys/stat.hE<gt>\n"
4303 "#include E<lt>fcntl.hE<gt>\n"
4304 "#include E<lt>limits.hE<gt>\n"
4305 "#include E<lt>stdio.hE<gt>\n"
4306 "#include E<lt>stdlib.hE<gt>\n"
4307 "#include E<lt>unistd.hE<gt>\n"
4308 msgstr ""
4309
4310 #. type: Plain text
4311 #: build/C/man5/core.5:346
4312 #, no-wrap
4313 msgid "#define BUF_SIZE 1024\n"
4314 msgstr ""
4315
4316 #. type: Plain text
4317 #: build/C/man5/core.5:355
4318 #, no-wrap
4319 msgid ""
4320 "int\n"
4321 "main(int argc, char *argv[])\n"
4322 "{\n"
4323 "    int tot, j;\n"
4324 "    ssize_t nread;\n"
4325 "    char buf[BUF_SIZE];\n"
4326 "    FILE *fp;\n"
4327 "    char cwd[PATH_MAX];\n"
4328 msgstr ""
4329
4330 #. type: Plain text
4331 #: build/C/man5/core.5:358
4332 #, no-wrap
4333 msgid ""
4334 "    /* Change our current working directory to that of the\n"
4335 "       crashing process */\n"
4336 msgstr ""
4337
4338 #. type: Plain text
4339 #: build/C/man5/core.5:361
4340 #, no-wrap
4341 msgid ""
4342 "    snprintf(cwd, PATH_MAX, \"/proc/%s/cwd\", argv[1]);\n"
4343 "    chdir(cwd);\n"
4344 msgstr ""
4345
4346 #. type: Plain text
4347 #: build/C/man5/core.5:363
4348 #, no-wrap
4349 msgid "    /* Write output to file \"core.info\" in that directory */\n"
4350 msgstr ""
4351
4352 #. type: Plain text
4353 #: build/C/man5/core.5:367
4354 #, no-wrap
4355 msgid ""
4356 "    fp = fopen(\"core.info\", \"w+\");\n"
4357 "    if (fp == NULL)\n"
4358 "        exit(EXIT_FAILURE);\n"
4359 msgstr ""
4360
4361 #. type: Plain text
4362 #: build/C/man5/core.5:370
4363 #, no-wrap
4364 msgid ""
4365 "    /* Display command-line arguments given to core_pattern\n"
4366 "       pipe program */\n"
4367 msgstr ""
4368
4369 #. type: Plain text
4370 #: build/C/man5/core.5:374
4371 #, no-wrap
4372 msgid ""
4373 "    fprintf(fp, \"argc=%d\\en\", argc);\n"
4374 "    for (j = 0; j E<lt> argc; j++)\n"
4375 "        fprintf(fp, \"argc[%d]=E<lt>%sE<gt>\\en\", j, argv[j]);\n"
4376 msgstr ""
4377
4378 #. type: Plain text
4379 #: build/C/man5/core.5:376
4380 #, no-wrap
4381 msgid "    /* Count bytes in standard input (the core dump) */\n"
4382 msgstr ""
4383
4384 #. type: Plain text
4385 #: build/C/man5/core.5:381
4386 #, no-wrap
4387 msgid ""
4388 "    tot = 0;\n"
4389 "    while ((nread = read(STDIN_FILENO, buf, BUF_SIZE)) E<gt> 0)\n"
4390 "        tot += nread;\n"
4391 "    fprintf(fp, \"Total bytes in core dump: %d\\en\", tot);\n"
4392 msgstr ""
4393
4394 #. type: Plain text
4395 #: build/C/man5/core.5:384
4396 #, no-wrap
4397 msgid ""
4398 "    exit(EXIT_SUCCESS);\n"
4399 "}\n"
4400 msgstr ""
4401
4402 #. type: Plain text
4403 #: build/C/man5/core.5:396
4404 msgid ""
4405 "B<bash>(1), B<gdb>(1), B<getrlimit>(2), B<mmap>(2), B<prctl>(2), "
4406 "B<sigaction>(2), B<elf>(5), B<proc>(5), B<pthreads>(7), B<signal>(7)"
4407 msgstr ""
4408
4409 #. type: TH
4410 #: build/C/man4/cpuid.4:24
4411 #, no-wrap
4412 msgid "CPUID"
4413 msgstr ""
4414
4415 #. type: TH
4416 #: build/C/man4/cpuid.4:24 build/C/man4/msr.4:24
4417 #, no-wrap
4418 msgid "2009-03-31"
4419 msgstr ""
4420
4421 #. type: Plain text
4422 #: build/C/man4/cpuid.4:27
4423 msgid "cpuid - x86 CPUID access device"
4424 msgstr ""
4425
4426 #. type: Plain text
4427 #: build/C/man4/cpuid.4:29
4428 msgid "CPUID provides an interface for querying information about the x86 CPU."
4429 msgstr ""
4430
4431 #. type: Plain text
4432 #: build/C/man4/cpuid.4:36
4433 msgid ""
4434 "This device is accessed by B<lseek (2)> or B<pread (2)> to the appropriate "
4435 "CPUID level and reading in chunks of 16 bytes.  A larger read size means "
4436 "multiple reads of consecutive levels."
4437 msgstr ""
4438
4439 #. type: Plain text
4440 #: build/C/man4/cpuid.4:45
4441 msgid ""
4442 "The lower 32 bits of the file position is used as the incoming I<%eax>, and "
4443 "the upper 32 bits of the file position as the incoming I<%ecx>, the latter "
4444 "intended for \"counting\" I<eax> levels like I<eax=4>."
4445 msgstr ""
4446
4447 #. type: Plain text
4448 #: build/C/man4/cpuid.4:55
4449 msgid ""
4450 "This driver uses I</dev/cpu/CPUNUM/cpuid>, where I<CPUNUM> is the minor "
4451 "number, and on an SMP box will direct the access to CPU I<CPUNUM> as listed "
4452 "in I</proc/cpuinfo>."
4453 msgstr ""
4454
4455 #. type: Plain text
4456 #: build/C/man4/cpuid.4:60
4457 msgid ""
4458 "This file is protected so that it can only be read by the user I<root>, or "
4459 "members of the group I<root>."
4460 msgstr ""
4461
4462 #. type: Plain text
4463 #: build/C/man4/cpuid.4:65
4464 msgid ""
4465 "The CPUID instruction can be directly executed by a program using inline "
4466 "assembler.  However this device allows convenient access to all CPUs without "
4467 "changing process affinity."
4468 msgstr ""
4469
4470 #. type: Plain text
4471 #: build/C/man4/cpuid.4:74
4472 msgid ""
4473 "Most of the information in I<cpuid> is reported by the kernel in cooked form "
4474 "either in I</proc/cpuinfo> or through subdirectories in "
4475 "I</sys/devices/system/cpu>.  Direct CPUID access through this device should "
4476 "only be used in exceptional cases."
4477 msgstr ""
4478
4479 #. type: Plain text
4480 #: build/C/man4/cpuid.4:80
4481 msgid ""
4482 "The I<cpuid> driver is not auto-loaded.  On modular kernels you might need "
4483 "to use the following command to load it explicitly before use:"
4484 msgstr ""
4485
4486 #. type: Plain text
4487 #: build/C/man4/cpuid.4:82
4488 #, no-wrap
4489 msgid "     $ I<modprobe cpuid>\n"
4490 msgstr ""
4491
4492 #. type: Plain text
4493 #: build/C/man4/cpuid.4:85
4494 msgid ""
4495 "There is no support for CPUID functions that require additional input "
4496 "registers."
4497 msgstr ""
4498
4499 #. type: Plain text
4500 #: build/C/man4/cpuid.4:87
4501 msgid "Very old x86 CPUs don't support CPUID."
4502 msgstr ""
4503
4504 #. type: Plain text
4505 #: build/C/man4/cpuid.4:91
4506 msgid ""
4507 "Intel Corporation, Intel 64 and IA-32 Architectures Software Developer's "
4508 "Manual Volume 2A: Instruction Set Reference, A-M, 3-180 CPUID reference."
4509 msgstr ""
4510
4511 #. type: Plain text
4512 #: build/C/man4/cpuid.4:94
4513 msgid ""
4514 "Intel Corporation, Intel Processor Identification and the CPUID Instruction, "
4515 "Application note 485."
4516 msgstr ""
4517
4518 #. type: TH
4519 #: build/C/man4/dsp56k.4:26
4520 #, no-wrap
4521 msgid "DSP56K"
4522 msgstr ""
4523
4524 #. type: TH
4525 #: build/C/man4/dsp56k.4:26
4526 #, no-wrap
4527 msgid "2000-03-01"
4528 msgstr ""
4529
4530 #. type: Plain text
4531 #: build/C/man4/dsp56k.4:29
4532 msgid "dsp56k - DSP56001 interface device"
4533 msgstr ""
4534
4535 #. type: Plain text
4536 #: build/C/man4/dsp56k.4:32
4537 #, no-wrap
4538 msgid "#include E<lt>asm/dsp56k.hE<gt>\n"
4539 msgstr ""
4540
4541 #. type: Plain text
4542 #: build/C/man4/dsp56k.4:35
4543 #, no-wrap
4544 msgid ""
4545 "B<ssize_t read(int >I<fd>B<, void *>I<data>B<, size_t >I<length>B<);>\n"
4546 "B<ssize_t write(int >I<fd>B<, void *>I<data>B<, size_t >I<length>B<);>\n"
4547 msgstr ""
4548
4549 #. type: Plain text
4550 #: build/C/man4/dsp56k.4:41
4551 #, no-wrap
4552 msgid ""
4553 "B<int ioctl(int >I<fd>B<, DSP56K_UPLOAD, struct dsp56k_upload "
4554 "*>I<program>B<);>\n"
4555 "B<int ioctl(int >I<fd>B<, DSP56K_SET_TX_WSIZE, int >I<wsize>B<);>\n"
4556 "B<int ioctl(int >I<fd>B<, DSP56K_SET_RX_WSIZE, int >I<wsize>B<);>\n"
4557 "B<int ioctl(int >I<fd>B<, DSP56K_HOST_FLAGS, struct dsp56k_host_flags "
4558 "*>I<flags>B<);>\n"
4559 "B<int ioctl(int >I<fd>B<, DSP56K_HOST_CMD, int >I<cmd>B<);>\n"
4560 msgstr ""
4561
4562 #. type: SH
4563 #: build/C/man4/dsp56k.4:42 build/C/man4/fd.4:30 build/C/man4/full.4:29 build/C/man4/initrd.4:37 build/C/man4/lp.4:31 build/C/man4/mouse.4:28 build/C/man4/sd.4:32
4564 #, no-wrap
4565 msgid "CONFIGURATION"
4566 msgstr ""
4567
4568 #. type: Plain text
4569 #: build/C/man4/dsp56k.4:45
4570 msgid ""
4571 "The dsp56k device is a character device with major number 55 and minor "
4572 "number 0."
4573 msgstr ""
4574
4575 #. type: Plain text
4576 #: build/C/man4/dsp56k.4:51
4577 msgid ""
4578 "The Motorola DSP56001 is a fully programmable 24-bit digital signal "
4579 "processor found in Atari Falcon030-compatible computers.  The I<dsp56k> "
4580 "special file is used to control the DSP56001, and to send and receive data "
4581 "using the bidirectional handshaked host port."
4582 msgstr ""
4583
4584 #. type: Plain text
4585 #: build/C/man4/dsp56k.4:61
4586 msgid ""
4587 "To send a data stream to the signal processor, use B<write>(2)  to the "
4588 "device, and B<read>(2)  to receive processed data.  The data can be sent or "
4589 "received in 8, 16, 24, or 32-bit quantities on the host side, but will "
4590 "always be seen as 24-bit quantities in the DSP56001."
4591 msgstr ""
4592
4593 #. type: Plain text
4594 #: build/C/man4/dsp56k.4:66
4595 msgid "The following B<ioctl>(2)  calls are used to control the I<dsp56k> device:"
4596 msgstr ""
4597
4598 #. type: IP
4599 #: build/C/man4/dsp56k.4:66
4600 #, no-wrap
4601 msgid "B<DSP56K_UPLOAD>"
4602 msgstr ""
4603
4604 #. type: Plain text
4605 #: build/C/man4/dsp56k.4:73
4606 msgid ""
4607 "resets the DSP56001 and uploads a program.  The third B<ioctl>(2)  argument "
4608 "must be a pointer to a I<struct dsp56k_binary> with members I<bin> pointing "
4609 "to a DSP56001 binary program, and I<len> set to the length of the program, "
4610 "counted in 24-bit words."
4611 msgstr ""
4612
4613 #. type: IP
4614 #: build/C/man4/dsp56k.4:73
4615 #, no-wrap
4616 msgid "B<DSP56K_SET_TX_WSIZE>"
4617 msgstr ""
4618
4619 #. type: Plain text
4620 #: build/C/man4/dsp56k.4:81
4621 msgid ""
4622 "sets the transmit word size.  Allowed values are in the range 1 to 4, and is "
4623 "the number of bytes that will be sent at a time to the DSP56001.  These data "
4624 "quantities will either be padded with zero bytes, or truncated to fit the "
4625 "native 24-bit data format of the DSP56001."
4626 msgstr ""
4627
4628 #. type: IP
4629 #: build/C/man4/dsp56k.4:81
4630 #, no-wrap
4631 msgid "B<DSP56K_SET_RX_WSIZE>"
4632 msgstr ""
4633
4634 #. type: Plain text
4635 #: build/C/man4/dsp56k.4:88
4636 msgid ""
4637 "sets the receive word size.  Allowed values are in the range 1 to 4, and is "
4638 "the number of bytes that will be received at a time from the DSP56001.  "
4639 "These data quantities will either truncated, or padded with a null byte "
4640 "(\\(aq\\e0\\(aq) to fit the native 24-bit data format of the DSP56001."
4641 msgstr ""
4642
4643 #. type: IP
4644 #: build/C/man4/dsp56k.4:88
4645 #, no-wrap
4646 msgid "B<DSP56K_HOST_FLAGS>"
4647 msgstr ""
4648
4649 #. type: Plain text
4650 #: build/C/man4/dsp56k.4:95
4651 msgid ""
4652 "read and write the host flags.  The host flags are four general-purpose bits "
4653 "that can be read by both the hosting computer and the DSP56001.  Bits 0 and "
4654 "1 can be written by the host, and bits 2 and 3 can be written by the "
4655 "DSP56001."
4656 msgstr ""
4657
4658 #. type: Plain text
4659 #: build/C/man4/dsp56k.4:105
4660 msgid ""
4661 "To access the host flags, the third B<ioctl>(2)  argument must be a pointer "
4662 "to a I<struct dsp56k_host_flags>.  If bit 0 or 1 is set in the I<dir> "
4663 "member, the corresponding bit in I<out> will be written to the host flags.  "
4664 "The state of all host flags will be returned in the lower four bits of the "
4665 "I<status> member."
4666 msgstr ""
4667
4668 #. type: IP
4669 #: build/C/man4/dsp56k.4:105
4670 #, no-wrap
4671 msgid "B<DSP56K_HOST_CMD>"
4672 msgstr ""
4673
4674 #. type: Plain text
4675 #: build/C/man4/dsp56k.4:109
4676 msgid ""
4677 "sends a host command.  Allowed values are in the range 0 to 31, and is a "
4678 "user-defined command handled by the program running in the DSP56001."
4679 msgstr ""
4680
4681 #.  .SH AUTHORS
4682 #.  Fredrik Noring <noring@nocrew.org>, lars brinkhoff <lars@nocrew.org>,
4683 #.  Tomas Berndtsson <tomas@nocrew.org>.
4684 #. type: Plain text
4685 #: build/C/man4/dsp56k.4:114
4686 msgid "/dev/dsp56k"
4687 msgstr ""
4688
4689 #. type: Plain text
4690 #: build/C/man4/dsp56k.4:119
4691 msgid ""
4692 "I<linux/include/asm-m68k/dsp56k.h>, I<linux/drivers/char/dsp56k.c>, "
4693 "I<http://dsp56k.nocrew.org/>, DSP56000/DSP56001 Digital Signal Processor "
4694 "User's Manual"
4695 msgstr ""
4696
4697 #. type: TH
4698 #: build/C/man4/fd.4:27
4699 #, no-wrap
4700 msgid "FD"
4701 msgstr ""
4702
4703 #. type: TH
4704 #: build/C/man4/fd.4:27 build/C/man4/random.4:17
4705 #, no-wrap
4706 msgid "2010-08-29"
4707 msgstr ""
4708
4709 #. type: Plain text
4710 #: build/C/man4/fd.4:30
4711 msgid "fd - floppy disk device"
4712 msgstr ""
4713
4714 #. type: Plain text
4715 #: build/C/man4/fd.4:47
4716 msgid ""
4717 "Floppy drives are block devices with major number 2.  Typically they are "
4718 "owned by I<root.floppy> (i.e., user root, group floppy) and have either mode "
4719 "0660 (access checking via group membership) or mode 0666 (everybody has "
4720 "access).  The minor numbers encode the device type, drive number, and "
4721 "controller number.  For each device type (that is, combination of density "
4722 "and track count)  there is a base minor number.  To this base number, add "
4723 "the drive's number on its controller and 128 if the drive is on the "
4724 "secondary controller.  In the following device tables, I<n> represents the "
4725 "drive number."
4726 msgstr ""
4727
4728 #. type: Plain text
4729 #: build/C/man4/fd.4:54
4730 msgid ""
4731 "B<Warning: If you use formats with more tracks than supported by your drive, "
4732 "you may cause it mechanical damage.> Trying once if more tracks than the "
4733 "usual 40/80 are supported should not damage it, but no warranty is given for "
4734 "that.  If you are not sure, don't create device entries for those formats, "
4735 "so as to prevent their usage."
4736 msgstr ""
4737
4738 #. type: Plain text
4739 #: build/C/man4/fd.4:57
4740 msgid ""
4741 "Drive-independent device files which automatically detect the media format "
4742 "and capacity:"
4743 msgstr ""
4744
4745 #. type: tbl table
4746 #: build/C/man4/fd.4:59
4747 #, no-wrap
4748 msgid "Name\tBase minor #\n"
4749 msgstr ""
4750
4751 #. type: tbl table
4752 #: build/C/man4/fd.4:60 build/C/man4/fd.4:68 build/C/man4/fd.4:76 build/C/man4/fd.4:93 build/C/man4/fd.4:105 build/C/man4/fd.4:124
4753 #, no-wrap
4754 msgid "_\n"
4755 msgstr ""
4756
4757 #. type: tbl table
4758 #: build/C/man4/fd.4:61
4759 #, no-wrap
4760 msgid "B<fd>I<n>\t0\n"
4761 msgstr ""
4762
4763 #. type: Plain text
4764 #: build/C/man4/fd.4:65
4765 msgid "5.25 inch double density device files:"
4766 msgstr ""
4767
4768 #. type: tbl table
4769 #: build/C/man4/fd.4:67 build/C/man4/fd.4:75 build/C/man4/fd.4:92 build/C/man4/fd.4:104 build/C/man4/fd.4:123
4770 #, no-wrap
4771 msgid "Name\tCapac.\tCyl.\tSect.\tHeads\tBase minor #\n"
4772 msgstr ""
4773
4774 #. type: tbl table
4775 #: build/C/man4/fd.4:69
4776 #, no-wrap
4777 msgid "B<fd>I<n>B<d360>\t360K\t40\t9\t2\t4\n"
4778 msgstr ""
4779
4780 #. type: Plain text
4781 #: build/C/man4/fd.4:73
4782 msgid "5.25 inch high density device files:"
4783 msgstr ""
4784
4785 #. type: tbl table
4786 #: build/C/man4/fd.4:77
4787 #, no-wrap
4788 msgid "B<fd>I<n>B<h360>\t360K\t40\t9\t2\t20\n"
4789 msgstr ""
4790
4791 #. type: tbl table
4792 #: build/C/man4/fd.4:78
4793 #, no-wrap
4794 msgid "B<fd>I<n>B<h410>\t410K\t41\t10\t2\t48\n"
4795 msgstr ""
4796
4797 #. type: tbl table
4798 #: build/C/man4/fd.4:79
4799 #, no-wrap
4800 msgid "B<fd>I<n>B<h420>\t420K\t42\t10\t2\t64\n"
4801 msgstr ""
4802
4803 #. type: tbl table
4804 #: build/C/man4/fd.4:80
4805 #, no-wrap
4806 msgid "B<fd>I<n>B<h720>\t720K\t80\t9\t2\t24\n"
4807 msgstr ""
4808
4809 #. type: tbl table
4810 #: build/C/man4/fd.4:81
4811 #, no-wrap
4812 msgid "B<fd>I<n>B<h880>\t880K\t80\t11\t2\t80\n"
4813 msgstr ""
4814
4815 #. type: tbl table
4816 #: build/C/man4/fd.4:82
4817 #, no-wrap
4818 msgid "B<fd>I<n>B<h1200>\t1200K\t80\t15\t2\t8\n"
4819 msgstr ""
4820
4821 #. type: tbl table
4822 #: build/C/man4/fd.4:83
4823 #, no-wrap
4824 msgid "B<fd>I<n>B<h1440>\t1440K\t80\t18\t2\t40\n"
4825 msgstr ""
4826
4827 #. type: tbl table
4828 #: build/C/man4/fd.4:84
4829 #, no-wrap
4830 msgid "B<fd>I<n>B<h1476>\t1476K\t82\t18\t2\t56\n"
4831 msgstr ""
4832
4833 #. type: tbl table
4834 #: build/C/man4/fd.4:85
4835 #, no-wrap
4836 msgid "B<fd>I<n>B<h1494>\t1494K\t83\t18\t2\t72\n"
4837 msgstr ""
4838
4839 #. type: tbl table
4840 #: build/C/man4/fd.4:86
4841 #, no-wrap
4842 msgid "B<fd>I<n>B<h1600>\t1600K\t80\t20\t2\t92\n"
4843 msgstr ""
4844
4845 #. type: Plain text
4846 #: build/C/man4/fd.4:90
4847 msgid "3.5 inch double density device files:"
4848 msgstr ""
4849
4850 #. type: tbl table
4851 #: build/C/man4/fd.4:94
4852 #, no-wrap
4853 msgid "B<fd>I<n>B<D360>\t360K\t80\t9\t1\t12\n"
4854 msgstr ""
4855
4856 #. type: tbl table
4857 #: build/C/man4/fd.4:95
4858 #, no-wrap
4859 msgid "B<fd>I<n>B<D720>\t720K\t80\t9\t2\t16\n"
4860 msgstr ""
4861
4862 #. type: tbl table
4863 #: build/C/man4/fd.4:96
4864 #, no-wrap
4865 msgid "B<fd>I<n>B<D800>\t800K\t80\t10\t2\t120\n"
4866 msgstr ""
4867
4868 #. type: tbl table
4869 #: build/C/man4/fd.4:97
4870 #, no-wrap
4871 msgid "B<fd>I<n>B<D1040>\t1040K\t80\t13\t2\t84\n"
4872 msgstr ""
4873
4874 #. type: tbl table
4875 #: build/C/man4/fd.4:98
4876 #, no-wrap
4877 msgid "B<fd>I<n>B<D1120>\t1120K\t80\t14\t2\t88\n"
4878 msgstr ""
4879
4880 #. type: Plain text
4881 #: build/C/man4/fd.4:102
4882 msgid "3.5 inch high density device files:"
4883 msgstr ""
4884
4885 #. type: tbl table
4886 #: build/C/man4/fd.4:106
4887 #, no-wrap
4888 msgid "B<fd>I<n>B<H360>\t360K\t40\t9\t2\t12\n"
4889 msgstr ""
4890
4891 #. type: tbl table
4892 #: build/C/man4/fd.4:107
4893 #, no-wrap
4894 msgid "B<fd>I<n>B<H720>\t720K\t80\t9\t2\t16\n"
4895 msgstr ""
4896
4897 #. type: tbl table
4898 #: build/C/man4/fd.4:108
4899 #, no-wrap
4900 msgid "B<fd>I<n>B<H820>\t820K\t82\t10\t2\t52\n"
4901 msgstr ""
4902
4903 #. type: tbl table
4904 #: build/C/man4/fd.4:109
4905 #, no-wrap
4906 msgid "B<fd>I<n>B<H830>\t830K\t83\t10\t2\t68\n"
4907 msgstr ""
4908
4909 #. type: tbl table
4910 #: build/C/man4/fd.4:110
4911 #, no-wrap
4912 msgid "B<fd>I<n>B<H1440>\t1440K\t80\t18\t2\t28\n"
4913 msgstr ""
4914
4915 #. type: tbl table
4916 #: build/C/man4/fd.4:111
4917 #, no-wrap
4918 msgid "B<fd>I<n>B<H1600>\t1600K\t80\t20\t2\t124\n"
4919 msgstr ""
4920
4921 #. type: tbl table
4922 #: build/C/man4/fd.4:112
4923 #, no-wrap
4924 msgid "B<fd>I<n>B<H1680>\t1680K\t80\t21\t2\t44\n"
4925 msgstr ""
4926
4927 #. type: tbl table
4928 #: build/C/man4/fd.4:113
4929 #, no-wrap
4930 msgid "B<fd>I<n>B<H1722>\t1722K\t82\t21\t2\t60\n"
4931 msgstr ""
4932
4933 #. type: tbl table
4934 #: build/C/man4/fd.4:114
4935 #, no-wrap
4936 msgid "B<fd>I<n>B<H1743>\t1743K\t83\t21\t2\t76\n"
4937 msgstr ""
4938
4939 #. type: tbl table
4940 #: build/C/man4/fd.4:115
4941 #, no-wrap
4942 msgid "B<fd>I<n>B<H1760>\t1760K\t80\t22\t2\t96\n"
4943 msgstr ""
4944
4945 #. type: tbl table
4946 #: build/C/man4/fd.4:116
4947 #, no-wrap
4948 msgid "B<fd>I<n>B<H1840>\t1840K\t80\t23\t2\t116\n"
4949 msgstr ""
4950
4951 #. type: tbl table
4952 #: build/C/man4/fd.4:117
4953 #, no-wrap
4954 msgid "B<fd>I<n>B<H1920>\t1920K\t80\t24\t2\t100\n"
4955 msgstr ""
4956
4957 #. type: Plain text
4958 #: build/C/man4/fd.4:121
4959 msgid "3.5 inch extra density device files:"
4960 msgstr ""
4961
4962 #. type: tbl table
4963 #: build/C/man4/fd.4:125
4964 #, no-wrap
4965 msgid "B<fd>I<n>B<E2880>\t2880K\t80\t36\t2\t32\n"
4966 msgstr ""
4967
4968 #. type: tbl table
4969 #: build/C/man4/fd.4:126
4970 #, no-wrap
4971 msgid "B<fd>I<n>B<CompaQ>\t2880K\t80\t36\t2\t36\n"
4972 msgstr ""
4973
4974 #. type: tbl table
4975 #: build/C/man4/fd.4:127
4976 #, no-wrap
4977 msgid "B<fd>I<n>B<E3200>\t3200K\t80\t40\t2\t104\n"
4978 msgstr ""
4979
4980 #. type: tbl table
4981 #: build/C/man4/fd.4:128
4982 #, no-wrap
4983 msgid "B<fd>I<n>B<E3520>\t3520K\t80\t44\t2\t108\n"
4984 msgstr ""
4985
4986 #. type: tbl table
4987 #: build/C/man4/fd.4:129
4988 #, no-wrap
4989 msgid "B<fd>I<n>B<E3840>\t3840K\t80\t48\t2\t112\n"
4990 msgstr ""
4991
4992 #. type: Plain text
4993 #: build/C/man4/fd.4:136
4994 msgid ""
4995 "B<fd> special files access the floppy disk drives in raw mode.  The "
4996 "following B<ioctl>(2)  calls are supported by B<fd> devices:"
4997 msgstr ""
4998
4999 #. type: IP
5000 #: build/C/man4/fd.4:136
5001 #, no-wrap
5002 msgid "B<FDCLRPRM>"
5003 msgstr ""
5004
5005 #. type: Plain text
5006 #: build/C/man4/fd.4:138
5007 msgid "clears the media information of a drive (geometry of disk in drive)."
5008 msgstr ""
5009
5010 #. type: IP
5011 #: build/C/man4/fd.4:138
5012 #, no-wrap
5013 msgid "B<FDSETPRM>"
5014 msgstr ""
5015
5016 #. type: Plain text
5017 #: build/C/man4/fd.4:142
5018 msgid ""
5019 "sets the media information of a drive.  The media information will be lost "
5020 "when the media is changed."
5021 msgstr ""
5022
5023 #. type: IP
5024 #: build/C/man4/fd.4:142
5025 #, no-wrap
5026 msgid "B<FDDEFPRM>"
5027 msgstr ""
5028
5029 #. type: Plain text
5030 #: build/C/man4/fd.4:148
5031 msgid ""
5032 "sets the media information of a drive (geometry of disk in drive).  The "
5033 "media information will not be lost when the media is changed.  This will "
5034 "disable autodetection.  In order to reenable autodetection, you have to "
5035 "issue an B<FDCLRPRM>."
5036 msgstr ""
5037
5038 #. type: IP
5039 #: build/C/man4/fd.4:148 build/C/man4/fd.4:160
5040 #, no-wrap
5041 msgid "B<FDGETDRVTYP>"
5042 msgstr ""
5043
5044 #. type: Plain text
5045 #: build/C/man4/fd.4:153
5046 msgid ""
5047 "returns the type of a drive (name parameter).  For formats which work in "
5048 "several drive types, B<FDGETDRVTYP> returns a name which is appropriate for "
5049 "the oldest drive type which supports this format."
5050 msgstr ""
5051
5052 #. type: IP
5053 #: build/C/man4/fd.4:153
5054 #, no-wrap
5055 msgid "B<FDFLUSH>"
5056 msgstr ""
5057
5058 #. type: Plain text
5059 #: build/C/man4/fd.4:155
5060 msgid "invalidates the buffer cache for the given drive."
5061 msgstr ""
5062
5063 #. type: IP
5064 #: build/C/man4/fd.4:155 build/C/man4/fd.4:158
5065 #, no-wrap
5066 msgid "B<FDSETMAXERRS>"
5067 msgstr ""
5068
5069 #. type: Plain text
5070 #: build/C/man4/fd.4:158
5071 msgid ""
5072 "sets the error thresholds for reporting errors, aborting the operation, "
5073 "recalibrating, resetting, and reading sector by sector."
5074 msgstr ""
5075
5076 #. type: Plain text
5077 #: build/C/man4/fd.4:160
5078 msgid "gets the current error thresholds."
5079 msgstr ""
5080
5081 #. type: Plain text
5082 #: build/C/man4/fd.4:162
5083 msgid "gets the internal name of the drive."
5084 msgstr ""
5085
5086 #. type: IP
5087 #: build/C/man4/fd.4:162
5088 #, no-wrap
5089 msgid "B<FDWERRORCLR>"
5090 msgstr ""
5091
5092 #. type: Plain text
5093 #: build/C/man4/fd.4:164
5094 msgid "clears the write error statistics."
5095 msgstr ""
5096
5097 #. type: IP
5098 #: build/C/man4/fd.4:164
5099 #, no-wrap
5100 msgid "B<FDWERRORGET>"
5101 msgstr ""
5102
5103 #. type: Plain text
5104 #: build/C/man4/fd.4:171
5105 msgid ""
5106 "reads the write error statistics.  These include the total number of write "
5107 "errors, the location and disk of the first write error, and the location and "
5108 "disk of the last write error.  Disks are identified by a generation number "
5109 "which is incremented at (almost) each disk change."
5110 msgstr ""
5111
5112 #. type: IP
5113 #: build/C/man4/fd.4:171
5114 #, no-wrap
5115 msgid "B<FDTWADDLE>"
5116 msgstr ""
5117
5118 #. type: Plain text
5119 #: build/C/man4/fd.4:175
5120 msgid ""
5121 "Switch the drive motor off for a few microseconds.  This might be needed in "
5122 "order to access a disk whose sectors are too close together."
5123 msgstr ""
5124
5125 #. type: IP
5126 #: build/C/man4/fd.4:175
5127 #, no-wrap
5128 msgid "B<FDSETDRVPRM>"
5129 msgstr ""
5130
5131 #. type: Plain text
5132 #: build/C/man4/fd.4:177
5133 msgid "sets various drive parameters."
5134 msgstr ""
5135
5136 #. type: IP
5137 #: build/C/man4/fd.4:177
5138 #, no-wrap
5139 msgid "B<FDGETDRVPRM>"
5140 msgstr ""
5141
5142 #. type: Plain text
5143 #: build/C/man4/fd.4:179
5144 msgid "reads these parameters back."
5145 msgstr ""
5146
5147 #. type: IP
5148 #: build/C/man4/fd.4:179
5149 #, no-wrap
5150 msgid "B<FDGETDRVSTAT>"
5151 msgstr ""
5152
5153 #. type: Plain text
5154 #: build/C/man4/fd.4:181
5155 msgid "gets the cached drive state (disk changed, write protected et al.)"
5156 msgstr ""
5157
5158 #. type: IP
5159 #: build/C/man4/fd.4:181
5160 #, no-wrap
5161 msgid "B<FDPOLLDRVSTAT>"
5162 msgstr ""
5163
5164 #. type: Plain text
5165 #: build/C/man4/fd.4:183
5166 msgid "polls the drive and return its state."
5167 msgstr ""
5168
5169 #. type: IP
5170 #: build/C/man4/fd.4:183
5171 #, no-wrap
5172 msgid "B<FDGETFDCSTAT>"
5173 msgstr ""
5174
5175 #. type: Plain text
5176 #: build/C/man4/fd.4:185
5177 msgid "gets the floppy controller state."
5178 msgstr ""
5179
5180 #. type: IP
5181 #: build/C/man4/fd.4:185
5182 #, no-wrap
5183 msgid "B<FDRESET>"
5184 msgstr ""
5185
5186 #. type: Plain text
5187 #: build/C/man4/fd.4:187
5188 msgid "resets the floppy controller under certain conditions."
5189 msgstr ""
5190
5191 #. type: IP
5192 #: build/C/man4/fd.4:187
5193 #, no-wrap
5194 msgid "B<FDRAWCMD>"
5195 msgstr ""
5196
5197 #. type: Plain text
5198 #: build/C/man4/fd.4:189
5199 msgid "sends a raw command to the floppy controller."
5200 msgstr ""
5201
5202 #. type: Plain text
5203 #: build/C/man4/fd.4:194
5204 msgid ""
5205 "For more precise information, consult also the I<E<lt>linux/fd.hE<gt>> and "
5206 "I<E<lt>linux/fdreg.hE<gt>> include files, as well as the B<floppycontrol>(1)  "
5207 "manual page."
5208 msgstr ""
5209
5210 #. type: Plain text
5211 #: build/C/man4/fd.4:196
5212 msgid "/dev/fd*"
5213 msgstr ""
5214
5215 #. type: Plain text
5216 #: build/C/man4/fd.4:202
5217 msgid ""
5218 "The various formats permit reading and writing many types of disks.  "
5219 "However, if a floppy is formatted with an inter-sector gap that is too "
5220 "small, performance may drop, to the point of needing a few seconds to access "
5221 "an entire track.  To prevent this, use interleaved formats."
5222 msgstr ""
5223
5224 #. type: Plain text
5225 #: build/C/man4/fd.4:206
5226 msgid ""
5227 "It is not possible to read floppies which are formatted using GCR (group "
5228 "code recording), which is used by Apple II and Macintosh computers (800k "
5229 "disks)."
5230 msgstr ""
5231
5232 #.  .SH AUTHORS
5233 #.  Alain Knaff (Alain.Knaff@imag.fr), David Niemi
5234 #.  (niemidc@clark.net), Bill Broadhurst (bbroad@netcom.com).
5235 #. type: Plain text
5236 #: build/C/man4/fd.4:213
5237 msgid ""
5238 "Reading floppies which are hard sectored (one hole per sector, with the "
5239 "index hole being a little skewed) is not supported.  This used to be common "
5240 "with older 8-inch floppies."
5241 msgstr ""
5242
5243 #. type: Plain text
5244 #: build/C/man4/fd.4:221
5245 msgid ""
5246 "B<chown>(1), B<floppycontrol>(1), B<getfdprm>(1), B<mknod>(1), "
5247 "B<superformat>(1), B<mount>(8), B<setfdprm>(8)"
5248 msgstr ""
5249
5250 #. type: TH
5251 #: build/C/man7/fifo.7:10
5252 #, no-wrap
5253 msgid "FIFO"
5254 msgstr ""
5255
5256 #. type: TH
5257 #: build/C/man7/fifo.7:10
5258 #, no-wrap
5259 msgid "2008-12-03"
5260 msgstr ""
5261
5262 #. type: Plain text
5263 #: build/C/man7/fifo.7:13
5264 msgid "fifo - first-in first-out special file, named pipe"
5265 msgstr ""
5266
5267 #. type: Plain text
5268 #: build/C/man7/fifo.7:25
5269 msgid ""
5270 "A FIFO special file (a named pipe) is similar to a pipe, except that it is "
5271 "accessed as part of the file system.  It can be opened by multiple processes "
5272 "for reading or writing.  When processes are exchanging data via the FIFO, "
5273 "the kernel passes all data internally without writing it to the file "
5274 "system.  Thus, the FIFO special file has no contents on the file system; the "
5275 "file system entry merely serves as a reference point so that processes can "
5276 "access the pipe using a name in the file system."
5277 msgstr ""
5278
5279 #. type: Plain text
5280 #: build/C/man7/fifo.7:32
5281 msgid ""
5282 "The kernel maintains exactly one pipe object for each FIFO special file that "
5283 "is opened by at least one process.  The FIFO must be opened on both ends "
5284 "(reading and writing)  before data can be passed.  Normally, opening the "
5285 "FIFO blocks until the other end is opened also."
5286 msgstr ""
5287
5288 #. type: Plain text
5289 #: build/C/man7/fifo.7:41
5290 msgid ""
5291 "A process can open a FIFO in nonblocking mode.  In this case, opening for "
5292 "read only will succeed even if no-one has opened on the write side yet, "
5293 "opening for write only will fail with B<ENXIO> (no such device or address) "
5294 "unless the other end has already been opened."
5295 msgstr ""
5296
5297 #. type: Plain text
5298 #: build/C/man7/fifo.7:51
5299 msgid ""
5300 "Under Linux, opening a FIFO for read and write will succeed both in blocking "
5301 "and nonblocking mode.  POSIX leaves this behavior undefined.  This can be "
5302 "used to open a FIFO for writing while there are no readers available.  A "
5303 "process that uses both ends of the connection in order to communicate with "
5304 "itself should be very careful to avoid deadlocks."
5305 msgstr ""
5306
5307 #. type: Plain text
5308 #: build/C/man7/fifo.7:56
5309 msgid ""
5310 "When a process tries to write to a FIFO that is not opened for read on the "
5311 "other side, the process is sent a B<SIGPIPE> signal."
5312 msgstr ""
5313
5314 #. type: Plain text
5315 #: build/C/man7/fifo.7:62
5316 msgid ""
5317 "FIFO special files can be created by B<mkfifo>(3), and are indicated by I<ls "
5318 "-l> with the file type \\(aqp\\(aq."
5319 msgstr ""
5320
5321 #. type: Plain text
5322 #: build/C/man7/fifo.7:71
5323 msgid ""
5324 "B<mkfifo>(1), B<open>(2), B<pipe>(2), B<sigaction>(2), B<signal>(2), "
5325 "B<socketpair>(2), B<mkfifo>(3), B<pipe>(7)"
5326 msgstr ""
5327
5328 #. type: TH
5329 #: build/C/man4/full.4:26
5330 #, no-wrap
5331 msgid "FULL"
5332 msgstr ""
5333
5334 #. type: TH
5335 #: build/C/man4/full.4:26
5336 #, no-wrap
5337 msgid "2007-11-24"
5338 msgstr ""
5339
5340 #. type: Plain text
5341 #: build/C/man4/full.4:29
5342 msgid "full - always full device"
5343 msgstr ""
5344
5345 #. type: Plain text
5346 #: build/C/man4/full.4:32
5347 msgid ""
5348 "If your system does not have I</dev/full> created already, it can be created "
5349 "with the following commands:"
5350 msgstr ""
5351
5352 #. type: Plain text
5353 #: build/C/man4/full.4:36
5354 #, no-wrap
5355 msgid ""
5356 "        mknod -m 666 /dev/full c 1 7\n"
5357 "        chown root:root /dev/full\n"
5358 msgstr ""
5359
5360 #. type: Plain text
5361 #: build/C/man4/full.4:40
5362 msgid "File I</dev/full> has major device number 1 and minor device number 7."
5363 msgstr ""
5364
5365 #. type: Plain text
5366 #: build/C/man4/full.4:45
5367 msgid ""
5368 "Writes to the I</dev/full> device will fail with an B<ENOSPC> error.  This "
5369 "can be used to test how a program handles disk-full errors."
5370 msgstr ""
5371
5372 #. type: Plain text
5373 #: build/C/man4/full.4:47
5374 msgid "Reads from the I</dev/full> device will return \\e0 characters."
5375 msgstr ""
5376
5377 #. type: Plain text
5378 #: build/C/man4/full.4:49
5379 msgid "Seeks on I</dev/full> will always succeed."
5380 msgstr ""
5381
5382 #. type: Plain text
5383 #: build/C/man4/full.4:51
5384 msgid "/dev/full"
5385 msgstr ""
5386
5387 #. type: Plain text
5388 #: build/C/man4/full.4:55
5389 msgid "B<mknod>(1), B<null>(4), B<zero>(4)"
5390 msgstr ""
5391
5392 #. type: TH
5393 #: build/C/man3/gnu_get_libc_version.3:24
5394 #, no-wrap
5395 msgid "GNU_GET_LIBC_VERSION"
5396 msgstr ""
5397
5398 #. type: TH
5399 #: build/C/man3/gnu_get_libc_version.3:24 build/C/man3/makedev.3:24
5400 #, no-wrap
5401 msgid "2010-09-10"
5402 msgstr ""
5403
5404 #. type: Plain text
5405 #: build/C/man3/gnu_get_libc_version.3:27
5406 msgid "gnu_get_libc_version, gnu_get_libc_release - get glibc version and release"
5407 msgstr ""
5408
5409 #. type: Plain text
5410 #: build/C/man3/gnu_get_libc_version.3:31
5411 #, no-wrap
5412 msgid ""
5413 "B<#define _GNU_SOURCE>             /* See feature_test_macros(7) */\n"
5414 "B<#include E<lt>gnu/libc-version.hE<gt>>\n"
5415 msgstr ""
5416
5417 #. type: Plain text
5418 #: build/C/man3/gnu_get_libc_version.3:34
5419 #, no-wrap
5420 msgid ""
5421 "B<const char *gnu_get_libc_version(void);>\n"
5422 "B<const char *gnu_get_libc_release(void);>\n"
5423 msgstr ""
5424
5425 #. type: Plain text
5426 #: build/C/man3/gnu_get_libc_version.3:39
5427 msgid ""
5428 "The function B<gnu_get_libc_version>()  returns a string that identifies the "
5429 "glibc version available on the system."
5430 msgstr ""
5431
5432 #. type: Plain text
5433 #: build/C/man3/gnu_get_libc_version.3:46
5434 msgid ""
5435 "The function B<gnu_get_libc_release>()  returns a string indicates the "
5436 "release status of the glibc version available on the system.  This will be a "
5437 "string such as I<stable>."
5438 msgstr ""
5439
5440 #. type: SH
5441 #: build/C/man3/gnu_get_libc_version.3:46 build/C/man4/vcs.4:86
5442 #, no-wrap
5443 msgid "VERSIONS"
5444 msgstr ""
5445
5446 #. type: Plain text
5447 #: build/C/man3/gnu_get_libc_version.3:48
5448 msgid "These functions first appeared in glibc in version 2.1."
5449 msgstr ""
5450
5451 #. type: SH
5452 #: build/C/man3/gnu_get_libc_version.3:48 build/C/man3/makedev.3:61 build/C/man3/mkfifo.3:100 build/C/man2/mknod.2:172 build/C/man3/setlogmask.3:67 build/C/man3/stdarg.3:210 build/C/man2/syslog.2:257 build/C/man3/syslog.3:245 build/C/man7/uri.7:579
5453 #, no-wrap
5454 msgid "CONFORMING TO"
5455 msgstr ""
5456
5457 #. type: Plain text
5458 #: build/C/man3/gnu_get_libc_version.3:50
5459 msgid "These functions are glibc-specific."
5460 msgstr ""
5461
5462 #. type: Plain text
5463 #: build/C/man3/gnu_get_libc_version.3:52
5464 msgid "When run, the program below will produce output such as the following:"
5465 msgstr ""
5466
5467 #. type: Plain text
5468 #: build/C/man3/gnu_get_libc_version.3:58
5469 #, no-wrap
5470 msgid ""
5471 "$B< ./a.out>\n"
5472 "GNU libc version: 2.8\n"
5473 "GNU libc release: stable\n"
5474 msgstr ""
5475
5476 #. type: Plain text
5477 #: build/C/man3/gnu_get_libc_version.3:66
5478 #, no-wrap
5479 msgid ""
5480 "#include E<lt>gnu/libc-version.hE<gt>\n"
5481 "#include E<lt>stdlib.hE<gt>\n"
5482 "#include E<lt>stdio.hE<gt>\n"
5483 msgstr ""
5484
5485 #. type: Plain text
5486 #: build/C/man3/gnu_get_libc_version.3:74
5487 #, no-wrap
5488 msgid ""
5489 "int\n"
5490 "main(int argc, char *argv[])\n"
5491 "{\n"
5492 "    printf(\"GNU libc version: %s\\en\", gnu_get_libc_version());\n"
5493 "    printf(\"GNU libc release: %s\\en\", gnu_get_libc_release());\n"
5494 "    exit(EXIT_SUCCESS);\n"
5495 "}\n"
5496 msgstr ""
5497
5498 #. type: Plain text
5499 #: build/C/man3/gnu_get_libc_version.3:77
5500 msgid "B<confstr>(3)"
5501 msgstr ""
5502
5503 #. type: TH
5504 #: build/C/man4/hd.4:28
5505 #, no-wrap
5506 msgid "HD"
5507 msgstr ""
5508
5509 #. type: TH
5510 #: build/C/man4/hd.4:28 build/C/man4/sd.4:24
5511 #, no-wrap
5512 msgid "1992-12-17"
5513 msgstr ""
5514
5515 #. type: Plain text
5516 #: build/C/man4/hd.4:31
5517 msgid "hd - MFM/IDE hard disk devices"
5518 msgstr ""
5519
5520 #. type: Plain text
5521 #: build/C/man4/hd.4:38
5522 msgid ""
5523 "The B<hd*> devices are block devices to access MFM/IDE hard disk drives in "
5524 "raw mode.  The master drive on the primary IDE controller (major device "
5525 "number 3) is B<hda>; the slave drive is B<hdb>.  The master drive of the "
5526 "second controller (major device number 22)  is B<hdc> and the slave B<hdd>."
5527 msgstr ""
5528
5529 #. type: Plain text
5530 #: build/C/man4/hd.4:62
5531 msgid ""
5532 "General IDE block device names have the form B<hd>I<X>, or B<hd>I<XP>, where "
5533 "I<X> is a letter denoting the physical drive, and I<P> is a number denoting "
5534 "the partition on that physical drive.  The first form, B<hd>I<X,> is used to "
5535 "address the whole drive.  Partition numbers are assigned in the order the "
5536 "partitions are discovered, and only nonempty, nonextended partitions get a "
5537 "number.  However, partition numbers 1-4 are given to the four partitions "
5538 "described in the MBR (the \"primary\" partitions), regardless of whether "
5539 "they are unused or extended.  Thus, the first logical partition will be "
5540 "B<hd>I<X>B<5>\\&.  Both DOS-type partitioning and BSD-disklabel partitioning "
5541 "are supported.  You can have at most 63 partitions on an IDE disk."
5542 msgstr ""
5543
5544 #. type: Plain text
5545 #: build/C/man4/hd.4:68
5546 msgid ""
5547 "For example, I</dev/hda> refers to all of the first IDE drive in the system; "
5548 "and I</dev/hdb3> refers to the third DOS \"primary\" partition on the second "
5549 "one."
5550 msgstr ""
5551
5552 #. type: Plain text
5553 #: build/C/man4/hd.4:70 build/C/man4/ttyS.4:32
5554 msgid "They are typically created by:"
5555 msgstr ""
5556
5557 #. type: Plain text
5558 #: build/C/man4/hd.4:73
5559 msgid "mknod -m 660 /dev/hda b 3 0"
5560 msgstr ""
5561
5562 #. type: Plain text
5563 #: build/C/man4/hd.4:75
5564 msgid "mknod -m 660 /dev/hda1 b 3 1"
5565 msgstr ""
5566
5567 #. type: Plain text
5568 #: build/C/man4/hd.4:77
5569 msgid "mknod -m 660 /dev/hda2 b 3 2"
5570 msgstr ""
5571
5572 #. type: Plain text
5573 #: build/C/man4/hd.4:79 build/C/man4/hd.4:89
5574 msgid "\\&..."
5575 msgstr ""
5576
5577 #. type: Plain text
5578 #: build/C/man4/hd.4:81
5579 msgid "mknod -m 660 /dev/hda8 b 3 8"
5580 msgstr ""
5581
5582 #. type: Plain text
5583 #: build/C/man4/hd.4:83
5584 msgid "mknod -m 660 /dev/hdb b 3 64"
5585 msgstr ""
5586
5587 #. type: Plain text
5588 #: build/C/man4/hd.4:85
5589 msgid "mknod -m 660 /dev/hdb1 b 3 65"
5590 msgstr ""
5591
5592 #. type: Plain text
5593 #: build/C/man4/hd.4:87
5594 msgid "mknod -m 660 /dev/hdb2 b 3 66"
5595 msgstr ""
5596
5597 #. type: Plain text
5598 #: build/C/man4/hd.4:91
5599 msgid "mknod -m 660 /dev/hdb8 b 3 72"
5600 msgstr ""
5601
5602 #. type: Plain text
5603 #: build/C/man4/hd.4:93
5604 msgid "chown root:disk /dev/hd*"
5605 msgstr ""
5606
5607 #. type: Plain text
5608 #: build/C/man4/hd.4:96
5609 msgid "/dev/hd*"
5610 msgstr ""
5611
5612 #. type: Plain text
5613 #: build/C/man4/hd.4:101
5614 msgid "B<chown>(1), B<mknod>(1), B<sd>(4), B<mount>(8)"
5615 msgstr ""
5616
5617 #. type: TH
5618 #: build/C/man4/hpsa.4:7
5619 #, no-wrap
5620 msgid "HPSA"
5621 msgstr ""
5622
5623 #. type: Plain text
5624 #: build/C/man4/hpsa.4:10
5625 msgid "hpsa - HP Smart Array SCSI driver"
5626 msgstr ""
5627
5628 #. type: Plain text
5629 #: build/C/man4/hpsa.4:13
5630 #, no-wrap
5631 msgid "modprobe hpsa [ hpsa_allow_any=1 ]\n"
5632 msgstr ""
5633
5634 #. type: Plain text
5635 #: build/C/man4/hpsa.4:17
5636 msgid "B<hpsa> is a SCSI driver for HP Smart Array RAID controllers."
5637 msgstr ""
5638
5639 #. type: Plain text
5640 #: build/C/man4/hpsa.4:36
5641 msgid ""
5642 "I<hpsa_allow_any=1>: This option allows the driver to attempt to operate on "
5643 "any HP Smart Array hardware RAID controller, even if it is not explicitly "
5644 "known to the driver.  This allows newer hardware to work with older "
5645 "drivers.  Typically this is used to allow installation of operating systems "
5646 "from media that predates the RAID controller, though it may also be used to "
5647 "enable B<hpsa> to drive older controllers that would normally be handled by "
5648 "the B<cciss>(4)  driver.  These older boards have not been tested and are "
5649 "not supported with B<hpsa>, and B<cciss>(4)  should still be used for these."
5650 msgstr ""
5651
5652 #. type: Plain text
5653 #: build/C/man4/hpsa.4:40
5654 msgid "The B<hpsa> driver supports the following Smart Array boards:"
5655 msgstr ""
5656
5657 #. type: Plain text
5658 #: build/C/man4/hpsa.4:51
5659 #, no-wrap
5660 msgid ""
5661 "    Smart Array P700M\n"
5662 "    Smart Array P212\n"
5663 "    Smart Array P410\n"
5664 "    Smart Array P410i\n"
5665 "    Smart Array P411\n"
5666 "    Smart Array P812\n"
5667 "    Smart Array P712m\n"
5668 "    Smart Array P711m\n"
5669 "    StorageWorks P1210m\n"
5670 msgstr ""
5671
5672 #. type: Plain text
5673 #: build/C/man4/hpsa.4:76
5674 msgid ""
5675 "Logical drives are accessed via the SCSI disk driver (B<sd>(4)), tape drives "
5676 "via the SCSI tape driver (B<st>(4)), and the RAID controller via the SCSI "
5677 "generic driver (B<sg>(4)), with device nodes named I</dev/sd*,> I</dev/st*>, "
5678 "and I</dev/sg*>, respectively."
5679 msgstr ""
5680
5681 #. type: SS
5682 #: build/C/man4/hpsa.4:76
5683 #, no-wrap
5684 msgid "HPSA-Specific Host Attribute Files in /sys"
5685 msgstr ""
5686
5687 #. type: TP
5688 #: build/C/man4/hpsa.4:77
5689 #, no-wrap
5690 msgid "I</sys/class/scsi_host/host*/rescan>"
5691 msgstr ""
5692
5693 #. type: Plain text
5694 #: build/C/man4/hpsa.4:91
5695 msgid ""
5696 "This is a write-only attribute.  Writing to this attribute will cause the "
5697 "driver to scan for new, changed, or removed devices (e.g. hot-plugged tape "
5698 "drives, or newly configured or deleted logical drives, etc.)  and notify the "
5699 "SCSI midlayer of any changes detected.  Normally a rescan is triggered "
5700 "automatically by HP's Array Configuration Utility (either the GUI or the "
5701 "command-line variety); thus, for logical drive changes, the user should not "
5702 "normally have to use this attribute.  This attribute may be useful when hot "
5703 "plugging devices like tape drives, or entire storage boxes containing "
5704 "pre-configured logical drives."
5705 msgstr ""
5706
5707 #. type: TP
5708 #: build/C/man4/hpsa.4:91
5709 #, no-wrap
5710 msgid "I</sys/class/scsi_host/host*/firmware_revision>"
5711 msgstr ""
5712
5713 #. type: Plain text
5714 #: build/C/man4/hpsa.4:94
5715 msgid "This attribute contains the firmware version of the Smart Array."
5716 msgstr ""
5717
5718 #. type: Plain text
5719 #: build/C/man4/hpsa.4:96
5720 msgid "For example:"
5721 msgstr ""
5722
5723 #. type: Plain text
5724 #: build/C/man4/hpsa.4:101
5725 #, no-wrap
5726 msgid ""
5727 "    # B<cd /sys/class/scsi_host/host4>\n"
5728 "    # B<cat firmware_revision>\n"
5729 "    7.14\n"
5730 msgstr ""
5731
5732 #. type: SS
5733 #: build/C/man4/hpsa.4:103
5734 #, no-wrap
5735 msgid "HPSA-Specific Disk Attribute Files in /sys"
5736 msgstr ""
5737
5738 #. type: TP
5739 #: build/C/man4/hpsa.4:104
5740 #, no-wrap
5741 msgid "I</sys/class/scsi_disk/c:b:t:l/device/unique_id>"
5742 msgstr ""
5743
5744 #. type: Plain text
5745 #: build/C/man4/hpsa.4:107
5746 msgid "This attribute contains a 32 hex-digit unique ID for each logical drive."
5747 msgstr ""
5748
5749 #. type: Plain text
5750 #: build/C/man4/hpsa.4:110 build/C/man4/hpsa.4:121 build/C/man4/hpsa.4:135
5751 #, no-wrap
5752 msgid "For example:\n"
5753 msgstr ""
5754
5755 #. type: Plain text
5756 #: build/C/man4/hpsa.4:114
5757 #, no-wrap
5758 msgid ""
5759 "    # B<cd /sys/class/scsi_disk/4:0:0:0/device>\n"
5760 "    # B<cat unique_id>\n"
5761 "    600508B1001044395355323037570F77\n"
5762 msgstr ""
5763
5764 #. type: TP
5765 #: build/C/man4/hpsa.4:115
5766 #, no-wrap
5767 msgid "I</sys/class/scsi_disk/c:b:t:l/device/raid_level>"
5768 msgstr ""
5769
5770 #. type: Plain text
5771 #: build/C/man4/hpsa.4:118
5772 msgid "This attribute contains the RAID level of each logical drive."
5773 msgstr ""
5774
5775 #. type: Plain text
5776 #: build/C/man4/hpsa.4:125
5777 #, no-wrap
5778 msgid ""
5779 "    # B<cd /sys/class/scsi_disk/4:0:0:0/device>\n"
5780 "    # B<cat raid_level>\n"
5781 "    RAID 0\n"
5782 msgstr ""
5783
5784 #. type: TP
5785 #: build/C/man4/hpsa.4:126
5786 #, no-wrap
5787 msgid "I</sys/class/scsi_disk/c:b:t:l/device/lunid>"
5788 msgstr ""
5789
5790 #. type: Plain text
5791 #: build/C/man4/hpsa.4:132
5792 msgid ""
5793 "This attribute contains the 16 hex-digit (8 byte) LUN ID by which a logical "
5794 "drive or physical device can be addressed.  I<c>:I<b>:I<t>:I<l> are the "
5795 "controller, bus, target and lun of the device."
5796 msgstr ""
5797
5798 #. type: Plain text
5799 #: build/C/man4/hpsa.4:139
5800 #, no-wrap
5801 msgid ""
5802 "    # B<cd /sys/class/scsi_disk/4:0:0:0/device>\n"
5803 "    # B<cat lunid>\n"
5804 "    0x0000004000000000\n"
5805 msgstr ""
5806
5807 #. type: SS
5808 #: build/C/man4/hpsa.4:140
5809 #, no-wrap
5810 msgid "Supported ioctl() operations"
5811 msgstr ""
5812
5813 #. type: Plain text
5814 #: build/C/man4/hpsa.4:152
5815 msgid ""
5816 "For compatibility with applications written for the B<cciss>(4)  driver, "
5817 "many, but not all of the ioctls supported by the B<cciss>(4)  driver are "
5818 "also supported by the B<hpsa> driver.  The data structures used by these "
5819 "ioctls are described in the kernel source file "
5820 "I<include/linux/cciss_ioctl.h>."
5821 msgstr ""
5822
5823 #. type: TP
5824 #: build/C/man4/hpsa.4:152
5825 #, no-wrap
5826 msgid "B<CCISS_DEREGDISK>, B<CCISS_REGNEWDISK>, B<CCISS_REGNEWD>"
5827 msgstr ""
5828
5829 #. type: Plain text
5830 #: build/C/man4/hpsa.4:158
5831 msgid ""
5832 "These three ioctls all do exactly the same thing, which is to cause the "
5833 "driver to rescan for new devices.  This does exactly the same thing as "
5834 "writing to the hpsa-specific host \"rescan\" attribute."
5835 msgstr ""
5836
5837 #. type: TP
5838 #: build/C/man4/hpsa.4:158
5839 #, no-wrap
5840 msgid "B<CCISS_GETPCIINFO>"
5841 msgstr ""
5842
5843 #. type: Plain text
5844 #: build/C/man4/hpsa.4:161
5845 msgid ""
5846 "Returns PCI domain, bus, device and function and \"board ID\" (PCI subsystem "
5847 "ID)."
5848 msgstr ""
5849
5850 #. type: TP
5851 #: build/C/man4/hpsa.4:161
5852 #, no-wrap
5853 msgid "B<CCISS_GETDRIVVER>"
5854 msgstr ""
5855
5856 #. type: Plain text
5857 #: build/C/man4/hpsa.4:164
5858 msgid "Returns driver version in three bytes encoded as:"
5859 msgstr ""
5860
5861 #. type: Plain text
5862 #: build/C/man4/hpsa.4:167
5863 #, no-wrap
5864 msgid ""
5865 "    (major_version E<lt>E<lt> 16) | (minor_version E<lt>E<lt> 8) |\n"
5866 "        (subminor_version)\n"
5867 msgstr ""
5868
5869 #. type: TP
5870 #: build/C/man4/hpsa.4:167
5871 #, no-wrap
5872 msgid "B<CCISS_PASSTHRU>, B<CCISS_BIG_PASSTHRU>"
5873 msgstr ""
5874
5875 #. type: Plain text
5876 #: build/C/man4/hpsa.4:177
5877 msgid ""
5878 "Allows \"BMIC\" and \"CISS\" commands to be passed through to the Smart "
5879 "Array.  These are used extensively by the HP Array Configuration Utility, "
5880 "SNMP storage agents, etc.  See I<cciss_vol_status> at I<http://cciss.sf.net> "
5881 "for some examples."
5882 msgstr ""
5883
5884 #.  .SH AUTHORS
5885 #.  Don Brace, Steve Cameron, Tom Lawler, Mike Miller, Scott Teel
5886 #.  and probably some other people.
5887 #. type: Plain text
5888 #: build/C/man4/hpsa.4:192
5889 msgid ""
5890 "B<cciss>(4), B<sd>(4), B<st>(4), B<cciss_vol_status>(8), B<hpacucli>(8), "
5891 "B<hpacuxe>(8), I<http://cciss.sf.net>, and the Linux kernel source files "
5892 "I<Documentation/scsi/hpsa.txt> and "
5893 "I<Documentation/ABI/testing/sysfs-bus-pci-devices-cciss>"
5894 msgstr ""
5895
5896 #. type: TH
5897 #: build/C/man4/initrd.4:34
5898 #, no-wrap
5899 msgid "INITRD"
5900 msgstr ""
5901
5902 #. type: TH
5903 #: build/C/man4/initrd.4:34 build/C/man4/st.4:23
5904 #, no-wrap
5905 msgid "2010-09-04"
5906 msgstr ""
5907
5908 #. type: Plain text
5909 #: build/C/man4/initrd.4:37
5910 msgid "initrd - boot loader initialized RAM disk"
5911 msgstr ""
5912
5913 #. type: Plain text
5914 #: build/C/man4/initrd.4:50
5915 msgid ""
5916 "The I</dev/initrd> is a read-only block device assigned major number 1 and "
5917 "minor number 250.  Typically I</dev/initrd> is owned by I<root.disk> with "
5918 "mode 0400 (read access by root only).  If the Linux system does not have "
5919 "I</dev/initrd> already created, it can be created with the following "
5920 "commands:"
5921 msgstr ""
5922
5923 #. type: Plain text
5924 #: build/C/man4/initrd.4:55
5925 #, no-wrap
5926 msgid ""
5927 "B<\n"
5928 "        mknod -m 400 /dev/initrd b 1 250\n"
5929 "        chown root:disk /dev/initrd>\n"
5930 "\n"
5931 msgstr ""
5932
5933 #. type: Plain text
5934 #: build/C/man4/initrd.4:70
5935 msgid ""
5936 "Also, support for both \"RAM disk\" and \"Initial RAM disk\" (e.g.  "
5937 "B<CONFIG_BLK_DEV_RAM=y> and B<CONFIG_BLK_DEV_INITRD=y>)  must be compiled "
5938 "directly into the Linux kernel to use I</dev/initrd>.  When using "
5939 "I</dev/initrd>, the RAM disk driver cannot be loaded as a module."
5940 msgstr ""
5941
5942 #. type: Plain text
5943 #: build/C/man4/initrd.4:79
5944 msgid ""
5945 "The special file I</dev/initrd> is a read-only block device.  This device is "
5946 "a RAM disk that is initialized (e.g., loaded)  by the boot loader before the "
5947 "kernel is started.  The kernel then can use I</dev/initrd>'s contents for a "
5948 "two-phase system boot-up."
5949 msgstr ""
5950
5951 #. type: Plain text
5952 #: build/C/man4/initrd.4:92
5953 msgid ""
5954 "In the first boot-up phase, the kernel starts up and mounts an initial root "
5955 "file-system from the contents of I</dev/initrd> (e.g., RAM disk initialized "
5956 "by the boot loader).  In the second phase, additional drivers or other "
5957 "modules are loaded from the initial root device's contents.  After loading "
5958 "the additional modules, a new root file system (i.e., the normal root file "
5959 "system) is mounted from a different device."
5960 msgstr ""
5961
5962 #. type: SS
5963 #: build/C/man4/initrd.4:92
5964 #, no-wrap
5965 msgid "Boot-up Operation"
5966 msgstr ""
5967
5968 #. type: Plain text
5969 #: build/C/man4/initrd.4:96
5970 msgid "When booting up with B<initrd>, the system boots as follows:"
5971 msgstr ""
5972
5973 #. type: Plain text
5974 #: build/C/man4/initrd.4:100
5975 msgid ""
5976 "The boot loader loads the kernel program and I</dev/initrd>'s contents into "
5977 "memory."
5978 msgstr ""
5979
5980 #. type: Plain text
5981 #: build/C/man4/initrd.4:108
5982 msgid ""
5983 "On kernel startup, the kernel uncompresses and copies the contents of the "
5984 "device I</dev/initrd> onto device I</dev/ram0> and then frees the memory "
5985 "used by I</dev/initrd>."
5986 msgstr ""
5987
5988 #. type: IP
5989 #: build/C/man4/initrd.4:108 build/C/man4/initrd.4:338 build/C/man4/initrd.4:457 build/C/man4/st.4:918
5990 #, no-wrap
5991 msgid "3."
5992 msgstr ""
5993
5994 #. type: Plain text
5995 #: build/C/man4/initrd.4:112
5996 msgid ""
5997 "The kernel then read-write mounts the device I</dev/ram0> as the initial "
5998 "root file system."
5999 msgstr ""
6000
6001 #. type: IP
6002 #: build/C/man4/initrd.4:112 build/C/man4/initrd.4:342 build/C/man4/st.4:925
6003 #, no-wrap
6004 msgid "4."
6005 msgstr ""
6006
6007 #. type: Plain text
6008 #: build/C/man4/initrd.4:117
6009 msgid ""
6010 "If the indicated normal root file system is also the initial root "
6011 "file-system (e.g.  I</dev/ram0>)  then the kernel skips to the last step for "
6012 "the usual boot sequence."
6013 msgstr ""
6014
6015 #. type: IP
6016 #: build/C/man4/initrd.4:117 build/C/man4/initrd.4:348 build/C/man4/st.4:930
6017 #, no-wrap
6018 msgid "5."
6019 msgstr ""
6020
6021 #. type: Plain text
6022 #: build/C/man4/initrd.4:129
6023 msgid ""
6024 "If the executable file I</linuxrc> is present in the initial root "
6025 "file-system, I</linuxrc> is executed with UID 0.  (The file I</linuxrc> must "
6026 "have executable permission.  The file I</linuxrc> can be any valid "
6027 "executable, including a shell script.)"
6028 msgstr ""
6029
6030 #. type: IP
6031 #: build/C/man4/initrd.4:129 build/C/man4/initrd.4:357
6032 #, no-wrap
6033 msgid "6."
6034 msgstr ""
6035
6036 #. type: Plain text
6037 #: build/C/man4/initrd.4:141
6038 msgid ""
6039 "If I</linuxrc> is not executed or when I</linuxrc> terminates, the normal "
6040 "root file system is mounted.  (If I</linuxrc> exits with any file-systems "
6041 "mounted on the initial root file-system, then the behavior of the kernel is "
6042 "B<UNSPECIFIED>.  See the NOTES section for the current kernel behavior.)"
6043 msgstr ""
6044
6045 #. type: IP
6046 #: build/C/man4/initrd.4:141 build/C/man4/initrd.4:359
6047 #, no-wrap
6048 msgid "7."
6049 msgstr ""
6050
6051 #. type: Plain text
6052 #: build/C/man4/initrd.4:172
6053 msgid ""
6054 "If the normal root file system has a directory I</initrd>, the device "
6055 "I</dev/ram0> is moved from I</> to I</initrd>.  Otherwise if the directory "
6056 "I</initrd> does not exist, the device I</dev/ram0> is unmounted.  (When "
6057 "moved from I</> to I</initrd>, I</dev/ram0> is not unmounted and therefore "
6058 "processes can remain running from I</dev/ram0>.  If directory I</initrd> "
6059 "does not exist on the normal root file system and any processes remain "
6060 "running from I</dev/ram0> when I</linuxrc> exits, the behavior of the kernel "
6061 "is B<UNSPECIFIED>.  See the NOTES section for the current kernel behavior.)"
6062 msgstr ""
6063
6064 #. type: IP
6065 #: build/C/man4/initrd.4:172 build/C/man4/initrd.4:362
6066 #, no-wrap
6067 msgid "8."
6068 msgstr ""
6069
6070 #. type: Plain text
6071 #: build/C/man4/initrd.4:179
6072 msgid ""
6073 "The usual boot sequence (e.g., invocation of I</sbin/init>)  is performed on "
6074 "the normal root file system."
6075 msgstr ""
6076
6077 #. type: Plain text
6078 #: build/C/man4/initrd.4:183
6079 msgid ""
6080 "The following boot loader options, when used with B<initrd>, affect the "
6081 "kernel's boot-up operation:"
6082 msgstr ""
6083
6084 #. type: TP
6085 #: build/C/man4/initrd.4:183
6086 #, no-wrap
6087 msgid "B<initrd=>I<filename>"
6088 msgstr ""
6089
6090 #. type: Plain text
6091 #: build/C/man4/initrd.4:198
6092 msgid ""
6093 "Specifies the file to load as the contents of I</dev/initrd>.  For "
6094 "B<LOADLIN> this is a command-line option.  For B<LILO> you have to use this "
6095 "command in the B<LILO> configuration file I</etc/lilo.config>.  The filename "
6096 "specified with this option will typically be a gzipped file-system image."
6097 msgstr ""
6098
6099 #. type: TP
6100 #: build/C/man4/initrd.4:198
6101 #, no-wrap
6102 msgid "I<noinitrd>"
6103 msgstr ""
6104
6105 #. type: Plain text
6106 #: build/C/man4/initrd.4:213
6107 msgid ""
6108 "This boot option disables the two-phase boot-up operation.  The kernel "
6109 "performs the usual boot sequence as if I</dev/initrd> was not initialized.  "
6110 "With this option, any contents of I</dev/initrd> loaded into memory by the "
6111 "boot loader contents are preserved.  This option permits the contents of "
6112 "I</dev/initrd> to be any data and need not be limited to a file system "
6113 "image.  However, device I</dev/initrd> is read-only and can be read only one "
6114 "time after system startup."
6115 msgstr ""
6116
6117 #. type: TP
6118 #: build/C/man4/initrd.4:213
6119 #, no-wrap
6120 msgid "B<root=>I<device-name>"
6121 msgstr ""
6122
6123 #. type: Plain text
6124 #: build/C/man4/initrd.4:231
6125 msgid ""
6126 "Specifies the device to be used as the normal root file system.  For "
6127 "B<LOADLIN> this is a command-line option.  For B<LILO> this is a boot time "
6128 "option or can be used as an option line in the B<LILO> configuration file "
6129 "I</etc/lilo.config>.  The device specified by the this option must be a "
6130 "mountable device having a suitable root file-system."
6131 msgstr ""
6132
6133 #. type: SS
6134 #: build/C/man4/initrd.4:231
6135 #, no-wrap
6136 msgid "Changing the Normal Root File System"
6137 msgstr ""
6138
6139 #. type: Plain text
6140 #: build/C/man4/initrd.4:251
6141 msgid ""
6142 "By default, the kernel's settings (e.g., set in the kernel file with "
6143 "B<rdev>(8)  or compiled into the kernel file), or the boot loader option "
6144 "setting is used for the normal root file systems.  For an NFS-mounted normal "
6145 "root file system, one has to use the B<nfs_root_name> and B<nfs_root_addrs> "
6146 "boot options to give the NFS settings.  For more information on NFS-mounted "
6147 "root see the kernel documentation file "
6148 "B<Documentation/filesystems/nfsroot.txt>.  For more information on setting "
6149 "the root file system see also the B<LILO> and B<LOADLIN> documentation."
6150 msgstr ""
6151
6152 #. type: Plain text
6153 #: build/C/man4/initrd.4:283
6154 msgid ""
6155 "It is also possible for the I</linuxrc> executable to change the normal root "
6156 "device.  For I</linuxrc> to change the normal root device, I</proc> must be "
6157 "mounted.  After mounting I</proc>, I</linuxrc> changes the normal root "
6158 "device by writing into the proc files I</proc/sys/kernel/real-root-dev>, "
6159 "I</proc/sys/kernel/nfs-root-name>, and I</proc/sys/kernel/nfs-root-addrs>.  "
6160 "For a physical root device, the root device is changed by having I</linuxrc> "
6161 "write the new root file system device number into "
6162 "I</proc/sys/kernel/real-root-dev>.  For an NFS root file system, the root "
6163 "device is changed by having I</linuxrc> write the NFS setting into files "
6164 "I</proc/sys/kernel/nfs-root-name> and I</proc/sys/kernel/nfs-root-addrs> and "
6165 "then writing 0xff (e.g., the pseudo-NFS-device number) into file "
6166 "I</proc/sys/kernel/real-root-dev>.  For example, the following shell command "
6167 "line would change the normal root device to I</dev/hdb1>:"
6168 msgstr ""
6169
6170 #. type: Plain text
6171 #: build/C/man4/initrd.4:286
6172 #, no-wrap
6173 msgid "    echo 0x365 E<gt>/proc/sys/kernel/real-root-dev\n"
6174 msgstr ""
6175
6176 #. type: Plain text
6177 #: build/C/man4/initrd.4:293
6178 msgid ""
6179 "For an NFS example, the following shell command lines would change the "
6180 "normal root device to the NFS directory I</var/nfsroot> on a local networked "
6181 "NFS server with IP number 193.8.232.7 for a system with IP number "
6182 "193.8.232.2 and named \"idefix\":"
6183 msgstr ""
6184
6185 #. type: Plain text
6186 #: build/C/man4/initrd.4:299
6187 #, no-wrap
6188 msgid ""
6189 "    echo /var/nfsroot E<gt>/proc/sys/kernel/nfs-root-name\n"
6190 "    echo 193.8.232.2:193.8.232.7::255.255.255.0:idefix \\e\n"
6191 "        E<gt>/proc/sys/kernel/nfs-root-addrs\n"
6192 "    echo 255 E<gt>/proc/sys/kernel/real-root-dev\n"
6193 msgstr ""
6194
6195 #.  FIXME the manual page should describe the pivot_root mechanism.
6196 #. type: Plain text
6197 #: build/C/man4/initrd.4:316
6198 msgid ""
6199 "B<Note>: The use of I</proc/sys/kernel/real-root-dev> to change the root "
6200 "file system is obsolete.  See the kernel source file "
6201 "I<Documentation/initrd.txt> as well as B<pivot_root>(2)  and "
6202 "B<pivot_root>(8)  for information on the modern method of changing the root "
6203 "file system."
6204 msgstr ""
6205
6206 #. type: SS
6207 #: build/C/man4/initrd.4:316 build/C/man4/random.4:52 build/C/man7/uri.7:108
6208 #, no-wrap
6209 msgid "Usage"
6210 msgstr ""
6211
6212 #. type: Plain text
6213 #: build/C/man4/initrd.4:320
6214 msgid ""
6215 "The main motivation for implementing B<initrd> was to allow for modular "
6216 "kernel configuration at system installation."
6217 msgstr ""
6218
6219 #. type: Plain text
6220 #: build/C/man4/initrd.4:322
6221 msgid "A possible system installation scenario is as follows:"
6222 msgstr ""
6223
6224 #. type: Plain text
6225 #: build/C/man4/initrd.4:330
6226 msgid ""
6227 "The loader program boots from floppy or other media with a minimal kernel "
6228 "(e.g., support for I</dev/ram>, I</dev/initrd>, and the ext2 file-system) "
6229 "and loads I</dev/initrd> with a gzipped version of the initial file-system."
6230 msgstr ""
6231
6232 #. type: Plain text
6233 #: build/C/man4/initrd.4:338
6234 msgid ""
6235 "The executable I</linuxrc> determines what is needed to (1) mount the normal "
6236 "root file-system (i.e., device type, device drivers, file system) and (2) "
6237 "the distribution media (e.g., CD-ROM, network, tape, ...).  This can be done "
6238 "by asking the user, by auto-probing, or by using a hybrid approach."
6239 msgstr ""
6240
6241 #. type: Plain text
6242 #: build/C/man4/initrd.4:342
6243 msgid ""
6244 "The executable I</linuxrc> loads the necessary modules from the initial root "
6245 "file-system."
6246 msgstr ""
6247
6248 #. type: Plain text
6249 #: build/C/man4/initrd.4:348
6250 msgid ""
6251 "The executable I</linuxrc> creates and populates the root file system.  (At "
6252 "this stage the normal root file system does not have to be a completed "
6253 "system yet.)"
6254 msgstr ""
6255
6256 #. type: Plain text
6257 #: build/C/man4/initrd.4:357
6258 msgid ""
6259 "The executable I</linuxrc> sets I</proc/sys/kernel/real-root-dev>, unmount "
6260 "I</proc>, the normal root file system and any other file systems it has "
6261 "mounted, and then terminates."
6262 msgstr ""
6263
6264 #. type: Plain text
6265 #: build/C/man4/initrd.4:359
6266 msgid "The kernel then mounts the normal root file system."
6267 msgstr ""
6268
6269 #. type: Plain text
6270 #: build/C/man4/initrd.4:362
6271 msgid ""
6272 "Now that the file system is accessible and intact, the boot loader can be "
6273 "installed."
6274 msgstr ""
6275
6276 #. type: Plain text
6277 #: build/C/man4/initrd.4:371
6278 msgid ""
6279 "The boot loader is configured to load into I</dev/initrd> a file system with "
6280 "the set of modules that was used to bring up the system.  (e.g., Device "
6281 "I</dev/ram0> can be modified, then unmounted, and finally, the image is "
6282 "written from I</dev/ram0> to a file.)"
6283 msgstr ""
6284
6285 #. type: IP
6286 #: build/C/man4/initrd.4:371
6287 #, no-wrap
6288 msgid "9."
6289 msgstr ""
6290
6291 #. type: Plain text
6292 #: build/C/man4/initrd.4:374
6293 msgid ""
6294 "The system is now bootable and additional installation tasks can be "
6295 "performed."
6296 msgstr ""
6297
6298 #. type: Plain text
6299 #: build/C/man4/initrd.4:380
6300 msgid ""
6301 "The key role of I</dev/initrd> in the above is to reuse the configuration "
6302 "data during normal system operation without requiring initial kernel "
6303 "selection, a large generic kernel or, recompiling the kernel."
6304 msgstr ""
6305
6306 #. type: Plain text
6307 #: build/C/man4/initrd.4:393
6308 msgid ""
6309 "A second scenario is for installations where Linux runs on systems with "
6310 "different hardware configurations in a single administrative network.  In "
6311 "such cases, it may be desirable to use only a small set of kernels (ideally "
6312 "only one) and to keep the system-specific part of configuration information "
6313 "as small as possible.  In this case, create a common file with all needed "
6314 "modules.  Then, only the I</linuxrc> file or a file executed by I</linuxrc> "
6315 "would be different."
6316 msgstr ""
6317
6318 #. type: Plain text
6319 #: build/C/man4/initrd.4:400
6320 msgid ""
6321 "A third scenario is more convenient recovery disks.  Because information "
6322 "like the location of the root file-system partition is not needed at boot "
6323 "time, the system loaded from I</dev/initrd> can use a dialog and/or "
6324 "auto-detection followed by a possible sanity check."
6325 msgstr ""
6326
6327 #. type: Plain text
6328 #: build/C/man4/initrd.4:417
6329 msgid ""
6330 "Last but not least, Linux distributions on CD-ROM may use B<initrd> for easy "
6331 "installation from the CD-ROM.  The distribution can use B<LOADLIN> to "
6332 "directly load I</dev/initrd> from CD-ROM without the need of any floppies.  "
6333 "The distribution could also use a B<LILO> boot floppy and then bootstrap a "
6334 "bigger RAM disk via I</dev/initrd> from the CD-ROM."
6335 msgstr ""
6336
6337 #. type: Plain text
6338 #: build/C/man4/initrd.4:419
6339 msgid "I</dev/initrd>"
6340 msgstr ""
6341
6342 #. type: Plain text
6343 #: build/C/man4/initrd.4:421
6344 msgid "I</dev/ram0>"
6345 msgstr ""
6346
6347 #. type: Plain text
6348 #: build/C/man4/initrd.4:423
6349 msgid "I</linuxrc>"
6350 msgstr ""
6351
6352 #. type: Plain text
6353 #: build/C/man4/initrd.4:428
6354 msgid "I</initrd>"
6355 msgstr ""
6356
6357 #. type: Plain text
6358 #: build/C/man4/initrd.4:440
6359 msgid ""
6360 "With the current kernel, any file systems that remain mounted when "
6361 "I</dev/ram0> is moved from I</> to I</initrd> continue to be accessible.  "
6362 "However, the I</proc/mounts> entries are not updated."
6363 msgstr ""
6364
6365 #. type: Plain text
6366 #: build/C/man4/initrd.4:457
6367 msgid ""
6368 "With the current kernel, if directory I</initrd> does not exist, then "
6369 "I</dev/ram0> will B<not> be fully unmounted if I</dev/ram0> is used by any "
6370 "process or has any file-system mounted on it.  If I</dev/ram0> is B<not> "
6371 "fully unmounted, then I</dev/ram0> will remain in memory."
6372 msgstr ""
6373
6374 #
6375 #
6376 #
6377 #.  .SH AUTHORS
6378 #.  The kernel code for device
6379 #.  .BR initrd
6380 #.  was written by Werner Almesberger <almesber@lrc.epfl.ch> and
6381 #.  Hans Lermen <lermen@elserv.ffm.fgan.de>.
6382 #.  The code for
6383 #.  .BR initrd
6384 #.  was added to the baseline Linux kernel in development version 1.3.73.
6385 #. type: Plain text
6386 #: build/C/man4/initrd.4:473
6387 msgid ""
6388 "Users of I</dev/initrd> should not depend on the behavior give in the above "
6389 "notes.  The behavior may change in future versions of the Linux kernel."
6390 msgstr ""
6391
6392 #. type: Plain text
6393 #: build/C/man4/initrd.4:479
6394 msgid "B<chown>(1), B<mknod>(1), B<ram>(4), B<freeramdisk>(8), B<rdev>(8)"
6395 msgstr ""
6396
6397 #. type: Plain text
6398 #: build/C/man4/initrd.4:484
6399 msgid ""
6400 "The documentation file I<initrd.txt> in the kernel source package, the LILO "
6401 "documentation, the LOADLIN documentation, the SYSLINUX documentation."
6402 msgstr ""
6403
6404 #. type: TH
6405 #: build/C/man4/lp.4:26
6406 #, no-wrap
6407 msgid "LP"
6408 msgstr ""
6409
6410 #. type: TH
6411 #: build/C/man4/lp.4:26
6412 #, no-wrap
6413 msgid "1995-01-15"
6414 msgstr ""
6415
6416 #. type: Plain text
6417 #: build/C/man4/lp.4:29
6418 msgid "lp - line printer devices"
6419 msgstr ""
6420
6421 #. type: Plain text
6422 #: build/C/man4/lp.4:31
6423 msgid "B<#include E<lt>linux/lp.hE<gt>>"
6424 msgstr ""
6425
6426 #. type: Plain text
6427 #: build/C/man4/lp.4:42
6428 msgid ""
6429 "B<lp>[0\\(en2] are character devices for the parallel line printers; they "
6430 "have major number 6 and minor number 0\\(en2.  The minor numbers correspond "
6431 "to the printer port base addresses 0x03bc, 0x0378 and 0x0278.  Usually they "
6432 "have mode 220 and are owned by root and group lp.  You can use printer ports "
6433 "either with polling or with interrupts.  Interrupts are recommended when "
6434 "high traffic is expected, for example, for laser printers.  For usual dot "
6435 "matrix printers polling will usually be enough.  The default is polling."
6436 msgstr ""
6437
6438 #. type: Plain text
6439 #: build/C/man4/lp.4:46
6440 msgid "The following B<ioctl>(2)  calls are supported:"
6441 msgstr ""
6442
6443 #. type: IP
6444 #: build/C/man4/lp.4:46
6445 #, no-wrap
6446 msgid "B<int ioctl(int >I<fd>B<, LPTIME, int >I<arg>B<)>"
6447 msgstr ""
6448
6449 #. type: Plain text
6450 #: build/C/man4/lp.4:54
6451 msgid ""
6452 "Sets the amount of time that the driver sleeps before rechecking the printer "
6453 "when the printer's buffer appears to be filled to I<arg>.  If you have a "
6454 "fast printer, decrease this number; if you have a slow printer then increase "
6455 "it.  This is in hundredths of a second, the default 2 being 0.02 seconds.  "
6456 "It only influences the polling driver."
6457 msgstr ""
6458
6459 #. type: IP
6460 #: build/C/man4/lp.4:54
6461 #, no-wrap
6462 msgid "B<int ioctl(int >I<fd>B<, LPCHAR, int >I<arg>B<)>"
6463 msgstr ""
6464
6465 #. type: Plain text
6466 #: build/C/man4/lp.4:62
6467 msgid ""
6468 "Sets the maximum number of busy-wait iterations which the polling driver "
6469 "does while waiting for the printer to get ready for receiving a character to "
6470 "I<arg>.  If printing is too slow, increase this number; if the system gets "
6471 "too slow, decrease this number.  The default is 1000.  It only influences "
6472 "the polling driver."
6473 msgstr ""
6474
6475 #. type: IP
6476 #: build/C/man4/lp.4:62
6477 #, no-wrap
6478 msgid "B<int ioctl(int >I<fd>B<, LPABORT, int >I<arg>B<)>"
6479 msgstr ""
6480
6481 #. type: Plain text
6482 #: build/C/man4/lp.4:66
6483 msgid ""
6484 "If I<arg> is 0, the printer driver will retry on errors, otherwise it will "
6485 "abort.  The default is 0."
6486 msgstr ""
6487
6488 #. type: IP
6489 #: build/C/man4/lp.4:66
6490 #, no-wrap
6491 msgid "B<int ioctl(int >I<fd>B<, LPABORTOPEN, int >I<arg>B<)>"
6492 msgstr ""
6493
6494 #. type: Plain text
6495 #: build/C/man4/lp.4:71
6496 msgid ""
6497 "If I<arg> is 0, B<open>(2)  will be aborted on error, otherwise error will "
6498 "be ignored.  The default is to ignore it."
6499 msgstr ""
6500
6501 #. type: IP
6502 #: build/C/man4/lp.4:71
6503 #, no-wrap
6504 msgid "B<int ioctl(int >I<fd>B<, LPCAREFUL, int >I<arg>B<)>"
6505 msgstr ""
6506
6507 #. type: Plain text
6508 #: build/C/man4/lp.4:75
6509 msgid ""
6510 "If I<arg> is 0, then the out-of-paper, offline and error signals are "
6511 "required to be false on all writes, otherwise they are ignored.  The default "
6512 "is to ignore them."
6513 msgstr ""
6514
6515 #. type: IP
6516 #: build/C/man4/lp.4:75
6517 #, no-wrap
6518 msgid "B<int ioctl(int >I<fd>B<, LPWAIT, int >I<arg>B<)>"
6519 msgstr ""
6520
6521 #. type: Plain text
6522 #: build/C/man4/lp.4:85
6523 msgid ""
6524 "Sets the number of busy waiting iterations to wait before strobing the "
6525 "printer to accept a just-written character, and the number of iterations to "
6526 "wait before turning the strobe off again, to I<arg>.  The specification says "
6527 "this time should be 0.5 microseconds, but experience has shown the delay "
6528 "caused by the code is already enough.  For that reason, the default value is "
6529 "0.  This is used for both the polling and the interrupt driver."
6530 msgstr ""
6531
6532 #. type: IP
6533 #: build/C/man4/lp.4:85
6534 #, no-wrap
6535 msgid "B<int ioctl(int >I<fd>B<, LPSETIRQ, int >I<arg>B<)>"
6536 msgstr ""
6537
6538 #. type: Plain text
6539 #: build/C/man4/lp.4:94
6540 msgid ""
6541 "This B<ioctl>(2)  requires superuser privileges.  It takes an I<int> "
6542 "containing the new IRQ as argument.  As a side effect, the printer will be "
6543 "reset.  When I<arg> is 0, the polling driver will be used, which is also "
6544 "default."
6545 msgstr ""
6546
6547 #. type: IP
6548 #: build/C/man4/lp.4:94
6549 #, no-wrap
6550 msgid "B<int ioctl(int >I<fd>B<, LPGETIRQ, int *>I<arg>B<)>"
6551 msgstr ""
6552
6553 #. type: Plain text
6554 #: build/C/man4/lp.4:96
6555 msgid "Stores the currently used IRQ in I<arg>."
6556 msgstr ""
6557
6558 #. type: IP
6559 #: build/C/man4/lp.4:96
6560 #, no-wrap
6561 msgid "B<int ioctl(int >I<fd>B<, LPGETSTATUS, int *>I<arg>B<)>"
6562 msgstr ""
6563
6564 #. type: Plain text
6565 #: build/C/man4/lp.4:99
6566 msgid ""
6567 "Stores the value of the status port in I<arg>.  The bits have the following "
6568 "meaning:"
6569 msgstr ""
6570
6571 #. type: tbl table
6572 #: build/C/man4/lp.4:101
6573 #, no-wrap
6574 msgid "LP_PBUSY\tinverted busy input, active high\n"
6575 msgstr ""
6576
6577 #. type: tbl table
6578 #: build/C/man4/lp.4:102
6579 #, no-wrap
6580 msgid "LP_PACK\tunchanged acknowledge input, active low\n"
6581 msgstr ""
6582
6583 #. type: tbl table
6584 #: build/C/man4/lp.4:103
6585 #, no-wrap
6586 msgid "LP_POUTPA\tunchanged out-of-paper input, active high\n"
6587 msgstr ""
6588
6589 #. type: tbl table
6590 #: build/C/man4/lp.4:104
6591 #, no-wrap
6592 msgid "LP_PSELECD\tunchanged selected input, active high\n"
6593 msgstr ""
6594
6595 #. type: tbl table
6596 #: build/C/man4/lp.4:105
6597 #, no-wrap
6598 msgid "LP_PERRORP\tunchanged error input, active low\n"
6599 msgstr ""
6600
6601 #. type: Plain text
6602 #: build/C/man4/lp.4:110
6603 msgid ""
6604 "Refer to your printer manual for the meaning of the signals.  Note that "
6605 "undocumented bits may also be set, depending on your printer."
6606 msgstr ""
6607
6608 #. type: IP
6609 #: build/C/man4/lp.4:110
6610 #, no-wrap
6611 msgid "B<int ioctl(int >I<fd>B<, LPRESET)>"
6612 msgstr ""
6613
6614 #. type: Plain text
6615 #: build/C/man4/lp.4:113
6616 msgid "Resets the printer.  No argument is used."
6617 msgstr ""
6618
6619 #.  .SH AUTHORS
6620 #.  The printer driver was originally written by Jim Weigand and Linus
6621 #.  Torvalds.
6622 #.  It was further improved by Michael K.\& Johnson.
6623 #.  The interrupt code was written by Nigel Gamble.
6624 #.  Alan Cox modularized it.
6625 #.  LPCAREFUL, LPABORT, LPGETSTATUS were added by Chris Metcalf.
6626 #. type: Plain text
6627 #: build/C/man4/lp.4:122
6628 msgid "/dev/lp*"
6629 msgstr ""
6630
6631 #. type: Plain text
6632 #: build/C/man4/lp.4:128
6633 msgid "B<chmod>(1), B<chown>(1), B<mknod>(1), B<lpcntl>(8), B<tunelp>(8)"
6634 msgstr ""
6635
6636 #. type: TH
6637 #: build/C/man3/makedev.3:24
6638 #, no-wrap
6639 msgid "MAKEDEV"
6640 msgstr ""
6641
6642 #. type: Plain text
6643 #: build/C/man3/makedev.3:27
6644 msgid "makedev, major, minor - manage a device number"
6645 msgstr ""
6646
6647 #. type: Plain text
6648 #: build/C/man3/makedev.3:31
6649 #, no-wrap
6650 msgid ""
6651 "B<#define _BSD_SOURCE>             /* See feature_test_macros(7) */\n"
6652 "B<#include E<lt>sys/types.hE<gt>>\n"
6653 msgstr ""
6654
6655 #. type: Plain text
6656 #: build/C/man3/makedev.3:33
6657 #, no-wrap
6658 msgid "B<dev_t makedev(int >I<maj>B<, int >I<min>B<);>\n"
6659 msgstr ""
6660
6661 #. type: Plain text
6662 #: build/C/man3/makedev.3:36
6663 #, no-wrap
6664 msgid ""
6665 "B<int major(dev_t >I<dev>B<);>\n"
6666 "B<int minor(dev_t >I<dev>B<);>\n"
6667 msgstr ""
6668
6669 #. type: Plain text
6670 #: build/C/man3/makedev.3:44
6671 msgid ""
6672 "A device ID consists of two parts: a major ID, identifying the class of the "
6673 "device, and a minor ID, identifying a specific instance of a device in that "
6674 "class.  A device ID is represented using the type I<dev_t>."
6675 msgstr ""
6676
6677 #. type: Plain text
6678 #: build/C/man3/makedev.3:51
6679 msgid ""
6680 "Given major and minor device IDs, B<makedev>()  combines these to produce a "
6681 "device ID, returned as the function result.  This device ID can be given to "
6682 "B<mknod>(2), for example."
6683 msgstr ""
6684
6685 #. type: Plain text
6686 #: build/C/man3/makedev.3:61
6687 msgid ""
6688 "The B<major>()  and B<minor>()  functions perform the converse task: given a "
6689 "device ID, they return, respectively, the major and minor components.  These "
6690 "macros can be useful to, for example, decompose the device IDs in the "
6691 "structure returned by B<stat>(2)."
6692 msgstr ""
6693
6694 #.  The BSDs, HP-UX, Solaris, AIX, Irix
6695 #. type: Plain text
6696 #: build/C/man3/makedev.3:70
6697 msgid ""
6698 "The B<makedev>(), B<major>(), and B<minor>()  functions are not specified in "
6699 "POSIX.1, but are present on many other systems."
6700 msgstr ""
6701
6702 #. type: Plain text
6703 #: build/C/man3/makedev.3:79
6704 msgid ""
6705 "These interfaces are defined as macros.  Since glibc 2.3.3, they have been "
6706 "aliases for three GNU-specific functions: B<gnu_dev_makedev>(), "
6707 "B<gnu_dev_major>(), and B<gnu_dev_minor>().  The latter names are exported, "
6708 "but the traditional names are more portable."
6709 msgstr ""
6710
6711 #. type: Plain text
6712 #: build/C/man3/makedev.3:82
6713 msgid "B<mknod>(2), B<stat>(2)"
6714 msgstr ""
6715
6716 #. type: TH
6717 #: build/C/man4/mem.4:25
6718 #, no-wrap
6719 msgid "MEM"
6720 msgstr ""
6721
6722 #. type: TH
6723 #: build/C/man4/mem.4:25 build/C/man4/ram.4:25
6724 #, no-wrap
6725 msgid "1992-11-21"
6726 msgstr ""
6727
6728 #. type: Plain text
6729 #: build/C/man4/mem.4:28
6730 msgid "mem, kmem, port - system memory, kernel memory and system ports"
6731 msgstr ""
6732
6733 #. type: Plain text
6734 #: build/C/man4/mem.4:32
6735 msgid ""
6736 "B<mem> is a character device file that is an image of the main memory of the "
6737 "computer.  It may be used, for example, to examine (and even patch) the "
6738 "system."
6739 msgstr ""
6740
6741 #. type: Plain text
6742 #: build/C/man4/mem.4:37
6743 msgid ""
6744 "Byte addresses in B<mem> are interpreted as physical memory addresses.  "
6745 "References to nonexistent locations cause errors to be returned."
6746 msgstr ""
6747
6748 #. type: Plain text
6749 #: build/C/man4/mem.4:40
6750 msgid ""
6751 "Examining and patching is likely to lead to unexpected results when "
6752 "read-only or write-only bits are present."
6753 msgstr ""
6754
6755 #. type: Plain text
6756 #: build/C/man4/mem.4:42 build/C/man4/mem.4:57 build/C/man4/mem.4:69 build/C/man4/ram.4:32
6757 msgid "It is typically created by:"
6758 msgstr ""
6759
6760 #. type: Plain text
6761 #: build/C/man4/mem.4:45
6762 msgid "mknod -m 660 /dev/mem c 1 1"
6763 msgstr ""
6764
6765 #. type: Plain text
6766 #: build/C/man4/mem.4:47
6767 msgid "chown root:kmem /dev/mem"
6768 msgstr ""
6769
6770 #. type: Plain text
6771 #: build/C/man4/mem.4:55
6772 msgid ""
6773 "The file B<kmem> is the same as B<mem>, except that the kernel virtual "
6774 "memory rather than physical memory is accessed."
6775 msgstr ""
6776
6777 #. type: Plain text
6778 #: build/C/man4/mem.4:60
6779 msgid "mknod -m 640 /dev/kmem c 1 2"
6780 msgstr ""
6781
6782 #. type: Plain text
6783 #: build/C/man4/mem.4:62
6784 msgid "chown root:kmem /dev/kmem"
6785 msgstr ""
6786
6787 #. type: Plain text
6788 #: build/C/man4/mem.4:67
6789 msgid "B<port> is similar to B<mem>, but the I/O ports are accessed."
6790 msgstr ""
6791
6792 #. type: Plain text
6793 #: build/C/man4/mem.4:72
6794 msgid "mknod -m 660 /dev/port c 1 4"
6795 msgstr ""
6796
6797 #. type: Plain text
6798 #: build/C/man4/mem.4:74
6799 msgid "chown root:mem /dev/port"
6800 msgstr ""
6801
6802 #. type: Plain text
6803 #: build/C/man4/mem.4:77
6804 msgid "I</dev/mem>"
6805 msgstr ""
6806
6807 #. type: Plain text
6808 #: build/C/man4/mem.4:79
6809 msgid "I</dev/kmem>"
6810 msgstr ""
6811
6812 #. type: Plain text
6813 #: build/C/man4/mem.4:81
6814 msgid "I</dev/port>"
6815 msgstr ""
6816
6817 #. type: Plain text
6818 #: build/C/man4/mem.4:85
6819 msgid "B<chown>(1), B<mknod>(1), B<ioperm>(2)"
6820 msgstr ""
6821
6822 #. type: TH
6823 #: build/C/man3/mkfifo.3:27
6824 #, no-wrap
6825 msgid "MKFIFO"
6826 msgstr ""
6827
6828 #. type: TH
6829 #: build/C/man3/mkfifo.3:27
6830 #, no-wrap
6831 msgid "2008-06-12"
6832 msgstr ""
6833
6834 #. type: TH
6835 #: build/C/man3/mkfifo.3:27
6836 #, no-wrap
6837 msgid "GNU"
6838 msgstr ""
6839
6840 #. type: Plain text
6841 #: build/C/man3/mkfifo.3:30
6842 msgid "mkfifo - make a FIFO special file (a named pipe)"
6843 msgstr ""
6844
6845 #. type: Plain text
6846 #: build/C/man3/mkfifo.3:34
6847 #, no-wrap
6848 msgid ""
6849 "B<#include E<lt>sys/types.hE<gt>>\n"
6850 "B<#include E<lt>sys/stat.hE<gt>>\n"
6851 msgstr ""
6852
6853 #. type: Plain text
6854 #: build/C/man3/mkfifo.3:36
6855 #, no-wrap
6856 msgid "B<int mkfifo(const char *>I<pathname>B<, mode_t >I<mode>B<);>\n"
6857 msgstr ""
6858
6859 #. type: Plain text
6860 #: build/C/man3/mkfifo.3:44
6861 msgid ""
6862 "B<mkfifo>()  makes a FIFO special file with name I<pathname>.  I<mode> "
6863 "specifies the FIFO's permissions.  It is modified by the process's B<umask> "
6864 "in the usual way: the permissions of the created file are B<(>I<mode>B< & "
6865 "~umask)>."
6866 msgstr ""
6867
6868 #. type: Plain text
6869 #: build/C/man3/mkfifo.3:51
6870 msgid ""
6871 "A FIFO special file is similar to a pipe, except that it is created in a "
6872 "different way.  Instead of being an anonymous communications channel, a FIFO "
6873 "special file is entered into the file system by calling B<mkfifo>()."
6874 msgstr ""
6875
6876 #. type: Plain text
6877 #: build/C/man3/mkfifo.3:61
6878 msgid ""
6879 "Once you have created a FIFO special file in this way, any process can open "
6880 "it for reading or writing, in the same way as an ordinary file.  However, it "
6881 "has to be open at both ends simultaneously before you can proceed to do any "
6882 "input or output operations on it.  Opening a FIFO for reading normally "
6883 "blocks until some other process opens the same FIFO for writing, and vice "
6884 "versa.  See B<fifo>(7)  for nonblocking handling of FIFO special files."
6885 msgstr ""
6886
6887 #. type: Plain text
6888 #: build/C/man3/mkfifo.3:67
6889 msgid ""
6890 "On success B<mkfifo>()  returns 0.  In the case of an error, -1 is returned "
6891 "(in which case, I<errno> is set appropriately)."
6892 msgstr ""
6893
6894 #. type: TP
6895 #: build/C/man3/mkfifo.3:68 build/C/man2/mknod.2:106 build/C/man4/st.4:828
6896 #, no-wrap
6897 msgid "B<EACCES>"
6898 msgstr ""
6899
6900 #. type: Plain text
6901 #: build/C/man3/mkfifo.3:72
6902 msgid ""
6903 "One of the directories in I<pathname> did not allow search (execute) "
6904 "permission."
6905 msgstr ""
6906
6907 #. type: TP
6908 #: build/C/man3/mkfifo.3:72 build/C/man2/mknod.2:114
6909 #, no-wrap
6910 msgid "B<EEXIST>"
6911 msgstr ""
6912
6913 #. type: Plain text
6914 #: build/C/man3/mkfifo.3:78 build/C/man2/mknod.2:121
6915 msgid ""
6916 "I<pathname> already exists.  This includes the case where I<pathname> is a "
6917 "symbolic link, dangling or not."
6918 msgstr ""
6919
6920 #. type: TP
6921 #: build/C/man3/mkfifo.3:78 build/C/man2/mknod.2:133
6922 #, no-wrap
6923 msgid "B<ENAMETOOLONG>"
6924 msgstr ""
6925
6926 #. type: Plain text
6927 #: build/C/man3/mkfifo.3:86
6928 msgid ""
6929 "Either the total length of I<pathname> is greater than B<PATH_MAX>, or an "
6930 "individual filename component has a length greater than B<NAME_MAX>.  In the "
6931 "GNU system, there is no imposed limit on overall filename length, but some "
6932 "file systems may place limits on the length of a component."
6933 msgstr ""
6934
6935 #. type: TP
6936 #: build/C/man3/mkfifo.3:86 build/C/man2/mknod.2:136
6937 #, no-wrap
6938 msgid "B<ENOENT>"
6939 msgstr ""
6940
6941 #. type: Plain text
6942 #: build/C/man3/mkfifo.3:90 build/C/man2/mknod.2:141
6943 msgid ""
6944 "A directory component in I<pathname> does not exist or is a dangling "
6945 "symbolic link."
6946 msgstr ""
6947
6948 #. type: TP
6949 #: build/C/man3/mkfifo.3:90 build/C/man2/mknod.2:144 build/C/man4/st.4:856
6950 #, no-wrap
6951 msgid "B<ENOSPC>"
6952 msgstr ""
6953
6954 #. type: Plain text
6955 #: build/C/man3/mkfifo.3:93
6956 msgid "The directory or file system has no room for the new file."
6957 msgstr ""
6958
6959 #. type: TP
6960 #: build/C/man3/mkfifo.3:93 build/C/man2/mknod.2:149
6961 #, no-wrap
6962 msgid "B<ENOTDIR>"
6963 msgstr ""
6964
6965 #. type: Plain text
6966 #: build/C/man3/mkfifo.3:97 build/C/man2/mknod.2:154
6967 msgid "A component used as a directory in I<pathname> is not, in fact, a directory."
6968 msgstr ""
6969
6970 #. type: TP
6971 #: build/C/man3/mkfifo.3:97 build/C/man2/mknod.2:168 build/C/man4/st.4:871
6972 #, no-wrap
6973 msgid "B<EROFS>"
6974 msgstr ""
6975
6976 #. type: Plain text
6977 #: build/C/man3/mkfifo.3:100
6978 msgid "I<pathname> refers to a read-only file system."
6979 msgstr ""
6980
6981 #. type: Plain text
6982 #: build/C/man3/mkfifo.3:102
6983 msgid "POSIX.1-2001."
6984 msgstr ""
6985
6986 #. type: Plain text
6987 #: build/C/man3/mkfifo.3:112
6988 msgid ""
6989 "B<mkfifo>(1), B<close>(2), B<open>(2), B<read>(2), B<stat>(2), B<umask>(2), "
6990 "B<write>(2), B<mkfifoat>(3), B<fifo>(7)"
6991 msgstr ""
6992
6993 #. type: TH
6994 #: build/C/man2/mknod.2:13
6995 #, no-wrap
6996 msgid "MKNOD"
6997 msgstr ""
6998
6999 #. type: TH
7000 #: build/C/man2/mknod.2:13
7001 #, no-wrap
7002 msgid "2010-09-20"
7003 msgstr ""
7004
7005 #. type: Plain text
7006 #: build/C/man2/mknod.2:16
7007 msgid "mknod - create a special or ordinary file"
7008 msgstr ""
7009
7010 #. type: Plain text
7011 #: build/C/man2/mknod.2:22
7012 #, no-wrap
7013 msgid ""
7014 "B<#include E<lt>sys/types.hE<gt>>\n"
7015 "B<#include E<lt>sys/stat.hE<gt>>\n"
7016 "B<#include E<lt>fcntl.hE<gt>>\n"
7017 "B<#include E<lt>unistd.hE<gt>>\n"
7018 msgstr ""
7019
7020 #. type: Plain text
7021 #: build/C/man2/mknod.2:24
7022 #, no-wrap
7023 msgid ""
7024 "B<int mknod(const char *>I<pathname>B<, mode_t >I<mode>B<, dev_t "
7025 ">I<dev>B<);>\n"
7026 msgstr ""
7027
7028 #. type: Plain text
7029 #: build/C/man2/mknod.2:29 build/C/man3/syslog.3:53
7030 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
7031 msgstr ""
7032
7033 #. type: Plain text
7034 #: build/C/man2/mknod.2:32
7035 msgid "B<mknod>():"
7036 msgstr ""
7037
7038 #. type: Plain text
7039 #: build/C/man2/mknod.2:36
7040 msgid ""
7041 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
7042 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
7043 msgstr ""
7044
7045 #. type: Plain text
7046 #: build/C/man2/mknod.2:48
7047 msgid ""
7048 "The system call B<mknod>()  creates a file system node (file, device special "
7049 "file or named pipe) named I<pathname>, with attributes specified by I<mode> "
7050 "and I<dev>."
7051 msgstr ""
7052
7053 #. type: Plain text
7054 #: build/C/man2/mknod.2:55
7055 msgid ""
7056 "The I<mode> argument specifies both the permissions to use and the type of "
7057 "node to be created.  It should be a combination (using bitwise OR) of one of "
7058 "the file types listed below and the permissions for the new node."
7059 msgstr ""
7060
7061 #. type: Plain text
7062 #: build/C/man2/mknod.2:60
7063 msgid ""
7064 "The permissions are modified by the process's I<umask> in the usual way: the "
7065 "permissions of the created node are I<(mode & ~umask)>."
7066 msgstr ""
7067
7068 #.  (S_IFSOCK since Linux 1.2.4)
7069 #. type: Plain text
7070 #: build/C/man2/mknod.2:74
7071 msgid ""
7072 "The file type must be one of B<S_IFREG>, B<S_IFCHR>, B<S_IFBLK>, B<S_IFIFO> "
7073 "or B<S_IFSOCK> to specify a regular file (which will be created empty), "
7074 "character special file, block special file, FIFO (named pipe), or UNIX "
7075 "domain socket, respectively.  (Zero file type is equivalent to type "
7076 "B<S_IFREG>.)"
7077 msgstr ""
7078
7079 #. type: Plain text
7080 #: build/C/man2/mknod.2:87
7081 msgid ""
7082 "If the file type is B<S_IFCHR> or B<S_IFBLK> then I<dev> specifies the major "
7083 "and minor numbers of the newly created device special file (B<makedev>(3)  "
7084 "may be useful to build the value for I<dev>); otherwise it is ignored."
7085 msgstr ""
7086
7087 #. type: Plain text
7088 #: build/C/man2/mknod.2:93
7089 msgid ""
7090 "If I<pathname> already exists, or is a symbolic link, this call fails with "
7091 "an B<EEXIST> error."
7092 msgstr ""
7093
7094 #. type: Plain text
7095 #: build/C/man2/mknod.2:100
7096 msgid ""
7097 "The newly created node will be owned by the effective user ID of the "
7098 "process.  If the directory containing the node has the set-group-ID bit set, "
7099 "or if the file system is mounted with BSD group semantics, the new node will "
7100 "inherit the group ownership from its parent directory; otherwise it will be "
7101 "owned by the effective group ID of the process."
7102 msgstr ""
7103
7104 #. type: Plain text
7105 #: build/C/man2/mknod.2:105
7106 msgid ""
7107 "B<mknod>()  returns zero on success, or -1 if an error occurred (in which "
7108 "case, I<errno> is set appropriately)."
7109 msgstr ""
7110
7111 #. type: Plain text
7112 #: build/C/man2/mknod.2:114
7113 msgid ""
7114 "The parent directory does not allow write permission to the process, or one "
7115 "of the directories in the path prefix of I<pathname> did not allow search "
7116 "permission.  (See also B<path_resolution>(7).)"
7117 msgstr ""
7118
7119 #. type: TP
7120 #: build/C/man2/mknod.2:121 build/C/man4/st.4:837
7121 #, no-wrap
7122 msgid "B<EFAULT>"
7123 msgstr ""
7124
7125 #. type: Plain text
7126 #: build/C/man2/mknod.2:124
7127 msgid "I<pathname> points outside your accessible address space."
7128 msgstr ""
7129
7130 #. type: Plain text
7131 #: build/C/man2/mknod.2:129
7132 msgid ""
7133 "I<mode> requested creation of something other than a regular file, device "
7134 "special file, FIFO or socket."
7135 msgstr ""
7136
7137 #. type: TP
7138 #: build/C/man2/mknod.2:129
7139 #, no-wrap
7140 msgid "B<ELOOP>"
7141 msgstr ""
7142
7143 #. type: Plain text
7144 #: build/C/man2/mknod.2:133
7145 msgid "Too many symbolic links were encountered in resolving I<pathname>."
7146 msgstr ""
7147
7148 #. type: Plain text
7149 #: build/C/man2/mknod.2:136
7150 msgid "I<pathname> was too long."
7151 msgstr ""
7152
7153 #. type: TP
7154 #: build/C/man2/mknod.2:141 build/C/man4/st.4:849
7155 #, no-wrap
7156 msgid "B<ENOMEM>"
7157 msgstr ""
7158
7159 #. type: Plain text
7160 #: build/C/man2/mknod.2:144
7161 msgid "Insufficient kernel memory was available."
7162 msgstr ""
7163
7164 #. type: Plain text
7165 #: build/C/man2/mknod.2:149
7166 msgid "The device containing I<pathname> has no room for the new node."
7167 msgstr ""
7168
7169 #.  For UNIX domain sockets and regular files, EPERM is only returned in
7170 #.  Linux 2.2 and earlier; in Linux 2.4 and later, unprivileged can
7171 #.  use mknod() to make these files.
7172 #. type: Plain text
7173 #: build/C/man2/mknod.2:168
7174 msgid ""
7175 "I<mode> requested creation of something other than a regular file, FIFO "
7176 "(named pipe), or UNIX domain socket, and the caller is not privileged "
7177 "(Linux: does not have the B<CAP_MKNOD> capability); also returned if the "
7178 "file system containing I<pathname> does not support the type of node "
7179 "requested."
7180 msgstr ""
7181
7182 #. type: Plain text
7183 #: build/C/man2/mknod.2:172
7184 msgid "I<pathname> refers to a file on a read-only file system."
7185 msgstr ""
7186
7187 #.  The Linux version differs from the SVr4 version in that it
7188 #.  does not require root permission to create pipes, also in that no
7189 #.  EMULTIHOP, ENOLINK, or EINTR error is documented.
7190 #. type: Plain text
7191 #: build/C/man2/mknod.2:177
7192 msgid "SVr4, 4.4BSD, POSIX.1-2001 (but see below)."
7193 msgstr ""
7194
7195 #. type: Plain text
7196 #: build/C/man2/mknod.2:195
7197 msgid ""
7198 "POSIX.1-2001 says: \"The only portable use of B<mknod>()  is to create a "
7199 "FIFO-special file.  If I<mode> is not B<S_IFIFO> or I<dev> is not 0, the "
7200 "behavior of B<mknod>()  is unspecified.\" However, nowadays one should never "
7201 "use B<mknod>()  for this purpose; one should use B<mkfifo>(3), a function "
7202 "especially defined for this purpose."
7203 msgstr ""
7204
7205 #.  and one should make UNIX domain sockets with socket(2) and bind(2).
7206 #. type: Plain text
7207 #: build/C/man2/mknod.2:200
7208 msgid ""
7209 "Under Linux, this call cannot be used to create directories.  One should "
7210 "make directories with B<mkdir>(2)."
7211 msgstr ""
7212
7213 #. type: Plain text
7214 #: build/C/man2/mknod.2:204
7215 msgid ""
7216 "There are many infelicities in the protocol underlying NFS.  Some of these "
7217 "affect B<mknod>()."
7218 msgstr ""
7219
7220 #. type: Plain text
7221 #: build/C/man2/mknod.2:218
7222 msgid ""
7223 "B<chmod>(2), B<chown>(2), B<fcntl>(2), B<mkdir>(2), B<mknodat>(2), "
7224 "B<mount>(2), B<socket>(2), B<stat>(2), B<umask>(2), B<unlink>(2), "
7225 "B<makedev>(3), B<mkfifo>(3), B<path_resolution>(7)"
7226 msgstr ""
7227
7228 #. type: TH
7229 #: build/C/man4/mouse.4:25
7230 #, no-wrap
7231 msgid "MOUSE"
7232 msgstr ""
7233
7234 #. type: TH
7235 #: build/C/man4/mouse.4:25
7236 #, no-wrap
7237 msgid "1996-02-10"
7238 msgstr ""
7239
7240 #. type: Plain text
7241 #: build/C/man4/mouse.4:28
7242 msgid "mouse - serial mouse interface"
7243 msgstr ""
7244
7245 #. type: Plain text
7246 #: build/C/man4/mouse.4:32
7247 msgid ""
7248 "Serial mice are connected to a serial RS232/V24 dialout line, see B<ttyS>(4)  "
7249 "for a description."
7250 msgstr ""
7251
7252 #. type: SS
7253 #: build/C/man4/mouse.4:33
7254 #, no-wrap
7255 msgid "Introduction"
7256 msgstr ""
7257
7258 #. type: Plain text
7259 #: build/C/man4/mouse.4:35
7260 msgid "The pinout of the usual 9 pin plug as used for serial mice is:"
7261 msgstr ""
7262
7263 #. type: tbl table
7264 #: build/C/man4/mouse.4:38
7265 #, no-wrap
7266 msgid "pin\tname\tused for\n"
7267 msgstr ""
7268
7269 #. type: tbl table
7270 #: build/C/man4/mouse.4:39
7271 #, no-wrap
7272 msgid "2\tRX\tData\n"
7273 msgstr ""
7274
7275 #. type: tbl table
7276 #: build/C/man4/mouse.4:40
7277 #, no-wrap
7278 msgid "3\tTX\t-12 V, Imax = 10 mA\n"
7279 msgstr ""
7280
7281 #. type: tbl table
7282 #: build/C/man4/mouse.4:41
7283 #, no-wrap
7284 msgid "4\tDTR\t+12 V, Imax = 10 mA\n"
7285 msgstr ""
7286
7287 #. type: tbl table
7288 #: build/C/man4/mouse.4:42
7289 #, no-wrap
7290 msgid "7\tRTS\t+12 V, Imax = 10 mA\n"
7291 msgstr ""
7292
7293 #. type: tbl table
7294 #: build/C/man4/mouse.4:43
7295 #, no-wrap
7296 msgid "5\tGND\tGround\n"
7297 msgstr ""
7298
7299 #. type: Plain text
7300 #: build/C/man4/mouse.4:47
7301 msgid "This is the specification, in fact 9 V suffices with most mice."
7302 msgstr ""
7303
7304 #. type: Plain text
7305 #: build/C/man4/mouse.4:53
7306 msgid ""
7307 "The mouse driver can recognize a mouse by dropping RTS to low and raising it "
7308 "again.  About 14 ms later the mouse will send 0x4D (\\(aqM\\(aq) on the data "
7309 "line.  After a further 63 ms, a Microsoft-compatible 3-button mouse will "
7310 "send 0x33 (\\(aq3\\(aq)."
7311 msgstr ""
7312
7313 #. type: Plain text
7314 #: build/C/man4/mouse.4:61
7315 msgid ""
7316 "The relative mouse movement is sent as I<dx> (positive means right)  and "
7317 "I<dy> (positive means down).  Various mice can operate at different speeds.  "
7318 "To select speeds, cycle through the speeds 9600, 4800, 2400 and 1200 bit/s, "
7319 "each time writing the two characters from the table below and waiting 0.1 "
7320 "seconds.  The following table shows available speeds and the strings that "
7321 "select them:"
7322 msgstr ""
7323
7324 #. type: tbl table
7325 #: build/C/man4/mouse.4:64
7326 #, no-wrap
7327 msgid "bit/s\tstring\n"
7328 msgstr ""
7329
7330 #. type: tbl table
7331 #: build/C/man4/mouse.4:65
7332 #, no-wrap
7333 msgid "9600\t*q\n"
7334 msgstr ""
7335
7336 #. type: tbl table
7337 #: build/C/man4/mouse.4:66
7338 #, no-wrap
7339 msgid "4800\t*p\n"
7340 msgstr ""
7341
7342 #. type: tbl table
7343 #: build/C/man4/mouse.4:67
7344 #, no-wrap
7345 msgid "2400\t*o\n"
7346 msgstr ""
7347
7348 #. type: tbl table
7349 #: build/C/man4/mouse.4:68
7350 #, no-wrap
7351 msgid "1200\t*n\n"
7352 msgstr ""
7353
7354 #. type: Plain text
7355 #: build/C/man4/mouse.4:72
7356 msgid "The first byte of a data packet can be used to synchronization purposes."
7357 msgstr ""
7358
7359 #. type: SS
7360 #: build/C/man4/mouse.4:72
7361 #, no-wrap
7362 msgid "Microsoft protocol"
7363 msgstr ""
7364
7365 #. type: Plain text
7366 #: build/C/man4/mouse.4:79
7367 msgid ""
7368 "The B<Microsoft> protocol uses 1 start bit, 7 data bits, no parity and one "
7369 "stop bit at the speed of 1200 bits/sec.  Data is sent to RxD in 3-byte "
7370 "packets.  The I<dx> and I<dy> movements are sent as two's-complement, I<lb> "
7371 "(I<rb>) are set when the left (right)  button is pressed:"
7372 msgstr ""
7373
7374 #. type: tbl table
7375 #: build/C/man4/mouse.4:82
7376 #, no-wrap
7377 msgid "byte\td6\td5\td4\td3\td2\td1\td0\n"
7378 msgstr ""
7379
7380 #. type: tbl table
7381 #: build/C/man4/mouse.4:83
7382 #, no-wrap
7383 msgid "1\t1\tlb\trb\tdy7\tdy6\tdx7\tdx6\n"
7384 msgstr ""
7385
7386 #. type: tbl table
7387 #: build/C/man4/mouse.4:84
7388 #, no-wrap
7389 msgid "2\t0\tdx5\tdx4\tdx3\tdx2\tdx1\tdx0\n"
7390 msgstr ""
7391
7392 #. type: tbl table
7393 #: build/C/man4/mouse.4:85
7394 #, no-wrap
7395 msgid "3\t0\tdy5\tdy4\tdy3\tdy2\tdy1\tdy0\n"
7396 msgstr ""
7397
7398 #. type: SS
7399 #: build/C/man4/mouse.4:87
7400 #, no-wrap
7401 msgid "3-button Microsoft protocol"
7402 msgstr ""
7403
7404 #. type: Plain text
7405 #: build/C/man4/mouse.4:96
7406 msgid ""
7407 "Original Microsoft mice only have two buttons.  However, there are some "
7408 "three button mice which also use the Microsoft protocol.  Pressing or "
7409 "releasing the middle button is reported by sending a packet with zero "
7410 "movement and no buttons pressed.  (Thus, unlike for the other two buttons, "
7411 "the status of the middle button is not reported in each packet.)"
7412 msgstr ""
7413
7414 #. type: SS
7415 #: build/C/man4/mouse.4:96
7416 #, no-wrap
7417 msgid "Logitech protocol"
7418 msgstr ""
7419
7420 #. type: Plain text
7421 #: build/C/man4/mouse.4:105
7422 msgid ""
7423 "Logitech serial 3-button mice use a different extension of the Microsoft "
7424 "protocol: when the middle button is up, the above 3-byte packet is sent.  "
7425 "When the middle button is down a 4-byte packet is sent, where the 4th byte "
7426 "has value 0x20 (or at least has the 0x20 bit set).  In particular, a press "
7427 "of the middle button is reported as 0,0,0,0x20 when no other buttons are "
7428 "down."
7429 msgstr ""
7430
7431 #. type: SS
7432 #: build/C/man4/mouse.4:105
7433 #, no-wrap
7434 msgid "Mousesystems protocol"
7435 msgstr ""
7436
7437 #. type: Plain text
7438 #: build/C/man4/mouse.4:115
7439 msgid ""
7440 "The B<Mousesystems> protocol uses 1 start bit, 8 data bits, no parity and "
7441 "two stop bits at the speed of 1200 bits/sec.  Data is sent to RxD in 5-byte "
7442 "packets.  I<dx> is sent as the sum of the two two's-complement values, I<dy> "
7443 "is send as negated sum of the two two's-complement values.  I<lb> (I<mb>, "
7444 "I<rb>) are cleared when the left (middle, right) button is pressed:"
7445 msgstr ""
7446
7447 #. type: tbl table
7448 #: build/C/man4/mouse.4:118 build/C/man4/mouse.4:143
7449 #, no-wrap
7450 msgid "byte\td7\td6\td5\td4\td3\td2\td1\td0\n"
7451 msgstr ""
7452
7453 #. type: tbl table
7454 #: build/C/man4/mouse.4:119
7455 #, no-wrap
7456 msgid "1\t1\t0\t0\t0\t0\tlb\tmb\trb\n"
7457 msgstr ""
7458
7459 #. type: tbl table
7460 #: build/C/man4/mouse.4:120
7461 #, no-wrap
7462 msgid "2\t0\tdxa6\tdxa5\tdxa4\tdxa3\tdxa2\tdxa1\tdxa0\n"
7463 msgstr ""
7464
7465 #. type: tbl table
7466 #: build/C/man4/mouse.4:121
7467 #, no-wrap
7468 msgid "3\t0\tdya6\tdya5\tdya4\tdya3\tdya2\tdya1\tdya0\n"
7469 msgstr ""
7470
7471 #. type: tbl table
7472 #: build/C/man4/mouse.4:122
7473 #, no-wrap
7474 msgid "4\t0\tdxb6\tdxb5\tdxb4\tdxb3\tdxb2\tdxb1\tdxb0\n"
7475 msgstr ""
7476
7477 #. type: tbl table
7478 #: build/C/man4/mouse.4:123
7479 #, no-wrap
7480 msgid "5\t0\tdyb6\tdyb5\tdyb4\tdyb3\tdyb2\tdyb1\tdyb0\n"
7481 msgstr ""
7482
7483 #. type: Plain text
7484 #: build/C/man4/mouse.4:128
7485 msgid ""
7486 "Bytes 4 and 5 describe the change that occurred since bytes 2 and 3 were "
7487 "transmitted."
7488 msgstr ""
7489
7490 #. type: SS
7491 #: build/C/man4/mouse.4:128
7492 #, no-wrap
7493 msgid "Sun protocol"
7494 msgstr ""
7495
7496 #. type: Plain text
7497 #: build/C/man4/mouse.4:131
7498 msgid ""
7499 "The B<Sun> protocol is the 3-byte version of the above 5-byte Mousesystems "
7500 "protocol: the last two bytes are not sent."
7501 msgstr ""
7502
7503 #. type: SS
7504 #: build/C/man4/mouse.4:131
7505 #, no-wrap
7506 msgid "MM protocol"
7507 msgstr ""
7508
7509 #. type: Plain text
7510 #: build/C/man4/mouse.4:140
7511 msgid ""
7512 "The B<MM> protocol uses 1 start bit, 8 data bits, odd parity and one stop "
7513 "bit at the speed of 1200 bits/sec.  Data is sent to RxD in 3-byte packets.  "
7514 "I<dx> and I<dy> are sent as single signed values, the sign bit indicating a "
7515 "negative value.  I<lb> (I<mb>, I<rb>) are set when the left (middle, right) "
7516 "button is pressed:"
7517 msgstr ""
7518
7519 #. type: tbl table
7520 #: build/C/man4/mouse.4:144
7521 #, no-wrap
7522 msgid "1\t1\t0\t0\tdxs\tdys\tlb\tmb\trb\n"
7523 msgstr ""
7524
7525 #. type: tbl table
7526 #: build/C/man4/mouse.4:145
7527 #, no-wrap
7528 msgid "2\t0\tdx6\tdx5\tdx4\tdx3\tdx2\tdx1\tdx0\n"
7529 msgstr ""
7530
7531 #. type: tbl table
7532 #: build/C/man4/mouse.4:146
7533 #, no-wrap
7534 msgid "3\t0\tdy6\tdy5\tdy4\tdy3\tdy2\tdy1\tdy0\n"
7535 msgstr ""
7536
7537 #. type: TP
7538 #: build/C/man4/mouse.4:149
7539 #, no-wrap
7540 msgid "I</dev/mouse>"
7541 msgstr ""
7542
7543 #. type: Plain text
7544 #: build/C/man4/mouse.4:152
7545 msgid "A commonly used symlink pointing to a mouse device."
7546 msgstr ""
7547
7548 #. type: Plain text
7549 #: build/C/man4/mouse.4:155
7550 msgid "B<ttyS>(4), B<gpm>(8)"
7551 msgstr ""
7552
7553 #. type: TH
7554 #: build/C/man4/msr.4:24
7555 #, no-wrap
7556 msgid "MSR"
7557 msgstr ""
7558
7559 #. type: Plain text
7560 #: build/C/man4/msr.4:27
7561 msgid "msr - x86 CPU MSR access device"
7562 msgstr ""
7563
7564 #. type: Plain text
7565 #: build/C/man4/msr.4:34
7566 msgid ""
7567 "I</dev/cpu/CPUNUM/msr> provides an interface to read and write the "
7568 "model-specific registers (MSRs) of an x86 CPU.  I<CPUNUM> is the number of "
7569 "the CPU to access as listed in I</proc/cpuinfo>."
7570 msgstr ""
7571
7572 #. type: Plain text
7573 #: build/C/man4/msr.4:40
7574 msgid ""
7575 "The register access is done by opening the file and seeking to the MSR "
7576 "number as offset in the file, and then reading or writing in chunks of 8 "
7577 "bytes.  An I/O transfer of more than 8 bytes means multiple reads or writes "
7578 "of the same register."
7579 msgstr ""
7580
7581 #. type: Plain text
7582 #: build/C/man4/msr.4:45
7583 msgid ""
7584 "This file is protected so that it can only be read and written by the user "
7585 "I<root>, or members of the group I<root>."
7586 msgstr ""
7587
7588 #. type: Plain text
7589 #: build/C/man4/msr.4:51
7590 msgid ""
7591 "The I<msr> driver is not auto-loaded.  On modular kernels you might need to "
7592 "use the following command to load it explicitly before use:"
7593 msgstr ""
7594
7595 #. type: Plain text
7596 #: build/C/man4/msr.4:53
7597 #, no-wrap
7598 msgid "    $ I<modprobe msr>\n"
7599 msgstr ""
7600
7601 #. type: Plain text
7602 #: build/C/man4/msr.4:57
7603 msgid ""
7604 "Intel Corporation Intel 64 and IA-32 Architectures Software Developer's "
7605 "Manual Volume 3B Appendix B for an overview of the Intel CPU MSRs."
7606 msgstr ""
7607
7608 #. type: TH
7609 #: build/C/man4/null.4:25
7610 #, no-wrap
7611 msgid "NULL"
7612 msgstr ""
7613
7614 #. type: TH
7615 #: build/C/man4/null.4:25
7616 #, no-wrap
7617 msgid "2009-02-23"
7618 msgstr ""
7619
7620 #. type: Plain text
7621 #: build/C/man4/null.4:28
7622 msgid "null, zero - data sink"
7623 msgstr ""
7624
7625 #. type: Plain text
7626 #: build/C/man4/null.4:30
7627 msgid "Data written to a B<null> or B<zero> special file is discarded."
7628 msgstr ""
7629
7630 #. type: Plain text
7631 #: build/C/man4/null.4:35
7632 msgid ""
7633 "Reads from the B<null> special file always return end of file (i.e., "
7634 "B<read>(2)  returns 0), whereas reads from B<zero> always return bytes "
7635 "containing zero (\\e0 characters)."
7636 msgstr ""
7637
7638 #. type: Plain text
7639 #: build/C/man4/null.4:37
7640 msgid "B<null> and B<zero> are typically created by:"
7641 msgstr ""
7642
7643 #. type: Plain text
7644 #: build/C/man4/null.4:40
7645 msgid "mknod -m 666 /dev/null c 1 3"
7646 msgstr ""
7647
7648 #. type: Plain text
7649 #: build/C/man4/null.4:42
7650 msgid "mknod -m 666 /dev/zero c 1 5"
7651 msgstr ""
7652
7653 #. type: Plain text
7654 #: build/C/man4/null.4:44
7655 msgid "chown root:root /dev/null /dev/zero"
7656 msgstr ""
7657
7658 #. type: Plain text
7659 #: build/C/man4/null.4:47
7660 msgid "I</dev/null>"
7661 msgstr ""
7662
7663 #. type: Plain text
7664 #: build/C/man4/null.4:49
7665 msgid "I</dev/zero>"
7666 msgstr ""
7667
7668 #. type: Plain text
7669 #: build/C/man4/null.4:52
7670 msgid ""
7671 "If these devices are not writable and readable for all users, many programs "
7672 "will act strangely."
7673 msgstr ""
7674
7675 #. type: Plain text
7676 #: build/C/man4/null.4:56
7677 msgid "B<chown>(1), B<mknod>(1), B<full>(4)"
7678 msgstr ""
7679
7680 #. type: TH
7681 #: build/C/man7/pipe.7:25
7682 #, no-wrap
7683 msgid "PIPE"
7684 msgstr ""
7685
7686 #. type: TH
7687 #: build/C/man7/pipe.7:25
7688 #, no-wrap
7689 msgid "2005-12-08"
7690 msgstr ""
7691
7692 #. type: Plain text
7693 #: build/C/man7/pipe.7:28
7694 msgid "pipe - overview of pipes and FIFOs"
7695 msgstr ""
7696
7697 #. type: Plain text
7698 #: build/C/man7/pipe.7:37
7699 msgid ""
7700 "Pipes and FIFOs (also known as named pipes)  provide a unidirectional "
7701 "interprocess communication channel.  A pipe has a I<read end> and a I<write "
7702 "end>.  Data written to the write end of a pipe can be read from the read end "
7703 "of the pipe."
7704 msgstr ""
7705
7706 #. type: Plain text
7707 #: build/C/man7/pipe.7:47
7708 msgid ""
7709 "A pipe is created using B<pipe>(2), which creates a new pipe and returns two "
7710 "file descriptors, one referring to the read end of the pipe, the other "
7711 "referring to the write end.  Pipes can be used to create a communication "
7712 "channel between related processes; see B<pipe>(2)  for an example."
7713 msgstr ""
7714
7715 #. type: Plain text
7716 #: build/C/man7/pipe.7:66
7717 msgid ""
7718 "A FIFO (short for First In First Out) has a name within the file system "
7719 "(created using B<mkfifo>(3)), and is opened using B<open>(2).  Any process "
7720 "may open a FIFO, assuming the file permissions allow it.  The read end is "
7721 "opened using the B<O_RDONLY> flag; the write end is opened using the "
7722 "B<O_WRONLY> flag.  See B<fifo>(7)  for further details.  I<Note>: although "
7723 "FIFOs have a pathname in the file system, I/O on FIFOs does not involve "
7724 "operations on the underlying device (if there is one)."
7725 msgstr ""
7726
7727 #. type: SS
7728 #: build/C/man7/pipe.7:66
7729 #, no-wrap
7730 msgid "I/O on Pipes and FIFOs"
7731 msgstr ""
7732
7733 #. type: Plain text
7734 #: build/C/man7/pipe.7:71
7735 msgid ""
7736 "The only difference between pipes and FIFOs is the manner in which they are "
7737 "created and opened.  Once these tasks have been accomplished, I/O on pipes "
7738 "and FIFOs has exactly the same semantics."
7739 msgstr ""
7740
7741 #. type: Plain text
7742 #: build/C/man7/pipe.7:85
7743 msgid ""
7744 "If a process attempts to read from an empty pipe, then B<read>(2)  will "
7745 "block until data is available.  If a process attempts to write to a full "
7746 "pipe (see below), then B<write>(2)  blocks until sufficient data has been "
7747 "read from the pipe to allow the write to complete.  Nonblocking I/O is "
7748 "possible by using the B<fcntl>(2)  B<F_SETFL> operation to enable the "
7749 "B<O_NONBLOCK> open file status flag."
7750 msgstr ""
7751
7752 #. type: Plain text
7753 #: build/C/man7/pipe.7:89
7754 msgid ""
7755 "The communication channel provided by a pipe is a I<byte stream>: there is "
7756 "no concept of message boundaries."
7757 msgstr ""
7758
7759 #. type: Plain text
7760 #: build/C/man7/pipe.7:116
7761 msgid ""
7762 "If all file descriptors referring to the write end of a pipe have been "
7763 "closed, then an attempt to B<read>(2)  from the pipe will see end-of-file "
7764 "(B<read>(2)  will return 0).  If all file descriptors referring to the read "
7765 "end of a pipe have been closed, then a B<write>(2)  will cause a B<SIGPIPE> "
7766 "signal to be generated for the calling process.  If the calling process is "
7767 "ignoring this signal, then B<write>(2)  fails with the error B<EPIPE>.  An "
7768 "application that uses B<pipe>(2)  and B<fork>(2)  should use suitable "
7769 "B<close>(2)  calls to close unnecessary duplicate file descriptors; this "
7770 "ensures that end-of-file and B<SIGPIPE>/B<EPIPE> are delivered when "
7771 "appropriate."
7772 msgstr ""
7773
7774 #. type: Plain text
7775 #: build/C/man7/pipe.7:120
7776 msgid "It is not possible to apply B<lseek>(2)  to a pipe."
7777 msgstr ""
7778
7779 #. type: SS
7780 #: build/C/man7/pipe.7:120
7781 #, no-wrap
7782 msgid "Pipe Capacity"
7783 msgstr ""
7784
7785 #. type: Plain text
7786 #: build/C/man7/pipe.7:132
7787 msgid ""
7788 "A pipe has a limited capacity.  If the pipe is full, then a B<write>(2)  "
7789 "will block or fail, depending on whether the B<O_NONBLOCK> flag is set (see "
7790 "below).  Different implementations have different limits for the pipe "
7791 "capacity.  Applications should not rely on a particular capacity: an "
7792 "application should be designed so that a reading process consumes data as "
7793 "soon as it is available, so that a writing process does not remain blocked."
7794 msgstr ""
7795
7796 #. type: Plain text
7797 #: build/C/man7/pipe.7:136
7798 msgid ""
7799 "In Linux versions before 2.6.11, the capacity of a pipe was the same as the "
7800 "system page size (e.g., 4096 bytes on i386).  Since Linux 2.6.11, the pipe "
7801 "capacity is 65536 bytes."
7802 msgstr ""
7803
7804 #. type: SS
7805 #: build/C/man7/pipe.7:136
7806 #, no-wrap
7807 msgid "PIPE_BUF"
7808 msgstr ""
7809
7810 #. type: Plain text
7811 #: build/C/man7/pipe.7:158
7812 msgid ""
7813 "POSIX.1-2001 says that B<write>(2)s of less than B<PIPE_BUF> bytes must be "
7814 "atomic: the output data is written to the pipe as a contiguous sequence.  "
7815 "Writes of more than B<PIPE_BUF> bytes may be nonatomic: the kernel may "
7816 "interleave the data with data written by other processes.  POSIX.1-2001 "
7817 "requires B<PIPE_BUF> to be at least 512 bytes.  (On Linux, B<PIPE_BUF> is "
7818 "4096 bytes.)  The precise semantics depend on whether the file descriptor is "
7819 "nonblocking (B<O_NONBLOCK>), whether there are multiple writers to the pipe, "
7820 "and on I<n>, the number of bytes to be written:"
7821 msgstr ""
7822
7823 #. type: TP
7824 #: build/C/man7/pipe.7:158
7825 #, no-wrap
7826 msgid "B<O_NONBLOCK> disabled, I<n> E<lt>= B<PIPE_BUF>"
7827 msgstr ""
7828
7829 #. type: Plain text
7830 #: build/C/man7/pipe.7:167
7831 msgid ""
7832 "All I<n> bytes are written atomically; B<write>(2)  may block if there is "
7833 "not room for I<n> bytes to be written immediately"
7834 msgstr ""
7835
7836 #. type: TP
7837 #: build/C/man7/pipe.7:167
7838 #, no-wrap
7839 msgid "B<O_NONBLOCK> enabled, I<n> E<lt>= B<PIPE_BUF>"
7840 msgstr ""
7841
7842 #. type: Plain text
7843 #: build/C/man7/pipe.7:181
7844 msgid ""
7845 "If there is room to write I<n> bytes to the pipe, then B<write>(2)  succeeds "
7846 "immediately, writing all I<n> bytes; otherwise B<write>(2)  fails, with "
7847 "I<errno> set to B<EAGAIN>."
7848 msgstr ""
7849
7850 #. type: TP
7851 #: build/C/man7/pipe.7:181
7852 #, no-wrap
7853 msgid "B<O_NONBLOCK> disabled, I<n> E<gt> B<PIPE_BUF>"
7854 msgstr ""
7855
7856 #. type: Plain text
7857 #: build/C/man7/pipe.7:193
7858 msgid ""
7859 "The write is nonatomic: the data given to B<write>(2)  may be interleaved "
7860 "with B<write>(2)s by other process; the B<write>(2)  blocks until I<n> bytes "
7861 "have been written."
7862 msgstr ""
7863
7864 #. type: TP
7865 #: build/C/man7/pipe.7:193
7866 #, no-wrap
7867 msgid "B<O_NONBLOCK> enabled, I<n> E<gt> B<PIPE_BUF>"
7868 msgstr ""
7869
7870 #. type: Plain text
7871 #: build/C/man7/pipe.7:208
7872 msgid ""
7873 "If the pipe is full, then B<write>(2)  fails, with I<errno> set to "
7874 "B<EAGAIN>.  Otherwise, from 1 to I<n> bytes may be written (i.e., a "
7875 "\"partial write\" may occur; the caller should check the return value from "
7876 "B<write>(2)  to see how many bytes were actually written), and these bytes "
7877 "may be interleaved with writes by other processes."
7878 msgstr ""
7879
7880 #. type: SS
7881 #: build/C/man7/pipe.7:208
7882 #, no-wrap
7883 msgid "Open File Status Flags"
7884 msgstr ""
7885
7886 #. type: Plain text
7887 #: build/C/man7/pipe.7:214
7888 msgid ""
7889 "The only open file status flags that can be meaningfully applied to a pipe "
7890 "or FIFO are B<O_NONBLOCK> and B<O_ASYNC>."
7891 msgstr ""
7892
7893 #. type: Plain text
7894 #: build/C/man7/pipe.7:226
7895 msgid ""
7896 "Setting the B<O_ASYNC> flag for the read end of a pipe causes a signal "
7897 "(B<SIGIO> by default) to be generated when new input becomes available on "
7898 "the pipe (see B<fcntl>(2)  for details).  On Linux, B<O_ASYNC> is supported "
7899 "for pipes and FIFOs only since kernel 2.6."
7900 msgstr ""
7901
7902 #. type: SS
7903 #: build/C/man7/pipe.7:226
7904 #, no-wrap
7905 msgid "Portability notes"
7906 msgstr ""
7907
7908 #. type: Plain text
7909 #: build/C/man7/pipe.7:232
7910 msgid ""
7911 "On some systems (but not Linux), pipes are bidirectional: data can be "
7912 "transmitted in both directions between the pipe ends.  According to "
7913 "POSIX.1-2001, pipes only need to be unidirectional.  Portable applications "
7914 "should avoid reliance on bidirectional pipe semantics."
7915 msgstr ""
7916
7917 #. type: Plain text
7918 #: build/C/man7/pipe.7:244
7919 msgid ""
7920 "B<dup>(2), B<fcntl>(2), B<open>(2), B<pipe>(2), B<poll>(2), B<select>(2), "
7921 "B<socketpair>(2), B<stat>(2), B<mkfifo>(3), B<epoll>(7), B<fifo>(7)"
7922 msgstr ""
7923
7924 #. type: TH
7925 #: build/C/man4/ram.4:25
7926 #, no-wrap
7927 msgid "RAM"
7928 msgstr ""
7929
7930 #. type: Plain text
7931 #: build/C/man4/ram.4:28
7932 msgid "ram - ram disk device"
7933 msgstr ""
7934
7935 #. type: Plain text
7936 #: build/C/man4/ram.4:30
7937 msgid "The I<ram> device is a block device to access the ram disk in raw mode."
7938 msgstr ""
7939
7940 #. type: Plain text
7941 #: build/C/man4/ram.4:35
7942 msgid "mknod -m 660 /dev/ram b 1 1"
7943 msgstr ""
7944
7945 #. type: Plain text
7946 #: build/C/man4/ram.4:37
7947 msgid "chown root:disk /dev/ram"
7948 msgstr ""
7949
7950 #. type: Plain text
7951 #: build/C/man4/ram.4:40
7952 msgid "/dev/ram"
7953 msgstr ""
7954
7955 #. type: Plain text
7956 #: build/C/man4/ram.4:44
7957 msgid "B<chown>(1), B<mknod>(1), B<mount>(8)"
7958 msgstr ""
7959
7960 #. type: TH
7961 #: build/C/man4/random.4:17
7962 #, no-wrap
7963 msgid "RANDOM"
7964 msgstr ""
7965
7966 #. type: Plain text
7967 #: build/C/man4/random.4:20
7968 msgid "random, urandom - kernel random number source devices"
7969 msgstr ""
7970
7971 #. type: Plain text
7972 #: build/C/man4/random.4:27
7973 msgid ""
7974 "The character special files I</dev/random> and I</dev/urandom> (present "
7975 "since Linux 1.3.30)  provide an interface to the kernel's random number "
7976 "generator.  File I</dev/random> has major device number 1 and minor device "
7977 "number 8.  File I</dev/urandom> has major device number 1 and minor device "
7978 "number 9."
7979 msgstr ""
7980
7981 #. type: Plain text
7982 #: build/C/man4/random.4:33
7983 msgid ""
7984 "The random number generator gathers environmental noise from device drivers "
7985 "and other sources into an entropy pool.  The generator also keeps an "
7986 "estimate of the number of bits of noise in the entropy pool.  From this "
7987 "entropy pool random numbers are created."
7988 msgstr ""
7989
7990 #. type: Plain text
7991 #: build/C/man4/random.4:41
7992 msgid ""
7993 "When read, the I</dev/random> device will only return random bytes within "
7994 "the estimated number of bits of noise in the entropy pool.  I</dev/random> "
7995 "should be suitable for uses that need very high quality randomness such as "
7996 "one-time pad or key generation.  When the entropy pool is empty, reads from "
7997 "I</dev/random> will block until additional environmental noise is gathered."
7998 msgstr ""
7999
8000 #. type: Plain text
8001 #: build/C/man4/random.4:52
8002 msgid ""
8003 "A read from the I</dev/urandom> device will not block waiting for more "
8004 "entropy.  As a result, if there is not sufficient entropy in the entropy "
8005 "pool, the returned values are theoretically vulnerable to a cryptographic "
8006 "attack on the algorithms used by the driver.  Knowledge of how to do this is "
8007 "not available in the current unclassified literature, but it is "
8008 "theoretically possible that such an attack may exist.  If this is a concern "
8009 "in your application, use I</dev/random> instead."
8010 msgstr ""
8011
8012 #. type: Plain text
8013 #: build/C/man4/random.4:61
8014 msgid ""
8015 "If you are unsure about whether you should use I</dev/random> or "
8016 "I</dev/urandom>, then probably you want to use the latter.  As a general "
8017 "rule, I</dev/urandom> should be used for everything except long-lived "
8018 "GPG/SSL/SSH keys."
8019 msgstr ""
8020
8021 #. type: Plain text
8022 #: build/C/man4/random.4:73
8023 msgid ""
8024 "If a seed file is saved across reboots as recommended below (all major Linux "
8025 "distributions have done this since 2000 at least), the output is "
8026 "cryptographically secure against attackers without local root access as soon "
8027 "as it is reloaded in the boot sequence, and perfectly adequate for network "
8028 "encryption session keys.  Since reads from I</dev/random> may block, users "
8029 "will usually want to open it in nonblocking mode (or perform a read with "
8030 "timeout), and provide some sort of user notification if the desired entropy "
8031 "is not immediately available."
8032 msgstr ""
8033
8034 #. type: Plain text
8035 #: build/C/man4/random.4:86
8036 msgid ""
8037 "The kernel random-number generator is designed to produce a small amount of "
8038 "high-quality seed material to seed a cryptographic pseudo-random number "
8039 "generator (CPRNG).  It is designed for security, not speed, and is poorly "
8040 "suited to generating large amounts of random data.  Users should be very "
8041 "economical in the amount of seed material that they read from "
8042 "I</dev/urandom> (and I</dev/random>); unnecessarily reading large quantities "
8043 "of data from this device will have a negative impact on other users of the "
8044 "device."
8045 msgstr ""
8046
8047 #. type: Plain text
8048 #: build/C/man4/random.4:94
8049 msgid ""
8050 "The amount of seed material required to generate a cryptographic key equals "
8051 "the effective key size of the key.  For example, a 3072-bit RSA or "
8052 "Diffie-Hellman private key has an effective key size of 128 bits (it "
8053 "requires about 2^128 operations to break) so a key generator only needs 128 "
8054 "bits (16 bytes) of seed material from I</dev/random>."
8055 msgstr ""
8056
8057 #. type: Plain text
8058 #: build/C/man4/random.4:103
8059 msgid ""
8060 "While some safety margin above that minimum is reasonable, as a guard "
8061 "against flaws in the CPRNG algorithm, no cryptographic primitive available "
8062 "today can hope to promise more than 256 bits of security, so if any program "
8063 "reads more than 256 bits (32 bytes) from the kernel random pool per "
8064 "invocation, or per reasonable reseed interval (not less than one minute), "
8065 "that should be taken as a sign that its cryptography is I<not> skilfully "
8066 "implemented."
8067 msgstr ""
8068
8069 #. type: SS
8070 #: build/C/man4/random.4:103
8071 #, no-wrap
8072 msgid "Configuration"
8073 msgstr ""
8074
8075 #. type: Plain text
8076 #: build/C/man4/random.4:107
8077 msgid ""
8078 "If your system does not have I</dev/random> and I</dev/urandom> created "
8079 "already, they can be created with the following commands:"
8080 msgstr ""
8081
8082 #. type: Plain text
8083 #: build/C/man4/random.4:112
8084 #, no-wrap
8085 msgid ""
8086 "    mknod -m 644 /dev/random c 1 8\n"
8087 "    mknod -m 644 /dev/urandom c 1 9\n"
8088 "    chown root:root /dev/random /dev/urandom\n"
8089 msgstr ""
8090
8091 #. type: Plain text
8092 #: build/C/man4/random.4:122
8093 msgid ""
8094 "When a Linux system starts up without much operator interaction, the entropy "
8095 "pool may be in a fairly predictable state.  This reduces the actual amount "
8096 "of noise in the entropy pool below the estimate.  In order to counteract "
8097 "this effect, it helps to carry entropy pool information across shut-downs "
8098 "and start-ups.  To do this, add the following lines to an appropriate script "
8099 "which is run during the Linux system start-up sequence:"
8100 msgstr ""
8101
8102 #. type: Plain text
8103 #: build/C/man4/random.4:137
8104 #, no-wrap
8105 msgid ""
8106 "    echo \"Initializing random number generator...\"\n"
8107 "    random_seed=/var/run/random-seed\n"
8108 "    # Carry a random seed from start-up to start-up\n"
8109 "    # Load and then save the whole entropy pool\n"
8110 "    if [ -f $random_seed ]; then\n"
8111 "        cat $random_seed E<gt>/dev/urandom\n"
8112 "    else\n"
8113 "        touch $random_seed\n"
8114 "    fi\n"
8115 "    chmod 600 $random_seed\n"
8116 "    poolfile=/proc/sys/kernel/random/poolsize\n"
8117 "    [ -r $poolfile ] && bytes=\\`cat $poolfile\\` || bytes=512\n"
8118 "    dd if=/dev/urandom of=$random_seed count=1 bs=$bytes\n"
8119 msgstr ""
8120
8121 #. type: Plain text
8122 #: build/C/man4/random.4:141
8123 msgid ""
8124 "Also, add the following lines in an appropriate script which is run during "
8125 "the Linux system shutdown:"
8126 msgstr ""
8127
8128 #. type: Plain text
8129 #: build/C/man4/random.4:152
8130 #, no-wrap
8131 msgid ""
8132 "    # Carry a random seed from shut-down to start-up\n"
8133 "    # Save the whole entropy pool\n"
8134 "    echo \"Saving random seed...\"\n"
8135 "    random_seed=/var/run/random-seed\n"
8136 "    touch $random_seed\n"
8137 "    chmod 600 $random_seed\n"
8138 "    poolfile=/proc/sys/kernel/random/poolsize\n"
8139 "    [ -r $poolfile ] && bytes=\\`cat $poolfile\\` || bytes=512\n"
8140 "    dd if=/dev/urandom of=$random_seed count=1 bs=$bytes\n"
8141 msgstr ""
8142
8143 #. type: SS
8144 #: build/C/man4/random.4:153
8145 #, no-wrap
8146 msgid "/proc Interface"
8147 msgstr ""
8148
8149 #. type: Plain text
8150 #: build/C/man4/random.4:159
8151 msgid ""
8152 "The files in the directory I</proc/sys/kernel/random> (present since 2.3.16) "
8153 "provide an additional interface to the I</dev/random> device."
8154 msgstr ""
8155
8156 #. type: Plain text
8157 #: build/C/man4/random.4:165
8158 msgid ""
8159 "The read-only file I<entropy_avail> gives the available entropy.  Normally, "
8160 "this will be 4096 (bits), a full entropy pool."
8161 msgstr ""
8162
8163 #. type: Plain text
8164 #: build/C/man4/random.4:170
8165 msgid ""
8166 "The file I<poolsize> gives the size of the entropy pool.  The semantics of "
8167 "this file vary across kernel versions:"
8168 msgstr ""
8169
8170 #. type: TP
8171 #: build/C/man4/random.4:171
8172 #, no-wrap
8173 msgid "Linux 2.4:"
8174 msgstr ""
8175
8176 #. type: Plain text
8177 #: build/C/man4/random.4:178
8178 msgid ""
8179 "This file gives the size of the entropy pool in I<bytes>.  Normally, this "
8180 "file will have the value 512, but it is writable, and can be changed to any "
8181 "value for which an algorithm is available.  The choices are 32, 64, 128, "
8182 "256, 512, 1024, or 2048."
8183 msgstr ""
8184
8185 #. type: TP
8186 #: build/C/man4/random.4:178
8187 #, no-wrap
8188 msgid "Linux 2.6:"
8189 msgstr ""
8190
8191 #. type: Plain text
8192 #: build/C/man4/random.4:183
8193 msgid ""
8194 "This file is read-only, and gives the size of the entropy pool in I<bits>.  "
8195 "It contains the value 4096."
8196 msgstr ""
8197
8198 #. type: Plain text
8199 #: build/C/man4/random.4:201
8200 msgid ""
8201 "The file I<read_wakeup_threshold> contains the number of bits of entropy "
8202 "required for waking up processes that sleep waiting for entropy from "
8203 "I</dev/random>.  The default is 64.  The file I<write_wakeup_threshold> "
8204 "contains the number of bits of entropy below which we wake up processes that "
8205 "do a B<select>(2)  or B<poll>(2)  for write access to I</dev/random>.  These "
8206 "values can be changed by writing to the files."
8207 msgstr ""
8208
8209 #. type: Plain text
8210 #: build/C/man4/random.4:209
8211 msgid ""
8212 "The read-only files I<uuid> and I<boot_id> contain random strings like "
8213 "6fd5a44b-35f4-4ad4-a9b9-6b9be13e1fe9.  The former is generated afresh for "
8214 "each read, the latter was generated once."
8215 msgstr ""
8216
8217 #. type: Plain text
8218 #: build/C/man4/random.4:211
8219 msgid "/dev/random"
8220 msgstr ""
8221
8222 #.  .SH AUTHOR
8223 #.  The kernel's random number generator was written by
8224 #.  Theodore Ts'o (tytso@athena.mit.edu).
8225 #. type: Plain text
8226 #: build/C/man4/random.4:216
8227 msgid "/dev/urandom"
8228 msgstr ""
8229
8230 #. type: Plain text
8231 #: build/C/man4/random.4:218
8232 msgid "mknod (1)"
8233 msgstr ""
8234
8235 #. type: Plain text
8236 #: build/C/man4/random.4:220
8237 msgid "RFC\\ 1750, \"Randomness Recommendations for Security\""
8238 msgstr ""
8239
8240 #. type: TH
8241 #: build/C/man4/sd.4:24
8242 #, no-wrap
8243 msgid "SD"
8244 msgstr ""
8245
8246 #. type: Plain text
8247 #: build/C/man4/sd.4:27
8248 msgid "sd - Driver for SCSI Disk Drives"
8249 msgstr ""
8250
8251 #. type: Plain text
8252 #: build/C/man4/sd.4:31
8253 #, no-wrap
8254 msgid ""
8255 "B<#include E<lt>linux/hdreg.hE<gt>        >/* for HDIO_GETGEO */\n"
8256 "B<#include E<lt>linux/fs.hE<gt>           >/* for BLKGETSIZE and BLKRRPART "
8257 "*/\n"
8258 msgstr ""
8259
8260 #. type: Plain text
8261 #: build/C/man4/sd.4:43
8262 msgid ""
8263 "The block device name has the following form: B<sd>I<lp,> where I<l> is a "
8264 "letter denoting the physical drive, and I<p> is a number denoting the "
8265 "partition on that physical drive.  Often, the partition number, I<p>, will "
8266 "be left off when the device corresponds to the whole drive."
8267 msgstr ""
8268
8269 #. type: Plain text
8270 #: build/C/man4/sd.4:52
8271 msgid ""
8272 "SCSI disks have a major device number of 8, and a minor device number of the "
8273 "form (16 * I<drive_number>) + I<partition_number>, where I<drive_number> is "
8274 "the number of the physical drive in order of detection, and "
8275 "I<partition_number> is as follows:"
8276 msgstr ""
8277
8278 #. type: Plain text
8279 #: build/C/man4/sd.4:54
8280 msgid "partition 0 is the whole drive"
8281 msgstr ""
8282
8283 #. type: Plain text
8284 #: build/C/man4/sd.4:56
8285 msgid "partitions 1-4 are the DOS \"primary\" partitions"
8286 msgstr ""
8287
8288 #. type: Plain text
8289 #: build/C/man4/sd.4:58
8290 msgid "partitions 5-8 are the DOS \"extended\" (or \"logical\") partitions"
8291 msgstr ""
8292
8293 #. type: Plain text
8294 #: build/C/man4/sd.4:66
8295 msgid ""
8296 "For example, I</dev/sda> will have major 8, minor 0, and will refer to all "
8297 "of the first SCSI drive in the system; and I</dev/sdb3> will have major 8, "
8298 "minor 19, and will refer to the third DOS \"primary\" partition on the "
8299 "second SCSI drive in the system."
8300 msgstr ""
8301
8302 #. type: Plain text
8303 #: build/C/man4/sd.4:69
8304 msgid ""
8305 "At this time, only block devices are provided.  Raw devices have not yet "
8306 "been implemented."
8307 msgstr ""
8308
8309 #. type: Plain text
8310 #: build/C/man4/sd.4:73
8311 msgid "The following I<ioctl>s are provided:"
8312 msgstr ""
8313
8314 #. type: TP
8315 #: build/C/man4/sd.4:73
8316 #, no-wrap
8317 msgid "B<HDIO_GETGEO>"
8318 msgstr ""
8319
8320 #. type: Plain text
8321 #: build/C/man4/sd.4:77
8322 msgid "Returns the BIOS disk parameters in the following structure:"
8323 msgstr ""
8324
8325 #. type: Plain text
8326 #: build/C/man4/sd.4:86
8327 #, no-wrap
8328 msgid ""
8329 "struct hd_geometry {\n"
8330 "    unsigned char  heads;\n"
8331 "    unsigned char  sectors;\n"
8332 "    unsigned short cylinders;\n"
8333 "    unsigned long  start;\n"
8334 "};\n"
8335 msgstr ""
8336
8337 #. type: Plain text
8338 #: build/C/man4/sd.4:92
8339 msgid "A pointer to this structure is passed as the B<ioctl>(2)  parameter."
8340 msgstr ""
8341
8342 #. type: Plain text
8343 #: build/C/man4/sd.4:107
8344 msgid ""
8345 "The information returned in the parameter is the disk geometry of the drive "
8346 "I<as understood by DOS!> This geometry is I<not> the physical geometry of "
8347 "the drive.  It is used when constructing the drive's partition table, "
8348 "however, and is needed for convenient operation of B<fdisk>(1), "
8349 "B<efdisk>(1), and B<lilo>(1).  If the geometry information is not available, "
8350 "zero will be returned for all of the parameters."
8351 msgstr ""
8352
8353 #. type: TP
8354 #: build/C/man4/sd.4:108
8355 #, no-wrap
8356 msgid "B<BLKGETSIZE>"
8357 msgstr ""
8358
8359 #. type: Plain text
8360 #: build/C/man4/sd.4:115
8361 msgid ""
8362 "Returns the device size in sectors.  The B<ioctl>(2)  parameter should be a "
8363 "pointer to a I<long>."
8364 msgstr ""
8365
8366 #. type: TP
8367 #: build/C/man4/sd.4:115
8368 #, no-wrap
8369 msgid "B<BLKRRPART>"
8370 msgstr ""
8371
8372 #. type: Plain text
8373 #: build/C/man4/sd.4:119
8374 msgid "Forces a reread of the SCSI disk partition tables.  No parameter is needed."
8375 msgstr ""
8376
8377 #. type: Plain text
8378 #: build/C/man4/sd.4:130
8379 msgid ""
8380 "The B<scsi>(4)  B<ioctl>(2)  operations are also supported.  If the "
8381 "B<ioctl>(2)  parameter is required, and it is NULL, then B<ioctl>(2)  will "
8382 "fail with the error B<EINVAL>."
8383 msgstr ""
8384
8385 #. type: Plain text
8386 #: build/C/man4/sd.4:132
8387 msgid "/dev/sd[a-h]: the whole device"
8388 msgstr ""
8389
8390 #. .SH "SEE ALSO"
8391 #. .BR scsi (4)
8392 #. type: Plain text
8393 #: build/C/man4/sd.4:136
8394 msgid "/dev/sd[a-h][0-8]: individual block partitions"
8395 msgstr ""
8396
8397 #. type: TH
8398 #: build/C/man3/setlogmask.3:23
8399 #, no-wrap
8400 msgid "SETLOGMASK"
8401 msgstr ""
8402
8403 #. type: TH
8404 #: build/C/man3/setlogmask.3:23
8405 #, no-wrap
8406 msgid "2001-10-05"
8407 msgstr ""
8408
8409 #. type: Plain text
8410 #: build/C/man3/setlogmask.3:26
8411 msgid "setlogmask - set log priority mask"
8412 msgstr ""
8413
8414 #. type: Plain text
8415 #: build/C/man3/setlogmask.3:29
8416 #, no-wrap
8417 msgid "B<#include E<lt>syslog.hE<gt>>\n"
8418 msgstr ""
8419
8420 #. type: Plain text
8421 #: build/C/man3/setlogmask.3:31
8422 #, no-wrap
8423 msgid "B<int setlogmask(int >I<mask>B<);>\n"
8424 msgstr ""
8425
8426 #. type: Plain text
8427 #: build/C/man3/setlogmask.3:41
8428 msgid ""
8429 "A process has a log priority mask that determines which calls to "
8430 "B<syslog>(3)  may be logged.  All other calls will be ignored.  Logging is "
8431 "enabled for the priorities that have the corresponding bit set in I<mask>.  "
8432 "The initial mask is such that logging is enabled for all priorities."
8433 msgstr ""
8434
8435 #. type: Plain text
8436 #: build/C/man3/setlogmask.3:47
8437 msgid ""
8438 "The B<setlogmask>()  function sets this logmask for the calling process, and "
8439 "returns the previous mask.  If the mask argument is 0, the current logmask "
8440 "is not modified."
8441 msgstr ""
8442
8443 #. type: Plain text
8444 #: build/C/man3/setlogmask.3:61
8445 msgid ""
8446 "The eight priorities are B<LOG_EMERG>, B<LOG_ALERT>, B<LOG_CRIT>, "
8447 "B<LOG_ERR>, B<LOG_WARNING>, B<LOG_NOTICE>, B<LOG_INFO>, and B<LOG_DEBUG>.  "
8448 "The bit corresponding to a priority I<p> is B<LOG_MASK>(I<p>).  Some systems "
8449 "also provide a macro B<LOG_UPTO>(I<p>) for the mask of all priorities in the "
8450 "above list up to and including I<p>."
8451 msgstr ""
8452
8453 #. type: Plain text
8454 #: build/C/man3/setlogmask.3:63
8455 msgid "This function returns the previous log priority mask."
8456 msgstr ""
8457
8458 #.  .SH NOTES
8459 #.  The glibc logmask handling was broken in versions before glibc 2.1.1.
8460 #. type: Plain text
8461 #: build/C/man3/setlogmask.3:67
8462 msgid "None."
8463 msgstr ""
8464
8465 #. type: Plain text
8466 #: build/C/man3/setlogmask.3:70
8467 msgid "POSIX.1-2001.  Note that the description in POSIX.1-2001 is flawed."
8468 msgstr ""
8469
8470 #. type: Plain text
8471 #: build/C/man3/setlogmask.3:74
8472 msgid "B<closelog>(3), B<openlog>(3), B<syslog>(3)"
8473 msgstr ""
8474
8475 #. type: TH
8476 #: build/C/man4/sk98lin.4:25
8477 #, no-wrap
8478 msgid "SK98LIN"
8479 msgstr ""
8480
8481 #. type: TH
8482 #: build/C/man4/sk98lin.4:25
8483 #, no-wrap
8484 msgid "2007-11-25"
8485 msgstr ""
8486
8487 #. type: Plain text
8488 #: build/C/man4/sk98lin.4:28
8489 msgid "sk98lin - Marvell/SysKonnect Gigabit Ethernet driver v6.21"
8490 msgstr ""
8491
8492 #. type: Plain text
8493 #: build/C/man4/sk98lin.4:60
8494 msgid ""
8495 "B<insmod sk98lin.o> [B<Speed_A=>I<i,j,...>] [B<Speed_B=>I<i,j,...>] "
8496 "[B<AutoNeg_A=>I<i,j,...>] [B<AutoNeg_B=>I<i,j,...>] [B<DupCap_A=>I<i,j,...>] "
8497 "[B<DupCap_B=>I<i,j,...>] [B<FlowCtrl_A=>I<i,j,...>] "
8498 "[B<FlowCtrl_B=>I<i,j,...>] [B<Role_A=>I<i,j,...>] [B<Role_B=>I<i,j,...>] "
8499 "[B<ConType=>I<i,j,...>] [B<Moderation=>I<i,j,...>] "
8500 "[B<IntsPerSec=>I<i,j,...>] [B<PrefPort=>I<i,j,...>] [B<RlmtMode=>I<i,j,...>]"
8501 msgstr ""
8502
8503 #. type: Plain text
8504 #: build/C/man4/sk98lin.4:69
8505 msgid ""
8506 "B<sk98lin> is the Gigabit Ethernet driver for Marvell and SysKonnect network "
8507 "adapter cards.  It supports SysKonnect SK-98xx/SK-95xx compliant Gigabit "
8508 "Ethernet Adapter and any Yukon compliant chipset."
8509 msgstr ""
8510
8511 #. type: Plain text
8512 #: build/C/man4/sk98lin.4:76
8513 msgid ""
8514 "When loading the driver using insmod, parameters for the network adapter "
8515 "cards might be stated as a sequence of comma separated commands.  If for "
8516 "instance two network adapters are installed and AutoNegotiation on Port A of "
8517 "the first adapter should be ON, but on the Port A of the second adapter "
8518 "switched OFF, one must enter:"
8519 msgstr ""
8520
8521 #. type: Plain text
8522 #: build/C/man4/sk98lin.4:78
8523 #, no-wrap
8524 msgid "   insmod sk98lin.o AutoNeg_A=On,Off\n"
8525 msgstr ""
8526
8527 #. type: Plain text
8528 #: build/C/man4/sk98lin.4:93
8529 msgid ""
8530 "After B<sk98lin> is bound to one or more adapter cards and the I</proc> file "
8531 "system is mounted on your system, a dedicated statistics file will be "
8532 "created in folder I</proc/net/sk98lin> for all ports of the installed "
8533 "network adapter cards.  Those files are named I<eth[x]> whereas I<x> is the "
8534 "number of the interface that has been assigned to a dedicated port by the "
8535 "system."
8536 msgstr ""
8537
8538 #. type: Plain text
8539 #: build/C/man4/sk98lin.4:103
8540 msgid ""
8541 "If loading is finished, any desired IP address can be assigned to the "
8542 "respective I<eth[x]> interface using the B<ifconfig>(8)  command.  This "
8543 "causes the adapter to connect to the Ethernet and to display a status "
8544 "message on the console saying \"ethx: network connection up using port y\" "
8545 "followed by the configured or detected connection parameters."
8546 msgstr ""
8547
8548 #. type: Plain text
8549 #: build/C/man4/sk98lin.4:119
8550 msgid ""
8551 "The B<sk98lin> also supports large frames (also called jumbo frames).  Using "
8552 "jumbo frames can improve throughput tremendously when transferring large "
8553 "amounts of data.  To enable large frames, the MTU (maximum transfer unit) "
8554 "size for an interface is to be set to a high value.  The default MTU size is "
8555 "1500 and can be changed up to 9000 (bytes).  Setting the MTU size can be "
8556 "done when assigning the IP address to the interface or later by using the "
8557 "B<ifconfig>(8)  command with the mtu parameter.  If for instance eth0 needs "
8558 "an IP address and a large frame MTU size, the following two commands might "
8559 "be used:"
8560 msgstr ""
8561
8562 #. type: Plain text
8563 #: build/C/man4/sk98lin.4:122
8564 #, no-wrap
8565 msgid ""
8566 "    ifconfig eth0 10.1.1.1\n"
8567 "    ifconfig eth0 mtu 9000\n"
8568 msgstr ""
8569
8570 #. type: Plain text
8571 #: build/C/man4/sk98lin.4:124
8572 msgid "Those two commands might even be combined into one:"
8573 msgstr ""
8574
8575 #. type: Plain text
8576 #: build/C/man4/sk98lin.4:126
8577 #, no-wrap
8578 msgid "    ifconfig eth0 10.1.1.1 mtu 9000\n"
8579 msgstr ""
8580
8581 #. type: Plain text
8582 #: build/C/man4/sk98lin.4:139
8583 msgid ""
8584 "Note that large frames can only be used if permitted by your network "
8585 "infrastructure.  This means, that any switch being used in your Ethernet "
8586 "must also support large frames.  Quite some switches support large frames, "
8587 "but need to be configured to do so.  Most of the times, their default "
8588 "setting is to support only standard frames with an MTU size of 1500 "
8589 "(bytes).  In addition to the switches inside the network, all network "
8590 "adapters that are to be used must also be enabled regarding jumbo frames.  "
8591 "If an adapter is not set to receive large frames it will simply drop them."
8592 msgstr ""
8593
8594 #. type: Plain text
8595 #: build/C/man4/sk98lin.4:143
8596 msgid ""
8597 "Switching back to the standard Ethernet frame size can be done by using the "
8598 "B<ifconfig>(8)  command again:"
8599 msgstr ""
8600
8601 #. type: Plain text
8602 #: build/C/man4/sk98lin.4:145
8603 #, no-wrap
8604 msgid "    ifconfig eth0 mtu 1500\n"
8605 msgstr ""
8606
8607 #. type: Plain text
8608 #: build/C/man4/sk98lin.4:151
8609 msgid ""
8610 "The Marvell/SysKonnect Gigabit Ethernet driver for Linux is able to support "
8611 "VLAN and Link Aggregation according to IEEE standards 802.1, 802.1q, and "
8612 "802.3ad.  Those features are only available after installation of open "
8613 "source modules which can be found on the Internet:"
8614 msgstr ""
8615
8616 #. type: Plain text
8617 #: build/C/man4/sk98lin.4:154
8618 msgid "I<VLAN>: http://www.candelatech.com/~greear/vlan.html"
8619 msgstr ""
8620
8621 #. type: Plain text
8622 #: build/C/man4/sk98lin.4:158
8623 msgid "I<Link> I<Aggregation>: http://www.st.rim.or.jp/~yumo"
8624 msgstr ""
8625
8626 #. type: Plain text
8627 #: build/C/man4/sk98lin.4:163
8628 msgid ""
8629 "Note that Marvell/SysKonnect does not offer any support for these open "
8630 "source modules and does not take the responsibility for any kind of failures "
8631 "or problems arising when using these modules."
8632 msgstr ""
8633
8634 #. type: SS
8635 #: build/C/man4/sk98lin.4:163 build/C/man4/wavelan.4:32
8636 #, no-wrap
8637 msgid "Parameters"
8638 msgstr ""
8639
8640 #. type: TP
8641 #: build/C/man4/sk98lin.4:164
8642 #, no-wrap
8643 msgid "B<Speed_A=>I<i,j,...>"
8644 msgstr ""
8645
8646 #. type: Plain text
8647 #: build/C/man4/sk98lin.4:182
8648 msgid ""
8649 "This parameter is used to set the speed capabilities of port A of an adapter "
8650 "card.  It is only valid for Yukon copper adapters.  Possible values are: "
8651 "I<10>, I<100>, I<1000> or I<Auto> whereas I<Auto> is the default.  Usually, "
8652 "the speed is negotiated between the two ports during link establishment.  If "
8653 "this fails, a port can be forced to a specific setting with this parameter."
8654 msgstr ""
8655
8656 #. type: TP
8657 #: build/C/man4/sk98lin.4:182
8658 #, no-wrap
8659 msgid "B<Speed_B=>I<i,j,...>"
8660 msgstr ""
8661
8662 #. type: Plain text
8663 #: build/C/man4/sk98lin.4:200
8664 msgid ""
8665 "This parameter is used to set the speed capabilities of port B of an adapter "
8666 "card.  It is only valid for Yukon copper adapters.  Possible values are: "
8667 "I<10>, I<100>, I<1000> or I<Auto> whereas I<Auto> is the default.  Usually, "
8668 "the speed is negotiated between the two ports during link establishment.  If "
8669 "this fails, a port can be forced to a specific setting with this parameter."
8670 msgstr ""
8671
8672 #. type: TP
8673 #: build/C/man4/sk98lin.4:200
8674 #, no-wrap
8675 msgid "B<AutoNeg_A=>I<i,j,...>"
8676 msgstr ""
8677
8678 #. type: Plain text
8679 #: build/C/man4/sk98lin.4:215
8680 msgid ""
8681 "Enables or disables the use of autonegotiation of port A of an adapter "
8682 "card.  Possible values are: I<On>, I<Off> or I<Sense> whereas I<On> is the "
8683 "default.  The I<Sense> mode automatically detects whether the link partner "
8684 "supports auto-negotiation or not."
8685 msgstr ""
8686
8687 #. type: TP
8688 #: build/C/man4/sk98lin.4:215
8689 #, no-wrap
8690 msgid "B<AutoNeg_B=>I<i,j,...>"
8691 msgstr ""
8692
8693 #. type: Plain text
8694 #: build/C/man4/sk98lin.4:230
8695 msgid ""
8696 "Enables or disables the use of autonegotiation of port B of an adapter "
8697 "card.  Possible values are: I<On>, I<Off> or I<Sense> whereas I<On> is the "
8698 "default.  The I<Sense> mode automatically detects whether the link partner "
8699 "supports auto-negotiation or not."
8700 msgstr ""
8701
8702 #. type: TP
8703 #: build/C/man4/sk98lin.4:230
8704 #, no-wrap
8705 msgid "B<DupCap_A=>I<i,j,...>"
8706 msgstr ""
8707
8708 #. type: Plain text
8709 #: build/C/man4/sk98lin.4:261
8710 msgid ""
8711 "This parameter indicates the duplex mode to be used for port A of an adapter "
8712 "card.  Possible values are: I<Half>, I<Full> or I<Both> whereas I<Both> is "
8713 "the default.  This parameter is only relevant if AutoNeg_A of port A is not "
8714 "set to I<Sense>.  If AutoNeg_A is set to I<On>, all three values of DupCap_A "
8715 "( I<Half>, I<Full> or I<Both>)  might be stated.  If AutoNeg_A is set to "
8716 "I<Off>, only DupCap_A values I<Full> and I<Half> are allowed.  This DupCap_A "
8717 "parameter is useful if your link partner does not support all possible "
8718 "duplex combinations."
8719 msgstr ""
8720
8721 #. type: TP
8722 #: build/C/man4/sk98lin.4:261
8723 #, no-wrap
8724 msgid "B<DupCap_B=>I<i,j,...>"
8725 msgstr ""
8726
8727 #. type: Plain text
8728 #: build/C/man4/sk98lin.4:292
8729 msgid ""
8730 "This parameter indicates the duplex mode to be used for port B of an adapter "
8731 "card.  Possible values are: I<Half>, I<Full> or I<Both> whereas I<Both> is "
8732 "the default.  This parameter is only relevant if AutoNeg_B of port B is not "
8733 "set to I<Sense>.  If AutoNeg_B is set to I<On>, all three values of DupCap_B "
8734 "( I<Half>, I<Full> or I<Both>)  might be stated.  If AutoNeg_B is set to "
8735 "I<Off>, only DupCap_B values I<Full> and I<Half> are allowed.  This DupCap_B "
8736 "parameter is useful if your link partner does not support all possible "
8737 "duplex combinations."
8738 msgstr ""
8739
8740 #. type: TP
8741 #: build/C/man4/sk98lin.4:292
8742 #, no-wrap
8743 msgid "B<FlowCtrl_A=>I<i,j,...>"
8744 msgstr ""
8745
8746 #. type: Plain text
8747 #: build/C/man4/sk98lin.4:306 build/C/man4/sk98lin.4:340
8748 msgid ""
8749 "This parameter can be used to set the flow control capabilities the port "
8750 "reports during auto-negotiation.  Possible values are: I<Sym>, I<SymOrRem>, "
8751 "I<LocSend> or I<None> whereas I<SymOrRem> is the default.  The different "
8752 "modes have the following meaning:"
8753 msgstr ""
8754
8755 #. type: Plain text
8756 #: build/C/man4/sk98lin.4:311 build/C/man4/sk98lin.4:344
8757 #, no-wrap
8758 msgid ""
8759 "I<Sym>\n"
8760 "= Symmetric\n"
8761 " both link partners are allowed to send PAUSE frames\n"
8762 msgstr ""
8763
8764 #. type: Plain text
8765 #: build/C/man4/sk98lin.4:315 build/C/man4/sk98lin.4:348
8766 #, no-wrap
8767 msgid ""
8768 "I<SymOrRem>\n"
8769 "= SymmetricOrRemote\n"
8770 " both or only remote partner are allowed to send PAUSE frames\n"
8771 msgstr ""
8772
8773 #. type: Plain text
8774 #: build/C/man4/sk98lin.4:319 build/C/man4/sk98lin.4:352
8775 #, no-wrap
8776 msgid ""
8777 "I<LocSend>\n"
8778 "= LocalSend\n"
8779 " only local link partner is allowed to send PAUSE frames\n"
8780 msgstr ""
8781
8782 #. type: Plain text
8783 #: build/C/man4/sk98lin.4:323 build/C/man4/sk98lin.4:356
8784 #, no-wrap
8785 msgid ""
8786 "I<None>\n"
8787 "= None\n"
8788 " no link partner is allowed to send PAUSE frames\n"
8789 msgstr ""
8790
8791 #. type: Plain text
8792 #: build/C/man4/sk98lin.4:326
8793 msgid "Note that this parameter is ignored if AutoNeg_A is set to I<Off>."
8794 msgstr ""
8795
8796 #. type: TP
8797 #: build/C/man4/sk98lin.4:326
8798 #, no-wrap
8799 msgid "B<FlowCtrl_B=>I<i,j,...>"
8800 msgstr ""
8801
8802 #. type: Plain text
8803 #: build/C/man4/sk98lin.4:360
8804 msgid "Note that this parameter is ignored if AutoNeg_B is set to I<Off>."
8805 msgstr ""
8806
8807 #. type: TP
8808 #: build/C/man4/sk98lin.4:360
8809 #, no-wrap
8810 msgid "B<Role_A=>I<i,j,...>"
8811 msgstr ""
8812
8813 #. type: Plain text
8814 #: build/C/man4/sk98lin.4:377
8815 msgid ""
8816 "This parameter is only valid for 1000Base-T adapter cards.  For two "
8817 "1000Base-T ports to communicate, one must take the role of the master "
8818 "(providing timing information), while the other must be the slave.  Possible "
8819 "values are: I<Auto>, I<Master> or I<Slave> whereas I<Auto> is the default.  "
8820 "Usually, the role of a port is negotiated between two ports during link "
8821 "establishment, but if that fails the port A of an adapter card can be forced "
8822 "to a specific setting with this parameter."
8823 msgstr ""
8824
8825 #. type: TP
8826 #: build/C/man4/sk98lin.4:377
8827 #, no-wrap
8828 msgid "B<Role_B=>I<i,j,...>"
8829 msgstr ""
8830
8831 #. type: Plain text
8832 #: build/C/man4/sk98lin.4:395
8833 msgid ""
8834 "This parameter is only valid for 1000Base-T adapter cards.  For two "
8835 "1000Base-T ports to communicate, one must take the role of the master "
8836 "(providing timing information), while the other must be the slave.  Possible "
8837 "values are: I<Auto>, I<Master> or I<Slave> whereas I<Auto> is the default.  "
8838 "Usually, the role of a port is negotiated between two ports during link "
8839 "establishment, but if that fails the port B of an adapter card can be forced "
8840 "to a specific setting with this parameter."
8841 msgstr ""
8842
8843 #. type: TP
8844 #: build/C/man4/sk98lin.4:395
8845 #, no-wrap
8846 msgid "B<ConType=>I<i,j,...>"
8847 msgstr ""
8848
8849 #. type: Plain text
8850 #: build/C/man4/sk98lin.4:403
8851 msgid ""
8852 "This parameter is a combination of all five per-port parameters within one "
8853 "single parameter.  This simplifies the configuration of both ports of an "
8854 "adapter card.  The different values of this variable reflect the most "
8855 "meaningful combinations of port parameters.  Possible values and their "
8856 "corresponding combination of per-port parameters:"
8857 msgstr ""
8858
8859 #. type: Plain text
8860 #: build/C/man4/sk98lin.4:408
8861 #, no-wrap
8862 msgid ""
8863 "ConType | DupCap   AutoNeg   FlowCtrl   Role   Speed\n"
8864 "--------+-------------------------------------------\n"
8865 "I<Auto>    |  Both      On      SymOrRem   Auto   Auto\n"
8866 msgstr ""
8867
8868 #. type: Plain text
8869 #: build/C/man4/sk98lin.4:410
8870 #, no-wrap
8871 msgid "I<100FD>   |  Full      Off       None     Auto   100\n"
8872 msgstr ""
8873
8874 #. type: Plain text
8875 #: build/C/man4/sk98lin.4:412
8876 #, no-wrap
8877 msgid "I<100HD>   |  Half      Off       None     Auto   100\n"
8878 msgstr ""
8879
8880 #. type: Plain text
8881 #: build/C/man4/sk98lin.4:414
8882 #, no-wrap
8883 msgid "I<10FD>    |  Full      Off       None     Auto   10\n"
8884 msgstr ""
8885
8886 #. type: Plain text
8887 #: build/C/man4/sk98lin.4:416
8888 #, no-wrap
8889 msgid "I<10HD>    |  Half      Off       None     Auto   10\n"
8890 msgstr ""
8891
8892 #. type: Plain text
8893 #: build/C/man4/sk98lin.4:426
8894 msgid ""
8895 "Stating any other port parameter together with this I<ConType> parameter "
8896 "will result in a merged configuration of those settings.  This is due to the "
8897 "fact, that the per-port parameters (e.g.  I<Speed_A>)  have a higher "
8898 "priority than the combined variable I<ConType>."
8899 msgstr ""
8900
8901 #. type: TP
8902 #: build/C/man4/sk98lin.4:426
8903 #, no-wrap
8904 msgid "B<Moderation=>I<i,j,...>"
8905 msgstr ""
8906
8907 #. type: Plain text
8908 #: build/C/man4/sk98lin.4:444
8909 msgid ""
8910 "Interrupt moderation is employed to limit the maximum number of interrupts "
8911 "the driver has to serve.  That is, one or more interrupts (which indicate "
8912 "any transmit or receive packet to be processed) are queued until the driver "
8913 "processes them.  When queued interrupts are to be served, is determined by "
8914 "the I<IntsPerSec> parameter, which is explained later below.  Possible "
8915 "moderation modes are: I<None>, I<Static> or I<Dynamic> whereas I<None> is "
8916 "the default.  The different modes have the following meaning:"
8917 msgstr ""
8918
8919 #. type: Plain text
8920 #: build/C/man4/sk98lin.4:449
8921 msgid ""
8922 "I<None> No interrupt moderation is applied on the adapter card.  Therefore, "
8923 "each transmit or receive interrupt is served immediately as soon as it "
8924 "appears on the interrupt line of the adapter card."
8925 msgstr ""
8926
8927 #. type: Plain text
8928 #: build/C/man4/sk98lin.4:464
8929 msgid ""
8930 "I<Static> Interrupt moderation is applied on the adapter card.  All transmit "
8931 "and receive interrupts are queued until a complete moderation interval "
8932 "ends.  If such a moderation interval ends, all queued interrupts are "
8933 "processed in one big bunch without any delay.  The term I<Static> reflects "
8934 "the fact, that interrupt moderation is always enabled, regardless how much "
8935 "network load is currently passing via a particular interface.  In addition, "
8936 "the duration of the moderation interval has a fixed length that never "
8937 "changes while the driver is operational."
8938 msgstr ""
8939
8940 #. type: Plain text
8941 #: build/C/man4/sk98lin.4:475
8942 msgid ""
8943 "I<Dynamic> Interrupt moderation might be applied on the adapter card, "
8944 "depending on the load of the system.  If the driver detects that the system "
8945 "load is too high, the driver tries to shield the system against too much "
8946 "network load by enabling interrupt moderation.  If\\(emat a later "
8947 "time\\(emthe CPU utilization decreases again (or if the network load is "
8948 "negligible) the interrupt moderation will automatically be disabled."
8949 msgstr ""
8950
8951 #. type: Plain text
8952 #: build/C/man4/sk98lin.4:481
8953 msgid ""
8954 "Interrupt moderation should be used when the driver has to handle one or "
8955 "more interfaces with a high network load, which\\(emas a "
8956 "consequence\\(emleads also to a high CPU utilization.  When moderation is "
8957 "applied in such high network load situations, CPU load might be reduced by "
8958 "20-30% on slow computers."
8959 msgstr ""
8960
8961 #. type: Plain text
8962 #: build/C/man4/sk98lin.4:485
8963 msgid ""
8964 "Note that the drawback of using interrupt moderation is an increase of the "
8965 "round-trip-time (RTT), due to the queuing and serving of interrupts at "
8966 "dedicated moderation times."
8967 msgstr ""
8968
8969 #. type: TP
8970 #: build/C/man4/sk98lin.4:485
8971 #, no-wrap
8972 msgid "B<IntsPerSec=>I<i,j,...>"
8973 msgstr ""
8974
8975 #. type: Plain text
8976 #: build/C/man4/sk98lin.4:495
8977 msgid ""
8978 "This parameter determines the length of any interrupt moderation interval.  "
8979 "Assuming that static interrupt moderation is to be used, an I<IntsPerSec> "
8980 "parameter value of 2000 will lead to an interrupt moderation interval of 500 "
8981 "microseconds.  Possible values for this parameter are in the range of "
8982 "30...40000 (interrupts per second).  The default value is 2000."
8983 msgstr ""
8984
8985 #. type: Plain text
8986 #: build/C/man4/sk98lin.4:499
8987 msgid ""
8988 "This parameter is only used, if either static or dynamic interrupt "
8989 "moderation is enabled on a network adapter card.  This parameter is ignored "
8990 "if no moderation is applied."
8991 msgstr ""
8992
8993 #. type: Plain text
8994 #: build/C/man4/sk98lin.4:506
8995 msgid ""
8996 "Note that the duration of the moderation interval is to be chosen with "
8997 "care.  At first glance, selecting a very long duration (e.g., only 100 "
8998 "interrupts per second) seems to be meaningful, but the increase of "
8999 "packet-processing delay is tremendous.  On the other hand, selecting a very "
9000 "short moderation time might compensate the use of any moderation being "
9001 "applied."
9002 msgstr ""
9003
9004 #. type: TP
9005 #: build/C/man4/sk98lin.4:506
9006 #, no-wrap
9007 msgid "B<PrefPort=>I<i,j,...>"
9008 msgstr ""
9009
9010 #. type: Plain text
9011 #: build/C/man4/sk98lin.4:519
9012 msgid ""
9013 "This parameter is used to force the preferred port to A or B (on dual-port "
9014 "network adapters).  The preferred port is the one that is used if both ports "
9015 "A and B are detected as fully functional.  Possible values are: I<A> or I<B> "
9016 "whereas I<A> is the default."
9017 msgstr ""
9018
9019 #. type: TP
9020 #: build/C/man4/sk98lin.4:519
9021 #, no-wrap
9022 msgid "B<RlmtMode=>I<i,j,...>"
9023 msgstr ""
9024
9025 #. type: Plain text
9026 #: build/C/man4/sk98lin.4:536
9027 msgid ""
9028 "RLMT monitors the status of the port.  If the link of the active port fails, "
9029 "RLMT switches immediately to the standby link.  The virtual link is "
9030 "maintained as long as at least one \"physical\" link is up.  This parameters "
9031 "states how RLMT should monitor both ports.  Possible values are: "
9032 "I<CheckLinkState>, I<CheckLocalPort>, I<CheckSeg> or I<DualNet> whereas "
9033 "I<CheckLinkState> is the default.  The different modes have the following "
9034 "meaning:"
9035 msgstr ""
9036
9037 #. type: Plain text
9038 #: build/C/man4/sk98lin.4:541
9039 msgid ""
9040 "I<CheckLinkState> Check link state only: RLMT uses the link state reported "
9041 "by the adapter hardware for each individual port to determine whether a port "
9042 "can be used for all network traffic or not."
9043 msgstr ""
9044
9045 #. type: Plain text
9046 #: build/C/man4/sk98lin.4:549
9047 msgid ""
9048 "I<CheckLocalPort> In this mode, RLMT monitors the network path between the "
9049 "two ports of an adapter by regularly exchanging packets between them.  This "
9050 "mode requires a network configuration in which the two ports are able to "
9051 "\"see\" each other (i.e., there must not be any router between the ports)."
9052 msgstr ""
9053
9054 #. type: Plain text
9055 #: build/C/man4/sk98lin.4:558
9056 msgid ""
9057 "I<CheckSeg> Check local port and segmentation: This mode supports the same "
9058 "functions as the CheckLocalPort mode and additionally checks network "
9059 "segmentation between the ports.  Therefore, this mode is only to be used if "
9060 "Gigabit Ethernet switches are installed on the network that have been "
9061 "configured to use the Spanning Tree protocol."
9062 msgstr ""
9063
9064 #. type: Plain text
9065 #: build/C/man4/sk98lin.4:569
9066 msgid ""
9067 "I<DualNet> In this mode, ports A and B are used as separate devices.  If you "
9068 "have a dual port adapter, port A will be configured as I<eth[x]> and port B "
9069 "as I<eth[x+1]>.  Both ports can be used independently with distinct IP "
9070 "addresses.  The preferred port setting is not used.  RLMT is turned off."
9071 msgstr ""
9072
9073 #. type: Plain text
9074 #: build/C/man4/sk98lin.4:578
9075 msgid ""
9076 "Note that RLMT modes I<CheckLocalPort> and I<CheckLinkState> are designed to "
9077 "operate in configurations where a network path between the ports on one "
9078 "adapter exists.  Moreover, they are not designed to work where adapters are "
9079 "connected back-to-back."
9080 msgstr ""
9081
9082 #. type: TP
9083 #: build/C/man4/sk98lin.4:579
9084 #, no-wrap
9085 msgid "I</proc/net/sk98lin/eth[x]>"
9086 msgstr ""
9087
9088 #. type: Plain text
9089 #: build/C/man4/sk98lin.4:585
9090 msgid ""
9091 "The statistics file of a particular interface of an adapter card.  It "
9092 "contains generic information about the adapter card plus a detailed summary "
9093 "of all transmit and receive counters."
9094 msgstr ""
9095
9096 #. type: TP
9097 #: build/C/man4/sk98lin.4:585
9098 #, no-wrap
9099 msgid "I</usr/src/linux/Documentation/networking/sk98lin.txt>"
9100 msgstr ""
9101
9102 #. type: Plain text
9103 #: build/C/man4/sk98lin.4:596
9104 msgid ""
9105 "This is the I<README> file of the I<sk98lin> driver.  It contains a detailed "
9106 "installation HOWTO and describes all parameters of the driver.  It denotes "
9107 "also common problems and provides the solution to them."
9108 msgstr ""
9109
9110 #.  .SH AUTHORS
9111 #.  Ralph Roesler \(em rroesler@syskonnect.de
9112 #.  .br
9113 #.  Mirko Lindner \(em mlindner@syskonnect.de
9114 #. type: Plain text
9115 #: build/C/man4/sk98lin.4:602
9116 msgid "Report any bugs to linux@syskonnect.de"
9117 msgstr ""
9118
9119 #. type: Plain text
9120 #: build/C/man4/sk98lin.4:606
9121 msgid "B<ifconfig>(8), B<insmod>(8), B<modprobe>(8)"
9122 msgstr ""
9123
9124 #. type: TH
9125 #: build/C/man4/st.4:23
9126 #, no-wrap
9127 msgid "ST"
9128 msgstr ""
9129
9130 #. type: Plain text
9131 #: build/C/man4/st.4:26
9132 msgid "st - SCSI tape device"
9133 msgstr ""
9134
9135 #. type: Plain text
9136 #: build/C/man4/st.4:29
9137 #, no-wrap
9138 msgid "B<#include E<lt>sys/mtio.hE<gt>>\n"
9139 msgstr ""
9140
9141 #. type: Plain text
9142 #: build/C/man4/st.4:34
9143 #, no-wrap
9144 msgid ""
9145 "B<int ioctl(int >I<fd>B<, int >I<request>B< [, (void *)>I<arg3>B<]);>\n"
9146 "B<int ioctl(int >I<fd>B<, MTIOCTOP, (struct mtop *)>I<mt_cmd>B<);>\n"
9147 "B<int ioctl(int >I<fd>B<, MTIOCGET, (struct mtget *)>I<mt_status>B<);>\n"
9148 "B<int ioctl(int >I<fd>B<, MTIOCPOS, (struct mtpos *)>I<mt_pos>B<);>\n"
9149 msgstr ""
9150
9151 #. type: Plain text
9152 #: build/C/man4/st.4:44
9153 msgid ""
9154 "The B<st> driver provides the interface to a variety of SCSI tape devices.  "
9155 "Currently, the driver takes control of all detected devices of type "
9156 "\\(lqsequential-access\\(rq.  The B<st> driver uses major device number 9."
9157 msgstr ""
9158
9159 #. type: Plain text
9160 #: build/C/man4/st.4:64
9161 msgid ""
9162 "Each device uses eight minor device numbers.  The lowermost five bits in the "
9163 "minor numbers are assigned sequentially in the order of detection.  In the "
9164 "2.6 kernel, the bits above the eight lowermost bits are concatenated to the "
9165 "five lowermost bits to form the tape number.  The minor numbers can be "
9166 "grouped into two sets of four numbers: the principal (auto-rewind) minor "
9167 "device numbers, I<n>, and the \\(lqno-rewind\\(rq device numbers, (I<n> + "
9168 "128).  Devices opened using the principal device number will be sent a "
9169 "B<REWIND> command when they are closed.  Devices opened using the "
9170 "\\(lqno-rewind\\(rq device number will not.  (Note that using an auto-rewind "
9171 "device for positioning the tape with, for instance, mt does not lead to the "
9172 "desired result: the tape is rewound after the mt command and the next "
9173 "command starts from the beginning of the tape)."
9174 msgstr ""
9175
9176 #. type: Plain text
9177 #: build/C/man4/st.4:78
9178 msgid ""
9179 "Within each group, four minor numbers are available to define devices with "
9180 "different characteristics (block size, compression, density, etc.)  When the "
9181 "system starts up, only the first device is available.  The other three are "
9182 "activated when the default characteristics are defined (see below).  (By "
9183 "changing compile-time constants, it is possible to change the balance "
9184 "between the maximum number of tape drives and the number of minor numbers "
9185 "for each drive.  The default allocation allows control of 32 tape drives.  "
9186 "For instance, it is possible to control up to 64 tape drives with two minor "
9187 "numbers for different options.)"
9188 msgstr ""
9189
9190 #. type: Plain text
9191 #: build/C/man4/st.4:80
9192 msgid "Devices are typically created by:"
9193 msgstr ""
9194
9195 #. type: Plain text
9196 #: build/C/man4/st.4:91
9197 #, no-wrap
9198 msgid ""
9199 "mknod -m 666 /dev/st0 c 9 0\n"
9200 "mknod -m 666 /dev/st0l c 9 32\n"
9201 "mknod -m 666 /dev/st0m c 9 64\n"
9202 "mknod -m 666 /dev/st0a c 9 96\n"
9203 "mknod -m 666 /dev/nst0 c 9 128\n"
9204 "mknod -m 666 /dev/nst0l c 9 160\n"
9205 "mknod -m 666 /dev/nst0m c 9 192\n"
9206 "mknod -m 666 /dev/nst0a c 9 224\n"
9207 msgstr ""
9208
9209 #. type: Plain text
9210 #: build/C/man4/st.4:95
9211 msgid "There is no corresponding block device."
9212 msgstr ""
9213
9214 #. type: Plain text
9215 #: build/C/man4/st.4:110
9216 msgid ""
9217 "The driver uses an internal buffer that has to be large enough to hold at "
9218 "least one tape block.  In kernels before 2.1.121, the buffer is allocated as "
9219 "one contiguous block.  This limits the block size to the largest contiguous "
9220 "block of memory the kernel allocator can provide.  The limit is currently "
9221 "128 kB for 32-bit architectures and 256 kB for 64-bit architectures.  In "
9222 "newer kernels the driver allocates the buffer in several parts if "
9223 "necessary.  By default, the maximum number of parts is 16.  This means that "
9224 "the maximum block size is very large (2 MB if allocation of 16 blocks of 128 "
9225 "kB succeeds)."
9226 msgstr ""
9227
9228 #. type: Plain text
9229 #: build/C/man4/st.4:119
9230 msgid ""
9231 "The driver's internal buffer size is determined by a compile-time constant "
9232 "which can be overridden with a kernel startup option.  In addition to this, "
9233 "the driver tries to allocate a larger temporary buffer at run time if "
9234 "necessary.  However, run-time allocation of large contiguous blocks of "
9235 "memory may fail and it is advisable not to rely too much on dynamic buffer "
9236 "allocation with kernels older than 2.1.121 (this applies also to "
9237 "demand-loading the driver with kerneld or kmod)."
9238 msgstr ""
9239
9240 #. type: Plain text
9241 #: build/C/man4/st.4:132
9242 msgid ""
9243 "The driver does not specifically support any tape drive brand or model.  "
9244 "After system start-up the tape device options are defined by the drive "
9245 "firmware.  For example, if the drive firmware selects fixed-block mode, the "
9246 "tape device uses fixed-block mode.  The options can be changed with explicit "
9247 "B<ioctl>(2)  calls and remain in effect when the device is closed and "
9248 "reopened.  Setting the options affects both the auto-rewind and the "
9249 "nonrewind device."
9250 msgstr ""
9251
9252 #. type: Plain text
9253 #: build/C/man4/st.4:141
9254 msgid ""
9255 "Different options can be specified for the different devices within the "
9256 "subgroup of four.  The options take effect when the device is opened.  For "
9257 "example, the system administrator can define one device that writes in "
9258 "fixed-block mode with a certain block size, and one which writes in "
9259 "variable-block mode (if the drive supports both modes)."
9260 msgstr ""
9261
9262 #. type: Plain text
9263 #: build/C/man4/st.4:164
9264 msgid ""
9265 "The driver supports B<tape partitions> if they are supported by the drive.  "
9266 "(Note that the tape partitions have nothing to do with disk partitions.  A "
9267 "partitioned tape can be seen as several logical tapes within one medium.)  "
9268 "Partition support has to be enabled with an B<ioctl>(2).  The tape location "
9269 "is preserved within each partition across partition changes.  The partition "
9270 "used for subsequent tape operations is selected with an B<ioctl>(2).  The "
9271 "partition switch is executed together with the next tape operation in order "
9272 "to avoid unnecessary tape movement.  The maximum number of partitions on a "
9273 "tape is defined by a compile-time constant (originally four).  The driver "
9274 "contains an B<ioctl>(2)  that can format a tape with either one or two "
9275 "partitions."
9276 msgstr ""
9277
9278 #. type: Plain text
9279 #: build/C/man4/st.4:169
9280 msgid ""
9281 "Device I</dev/tape> is usually created as a hard or soft link to the default "
9282 "tape device on the system."
9283 msgstr ""
9284
9285 #. type: Plain text
9286 #: build/C/man4/st.4:173
9287 msgid ""
9288 "Starting from kernel 2.6.2, the driver exports in the sysfs directory "
9289 "I</sys/class/scsi_tape> the attached devices and some parameters assigned to "
9290 "the devices."
9291 msgstr ""
9292
9293 #. type: SS
9294 #: build/C/man4/st.4:173
9295 #, no-wrap
9296 msgid "Data Transfer"
9297 msgstr ""
9298
9299 #. type: Plain text
9300 #: build/C/man4/st.4:186
9301 msgid ""
9302 "The driver supports operation in both fixed-block mode and variable-block "
9303 "mode (if supported by the drive).  In fixed-block mode the drive writes "
9304 "blocks of the specified size and the block size is not dependent on the byte "
9305 "counts of the write system calls.  In variable-block mode one tape block is "
9306 "written for each write call and the byte count determines the size of the "
9307 "corresponding tape block.  Note that the blocks on the tape don't contain "
9308 "any information about the writing mode: when reading, the only important "
9309 "thing is to use commands that accept the block sizes on the tape."
9310 msgstr ""
9311
9312 #. type: Plain text
9313 #: build/C/man4/st.4:195
9314 msgid ""
9315 "In variable-block mode the read byte count does not have to match the tape "
9316 "block size exactly.  If the byte count is larger than the next block on "
9317 "tape, the driver returns the data and the function returns the actual block "
9318 "size.  If the block size is larger than the byte count, the requested amount "
9319 "of data from the start of the block is returned and the rest of the block is "
9320 "discarded."
9321 msgstr ""
9322
9323 #. type: Plain text
9324 #: build/C/man4/st.4:204
9325 msgid ""
9326 "In fixed-block mode the read byte counts can be arbitrary if buffering is "
9327 "enabled, or a multiple of the tape block size if buffering is disabled.  "
9328 "Kernels before 2.1.121 allow writes with arbitrary byte count if buffering "
9329 "is enabled.  In all other cases (kernel before 2.1.121 with buffering "
9330 "disabled or newer kernel) the write byte count must be a multiple of the "
9331 "tape block size."
9332 msgstr ""
9333
9334 #. type: Plain text
9335 #: build/C/man4/st.4:213
9336 msgid ""
9337 "In the 2.6 kernel, the driver tries to use direct transfers between the user "
9338 "buffer and the device.  If this is not possible, the driver's internal "
9339 "buffer is used.  The reasons for not using direct transfers include improper "
9340 "alignment of the user buffer (default is 512 bytes but this can be changed "
9341 "by the HBA driver), one of more pages of the user buffer not reachable by "
9342 "the SCSI adapter, etc."
9343 msgstr ""
9344
9345 #. type: Plain text
9346 #: build/C/man4/st.4:216
9347 msgid ""
9348 "A filemark is automatically written to tape if the last tape operation "
9349 "before close was a write."
9350 msgstr ""
9351
9352 #. type: Plain text
9353 #: build/C/man4/st.4:228
9354 msgid ""
9355 "When a filemark is encountered while reading, the following happens.  If "
9356 "there are data remaining in the buffer when the filemark is found, the "
9357 "buffered data is returned.  The next read returns zero bytes.  The following "
9358 "read returns data from the next file.  The end of recorded data is signaled "
9359 "by returning zero bytes for two consecutive read calls.  The third read "
9360 "returns an error."
9361 msgstr ""
9362
9363 #. type: SS
9364 #: build/C/man4/st.4:228
9365 #, no-wrap
9366 msgid "Ioctls"
9367 msgstr ""
9368
9369 #. type: Plain text
9370 #: build/C/man4/st.4:239
9371 msgid ""
9372 "The driver supports three B<ioctl>(2)  requests.  Requests not recognized by "
9373 "the B<st> driver are passed to the B<SCSI> driver.  The definitions below "
9374 "are from I</usr/include/linux/mtio.h>:"
9375 msgstr ""
9376
9377 #. type: SS
9378 #: build/C/man4/st.4:239
9379 #, no-wrap
9380 msgid "MTIOCTOP \\(em Perform a tape operation"
9381 msgstr ""
9382
9383 #. type: Plain text
9384 #: build/C/man4/st.4:247
9385 msgid ""
9386 "This request takes an argument of type I<(struct mtop *)>.  Not all drives "
9387 "support all operations.  The driver returns an B<EIO> error if the drive "
9388 "rejects an operation."
9389 msgstr ""
9390
9391 #. type: Plain text
9392 #: build/C/man4/st.4:255
9393 #, no-wrap
9394 msgid ""
9395 "/* Structure for MTIOCTOP - mag tape op command: */\n"
9396 "struct mtop {\n"
9397 "    short   mt_op;       /* operations defined below */\n"
9398 "    int     mt_count;    /* how many of them */\n"
9399 "};\n"
9400 msgstr ""
9401
9402 #. type: Plain text
9403 #: build/C/man4/st.4:259
9404 msgid "Magnetic Tape operations for normal tape use:"
9405 msgstr ""
9406
9407 #. type: TP
9408 #: build/C/man4/st.4:259
9409 #, no-wrap
9410 msgid "B<MTBSF>"
9411 msgstr ""
9412
9413 #. type: Plain text
9414 #: build/C/man4/st.4:264
9415 msgid "Backward space over I<mt_count> filemarks."
9416 msgstr ""
9417
9418 #. type: TP
9419 #: build/C/man4/st.4:264
9420 #, no-wrap
9421 msgid "B<MTBSFM>"
9422 msgstr ""
9423
9424 #. type: Plain text
9425 #: build/C/man4/st.4:270
9426 msgid ""
9427 "Backward space over I<mt_count> filemarks.  Reposition the tape to the EOT "
9428 "side of the last filemark."
9429 msgstr ""
9430
9431 #. type: TP
9432 #: build/C/man4/st.4:270
9433 #, no-wrap
9434 msgid "B<MTBSR>"
9435 msgstr ""
9436
9437 #. type: Plain text
9438 #: build/C/man4/st.4:275
9439 msgid "Backward space over I<mt_count> records (tape blocks)."
9440 msgstr ""
9441
9442 #. type: TP
9443 #: build/C/man4/st.4:275
9444 #, no-wrap
9445 msgid "B<MTBSS>"
9446 msgstr ""
9447
9448 #. type: Plain text
9449 #: build/C/man4/st.4:280
9450 msgid "Backward space over I<mt_count> setmarks."
9451 msgstr ""
9452
9453 #. type: TP
9454 #: build/C/man4/st.4:280
9455 #, no-wrap
9456 msgid "B<MTCOMPRESSION>"
9457 msgstr ""
9458
9459 #. type: Plain text
9460 #: build/C/man4/st.4:288
9461 msgid ""
9462 "Enable compression of tape data within the drive if I<mt_count> is nonzero "
9463 "and disable compression if I<mt_count> is zero.  This command uses the MODE "
9464 "page 15 supported by most DATs."
9465 msgstr ""
9466
9467 #. type: TP
9468 #: build/C/man4/st.4:288
9469 #, no-wrap
9470 msgid "B<MTEOM>"
9471 msgstr ""
9472
9473 #. type: Plain text
9474 #: build/C/man4/st.4:291
9475 msgid "Go to the end of the recorded media (for appending files)."
9476 msgstr ""
9477
9478 #. type: TP
9479 #: build/C/man4/st.4:291
9480 #, no-wrap
9481 msgid "B<MTERASE>"
9482 msgstr ""
9483
9484 #. type: Plain text
9485 #: build/C/man4/st.4:297
9486 msgid ""
9487 "Erase tape.  With 2.6 kernel, short erase (mark tape empty) is performed if "
9488 "the argument is zero.  Otherwise long erase (erase all) is done."
9489 msgstr ""
9490
9491 #. type: TP
9492 #: build/C/man4/st.4:297
9493 #, no-wrap
9494 msgid "B<MTFSF>"
9495 msgstr ""
9496
9497 #. type: Plain text
9498 #: build/C/man4/st.4:302
9499 msgid "Forward space over I<mt_count> filemarks."
9500 msgstr ""
9501
9502 #. type: TP
9503 #: build/C/man4/st.4:302
9504 #, no-wrap
9505 msgid "B<MTFSFM>"
9506 msgstr ""
9507
9508 #. type: Plain text
9509 #: build/C/man4/st.4:308
9510 msgid ""
9511 "Forward space over I<mt_count> filemarks.  Reposition the tape to the BOT "
9512 "side of the last filemark."
9513 msgstr ""
9514
9515 #. type: TP
9516 #: build/C/man4/st.4:308
9517 #, no-wrap
9518 msgid "B<MTFSR>"
9519 msgstr ""
9520
9521 #. type: Plain text
9522 #: build/C/man4/st.4:313
9523 msgid "Forward space over I<mt_count> records (tape blocks)."
9524 msgstr ""
9525
9526 #. type: TP
9527 #: build/C/man4/st.4:313
9528 #, no-wrap
9529 msgid "B<MTFSS>"
9530 msgstr ""
9531
9532 #. type: Plain text
9533 #: build/C/man4/st.4:318
9534 msgid "Forward space over I<mt_count> setmarks."
9535 msgstr ""
9536
9537 #. type: TP
9538 #: build/C/man4/st.4:318
9539 #, no-wrap
9540 msgid "B<MTLOAD>"
9541 msgstr ""
9542
9543 #. type: Plain text
9544 #: build/C/man4/st.4:329
9545 msgid ""
9546 "Execute the SCSI load command.  A special case is available for some HP "
9547 "autoloaders.  If I<mt_count> is the constant B<MT_ST_HPLOADER_OFFSET> plus a "
9548 "number, the number is sent to the drive to control the autoloader."
9549 msgstr ""
9550
9551 #. type: TP
9552 #: build/C/man4/st.4:329
9553 #, no-wrap
9554 msgid "B<MTLOCK>"
9555 msgstr ""
9556
9557 #. type: Plain text
9558 #: build/C/man4/st.4:332
9559 msgid "Lock the tape drive door."
9560 msgstr ""
9561
9562 #. type: TP
9563 #: build/C/man4/st.4:332
9564 #, no-wrap
9565 msgid "B<MTMKPART>"
9566 msgstr ""
9567
9568 #. type: Plain text
9569 #: build/C/man4/st.4:346
9570 msgid ""
9571 "Format the tape into one or two partitions.  If I<mt_count> is nonzero, it "
9572 "gives the size of the first partition and the second partition contains the "
9573 "rest of the tape.  If I<mt_count> is zero, the tape is formatted into one "
9574 "partition.  This command is not allowed for a drive unless the partition "
9575 "support is enabled for the drive (see B<MT_ST_CAN_PARTITIONS> below)."
9576 msgstr ""
9577
9578 #. type: TP
9579 #: build/C/man4/st.4:346
9580 #, no-wrap
9581 msgid "B<MTNOP>"
9582 msgstr ""
9583
9584 #. type: Plain text
9585 #: build/C/man4/st.4:351
9586 msgid ""
9587 "No op\\(emflushes the driver's buffer as a side effect.  Should be used "
9588 "before reading status with B<MTIOCGET>."
9589 msgstr ""
9590
9591 #. type: TP
9592 #: build/C/man4/st.4:351
9593 #, no-wrap
9594 msgid "B<MTOFFL>"
9595 msgstr ""
9596
9597 #. type: Plain text
9598 #: build/C/man4/st.4:354
9599 msgid "Rewind and put the drive off line."
9600 msgstr ""
9601
9602 #. type: TP
9603 #: build/C/man4/st.4:354
9604 #, no-wrap
9605 msgid "B<MTRESET>"
9606 msgstr ""
9607
9608 #. type: Plain text
9609 #: build/C/man4/st.4:357
9610 msgid "Reset drive."
9611 msgstr ""
9612
9613 #. type: TP
9614 #: build/C/man4/st.4:357
9615 #, no-wrap
9616 msgid "B<MTRETEN>"
9617 msgstr ""
9618
9619 #. type: Plain text
9620 #: build/C/man4/st.4:360
9621 msgid "Re-tension tape."
9622 msgstr ""
9623
9624 #. type: TP
9625 #: build/C/man4/st.4:360
9626 #, no-wrap
9627 msgid "B<MTREW>"
9628 msgstr ""
9629
9630 #. type: Plain text
9631 #: build/C/man4/st.4:363
9632 msgid "Rewind."
9633 msgstr ""
9634
9635 #. type: TP
9636 #: build/C/man4/st.4:363
9637 #, no-wrap
9638 msgid "B<MTSEEK>"
9639 msgstr ""
9640
9641 #. type: Plain text
9642 #: build/C/man4/st.4:375
9643 msgid ""
9644 "Seek to the tape block number specified in I<mt_count>.  This operation "
9645 "requires either a SCSI-2 drive that supports the B<LOCATE> command "
9646 "(device-specific address)  or a Tandberg-compatible SCSI-1 drive (Tandberg, "
9647 "Archive Viper, Wangtek, ...).  The block number should be one that was "
9648 "previously returned by B<MTIOCPOS> if device-specific addresses are used."
9649 msgstr ""
9650
9651 #. type: TP
9652 #: build/C/man4/st.4:375
9653 #, no-wrap
9654 msgid "B<MTSETBLK>"
9655 msgstr ""
9656
9657 #. type: Plain text
9658 #: build/C/man4/st.4:380
9659 msgid ""
9660 "Set the drive's block length to the value specified in I<mt_count>.  A block "
9661 "length of zero sets the drive to variable block size mode."
9662 msgstr ""
9663
9664 #. type: TP
9665 #: build/C/man4/st.4:380
9666 #, no-wrap
9667 msgid "B<MTSETDENSITY>"
9668 msgstr ""
9669
9670 #. type: Plain text
9671 #: build/C/man4/st.4:386
9672 msgid ""
9673 "Set the tape density to the code in I<mt_count>.  The density codes "
9674 "supported by a drive can be found from the drive documentation."
9675 msgstr ""
9676
9677 #. type: TP
9678 #: build/C/man4/st.4:386
9679 #, no-wrap
9680 msgid "B<MTSETPART>"
9681 msgstr ""
9682
9683 #. type: Plain text
9684 #: build/C/man4/st.4:395
9685 msgid ""
9686 "The active partition is switched to I<mt_count>.  The partitions are "
9687 "numbered from zero.  This command is not allowed for a drive unless the "
9688 "partition support is enabled for the drive (see B<MT_ST_CAN_PARTITIONS> "
9689 "below)."
9690 msgstr ""
9691
9692 #. type: TP
9693 #: build/C/man4/st.4:395
9694 #, no-wrap
9695 msgid "B<MTUNLOAD>"
9696 msgstr ""
9697
9698 #. type: Plain text
9699 #: build/C/man4/st.4:398
9700 msgid "Execute the SCSI unload command (does not eject the tape)."
9701 msgstr ""
9702
9703 #. type: TP
9704 #: build/C/man4/st.4:398
9705 #, no-wrap
9706 msgid "B<MTUNLOCK>"
9707 msgstr ""
9708
9709 #. type: Plain text
9710 #: build/C/man4/st.4:401
9711 msgid "Unlock the tape drive door."
9712 msgstr ""
9713
9714 #. type: TP
9715 #: build/C/man4/st.4:401
9716 #, no-wrap
9717 msgid "B<MTWEOF>"
9718 msgstr ""
9719
9720 #. type: Plain text
9721 #: build/C/man4/st.4:406
9722 msgid "Write I<mt_count> filemarks."
9723 msgstr ""
9724
9725 #. type: TP
9726 #: build/C/man4/st.4:406
9727 #, no-wrap
9728 msgid "B<MTWSM>"
9729 msgstr ""
9730
9731 #. type: Plain text
9732 #: build/C/man4/st.4:411
9733 msgid "Write I<mt_count> setmarks."
9734 msgstr ""
9735
9736 #. type: Plain text
9737 #: build/C/man4/st.4:413
9738 msgid "Magnetic Tape operations for setting of device options (by the superuser):"
9739 msgstr ""
9740
9741 #. type: TP
9742 #: build/C/man4/st.4:413
9743 #, no-wrap
9744 msgid "B<MTSETDRVBUFFER>"
9745 msgstr ""
9746
9747 #. type: Plain text
9748 #: build/C/man4/st.4:422
9749 msgid ""
9750 "Set various drive and driver options according to bits encoded in "
9751 "I<mt_count>.  These consist of the drive's buffering mode, a set of Boolean "
9752 "driver options, the buffer write threshold, defaults for the block size and "
9753 "density, and timeouts (only in kernels 2.1 and later).  A single operation "
9754 "can affect only one item in the list above (the Booleans counted as one "
9755 "item.)"
9756 msgstr ""
9757
9758 #. type: Plain text
9759 #: build/C/man4/st.4:426
9760 msgid ""
9761 "A value having zeros in the high-order 4 bits will be used to set the "
9762 "drive's buffering mode.  The buffering modes are:"
9763 msgstr ""
9764
9765 #. type: IP
9766 #: build/C/man4/st.4:427
9767 #, no-wrap
9768 msgid "0"
9769 msgstr ""
9770
9771 #. type: Plain text
9772 #: build/C/man4/st.4:432
9773 msgid ""
9774 "The drive will not report B<GOOD> status on write commands until the data "
9775 "blocks are actually written to the medium."
9776 msgstr ""
9777
9778 #. type: IP
9779 #: build/C/man4/st.4:432
9780 #, no-wrap
9781 msgid "1"
9782 msgstr ""
9783
9784 #. type: Plain text
9785 #: build/C/man4/st.4:437
9786 msgid ""
9787 "The drive may report B<GOOD> status on write commands as soon as all the "
9788 "data has been transferred to the drive's internal buffer."
9789 msgstr ""
9790
9791 #. type: IP
9792 #: build/C/man4/st.4:437
9793 #, no-wrap
9794 msgid "2"
9795 msgstr ""
9796
9797 #. type: Plain text
9798 #: build/C/man4/st.4:444
9799 msgid ""
9800 "The drive may report B<GOOD> status on write commands as soon as (a) all the "
9801 "data has been transferred to the drive's internal buffer, and (b) all "
9802 "buffered data from different initiators has been successfully written to the "
9803 "medium."
9804 msgstr ""
9805
9806 #. type: Plain text
9807 #: build/C/man4/st.4:455
9808 msgid ""
9809 "To control the write threshold the value in I<mt_count> must include the "
9810 "constant B<MT_ST_WRITE_THRESHOLD> bitwise ORed with a block count in the low "
9811 "28 bits.  The block count refers to 1024-byte blocks, not the physical block "
9812 "size on the tape.  The threshold cannot exceed the driver's internal buffer "
9813 "size (see DESCRIPTION, above)."
9814 msgstr ""
9815
9816 #. type: Plain text
9817 #: build/C/man4/st.4:476
9818 msgid ""
9819 "To set and clear the Boolean options the value in I<mt_count> must include "
9820 "one of the constants B<MT_ST_BOOLEANS>, B<MT_ST_SETBOOLEANS>, "
9821 "B<MT_ST_CLEARBOOLEANS>, or B<MT_ST_DEFBOOLEANS> bitwise ORed with whatever "
9822 "combination of the following options is desired.  Using B<MT_ST_BOOLEANS> "
9823 "the options can be set to the values defined in the corresponding bits.  "
9824 "With B<MT_ST_SETBOOLEANS> the options can be selectively set and with "
9825 "B<MT_ST_DEFBOOLEANS> selectively cleared."
9826 msgstr ""
9827
9828 #. type: Plain text
9829 #: build/C/man4/st.4:484
9830 msgid ""
9831 "The default options for a tape device are set with B<MT_ST_DEFBOOLEANS>.  A "
9832 "nonactive tape device (e.g., device with minor 32 or 160) is activated when "
9833 "the default options for it are defined the first time.  An activated device "
9834 "inherits from the device activated at start-up the options not set "
9835 "explicitly."
9836 msgstr ""
9837
9838 #. type: Plain text
9839 #: build/C/man4/st.4:486
9840 msgid "The Boolean options are:"
9841 msgstr ""
9842
9843 #. type: TP
9844 #: build/C/man4/st.4:487
9845 #, no-wrap
9846 msgid "B<MT_ST_BUFFER_WRITES> (Default: true)"
9847 msgstr ""
9848
9849 #. type: Plain text
9850 #: build/C/man4/st.4:493
9851 msgid ""
9852 "Buffer all write operations in fixed-block mode.  If this option is false "
9853 "and the drive uses a fixed block size, then all write operations must be for "
9854 "a multiple of the block size.  This option must be set false to write "
9855 "reliable multivolume archives."
9856 msgstr ""
9857
9858 #. type: TP
9859 #: build/C/man4/st.4:494
9860 #, no-wrap
9861 msgid "B<MT_ST_ASYNC_WRITES> (Default: true)"
9862 msgstr ""
9863
9864 #. type: Plain text
9865 #: build/C/man4/st.4:504
9866 msgid ""
9867 "When this option is true, write operations return immediately without "
9868 "waiting for the data to be transferred to the drive if the data fits into "
9869 "the driver's buffer.  The write threshold determines how full the buffer "
9870 "must be before a new SCSI write command is issued.  Any errors reported by "
9871 "the drive will be held until the next operation.  This option must be set "
9872 "false to write reliable multivolume archives."
9873 msgstr ""
9874
9875 #. type: TP
9876 #: build/C/man4/st.4:504
9877 #, no-wrap
9878 msgid "B<MT_ST_READ_AHEAD> (Default: true)"
9879 msgstr ""
9880
9881 #. type: Plain text
9882 #: build/C/man4/st.4:510
9883 msgid ""
9884 "This option causes the driver to provide read buffering and read-ahead in "
9885 "fixed-block mode.  If this option is false and the drive uses a fixed block "
9886 "size, then all read operations must be for a multiple of the block size."
9887 msgstr ""
9888
9889 #. type: TP
9890 #: build/C/man4/st.4:510
9891 #, no-wrap
9892 msgid "B<MT_ST_TWO_FM> (Default: false)"
9893 msgstr ""
9894
9895 #. type: Plain text
9896 #: build/C/man4/st.4:516
9897 msgid ""
9898 "This option modifies the driver behavior when a file is closed.  The normal "
9899 "action is to write a single filemark.  If the option is true the driver will "
9900 "write two filemarks and backspace over the second one."
9901 msgstr ""
9902
9903 #. type: Plain text
9904 #: build/C/man4/st.4:525
9905 msgid ""
9906 "Note: This option should not be set true for QIC tape drives since they are "
9907 "unable to overwrite a filemark.  These drives detect the end of recorded "
9908 "data by testing for blank tape rather than two consecutive filemarks.  Most "
9909 "other current drives also detect the end of recorded data and using two "
9910 "filemarks is usually necessary only when interchanging tapes with some other "
9911 "systems."
9912 msgstr ""
9913
9914 #. type: TP
9915 #: build/C/man4/st.4:525
9916 #, no-wrap
9917 msgid "B<MT_ST_DEBUGGING> (Default: false)"
9918 msgstr ""
9919
9920 #. type: Plain text
9921 #: build/C/man4/st.4:531
9922 msgid ""
9923 "This option turns on various debugging messages from the driver (effective "
9924 "only if the driver was compiled with B<DEBUG> defined nonzero)."
9925 msgstr ""
9926
9927 #. type: TP
9928 #: build/C/man4/st.4:531
9929 #, no-wrap
9930 msgid "B<MT_ST_FAST_EOM> (Default: false)"
9931 msgstr ""
9932
9933 #. type: Plain text
9934 #: build/C/man4/st.4:545
9935 msgid ""
9936 "This option causes the B<MTEOM> operation to be sent directly to the drive, "
9937 "potentially speeding up the operation but causing the driver to lose track "
9938 "of the current file number normally returned by the B<MTIOCGET> request.  If "
9939 "B<MT_ST_FAST_EOM> is false the driver will respond to an B<MTEOM> request by "
9940 "forward spacing over files."
9941 msgstr ""
9942
9943 #. type: TP
9944 #: build/C/man4/st.4:545
9945 #, no-wrap
9946 msgid "B<MT_ST_AUTO_LOCK> (Default: false)"
9947 msgstr ""
9948
9949 #. type: Plain text
9950 #: build/C/man4/st.4:549
9951 msgid ""
9952 "When this option is true, the drive door is locked when the device is opened "
9953 "and unlocked when it is closed."
9954 msgstr ""
9955
9956 #. type: TP
9957 #: build/C/man4/st.4:549
9958 #, no-wrap
9959 msgid "B<MT_ST_DEF_WRITES> (Default: false)"
9960 msgstr ""
9961
9962 #. type: Plain text
9963 #: build/C/man4/st.4:566
9964 msgid ""
9965 "The tape options (block size, mode, compression, etc.) may change when "
9966 "changing from one device linked to a drive to another device linked to the "
9967 "same drive depending on how the devices are defined.  This option defines "
9968 "when the changes are enforced by the driver using SCSI-commands and when the "
9969 "drives auto-detection capabilities are relied upon.  If this option is "
9970 "false, the driver sends the SCSI-commands immediately when the device is "
9971 "changed.  If the option is true, the SCSI-commands are not sent until a "
9972 "write is requested.  In this case the drive firmware is allowed to detect "
9973 "the tape structure when reading and the SCSI-commands are used only to make "
9974 "sure that a tape is written according to the correct specification."
9975 msgstr ""
9976
9977 #. type: TP
9978 #: build/C/man4/st.4:566
9979 #, no-wrap
9980 msgid "B<MT_ST_CAN_BSR> (Default: false)"
9981 msgstr ""
9982
9983 #. type: Plain text
9984 #: build/C/man4/st.4:579
9985 msgid ""
9986 "When read-ahead is used, the tape must sometimes be spaced backward to the "
9987 "correct position when the device is closed and the SCSI command to space "
9988 "backward over records is used for this purpose.  Some older drives can't "
9989 "process this command reliably and this option can be used to instruct the "
9990 "driver not to use the command.  The end result is that, with read-ahead and "
9991 "fixed-block mode, the tape may not be correctly positioned within a file "
9992 "when the device is closed.  With 2.6 kernel, the default is true for drives "
9993 "supporting SCSI-3."
9994 msgstr ""
9995
9996 #. type: TP
9997 #: build/C/man4/st.4:579
9998 #, no-wrap
9999 msgid "B<MT_ST_NO_BLKLIMS> (Default: false)"
10000 msgstr ""
10001
10002 #. type: Plain text
10003 #: build/C/man4/st.4:588
10004 msgid ""
10005 "Some drives don't accept the B<READ BLOCK LIMITS> SCSI command.  If this is "
10006 "used, the driver does not use the command.  The drawback is that the driver "
10007 "can't check before sending commands if the selected block size is acceptable "
10008 "to the drive."
10009 msgstr ""
10010
10011 #. type: TP
10012 #: build/C/man4/st.4:588
10013 #, no-wrap
10014 msgid "B<MT_ST_CAN_PARTITIONS> (Default: false)"
10015 msgstr ""
10016
10017 #. type: Plain text
10018 #: build/C/man4/st.4:593
10019 msgid ""
10020 "This option enables support for several partitions within a tape.  The "
10021 "option applies to all devices linked to a drive."
10022 msgstr ""
10023
10024 #. type: TP
10025 #: build/C/man4/st.4:593
10026 #, no-wrap
10027 msgid "B<MT_ST_SCSI2LOGICAL> (Default: false)"
10028 msgstr ""
10029
10030 #. type: Plain text
10031 #: build/C/man4/st.4:608
10032 msgid ""
10033 "This option instructs the driver to use the logical block addresses defined "
10034 "in the SCSI-2 standard when performing the seek and tell operations (both "
10035 "with B<MTSEEK> and B<MTIOCPOS> commands and when changing tape partition).  "
10036 "Otherwise the device-specific addresses are used.  It is highly advisable to "
10037 "set this option if the drive supports the logical addresses because they "
10038 "count also filemarks.  There are some drives that only support the logical "
10039 "block addresses."
10040 msgstr ""
10041
10042 #. type: TP
10043 #: build/C/man4/st.4:608
10044 #, no-wrap
10045 msgid "B<MT_ST_SYSV> (Default: false)"
10046 msgstr ""
10047
10048 #. type: Plain text
10049 #: build/C/man4/st.4:619
10050 msgid ""
10051 "When this option is enabled, the tape devices use the SystemV semantics.  "
10052 "Otherwise the BSD semantics are used.  The most important difference between "
10053 "the semantics is what happens when a device used for reading is closed: in "
10054 "System V semantics the tape is spaced forward past the next filemark if this "
10055 "has not happened while using the device.  In BSD semantics the tape position "
10056 "is not changed."
10057 msgstr ""
10058
10059 #. type: TP
10060 #: build/C/man4/st.4:619
10061 #, no-wrap
10062 msgid "B<MT_NO_WAIT> (Default: false)"
10063 msgstr ""
10064
10065 #. type: Plain text
10066 #: build/C/man4/st.4:623
10067 msgid ""
10068 "Enables immediate mode (i.e., don't wait for the command to finish) for some "
10069 "commands (e.g., rewind)."
10070 msgstr ""
10071
10072 #. type: Plain text
10073 #: build/C/man4/st.4:625
10074 msgid "An example:"
10075 msgstr ""
10076
10077 #. type: Plain text
10078 #: build/C/man4/st.4:633
10079 #, no-wrap
10080 msgid ""
10081 "struct mtop mt_cmd;\n"
10082 "mt_cmd.mt_op = MTSETDRVBUFFER;\n"
10083 "mt_cmd.mt_count = MT_ST_BOOLEANS |\n"
10084 "        MT_ST_BUFFER_WRITES | MT_ST_ASYNC_WRITES;\n"
10085 "ioctl(fd, MTIOCTOP, mt_cmd);\n"
10086 msgstr ""
10087
10088 #. type: Plain text
10089 #: build/C/man4/st.4:643
10090 msgid ""
10091 "The default block size for a device can be set with B<MT_ST_DEF_BLKSIZE> and "
10092 "the default density code can be set with B<MT_ST_DEFDENSITY>.  The values "
10093 "for the parameters are or'ed with the operation code."
10094 msgstr ""
10095
10096 #. type: Plain text
10097 #: build/C/man4/st.4:660
10098 msgid ""
10099 "With kernels 2.1.x and later, the timeout values can be set with the "
10100 "subcommand B<MT_ST_SET_TIMEOUT> ORed with the timeout in seconds.  The long "
10101 "timeout (used for rewinds and other commands that may take a long time) can "
10102 "be set with B<MT_ST_SET_LONG_TIMEOUT>.  The kernel defaults are very long to "
10103 "make sure that a successful command is not timed out with any drive.  "
10104 "Because of this the driver may seem stuck even if it is only waiting for the "
10105 "timeout.  These commands can be used to set more practical values for a "
10106 "specific drive.  The timeouts set for one device apply for all devices "
10107 "linked to the same drive."
10108 msgstr ""
10109
10110 #. type: Plain text
10111 #: build/C/man4/st.4:681
10112 msgid ""
10113 "Starting from kernels 2.4.19 and 2.5.43, the driver supports a status bit "
10114 "which indicates whether the drive requests cleaning.  The method used by the "
10115 "drive to return cleaning information is set using the B<MT_ST_SEL_CLN> "
10116 "subcommand.  If the value is zero, the cleaning bit is always zero.  If the "
10117 "value is one, the TapeAlert data defined in the SCSI-3 standard is used (not "
10118 "yet implemented).  Values 2-17 are reserved.  If the lowest eight bits are "
10119 "E<gt>= 18, bits from the extended sense data are used.  The bits 9-16 "
10120 "specify a mask to select the bits to look at and the bits 17-23 specify the "
10121 "bit pattern to look for.  If the bit pattern is zero, one or more bits under "
10122 "the mask indicate the cleaning request.  If the pattern is nonzero, the "
10123 "pattern must match the masked sense data byte."
10124 msgstr ""
10125
10126 #. type: SS
10127 #: build/C/man4/st.4:681
10128 #, no-wrap
10129 msgid "MTIOCGET \\(em Get status"
10130 msgstr ""
10131
10132 #. type: Plain text
10133 #: build/C/man4/st.4:685
10134 msgid "This request takes an argument of type I<(struct mtget *)>."
10135 msgstr ""
10136
10137 #. type: Plain text
10138 #: build/C/man4/st.4:700
10139 #, no-wrap
10140 msgid ""
10141 "/* structure for MTIOCGET - mag tape get status command */\n"
10142 "struct mtget {\n"
10143 "    long     mt_type;\n"
10144 "    long     mt_resid;\n"
10145 "    /* the following registers are device dependent */\n"
10146 "    long     mt_dsreg;\n"
10147 "    long     mt_gstat;\n"
10148 "    long     mt_erreg;\n"
10149 "    /* The next two fields are not always used */\n"
10150 "    daddr_t  mt_fileno;\n"
10151 "    daddr_t  mt_blkno;\n"
10152 "};\n"
10153 msgstr ""
10154
10155 #. type: IP
10156 #: build/C/man4/st.4:702
10157 #, no-wrap
10158 msgid "I<mt_type>"
10159 msgstr ""
10160
10161 #. type: Plain text
10162 #: build/C/man4/st.4:711
10163 msgid ""
10164 "The header file defines many values for I<mt_type>, but the current driver "
10165 "reports only the generic types B<MT_ISSCSI1> (Generic SCSI-1 tape)  and "
10166 "B<MT_ISSCSI2> (Generic SCSI-2 tape)."
10167 msgstr ""
10168
10169 #. type: IP
10170 #: build/C/man4/st.4:711
10171 #, no-wrap
10172 msgid "I<mt_resid>"
10173 msgstr ""
10174
10175 #. type: Plain text
10176 #: build/C/man4/st.4:713
10177 msgid "contains the current tape partition number."
10178 msgstr ""
10179
10180 #. type: IP
10181 #: build/C/man4/st.4:713
10182 #, no-wrap
10183 msgid "I<mt_dsreg>"
10184 msgstr ""
10185
10186 #. type: Plain text
10187 #: build/C/man4/st.4:722
10188 msgid ""
10189 "reports the drive's current settings for block size (in the low 24 bits) and "
10190 "density (in the high 8 bits).  These fields are defined by "
10191 "B<MT_ST_BLKSIZE_SHIFT>, B<MT_ST_BLKSIZE_MASK>, B<MT_ST_DENSITY_SHIFT>, and "
10192 "B<MT_ST_DENSITY_MASK>."
10193 msgstr ""
10194
10195 #. type: IP
10196 #: build/C/man4/st.4:722
10197 #, no-wrap
10198 msgid "I<mt_gstat>"
10199 msgstr ""
10200
10201 #. type: Plain text
10202 #: build/C/man4/st.4:725
10203 msgid ""
10204 "reports generic (device independent) status information.  The header file "
10205 "defines macros for testing these status bits:"
10206 msgstr ""
10207
10208 #. type: Plain text
10209 #: build/C/man4/st.4:732
10210 msgid ""
10211 "B<GMT_EOF>(I<x>): The tape is positioned just after a filemark (always false "
10212 "after an B<MTSEEK> operation)."
10213 msgstr ""
10214
10215 #. type: Plain text
10216 #: build/C/man4/st.4:738
10217 msgid ""
10218 "B<GMT_BOT>(I<x>): The tape is positioned at the beginning of the first file "
10219 "(always false after an B<MTSEEK> operation)."
10220 msgstr ""
10221
10222 #. type: Plain text
10223 #: build/C/man4/st.4:741
10224 msgid "B<GMT_EOT>(I<x>): A tape operation has reached the physical End Of Tape."
10225 msgstr ""
10226
10227 #. type: Plain text
10228 #: build/C/man4/st.4:747
10229 msgid ""
10230 "B<GMT_SM>(I<x>): The tape is currently positioned at a setmark (always false "
10231 "after an B<MTSEEK> operation)."
10232 msgstr ""
10233
10234 #. type: Plain text
10235 #: build/C/man4/st.4:750
10236 msgid "B<GMT_EOD>(I<x>): The tape is positioned at the end of recorded data."
10237 msgstr ""
10238
10239 #. type: Plain text
10240 #: build/C/man4/st.4:755
10241 msgid ""
10242 "B<GMT_WR_PROT>(I<x>): The drive is write-protected.  For some drives this "
10243 "can also mean that the drive does not support writing on the current medium "
10244 "type."
10245 msgstr ""
10246
10247 #. type: Plain text
10248 #: build/C/man4/st.4:760
10249 msgid ""
10250 "B<GMT_ONLINE>(I<x>): The last B<open>(2)  found the drive with a tape in "
10251 "place and ready for operation."
10252 msgstr ""
10253
10254 #. type: Plain text
10255 #: build/C/man4/st.4:764
10256 msgid ""
10257 "B<GMT_D_6250>(I<x>), B<GMT_D_1600>(I<x>), B<GMT_D_800>(I<x>): This "
10258 "\\(lqgeneric\\(rq status information reports the current density setting for "
10259 "9-track \\(12\" tape drives only."
10260 msgstr ""
10261
10262 #. type: Plain text
10263 #: build/C/man4/st.4:767
10264 msgid "B<GMT_DR_OPEN>(I<x>): The drive does not have a tape in place."
10265 msgstr ""
10266
10267 #. type: Plain text
10268 #: build/C/man4/st.4:775
10269 msgid ""
10270 "B<GMT_IM_REP_EN>(I<x>): Immediate report mode.  This bit is set if there are "
10271 "no guarantees that the data has been physically written to the tape when the "
10272 "write call returns.  It is set zero only when the driver does not buffer "
10273 "data and the drive is set not to buffer data."
10274 msgstr ""
10275
10276 #. type: Plain text
10277 #: build/C/man4/st.4:779
10278 msgid ""
10279 "B<GMT_CLN>(I<x>): The drive has requested cleaning.  Implemented in kernels "
10280 "since 2.4.19 and 2.5.43."
10281 msgstr ""
10282
10283 #. type: IP
10284 #: build/C/man4/st.4:780
10285 #, no-wrap
10286 msgid "I<mt_erreg>"
10287 msgstr ""
10288
10289 #. type: Plain text
10290 #: build/C/man4/st.4:790
10291 msgid ""
10292 "The only field defined in I<mt_erreg> is the recovered error count in the "
10293 "low 16 bits (as defined by B<MT_ST_SOFTERR_SHIFT> and "
10294 "B<MT_ST_SOFTERR_MASK>.  Due to inconsistencies in the way drives report "
10295 "recovered errors, this count is often not maintained (most drives do not by "
10296 "default report soft errors but this can be changed with a SCSI MODE SELECT "
10297 "command)."
10298 msgstr ""
10299
10300 #. type: IP
10301 #: build/C/man4/st.4:790
10302 #, no-wrap
10303 msgid "I<mt_fileno>"
10304 msgstr ""
10305
10306 #. type: Plain text
10307 #: build/C/man4/st.4:796
10308 msgid ""
10309 "reports the current file number (zero-based).  This value is set to -1 when "
10310 "the file number is unknown (e.g., after B<MTBSS> or B<MTSEEK>)."
10311 msgstr ""
10312
10313 #. type: IP
10314 #: build/C/man4/st.4:796
10315 #, no-wrap
10316 msgid "I<mt_blkno>"
10317 msgstr ""
10318
10319 #. type: Plain text
10320 #: build/C/man4/st.4:803
10321 msgid ""
10322 "reports the block number (zero-based) within the current file.  This value "
10323 "is set to -1 when the block number is unknown (e.g., after B<MTBSF>, "
10324 "B<MTBSS>, or B<MTSEEK>)."
10325 msgstr ""
10326
10327 #. type: SS
10328 #: build/C/man4/st.4:803
10329 #, no-wrap
10330 msgid "MTIOCPOS \\(em Get tape position"
10331 msgstr ""
10332
10333 #. type: Plain text
10334 #: build/C/man4/st.4:817
10335 msgid ""
10336 "This request takes an argument of type I<(struct mtpos *)> and reports the "
10337 "drive's notion of the current tape block number, which is not the same as "
10338 "I<mt_blkno> returned by B<MTIOCGET>.  This drive must be a SCSI-2 drive that "
10339 "supports the B<READ POSITION> command (device-specific address)  or a "
10340 "Tandberg-compatible SCSI-1 drive (Tandberg, Archive Viper, Wangtek, ... )."
10341 msgstr ""
10342
10343 #. type: Plain text
10344 #: build/C/man4/st.4:824
10345 #, no-wrap
10346 msgid ""
10347 "/* structure for MTIOCPOS - mag tape get position command */\n"
10348 "struct mtpos {\n"
10349 "    long mt_blkno;    /* current block number */\n"
10350 "};\n"
10351 msgstr ""
10352
10353 #. type: Plain text
10354 #: build/C/man4/st.4:833
10355 msgid ""
10356 "An attempt was made to write or erase a write-protected tape.  (This error "
10357 "is not detected during B<open>(2).)"
10358 msgstr ""
10359
10360 #. type: TP
10361 #: build/C/man4/st.4:833
10362 #, no-wrap
10363 msgid "B<EBUSY>"
10364 msgstr ""
10365
10366 #. type: Plain text
10367 #: build/C/man4/st.4:837
10368 msgid "The device is already in use or the driver was unable to allocate a buffer."
10369 msgstr ""
10370
10371 #. type: Plain text
10372 #: build/C/man4/st.4:841
10373 msgid "The command parameters point to memory not belonging to the calling process."
10374 msgstr ""
10375
10376 #. type: Plain text
10377 #: build/C/man4/st.4:846
10378 msgid ""
10379 "An B<ioctl>(2)  had an invalid argument, or a requested block size was "
10380 "invalid."
10381 msgstr ""
10382
10383 #. type: TP
10384 #: build/C/man4/st.4:846
10385 #, no-wrap
10386 msgid "B<EIO>"
10387 msgstr ""
10388
10389 #. type: Plain text
10390 #: build/C/man4/st.4:849
10391 msgid "The requested operation could not be completed."
10392 msgstr ""
10393
10394 #. type: Plain text
10395 #: build/C/man4/st.4:856
10396 msgid ""
10397 "The byte count in B<read>(2)  is smaller than the next physical block on the "
10398 "tape.  (Before 2.2.18 and 2.4.0-test6 the extra bytes have been silently "
10399 "ignored.)"
10400 msgstr ""
10401
10402 #. type: Plain text
10403 #: build/C/man4/st.4:860
10404 msgid ""
10405 "A write operation could not be completed because the tape reached "
10406 "end-of-medium."
10407 msgstr ""
10408
10409 #. type: TP
10410 #: build/C/man4/st.4:860 build/C/man2/syslog.2:237
10411 #, no-wrap
10412 msgid "B<ENOSYS>"
10413 msgstr ""
10414
10415 #. type: Plain text
10416 #: build/C/man4/st.4:864
10417 msgid "Unknown B<ioctl>(2)."
10418 msgstr ""
10419
10420 #. type: TP
10421 #: build/C/man4/st.4:864
10422 #, no-wrap
10423 msgid "B<ENXIO>"
10424 msgstr ""
10425
10426 #. type: Plain text
10427 #: build/C/man4/st.4:867
10428 msgid "During opening, the tape device does not exist."
10429 msgstr ""
10430
10431 #. type: TP
10432 #: build/C/man4/st.4:867
10433 #, no-wrap
10434 msgid "B<EOVERFLOW>"
10435 msgstr ""
10436
10437 #. type: Plain text
10438 #: build/C/man4/st.4:871
10439 msgid ""
10440 "An attempt was made to read or write a variable-length block that is larger "
10441 "than the driver's internal buffer."
10442 msgstr ""
10443
10444 #. type: Plain text
10445 #: build/C/man4/st.4:878
10446 msgid ""
10447 "Open is attempted with B<O_WRONLY> or B<O_RDWR> when the tape in the drive "
10448 "is write-protected."
10449 msgstr ""
10450
10451 #. type: TP
10452 #: build/C/man4/st.4:879
10453 #, no-wrap
10454 msgid "I</dev/st*>"
10455 msgstr ""
10456
10457 #. type: Plain text
10458 #: build/C/man4/st.4:882
10459 msgid "the auto-rewind SCSI tape devices"
10460 msgstr ""
10461
10462 #. type: TP
10463 #: build/C/man4/st.4:882
10464 #, no-wrap
10465 msgid "I</dev/nst*>"
10466 msgstr ""
10467
10468 #.  .SH AUTHOR
10469 #.  The driver has been written by Kai M\(:akisara (Kai.Makisara@metla.fi)
10470 #.  starting from a driver written by Dwayne Forsyth.
10471 #.  Several other
10472 #.  people have also contributed to the driver.
10473 #. type: Plain text
10474 #: build/C/man4/st.4:890
10475 msgid "the nonrewind SCSI tape devices"
10476 msgstr ""
10477
10478 #. type: Plain text
10479 #: build/C/man4/st.4:911
10480 msgid ""
10481 "When exchanging data between systems, both systems have to agree on the "
10482 "physical tape block size.  The parameters of a drive after startup are often "
10483 "not the ones most operating systems use with these devices.  Most systems "
10484 "use drives in variable-block mode if the drive supports that mode.  This "
10485 "applies to most modern drives, including DATs, 8mm helical scan drives, "
10486 "DLTs, etc.  It may be advisable to use these drives in variable-block mode "
10487 "also in Linux (i.e., use B<MTSETBLK> or B<MTSETDEFBLK> at system startup to "
10488 "set the mode), at least when exchanging data with a foreign system.  The "
10489 "drawback of this is that a fairly large tape block size has to be used to "
10490 "get acceptable data transfer rates on the SCSI bus."
10491 msgstr ""
10492
10493 #. type: Plain text
10494 #: build/C/man4/st.4:918
10495 msgid ""
10496 "Many programs (e.g., B<tar>(1))  allow the user to specify the blocking "
10497 "factor on the command line.  Note that this determines the physical block "
10498 "size on tape only in variable-block mode."
10499 msgstr ""
10500
10501 #. type: Plain text
10502 #: build/C/man4/st.4:925
10503 msgid ""
10504 "In order to use SCSI tape drives, the basic SCSI driver, a SCSI-adapter "
10505 "driver and the SCSI tape driver must be either configured into the kernel or "
10506 "loaded as modules.  If the SCSI-tape driver is not present, the drive is "
10507 "recognized but the tape support described in this page is not available."
10508 msgstr ""
10509
10510 #. type: Plain text
10511 #: build/C/man4/st.4:930
10512 msgid ""
10513 "The driver writes error messages to the console/log.  The SENSE codes "
10514 "written into some messages are automatically translated to text if verbose "
10515 "SCSI messages are enabled in kernel configuration."
10516 msgstr ""
10517
10518 #.  .SH COPYRIGHT
10519 #.  Copyright \(co 1995 Robert K. Nichols.
10520 #.  .br
10521 #.  Copyright \(co 1999-2005 Kai M\(:akisara.
10522 #.  .PP
10523 #.  Permission is granted to make and distribute verbatim copies of this
10524 #.  manual provided the copyright notice and this permission notice are
10525 #.  preserved on all copies.
10526 #.  Additional permissions are contained in the header of the source file.
10527 #. type: Plain text
10528 #: build/C/man4/st.4:952
10529 msgid ""
10530 "The driver's internal buffering allows good throughput in fixed-block mode "
10531 "also with small B<read>(2)  and B<write>(2)  byte counts.  With direct "
10532 "transfers this is not possible and may cause a surprise when moving to the "
10533 "2.6 kernel.  The solution is to tell the software to use larger transfers "
10534 "(often telling it to use larger blocks).  If this is not possible, direct "
10535 "transfers can be disabled."
10536 msgstr ""
10537
10538 #. type: Plain text
10539 #: build/C/man4/st.4:954
10540 msgid "B<mt>(1)"
10541 msgstr ""
10542
10543 #. type: Plain text
10544 #: build/C/man4/st.4:962
10545 msgid ""
10546 "The file I<drivers/scsi/README.st> or I<Documentation/scsi/st.txt> (kernel "
10547 "E<gt>= 2.6) in the kernel sources contains the most recent information about "
10548 "the driver and its configuration possibilities."
10549 msgstr ""
10550
10551 #. type: TH
10552 #: build/C/man3/stdarg.3:41
10553 #, no-wrap
10554 msgid "STDARG"
10555 msgstr ""
10556
10557 #. type: TH
10558 #: build/C/man3/stdarg.3:41
10559 #, no-wrap
10560 msgid "2001-10-14"
10561 msgstr ""
10562
10563 #. type: Plain text
10564 #: build/C/man3/stdarg.3:44
10565 msgid "stdarg, va_start, va_arg, va_end, va_copy - variable argument lists"
10566 msgstr ""
10567
10568 #. type: Plain text
10569 #: build/C/man3/stdarg.3:46 build/C/man3/syslog.3:47
10570 msgid "B<#include E<lt>stdarg.hE<gt>>"
10571 msgstr ""
10572
10573 #. type: Plain text
10574 #: build/C/man3/stdarg.3:48
10575 msgid "B<void va_start(va_list >I<ap>B<, >I<last>B<);>"
10576 msgstr ""
10577
10578 #. type: Plain text
10579 #: build/C/man3/stdarg.3:50
10580 msgid "I<type>B< va_arg(va_list >I<ap>B<, >I<type>B<);>"
10581 msgstr ""
10582
10583 #. type: Plain text
10584 #: build/C/man3/stdarg.3:52
10585 msgid "B<void va_end(va_list >I<ap>B<);>"
10586 msgstr ""
10587
10588 #. type: Plain text
10589 #: build/C/man3/stdarg.3:54
10590 msgid "B<void va_copy(va_list >I<dest>B<, va_list >I<src>B<);>"
10591 msgstr ""
10592
10593 #. type: Plain text
10594 #: build/C/man3/stdarg.3:63
10595 msgid ""
10596 "A function may be called with a varying number of arguments of varying "
10597 "types.  The include file I<E<lt>stdarg.hE<gt>> declares a type I<va_list> "
10598 "and defines three macros for stepping through a list of arguments whose "
10599 "number and types are not known to the called function."
10600 msgstr ""
10601
10602 #. type: Plain text
10603 #: build/C/man3/stdarg.3:71
10604 msgid ""
10605 "The called function must declare an object of type I<va_list> which is used "
10606 "by the macros B<va_start>(), B<va_arg>(), and B<va_end>()."
10607 msgstr ""
10608
10609 #. type: SS
10610 #: build/C/man3/stdarg.3:71
10611 #, no-wrap
10612 msgid "va_start()"
10613 msgstr ""
10614
10615 #. type: Plain text
10616 #: build/C/man3/stdarg.3:81
10617 msgid ""
10618 "The B<va_start>()  macro initializes I<ap> for subsequent use by B<va_arg>()  "
10619 "and B<va_end>(), and must be called first."
10620 msgstr ""
10621
10622 #. type: Plain text
10623 #: build/C/man3/stdarg.3:86
10624 msgid ""
10625 "The argument I<last> is the name of the last argument before the variable "
10626 "argument list, that is, the last argument of which the calling function "
10627 "knows the type."
10628 msgstr ""
10629
10630 #. type: Plain text
10631 #: build/C/man3/stdarg.3:91
10632 msgid ""
10633 "Because the address of this argument may be used in the B<va_start>()  "
10634 "macro, it should not be declared as a register variable, or as a function or "
10635 "an array type."
10636 msgstr ""
10637
10638 #. type: SS
10639 #: build/C/man3/stdarg.3:91
10640 #, no-wrap
10641 msgid "va_arg()"
10642 msgstr ""
10643
10644 #. type: Plain text
10645 #: build/C/man3/stdarg.3:113
10646 msgid ""
10647 "The B<va_arg>()  macro expands to an expression that has the type and value "
10648 "of the next argument in the call.  The argument I<ap> is the I<va_list> "
10649 "I<ap> initialized by B<va_start>().  Each call to B<va_arg>()  modifies "
10650 "I<ap> so that the next call returns the next argument.  The argument I<type> "
10651 "is a type name specified so that the type of a pointer to an object that has "
10652 "the specified type can be obtained simply by adding a * to I<type>."
10653 msgstr ""
10654
10655 #. type: Plain text
10656 #: build/C/man3/stdarg.3:121
10657 msgid ""
10658 "The first use of the B<va_arg>()  macro after that of the B<va_start>()  "
10659 "macro returns the argument after I<last>.  Successive invocations return the "
10660 "values of the remaining arguments."
10661 msgstr ""
10662
10663 #. type: Plain text
10664 #: build/C/man3/stdarg.3:126
10665 msgid ""
10666 "If there is no next argument, or if I<type> is not compatible with the type "
10667 "of the actual next argument (as promoted according to the default argument "
10668 "promotions), random errors will occur."
10669 msgstr ""
10670
10671 #. type: Plain text
10672 #: build/C/man3/stdarg.3:134
10673 msgid ""
10674 "If I<ap> is passed to a function that uses B<va_arg(>I<ap>B<,>I<type>B<)> "
10675 "then the value of I<ap> is undefined after the return of that function."
10676 msgstr ""
10677
10678 #. type: SS
10679 #: build/C/man3/stdarg.3:134
10680 #, no-wrap
10681 msgid "va_end()"
10682 msgstr ""
10683
10684 #. type: Plain text
10685 #: build/C/man3/stdarg.3:153
10686 msgid ""
10687 "Each invocation of B<va_start>()  must be matched by a corresponding "
10688 "invocation of B<va_end>()  in the same function.  After the call "
10689 "B<va_end(>I<ap>B<)> the variable I<ap> is undefined.  Multiple traversals of "
10690 "the list, each bracketed by B<va_start>()  and B<va_end>()  are possible.  "
10691 "B<va_end>()  may be a macro or a function."
10692 msgstr ""
10693
10694 #. type: SS
10695 #: build/C/man3/stdarg.3:153
10696 #, no-wrap
10697 msgid "va_copy()"
10698 msgstr ""
10699
10700 #.  Proposal from clive@demon.net, 1997-02-28
10701 #. type: Plain text
10702 #: build/C/man3/stdarg.3:160
10703 msgid ""
10704 "An obvious implementation would have a I<va_list> be a pointer to the stack "
10705 "frame of the variadic function.  In such a setup (by far the most common) "
10706 "there seems nothing against an assignment"
10707 msgstr ""
10708
10709 #. type: Plain text
10710 #: build/C/man3/stdarg.3:164
10711 #, no-wrap
10712 msgid "va_list aq = ap;\n"
10713 msgstr ""
10714
10715 #. type: Plain text
10716 #: build/C/man3/stdarg.3:169
10717 msgid ""
10718 "Unfortunately, there are also systems that make it an array of pointers (of "
10719 "length 1), and there one needs"
10720 msgstr ""
10721
10722 #. type: Plain text
10723 #: build/C/man3/stdarg.3:174
10724 #, no-wrap
10725 msgid ""
10726 "va_list aq;\n"
10727 "*aq = *ap;\n"
10728 msgstr ""
10729
10730 #. type: Plain text
10731 #: build/C/man3/stdarg.3:190
10732 msgid ""
10733 "Finally, on systems where arguments are passed in registers, it may be "
10734 "necessary for B<va_start>()  to allocate memory, store the arguments there, "
10735 "and also an indication of which argument is next, so that B<va_arg>()  can "
10736 "step through the list.  Now B<va_end>()  can free the allocated memory "
10737 "again.  To accommodate this situation, C99 adds a macro B<va_copy>(), so "
10738 "that the above assignment can be replaced by"
10739 msgstr ""
10740
10741 #. type: Plain text
10742 #: build/C/man3/stdarg.3:197
10743 #, no-wrap
10744 msgid ""
10745 "va_list aq;\n"
10746 "va_copy(aq, ap);\n"
10747 "\\&...\n"
10748 "va_end(aq);\n"
10749 msgstr ""
10750
10751 #. type: Plain text
10752 #: build/C/man3/stdarg.3:210
10753 msgid ""
10754 "Each invocation of B<va_copy>()  must be matched by a corresponding "
10755 "invocation of B<va_end>()  in the same function.  Some systems that do not "
10756 "supply B<va_copy>()  have B<__va_copy> instead, since that was the name used "
10757 "in the draft proposal."
10758 msgstr ""
10759
10760 #. type: Plain text
10761 #: build/C/man3/stdarg.3:220
10762 msgid ""
10763 "The B<va_start>(), B<va_arg>(), and B<va_end>()  macros conform to C89.  C99 "
10764 "defines the B<va_copy>()  macro."
10765 msgstr ""
10766
10767 #. type: Plain text
10768 #: build/C/man3/stdarg.3:226
10769 msgid ""
10770 "These macros are I<not> compatible with the historic macros they replace.  A "
10771 "backward-compatible version can be found in the include file "
10772 "I<E<lt>varargs.hE<gt>>."
10773 msgstr ""
10774
10775 #. type: Plain text
10776 #: build/C/man3/stdarg.3:228
10777 msgid "The historic setup is:"
10778 msgstr ""
10779
10780 #. type: Plain text
10781 #: build/C/man3/stdarg.3:232
10782 #, no-wrap
10783 msgid "#include E<lt>varargs.hE<gt>\n"
10784 msgstr ""
10785
10786 #. type: Plain text
10787 #: build/C/man3/stdarg.3:238
10788 #, no-wrap
10789 msgid ""
10790 "void\n"
10791 "foo(va_alist)\n"
10792 "    va_dcl\n"
10793 "{\n"
10794 "    va_list ap;\n"
10795 msgstr ""
10796
10797 #. type: Plain text
10798 #: build/C/man3/stdarg.3:247
10799 #, no-wrap
10800 msgid ""
10801 "    va_start(ap);\n"
10802 "    while (...) {\n"
10803 "        ...\n"
10804 "        x = va_arg(ap, type);\n"
10805 "        ...\n"
10806 "    }\n"
10807 "    va_end(ap);\n"
10808 "}\n"
10809 msgstr ""
10810
10811 #. type: Plain text
10812 #: build/C/man3/stdarg.3:256
10813 msgid ""
10814 "On some systems, I<va_end> contains a closing \\(aq}\\(aq matching a "
10815 "\\(aq{\\(aq in I<va_start>, so that both macros must occur in the same "
10816 "function, and in a way that allows this."
10817 msgstr ""
10818
10819 #. type: Plain text
10820 #: build/C/man3/stdarg.3:272
10821 msgid ""
10822 "Unlike the B<varargs> macros, the B<stdarg> macros do not permit programmers "
10823 "to code a function with no fixed arguments.  This problem generates work "
10824 "mainly when converting B<varargs> code to B<stdarg> code, but it also "
10825 "creates difficulties for variadic functions that wish to pass all of their "
10826 "arguments on to a function that takes a I<va_list> argument, such as "
10827 "B<vfprintf>(3)."
10828 msgstr ""
10829
10830 #. type: Plain text
10831 #: build/C/man3/stdarg.3:277
10832 msgid ""
10833 "The function I<foo> takes a string of format characters and prints out the "
10834 "argument associated with each format character based on the type."
10835 msgstr ""
10836
10837 #. type: Plain text
10838 #: build/C/man3/stdarg.3:281
10839 #, no-wrap
10840 msgid ""
10841 "#include E<lt>stdio.hE<gt>\n"
10842 "#include E<lt>stdarg.hE<gt>\n"
10843 msgstr ""
10844
10845 #. type: Plain text
10846 #: build/C/man3/stdarg.3:288
10847 #, no-wrap
10848 msgid ""
10849 "void\n"
10850 "foo(char *fmt, ...)\n"
10851 "{\n"
10852 "    va_list ap;\n"
10853 "    int d;\n"
10854 "    char c, *s;\n"
10855 msgstr ""
10856
10857 #. type: Plain text
10858 #: build/C/man3/stdarg.3:309
10859 #, no-wrap
10860 msgid ""
10861 "    va_start(ap, fmt);\n"
10862 "    while (*fmt)\n"
10863 "        switch (*fmt++) {\n"
10864 "        case \\(aqs\\(aq:              /* string */\n"
10865 "            s = va_arg(ap, char *);\n"
10866 "            printf(\"string %s\\en\", s);\n"
10867 "            break;\n"
10868 "        case \\(aqd\\(aq:              /* int */\n"
10869 "            d = va_arg(ap, int);\n"
10870 "            printf(\"int %d\\en\", d);\n"
10871 "            break;\n"
10872 "        case \\(aqc\\(aq:              /* char */\n"
10873 "            /* need a cast here since va_arg only\n"
10874 "               takes fully promoted types */\n"
10875 "            c = (char) va_arg(ap, int);\n"
10876 "            printf(\"char %c\\en\", c);\n"
10877 "            break;\n"
10878 "        }\n"
10879 "    va_end(ap);\n"
10880 "}\n"
10881 msgstr ""
10882
10883 #. type: TH
10884 #: build/C/man2/syslog.2:29 build/C/man3/syslog.3:34
10885 #, no-wrap
10886 msgid "SYSLOG"
10887 msgstr ""
10888
10889 #. type: TH
10890 #: build/C/man2/syslog.2:29
10891 #, no-wrap
10892 msgid "2011-09-07"
10893 msgstr ""
10894
10895 #. type: Plain text
10896 #: build/C/man2/syslog.2:33
10897 msgid ""
10898 "syslog, klogctl - read and/or clear kernel message ring buffer; set "
10899 "console_loglevel"
10900 msgstr ""
10901
10902 #. type: Plain text
10903 #: build/C/man2/syslog.2:37
10904 #, no-wrap
10905 msgid ""
10906 "B<int syslog(int >I<type>B<, char *>I<bufp>B<, int >I<len>B<);>\n"
10907 "B</* No wrapper provided in glibc */>\n"
10908 msgstr ""
10909
10910 #. type: Plain text
10911 #: build/C/man2/syslog.2:39
10912 #, no-wrap
10913 msgid "/* The glibc interface */\n"
10914 msgstr ""
10915
10916 #. type: Plain text
10917 #: build/C/man2/syslog.2:41
10918 #, no-wrap
10919 msgid "B<#include E<lt>sys/klog.hE<gt>>\n"
10920 msgstr ""
10921
10922 #. type: Plain text
10923 #: build/C/man2/syslog.2:43
10924 #, no-wrap
10925 msgid "B<int klogctl(int >I<type>B<, char *>I<bufp>B<, int >I<len>B<);>\n"
10926 msgstr ""
10927
10928 #. type: Plain text
10929 #: build/C/man2/syslog.2:55
10930 msgid ""
10931 "If you need the C library function B<syslog>()  (which talks to "
10932 "B<syslogd>(8)), then look at B<syslog>(3).  The system call of this name is "
10933 "about controlling the kernel I<printk>()  buffer, and the glibc wrapper "
10934 "function is called B<klogctl>()."
10935 msgstr ""
10936
10937 #. type: Plain text
10938 #: build/C/man2/syslog.2:58
10939 msgid ""
10940 "The I<type> argument determines the action taken by this function, as "
10941 "follows:"
10942 msgstr ""
10943
10944 #. type: Plain text
10945 #: build/C/man2/syslog.2:71
10946 #, no-wrap
10947 msgid ""
10948 "      0 -- Close the log.  Currently a NOP.\n"
10949 "      1 -- Open the log. Currently a NOP.\n"
10950 "      2 -- Read from the log.\n"
10951 "      3 -- Read all messages remaining in the ring buffer.\n"
10952 "      4 -- Read and clear all messages remaining in the ring buffer\n"
10953 "      5 -- Clear ring buffer.\n"
10954 "      6 -- Disable printk to console\n"
10955 "      7 -- Enable printk to console\n"
10956 "      8 -- Set level of messages printed to console\n"
10957 "      9 -- Return number of unread characters in the log buffer\n"
10958 "     10 -- Return size of the log buffer\n"
10959 msgstr ""
10960
10961 #. type: Plain text
10962 #: build/C/man2/syslog.2:74
10963 msgid "Type 9 was added in Linux 2.4.10; type 10 in Linux 2.6.6."
10964 msgstr ""
10965
10966 #. type: Plain text
10967 #: build/C/man2/syslog.2:90
10968 msgid ""
10969 "In Linux kernels before 2.6.37, only command types 3 and 10 are allowed to "
10970 "unprivileged processes.  Since Linux 2.6.37, command types 3 and 10 are only "
10971 "allowed to unprivileged processes if I</proc/sys/kernel/dmesg_restrict> has "
10972 "the value 0.  Before Linux 2.6.37, \"privileged\" means that the caller has "
10973 "the B<CAP_SYS_ADMIN> capability.  Since Linux 2.6.37, \"privileged\" means "
10974 "that the caller has either the B<CAP_SYS_ADMIN> capability (now deprecated "
10975 "for this purpose) or the (new)  B<CAP_SYSLOG> capability."
10976 msgstr ""
10977
10978 #. type: SS
10979 #: build/C/man2/syslog.2:90
10980 #, no-wrap
10981 msgid "The kernel log buffer"
10982 msgstr ""
10983
10984 #.  Under "General setup" ==> "Kernel log buffer size"
10985 #.  For 2.6, precisely the option seems to have appeared in 2.5.55.
10986 #. type: Plain text
10987 #: build/C/man2/syslog.2:105
10988 msgid ""
10989 "The kernel has a cyclic buffer of length B<LOG_BUF_LEN> in which messages "
10990 "given as arguments to the kernel function B<printk>()  are stored "
10991 "(regardless of their loglevel).  In early kernels, B<LOG_BUF_LEN> had the "
10992 "value 4096; from kernel 1.3.54, it was 8192; from kernel 2.1.113 it was "
10993 "16384; since 2.4.23/2.6 the value is a kernel configuration option.  In "
10994 "recent kernels the size can be queried with command type 10."
10995 msgstr ""
10996
10997 #. type: Plain text
10998 #: build/C/man2/syslog.2:117
10999 msgid ""
11000 "The call I<syslog(2,buf,len)> waits until this kernel log buffer is "
11001 "nonempty, and then reads at most I<len> bytes into the buffer I<buf>.  It "
11002 "returns the number of bytes read.  Bytes read from the log disappear from "
11003 "the log buffer: the information can only be read once.  This is the function "
11004 "executed by the kernel when a user program reads I</proc/kmsg>."
11005 msgstr ""
11006
11007 #. type: Plain text
11008 #: build/C/man2/syslog.2:124
11009 msgid ""
11010 "The call I<syslog(3,buf,len)> will read the last I<len> bytes from the log "
11011 "buffer (nondestructively), but will not read more than was written into the "
11012 "buffer since the last \"clear ring buffer\" command (which does not clear "
11013 "the buffer at all).  It returns the number of bytes read."
11014 msgstr ""
11015
11016 #. type: Plain text
11017 #: build/C/man2/syslog.2:128
11018 msgid ""
11019 "The call I<syslog(4,buf,len)> does precisely the same, but also executes the "
11020 "\"clear ring buffer\" command."
11021 msgstr ""
11022
11023 #. type: Plain text
11024 #: build/C/man2/syslog.2:137
11025 msgid ""
11026 "The call I<syslog(5,dummy,dummy)> executes just the \"clear ring buffer\" "
11027 "command.  (In each call where I<buf> or I<len> is shown as \"dummy\", the "
11028 "value of the argument is ignored by the call.)"
11029 msgstr ""
11030
11031 #. type: Plain text
11032 #: build/C/man2/syslog.2:142
11033 msgid ""
11034 "The call I<syslog(6,dummy,dummy)> sets the console log level to minimum, so "
11035 "that no messages are printed to the console."
11036 msgstr ""
11037
11038 #. type: Plain text
11039 #: build/C/man2/syslog.2:147
11040 msgid ""
11041 "The call I<syslog(7,dummy,dummy)> sets the console log level to default, so "
11042 "that messages are printed to the console."
11043 msgstr ""
11044
11045 #. type: Plain text
11046 #: build/C/man2/syslog.2:156
11047 msgid ""
11048 "The call I<syslog(8,dummy,level)> sets the console log level to I<level>, "
11049 "which must be an integer between 1 and 8 (inclusive).  See the B<loglevel> "
11050 "section for details."
11051 msgstr ""
11052
11053 #. type: Plain text
11054 #: build/C/man2/syslog.2:161
11055 msgid ""
11056 "The call I<syslog(9,dummy,dummy)> returns the number of bytes currently "
11057 "available to be read on the kernel log buffer."
11058 msgstr ""
11059
11060 #. type: Plain text
11061 #: build/C/man2/syslog.2:165
11062 msgid ""
11063 "The call I<syslog(10,dummy,dummy)> returns the total size of the kernel log "
11064 "buffer."
11065 msgstr ""
11066
11067 #. type: SS
11068 #: build/C/man2/syslog.2:165
11069 #, no-wrap
11070 msgid "The loglevel"
11071 msgstr ""
11072
11073 #. type: Plain text
11074 #: build/C/man2/syslog.2:182
11075 msgid ""
11076 "The kernel routine B<printk>()  will only print a message on the console, if "
11077 "it has a loglevel less than the value of the variable I<console_loglevel>.  "
11078 "This variable initially has the value B<DEFAULT_CONSOLE_LOGLEVEL> (7), but "
11079 "is set to 10 if the kernel command line contains the word \"debug\", and to "
11080 "15 in case of a kernel fault (the 10 and 15 are just silly, and equivalent "
11081 "to 8).  This variable is set (to a value in the range 1-8) by the call "
11082 "I<syslog(8,dummy,value)>.  The calls I<syslog(type,dummy,dummy)> with "
11083 "I<type> equal to 6 or 7, set it to 1 (kernel panics only)  or 7 (all except "
11084 "debugging messages), respectively."
11085 msgstr ""
11086
11087 #. type: Plain text
11088 #: build/C/man2/syslog.2:192
11089 msgid ""
11090 "Every text line in a message has its own loglevel.  This level is "
11091 "I<DEFAULT_MESSAGE_LOGLEVEL - 1> (6) unless the line starts with E<lt>dE<gt> "
11092 "where I<d> is a digit in the range 1-7, in which case the level is I<d>.  "
11093 "The conventional meaning of the loglevel is defined in "
11094 "I<E<lt>linux/kernel.hE<gt>> as follows:"
11095 msgstr ""
11096
11097 #. type: Plain text
11098 #: build/C/man2/syslog.2:202
11099 #, no-wrap
11100 msgid ""
11101 "#define KERN_EMERG    \"E<lt>0E<gt>\"  /* system is unusable               "
11102 "*/\n"
11103 "#define KERN_ALERT    \"E<lt>1E<gt>\"  /* action must be taken immediately "
11104 "*/\n"
11105 "#define KERN_CRIT     \"E<lt>2E<gt>\"  /* critical conditions              "
11106 "*/\n"
11107 "#define KERN_ERR      \"E<lt>3E<gt>\"  /* error conditions                 "
11108 "*/\n"
11109 "#define KERN_WARNING  \"E<lt>4E<gt>\"  /* warning conditions               "
11110 "*/\n"
11111 "#define KERN_NOTICE   \"E<lt>5E<gt>\"  /* normal but significant condition "
11112 "*/\n"
11113 "#define KERN_INFO     \"E<lt>6E<gt>\"  /* informational                    "
11114 "*/\n"
11115 "#define KERN_DEBUG    \"E<lt>7E<gt>\"  /* debug-level messages             "
11116 "*/\n"
11117 msgstr ""
11118
11119 #. type: Plain text
11120 #: build/C/man2/syslog.2:216
11121 msgid ""
11122 "For I<type> equal to 2, 3, or 4, a successful call to B<syslog>()  returns "
11123 "the number of bytes read.  For I<type> 9, B<syslog>()  returns the number of "
11124 "bytes currently available to be read on the kernel log buffer.  For I<type> "
11125 "10, B<syslog>()  returns the total size of the kernel log buffer.  For other "
11126 "values of I<type>, 0 is returned on success."
11127 msgstr ""
11128
11129 #. type: Plain text
11130 #: build/C/man2/syslog.2:219
11131 msgid "In case of error, -1 is returned, and I<errno> is set to indicate the error."
11132 msgstr ""
11133
11134 #. type: Plain text
11135 #: build/C/man2/syslog.2:237
11136 msgid ""
11137 "Bad arguments (e.g., bad I<type>; or for I<type> 2, 3, or 4, I<buf> is NULL, "
11138 "or I<len> is less than zero; or for I<type> 8, the I<level> is outside the "
11139 "range 1 to 8)."
11140 msgstr ""
11141
11142 #. type: Plain text
11143 #: build/C/man2/syslog.2:244
11144 msgid ""
11145 "This B<syslog>()  system call is not available, because the kernel was "
11146 "compiled with the B<CONFIG_PRINTK> kernel-configuration option disabled."
11147 msgstr ""
11148
11149 #. type: Plain text
11150 #: build/C/man2/syslog.2:253
11151 msgid ""
11152 "An attempt was made to change console_loglevel or clear the kernel message "
11153 "ring buffer by a process without sufficient privilege (more precisely: "
11154 "without the B<CAP_SYS_ADMIN> or B<CAP_SYSLOG> capability)."
11155 msgstr ""
11156
11157 #. type: TP
11158 #: build/C/man2/syslog.2:253
11159 #, no-wrap
11160 msgid "B<ERESTARTSYS>"
11161 msgstr ""
11162
11163 #. type: Plain text
11164 #: build/C/man2/syslog.2:257
11165 msgid ""
11166 "System call was interrupted by a signal; nothing was read.  (This can be "
11167 "seen only during a trace.)"
11168 msgstr ""
11169
11170 #. type: Plain text
11171 #: build/C/man2/syslog.2:260
11172 msgid ""
11173 "This system call is Linux-specific and should not be used in programs "
11174 "intended to be portable."
11175 msgstr ""
11176
11177 #. type: Plain text
11178 #: build/C/man2/syslog.2:268
11179 msgid ""
11180 "From the very start people noted that it is unfortunate that a system call "
11181 "and a library routine of the same name are entirely different animals.  In "
11182 "libc4 and libc5 the number of this call was defined by B<SYS_klog>.  In "
11183 "glibc 2.0 the syscall is baptized B<klogctl>()."
11184 msgstr ""
11185
11186 #. type: Plain text
11187 #: build/C/man2/syslog.2:271
11188 msgid "B<syslog>(3), B<capabilities>(7)"
11189 msgstr ""
11190
11191 #. type: TH
11192 #: build/C/man3/syslog.3:34
11193 #, no-wrap
11194 msgid "2008-11-12"
11195 msgstr ""
11196
11197 #. type: Plain text
11198 #: build/C/man3/syslog.3:37
11199 msgid "closelog, openlog, syslog, vsyslog - send messages to the system logger"
11200 msgstr ""
11201
11202 #. type: Plain text
11203 #: build/C/man3/syslog.3:39
11204 msgid "B<#include E<lt>syslog.hE<gt>>"
11205 msgstr ""
11206
11207 #. type: Plain text
11208 #: build/C/man3/syslog.3:41
11209 msgid ""
11210 "B<void openlog(const char *>I<ident>B<, int >I<option>B<, int "
11211 ">I<facility>B<);>"
11212 msgstr ""
11213
11214 #. type: Plain text
11215 #: build/C/man3/syslog.3:43
11216 msgid "B<void syslog(int >I<priority>B<, const char *>I<format>B<, ...);>"
11217 msgstr ""
11218
11219 #. type: Plain text
11220 #: build/C/man3/syslog.3:45
11221 msgid "B<void closelog(void);>"
11222 msgstr ""
11223
11224 #. type: Plain text
11225 #: build/C/man3/syslog.3:49
11226 msgid ""
11227 "B<void vsyslog(int >I<priority>B<, const char *>I<format>B<, va_list "
11228 ">I<ap>B<);>"
11229 msgstr ""
11230
11231 #. type: Plain text
11232 #: build/C/man3/syslog.3:57
11233 msgid "B<vsyslog>(): _BSD_SOURCE"
11234 msgstr ""
11235
11236 #. type: Plain text
11237 #: build/C/man3/syslog.3:63
11238 msgid ""
11239 "B<closelog>()  closes the descriptor being used to write to the system "
11240 "logger.  The use of B<closelog>()  is optional."
11241 msgstr ""
11242
11243 #. type: Plain text
11244 #: build/C/man3/syslog.3:92
11245 msgid ""
11246 "B<openlog>()  opens a connection to the system logger for a program.  The "
11247 "string pointed to by I<ident> is prepended to every message, and is "
11248 "typically set to the program name.  The I<option> argument specifies flags "
11249 "which control the operation of B<openlog>()  and subsequent calls to "
11250 "B<syslog>().  The I<facility> argument establishes a default to be used if "
11251 "none is specified in subsequent calls to B<syslog>().  Values for I<option> "
11252 "and I<facility> are given below.  The use of B<openlog>()  is optional; it "
11253 "will automatically be called by B<syslog>()  if necessary, in which case "
11254 "I<ident> will default to NULL."
11255 msgstr ""
11256
11257 #. type: Plain text
11258 #: build/C/man3/syslog.3:116
11259 msgid ""
11260 "B<syslog>()  generates a log message, which will be distributed by "
11261 "B<syslogd>(8).  The I<priority> argument is formed by ORing the I<facility> "
11262 "and the I<level> values (explained below).  The remaining arguments are a "
11263 "I<format>, as in B<printf>(3)  and any arguments required by the I<format>, "
11264 "except that the two character sequence B<%m> will be replaced by the error "
11265 "message string I<strerror>(I<errno>).  A trailing newline may be added if "
11266 "needed."
11267 msgstr ""
11268
11269 #. type: Plain text
11270 #: build/C/man3/syslog.3:125
11271 msgid ""
11272 "The function B<vsyslog>()  performs the same task as B<syslog>()  with the "
11273 "difference that it takes a set of arguments which have been obtained using "
11274 "the B<stdarg>(3)  variable argument list macros."
11275 msgstr ""
11276
11277 #. type: Plain text
11278 #: build/C/man3/syslog.3:128
11279 msgid ""
11280 "The subsections below list the parameters used to set the values of "
11281 "I<option>,I< facility>, and I<priority>."
11282 msgstr ""
11283
11284 #. type: SS
11285 #: build/C/man3/syslog.3:128
11286 #, no-wrap
11287 msgid "option"
11288 msgstr ""
11289
11290 #. type: Plain text
11291 #: build/C/man3/syslog.3:134
11292 msgid "The I<option> argument to B<openlog>()  is an OR of any of these:"
11293 msgstr ""
11294
11295 #. type: TP
11296 #: build/C/man3/syslog.3:134
11297 #, no-wrap
11298 msgid "B<LOG_CONS>"
11299 msgstr ""
11300
11301 #. type: Plain text
11302 #: build/C/man3/syslog.3:138
11303 msgid ""
11304 "Write directly to system console if there is an error while sending to "
11305 "system logger."
11306 msgstr ""
11307
11308 #. type: TP
11309 #: build/C/man3/syslog.3:138
11310 #, no-wrap
11311 msgid "B<LOG_NDELAY>"
11312 msgstr ""
11313
11314 #. type: Plain text
11315 #: build/C/man3/syslog.3:142
11316 msgid ""
11317 "Open the connection immediately (normally, the connection is opened when the "
11318 "first message is logged)."
11319 msgstr ""
11320
11321 #. type: TP
11322 #: build/C/man3/syslog.3:142
11323 #, no-wrap
11324 msgid "B<LOG_NOWAIT>"
11325 msgstr ""
11326
11327 #. type: Plain text
11328 #: build/C/man3/syslog.3:148
11329 msgid ""
11330 "Don't wait for child processes that may have been created while logging the "
11331 "message.  (The GNU C library does not create a child process, so this option "
11332 "has no effect on Linux.)"
11333 msgstr ""
11334
11335 #. type: TP
11336 #: build/C/man3/syslog.3:148
11337 #, no-wrap
11338 msgid "B<LOG_ODELAY>"
11339 msgstr ""
11340
11341 #. type: Plain text
11342 #: build/C/man3/syslog.3:156
11343 msgid ""
11344 "The converse of B<LOG_NDELAY>; opening of the connection is delayed until "
11345 "B<syslog>()  is called.  (This is the default, and need not be specified.)"
11346 msgstr ""
11347
11348 #. type: TP
11349 #: build/C/man3/syslog.3:156
11350 #, no-wrap
11351 msgid "B<LOG_PERROR>"
11352 msgstr ""
11353
11354 #. type: Plain text
11355 #: build/C/man3/syslog.3:160
11356 msgid "(Not in POSIX.1-2001.)  Print to I<stderr> as well."
11357 msgstr ""
11358
11359 #. type: TP
11360 #: build/C/man3/syslog.3:160
11361 #, no-wrap
11362 msgid "B<LOG_PID>"
11363 msgstr ""
11364
11365 #. type: Plain text
11366 #: build/C/man3/syslog.3:163
11367 msgid "Include PID with each message."
11368 msgstr ""
11369
11370 #. type: SS
11371 #: build/C/man3/syslog.3:163
11372 #, no-wrap
11373 msgid "facility"
11374 msgstr ""
11375
11376 #. type: Plain text
11377 #: build/C/man3/syslog.3:169
11378 msgid ""
11379 "The I<facility> argument is used to specify what type of program is logging "
11380 "the message.  This lets the configuration file specify that messages from "
11381 "different facilities will be handled differently."
11382 msgstr ""
11383
11384 #. type: TP
11385 #: build/C/man3/syslog.3:169
11386 #, no-wrap
11387 msgid "B<LOG_AUTH>"
11388 msgstr ""
11389
11390 #. type: Plain text
11391 #: build/C/man3/syslog.3:174
11392 msgid "security/authorization messages (DEPRECATED Use B<LOG_AUTHPRIV> instead)"
11393 msgstr ""
11394
11395 #. type: TP
11396 #: build/C/man3/syslog.3:174
11397 #, no-wrap
11398 msgid "B<LOG_AUTHPRIV>"
11399 msgstr ""
11400
11401 #. type: Plain text
11402 #: build/C/man3/syslog.3:177
11403 msgid "security/authorization messages (private)"
11404 msgstr ""
11405
11406 #. type: TP
11407 #: build/C/man3/syslog.3:177
11408 #, no-wrap
11409 msgid "B<LOG_CRON>"
11410 msgstr ""
11411
11412 #. type: Plain text
11413 #: build/C/man3/syslog.3:181
11414 msgid "clock daemon (B<cron> and B<at>)"
11415 msgstr ""
11416
11417 #. type: TP
11418 #: build/C/man3/syslog.3:181
11419 #, no-wrap
11420 msgid "B<LOG_DAEMON>"
11421 msgstr ""
11422
11423 #. type: Plain text
11424 #: build/C/man3/syslog.3:184
11425 msgid "system daemons without separate facility value"
11426 msgstr ""
11427
11428 #. type: TP
11429 #: build/C/man3/syslog.3:184
11430 #, no-wrap
11431 msgid "B<LOG_FTP>"
11432 msgstr ""
11433
11434 #. type: Plain text
11435 #: build/C/man3/syslog.3:187
11436 msgid "ftp daemon"
11437 msgstr ""
11438
11439 #. type: TP
11440 #: build/C/man3/syslog.3:187
11441 #, no-wrap
11442 msgid "B<LOG_KERN>"
11443 msgstr ""
11444
11445 #.  LOG_KERN has the value 0; if used as a facility, zero translates to:
11446 #.  "use the default facility".
11447 #. type: Plain text
11448 #: build/C/man3/syslog.3:192
11449 msgid "kernel messages (these can't be generated from user processes)"
11450 msgstr ""
11451
11452 #. type: TP
11453 #: build/C/man3/syslog.3:192
11454 #, no-wrap
11455 msgid "B<LOG_LOCAL0> through B<LOG_LOCAL7>"
11456 msgstr ""
11457
11458 #. type: Plain text
11459 #: build/C/man3/syslog.3:195
11460 msgid "reserved for local use"
11461 msgstr ""
11462
11463 #. type: TP
11464 #: build/C/man3/syslog.3:195
11465 #, no-wrap
11466 msgid "B<LOG_LPR>"
11467 msgstr ""
11468
11469 #. type: Plain text
11470 #: build/C/man3/syslog.3:198
11471 msgid "line printer subsystem"
11472 msgstr ""
11473
11474 #. type: TP
11475 #: build/C/man3/syslog.3:198
11476 #, no-wrap
11477 msgid "B<LOG_MAIL>"
11478 msgstr ""
11479
11480 #. type: Plain text
11481 #: build/C/man3/syslog.3:201
11482 msgid "mail subsystem"
11483 msgstr ""
11484
11485 #. type: TP
11486 #: build/C/man3/syslog.3:201
11487 #, no-wrap
11488 msgid "B<LOG_NEWS>"
11489 msgstr ""
11490
11491 #. type: Plain text
11492 #: build/C/man3/syslog.3:204
11493 msgid "USENET news subsystem"
11494 msgstr ""
11495
11496 #. type: TP
11497 #: build/C/man3/syslog.3:204
11498 #, no-wrap
11499 msgid "B<LOG_SYSLOG>"
11500 msgstr ""
11501
11502 #. type: Plain text
11503 #: build/C/man3/syslog.3:208
11504 msgid "messages generated internally by B<syslogd>(8)"
11505 msgstr ""
11506
11507 #. type: TP
11508 #: build/C/man3/syslog.3:208
11509 #, no-wrap
11510 msgid "B<LOG_USER> (default)"
11511 msgstr ""
11512
11513 #. type: Plain text
11514 #: build/C/man3/syslog.3:211
11515 msgid "generic user-level messages"
11516 msgstr ""
11517
11518 #. type: TP
11519 #: build/C/man3/syslog.3:211
11520 #, no-wrap
11521 msgid "B<LOG_UUCP>"
11522 msgstr ""
11523
11524 #. type: Plain text
11525 #: build/C/man3/syslog.3:214
11526 msgid "UUCP subsystem"
11527 msgstr ""
11528
11529 #. type: SS
11530 #: build/C/man3/syslog.3:214
11531 #, no-wrap
11532 msgid "level"
11533 msgstr ""
11534
11535 #. type: Plain text
11536 #: build/C/man3/syslog.3:217
11537 msgid ""
11538 "This determines the importance of the message.  The levels are, in order of "
11539 "decreasing importance:"
11540 msgstr ""
11541
11542 #. type: TP
11543 #: build/C/man3/syslog.3:217
11544 #, no-wrap
11545 msgid "B<LOG_EMERG>"
11546 msgstr ""
11547
11548 #. type: Plain text
11549 #: build/C/man3/syslog.3:220
11550 msgid "system is unusable"
11551 msgstr ""
11552
11553 #. type: TP
11554 #: build/C/man3/syslog.3:220
11555 #, no-wrap
11556 msgid "B<LOG_ALERT>"
11557 msgstr ""
11558
11559 #. type: Plain text
11560 #: build/C/man3/syslog.3:223
11561 msgid "action must be taken immediately"
11562 msgstr ""
11563
11564 #. type: TP
11565 #: build/C/man3/syslog.3:223
11566 #, no-wrap
11567 msgid "B<LOG_CRIT>"
11568 msgstr ""
11569
11570 #. type: Plain text
11571 #: build/C/man3/syslog.3:226
11572 msgid "critical conditions"
11573 msgstr ""
11574
11575 #. type: TP
11576 #: build/C/man3/syslog.3:226
11577 #, no-wrap
11578 msgid "B<LOG_ERR>"
11579 msgstr ""
11580
11581 #. type: Plain text
11582 #: build/C/man3/syslog.3:229
11583 msgid "error conditions"
11584 msgstr ""
11585
11586 #. type: TP
11587 #: build/C/man3/syslog.3:229
11588 #, no-wrap
11589 msgid "B<LOG_WARNING>"
11590 msgstr ""
11591
11592 #. type: Plain text
11593 #: build/C/man3/syslog.3:232
11594 msgid "warning conditions"
11595 msgstr ""
11596
11597 #. type: TP
11598 #: build/C/man3/syslog.3:232
11599 #, no-wrap
11600 msgid "B<LOG_NOTICE>"
11601 msgstr ""
11602
11603 #. type: Plain text
11604 #: build/C/man3/syslog.3:235
11605 msgid "normal, but significant, condition"
11606 msgstr ""
11607
11608 #. type: TP
11609 #: build/C/man3/syslog.3:235
11610 #, no-wrap
11611 msgid "B<LOG_INFO>"
11612 msgstr ""
11613
11614 #. type: Plain text
11615 #: build/C/man3/syslog.3:238
11616 msgid "informational message"
11617 msgstr ""
11618
11619 #. type: TP
11620 #: build/C/man3/syslog.3:238
11621 #, no-wrap
11622 msgid "B<LOG_DEBUG>"
11623 msgstr ""
11624
11625 #. type: Plain text
11626 #: build/C/man3/syslog.3:241
11627 msgid "debug-level message"
11628 msgstr ""
11629
11630 #. type: Plain text
11631 #: build/C/man3/syslog.3:245
11632 msgid ""
11633 "The function B<setlogmask>(3)  can be used to restrict logging to specified "
11634 "levels only."
11635 msgstr ""
11636
11637 #.  .SH HISTORY
11638 #.  A
11639 #.  .BR syslog ()
11640 #.  function call appeared in 4.2BSD.
11641 #.  4.3BSD documents
11642 #.  .BR openlog (),
11643 #.  .BR syslog (),
11644 #.  .BR closelog (),
11645 #.  and
11646 #.  .BR setlogmask ().
11647 #.  4.3BSD-Reno also documents
11648 #.  .BR vsyslog ().
11649 #.  Of course early v* functions used the
11650 #.  .I <varargs.h>
11651 #.  mechanism, which is not compatible with
11652 #.  .IR <stdarg.h> .
11653 #. type: Plain text
11654 #: build/C/man3/syslog.3:289
11655 msgid ""
11656 "The functions B<openlog>(), B<closelog>(), and B<syslog>()  (but not "
11657 "B<vsyslog>())  are specified in SUSv2 and POSIX.1-2001.  POSIX.1-2001 "
11658 "specifies only the B<LOG_USER> and B<LOG_LOCAL*> values for I<facility>.  "
11659 "However, with the exception of B<LOG_AUTHPRIV> and B<LOG_FTP>, the other "
11660 "I<facility> values appear on most UNIX systems.  The B<LOG_PERROR> value for "
11661 "I<option> is not specified by POSIX.1-2001, but is available in most "
11662 "versions of UNIX."
11663 msgstr ""
11664
11665 #. type: Plain text
11666 #: build/C/man3/syslog.3:301
11667 msgid ""
11668 "The argument I<ident> in the call of B<openlog>()  is probably stored "
11669 "as-is.  Thus, if the string it points to is changed, B<syslog>()  may start "
11670 "prepending the changed string, and if the string it points to ceases to "
11671 "exist, the results are undefined.  Most portable is to use a string "
11672 "constant."
11673 msgstr ""
11674
11675 #. type: Plain text
11676 #: build/C/man3/syslog.3:304
11677 msgid ""
11678 "Never pass a string with user-supplied data as a format, use the following "
11679 "instead:"
11680 msgstr ""
11681
11682 #. type: Plain text
11683 #: build/C/man3/syslog.3:307
11684 #, no-wrap
11685 msgid "    syslog(priority, \"%s\", string);\n"
11686 msgstr ""
11687
11688 #. type: Plain text
11689 #: build/C/man3/syslog.3:313
11690 msgid "B<logger>(1), B<setlogmask>(3), B<syslog.conf>(5), B<syslogd>(8)"
11691 msgstr ""
11692
11693 #. type: TH
11694 #: build/C/man4/ttyS.4:25
11695 #, no-wrap
11696 msgid "TTYS"
11697 msgstr ""
11698
11699 #. type: TH
11700 #: build/C/man4/ttyS.4:25
11701 #, no-wrap
11702 msgid "1992-12-19"
11703 msgstr ""
11704
11705 #. type: Plain text
11706 #: build/C/man4/ttyS.4:28
11707 msgid "ttyS - serial terminal lines"
11708 msgstr ""
11709
11710 #. type: Plain text
11711 #: build/C/man4/ttyS.4:30
11712 msgid "B<ttyS[0-3]> are character devices for the serial terminal lines."
11713 msgstr ""
11714
11715 #. type: Plain text
11716 #: build/C/man4/ttyS.4:35
11717 msgid "mknod -m 660 /dev/ttyS0 c 4 64 # base address 0x3f8"
11718 msgstr ""
11719
11720 #. type: Plain text
11721 #: build/C/man4/ttyS.4:37
11722 msgid "mknod -m 660 /dev/ttyS1 c 4 65 # base address 0x2f8"
11723 msgstr ""
11724
11725 #. type: Plain text
11726 #: build/C/man4/ttyS.4:39
11727 msgid "mknod -m 660 /dev/ttyS2 c 4 66 # base address 0x3e8"
11728 msgstr ""
11729
11730 #. type: Plain text
11731 #: build/C/man4/ttyS.4:41
11732 msgid "mknod -m 660 /dev/ttyS3 c 4 67 # base address 0x2e8"
11733 msgstr ""
11734
11735 #. type: Plain text
11736 #: build/C/man4/ttyS.4:43
11737 msgid "chown root:tty /dev/ttyS[0-3]"
11738 msgstr ""
11739
11740 #. type: Plain text
11741 #: build/C/man4/ttyS.4:46
11742 msgid "/dev/ttyS[0-3]"
11743 msgstr ""
11744
11745 #. type: Plain text
11746 #: build/C/man4/ttyS.4:53
11747 msgid ""
11748 "B<chown>(1), B<mknod>(1), B<tty>(4), B<agetty>(8), B<mingetty>(8), "
11749 "B<setserial>(8)"
11750 msgstr ""
11751
11752 #. type: TH
11753 #: build/C/man7/uri.7:47
11754 #, no-wrap
11755 msgid "URI"
11756 msgstr ""
11757
11758 #. type: TH
11759 #: build/C/man7/uri.7:47
11760 #, no-wrap
11761 msgid "2000-03-14"
11762 msgstr ""
11763
11764 #. type: Plain text
11765 #: build/C/man7/uri.7:50
11766 msgid "uri, url, urn - uniform resource identifier (URI), including a URL or URN"
11767 msgstr ""
11768
11769 #. type: Plain text
11770 #: build/C/man7/uri.7:54
11771 #, no-wrap
11772 msgid "URI = [ absoluteURI | relativeURI ] [ \"#\" fragment ]\n"
11773 msgstr ""
11774
11775 #. type: Plain text
11776 #: build/C/man7/uri.7:56
11777 #, no-wrap
11778 msgid "absoluteURI = scheme \":\" ( hierarchical_part | opaque_part )\n"
11779 msgstr ""
11780
11781 #. type: Plain text
11782 #: build/C/man7/uri.7:58
11783 #, no-wrap
11784 msgid "relativeURI = ( net_path | absolute_path | relative_path ) [ \"?\" query ]\n"
11785 msgstr ""
11786
11787 #. type: Plain text
11788 #: build/C/man7/uri.7:61
11789 #, no-wrap
11790 msgid ""
11791 "scheme = \"http\" | \"ftp\" | \"gopher\" | \"mailto\" | \"news\" | "
11792 "\"telnet\" |\n"
11793 "         \"file\" | \"man\" | \"info\" | \"whatis\" | \"ldap\" | \"wais\" | "
11794 "\\&...\n"
11795 msgstr ""
11796
11797 #. type: Plain text
11798 #: build/C/man7/uri.7:63
11799 #, no-wrap
11800 msgid "hierarchical_part = ( net_path | absolute_path ) [ \"?\" query ]\n"
11801 msgstr ""
11802
11803 #. type: Plain text
11804 #: build/C/man7/uri.7:65
11805 #, no-wrap
11806 msgid "net_path = \"//\" authority [ absolute_path ]\n"
11807 msgstr ""
11808
11809 #. type: Plain text
11810 #: build/C/man7/uri.7:67
11811 #, no-wrap
11812 msgid "absolute_path = \"/\"  path_segments\n"
11813 msgstr ""
11814
11815 #. type: Plain text
11816 #: build/C/man7/uri.7:69
11817 #, no-wrap
11818 msgid "relative_path = relative_segment [ absolute_path ]\n"
11819 msgstr ""
11820
11821 #. type: Plain text
11822 #: build/C/man7/uri.7:81
11823 msgid ""
11824 "A Uniform Resource Identifier (URI) is a short string of characters "
11825 "identifying an abstract or physical resource (for example, a web page).  A "
11826 "Uniform Resource Locator (URL) is a URI that identifies a resource through "
11827 "its primary access mechanism (e.g., its network \"location\"), rather than "
11828 "by name or some other attribute of that resource.  A Uniform Resource Name "
11829 "(URN) is a URI that must remain globally unique and persistent even when the "
11830 "resource ceases to exist or becomes unavailable."
11831 msgstr ""
11832
11833 #. type: Plain text
11834 #: build/C/man7/uri.7:88
11835 msgid ""
11836 "URIs are the standard way to name hypertext link destinations for tools such "
11837 "as web browsers.  The string \"http://www.kernelnotes.org\" is a URL (and "
11838 "thus it is also a URI).  Many people use the term URL loosely as a synonym "
11839 "for URI (though technically URLs are a subset of URIs)."
11840 msgstr ""
11841
11842 #. type: Plain text
11843 #: build/C/man7/uri.7:104
11844 msgid ""
11845 "URIs can be absolute or relative.  An absolute identifier refers to a "
11846 "resource independent of context, while a relative identifier refers to a "
11847 "resource by describing the difference from the current context.  Within a "
11848 "relative path reference, the complete path segments \".\" and \"..\" have "
11849 "special meanings: \"the current hierarchy level\" and \"the level above this "
11850 "hierarchy level\", respectively, just like they do in UNIX-like systems.  A "
11851 "path segment which contains a colon character can't be used as the first "
11852 "segment of a relative URI path (e.g., \"this:that\"), because it would be "
11853 "mistaken for a scheme name; precede such segments with ./ (e.g., "
11854 "\"./this:that\").  Note that descendants of MS-DOS (e.g., Microsoft Windows) "
11855 "replace devicename colons with the vertical bar (\"|\") in URIs, so \"C:\" "
11856 "becomes \"C|\"."
11857 msgstr ""
11858
11859 #. type: Plain text
11860 #: build/C/man7/uri.7:108
11861 msgid ""
11862 "A fragment identifier, if included, refers to a particular named portion "
11863 "(fragment) of a resource; text after a \\(aq#\\(aq identifies the fragment.  "
11864 "A URI beginning with \\(aq#\\(aq refers to that fragment in the current "
11865 "resource."
11866 msgstr ""
11867
11868 #. type: Plain text
11869 #: build/C/man7/uri.7:116
11870 msgid ""
11871 "There are many different URI schemes, each with specific additional rules "
11872 "and meanings, but they are intentionally made to be as similar as possible.  "
11873 "For example, many URL schemes permit the authority to be the following "
11874 "format, called here an I<ip_server> (square brackets show what's optional):"
11875 msgstr ""
11876
11877 #. type: Plain text
11878 #: build/C/man7/uri.7:118
11879 msgid "I<ip_server = >[I<user> [ : I<password> ] @ ] I<host> [ : I<port>]"
11880 msgstr ""
11881
11882 #. type: Plain text
11883 #: build/C/man7/uri.7:134
11884 msgid ""
11885 "This format allows you to optionally insert a username, a user plus "
11886 "password, and/or a port number.  The I<host> is the name of the host "
11887 "computer, either its name as determined by DNS or an IP address (numbers "
11888 "separated by periods).  Thus the URI "
11889 "E<lt>http://fred:fredpassword@xyz.com:8080/E<gt> logs into a web server on "
11890 "host xyz.com as fred (using fredpassword) using port 8080.  Avoid including "
11891 "a password in a URI if possible because of the many security risks of having "
11892 "a password written down.  If the URL supplies a username but no password, "
11893 "and the remote server requests a password, the program interpreting the URL "
11894 "should request one from the user."
11895 msgstr ""
11896
11897 #. type: Plain text
11898 #: build/C/man7/uri.7:139
11899 msgid ""
11900 "Here are some of the most common schemes in use on UNIX-like systems that "
11901 "are understood by many tools.  Note that many tools using URIs also have "
11902 "internal schemes or specialized schemes; see those tools' documentation for "
11903 "information on those schemes."
11904 msgstr ""
11905
11906 #. type: Plain text
11907 #: build/C/man7/uri.7:141
11908 msgid "B<http - Web (HTTP) server>"
11909 msgstr ""
11910
11911 #. type: Plain text
11912 #: build/C/man7/uri.7:143
11913 msgid "http://I<ip_server>/I<path>"
11914 msgstr ""
11915
11916 #. type: Plain text
11917 #: build/C/man7/uri.7:145
11918 msgid "http://I<ip_server>/I<path>?I<query>"
11919 msgstr ""
11920
11921 #. type: Plain text
11922 #: build/C/man7/uri.7:153
11923 msgid ""
11924 "This is a URL accessing a web (HTTP) server.  The default port is 80.  If "
11925 "the path refers to a directory, the web server will choose what to return; "
11926 "usually if there is a file named \"index.html\" or \"index.htm\" its content "
11927 "is returned, otherwise, a list of the files in the current directory (with "
11928 "appropriate links) is generated and returned.  An example is "
11929 "E<lt>http://lwn.netE<gt>."
11930 msgstr ""
11931
11932 #. type: Plain text
11933 #: build/C/man7/uri.7:174
11934 msgid ""
11935 "A query can be given in the archaic \"isindex\" format, consisting of a word "
11936 "or phrase and not including an equal sign (=).  A query can also be in the "
11937 "longer \"GET\" format, which has one or more query entries of the form "
11938 "I<key>=I<value> separated by the ampersand character (&).  Note that I<key> "
11939 "can be repeated more than once, though it's up to the web server and its "
11940 "application programs to determine if there's any meaning to that.  There is "
11941 "an unfortunate interaction with HTML/XML/SGML and the GET query format; when "
11942 "such URIs with more than one key are embedded in SGML/XML documents "
11943 "(including HTML), the ampersand (&) has to be rewritten as &amp;.  Note that "
11944 "not all queries use this format; larger forms may be too long to store as a "
11945 "URI, so they use a different interaction mechanism (called POST) which does "
11946 "not include the data in the URI.  See the Common Gateway Interface "
11947 "specification at E<lt>http://www.w3.org/CGIE<gt> for more information."
11948 msgstr ""
11949
11950 #. type: Plain text
11951 #: build/C/man7/uri.7:176
11952 msgid "B<ftp - File Transfer Protocol (FTP)>"
11953 msgstr ""
11954
11955 #. type: Plain text
11956 #: build/C/man7/uri.7:178
11957 msgid "ftp://I<ip_server>/I<path>"
11958 msgstr ""
11959
11960 #. type: Plain text
11961 #: build/C/man7/uri.7:186
11962 msgid ""
11963 "This is a URL accessing a file through the file transfer protocol (FTP).  "
11964 "The default port (for control) is 21.  If no username is included, the "
11965 "username \"anonymous\" is supplied, and in that case many clients provide as "
11966 "the password the requestor's Internet email address.  An example is "
11967 "E<lt>ftp://ftp.is.co.za/rfc/rfc1808.txtE<gt>."
11968 msgstr ""
11969
11970 #. type: Plain text
11971 #: build/C/man7/uri.7:188
11972 msgid "B<gopher - Gopher server>"
11973 msgstr ""
11974
11975 #. type: Plain text
11976 #: build/C/man7/uri.7:190
11977 msgid "gopher://I<ip_server>/I<gophertype selector>"
11978 msgstr ""
11979
11980 #. type: Plain text
11981 #: build/C/man7/uri.7:192
11982 msgid "gopher://I<ip_server>/I<gophertype selector>%09I<search>"
11983 msgstr ""
11984
11985 #. type: Plain text
11986 #: build/C/man7/uri.7:194
11987 msgid "gopher://I<ip_server>/I<gophertype selector>%09I<search>%09I<gopher+_string>"
11988 msgstr ""
11989
11990 #. type: Plain text
11991 #: build/C/man7/uri.7:204
11992 msgid ""
11993 "The default gopher port is 70.  I<gophertype> is a single-character field to "
11994 "denote the Gopher type of the resource to which the URL refers.  The entire "
11995 "path may also be empty, in which case the delimiting \"/\" is also optional "
11996 "and the gophertype defaults to \"1\"."
11997 msgstr ""
11998
11999 #. type: Plain text
12000 #: build/C/man7/uri.7:211
12001 msgid ""
12002 "I<selector> is the Gopher selector string.  In the Gopher protocol, Gopher "
12003 "selector strings are a sequence of octets which may contain any octets "
12004 "except 09 hexadecimal (US-ASCII HT or tab), 0A hexadecimal (US-ASCII "
12005 "character LF), and 0D (US-ASCII character CR)."
12006 msgstr ""
12007
12008 #. type: Plain text
12009 #: build/C/man7/uri.7:213
12010 msgid "B<mailto - Email address>"
12011 msgstr ""
12012
12013 #. type: Plain text
12014 #: build/C/man7/uri.7:215
12015 msgid "mailto:I<email-address>"
12016 msgstr ""
12017
12018 #. type: Plain text
12019 #: build/C/man7/uri.7:223
12020 msgid ""
12021 "This is an email address, usually of the form I<name>@I<hostname>.  See "
12022 "B<mailaddr>(7)  for more information on the correct format of an email "
12023 "address.  Note that any % character must be rewritten as %25.  An example is "
12024 "E<lt>mailto:dwheeler@dwheeler.comE<gt>."
12025 msgstr ""
12026
12027 #. type: Plain text
12028 #: build/C/man7/uri.7:225
12029 msgid "B<news - Newsgroup or News message>"
12030 msgstr ""
12031
12032 #. type: Plain text
12033 #: build/C/man7/uri.7:227
12034 msgid "news:I<newsgroup-name>"
12035 msgstr ""
12036
12037 #. type: Plain text
12038 #: build/C/man7/uri.7:229
12039 msgid "news:I<message-id>"
12040 msgstr ""
12041
12042 #. type: Plain text
12043 #: build/C/man7/uri.7:237
12044 msgid ""
12045 "A I<newsgroup-name> is a period-delimited hierarchical name, such as "
12046 "\"comp.infosystems.www.misc\".  If E<lt>newsgroup-nameE<gt> is \"*\" (as in "
12047 "E<lt>news:*E<gt>), it is used to refer to \"all available news groups\".  An "
12048 "example is E<lt>news:comp.lang.adaE<gt>."
12049 msgstr ""
12050
12051 #. type: Plain text
12052 #: build/C/man7/uri.7:241
12053 msgid "A I<message-id> corresponds to the Message-ID of"
12054 msgstr ""
12055
12056 #. type: UR
12057 #: build/C/man7/uri.7:241
12058 #, no-wrap
12059 msgid "http://www.ietf.org/rfc/rfc1036.txt"
12060 msgstr ""
12061
12062 #. type: Plain text
12063 #: build/C/man7/uri.7:243
12064 msgid "IETF RFC\\ 1036,"
12065 msgstr ""
12066
12067 #. type: Plain text
12068 #: build/C/man7/uri.7:249
12069 msgid ""
12070 "without the enclosing \"E<lt>\" and \"E<gt>\"; it takes the form "
12071 "I<unique>@I<full_domain_name>.  A message identifier may be distinguished "
12072 "from a news group name by the presence of the \"@\" character."
12073 msgstr ""
12074
12075 #. type: Plain text
12076 #: build/C/man7/uri.7:251
12077 msgid "B<telnet - Telnet login>"
12078 msgstr ""
12079
12080 #. type: Plain text
12081 #: build/C/man7/uri.7:253
12082 msgid "telnet://I<ip_server>/"
12083 msgstr ""
12084
12085 #. type: Plain text
12086 #: build/C/man7/uri.7:259
12087 msgid ""
12088 "The Telnet URL scheme is used to designate interactive text services that "
12089 "may be accessed by the Telnet protocol.  The final \"/\" character may be "
12090 "omitted.  The default port is 23.  An example is "
12091 "E<lt>telnet://melvyl.ucop.edu/E<gt>."
12092 msgstr ""
12093
12094 #. type: Plain text
12095 #: build/C/man7/uri.7:261
12096 msgid "B<file - Normal file>"
12097 msgstr ""
12098
12099 #. type: Plain text
12100 #: build/C/man7/uri.7:263
12101 msgid "file://I<ip_server>/I<path_segments>"
12102 msgstr ""
12103
12104 #. type: Plain text
12105 #: build/C/man7/uri.7:265
12106 msgid "file:I<path_segments>"
12107 msgstr ""
12108
12109 #. type: Plain text
12110 #: build/C/man7/uri.7:282
12111 msgid ""
12112 "This represents a file or directory accessible locally.  As a special case, "
12113 "I<host> can be the string \"localhost\" or the empty string; this is "
12114 "interpreted as \"the machine from which the URL is being interpreted\".  If "
12115 "the path is to a directory, the viewer should display the directory's "
12116 "contents with links to each containee; not all viewers currently do this.  "
12117 "KDE supports generated files through the URL E<lt>file:/cgi-binE<gt>.  If "
12118 "the given file isn't found, browser writers may want to try to expand the "
12119 "filename via filename globbing (see B<glob>(7)  and B<glob>(3))."
12120 msgstr ""
12121
12122 #. type: Plain text
12123 #: build/C/man7/uri.7:296
12124 msgid ""
12125 "The second format (e.g., E<lt>file:/etc/passwdE<gt>)  is a correct format "
12126 "for referring to a local file.  However, older standards did not permit this "
12127 "format, and some programs don't recognize this as a URI.  A more portable "
12128 "syntax is to use an empty string as the server name, for example, "
12129 "E<lt>file:///etc/passwdE<gt>; this form does the same thing and is easily "
12130 "recognized by pattern matchers and older programs as a URI.  Note that if "
12131 "you really mean to say \"start from the current location,\" don't specify "
12132 "the scheme at all; use a relative address like E<lt>../test.txtE<gt>, which "
12133 "has the side-effect of being scheme-independent.  An example of this scheme "
12134 "is E<lt>file:///etc/passwdE<gt>."
12135 msgstr ""
12136
12137 #. type: Plain text
12138 #: build/C/man7/uri.7:298
12139 msgid "B<man - Man page documentation>"
12140 msgstr ""
12141
12142 #. type: Plain text
12143 #: build/C/man7/uri.7:300
12144 msgid "man:I<command-name>"
12145 msgstr ""
12146
12147 #. type: Plain text
12148 #: build/C/man7/uri.7:302
12149 msgid "man:I<command-name>(I<section>)"
12150 msgstr ""
12151
12152 #. type: Plain text
12153 #: build/C/man7/uri.7:311
12154 msgid ""
12155 "This refers to local online manual (man) reference pages.  The command name "
12156 "can optionally be followed by a parenthesis and section number; see "
12157 "B<man>(7)  for more information on the meaning of the section numbers.  This "
12158 "URI scheme is unique to UNIX-like systems (such as Linux)  and is not "
12159 "currently registered by the IETF.  An example is E<lt>man:ls(1)E<gt>."
12160 msgstr ""
12161
12162 #. type: Plain text
12163 #: build/C/man7/uri.7:313
12164 msgid "B<info - Info page documentation>"
12165 msgstr ""
12166
12167 #. type: Plain text
12168 #: build/C/man7/uri.7:315
12169 msgid "info:I<virtual-filename>"
12170 msgstr ""
12171
12172 #. type: Plain text
12173 #: build/C/man7/uri.7:317
12174 msgid "info:I<virtual-filename>#I<nodename>"
12175 msgstr ""
12176
12177 #. type: Plain text
12178 #: build/C/man7/uri.7:319
12179 msgid "info:(I<virtual-filename>)"
12180 msgstr ""
12181
12182 #. type: Plain text
12183 #: build/C/man7/uri.7:321
12184 msgid "info:(I<virtual-filename>)I<nodename>"
12185 msgstr ""
12186
12187 #. type: Plain text
12188 #: build/C/man7/uri.7:340
12189 msgid ""
12190 "This scheme refers to online info reference pages (generated from texinfo "
12191 "files), a documentation format used by programs such as the GNU tools.  This "
12192 "URI scheme is unique to UNIX-like systems (such as Linux)  and is not "
12193 "currently registered by the IETF.  As of this writing, GNOME and KDE differ "
12194 "in their URI syntax and do not accept the other's syntax.  The first two "
12195 "formats are the GNOME format; in nodenames all spaces are written as "
12196 "underscores.  The second two formats are the KDE format; spaces in nodenames "
12197 "must be written as spaces, even though this is forbidden by the URI "
12198 "standards.  It's hoped that in the future most tools will understand all of "
12199 "these formats and will always accept underscores for spaces in nodenames.  "
12200 "In both GNOME and KDE, if the form without the nodename is used the nodename "
12201 "is assumed to be \"Top\".  Examples of the GNOME format are "
12202 "E<lt>info:gccE<gt> and E<lt>info:gcc#G++_and_GCCE<gt>.  Examples of the KDE "
12203 "format are E<lt>info:(gcc)E<gt> and E<lt>info:(gcc)G++ and GCCE<gt>."
12204 msgstr ""
12205
12206 #. type: Plain text
12207 #: build/C/man7/uri.7:342
12208 msgid "B<whatis - Documentation search>"
12209 msgstr ""
12210
12211 #. type: Plain text
12212 #: build/C/man7/uri.7:344
12213 msgid "whatis:I<string>"
12214 msgstr ""
12215
12216 #. type: Plain text
12217 #: build/C/man7/uri.7:352
12218 msgid ""
12219 "This scheme searches the database of short (one-line) descriptions of "
12220 "commands and returns a list of descriptions containing that string.  Only "
12221 "complete word matches are returned.  See B<whatis>(1).  This URI scheme is "
12222 "unique to UNIX-like systems (such as Linux)  and is not currently registered "
12223 "by the IETF."
12224 msgstr ""
12225
12226 #. type: Plain text
12227 #: build/C/man7/uri.7:354
12228 msgid "B<ghelp - GNOME help documentation>"
12229 msgstr ""
12230
12231 #. type: Plain text
12232 #: build/C/man7/uri.7:356
12233 msgid "ghelp:I<name-of-application>"
12234 msgstr ""
12235
12236 #. type: Plain text
12237 #: build/C/man7/uri.7:359
12238 msgid ""
12239 "This loads GNOME help for the given application.  Note that not much "
12240 "documentation currently exists in this format."
12241 msgstr ""
12242
12243 #. type: Plain text
12244 #: build/C/man7/uri.7:361
12245 msgid "B<ldap - Lightweight Directory Access Protocol>"
12246 msgstr ""
12247
12248 #. type: Plain text
12249 #: build/C/man7/uri.7:363
12250 msgid "ldap://I<hostport>"
12251 msgstr ""
12252
12253 #. type: Plain text
12254 #: build/C/man7/uri.7:365
12255 msgid "ldap://I<hostport>/"
12256 msgstr ""
12257
12258 #. type: Plain text
12259 #: build/C/man7/uri.7:367
12260 msgid "ldap://I<hostport>/I<dn>"
12261 msgstr ""
12262
12263 #. type: Plain text
12264 #: build/C/man7/uri.7:369
12265 msgid "ldap://I<hostport>/I<dn>?I<attributes>"
12266 msgstr ""
12267
12268 #. type: Plain text
12269 #: build/C/man7/uri.7:371
12270 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>"
12271 msgstr ""
12272
12273 #. type: Plain text
12274 #: build/C/man7/uri.7:373
12275 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>?I<filter>"
12276 msgstr ""
12277
12278 #. type: Plain text
12279 #: build/C/man7/uri.7:375
12280 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>?I<filter>?I<extensions>"
12281 msgstr ""
12282
12283 #. type: Plain text
12284 #: build/C/man7/uri.7:381
12285 msgid ""
12286 "This scheme supports queries to the Lightweight Directory Access Protocol "
12287 "(LDAP), a protocol for querying a set of servers for hierarchically "
12288 "organized information (such as people and computing resources).  More "
12289 "information on the LDAP URL scheme is available in"
12290 msgstr ""
12291
12292 #. type: UR
12293 #: build/C/man7/uri.7:381 build/C/man7/uri.7:704
12294 #, no-wrap
12295 msgid "http://www.ietf.org/rfc/rfc2255.txt"
12296 msgstr ""
12297
12298 #. type: Plain text
12299 #: build/C/man7/uri.7:383
12300 msgid "RFC\\ 2255."
12301 msgstr ""
12302
12303 #. type: Plain text
12304 #: build/C/man7/uri.7:385
12305 msgid "The components of this URL are:"
12306 msgstr ""
12307
12308 #. type: IP
12309 #: build/C/man7/uri.7:385
12310 #, no-wrap
12311 msgid "hostport"
12312 msgstr ""
12313
12314 #. type: Plain text
12315 #: build/C/man7/uri.7:390
12316 msgid ""
12317 "the LDAP server to query, written as a hostname optionally followed by a "
12318 "colon and the port number.  The default LDAP port is TCP port 389.  If "
12319 "empty, the client determines which the LDAP server to use."
12320 msgstr ""
12321
12322 #. type: IP
12323 #: build/C/man7/uri.7:390
12324 #, no-wrap
12325 msgid "dn"
12326 msgstr ""
12327
12328 #. type: Plain text
12329 #: build/C/man7/uri.7:393
12330 msgid ""
12331 "the LDAP Distinguished Name, which identifies the base object of the LDAP "
12332 "search (see"
12333 msgstr ""
12334
12335 #. type: UR
12336 #: build/C/man7/uri.7:393
12337 #, no-wrap
12338 msgid "http://www.ietf.org/rfc/rfc2253.txt"
12339 msgstr ""
12340
12341 #. type: Plain text
12342 #: build/C/man7/uri.7:395
12343 msgid "RFC\\ 2253"
12344 msgstr ""
12345
12346 #. type: Plain text
12347 #: build/C/man7/uri.7:397
12348 msgid "section 3)."
12349 msgstr ""
12350
12351 #. type: IP
12352 #: build/C/man7/uri.7:397
12353 #, no-wrap
12354 msgid "attributes"
12355 msgstr ""
12356
12357 #. type: Plain text
12358 #: build/C/man7/uri.7:401
12359 msgid ""
12360 "a comma-separated list of attributes to be returned; see RFC\\ 2251 section "
12361 "4.1.5.  If omitted, all attributes should be returned."
12362 msgstr ""
12363
12364 #. type: IP
12365 #: build/C/man7/uri.7:401
12366 #, no-wrap
12367 msgid "scope"
12368 msgstr ""
12369
12370 #. type: Plain text
12371 #: build/C/man7/uri.7:406
12372 msgid ""
12373 "specifies the scope of the search, which can be one of \"base\" (for a base "
12374 "object search), \"one\" (for a one-level search), or \"sub\" (for a subtree "
12375 "search).  If scope is omitted, \"base\" is assumed."
12376 msgstr ""
12377
12378 #. type: IP
12379 #: build/C/man7/uri.7:406
12380 #, no-wrap
12381 msgid "filter"
12382 msgstr ""
12383
12384 #. type: Plain text
12385 #: build/C/man7/uri.7:411
12386 msgid ""
12387 "specifies the search filter (subset of entries to return).  If omitted, all "
12388 "entries should be returned.  See"
12389 msgstr ""
12390
12391 #. type: UR
12392 #: build/C/man7/uri.7:411
12393 #, no-wrap
12394 msgid "http://www.ietf.org/rfc/rfc2254.txt"
12395 msgstr ""
12396
12397 #. type: Plain text
12398 #: build/C/man7/uri.7:413
12399 msgid "RFC\\ 2254"
12400 msgstr ""
12401
12402 #. type: Plain text
12403 #: build/C/man7/uri.7:415
12404 msgid "section 4."
12405 msgstr ""
12406
12407 #. type: IP
12408 #: build/C/man7/uri.7:415
12409 #, no-wrap
12410 msgid "extensions"
12411 msgstr ""
12412
12413 #. type: Plain text
12414 #: build/C/man7/uri.7:421
12415 msgid ""
12416 "a comma-separated list of type=value pairs, where the =value portion may be "
12417 "omitted for options not requiring it.  An extension prefixed with a "
12418 "\\(aq!\\(aq is critical (must be supported to be valid), otherwise it is "
12419 "noncritical (optional)."
12420 msgstr ""
12421
12422 #. type: Plain text
12423 #: build/C/man7/uri.7:425
12424 msgid ""
12425 "LDAP queries are easiest to explain by example.  Here's a query that asks "
12426 "ldap.itd.umich.edu for information about the University of Michigan in the "
12427 "U.S.:"
12428 msgstr ""
12429
12430 #. type: Plain text
12431 #: build/C/man7/uri.7:428
12432 #, no-wrap
12433 msgid "ldap://ldap.itd.umich.edu/o=University%20of%20Michigan,c=US\n"
12434 msgstr ""
12435
12436 #. type: Plain text
12437 #: build/C/man7/uri.7:431
12438 msgid "To just get its postal address attribute, request:"
12439 msgstr ""
12440
12441 #. type: Plain text
12442 #: build/C/man7/uri.7:434
12443 #, no-wrap
12444 msgid "ldap://ldap.itd.umich.edu/o=University%20of%20Michigan,c=US?postalAddress\n"
12445 msgstr ""
12446
12447 #. type: Plain text
12448 #: build/C/man7/uri.7:438
12449 msgid ""
12450 "To ask a host.com at port 6666 for information about the person with common "
12451 "name (cn) \"Babs Jensen\" at University of Michigan, request:"
12452 msgstr ""
12453
12454 #. type: Plain text
12455 #: build/C/man7/uri.7:441
12456 #, no-wrap
12457 msgid "ldap://host.com:6666/o=University%20of%20Michigan,c=US??sub?(cn=Babs%20Jensen)\n"
12458 msgstr ""
12459
12460 #. type: Plain text
12461 #: build/C/man7/uri.7:444
12462 msgid "B<wais - Wide Area Information Servers>"
12463 msgstr ""
12464
12465 #. type: Plain text
12466 #: build/C/man7/uri.7:446
12467 msgid "wais://I<hostport>/I<database>"
12468 msgstr ""
12469
12470 #. type: Plain text
12471 #: build/C/man7/uri.7:448
12472 msgid "wais://I<hostport>/I<database>?I<search>"
12473 msgstr ""
12474
12475 #. type: Plain text
12476 #: build/C/man7/uri.7:450
12477 msgid "wais://I<hostport>/I<database>/I<wtype>/I<wpath>"
12478 msgstr ""
12479
12480 #. type: Plain text
12481 #: build/C/man7/uri.7:453
12482 msgid "This scheme designates a WAIS database, search, or document (see"
12483 msgstr ""
12484
12485 #. type: UR
12486 #: build/C/man7/uri.7:453
12487 #, no-wrap
12488 msgid "http://www.ietf.org/rfc/rfc1625.txt"
12489 msgstr ""
12490
12491 #. type: Plain text
12492 #: build/C/man7/uri.7:455
12493 msgid "IETF RFC\\ 1625"
12494 msgstr ""
12495
12496 #. type: Plain text
12497 #: build/C/man7/uri.7:459
12498 msgid ""
12499 "for more information on WAIS).  Hostport is the hostname, optionally "
12500 "followed by a colon and port number (the default port number is 210)."
12501 msgstr ""
12502
12503 #. type: Plain text
12504 #: build/C/man7/uri.7:469
12505 msgid ""
12506 "The first form designates a WAIS database for searching.  The second form "
12507 "designates a particular search of the WAIS database I<database>.  The third "
12508 "form designates a particular document within a WAIS database to be "
12509 "retrieved.  I<wtype> is the WAIS designation of the type of the object and "
12510 "I<wpath> is the WAIS document-id."
12511 msgstr ""
12512
12513 #. type: Plain text
12514 #: build/C/man7/uri.7:471
12515 msgid "B<other schemes>"
12516 msgstr ""
12517
12518 #. type: Plain text
12519 #: build/C/man7/uri.7:485
12520 msgid ""
12521 "There are many other URI schemes.  Most tools that accept URIs support a set "
12522 "of internal URIs (e.g., Mozilla has the about: scheme for internal "
12523 "information, and the GNOME help browser has the toc: scheme for various "
12524 "starting locations).  There are many schemes that have been defined but are "
12525 "not as widely used at the current time (e.g., prospero).  The nntp: scheme "
12526 "is deprecated in favor of the news: scheme.  URNs are to be supported by the "
12527 "urn: scheme, with a hierarchical name space (e.g., urn:ietf:... would "
12528 "identify IETF documents); at this time URNs are not widely implemented.  Not "
12529 "all tools support all schemes."
12530 msgstr ""
12531
12532 #. type: SS
12533 #: build/C/man7/uri.7:485
12534 #, no-wrap
12535 msgid "Character Encoding"
12536 msgstr ""
12537
12538 #. type: Plain text
12539 #: build/C/man7/uri.7:489
12540 msgid ""
12541 "URIs use a limited number of characters so that they can be typed in and "
12542 "used in a variety of situations."
12543 msgstr ""
12544
12545 #. type: Plain text
12546 #: build/C/man7/uri.7:493
12547 msgid ""
12548 "The following characters are reserved, that is, they may appear in a URI but "
12549 "their use is limited to their reserved purpose (conflicting data must be "
12550 "escaped before forming the URI):"
12551 msgstr ""
12552
12553 #. type: Plain text
12554 #: build/C/man7/uri.7:495
12555 #, no-wrap
12556 msgid "   ; / ? : @ & = + $ ,\n"
12557 msgstr ""
12558
12559 #. type: Plain text
12560 #: build/C/man7/uri.7:501
12561 msgid ""
12562 "Unreserved characters may be included in a URI.  Unreserved characters "
12563 "include upper and lower case English letters, decimal digits, and the "
12564 "following limited set of punctuation marks and symbols:"
12565 msgstr ""
12566
12567 #. type: Plain text
12568 #: build/C/man7/uri.7:503
12569 #, no-wrap
12570 msgid " - _ . ! ~ * ' ( )\n"
12571 msgstr ""
12572
12573 #. type: Plain text
12574 #: build/C/man7/uri.7:518
12575 msgid ""
12576 "All other characters must be escaped.  An escaped octet is encoded as a "
12577 "character triplet, consisting of the percent character \"%\" followed by the "
12578 "two hexadecimal digits representing the octet code (you can use upper or "
12579 "lower case letters for the hexadecimal digits).  For example, a blank space "
12580 "must be escaped as \"%20\", a tab character as \"%09\", and the \"&\" as "
12581 "\"%26\".  Because the percent \"%\" character always has the reserved "
12582 "purpose of being the escape indicator, it must be escaped as \"%25\".  It is "
12583 "common practice to escape space characters as the plus symbol (+)  in query "
12584 "text; this practice isn't uniformly defined in the relevant RFCs (which "
12585 "recommend %20 instead) but any tool accepting URIs with query text should be "
12586 "prepared for them.  A URI is always shown in its \"escaped\" form."
12587 msgstr ""
12588
12589 #. type: Plain text
12590 #: build/C/man7/uri.7:524
12591 msgid ""
12592 "Unreserved characters can be escaped without changing the semantics of the "
12593 "URI, but this should not be done unless the URI is being used in a context "
12594 "that does not allow the unescaped character to appear.  For example, \"%7e\" "
12595 "is sometimes used instead of \"~\" in an HTTP URL path, but the two are "
12596 "equivalent for an HTTP URL."
12597 msgstr ""
12598
12599 #. type: Plain text
12600 #: build/C/man7/uri.7:528
12601 msgid ""
12602 "For URIs which must handle characters outside the US ASCII character set, "
12603 "the HTML 4.01 specification (section B.2) and IETF RFC\\ 2718 (section "
12604 "2.2.5) recommend the following approach:"
12605 msgstr ""
12606
12607 #. type: Plain text
12608 #: build/C/man7/uri.7:532
12609 msgid ""
12610 "translate the character sequences into UTF-8 (IETF RFC\\ 2279)\\(emsee "
12611 "B<utf-8>(7)\\(emand then"
12612 msgstr ""
12613
12614 #. type: Plain text
12615 #: build/C/man7/uri.7:535
12616 msgid ""
12617 "use the URI escaping mechanism, that is, use the %HH encoding for unsafe "
12618 "octets."
12619 msgstr ""
12620
12621 #. type: SS
12622 #: build/C/man7/uri.7:535
12623 #, no-wrap
12624 msgid "Writing a URI"
12625 msgstr ""
12626
12627 #. type: Plain text
12628 #: build/C/man7/uri.7:557
12629 msgid ""
12630 "When written, URIs should be placed inside double quotes (e.g., "
12631 "\"http://www.kernelnotes.org\"), enclosed in angle brackets (e.g., "
12632 "E<lt>http://lwn.netE<gt>), or placed on a line by themselves.  A warning for "
12633 "those who use double-quotes: B<never> move extraneous punctuation (such as "
12634 "the period ending a sentence or the comma in a list)  inside a URI, since "
12635 "this will change the value of the URI.  Instead, use angle brackets instead, "
12636 "or switch to a quoting system that never includes extraneous characters "
12637 "inside quotation marks.  This latter system, called the 'new' or 'logical' "
12638 "quoting system by \"Hart's Rules\" and the \"Oxford Dictionary for Writers "
12639 "and Editors\", is preferred practice in Great Britain and hackers worldwide "
12640 "(see the Jargon File's section on Hacker Writing Style, "
12641 "I<http://www.fwi.uva.nl/~mes/jargon/h/HackerWritingStyle.html>, for more "
12642 "information).  Older documents suggested inserting the prefix \"URL:\" just "
12643 "before the URI, but this form has never caught on."
12644 msgstr ""
12645
12646 #. type: Plain text
12647 #: build/C/man7/uri.7:579
12648 msgid ""
12649 "The URI syntax was designed to be unambiguous.  However, as URIs have become "
12650 "commonplace, traditional media (television, radio, newspapers, billboards, "
12651 "etc.) have increasingly used abbreviated URI references consisting of only "
12652 "the authority and path portions of the identified resource (e.g., "
12653 "E<lt>www.w3.org/AddressingE<gt>).  Such references are primarily intended "
12654 "for human interpretation rather than machine, with the assumption that "
12655 "context-based heuristics are sufficient to complete the URI (e.g., hostnames "
12656 "beginning with \"www\" are likely to have a URI prefix of \"http://\" and "
12657 "hostnames beginning with \"ftp\" likely to have a prefix of \"ftp://\").  "
12658 "Many client implementations heuristically resolve these references.  Such "
12659 "heuristics may change over time, particularly when new schemes are "
12660 "introduced.  Since an abbreviated URI has the same syntax as a relative URL "
12661 "path, abbreviated URI references cannot be used where relative URIs are "
12662 "permitted, and can only be used when there is no defined base (such as in "
12663 "dialog boxes).  Don't use abbreviated URIs as hypertext links inside a "
12664 "document; use the standard format as described here."
12665 msgstr ""
12666
12667 #. type: Plain text
12668 #: build/C/man7/uri.7:585
12669 msgid ""
12670 "I<http://www.ietf.org/rfc/rfc2396.txt> (IETF RFC\\ 2396), "
12671 "I<http://www.w3.org/TR/REC-html40> (HTML 4.0)."
12672 msgstr ""
12673
12674 #. type: Plain text
12675 #: build/C/man7/uri.7:591
12676 msgid ""
12677 "Any tool accepting URIs (e.g., a web browser) on a Linux system should be "
12678 "able to handle (directly or indirectly) all of the schemes described here, "
12679 "including the man: and info: schemes.  Handling them by invoking some other "
12680 "program is fine and in fact encouraged."
12681 msgstr ""
12682
12683 #. type: Plain text
12684 #: build/C/man7/uri.7:593
12685 msgid "Technically the fragment isn't part of the URI."
12686 msgstr ""
12687
12688 #. type: Plain text
12689 #: build/C/man7/uri.7:602
12690 msgid ""
12691 "For information on how to embed URIs (including URLs) in a data format, see "
12692 "documentation on that format.  HTML uses the format E<lt>A "
12693 "HREF=\"I<uri>\"E<gt> I<text> E<lt>/AE<gt>.  Texinfo files use the format "
12694 "@uref{I<uri>}.  Man and mdoc have the recently added UR macro, or just "
12695 "include the URI in the text (viewers should be able to detect :// as part of "
12696 "a URI)."
12697 msgstr ""
12698
12699 #. type: Plain text
12700 #: build/C/man7/uri.7:623
12701 msgid ""
12702 "The GNOME and KDE desktop environments currently vary in the URIs they "
12703 "accept, in particular in their respective help browsers.  To list man pages, "
12704 "GNOME uses E<lt>toc:manE<gt> while KDE uses E<lt>man:(index)E<gt>, and to "
12705 "list info pages, GNOME uses E<lt>toc:infoE<gt> while KDE uses "
12706 "E<lt>info:(dir)E<gt> (the author of this man page prefers the KDE approach "
12707 "here, though a more regular format would be even better).  In general, KDE "
12708 "uses E<lt>file:/cgi-bin/E<gt> as a prefix to a set of generated files.  KDE "
12709 "prefers documentation in HTML, accessed via the "
12710 "E<lt>file:/cgi-bin/helpindexE<gt>.  GNOME prefers the ghelp scheme to store "
12711 "and find documentation.  Neither browser handles file: references to "
12712 "directories at the time of this writing, making it difficult to refer to an "
12713 "entire directory with a browsable URI.  As noted above, these environments "
12714 "differ in how they handle the info: scheme, probably the most important "
12715 "variation.  It is expected that GNOME and KDE will converge to common URI "
12716 "formats, and a future version of this man page will describe the converged "
12717 "result.  Efforts to aid this convergence are encouraged."
12718 msgstr ""
12719
12720 #. type: SS
12721 #: build/C/man7/uri.7:623
12722 #, no-wrap
12723 msgid "Security"
12724 msgstr ""
12725
12726 #. type: Plain text
12727 #: build/C/man7/uri.7:633
12728 msgid ""
12729 "A URI does not in itself pose a security threat.  There is no general "
12730 "guarantee that a URL, which at one time located a given resource, will "
12731 "continue to do so.  Nor is there any guarantee that a URL will not locate a "
12732 "different resource at some later point in time; such a guarantee can only be "
12733 "obtained from the person(s) controlling that namespace and the resource in "
12734 "question."
12735 msgstr ""
12736
12737 #. type: Plain text
12738 #: build/C/man7/uri.7:648
12739 msgid ""
12740 "It is sometimes possible to construct a URL such that an attempt to perform "
12741 "a seemingly harmless operation, such as the retrieval of an entity "
12742 "associated with the resource, will in fact cause a possibly damaging remote "
12743 "operation to occur.  The unsafe URL is typically constructed by specifying a "
12744 "port number other than that reserved for the network protocol in question.  "
12745 "The client unwittingly contacts a site that is in fact running a different "
12746 "protocol.  The content of the URL contains instructions that, when "
12747 "interpreted according to this other protocol, cause an unexpected "
12748 "operation.  An example has been the use of a gopher URL to cause an "
12749 "unintended or impersonating message to be sent via a SMTP server."
12750 msgstr ""
12751
12752 #. type: Plain text
12753 #: build/C/man7/uri.7:652
12754 msgid ""
12755 "Caution should be used when using any URL that specifies a port number other "
12756 "than the default for the protocol, especially when it is a number within the "
12757 "reserved space."
12758 msgstr ""
12759
12760 #. type: Plain text
12761 #: build/C/man7/uri.7:660
12762 msgid ""
12763 "Care should be taken when a URI contains escaped delimiters for a given "
12764 "protocol (for example, CR and LF characters for telnet protocols) that these "
12765 "are not unescaped before transmission.  This might violate the protocol, but "
12766 "avoids the potential for such characters to be used to simulate an extra "
12767 "operation or parameter in that protocol, which might lead to an unexpected "
12768 "and possibly harmful remote operation to be performed."
12769 msgstr ""
12770
12771 #. type: Plain text
12772 #: build/C/man7/uri.7:666
12773 msgid ""
12774 "It is clearly unwise to use a URI that contains a password which is intended "
12775 "to be secret.  In particular, the use of a password within the \"userinfo\" "
12776 "component of a URI is strongly recommended against except in those rare "
12777 "cases where the \"password\" parameter is intended to be public."
12778 msgstr ""
12779
12780 #. type: Plain text
12781 #: build/C/man7/uri.7:688
12782 msgid ""
12783 "Documentation may be placed in a variety of locations, so there currently "
12784 "isn't a good URI scheme for general online documentation in arbitrary "
12785 "formats.  References of the form E<lt>file:///usr/doc/ZZZE<gt> don't work "
12786 "because different distributions and local installation requirements may "
12787 "place the files in different directories (it may be in /usr/doc, or "
12788 "/usr/local/doc, or /usr/share, or somewhere else).  Also, the directory ZZZ "
12789 "usually changes when a version changes (though filename globbing could "
12790 "partially overcome this).  Finally, using the file: scheme doesn't easily "
12791 "support people who dynamically load documentation from the Internet (instead "
12792 "of loading the files onto a local file system).  A future URI scheme may be "
12793 "added (e.g., \"userdoc:\") to permit programs to include cross-references to "
12794 "more detailed documentation without having to know the exact location of "
12795 "that documentation.  Alternatively, a future version of the file-system "
12796 "specification may specify file locations sufficiently so that the file: "
12797 "scheme will be able to locate documentation."
12798 msgstr ""
12799
12800 #. type: Plain text
12801 #: build/C/man7/uri.7:691
12802 msgid ""
12803 "Many programs and file formats don't include a way to incorporate or "
12804 "implement links using URIs."
12805 msgstr ""
12806
12807 #.  .SH AUTHOR
12808 #.  David A. Wheeler (dwheeler@dwheeler.com) wrote this man page.
12809 #. type: Plain text
12810 #: build/C/man7/uri.7:699
12811 msgid ""
12812 "Many programs can't handle all of these different URI formats; there should "
12813 "be a standard mechanism to load an arbitrary URI that automatically detects "
12814 "the users' environment (e.g., text or graphics, desktop environment, local "
12815 "user preferences, and currently executing tools) and invokes the right tool "
12816 "for any URI."
12817 msgstr ""
12818
12819 #. type: Plain text
12820 #: build/C/man7/uri.7:704
12821 msgid "B<lynx>(1), B<man2html>(1), B<mailaddr>(7), B<utf-8>(7),"
12822 msgstr ""
12823
12824 #. type: Plain text
12825 #: build/C/man7/uri.7:706
12826 msgid "IETF RFC\\ 2255"
12827 msgstr ""
12828
12829 #. type: TH
12830 #: build/C/man4/vcs.4:28
12831 #, no-wrap
12832 msgid "VCS"
12833 msgstr ""
12834
12835 #. type: TH
12836 #: build/C/man4/vcs.4:28
12837 #, no-wrap
12838 msgid "2007-12-17"
12839 msgstr ""
12840
12841 #. type: Plain text
12842 #: build/C/man4/vcs.4:31
12843 msgid "vcs, vcsa - virtual console memory"
12844 msgstr ""
12845
12846 #. type: Plain text
12847 #: build/C/man4/vcs.4:36
12848 msgid ""
12849 "I</dev/vcs0> is a character device with major number 7 and minor number 0, "
12850 "usually of mode 0644 and owner root.tty.  It refers to the memory of the "
12851 "currently displayed virtual console terminal."
12852 msgstr ""
12853
12854 #. type: Plain text
12855 #: build/C/man4/vcs.4:47
12856 msgid ""
12857 "I</dev/vcs[1-63]> are character devices for virtual console terminals, they "
12858 "have major number 7 and minor number 1 to 63, usually mode 0644 and owner "
12859 "root.tty.  I</dev/vcsa[0-63]> are the same, but using I<unsigned short>s (in "
12860 "host byte order) that include attributes, and prefixed with four bytes "
12861 "giving the screen dimensions and cursor position: I<lines>, I<columns>, "
12862 "I<x>, I<y>.  (I<x> = I<y> = 0 at the top left corner of the screen.)"
12863 msgstr ""
12864
12865 #. type: Plain text
12866 #: build/C/man4/vcs.4:59
12867 msgid ""
12868 "When a 512-character font is loaded, the 9th bit position can be fetched by "
12869 "applying the B<ioctl>(2)  B<VT_GETHIFONTMASK> operation (available in Linux "
12870 "kernels 2.6.18 and above)  on I</dev/tty[1-63]>; the value is returned in "
12871 "the I<unsigned short> pointed to by the third B<ioctl>(2)  argument."
12872 msgstr ""
12873
12874 #. type: Plain text
12875 #: build/C/man4/vcs.4:66
12876 msgid ""
12877 "These devices replace the screendump B<ioctl>(2)  operations of "
12878 "B<console>(4), so the system administrator can control access using file "
12879 "system permissions."
12880 msgstr ""
12881
12882 #. type: Plain text
12883 #: build/C/man4/vcs.4:68
12884 msgid "The devices for the first eight virtual consoles may be created by:"
12885 msgstr ""
12886
12887 #. type: Plain text
12888 #: build/C/man4/vcs.4:75
12889 #, no-wrap
12890 msgid ""
12891 "    for x in 0 1 2 3 4 5 6 7 8; do\n"
12892 "        mknod -m 644 /dev/vcs$x c 7 $x;\n"
12893 "        mknod -m 644 /dev/vcsa$x c 7 $[$x+128];\n"
12894 "    done\n"
12895 "    chown root:tty /dev/vcs*\n"
12896 msgstr ""
12897
12898 #. type: Plain text
12899 #: build/C/man4/vcs.4:80
12900 msgid "No B<ioctl>(2)  requests are supported."
12901 msgstr ""
12902
12903 #. type: Plain text
12904 #: build/C/man4/vcs.4:82
12905 msgid "/dev/vcs[0-63]"
12906 msgstr ""
12907
12908 #.  .SH AUTHOR
12909 #.  Andries Brouwer <aeb@cwi.nl>
12910 #. type: Plain text
12911 #: build/C/man4/vcs.4:86
12912 msgid "/dev/vcsa[0-63]"
12913 msgstr ""
12914
12915 #. type: Plain text
12916 #: build/C/man4/vcs.4:88
12917 msgid "Introduced with version 1.1.92 of the Linux kernel."
12918 msgstr ""
12919
12920 #. type: Plain text
12921 #: build/C/man4/vcs.4:95
12922 msgid ""
12923 "You may do a screendump on vt3 by switching to vt1 and typing I<cat "
12924 "/dev/vcs3 E<gt>foo>.  Note that the output does not contain newline "
12925 "characters, so some processing may be required, like in I<fold -w 81 "
12926 "/dev/vcs3 | lpr> or (horrors)  I<setterm -dump 3 -file /proc/self/fd/1>."
12927 msgstr ""
12928
12929 #. type: Plain text
12930 #: build/C/man4/vcs.4:97
12931 msgid "The I</dev/vcsa0> device is used for Braille support."
12932 msgstr ""
12933
12934 #. type: Plain text
12935 #: build/C/man4/vcs.4:101
12936 msgid ""
12937 "This program displays the character and screen attributes under the cursor "
12938 "of the second virtual console, then changes the background color there:"
12939 msgstr ""
12940
12941 #. type: Plain text
12942 #: build/C/man4/vcs.4:109
12943 #, no-wrap
12944 msgid ""
12945 "#include E<lt>unistd.hE<gt>\n"
12946 "#include E<lt>stdlib.hE<gt>\n"
12947 "#include E<lt>stdio.hE<gt>\n"
12948 "#include E<lt>fcntl.hE<gt>\n"
12949 "#include E<lt>sys/ioctl.hE<gt>\n"
12950 "#include E<lt>linux/vt.hE<gt>\n"
12951 msgstr ""
12952
12953 #. type: Plain text
12954 #: build/C/man4/vcs.4:120
12955 #, no-wrap
12956 msgid ""
12957 "int\n"
12958 "main(void)\n"
12959 "{\n"
12960 "    int fd;\n"
12961 "    char *device = \"/dev/vcsa2\";\n"
12962 "    char *console = \"/dev/tty2\";\n"
12963 "    struct {unsigned char lines, cols, x, y;} scrn;\n"
12964 "    unsigned short s;\n"
12965 "    unsigned short mask;\n"
12966 "    unsigned char ch, attrib;\n"
12967 msgstr ""
12968
12969 #. type: Plain text
12970 #: build/C/man4/vcs.4:149
12971 #, no-wrap
12972 msgid ""
12973 "    fd = open(console, O_RDWR);\n"
12974 "    if (fd E<lt> 0) {\n"
12975 "        perror(console);\n"
12976 "        exit(EXIT_FAILURE);\n"
12977 "    }\n"
12978 "    if (ioctl(fd, VT_GETHIFONTMASK, &mask) E<lt> 0) {\n"
12979 "        perror(\"VT_GETHIFONTMASK\");\n"
12980 "        exit(EXIT_FAILURE);\n"
12981 "    }\n"
12982 "    (void) close(fd);\n"
12983 "    fd = open(device, O_RDWR);\n"
12984 "    if (fd E<lt> 0) {\n"
12985 "        perror(device);\n"
12986 "        exit(EXIT_FAILURE);\n"
12987 "    }\n"
12988 "    (void) read(fd, &scrn, 4);\n"
12989 "    (void) lseek(fd, 4 + 2*(scrn.y*scrn.cols + scrn.x), 0);\n"
12990 "    (void) read(fd, &s, 2);\n"
12991 "    ch = s & 0xff;\n"
12992 "    if (attrib & mask)\n"
12993 "        ch |= 0x100;\n"
12994 "    attrib = ((s & ~mask) E<gt>E<gt> 8);\n"
12995 "    printf(\"ch=\\(aq%c\\(aq attrib=0x%02x\\en\", ch, attrib);\n"
12996 "    attrib ^= 0x10;\n"
12997 "    (void) lseek(fd, -1, 1);\n"
12998 "    (void) write(fd, &attrib, 1);\n"
12999 "    exit(EXIT_SUCCESS);\n"
13000 "}\n"
13001 msgstr ""
13002
13003 #. type: Plain text
13004 #: build/C/man4/vcs.4:155
13005 msgid "B<console>(4), B<tty>(4), B<ttyS>(4), B<gpm>(8)"
13006 msgstr ""
13007
13008 #. type: TH
13009 #: build/C/man4/wavelan.4:11
13010 #, no-wrap
13011 msgid "WAVELAN"
13012 msgstr ""
13013
13014 #. type: TH
13015 #: build/C/man4/wavelan.4:11
13016 #, no-wrap
13017 msgid "1996-10-22"
13018 msgstr ""
13019
13020 #. type: Plain text
13021 #: build/C/man4/wavelan.4:14
13022 msgid "wavelan - AT&T GIS WaveLAN ISA device driver"
13023 msgstr ""
13024
13025 #. type: Plain text
13026 #: build/C/man4/wavelan.4:16
13027 msgid ""
13028 "B<insmod wavelan_cs.o [io=>I<B,B..>B<] [ irq=>I<I,I..>B<] "
13029 "[name=>I<N,N..>B<]>"
13030 msgstr ""
13031
13032 #. type: Plain text
13033 #: build/C/man4/wavelan.4:32
13034 msgid ""
13035 "I<wavelan> is the low-level device driver for the NCR / AT&T / Lucent "
13036 "B<WaveLAN ISA> and Digital (DEC)  B<RoamAbout DS> wireless ethernet "
13037 "adapter.  This driver is available as a module or might be compiled in the "
13038 "kernel.  This driver supports multiple cards in both forms (up to 4) and "
13039 "allocates the next available ethernet device (eth0..eth#) for each card "
13040 "found, unless a device name is explicitly specified (see below).  This "
13041 "device name will be reported in the kernel log file with the MAC address, "
13042 "NWID and frequency used by the card."
13043 msgstr ""
13044
13045 #. type: Plain text
13046 #: build/C/man4/wavelan.4:39
13047 msgid ""
13048 "This section apply to the module form (parameters passed on the B<insmod>(8)  "
13049 "command line).  If the driver is included in the kernel, use the "
13050 "I<ether=IRQ,IO,NAME> syntax on the kernel command line."
13051 msgstr ""
13052
13053 #. type: TP
13054 #: build/C/man4/wavelan.4:39
13055 #, no-wrap
13056 msgid "B<io>"
13057 msgstr ""
13058
13059 #. type: Plain text
13060 #: build/C/man4/wavelan.4:46
13061 msgid ""
13062 "Specify the list of base address where to search for wavelan cards (setting "
13063 "by dip switch on the card).  If you don't specify any io address, the driver "
13064 "will scan 0x390 and 0x3E0 addresses, which might conflict with other "
13065 "hardware..."
13066 msgstr ""
13067
13068 #. type: TP
13069 #: build/C/man4/wavelan.4:46
13070 #, no-wrap
13071 msgid "B<irq>"
13072 msgstr ""
13073
13074 #. type: Plain text
13075 #: build/C/man4/wavelan.4:50
13076 msgid ""
13077 "Set the list of irq that each wavelan card should use (the value is saved in "
13078 "permanent storage for future use)."
13079 msgstr ""
13080
13081 #. type: TP
13082 #: build/C/man4/wavelan.4:50
13083 #, no-wrap
13084 msgid "B<name>"
13085 msgstr ""
13086
13087 #. type: Plain text
13088 #: build/C/man4/wavelan.4:55
13089 msgid ""
13090 "Set the list of name to be used for each wavelan cards device (name used by "
13091 "B<ifconfig>(8))."
13092 msgstr ""
13093
13094 #. type: SS
13095 #: build/C/man4/wavelan.4:55
13096 #, no-wrap
13097 msgid "Wireless Extensions"
13098 msgstr ""
13099
13100 #. type: Plain text
13101 #: build/C/man4/wavelan.4:59
13102 msgid "Use B<iwconfig>(8)  to manipulate wireless extensions."
13103 msgstr ""
13104
13105 #. type: SS
13106 #: build/C/man4/wavelan.4:59
13107 #, no-wrap
13108 msgid "NWID (or domain)"
13109 msgstr ""
13110
13111 #. type: Plain text
13112 #: build/C/man4/wavelan.4:68
13113 msgid ""
13114 "Set the network ID [I<0> to I<FFFF>] or disable it [I<off>].  As the NWID is "
13115 "stored in the card Permanent Storage Area, it will be reuse at any further "
13116 "invocation of the driver."
13117 msgstr ""
13118
13119 #. type: SS
13120 #: build/C/man4/wavelan.4:68
13121 #, no-wrap
13122 msgid "Frequency & channels"
13123 msgstr ""
13124
13125 #. type: Plain text
13126 #: build/C/man4/wavelan.4:79
13127 msgid ""
13128 "For the 2.4GHz 2.00 Hardware, you are able to set the frequency by "
13129 "specifying one of the 10 defined channels (I<2.412,> I<2.422, 2.425, 2.4305, "
13130 "2.432, 2.442, 2.452, 2.460, 2.462> or I<2.484>)  or directly by its value.  "
13131 "The frequency is changed immediately and permanently.  Frequency "
13132 "availability depends on the regulations..."
13133 msgstr ""
13134
13135 #. type: SS
13136 #: build/C/man4/wavelan.4:79
13137 #, no-wrap
13138 msgid "Statistics spy"
13139 msgstr ""
13140
13141 #. type: Plain text
13142 #: build/C/man4/wavelan.4:83
13143 msgid ""
13144 "Set a list of MAC addresses in the driver (up to 8) and get the last quality "
13145 "of link for each of those (see B<iwspy>(8))."
13146 msgstr ""
13147
13148 #. type: SS
13149 #: build/C/man4/wavelan.4:83
13150 #, no-wrap
13151 msgid "/proc/net/wireless"
13152 msgstr ""
13153
13154 #. type: Plain text
13155 #: build/C/man4/wavelan.4:98
13156 msgid ""
13157 "I<status> is the status reported by the modem.  I<Link quality> reports the "
13158 "quality of the modulation on the air (direct sequence spread spectrum) [max "
13159 "= 16].  I<Level> and I<Noise> refer to the signal level and noise level [max "
13160 "= 64].  The I<crypt discarded packet> and I<misc discarded packet> counters "
13161 "are not implemented."
13162 msgstr ""
13163
13164 #. type: SS
13165 #: build/C/man4/wavelan.4:98
13166 #, no-wrap
13167 msgid "Private Ioctl"
13168 msgstr ""
13169
13170 #. type: Plain text
13171 #: build/C/man4/wavelan.4:102
13172 msgid "You may use B<iwpriv>(8)  to manipulate private ioctls."
13173 msgstr ""
13174
13175 #. type: SS
13176 #: build/C/man4/wavelan.4:102
13177 #, no-wrap
13178 msgid "Quality and Level threshold"
13179 msgstr ""
13180
13181 #. type: Plain text
13182 #: build/C/man4/wavelan.4:105
13183 msgid ""
13184 "Enable you the define the quality and level threshold used by the modem "
13185 "(packet below that level are discarded)."
13186 msgstr ""
13187
13188 #. type: SS
13189 #: build/C/man4/wavelan.4:105
13190 #, no-wrap
13191 msgid "Histogram"
13192 msgstr ""
13193
13194 #. type: Plain text
13195 #: build/C/man4/wavelan.4:112
13196 msgid ""
13197 "This functionality makes it possible to set a number of signal level "
13198 "intervals and to count the number of packets received in each of those "
13199 "defined intervals.  This distribution might be used to calculate the mean "
13200 "value and standard deviation of the signal level."
13201 msgstr ""
13202
13203 #. type: SS
13204 #: build/C/man4/wavelan.4:112
13205 #, no-wrap
13206 msgid "Specific Notes"
13207 msgstr ""
13208
13209 #. type: Plain text
13210 #: build/C/man4/wavelan.4:118
13211 msgid ""
13212 "This driver will fail to detect some B<non-NCR/ATT&T/Lucent> Wavelan cards.  "
13213 "If this happens for you, you must look in the source code on how to add your "
13214 "card to the detection routine."
13215 msgstr ""
13216
13217 #.  .SH AUTHOR
13218 #.  Bruce Janson \(em bruce@cs.usyd.edu.au
13219 #.  .br
13220 #.  Jean Tourrilhes \(em jt@hplb.hpl.hp.com
13221 #.  .br
13222 #.  (and others; see source code for details)
13223 #
13224 #.  SEE ALSO part
13225 #. type: Plain text
13226 #: build/C/man4/wavelan.4:131
13227 msgid ""
13228 "Some of the mentioned features are optional.  You may enable to disable them "
13229 "by changing flags in the driver header and recompile."
13230 msgstr ""
13231
13232 #. type: Plain text
13233 #: build/C/man4/wavelan.4:138
13234 msgid ""
13235 "B<wavelan_cs>(4), B<ifconfig>(8), B<insmod>(8), B<iwconfig>(8), "
13236 "B<iwpriv>(8), B<iwspy>(8)"
13237 msgstr ""