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-28 07:17+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:129 build/C/man4/sk98lin.4:581 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:529
 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:533
 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:605 build/C/man4/st.4:952 build/C/man2/syslog.2:268 build/C/man3/syslog.3:315 build/C/man4/ttyS.4:46 build/C/man7/uri.7:700 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:135 build/C/man3/setlogmask.3:74 build/C/man4/sk98lin.4:609 build/C/man4/st.4:962 build/C/man3/stdarg.3:310 build/C/man2/syslog.2:271 build/C/man3/syslog.3:320 build/C/man4/ttyS.4:53 build/C/man7/uri.7:708 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:142 build/C/man3/setlogmask.3:81 build/C/man4/sk98lin.4:616 build/C/man4/st.4:969 build/C/man3/stdarg.3:317 build/C/man2/syslog.2:278 build/C/man3/syslog.3:327 build/C/man4/ttyS.4:60 build/C/man7/uri.7:715 build/C/man4/vcs.4:162 build/C/man4/wavelan.4:145
 672 msgid ""
 673 "This page is part of release 3.41 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, and so on.  In the "
 803 "tabular descriptions below, the second column gives ECMA-48 or DEC mnemonics "
 804 "(the latter if prefixed with DEC) for the given function.  Sequences without "
 805 "a 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 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 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 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:296 build/C/man7/uri.7:586
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:599 build/C/man3/stdarg.3:256 build/C/man7/uri.7:667
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
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:252 build/C/man7/uri.7:580
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
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: TH
6643 #: build/C/man3/makedev.3:24 build/C/man4/sk98lin.4:25
6644 #, no-wrap
6645 msgid "2012-05-10"
6646 msgstr ""
6647
6648 #. type: Plain text
6649 #: build/C/man3/makedev.3:27
6650 msgid "makedev, major, minor - manage a device number"
6651 msgstr ""
6652
6653 #. type: Plain text
6654 #: build/C/man3/makedev.3:31
6655 #, no-wrap
6656 msgid ""
6657 "B<#define _BSD_SOURCE>             /* See feature_test_macros(7) */\n"
6658 "B<#include E<lt>sys/types.hE<gt>>\n"
6659 msgstr ""
6660
6661 #. type: Plain text
6662 #: build/C/man3/makedev.3:33
6663 #, no-wrap
6664 msgid "B<dev_t makedev(int >I<maj>B<, int >I<min>B<);>\n"
6665 msgstr ""
6666
6667 #. type: Plain text
6668 #: build/C/man3/makedev.3:36
6669 #, no-wrap
6670 msgid ""
6671 "B<unsigned int major(dev_t >I<dev>B<);>\n"
6672 "B<unsigned int minor(dev_t >I<dev>B<);>\n"
6673 msgstr ""
6674
6675 #. type: Plain text
6676 #: build/C/man3/makedev.3:44
6677 msgid ""
6678 "A device ID consists of two parts: a major ID, identifying the class of the "
6679 "device, and a minor ID, identifying a specific instance of a device in that "
6680 "class.  A device ID is represented using the type I<dev_t>."
6681 msgstr ""
6682
6683 #. type: Plain text
6684 #: build/C/man3/makedev.3:51
6685 msgid ""
6686 "Given major and minor device IDs, B<makedev>()  combines these to produce a "
6687 "device ID, returned as the function result.  This device ID can be given to "
6688 "B<mknod>(2), for example."
6689 msgstr ""
6690
6691 #. type: Plain text
6692 #: build/C/man3/makedev.3:61
6693 msgid ""
6694 "The B<major>()  and B<minor>()  functions perform the converse task: given a "
6695 "device ID, they return, respectively, the major and minor components.  These "
6696 "macros can be useful to, for example, decompose the device IDs in the "
6697 "structure returned by B<stat>(2)."
6698 msgstr ""
6699
6700 #.  The BSDs, HP-UX, Solaris, AIX, Irix
6701 #. type: Plain text
6702 #: build/C/man3/makedev.3:70
6703 msgid ""
6704 "The B<makedev>(), B<major>(), and B<minor>()  functions are not specified in "
6705 "POSIX.1, but are present on many other systems."
6706 msgstr ""
6707
6708 #. type: Plain text
6709 #: build/C/man3/makedev.3:79
6710 msgid ""
6711 "These interfaces are defined as macros.  Since glibc 2.3.3, they have been "
6712 "aliases for three GNU-specific functions: B<gnu_dev_makedev>(), "
6713 "B<gnu_dev_major>(), and B<gnu_dev_minor>().  The latter names are exported, "
6714 "but the traditional names are more portable."
6715 msgstr ""
6716
6717 #. type: Plain text
6718 #: build/C/man3/makedev.3:82
6719 msgid "B<mknod>(2), B<stat>(2)"
6720 msgstr ""
6721
6722 #. type: TH
6723 #: build/C/man4/mem.4:25
6724 #, no-wrap
6725 msgid "MEM"
6726 msgstr ""
6727
6728 #. type: TH
6729 #: build/C/man4/mem.4:25 build/C/man4/ram.4:25
6730 #, no-wrap
6731 msgid "1992-11-21"
6732 msgstr ""
6733
6734 #. type: Plain text
6735 #: build/C/man4/mem.4:28
6736 msgid "mem, kmem, port - system memory, kernel memory and system ports"
6737 msgstr ""
6738
6739 #. type: Plain text
6740 #: build/C/man4/mem.4:32
6741 msgid ""
6742 "B<mem> is a character device file that is an image of the main memory of the "
6743 "computer.  It may be used, for example, to examine (and even patch) the "
6744 "system."
6745 msgstr ""
6746
6747 #. type: Plain text
6748 #: build/C/man4/mem.4:37
6749 msgid ""
6750 "Byte addresses in B<mem> are interpreted as physical memory addresses.  "
6751 "References to nonexistent locations cause errors to be returned."
6752 msgstr ""
6753
6754 #. type: Plain text
6755 #: build/C/man4/mem.4:40
6756 msgid ""
6757 "Examining and patching is likely to lead to unexpected results when "
6758 "read-only or write-only bits are present."
6759 msgstr ""
6760
6761 #. type: Plain text
6762 #: build/C/man4/mem.4:42 build/C/man4/mem.4:57 build/C/man4/mem.4:69 build/C/man4/ram.4:32
6763 msgid "It is typically created by:"
6764 msgstr ""
6765
6766 #. type: Plain text
6767 #: build/C/man4/mem.4:45
6768 msgid "mknod -m 660 /dev/mem c 1 1"
6769 msgstr ""
6770
6771 #. type: Plain text
6772 #: build/C/man4/mem.4:47
6773 msgid "chown root:kmem /dev/mem"
6774 msgstr ""
6775
6776 #. type: Plain text
6777 #: build/C/man4/mem.4:55
6778 msgid ""
6779 "The file B<kmem> is the same as B<mem>, except that the kernel virtual "
6780 "memory rather than physical memory is accessed."
6781 msgstr ""
6782
6783 #. type: Plain text
6784 #: build/C/man4/mem.4:60
6785 msgid "mknod -m 640 /dev/kmem c 1 2"
6786 msgstr ""
6787
6788 #. type: Plain text
6789 #: build/C/man4/mem.4:62
6790 msgid "chown root:kmem /dev/kmem"
6791 msgstr ""
6792
6793 #. type: Plain text
6794 #: build/C/man4/mem.4:67
6795 msgid "B<port> is similar to B<mem>, but the I/O ports are accessed."
6796 msgstr ""
6797
6798 #. type: Plain text
6799 #: build/C/man4/mem.4:72
6800 msgid "mknod -m 660 /dev/port c 1 4"
6801 msgstr ""
6802
6803 #. type: Plain text
6804 #: build/C/man4/mem.4:74
6805 msgid "chown root:mem /dev/port"
6806 msgstr ""
6807
6808 #. type: Plain text
6809 #: build/C/man4/mem.4:77
6810 msgid "I</dev/mem>"
6811 msgstr ""
6812
6813 #. type: Plain text
6814 #: build/C/man4/mem.4:79
6815 msgid "I</dev/kmem>"
6816 msgstr ""
6817
6818 #. type: Plain text
6819 #: build/C/man4/mem.4:81
6820 msgid "I</dev/port>"
6821 msgstr ""
6822
6823 #. type: Plain text
6824 #: build/C/man4/mem.4:85
6825 msgid "B<chown>(1), B<mknod>(1), B<ioperm>(2)"
6826 msgstr ""
6827
6828 #. type: TH
6829 #: build/C/man3/mkfifo.3:27
6830 #, no-wrap
6831 msgid "MKFIFO"
6832 msgstr ""
6833
6834 #. type: TH
6835 #: build/C/man3/mkfifo.3:27
6836 #, no-wrap
6837 msgid "2008-06-12"
6838 msgstr ""
6839
6840 #. type: TH
6841 #: build/C/man3/mkfifo.3:27
6842 #, no-wrap
6843 msgid "GNU"
6844 msgstr ""
6845
6846 #. type: Plain text
6847 #: build/C/man3/mkfifo.3:30
6848 msgid "mkfifo - make a FIFO special file (a named pipe)"
6849 msgstr ""
6850
6851 #. type: Plain text
6852 #: build/C/man3/mkfifo.3:34
6853 #, no-wrap
6854 msgid ""
6855 "B<#include E<lt>sys/types.hE<gt>>\n"
6856 "B<#include E<lt>sys/stat.hE<gt>>\n"
6857 msgstr ""
6858
6859 #. type: Plain text
6860 #: build/C/man3/mkfifo.3:36
6861 #, no-wrap
6862 msgid "B<int mkfifo(const char *>I<pathname>B<, mode_t >I<mode>B<);>\n"
6863 msgstr ""
6864
6865 #. type: Plain text
6866 #: build/C/man3/mkfifo.3:44
6867 msgid ""
6868 "B<mkfifo>()  makes a FIFO special file with name I<pathname>.  I<mode> "
6869 "specifies the FIFO's permissions.  It is modified by the process's B<umask> "
6870 "in the usual way: the permissions of the created file are B<(>I<mode>B< & "
6871 "~umask)>."
6872 msgstr ""
6873
6874 #. type: Plain text
6875 #: build/C/man3/mkfifo.3:51
6876 msgid ""
6877 "A FIFO special file is similar to a pipe, except that it is created in a "
6878 "different way.  Instead of being an anonymous communications channel, a FIFO "
6879 "special file is entered into the file system by calling B<mkfifo>()."
6880 msgstr ""
6881
6882 #. type: Plain text
6883 #: build/C/man3/mkfifo.3:61
6884 msgid ""
6885 "Once you have created a FIFO special file in this way, any process can open "
6886 "it for reading or writing, in the same way as an ordinary file.  However, it "
6887 "has to be open at both ends simultaneously before you can proceed to do any "
6888 "input or output operations on it.  Opening a FIFO for reading normally "
6889 "blocks until some other process opens the same FIFO for writing, and vice "
6890 "versa.  See B<fifo>(7)  for nonblocking handling of FIFO special files."
6891 msgstr ""
6892
6893 #. type: Plain text
6894 #: build/C/man3/mkfifo.3:67
6895 msgid ""
6896 "On success B<mkfifo>()  returns 0.  In the case of an error, -1 is returned "
6897 "(in which case, I<errno> is set appropriately)."
6898 msgstr ""
6899
6900 #. type: TP
6901 #: build/C/man3/mkfifo.3:68 build/C/man2/mknod.2:106 build/C/man4/st.4:828
6902 #, no-wrap
6903 msgid "B<EACCES>"
6904 msgstr ""
6905
6906 #. type: Plain text
6907 #: build/C/man3/mkfifo.3:72
6908 msgid ""
6909 "One of the directories in I<pathname> did not allow search (execute) "
6910 "permission."
6911 msgstr ""
6912
6913 #. type: TP
6914 #: build/C/man3/mkfifo.3:72 build/C/man2/mknod.2:114
6915 #, no-wrap
6916 msgid "B<EEXIST>"
6917 msgstr ""
6918
6919 #. type: Plain text
6920 #: build/C/man3/mkfifo.3:78 build/C/man2/mknod.2:121
6921 msgid ""
6922 "I<pathname> already exists.  This includes the case where I<pathname> is a "
6923 "symbolic link, dangling or not."
6924 msgstr ""
6925
6926 #. type: TP
6927 #: build/C/man3/mkfifo.3:78 build/C/man2/mknod.2:133
6928 #, no-wrap
6929 msgid "B<ENAMETOOLONG>"
6930 msgstr ""
6931
6932 #. type: Plain text
6933 #: build/C/man3/mkfifo.3:86
6934 msgid ""
6935 "Either the total length of I<pathname> is greater than B<PATH_MAX>, or an "
6936 "individual filename component has a length greater than B<NAME_MAX>.  In the "
6937 "GNU system, there is no imposed limit on overall filename length, but some "
6938 "file systems may place limits on the length of a component."
6939 msgstr ""
6940
6941 #. type: TP
6942 #: build/C/man3/mkfifo.3:86 build/C/man2/mknod.2:136
6943 #, no-wrap
6944 msgid "B<ENOENT>"
6945 msgstr ""
6946
6947 #. type: Plain text
6948 #: build/C/man3/mkfifo.3:90 build/C/man2/mknod.2:141
6949 msgid ""
6950 "A directory component in I<pathname> does not exist or is a dangling "
6951 "symbolic link."
6952 msgstr ""
6953
6954 #. type: TP
6955 #: build/C/man3/mkfifo.3:90 build/C/man2/mknod.2:144 build/C/man4/st.4:856
6956 #, no-wrap
6957 msgid "B<ENOSPC>"
6958 msgstr ""
6959
6960 #. type: Plain text
6961 #: build/C/man3/mkfifo.3:93
6962 msgid "The directory or file system has no room for the new file."
6963 msgstr ""
6964
6965 #. type: TP
6966 #: build/C/man3/mkfifo.3:93 build/C/man2/mknod.2:149
6967 #, no-wrap
6968 msgid "B<ENOTDIR>"
6969 msgstr ""
6970
6971 #. type: Plain text
6972 #: build/C/man3/mkfifo.3:97 build/C/man2/mknod.2:154
6973 msgid "A component used as a directory in I<pathname> is not, in fact, a directory."
6974 msgstr ""
6975
6976 #. type: TP
6977 #: build/C/man3/mkfifo.3:97 build/C/man2/mknod.2:168 build/C/man4/st.4:871
6978 #, no-wrap
6979 msgid "B<EROFS>"
6980 msgstr ""
6981
6982 #. type: Plain text
6983 #: build/C/man3/mkfifo.3:100
6984 msgid "I<pathname> refers to a read-only file system."
6985 msgstr ""
6986
6987 #. type: Plain text
6988 #: build/C/man3/mkfifo.3:102
6989 msgid "POSIX.1-2001."
6990 msgstr ""
6991
6992 #. type: Plain text
6993 #: build/C/man3/mkfifo.3:112
6994 msgid ""
6995 "B<mkfifo>(1), B<close>(2), B<open>(2), B<read>(2), B<stat>(2), B<umask>(2), "
6996 "B<write>(2), B<mkfifoat>(3), B<fifo>(7)"
6997 msgstr ""
6998
6999 #. type: TH
7000 #: build/C/man2/mknod.2:13
7001 #, no-wrap
7002 msgid "MKNOD"
7003 msgstr ""
7004
7005 #. type: TH
7006 #: build/C/man2/mknod.2:13
7007 #, no-wrap
7008 msgid "2010-09-20"
7009 msgstr ""
7010
7011 #. type: Plain text
7012 #: build/C/man2/mknod.2:16
7013 msgid "mknod - create a special or ordinary file"
7014 msgstr ""
7015
7016 #. type: Plain text
7017 #: build/C/man2/mknod.2:22
7018 #, no-wrap
7019 msgid ""
7020 "B<#include E<lt>sys/types.hE<gt>>\n"
7021 "B<#include E<lt>sys/stat.hE<gt>>\n"
7022 "B<#include E<lt>fcntl.hE<gt>>\n"
7023 "B<#include E<lt>unistd.hE<gt>>\n"
7024 msgstr ""
7025
7026 #. type: Plain text
7027 #: build/C/man2/mknod.2:24
7028 #, no-wrap
7029 msgid ""
7030 "B<int mknod(const char *>I<pathname>B<, mode_t >I<mode>B<, dev_t "
7031 ">I<dev>B<);>\n"
7032 msgstr ""
7033
7034 #. type: Plain text
7035 #: build/C/man2/mknod.2:29 build/C/man3/syslog.3:53
7036 msgid "Feature Test Macro Requirements for glibc (see B<feature_test_macros>(7)):"
7037 msgstr ""
7038
7039 #. type: Plain text
7040 #: build/C/man2/mknod.2:32
7041 msgid "B<mknod>():"
7042 msgstr ""
7043
7044 #. type: Plain text
7045 #: build/C/man2/mknod.2:36
7046 msgid ""
7047 "_BSD_SOURCE || _SVID_SOURCE || _XOPEN_SOURCE\\ E<gt>=\\ 500 || "
7048 "_XOPEN_SOURCE\\ &&\\ _XOPEN_SOURCE_EXTENDED"
7049 msgstr ""
7050
7051 #. type: Plain text
7052 #: build/C/man2/mknod.2:48
7053 msgid ""
7054 "The system call B<mknod>()  creates a file system node (file, device special "
7055 "file or named pipe) named I<pathname>, with attributes specified by I<mode> "
7056 "and I<dev>."
7057 msgstr ""
7058
7059 #. type: Plain text
7060 #: build/C/man2/mknod.2:55
7061 msgid ""
7062 "The I<mode> argument specifies both the permissions to use and the type of "
7063 "node to be created.  It should be a combination (using bitwise OR) of one of "
7064 "the file types listed below and the permissions for the new node."
7065 msgstr ""
7066
7067 #. type: Plain text
7068 #: build/C/man2/mknod.2:60
7069 msgid ""
7070 "The permissions are modified by the process's I<umask> in the usual way: the "
7071 "permissions of the created node are I<(mode & ~umask)>."
7072 msgstr ""
7073
7074 #.  (S_IFSOCK since Linux 1.2.4)
7075 #. type: Plain text
7076 #: build/C/man2/mknod.2:74
7077 msgid ""
7078 "The file type must be one of B<S_IFREG>, B<S_IFCHR>, B<S_IFBLK>, B<S_IFIFO> "
7079 "or B<S_IFSOCK> to specify a regular file (which will be created empty), "
7080 "character special file, block special file, FIFO (named pipe), or UNIX "
7081 "domain socket, respectively.  (Zero file type is equivalent to type "
7082 "B<S_IFREG>.)"
7083 msgstr ""
7084
7085 #. type: Plain text
7086 #: build/C/man2/mknod.2:87
7087 msgid ""
7088 "If the file type is B<S_IFCHR> or B<S_IFBLK> then I<dev> specifies the major "
7089 "and minor numbers of the newly created device special file (B<makedev>(3)  "
7090 "may be useful to build the value for I<dev>); otherwise it is ignored."
7091 msgstr ""
7092
7093 #. type: Plain text
7094 #: build/C/man2/mknod.2:93
7095 msgid ""
7096 "If I<pathname> already exists, or is a symbolic link, this call fails with "
7097 "an B<EEXIST> error."
7098 msgstr ""
7099
7100 #. type: Plain text
7101 #: build/C/man2/mknod.2:100
7102 msgid ""
7103 "The newly created node will be owned by the effective user ID of the "
7104 "process.  If the directory containing the node has the set-group-ID bit set, "
7105 "or if the file system is mounted with BSD group semantics, the new node will "
7106 "inherit the group ownership from its parent directory; otherwise it will be "
7107 "owned by the effective group ID of the process."
7108 msgstr ""
7109
7110 #. type: Plain text
7111 #: build/C/man2/mknod.2:105
7112 msgid ""
7113 "B<mknod>()  returns zero on success, or -1 if an error occurred (in which "
7114 "case, I<errno> is set appropriately)."
7115 msgstr ""
7116
7117 #. type: Plain text
7118 #: build/C/man2/mknod.2:114
7119 msgid ""
7120 "The parent directory does not allow write permission to the process, or one "
7121 "of the directories in the path prefix of I<pathname> did not allow search "
7122 "permission.  (See also B<path_resolution>(7).)"
7123 msgstr ""
7124
7125 #. type: TP
7126 #: build/C/man2/mknod.2:121 build/C/man4/st.4:837
7127 #, no-wrap
7128 msgid "B<EFAULT>"
7129 msgstr ""
7130
7131 #. type: Plain text
7132 #: build/C/man2/mknod.2:124
7133 msgid "I<pathname> points outside your accessible address space."
7134 msgstr ""
7135
7136 #. type: Plain text
7137 #: build/C/man2/mknod.2:129
7138 msgid ""
7139 "I<mode> requested creation of something other than a regular file, device "
7140 "special file, FIFO or socket."
7141 msgstr ""
7142
7143 #. type: TP
7144 #: build/C/man2/mknod.2:129
7145 #, no-wrap
7146 msgid "B<ELOOP>"
7147 msgstr ""
7148
7149 #. type: Plain text
7150 #: build/C/man2/mknod.2:133
7151 msgid "Too many symbolic links were encountered in resolving I<pathname>."
7152 msgstr ""
7153
7154 #. type: Plain text
7155 #: build/C/man2/mknod.2:136
7156 msgid "I<pathname> was too long."
7157 msgstr ""
7158
7159 #. type: TP
7160 #: build/C/man2/mknod.2:141 build/C/man4/st.4:849
7161 #, no-wrap
7162 msgid "B<ENOMEM>"
7163 msgstr ""
7164
7165 #. type: Plain text
7166 #: build/C/man2/mknod.2:144
7167 msgid "Insufficient kernel memory was available."
7168 msgstr ""
7169
7170 #. type: Plain text
7171 #: build/C/man2/mknod.2:149
7172 msgid "The device containing I<pathname> has no room for the new node."
7173 msgstr ""
7174
7175 #.  For UNIX domain sockets and regular files, EPERM is only returned in
7176 #.  Linux 2.2 and earlier; in Linux 2.4 and later, unprivileged can
7177 #.  use mknod() to make these files.
7178 #. type: Plain text
7179 #: build/C/man2/mknod.2:168
7180 msgid ""
7181 "I<mode> requested creation of something other than a regular file, FIFO "
7182 "(named pipe), or UNIX domain socket, and the caller is not privileged "
7183 "(Linux: does not have the B<CAP_MKNOD> capability); also returned if the "
7184 "file system containing I<pathname> does not support the type of node "
7185 "requested."
7186 msgstr ""
7187
7188 #. type: Plain text
7189 #: build/C/man2/mknod.2:172
7190 msgid "I<pathname> refers to a file on a read-only file system."
7191 msgstr ""
7192
7193 #.  The Linux version differs from the SVr4 version in that it
7194 #.  does not require root permission to create pipes, also in that no
7195 #.  EMULTIHOP, ENOLINK, or EINTR error is documented.
7196 #. type: Plain text
7197 #: build/C/man2/mknod.2:177
7198 msgid "SVr4, 4.4BSD, POSIX.1-2001 (but see below)."
7199 msgstr ""
7200
7201 #. type: Plain text
7202 #: build/C/man2/mknod.2:195
7203 msgid ""
7204 "POSIX.1-2001 says: \"The only portable use of B<mknod>()  is to create a "
7205 "FIFO-special file.  If I<mode> is not B<S_IFIFO> or I<dev> is not 0, the "
7206 "behavior of B<mknod>()  is unspecified.\" However, nowadays one should never "
7207 "use B<mknod>()  for this purpose; one should use B<mkfifo>(3), a function "
7208 "especially defined for this purpose."
7209 msgstr ""
7210
7211 #.  and one should make UNIX domain sockets with socket(2) and bind(2).
7212 #. type: Plain text
7213 #: build/C/man2/mknod.2:200
7214 msgid ""
7215 "Under Linux, this call cannot be used to create directories.  One should "
7216 "make directories with B<mkdir>(2)."
7217 msgstr ""
7218
7219 #. type: Plain text
7220 #: build/C/man2/mknod.2:204
7221 msgid ""
7222 "There are many infelicities in the protocol underlying NFS.  Some of these "
7223 "affect B<mknod>()."
7224 msgstr ""
7225
7226 #. type: Plain text
7227 #: build/C/man2/mknod.2:218
7228 msgid ""
7229 "B<chmod>(2), B<chown>(2), B<fcntl>(2), B<mkdir>(2), B<mknodat>(2), "
7230 "B<mount>(2), B<socket>(2), B<stat>(2), B<umask>(2), B<unlink>(2), "
7231 "B<makedev>(3), B<mkfifo>(3), B<path_resolution>(7)"
7232 msgstr ""
7233
7234 #. type: TH
7235 #: build/C/man4/mouse.4:25
7236 #, no-wrap
7237 msgid "MOUSE"
7238 msgstr ""
7239
7240 #. type: TH
7241 #: build/C/man4/mouse.4:25
7242 #, no-wrap
7243 msgid "1996-02-10"
7244 msgstr ""
7245
7246 #. type: Plain text
7247 #: build/C/man4/mouse.4:28
7248 msgid "mouse - serial mouse interface"
7249 msgstr ""
7250
7251 #. type: Plain text
7252 #: build/C/man4/mouse.4:32
7253 msgid ""
7254 "Serial mice are connected to a serial RS232/V24 dialout line, see B<ttyS>(4)  "
7255 "for a description."
7256 msgstr ""
7257
7258 #. type: SS
7259 #: build/C/man4/mouse.4:33
7260 #, no-wrap
7261 msgid "Introduction"
7262 msgstr ""
7263
7264 #. type: Plain text
7265 #: build/C/man4/mouse.4:35
7266 msgid "The pinout of the usual 9 pin plug as used for serial mice is:"
7267 msgstr ""
7268
7269 #. type: tbl table
7270 #: build/C/man4/mouse.4:38
7271 #, no-wrap
7272 msgid "pin\tname\tused for\n"
7273 msgstr ""
7274
7275 #. type: tbl table
7276 #: build/C/man4/mouse.4:39
7277 #, no-wrap
7278 msgid "2\tRX\tData\n"
7279 msgstr ""
7280
7281 #. type: tbl table
7282 #: build/C/man4/mouse.4:40
7283 #, no-wrap
7284 msgid "3\tTX\t-12 V, Imax = 10 mA\n"
7285 msgstr ""
7286
7287 #. type: tbl table
7288 #: build/C/man4/mouse.4:41
7289 #, no-wrap
7290 msgid "4\tDTR\t+12 V, Imax = 10 mA\n"
7291 msgstr ""
7292
7293 #. type: tbl table
7294 #: build/C/man4/mouse.4:42
7295 #, no-wrap
7296 msgid "7\tRTS\t+12 V, Imax = 10 mA\n"
7297 msgstr ""
7298
7299 #. type: tbl table
7300 #: build/C/man4/mouse.4:43
7301 #, no-wrap
7302 msgid "5\tGND\tGround\n"
7303 msgstr ""
7304
7305 #. type: Plain text
7306 #: build/C/man4/mouse.4:47
7307 msgid "This is the specification, in fact 9 V suffices with most mice."
7308 msgstr ""
7309
7310 #. type: Plain text
7311 #: build/C/man4/mouse.4:53
7312 msgid ""
7313 "The mouse driver can recognize a mouse by dropping RTS to low and raising it "
7314 "again.  About 14 ms later the mouse will send 0x4D (\\(aqM\\(aq) on the data "
7315 "line.  After a further 63 ms, a Microsoft-compatible 3-button mouse will "
7316 "send 0x33 (\\(aq3\\(aq)."
7317 msgstr ""
7318
7319 #. type: Plain text
7320 #: build/C/man4/mouse.4:61
7321 msgid ""
7322 "The relative mouse movement is sent as I<dx> (positive means right)  and "
7323 "I<dy> (positive means down).  Various mice can operate at different speeds.  "
7324 "To select speeds, cycle through the speeds 9600, 4800, 2400 and 1200 bit/s, "
7325 "each time writing the two characters from the table below and waiting 0.1 "
7326 "seconds.  The following table shows available speeds and the strings that "
7327 "select them:"
7328 msgstr ""
7329
7330 #. type: tbl table
7331 #: build/C/man4/mouse.4:64
7332 #, no-wrap
7333 msgid "bit/s\tstring\n"
7334 msgstr ""
7335
7336 #. type: tbl table
7337 #: build/C/man4/mouse.4:65
7338 #, no-wrap
7339 msgid "9600\t*q\n"
7340 msgstr ""
7341
7342 #. type: tbl table
7343 #: build/C/man4/mouse.4:66
7344 #, no-wrap
7345 msgid "4800\t*p\n"
7346 msgstr ""
7347
7348 #. type: tbl table
7349 #: build/C/man4/mouse.4:67
7350 #, no-wrap
7351 msgid "2400\t*o\n"
7352 msgstr ""
7353
7354 #. type: tbl table
7355 #: build/C/man4/mouse.4:68
7356 #, no-wrap
7357 msgid "1200\t*n\n"
7358 msgstr ""
7359
7360 #. type: Plain text
7361 #: build/C/man4/mouse.4:72
7362 msgid "The first byte of a data packet can be used to synchronization purposes."
7363 msgstr ""
7364
7365 #. type: SS
7366 #: build/C/man4/mouse.4:72
7367 #, no-wrap
7368 msgid "Microsoft protocol"
7369 msgstr ""
7370
7371 #. type: Plain text
7372 #: build/C/man4/mouse.4:79
7373 msgid ""
7374 "The B<Microsoft> protocol uses 1 start bit, 7 data bits, no parity and one "
7375 "stop bit at the speed of 1200 bits/sec.  Data is sent to RxD in 3-byte "
7376 "packets.  The I<dx> and I<dy> movements are sent as two's-complement, I<lb> "
7377 "(I<rb>) are set when the left (right)  button is pressed:"
7378 msgstr ""
7379
7380 #. type: tbl table
7381 #: build/C/man4/mouse.4:82
7382 #, no-wrap
7383 msgid "byte\td6\td5\td4\td3\td2\td1\td0\n"
7384 msgstr ""
7385
7386 #. type: tbl table
7387 #: build/C/man4/mouse.4:83
7388 #, no-wrap
7389 msgid "1\t1\tlb\trb\tdy7\tdy6\tdx7\tdx6\n"
7390 msgstr ""
7391
7392 #. type: tbl table
7393 #: build/C/man4/mouse.4:84
7394 #, no-wrap
7395 msgid "2\t0\tdx5\tdx4\tdx3\tdx2\tdx1\tdx0\n"
7396 msgstr ""
7397
7398 #. type: tbl table
7399 #: build/C/man4/mouse.4:85
7400 #, no-wrap
7401 msgid "3\t0\tdy5\tdy4\tdy3\tdy2\tdy1\tdy0\n"
7402 msgstr ""
7403
7404 #. type: SS
7405 #: build/C/man4/mouse.4:87
7406 #, no-wrap
7407 msgid "3-button Microsoft protocol"
7408 msgstr ""
7409
7410 #. type: Plain text
7411 #: build/C/man4/mouse.4:96
7412 msgid ""
7413 "Original Microsoft mice only have two buttons.  However, there are some "
7414 "three button mice which also use the Microsoft protocol.  Pressing or "
7415 "releasing the middle button is reported by sending a packet with zero "
7416 "movement and no buttons pressed.  (Thus, unlike for the other two buttons, "
7417 "the status of the middle button is not reported in each packet.)"
7418 msgstr ""
7419
7420 #. type: SS
7421 #: build/C/man4/mouse.4:96
7422 #, no-wrap
7423 msgid "Logitech protocol"
7424 msgstr ""
7425
7426 #. type: Plain text
7427 #: build/C/man4/mouse.4:105
7428 msgid ""
7429 "Logitech serial 3-button mice use a different extension of the Microsoft "
7430 "protocol: when the middle button is up, the above 3-byte packet is sent.  "
7431 "When the middle button is down a 4-byte packet is sent, where the 4th byte "
7432 "has value 0x20 (or at least has the 0x20 bit set).  In particular, a press "
7433 "of the middle button is reported as 0,0,0,0x20 when no other buttons are "
7434 "down."
7435 msgstr ""
7436
7437 #. type: SS
7438 #: build/C/man4/mouse.4:105
7439 #, no-wrap
7440 msgid "Mousesystems protocol"
7441 msgstr ""
7442
7443 #. type: Plain text
7444 #: build/C/man4/mouse.4:115
7445 msgid ""
7446 "The B<Mousesystems> protocol uses 1 start bit, 8 data bits, no parity and "
7447 "two stop bits at the speed of 1200 bits/sec.  Data is sent to RxD in 5-byte "
7448 "packets.  I<dx> is sent as the sum of the two two's-complement values, I<dy> "
7449 "is send as negated sum of the two two's-complement values.  I<lb> (I<mb>, "
7450 "I<rb>) are cleared when the left (middle, right) button is pressed:"
7451 msgstr ""
7452
7453 #. type: tbl table
7454 #: build/C/man4/mouse.4:118 build/C/man4/mouse.4:143
7455 #, no-wrap
7456 msgid "byte\td7\td6\td5\td4\td3\td2\td1\td0\n"
7457 msgstr ""
7458
7459 #. type: tbl table
7460 #: build/C/man4/mouse.4:119
7461 #, no-wrap
7462 msgid "1\t1\t0\t0\t0\t0\tlb\tmb\trb\n"
7463 msgstr ""
7464
7465 #. type: tbl table
7466 #: build/C/man4/mouse.4:120
7467 #, no-wrap
7468 msgid "2\t0\tdxa6\tdxa5\tdxa4\tdxa3\tdxa2\tdxa1\tdxa0\n"
7469 msgstr ""
7470
7471 #. type: tbl table
7472 #: build/C/man4/mouse.4:121
7473 #, no-wrap
7474 msgid "3\t0\tdya6\tdya5\tdya4\tdya3\tdya2\tdya1\tdya0\n"
7475 msgstr ""
7476
7477 #. type: tbl table
7478 #: build/C/man4/mouse.4:122
7479 #, no-wrap
7480 msgid "4\t0\tdxb6\tdxb5\tdxb4\tdxb3\tdxb2\tdxb1\tdxb0\n"
7481 msgstr ""
7482
7483 #. type: tbl table
7484 #: build/C/man4/mouse.4:123
7485 #, no-wrap
7486 msgid "5\t0\tdyb6\tdyb5\tdyb4\tdyb3\tdyb2\tdyb1\tdyb0\n"
7487 msgstr ""
7488
7489 #. type: Plain text
7490 #: build/C/man4/mouse.4:128
7491 msgid ""
7492 "Bytes 4 and 5 describe the change that occurred since bytes 2 and 3 were "
7493 "transmitted."
7494 msgstr ""
7495
7496 #. type: SS
7497 #: build/C/man4/mouse.4:128
7498 #, no-wrap
7499 msgid "Sun protocol"
7500 msgstr ""
7501
7502 #. type: Plain text
7503 #: build/C/man4/mouse.4:131
7504 msgid ""
7505 "The B<Sun> protocol is the 3-byte version of the above 5-byte Mousesystems "
7506 "protocol: the last two bytes are not sent."
7507 msgstr ""
7508
7509 #. type: SS
7510 #: build/C/man4/mouse.4:131
7511 #, no-wrap
7512 msgid "MM protocol"
7513 msgstr ""
7514
7515 #. type: Plain text
7516 #: build/C/man4/mouse.4:140
7517 msgid ""
7518 "The B<MM> protocol uses 1 start bit, 8 data bits, odd parity and one stop "
7519 "bit at the speed of 1200 bits/sec.  Data is sent to RxD in 3-byte packets.  "
7520 "I<dx> and I<dy> are sent as single signed values, the sign bit indicating a "
7521 "negative value.  I<lb> (I<mb>, I<rb>) are set when the left (middle, right) "
7522 "button is pressed:"
7523 msgstr ""
7524
7525 #. type: tbl table
7526 #: build/C/man4/mouse.4:144
7527 #, no-wrap
7528 msgid "1\t1\t0\t0\tdxs\tdys\tlb\tmb\trb\n"
7529 msgstr ""
7530
7531 #. type: tbl table
7532 #: build/C/man4/mouse.4:145
7533 #, no-wrap
7534 msgid "2\t0\tdx6\tdx5\tdx4\tdx3\tdx2\tdx1\tdx0\n"
7535 msgstr ""
7536
7537 #. type: tbl table
7538 #: build/C/man4/mouse.4:146
7539 #, no-wrap
7540 msgid "3\t0\tdy6\tdy5\tdy4\tdy3\tdy2\tdy1\tdy0\n"
7541 msgstr ""
7542
7543 #. type: TP
7544 #: build/C/man4/mouse.4:149
7545 #, no-wrap
7546 msgid "I</dev/mouse>"
7547 msgstr ""
7548
7549 #. type: Plain text
7550 #: build/C/man4/mouse.4:152
7551 msgid "A commonly used symlink pointing to a mouse device."
7552 msgstr ""
7553
7554 #. type: Plain text
7555 #: build/C/man4/mouse.4:155
7556 msgid "B<ttyS>(4), B<gpm>(8)"
7557 msgstr ""
7558
7559 #. type: TH
7560 #: build/C/man4/msr.4:24
7561 #, no-wrap
7562 msgid "MSR"
7563 msgstr ""
7564
7565 #. type: Plain text
7566 #: build/C/man4/msr.4:27
7567 msgid "msr - x86 CPU MSR access device"
7568 msgstr ""
7569
7570 #. type: Plain text
7571 #: build/C/man4/msr.4:34
7572 msgid ""
7573 "I</dev/cpu/CPUNUM/msr> provides an interface to read and write the "
7574 "model-specific registers (MSRs) of an x86 CPU.  I<CPUNUM> is the number of "
7575 "the CPU to access as listed in I</proc/cpuinfo>."
7576 msgstr ""
7577
7578 #. type: Plain text
7579 #: build/C/man4/msr.4:40
7580 msgid ""
7581 "The register access is done by opening the file and seeking to the MSR "
7582 "number as offset in the file, and then reading or writing in chunks of 8 "
7583 "bytes.  An I/O transfer of more than 8 bytes means multiple reads or writes "
7584 "of the same register."
7585 msgstr ""
7586
7587 #. type: Plain text
7588 #: build/C/man4/msr.4:45
7589 msgid ""
7590 "This file is protected so that it can only be read and written by the user "
7591 "I<root>, or members of the group I<root>."
7592 msgstr ""
7593
7594 #. type: Plain text
7595 #: build/C/man4/msr.4:51
7596 msgid ""
7597 "The I<msr> driver is not auto-loaded.  On modular kernels you might need to "
7598 "use the following command to load it explicitly before use:"
7599 msgstr ""
7600
7601 #. type: Plain text
7602 #: build/C/man4/msr.4:53
7603 #, no-wrap
7604 msgid "    $ I<modprobe msr>\n"
7605 msgstr ""
7606
7607 #. type: Plain text
7608 #: build/C/man4/msr.4:57
7609 msgid ""
7610 "Intel Corporation Intel 64 and IA-32 Architectures Software Developer's "
7611 "Manual Volume 3B Appendix B for an overview of the Intel CPU MSRs."
7612 msgstr ""
7613
7614 #. type: TH
7615 #: build/C/man4/null.4:25
7616 #, no-wrap
7617 msgid "NULL"
7618 msgstr ""
7619
7620 #. type: TH
7621 #: build/C/man4/null.4:25
7622 #, no-wrap
7623 msgid "2009-02-23"
7624 msgstr ""
7625
7626 #. type: Plain text
7627 #: build/C/man4/null.4:28
7628 msgid "null, zero - data sink"
7629 msgstr ""
7630
7631 #. type: Plain text
7632 #: build/C/man4/null.4:30
7633 msgid "Data written to a B<null> or B<zero> special file is discarded."
7634 msgstr ""
7635
7636 #. type: Plain text
7637 #: build/C/man4/null.4:35
7638 msgid ""
7639 "Reads from the B<null> special file always return end of file (i.e., "
7640 "B<read>(2)  returns 0), whereas reads from B<zero> always return bytes "
7641 "containing zero (\\e0 characters)."
7642 msgstr ""
7643
7644 #. type: Plain text
7645 #: build/C/man4/null.4:37
7646 msgid "B<null> and B<zero> are typically created by:"
7647 msgstr ""
7648
7649 #. type: Plain text
7650 #: build/C/man4/null.4:40
7651 msgid "mknod -m 666 /dev/null c 1 3"
7652 msgstr ""
7653
7654 #. type: Plain text
7655 #: build/C/man4/null.4:42
7656 msgid "mknod -m 666 /dev/zero c 1 5"
7657 msgstr ""
7658
7659 #. type: Plain text
7660 #: build/C/man4/null.4:44
7661 msgid "chown root:root /dev/null /dev/zero"
7662 msgstr ""
7663
7664 #. type: Plain text
7665 #: build/C/man4/null.4:47
7666 msgid "I</dev/null>"
7667 msgstr ""
7668
7669 #. type: Plain text
7670 #: build/C/man4/null.4:49
7671 msgid "I</dev/zero>"
7672 msgstr ""
7673
7674 #. type: Plain text
7675 #: build/C/man4/null.4:52
7676 msgid ""
7677 "If these devices are not writable and readable for all users, many programs "
7678 "will act strangely."
7679 msgstr ""
7680
7681 #. type: Plain text
7682 #: build/C/man4/null.4:56
7683 msgid "B<chown>(1), B<mknod>(1), B<full>(4)"
7684 msgstr ""
7685
7686 #. type: TH
7687 #: build/C/man7/pipe.7:25
7688 #, no-wrap
7689 msgid "PIPE"
7690 msgstr ""
7691
7692 #. type: TH
7693 #: build/C/man7/pipe.7:25
7694 #, no-wrap
7695 msgid "2005-12-08"
7696 msgstr ""
7697
7698 #. type: Plain text
7699 #: build/C/man7/pipe.7:28
7700 msgid "pipe - overview of pipes and FIFOs"
7701 msgstr ""
7702
7703 #. type: Plain text
7704 #: build/C/man7/pipe.7:37
7705 msgid ""
7706 "Pipes and FIFOs (also known as named pipes)  provide a unidirectional "
7707 "interprocess communication channel.  A pipe has a I<read end> and a I<write "
7708 "end>.  Data written to the write end of a pipe can be read from the read end "
7709 "of the pipe."
7710 msgstr ""
7711
7712 #. type: Plain text
7713 #: build/C/man7/pipe.7:47
7714 msgid ""
7715 "A pipe is created using B<pipe>(2), which creates a new pipe and returns two "
7716 "file descriptors, one referring to the read end of the pipe, the other "
7717 "referring to the write end.  Pipes can be used to create a communication "
7718 "channel between related processes; see B<pipe>(2)  for an example."
7719 msgstr ""
7720
7721 #. type: Plain text
7722 #: build/C/man7/pipe.7:66
7723 msgid ""
7724 "A FIFO (short for First In First Out) has a name within the file system "
7725 "(created using B<mkfifo>(3)), and is opened using B<open>(2).  Any process "
7726 "may open a FIFO, assuming the file permissions allow it.  The read end is "
7727 "opened using the B<O_RDONLY> flag; the write end is opened using the "
7728 "B<O_WRONLY> flag.  See B<fifo>(7)  for further details.  I<Note>: although "
7729 "FIFOs have a pathname in the file system, I/O on FIFOs does not involve "
7730 "operations on the underlying device (if there is one)."
7731 msgstr ""
7732
7733 #. type: SS
7734 #: build/C/man7/pipe.7:66
7735 #, no-wrap
7736 msgid "I/O on Pipes and FIFOs"
7737 msgstr ""
7738
7739 #. type: Plain text
7740 #: build/C/man7/pipe.7:71
7741 msgid ""
7742 "The only difference between pipes and FIFOs is the manner in which they are "
7743 "created and opened.  Once these tasks have been accomplished, I/O on pipes "
7744 "and FIFOs has exactly the same semantics."
7745 msgstr ""
7746
7747 #. type: Plain text
7748 #: build/C/man7/pipe.7:85
7749 msgid ""
7750 "If a process attempts to read from an empty pipe, then B<read>(2)  will "
7751 "block until data is available.  If a process attempts to write to a full "
7752 "pipe (see below), then B<write>(2)  blocks until sufficient data has been "
7753 "read from the pipe to allow the write to complete.  Nonblocking I/O is "
7754 "possible by using the B<fcntl>(2)  B<F_SETFL> operation to enable the "
7755 "B<O_NONBLOCK> open file status flag."
7756 msgstr ""
7757
7758 #. type: Plain text
7759 #: build/C/man7/pipe.7:89
7760 msgid ""
7761 "The communication channel provided by a pipe is a I<byte stream>: there is "
7762 "no concept of message boundaries."
7763 msgstr ""
7764
7765 #. type: Plain text
7766 #: build/C/man7/pipe.7:116
7767 msgid ""
7768 "If all file descriptors referring to the write end of a pipe have been "
7769 "closed, then an attempt to B<read>(2)  from the pipe will see end-of-file "
7770 "(B<read>(2)  will return 0).  If all file descriptors referring to the read "
7771 "end of a pipe have been closed, then a B<write>(2)  will cause a B<SIGPIPE> "
7772 "signal to be generated for the calling process.  If the calling process is "
7773 "ignoring this signal, then B<write>(2)  fails with the error B<EPIPE>.  An "
7774 "application that uses B<pipe>(2)  and B<fork>(2)  should use suitable "
7775 "B<close>(2)  calls to close unnecessary duplicate file descriptors; this "
7776 "ensures that end-of-file and B<SIGPIPE>/B<EPIPE> are delivered when "
7777 "appropriate."
7778 msgstr ""
7779
7780 #. type: Plain text
7781 #: build/C/man7/pipe.7:120
7782 msgid "It is not possible to apply B<lseek>(2)  to a pipe."
7783 msgstr ""
7784
7785 #. type: SS
7786 #: build/C/man7/pipe.7:120
7787 #, no-wrap
7788 msgid "Pipe Capacity"
7789 msgstr ""
7790
7791 #. type: Plain text
7792 #: build/C/man7/pipe.7:132
7793 msgid ""
7794 "A pipe has a limited capacity.  If the pipe is full, then a B<write>(2)  "
7795 "will block or fail, depending on whether the B<O_NONBLOCK> flag is set (see "
7796 "below).  Different implementations have different limits for the pipe "
7797 "capacity.  Applications should not rely on a particular capacity: an "
7798 "application should be designed so that a reading process consumes data as "
7799 "soon as it is available, so that a writing process does not remain blocked."
7800 msgstr ""
7801
7802 #. type: Plain text
7803 #: build/C/man7/pipe.7:136
7804 msgid ""
7805 "In Linux versions before 2.6.11, the capacity of a pipe was the same as the "
7806 "system page size (e.g., 4096 bytes on i386).  Since Linux 2.6.11, the pipe "
7807 "capacity is 65536 bytes."
7808 msgstr ""
7809
7810 #. type: SS
7811 #: build/C/man7/pipe.7:136
7812 #, no-wrap
7813 msgid "PIPE_BUF"
7814 msgstr ""
7815
7816 #. type: Plain text
7817 #: build/C/man7/pipe.7:158
7818 msgid ""
7819 "POSIX.1-2001 says that B<write>(2)s of less than B<PIPE_BUF> bytes must be "
7820 "atomic: the output data is written to the pipe as a contiguous sequence.  "
7821 "Writes of more than B<PIPE_BUF> bytes may be nonatomic: the kernel may "
7822 "interleave the data with data written by other processes.  POSIX.1-2001 "
7823 "requires B<PIPE_BUF> to be at least 512 bytes.  (On Linux, B<PIPE_BUF> is "
7824 "4096 bytes.)  The precise semantics depend on whether the file descriptor is "
7825 "nonblocking (B<O_NONBLOCK>), whether there are multiple writers to the pipe, "
7826 "and on I<n>, the number of bytes to be written:"
7827 msgstr ""
7828
7829 #. type: TP
7830 #: build/C/man7/pipe.7:158
7831 #, no-wrap
7832 msgid "B<O_NONBLOCK> disabled, I<n> E<lt>= B<PIPE_BUF>"
7833 msgstr ""
7834
7835 #. type: Plain text
7836 #: build/C/man7/pipe.7:167
7837 msgid ""
7838 "All I<n> bytes are written atomically; B<write>(2)  may block if there is "
7839 "not room for I<n> bytes to be written immediately"
7840 msgstr ""
7841
7842 #. type: TP
7843 #: build/C/man7/pipe.7:167
7844 #, no-wrap
7845 msgid "B<O_NONBLOCK> enabled, I<n> E<lt>= B<PIPE_BUF>"
7846 msgstr ""
7847
7848 #. type: Plain text
7849 #: build/C/man7/pipe.7:181
7850 msgid ""
7851 "If there is room to write I<n> bytes to the pipe, then B<write>(2)  succeeds "
7852 "immediately, writing all I<n> bytes; otherwise B<write>(2)  fails, with "
7853 "I<errno> set to B<EAGAIN>."
7854 msgstr ""
7855
7856 #. type: TP
7857 #: build/C/man7/pipe.7:181
7858 #, no-wrap
7859 msgid "B<O_NONBLOCK> disabled, I<n> E<gt> B<PIPE_BUF>"
7860 msgstr ""
7861
7862 #. type: Plain text
7863 #: build/C/man7/pipe.7:193
7864 msgid ""
7865 "The write is nonatomic: the data given to B<write>(2)  may be interleaved "
7866 "with B<write>(2)s by other process; the B<write>(2)  blocks until I<n> bytes "
7867 "have been written."
7868 msgstr ""
7869
7870 #. type: TP
7871 #: build/C/man7/pipe.7:193
7872 #, no-wrap
7873 msgid "B<O_NONBLOCK> enabled, I<n> E<gt> B<PIPE_BUF>"
7874 msgstr ""
7875
7876 #. type: Plain text
7877 #: build/C/man7/pipe.7:208
7878 msgid ""
7879 "If the pipe is full, then B<write>(2)  fails, with I<errno> set to "
7880 "B<EAGAIN>.  Otherwise, from 1 to I<n> bytes may be written (i.e., a "
7881 "\"partial write\" may occur; the caller should check the return value from "
7882 "B<write>(2)  to see how many bytes were actually written), and these bytes "
7883 "may be interleaved with writes by other processes."
7884 msgstr ""
7885
7886 #. type: SS
7887 #: build/C/man7/pipe.7:208
7888 #, no-wrap
7889 msgid "Open File Status Flags"
7890 msgstr ""
7891
7892 #. type: Plain text
7893 #: build/C/man7/pipe.7:214
7894 msgid ""
7895 "The only open file status flags that can be meaningfully applied to a pipe "
7896 "or FIFO are B<O_NONBLOCK> and B<O_ASYNC>."
7897 msgstr ""
7898
7899 #. type: Plain text
7900 #: build/C/man7/pipe.7:226
7901 msgid ""
7902 "Setting the B<O_ASYNC> flag for the read end of a pipe causes a signal "
7903 "(B<SIGIO> by default) to be generated when new input becomes available on "
7904 "the pipe (see B<fcntl>(2)  for details).  On Linux, B<O_ASYNC> is supported "
7905 "for pipes and FIFOs only since kernel 2.6."
7906 msgstr ""
7907
7908 #. type: SS
7909 #: build/C/man7/pipe.7:226
7910 #, no-wrap
7911 msgid "Portability notes"
7912 msgstr ""
7913
7914 #. type: Plain text
7915 #: build/C/man7/pipe.7:232
7916 msgid ""
7917 "On some systems (but not Linux), pipes are bidirectional: data can be "
7918 "transmitted in both directions between the pipe ends.  According to "
7919 "POSIX.1-2001, pipes only need to be unidirectional.  Portable applications "
7920 "should avoid reliance on bidirectional pipe semantics."
7921 msgstr ""
7922
7923 #. type: Plain text
7924 #: build/C/man7/pipe.7:244
7925 msgid ""
7926 "B<dup>(2), B<fcntl>(2), B<open>(2), B<pipe>(2), B<poll>(2), B<select>(2), "
7927 "B<socketpair>(2), B<stat>(2), B<mkfifo>(3), B<epoll>(7), B<fifo>(7)"
7928 msgstr ""
7929
7930 #. type: TH
7931 #: build/C/man4/ram.4:25
7932 #, no-wrap
7933 msgid "RAM"
7934 msgstr ""
7935
7936 #. type: Plain text
7937 #: build/C/man4/ram.4:28
7938 msgid "ram - ram disk device"
7939 msgstr ""
7940
7941 #. type: Plain text
7942 #: build/C/man4/ram.4:30
7943 msgid "The I<ram> device is a block device to access the ram disk in raw mode."
7944 msgstr ""
7945
7946 #. type: Plain text
7947 #: build/C/man4/ram.4:35
7948 msgid "mknod -m 660 /dev/ram b 1 1"
7949 msgstr ""
7950
7951 #. type: Plain text
7952 #: build/C/man4/ram.4:37
7953 msgid "chown root:disk /dev/ram"
7954 msgstr ""
7955
7956 #. type: Plain text
7957 #: build/C/man4/ram.4:40
7958 msgid "/dev/ram"
7959 msgstr ""
7960
7961 #. type: Plain text
7962 #: build/C/man4/ram.4:44
7963 msgid "B<chown>(1), B<mknod>(1), B<mount>(8)"
7964 msgstr ""
7965
7966 #. type: TH
7967 #: build/C/man4/random.4:17
7968 #, no-wrap
7969 msgid "RANDOM"
7970 msgstr ""
7971
7972 #. type: Plain text
7973 #: build/C/man4/random.4:20
7974 msgid "random, urandom - kernel random number source devices"
7975 msgstr ""
7976
7977 #. type: Plain text
7978 #: build/C/man4/random.4:27
7979 msgid ""
7980 "The character special files I</dev/random> and I</dev/urandom> (present "
7981 "since Linux 1.3.30)  provide an interface to the kernel's random number "
7982 "generator.  File I</dev/random> has major device number 1 and minor device "
7983 "number 8.  File I</dev/urandom> has major device number 1 and minor device "
7984 "number 9."
7985 msgstr ""
7986
7987 #. type: Plain text
7988 #: build/C/man4/random.4:33
7989 msgid ""
7990 "The random number generator gathers environmental noise from device drivers "
7991 "and other sources into an entropy pool.  The generator also keeps an "
7992 "estimate of the number of bits of noise in the entropy pool.  From this "
7993 "entropy pool random numbers are created."
7994 msgstr ""
7995
7996 #. type: Plain text
7997 #: build/C/man4/random.4:41
7998 msgid ""
7999 "When read, the I</dev/random> device will only return random bytes within "
8000 "the estimated number of bits of noise in the entropy pool.  I</dev/random> "
8001 "should be suitable for uses that need very high quality randomness such as "
8002 "one-time pad or key generation.  When the entropy pool is empty, reads from "
8003 "I</dev/random> will block until additional environmental noise is gathered."
8004 msgstr ""
8005
8006 #. type: Plain text
8007 #: build/C/man4/random.4:52
8008 msgid ""
8009 "A read from the I</dev/urandom> device will not block waiting for more "
8010 "entropy.  As a result, if there is not sufficient entropy in the entropy "
8011 "pool, the returned values are theoretically vulnerable to a cryptographic "
8012 "attack on the algorithms used by the driver.  Knowledge of how to do this is "
8013 "not available in the current unclassified literature, but it is "
8014 "theoretically possible that such an attack may exist.  If this is a concern "
8015 "in your application, use I</dev/random> instead."
8016 msgstr ""
8017
8018 #. type: Plain text
8019 #: build/C/man4/random.4:61
8020 msgid ""
8021 "If you are unsure about whether you should use I</dev/random> or "
8022 "I</dev/urandom>, then probably you want to use the latter.  As a general "
8023 "rule, I</dev/urandom> should be used for everything except long-lived "
8024 "GPG/SSL/SSH keys."
8025 msgstr ""
8026
8027 #. type: Plain text
8028 #: build/C/man4/random.4:73
8029 msgid ""
8030 "If a seed file is saved across reboots as recommended below (all major Linux "
8031 "distributions have done this since 2000 at least), the output is "
8032 "cryptographically secure against attackers without local root access as soon "
8033 "as it is reloaded in the boot sequence, and perfectly adequate for network "
8034 "encryption session keys.  Since reads from I</dev/random> may block, users "
8035 "will usually want to open it in nonblocking mode (or perform a read with "
8036 "timeout), and provide some sort of user notification if the desired entropy "
8037 "is not immediately available."
8038 msgstr ""
8039
8040 #. type: Plain text
8041 #: build/C/man4/random.4:86
8042 msgid ""
8043 "The kernel random-number generator is designed to produce a small amount of "
8044 "high-quality seed material to seed a cryptographic pseudo-random number "
8045 "generator (CPRNG).  It is designed for security, not speed, and is poorly "
8046 "suited to generating large amounts of random data.  Users should be very "
8047 "economical in the amount of seed material that they read from "
8048 "I</dev/urandom> (and I</dev/random>); unnecessarily reading large quantities "
8049 "of data from this device will have a negative impact on other users of the "
8050 "device."
8051 msgstr ""
8052
8053 #. type: Plain text
8054 #: build/C/man4/random.4:94
8055 msgid ""
8056 "The amount of seed material required to generate a cryptographic key equals "
8057 "the effective key size of the key.  For example, a 3072-bit RSA or "
8058 "Diffie-Hellman private key has an effective key size of 128 bits (it "
8059 "requires about 2^128 operations to break) so a key generator only needs 128 "
8060 "bits (16 bytes) of seed material from I</dev/random>."
8061 msgstr ""
8062
8063 #. type: Plain text
8064 #: build/C/man4/random.4:103
8065 msgid ""
8066 "While some safety margin above that minimum is reasonable, as a guard "
8067 "against flaws in the CPRNG algorithm, no cryptographic primitive available "
8068 "today can hope to promise more than 256 bits of security, so if any program "
8069 "reads more than 256 bits (32 bytes) from the kernel random pool per "
8070 "invocation, or per reasonable reseed interval (not less than one minute), "
8071 "that should be taken as a sign that its cryptography is I<not> skilfully "
8072 "implemented."
8073 msgstr ""
8074
8075 #. type: SS
8076 #: build/C/man4/random.4:103
8077 #, no-wrap
8078 msgid "Configuration"
8079 msgstr ""
8080
8081 #. type: Plain text
8082 #: build/C/man4/random.4:107
8083 msgid ""
8084 "If your system does not have I</dev/random> and I</dev/urandom> created "
8085 "already, they can be created with the following commands:"
8086 msgstr ""
8087
8088 #. type: Plain text
8089 #: build/C/man4/random.4:112
8090 #, no-wrap
8091 msgid ""
8092 "    mknod -m 644 /dev/random c 1 8\n"
8093 "    mknod -m 644 /dev/urandom c 1 9\n"
8094 "    chown root:root /dev/random /dev/urandom\n"
8095 msgstr ""
8096
8097 #. type: Plain text
8098 #: build/C/man4/random.4:122
8099 msgid ""
8100 "When a Linux system starts up without much operator interaction, the entropy "
8101 "pool may be in a fairly predictable state.  This reduces the actual amount "
8102 "of noise in the entropy pool below the estimate.  In order to counteract "
8103 "this effect, it helps to carry entropy pool information across shut-downs "
8104 "and start-ups.  To do this, add the following lines to an appropriate script "
8105 "which is run during the Linux system start-up sequence:"
8106 msgstr ""
8107
8108 #. type: Plain text
8109 #: build/C/man4/random.4:137
8110 #, no-wrap
8111 msgid ""
8112 "    echo \"Initializing random number generator...\"\n"
8113 "    random_seed=/var/run/random-seed\n"
8114 "    # Carry a random seed from start-up to start-up\n"
8115 "    # Load and then save the whole entropy pool\n"
8116 "    if [ -f $random_seed ]; then\n"
8117 "        cat $random_seed E<gt>/dev/urandom\n"
8118 "    else\n"
8119 "        touch $random_seed\n"
8120 "    fi\n"
8121 "    chmod 600 $random_seed\n"
8122 "    poolfile=/proc/sys/kernel/random/poolsize\n"
8123 "    [ -r $poolfile ] && bytes=\\`cat $poolfile\\` || bytes=512\n"
8124 "    dd if=/dev/urandom of=$random_seed count=1 bs=$bytes\n"
8125 msgstr ""
8126
8127 #. type: Plain text
8128 #: build/C/man4/random.4:141
8129 msgid ""
8130 "Also, add the following lines in an appropriate script which is run during "
8131 "the Linux system shutdown:"
8132 msgstr ""
8133
8134 #. type: Plain text
8135 #: build/C/man4/random.4:152
8136 #, no-wrap
8137 msgid ""
8138 "    # Carry a random seed from shut-down to start-up\n"
8139 "    # Save the whole entropy pool\n"
8140 "    echo \"Saving random seed...\"\n"
8141 "    random_seed=/var/run/random-seed\n"
8142 "    touch $random_seed\n"
8143 "    chmod 600 $random_seed\n"
8144 "    poolfile=/proc/sys/kernel/random/poolsize\n"
8145 "    [ -r $poolfile ] && bytes=\\`cat $poolfile\\` || bytes=512\n"
8146 "    dd if=/dev/urandom of=$random_seed count=1 bs=$bytes\n"
8147 msgstr ""
8148
8149 #. type: SS
8150 #: build/C/man4/random.4:153
8151 #, no-wrap
8152 msgid "/proc Interface"
8153 msgstr ""
8154
8155 #. type: Plain text
8156 #: build/C/man4/random.4:159
8157 msgid ""
8158 "The files in the directory I</proc/sys/kernel/random> (present since 2.3.16) "
8159 "provide an additional interface to the I</dev/random> device."
8160 msgstr ""
8161
8162 #. type: Plain text
8163 #: build/C/man4/random.4:165
8164 msgid ""
8165 "The read-only file I<entropy_avail> gives the available entropy.  Normally, "
8166 "this will be 4096 (bits), a full entropy pool."
8167 msgstr ""
8168
8169 #. type: Plain text
8170 #: build/C/man4/random.4:170
8171 msgid ""
8172 "The file I<poolsize> gives the size of the entropy pool.  The semantics of "
8173 "this file vary across kernel versions:"
8174 msgstr ""
8175
8176 #. type: TP
8177 #: build/C/man4/random.4:171
8178 #, no-wrap
8179 msgid "Linux 2.4:"
8180 msgstr ""
8181
8182 #. type: Plain text
8183 #: build/C/man4/random.4:178
8184 msgid ""
8185 "This file gives the size of the entropy pool in I<bytes>.  Normally, this "
8186 "file will have the value 512, but it is writable, and can be changed to any "
8187 "value for which an algorithm is available.  The choices are 32, 64, 128, "
8188 "256, 512, 1024, or 2048."
8189 msgstr ""
8190
8191 #. type: TP
8192 #: build/C/man4/random.4:178
8193 #, no-wrap
8194 msgid "Linux 2.6:"
8195 msgstr ""
8196
8197 #. type: Plain text
8198 #: build/C/man4/random.4:183
8199 msgid ""
8200 "This file is read-only, and gives the size of the entropy pool in I<bits>.  "
8201 "It contains the value 4096."
8202 msgstr ""
8203
8204 #. type: Plain text
8205 #: build/C/man4/random.4:201
8206 msgid ""
8207 "The file I<read_wakeup_threshold> contains the number of bits of entropy "
8208 "required for waking up processes that sleep waiting for entropy from "
8209 "I</dev/random>.  The default is 64.  The file I<write_wakeup_threshold> "
8210 "contains the number of bits of entropy below which we wake up processes that "
8211 "do a B<select>(2)  or B<poll>(2)  for write access to I</dev/random>.  These "
8212 "values can be changed by writing to the files."
8213 msgstr ""
8214
8215 #. type: Plain text
8216 #: build/C/man4/random.4:209
8217 msgid ""
8218 "The read-only files I<uuid> and I<boot_id> contain random strings like "
8219 "6fd5a44b-35f4-4ad4-a9b9-6b9be13e1fe9.  The former is generated afresh for "
8220 "each read, the latter was generated once."
8221 msgstr ""
8222
8223 #. type: Plain text
8224 #: build/C/man4/random.4:211
8225 msgid "/dev/random"
8226 msgstr ""
8227
8228 #.  .SH AUTHOR
8229 #.  The kernel's random number generator was written by
8230 #.  Theodore Ts'o (tytso@athena.mit.edu).
8231 #. type: Plain text
8232 #: build/C/man4/random.4:216
8233 msgid "/dev/urandom"
8234 msgstr ""
8235
8236 #. type: Plain text
8237 #: build/C/man4/random.4:218
8238 msgid "mknod (1)"
8239 msgstr ""
8240
8241 #. type: Plain text
8242 #: build/C/man4/random.4:220
8243 msgid "RFC\\ 1750, \"Randomness Recommendations for Security\""
8244 msgstr ""
8245
8246 #. type: TH
8247 #: build/C/man4/sd.4:24
8248 #, no-wrap
8249 msgid "SD"
8250 msgstr ""
8251
8252 #. type: TH
8253 #: build/C/man4/sd.4:24
8254 #, no-wrap
8255 msgid "2012-05-03"
8256 msgstr ""
8257
8258 #. type: Plain text
8259 #: build/C/man4/sd.4:27
8260 msgid "sd - Driver for SCSI Disk Drives"
8261 msgstr ""
8262
8263 #. type: Plain text
8264 #: build/C/man4/sd.4:31
8265 #, no-wrap
8266 msgid ""
8267 "B<#include E<lt>linux/hdreg.hE<gt>        >/* for HDIO_GETGEO */\n"
8268 "B<#include E<lt>linux/fs.hE<gt>           >/* for BLKGETSIZE and BLKRRPART "
8269 "*/\n"
8270 msgstr ""
8271
8272 #. type: Plain text
8273 #: build/C/man4/sd.4:43
8274 msgid ""
8275 "The block device name has the following form: B<sd>I<lp,> where I<l> is a "
8276 "letter denoting the physical drive, and I<p> is a number denoting the "
8277 "partition on that physical drive.  Often, the partition number, I<p>, will "
8278 "be left off when the device corresponds to the whole drive."
8279 msgstr ""
8280
8281 #. type: Plain text
8282 #: build/C/man4/sd.4:52
8283 msgid ""
8284 "SCSI disks have a major device number of 8, and a minor device number of the "
8285 "form (16 * I<drive_number>) + I<partition_number>, where I<drive_number> is "
8286 "the number of the physical drive in order of detection, and "
8287 "I<partition_number> is as follows:"
8288 msgstr ""
8289
8290 #. type: Plain text
8291 #: build/C/man4/sd.4:54
8292 msgid "partition 0 is the whole drive"
8293 msgstr ""
8294
8295 #. type: Plain text
8296 #: build/C/man4/sd.4:56
8297 msgid "partitions 1-4 are the DOS \"primary\" partitions"
8298 msgstr ""
8299
8300 #. type: Plain text
8301 #: build/C/man4/sd.4:58
8302 msgid "partitions 5-8 are the DOS \"extended\" (or \"logical\") partitions"
8303 msgstr ""
8304
8305 #. type: Plain text
8306 #: build/C/man4/sd.4:66
8307 msgid ""
8308 "For example, I</dev/sda> will have major 8, minor 0, and will refer to all "
8309 "of the first SCSI drive in the system; and I</dev/sdb3> will have major 8, "
8310 "minor 19, and will refer to the third DOS \"primary\" partition on the "
8311 "second SCSI drive in the system."
8312 msgstr ""
8313
8314 #. type: Plain text
8315 #: build/C/man4/sd.4:69
8316 msgid ""
8317 "At this time, only block devices are provided.  Raw devices have not yet "
8318 "been implemented."
8319 msgstr ""
8320
8321 #. type: Plain text
8322 #: build/C/man4/sd.4:73
8323 msgid "The following I<ioctl>s are provided:"
8324 msgstr ""
8325
8326 #. type: TP
8327 #: build/C/man4/sd.4:73
8328 #, no-wrap
8329 msgid "B<HDIO_GETGEO>"
8330 msgstr ""
8331
8332 #. type: Plain text
8333 #: build/C/man4/sd.4:77
8334 msgid "Returns the BIOS disk parameters in the following structure:"
8335 msgstr ""
8336
8337 #. type: Plain text
8338 #: build/C/man4/sd.4:86
8339 #, no-wrap
8340 msgid ""
8341 "struct hd_geometry {\n"
8342 "    unsigned char  heads;\n"
8343 "    unsigned char  sectors;\n"
8344 "    unsigned short cylinders;\n"
8345 "    unsigned long  start;\n"
8346 "};\n"
8347 msgstr ""
8348
8349 #. type: Plain text
8350 #: build/C/man4/sd.4:92
8351 msgid "A pointer to this structure is passed as the B<ioctl>(2)  parameter."
8352 msgstr ""
8353
8354 #. type: Plain text
8355 #: build/C/man4/sd.4:107
8356 msgid ""
8357 "The information returned in the parameter is the disk geometry of the drive "
8358 "I<as understood by DOS!> This geometry is I<not> the physical geometry of "
8359 "the drive.  It is used when constructing the drive's partition table, "
8360 "however, and is needed for convenient operation of B<fdisk>(1), "
8361 "B<efdisk>(1), and B<lilo>(1).  If the geometry information is not available, "
8362 "zero will be returned for all of the parameters."
8363 msgstr ""
8364
8365 #. type: TP
8366 #: build/C/man4/sd.4:108
8367 #, no-wrap
8368 msgid "B<BLKGETSIZE>"
8369 msgstr ""
8370
8371 #. type: Plain text
8372 #: build/C/man4/sd.4:115
8373 msgid ""
8374 "Returns the device size in sectors.  The B<ioctl>(2)  parameter should be a "
8375 "pointer to a I<long>."
8376 msgstr ""
8377
8378 #. type: TP
8379 #: build/C/man4/sd.4:115
8380 #, no-wrap
8381 msgid "B<BLKRRPART>"
8382 msgstr ""
8383
8384 #. type: Plain text
8385 #: build/C/man4/sd.4:119
8386 msgid "Forces a reread of the SCSI disk partition tables.  No parameter is needed."
8387 msgstr ""
8388
8389 #. type: Plain text
8390 #: build/C/man4/sd.4:129
8391 msgid ""
8392 "The SCSI B<ioctl>(2)  operations are also supported.  If the B<ioctl>(2)  "
8393 "parameter is required, and it is NULL, then B<ioctl>(2)  will fail with the "
8394 "error B<EINVAL>."
8395 msgstr ""
8396
8397 #. type: Plain text
8398 #: build/C/man4/sd.4:131
8399 msgid "/dev/sd[a-h]: the whole device"
8400 msgstr ""
8401
8402 #. .SH "SEE ALSO"
8403 #. .BR scsi (4)
8404 #. type: Plain text
8405 #: build/C/man4/sd.4:135
8406 msgid "/dev/sd[a-h][0-8]: individual block partitions"
8407 msgstr ""
8408
8409 #. type: TH
8410 #: build/C/man3/setlogmask.3:23
8411 #, no-wrap
8412 msgid "SETLOGMASK"
8413 msgstr ""
8414
8415 #. type: TH
8416 #: build/C/man3/setlogmask.3:23
8417 #, no-wrap
8418 msgid "2001-10-05"
8419 msgstr ""
8420
8421 #. type: Plain text
8422 #: build/C/man3/setlogmask.3:26
8423 msgid "setlogmask - set log priority mask"
8424 msgstr ""
8425
8426 #. type: Plain text
8427 #: build/C/man3/setlogmask.3:29
8428 #, no-wrap
8429 msgid "B<#include E<lt>syslog.hE<gt>>\n"
8430 msgstr ""
8431
8432 #. type: Plain text
8433 #: build/C/man3/setlogmask.3:31
8434 #, no-wrap
8435 msgid "B<int setlogmask(int >I<mask>B<);>\n"
8436 msgstr ""
8437
8438 #. type: Plain text
8439 #: build/C/man3/setlogmask.3:41
8440 msgid ""
8441 "A process has a log priority mask that determines which calls to "
8442 "B<syslog>(3)  may be logged.  All other calls will be ignored.  Logging is "
8443 "enabled for the priorities that have the corresponding bit set in I<mask>.  "
8444 "The initial mask is such that logging is enabled for all priorities."
8445 msgstr ""
8446
8447 #. type: Plain text
8448 #: build/C/man3/setlogmask.3:47
8449 msgid ""
8450 "The B<setlogmask>()  function sets this logmask for the calling process, and "
8451 "returns the previous mask.  If the mask argument is 0, the current logmask "
8452 "is not modified."
8453 msgstr ""
8454
8455 #. type: Plain text
8456 #: build/C/man3/setlogmask.3:61
8457 msgid ""
8458 "The eight priorities are B<LOG_EMERG>, B<LOG_ALERT>, B<LOG_CRIT>, "
8459 "B<LOG_ERR>, B<LOG_WARNING>, B<LOG_NOTICE>, B<LOG_INFO>, and B<LOG_DEBUG>.  "
8460 "The bit corresponding to a priority I<p> is B<LOG_MASK>(I<p>).  Some systems "
8461 "also provide a macro B<LOG_UPTO>(I<p>) for the mask of all priorities in the "
8462 "above list up to and including I<p>."
8463 msgstr ""
8464
8465 #. type: Plain text
8466 #: build/C/man3/setlogmask.3:63
8467 msgid "This function returns the previous log priority mask."
8468 msgstr ""
8469
8470 #.  .SH NOTES
8471 #.  The glibc logmask handling was broken in versions before glibc 2.1.1.
8472 #. type: Plain text
8473 #: build/C/man3/setlogmask.3:67
8474 msgid "None."
8475 msgstr ""
8476
8477 #. type: Plain text
8478 #: build/C/man3/setlogmask.3:70
8479 msgid "POSIX.1-2001.  Note that the description in POSIX.1-2001 is flawed."
8480 msgstr ""
8481
8482 #. type: Plain text
8483 #: build/C/man3/setlogmask.3:74
8484 msgid "B<closelog>(3), B<openlog>(3), B<syslog>(3)"
8485 msgstr ""
8486
8487 #. type: TH
8488 #: build/C/man4/sk98lin.4:25
8489 #, no-wrap
8490 msgid "SK98LIN"
8491 msgstr ""
8492
8493 #. type: Plain text
8494 #: build/C/man4/sk98lin.4:28
8495 msgid "sk98lin - Marvell/SysKonnect Gigabit Ethernet driver v6.21"
8496 msgstr ""
8497
8498 #. type: Plain text
8499 #: build/C/man4/sk98lin.4:60
8500 msgid ""
8501 "B<insmod sk98lin.o> [B<Speed_A=>I<i,j,...>] [B<Speed_B=>I<i,j,...>] "
8502 "[B<AutoNeg_A=>I<i,j,...>] [B<AutoNeg_B=>I<i,j,...>] [B<DupCap_A=>I<i,j,...>] "
8503 "[B<DupCap_B=>I<i,j,...>] [B<FlowCtrl_A=>I<i,j,...>] "
8504 "[B<FlowCtrl_B=>I<i,j,...>] [B<Role_A=>I<i,j,...>] [B<Role_B=>I<i,j,...>] "
8505 "[B<ConType=>I<i,j,...>] [B<Moderation=>I<i,j,...>] "
8506 "[B<IntsPerSec=>I<i,j,...>] [B<PrefPort=>I<i,j,...>] [B<RlmtMode=>I<i,j,...>]"
8507 msgstr ""
8508
8509 #. type: Plain text
8510 #: build/C/man4/sk98lin.4:65
8511 msgid "B<Note>: This obsolete driver was removed from the kernel in version 2.6.26."
8512 msgstr ""
8513
8514 #. type: Plain text
8515 #: build/C/man4/sk98lin.4:72
8516 msgid ""
8517 "B<sk98lin> is the Gigabit Ethernet driver for Marvell and SysKonnect network "
8518 "adapter cards.  It supports SysKonnect SK-98xx/SK-95xx compliant Gigabit "
8519 "Ethernet Adapter and any Yukon compliant chipset."
8520 msgstr ""
8521
8522 #. type: Plain text
8523 #: build/C/man4/sk98lin.4:79
8524 msgid ""
8525 "When loading the driver using insmod, parameters for the network adapter "
8526 "cards might be stated as a sequence of comma separated commands.  If for "
8527 "instance two network adapters are installed and AutoNegotiation on Port A of "
8528 "the first adapter should be ON, but on the Port A of the second adapter "
8529 "switched OFF, one must enter:"
8530 msgstr ""
8531
8532 #. type: Plain text
8533 #: build/C/man4/sk98lin.4:81
8534 #, no-wrap
8535 msgid "   insmod sk98lin.o AutoNeg_A=On,Off\n"
8536 msgstr ""
8537
8538 #. type: Plain text
8539 #: build/C/man4/sk98lin.4:96
8540 msgid ""
8541 "After B<sk98lin> is bound to one or more adapter cards and the I</proc> file "
8542 "system is mounted on your system, a dedicated statistics file will be "
8543 "created in folder I</proc/net/sk98lin> for all ports of the installed "
8544 "network adapter cards.  Those files are named I<eth[x]> whereas I<x> is the "
8545 "number of the interface that has been assigned to a dedicated port by the "
8546 "system."
8547 msgstr ""
8548
8549 #. type: Plain text
8550 #: build/C/man4/sk98lin.4:106
8551 msgid ""
8552 "If loading is finished, any desired IP address can be assigned to the "
8553 "respective I<eth[x]> interface using the B<ifconfig>(8)  command.  This "
8554 "causes the adapter to connect to the Ethernet and to display a status "
8555 "message on the console saying \"ethx: network connection up using port y\" "
8556 "followed by the configured or detected connection parameters."
8557 msgstr ""
8558
8559 #. type: Plain text
8560 #: build/C/man4/sk98lin.4:122
8561 msgid ""
8562 "The B<sk98lin> also supports large frames (also called jumbo frames).  Using "
8563 "jumbo frames can improve throughput tremendously when transferring large "
8564 "amounts of data.  To enable large frames, the MTU (maximum transfer unit) "
8565 "size for an interface is to be set to a high value.  The default MTU size is "
8566 "1500 and can be changed up to 9000 (bytes).  Setting the MTU size can be "
8567 "done when assigning the IP address to the interface or later by using the "
8568 "B<ifconfig>(8)  command with the mtu parameter.  If for instance eth0 needs "
8569 "an IP address and a large frame MTU size, the following two commands might "
8570 "be used:"
8571 msgstr ""
8572
8573 #. type: Plain text
8574 #: build/C/man4/sk98lin.4:125
8575 #, no-wrap
8576 msgid ""
8577 "    ifconfig eth0 10.1.1.1\n"
8578 "    ifconfig eth0 mtu 9000\n"
8579 msgstr ""
8580
8581 #. type: Plain text
8582 #: build/C/man4/sk98lin.4:127
8583 msgid "Those two commands might even be combined into one:"
8584 msgstr ""
8585
8586 #. type: Plain text
8587 #: build/C/man4/sk98lin.4:129
8588 #, no-wrap
8589 msgid "    ifconfig eth0 10.1.1.1 mtu 9000\n"
8590 msgstr ""
8591
8592 #. type: Plain text
8593 #: build/C/man4/sk98lin.4:142
8594 msgid ""
8595 "Note that large frames can only be used if permitted by your network "
8596 "infrastructure.  This means, that any switch being used in your Ethernet "
8597 "must also support large frames.  Quite some switches support large frames, "
8598 "but need to be configured to do so.  Most of the times, their default "
8599 "setting is to support only standard frames with an MTU size of 1500 "
8600 "(bytes).  In addition to the switches inside the network, all network "
8601 "adapters that are to be used must also be enabled regarding jumbo frames.  "
8602 "If an adapter is not set to receive large frames it will simply drop them."
8603 msgstr ""
8604
8605 #. type: Plain text
8606 #: build/C/man4/sk98lin.4:146
8607 msgid ""
8608 "Switching back to the standard Ethernet frame size can be done by using the "
8609 "B<ifconfig>(8)  command again:"
8610 msgstr ""
8611
8612 #. type: Plain text
8613 #: build/C/man4/sk98lin.4:148
8614 #, no-wrap
8615 msgid "    ifconfig eth0 mtu 1500\n"
8616 msgstr ""
8617
8618 #. type: Plain text
8619 #: build/C/man4/sk98lin.4:154
8620 msgid ""
8621 "The Marvell/SysKonnect Gigabit Ethernet driver for Linux is able to support "
8622 "VLAN and Link Aggregation according to IEEE standards 802.1, 802.1q, and "
8623 "802.3ad.  Those features are only available after installation of open "
8624 "source modules which can be found on the Internet:"
8625 msgstr ""
8626
8627 #. type: Plain text
8628 #: build/C/man4/sk98lin.4:157
8629 msgid "I<VLAN>: http://www.candelatech.com/~greear/vlan.html"
8630 msgstr ""
8631
8632 #. type: Plain text
8633 #: build/C/man4/sk98lin.4:161
8634 msgid "I<Link> I<Aggregation>: http://www.st.rim.or.jp/~yumo"
8635 msgstr ""
8636
8637 #. type: Plain text
8638 #: build/C/man4/sk98lin.4:166
8639 msgid ""
8640 "Note that Marvell/SysKonnect does not offer any support for these open "
8641 "source modules and does not take the responsibility for any kind of failures "
8642 "or problems arising when using these modules."
8643 msgstr ""
8644
8645 #. type: SS
8646 #: build/C/man4/sk98lin.4:166 build/C/man4/wavelan.4:32
8647 #, no-wrap
8648 msgid "Parameters"
8649 msgstr ""
8650
8651 #. type: TP
8652 #: build/C/man4/sk98lin.4:167
8653 #, no-wrap
8654 msgid "B<Speed_A=>I<i,j,...>"
8655 msgstr ""
8656
8657 #. type: Plain text
8658 #: build/C/man4/sk98lin.4:185
8659 msgid ""
8660 "This parameter is used to set the speed capabilities of port A of an adapter "
8661 "card.  It is only valid for Yukon copper adapters.  Possible values are: "
8662 "I<10>, I<100>, I<1000> or I<Auto> whereas I<Auto> is the default.  Usually, "
8663 "the speed is negotiated between the two ports during link establishment.  If "
8664 "this fails, a port can be forced to a specific setting with this parameter."
8665 msgstr ""
8666
8667 #. type: TP
8668 #: build/C/man4/sk98lin.4:185
8669 #, no-wrap
8670 msgid "B<Speed_B=>I<i,j,...>"
8671 msgstr ""
8672
8673 #. type: Plain text
8674 #: build/C/man4/sk98lin.4:203
8675 msgid ""
8676 "This parameter is used to set the speed capabilities of port B of an adapter "
8677 "card.  It is only valid for Yukon copper adapters.  Possible values are: "
8678 "I<10>, I<100>, I<1000> or I<Auto> whereas I<Auto> is the default.  Usually, "
8679 "the speed is negotiated between the two ports during link establishment.  If "
8680 "this fails, a port can be forced to a specific setting with this parameter."
8681 msgstr ""
8682
8683 #. type: TP
8684 #: build/C/man4/sk98lin.4:203
8685 #, no-wrap
8686 msgid "B<AutoNeg_A=>I<i,j,...>"
8687 msgstr ""
8688
8689 #. type: Plain text
8690 #: build/C/man4/sk98lin.4:218
8691 msgid ""
8692 "Enables or disables the use of autonegotiation of port A of an adapter "
8693 "card.  Possible values are: I<On>, I<Off> or I<Sense> whereas I<On> is the "
8694 "default.  The I<Sense> mode automatically detects whether the link partner "
8695 "supports auto-negotiation or not."
8696 msgstr ""
8697
8698 #. type: TP
8699 #: build/C/man4/sk98lin.4:218
8700 #, no-wrap
8701 msgid "B<AutoNeg_B=>I<i,j,...>"
8702 msgstr ""
8703
8704 #. type: Plain text
8705 #: build/C/man4/sk98lin.4:233
8706 msgid ""
8707 "Enables or disables the use of autonegotiation of port B of an adapter "
8708 "card.  Possible values are: I<On>, I<Off> or I<Sense> whereas I<On> is the "
8709 "default.  The I<Sense> mode automatically detects whether the link partner "
8710 "supports auto-negotiation or not."
8711 msgstr ""
8712
8713 #. type: TP
8714 #: build/C/man4/sk98lin.4:233
8715 #, no-wrap
8716 msgid "B<DupCap_A=>I<i,j,...>"
8717 msgstr ""
8718
8719 #. type: Plain text
8720 #: build/C/man4/sk98lin.4:264
8721 msgid ""
8722 "This parameter indicates the duplex mode to be used for port A of an adapter "
8723 "card.  Possible values are: I<Half>, I<Full> or I<Both> whereas I<Both> is "
8724 "the default.  This parameter is only relevant if AutoNeg_A of port A is not "
8725 "set to I<Sense>.  If AutoNeg_A is set to I<On>, all three values of DupCap_A "
8726 "( I<Half>, I<Full> or I<Both>)  might be stated.  If AutoNeg_A is set to "
8727 "I<Off>, only DupCap_A values I<Full> and I<Half> are allowed.  This DupCap_A "
8728 "parameter is useful if your link partner does not support all possible "
8729 "duplex combinations."
8730 msgstr ""
8731
8732 #. type: TP
8733 #: build/C/man4/sk98lin.4:264
8734 #, no-wrap
8735 msgid "B<DupCap_B=>I<i,j,...>"
8736 msgstr ""
8737
8738 #. type: Plain text
8739 #: build/C/man4/sk98lin.4:295
8740 msgid ""
8741 "This parameter indicates the duplex mode to be used for port B of an adapter "
8742 "card.  Possible values are: I<Half>, I<Full> or I<Both> whereas I<Both> is "
8743 "the default.  This parameter is only relevant if AutoNeg_B of port B is not "
8744 "set to I<Sense>.  If AutoNeg_B is set to I<On>, all three values of DupCap_B "
8745 "( I<Half>, I<Full> or I<Both>)  might be stated.  If AutoNeg_B is set to "
8746 "I<Off>, only DupCap_B values I<Full> and I<Half> are allowed.  This DupCap_B "
8747 "parameter is useful if your link partner does not support all possible "
8748 "duplex combinations."
8749 msgstr ""
8750
8751 #. type: TP
8752 #: build/C/man4/sk98lin.4:295
8753 #, no-wrap
8754 msgid "B<FlowCtrl_A=>I<i,j,...>"
8755 msgstr ""
8756
8757 #. type: Plain text
8758 #: build/C/man4/sk98lin.4:309 build/C/man4/sk98lin.4:343
8759 msgid ""
8760 "This parameter can be used to set the flow control capabilities the port "
8761 "reports during auto-negotiation.  Possible values are: I<Sym>, I<SymOrRem>, "
8762 "I<LocSend> or I<None> whereas I<SymOrRem> is the default.  The different "
8763 "modes have the following meaning:"
8764 msgstr ""
8765
8766 #. type: Plain text
8767 #: build/C/man4/sk98lin.4:314 build/C/man4/sk98lin.4:347
8768 #, no-wrap
8769 msgid ""
8770 "I<Sym>\n"
8771 "= Symmetric\n"
8772 " both link partners are allowed to send PAUSE frames\n"
8773 msgstr ""
8774
8775 #. type: Plain text
8776 #: build/C/man4/sk98lin.4:318 build/C/man4/sk98lin.4:351
8777 #, no-wrap
8778 msgid ""
8779 "I<SymOrRem>\n"
8780 "= SymmetricOrRemote\n"
8781 " both or only remote partner are allowed to send PAUSE frames\n"
8782 msgstr ""
8783
8784 #. type: Plain text
8785 #: build/C/man4/sk98lin.4:322 build/C/man4/sk98lin.4:355
8786 #, no-wrap
8787 msgid ""
8788 "I<LocSend>\n"
8789 "= LocalSend\n"
8790 " only local link partner is allowed to send PAUSE frames\n"
8791 msgstr ""
8792
8793 #. type: Plain text
8794 #: build/C/man4/sk98lin.4:326 build/C/man4/sk98lin.4:359
8795 #, no-wrap
8796 msgid ""
8797 "I<None>\n"
8798 "= None\n"
8799 " no link partner is allowed to send PAUSE frames\n"
8800 msgstr ""
8801
8802 #. type: Plain text
8803 #: build/C/man4/sk98lin.4:329
8804 msgid "Note that this parameter is ignored if AutoNeg_A is set to I<Off>."
8805 msgstr ""
8806
8807 #. type: TP
8808 #: build/C/man4/sk98lin.4:329
8809 #, no-wrap
8810 msgid "B<FlowCtrl_B=>I<i,j,...>"
8811 msgstr ""
8812
8813 #. type: Plain text
8814 #: build/C/man4/sk98lin.4:363
8815 msgid "Note that this parameter is ignored if AutoNeg_B is set to I<Off>."
8816 msgstr ""
8817
8818 #. type: TP
8819 #: build/C/man4/sk98lin.4:363
8820 #, no-wrap
8821 msgid "B<Role_A=>I<i,j,...>"
8822 msgstr ""
8823
8824 #. type: Plain text
8825 #: build/C/man4/sk98lin.4:380
8826 msgid ""
8827 "This parameter is only valid for 1000Base-T adapter cards.  For two "
8828 "1000Base-T ports to communicate, one must take the role of the master "
8829 "(providing timing information), while the other must be the slave.  Possible "
8830 "values are: I<Auto>, I<Master> or I<Slave> whereas I<Auto> is the default.  "
8831 "Usually, the role of a port is negotiated between two ports during link "
8832 "establishment, but if that fails the port A of an adapter card can be forced "
8833 "to a specific setting with this parameter."
8834 msgstr ""
8835
8836 #. type: TP
8837 #: build/C/man4/sk98lin.4:380
8838 #, no-wrap
8839 msgid "B<Role_B=>I<i,j,...>"
8840 msgstr ""
8841
8842 #. type: Plain text
8843 #: build/C/man4/sk98lin.4:398
8844 msgid ""
8845 "This parameter is only valid for 1000Base-T adapter cards.  For two "
8846 "1000Base-T ports to communicate, one must take the role of the master "
8847 "(providing timing information), while the other must be the slave.  Possible "
8848 "values are: I<Auto>, I<Master> or I<Slave> whereas I<Auto> is the default.  "
8849 "Usually, the role of a port is negotiated between two ports during link "
8850 "establishment, but if that fails the port B of an adapter card can be forced "
8851 "to a specific setting with this parameter."
8852 msgstr ""
8853
8854 #. type: TP
8855 #: build/C/man4/sk98lin.4:398
8856 #, no-wrap
8857 msgid "B<ConType=>I<i,j,...>"
8858 msgstr ""
8859
8860 #. type: Plain text
8861 #: build/C/man4/sk98lin.4:406
8862 msgid ""
8863 "This parameter is a combination of all five per-port parameters within one "
8864 "single parameter.  This simplifies the configuration of both ports of an "
8865 "adapter card.  The different values of this variable reflect the most "
8866 "meaningful combinations of port parameters.  Possible values and their "
8867 "corresponding combination of per-port parameters:"
8868 msgstr ""
8869
8870 #. type: Plain text
8871 #: build/C/man4/sk98lin.4:411
8872 #, no-wrap
8873 msgid ""
8874 "ConType | DupCap   AutoNeg   FlowCtrl   Role   Speed\n"
8875 "--------+-------------------------------------------\n"
8876 "I<Auto>    |  Both      On      SymOrRem   Auto   Auto\n"
8877 msgstr ""
8878
8879 #. type: Plain text
8880 #: build/C/man4/sk98lin.4:413
8881 #, no-wrap
8882 msgid "I<100FD>   |  Full      Off       None     Auto   100\n"
8883 msgstr ""
8884
8885 #. type: Plain text
8886 #: build/C/man4/sk98lin.4:415
8887 #, no-wrap
8888 msgid "I<100HD>   |  Half      Off       None     Auto   100\n"
8889 msgstr ""
8890
8891 #. type: Plain text
8892 #: build/C/man4/sk98lin.4:417
8893 #, no-wrap
8894 msgid "I<10FD>    |  Full      Off       None     Auto   10\n"
8895 msgstr ""
8896
8897 #. type: Plain text
8898 #: build/C/man4/sk98lin.4:419
8899 #, no-wrap
8900 msgid "I<10HD>    |  Half      Off       None     Auto   10\n"
8901 msgstr ""
8902
8903 #. type: Plain text
8904 #: build/C/man4/sk98lin.4:429
8905 msgid ""
8906 "Stating any other port parameter together with this I<ConType> parameter "
8907 "will result in a merged configuration of those settings.  This is due to the "
8908 "fact, that the per-port parameters (e.g., I<Speed_A>)  have a higher "
8909 "priority than the combined variable I<ConType>."
8910 msgstr ""
8911
8912 #. type: TP
8913 #: build/C/man4/sk98lin.4:429
8914 #, no-wrap
8915 msgid "B<Moderation=>I<i,j,...>"
8916 msgstr ""
8917
8918 #. type: Plain text
8919 #: build/C/man4/sk98lin.4:447
8920 msgid ""
8921 "Interrupt moderation is employed to limit the maximum number of interrupts "
8922 "the driver has to serve.  That is, one or more interrupts (which indicate "
8923 "any transmit or receive packet to be processed) are queued until the driver "
8924 "processes them.  When queued interrupts are to be served, is determined by "
8925 "the I<IntsPerSec> parameter, which is explained later below.  Possible "
8926 "moderation modes are: I<None>, I<Static> or I<Dynamic> whereas I<None> is "
8927 "the default.  The different modes have the following meaning:"
8928 msgstr ""
8929
8930 #. type: Plain text
8931 #: build/C/man4/sk98lin.4:452
8932 msgid ""
8933 "I<None> No interrupt moderation is applied on the adapter card.  Therefore, "
8934 "each transmit or receive interrupt is served immediately as soon as it "
8935 "appears on the interrupt line of the adapter card."
8936 msgstr ""
8937
8938 #. type: Plain text
8939 #: build/C/man4/sk98lin.4:467
8940 msgid ""
8941 "I<Static> Interrupt moderation is applied on the adapter card.  All transmit "
8942 "and receive interrupts are queued until a complete moderation interval "
8943 "ends.  If such a moderation interval ends, all queued interrupts are "
8944 "processed in one big bunch without any delay.  The term I<Static> reflects "
8945 "the fact, that interrupt moderation is always enabled, regardless how much "
8946 "network load is currently passing via a particular interface.  In addition, "
8947 "the duration of the moderation interval has a fixed length that never "
8948 "changes while the driver is operational."
8949 msgstr ""
8950
8951 #. type: Plain text
8952 #: build/C/man4/sk98lin.4:478
8953 msgid ""
8954 "I<Dynamic> Interrupt moderation might be applied on the adapter card, "
8955 "depending on the load of the system.  If the driver detects that the system "
8956 "load is too high, the driver tries to shield the system against too much "
8957 "network load by enabling interrupt moderation.  If\\(emat a later "
8958 "time\\(emthe CPU utilization decreases again (or if the network load is "
8959 "negligible) the interrupt moderation will automatically be disabled."
8960 msgstr ""
8961
8962 #. type: Plain text
8963 #: build/C/man4/sk98lin.4:484
8964 msgid ""
8965 "Interrupt moderation should be used when the driver has to handle one or "
8966 "more interfaces with a high network load, which\\(emas a "
8967 "consequence\\(emleads also to a high CPU utilization.  When moderation is "
8968 "applied in such high network load situations, CPU load might be reduced by "
8969 "20-30% on slow computers."
8970 msgstr ""
8971
8972 #. type: Plain text
8973 #: build/C/man4/sk98lin.4:488
8974 msgid ""
8975 "Note that the drawback of using interrupt moderation is an increase of the "
8976 "round-trip-time (RTT), due to the queuing and serving of interrupts at "
8977 "dedicated moderation times."
8978 msgstr ""
8979
8980 #. type: TP
8981 #: build/C/man4/sk98lin.4:488
8982 #, no-wrap
8983 msgid "B<IntsPerSec=>I<i,j,...>"
8984 msgstr ""
8985
8986 #. type: Plain text
8987 #: build/C/man4/sk98lin.4:498
8988 msgid ""
8989 "This parameter determines the length of any interrupt moderation interval.  "
8990 "Assuming that static interrupt moderation is to be used, an I<IntsPerSec> "
8991 "parameter value of 2000 will lead to an interrupt moderation interval of 500 "
8992 "microseconds.  Possible values for this parameter are in the range of "
8993 "30...40000 (interrupts per second).  The default value is 2000."
8994 msgstr ""
8995
8996 #. type: Plain text
8997 #: build/C/man4/sk98lin.4:502
8998 msgid ""
8999 "This parameter is only used, if either static or dynamic interrupt "
9000 "moderation is enabled on a network adapter card.  This parameter is ignored "
9001 "if no moderation is applied."
9002 msgstr ""
9003
9004 #. type: Plain text
9005 #: build/C/man4/sk98lin.4:509
9006 msgid ""
9007 "Note that the duration of the moderation interval is to be chosen with "
9008 "care.  At first glance, selecting a very long duration (e.g., only 100 "
9009 "interrupts per second) seems to be meaningful, but the increase of "
9010 "packet-processing delay is tremendous.  On the other hand, selecting a very "
9011 "short moderation time might compensate the use of any moderation being "
9012 "applied."
9013 msgstr ""
9014
9015 #. type: TP
9016 #: build/C/man4/sk98lin.4:509
9017 #, no-wrap
9018 msgid "B<PrefPort=>I<i,j,...>"
9019 msgstr ""
9020
9021 #. type: Plain text
9022 #: build/C/man4/sk98lin.4:522
9023 msgid ""
9024 "This parameter is used to force the preferred port to A or B (on dual-port "
9025 "network adapters).  The preferred port is the one that is used if both ports "
9026 "A and B are detected as fully functional.  Possible values are: I<A> or I<B> "
9027 "whereas I<A> is the default."
9028 msgstr ""
9029
9030 #. type: TP
9031 #: build/C/man4/sk98lin.4:522
9032 #, no-wrap
9033 msgid "B<RlmtMode=>I<i,j,...>"
9034 msgstr ""
9035
9036 #. type: Plain text
9037 #: build/C/man4/sk98lin.4:539
9038 msgid ""
9039 "RLMT monitors the status of the port.  If the link of the active port fails, "
9040 "RLMT switches immediately to the standby link.  The virtual link is "
9041 "maintained as long as at least one \"physical\" link is up.  This parameters "
9042 "states how RLMT should monitor both ports.  Possible values are: "
9043 "I<CheckLinkState>, I<CheckLocalPort>, I<CheckSeg> or I<DualNet> whereas "
9044 "I<CheckLinkState> is the default.  The different modes have the following "
9045 "meaning:"
9046 msgstr ""
9047
9048 #. type: Plain text
9049 #: build/C/man4/sk98lin.4:544
9050 msgid ""
9051 "I<CheckLinkState> Check link state only: RLMT uses the link state reported "
9052 "by the adapter hardware for each individual port to determine whether a port "
9053 "can be used for all network traffic or not."
9054 msgstr ""
9055
9056 #. type: Plain text
9057 #: build/C/man4/sk98lin.4:552
9058 msgid ""
9059 "I<CheckLocalPort> In this mode, RLMT monitors the network path between the "
9060 "two ports of an adapter by regularly exchanging packets between them.  This "
9061 "mode requires a network configuration in which the two ports are able to "
9062 "\"see\" each other (i.e., there must not be any router between the ports)."
9063 msgstr ""
9064
9065 #. type: Plain text
9066 #: build/C/man4/sk98lin.4:561
9067 msgid ""
9068 "I<CheckSeg> Check local port and segmentation: This mode supports the same "
9069 "functions as the CheckLocalPort mode and additionally checks network "
9070 "segmentation between the ports.  Therefore, this mode is only to be used if "
9071 "Gigabit Ethernet switches are installed on the network that have been "
9072 "configured to use the Spanning Tree protocol."
9073 msgstr ""
9074
9075 #. type: Plain text
9076 #: build/C/man4/sk98lin.4:572
9077 msgid ""
9078 "I<DualNet> In this mode, ports A and B are used as separate devices.  If you "
9079 "have a dual port adapter, port A will be configured as I<eth[x]> and port B "
9080 "as I<eth[x+1]>.  Both ports can be used independently with distinct IP "
9081 "addresses.  The preferred port setting is not used.  RLMT is turned off."
9082 msgstr ""
9083
9084 #. type: Plain text
9085 #: build/C/man4/sk98lin.4:581
9086 msgid ""
9087 "Note that RLMT modes I<CheckLocalPort> and I<CheckLinkState> are designed to "
9088 "operate in configurations where a network path between the ports on one "
9089 "adapter exists.  Moreover, they are not designed to work where adapters are "
9090 "connected back-to-back."
9091 msgstr ""
9092
9093 #. type: TP
9094 #: build/C/man4/sk98lin.4:582
9095 #, no-wrap
9096 msgid "I</proc/net/sk98lin/eth[x]>"
9097 msgstr ""
9098
9099 #. type: Plain text
9100 #: build/C/man4/sk98lin.4:588
9101 msgid ""
9102 "The statistics file of a particular interface of an adapter card.  It "
9103 "contains generic information about the adapter card plus a detailed summary "
9104 "of all transmit and receive counters."
9105 msgstr ""
9106
9107 #. type: TP
9108 #: build/C/man4/sk98lin.4:588
9109 #, no-wrap
9110 msgid "I</usr/src/linux/Documentation/networking/sk98lin.txt>"
9111 msgstr ""
9112
9113 #. type: Plain text
9114 #: build/C/man4/sk98lin.4:599
9115 msgid ""
9116 "This is the I<README> file of the I<sk98lin> driver.  It contains a detailed "
9117 "installation HOWTO and describes all parameters of the driver.  It denotes "
9118 "also common problems and provides the solution to them."
9119 msgstr ""
9120
9121 #.  .SH AUTHORS
9122 #.  Ralph Roesler \(em rroesler@syskonnect.de
9123 #.  .br
9124 #.  Mirko Lindner \(em mlindner@syskonnect.de
9125 #. type: Plain text
9126 #: build/C/man4/sk98lin.4:605
9127 msgid "Report any bugs to linux@syskonnect.de"
9128 msgstr ""
9129
9130 #. type: Plain text
9131 #: build/C/man4/sk98lin.4:609
9132 msgid "B<ifconfig>(8), B<insmod>(8), B<modprobe>(8)"
9133 msgstr ""
9134
9135 #. type: TH
9136 #: build/C/man4/st.4:23
9137 #, no-wrap
9138 msgid "ST"
9139 msgstr ""
9140
9141 #. type: Plain text
9142 #: build/C/man4/st.4:26
9143 msgid "st - SCSI tape device"
9144 msgstr ""
9145
9146 #. type: Plain text
9147 #: build/C/man4/st.4:29
9148 #, no-wrap
9149 msgid "B<#include E<lt>sys/mtio.hE<gt>>\n"
9150 msgstr ""
9151
9152 #. type: Plain text
9153 #: build/C/man4/st.4:34
9154 #, no-wrap
9155 msgid ""
9156 "B<int ioctl(int >I<fd>B<, int >I<request>B< [, (void *)>I<arg3>B<]);>\n"
9157 "B<int ioctl(int >I<fd>B<, MTIOCTOP, (struct mtop *)>I<mt_cmd>B<);>\n"
9158 "B<int ioctl(int >I<fd>B<, MTIOCGET, (struct mtget *)>I<mt_status>B<);>\n"
9159 "B<int ioctl(int >I<fd>B<, MTIOCPOS, (struct mtpos *)>I<mt_pos>B<);>\n"
9160 msgstr ""
9161
9162 #. type: Plain text
9163 #: build/C/man4/st.4:44
9164 msgid ""
9165 "The B<st> driver provides the interface to a variety of SCSI tape devices.  "
9166 "Currently, the driver takes control of all detected devices of type "
9167 "\\(lqsequential-access\\(rq.  The B<st> driver uses major device number 9."
9168 msgstr ""
9169
9170 #. type: Plain text
9171 #: build/C/man4/st.4:64
9172 msgid ""
9173 "Each device uses eight minor device numbers.  The lowermost five bits in the "
9174 "minor numbers are assigned sequentially in the order of detection.  In the "
9175 "2.6 kernel, the bits above the eight lowermost bits are concatenated to the "
9176 "five lowermost bits to form the tape number.  The minor numbers can be "
9177 "grouped into two sets of four numbers: the principal (auto-rewind) minor "
9178 "device numbers, I<n>, and the \\(lqno-rewind\\(rq device numbers, (I<n> + "
9179 "128).  Devices opened using the principal device number will be sent a "
9180 "B<REWIND> command when they are closed.  Devices opened using the "
9181 "\\(lqno-rewind\\(rq device number will not.  (Note that using an auto-rewind "
9182 "device for positioning the tape with, for instance, mt does not lead to the "
9183 "desired result: the tape is rewound after the mt command and the next "
9184 "command starts from the beginning of the tape)."
9185 msgstr ""
9186
9187 #. type: Plain text
9188 #: build/C/man4/st.4:78
9189 msgid ""
9190 "Within each group, four minor numbers are available to define devices with "
9191 "different characteristics (block size, compression, density, etc.)  When the "
9192 "system starts up, only the first device is available.  The other three are "
9193 "activated when the default characteristics are defined (see below).  (By "
9194 "changing compile-time constants, it is possible to change the balance "
9195 "between the maximum number of tape drives and the number of minor numbers "
9196 "for each drive.  The default allocation allows control of 32 tape drives.  "
9197 "For instance, it is possible to control up to 64 tape drives with two minor "
9198 "numbers for different options.)"
9199 msgstr ""
9200
9201 #. type: Plain text
9202 #: build/C/man4/st.4:80
9203 msgid "Devices are typically created by:"
9204 msgstr ""
9205
9206 #. type: Plain text
9207 #: build/C/man4/st.4:91
9208 #, no-wrap
9209 msgid ""
9210 "mknod -m 666 /dev/st0 c 9 0\n"
9211 "mknod -m 666 /dev/st0l c 9 32\n"
9212 "mknod -m 666 /dev/st0m c 9 64\n"
9213 "mknod -m 666 /dev/st0a c 9 96\n"
9214 "mknod -m 666 /dev/nst0 c 9 128\n"
9215 "mknod -m 666 /dev/nst0l c 9 160\n"
9216 "mknod -m 666 /dev/nst0m c 9 192\n"
9217 "mknod -m 666 /dev/nst0a c 9 224\n"
9218 msgstr ""
9219
9220 #. type: Plain text
9221 #: build/C/man4/st.4:95
9222 msgid "There is no corresponding block device."
9223 msgstr ""
9224
9225 #. type: Plain text
9226 #: build/C/man4/st.4:110
9227 msgid ""
9228 "The driver uses an internal buffer that has to be large enough to hold at "
9229 "least one tape block.  In kernels before 2.1.121, the buffer is allocated as "
9230 "one contiguous block.  This limits the block size to the largest contiguous "
9231 "block of memory the kernel allocator can provide.  The limit is currently "
9232 "128 kB for 32-bit architectures and 256 kB for 64-bit architectures.  In "
9233 "newer kernels the driver allocates the buffer in several parts if "
9234 "necessary.  By default, the maximum number of parts is 16.  This means that "
9235 "the maximum block size is very large (2 MB if allocation of 16 blocks of 128 "
9236 "kB succeeds)."
9237 msgstr ""
9238
9239 #. type: Plain text
9240 #: build/C/man4/st.4:119
9241 msgid ""
9242 "The driver's internal buffer size is determined by a compile-time constant "
9243 "which can be overridden with a kernel startup option.  In addition to this, "
9244 "the driver tries to allocate a larger temporary buffer at run time if "
9245 "necessary.  However, run-time allocation of large contiguous blocks of "
9246 "memory may fail and it is advisable not to rely too much on dynamic buffer "
9247 "allocation with kernels older than 2.1.121 (this applies also to "
9248 "demand-loading the driver with kerneld or kmod)."
9249 msgstr ""
9250
9251 #. type: Plain text
9252 #: build/C/man4/st.4:132
9253 msgid ""
9254 "The driver does not specifically support any tape drive brand or model.  "
9255 "After system start-up the tape device options are defined by the drive "
9256 "firmware.  For example, if the drive firmware selects fixed-block mode, the "
9257 "tape device uses fixed-block mode.  The options can be changed with explicit "
9258 "B<ioctl>(2)  calls and remain in effect when the device is closed and "
9259 "reopened.  Setting the options affects both the auto-rewind and the "
9260 "nonrewind device."
9261 msgstr ""
9262
9263 #. type: Plain text
9264 #: build/C/man4/st.4:141
9265 msgid ""
9266 "Different options can be specified for the different devices within the "
9267 "subgroup of four.  The options take effect when the device is opened.  For "
9268 "example, the system administrator can define one device that writes in "
9269 "fixed-block mode with a certain block size, and one which writes in "
9270 "variable-block mode (if the drive supports both modes)."
9271 msgstr ""
9272
9273 #. type: Plain text
9274 #: build/C/man4/st.4:164
9275 msgid ""
9276 "The driver supports B<tape partitions> if they are supported by the drive.  "
9277 "(Note that the tape partitions have nothing to do with disk partitions.  A "
9278 "partitioned tape can be seen as several logical tapes within one medium.)  "
9279 "Partition support has to be enabled with an B<ioctl>(2).  The tape location "
9280 "is preserved within each partition across partition changes.  The partition "
9281 "used for subsequent tape operations is selected with an B<ioctl>(2).  The "
9282 "partition switch is executed together with the next tape operation in order "
9283 "to avoid unnecessary tape movement.  The maximum number of partitions on a "
9284 "tape is defined by a compile-time constant (originally four).  The driver "
9285 "contains an B<ioctl>(2)  that can format a tape with either one or two "
9286 "partitions."
9287 msgstr ""
9288
9289 #. type: Plain text
9290 #: build/C/man4/st.4:169
9291 msgid ""
9292 "Device I</dev/tape> is usually created as a hard or soft link to the default "
9293 "tape device on the system."
9294 msgstr ""
9295
9296 #. type: Plain text
9297 #: build/C/man4/st.4:173
9298 msgid ""
9299 "Starting from kernel 2.6.2, the driver exports in the sysfs directory "
9300 "I</sys/class/scsi_tape> the attached devices and some parameters assigned to "
9301 "the devices."
9302 msgstr ""
9303
9304 #. type: SS
9305 #: build/C/man4/st.4:173
9306 #, no-wrap
9307 msgid "Data Transfer"
9308 msgstr ""
9309
9310 #. type: Plain text
9311 #: build/C/man4/st.4:186
9312 msgid ""
9313 "The driver supports operation in both fixed-block mode and variable-block "
9314 "mode (if supported by the drive).  In fixed-block mode the drive writes "
9315 "blocks of the specified size and the block size is not dependent on the byte "
9316 "counts of the write system calls.  In variable-block mode one tape block is "
9317 "written for each write call and the byte count determines the size of the "
9318 "corresponding tape block.  Note that the blocks on the tape don't contain "
9319 "any information about the writing mode: when reading, the only important "
9320 "thing is to use commands that accept the block sizes on the tape."
9321 msgstr ""
9322
9323 #. type: Plain text
9324 #: build/C/man4/st.4:195
9325 msgid ""
9326 "In variable-block mode the read byte count does not have to match the tape "
9327 "block size exactly.  If the byte count is larger than the next block on "
9328 "tape, the driver returns the data and the function returns the actual block "
9329 "size.  If the block size is larger than the byte count, the requested amount "
9330 "of data from the start of the block is returned and the rest of the block is "
9331 "discarded."
9332 msgstr ""
9333
9334 #. type: Plain text
9335 #: build/C/man4/st.4:204
9336 msgid ""
9337 "In fixed-block mode the read byte counts can be arbitrary if buffering is "
9338 "enabled, or a multiple of the tape block size if buffering is disabled.  "
9339 "Kernels before 2.1.121 allow writes with arbitrary byte count if buffering "
9340 "is enabled.  In all other cases (kernel before 2.1.121 with buffering "
9341 "disabled or newer kernel) the write byte count must be a multiple of the "
9342 "tape block size."
9343 msgstr ""
9344
9345 #. type: Plain text
9346 #: build/C/man4/st.4:213
9347 msgid ""
9348 "In the 2.6 kernel, the driver tries to use direct transfers between the user "
9349 "buffer and the device.  If this is not possible, the driver's internal "
9350 "buffer is used.  The reasons for not using direct transfers include improper "
9351 "alignment of the user buffer (default is 512 bytes but this can be changed "
9352 "by the HBA driver), one of more pages of the user buffer not reachable by "
9353 "the SCSI adapter, etc."
9354 msgstr ""
9355
9356 #. type: Plain text
9357 #: build/C/man4/st.4:216
9358 msgid ""
9359 "A filemark is automatically written to tape if the last tape operation "
9360 "before close was a write."
9361 msgstr ""
9362
9363 #. type: Plain text
9364 #: build/C/man4/st.4:228
9365 msgid ""
9366 "When a filemark is encountered while reading, the following happens.  If "
9367 "there are data remaining in the buffer when the filemark is found, the "
9368 "buffered data is returned.  The next read returns zero bytes.  The following "
9369 "read returns data from the next file.  The end of recorded data is signaled "
9370 "by returning zero bytes for two consecutive read calls.  The third read "
9371 "returns an error."
9372 msgstr ""
9373
9374 #. type: SS
9375 #: build/C/man4/st.4:228
9376 #, no-wrap
9377 msgid "Ioctls"
9378 msgstr ""
9379
9380 #. type: Plain text
9381 #: build/C/man4/st.4:239
9382 msgid ""
9383 "The driver supports three B<ioctl>(2)  requests.  Requests not recognized by "
9384 "the B<st> driver are passed to the B<SCSI> driver.  The definitions below "
9385 "are from I</usr/include/linux/mtio.h>:"
9386 msgstr ""
9387
9388 #. type: SS
9389 #: build/C/man4/st.4:239
9390 #, no-wrap
9391 msgid "MTIOCTOP \\(em Perform a tape operation"
9392 msgstr ""
9393
9394 #. type: Plain text
9395 #: build/C/man4/st.4:247
9396 msgid ""
9397 "This request takes an argument of type I<(struct mtop *)>.  Not all drives "
9398 "support all operations.  The driver returns an B<EIO> error if the drive "
9399 "rejects an operation."
9400 msgstr ""
9401
9402 #. type: Plain text
9403 #: build/C/man4/st.4:255
9404 #, no-wrap
9405 msgid ""
9406 "/* Structure for MTIOCTOP - mag tape op command: */\n"
9407 "struct mtop {\n"
9408 "    short   mt_op;       /* operations defined below */\n"
9409 "    int     mt_count;    /* how many of them */\n"
9410 "};\n"
9411 msgstr ""
9412
9413 #. type: Plain text
9414 #: build/C/man4/st.4:259
9415 msgid "Magnetic Tape operations for normal tape use:"
9416 msgstr ""
9417
9418 #. type: TP
9419 #: build/C/man4/st.4:259
9420 #, no-wrap
9421 msgid "B<MTBSF>"
9422 msgstr ""
9423
9424 #. type: Plain text
9425 #: build/C/man4/st.4:264
9426 msgid "Backward space over I<mt_count> filemarks."
9427 msgstr ""
9428
9429 #. type: TP
9430 #: build/C/man4/st.4:264
9431 #, no-wrap
9432 msgid "B<MTBSFM>"
9433 msgstr ""
9434
9435 #. type: Plain text
9436 #: build/C/man4/st.4:270
9437 msgid ""
9438 "Backward space over I<mt_count> filemarks.  Reposition the tape to the EOT "
9439 "side of the last filemark."
9440 msgstr ""
9441
9442 #. type: TP
9443 #: build/C/man4/st.4:270
9444 #, no-wrap
9445 msgid "B<MTBSR>"
9446 msgstr ""
9447
9448 #. type: Plain text
9449 #: build/C/man4/st.4:275
9450 msgid "Backward space over I<mt_count> records (tape blocks)."
9451 msgstr ""
9452
9453 #. type: TP
9454 #: build/C/man4/st.4:275
9455 #, no-wrap
9456 msgid "B<MTBSS>"
9457 msgstr ""
9458
9459 #. type: Plain text
9460 #: build/C/man4/st.4:280
9461 msgid "Backward space over I<mt_count> setmarks."
9462 msgstr ""
9463
9464 #. type: TP
9465 #: build/C/man4/st.4:280
9466 #, no-wrap
9467 msgid "B<MTCOMPRESSION>"
9468 msgstr ""
9469
9470 #. type: Plain text
9471 #: build/C/man4/st.4:288
9472 msgid ""
9473 "Enable compression of tape data within the drive if I<mt_count> is nonzero "
9474 "and disable compression if I<mt_count> is zero.  This command uses the MODE "
9475 "page 15 supported by most DATs."
9476 msgstr ""
9477
9478 #. type: TP
9479 #: build/C/man4/st.4:288
9480 #, no-wrap
9481 msgid "B<MTEOM>"
9482 msgstr ""
9483
9484 #. type: Plain text
9485 #: build/C/man4/st.4:291
9486 msgid "Go to the end of the recorded media (for appending files)."
9487 msgstr ""
9488
9489 #. type: TP
9490 #: build/C/man4/st.4:291
9491 #, no-wrap
9492 msgid "B<MTERASE>"
9493 msgstr ""
9494
9495 #. type: Plain text
9496 #: build/C/man4/st.4:297
9497 msgid ""
9498 "Erase tape.  With 2.6 kernel, short erase (mark tape empty) is performed if "
9499 "the argument is zero.  Otherwise long erase (erase all) is done."
9500 msgstr ""
9501
9502 #. type: TP
9503 #: build/C/man4/st.4:297
9504 #, no-wrap
9505 msgid "B<MTFSF>"
9506 msgstr ""
9507
9508 #. type: Plain text
9509 #: build/C/man4/st.4:302
9510 msgid "Forward space over I<mt_count> filemarks."
9511 msgstr ""
9512
9513 #. type: TP
9514 #: build/C/man4/st.4:302
9515 #, no-wrap
9516 msgid "B<MTFSFM>"
9517 msgstr ""
9518
9519 #. type: Plain text
9520 #: build/C/man4/st.4:308
9521 msgid ""
9522 "Forward space over I<mt_count> filemarks.  Reposition the tape to the BOT "
9523 "side of the last filemark."
9524 msgstr ""
9525
9526 #. type: TP
9527 #: build/C/man4/st.4:308
9528 #, no-wrap
9529 msgid "B<MTFSR>"
9530 msgstr ""
9531
9532 #. type: Plain text
9533 #: build/C/man4/st.4:313
9534 msgid "Forward space over I<mt_count> records (tape blocks)."
9535 msgstr ""
9536
9537 #. type: TP
9538 #: build/C/man4/st.4:313
9539 #, no-wrap
9540 msgid "B<MTFSS>"
9541 msgstr ""
9542
9543 #. type: Plain text
9544 #: build/C/man4/st.4:318
9545 msgid "Forward space over I<mt_count> setmarks."
9546 msgstr ""
9547
9548 #. type: TP
9549 #: build/C/man4/st.4:318
9550 #, no-wrap
9551 msgid "B<MTLOAD>"
9552 msgstr ""
9553
9554 #. type: Plain text
9555 #: build/C/man4/st.4:329
9556 msgid ""
9557 "Execute the SCSI load command.  A special case is available for some HP "
9558 "autoloaders.  If I<mt_count> is the constant B<MT_ST_HPLOADER_OFFSET> plus a "
9559 "number, the number is sent to the drive to control the autoloader."
9560 msgstr ""
9561
9562 #. type: TP
9563 #: build/C/man4/st.4:329
9564 #, no-wrap
9565 msgid "B<MTLOCK>"
9566 msgstr ""
9567
9568 #. type: Plain text
9569 #: build/C/man4/st.4:332
9570 msgid "Lock the tape drive door."
9571 msgstr ""
9572
9573 #. type: TP
9574 #: build/C/man4/st.4:332
9575 #, no-wrap
9576 msgid "B<MTMKPART>"
9577 msgstr ""
9578
9579 #. type: Plain text
9580 #: build/C/man4/st.4:346
9581 msgid ""
9582 "Format the tape into one or two partitions.  If I<mt_count> is nonzero, it "
9583 "gives the size of the first partition and the second partition contains the "
9584 "rest of the tape.  If I<mt_count> is zero, the tape is formatted into one "
9585 "partition.  This command is not allowed for a drive unless the partition "
9586 "support is enabled for the drive (see B<MT_ST_CAN_PARTITIONS> below)."
9587 msgstr ""
9588
9589 #. type: TP
9590 #: build/C/man4/st.4:346
9591 #, no-wrap
9592 msgid "B<MTNOP>"
9593 msgstr ""
9594
9595 #. type: Plain text
9596 #: build/C/man4/st.4:351
9597 msgid ""
9598 "No op\\(emflushes the driver's buffer as a side effect.  Should be used "
9599 "before reading status with B<MTIOCGET>."
9600 msgstr ""
9601
9602 #. type: TP
9603 #: build/C/man4/st.4:351
9604 #, no-wrap
9605 msgid "B<MTOFFL>"
9606 msgstr ""
9607
9608 #. type: Plain text
9609 #: build/C/man4/st.4:354
9610 msgid "Rewind and put the drive off line."
9611 msgstr ""
9612
9613 #. type: TP
9614 #: build/C/man4/st.4:354
9615 #, no-wrap
9616 msgid "B<MTRESET>"
9617 msgstr ""
9618
9619 #. type: Plain text
9620 #: build/C/man4/st.4:357
9621 msgid "Reset drive."
9622 msgstr ""
9623
9624 #. type: TP
9625 #: build/C/man4/st.4:357
9626 #, no-wrap
9627 msgid "B<MTRETEN>"
9628 msgstr ""
9629
9630 #. type: Plain text
9631 #: build/C/man4/st.4:360
9632 msgid "Re-tension tape."
9633 msgstr ""
9634
9635 #. type: TP
9636 #: build/C/man4/st.4:360
9637 #, no-wrap
9638 msgid "B<MTREW>"
9639 msgstr ""
9640
9641 #. type: Plain text
9642 #: build/C/man4/st.4:363
9643 msgid "Rewind."
9644 msgstr ""
9645
9646 #. type: TP
9647 #: build/C/man4/st.4:363
9648 #, no-wrap
9649 msgid "B<MTSEEK>"
9650 msgstr ""
9651
9652 #. type: Plain text
9653 #: build/C/man4/st.4:375
9654 msgid ""
9655 "Seek to the tape block number specified in I<mt_count>.  This operation "
9656 "requires either a SCSI-2 drive that supports the B<LOCATE> command "
9657 "(device-specific address)  or a Tandberg-compatible SCSI-1 drive (Tandberg, "
9658 "Archive Viper, Wangtek, ...).  The block number should be one that was "
9659 "previously returned by B<MTIOCPOS> if device-specific addresses are used."
9660 msgstr ""
9661
9662 #. type: TP
9663 #: build/C/man4/st.4:375
9664 #, no-wrap
9665 msgid "B<MTSETBLK>"
9666 msgstr ""
9667
9668 #. type: Plain text
9669 #: build/C/man4/st.4:380
9670 msgid ""
9671 "Set the drive's block length to the value specified in I<mt_count>.  A block "
9672 "length of zero sets the drive to variable block size mode."
9673 msgstr ""
9674
9675 #. type: TP
9676 #: build/C/man4/st.4:380
9677 #, no-wrap
9678 msgid "B<MTSETDENSITY>"
9679 msgstr ""
9680
9681 #. type: Plain text
9682 #: build/C/man4/st.4:386
9683 msgid ""
9684 "Set the tape density to the code in I<mt_count>.  The density codes "
9685 "supported by a drive can be found from the drive documentation."
9686 msgstr ""
9687
9688 #. type: TP
9689 #: build/C/man4/st.4:386
9690 #, no-wrap
9691 msgid "B<MTSETPART>"
9692 msgstr ""
9693
9694 #. type: Plain text
9695 #: build/C/man4/st.4:395
9696 msgid ""
9697 "The active partition is switched to I<mt_count>.  The partitions are "
9698 "numbered from zero.  This command is not allowed for a drive unless the "
9699 "partition support is enabled for the drive (see B<MT_ST_CAN_PARTITIONS> "
9700 "below)."
9701 msgstr ""
9702
9703 #. type: TP
9704 #: build/C/man4/st.4:395
9705 #, no-wrap
9706 msgid "B<MTUNLOAD>"
9707 msgstr ""
9708
9709 #. type: Plain text
9710 #: build/C/man4/st.4:398
9711 msgid "Execute the SCSI unload command (does not eject the tape)."
9712 msgstr ""
9713
9714 #. type: TP
9715 #: build/C/man4/st.4:398
9716 #, no-wrap
9717 msgid "B<MTUNLOCK>"
9718 msgstr ""
9719
9720 #. type: Plain text
9721 #: build/C/man4/st.4:401
9722 msgid "Unlock the tape drive door."
9723 msgstr ""
9724
9725 #. type: TP
9726 #: build/C/man4/st.4:401
9727 #, no-wrap
9728 msgid "B<MTWEOF>"
9729 msgstr ""
9730
9731 #. type: Plain text
9732 #: build/C/man4/st.4:406
9733 msgid "Write I<mt_count> filemarks."
9734 msgstr ""
9735
9736 #. type: TP
9737 #: build/C/man4/st.4:406
9738 #, no-wrap
9739 msgid "B<MTWSM>"
9740 msgstr ""
9741
9742 #. type: Plain text
9743 #: build/C/man4/st.4:411
9744 msgid "Write I<mt_count> setmarks."
9745 msgstr ""
9746
9747 #. type: Plain text
9748 #: build/C/man4/st.4:413
9749 msgid "Magnetic Tape operations for setting of device options (by the superuser):"
9750 msgstr ""
9751
9752 #. type: TP
9753 #: build/C/man4/st.4:413
9754 #, no-wrap
9755 msgid "B<MTSETDRVBUFFER>"
9756 msgstr ""
9757
9758 #. type: Plain text
9759 #: build/C/man4/st.4:422
9760 msgid ""
9761 "Set various drive and driver options according to bits encoded in "
9762 "I<mt_count>.  These consist of the drive's buffering mode, a set of Boolean "
9763 "driver options, the buffer write threshold, defaults for the block size and "
9764 "density, and timeouts (only in kernels 2.1 and later).  A single operation "
9765 "can affect only one item in the list above (the Booleans counted as one "
9766 "item.)"
9767 msgstr ""
9768
9769 #. type: Plain text
9770 #: build/C/man4/st.4:426
9771 msgid ""
9772 "A value having zeros in the high-order 4 bits will be used to set the "
9773 "drive's buffering mode.  The buffering modes are:"
9774 msgstr ""
9775
9776 #. type: IP
9777 #: build/C/man4/st.4:427
9778 #, no-wrap
9779 msgid "0"
9780 msgstr ""
9781
9782 #. type: Plain text
9783 #: build/C/man4/st.4:432
9784 msgid ""
9785 "The drive will not report B<GOOD> status on write commands until the data "
9786 "blocks are actually written to the medium."
9787 msgstr ""
9788
9789 #. type: IP
9790 #: build/C/man4/st.4:432
9791 #, no-wrap
9792 msgid "1"
9793 msgstr ""
9794
9795 #. type: Plain text
9796 #: build/C/man4/st.4:437
9797 msgid ""
9798 "The drive may report B<GOOD> status on write commands as soon as all the "
9799 "data has been transferred to the drive's internal buffer."
9800 msgstr ""
9801
9802 #. type: IP
9803 #: build/C/man4/st.4:437
9804 #, no-wrap
9805 msgid "2"
9806 msgstr ""
9807
9808 #. type: Plain text
9809 #: build/C/man4/st.4:444
9810 msgid ""
9811 "The drive may report B<GOOD> status on write commands as soon as (a) all the "
9812 "data has been transferred to the drive's internal buffer, and (b) all "
9813 "buffered data from different initiators has been successfully written to the "
9814 "medium."
9815 msgstr ""
9816
9817 #. type: Plain text
9818 #: build/C/man4/st.4:455
9819 msgid ""
9820 "To control the write threshold the value in I<mt_count> must include the "
9821 "constant B<MT_ST_WRITE_THRESHOLD> bitwise ORed with a block count in the low "
9822 "28 bits.  The block count refers to 1024-byte blocks, not the physical block "
9823 "size on the tape.  The threshold cannot exceed the driver's internal buffer "
9824 "size (see DESCRIPTION, above)."
9825 msgstr ""
9826
9827 #. type: Plain text
9828 #: build/C/man4/st.4:476
9829 msgid ""
9830 "To set and clear the Boolean options the value in I<mt_count> must include "
9831 "one of the constants B<MT_ST_BOOLEANS>, B<MT_ST_SETBOOLEANS>, "
9832 "B<MT_ST_CLEARBOOLEANS>, or B<MT_ST_DEFBOOLEANS> bitwise ORed with whatever "
9833 "combination of the following options is desired.  Using B<MT_ST_BOOLEANS> "
9834 "the options can be set to the values defined in the corresponding bits.  "
9835 "With B<MT_ST_SETBOOLEANS> the options can be selectively set and with "
9836 "B<MT_ST_DEFBOOLEANS> selectively cleared."
9837 msgstr ""
9838
9839 #. type: Plain text
9840 #: build/C/man4/st.4:484
9841 msgid ""
9842 "The default options for a tape device are set with B<MT_ST_DEFBOOLEANS>.  A "
9843 "nonactive tape device (e.g., device with minor 32 or 160) is activated when "
9844 "the default options for it are defined the first time.  An activated device "
9845 "inherits from the device activated at start-up the options not set "
9846 "explicitly."
9847 msgstr ""
9848
9849 #. type: Plain text
9850 #: build/C/man4/st.4:486
9851 msgid "The Boolean options are:"
9852 msgstr ""
9853
9854 #. type: TP
9855 #: build/C/man4/st.4:487
9856 #, no-wrap
9857 msgid "B<MT_ST_BUFFER_WRITES> (Default: true)"
9858 msgstr ""
9859
9860 #. type: Plain text
9861 #: build/C/man4/st.4:493
9862 msgid ""
9863 "Buffer all write operations in fixed-block mode.  If this option is false "
9864 "and the drive uses a fixed block size, then all write operations must be for "
9865 "a multiple of the block size.  This option must be set false to write "
9866 "reliable multivolume archives."
9867 msgstr ""
9868
9869 #. type: TP
9870 #: build/C/man4/st.4:494
9871 #, no-wrap
9872 msgid "B<MT_ST_ASYNC_WRITES> (Default: true)"
9873 msgstr ""
9874
9875 #. type: Plain text
9876 #: build/C/man4/st.4:504
9877 msgid ""
9878 "When this option is true, write operations return immediately without "
9879 "waiting for the data to be transferred to the drive if the data fits into "
9880 "the driver's buffer.  The write threshold determines how full the buffer "
9881 "must be before a new SCSI write command is issued.  Any errors reported by "
9882 "the drive will be held until the next operation.  This option must be set "
9883 "false to write reliable multivolume archives."
9884 msgstr ""
9885
9886 #. type: TP
9887 #: build/C/man4/st.4:504
9888 #, no-wrap
9889 msgid "B<MT_ST_READ_AHEAD> (Default: true)"
9890 msgstr ""
9891
9892 #. type: Plain text
9893 #: build/C/man4/st.4:510
9894 msgid ""
9895 "This option causes the driver to provide read buffering and read-ahead in "
9896 "fixed-block mode.  If this option is false and the drive uses a fixed block "
9897 "size, then all read operations must be for a multiple of the block size."
9898 msgstr ""
9899
9900 #. type: TP
9901 #: build/C/man4/st.4:510
9902 #, no-wrap
9903 msgid "B<MT_ST_TWO_FM> (Default: false)"
9904 msgstr ""
9905
9906 #. type: Plain text
9907 #: build/C/man4/st.4:516
9908 msgid ""
9909 "This option modifies the driver behavior when a file is closed.  The normal "
9910 "action is to write a single filemark.  If the option is true the driver will "
9911 "write two filemarks and backspace over the second one."
9912 msgstr ""
9913
9914 #. type: Plain text
9915 #: build/C/man4/st.4:525
9916 msgid ""
9917 "Note: This option should not be set true for QIC tape drives since they are "
9918 "unable to overwrite a filemark.  These drives detect the end of recorded "
9919 "data by testing for blank tape rather than two consecutive filemarks.  Most "
9920 "other current drives also detect the end of recorded data and using two "
9921 "filemarks is usually necessary only when interchanging tapes with some other "
9922 "systems."
9923 msgstr ""
9924
9925 #. type: TP
9926 #: build/C/man4/st.4:525
9927 #, no-wrap
9928 msgid "B<MT_ST_DEBUGGING> (Default: false)"
9929 msgstr ""
9930
9931 #. type: Plain text
9932 #: build/C/man4/st.4:531
9933 msgid ""
9934 "This option turns on various debugging messages from the driver (effective "
9935 "only if the driver was compiled with B<DEBUG> defined nonzero)."
9936 msgstr ""
9937
9938 #. type: TP
9939 #: build/C/man4/st.4:531
9940 #, no-wrap
9941 msgid "B<MT_ST_FAST_EOM> (Default: false)"
9942 msgstr ""
9943
9944 #. type: Plain text
9945 #: build/C/man4/st.4:545
9946 msgid ""
9947 "This option causes the B<MTEOM> operation to be sent directly to the drive, "
9948 "potentially speeding up the operation but causing the driver to lose track "
9949 "of the current file number normally returned by the B<MTIOCGET> request.  If "
9950 "B<MT_ST_FAST_EOM> is false the driver will respond to an B<MTEOM> request by "
9951 "forward spacing over files."
9952 msgstr ""
9953
9954 #. type: TP
9955 #: build/C/man4/st.4:545
9956 #, no-wrap
9957 msgid "B<MT_ST_AUTO_LOCK> (Default: false)"
9958 msgstr ""
9959
9960 #. type: Plain text
9961 #: build/C/man4/st.4:549
9962 msgid ""
9963 "When this option is true, the drive door is locked when the device is opened "
9964 "and unlocked when it is closed."
9965 msgstr ""
9966
9967 #. type: TP
9968 #: build/C/man4/st.4:549
9969 #, no-wrap
9970 msgid "B<MT_ST_DEF_WRITES> (Default: false)"
9971 msgstr ""
9972
9973 #. type: Plain text
9974 #: build/C/man4/st.4:566
9975 msgid ""
9976 "The tape options (block size, mode, compression, etc.) may change when "
9977 "changing from one device linked to a drive to another device linked to the "
9978 "same drive depending on how the devices are defined.  This option defines "
9979 "when the changes are enforced by the driver using SCSI-commands and when the "
9980 "drives auto-detection capabilities are relied upon.  If this option is "
9981 "false, the driver sends the SCSI-commands immediately when the device is "
9982 "changed.  If the option is true, the SCSI-commands are not sent until a "
9983 "write is requested.  In this case the drive firmware is allowed to detect "
9984 "the tape structure when reading and the SCSI-commands are used only to make "
9985 "sure that a tape is written according to the correct specification."
9986 msgstr ""
9987
9988 #. type: TP
9989 #: build/C/man4/st.4:566
9990 #, no-wrap
9991 msgid "B<MT_ST_CAN_BSR> (Default: false)"
9992 msgstr ""
9993
9994 #. type: Plain text
9995 #: build/C/man4/st.4:579
9996 msgid ""
9997 "When read-ahead is used, the tape must sometimes be spaced backward to the "
9998 "correct position when the device is closed and the SCSI command to space "
9999 "backward over records is used for this purpose.  Some older drives can't "
10000 "process this command reliably and this option can be used to instruct the "
10001 "driver not to use the command.  The end result is that, with read-ahead and "
10002 "fixed-block mode, the tape may not be correctly positioned within a file "
10003 "when the device is closed.  With 2.6 kernel, the default is true for drives "
10004 "supporting SCSI-3."
10005 msgstr ""
10006
10007 #. type: TP
10008 #: build/C/man4/st.4:579
10009 #, no-wrap
10010 msgid "B<MT_ST_NO_BLKLIMS> (Default: false)"
10011 msgstr ""
10012
10013 #. type: Plain text
10014 #: build/C/man4/st.4:588
10015 msgid ""
10016 "Some drives don't accept the B<READ BLOCK LIMITS> SCSI command.  If this is "
10017 "used, the driver does not use the command.  The drawback is that the driver "
10018 "can't check before sending commands if the selected block size is acceptable "
10019 "to the drive."
10020 msgstr ""
10021
10022 #. type: TP
10023 #: build/C/man4/st.4:588
10024 #, no-wrap
10025 msgid "B<MT_ST_CAN_PARTITIONS> (Default: false)"
10026 msgstr ""
10027
10028 #. type: Plain text
10029 #: build/C/man4/st.4:593
10030 msgid ""
10031 "This option enables support for several partitions within a tape.  The "
10032 "option applies to all devices linked to a drive."
10033 msgstr ""
10034
10035 #. type: TP
10036 #: build/C/man4/st.4:593
10037 #, no-wrap
10038 msgid "B<MT_ST_SCSI2LOGICAL> (Default: false)"
10039 msgstr ""
10040
10041 #. type: Plain text
10042 #: build/C/man4/st.4:608
10043 msgid ""
10044 "This option instructs the driver to use the logical block addresses defined "
10045 "in the SCSI-2 standard when performing the seek and tell operations (both "
10046 "with B<MTSEEK> and B<MTIOCPOS> commands and when changing tape partition).  "
10047 "Otherwise the device-specific addresses are used.  It is highly advisable to "
10048 "set this option if the drive supports the logical addresses because they "
10049 "count also filemarks.  There are some drives that only support the logical "
10050 "block addresses."
10051 msgstr ""
10052
10053 #. type: TP
10054 #: build/C/man4/st.4:608
10055 #, no-wrap
10056 msgid "B<MT_ST_SYSV> (Default: false)"
10057 msgstr ""
10058
10059 #. type: Plain text
10060 #: build/C/man4/st.4:619
10061 msgid ""
10062 "When this option is enabled, the tape devices use the SystemV semantics.  "
10063 "Otherwise the BSD semantics are used.  The most important difference between "
10064 "the semantics is what happens when a device used for reading is closed: in "
10065 "System V semantics the tape is spaced forward past the next filemark if this "
10066 "has not happened while using the device.  In BSD semantics the tape position "
10067 "is not changed."
10068 msgstr ""
10069
10070 #. type: TP
10071 #: build/C/man4/st.4:619
10072 #, no-wrap
10073 msgid "B<MT_NO_WAIT> (Default: false)"
10074 msgstr ""
10075
10076 #. type: Plain text
10077 #: build/C/man4/st.4:623
10078 msgid ""
10079 "Enables immediate mode (i.e., don't wait for the command to finish) for some "
10080 "commands (e.g., rewind)."
10081 msgstr ""
10082
10083 #. type: Plain text
10084 #: build/C/man4/st.4:625
10085 msgid "An example:"
10086 msgstr ""
10087
10088 #. type: Plain text
10089 #: build/C/man4/st.4:633
10090 #, no-wrap
10091 msgid ""
10092 "struct mtop mt_cmd;\n"
10093 "mt_cmd.mt_op = MTSETDRVBUFFER;\n"
10094 "mt_cmd.mt_count = MT_ST_BOOLEANS |\n"
10095 "        MT_ST_BUFFER_WRITES | MT_ST_ASYNC_WRITES;\n"
10096 "ioctl(fd, MTIOCTOP, mt_cmd);\n"
10097 msgstr ""
10098
10099 #. type: Plain text
10100 #: build/C/man4/st.4:643
10101 msgid ""
10102 "The default block size for a device can be set with B<MT_ST_DEF_BLKSIZE> and "
10103 "the default density code can be set with B<MT_ST_DEFDENSITY>.  The values "
10104 "for the parameters are or'ed with the operation code."
10105 msgstr ""
10106
10107 #. type: Plain text
10108 #: build/C/man4/st.4:660
10109 msgid ""
10110 "With kernels 2.1.x and later, the timeout values can be set with the "
10111 "subcommand B<MT_ST_SET_TIMEOUT> ORed with the timeout in seconds.  The long "
10112 "timeout (used for rewinds and other commands that may take a long time) can "
10113 "be set with B<MT_ST_SET_LONG_TIMEOUT>.  The kernel defaults are very long to "
10114 "make sure that a successful command is not timed out with any drive.  "
10115 "Because of this the driver may seem stuck even if it is only waiting for the "
10116 "timeout.  These commands can be used to set more practical values for a "
10117 "specific drive.  The timeouts set for one device apply for all devices "
10118 "linked to the same drive."
10119 msgstr ""
10120
10121 #. type: Plain text
10122 #: build/C/man4/st.4:681
10123 msgid ""
10124 "Starting from kernels 2.4.19 and 2.5.43, the driver supports a status bit "
10125 "which indicates whether the drive requests cleaning.  The method used by the "
10126 "drive to return cleaning information is set using the B<MT_ST_SEL_CLN> "
10127 "subcommand.  If the value is zero, the cleaning bit is always zero.  If the "
10128 "value is one, the TapeAlert data defined in the SCSI-3 standard is used (not "
10129 "yet implemented).  Values 2-17 are reserved.  If the lowest eight bits are "
10130 "E<gt>= 18, bits from the extended sense data are used.  The bits 9-16 "
10131 "specify a mask to select the bits to look at and the bits 17-23 specify the "
10132 "bit pattern to look for.  If the bit pattern is zero, one or more bits under "
10133 "the mask indicate the cleaning request.  If the pattern is nonzero, the "
10134 "pattern must match the masked sense data byte."
10135 msgstr ""
10136
10137 #. type: SS
10138 #: build/C/man4/st.4:681
10139 #, no-wrap
10140 msgid "MTIOCGET \\(em Get status"
10141 msgstr ""
10142
10143 #. type: Plain text
10144 #: build/C/man4/st.4:685
10145 msgid "This request takes an argument of type I<(struct mtget *)>."
10146 msgstr ""
10147
10148 #. type: Plain text
10149 #: build/C/man4/st.4:700
10150 #, no-wrap
10151 msgid ""
10152 "/* structure for MTIOCGET - mag tape get status command */\n"
10153 "struct mtget {\n"
10154 "    long     mt_type;\n"
10155 "    long     mt_resid;\n"
10156 "    /* the following registers are device dependent */\n"
10157 "    long     mt_dsreg;\n"
10158 "    long     mt_gstat;\n"
10159 "    long     mt_erreg;\n"
10160 "    /* The next two fields are not always used */\n"
10161 "    daddr_t  mt_fileno;\n"
10162 "    daddr_t  mt_blkno;\n"
10163 "};\n"
10164 msgstr ""
10165
10166 #. type: IP
10167 #: build/C/man4/st.4:702
10168 #, no-wrap
10169 msgid "I<mt_type>"
10170 msgstr ""
10171
10172 #. type: Plain text
10173 #: build/C/man4/st.4:711
10174 msgid ""
10175 "The header file defines many values for I<mt_type>, but the current driver "
10176 "reports only the generic types B<MT_ISSCSI1> (Generic SCSI-1 tape)  and "
10177 "B<MT_ISSCSI2> (Generic SCSI-2 tape)."
10178 msgstr ""
10179
10180 #. type: IP
10181 #: build/C/man4/st.4:711
10182 #, no-wrap
10183 msgid "I<mt_resid>"
10184 msgstr ""
10185
10186 #. type: Plain text
10187 #: build/C/man4/st.4:713
10188 msgid "contains the current tape partition number."
10189 msgstr ""
10190
10191 #. type: IP
10192 #: build/C/man4/st.4:713
10193 #, no-wrap
10194 msgid "I<mt_dsreg>"
10195 msgstr ""
10196
10197 #. type: Plain text
10198 #: build/C/man4/st.4:722
10199 msgid ""
10200 "reports the drive's current settings for block size (in the low 24 bits) and "
10201 "density (in the high 8 bits).  These fields are defined by "
10202 "B<MT_ST_BLKSIZE_SHIFT>, B<MT_ST_BLKSIZE_MASK>, B<MT_ST_DENSITY_SHIFT>, and "
10203 "B<MT_ST_DENSITY_MASK>."
10204 msgstr ""
10205
10206 #. type: IP
10207 #: build/C/man4/st.4:722
10208 #, no-wrap
10209 msgid "I<mt_gstat>"
10210 msgstr ""
10211
10212 #. type: Plain text
10213 #: build/C/man4/st.4:725
10214 msgid ""
10215 "reports generic (device independent) status information.  The header file "
10216 "defines macros for testing these status bits:"
10217 msgstr ""
10218
10219 #. type: Plain text
10220 #: build/C/man4/st.4:732
10221 msgid ""
10222 "B<GMT_EOF>(I<x>): The tape is positioned just after a filemark (always false "
10223 "after an B<MTSEEK> operation)."
10224 msgstr ""
10225
10226 #. type: Plain text
10227 #: build/C/man4/st.4:738
10228 msgid ""
10229 "B<GMT_BOT>(I<x>): The tape is positioned at the beginning of the first file "
10230 "(always false after an B<MTSEEK> operation)."
10231 msgstr ""
10232
10233 #. type: Plain text
10234 #: build/C/man4/st.4:741
10235 msgid "B<GMT_EOT>(I<x>): A tape operation has reached the physical End Of Tape."
10236 msgstr ""
10237
10238 #. type: Plain text
10239 #: build/C/man4/st.4:747
10240 msgid ""
10241 "B<GMT_SM>(I<x>): The tape is currently positioned at a setmark (always false "
10242 "after an B<MTSEEK> operation)."
10243 msgstr ""
10244
10245 #. type: Plain text
10246 #: build/C/man4/st.4:750
10247 msgid "B<GMT_EOD>(I<x>): The tape is positioned at the end of recorded data."
10248 msgstr ""
10249
10250 #. type: Plain text
10251 #: build/C/man4/st.4:755
10252 msgid ""
10253 "B<GMT_WR_PROT>(I<x>): The drive is write-protected.  For some drives this "
10254 "can also mean that the drive does not support writing on the current medium "
10255 "type."
10256 msgstr ""
10257
10258 #. type: Plain text
10259 #: build/C/man4/st.4:760
10260 msgid ""
10261 "B<GMT_ONLINE>(I<x>): The last B<open>(2)  found the drive with a tape in "
10262 "place and ready for operation."
10263 msgstr ""
10264
10265 #. type: Plain text
10266 #: build/C/man4/st.4:764
10267 msgid ""
10268 "B<GMT_D_6250>(I<x>), B<GMT_D_1600>(I<x>), B<GMT_D_800>(I<x>): This "
10269 "\\(lqgeneric\\(rq status information reports the current density setting for "
10270 "9-track \\(12\" tape drives only."
10271 msgstr ""
10272
10273 #. type: Plain text
10274 #: build/C/man4/st.4:767
10275 msgid "B<GMT_DR_OPEN>(I<x>): The drive does not have a tape in place."
10276 msgstr ""
10277
10278 #. type: Plain text
10279 #: build/C/man4/st.4:775
10280 msgid ""
10281 "B<GMT_IM_REP_EN>(I<x>): Immediate report mode.  This bit is set if there are "
10282 "no guarantees that the data has been physically written to the tape when the "
10283 "write call returns.  It is set zero only when the driver does not buffer "
10284 "data and the drive is set not to buffer data."
10285 msgstr ""
10286
10287 #. type: Plain text
10288 #: build/C/man4/st.4:779
10289 msgid ""
10290 "B<GMT_CLN>(I<x>): The drive has requested cleaning.  Implemented in kernels "
10291 "since 2.4.19 and 2.5.43."
10292 msgstr ""
10293
10294 #. type: IP
10295 #: build/C/man4/st.4:780
10296 #, no-wrap
10297 msgid "I<mt_erreg>"
10298 msgstr ""
10299
10300 #. type: Plain text
10301 #: build/C/man4/st.4:790
10302 msgid ""
10303 "The only field defined in I<mt_erreg> is the recovered error count in the "
10304 "low 16 bits (as defined by B<MT_ST_SOFTERR_SHIFT> and "
10305 "B<MT_ST_SOFTERR_MASK>.  Due to inconsistencies in the way drives report "
10306 "recovered errors, this count is often not maintained (most drives do not by "
10307 "default report soft errors but this can be changed with a SCSI MODE SELECT "
10308 "command)."
10309 msgstr ""
10310
10311 #. type: IP
10312 #: build/C/man4/st.4:790
10313 #, no-wrap
10314 msgid "I<mt_fileno>"
10315 msgstr ""
10316
10317 #. type: Plain text
10318 #: build/C/man4/st.4:796
10319 msgid ""
10320 "reports the current file number (zero-based).  This value is set to -1 when "
10321 "the file number is unknown (e.g., after B<MTBSS> or B<MTSEEK>)."
10322 msgstr ""
10323
10324 #. type: IP
10325 #: build/C/man4/st.4:796
10326 #, no-wrap
10327 msgid "I<mt_blkno>"
10328 msgstr ""
10329
10330 #. type: Plain text
10331 #: build/C/man4/st.4:803
10332 msgid ""
10333 "reports the block number (zero-based) within the current file.  This value "
10334 "is set to -1 when the block number is unknown (e.g., after B<MTBSF>, "
10335 "B<MTBSS>, or B<MTSEEK>)."
10336 msgstr ""
10337
10338 #. type: SS
10339 #: build/C/man4/st.4:803
10340 #, no-wrap
10341 msgid "MTIOCPOS \\(em Get tape position"
10342 msgstr ""
10343
10344 #. type: Plain text
10345 #: build/C/man4/st.4:817
10346 msgid ""
10347 "This request takes an argument of type I<(struct mtpos *)> and reports the "
10348 "drive's notion of the current tape block number, which is not the same as "
10349 "I<mt_blkno> returned by B<MTIOCGET>.  This drive must be a SCSI-2 drive that "
10350 "supports the B<READ POSITION> command (device-specific address)  or a "
10351 "Tandberg-compatible SCSI-1 drive (Tandberg, Archive Viper, Wangtek, ... )."
10352 msgstr ""
10353
10354 #. type: Plain text
10355 #: build/C/man4/st.4:824
10356 #, no-wrap
10357 msgid ""
10358 "/* structure for MTIOCPOS - mag tape get position command */\n"
10359 "struct mtpos {\n"
10360 "    long mt_blkno;    /* current block number */\n"
10361 "};\n"
10362 msgstr ""
10363
10364 #. type: Plain text
10365 #: build/C/man4/st.4:833
10366 msgid ""
10367 "An attempt was made to write or erase a write-protected tape.  (This error "
10368 "is not detected during B<open>(2).)"
10369 msgstr ""
10370
10371 #. type: TP
10372 #: build/C/man4/st.4:833
10373 #, no-wrap
10374 msgid "B<EBUSY>"
10375 msgstr ""
10376
10377 #. type: Plain text
10378 #: build/C/man4/st.4:837
10379 msgid "The device is already in use or the driver was unable to allocate a buffer."
10380 msgstr ""
10381
10382 #. type: Plain text
10383 #: build/C/man4/st.4:841
10384 msgid "The command parameters point to memory not belonging to the calling process."
10385 msgstr ""
10386
10387 #. type: Plain text
10388 #: build/C/man4/st.4:846
10389 msgid ""
10390 "An B<ioctl>(2)  had an invalid argument, or a requested block size was "
10391 "invalid."
10392 msgstr ""
10393
10394 #. type: TP
10395 #: build/C/man4/st.4:846
10396 #, no-wrap
10397 msgid "B<EIO>"
10398 msgstr ""
10399
10400 #. type: Plain text
10401 #: build/C/man4/st.4:849
10402 msgid "The requested operation could not be completed."
10403 msgstr ""
10404
10405 #. type: Plain text
10406 #: build/C/man4/st.4:856
10407 msgid ""
10408 "The byte count in B<read>(2)  is smaller than the next physical block on the "
10409 "tape.  (Before 2.2.18 and 2.4.0-test6 the extra bytes have been silently "
10410 "ignored.)"
10411 msgstr ""
10412
10413 #. type: Plain text
10414 #: build/C/man4/st.4:860
10415 msgid ""
10416 "A write operation could not be completed because the tape reached "
10417 "end-of-medium."
10418 msgstr ""
10419
10420 #. type: TP
10421 #: build/C/man4/st.4:860 build/C/man2/syslog.2:237
10422 #, no-wrap
10423 msgid "B<ENOSYS>"
10424 msgstr ""
10425
10426 #. type: Plain text
10427 #: build/C/man4/st.4:864
10428 msgid "Unknown B<ioctl>(2)."
10429 msgstr ""
10430
10431 #. type: TP
10432 #: build/C/man4/st.4:864
10433 #, no-wrap
10434 msgid "B<ENXIO>"
10435 msgstr ""
10436
10437 #. type: Plain text
10438 #: build/C/man4/st.4:867
10439 msgid "During opening, the tape device does not exist."
10440 msgstr ""
10441
10442 #. type: TP
10443 #: build/C/man4/st.4:867
10444 #, no-wrap
10445 msgid "B<EOVERFLOW>"
10446 msgstr ""
10447
10448 #. type: Plain text
10449 #: build/C/man4/st.4:871
10450 msgid ""
10451 "An attempt was made to read or write a variable-length block that is larger "
10452 "than the driver's internal buffer."
10453 msgstr ""
10454
10455 #. type: Plain text
10456 #: build/C/man4/st.4:878
10457 msgid ""
10458 "Open is attempted with B<O_WRONLY> or B<O_RDWR> when the tape in the drive "
10459 "is write-protected."
10460 msgstr ""
10461
10462 #. type: TP
10463 #: build/C/man4/st.4:879
10464 #, no-wrap
10465 msgid "I</dev/st*>"
10466 msgstr ""
10467
10468 #. type: Plain text
10469 #: build/C/man4/st.4:882
10470 msgid "the auto-rewind SCSI tape devices"
10471 msgstr ""
10472
10473 #. type: TP
10474 #: build/C/man4/st.4:882
10475 #, no-wrap
10476 msgid "I</dev/nst*>"
10477 msgstr ""
10478
10479 #.  .SH AUTHOR
10480 #.  The driver has been written by Kai M\(:akisara (Kai.Makisara@metla.fi)
10481 #.  starting from a driver written by Dwayne Forsyth.
10482 #.  Several other
10483 #.  people have also contributed to the driver.
10484 #. type: Plain text
10485 #: build/C/man4/st.4:890
10486 msgid "the nonrewind SCSI tape devices"
10487 msgstr ""
10488
10489 #. type: Plain text
10490 #: build/C/man4/st.4:911
10491 msgid ""
10492 "When exchanging data between systems, both systems have to agree on the "
10493 "physical tape block size.  The parameters of a drive after startup are often "
10494 "not the ones most operating systems use with these devices.  Most systems "
10495 "use drives in variable-block mode if the drive supports that mode.  This "
10496 "applies to most modern drives, including DATs, 8mm helical scan drives, "
10497 "DLTs, etc.  It may be advisable to use these drives in variable-block mode "
10498 "also in Linux (i.e., use B<MTSETBLK> or B<MTSETDEFBLK> at system startup to "
10499 "set the mode), at least when exchanging data with a foreign system.  The "
10500 "drawback of this is that a fairly large tape block size has to be used to "
10501 "get acceptable data transfer rates on the SCSI bus."
10502 msgstr ""
10503
10504 #. type: Plain text
10505 #: build/C/man4/st.4:918
10506 msgid ""
10507 "Many programs (e.g., B<tar>(1))  allow the user to specify the blocking "
10508 "factor on the command line.  Note that this determines the physical block "
10509 "size on tape only in variable-block mode."
10510 msgstr ""
10511
10512 #. type: Plain text
10513 #: build/C/man4/st.4:925
10514 msgid ""
10515 "In order to use SCSI tape drives, the basic SCSI driver, a SCSI-adapter "
10516 "driver and the SCSI tape driver must be either configured into the kernel or "
10517 "loaded as modules.  If the SCSI-tape driver is not present, the drive is "
10518 "recognized but the tape support described in this page is not available."
10519 msgstr ""
10520
10521 #. type: Plain text
10522 #: build/C/man4/st.4:930
10523 msgid ""
10524 "The driver writes error messages to the console/log.  The SENSE codes "
10525 "written into some messages are automatically translated to text if verbose "
10526 "SCSI messages are enabled in kernel configuration."
10527 msgstr ""
10528
10529 #.  .SH COPYRIGHT
10530 #.  Copyright \(co 1995 Robert K. Nichols.
10531 #.  .br
10532 #.  Copyright \(co 1999-2005 Kai M\(:akisara.
10533 #.  .PP
10534 #.  Permission is granted to make and distribute verbatim copies of this
10535 #.  manual provided the copyright notice and this permission notice are
10536 #.  preserved on all copies.
10537 #.  Additional permissions are contained in the header of the source file.
10538 #. type: Plain text
10539 #: build/C/man4/st.4:952
10540 msgid ""
10541 "The driver's internal buffering allows good throughput in fixed-block mode "
10542 "also with small B<read>(2)  and B<write>(2)  byte counts.  With direct "
10543 "transfers this is not possible and may cause a surprise when moving to the "
10544 "2.6 kernel.  The solution is to tell the software to use larger transfers "
10545 "(often telling it to use larger blocks).  If this is not possible, direct "
10546 "transfers can be disabled."
10547 msgstr ""
10548
10549 #. type: Plain text
10550 #: build/C/man4/st.4:954
10551 msgid "B<mt>(1)"
10552 msgstr ""
10553
10554 #. type: Plain text
10555 #: build/C/man4/st.4:962
10556 msgid ""
10557 "The file I<drivers/scsi/README.st> or I<Documentation/scsi/st.txt> (kernel "
10558 "E<gt>= 2.6) in the kernel sources contains the most recent information about "
10559 "the driver and its configuration possibilities."
10560 msgstr ""
10561
10562 #. type: TH
10563 #: build/C/man3/stdarg.3:41
10564 #, no-wrap
10565 msgid "STDARG"
10566 msgstr ""
10567
10568 #. type: TH
10569 #: build/C/man3/stdarg.3:41
10570 #, no-wrap
10571 msgid "2001-10-14"
10572 msgstr ""
10573
10574 #. type: Plain text
10575 #: build/C/man3/stdarg.3:44
10576 msgid "stdarg, va_start, va_arg, va_end, va_copy - variable argument lists"
10577 msgstr ""
10578
10579 #. type: Plain text
10580 #: build/C/man3/stdarg.3:46 build/C/man3/syslog.3:47
10581 msgid "B<#include E<lt>stdarg.hE<gt>>"
10582 msgstr ""
10583
10584 #. type: Plain text
10585 #: build/C/man3/stdarg.3:48
10586 msgid "B<void va_start(va_list >I<ap>B<, >I<last>B<);>"
10587 msgstr ""
10588
10589 #. type: Plain text
10590 #: build/C/man3/stdarg.3:50
10591 msgid "I<type>B< va_arg(va_list >I<ap>B<, >I<type>B<);>"
10592 msgstr ""
10593
10594 #. type: Plain text
10595 #: build/C/man3/stdarg.3:52
10596 msgid "B<void va_end(va_list >I<ap>B<);>"
10597 msgstr ""
10598
10599 #. type: Plain text
10600 #: build/C/man3/stdarg.3:54
10601 msgid "B<void va_copy(va_list >I<dest>B<, va_list >I<src>B<);>"
10602 msgstr ""
10603
10604 #. type: Plain text
10605 #: build/C/man3/stdarg.3:63
10606 msgid ""
10607 "A function may be called with a varying number of arguments of varying "
10608 "types.  The include file I<E<lt>stdarg.hE<gt>> declares a type I<va_list> "
10609 "and defines three macros for stepping through a list of arguments whose "
10610 "number and types are not known to the called function."
10611 msgstr ""
10612
10613 #. type: Plain text
10614 #: build/C/man3/stdarg.3:71
10615 msgid ""
10616 "The called function must declare an object of type I<va_list> which is used "
10617 "by the macros B<va_start>(), B<va_arg>(), and B<va_end>()."
10618 msgstr ""
10619
10620 #. type: SS
10621 #: build/C/man3/stdarg.3:71
10622 #, no-wrap
10623 msgid "va_start()"
10624 msgstr ""
10625
10626 #. type: Plain text
10627 #: build/C/man3/stdarg.3:81
10628 msgid ""
10629 "The B<va_start>()  macro initializes I<ap> for subsequent use by B<va_arg>()  "
10630 "and B<va_end>(), and must be called first."
10631 msgstr ""
10632
10633 #. type: Plain text
10634 #: build/C/man3/stdarg.3:86
10635 msgid ""
10636 "The argument I<last> is the name of the last argument before the variable "
10637 "argument list, that is, the last argument of which the calling function "
10638 "knows the type."
10639 msgstr ""
10640
10641 #. type: Plain text
10642 #: build/C/man3/stdarg.3:91
10643 msgid ""
10644 "Because the address of this argument may be used in the B<va_start>()  "
10645 "macro, it should not be declared as a register variable, or as a function or "
10646 "an array type."
10647 msgstr ""
10648
10649 #. type: SS
10650 #: build/C/man3/stdarg.3:91
10651 #, no-wrap
10652 msgid "va_arg()"
10653 msgstr ""
10654
10655 #. type: Plain text
10656 #: build/C/man3/stdarg.3:113
10657 msgid ""
10658 "The B<va_arg>()  macro expands to an expression that has the type and value "
10659 "of the next argument in the call.  The argument I<ap> is the I<va_list> "
10660 "I<ap> initialized by B<va_start>().  Each call to B<va_arg>()  modifies "
10661 "I<ap> so that the next call returns the next argument.  The argument I<type> "
10662 "is a type name specified so that the type of a pointer to an object that has "
10663 "the specified type can be obtained simply by adding a * to I<type>."
10664 msgstr ""
10665
10666 #. type: Plain text
10667 #: build/C/man3/stdarg.3:121
10668 msgid ""
10669 "The first use of the B<va_arg>()  macro after that of the B<va_start>()  "
10670 "macro returns the argument after I<last>.  Successive invocations return the "
10671 "values of the remaining arguments."
10672 msgstr ""
10673
10674 #. type: Plain text
10675 #: build/C/man3/stdarg.3:126
10676 msgid ""
10677 "If there is no next argument, or if I<type> is not compatible with the type "
10678 "of the actual next argument (as promoted according to the default argument "
10679 "promotions), random errors will occur."
10680 msgstr ""
10681
10682 #. type: Plain text
10683 #: build/C/man3/stdarg.3:134
10684 msgid ""
10685 "If I<ap> is passed to a function that uses B<va_arg(>I<ap>B<,>I<type>B<)> "
10686 "then the value of I<ap> is undefined after the return of that function."
10687 msgstr ""
10688
10689 #. type: SS
10690 #: build/C/man3/stdarg.3:134
10691 #, no-wrap
10692 msgid "va_end()"
10693 msgstr ""
10694
10695 #. type: Plain text
10696 #: build/C/man3/stdarg.3:153
10697 msgid ""
10698 "Each invocation of B<va_start>()  must be matched by a corresponding "
10699 "invocation of B<va_end>()  in the same function.  After the call "
10700 "B<va_end(>I<ap>B<)> the variable I<ap> is undefined.  Multiple traversals of "
10701 "the list, each bracketed by B<va_start>()  and B<va_end>()  are possible.  "
10702 "B<va_end>()  may be a macro or a function."
10703 msgstr ""
10704
10705 #. type: SS
10706 #: build/C/man3/stdarg.3:153
10707 #, no-wrap
10708 msgid "va_copy()"
10709 msgstr ""
10710
10711 #.  Proposal from clive@demon.net, 1997-02-28
10712 #. type: Plain text
10713 #: build/C/man3/stdarg.3:160
10714 msgid ""
10715 "An obvious implementation would have a I<va_list> be a pointer to the stack "
10716 "frame of the variadic function.  In such a setup (by far the most common) "
10717 "there seems nothing against an assignment"
10718 msgstr ""
10719
10720 #. type: Plain text
10721 #: build/C/man3/stdarg.3:164
10722 #, no-wrap
10723 msgid "va_list aq = ap;\n"
10724 msgstr ""
10725
10726 #. type: Plain text
10727 #: build/C/man3/stdarg.3:169
10728 msgid ""
10729 "Unfortunately, there are also systems that make it an array of pointers (of "
10730 "length 1), and there one needs"
10731 msgstr ""
10732
10733 #. type: Plain text
10734 #: build/C/man3/stdarg.3:174
10735 #, no-wrap
10736 msgid ""
10737 "va_list aq;\n"
10738 "*aq = *ap;\n"
10739 msgstr ""
10740
10741 #. type: Plain text
10742 #: build/C/man3/stdarg.3:190
10743 msgid ""
10744 "Finally, on systems where arguments are passed in registers, it may be "
10745 "necessary for B<va_start>()  to allocate memory, store the arguments there, "
10746 "and also an indication of which argument is next, so that B<va_arg>()  can "
10747 "step through the list.  Now B<va_end>()  can free the allocated memory "
10748 "again.  To accommodate this situation, C99 adds a macro B<va_copy>(), so "
10749 "that the above assignment can be replaced by"
10750 msgstr ""
10751
10752 #. type: Plain text
10753 #: build/C/man3/stdarg.3:197
10754 #, no-wrap
10755 msgid ""
10756 "va_list aq;\n"
10757 "va_copy(aq, ap);\n"
10758 "\\&...\n"
10759 "va_end(aq);\n"
10760 msgstr ""
10761
10762 #. type: Plain text
10763 #: build/C/man3/stdarg.3:210
10764 msgid ""
10765 "Each invocation of B<va_copy>()  must be matched by a corresponding "
10766 "invocation of B<va_end>()  in the same function.  Some systems that do not "
10767 "supply B<va_copy>()  have B<__va_copy> instead, since that was the name used "
10768 "in the draft proposal."
10769 msgstr ""
10770
10771 #. type: Plain text
10772 #: build/C/man3/stdarg.3:220
10773 msgid ""
10774 "The B<va_start>(), B<va_arg>(), and B<va_end>()  macros conform to C89.  C99 "
10775 "defines the B<va_copy>()  macro."
10776 msgstr ""
10777
10778 #. type: Plain text
10779 #: build/C/man3/stdarg.3:226
10780 msgid ""
10781 "These macros are I<not> compatible with the historic macros they replace.  A "
10782 "backward-compatible version can be found in the include file "
10783 "I<E<lt>varargs.hE<gt>>."
10784 msgstr ""
10785
10786 #. type: Plain text
10787 #: build/C/man3/stdarg.3:228
10788 msgid "The historic setup is:"
10789 msgstr ""
10790
10791 #. type: Plain text
10792 #: build/C/man3/stdarg.3:232
10793 #, no-wrap
10794 msgid "#include E<lt>varargs.hE<gt>\n"
10795 msgstr ""
10796
10797 #. type: Plain text
10798 #: build/C/man3/stdarg.3:238
10799 #, no-wrap
10800 msgid ""
10801 "void\n"
10802 "foo(va_alist)\n"
10803 "    va_dcl\n"
10804 "{\n"
10805 "    va_list ap;\n"
10806 msgstr ""
10807
10808 #. type: Plain text
10809 #: build/C/man3/stdarg.3:247
10810 #, no-wrap
10811 msgid ""
10812 "    va_start(ap);\n"
10813 "    while (...) {\n"
10814 "        ...\n"
10815 "        x = va_arg(ap, type);\n"
10816 "        ...\n"
10817 "    }\n"
10818 "    va_end(ap);\n"
10819 "}\n"
10820 msgstr ""
10821
10822 #. type: Plain text
10823 #: build/C/man3/stdarg.3:256
10824 msgid ""
10825 "On some systems, I<va_end> contains a closing \\(aq}\\(aq matching a "
10826 "\\(aq{\\(aq in I<va_start>, so that both macros must occur in the same "
10827 "function, and in a way that allows this."
10828 msgstr ""
10829
10830 #. type: Plain text
10831 #: build/C/man3/stdarg.3:272
10832 msgid ""
10833 "Unlike the B<varargs> macros, the B<stdarg> macros do not permit programmers "
10834 "to code a function with no fixed arguments.  This problem generates work "
10835 "mainly when converting B<varargs> code to B<stdarg> code, but it also "
10836 "creates difficulties for variadic functions that wish to pass all of their "
10837 "arguments on to a function that takes a I<va_list> argument, such as "
10838 "B<vfprintf>(3)."
10839 msgstr ""
10840
10841 #. type: Plain text
10842 #: build/C/man3/stdarg.3:277
10843 msgid ""
10844 "The function I<foo> takes a string of format characters and prints out the "
10845 "argument associated with each format character based on the type."
10846 msgstr ""
10847
10848 #. type: Plain text
10849 #: build/C/man3/stdarg.3:281
10850 #, no-wrap
10851 msgid ""
10852 "#include E<lt>stdio.hE<gt>\n"
10853 "#include E<lt>stdarg.hE<gt>\n"
10854 msgstr ""
10855
10856 #. type: Plain text
10857 #: build/C/man3/stdarg.3:288
10858 #, no-wrap
10859 msgid ""
10860 "void\n"
10861 "foo(char *fmt, ...)\n"
10862 "{\n"
10863 "    va_list ap;\n"
10864 "    int d;\n"
10865 "    char c, *s;\n"
10866 msgstr ""
10867
10868 #. type: Plain text
10869 #: build/C/man3/stdarg.3:309
10870 #, no-wrap
10871 msgid ""
10872 "    va_start(ap, fmt);\n"
10873 "    while (*fmt)\n"
10874 "        switch (*fmt++) {\n"
10875 "        case \\(aqs\\(aq:              /* string */\n"
10876 "            s = va_arg(ap, char *);\n"
10877 "            printf(\"string %s\\en\", s);\n"
10878 "            break;\n"
10879 "        case \\(aqd\\(aq:              /* int */\n"
10880 "            d = va_arg(ap, int);\n"
10881 "            printf(\"int %d\\en\", d);\n"
10882 "            break;\n"
10883 "        case \\(aqc\\(aq:              /* char */\n"
10884 "            /* need a cast here since va_arg only\n"
10885 "               takes fully promoted types */\n"
10886 "            c = (char) va_arg(ap, int);\n"
10887 "            printf(\"char %c\\en\", c);\n"
10888 "            break;\n"
10889 "        }\n"
10890 "    va_end(ap);\n"
10891 "}\n"
10892 msgstr ""
10893
10894 #. type: TH
10895 #: build/C/man2/syslog.2:29 build/C/man3/syslog.3:34
10896 #, no-wrap
10897 msgid "SYSLOG"
10898 msgstr ""
10899
10900 #. type: TH
10901 #: build/C/man2/syslog.2:29
10902 #, no-wrap
10903 msgid "2012-05-05"
10904 msgstr ""
10905
10906 #. type: Plain text
10907 #: build/C/man2/syslog.2:33
10908 msgid ""
10909 "syslog, klogctl - read and/or clear kernel message ring buffer; set "
10910 "console_loglevel"
10911 msgstr ""
10912
10913 #. type: Plain text
10914 #: build/C/man2/syslog.2:37
10915 #, no-wrap
10916 msgid ""
10917 "B<int syslog(int >I<type>B<, char *>I<bufp>B<, int >I<len>B<);>\n"
10918 "B</* No wrapper provided in glibc */>\n"
10919 msgstr ""
10920
10921 #. type: Plain text
10922 #: build/C/man2/syslog.2:39
10923 #, no-wrap
10924 msgid "/* The glibc interface */\n"
10925 msgstr ""
10926
10927 #. type: Plain text
10928 #: build/C/man2/syslog.2:41
10929 #, no-wrap
10930 msgid "B<#include E<lt>sys/klog.hE<gt>>\n"
10931 msgstr ""
10932
10933 #. type: Plain text
10934 #: build/C/man2/syslog.2:43
10935 #, no-wrap
10936 msgid "B<int klogctl(int >I<type>B<, char *>I<bufp>B<, int >I<len>B<);>\n"
10937 msgstr ""
10938
10939 #. type: Plain text
10940 #: build/C/man2/syslog.2:55
10941 msgid ""
10942 "If you need the C library function B<syslog>()  (which talks to "
10943 "B<syslogd>(8)), then look at B<syslog>(3).  The system call of this name is "
10944 "about controlling the kernel I<printk>()  buffer, and the glibc wrapper "
10945 "function is called B<klogctl>()."
10946 msgstr ""
10947
10948 #. type: Plain text
10949 #: build/C/man2/syslog.2:58
10950 msgid ""
10951 "The I<type> argument determines the action taken by this function, as "
10952 "follows:"
10953 msgstr ""
10954
10955 #. type: Plain text
10956 #: build/C/man2/syslog.2:71
10957 #, no-wrap
10958 msgid ""
10959 "      0 -- Close the log.  Currently a NOP.\n"
10960 "      1 -- Open the log. Currently a NOP.\n"
10961 "      2 -- Read from the log.\n"
10962 "      3 -- Read all messages remaining in the ring buffer.\n"
10963 "      4 -- Read and clear all messages remaining in the ring buffer\n"
10964 "      5 -- Clear ring buffer.\n"
10965 "      6 -- Disable printk to console\n"
10966 "      7 -- Enable printk to console\n"
10967 "      8 -- Set level of messages printed to console\n"
10968 "      9 -- Return number of unread characters in the log buffer\n"
10969 "     10 -- Return size of the log buffer\n"
10970 msgstr ""
10971
10972 #. type: Plain text
10973 #: build/C/man2/syslog.2:74
10974 msgid "Type 9 was added in Linux 2.4.10; type 10 in Linux 2.6.6."
10975 msgstr ""
10976
10977 #. type: Plain text
10978 #: build/C/man2/syslog.2:90
10979 msgid ""
10980 "In Linux kernels before 2.6.37, only command types 3 and 10 are allowed to "
10981 "unprivileged processes.  Since Linux 2.6.37, command types 3 and 10 are only "
10982 "allowed to unprivileged processes if I</proc/sys/kernel/dmesg_restrict> has "
10983 "the value 0.  Before Linux 2.6.37, \"privileged\" means that the caller has "
10984 "the B<CAP_SYS_ADMIN> capability.  Since Linux 2.6.37, \"privileged\" means "
10985 "that the caller has either the B<CAP_SYS_ADMIN> capability (now deprecated "
10986 "for this purpose) or the (new)  B<CAP_SYSLOG> capability."
10987 msgstr ""
10988
10989 #. type: SS
10990 #: build/C/man2/syslog.2:90
10991 #, no-wrap
10992 msgid "The kernel log buffer"
10993 msgstr ""
10994
10995 #.  Under "General setup" ==> "Kernel log buffer size"
10996 #.  For 2.6, precisely the option seems to have appeared in 2.5.55.
10997 #. type: Plain text
10998 #: build/C/man2/syslog.2:105
10999 msgid ""
11000 "The kernel has a cyclic buffer of length B<LOG_BUF_LEN> in which messages "
11001 "given as arguments to the kernel function B<printk>()  are stored "
11002 "(regardless of their loglevel).  In early kernels, B<LOG_BUF_LEN> had the "
11003 "value 4096; from kernel 1.3.54, it was 8192; from kernel 2.1.113 it was "
11004 "16384; since 2.4.23/2.6 the value is a kernel configuration option.  In "
11005 "recent kernels the size can be queried with command type 10."
11006 msgstr ""
11007
11008 #. type: Plain text
11009 #: build/C/man2/syslog.2:117
11010 msgid ""
11011 "The call I<syslog(2,buf,len)> waits until this kernel log buffer is "
11012 "nonempty, and then reads at most I<len> bytes into the buffer I<buf>.  It "
11013 "returns the number of bytes read.  Bytes read from the log disappear from "
11014 "the log buffer: the information can only be read once.  This is the function "
11015 "executed by the kernel when a user program reads I</proc/kmsg>."
11016 msgstr ""
11017
11018 #. type: Plain text
11019 #: build/C/man2/syslog.2:124
11020 msgid ""
11021 "The call I<syslog(3,buf,len)> will read the last I<len> bytes from the log "
11022 "buffer (nondestructively), but will not read more than was written into the "
11023 "buffer since the last \"clear ring buffer\" command (which does not clear "
11024 "the buffer at all).  It returns the number of bytes read."
11025 msgstr ""
11026
11027 #. type: Plain text
11028 #: build/C/man2/syslog.2:128
11029 msgid ""
11030 "The call I<syslog(4,buf,len)> does precisely the same, but also executes the "
11031 "\"clear ring buffer\" command."
11032 msgstr ""
11033
11034 #. type: Plain text
11035 #: build/C/man2/syslog.2:137
11036 msgid ""
11037 "The call I<syslog(5,dummy,dummy)> executes just the \"clear ring buffer\" "
11038 "command.  (In each call where I<buf> or I<len> is shown as \"dummy\", the "
11039 "value of the argument is ignored by the call.)"
11040 msgstr ""
11041
11042 #. type: Plain text
11043 #: build/C/man2/syslog.2:142
11044 msgid ""
11045 "The call I<syslog(6,dummy,dummy)> sets the console log level to minimum, so "
11046 "that no messages are printed to the console."
11047 msgstr ""
11048
11049 #. type: Plain text
11050 #: build/C/man2/syslog.2:147
11051 msgid ""
11052 "The call I<syslog(7,dummy,dummy)> sets the console log level to default, so "
11053 "that messages are printed to the console."
11054 msgstr ""
11055
11056 #. type: Plain text
11057 #: build/C/man2/syslog.2:156
11058 msgid ""
11059 "The call I<syslog(8,dummy,level)> sets the console log level to I<level>, "
11060 "which must be an integer between 1 and 8 (inclusive).  See the B<loglevel> "
11061 "section for details."
11062 msgstr ""
11063
11064 #. type: Plain text
11065 #: build/C/man2/syslog.2:161
11066 msgid ""
11067 "The call I<syslog(9,dummy,dummy)> returns the number of bytes currently "
11068 "available to be read on the kernel log buffer."
11069 msgstr ""
11070
11071 #. type: Plain text
11072 #: build/C/man2/syslog.2:165
11073 msgid ""
11074 "The call I<syslog(10,dummy,dummy)> returns the total size of the kernel log "
11075 "buffer."
11076 msgstr ""
11077
11078 #. type: SS
11079 #: build/C/man2/syslog.2:165
11080 #, no-wrap
11081 msgid "The loglevel"
11082 msgstr ""
11083
11084 #. type: Plain text
11085 #: build/C/man2/syslog.2:182
11086 msgid ""
11087 "The kernel routine B<printk>()  will only print a message on the console, if "
11088 "it has a loglevel less than the value of the variable I<console_loglevel>.  "
11089 "This variable initially has the value B<DEFAULT_CONSOLE_LOGLEVEL> (7), but "
11090 "is set to 10 if the kernel command line contains the word \"debug\", and to "
11091 "15 in case of a kernel fault (the 10 and 15 are just silly, and equivalent "
11092 "to 8).  This variable is set (to a value in the range 1-8) by the call "
11093 "I<syslog(8,dummy,value)>.  The calls I<syslog(type,dummy,dummy)> with "
11094 "I<type> equal to 6 or 7, set it to 1 (kernel panics only)  or 7 (all except "
11095 "debugging messages), respectively."
11096 msgstr ""
11097
11098 #. type: Plain text
11099 #: build/C/man2/syslog.2:192
11100 msgid ""
11101 "Every text line in a message has its own loglevel.  This level is "
11102 "I<DEFAULT_MESSAGE_LOGLEVEL - 1> (6) unless the line starts with E<lt>dE<gt> "
11103 "where I<d> is a digit in the range 1-7, in which case the level is I<d>.  "
11104 "The conventional meaning of the loglevel is defined in "
11105 "I<E<lt>linux/kernel.hE<gt>> as follows:"
11106 msgstr ""
11107
11108 #. type: Plain text
11109 #: build/C/man2/syslog.2:202
11110 #, no-wrap
11111 msgid ""
11112 "#define KERN_EMERG    \"E<lt>0E<gt>\"  /* system is unusable               "
11113 "*/\n"
11114 "#define KERN_ALERT    \"E<lt>1E<gt>\"  /* action must be taken immediately "
11115 "*/\n"
11116 "#define KERN_CRIT     \"E<lt>2E<gt>\"  /* critical conditions              "
11117 "*/\n"
11118 "#define KERN_ERR      \"E<lt>3E<gt>\"  /* error conditions                 "
11119 "*/\n"
11120 "#define KERN_WARNING  \"E<lt>4E<gt>\"  /* warning conditions               "
11121 "*/\n"
11122 "#define KERN_NOTICE   \"E<lt>5E<gt>\"  /* normal but significant condition "
11123 "*/\n"
11124 "#define KERN_INFO     \"E<lt>6E<gt>\"  /* informational                    "
11125 "*/\n"
11126 "#define KERN_DEBUG    \"E<lt>7E<gt>\"  /* debug-level messages             "
11127 "*/\n"
11128 msgstr ""
11129
11130 #. type: Plain text
11131 #: build/C/man2/syslog.2:216
11132 msgid ""
11133 "For I<type> equal to 2, 3, or 4, a successful call to B<syslog>()  returns "
11134 "the number of bytes read.  For I<type> 9, B<syslog>()  returns the number of "
11135 "bytes currently available to be read on the kernel log buffer.  For I<type> "
11136 "10, B<syslog>()  returns the total size of the kernel log buffer.  For other "
11137 "values of I<type>, 0 is returned on success."
11138 msgstr ""
11139
11140 #. type: Plain text
11141 #: build/C/man2/syslog.2:219
11142 msgid "In case of error, -1 is returned, and I<errno> is set to indicate the error."
11143 msgstr ""
11144
11145 #. type: Plain text
11146 #: build/C/man2/syslog.2:237
11147 msgid ""
11148 "Bad arguments (e.g., bad I<type>; or for I<type> 2, 3, or 4, I<buf> is NULL, "
11149 "or I<len> is less than zero; or for I<type> 8, the I<level> is outside the "
11150 "range 1 to 8)."
11151 msgstr ""
11152
11153 #. type: Plain text
11154 #: build/C/man2/syslog.2:244
11155 msgid ""
11156 "This B<syslog>()  system call is not available, because the kernel was "
11157 "compiled with the B<CONFIG_PRINTK> kernel-configuration option disabled."
11158 msgstr ""
11159
11160 #. type: Plain text
11161 #: build/C/man2/syslog.2:253
11162 msgid ""
11163 "An attempt was made to change console_loglevel or clear the kernel message "
11164 "ring buffer by a process without sufficient privilege (more precisely: "
11165 "without the B<CAP_SYS_ADMIN> or B<CAP_SYSLOG> capability)."
11166 msgstr ""
11167
11168 #. type: TP
11169 #: build/C/man2/syslog.2:253
11170 #, no-wrap
11171 msgid "B<ERESTARTSYS>"
11172 msgstr ""
11173
11174 #. type: Plain text
11175 #: build/C/man2/syslog.2:257
11176 msgid ""
11177 "System call was interrupted by a signal; nothing was read.  (This can be "
11178 "seen only during a trace.)"
11179 msgstr ""
11180
11181 #. type: Plain text
11182 #: build/C/man2/syslog.2:260
11183 msgid ""
11184 "This system call is Linux-specific and should not be used in programs "
11185 "intended to be portable."
11186 msgstr ""
11187
11188 #.  In libc4 and libc5 the number of this call was defined by
11189 #.  .BR SYS_klog .
11190 #.  In glibc 2.0 the syscall is baptized
11191 #.  .BR klogctl ().
11192 #. type: Plain text
11193 #: build/C/man2/syslog.2:268
11194 msgid ""
11195 "From the very start people noted that it is unfortunate that a system call "
11196 "and a library routine of the same name are entirely different animals."
11197 msgstr ""
11198
11199 #. type: Plain text
11200 #: build/C/man2/syslog.2:271
11201 msgid "B<syslog>(3), B<capabilities>(7)"
11202 msgstr ""
11203
11204 #. type: TH
11205 #: build/C/man3/syslog.3:34
11206 #, no-wrap
11207 msgid "2012-04-30"
11208 msgstr ""
11209
11210 #. type: Plain text
11211 #: build/C/man3/syslog.3:37
11212 msgid "closelog, openlog, syslog, vsyslog - send messages to the system logger"
11213 msgstr ""
11214
11215 #. type: Plain text
11216 #: build/C/man3/syslog.3:39
11217 msgid "B<#include E<lt>syslog.hE<gt>>"
11218 msgstr ""
11219
11220 #. type: Plain text
11221 #: build/C/man3/syslog.3:41
11222 msgid ""
11223 "B<void openlog(const char *>I<ident>B<, int >I<option>B<, int "
11224 ">I<facility>B<);>"
11225 msgstr ""
11226
11227 #. type: Plain text
11228 #: build/C/man3/syslog.3:43
11229 msgid "B<void syslog(int >I<priority>B<, const char *>I<format>B<, ...);>"
11230 msgstr ""
11231
11232 #. type: Plain text
11233 #: build/C/man3/syslog.3:45
11234 msgid "B<void closelog(void);>"
11235 msgstr ""
11236
11237 #. type: Plain text
11238 #: build/C/man3/syslog.3:49
11239 msgid ""
11240 "B<void vsyslog(int >I<priority>B<, const char *>I<format>B<, va_list "
11241 ">I<ap>B<);>"
11242 msgstr ""
11243
11244 #. type: Plain text
11245 #: build/C/man3/syslog.3:57
11246 msgid "B<vsyslog>(): _BSD_SOURCE"
11247 msgstr ""
11248
11249 #. type: Plain text
11250 #: build/C/man3/syslog.3:63
11251 msgid ""
11252 "B<closelog>()  closes the descriptor being used to write to the system "
11253 "logger.  The use of B<closelog>()  is optional."
11254 msgstr ""
11255
11256 #. type: Plain text
11257 #: build/C/man3/syslog.3:75
11258 msgid ""
11259 "B<openlog>()  opens a connection to the system logger for a program.  The "
11260 "string pointed to by I<ident> is prepended to every message, and is "
11261 "typically set to the program name.  If I<ident> is NULL, the program name is "
11262 "used.  (POSIX.1-2008 does not specify the behavior when I<ident> is NULL.)"
11263 msgstr ""
11264
11265 #. type: Plain text
11266 #: build/C/man3/syslog.3:99
11267 msgid ""
11268 "The I<option> argument specifies flags which control the operation of "
11269 "B<openlog>()  and subsequent calls to B<syslog>().  The I<facility> argument "
11270 "establishes a default to be used if none is specified in subsequent calls to "
11271 "B<syslog>().  Values for I<option> and I<facility> are given below.  The use "
11272 "of B<openlog>()  is optional; it will automatically be called by B<syslog>()  "
11273 "if necessary, in which case I<ident> will default to NULL."
11274 msgstr ""
11275
11276 #. type: Plain text
11277 #: build/C/man3/syslog.3:123
11278 msgid ""
11279 "B<syslog>()  generates a log message, which will be distributed by "
11280 "B<syslogd>(8).  The I<priority> argument is formed by ORing the I<facility> "
11281 "and the I<level> values (explained below).  The remaining arguments are a "
11282 "I<format>, as in B<printf>(3)  and any arguments required by the I<format>, "
11283 "except that the two character sequence B<%m> will be replaced by the error "
11284 "message string I<strerror>(I<errno>).  A trailing newline may be added if "
11285 "needed."
11286 msgstr ""
11287
11288 #. type: Plain text
11289 #: build/C/man3/syslog.3:132
11290 msgid ""
11291 "The function B<vsyslog>()  performs the same task as B<syslog>()  with the "
11292 "difference that it takes a set of arguments which have been obtained using "
11293 "the B<stdarg>(3)  variable argument list macros."
11294 msgstr ""
11295
11296 #. type: Plain text
11297 #: build/C/man3/syslog.3:135
11298 msgid ""
11299 "The subsections below list the parameters used to set the values of "
11300 "I<option>,I< facility>, and I<priority>."
11301 msgstr ""
11302
11303 #. type: SS
11304 #: build/C/man3/syslog.3:135
11305 #, no-wrap
11306 msgid "option"
11307 msgstr ""
11308
11309 #. type: Plain text
11310 #: build/C/man3/syslog.3:141
11311 msgid "The I<option> argument to B<openlog>()  is an OR of any of these:"
11312 msgstr ""
11313
11314 #. type: TP
11315 #: build/C/man3/syslog.3:141
11316 #, no-wrap
11317 msgid "B<LOG_CONS>"
11318 msgstr ""
11319
11320 #. type: Plain text
11321 #: build/C/man3/syslog.3:145
11322 msgid ""
11323 "Write directly to system console if there is an error while sending to "
11324 "system logger."
11325 msgstr ""
11326
11327 #. type: TP
11328 #: build/C/man3/syslog.3:145
11329 #, no-wrap
11330 msgid "B<LOG_NDELAY>"
11331 msgstr ""
11332
11333 #. type: Plain text
11334 #: build/C/man3/syslog.3:149
11335 msgid ""
11336 "Open the connection immediately (normally, the connection is opened when the "
11337 "first message is logged)."
11338 msgstr ""
11339
11340 #. type: TP
11341 #: build/C/man3/syslog.3:149
11342 #, no-wrap
11343 msgid "B<LOG_NOWAIT>"
11344 msgstr ""
11345
11346 #. type: Plain text
11347 #: build/C/man3/syslog.3:155
11348 msgid ""
11349 "Don't wait for child processes that may have been created while logging the "
11350 "message.  (The GNU C library does not create a child process, so this option "
11351 "has no effect on Linux.)"
11352 msgstr ""
11353
11354 #. type: TP
11355 #: build/C/man3/syslog.3:155
11356 #, no-wrap
11357 msgid "B<LOG_ODELAY>"
11358 msgstr ""
11359
11360 #. type: Plain text
11361 #: build/C/man3/syslog.3:163
11362 msgid ""
11363 "The converse of B<LOG_NDELAY>; opening of the connection is delayed until "
11364 "B<syslog>()  is called.  (This is the default, and need not be specified.)"
11365 msgstr ""
11366
11367 #. type: TP
11368 #: build/C/man3/syslog.3:163
11369 #, no-wrap
11370 msgid "B<LOG_PERROR>"
11371 msgstr ""
11372
11373 #. type: Plain text
11374 #: build/C/man3/syslog.3:167
11375 msgid "(Not in POSIX.1-2001 or POSIX.1-2008.)  Print to I<stderr> as well."
11376 msgstr ""
11377
11378 #. type: TP
11379 #: build/C/man3/syslog.3:167
11380 #, no-wrap
11381 msgid "B<LOG_PID>"
11382 msgstr ""
11383
11384 #. type: Plain text
11385 #: build/C/man3/syslog.3:170
11386 msgid "Include PID with each message."
11387 msgstr ""
11388
11389 #. type: SS
11390 #: build/C/man3/syslog.3:170
11391 #, no-wrap
11392 msgid "facility"
11393 msgstr ""
11394
11395 #. type: Plain text
11396 #: build/C/man3/syslog.3:176
11397 msgid ""
11398 "The I<facility> argument is used to specify what type of program is logging "
11399 "the message.  This lets the configuration file specify that messages from "
11400 "different facilities will be handled differently."
11401 msgstr ""
11402
11403 #. type: TP
11404 #: build/C/man3/syslog.3:176
11405 #, no-wrap
11406 msgid "B<LOG_AUTH>"
11407 msgstr ""
11408
11409 #. type: Plain text
11410 #: build/C/man3/syslog.3:181
11411 msgid "security/authorization messages (DEPRECATED Use B<LOG_AUTHPRIV> instead)"
11412 msgstr ""
11413
11414 #. type: TP
11415 #: build/C/man3/syslog.3:181
11416 #, no-wrap
11417 msgid "B<LOG_AUTHPRIV>"
11418 msgstr ""
11419
11420 #. type: Plain text
11421 #: build/C/man3/syslog.3:184
11422 msgid "security/authorization messages (private)"
11423 msgstr ""
11424
11425 #. type: TP
11426 #: build/C/man3/syslog.3:184
11427 #, no-wrap
11428 msgid "B<LOG_CRON>"
11429 msgstr ""
11430
11431 #. type: Plain text
11432 #: build/C/man3/syslog.3:188
11433 msgid "clock daemon (B<cron> and B<at>)"
11434 msgstr ""
11435
11436 #. type: TP
11437 #: build/C/man3/syslog.3:188
11438 #, no-wrap
11439 msgid "B<LOG_DAEMON>"
11440 msgstr ""
11441
11442 #. type: Plain text
11443 #: build/C/man3/syslog.3:191
11444 msgid "system daemons without separate facility value"
11445 msgstr ""
11446
11447 #. type: TP
11448 #: build/C/man3/syslog.3:191
11449 #, no-wrap
11450 msgid "B<LOG_FTP>"
11451 msgstr ""
11452
11453 #. type: Plain text
11454 #: build/C/man3/syslog.3:194
11455 msgid "ftp daemon"
11456 msgstr ""
11457
11458 #. type: TP
11459 #: build/C/man3/syslog.3:194
11460 #, no-wrap
11461 msgid "B<LOG_KERN>"
11462 msgstr ""
11463
11464 #.  LOG_KERN has the value 0; if used as a facility, zero translates to:
11465 #.  "use the default facility".
11466 #. type: Plain text
11467 #: build/C/man3/syslog.3:199
11468 msgid "kernel messages (these can't be generated from user processes)"
11469 msgstr ""
11470
11471 #. type: TP
11472 #: build/C/man3/syslog.3:199
11473 #, no-wrap
11474 msgid "B<LOG_LOCAL0> through B<LOG_LOCAL7>"
11475 msgstr ""
11476
11477 #. type: Plain text
11478 #: build/C/man3/syslog.3:202
11479 msgid "reserved for local use"
11480 msgstr ""
11481
11482 #. type: TP
11483 #: build/C/man3/syslog.3:202
11484 #, no-wrap
11485 msgid "B<LOG_LPR>"
11486 msgstr ""
11487
11488 #. type: Plain text
11489 #: build/C/man3/syslog.3:205
11490 msgid "line printer subsystem"
11491 msgstr ""
11492
11493 #. type: TP
11494 #: build/C/man3/syslog.3:205
11495 #, no-wrap
11496 msgid "B<LOG_MAIL>"
11497 msgstr ""
11498
11499 #. type: Plain text
11500 #: build/C/man3/syslog.3:208
11501 msgid "mail subsystem"
11502 msgstr ""
11503
11504 #. type: TP
11505 #: build/C/man3/syslog.3:208
11506 #, no-wrap
11507 msgid "B<LOG_NEWS>"
11508 msgstr ""
11509
11510 #. type: Plain text
11511 #: build/C/man3/syslog.3:211
11512 msgid "USENET news subsystem"
11513 msgstr ""
11514
11515 #. type: TP
11516 #: build/C/man3/syslog.3:211
11517 #, no-wrap
11518 msgid "B<LOG_SYSLOG>"
11519 msgstr ""
11520
11521 #. type: Plain text
11522 #: build/C/man3/syslog.3:215
11523 msgid "messages generated internally by B<syslogd>(8)"
11524 msgstr ""
11525
11526 #. type: TP
11527 #: build/C/man3/syslog.3:215
11528 #, no-wrap
11529 msgid "B<LOG_USER> (default)"
11530 msgstr ""
11531
11532 #. type: Plain text
11533 #: build/C/man3/syslog.3:218
11534 msgid "generic user-level messages"
11535 msgstr ""
11536
11537 #. type: TP
11538 #: build/C/man3/syslog.3:218
11539 #, no-wrap
11540 msgid "B<LOG_UUCP>"
11541 msgstr ""
11542
11543 #. type: Plain text
11544 #: build/C/man3/syslog.3:221
11545 msgid "UUCP subsystem"
11546 msgstr ""
11547
11548 #. type: SS
11549 #: build/C/man3/syslog.3:221
11550 #, no-wrap
11551 msgid "level"
11552 msgstr ""
11553
11554 #. type: Plain text
11555 #: build/C/man3/syslog.3:224
11556 msgid ""
11557 "This determines the importance of the message.  The levels are, in order of "
11558 "decreasing importance:"
11559 msgstr ""
11560
11561 #. type: TP
11562 #: build/C/man3/syslog.3:224
11563 #, no-wrap
11564 msgid "B<LOG_EMERG>"
11565 msgstr ""
11566
11567 #. type: Plain text
11568 #: build/C/man3/syslog.3:227
11569 msgid "system is unusable"
11570 msgstr ""
11571
11572 #. type: TP
11573 #: build/C/man3/syslog.3:227
11574 #, no-wrap
11575 msgid "B<LOG_ALERT>"
11576 msgstr ""
11577
11578 #. type: Plain text
11579 #: build/C/man3/syslog.3:230
11580 msgid "action must be taken immediately"
11581 msgstr ""
11582
11583 #. type: TP
11584 #: build/C/man3/syslog.3:230
11585 #, no-wrap
11586 msgid "B<LOG_CRIT>"
11587 msgstr ""
11588
11589 #. type: Plain text
11590 #: build/C/man3/syslog.3:233
11591 msgid "critical conditions"
11592 msgstr ""
11593
11594 #. type: TP
11595 #: build/C/man3/syslog.3:233
11596 #, no-wrap
11597 msgid "B<LOG_ERR>"
11598 msgstr ""
11599
11600 #. type: Plain text
11601 #: build/C/man3/syslog.3:236
11602 msgid "error conditions"
11603 msgstr ""
11604
11605 #. type: TP
11606 #: build/C/man3/syslog.3:236
11607 #, no-wrap
11608 msgid "B<LOG_WARNING>"
11609 msgstr ""
11610
11611 #. type: Plain text
11612 #: build/C/man3/syslog.3:239
11613 msgid "warning conditions"
11614 msgstr ""
11615
11616 #. type: TP
11617 #: build/C/man3/syslog.3:239
11618 #, no-wrap
11619 msgid "B<LOG_NOTICE>"
11620 msgstr ""
11621
11622 #. type: Plain text
11623 #: build/C/man3/syslog.3:242
11624 msgid "normal, but significant, condition"
11625 msgstr ""
11626
11627 #. type: TP
11628 #: build/C/man3/syslog.3:242
11629 #, no-wrap
11630 msgid "B<LOG_INFO>"
11631 msgstr ""
11632
11633 #. type: Plain text
11634 #: build/C/man3/syslog.3:245
11635 msgid "informational message"
11636 msgstr ""
11637
11638 #. type: TP
11639 #: build/C/man3/syslog.3:245
11640 #, no-wrap
11641 msgid "B<LOG_DEBUG>"
11642 msgstr ""
11643
11644 #. type: Plain text
11645 #: build/C/man3/syslog.3:248
11646 msgid "debug-level message"
11647 msgstr ""
11648
11649 #. type: Plain text
11650 #: build/C/man3/syslog.3:252
11651 msgid ""
11652 "The function B<setlogmask>(3)  can be used to restrict logging to specified "
11653 "levels only."
11654 msgstr ""
11655
11656 #.  .SH HISTORY
11657 #.  A
11658 #.  .BR syslog ()
11659 #.  function call appeared in 4.2BSD.
11660 #.  4.3BSD documents
11661 #.  .BR openlog (),
11662 #.  .BR syslog (),
11663 #.  .BR closelog (),
11664 #.  and
11665 #.  .BR setlogmask ().
11666 #.  4.3BSD-Reno also documents
11667 #.  .BR vsyslog ().
11668 #.  Of course early v* functions used the
11669 #.  .I <varargs.h>
11670 #.  mechanism, which is not compatible with
11671 #.  .IR <stdarg.h> .
11672 #. type: Plain text
11673 #: build/C/man3/syslog.3:296
11674 msgid ""
11675 "The functions B<openlog>(), B<closelog>(), and B<syslog>()  (but not "
11676 "B<vsyslog>())  are specified in SUSv2, POSIX.1-2001, and POSIX.1-2008.  "
11677 "POSIX.1-2001 specifies only the B<LOG_USER> and B<LOG_LOCAL*> values for "
11678 "I<facility>.  However, with the exception of B<LOG_AUTHPRIV> and B<LOG_FTP>, "
11679 "the other I<facility> values appear on most UNIX systems.  The B<LOG_PERROR> "
11680 "value for I<option> is not specified by POSIX.1-2001 or POSIX.1-2008, but is "
11681 "available in most versions of UNIX."
11682 msgstr ""
11683
11684 #. type: Plain text
11685 #: build/C/man3/syslog.3:308
11686 msgid ""
11687 "The argument I<ident> in the call of B<openlog>()  is probably stored "
11688 "as-is.  Thus, if the string it points to is changed, B<syslog>()  may start "
11689 "prepending the changed string, and if the string it points to ceases to "
11690 "exist, the results are undefined.  Most portable is to use a string "
11691 "constant."
11692 msgstr ""
11693
11694 #. type: Plain text
11695 #: build/C/man3/syslog.3:311
11696 msgid ""
11697 "Never pass a string with user-supplied data as a format, use the following "
11698 "instead:"
11699 msgstr ""
11700
11701 #. type: Plain text
11702 #: build/C/man3/syslog.3:314
11703 #, no-wrap
11704 msgid "    syslog(priority, \"%s\", string);\n"
11705 msgstr ""
11706
11707 #. type: Plain text
11708 #: build/C/man3/syslog.3:320
11709 msgid "B<logger>(1), B<setlogmask>(3), B<syslog.conf>(5), B<syslogd>(8)"
11710 msgstr ""
11711
11712 #. type: TH
11713 #: build/C/man4/ttyS.4:25
11714 #, no-wrap
11715 msgid "TTYS"
11716 msgstr ""
11717
11718 #. type: TH
11719 #: build/C/man4/ttyS.4:25
11720 #, no-wrap
11721 msgid "1992-12-19"
11722 msgstr ""
11723
11724 #. type: Plain text
11725 #: build/C/man4/ttyS.4:28
11726 msgid "ttyS - serial terminal lines"
11727 msgstr ""
11728
11729 #. type: Plain text
11730 #: build/C/man4/ttyS.4:30
11731 msgid "B<ttyS[0-3]> are character devices for the serial terminal lines."
11732 msgstr ""
11733
11734 #. type: Plain text
11735 #: build/C/man4/ttyS.4:35
11736 msgid "mknod -m 660 /dev/ttyS0 c 4 64 # base address 0x3f8"
11737 msgstr ""
11738
11739 #. type: Plain text
11740 #: build/C/man4/ttyS.4:37
11741 msgid "mknod -m 660 /dev/ttyS1 c 4 65 # base address 0x2f8"
11742 msgstr ""
11743
11744 #. type: Plain text
11745 #: build/C/man4/ttyS.4:39
11746 msgid "mknod -m 660 /dev/ttyS2 c 4 66 # base address 0x3e8"
11747 msgstr ""
11748
11749 #. type: Plain text
11750 #: build/C/man4/ttyS.4:41
11751 msgid "mknod -m 660 /dev/ttyS3 c 4 67 # base address 0x2e8"
11752 msgstr ""
11753
11754 #. type: Plain text
11755 #: build/C/man4/ttyS.4:43
11756 msgid "chown root:tty /dev/ttyS[0-3]"
11757 msgstr ""
11758
11759 #. type: Plain text
11760 #: build/C/man4/ttyS.4:46
11761 msgid "/dev/ttyS[0-3]"
11762 msgstr ""
11763
11764 #. type: Plain text
11765 #: build/C/man4/ttyS.4:53
11766 msgid ""
11767 "B<chown>(1), B<mknod>(1), B<tty>(4), B<agetty>(8), B<mingetty>(8), "
11768 "B<setserial>(8)"
11769 msgstr ""
11770
11771 #. type: TH
11772 #: build/C/man7/uri.7:47
11773 #, no-wrap
11774 msgid "URI"
11775 msgstr ""
11776
11777 #. type: TH
11778 #: build/C/man7/uri.7:47
11779 #, no-wrap
11780 msgid "2000-03-14"
11781 msgstr ""
11782
11783 #. type: Plain text
11784 #: build/C/man7/uri.7:50
11785 msgid "uri, url, urn - uniform resource identifier (URI), including a URL or URN"
11786 msgstr ""
11787
11788 #. type: Plain text
11789 #: build/C/man7/uri.7:54
11790 #, no-wrap
11791 msgid "URI = [ absoluteURI | relativeURI ] [ \"#\" fragment ]\n"
11792 msgstr ""
11793
11794 #. type: Plain text
11795 #: build/C/man7/uri.7:56
11796 #, no-wrap
11797 msgid "absoluteURI = scheme \":\" ( hierarchical_part | opaque_part )\n"
11798 msgstr ""
11799
11800 #. type: Plain text
11801 #: build/C/man7/uri.7:58
11802 #, no-wrap
11803 msgid "relativeURI = ( net_path | absolute_path | relative_path ) [ \"?\" query ]\n"
11804 msgstr ""
11805
11806 #. type: Plain text
11807 #: build/C/man7/uri.7:61
11808 #, no-wrap
11809 msgid ""
11810 "scheme = \"http\" | \"ftp\" | \"gopher\" | \"mailto\" | \"news\" | "
11811 "\"telnet\" |\n"
11812 "         \"file\" | \"man\" | \"info\" | \"whatis\" | \"ldap\" | \"wais\" | "
11813 "\\&...\n"
11814 msgstr ""
11815
11816 #. type: Plain text
11817 #: build/C/man7/uri.7:63
11818 #, no-wrap
11819 msgid "hierarchical_part = ( net_path | absolute_path ) [ \"?\" query ]\n"
11820 msgstr ""
11821
11822 #. type: Plain text
11823 #: build/C/man7/uri.7:65
11824 #, no-wrap
11825 msgid "net_path = \"//\" authority [ absolute_path ]\n"
11826 msgstr ""
11827
11828 #. type: Plain text
11829 #: build/C/man7/uri.7:67
11830 #, no-wrap
11831 msgid "absolute_path = \"/\"  path_segments\n"
11832 msgstr ""
11833
11834 #. type: Plain text
11835 #: build/C/man7/uri.7:69
11836 #, no-wrap
11837 msgid "relative_path = relative_segment [ absolute_path ]\n"
11838 msgstr ""
11839
11840 #. type: Plain text
11841 #: build/C/man7/uri.7:81
11842 msgid ""
11843 "A Uniform Resource Identifier (URI) is a short string of characters "
11844 "identifying an abstract or physical resource (for example, a web page).  A "
11845 "Uniform Resource Locator (URL) is a URI that identifies a resource through "
11846 "its primary access mechanism (e.g., its network \"location\"), rather than "
11847 "by name or some other attribute of that resource.  A Uniform Resource Name "
11848 "(URN) is a URI that must remain globally unique and persistent even when the "
11849 "resource ceases to exist or becomes unavailable."
11850 msgstr ""
11851
11852 #. type: Plain text
11853 #: build/C/man7/uri.7:88
11854 msgid ""
11855 "URIs are the standard way to name hypertext link destinations for tools such "
11856 "as web browsers.  The string \"http://www.kernelnotes.org\" is a URL (and "
11857 "thus it is also a URI).  Many people use the term URL loosely as a synonym "
11858 "for URI (though technically URLs are a subset of URIs)."
11859 msgstr ""
11860
11861 #. type: Plain text
11862 #: build/C/man7/uri.7:104
11863 msgid ""
11864 "URIs can be absolute or relative.  An absolute identifier refers to a "
11865 "resource independent of context, while a relative identifier refers to a "
11866 "resource by describing the difference from the current context.  Within a "
11867 "relative path reference, the complete path segments \".\" and \"..\" have "
11868 "special meanings: \"the current hierarchy level\" and \"the level above this "
11869 "hierarchy level\", respectively, just like they do in UNIX-like systems.  A "
11870 "path segment which contains a colon character can't be used as the first "
11871 "segment of a relative URI path (e.g., \"this:that\"), because it would be "
11872 "mistaken for a scheme name; precede such segments with ./ (e.g., "
11873 "\"./this:that\").  Note that descendants of MS-DOS (e.g., Microsoft Windows) "
11874 "replace devicename colons with the vertical bar (\"|\") in URIs, so \"C:\" "
11875 "becomes \"C|\"."
11876 msgstr ""
11877
11878 #. type: Plain text
11879 #: build/C/man7/uri.7:108
11880 msgid ""
11881 "A fragment identifier, if included, refers to a particular named portion "
11882 "(fragment) of a resource; text after a \\(aq#\\(aq identifies the fragment.  "
11883 "A URI beginning with \\(aq#\\(aq refers to that fragment in the current "
11884 "resource."
11885 msgstr ""
11886
11887 #. type: Plain text
11888 #: build/C/man7/uri.7:116
11889 msgid ""
11890 "There are many different URI schemes, each with specific additional rules "
11891 "and meanings, but they are intentionally made to be as similar as possible.  "
11892 "For example, many URL schemes permit the authority to be the following "
11893 "format, called here an I<ip_server> (square brackets show what's optional):"
11894 msgstr ""
11895
11896 #. type: Plain text
11897 #: build/C/man7/uri.7:118
11898 msgid "I<ip_server = >[I<user> [ : I<password> ] @ ] I<host> [ : I<port>]"
11899 msgstr ""
11900
11901 #. type: Plain text
11902 #: build/C/man7/uri.7:134
11903 msgid ""
11904 "This format allows you to optionally insert a username, a user plus "
11905 "password, and/or a port number.  The I<host> is the name of the host "
11906 "computer, either its name as determined by DNS or an IP address (numbers "
11907 "separated by periods).  Thus the URI "
11908 "E<lt>http://fred:fredpassword@xyz.com:8080/E<gt> logs into a web server on "
11909 "host xyz.com as fred (using fredpassword) using port 8080.  Avoid including "
11910 "a password in a URI if possible because of the many security risks of having "
11911 "a password written down.  If the URL supplies a username but no password, "
11912 "and the remote server requests a password, the program interpreting the URL "
11913 "should request one from the user."
11914 msgstr ""
11915
11916 #. type: Plain text
11917 #: build/C/man7/uri.7:139
11918 msgid ""
11919 "Here are some of the most common schemes in use on UNIX-like systems that "
11920 "are understood by many tools.  Note that many tools using URIs also have "
11921 "internal schemes or specialized schemes; see those tools' documentation for "
11922 "information on those schemes."
11923 msgstr ""
11924
11925 #. type: Plain text
11926 #: build/C/man7/uri.7:141
11927 msgid "B<http - Web (HTTP) server>"
11928 msgstr ""
11929
11930 #. type: Plain text
11931 #: build/C/man7/uri.7:143
11932 msgid "http://I<ip_server>/I<path>"
11933 msgstr ""
11934
11935 #. type: Plain text
11936 #: build/C/man7/uri.7:145
11937 msgid "http://I<ip_server>/I<path>?I<query>"
11938 msgstr ""
11939
11940 #. type: Plain text
11941 #: build/C/man7/uri.7:153
11942 msgid ""
11943 "This is a URL accessing a web (HTTP) server.  The default port is 80.  If "
11944 "the path refers to a directory, the web server will choose what to return; "
11945 "usually if there is a file named \"index.html\" or \"index.htm\" its content "
11946 "is returned, otherwise, a list of the files in the current directory (with "
11947 "appropriate links) is generated and returned.  An example is "
11948 "E<lt>http://lwn.netE<gt>."
11949 msgstr ""
11950
11951 #. type: Plain text
11952 #: build/C/man7/uri.7:174
11953 msgid ""
11954 "A query can be given in the archaic \"isindex\" format, consisting of a word "
11955 "or phrase and not including an equal sign (=).  A query can also be in the "
11956 "longer \"GET\" format, which has one or more query entries of the form "
11957 "I<key>=I<value> separated by the ampersand character (&).  Note that I<key> "
11958 "can be repeated more than once, though it's up to the web server and its "
11959 "application programs to determine if there's any meaning to that.  There is "
11960 "an unfortunate interaction with HTML/XML/SGML and the GET query format; when "
11961 "such URIs with more than one key are embedded in SGML/XML documents "
11962 "(including HTML), the ampersand (&) has to be rewritten as &amp;.  Note that "
11963 "not all queries use this format; larger forms may be too long to store as a "
11964 "URI, so they use a different interaction mechanism (called POST) which does "
11965 "not include the data in the URI.  See the Common Gateway Interface "
11966 "specification at E<lt>http://www.w3.org/CGIE<gt> for more information."
11967 msgstr ""
11968
11969 #. type: Plain text
11970 #: build/C/man7/uri.7:176
11971 msgid "B<ftp - File Transfer Protocol (FTP)>"
11972 msgstr ""
11973
11974 #. type: Plain text
11975 #: build/C/man7/uri.7:178
11976 msgid "ftp://I<ip_server>/I<path>"
11977 msgstr ""
11978
11979 #. type: Plain text
11980 #: build/C/man7/uri.7:186
11981 msgid ""
11982 "This is a URL accessing a file through the file transfer protocol (FTP).  "
11983 "The default port (for control) is 21.  If no username is included, the "
11984 "username \"anonymous\" is supplied, and in that case many clients provide as "
11985 "the password the requestor's Internet email address.  An example is "
11986 "E<lt>ftp://ftp.is.co.za/rfc/rfc1808.txtE<gt>."
11987 msgstr ""
11988
11989 #. type: Plain text
11990 #: build/C/man7/uri.7:188
11991 msgid "B<gopher - Gopher server>"
11992 msgstr ""
11993
11994 #. type: Plain text
11995 #: build/C/man7/uri.7:190
11996 msgid "gopher://I<ip_server>/I<gophertype selector>"
11997 msgstr ""
11998
11999 #. type: Plain text
12000 #: build/C/man7/uri.7:192
12001 msgid "gopher://I<ip_server>/I<gophertype selector>%09I<search>"
12002 msgstr ""
12003
12004 #. type: Plain text
12005 #: build/C/man7/uri.7:194
12006 msgid "gopher://I<ip_server>/I<gophertype selector>%09I<search>%09I<gopher+_string>"
12007 msgstr ""
12008
12009 #. type: Plain text
12010 #: build/C/man7/uri.7:204
12011 msgid ""
12012 "The default gopher port is 70.  I<gophertype> is a single-character field to "
12013 "denote the Gopher type of the resource to which the URL refers.  The entire "
12014 "path may also be empty, in which case the delimiting \"/\" is also optional "
12015 "and the gophertype defaults to \"1\"."
12016 msgstr ""
12017
12018 #. type: Plain text
12019 #: build/C/man7/uri.7:211
12020 msgid ""
12021 "I<selector> is the Gopher selector string.  In the Gopher protocol, Gopher "
12022 "selector strings are a sequence of octets which may contain any octets "
12023 "except 09 hexadecimal (US-ASCII HT or tab), 0A hexadecimal (US-ASCII "
12024 "character LF), and 0D (US-ASCII character CR)."
12025 msgstr ""
12026
12027 #. type: Plain text
12028 #: build/C/man7/uri.7:213
12029 msgid "B<mailto - Email address>"
12030 msgstr ""
12031
12032 #. type: Plain text
12033 #: build/C/man7/uri.7:215
12034 msgid "mailto:I<email-address>"
12035 msgstr ""
12036
12037 #. type: Plain text
12038 #: build/C/man7/uri.7:223
12039 msgid ""
12040 "This is an email address, usually of the form I<name>@I<hostname>.  See "
12041 "B<mailaddr>(7)  for more information on the correct format of an email "
12042 "address.  Note that any % character must be rewritten as %25.  An example is "
12043 "E<lt>mailto:dwheeler@dwheeler.comE<gt>."
12044 msgstr ""
12045
12046 #. type: Plain text
12047 #: build/C/man7/uri.7:225
12048 msgid "B<news - Newsgroup or News message>"
12049 msgstr ""
12050
12051 #. type: Plain text
12052 #: build/C/man7/uri.7:227
12053 msgid "news:I<newsgroup-name>"
12054 msgstr ""
12055
12056 #. type: Plain text
12057 #: build/C/man7/uri.7:229
12058 msgid "news:I<message-id>"
12059 msgstr ""
12060
12061 #. type: Plain text
12062 #: build/C/man7/uri.7:237
12063 msgid ""
12064 "A I<newsgroup-name> is a period-delimited hierarchical name, such as "
12065 "\"comp.infosystems.www.misc\".  If E<lt>newsgroup-nameE<gt> is \"*\" (as in "
12066 "E<lt>news:*E<gt>), it is used to refer to \"all available news groups\".  An "
12067 "example is E<lt>news:comp.lang.adaE<gt>."
12068 msgstr ""
12069
12070 #. type: Plain text
12071 #: build/C/man7/uri.7:241
12072 msgid "A I<message-id> corresponds to the Message-ID of"
12073 msgstr ""
12074
12075 #. type: UR
12076 #: build/C/man7/uri.7:241
12077 #, no-wrap
12078 msgid "http://www.ietf.org/rfc/rfc1036.txt"
12079 msgstr ""
12080
12081 #. type: Plain text
12082 #: build/C/man7/uri.7:243
12083 msgid "IETF RFC\\ 1036,"
12084 msgstr ""
12085
12086 #. type: Plain text
12087 #: build/C/man7/uri.7:249
12088 msgid ""
12089 "without the enclosing \"E<lt>\" and \"E<gt>\"; it takes the form "
12090 "I<unique>@I<full_domain_name>.  A message identifier may be distinguished "
12091 "from a news group name by the presence of the \"@\" character."
12092 msgstr ""
12093
12094 #. type: Plain text
12095 #: build/C/man7/uri.7:251
12096 msgid "B<telnet - Telnet login>"
12097 msgstr ""
12098
12099 #. type: Plain text
12100 #: build/C/man7/uri.7:253
12101 msgid "telnet://I<ip_server>/"
12102 msgstr ""
12103
12104 #. type: Plain text
12105 #: build/C/man7/uri.7:259
12106 msgid ""
12107 "The Telnet URL scheme is used to designate interactive text services that "
12108 "may be accessed by the Telnet protocol.  The final \"/\" character may be "
12109 "omitted.  The default port is 23.  An example is "
12110 "E<lt>telnet://melvyl.ucop.edu/E<gt>."
12111 msgstr ""
12112
12113 #. type: Plain text
12114 #: build/C/man7/uri.7:261
12115 msgid "B<file - Normal file>"
12116 msgstr ""
12117
12118 #. type: Plain text
12119 #: build/C/man7/uri.7:263
12120 msgid "file://I<ip_server>/I<path_segments>"
12121 msgstr ""
12122
12123 #. type: Plain text
12124 #: build/C/man7/uri.7:265
12125 msgid "file:I<path_segments>"
12126 msgstr ""
12127
12128 #. type: Plain text
12129 #: build/C/man7/uri.7:282
12130 msgid ""
12131 "This represents a file or directory accessible locally.  As a special case, "
12132 "I<host> can be the string \"localhost\" or the empty string; this is "
12133 "interpreted as \"the machine from which the URL is being interpreted\".  If "
12134 "the path is to a directory, the viewer should display the directory's "
12135 "contents with links to each containee; not all viewers currently do this.  "
12136 "KDE supports generated files through the URL E<lt>file:/cgi-binE<gt>.  If "
12137 "the given file isn't found, browser writers may want to try to expand the "
12138 "filename via filename globbing (see B<glob>(7)  and B<glob>(3))."
12139 msgstr ""
12140
12141 #. type: Plain text
12142 #: build/C/man7/uri.7:296
12143 msgid ""
12144 "The second format (e.g., E<lt>file:/etc/passwdE<gt>)  is a correct format "
12145 "for referring to a local file.  However, older standards did not permit this "
12146 "format, and some programs don't recognize this as a URI.  A more portable "
12147 "syntax is to use an empty string as the server name, for example, "
12148 "E<lt>file:///etc/passwdE<gt>; this form does the same thing and is easily "
12149 "recognized by pattern matchers and older programs as a URI.  Note that if "
12150 "you really mean to say \"start from the current location,\" don't specify "
12151 "the scheme at all; use a relative address like E<lt>../test.txtE<gt>, which "
12152 "has the side-effect of being scheme-independent.  An example of this scheme "
12153 "is E<lt>file:///etc/passwdE<gt>."
12154 msgstr ""
12155
12156 #. type: Plain text
12157 #: build/C/man7/uri.7:298
12158 msgid "B<man - Man page documentation>"
12159 msgstr ""
12160
12161 #. type: Plain text
12162 #: build/C/man7/uri.7:300
12163 msgid "man:I<command-name>"
12164 msgstr ""
12165
12166 #. type: Plain text
12167 #: build/C/man7/uri.7:302
12168 msgid "man:I<command-name>(I<section>)"
12169 msgstr ""
12170
12171 #. type: Plain text
12172 #: build/C/man7/uri.7:311
12173 msgid ""
12174 "This refers to local online manual (man) reference pages.  The command name "
12175 "can optionally be followed by a parenthesis and section number; see "
12176 "B<man>(7)  for more information on the meaning of the section numbers.  This "
12177 "URI scheme is unique to UNIX-like systems (such as Linux)  and is not "
12178 "currently registered by the IETF.  An example is E<lt>man:ls(1)E<gt>."
12179 msgstr ""
12180
12181 #. type: Plain text
12182 #: build/C/man7/uri.7:313
12183 msgid "B<info - Info page documentation>"
12184 msgstr ""
12185
12186 #. type: Plain text
12187 #: build/C/man7/uri.7:315
12188 msgid "info:I<virtual-filename>"
12189 msgstr ""
12190
12191 #. type: Plain text
12192 #: build/C/man7/uri.7:317
12193 msgid "info:I<virtual-filename>#I<nodename>"
12194 msgstr ""
12195
12196 #. type: Plain text
12197 #: build/C/man7/uri.7:319
12198 msgid "info:(I<virtual-filename>)"
12199 msgstr ""
12200
12201 #. type: Plain text
12202 #: build/C/man7/uri.7:321
12203 msgid "info:(I<virtual-filename>)I<nodename>"
12204 msgstr ""
12205
12206 #. type: Plain text
12207 #: build/C/man7/uri.7:340
12208 msgid ""
12209 "This scheme refers to online info reference pages (generated from texinfo "
12210 "files), a documentation format used by programs such as the GNU tools.  This "
12211 "URI scheme is unique to UNIX-like systems (such as Linux)  and is not "
12212 "currently registered by the IETF.  As of this writing, GNOME and KDE differ "
12213 "in their URI syntax and do not accept the other's syntax.  The first two "
12214 "formats are the GNOME format; in nodenames all spaces are written as "
12215 "underscores.  The second two formats are the KDE format; spaces in nodenames "
12216 "must be written as spaces, even though this is forbidden by the URI "
12217 "standards.  It's hoped that in the future most tools will understand all of "
12218 "these formats and will always accept underscores for spaces in nodenames.  "
12219 "In both GNOME and KDE, if the form without the nodename is used the nodename "
12220 "is assumed to be \"Top\".  Examples of the GNOME format are "
12221 "E<lt>info:gccE<gt> and E<lt>info:gcc#G++_and_GCCE<gt>.  Examples of the KDE "
12222 "format are E<lt>info:(gcc)E<gt> and E<lt>info:(gcc)G++ and GCCE<gt>."
12223 msgstr ""
12224
12225 #. type: Plain text
12226 #: build/C/man7/uri.7:342
12227 msgid "B<whatis - Documentation search>"
12228 msgstr ""
12229
12230 #. type: Plain text
12231 #: build/C/man7/uri.7:344
12232 msgid "whatis:I<string>"
12233 msgstr ""
12234
12235 #. type: Plain text
12236 #: build/C/man7/uri.7:352
12237 msgid ""
12238 "This scheme searches the database of short (one-line) descriptions of "
12239 "commands and returns a list of descriptions containing that string.  Only "
12240 "complete word matches are returned.  See B<whatis>(1).  This URI scheme is "
12241 "unique to UNIX-like systems (such as Linux)  and is not currently registered "
12242 "by the IETF."
12243 msgstr ""
12244
12245 #. type: Plain text
12246 #: build/C/man7/uri.7:354
12247 msgid "B<ghelp - GNOME help documentation>"
12248 msgstr ""
12249
12250 #. type: Plain text
12251 #: build/C/man7/uri.7:356
12252 msgid "ghelp:I<name-of-application>"
12253 msgstr ""
12254
12255 #. type: Plain text
12256 #: build/C/man7/uri.7:359
12257 msgid ""
12258 "This loads GNOME help for the given application.  Note that not much "
12259 "documentation currently exists in this format."
12260 msgstr ""
12261
12262 #. type: Plain text
12263 #: build/C/man7/uri.7:361
12264 msgid "B<ldap - Lightweight Directory Access Protocol>"
12265 msgstr ""
12266
12267 #. type: Plain text
12268 #: build/C/man7/uri.7:363
12269 msgid "ldap://I<hostport>"
12270 msgstr ""
12271
12272 #. type: Plain text
12273 #: build/C/man7/uri.7:365
12274 msgid "ldap://I<hostport>/"
12275 msgstr ""
12276
12277 #. type: Plain text
12278 #: build/C/man7/uri.7:367
12279 msgid "ldap://I<hostport>/I<dn>"
12280 msgstr ""
12281
12282 #. type: Plain text
12283 #: build/C/man7/uri.7:369
12284 msgid "ldap://I<hostport>/I<dn>?I<attributes>"
12285 msgstr ""
12286
12287 #. type: Plain text
12288 #: build/C/man7/uri.7:371
12289 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>"
12290 msgstr ""
12291
12292 #. type: Plain text
12293 #: build/C/man7/uri.7:373
12294 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>?I<filter>"
12295 msgstr ""
12296
12297 #. type: Plain text
12298 #: build/C/man7/uri.7:375
12299 msgid "ldap://I<hostport>/I<dn>?I<attributes>?I<scope>?I<filter>?I<extensions>"
12300 msgstr ""
12301
12302 #. type: Plain text
12303 #: build/C/man7/uri.7:381
12304 msgid ""
12305 "This scheme supports queries to the Lightweight Directory Access Protocol "
12306 "(LDAP), a protocol for querying a set of servers for hierarchically "
12307 "organized information (such as people and computing resources).  See"
12308 msgstr ""
12309
12310 #. type: UR
12311 #: build/C/man7/uri.7:381 build/C/man7/uri.7:705
12312 #, no-wrap
12313 msgid "http://www.ietf.org/rfc/rfc2255.txt"
12314 msgstr ""
12315
12316 #. type: Plain text
12317 #: build/C/man7/uri.7:383
12318 msgid "RFC\\ 2255"
12319 msgstr ""
12320
12321 #. type: Plain text
12322 #: build/C/man7/uri.7:386
12323 msgid ""
12324 "for more information on the LDAP URL scheme.  The components of this URL "
12325 "are:"
12326 msgstr ""
12327
12328 #. type: IP
12329 #: build/C/man7/uri.7:386
12330 #, no-wrap
12331 msgid "hostport"
12332 msgstr ""
12333
12334 #. type: Plain text
12335 #: build/C/man7/uri.7:391
12336 msgid ""
12337 "the LDAP server to query, written as a hostname optionally followed by a "
12338 "colon and the port number.  The default LDAP port is TCP port 389.  If "
12339 "empty, the client determines which the LDAP server to use."
12340 msgstr ""
12341
12342 #. type: IP
12343 #: build/C/man7/uri.7:391
12344 #, no-wrap
12345 msgid "dn"
12346 msgstr ""
12347
12348 #. type: Plain text
12349 #: build/C/man7/uri.7:394
12350 msgid ""
12351 "the LDAP Distinguished Name, which identifies the base object of the LDAP "
12352 "search (see"
12353 msgstr ""
12354
12355 #. type: UR
12356 #: build/C/man7/uri.7:394
12357 #, no-wrap
12358 msgid "http://www.ietf.org/rfc/rfc2253.txt"
12359 msgstr ""
12360
12361 #. type: Plain text
12362 #: build/C/man7/uri.7:396
12363 msgid "RFC\\ 2253"
12364 msgstr ""
12365
12366 #. type: Plain text
12367 #: build/C/man7/uri.7:398
12368 msgid "section 3)."
12369 msgstr ""
12370
12371 #. type: IP
12372 #: build/C/man7/uri.7:398
12373 #, no-wrap
12374 msgid "attributes"
12375 msgstr ""
12376
12377 #. type: Plain text
12378 #: build/C/man7/uri.7:402
12379 msgid ""
12380 "a comma-separated list of attributes to be returned; see RFC\\ 2251 section "
12381 "4.1.5.  If omitted, all attributes should be returned."
12382 msgstr ""
12383
12384 #. type: IP
12385 #: build/C/man7/uri.7:402
12386 #, no-wrap
12387 msgid "scope"
12388 msgstr ""
12389
12390 #. type: Plain text
12391 #: build/C/man7/uri.7:407
12392 msgid ""
12393 "specifies the scope of the search, which can be one of \"base\" (for a base "
12394 "object search), \"one\" (for a one-level search), or \"sub\" (for a subtree "
12395 "search).  If scope is omitted, \"base\" is assumed."
12396 msgstr ""
12397
12398 #. type: IP
12399 #: build/C/man7/uri.7:407
12400 #, no-wrap
12401 msgid "filter"
12402 msgstr ""
12403
12404 #. type: Plain text
12405 #: build/C/man7/uri.7:412
12406 msgid ""
12407 "specifies the search filter (subset of entries to return).  If omitted, all "
12408 "entries should be returned.  See"
12409 msgstr ""
12410
12411 #. type: UR
12412 #: build/C/man7/uri.7:412
12413 #, no-wrap
12414 msgid "http://www.ietf.org/rfc/rfc2254.txt"
12415 msgstr ""
12416
12417 #. type: Plain text
12418 #: build/C/man7/uri.7:414
12419 msgid "RFC\\ 2254"
12420 msgstr ""
12421
12422 #. type: Plain text
12423 #: build/C/man7/uri.7:416
12424 msgid "section 4."
12425 msgstr ""
12426
12427 #. type: IP
12428 #: build/C/man7/uri.7:416
12429 #, no-wrap
12430 msgid "extensions"
12431 msgstr ""
12432
12433 #. type: Plain text
12434 #: build/C/man7/uri.7:422
12435 msgid ""
12436 "a comma-separated list of type=value pairs, where the =value portion may be "
12437 "omitted for options not requiring it.  An extension prefixed with a "
12438 "\\(aq!\\(aq is critical (must be supported to be valid), otherwise it is "
12439 "noncritical (optional)."
12440 msgstr ""
12441
12442 #. type: Plain text
12443 #: build/C/man7/uri.7:426
12444 msgid ""
12445 "LDAP queries are easiest to explain by example.  Here's a query that asks "
12446 "ldap.itd.umich.edu for information about the University of Michigan in the "
12447 "U.S.:"
12448 msgstr ""
12449
12450 #. type: Plain text
12451 #: build/C/man7/uri.7:429
12452 #, no-wrap
12453 msgid "ldap://ldap.itd.umich.edu/o=University%20of%20Michigan,c=US\n"
12454 msgstr ""
12455
12456 #. type: Plain text
12457 #: build/C/man7/uri.7:432
12458 msgid "To just get its postal address attribute, request:"
12459 msgstr ""
12460
12461 #. type: Plain text
12462 #: build/C/man7/uri.7:435
12463 #, no-wrap
12464 msgid "ldap://ldap.itd.umich.edu/o=University%20of%20Michigan,c=US?postalAddress\n"
12465 msgstr ""
12466
12467 #. type: Plain text
12468 #: build/C/man7/uri.7:439
12469 msgid ""
12470 "To ask a host.com at port 6666 for information about the person with common "
12471 "name (cn) \"Babs Jensen\" at University of Michigan, request:"
12472 msgstr ""
12473
12474 #. type: Plain text
12475 #: build/C/man7/uri.7:442
12476 #, no-wrap
12477 msgid "ldap://host.com:6666/o=University%20of%20Michigan,c=US??sub?(cn=Babs%20Jensen)\n"
12478 msgstr ""
12479
12480 #. type: Plain text
12481 #: build/C/man7/uri.7:445
12482 msgid "B<wais - Wide Area Information Servers>"
12483 msgstr ""
12484
12485 #. type: Plain text
12486 #: build/C/man7/uri.7:447
12487 msgid "wais://I<hostport>/I<database>"
12488 msgstr ""
12489
12490 #. type: Plain text
12491 #: build/C/man7/uri.7:449
12492 msgid "wais://I<hostport>/I<database>?I<search>"
12493 msgstr ""
12494
12495 #. type: Plain text
12496 #: build/C/man7/uri.7:451
12497 msgid "wais://I<hostport>/I<database>/I<wtype>/I<wpath>"
12498 msgstr ""
12499
12500 #. type: Plain text
12501 #: build/C/man7/uri.7:454
12502 msgid "This scheme designates a WAIS database, search, or document (see"
12503 msgstr ""
12504
12505 #. type: UR
12506 #: build/C/man7/uri.7:454
12507 #, no-wrap
12508 msgid "http://www.ietf.org/rfc/rfc1625.txt"
12509 msgstr ""
12510
12511 #. type: Plain text
12512 #: build/C/man7/uri.7:456
12513 msgid "IETF RFC\\ 1625"
12514 msgstr ""
12515
12516 #. type: Plain text
12517 #: build/C/man7/uri.7:460
12518 msgid ""
12519 "for more information on WAIS).  Hostport is the hostname, optionally "
12520 "followed by a colon and port number (the default port number is 210)."
12521 msgstr ""
12522
12523 #. type: Plain text
12524 #: build/C/man7/uri.7:470
12525 msgid ""
12526 "The first form designates a WAIS database for searching.  The second form "
12527 "designates a particular search of the WAIS database I<database>.  The third "
12528 "form designates a particular document within a WAIS database to be "
12529 "retrieved.  I<wtype> is the WAIS designation of the type of the object and "
12530 "I<wpath> is the WAIS document-id."
12531 msgstr ""
12532
12533 #. type: Plain text
12534 #: build/C/man7/uri.7:472
12535 msgid "B<other schemes>"
12536 msgstr ""
12537
12538 #. type: Plain text
12539 #: build/C/man7/uri.7:486
12540 msgid ""
12541 "There are many other URI schemes.  Most tools that accept URIs support a set "
12542 "of internal URIs (e.g., Mozilla has the about: scheme for internal "
12543 "information, and the GNOME help browser has the toc: scheme for various "
12544 "starting locations).  There are many schemes that have been defined but are "
12545 "not as widely used at the current time (e.g., prospero).  The nntp: scheme "
12546 "is deprecated in favor of the news: scheme.  URNs are to be supported by the "
12547 "urn: scheme, with a hierarchical name space (e.g., urn:ietf:... would "
12548 "identify IETF documents); at this time URNs are not widely implemented.  Not "
12549 "all tools support all schemes."
12550 msgstr ""
12551
12552 #. type: SS
12553 #: build/C/man7/uri.7:486
12554 #, no-wrap
12555 msgid "Character Encoding"
12556 msgstr ""
12557
12558 #. type: Plain text
12559 #: build/C/man7/uri.7:490
12560 msgid ""
12561 "URIs use a limited number of characters so that they can be typed in and "
12562 "used in a variety of situations."
12563 msgstr ""
12564
12565 #. type: Plain text
12566 #: build/C/man7/uri.7:494
12567 msgid ""
12568 "The following characters are reserved, that is, they may appear in a URI but "
12569 "their use is limited to their reserved purpose (conflicting data must be "
12570 "escaped before forming the URI):"
12571 msgstr ""
12572
12573 #. type: Plain text
12574 #: build/C/man7/uri.7:496
12575 #, no-wrap
12576 msgid "   ; / ? : @ & = + $ ,\n"
12577 msgstr ""
12578
12579 #. type: Plain text
12580 #: build/C/man7/uri.7:502
12581 msgid ""
12582 "Unreserved characters may be included in a URI.  Unreserved characters "
12583 "include upper and lower case English letters, decimal digits, and the "
12584 "following limited set of punctuation marks and symbols:"
12585 msgstr ""
12586
12587 #. type: Plain text
12588 #: build/C/man7/uri.7:504
12589 #, no-wrap
12590 msgid " - _ . ! ~ * ' ( )\n"
12591 msgstr ""
12592
12593 #. type: Plain text
12594 #: build/C/man7/uri.7:519
12595 msgid ""
12596 "All other characters must be escaped.  An escaped octet is encoded as a "
12597 "character triplet, consisting of the percent character \"%\" followed by the "
12598 "two hexadecimal digits representing the octet code (you can use upper or "
12599 "lower case letters for the hexadecimal digits).  For example, a blank space "
12600 "must be escaped as \"%20\", a tab character as \"%09\", and the \"&\" as "
12601 "\"%26\".  Because the percent \"%\" character always has the reserved "
12602 "purpose of being the escape indicator, it must be escaped as \"%25\".  It is "
12603 "common practice to escape space characters as the plus symbol (+)  in query "
12604 "text; this practice isn't uniformly defined in the relevant RFCs (which "
12605 "recommend %20 instead) but any tool accepting URIs with query text should be "
12606 "prepared for them.  A URI is always shown in its \"escaped\" form."
12607 msgstr ""
12608
12609 #. type: Plain text
12610 #: build/C/man7/uri.7:525
12611 msgid ""
12612 "Unreserved characters can be escaped without changing the semantics of the "
12613 "URI, but this should not be done unless the URI is being used in a context "
12614 "that does not allow the unescaped character to appear.  For example, \"%7e\" "
12615 "is sometimes used instead of \"~\" in an HTTP URL path, but the two are "
12616 "equivalent for an HTTP URL."
12617 msgstr ""
12618
12619 #. type: Plain text
12620 #: build/C/man7/uri.7:529
12621 msgid ""
12622 "For URIs which must handle characters outside the US ASCII character set, "
12623 "the HTML 4.01 specification (section B.2) and IETF RFC\\ 2718 (section "
12624 "2.2.5) recommend the following approach:"
12625 msgstr ""
12626
12627 #. type: Plain text
12628 #: build/C/man7/uri.7:533
12629 msgid ""
12630 "translate the character sequences into UTF-8 (IETF RFC\\ 2279)\\(emsee "
12631 "B<utf-8>(7)\\(emand then"
12632 msgstr ""
12633
12634 #. type: Plain text
12635 #: build/C/man7/uri.7:536
12636 msgid ""
12637 "use the URI escaping mechanism, that is, use the %HH encoding for unsafe "
12638 "octets."
12639 msgstr ""
12640
12641 #. type: SS
12642 #: build/C/man7/uri.7:536
12643 #, no-wrap
12644 msgid "Writing a URI"
12645 msgstr ""
12646
12647 #. type: Plain text
12648 #: build/C/man7/uri.7:558
12649 msgid ""
12650 "When written, URIs should be placed inside double quotes (e.g., "
12651 "\"http://www.kernelnotes.org\"), enclosed in angle brackets (e.g., "
12652 "E<lt>http://lwn.netE<gt>), or placed on a line by themselves.  A warning for "
12653 "those who use double-quotes: B<never> move extraneous punctuation (such as "
12654 "the period ending a sentence or the comma in a list)  inside a URI, since "
12655 "this will change the value of the URI.  Instead, use angle brackets instead, "
12656 "or switch to a quoting system that never includes extraneous characters "
12657 "inside quotation marks.  This latter system, called the 'new' or 'logical' "
12658 "quoting system by \"Hart's Rules\" and the \"Oxford Dictionary for Writers "
12659 "and Editors\", is preferred practice in Great Britain and hackers worldwide "
12660 "(see the Jargon File's section on Hacker Writing Style, "
12661 "I<http://www.fwi.uva.nl/~mes/jargon/h/HackerWritingStyle.html>, for more "
12662 "information).  Older documents suggested inserting the prefix \"URL:\" just "
12663 "before the URI, but this form has never caught on."
12664 msgstr ""
12665
12666 #. type: Plain text
12667 #: build/C/man7/uri.7:580
12668 msgid ""
12669 "The URI syntax was designed to be unambiguous.  However, as URIs have become "
12670 "commonplace, traditional media (television, radio, newspapers, billboards, "
12671 "etc.) have increasingly used abbreviated URI references consisting of only "
12672 "the authority and path portions of the identified resource (e.g., "
12673 "E<lt>www.w3.org/AddressingE<gt>).  Such references are primarily intended "
12674 "for human interpretation rather than machine, with the assumption that "
12675 "context-based heuristics are sufficient to complete the URI (e.g., hostnames "
12676 "beginning with \"www\" are likely to have a URI prefix of \"http://\" and "
12677 "hostnames beginning with \"ftp\" likely to have a prefix of \"ftp://\").  "
12678 "Many client implementations heuristically resolve these references.  Such "
12679 "heuristics may change over time, particularly when new schemes are "
12680 "introduced.  Since an abbreviated URI has the same syntax as a relative URL "
12681 "path, abbreviated URI references cannot be used where relative URIs are "
12682 "permitted, and can only be used when there is no defined base (such as in "
12683 "dialog boxes).  Don't use abbreviated URIs as hypertext links inside a "
12684 "document; use the standard format as described here."
12685 msgstr ""
12686
12687 #. type: Plain text
12688 #: build/C/man7/uri.7:586
12689 msgid ""
12690 "I<http://www.ietf.org/rfc/rfc2396.txt> (IETF RFC\\ 2396), "
12691 "I<http://www.w3.org/TR/REC-html40> (HTML 4.0)."
12692 msgstr ""
12693
12694 #. type: Plain text
12695 #: build/C/man7/uri.7:592
12696 msgid ""
12697 "Any tool accepting URIs (e.g., a web browser) on a Linux system should be "
12698 "able to handle (directly or indirectly) all of the schemes described here, "
12699 "including the man: and info: schemes.  Handling them by invoking some other "
12700 "program is fine and in fact encouraged."
12701 msgstr ""
12702
12703 #. type: Plain text
12704 #: build/C/man7/uri.7:594
12705 msgid "Technically the fragment isn't part of the URI."
12706 msgstr ""
12707
12708 #. type: Plain text
12709 #: build/C/man7/uri.7:603
12710 msgid ""
12711 "For information on how to embed URIs (including URLs) in a data format, see "
12712 "documentation on that format.  HTML uses the format E<lt>A "
12713 "HREF=\"I<uri>\"E<gt> I<text> E<lt>/AE<gt>.  Texinfo files use the format "
12714 "@uref{I<uri>}.  Man and mdoc have the recently added UR macro, or just "
12715 "include the URI in the text (viewers should be able to detect :// as part of "
12716 "a URI)."
12717 msgstr ""
12718
12719 #. type: Plain text
12720 #: build/C/man7/uri.7:624
12721 msgid ""
12722 "The GNOME and KDE desktop environments currently vary in the URIs they "
12723 "accept, in particular in their respective help browsers.  To list man pages, "
12724 "GNOME uses E<lt>toc:manE<gt> while KDE uses E<lt>man:(index)E<gt>, and to "
12725 "list info pages, GNOME uses E<lt>toc:infoE<gt> while KDE uses "
12726 "E<lt>info:(dir)E<gt> (the author of this man page prefers the KDE approach "
12727 "here, though a more regular format would be even better).  In general, KDE "
12728 "uses E<lt>file:/cgi-bin/E<gt> as a prefix to a set of generated files.  KDE "
12729 "prefers documentation in HTML, accessed via the "
12730 "E<lt>file:/cgi-bin/helpindexE<gt>.  GNOME prefers the ghelp scheme to store "
12731 "and find documentation.  Neither browser handles file: references to "
12732 "directories at the time of this writing, making it difficult to refer to an "
12733 "entire directory with a browsable URI.  As noted above, these environments "
12734 "differ in how they handle the info: scheme, probably the most important "
12735 "variation.  It is expected that GNOME and KDE will converge to common URI "
12736 "formats, and a future version of this man page will describe the converged "
12737 "result.  Efforts to aid this convergence are encouraged."
12738 msgstr ""
12739
12740 #. type: SS
12741 #: build/C/man7/uri.7:624
12742 #, no-wrap
12743 msgid "Security"
12744 msgstr ""
12745
12746 #. type: Plain text
12747 #: build/C/man7/uri.7:634
12748 msgid ""
12749 "A URI does not in itself pose a security threat.  There is no general "
12750 "guarantee that a URL, which at one time located a given resource, will "
12751 "continue to do so.  Nor is there any guarantee that a URL will not locate a "
12752 "different resource at some later point in time; such a guarantee can only be "
12753 "obtained from the person(s) controlling that namespace and the resource in "
12754 "question."
12755 msgstr ""
12756
12757 #. type: Plain text
12758 #: build/C/man7/uri.7:649
12759 msgid ""
12760 "It is sometimes possible to construct a URL such that an attempt to perform "
12761 "a seemingly harmless operation, such as the retrieval of an entity "
12762 "associated with the resource, will in fact cause a possibly damaging remote "
12763 "operation to occur.  The unsafe URL is typically constructed by specifying a "
12764 "port number other than that reserved for the network protocol in question.  "
12765 "The client unwittingly contacts a site that is in fact running a different "
12766 "protocol.  The content of the URL contains instructions that, when "
12767 "interpreted according to this other protocol, cause an unexpected "
12768 "operation.  An example has been the use of a gopher URL to cause an "
12769 "unintended or impersonating message to be sent via a SMTP server."
12770 msgstr ""
12771
12772 #. type: Plain text
12773 #: build/C/man7/uri.7:653
12774 msgid ""
12775 "Caution should be used when using any URL that specifies a port number other "
12776 "than the default for the protocol, especially when it is a number within the "
12777 "reserved space."
12778 msgstr ""
12779
12780 #. type: Plain text
12781 #: build/C/man7/uri.7:661
12782 msgid ""
12783 "Care should be taken when a URI contains escaped delimiters for a given "
12784 "protocol (for example, CR and LF characters for telnet protocols) that these "
12785 "are not unescaped before transmission.  This might violate the protocol, but "
12786 "avoids the potential for such characters to be used to simulate an extra "
12787 "operation or parameter in that protocol, which might lead to an unexpected "
12788 "and possibly harmful remote operation to be performed."
12789 msgstr ""
12790
12791 #. type: Plain text
12792 #: build/C/man7/uri.7:667
12793 msgid ""
12794 "It is clearly unwise to use a URI that contains a password which is intended "
12795 "to be secret.  In particular, the use of a password within the \"userinfo\" "
12796 "component of a URI is strongly recommended against except in those rare "
12797 "cases where the \"password\" parameter is intended to be public."
12798 msgstr ""
12799
12800 #. type: Plain text
12801 #: build/C/man7/uri.7:689
12802 msgid ""
12803 "Documentation may be placed in a variety of locations, so there currently "
12804 "isn't a good URI scheme for general online documentation in arbitrary "
12805 "formats.  References of the form E<lt>file:///usr/doc/ZZZE<gt> don't work "
12806 "because different distributions and local installation requirements may "
12807 "place the files in different directories (it may be in /usr/doc, or "
12808 "/usr/local/doc, or /usr/share, or somewhere else).  Also, the directory ZZZ "
12809 "usually changes when a version changes (though filename globbing could "
12810 "partially overcome this).  Finally, using the file: scheme doesn't easily "
12811 "support people who dynamically load documentation from the Internet (instead "
12812 "of loading the files onto a local file system).  A future URI scheme may be "
12813 "added (e.g., \"userdoc:\") to permit programs to include cross-references to "
12814 "more detailed documentation without having to know the exact location of "
12815 "that documentation.  Alternatively, a future version of the file-system "
12816 "specification may specify file locations sufficiently so that the file: "
12817 "scheme will be able to locate documentation."
12818 msgstr ""
12819
12820 #. type: Plain text
12821 #: build/C/man7/uri.7:692
12822 msgid ""
12823 "Many programs and file formats don't include a way to incorporate or "
12824 "implement links using URIs."
12825 msgstr ""
12826
12827 #.  .SH AUTHOR
12828 #.  David A. Wheeler (dwheeler@dwheeler.com) wrote this man page.
12829 #. type: Plain text
12830 #: build/C/man7/uri.7:700
12831 msgid ""
12832 "Many programs can't handle all of these different URI formats; there should "
12833 "be a standard mechanism to load an arbitrary URI that automatically detects "
12834 "the users' environment (e.g., text or graphics, desktop environment, local "
12835 "user preferences, and currently executing tools) and invokes the right tool "
12836 "for any URI."
12837 msgstr ""
12838
12839 #. type: Plain text
12840 #: build/C/man7/uri.7:705
12841 msgid "B<lynx>(1), B<man2html>(1), B<mailaddr>(7), B<utf-8>(7),"
12842 msgstr ""
12843
12844 #. type: Plain text
12845 #: build/C/man7/uri.7:707
12846 msgid "IETF RFC\\ 2255"
12847 msgstr ""
12848
12849 #. type: TH
12850 #: build/C/man4/vcs.4:28
12851 #, no-wrap
12852 msgid "VCS"
12853 msgstr ""
12854
12855 #. type: TH
12856 #: build/C/man4/vcs.4:28
12857 #, no-wrap
12858 msgid "2007-12-17"
12859 msgstr ""
12860
12861 #. type: Plain text
12862 #: build/C/man4/vcs.4:31
12863 msgid "vcs, vcsa - virtual console memory"
12864 msgstr ""
12865
12866 #. type: Plain text
12867 #: build/C/man4/vcs.4:36
12868 msgid ""
12869 "I</dev/vcs0> is a character device with major number 7 and minor number 0, "
12870 "usually of mode 0644 and owner root.tty.  It refers to the memory of the "
12871 "currently displayed virtual console terminal."
12872 msgstr ""
12873
12874 #. type: Plain text
12875 #: build/C/man4/vcs.4:47
12876 msgid ""
12877 "I</dev/vcs[1-63]> are character devices for virtual console terminals, they "
12878 "have major number 7 and minor number 1 to 63, usually mode 0644 and owner "
12879 "root.tty.  I</dev/vcsa[0-63]> are the same, but using I<unsigned short>s (in "
12880 "host byte order) that include attributes, and prefixed with four bytes "
12881 "giving the screen dimensions and cursor position: I<lines>, I<columns>, "
12882 "I<x>, I<y>.  (I<x> = I<y> = 0 at the top left corner of the screen.)"
12883 msgstr ""
12884
12885 #. type: Plain text
12886 #: build/C/man4/vcs.4:59
12887 msgid ""
12888 "When a 512-character font is loaded, the 9th bit position can be fetched by "
12889 "applying the B<ioctl>(2)  B<VT_GETHIFONTMASK> operation (available in Linux "
12890 "kernels 2.6.18 and above)  on I</dev/tty[1-63]>; the value is returned in "
12891 "the I<unsigned short> pointed to by the third B<ioctl>(2)  argument."
12892 msgstr ""
12893
12894 #. type: Plain text
12895 #: build/C/man4/vcs.4:66
12896 msgid ""
12897 "These devices replace the screendump B<ioctl>(2)  operations of "
12898 "B<console>(4), so the system administrator can control access using file "
12899 "system permissions."
12900 msgstr ""
12901
12902 #. type: Plain text
12903 #: build/C/man4/vcs.4:68
12904 msgid "The devices for the first eight virtual consoles may be created by:"
12905 msgstr ""
12906
12907 #. type: Plain text
12908 #: build/C/man4/vcs.4:75
12909 #, no-wrap
12910 msgid ""
12911 "    for x in 0 1 2 3 4 5 6 7 8; do\n"
12912 "        mknod -m 644 /dev/vcs$x c 7 $x;\n"
12913 "        mknod -m 644 /dev/vcsa$x c 7 $[$x+128];\n"
12914 "    done\n"
12915 "    chown root:tty /dev/vcs*\n"
12916 msgstr ""
12917
12918 #. type: Plain text
12919 #: build/C/man4/vcs.4:80
12920 msgid "No B<ioctl>(2)  requests are supported."
12921 msgstr ""
12922
12923 #. type: Plain text
12924 #: build/C/man4/vcs.4:82
12925 msgid "/dev/vcs[0-63]"
12926 msgstr ""
12927
12928 #.  .SH AUTHOR
12929 #.  Andries Brouwer <aeb@cwi.nl>
12930 #. type: Plain text
12931 #: build/C/man4/vcs.4:86
12932 msgid "/dev/vcsa[0-63]"
12933 msgstr ""
12934
12935 #. type: Plain text
12936 #: build/C/man4/vcs.4:88
12937 msgid "Introduced with version 1.1.92 of the Linux kernel."
12938 msgstr ""
12939
12940 #. type: Plain text
12941 #: build/C/man4/vcs.4:95
12942 msgid ""
12943 "You may do a screendump on vt3 by switching to vt1 and typing I<cat "
12944 "/dev/vcs3 E<gt>foo>.  Note that the output does not contain newline "
12945 "characters, so some processing may be required, like in I<fold -w 81 "
12946 "/dev/vcs3 | lpr> or (horrors)  I<setterm -dump 3 -file /proc/self/fd/1>."
12947 msgstr ""
12948
12949 #. type: Plain text
12950 #: build/C/man4/vcs.4:97
12951 msgid "The I</dev/vcsa0> device is used for Braille support."
12952 msgstr ""
12953
12954 #. type: Plain text
12955 #: build/C/man4/vcs.4:101
12956 msgid ""
12957 "This program displays the character and screen attributes under the cursor "
12958 "of the second virtual console, then changes the background color there:"
12959 msgstr ""
12960
12961 #. type: Plain text
12962 #: build/C/man4/vcs.4:109
12963 #, no-wrap
12964 msgid ""
12965 "#include E<lt>unistd.hE<gt>\n"
12966 "#include E<lt>stdlib.hE<gt>\n"
12967 "#include E<lt>stdio.hE<gt>\n"
12968 "#include E<lt>fcntl.hE<gt>\n"
12969 "#include E<lt>sys/ioctl.hE<gt>\n"
12970 "#include E<lt>linux/vt.hE<gt>\n"
12971 msgstr ""
12972
12973 #. type: Plain text
12974 #: build/C/man4/vcs.4:120
12975 #, no-wrap
12976 msgid ""
12977 "int\n"
12978 "main(void)\n"
12979 "{\n"
12980 "    int fd;\n"
12981 "    char *device = \"/dev/vcsa2\";\n"
12982 "    char *console = \"/dev/tty2\";\n"
12983 "    struct {unsigned char lines, cols, x, y;} scrn;\n"
12984 "    unsigned short s;\n"
12985 "    unsigned short mask;\n"
12986 "    unsigned char ch, attrib;\n"
12987 msgstr ""
12988
12989 #. type: Plain text
12990 #: build/C/man4/vcs.4:149
12991 #, no-wrap
12992 msgid ""
12993 "    fd = open(console, O_RDWR);\n"
12994 "    if (fd E<lt> 0) {\n"
12995 "        perror(console);\n"
12996 "        exit(EXIT_FAILURE);\n"
12997 "    }\n"
12998 "    if (ioctl(fd, VT_GETHIFONTMASK, &mask) E<lt> 0) {\n"
12999 "        perror(\"VT_GETHIFONTMASK\");\n"
13000 "        exit(EXIT_FAILURE);\n"
13001 "    }\n"
13002 "    (void) close(fd);\n"
13003 "    fd = open(device, O_RDWR);\n"
13004 "    if (fd E<lt> 0) {\n"
13005 "        perror(device);\n"
13006 "        exit(EXIT_FAILURE);\n"
13007 "    }\n"
13008 "    (void) read(fd, &scrn, 4);\n"
13009 "    (void) lseek(fd, 4 + 2*(scrn.y*scrn.cols + scrn.x), 0);\n"
13010 "    (void) read(fd, &s, 2);\n"
13011 "    ch = s & 0xff;\n"
13012 "    if (attrib & mask)\n"
13013 "        ch |= 0x100;\n"
13014 "    attrib = ((s & ~mask) E<gt>E<gt> 8);\n"
13015 "    printf(\"ch=\\(aq%c\\(aq attrib=0x%02x\\en\", ch, attrib);\n"
13016 "    attrib ^= 0x10;\n"
13017 "    (void) lseek(fd, -1, 1);\n"
13018 "    (void) write(fd, &attrib, 1);\n"
13019 "    exit(EXIT_SUCCESS);\n"
13020 "}\n"
13021 msgstr ""
13022
13023 #. type: Plain text
13024 #: build/C/man4/vcs.4:155
13025 msgid "B<console>(4), B<tty>(4), B<ttyS>(4), B<gpm>(8)"
13026 msgstr ""
13027
13028 #. type: TH
13029 #: build/C/man4/wavelan.4:11
13030 #, no-wrap
13031 msgid "WAVELAN"
13032 msgstr ""
13033
13034 #. type: TH
13035 #: build/C/man4/wavelan.4:11
13036 #, no-wrap
13037 msgid "1996-10-22"
13038 msgstr ""
13039
13040 #. type: Plain text
13041 #: build/C/man4/wavelan.4:14
13042 msgid "wavelan - AT&T GIS WaveLAN ISA device driver"
13043 msgstr ""
13044
13045 #. type: Plain text
13046 #: build/C/man4/wavelan.4:16
13047 msgid ""
13048 "B<insmod wavelan_cs.o [io=>I<B,B..>B<] [ irq=>I<I,I..>B<] "
13049 "[name=>I<N,N..>B<]>"
13050 msgstr ""
13051
13052 #. type: Plain text
13053 #: build/C/man4/wavelan.4:32
13054 msgid ""
13055 "I<wavelan> is the low-level device driver for the NCR / AT&T / Lucent "
13056 "B<WaveLAN ISA> and Digital (DEC)  B<RoamAbout DS> wireless ethernet "
13057 "adapter.  This driver is available as a module or might be compiled in the "
13058 "kernel.  This driver supports multiple cards in both forms (up to 4) and "
13059 "allocates the next available ethernet device (eth0..eth#) for each card "
13060 "found, unless a device name is explicitly specified (see below).  This "
13061 "device name will be reported in the kernel log file with the MAC address, "
13062 "NWID and frequency used by the card."
13063 msgstr ""
13064
13065 #. type: Plain text
13066 #: build/C/man4/wavelan.4:39
13067 msgid ""
13068 "This section apply to the module form (parameters passed on the B<insmod>(8)  "
13069 "command line).  If the driver is included in the kernel, use the "
13070 "I<ether=IRQ,IO,NAME> syntax on the kernel command line."
13071 msgstr ""
13072
13073 #. type: TP
13074 #: build/C/man4/wavelan.4:39
13075 #, no-wrap
13076 msgid "B<io>"
13077 msgstr ""
13078
13079 #. type: Plain text
13080 #: build/C/man4/wavelan.4:46
13081 msgid ""
13082 "Specify the list of base address where to search for wavelan cards (setting "
13083 "by dip switch on the card).  If you don't specify any io address, the driver "
13084 "will scan 0x390 and 0x3E0 addresses, which might conflict with other "
13085 "hardware..."
13086 msgstr ""
13087
13088 #. type: TP
13089 #: build/C/man4/wavelan.4:46
13090 #, no-wrap
13091 msgid "B<irq>"
13092 msgstr ""
13093
13094 #. type: Plain text
13095 #: build/C/man4/wavelan.4:50
13096 msgid ""
13097 "Set the list of irq that each wavelan card should use (the value is saved in "
13098 "permanent storage for future use)."
13099 msgstr ""
13100
13101 #. type: TP
13102 #: build/C/man4/wavelan.4:50
13103 #, no-wrap
13104 msgid "B<name>"
13105 msgstr ""
13106
13107 #. type: Plain text
13108 #: build/C/man4/wavelan.4:55
13109 msgid ""
13110 "Set the list of name to be used for each wavelan cards device (name used by "
13111 "B<ifconfig>(8))."
13112 msgstr ""
13113
13114 #. type: SS
13115 #: build/C/man4/wavelan.4:55
13116 #, no-wrap
13117 msgid "Wireless Extensions"
13118 msgstr ""
13119
13120 #. type: Plain text
13121 #: build/C/man4/wavelan.4:59
13122 msgid "Use B<iwconfig>(8)  to manipulate wireless extensions."
13123 msgstr ""
13124
13125 #. type: SS
13126 #: build/C/man4/wavelan.4:59
13127 #, no-wrap
13128 msgid "NWID (or domain)"
13129 msgstr ""
13130
13131 #. type: Plain text
13132 #: build/C/man4/wavelan.4:68
13133 msgid ""
13134 "Set the network ID [I<0> to I<FFFF>] or disable it [I<off>].  As the NWID is "
13135 "stored in the card Permanent Storage Area, it will be reuse at any further "
13136 "invocation of the driver."
13137 msgstr ""
13138
13139 #. type: SS
13140 #: build/C/man4/wavelan.4:68
13141 #, no-wrap
13142 msgid "Frequency & channels"
13143 msgstr ""
13144
13145 #. type: Plain text
13146 #: build/C/man4/wavelan.4:79
13147 msgid ""
13148 "For the 2.4GHz 2.00 Hardware, you are able to set the frequency by "
13149 "specifying one of the 10 defined channels (I<2.412,> I<2.422, 2.425, 2.4305, "
13150 "2.432, 2.442, 2.452, 2.460, 2.462> or I<2.484>)  or directly by its value.  "
13151 "The frequency is changed immediately and permanently.  Frequency "
13152 "availability depends on the regulations..."
13153 msgstr ""
13154
13155 #. type: SS
13156 #: build/C/man4/wavelan.4:79
13157 #, no-wrap
13158 msgid "Statistics spy"
13159 msgstr ""
13160
13161 #. type: Plain text
13162 #: build/C/man4/wavelan.4:83
13163 msgid ""
13164 "Set a list of MAC addresses in the driver (up to 8) and get the last quality "
13165 "of link for each of those (see B<iwspy>(8))."
13166 msgstr ""
13167
13168 #. type: SS
13169 #: build/C/man4/wavelan.4:83
13170 #, no-wrap
13171 msgid "/proc/net/wireless"
13172 msgstr ""
13173
13174 #. type: Plain text
13175 #: build/C/man4/wavelan.4:98
13176 msgid ""
13177 "I<status> is the status reported by the modem.  I<Link quality> reports the "
13178 "quality of the modulation on the air (direct sequence spread spectrum) [max "
13179 "= 16].  I<Level> and I<Noise> refer to the signal level and noise level [max "
13180 "= 64].  The I<crypt discarded packet> and I<misc discarded packet> counters "
13181 "are not implemented."
13182 msgstr ""
13183
13184 #. type: SS
13185 #: build/C/man4/wavelan.4:98
13186 #, no-wrap
13187 msgid "Private Ioctl"
13188 msgstr ""
13189
13190 #. type: Plain text
13191 #: build/C/man4/wavelan.4:102
13192 msgid "You may use B<iwpriv>(8)  to manipulate private ioctls."
13193 msgstr ""
13194
13195 #. type: SS
13196 #: build/C/man4/wavelan.4:102
13197 #, no-wrap
13198 msgid "Quality and Level threshold"
13199 msgstr ""
13200
13201 #. type: Plain text
13202 #: build/C/man4/wavelan.4:105
13203 msgid ""
13204 "Enable you the define the quality and level threshold used by the modem "
13205 "(packet below that level are discarded)."
13206 msgstr ""
13207
13208 #. type: SS
13209 #: build/C/man4/wavelan.4:105
13210 #, no-wrap
13211 msgid "Histogram"
13212 msgstr ""
13213
13214 #. type: Plain text
13215 #: build/C/man4/wavelan.4:112
13216 msgid ""
13217 "This functionality makes it possible to set a number of signal level "
13218 "intervals and to count the number of packets received in each of those "
13219 "defined intervals.  This distribution might be used to calculate the mean "
13220 "value and standard deviation of the signal level."
13221 msgstr ""
13222
13223 #. type: SS
13224 #: build/C/man4/wavelan.4:112
13225 #, no-wrap
13226 msgid "Specific Notes"
13227 msgstr ""
13228
13229 #. type: Plain text
13230 #: build/C/man4/wavelan.4:118
13231 msgid ""
13232 "This driver will fail to detect some B<non-NCR/ATT&T/Lucent> Wavelan cards.  "
13233 "If this happens for you, you must look in the source code on how to add your "
13234 "card to the detection routine."
13235 msgstr ""
13236
13237 #.  .SH AUTHOR
13238 #.  Bruce Janson \(em bruce@cs.usyd.edu.au
13239 #.  .br
13240 #.  Jean Tourrilhes \(em jt@hplb.hpl.hp.com
13241 #.  .br
13242 #.  (and others; see source code for details)
13243 #
13244 #.  SEE ALSO part
13245 #. type: Plain text
13246 #: build/C/man4/wavelan.4:131
13247 msgid ""
13248 "Some of the mentioned features are optional.  You may enable to disable them "
13249 "by changing flags in the driver header and recompile."
13250 msgstr ""
13251
13252 #. type: Plain text
13253 #: build/C/man4/wavelan.4:138
13254 msgid ""
13255 "B<wavelan_cs>(4), B<ifconfig>(8), B<insmod>(8), B<iwconfig>(8), "
13256 "B<iwpriv>(8), B<iwspy>(8)"
13257 msgstr ""