man2/reboot.2: show BCD dates in hex not decimal
PATCH 5/11 man2/reboot.2: show BCD dates in hex not decimal
--- man2/reboot.2 | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-)
man2/reboot.2 +4 -4
@@ -51,16 +51,16 @@ equals .I magic2 equals .B LINUX_REBOOT_MAGIC2 -(that is, 672274793). +(that is, 0x28121969). However, since Linux 2.1.17 also .B LINUX_REBOOT_MAGIC2A -(that is, 85072278) +(that is, 0x05121996) and since Linux 2.1.97 also .B LINUX_REBOOT_MAGIC2B -(that is, 369367448) +(that is, 0x16041998) and since Linux 2.5.71 also .B LINUX_REBOOT_MAGIC2C -(that is, 537993216) +(that is, 0x20112000) are permitted as values for .IR magic2 . (The hexadecimal values of these constants are meaningful.)
PATCH 6/11 man2/reboot.2: punctuate hex in docs with digit separators
--- man2/reboot.2 | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-)
man2/reboot.2 +12 -12
@@ -47,20 +47,20 @@ unless .I magic equals .B LINUX_REBOOT_MAGIC1 -(that is, 0xfee1dead) and +(that is, 0xfee1\[aq]dead) and .I magic2 equals .B LINUX_REBOOT_MAGIC2 -(that is, 0x28121969). +(that is 0x2812\[aq]1969). However, since Linux 2.1.17 also .B LINUX_REBOOT_MAGIC2A -(that is, 0x05121996) +(that is 0x0512\[aq]1996) and since Linux 2.1.97 also .B LINUX_REBOOT_MAGIC2B -(that is, 0x16041998) +(that is 0x1604\[aq]1998) and since Linux 2.5.71 also .B LINUX_REBOOT_MAGIC2C -(that is, 0x20112000) +(that is 0x2011\[aq]2000) are permitted as values for .IR magic2 . (The hexadecimal values of these constants are meaningful.)
@@ -81,7 +81,7 @@ proper action (maybe: kill all processes, sync, reboot). .TP .B LINUX_REBOOT_CMD_CAD_ON .RB ( RB_ENABLE_CAD , -0x89abcdef). +0x89ab\[aq]cdef). CAD is enabled. This means that the CAD keystroke will immediately cause the action associated with
@@ -89,7 +89,7 @@ the action associated with .TP .B LINUX_REBOOT_CMD_HALT .RB ( RB_HALT_SYSTEM , -0xcdef0123; since Linux 1.1.76). +0xcdef\[aq]0123; since Linux 1.1.76). The message "System halted." is printed, and the system is halted. Control is given to the ROM monitor, if there is one. If not preceded by a
@@ -98,7 +98,7 @@ data will be lost. .TP .B LINUX_REBOOT_CMD_KEXEC .RB ( RB_KEXEC , -0x45584543, since Linux 2.6.13). +0x4558\[aq]4543; since Linux 2.6.13). Execute a kernel that has been loaded earlier with .BR kexec_load (2). This option is available only if the kernel was configured with
@@ -106,7 +106,7 @@ This option is available only if the kernel was configured with .TP .B LINUX_REBOOT_CMD_POWER_OFF .RB ( RB_POWER_OFF , -0x4321fedc; since Linux 2.1.30). +0x4321\[aq]fedc; since Linux 2.1.30). The message "Power down." is printed, the system is stopped, and all power is removed from the system, if possible. If not preceded by a
@@ -115,7 +115,7 @@ data will be lost. .TP .B LINUX_REBOOT_CMD_RESTART .RB ( RB_AUTOBOOT , -0x1234567). +0x0123\[aq]4567). The message "Restarting system." is printed, and a default restart is performed immediately. If not preceded by a
@@ -123,7 +123,7 @@ If not preceded by a data will be lost. .TP .B LINUX_REBOOT_CMD_RESTART2 -(0xa1b2c3d4; since Linux 2.1.30). +(0xa1b2\[aq]c3d4; since Linux 2.1.30). The message "Restarting system with command \(aq%s\(aq" is printed, and a restart (using the command string given in .IR arg )
@@ -134,7 +134,7 @@ data will be lost. .TP .B LINUX_REBOOT_CMD_SW_SUSPEND .RB ( RB_SW_SUSPEND , -0xd000fce1; since Linux 2.5.18). +0xd000\[aq]fce1; since Linux 2.5.18). The system is suspended (hibernated) to disk. This option is available only if the kernel was configured with .BR CONFIG_HIBERNATION .
PATCH 7/11 man2/statfs.2: punctuate hex in docs with digit separators
In reply to Brian Inglis--- man2/statfs.2 | 110 +++++++++++++++++++++++++------------------------- 1 file changed, 55 insertions(+), 55 deletions(-)
man2/statfs.2 +55 -55
@@ -58,90 +58,90 @@ The following filesystem types may appear in .EX ADFS_SUPER_MAGIC 0xadf5 AFFS_SUPER_MAGIC 0xadff -AFS_SUPER_MAGIC 0x5346414f -ANON_INODE_FS_MAGIC 0x09041934 /* Anonymous inode FS (for +AFS_SUPER_MAGIC 0x5346\[aq]414f +ANON_INODE_FS_MAGIC 0x0904\[aq]1934 /* Anonymous inode FS (for pseudofiles that have no name; e.g., epoll, signalfd, bpf) */ AUTOFS_SUPER_MAGIC 0x0187 -BDEVFS_MAGIC 0x62646576 -BEFS_SUPER_MAGIC 0x42465331 -BFS_MAGIC 0x1badface -BINFMTFS_MAGIC 0x42494e4d -BPF_FS_MAGIC 0xcafe4a11 -BTRFS_SUPER_MAGIC 0x9123683e -BTRFS_TEST_MAGIC 0x73727279 -CGROUP_SUPER_MAGIC 0x27e0eb /* Cgroup pseudo FS */ -CGROUP2_SUPER_MAGIC 0x63677270 /* Cgroup v2 pseudo FS */ -CIFS_MAGIC_NUMBER 0xff534d42 -CODA_SUPER_MAGIC 0x73757245 -COH_SUPER_MAGIC 0x012ff7b7 -CRAMFS_MAGIC 0x28cd3d45 -DEBUGFS_MAGIC 0x64626720 +BDEVFS_MAGIC 0x6264\[aq]6576 +BEFS_SUPER_MAGIC 0x4246\[aq]5331 +BFS_MAGIC 0x1bad\[aq]face +BINFMTFS_MAGIC 0x4249\[aq]4e4d +BPF_FS_MAGIC 0xcafe\[aq]4a11 +BTRFS_SUPER_MAGIC 0x9123\[aq]683e +BTRFS_TEST_MAGIC 0x7372\[aq]7279 +CGROUP_SUPER_MAGIC 0x27\[aq]e0eb /* Cgroup pseudo FS */ +CGROUP2_SUPER_MAGIC 0x6367\[aq]7270 /* Cgroup v2 pseudo FS */ +CIFS_MAGIC_NUMBER 0xff53\[aq]4d42 +CODA_SUPER_MAGIC 0x7375\[aq]7245 +COH_SUPER_MAGIC 0x012f\[aq]f7b7 +CRAMFS_MAGIC 0x28cd\[aq]3d45 +DEBUGFS_MAGIC 0x6462\[aq]6720 DEVFS_SUPER_MAGIC 0x1373 /* Linux 2.6.17 and earlier */ DEVPTS_SUPER_MAGIC 0x1cd1 ECRYPTFS_SUPER_MAGIC 0xf15f -EFIVARFS_MAGIC 0xde5e81e4 -EFS_SUPER_MAGIC 0x00414a53 +EFIVARFS_MAGIC 0xde5e\[aq]81e4 +EFS_SUPER_MAGIC 0x0041\[aq]4a53 EXT_SUPER_MAGIC 0x137d /* Linux 2.0 and earlier */ EXT2_OLD_SUPER_MAGIC 0xef51 EXT2_SUPER_MAGIC 0xef53 EXT3_SUPER_MAGIC 0xef53 EXT4_SUPER_MAGIC 0xef53 -F2FS_SUPER_MAGIC 0xf2f52010 -FUSE_SUPER_MAGIC 0x65735546 -FUTEXFS_SUPER_MAGIC 0xbad1dea /* Unused */ +F2FS_SUPER_MAGIC 0xf2f5\[aq]2010 +FUSE_SUPER_MAGIC 0x6573\[aq]5546 +FUTEXFS_SUPER_MAGIC 0xbad\[aq]1dea /* Unused */ HFS_SUPER_MAGIC 0x4244 -HOSTFS_SUPER_MAGIC 0x00c0ffee -HPFS_SUPER_MAGIC 0xf995e849 -HUGETLBFS_MAGIC 0x958458f6 +HOSTFS_SUPER_MAGIC 0x00c0\[aq]ffee +HPFS_SUPER_MAGIC 0xf995\[aq]e849 +HUGETLBFS_MAGIC 0x9584\[aq]58f6 ISOFS_SUPER_MAGIC 0x9660 JFFS2_SUPER_MAGIC 0x72b6 -JFS_SUPER_MAGIC 0x3153464a +JFS_SUPER_MAGIC 0x3153\[aq]464a MINIX_SUPER_MAGIC 0x137f /* original minix FS */ MINIX_SUPER_MAGIC2 0x138f /* 30 char minix FS */ MINIX2_SUPER_MAGIC 0x2468 /* minix V2 FS */ MINIX2_SUPER_MAGIC2 0x2478 /* minix V2 FS, 30 char names */ MINIX3_SUPER_MAGIC 0x4d5a /* minix V3 FS, 60 char names */ -MQUEUE_MAGIC 0x19800202 /* POSIX message queue FS */ +MQUEUE_MAGIC 0x1980\[aq]0202 /* POSIX message queue FS */ MSDOS_SUPER_MAGIC 0x4d44 -MTD_INODE_FS_MAGIC 0x11307854 +MTD_INODE_FS_MAGIC 0x1130\[aq]7854 NCP_SUPER_MAGIC 0x564c NFS_SUPER_MAGIC 0x6969 NILFS_SUPER_MAGIC 0x3434 -NSFS_MAGIC 0x6e736673 -NTFS_SB_MAGIC 0x5346544e -OCFS2_SUPER_MAGIC 0x7461636f +NSFS_MAGIC 0x6e73\[aq]6673 +NTFS_SB_MAGIC 0x5346\[aq]544e +OCFS2_SUPER_MAGIC 0x7461\[aq]636f OPENPROM_SUPER_MAGIC 0x9fa1 -OVERLAYFS_SUPER_MAGIC 0x794c7630 -PIPEFS_MAGIC 0x50495045 +OVERLAYFS_SUPER_MAGIC 0x794c\[aq]7630 +PIPEFS_MAGIC 0x5049\[aq]5045 PROC_SUPER_MAGIC 0x9fa0 /* /proc FS */ -PSTOREFS_MAGIC 0x6165676c +PSTOREFS_MAGIC 0x6165\[aq]676c QNX4_SUPER_MAGIC 0x002f -QNX6_SUPER_MAGIC 0x68191122 -RAMFS_MAGIC 0x858458f6 -REISERFS_SUPER_MAGIC 0x52654973 +QNX6_SUPER_MAGIC 0x6819\[aq]1122 +RAMFS_MAGIC 0x8584\[aq]58f6 +REISERFS_SUPER_MAGIC 0x5265\[aq]4973 ROMFS_MAGIC 0x7275 -SECURITYFS_MAGIC 0x73636673 -SELINUX_MAGIC 0xf97cff8c -SMACK_MAGIC 0x43415d53 +SECURITYFS_MAGIC 0x7363\[aq]6673 +SELINUX_MAGIC 0xf97c\[aq]ff8c +SMACK_MAGIC 0x4341\[aq]5d53 SMB_SUPER_MAGIC 0x517b -SMB2_MAGIC_NUMBER 0xfe534d42 -SOCKFS_MAGIC 0x534f434b -SQUASHFS_MAGIC 0x73717368 -SYSFS_MAGIC 0x62656572 -SYSV2_SUPER_MAGIC 0x012ff7b6 -SYSV4_SUPER_MAGIC 0x012ff7b5 -TMPFS_MAGIC 0x01021994 -TRACEFS_MAGIC 0x74726163 -UDF_SUPER_MAGIC 0x15013346 -UFS_MAGIC 0x00011954 +SMB2_MAGIC_NUMBER 0xfe53\[aq]4d42 +SOCKFS_MAGIC 0x534f\[aq]434b +SQUASHFS_MAGIC 0x7371\[aq]7368 +SYSFS_MAGIC 0x6265\[aq]6572 +SYSV2_SUPER_MAGIC 0x012f\[aq]f7b6 +SYSV4_SUPER_MAGIC 0x012f\[aq]f7b5 +TMPFS_MAGIC 0x0102\[aq]1994 +TRACEFS_MAGIC 0x7472\[aq]6163 +UDF_SUPER_MAGIC 0x1501\[aq]3346 +UFS_MAGIC 0x0001\[aq]1954 USBDEVICE_SUPER_MAGIC 0x9fa2 -V9FS_MAGIC 0x01021997 -VXFS_SUPER_MAGIC 0xa501fcf5 -XENFS_SUPER_MAGIC 0xabba1974 -XENIX_SUPER_MAGIC 0x012ff7b4 -XFS_SUPER_MAGIC 0x58465342 -_XIAFS_SUPER_MAGIC 0x012fd16d /* Linux 2.0 and earlier */ +V9FS_MAGIC 0x0102\[aq]1997 +VXFS_SUPER_MAGIC 0xa501\[aq]fcf5 +XENFS_SUPER_MAGIC 0xabba\[aq]1974 +XENIX_SUPER_MAGIC 0x012f\[aq]f7b4 +XFS_SUPER_MAGIC 0x5846\[aq]5342 +_XIAFS_SUPER_MAGIC 0x012f\[aq]d16d /* Linux 2.0 and earlier */ .EE .in .PP
PATCH 8/11 man2/adjtimex.2: use ISO/IEC suffixes and digit separators in ranges and example docs
In reply to Brian Inglis--- man2/adjtimex.2 | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-)
man2/adjtimex.2 +6 -6
@@ -108,7 +108,7 @@ Set frequency offset from .IR buf.freq . Since Linux 2.6.26, .\" commit 074b3b87941c99bc0ce35385b5817924b1ed0c23 -the supplied value is clamped to the range (\-32768000, +32768000). +the supplied value is clamped to the range (\-32\[aq]000Ki, +32\[aq]000Ki). In older kernels, an .B EINVAL error occurs if the supplied value is out of range.
@@ -471,7 +471,7 @@ does not point to writable memory. .BR EINVAL " (before Linux 2.6.26)" An attempt was made to set .I buf.freq -to a value outside the range (\-33554432, +33554432). +to a value outside the range (\-32Mi, +32Mi). .\" From a quick glance, it appears there was no clamping or range check .\" for buf.freq before Linux 2.0 .TP
@@ -479,8 +479,8 @@ to a value outside the range (\-33554432, +33554432). An attempt was made to set .I buf.offset to a value outside the permitted range. -Before Linux 2.0, the permitted range was (\-131072, +131072). -From Linux 2.0 onwards, the permitted range was (\-512000, +512000). +Before Linux 2.0, the permitted range was (\-128Ki, +128Ki). +From Linux 2.0 onwards, the permitted range was (\-512k, +512k). .TP .B EINVAL An attempt was made to set
@@ -505,9 +505,9 @@ for a discussion of dynamic clocks. An attempt was made to set .I buf.tick to a value outside the range -.RB 900000/ HZ +.RB 900k/ HZ to -.RB 1100000/ HZ , +.RB 1\[aq]100k/ HZ , where .B HZ is the system timer interrupt frequency.
PATCH 9/11 man2/getrandom.2: change limit to use IEC suffix
In reply to Brian Inglis--- man2/getrandom.2 | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
man2/getrandom.2 +1 -1
@@ -188,7 +188,7 @@ As of Linux 3.19 the following limits apply: .IP \(bu 3 When reading from the .I urandom -source, a maximum of 33554431 bytes is returned by a single call to +source, a maximum of 32Mi-1 bytes is returned by a single call to .BR getrandom () on systems where .I int