From 0db324e2e5d9d3347ea0e93138372fb65aac09e6 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:41:09 +0200 Subject: Merging upstream version 6.7. Signed-off-by: Daniel Baumann --- man4/cciss.4 | 40 ++++---- man4/console_codes.4 | 117 +++++++++++----------- man4/cpuid.4 | 28 +++--- man4/dsp56k.4 | 10 +- man4/fd.4 | 22 ++--- man4/full.4 | 10 +- man4/fuse.4 | 16 +-- man4/hd.4 | 10 +- man4/hpsa.4 | 22 +++-- man4/initrd.4 | 30 +++--- man4/intro.4 | 2 +- man4/lirc.4 | 19 ++-- man4/loop.4 | 18 ++-- man4/lp.4 | 2 +- man4/mem.4 | 24 ++--- man4/mouse.4 | 22 ++--- man4/msr.4 | 8 +- man4/null.4 | 10 +- man4/pts.4 | 14 +-- man4/ram.4 | 6 +- man4/random.4 | 42 ++++---- man4/rtc.4 | 66 ++++++++----- man4/sd.4 | 10 +- man4/sk98lin.4 | 32 +++--- man4/smartpqi.4 | 268 +++++++++++++++++++++++++++++++++++++++++---------- man4/st.4 | 60 ++++++------ man4/tty.4 | 8 +- man4/ttyS.4 | 6 +- man4/vcs.4 | 30 +++--- man4/veth.4 | 22 ++--- man4/wavelan.4 | 6 +- 31 files changed, 592 insertions(+), 388 deletions(-) (limited to 'man4') diff --git a/man4/cciss.4 b/man4/cciss.4 index 9194c8a..6b6a6d1 100644 --- a/man4/cciss.4 +++ b/man4/cciss.4 @@ -6,7 +6,7 @@ .\" .\" shorthand for double quote that works everywhere. .ds q \N'34' -.TH cciss 4 2023-05-03 "Linux man-pages 6.05.01" +.TH cciss 4 2023-10-31 "Linux man-pages 6.7" .SH NAME cciss \- HP Smart Array block driver .SH SYNOPSIS @@ -20,7 +20,7 @@ This obsolete driver was removed in Linux 4.14, as it is superseded by the .BR hpsa (4) driver in newer kernels. -.PP +.P .B cciss is a block driver for older HP Smart Array RAID controllers. .SS Options @@ -32,7 +32,7 @@ driver from attempting to drive any controllers that the driver is capable of controlling, which is to say, the .B cciss driver is restricted by this option to the following controllers: -.PP +.P .nf Smart Array 5300 Smart Array 5i @@ -56,7 +56,7 @@ driver is restricted by this option to the following controllers: The .B cciss driver supports the following Smart Array boards: -.PP +.P .nf Smart Array 5300 Smart Array 5i @@ -95,7 +95,7 @@ run from the Smart Array's option ROM at boot time. .SH FILES .SS Device nodes The device naming scheme is as follows: -.PP +.P Major numbers: .IP .TS @@ -109,9 +109,9 @@ r r. 110 cciss6 111 cciss7 .TE -.PP +.P Minor numbers: -.PP +.P .EX b7 b6 b5 b4 b3 b2 b1 b0 |\-\-\-\-+\-\-\-\-| |\-\-\-\-+\-\-\-\-| @@ -120,7 +120,7 @@ Minor numbers: | +\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\- Logical Volume number .EE -.PP +.P The device naming scheme is: .TS li l. @@ -140,7 +140,7 @@ The files contain information about the configuration of each controller. For example: -.PP +.P .in +4n .EX $ \fBcd /proc/driver/cciss\fP @@ -237,7 +237,7 @@ for more details.) You must enable "SCSI tape drive support for Smart Array 5xxx" and "SCSI support" in your kernel configuration to be able to use SCSI tape drives with your Smart Array 5xxx controller. -.PP +.P Additionally, note that the driver will not engage the SCSI core at init time. The driver must be directed to dynamically engage the SCSI core via the @@ -255,7 +255,7 @@ This is best done via an initialization script .IR /etc/init.d , but could vary depending on distribution). For example: -.PP +.P .in +4n .EX for x in /proc/driver/cciss/cciss[0\-9]* @@ -264,10 +264,10 @@ do done .EE .in -.PP +.P Once the SCSI core is engaged by the driver, it cannot be disengaged (except by unloading the driver, if it happens to be linked as a module.) -.PP +.P Note also that if no sequential access devices or medium changers are detected, the SCSI core will not be engaged by the action of the above script. @@ -283,7 +283,7 @@ filesystem. For example: .IP echo "rescan" > /proc/scsi/cciss0/1 -.PP +.P This causes the driver to: .RS .IP (1) 5 @@ -293,20 +293,20 @@ physical SCSI buses and/or fiber channel arbitrated loop, and make note of any new or removed sequential access devices or medium changers. .RE -.PP +.P The driver will output messages indicating which devices have been added or removed and the controller, bus, target, and lun used to address each device. The driver then notifies the SCSI midlayer of these changes. -.PP +.P Note that the naming convention of the .I /proc filesystem entries contains a number in addition to the driver name (e.g., "cciss0" instead of just "cciss", which you might expect). -.PP +.P Note: .I Only sequential access devices and medium changers are presented @@ -340,7 +340,7 @@ If that doesn't work, the device is reset. If that doesn't work, the SCSI bus is reset. .IP (4) If that doesn't work, the host bus adapter is reset. -.PP +.P The .B cciss driver is a block @@ -358,7 +358,7 @@ in aborting commands, and sometimes it appears they will not even obey a reset command, though in most circumstances they will. If the command cannot be aborted and the device cannot be reset, the device will be set offline. -.PP +.P In the event that the error-handling code is triggered and a tape drive is successfully reset or the tardy command is successfully aborted, the tape drive may still not allow I/O to continue until some command @@ -371,7 +371,7 @@ for example) before I/O can proceed again to a tape drive that was reset. .BR cciss_vol_status (8), .BR hpacucli (8), .BR hpacuxe (8) -.PP +.P .UR http://cciss.sf.net .UE , and diff --git a/man4/console_codes.4 b/man4/console_codes.4 index e2ac4e8..afc8c70 100644 --- a/man4/console_codes.4 +++ b/man4/console_codes.4 @@ -6,7 +6,7 @@ .\" This is combined from many sources. .\" For Linux, the definitive source is of course console.c. .\" About vt100-like escape sequences in general there are -.\" the ISO 6429 and ISO 2022 norms, the descriptions of +.\" the ISO/IEC 6429 and ISO/IEC 2022 norms, the descriptions of .\" an actual vt100, and the xterm docs (ctlseqs.ms). .\" Substantial portions of this text are derived from a write-up .\" by Eric S. Raymond . @@ -15,41 +15,42 @@ .\" .\" 2006-05-27, Several corrections - Thomas E. Dickey .\" -.TH console_codes 4 2023-02-05 "Linux man-pages 6.05.01" +.TH console_codes 4 2024-01-28 "Linux man-pages 6.7" .SH NAME console_codes \- Linux console escape and control sequences .SH DESCRIPTION -The Linux console implements a large subset of the VT102 and ECMA-48/ISO -6429/ANSI X3.64 terminal controls, plus certain private-mode sequences +The Linux console implements a large subset of +the VT102 and ECMA-48 / ISO/IEC\~6429 / ANSI X3.64 terminal controls, +plus certain private-mode sequences for changing the color palette, character-set mapping, and so on. In the tabular descriptions below, the second column gives ECMA-48 or DEC mnemonics (the latter if prefixed with DEC) for the given function. Sequences without a mnemonic are neither ECMA-48 nor VT102. -.PP +.P After all the normal output processing has been done, and a stream of characters arrives at the console driver for actual printing, the first thing that happens is a translation from the code used for processing to the code used for printing. -.PP +.P If the console is in UTF-8 mode, then the incoming bytes are first assembled into 16-bit Unicode codes. Otherwise, each byte is transformed according to the current mapping table (which translates it to a Unicode value). See the \fBCharacter Sets\fP section below for discussion. -.PP +.P In the normal case, the Unicode value is converted to a font index, and this is stored in video memory, so that the corresponding glyph (as found in video ROM) appears on the screen. Note that the use of Unicode (and the design of the PC hardware) allows us to use 512 different glyphs simultaneously. -.PP +.P If the current Unicode value is a control character, or we are currently processing an escape sequence, the value will treated specially. Instead of being turned into a font index and rendered as a glyph, it may trigger cursor movement or other control functions. See the \fBLinux Console Controls\fP section below for discussion. -.PP +.P It is generally not good practice to hard-wire terminal controls into programs. Linux supports a @@ -65,9 +66,9 @@ or This section describes all the control characters and escape sequences that invoke special functions (i.e., anything other than writing a glyph at the current cursor location) on the Linux console. -.PP +.P .B "Control characters" -.PP +.P A character is a control character if (before transformation according to the mapping table) it has one of the 14 codes 00 (NUL), 07 (BEL), 08 (BS), 09 (HT), 0a (LF), 0b (VT), @@ -78,7 +79,7 @@ and allow 07, 09, 0b, 18, 1a, 7f to be displayed as glyphs. On the other hand, in UTF-8 mode all codes 00\[en]1f are regarded as control characters, regardless of any "display control characters" mode. -.PP +.P If we have a control character, it is acted upon immediately and then discarded (even in the middle of an escape sequence) and the escape sequence continues with the next character. @@ -129,7 +130,7 @@ is ignored; .TP CSI (0x9B) is equivalent to ESC [. -.PP +.P .B "ESC- but not CSI-sequences" .ad l .TS @@ -152,7 +153,7 @@ ESC 8 DECRC T{ Restore state most recently saved by ESC 7. T} ESC % Start sequence selecting character set -ESC % @ \0\0\0Select default (ISO 646 / ISO 8859-1) +ESC % @ \0\0\0Select default (ISO/IEC\~646 / ISO/IEC\~8859-1) ESC % G \0\0\0Select UTF-8 ESC % 8 \0\0\0Select UTF-8 (obsolete) ESC # 8 DECALN T{ @@ -163,7 +164,7 @@ Start sequence defining G0 character set (followed by one of B, 0, U, K, as below) T} ESC ( B T{ -Select default (ISO 8859-1 mapping). +Select default (ISO/IEC\~8859-1 mapping). T} ESC ( 0 T{ Select VT100 graphics mapping. @@ -190,19 +191,19 @@ the red/green/blue values (0\[en]255). T} .TE .ad -.PP +.P .B "ECMA-48 CSI sequences" -.PP +.P CSI (or ESC [) is followed by a sequence of parameters, at most NPAR (16), that are decimal numbers separated by semicolons. An empty or absent parameter is taken to be 0. The sequence of parameters may be preceded by a single question mark. -.PP +.P However, after CSI [ (or ESC [ [) a single character is read and this entire sequence is ignored. (The idea is to ignore an echoed function key.) -.PP +.P The action of a CSI sequence is determined by its final character. .ad l .TS @@ -309,9 +310,9 @@ Move cursor to indicated column in current row. T} .TE .ad -.PP +.P .B ECMA-48 Select Graphic Rendition -.PP +.P The ECMA-48 SGR sequence ESC [ \fIparameters\fP m sets display attributes. Several attributes can be set in the same sequence, separated by @@ -397,7 +398,7 @@ set background, same as 40..47 (bright not supported) T} .TE .ad -.PP +.P Commands 38 and 48 require further arguments: .TS l lx. @@ -409,7 +410,7 @@ T} 24-bit color, r/g/b components are in the range 0..255 T} .TE -.PP +.P .B ECMA-48 Mode Switches .TP ESC [ 3 h @@ -421,7 +422,7 @@ DECIM (default off): Set insert mode. ESC [ 20 h LF/NL (default off): Automatically follow echo of LF, VT, or FF with CR. .\" -.PP +.P .B ECMA-48 Status Report Commands .\" .TP @@ -432,9 +433,9 @@ ESC [ 6 n Cursor position report (CPR): Answer is ESC [ \fIy\fP ; \fIx\fP R, where \fIx,y\fP is the cursor location. .\" -.PP +.P .B DEC Private Mode (DECSET/DECRST) sequences -.PP +.P .\" These are not described in ECMA-48. We list the Set Mode sequences; @@ -479,9 +480,9 @@ ESC [ ? 1000 h X11 Mouse Reporting (default off): Set reporting mode to 2 (or reset to 0)\[em]see below. .\" -.PP +.P .B Linux Console Private CSI Sequences -.PP +.P .\" The following sequences are neither ECMA-48 nor native VT102. They are native to the Linux console driver. @@ -532,13 +533,13 @@ The kernel knows about 4 translations of bytes into console-screen symbols. The four tables are: a) Latin1 \-> PC, b) VT100 graphics \-> PC, c) PC \-> PC, d) user-defined. -.PP +.P There are two character sets, called G0 and G1, and one of them is the current character set. (Initially G0.) Typing \fB\[ha]N\fP causes G1 to become current, \fB\[ha]O\fP causes G0 to become current. -.PP +.P These variables G0 and G1 point at a translation table, and can be changed by the user. Initially they point at tables a) and b), respectively. @@ -546,7 +547,7 @@ The sequences ESC ( B and ESC ( 0 and ESC ( U and ESC ( K cause G0 to point at translation table a), b), c), and d), respectively. The sequences ESC ) B and ESC ) 0 and ESC ) U and ESC ) K cause G1 to point at translation table a), b), c), and d), respectively. -.PP +.P The sequence ESC c causes a terminal reset, which is what you want if the screen is all garbled. The oft-advised "echo \[ha]V\[ha]O" will make only G0 current, @@ -556,7 +557,7 @@ In some distributions there is a program that just does "echo \[ha][c". If your terminfo entry for the console is correct (and has an entry rs1=\eEc), then "tput reset" will also work. -.PP +.P The user-defined mapping table can be set using .BR mapscrn (8). The result of the mapping is that if a symbol c is printed, the symbol @@ -576,13 +577,13 @@ These ioctls must be generated by a mouse-aware user-mode application such as the .BR gpm (8) daemon. -.PP +.P The mouse tracking escape sequences generated by \fBxterm\fP(1) encode numeric parameters in a single character as \fIvalue\fP+040. For example, \[aq]!\[aq] is 1. The screen coordinate system is 1-based. -.PP +.P The X10 compatibility mode sends an escape sequence on button press encoding the location and the mouse button pressed. It is enabled by sending ESC [ ? 9 h and disabled with ESC [ ? 9 l. @@ -592,7 +593,7 @@ Here \fIb\fP is button\-1, and \fIx\fP and \fIy\fP are the x and y coordinates of the mouse when the button was pressed. This is the same code the kernel also produces. -.PP +.P Normal tracking mode (not implemented in Linux 2.0.24) sends an escape sequence on both button press and release. Modifier information is also sent. @@ -614,9 +615,9 @@ Here we discuss differences between the Linux console and the two most important others, the DEC VT102 and .BR xterm (1). .\" -.PP +.P .B Control-character handling -.PP +.P The VT102 also recognized the following control characters: .TP NUL (0x00) @@ -631,17 +632,17 @@ resumed transmission; DC3 (0x13, \fB\[ha]S\fP, XOFF) caused VT100 to ignore (and stop transmitting) all codes except XOFF and XON. -.PP +.P VT100-like DC1/DC3 processing may be enabled by the terminal driver. -.PP +.P The .BR xterm (1) program (in VT100 mode) recognizes the control characters BEL, BS, HT, LF, VT, FF, CR, SO, SI, ESC. .\" -.PP +.P .B Escape sequences -.PP +.P VT100 console sequences not implemented on the Linux console: .TS l l l. @@ -660,7 +661,7 @@ ESC \e ST String terminator ESC * ... Designate G2 character set ESC + ... Designate G3 character set .TE -.PP +.P The program .BR xterm (1) (in VT100 mode) recognizes ESC c, ESC # 8, ESC >, ESC =, @@ -671,11 +672,11 @@ and ESC \[ha] ... ESC \e with the same meanings as indicated above. It accepts ESC (, ESC ), ESC *, ESC + followed by 0, A, B for the DEC special character and line drawing set, UK, and US-ASCII, respectively. -.PP +.P The user can configure \fBxterm\fP(1) to respond to VT220-specific control sequences, and it will identify itself as a VT52, VT100, and up depending on the way it is configured and initialized. -.PP +.P It accepts ESC ] (OSC) for the setting of certain resources. In addition to the ECMA-48 string terminator (ST), \fBxterm\fP(1) accepts a BEL to terminate an OSC string. @@ -694,7 +695,7 @@ Change log file to \fIname\fP (normally disabled by a compile-time option). T} ESC ] 5 0 ; \fIfn\fP ST Set font to \fIfn\fP. .TE -.PP +.P It recognizes the following with slightly modified meaning (saving more state, behaving closer to VT100/VT220): .TS @@ -702,7 +703,7 @@ l l l. ESC 7 DECSC Save cursor ESC 8 DECRC Restore cursor .TE -.PP +.P It also recognizes .TS l l lx. @@ -719,13 +720,13 @@ ESC | LS3R Invoke the G3 character set as GR. ESC } LS2R Invoke the G2 character set as GR. ESC \[ti] LS1R Invoke the G1 character set as GR. .TE -.PP +.P It also recognizes ESC % and provides a more complete UTF-8 implementation than Linux console. .\" -.PP +.P .B CSI Sequences -.PP +.P Old versions of \fBxterm\fP(1), for example, from X11R5, interpret the blink SGR as a bold SGR. Later versions which implemented ANSI colors, for example, @@ -739,7 +740,7 @@ All ECMA-48 CSI sequences recognized by Linux are also recognized by .IR xterm , however \fBxterm\fP(1) implements several ECMA-48 and DEC control sequences not recognized by Linux. -.PP +.P The \fBxterm\fP(1) program recognizes all of the DEC Private Mode sequences listed above, but none of the Linux private-mode sequences. @@ -753,21 +754,21 @@ and Thomas E.\& Dickey available with the X distribution. That document, though terse, is much longer than this manual page. For a chronological overview, -.PP +.P .RS .UR http://invisible\-island.net\:/xterm\:/xterm.log.html .UE .RE -.PP +.P details changes to xterm. -.PP +.P The \fIvttest\fP program -.PP +.P .RS .UR http://invisible\-island.net\:/vttest/ .UE .RE -.PP +.P demonstrates many of these control sequences. The \fBxterm\fP(1) source distribution also contains sample scripts which exercise other features. @@ -777,7 +778,7 @@ ESC %. .SH BUGS In Linux 2.0.23, CSI is broken, and NUL is not ignored inside escape sequences. -.PP +.P Some older kernel versions (after Linux 2.0) interpret 8-bit control sequences. These "C1 controls" use codes between 128 and 159 to replace @@ -786,7 +787,7 @@ There are fragments of that in modern kernels (either overlooked or broken by changes to support UTF-8), but the implementation is incomplete and should be regarded as unreliable. -.PP +.P Linux "private mode" sequences do not follow the rules in ECMA-48 for private mode control sequences. In particular, those ending with ] do not use a standard terminating @@ -801,7 +802,7 @@ will fix that). To accommodate applications which have been hardcoded to use Linux control sequences, set the \fBxterm\fP(1) resource \fBbrokenLinuxOSC\fP to true. -.PP +.P An older version of this document implied that Linux recognizes the ECMA-48 control sequence for invisible text. It is ignored. diff --git a/man4/cpuid.4 b/man4/cpuid.4 index 3f7d184..e58e29e 100644 --- a/man4/cpuid.4 +++ b/man4/cpuid.4 @@ -3,19 +3,19 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH cpuid 4 2022-10-30 "Linux man-pages 6.05.01" +.TH cpuid 4 2024-01-05 "Linux man-pages 6.7" .SH NAME cpuid \- x86 CPUID access device .SH DESCRIPTION CPUID provides an interface for querying information about the x86 CPU. -.PP +.P This device is accessed by .BR lseek (2) or .BR pread (2) to the appropriate CPUID level and reading in chunks of 16 bytes. A larger read size means multiple reads of consecutive levels. -.PP +.P The lower 32 bits of the file position is used as the incoming .IR %eax , and the upper 32 bits of the file position as the incoming @@ -24,7 +24,7 @@ the latter is intended for "counting" .I eax levels like .IR eax=4 . -.PP +.P This driver uses .IR /dev/cpu/CPUNUM/cpuid , where @@ -34,7 +34,7 @@ and on an SMP box will direct the access to CPU .I CPUNUM as listed in .IR /proc/cpuinfo . -.PP +.P This file is protected so that it can be read only by the user .IR root , or members of the group @@ -44,7 +44,7 @@ The CPUID instruction can be directly executed by a program using inline assembler. However this device allows convenient access to all CPUs without changing process affinity. -.PP +.P Most of the information in .I cpuid is reported by the kernel in cooked form either in @@ -53,29 +53,31 @@ or through subdirectories in .IR /sys/devices/system/cpu . Direct CPUID access through this device should only be used in exceptional cases. -.PP +.P The .I cpuid driver is not auto-loaded. On modular kernels you might need to use the following command to load it explicitly before use: -.PP +.P .in +4n .EX $ modprobe cpuid .EE .in -.PP +.P There is no support for CPUID functions that require additional input registers. -.PP -Very old x86 CPUs don't support CPUID. +.P +Early i486 CPUs do not support the CPUID instruction; +.\" arch/x86/kernel/cpuid.c cpuid_open() +opening this device for those CPUs fails with EIO. .SH SEE ALSO .BR cpuid (1) -.PP +.P Intel Corporation, Intel 64 and IA-32 Architectures Software Developer's Manual Volume 2A: Instruction Set Reference, A-M, 3-180 CPUID reference. -.PP +.P Intel Corporation, Intel Processor Identification and the CPUID Instruction, Application note 485. diff --git a/man4/dsp56k.4 b/man4/dsp56k.4 index a7b2682..36a856d 100644 --- a/man4/dsp56k.4 +++ b/man4/dsp56k.4 @@ -4,16 +4,16 @@ .\" .\" Modified, Thu Jan 27 19:16:19 CET 2000, lars@nocrew.org .\" -.TH dsp56k 4 2023-03-08 "Linux man-pages 6.05.01" +.TH dsp56k 4 2023-10-31 "Linux man-pages 6.7" .SH NAME dsp56k \- DSP56001 interface device .SH SYNOPSIS .nf .B #include -.PP +.P .BI "ssize_t read(int " fd ", void *" data ", size_t " length ); .BI "ssize_t write(int " fd ", void *" data ", size_t " length ); -.PP +.P .BI "int ioctl(int " fd ", DSP56K_UPLOAD, struct dsp56k_upload *" program ); .BI "int ioctl(int " fd ", DSP56K_SET_TX_WSIZE, int " wsize ); .BI "int ioctl(int " fd ", DSP56K_SET_RX_WSIZE, int " wsize ); @@ -31,7 +31,7 @@ processor found in Atari Falcon030-compatible computers. The \fIdsp56k\fP special file is used to control the DSP56001, and to send and receive data using the bidirectional handshaked host port. -.PP +.P To send a data stream to the signal processor, use .BR write (2) to the @@ -41,7 +41,7 @@ to receive processed data. The data can be sent or received in 8, 16, 24, or 32-bit quantities on the host side, but will always be seen as 24-bit quantities in the DSP56001. -.PP +.P The following .BR ioctl (2) calls are used to control the diff --git a/man4/fd.4 b/man4/fd.4 index da04acb..e1aaacb 100644 --- a/man4/fd.4 +++ b/man4/fd.4 @@ -6,7 +6,7 @@ .\" .\" Modified, Sun Feb 26 15:00:02 1995, faith@cs.unc.edu .\" -.TH fd 4 2022-12-15 "Linux man-pages 6.05.01" +.TH fd 4 2023-10-31 "Linux man-pages 6.7" .SH NAME fd \- floppy disk device .SH CONFIGURATION @@ -26,14 +26,14 @@ number on its controller and 128 if the drive is on the secondary controller. In the following device tables, \fIn\fP represents the drive number. -.PP +.P \fBWarning: if you use formats with more tracks than supported by your drive, you may cause it mechanical damage.\fP Trying once if more tracks than the usual 40/80 are supported should not damage it, but no warranty is given for that. If you are not sure, don't create device entries for those formats, so as to prevent their usage. -.PP +.P Drive-independent device files which automatically detect the media format and capacity: .TS @@ -44,7 +44,7 @@ Name Base _ \fBfd\fP\fIn\fP 0 .TE -.PP +.P 5.25 inch double-density device files: .TS lw(1i) l l l l c @@ -54,7 +54,7 @@ Name Capacity Cyl. Sect. Heads Base _ \fBfd\fP\fIn\fP\fBd360\fP 360 40 9 2 4 .TE -.PP +.P 5.25 inch high-density device files: .TS lw(1i) l l l l c @@ -73,7 +73,7 @@ _ \fBfd\fP\fIn\fP\fBh1494\fP 1494 83 18 2 72 \fBfd\fP\fIn\fP\fBh1600\fP 1600 80 20 2 92 .TE -.PP +.P 3.5 inch double-density device files: .TS lw(1i) l l l l c @@ -87,7 +87,7 @@ _ \fBfd\fP\fIn\fP\fBu1040\fP 1040 80 13 2 84 \fBfd\fP\fIn\fP\fBu1120\fP 1120 80 14 2 88 .TE -.PP +.P 3.5 inch high-density device files: .TS lw(1i) l l l l c @@ -108,7 +108,7 @@ _ \fBfd\fP\fIn\fP\fBu1840\fP 1840 80 23 2 116 \fBfd\fP\fIn\fP\fBu1920\fP 1920 80 24 2 100 .TE -.PP +.P 3.5 inch extra-density device files: .TS lw(1i) l l l l c @@ -198,7 +198,7 @@ resets the floppy controller under certain conditions. .TP .B FDRAWCMD sends a raw command to the floppy controller. -.PP +.P For more precise information, consult also the \fI\fP and \fI\fP include files, as well as the .BR floppycontrol (1) @@ -211,11 +211,11 @@ However, if a floppy is formatted with an inter-sector gap that is too small, performance may drop, to the point of needing a few seconds to access an entire track. To prevent this, use interleaved formats. -.PP +.P It is not possible to read floppies which are formatted using GCR (group code recording), which is used by Apple II and Macintosh computers (800k disks). -.PP +.P Reading floppies which are hard sectored (one hole per sector, with the index hole being a little skewed) is not supported. This used to be common with older 8-inch floppies. diff --git a/man4/full.4 b/man4/full.4 index 654b74b..9d5289b 100644 --- a/man4/full.4 +++ b/man4/full.4 @@ -3,7 +3,7 @@ .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" .\" correction, aeb, 970825 -.TH full 4 2022-10-30 "Linux man-pages 6.05.01" +.TH full 4 2023-10-31 "Linux man-pages 6.7" .SH NAME full \- always full device .SH CONFIGURATION @@ -11,7 +11,7 @@ If your system does not have .I /dev/full created already, it can be created with the following commands: -.PP +.P .in +4n .EX mknod \-m 666 /dev/full c 1 7 @@ -23,18 +23,18 @@ The file .I /dev/full has major device number 1 and minor device number 7. -.PP +.P Writes to the .I /dev/full device fail with an .B ENOSPC error. This can be used to test how a program handles disk-full errors. -.PP +.P Reads from the .I /dev/full device will return \e0 characters. -.PP +.P Seeks on .I /dev/full will always succeed. diff --git a/man4/fuse.4 b/man4/fuse.4 index a68a7ea..fbdd918 100644 --- a/man4/fuse.4 +++ b/man4/fuse.4 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH fuse 4 2023-05-03 "Linux man-pages 6.05.01" +.TH fuse 4 2023-10-31 "Linux man-pages 6.7" .SH NAME fuse \- Filesystem in Userspace (FUSE) device .SH SYNOPSIS @@ -21,7 +21,7 @@ Those implementing a FUSE filesystem may wish to make use of a user-space library such as .I libfuse that abstracts away the low-level interface. -.PP +.P At its core, FUSE is a simple client-server protocol, in which the Linux kernel is the client and the daemon is the server. After obtaining a file descriptor for this device, the daemon may @@ -38,7 +38,7 @@ through the first file descriptor (and vice versa). .SS The basic protocol Every message that is read by the daemon begins with a header described by the following structure: -.PP +.P .in +4n .EX struct fuse_in_header { @@ -55,19 +55,19 @@ struct fuse_in_header { }; .EE .in -.PP +.P The header is followed by a variable-length data portion (which may be empty) specific to the requested operation (the requested operation is indicated by .IR opcode ). -.PP +.P The daemon should then process the request and if applicable send a reply (almost all operations require a reply; if they do not, this is documented below), by performing a .BR write (2) to the file descriptor. All replies must start with the following header: -.PP +.P .in +4n .EX struct fuse_out_header { @@ -79,7 +79,7 @@ struct fuse_out_header { }; .EE .in -.PP +.P This header is also followed by (potentially empty) variable-sized data depending on the executed request. However, if the reply is an error reply (i.e., @@ -494,7 +494,7 @@ file descriptor that has not been mounted. Linux. .SH NOTES The following messages are not yet documented in this manual page: -.PP +.P .\" FIXME: Document the following. .in +4n .EX diff --git a/man4/hd.4 b/man4/hd.4 index 4f91c6b..995468f 100644 --- a/man4/hd.4 +++ b/man4/hd.4 @@ -7,7 +7,7 @@ .\" Modified Mon Oct 21 21:38:51 1996 by Eric S. Raymond .\" (and some more by aeb) .\" -.TH hd 4 2023-02-05 "Linux man-pages 6.05.01" +.TH hd 4 2023-10-31 "Linux man-pages 6.7" .SH NAME hd \- MFM/IDE hard disk devices .SH DESCRIPTION @@ -25,7 +25,7 @@ is .B hdc and the slave is .BR hdd . -.PP +.P General IDE block device names have the form .BI hd X\c , or @@ -49,15 +49,15 @@ Thus, the first logical partition will be \&. Both DOS-type partitioning and BSD-disklabel partitioning are supported. You can have at most 63 partitions on an IDE disk. -.PP +.P For example, .I /dev/hda refers to all of the first IDE drive in the system; and .I /dev/hdb3 refers to the third DOS "primary" partition on the second one. -.PP +.P They are typically created by: -.PP +.P .in +4n .EX mknod \-m 660 /dev/hda b 3 0 diff --git a/man4/hpsa.4 b/man4/hpsa.4 index 28ba8cf..2145bf1 100644 --- a/man4/hpsa.4 +++ b/man4/hpsa.4 @@ -5,7 +5,7 @@ .\" .\" shorthand for double quote that works everywhere. .ds q \N'34' -.TH hpsa 4 2022-10-30 "Linux man-pages 6.05.01" +.TH hpsa 4 2023-10-31 "Linux man-pages 6.7" .SH NAME hpsa \- HP Smart Array SCSI driver .SH SYNOPSIS @@ -38,7 +38,7 @@ should still be used for these. The .B hpsa driver supports the following Smart Array boards: -.PP +.P .nf Smart Array P700M Smart Array P212 @@ -50,10 +50,10 @@ driver supports the following Smart Array boards: Smart Array P711m StorageWorks P1210m .fi -.PP +.P .\" commit 135ae6edeb51979d0998daf1357f149a7d6ebb08 Since Linux 4.14, the following Smart Array boards are also supported: -.PP +.P .nf Smart Array 5300 Smart Array 5312 @@ -161,7 +161,7 @@ This attribute contains the 16 hex-digit (8 byte) LUN ID by which a logical drive or physical device can be addressed. .IR c : b : t : l are the controller, bus, target, and lun of the device. -.PP +.P For example: .IP .in +4n @@ -185,7 +185,11 @@ The data structures used by these ioctls are described in the Linux kernel source file .IR include/linux/cciss_ioctl.h . .TP -.BR CCISS_DEREGDISK ", " CCISS_REGNEWDISK ", " CCISS_REGNEWD +.B CCISS_DEREGDISK +.TQ +.B CCISS_REGNEWDISK +.TQ +.B CCISS_REGNEWD These three ioctls all do exactly the same thing, which is to cause the driver to rescan for new devices. This does exactly the same thing as writing to the @@ -204,7 +208,9 @@ Returns driver version in three bytes encoded as: .EE .in .TP -.BR CCISS_PASSTHRU ", " CCISS_BIG_PASSTHRU +.B CCISS_PASSTHRU +.TQ +.B CCISS_BIG_PASSTHRU Allows "BMIC" and "CISS" commands to be passed through to the Smart Array. These are used extensively by the HP Array Configuration Utility, SNMP storage agents, and so on. @@ -221,7 +227,7 @@ for some examples. .BR cciss_vol_status (8), .BR hpacucli (8), .BR hpacuxe (8) -.PP +.P .UR http://cciss.sf.net .UE , and diff --git a/man4/initrd.4 b/man4/initrd.4 index 28a16ea..1490f8e 100644 --- a/man4/initrd.4 +++ b/man4/initrd.4 @@ -12,7 +12,7 @@ .\" phone: (302)654-5478 .\" .\" $Id: initrd.4,v 0.9 1997/11/07 05:05:32 kallal Exp kallal $ -.TH initrd 4 2023-02-05 "Linux man-pages 6.05.01" +.TH initrd 4 2023-10-31 "Linux man-pages 6.7" .SH NAME initrd \- boot loader initialized RAM disk .SH CONFIGURATION @@ -27,14 +27,14 @@ with mode 0400 (read access by root only). If the Linux system does not have .I /dev/initrd already created, it can be created with the following commands: -.PP +.P .in +4n .EX mknod \-m 400 /dev/initrd b 1 250 chown root:disk /dev/initrd .EE .in -.PP +.P Also, support for both "RAM disk" and "Initial RAM disk" (e.g., .B CONFIG_BLK_DEV_RAM=y @@ -57,7 +57,7 @@ by the boot loader before the kernel is started. The kernel then can use .IR /dev/initrd "'s" contents for a two-phase system boot-up. -.PP +.P In the first boot-up phase, the kernel starts up and mounts an initial root filesystem from the contents of .I /dev/initrd @@ -233,7 +233,7 @@ For more information on setting the root filesystem see also the and .B LOADLIN documentation. -.PP +.P It is also possible for the .I /linuxrc executable to change the normal root device. @@ -265,19 +265,19 @@ and then writing 0xff (e.g., the pseudo-NFS-device number) into file For example, the following shell command line would change the normal root device to .IR /dev/hdb1 : -.PP +.P .in +4n .EX echo 0x365 >/proc/sys/kernel/real\-root\-dev .EE .in -.PP +.P For an NFS example, the following shell command lines would change the normal root device to the NFS directory .I /var/nfsroot on a local networked NFS server with IP number 193.8.232.7 for a system with IP number 193.8.232.2 and named "idefix": -.PP +.P .in +4n .EX echo /var/nfsroot >/proc/sys/kernel/nfs\-root\-name @@ -286,7 +286,7 @@ echo 193.8.232.2:193.8.232.7::255.255.255.0:idefix \e echo 255 >/proc/sys/kernel/real\-root\-dev .EE .in -.PP +.P .BR Note : The use of .I /proc/sys/kernel/real\-root\-dev @@ -310,7 +310,7 @@ for information on the modern method of changing the root filesystem. The main motivation for implementing .B initrd was to allow for modular kernel configuration at system installation. -.PP +.P A possible system installation scenario is as follows: .IP (1) 5 The loader program boots from floppy or other media with a minimal kernel @@ -364,13 +364,13 @@ to a file.) .IP (9) The system is now bootable and additional installation tasks can be performed. -.PP +.P The key role of .I /dev/initrd in the above is to reuse the configuration data during normal system operation without requiring initial kernel selection, a large generic kernel or, recompiling the kernel. -.PP +.P A second scenario is for installations where Linux runs on systems with different hardware configurations in a single administrative network. In such cases, it may be desirable to use only a small set of kernels @@ -383,14 +383,14 @@ Then, only the file or a file executed by .I /linuxrc would be different. -.PP +.P A third scenario is more convenient recovery disks. Because information like the location of the root filesystem partition is not needed at boot time, the system loaded from .I /dev/initrd can use a dialog and/or auto-detection followed by a possible sanity check. -.PP +.P Last but not least, Linux distributions on CD-ROM may use .B initrd for easy installation from the CD-ROM. @@ -469,7 +469,7 @@ The behavior may change in future versions of the Linux kernel. .BR ram (4), .BR freeramdisk (8), .BR rdev (8) -.PP +.P .I Documentation/admin\-guide/initrd.rst .\" commit 9d85025b0418163fae079c9ba8f8445212de8568 (or diff --git a/man4/intro.4 b/man4/intro.4 index a2fa45e..bcfcee4 100644 --- a/man4/intro.4 +++ b/man4/intro.4 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sat Jul 24 16:57:14 1993 by Rik Faith (faith@cs.unc.edu) -.TH intro 4 2023-02-05 "Linux man-pages 6.05.01" +.TH intro 4 2023-02-05 "Linux man-pages 6.7" .SH NAME intro \- introduction to special files .SH DESCRIPTION diff --git a/man4/lirc.4 b/man4/lirc.4 index dcaae9b..227172f 100644 --- a/man4/lirc.4 +++ b/man4/lirc.4 @@ -2,7 +2,7 @@ .\" Copyright (c) 2018, Sean Young .\" .\" SPDX-License-Identifier: GPL-2.0-or-later -.TH lirc 4 2023-05-03 "Linux man-pages 6.05.01" +.TH lirc 4 2023-10-31 "Linux man-pages 6.7" .SH NAME lirc \- lirc devices .SH DESCRIPTION @@ -13,7 +13,7 @@ bidirectional interface to infra-red (IR) remotes. Most of these devices can receive, and some can send. When receiving or sending data, the driver works in two different modes depending on the underlying hardware. -.PP +.P Some hardware (typically TV-cards) decodes the IR signal internally and provides decoded button presses as scancode values. Drivers for this kind of hardware work in @@ -23,7 +23,7 @@ Such hardware usually does not support sending IR signals. Furthermore, such hardware can only decode a limited set of IR protocols, usually only the protocol of the specific remote which is bundled with, for example, a TV-card. -.PP +.P Other hardware provides a stream of pulse/space durations. Such drivers work in .B LIRC_MODE_MODE2 @@ -39,7 +39,7 @@ and attached to the device. Sometimes, this kind of hardware also supports sending IR data. -.PP +.P The \fBLIRC_GET_FEATURES\fR ioctl (see below) allows probing for whether receiving and sending is supported, and in which modes, amongst other features. @@ -119,7 +119,7 @@ device cannot transmit. \& int ioctl(int fd, int cmd, int *val); .fi -.PP +.P The following .BR ioctl (2) operations are provided by the @@ -132,7 +132,7 @@ hardware settings. .TP 4 .BR LIRC_GET_FEATURES " (\fIvoid\fP)" Returns a bit mask of combined features bits; see FEATURES. -.PP +.P If a device returns an error code for .BR LIRC_GET_FEATURES , it is safe to assume it is not a @@ -215,8 +215,9 @@ describes the pulse width as a percentage of the total cycle. Currently, no special meaning is defined for 0 or 100, but the values are reserved for future use. .TP -.BR LIRC_GET_MIN_TIMEOUT " (\fIvoid\fP)", " "\ -LIRC_GET_MAX_TIMEOUT " (\fIvoid\fP)" +.BI LIRC_GET_MIN_TIMEOUT( void ) +.TQ +.BI LIRC_GET_MAX_TIMEOUT( void ) Some devices have internal timers that can be used to detect when there has been no IR activity for a long time. This can help @@ -417,6 +418,6 @@ Users of older kernels could use the file bundled in .\" .SH SEE ALSO \fBir\-ctl\fP(1), \fBlircd\fP(8),\ \fBbpf\fP(2) -.PP +.P .UR https://www.kernel.org/\:doc/\:html/\:latest/\:userspace\-api/\:media/\:rc/\:lirc\-dev.html .UE diff --git a/man4/loop.4 b/man4/loop.4 index 71c2e4a..273456c 100644 --- a/man4/loop.4 +++ b/man4/loop.4 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" -.TH loop 4 2023-05-03 "Linux man-pages 6.05.01" +.TH loop 4 2023-10-31 "Linux man-pages 6.7" .SH NAME loop, loop-control \- loop devices .SH SYNOPSIS @@ -20,7 +20,7 @@ image stored in a file, so that it can be mounted with the .BR mount (8) command. You could do -.PP +.P .in +4n .EX $ \fBdd if=/dev/zero of=file.img bs=1MiB count=10\fP @@ -30,14 +30,14 @@ $ \fBsudo mkdir /myloopdev\fP $ \fBsudo mount /dev/loop4 /myloopdev\fP .EE .in -.PP +.P See .BR losetup (8) for another example. -.PP +.P A transfer function can be specified for each loop device for encryption and decryption purposes. -.PP +.P The following .BR ioctl (2) operations are provided by the loop block device: @@ -214,12 +214,14 @@ explicitly request read-only mode by setting in .IR loop_config.info.lo_flags . .RE -.PP +.P Since Linux 2.6, there are two new .BR ioctl (2) operations: .TP -.BR LOOP_SET_STATUS64 ", " LOOP_GET_STATUS64 +.B LOOP_SET_STATUS64 +.TQ +.B LOOP_GET_STATUS64 These are similar to .BR LOOP_SET_STATUS " and " LOOP_GET_STATUS described above but use the @@ -293,7 +295,7 @@ device to find a free loop device, opens the loop device, opens a file to be used as the underlying storage for the device, and then associates the loop device with the backing store. The following shell session demonstrates the use of the program: -.PP +.P .in +4n .EX $ \fBdd if=/dev/zero of=file.img bs=1MiB count=10\fP diff --git a/man4/lp.4 b/man4/lp.4 index 16288ec..aa4376b 100644 --- a/man4/lp.4 +++ b/man4/lp.4 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified, Sun Feb 26 15:02:58 1995, faith@cs.unc.edu -.TH lp 4 2023-02-05 "Linux man-pages 6.05.01" +.TH lp 4 2023-02-05 "Linux man-pages 6.7" .SH NAME lp \- line printer devices .SH SYNOPSIS diff --git a/man4/mem.4 b/man4/mem.4 index 4ccb827..cfaa99c 100644 --- a/man4/mem.4 +++ b/man4/mem.4 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sat Jul 24 16:59:10 1993 by Rik Faith (faith@cs.unc.edu) -.TH mem 4 2022-10-30 "Linux man-pages 6.05.01" +.TH mem 4 2023-10-31 "Linux man-pages 6.7" .SH NAME mem, kmem, port \- system memory, kernel memory and system ports .SH DESCRIPTION @@ -12,31 +12,31 @@ mem, kmem, port \- system memory, kernel memory and system ports is a character device file that is an image of the main memory of the computer. It may be used, for example, to examine (and even patch) the system. -.PP +.P Byte addresses in .I /dev/mem are interpreted as physical memory addresses. References to nonexistent locations cause errors to be returned. -.PP +.P Examining and patching is likely to lead to unexpected results when read-only or write-only bits are present. -.PP +.P Since Linux 2.6.26, and depending on the architecture, the .B CONFIG_STRICT_DEVMEM kernel configuration option limits the areas which can be accessed through this file. For example: on x86, RAM access is not allowed but accessing memory-mapped PCI regions is. -.PP +.P It is typically created by: -.PP +.P .in +4n .EX mknod \-m 660 /dev/mem c 1 1 chown root:kmem /dev/mem .EE .in -.PP +.P The file .I /dev/kmem is the same as @@ -46,23 +46,23 @@ rather than physical memory is accessed. Since Linux 2.6.26, this file is available only if the .B CONFIG_DEVKMEM kernel configuration option is enabled. -.PP +.P It is typically created by: -.PP +.P .in +4n .EX mknod \-m 640 /dev/kmem c 1 2 chown root:kmem /dev/kmem .EE .in -.PP +.P .I /dev/port is similar to .IR /dev/mem , but the I/O ports are accessed. -.PP +.P It is typically created by: -.PP +.P .in +4n .EX mknod \-m 660 /dev/port c 1 4 diff --git a/man4/mouse.4 b/man4/mouse.4 index 69278a0..21ff1a2 100644 --- a/man4/mouse.4 +++ b/man4/mouse.4 @@ -3,7 +3,7 @@ .\" Updates Nov 1998, Andries Brouwer .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH mouse 4 2023-02-05 "Linux man-pages 6.05.01" +.TH mouse 4 2023-10-31 "Linux man-pages 6.7" .SH NAME mouse \- serial mouse interface .SH CONFIGURATION @@ -13,7 +13,7 @@ for a description. .SH DESCRIPTION .SS Introduction The pinout of the usual 9 pin plug as used for serial mice is: -.PP +.P .TS center; r c l. @@ -24,15 +24,15 @@ pin name used for 7 RTS +12 V, Imax = 10 mA 5 GND Ground .TE -.PP +.P This is the specification, in fact 9 V suffices with most mice. -.PP +.P The mouse driver can recognize a mouse by dropping RTS to low and raising it again. About 14 ms later the mouse will send 0x4D (\[aq]M\[aq]) on the data line. After a further 63 ms, a Microsoft-compatible 3-button mouse will send 0x33 (\[aq]3\[aq]). -.PP +.P The relative mouse movement is sent as .I dx (positive means right) @@ -44,7 +44,7 @@ To select speeds, cycle through the speeds 9600, 4800, 2400, and 1200 bit/s, each time writing the two characters from the table below and waiting 0.1 seconds. The following table shows available speeds and the strings that select them: -.PP +.P .TS center; l l. @@ -54,7 +54,7 @@ bit/s string 2400 *o 1200 *n .TE -.PP +.P The first byte of a data packet can be used for synchronization purposes. .SS Microsoft protocol The @@ -72,7 +72,7 @@ two's-complement, .RI ( rb ) are set when the left (right) button is pressed: -.PP +.P .TS center; r c c c c c c c. @@ -117,7 +117,7 @@ values. .IR rb ) are cleared when the left (middle, right) button is pressed: -.PP +.P .TS center; r c c c c c c c c. @@ -128,7 +128,7 @@ byte d7 d6 d5 d4 d3 d2 d1 d0 4 0 dxb6 dxb5 dxb4 dxb3 dxb2 dxb1 dxb0 5 0 dyb6 dyb5 dyb4 dyb3 dyb2 dyb1 dyb0 .TE -.PP +.P Bytes 4 and 5 describe the change that occurred since bytes 2 and 3 were transmitted. .SS Sun protocol @@ -153,7 +153,7 @@ sign bit indicating a negative value. .IR rb ) are set when the left (middle, right) button is pressed: -.PP +.P .TS center; r c c c c c c c c. diff --git a/man4/msr.4 b/man4/msr.4 index c499a6e..6a6438c 100644 --- a/man4/msr.4 +++ b/man4/msr.4 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH msr 4 2022-10-30 "Linux man-pages 6.05.01" +.TH msr 4 2023-10-31 "Linux man-pages 6.7" .SH NAME msr \- x86 CPU MSR access device .SH DESCRIPTION @@ -13,13 +13,13 @@ registers (MSRs) of an x86 CPU. .I CPUNUM is the number of the CPU to access as listed in .IR /proc/cpuinfo . -.PP +.P The register access is done by opening the file and seeking to the MSR number as offset in the file, and then reading or writing in chunks of 8 bytes. An I/O transfer of more than 8 bytes means multiple reads or writes of the same register. -.PP +.P This file is protected so that it can be read and written only by the user .IR root , or members of the group @@ -30,7 +30,7 @@ The driver is not auto-loaded. On modular kernels you might need to use the following command to load it explicitly before use: -.PP +.P .in +4n .EX $ modprobe msr diff --git a/man4/null.4 b/man4/null.4 index c1299fb..0d59e4f 100644 --- a/man4/null.4 +++ b/man4/null.4 @@ -4,7 +4,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sat Jul 24 17:00:12 1993 by Rik Faith (faith@cs.unc.edu) -.TH null 4 2023-02-05 "Linux man-pages 6.05.01" +.TH null 4 2023-10-31 "Linux man-pages 6.7" .SH NAME null, zero \- data sink .SH DESCRIPTION @@ -13,7 +13,7 @@ Data written to the and .I /dev/zero special files is discarded. -.PP +.P Reads from .I /dev/null always return end of file (i.e., @@ -21,9 +21,9 @@ always return end of file (i.e., returns 0), whereas reads from .I /dev/zero always return bytes containing zero (\[aq]\e0\[aq] characters). -.PP +.P These devices are typically created by: -.PP +.P .in +4n .EX mknod \-m 666 /dev/null c 1 3 @@ -38,7 +38,7 @@ chown root:root /dev/null /dev/zero .SH NOTES If these devices are not writable and readable for all users, many programs will act strangely. -.PP +.P Since Linux 2.6.31, .\" commit 2b83868723d090078ac0e2120e06a1cc94dbaef0 reads from diff --git a/man4/pts.4 b/man4/pts.4 index d330907..db778d3 100644 --- a/man4/pts.4 +++ b/man4/pts.4 @@ -5,7 +5,7 @@ .\" Redistribute and revise at will. .\" %%%LICENSE_END .\" -.TH pts 4 2022-10-30 "Linux man-pages 6.05.01" +.TH pts 4 2023-10-31 "Linux man-pages 6.7" .SH NAME ptmx, pts \- pseudoterminal master and slave .SH DESCRIPTION @@ -15,7 +15,7 @@ The file is a character file with major number 5 and minor number 2, usually with mode 0666 and ownership root:root. It is used to create a pseudoterminal master and slave pair. -.PP +.P When a process opens .IR /dev/ptmx , it gets a file @@ -29,19 +29,19 @@ is an independent pseudoterminal master with its own associated slave, whose path can be found by passing the file descriptor to .BR ptsname (3). -.PP +.P Before opening the pseudoterminal slave, you must pass the master's file descriptor to .BR grantpt (3) and .BR unlockpt (3). -.PP +.P Once both the pseudoterminal master and slave are open, the slave provides processes with an interface that is identical to that of a real terminal. -.PP +.P Data written to the slave is presented on the master file descriptor as input. Data written to the master is presented to the slave as input. -.PP +.P In practice, pseudoterminals are used for implementing terminal emulators such as .BR xterm (1), @@ -52,7 +52,7 @@ programs such as .BR sshd (8), in which data read from the pseudoterminal master is sent across the network to a client program that is connected to a terminal or terminal emulator. -.PP +.P Pseudoterminals can also be used to send input to programs that normally refuse to read input from pipes (such as .BR su (1), diff --git a/man4/ram.4 b/man4/ram.4 index 04ba495..6c4e037 100644 --- a/man4/ram.4 +++ b/man4/ram.4 @@ -4,16 +4,16 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sat Jul 24 17:01:11 1993 by Rik Faith (faith@cs.unc.edu) -.TH ram 4 2022-10-30 "Linux man-pages 6.05.01" +.TH ram 4 2023-10-31 "Linux man-pages 6.7" .SH NAME ram \- ram disk device .SH DESCRIPTION The .I ram device is a block device to access the ram disk in raw mode. -.PP +.P It is typically created by: -.PP +.P .in +4n .EX mknod \-m 660 /dev/ram b 1 1 diff --git a/man4/random.4 b/man4/random.4 index 0f0eb21..7a1d15d 100644 --- a/man4/random.4 +++ b/man4/random.4 @@ -9,13 +9,13 @@ .\" 2008-06-20, George Spelvin , .\" Matt Mackall .\" -.TH random 4 2023-04-18 "Linux man-pages 6.05.01" +.TH random 4 2023-10-31 "Linux man-pages 6.7" .SH NAME random, urandom \- kernel random number source devices .SH SYNOPSIS .nf #include -.PP +.P .BI "int ioctl(" fd ", RND" request ", " param ");" .fi .SH DESCRIPTION @@ -28,27 +28,27 @@ has major device number 1 and minor device number 8. The file .I /dev/urandom has major device number 1 and minor device number 9. -.PP +.P The random number generator gathers environmental noise from device drivers and other sources into an entropy pool. The generator also keeps an estimate of the number of bits of noise in the entropy pool. From this entropy pool, random numbers are created. -.PP +.P Linux 3.17 and later provides the simpler and safer .BR getrandom (2) interface which requires no special files; see the .BR getrandom (2) manual page for details. -.PP +.P When read, the .I /dev/urandom device returns random bytes using a pseudorandom number generator seeded from the entropy pool. Reads from this device do not block (i.e., the CPU is not yielded), but can incur an appreciable delay when requesting large amounts of data. -.PP +.P When read during early boot time, .I /dev/urandom may return data prior to the entropy pool being initialized. @@ -57,7 +57,7 @@ may return data prior to the entropy pool being initialized. If this is of concern in your application, use .BR getrandom (2) or \fI/dev/random\fP instead. -.PP +.P The \fI/dev/random\fP device is a legacy interface which dates back to a time where the cryptographic primitives used in the implementation of \fI/dev/urandom\fP were not widely trusted. @@ -65,7 +65,7 @@ It will return random bytes only within the estimated number of bits of fresh noise in the entropy pool, blocking if necessary. \fI/dev/random\fP is suitable for applications that need high quality randomness, and can afford indeterminate delays. -.PP +.P When the entropy pool is empty, reads from \fI/dev/random\fP will block until additional environmental noise is gathered. Since Linux 5.6, the @@ -89,7 +89,7 @@ will return \-1 and .I errno will be set to .BR EAGAIN . -.PP +.P The .B O_NONBLOCK flag has no effect when opening @@ -104,7 +104,7 @@ Reads with a buffer over this limit may return less than the requested number of bytes or fail with the error .BR EINTR , if interrupted by a signal handler. -.PP +.P Since Linux 3.16, .\" commit 79a8468747c5f95ed3d5ce8376a3e82e0c5857fc a @@ -119,7 +119,7 @@ from will return at most 512 bytes .\" SEC_XFER_SIZE in drivers/char/random.c (340 bytes before Linux 2.6.12). -.PP +.P Writing to \fI/dev/random\fP or \fI/dev/urandom\fP will update the entropy pool with the data written, but this will not result in a higher entropy count. @@ -137,7 +137,7 @@ these applications, .BR getrandom (2) must be used instead, because it will block until the entropy pool is initialized. -.PP +.P If a seed file is saved across reboots as recommended below, the output is cryptographically secure against attackers without local root access as @@ -156,7 +156,7 @@ entropy is not immediately available. If your system does not have \fI/dev/random\fP and \fI/dev/urandom\fP created already, they can be created with the following commands: -.PP +.P .in +4n .EX mknod \-m 666 /dev/random c 1 8 @@ -164,7 +164,7 @@ mknod \-m 666 /dev/urandom c 1 9 chown root:root /dev/random /dev/urandom .EE .in -.PP +.P When a Linux system starts up without much operator interaction, the entropy pool may be in a fairly predictable state. This reduces the actual amount of noise in the entropy pool @@ -173,7 +173,7 @@ In order to counteract this effect, it helps to carry entropy pool information across shut-downs and start-ups. To do this, add the lines to an appropriate script which is run during the Linux system start-up sequence: -.PP +.P .in +4n .EX echo "Initializing random number generator..." @@ -192,10 +192,10 @@ bytes=$(expr $bits / 8) dd if=/dev/urandom of=$random_seed count=1 bs=$bytes .EE .in -.PP +.P Also, add the following lines in an appropriate script which is run during the Linux system shutdown: -.PP +.P .in +4n .EX # Carry a random seed from shut\-down to start\-up @@ -210,7 +210,7 @@ bytes=$(expr $bits / 8) dd if=/dev/urandom of=$random_seed count=1 bs=$bytes .EE .in -.PP +.P In the above examples, we assume Linux 2.6.0 or later, where .I /proc/sys/kernel/random/poolsize returns the size of the entropy pool in bits (see below). @@ -321,7 +321,9 @@ is the buffer of size .I buf_size which gets added to the entropy pool. .TP -.BR RNDZAPENTCNT ", " RNDCLEARPOOL +.B RNDZAPENTCNT +.TQ +.B RNDCLEARPOOL Zero the entropy count of all pools and add some system data (such as wall clock) to the pools. .SH FILES @@ -343,5 +345,5 @@ may return data prior to the entropy pool being initialized. .BR mknod (1), .BR getrandom (2), .BR random (7) -.PP +.P RFC\ 1750, "Randomness Recommendations for Security" diff --git a/man4/rtc.4 b/man4/rtc.4 index aae4fc2..5a04a7b 100644 --- a/man4/rtc.4 +++ b/man4/rtc.4 @@ -8,30 +8,30 @@ .\" 2006-02-08 Various additions by mtk .\" 2006-11-26 cleanup, cover the generic rtc framework; David Brownell .\" -.TH rtc 4 2023-02-05 "Linux man-pages 6.05.01" +.TH rtc 4 2023-10-31 "Linux man-pages 6.7" .SH NAME rtc \- real-time clock .SH SYNOPSIS .nf #include -.PP +.P .BI "int ioctl(" fd ", RTC_" request ", " param ");" .fi .SH DESCRIPTION This is the interface to drivers for real-time clocks (RTCs). -.PP +.P Most computers have one or more hardware clocks which record the current "wall clock" time. These are called "Real Time Clocks" (RTCs). One of these usually has battery backup power so that it tracks the time even while the computer is turned off. RTCs often provide alarms and other interrupts. -.PP +.P All i386 PCs, and ACPI-based systems, have an RTC that is compatible with the Motorola MC146818 chip on the original PC/AT. Today such an RTC is usually integrated into the mainboard's chipset (south bridge), and uses a replaceable coin-sized backup battery. -.PP +.P Non-PC systems, such as embedded systems built around system-on-chip processors, use other implementations. They usually won't offer the same functionality as the RTC from a PC/AT. @@ -47,7 +47,7 @@ defined to be the POSIX Epoch: 1970-01-01 00:00:00 +0000 (UTC). (One common implementation counts timer interrupts, once per "jiffy", at a frequency of 100, 250, or 1000 Hz.) That is, it is supposed to report wall clock time, which RTCs also do. -.PP +.P A key difference between an RTC and the system clock is that RTCs run even when the system is in a low power state (including "off"), and the system clock can't. @@ -63,7 +63,7 @@ RTCs can be read and written with or directly with the .BR ioctl (2) requests listed below. -.PP +.P Besides tracking the date and time, many RTCs can also generate interrupts .IP \[bu] 3 @@ -73,7 +73,7 @@ at periodic intervals with a frequency that can be set to any power-of-2 multiple in the range 2 Hz to 8192 Hz; .IP \[bu] on reaching a previously specified alarm time. -.PP +.P Each of those interrupt sources can be enabled or disabled separately. On many systems, the alarm interrupt can be configured as a system wakeup event, which can resume the system from a low power state such as @@ -82,7 +82,7 @@ Hibernation (called S4 in ACPI systems), or even "off" (called S5 in ACPI systems). On some systems, the battery backed RTC can't issue interrupts, but another one can. -.PP +.P The .I /dev/rtc (or @@ -145,7 +145,9 @@ RTC's time the process must be privileged (i.e., have the .B CAP_SYS_TIME capability). .TP -.BR RTC_ALM_READ ", " RTC_ALM_SET +.B RTC_ALM_READ +.TQ +.B RTC_ALM_SET Read and set the alarm time, for RTCs that support alarms. The alarm interrupt must be separately enabled or disabled using the .BR RTC_AIE_ON ", " RTC_AIE_OFF @@ -162,7 +164,9 @@ and .I tm_hour fields of this structure are used. .TP -.BR RTC_IRQP_READ ", " RTC_IRQP_SET +.B RTC_IRQP_READ +.TQ +.B RTC_IRQP_SET Read and set the frequency for periodic interrupts, for RTCs that support periodic interrupts. The periodic interrupt must be separately enabled or disabled using the @@ -184,20 +188,26 @@ capability) can set frequencies above the value specified in .IR /proc/sys/dev/rtc/max\-user\-freq . (This file contains the value 64 by default.) .TP -.BR RTC_AIE_ON ", " RTC_AIE_OFF +.B RTC_AIE_ON +.TQ +.B RTC_AIE_OFF Enable or disable the alarm interrupt, for RTCs that support alarms. The third .BR ioctl (2) argument is ignored. .TP -.BR RTC_UIE_ON ", " RTC_UIE_OFF +.B RTC_UIE_ON +.TQ +.B RTC_UIE_OFF Enable or disable the interrupt on every clock update, for RTCs that support this once-per-second interrupt. The third .BR ioctl (2) argument is ignored. .TP -.BR RTC_PIE_ON ", " RTC_PIE_OFF +.B RTC_PIE_ON +.TQ +.B RTC_PIE_OFF Enable or disable the periodic interrupt, for RTCs that support these periodic interrupts. The third @@ -209,7 +219,9 @@ capability) can enable the periodic interrupt if the frequency is currently set above the value specified in .IR /proc/sys/dev/rtc/max\-user\-freq . .TP -.BR RTC_EPOCH_READ ", " RTC_EPOCH_SET +.B RTC_EPOCH_READ +.TQ +.B RTC_EPOCH_SET Many RTCs encode the year in an 8-bit register which is either interpreted as an 8-bit binary number or as a BCD number. In both cases, @@ -232,10 +244,12 @@ To set the RTC's Epoch the process must be privileged (i.e., have the .B CAP_SYS_TIME capability). .TP -.BR RTC_WKALM_RD ", " RTC_WKALM_SET +.B RTC_WKALM_RD +.TQ +.B RTC_WKALM_SET Some RTCs support a more powerful alarm interface, using these ioctls to read or write the RTC's alarm time (respectively) with this structure: -.PP +.P .RS .in +4n .EX @@ -278,7 +292,13 @@ A pointer to this structure should be passed as the third argument. .SH FILES .TP -.IR /dev/rtc ", " /dev/rtc0 ", " /dev/rtc1 ", etc." +.I /dev/rtc +.TQ +.I /dev/rtc0 +.TQ +.I /dev/rtc1 +.TQ +\&.\|.\|. RTC special character device files. .TP .I /proc/driver/rtc @@ -290,21 +310,21 @@ reference using it will update a designated RTC periodically every 11 minutes. To do so, the kernel has to briefly turn off periodic interrupts; this might affect programs using that RTC. -.PP +.P An RTC's Epoch has nothing to do with the POSIX Epoch which is used only for the system clock. -.PP +.P If the year according to the RTC's Epoch and the year register is less than 1970 it is assumed to be 100 years later, that is, between 2000 and 2069. -.PP +.P Some RTCs support "wildcard" values in alarm fields, to support scenarios like periodic alarms at fifteen minutes after every hour, or on the first day of each month. Such usage is nonportable; portable user-space code expects only a single alarm interrupt, and will either disable or reinitialize the alarm after receiving it. -.PP +.P Some RTCs support periodic interrupts with periods that are multiples of a second rather than fractions of a second; multiple alarms; @@ -322,6 +342,6 @@ capabilities that are not currently exposed by this API. .BR gmtime (3), .BR time (7), .BR hwclock (8) -.PP +.P .I Documentation/rtc.txt in the Linux kernel source tree diff --git a/man4/sd.4 b/man4/sd.4 index b465124..a2bf814 100644 --- a/man4/sd.4 +++ b/man4/sd.4 @@ -3,7 +3,7 @@ .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft .\" -.TH sd 4 2023-02-05 "Linux man-pages 6.05.01" +.TH sd 4 2023-10-31 "Linux man-pages 6.7" .SH NAME sd \- driver for SCSI disk drives .SH SYNOPSIS @@ -22,7 +22,7 @@ is a number denoting the partition on that physical drive. Often, the partition number, .IR p , will be left off when the device corresponds to the whole drive. -.PP +.P SCSI disks have a major device number of 8, and a minor device number of the form (16 * .IR drive_number ") + " partition_number , @@ -37,7 +37,7 @@ partition 0 is the whole drive partitions 1\[en]4 are the DOS "primary" partitions .IP \[bu] partitions 5\[en]8 are the DOS "extended" (or "logical") partitions -.PP +.P For example, .I /dev/sda will have major 8, minor 0, and will refer to all of the first SCSI drive @@ -45,7 +45,7 @@ in the system; and .I /dev/sdb3 will have major 8, minor 19, and will refer to the third DOS "primary" partition on the second SCSI drive in the system. -.PP +.P At this time, only block devices are provided. Raw devices have not yet been implemented. .SH DESCRIPTION @@ -55,7 +55,7 @@ are provided: .TP .B HDIO_GETGEO Returns the BIOS disk parameters in the following structure: -.PP +.P .in +4n .EX struct hd_geometry { diff --git a/man4/sk98lin.4 b/man4/sk98lin.4 index a8cbbbc..808a769 100644 --- a/man4/sk98lin.4 +++ b/man4/sk98lin.4 @@ -6,7 +6,7 @@ .\" .\" This manpage can be viewed using `groff -Tascii -man sk98lin.4 | less` .\" -.TH sk98lin 4 2023-07-28 "Linux man-pages 6.05.01" +.TH sk98lin 4 2023-10-31 "Linux man-pages 6.7" .SH NAME sk98lin \- Marvell/SysKonnect Gigabit Ethernet driver v6.21 .SH SYNOPSIS @@ -46,27 +46,27 @@ sk98lin \- Marvell/SysKonnect Gigabit Ethernet driver v6.21 .hy 0 .BR Note : This obsolete driver was removed in Linux 2.6.26. -.PP +.P .B sk98lin is the Gigabit Ethernet driver for Marvell and SysKonnect network adapter cards. It supports SysKonnect SK-98xx/SK-95xx compliant Gigabit Ethernet Adapter and any Yukon compliant chipset. -.PP +.P When loading the driver using insmod, parameters for the network adapter cards might be stated as a sequence of comma separated commands. If for instance two network adapters are installed and AutoNegotiation on Port A of the first adapter should be ON, but on the Port A of the second adapter switched OFF, one must enter: -.PP +.P .in +4n .EX insmod sk98lin.o AutoNeg_A=On,Off .EE .in -.PP +.P After .B sk98lin is bound to one or more adapter cards and the @@ -81,7 +81,7 @@ where .I x is the number of the interface that has been assigned to a dedicated port by the system. -.PP +.P If loading is finished, any desired IP address can be assigned to the respective .I eth[x] @@ -91,7 +91,7 @@ command. This causes the adapter to connect to the Ethernet and to display a status message on the console saying "ethx: network connection up using port y" followed by the configured or detected connection parameters. -.PP +.P The .B sk98lin also supports large frames (also called jumbo frames). @@ -107,22 +107,22 @@ command with the mtu parameter. If for instance eth0 needs an IP address and a large frame MTU size, the following two commands might be used: -.PP +.P .in +4n .EX ifconfig eth0 10.1.1.1 ifconfig eth0 mtu 9000 .EE .in -.PP +.P Those two commands might even be combined into one: -.PP +.P .in +4n .EX ifconfig eth0 10.1.1.1 mtu 9000 .EE .in -.PP +.P Note that large frames can be used only if permitted by your network infrastructure. This means, that any switch being used in your Ethernet must @@ -135,23 +135,23 @@ In addition to the switches inside the network, all network adapters that are to be used must also be enabled regarding jumbo frames. If an adapter is not set to receive large frames, it will simply drop them. -.PP +.P Switching back to the standard Ethernet frame size can be done by using the .BR ifconfig (8) command again: -.PP +.P .in +4n .EX ifconfig eth0 mtu 1500 .EE .in -.PP +.P The Marvell/SysKonnect Gigabit Ethernet driver for Linux is able to support VLAN and Link Aggregation according to IEEE standards 802.1, 802.1q, and 802.3ad. Those features are available only after installation of open source modules which can be found on the Internet: -.PP +.P .IR VLAN : .UR http://www.candelatech.com\:/\[ti]greear\:/vlan.html .UE @@ -160,7 +160,7 @@ which can be found on the Internet: .IR Aggregation : .UR http://www.st.rim.or.jp\:/\[ti]yumo .UE -.PP +.P Note that Marvell/SysKonnect does not offer any support for these open source modules and does not take the responsibility for any kind of failures or problems arising when using these modules. diff --git a/man4/smartpqi.4 b/man4/smartpqi.4 index ce1f5b7..5e9f25c 100644 --- a/man4/smartpqi.4 +++ b/man4/smartpqi.4 @@ -1,13 +1,13 @@ '\" t -.\" Copyright (C) 2019, Microchip Technology Inc. and its subsidiaries +.\" Copyright (C) 2019-2023, Microchip Technology Inc. and its subsidiaries .\" Copyright (C) 2016-2018, Microsemi Corporation .\" Copyright (C) 2016, PMC-Sierra, Inc. -.\" Written by Kevin Barnett +.\" Written by Kevin Barnett .\" .\" SPDX-License-Identifier: GPL-2.0-only -.TH smartpqi 4 2022-12-15 "Linux man-pages 6.05.01" +.TH smartpqi 4 2023-10-31 "Linux man-pages 6.7" .SH NAME -smartpqi \- Microsemi Smart Family SCSI driver +smartpqi \- Microchip Smart Storage SCSI driver .SH SYNOPSIS .SY "modprobe smartpqi" .RB [ disable_device_id_wildcards= { 0 | 1 }] @@ -16,10 +16,12 @@ smartpqi \- Microsemi Smart Family SCSI driver .RB [ lockup_action= { none | reboot | panic }] .RB [ expose_ld_first= { 0 | 1 }] .RB [ hide_vsep= { 0 | 1 }] +.RB [ disable_managed_interrupts= { 0 | 1 }] +.RB [ ctrl_ready_timeout= { 0 |[ 30 , 1800 ]}] .YS .SH DESCRIPTION .B smartpqi -is a SCSI driver for Microsemi Smart Family controllers. +is a SCSI driver for Microchip Smart Storage controllers. .SS Supported \f[BI]ioctl\fP\/() operations For compatibility with applications written for the .BR cciss (4) @@ -36,7 +38,11 @@ The data structures used by these operations are described in the Linux kernel source file .IR include/linux/cciss_ioctl.h . .TP -.BR CCISS_DEREGDISK ", " CCISS_REGNEWDISK ", " CCISS_REGNEWD +.B CCISS_DEREGDISK +.TQ +.B CCISS_REGNEWDISK +.TQ +.B CCISS_REGNEWD These operations all do exactly the same thing, which is to cause the driver to re-scan for new devices. @@ -66,17 +72,17 @@ Allows BMIC and CISS commands to be passed through to the controller. .TP .BR disable_device_id_wildcards= { 0 | 1 } Disables support for device ID wildcards. -The default value is 0. +The default value is 0 (wildcards are enabled). .TP .BR disable_heartbeat= { 0 | 1 } Disables support for the controller's heartbeat check. This parameter is used for debugging purposes. -The default value is 0, leaving the controller's heartbeat check active. +The default value is 0 (the controller's heartbeat check is enabled). .TP .BR disable_ctrl_shutdown= { 0 | 1 } Disables support for shutting down the controller in the event of a controller lockup. -The default value is 0. +The default value is 0 (controller will be shut down). .TP .BR lockup_action= { none | reboot | panic } Specifies the action the driver takes when a controller @@ -94,17 +100,29 @@ parameter action .TE .TP .BR expose_ld_first= { 0 | 1 } -This option enables support for exposing logical devices to -the operating system before physical devices. -The default value is 0. +This option exposes logical devices to the OS before physical devices. +The default value is 0 (physical devices exposed first). .TP .BR hide_vsep= { 0 | 1 } -This option enables disabling exposure of the virtual SEP to the host. -This is usually associated with direct attached drives. -The default value is 0. +This option disables exposure of the virtual SEP to the OS. +The default value is 0 (virtual SEP is exposed). +.TP +.BR disable_managed_interrupts= { 0 | 1 } +Disables driver utilization of Linux kernel managed interrupts for controllers. +The managed interrupts feature automatically distributes interrupts +to all available CPUs and assigns SMP affinity. +The default value is 0 (managed interrupts enabled). +.TP +.BR ctrl_ready_timeout= { 0 |[ 30 , 1800 ]} +This option specifies the timeout in seconds for the driver to wait +for the controller to be ready. +The valid range is 0 or +.RB [ 30 ", " 1800 ]. +The default value is 0, +which causes the driver to use a timeout of 180 seconds. .SH FILES .SS Device nodes -Logical drives are accessed via the SCSI disk driver +Disk drives are accessed via the SCSI disk driver .RI ( sd ), tape drives via the SCSI tape driver .RI ( st ), @@ -124,30 +142,12 @@ The host attribute is a write-only attribute. Writing to this attribute will cause the driver to scan for new, changed, or removed devices (e.g., hot-plugged tape drives, or newly -configured or deleted logical drives) and notify the SCSI mid-layer of +configured or deleted logical volumes) and notify the SCSI mid-layer of any changes detected. Usually this action is triggered automatically by configuration changes, so the user should not normally have to write to this file. Doing so may be useful when hot-plugging devices such as tape drives or -entire storage boxes containing pre-configured logical drives. -.TP -.IR /sys/class/scsi_host/host * /version -The host -.I version -attribute is a read-only attribute. -This attribute contains the driver version and the controller firmware -version. -.IP -For example: -.IP -.in +4n -.EX -$ \c -.B cat /sys/class/scsi_host/host1/version -driver: 1.1.2\-126 -firmware: 1.29\-112 -.EE -.in +entire storage boxes containing pre-configured logical volumes. .TP .IR /sys/class/scsi_host/host * /lockup_action The host @@ -162,7 +162,7 @@ for an explanation of the .I lockup_action values. .TP -.I /sys/class/scsi_host/host*/driver_version +.IR /sys/class/scsi_host/host * /driver_version The .I driver_version attribute is read-only. @@ -178,7 +178,7 @@ $ \c .EE .in .TP -.I /sys/class/scsi_host/host*/firmware_version +.IR /sys/class/scsi_host/host * /firmware_version The .I firmware_version attribute is read-only. @@ -194,7 +194,7 @@ $ \c .EE .in .TP -.I /sys/class/scsi_host/host*/model +.IR /sys/class/scsi_host/host * /model The .I model attribute is read-only. @@ -210,7 +210,7 @@ $ \c .EE .in .TP -.I /sys/class/scsi_host/host*/serial_number +.IR /sys/class/scsi_host/host * /serial_number The .I serial_number attribute is read-only. @@ -226,7 +226,7 @@ $ \c .EE .in .TP -.I /sys/class/scsi_host/host*/vendor +.IR /sys/class/scsi_host/host * /vendor The .I vendor attribute is read-only. @@ -241,6 +241,69 @@ $ \c Adaptec .EE .in +.TP +.IR /sys/class/scsi_host/host * /enable_stream_detection +The +.I enable_stream_detection +attribute is read-write. +This attribute enables/disables stream detection in the driver. +Enabling stream detection can improve sequential write performance +for ioaccel-enabled volumes. +See the +.B ssd_smart_path_enabled +disk attribute section for details on ioaccel-enabled volumes. +The default value is 1 (stream detection enabled). +.IP +Enable example: +.IP +.in +4n +.EX +$ \c +.B echo 1 > /sys/class/scsi_host/host1/enable_stream_detection +.EE +.in +.TP +.IR /sys/class/scsi_host/host * /enable_r5_writes +The +.I enable_r5_writes +attribute is read-write. +This attribute enables/disables RAID 5 write operations +for ioaccel-enabled volumes. +Enabling can improve sequential write performance. +See the +.B ssd_smart_path_enabled +disk attribute section for details on ioaccel-enabled volumes. +The default value is 1 (RAID 5 writes enabled). +.IP +Enable example: +.IP +.in +4n +.EX +$ \c +.B echo 1 > /sys/class/scsi_host/host1/enable_r5_writes +.EE +.in +.TP +.IR /sys/class/scsi_host/host * /enable_r6_writes +The +.I enable_r6_writes +attribute is read-write. +This attribute enables/disables RAID 6 write operations +for ioaccel-enabled volumes. +Enabling can improve sequential write performance. +See the +.B ssd_smart_path_enabled +disk attribute section for details on ioaccel-enabled volumes. +The default value is 1 (RAID 6 writes enabled). +.IP +Enable example: +.IP +.in +4n +.EX +$ \c +.B echo 1 > /sys/class/scsi_host/host1/enable_r6_writes +.EE +.in .SS SmartPQI-specific disk attribute files in \f[BI]/sys\fP In the file specifications below, .I c @@ -256,7 +319,7 @@ is the logical unit number (LUN). The .I raid_level attribute is read-only. -This attribute contains the RAID level of each logical drive. +This attribute contains the RAID level of the logical volume. .IP For example: .IP @@ -268,11 +331,11 @@ RAID 0 .EE .in .TP -.IR /sys/class/scsi_disk/c : b : t : l/device/sas_address +.IR /sys/class/scsi_disk/ c : b : t : l /device/sas_address The .I sas_address attribute is read-only. -This attribute contains the unique identifier of the disk. +This attribute contains the SAS address of the device. .IP For example: .IP @@ -284,7 +347,7 @@ $ \c .EE .in .TP -.IR /sys/class/scsi_disk/c : b : t : l/device/ssd_smart_path_enabled +.IR /sys/class/scsi_disk/ c : b : t : l /device/ssd_smart_path_enabled The .I ssd_smart_path_enabled attribute is read-only. @@ -305,22 +368,129 @@ $ \c 0 .EE .in +.TP +.IR /sys/class/scsi_disk/ c : b : t : l /device/lunid +The +.I lunid +attribute is read-only. +This attribute contains the SCSI LUN ID for the device. +.IP +For example: +.IP +.in +4n +.EX +$ \c +.B cat /sys/class/scsi_disk/13:1:0:3/device/lunid +0x0300004000000000 +.EE +.in +.TP +.IR /sys/class/scsi_disk/ c : b : t : l /device/unique_id +The +.I unique_id +attribute is read-only. +This attribute contains a 16-byte ID +that uniquely identifies the device within the controller. +.IP +For example: +.IP +.in +4n +.EX +$ \c +.B cat /sys/class/scsi_disk/13:1:0:3/device/unique_id +600508B1001C6D4723A8E98D704FDB94 +.EE +.in +.TP +.IR /sys/class/scsi_disk/ c : b : t : l /device/path_info +The +.I path_info +attribute is read-only. +This attribute contains the +.IR c : b : t : l +of the device +along with the device type +and whether the device is Active or Inactive. +If the device is an HBA device, +.I path_info +will also display the PORT, BOX, and BAY the device is plugged into. +.IP +For example: +.IP +.in +4n +.EX +$ \c +.B cat /sys/class/scsi_disk/13:1:0:3/device/path_info +[13:1:0:3] Direct-Access Active +\& +$ \c +.B cat /sys/class/scsi_disk/12:0:9:0/device/path_info +[12:0:9:0] Direct-Access PORT: C1 BOX: 1 BAY: 14 Inactive +[12:0:9:0] Direct-Access PORT: C0 BOX: 1 BAY: 14 Active +.EE +.in +.TP +.IR /sys/class/scsi_disk/ c : b : t : l /device/raid_bypass_cnt +The +.I raid_bypass_cnt +attribute is read-only. +This attribute contains the number of I/O requests +that have gone through the ioaccel path +for ioaccel-enabled volumes. +See the +.B ssd_smart_path_enabled +disk attribute section for details on ioaccel-enabled volumes. +.IP +For example: +.IP +.in +4n +.EX +$ \c +.B cat /sys/class/scsi_disk/13:1:0:3/device/raid_bypass_cnt +0x300 +.EE +.in +.TP +.IR /sys/class/scsi_disk/ c : b : t : l /device/sas_ncq_prio_enable +The +.I sas_ncq_prio_enable +attribute is read/write. +This attribute enables SATA NCQ priority support. +This attribute works only when device has NCQ support +and controller firmware can handle IO with NCQ priority attribute. +.IP +For example: +.IP +.in +4n +.EX +$ \c +.B echo 1 > /sys/class/scsi_disk/13:1:0:3/device/sas_ncq_prio_enable +.EE +.in .SH VERSIONS The .B smartpqi driver was added in Linux 4.9. .SH NOTES .SS Configuration -To configure a Microsemi Smart Family controller, +To configure a Microchip Smart Storage controller, refer to the User Guide for the controller, which can be found by searching for the specific controller at -.UR https://storage.microsemi.com/ +.UR https://www.microchip.com/design-centers/storage .UE . +.SH HISTORY +.I /sys/class/scsi_host/host*/version +was replaced by two sysfs entries: +.IP +.I /sys/class/scsi_host/host*/driver_version +.IP +.I /sys/class/scsi_host/host*/firmware_version .SH SEE ALSO .BR cciss (4), .BR hpsa (4), .BR sd (4), -.BR st (4) -.PP +.BR st (4), +.BR sg (4) +.P .I Documentation/ABI/testing/sysfs\-bus\-pci\-devices\-cciss in the Linux kernel source tree. diff --git a/man4/st.4 b/man4/st.4 index 254aec0..7366a22 100644 --- a/man4/st.4 +++ b/man4/st.4 @@ -2,13 +2,13 @@ .\" Copyright 1999-2005 Kai Mäkisara (Kai.Makisara@kolumbus.fi) .\" .\" SPDX-License-Identifier: Linux-man-pages-copyleft -.TH st 4 2023-02-05 "Linux man-pages 6.05.01" +.TH st 4 2023-10-31 "Linux man-pages 6.7" .SH NAME st \- SCSI tape device .SH SYNOPSIS .nf .B #include -.PP +.P .BI "int ioctl(int " fd ", int " request " [, (void *)" arg3 "]);" .BI "int ioctl(int " fd ", MTIOCTOP, (struct mtop *)" mt_cmd ); .BI "int ioctl(int " fd ", MTIOCGET, (struct mtget *)" mt_status ); @@ -23,7 +23,7 @@ Currently, the driver takes control of all detected devices of type The .B st driver uses major device number 9. -.PP +.P Each device uses eight minor device numbers. The lowermost five bits in the minor numbers are assigned sequentially in the order of @@ -43,7 +43,7 @@ Devices opened using the \[lq]no-rewind\[rq] device number will not. for instance, mt does not lead to the desired result: the tape is rewound after the mt command and the next command starts from the beginning of the tape). -.PP +.P Within each group, four minor numbers are available to define devices with different characteristics (block size, compression, density, etc.) @@ -57,9 +57,9 @@ drive. The default allocation allows control of 32 tape drives. For instance, it is possible to control up to 64 tape drives with two minor numbers for different options.) -.PP +.P Devices are typically created by: -.PP +.P .in +4n .EX mknod \-m 666 /dev/st0 c 9 0 @@ -72,9 +72,9 @@ mknod \-m 666 /dev/nst0m c 9 192 mknod \-m 666 /dev/nst0a c 9 224 .EE .in -.PP +.P There is no corresponding block device. -.PP +.P The driver uses an internal buffer that has to be large enough to hold at least one tape block. Before Linux 2.1.121, the buffer is @@ -89,7 +89,7 @@ By default, the maximum number of parts is 16. This means that the maximum block size is very large (2\ MB if allocation of 16 blocks of 128\ kB succeeds). -.PP +.P The driver's internal buffer size is determined by a compile-time constant which can be overridden with a kernel startup option. In addition to this, the driver tries to allocate a larger temporary @@ -98,7 +98,7 @@ However, run-time allocation of large contiguous blocks of memory may fail and it is advisable not to rely too much on dynamic buffer allocation before Linux 2.1.121 (this applies also to demand-loading the driver with kerneld or kmod). -.PP +.P The driver does not specifically support any tape drive brand or model. After system start-up the tape device options are defined by @@ -111,7 +111,7 @@ be changed with explicit calls and remain in effect when the device is closed and reopened. Setting the options affects both the auto-rewind and the nonrewind device. -.PP +.P Different options can be specified for the different devices within the subgroup of four. The options take effect when the device is @@ -120,7 +120,7 @@ For example, the system administrator can define one device that writes in fixed-block mode with a certain block size, and one which writes in variable-block mode (if the drive supports both modes). -.PP +.P The driver supports .B tape partitions if they are supported by the drive. @@ -143,12 +143,12 @@ compile-time constant (originally four). The driver contains an .BR ioctl (2) that can format a tape with either one or two partitions. -.PP +.P Device .I /dev/tape is usually created as a hard or soft link to the default tape device on the system. -.PP +.P Starting from Linux 2.6.2, the driver exports in the sysfs directory .I /sys/class/scsi_tape the attached devices and some parameters assigned to the devices. @@ -165,7 +165,7 @@ Note that the blocks on the tape don't contain any information about the writing mode: when reading, the only important thing is to use commands that accept the block sizes on the tape. -.PP +.P In variable-block mode the read byte count does not have to match the tape block size exactly. If the byte count is larger than the @@ -173,7 +173,7 @@ next block on tape, the driver returns the data and the function returns the actual block size. If the block size is larger than the byte count, an error is returned. -.PP +.P In fixed-block mode the read byte counts can be arbitrary if buffering is enabled, or a multiple of the tape block size if buffering is disabled. @@ -182,7 +182,7 @@ arbitrary byte count if buffering is enabled. In all other cases (before Linux 2.1.121 with buffering disabled or newer kernel) the write byte count must be a multiple of the tape block size. -.PP +.P In Linux 2.6, the driver tries to use direct transfers between the user buffer and the device. If this is not possible, the driver's internal buffer @@ -191,10 +191,10 @@ The reasons for not using direct transfers include improper alignment of the user buffer (default is 512 bytes but this can be changed by the HBA driver), one or more pages of the user buffer not reachable by the SCSI adapter, and so on. -.PP +.P A filemark is automatically written to tape if the last tape operation before close was a write. -.PP +.P When a filemark is encountered while reading, the following happens. If there are data remaining in the buffer when the filemark @@ -224,7 +224,7 @@ Not all drives support all operations. The driver returns an .B EIO error if the drive rejects an operation. -.PP +.P .in +4n .EX /* Structure for MTIOCTOP \- mag tape op command: */ @@ -234,7 +234,7 @@ struct mtop { }; .EE .in -.PP +.P Magnetic tape operations for normal tape use: .TP .B MTBSF @@ -395,7 +395,7 @@ filemarks. Write .I mt_count setmarks. -.PP +.P Magnetic tape operations for setting of device options (by the superuser): .TP .B MTSETDRVBUFFER @@ -609,9 +609,9 @@ In BSD semantics the tape position is not changed. .BR MT_NO_WAIT " (Default: false)" Enables immediate mode (i.e., don't wait for the command to finish) for some commands (e.g., rewind). -.PP +.P An example: -.PP +.P .in +4n .EX struct mtop mt_cmd; @@ -621,14 +621,14 @@ mt_cmd.mt_count = MT_ST_BOOLEANS | ioctl(fd, MTIOCTOP, mt_cmd); .EE .in -.PP +.P The default block size for a device can be set with .B MT_ST_DEF_BLKSIZE and the default density code can be set with .BR MT_ST_DEFDENSITY . The values for the parameters are or'ed with the operation code. -.PP +.P With Linux 2.1.x and later, the timeout values can be set with the subcommand .B MT_ST_SET_TIMEOUT @@ -645,7 +645,7 @@ These commands can be used to set more practical values for a specific drive. The timeouts set for one device apply for all devices linked to the same drive. -.PP +.P Starting from Linux 2.4.19 and Linux 2.5.43, the driver supports a status bit which indicates whether the drive requests cleaning. The method used by the @@ -670,7 +670,7 @@ the masked sense data byte. .SS MTIOCGET \[em] get status This request takes an argument of type .IR "(struct mtget\ *)" . -.PP +.P .in +4n .EX /* structure for MTIOCGET \- mag tape get status command */ @@ -812,7 +812,7 @@ This drive must be a SCSI-2 drive that supports the command (device-specific address) or a Tandberg-compatible SCSI-1 drive (Tandberg, Archive Viper, Wangtek, ... ). -.PP +.P .in +4n .EX /* structure for MTIOCPOS \- mag tape get position command */ @@ -940,7 +940,7 @@ telling it to use larger blocks). If this is not possible, direct transfers can be disabled. .SH SEE ALSO .BR mt (1) -.PP +.P The file .I drivers/scsi/README.st or diff --git a/man4/tty.4 b/man4/tty.4 index 1493e87..72bfcdf 100644 --- a/man4/tty.4 +++ b/man4/tty.4 @@ -6,7 +6,7 @@ .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu) .\" Modified 2003-04-07 by Michael Kerrisk .\" -.TH tty 4 2022-10-30 "Linux man-pages 6.05.01" +.TH tty 4 2023-10-31 "Linux man-pages 6.7" .SH NAME tty \- controlling terminal .SH DESCRIPTION @@ -15,7 +15,7 @@ The file is a character file with major number 5 and minor number 0, usually with mode 0666 and ownership root:tty. It is a synonym for the controlling terminal of a process, if any. -.PP +.P In addition to the .BR ioctl (2) requests supported by the device that @@ -27,7 +27,7 @@ request is supported. .SS TIOCNOTTY Detach the calling process from its controlling terminal. -.PP +.P If the process is the session leader, then .B SIGHUP @@ -35,7 +35,7 @@ and .B SIGCONT signals are sent to the foreground process group and all processes in the current session lose their controlling tty. -.PP +.P This .BR ioctl (2) call works only on file descriptors connected diff --git a/man4/ttyS.4 b/man4/ttyS.4 index eadd6bd..66fb119 100644 --- a/man4/ttyS.4 +++ b/man4/ttyS.4 @@ -4,15 +4,15 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified Sat Jul 24 17:03:24 1993 by Rik Faith (faith@cs.unc.edu) -.TH ttyS 4 2022-10-30 "Linux man-pages 6.05.01" +.TH ttyS 4 2023-10-31 "Linux man-pages 6.7" .SH NAME ttyS \- serial terminal lines .SH DESCRIPTION .B ttyS[0\-3] are character devices for the serial terminal lines. -.PP +.P They are typically created by: -.PP +.P .in +4n .EX mknod \-m 660 /dev/ttyS0 c 4 64 # base address 0x3f8 diff --git a/man4/vcs.4 b/man4/vcs.4 index 3aa3523..bf5dba2 100644 --- a/man4/vcs.4 +++ b/man4/vcs.4 @@ -7,7 +7,7 @@ .\" 2007-12-17, Samuel Thibault : .\" document the VT_GETHIFONTMASK ioctl .\" " -.TH vcs 4 2023-05-03 "Linux man-pages 6.05.01" +.TH vcs 4 2023-10-31 "Linux man-pages 6.7" .SH NAME vcs, vcsa \- virtual console memory .SH DESCRIPTION @@ -16,7 +16,7 @@ is a character device with major number 7 and minor number 0, usually with mode 0644 and ownership root:tty. It refers to the memory of the currently displayed virtual console terminal. -.PP +.P .I /dev/vcs[1\-63] are character devices for virtual console terminals, they have major number 7 and minor number 1 to 63, usually @@ -36,7 +36,7 @@ dimensions and cursor position: = .I y = 0 at the top left corner of the screen.) -.PP +.P When a 512-character font is loaded, the 9th bit position can be fetched by applying the .BR ioctl (2) @@ -50,16 +50,16 @@ the value is returned in the pointed to by the third .BR ioctl (2) argument. -.PP +.P These devices replace the screendump .BR ioctl (2) operations of .BR ioctl_console (2), so the system administrator can control access using filesystem permissions. -.PP +.P The devices for the first eight virtual consoles may be created by: -.PP +.P .in +4n .EX for x in 0 1 2 3 4 5 6 7 8; do @@ -69,7 +69,7 @@ done chown root:tty /dev/vcs* .EE .in -.PP +.P No .BR ioctl (2) requests are supported. @@ -83,39 +83,39 @@ requests are supported. Introduced with Linux 1.1.92. .SH EXAMPLES You may do a screendump on vt3 by switching to vt1 and typing -.PP +.P .in +4n .EX cat /dev/vcs3 >foo .EE .in -.PP +.P Note that the output does not contain newline characters, so some processing may be required, like in -.PP +.P .in +4n .EX fold \-w 81 /dev/vcs3 | lpr .EE .in -.PP +.P or (horrors) -.PP +.P .in +4n .EX setterm \-dump 3 \-file /proc/self/fd/1 .EE .in -.PP +.P The .I /dev/vcsa0 device is used for Braille support. -.PP +.P This program displays the character and screen attributes under the cursor of the second virtual console, then changes the background color there: -.PP +.P .EX #include #include diff --git a/man4/veth.4 b/man4/veth.4 index cbb2456..d6c9a19 100644 --- a/man4/veth.4 +++ b/man4/veth.4 @@ -5,7 +5,7 @@ .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" -.TH veth 4 2023-02-05 "Linux man-pages 6.05.01" +.TH veth 4 2023-10-31 "Linux man-pages 6.7" .SH NAME veth \- Virtual Ethernet Device .SH DESCRIPTION @@ -15,27 +15,27 @@ devices are virtual Ethernet devices. They can act as tunnels between network namespaces to create a bridge to a physical network device in another namespace, but can also be used as standalone network devices. -.PP +.P .B veth devices are always created in interconnected pairs. A pair can be created using the command: -.PP +.P .in +4n .EX # ip link add type veth peer name .EE .in -.PP +.P In the above, .I p1-name and .I p2-name are the names assigned to the two connected end points. -.PP +.P Packets transmitted on one device in the pair are immediately received on the other device. When either device is down, the link state of the pair is down. -.PP +.P .B veth device pairs are useful for combining the network facilities of the kernel together in interesting ways. @@ -46,28 +46,28 @@ thus allowing communication between network namespaces. To do this, one can provide the .B netns parameter when creating the interfaces: -.PP +.P .in +4n .EX # ip link add netns type veth peer netns .EE .in -.PP +.P or, for an existing .B veth pair, move one side to the other namespace: -.PP +.P .in +4n .EX # ip link set netns .EE .in -.PP +.P .BR ethtool (8) can be used to find the peer of a .B veth network interface, using commands something like: -.PP +.P .in +4n .EX # \fBip link add ve_A type veth peer name ve_B\fP # Create veth pair diff --git a/man4/wavelan.4 b/man4/wavelan.4 index 8ab01df..3e2f3b4 100644 --- a/man4/wavelan.4 +++ b/man4/wavelan.4 @@ -8,7 +8,7 @@ .\" .\" SPDX-License-Identifier: GPL-1.0-or-later .\" -.TH wavelan 4 2023-02-05 "Linux man-pages 6.05.01" +.TH wavelan 4 2023-10-31 "Linux man-pages 6.7" .SH NAME wavelan \- AT&T GIS WaveLAN ISA device driver .SH SYNOPSIS @@ -18,7 +18,7 @@ wavelan \- AT&T GIS WaveLAN ISA device driver .SH DESCRIPTION .I This driver is obsolete: it was removed in Linux 2.6.35. -.PP +.P .B wavelan is the low-level device driver for the NCR / AT&T / Lucent .B WaveLAN ISA @@ -120,7 +120,7 @@ This driver fails to detect some Wavelan cards. If this happens for you, you must look in the source code on how to add your card to the detection routine. -.PP +.P Some of the mentioned features are optional. You may enable or disable them by changing flags in the driver header and recompile. -- cgit v1.2.3