diff options
Diffstat (limited to 'upstream/debian-bookworm/man8')
50 files changed, 485 insertions, 199 deletions
diff --git a/upstream/debian-bookworm/man8/badblocks.8 b/upstream/debian-bookworm/man8/badblocks.8 index 0b0d8644..3e7074fc 100644 --- a/upstream/debian-bookworm/man8/badblocks.8 +++ b/upstream/debian-bookworm/man8/badblocks.8 @@ -1,5 +1,5 @@ .\" -*- nroff -*- -.TH BADBLOCKS 8 "February 2023" "E2fsprogs version 1.47.0" +.TH BADBLOCKS 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME badblocks \- search a device for bad blocks .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/bridge.8 b/upstream/debian-bookworm/man8/bridge.8 index a60964bb..bb02bd27 100644 --- a/upstream/debian-bookworm/man8/bridge.8 +++ b/upstream/debian-bookworm/man8/bridge.8 @@ -22,6 +22,7 @@ bridge \- show / manipulate bridge addresses and devices \fB\-s\fR[\fItatistics\fR] | \fB\-n\fR[\fIetns\fR] name | \fB\-b\fR[\fIatch\fR] filename | +\fB\-com\fR[\fIpressvlans\fR] | \fB\-c\fR[\fIolor\fR] | \fB\-p\fR[\fIretty\fR] | \fB\-j\fR[\fIson\fR] | @@ -188,6 +189,25 @@ bridge \- show / manipulate bridge addresses and devices .IR SRC_VNI " ]" .ti -8 +.B "bridge mdb flush" +.BI dev " DEV " +.RB "[ " port +.IR PORT " ]" +.RB "[ " vid +.IR VID " ]" +.RB "[ " src_vni +.IR SRC_VNI " ]" +.RB "[ " proto +.IR PROTO " ]" +.RB "[ " [no]permanent " ]" +.RB "[ " dst +.IR IPADDR " ]" +.RB "[ " dst_port +.IR DST_PORT " ]" +.RB "[ " vni +.IR VNI " ]" + +.ti -8 .BR "bridge vlan" " { " add " | " del " } " .B dev .I DEV @@ -327,6 +347,11 @@ If there were any errors during execution of the commands, the application return code will be non zero. .TP +.BR "\-com", " \-compressvlans" +Show compressed VLAN list. It will show continuous VLANs with the range instead +of separated VLANs. Default is off. + +.TP .BR \-c [ color ][ = { always | auto | never } Configure color output. If parameter is omitted or .BR always , @@ -1172,6 +1197,54 @@ the VLAN ID. Only relevant when the bridge is VLAN-aware. the source VNI Network Identifier. Only relevant when the VXLAN device is in external mode. +.SS bridge mdb flush - flush multicast group database entries. + +This command flushes the matching multicast group database entries. + +.TP +.BI dev " DEV" +the interface where this group address is associated. + +.TP +.BI port " PORT" +the target port for the operation. If the bridge device is specified then only +entries pointing to the bridge itself will be deleted. + +.TP +.BI vid " VID" +the VLAN ID for the operation. Match entries only with the specified VLAN ID. + +.TP +.BI src_vni " SRC_VNI" +the source VNI Network Identifier for the operation. Match entries only with +the specified source VNI. + +.TP +.BI proto " PROTO" +the routing protocol identifier for the operation. Match entries only with the +specified routing protocol. Can be a number or a string from the file +/etc/iproute2/rt_protos. + +.TP +.B [no]permanent +if specified then only permanent entries will be deleted or respectively if +"no" is prepended then only non-permanent (temp) entries will be deleted. + +.TP +.BI dst " IPADDR" +the IP address of the destination VXLAN tunnel endpoint where the multicast +receivers reside. Match entries only with the specified destination IP. + +.TP +.BI dst_port " DST_PORT" +the UDP destination port number to use to connect to the remote VXLAN tunnel +endpoint. Match entries only with the specified destination port number. + +.TP +.BI vni " VNI" +the VXLAN VNI Network Identifier to use to connect to the remote VXLAN tunnel +endpoint. Match entries only with the specified destination VNI. + .SH bridge vlan - VLAN filter list .B vlan diff --git a/upstream/debian-bookworm/man8/debugfs.8 b/upstream/debian-bookworm/man8/debugfs.8 index 8b6a600d..746c5327 100644 --- a/upstream/debian-bookworm/man8/debugfs.8 +++ b/upstream/debian-bookworm/man8/debugfs.8 @@ -2,7 +2,7 @@ .\" Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved. .\" This file may be copied under the terms of the GNU Public License. .\" -.TH DEBUGFS 8 "February 2023" "E2fsprogs version 1.47.0" +.TH DEBUGFS 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME debugfs \- ext2/ext3/ext4 file system debugger .SH SYNOPSIS @@ -268,9 +268,24 @@ number, otherwise use the .B s_mmp_block field in the superblock to locate and use the existing MMP block. .TP -.BI dx_hash " [-h hash_alg] [-s hash_seed] filename" +.BI dx_hash " [-cv] [-h hash_alg] [-s hash_seed] filename" Calculate the directory hash of .IR filename . +The +.I -c +option will casefold the filename before calculating the hash. The +.I -v +option will make the +.B dx_hash +command more verbose and print the hash algorithm and hash seed to +calculate the hash. +If a file system is open, use the hash_seed and +default hash_algorithm used by the file system, although these can be +overridden by the +.I -h +and +.I -s +options. The hash algorithm specified with .I -h may be diff --git a/upstream/debian-bookworm/man8/devlink-rate.8 b/upstream/debian-bookworm/man8/devlink-rate.8 index bcec3c31..f09ac4ac 100644 --- a/upstream/debian-bookworm/man8/devlink-rate.8 +++ b/upstream/debian-bookworm/man8/devlink-rate.8 @@ -149,7 +149,7 @@ These parameter accept integer meaning weight or priority of a node. - set rate object parent to existing node with name \fINODE_NAME\fR or unset parent. Rate limits of the parent node applied to all it's children. Actual behaviour is details of driver's implementation. Setting parent to empty ("") -name due to the kernel logic threated as parent unset. +name due to the kernel logic treated as parent unset. .SS devlink port function rate add - create node rate object with specified parameters. Creates rate object of type node and sets parameters. Parameters same as for the diff --git a/upstream/debian-bookworm/man8/dumpe2fs.8 b/upstream/debian-bookworm/man8/dumpe2fs.8 index e1b15c0c..7dfc94fa 100644 --- a/upstream/debian-bookworm/man8/dumpe2fs.8 +++ b/upstream/debian-bookworm/man8/dumpe2fs.8 @@ -2,7 +2,7 @@ .\" Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved. .\" This file may be copied under the terms of the GNU Public License. .\" -.TH DUMPE2FS 8 "February 2023" "E2fsprogs version 1.47.0" +.TH DUMPE2FS 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME dumpe2fs \- dump ext2/ext3/ext4 file system information .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/e2freefrag.8 b/upstream/debian-bookworm/man8/e2freefrag.8 index 510cbb32..d4a227af 100644 --- a/upstream/debian-bookworm/man8/e2freefrag.8 +++ b/upstream/debian-bookworm/man8/e2freefrag.8 @@ -1,5 +1,5 @@ .\" -*- nroff -*- -.TH E2FREEFRAG 8 "February 2023" "E2fsprogs version 1.47.0" +.TH E2FREEFRAG 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME e2freefrag \- report free space fragmentation information .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/e2fsck.8 b/upstream/debian-bookworm/man8/e2fsck.8 index 68b867cf..9a4dc3cf 100644 --- a/upstream/debian-bookworm/man8/e2fsck.8 +++ b/upstream/debian-bookworm/man8/e2fsck.8 @@ -2,7 +2,7 @@ .\" Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved. .\" This file may be copied under the terms of the GNU Public License. .\" -.TH E2FSCK 8 "February 2023" "E2fsprogs version 1.47.0" +.TH E2FSCK 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME e2fsck \- check a Linux ext2/ext3/ext4 file system .SH SYNOPSIS @@ -44,8 +44,9 @@ e2fsck \- check a Linux ext2/ext3/ext4 file system is used to check the ext2/ext3/ext4 family of file systems. For ext3 and ext4 file systems that use a journal, if the system has been shut down uncleanly without any errors, normally, after replaying the -committed transactions in the journal, the file system should be -marked as clean. Hence, for file systems that use journaling, +committed transactions in the journal, the file system should be +marked as clean. +Hence, for file systems that use journaling, .B e2fsck will normally replay the journal and exit, unless its superblock indicates that further checking is required. @@ -63,12 +64,14 @@ option is specified, and .BR \-c , .BR \-l , or -.B -L +.B \-L options are .I not -specified. However, even if it is safe to do so, the results printed by +specified. +However, even if it is safe to do so, the results printed by .B e2fsck -are not valid if the file system is mounted. If +are not valid if the file system is mounted. +If .B e2fsck asks whether or not you should check a file system which is mounted, the only correct answer is ``no''. Only experts who really know what @@ -80,10 +83,10 @@ is run in interactive mode (meaning that none of .BR \-y , .BR \-n , or -.BR \-p +.B \-p are specified), the program will ask the user to fix each problem found in the -file system. A response of 'y' will fix the error; 'n' will leave the error -unfixed; and 'a' will fix the problem and all subsequent problems; pressing +file system. A response of \&'y' will fix the error; \&'n' will leave the error +unfixed; and \&'a' will fix the problem and all subsequent problems; pressing Enter will proceed with the default response, which is printed before the question mark. Pressing Control-C terminates e2fsck immediately. .SH OPTIONS @@ -113,7 +116,7 @@ program using the option to print out where the superblocks exist, supposing .B mke2fs is supplied with arguments that are consistent with the file system's layout -(e.g. blocksize, blocks per group, +(e.g.\& blocksize, blocks per group, .BR sparse_super , etc.). .IP @@ -170,7 +173,7 @@ Print debugging output (useless unless you are debugging .B \-D Optimize directories in file system. This option causes e2fsck to try to optimize all directories, either by re-indexing them if the -file system supports directory indexing, or by sorting and compressing +file system supports directory indexing, or by sorting and compressing directories for smaller directories, or for file systems using traditional linear directories. .IP @@ -204,86 +207,92 @@ Set the version of the extended attribute blocks which will require while checking the file system. The version number may be 1 or 2. The default extended attribute version format is 2. .TP -.BI journal_only +.B journal_only Only replay the journal if required, but do not perform any further checks or repairs. .TP -.BI fragcheck +.B fragcheck During pass 1, print a detailed report of any discontiguous blocks for files in the file system. .TP -.BI discard +.B discard Attempt to discard free blocks and unused inode blocks after the full file system check (discarding blocks is useful on solid state devices and sparse -/ thin-provisioned storage). Note that discard is done in pass 5 AFTER the +/ thin-provisioned storage). +Note that discard is done in pass 5 AFTER the file system has been fully checked and only if it does not contain recognizable -errors. However there might be cases where +errors. +However there might be cases where .B e2fsck does not fully recognize a problem and hence in this case this option may prevent you from further manual data recovery. .TP -.BI nodiscard -Do not attempt to discard free blocks and unused inode blocks. This option is -exactly the opposite of discard option. This is set as default. +.B nodiscard +Do not attempt to discard free blocks and unused inode blocks. +This option is exactly the opposite of discard option. +This is set as default. .TP -.BI no_optimize_extents +.B no_optimize_extents Do not offer to optimize the extent tree by eliminating unnecessary width or depth. This can also be enabled in the options section of .BR /etc/e2fsck.conf . .TP -.BI optimize_extents +.B optimize_extents Offer to optimize the extent tree by eliminating unnecessary width or depth. This is the default unless otherwise specified in .BR /etc/e2fsck.conf . .TP -.BI inode_count_fullmap +.B inode_count_fullmap Trade off using memory for speed when checking a file system with a large number of hard-linked files. The amount of memory required is proportional to the number of inodes in the file system. For large file -systems, this can be gigabytes of memory. (For example, a 40TB file system +systems, this can be gigabytes of memory. (For example, a 40\ TB file system with 2.8 billion inodes will consume an additional 5.7 GB memory if this optimization is enabled.) This optimization can also be enabled in the options section of .BR /etc/e2fsck.conf . .TP -.BI no_inode_count_fullmap +.B no_inode_count_fullmap Disable the .B inode_count_fullmap optimization. This is the default unless otherwise specified in .BR /etc/e2fsck.conf . .TP -.BI readahead_kb +.B readahead_kb Use this many KiB of memory to pre-fetch metadata in the hopes of reducing e2fsck runtime. By default, this is set to the size of two block groups' inode -tables (typically 4MiB on a regular ext4 file system); if this amount is more +tables (typically 4\ MiB on a regular ext4 file system); if this amount is more than 1/50th of total physical memory, readahead is disabled. Set this to zero to disable readahead entirely. .TP -.BI bmap2extent +.B bmap2extent Convert block-mapped files to extent-mapped files. .TP -.BI fixes_only +.B fixes_only Only fix damaged metadata; do not optimize htree directories or compress -extent trees. This option is incompatible with the -D and -E bmap2extent +extent trees. This option is incompatible with the \-D and \-E bmap2extent options. .TP -.BI check_encoding +.B check_encoding Force verification of encoded filenames in case-insensitive directories. This is the default mode if the file system has the strict flag enabled. .TP -.BI unshare_blocks +.B unshare_blocks If the file system has shared blocks, with the shared blocks read-only feature enabled, then this will unshare all shared blocks and unset the read-only -feature bit. If there is not enough free space then the operation will fail. +feature bit. +If there is not enough free space then the operation will fail. If the file system does not have the read-only feature bit, but has shared -blocks anyway, then this option will have no effect. Note when using this +blocks anyway, then this option will have no effect. +Note when using this option, if there is no free space to clone blocks, there is no prompt to delete files and instead the operation will fail. .IP -Note that unshare_blocks implies the "-f" option to ensure that all passes -are run. Additionally, if "-n" is also specified, e2fsck will simulate trying -to allocate enough space to deduplicate. If this fails, the exit code will -be non-zero. +Note that unshare_blocks implies the "\-f" option to ensure that all passes +are run. +Additionally, if "\-n" is also specified, e2fsck will simulate trying +to allocate enough space to deduplicate. +If this fails, the exit code will be non-zero. .RE .TP .B \-f @@ -299,7 +308,7 @@ time trials. Set the pathname where the external-journal for this file system can be found. .TP -.BI \-k +.B \-k When combined with the .B \-c option, any existing bad blocks in the bad blocks list are preserved, @@ -318,7 +327,7 @@ of the file system. Hence, .BR badblocks (8) must be given the blocksize of the file system in order to obtain correct results. As a result, it is much simpler and safer to use the -.B -c +.B \-c option to .BR e2fsck , since it will assure that the correct parameters are passed to the @@ -391,7 +400,9 @@ options. .TP .BI \-z " undo_file" Before overwriting a file system block, write the old contents of the block to -an undo file. This undo file can be used with e2undo(8) to restore the old +an undo file. This undo file can be used with +.BR e2undo (8) +to restore the old contents of the file system should something go wrong. If the empty string is passed as the undo_file argument, the undo file will be written to a file named e2fsck-\fIdevice\fR.e2undo in the directory specified via the @@ -403,24 +414,23 @@ The exit code returned by .B e2fsck is the sum of the following conditions: .br -\ 0\ \-\ No errors -.br -\ 1\ \-\ File system errors corrected + 0 \-\ No errors .br -\ 2\ \-\ File system errors corrected, system should + 1 \-\ File system errors corrected .br -\ \ \ \ be rebooted + 2 \-\ File system errors corrected, system should .br -\ 4\ \-\ File system errors left uncorrected + \ \ be rebooted .br -\ 8\ \-\ Operational error + 4 \-\ File system errors left uncorrected .br -\ 16\ \-\ Usage or syntax error + 8 \-\ Operational error .br -\ 32\ \-\ E2fsck canceled by user request + 16 \-\ Usage or syntax error .br -\ 128\ \-\ Shared library error + 32 \-\ E2fsck canceled by user request .br + 128 \-\ Shared library error .SH SIGNALS The following signals have the following effect when sent to .BR e2fsck . @@ -454,7 +464,7 @@ the messages printed by are in English; if your system has been configured so that .BR e2fsck 's -messages have been translated into another language, please set the the +messages have been translated into another language, please set the .B LC_ALL environment variable to .B C @@ -492,7 +502,7 @@ Always include the full version string which displays when it is run, so I know which version you are running. .SH ENVIRONMENT .TP -.BI E2FSCK_CONFIG +.B E2FSCK_CONFIG Determines the location of the configuration file (see .BR e2fsck.conf (5)). .SH AUTHOR diff --git a/upstream/debian-bookworm/man8/e2image.8 b/upstream/debian-bookworm/man8/e2image.8 index 25673488..46b2122b 100644 --- a/upstream/debian-bookworm/man8/e2image.8 +++ b/upstream/debian-bookworm/man8/e2image.8 @@ -2,7 +2,7 @@ .\" Copyright 2001 by Theodore Ts'o. All Rights Reserved. .\" This file may be copied under the terms of the GNU Public License. .\" -.TH E2IMAGE 8 "February 2023" "E2fsprogs version 1.47.0" +.TH E2IMAGE 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME e2image \- Save critical ext2/ext3/ext4 file system metadata to a file diff --git a/upstream/debian-bookworm/man8/e2label.8 b/upstream/debian-bookworm/man8/e2label.8 index 29adae7e..78c54aba 100644 --- a/upstream/debian-bookworm/man8/e2label.8 +++ b/upstream/debian-bookworm/man8/e2label.8 @@ -2,7 +2,7 @@ .\" Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved. .\" This file may be copied under the terms of the GNU Public License. .\" -.TH E2LABEL 8 "February 2023" "E2fsprogs version 1.47.0" +.TH E2LABEL 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME e2label \- Change the label on an ext2/ext3/ext4 file system .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/e2mmpstatus.8 b/upstream/debian-bookworm/man8/e2mmpstatus.8 index 47a4624e..c72927a7 100644 --- a/upstream/debian-bookworm/man8/e2mmpstatus.8 +++ b/upstream/debian-bookworm/man8/e2mmpstatus.8 @@ -1,7 +1,7 @@ .\" -*- nroff -*- .\" This file may be copied under the terms of the GNU Public License. .\" -.TH E2MMPSTATUS 8 "February 2023" "E2fsprogs version 1.47.0" +.TH E2MMPSTATUS 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME e2mmpstatus \- Check MMP status of an ext4 file system .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/e2scrub.8 b/upstream/debian-bookworm/man8/e2scrub.8 index 6923c679..9511d849 100644 --- a/upstream/debian-bookworm/man8/e2scrub.8 +++ b/upstream/debian-bookworm/man8/e2scrub.8 @@ -1,4 +1,4 @@ -.TH E2SCRUB 8 "February 2023" "E2fsprogs version 1.47.0" +.TH E2SCRUB 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME e2scrub - check the contents of a mounted ext[234] file system .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/e2scrub_all.8 b/upstream/debian-bookworm/man8/e2scrub_all.8 index a2b962d9..6972e286 100644 --- a/upstream/debian-bookworm/man8/e2scrub_all.8 +++ b/upstream/debian-bookworm/man8/e2scrub_all.8 @@ -1,4 +1,4 @@ -.TH E2SCRUB 8 "February 2023" "E2fsprogs version 1.47.0" +.TH E2SCRUB 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME e2scrub_all - check all mounted ext[234] file systems for errors. .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/e2undo.8 b/upstream/debian-bookworm/man8/e2undo.8 index 8b90f7aa..22a9e5ce 100644 --- a/upstream/debian-bookworm/man8/e2undo.8 +++ b/upstream/debian-bookworm/man8/e2undo.8 @@ -2,7 +2,7 @@ .\" Copyright 2008 by Theodore Ts'o. All Rights Reserved. .\" This file may be copied under the terms of the GNU Public License. .\" -.TH E2UNDO 8 "February 2023" "E2fsprogs version 1.47.0" +.TH E2UNDO 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME e2undo \- Replay an undo log for an ext2/ext3/ext4 file system .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/e4crypt.8 b/upstream/debian-bookworm/man8/e4crypt.8 index 579397f2..48df35f4 100644 --- a/upstream/debian-bookworm/man8/e4crypt.8 +++ b/upstream/debian-bookworm/man8/e4crypt.8 @@ -1,4 +1,4 @@ -.TH E4CRYPT 8 "February 2023" "E2fsprogs version 1.47.0" +.TH E4CRYPT 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME e4crypt \- ext4 file system encryption utility .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/filefrag.8 b/upstream/debian-bookworm/man8/filefrag.8 index 5cfa0523..a322b4c6 100644 --- a/upstream/debian-bookworm/man8/filefrag.8 +++ b/upstream/debian-bookworm/man8/filefrag.8 @@ -1,5 +1,5 @@ .\" -*- nroff -*- -.TH FILEFRAG 8 "February 2023" "E2fsprogs version 1.47.0" +.TH FILEFRAG 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME filefrag \- report on file fragmentation .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/grub-bios-setup.8 b/upstream/debian-bookworm/man8/grub-bios-setup.8 index 0530de85..7ec17c08 100644 --- a/upstream/debian-bookworm/man8/grub-bios-setup.8 +++ b/upstream/debian-bookworm/man8/grub-bios-setup.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-BIOS-SETUP "8" "October 2023" "GRUB 2.06-13+deb12u1" "System Administration Utilities" +.TH GRUB-BIOS-SETUP "8" "February 2024" "GRUB 2.12-1~bpo12+1" "System Administration Utilities" .SH NAME grub-bios-setup \- set up a device to boot using GRUB .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/grub-macbless.8 b/upstream/debian-bookworm/man8/grub-macbless.8 index ad1b6d63..b6280ae7 100644 --- a/upstream/debian-bookworm/man8/grub-macbless.8 +++ b/upstream/debian-bookworm/man8/grub-macbless.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MACBLESS "8" "October 2023" "GRUB 2.06-13+deb12u1" "System Administration Utilities" +.TH GRUB-MACBLESS "8" "February 2024" "GRUB 2.12-1~bpo12+1" "System Administration Utilities" .SH NAME grub-macbless \- bless a mac file/directory .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/grub-mkconfig.8 b/upstream/debian-bookworm/man8/grub-mkconfig.8 index ff56cc14..0721f16d 100644 --- a/upstream/debian-bookworm/man8/grub-mkconfig.8 +++ b/upstream/debian-bookworm/man8/grub-mkconfig.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MKCONFIG "8" "October 2023" "GRUB 2.06-13+deb12u1" "System Administration Utilities" +.TH GRUB-MKCONFIG "8" "February 2024" "GRUB 2.12-1~bpo12+1" "System Administration Utilities" .SH NAME grub-mkconfig \- generate a GRUB configuration file .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/grub-mkdevicemap.8 b/upstream/debian-bookworm/man8/grub-mkdevicemap.8 index 2eb114ac..dbb6fcb8 100644 --- a/upstream/debian-bookworm/man8/grub-mkdevicemap.8 +++ b/upstream/debian-bookworm/man8/grub-mkdevicemap.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-MKDEVICEMAP "8" "October 2023" "GRUB 2.06-13+deb12u1" "System Administration Utilities" +.TH GRUB-MKDEVICEMAP "8" "February 2024" "GRUB 2.12-1~bpo12+1" "System Administration Utilities" .SH NAME grub-mkdevicemap \- make a device map file automatically .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/grub-probe.8 b/upstream/debian-bookworm/man8/grub-probe.8 index d96f21c2..2b96e669 100644 --- a/upstream/debian-bookworm/man8/grub-probe.8 +++ b/upstream/debian-bookworm/man8/grub-probe.8 @@ -1,5 +1,5 @@ .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.49.3. -.TH GRUB-PROBE "8" "October 2023" "GRUB 2.06-13+deb12u1" "System Administration Utilities" +.TH GRUB-PROBE "8" "February 2024" "GRUB 2.12-1~bpo12+1" "System Administration Utilities" .SH NAME grub-probe \- probe device information for GRUB .SH SYNOPSIS @@ -30,7 +30,8 @@ hints_string, ieee1275_hints, msdos_parttype, partmap, partuuid, zero_check [default=fs] .TP \fB\-v\fR, \fB\-\-verbose\fR -print verbose messages. +print verbose messages (pass twice to enable +debug printing). .TP \-?, \fB\-\-help\fR give this help list diff --git a/upstream/debian-bookworm/man8/ip-address.8 b/upstream/debian-bookworm/man8/ip-address.8 index 8e0de0e9..277c5068 100644 --- a/upstream/debian-bookworm/man8/ip-address.8 +++ b/upstream/debian-bookworm/man8/ip-address.8 @@ -146,7 +146,8 @@ ip-address \- protocol address management .BR ipvlan " |" .BR lowpan " |" .BR geneve " |" -.BR macsec " ]" +.BR macsec " |" +.BR netkit " ]" .SH "DESCRIPTION" The diff --git a/upstream/debian-bookworm/man8/ip-ioam.8 b/upstream/debian-bookworm/man8/ip-ioam.8 index 1bdc0ece..c723d782 100644 --- a/upstream/debian-bookworm/man8/ip-ioam.8 +++ b/upstream/debian-bookworm/man8/ip-ioam.8 @@ -49,12 +49,17 @@ ip-ioam \- IPv6 In-situ OAM (IOAM) .RI " { " ID " | " .BR none " }" +.ti -8 +.B ip ioam monitor + .SH DESCRIPTION The \fBip ioam\fR command is used to configure IPv6 In-situ OAM (IOAM6) internal parameters, namely IOAM namespaces and schemas. .PP Those parameters also include the mapping between an IOAM namespace and an IOAM schema. +.PP +The \fBip ioam monitor\fR command displays IOAM data received. .SH EXAMPLES .PP diff --git a/upstream/debian-bookworm/man8/ip-l2tp.8 b/upstream/debian-bookworm/man8/ip-l2tp.8 index 9aba6bec..7109c0a0 100644 --- a/upstream/debian-bookworm/man8/ip-l2tp.8 +++ b/upstream/debian-bookworm/man8/ip-l2tp.8 @@ -392,7 +392,7 @@ If L2TP is being used over IPv6, use the IPv6 defrag module. .SH INTEROPERABILITY .PP Unmanaged (static) L2TPv3 tunnels are supported by some network -equipment equipment vendors such as Cisco. +equipment vendors such as Cisco. .PP In Linux, L2TP Hello messages are not supported in unmanaged tunnels. Hello messages are used by L2TP clients and servers to detect diff --git a/upstream/debian-bookworm/man8/ip-link.8 b/upstream/debian-bookworm/man8/ip-link.8 index 209ae825..e3c71efd 100644 --- a/upstream/debian-bookworm/man8/ip-link.8 +++ b/upstream/debian-bookworm/man8/ip-link.8 @@ -63,7 +63,7 @@ ip-link \- network device configuration .RI "[ " ARGS " ]" .ti -8 -.BR "ip link set " { +.BR "ip link" " { " set " | " change " } " { .IR DEVICE " | " .BI "group " GROUP } @@ -247,6 +247,7 @@ ip-link \- network device configuration .BR macvlan " | " .BR macvtap " | " .BR netdevsim " |" +.BR netkit " |" .BR nlmon " |" .BR rmnet " |" .BR sit " |" @@ -384,6 +385,9 @@ Link types: .BR netdevsim - Interface for netdev API tests .sp +.BR netkit +- BPF-programmable network device +.sp .BR nlmon - Netlink monitoring device .sp @@ -441,6 +445,11 @@ TCP for IPv6 on this device when the size is greater than 65536. specifies the recommended maximum size of a IPv4 Generic Segment Offload packet the new device should accept. This is especially used to enable BIG TCP for IPv4 on this device by setting to a size greater than 65536. +Note that +.B gso_max_size +needs to be set to a size greater than or equal to +.B gso_ipv4_max_size +to really enable BIG TCP for IPv4. .TP .BI gso_max_segs " SEGMENTS " @@ -849,6 +858,46 @@ tunnel. .in -8 .TP +netkit Type Support +For a link of type +.I netkit +the following additional arguments are supported: + +.BI "ip link add " DEVICE +.BR type " netkit " +[ +.BI mode " MODE " +] [ +.I "POLICY " +] [ +.BR peer +[ +.I "POLICY " +] [ +.I "NAME " +] ] + +.in +8 + +.sp +.BI mode " MODE" +- specifies the operation mode of the netkit device with "l3" and "l2" +as possible values. Default option is "l3". + +.sp +.I "POLICY" +- specifies the default device policy when no BPF programs are attached +with "forward" and "blackhole" as possible values. Default option is +"forward". Specifying policy before the peer option refers to the primary +device, after the peer option refers to the peer device. + +.sp +.I "NAME" +- specifies the device name of the peer device. + +.in -8 + +.TP IPIP, SIT Type Support For a link of type .IR IPIP or SIT diff --git a/upstream/debian-bookworm/man8/ip-netns.8 b/upstream/debian-bookworm/man8/ip-netns.8 index 0c03fdb3..cad9c55b 100644 --- a/upstream/debian-bookworm/man8/ip-netns.8 +++ b/upstream/debian-bookworm/man8/ip-netns.8 @@ -98,7 +98,7 @@ If NAME is available in /run/netns this command creates a new network namespace and assigns NAME. .TP -.B ip netns attach NAME PID - create a new named network namespace +.B ip netns attach NAME PID - assign a name to the network namespace of the process .sp If NAME is available in /run/netns this command attaches the network namespace of the process PID to NAME as if it were created with ip netns. diff --git a/upstream/debian-bookworm/man8/ip-route.8 b/upstream/debian-bookworm/man8/ip-route.8 index 8a7553c2..aa8a1a87 100644 --- a/upstream/debian-bookworm/man8/ip-route.8 +++ b/upstream/debian-bookworm/man8/ip-route.8 @@ -29,6 +29,7 @@ ip-route \- routing table management .ti -8 .B ip route get .I ROUTE_GET_FLAGS +.B [ to ] .IR ADDRESS " [ " .BI from " ADDRESS " iif " STRING" .RB " ] [ " oif @@ -44,7 +45,9 @@ ip-route \- routing table management .B sport .IR NUMBER " ] [ " .B dport -.IR NUMBER " ] " +.IR NUMBER " ] [" +.B as +.IR ADDRESS " ]" .ti -8 .BR "ip route" " { " add " | " del " | " change " | " append " | "\ @@ -263,9 +266,14 @@ throw " | " unreachable " | " prohibit " | " blackhole " | " nat " ]" .ti -8 .IR ROUTE_GET_FLAGS " := " -.BR " [ " -.BR fibmatch -.BR " ] " +.IR ROUTE_GET_FLAG " [ " +.IR ROUTE_GET_FLAGS " ] " + +.ti -8 +.IR ROUTE_GET_FLAG " := " +.BR "[ " +.BR connected " | " fibmatch " | " notify +.BR "]" .SH DESCRIPTION .B ip route diff --git a/upstream/debian-bookworm/man8/ip.8 b/upstream/debian-bookworm/man8/ip.8 index 72227d44..fdae57c5 100644 --- a/upstream/debian-bookworm/man8/ip.8 +++ b/upstream/debian-bookworm/man8/ip.8 @@ -19,10 +19,12 @@ ip \- show / manipulate routing, network devices, interfaces and tunnels .ti -8 .IR OBJECT " := { " -.BR link " | " address " | " addrlabel " | " route " | " rule " | " neigh " | "\ - ntable " | " tunnel " | " tuntap " | " maddress " | " mroute " | " mrule " | "\ - monitor " | " xfrm " | " netns " | " l2tp " | " tcp_metrics " | " token " | "\ - macsec " | " vrf " | " mptcp " | " ioam " | " stats " }" +.BR address " | " addrlabel " | " fou " | " help " | " ila " | " ioam " | "\ + l2tp " | " link " | " macsec " | " maddress " | " monitor " | " mptcp " | "\ + mroute " | " mrule " | " neighbor " | " neighbour " | " netconf " | "\ + netns " | " nexthop " | " ntable " | " ntbl " | " route " | " rule " | "\ + sr " | " tap " | " tcpmetrics " | " token " | " tunnel " | " tuntap " | "\ + vrf " | " xfrm " }" .sp .ti -8 @@ -255,6 +257,14 @@ Request the kernel to send the applied configuration back. - label configuration for protocol address selection. .TP +.B fou +- Foo-over-UDP receive port configuration. + +.TP +.B ila +- manage identifier locator addresses (ILA). + +.TP .B ioam - manage IOAM namespaces and IOAM schemas. @@ -267,6 +277,10 @@ Request the kernel to send the applied configuration back. - network device. .TP +.B macsec +- MACsec device configuration. + +.TP .B maddress - multicast address. @@ -291,10 +305,18 @@ Request the kernel to send the applied configuration back. - manage ARP or NDISC cache entries. .TP +.B netconf +- network configuration monitoring. + +.TP .B netns - manage network namespaces. .TP +.B nexthop +- manage nexthop objects. + +.TP .B ntable - manage the neighbor cache's operation. @@ -307,12 +329,16 @@ Request the kernel to send the applied configuration back. - rule in routing policy database. .TP +.B sr +- manage IPv6 segment routing. + +.TP .B stats - manage and show interface statistics. .TP .B tcp_metrics/tcpmetrics -- manage TCP Metrics +- manage TCP Metrics. .TP .B token @@ -415,19 +441,24 @@ was written by Alexey N. Kuznetsov and added in Linux 2.2. .SH SEE ALSO .BR ip-address (8), .BR ip-addrlabel (8), +.BR ip-fou (8), .BR ip-ioam (8), .BR ip-l2tp (8), .BR ip-link (8), +.BR ip-macsec (8), .BR ip-maddress (8), .BR ip-monitor (8), .BR ip-mptcp (8), .BR ip-mroute (8), .BR ip-neighbour (8), +.BR ip-netconf (8), .BR ip-netns (8), +.BR ip-nexthop (8), .BR ip-ntable (8), .BR ip-route (8), .BR ip-rule (8), -.BR ip-stats (8) +.BR ip-sr (8), +.BR ip-stats (8), .BR ip-tcp_metrics (8), .BR ip-token (8), .BR ip-tunnel (8), diff --git a/upstream/debian-bookworm/man8/mke2fs.8 b/upstream/debian-bookworm/man8/mke2fs.8 index d39c024b..c3bf90eb 100644 --- a/upstream/debian-bookworm/man8/mke2fs.8 +++ b/upstream/debian-bookworm/man8/mke2fs.8 @@ -2,7 +2,7 @@ .\" Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved. .\" This file may be copied under the terms of the GNU Public License. .\" -.TH MKE2FS 8 "February 2023" "E2fsprogs version 1.47.0" +.TH MKE2FS 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME mke2fs \- create an ext2/ext3/ext4 file system .SH SYNOPSIS @@ -23,7 +23,7 @@ mke2fs \- create an ext2/ext3/ext4 file system ] [ .B \-d -.I root-directory +.I root-directory|tarball ] [ .B \-D @@ -232,16 +232,18 @@ test is used instead of a fast read-only test. .TP .B \-C " cluster-size" Specify the size of cluster in bytes for file systems using the bigalloc -feature. Valid cluster-size values are from 2048 to 256M bytes per -cluster. This can only be specified if the bigalloc feature is -enabled. (See the +feature. Valid cluster-size values range from 2 to 32768 times the +filesystem blocksize and must be a power of 2. The cluster-size can +only be specified if the bigalloc feature is enabled. (See the .B ext4 (5) man page for more details about bigalloc.) The default cluster size if bigalloc is enabled is 16 times the block size. .TP -.BI \-d " root-directory" -Copy the contents of the given directory into the root directory of the -file system. +.BI \-d " root-directory|tarball" +Copy the contents of the given directory or tarball into the root directory of the +file system. Tarball input is only available if mke2fs was compiled with +libarchive support enabled and if the libarchive shared library is available +at run-time. The special value "-" will read a tarball from standard input. .TP .B \-D Use direct I/O when writing to the disk. This avoids mke2fs dirtying a @@ -406,6 +408,11 @@ The \fBroot_owner=\fR option allows explicitly specifying these values, and avoid side-effects for users that do not expect the contents of the file system to change based on the user running \fBmke2fs\fR. .TP +.BI root_perms [=permissions] +Specify the root directory permissions in octal format. If no permissions +are specified then the root directory permissions would be set in accordance with +the default filesystem umask. +.TP .B test_fs Set a flag in the file system superblock indicating that it may be mounted using experimental kernel code, such as the ext4dev file system. @@ -508,8 +515,8 @@ The default inode size is controlled by the file. In the .B mke2fs.conf file shipped with e2fsprogs, the default inode size is 256 bytes for -most file systems, except for small file systems where the inode size -will be 128 bytes. +all file systems, except for the GNU Hurd since it only supports +128-byte inodes. .TP .B \-j Create the file system with an ext3 journal. If the diff --git a/upstream/debian-bookworm/man8/mklost+found.8 b/upstream/debian-bookworm/man8/mklost+found.8 index 54e39f90..08799773 100644 --- a/upstream/debian-bookworm/man8/mklost+found.8 +++ b/upstream/debian-bookworm/man8/mklost+found.8 @@ -2,7 +2,7 @@ .\" Copyright 1993, 1994, 1995 by Theodore Ts'o. All Rights Reserved. .\" This file may be copied under the terms of the GNU Public License. .\" -.TH MKLOST+FOUND 8 "February 2023" "E2fsprogs version 1.47.0" +.TH MKLOST+FOUND 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME mklost+found \- create a lost+found directory on a mounted Linux second extended file system diff --git a/upstream/debian-bookworm/man8/net.8 b/upstream/debian-bookworm/man8/net.8 index 9296ccde..2083366c 100644 --- a/upstream/debian-bookworm/man8/net.8 +++ b/upstream/debian-bookworm/man8/net.8 @@ -2,12 +2,12 @@ .\" Title: net .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/05/2024 +.\" Date: 05/08/2024 .\" Manual: System Administration tools -.\" Source: Samba 4.19.4-Debian +.\" Source: Samba 4.19.6-Debian .\" Language: English .\" -.TH "NET" "8" "02/05/2024" "Samba 4\&.19\&.4\-Debian" "System Administration tools" +.TH "NET" "8" "05/08/2024" "Samba 4\&.19\&.6\-Debian" "System Administration tools" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/debian-bookworm/man8/resize2fs.8 b/upstream/debian-bookworm/man8/resize2fs.8 index 52c9e848..a2f50397 100644 --- a/upstream/debian-bookworm/man8/resize2fs.8 +++ b/upstream/debian-bookworm/man8/resize2fs.8 @@ -1,8 +1,8 @@ .\" -*- nroff -*- .\" Copyright 1997 by Theodore Ts'o. All Rights Reserved. .\" -.\" .TH RESIZE2FS 8 "February 2023" "E2fsprogs version 1.47.0" -.TH RESIZE2FS 8 "February 2023" "E2fsprogs version 1.47.0" +.\" .TH RESIZE2FS 8 "May 2024" "E2fsprogs version 1.47.1-rc2" +.TH RESIZE2FS 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME resize2fs \- ext2/ext3/ext4 file system resizer .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/rfkill.8 b/upstream/debian-bookworm/man8/rfkill.8 index 5d79d7f8..70826165 100644 --- a/upstream/debian-bookworm/man8/rfkill.8 +++ b/upstream/debian-bookworm/man8/rfkill.8 @@ -2,12 +2,12 @@ .\" Title: rfkill .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.18 -.\" Date: 2023-03-23 +.\" Date: 2024-03-28 .\" Manual: System Administration .\" Source: util-linux 2.38.1 .\" Language: English .\" -.TH "RFKILL" "8" "2023-03-23" "util\-linux 2.38.1" "System Administration" +.TH "RFKILL" "8" "2024-03-28" "util\-linux 2.38.1" "System Administration" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .ss \n[.ss] 0 diff --git a/upstream/debian-bookworm/man8/samba-dcerpcd.8 b/upstream/debian-bookworm/man8/samba-dcerpcd.8 index dbaa6d63..0bde22a0 100644 --- a/upstream/debian-bookworm/man8/samba-dcerpcd.8 +++ b/upstream/debian-bookworm/man8/samba-dcerpcd.8 @@ -2,12 +2,12 @@ .\" Title: samba-dcerpcd .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/05/2024 +.\" Date: 05/08/2024 .\" Manual: System Administration tools -.\" Source: Samba 4.19.4-Debian +.\" Source: Samba 4.19.6-Debian .\" Language: English .\" -.TH "SAMBA\-DCERPCD" "8" "02/05/2024" "Samba 4\&.19\&.4\-Debian" "System Administration tools" +.TH "SAMBA\-DCERPCD" "8" "05/08/2024" "Samba 4\&.19\&.6\-Debian" "System Administration tools" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- diff --git a/upstream/debian-bookworm/man8/samba-regedit.8 b/upstream/debian-bookworm/man8/samba-regedit.8 index 31477883..2eacfbca 100644 --- a/upstream/debian-bookworm/man8/samba-regedit.8 +++ b/upstream/debian-bookworm/man8/samba-regedit.8 @@ -2,12 +2,12 @@ .\" Title: samba-regedit .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/05/2024 +.\" Date: 05/08/2024 .\" Manual: System Administration tools -.\" Source: Samba 4.19.4-Debian +.\" Source: Samba 4.19.6-Debian .\" Language: English .\" -.TH "SAMBA\-REGEDIT" "8" "02/05/2024" "Samba 4\&.19\&.4\-Debian" "System Administration tools" +.TH "SAMBA\-REGEDIT" "8" "05/08/2024" "Samba 4\&.19\&.6\-Debian" "System Administration tools" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -365,7 +365,7 @@ In case you need more fine grained control you can use: .RE .SH "VERSION" .PP -This man page is part of version 4\&.19\&.4\-Debian of the Samba suite\&. +This man page is part of version 4\&.19\&.6\-Debian of the Samba suite\&. .SH "SEE ALSO" .PP \fBsmbd\fR(8), diff --git a/upstream/debian-bookworm/man8/samba-tool.8 b/upstream/debian-bookworm/man8/samba-tool.8 index 04679402..7f79efd1 100644 --- a/upstream/debian-bookworm/man8/samba-tool.8 +++ b/upstream/debian-bookworm/man8/samba-tool.8 @@ -2,12 +2,12 @@ .\" Title: samba-tool .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/05/2024 +.\" Date: 05/08/2024 .\" Manual: System Administration tools -.\" Source: Samba 4.19.4-Debian +.\" Source: Samba 4.19.6-Debian .\" Language: English .\" -.TH "SAMBA\-TOOL" "8" "02/05/2024" "Samba 4\&.19\&.4\-Debian" "System Administration tools" +.TH "SAMBA\-TOOL" "8" "05/08/2024" "Samba 4\&.19\&.6\-Debian" "System Administration tools" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -1869,7 +1869,7 @@ because the repsFrom/To objects are not replicated, and it can reveal replicatio Gives usage information\&. .SH "VERSION" .PP -This man page is complete for version 4\&.19\&.4\-Debian of the Samba suite\&. +This man page is complete for version 4\&.19\&.6\-Debian of the Samba suite\&. .SH "AUTHOR" .PP The original Samba software and related utilities were created by Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\&. diff --git a/upstream/debian-bookworm/man8/smbpasswd.8 b/upstream/debian-bookworm/man8/smbpasswd.8 index 4cad5d03..e4715baa 100644 --- a/upstream/debian-bookworm/man8/smbpasswd.8 +++ b/upstream/debian-bookworm/man8/smbpasswd.8 @@ -2,12 +2,12 @@ .\" Title: smbpasswd .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/> -.\" Date: 02/05/2024 +.\" Date: 05/08/2024 .\" Manual: System Administration tools -.\" Source: Samba 4.19.4-Debian +.\" Source: Samba 4.19.6-Debian .\" Language: English .\" -.TH "SMBPASSWD" "8" "02/05/2024" "Samba 4\&.19\&.4\-Debian" "System Administration tools" +.TH "SMBPASSWD" "8" "05/08/2024" "Samba 4\&.19\&.6\-Debian" "System Administration tools" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- @@ -314,7 +314,7 @@ file and neglecting to allow "localhost" access to the smbd\&. In addition, the smbpasswd command is only useful if Samba has been set up to use encrypted passwords\&. .SH "VERSION" .PP -This man page is part of version 4\&.19\&.4\-Debian of the Samba suite\&. +This man page is part of version 4\&.19\&.6\-Debian of the Samba suite\&. .SH "SEE ALSO" .PP \fBsmbpasswd\fR(5), diff --git a/upstream/debian-bookworm/man8/ss.8 b/upstream/debian-bookworm/man8/ss.8 index 073e9f03..e23af826 100644 --- a/upstream/debian-bookworm/man8/ss.8 +++ b/upstream/debian-bookworm/man8/ss.8 @@ -24,6 +24,9 @@ Output version information. .B \-H, \-\-no-header Suppress header line. .TP +.B \-Q, \-\-no-queues +Suppress sending and receiving queue columns. +.TP .B \-O, \-\-oneline Print each socket's data on a single line. .TP @@ -40,6 +43,10 @@ established connections) sockets. .B \-l, \-\-listening Display only listening sockets (these are omitted by default). .TP +.B \-B, \-\-bound-inactive +Display only TCP bound but inactive (not listening, connecting, etc.) sockets +(these are omitted by default). +.TP .B \-o, \-\-options Show timer information. For TCP protocol, the output format is: .RS @@ -419,6 +426,12 @@ to FILE after applying filters. If FILE is - stdout is used. Read filter information from FILE. Each line of FILE is interpreted like single command line option. If FILE is - stdin is used. .TP +.B \-\-bpf-maps +Pretty-print all the BPF socket-local data entries for each socket. +.TP +.B \-\-bpf-map-id=MAP_ID +Pretty-print the BPF socket-local data entries for the requested map ID. Can be used more than once. +.TP .B FILTER := [ state STATE-FILTER ] [ EXPRESSION ] Please take a look at the official documentation for details regarding filters. @@ -456,6 +469,9 @@ states except for - opposite to .B bucket +.B bound-inactive +- bound but otherwise inactive sockets (not listening, connecting, etc.) + .SH EXPRESSION .B EXPRESSION diff --git a/upstream/debian-bookworm/man8/tc-bfifo.8 b/upstream/debian-bookworm/man8/tc-bfifo.8 index 3e290322..bc05ef4d 100644 --- a/upstream/debian-bookworm/man8/tc-bfifo.8 +++ b/upstream/debian-bookworm/man8/tc-bfifo.8 @@ -37,8 +37,6 @@ If the list is too long, no further packets are allowed on. This is called 'tail limit Maximum queue size. Specified in bytes for bfifo, in packets for pfifo. For pfifo, defaults to the interface txqueuelen, as specified with -.BR ifconfig (8) -or .BR ip (8). The range for this parameter is [0, UINT32_MAX]. diff --git a/upstream/debian-bookworm/man8/tc-gact.8 b/upstream/debian-bookworm/man8/tc-gact.8 new file mode 100644 index 00000000..81aa30eb --- /dev/null +++ b/upstream/debian-bookworm/man8/tc-gact.8 @@ -0,0 +1,85 @@ +.TH "Generic actions in tc" 8 "11 Jan 2023" "iproute2" "Linux" + +.SH NAME +gact - generic action +.SH SYNOPSIS +.in +8 +.ti -8 +.BR tc " ... " "action gact" +.IR CONTROL " [ " RAND " ] [ " INDEX " ]" +.ti -8 +.IR CONTROL " := { " +.BR reclassify " | " drop " | " continue " | " pass " | " pipe " | " +.br +.BI "goto chain " "CHAIN_INDEX" +| +.br +.BI "jump " "JUMP_COUNT" +} + +.ti -8 +.IR RAND " := " +.BI random " RANDTYPE CONTROL VAL" +.ti -8 +.IR RANDTYPE " := { " +.BR netrand " | " determ " }" +.ti -8 +.IR VAL " := number not exceeding 10000" +.ti -8 +.IR JUMP_COUNT " := absolute jump from start of action list" +.ti -8 +.IR INDEX " := index value used" + +.SH DESCRIPTION +The +.B gact +action allows reclassify, dropping, passing, or accepting packets. +At the moment there are only two algorithms. One is deterministic +and the other uses internal kernel netrand. + +.SH OPTIONS +.TP +.BI random " RANDTYPE CONTROL VAL" +The probability of taking the action expressed in terms of 1 out of +.I VAL +packets. + +.TP +.I CONTROL +Indicate how +.B tc +should proceed if the packet matches. +For a description of the possible +.I CONTROL +values, see +.BR tc-actions (8). + +.SH EXAMPLES +Apply a rule on ingress to drop packets from a given source address. +.RS +.EX +# tc filter add dev eth0 parent ffff: protocol ip prio 6 u32 match ip src \ +10.0.0.9/32 flowid 1:16 action drop +.EE +.RE + +Allow 1 out 10 packets from source randomly using the netrand generator +.RS +.EX +# tc filter add dev eth0 parent ffff: protocol ip prio 6 u32 match ip src \ +10.0.0.9/32 flowid 1:16 action drop random netrand ok 10 +.EE +.RE + +Deterministically accept every second packet +.RS +.EX +# tc filter add dev eth0 parent ffff: protocol ip prio 6 u32 match ip src \ +10.0.0.9/32 flowid 1:16 action drop random determ ok 2 +.EE +.RE + +.SH SEE ALSO +.BR tc (8), +.BR tc-actions (8), +.BR tc-u32 (8) diff --git a/upstream/debian-bookworm/man8/tc-htb.8 b/upstream/debian-bookworm/man8/tc-htb.8 index 7aa62615..59b159fb 100644 --- a/upstream/debian-bookworm/man8/tc-htb.8 +++ b/upstream/debian-bookworm/man8/tc-htb.8 @@ -36,7 +36,7 @@ bytes .SH DESCRIPTION HTB allows control of the outbound bandwidth on a given link. -It allows simulating simulating several slower links and to send different +It allows simulating several slower links and to send different kinds of traffic on different simulated links. In both cases, you have to specify how to divide the physical link into simulated links and how to decide which simulated link to use for a given packet to be sent. diff --git a/upstream/debian-bookworm/man8/tc-matchall.8 b/upstream/debian-bookworm/man8/tc-matchall.8 index d0224066..538cf745 100644 --- a/upstream/debian-bookworm/man8/tc-matchall.8 +++ b/upstream/debian-bookworm/man8/tc-matchall.8 @@ -37,39 +37,39 @@ To create ingress mirroring from port eth1 to port eth2: .RS .EX -tc qdisc add dev eth1 handle ffff: ingress -tc filter add dev eth1 parent ffff: \\ +tc qdisc add dev eth1 handle ffff: clsact +tc filter add dev eth1 ingress \\ matchall skip_sw \\ action mirred egress mirror \\ dev eth2 .EE .RE -The first command creates an ingress qdisc with handle +The first command creates a clsact qdisc with handle .BR ffff: on device .BR eth1 where the second command attaches a matchall filters on it that mirrors the -packets to device eth2. +packets to device eth2 for ingress. To create egress mirroring from port eth1 to port eth2: .RS .EX -tc qdisc add dev eth1 handle 1: root prio -tc filter add dev eth1 parent 1: \\ +tc qdisc add dev eth1 handle ffff: clsact +tc filter add dev eth1 egress \\ matchall skip_sw \\ action mirred egress mirror \\ dev eth2 .EE .RE -The first command creates an egress qdisc with handle -.BR 1: -that replaces the root qdisc on device +The first command creates a clsact qdisc with handle +.BR ffff: +on device .BR eth1 where the second command attaches a matchall filters on it that mirrors the -packets to device eth2. +packets to device eth2 for egress. To sample one of every 100 packets flowing into interface eth0 to psample group 12: diff --git a/upstream/debian-bookworm/man8/tc-mirred.8 b/upstream/debian-bookworm/man8/tc-mirred.8 index 38833b45..6959e3e6 100644 --- a/upstream/debian-bookworm/man8/tc-mirred.8 +++ b/upstream/debian-bookworm/man8/tc-mirred.8 @@ -9,13 +9,24 @@ mirred - mirror/redirect action .I DIRECTION ACTION .RB "[ " index .IR INDEX " ] " -.BI dev " DEVICENAME" +.I TARGET .ti -8 .IR DIRECTION " := { " .BR ingress " | " egress " }" .ti -8 +.IR TARGET " := { " DEV " | " BLOCK " }" + +.ti -8 +.IR DEV " := " +.BI dev " DEVICENAME" + +.ti -8 +.IR BLOCK " := " +.BI blockid " BLOCKID" + +.ti -8 .IR ACTION " := { " .BR mirror " | " redirect " }" .SH DESCRIPTION @@ -24,6 +35,12 @@ The action allows packet mirroring (copying) or redirecting (stealing) the packet it receives. Mirroring is what is sometimes referred to as Switch Port Analyzer (SPAN) and is commonly used to analyze and/or debug flows. +When mirroring to a tc block, the packet will be mirrored to all the ports in +the block with exception of the port where the packet ingressed, if that port is +part of the tc block. Redirecting is similar to mirroring except that the +behaviour is to mirror to the first N - 1 ports in the block and redirect to the +last one (note that the port in which the packet arrived is not going to be +mirrored or redirected to). .SH OPTIONS .TP .B ingress @@ -39,7 +56,7 @@ Define whether the packet should be copied .RB ( mirror ) or moved .RB ( redirect ) -to the destination interface. +to the destination interface or block. .TP .BI index " INDEX" Assign a unique ID to this action instead of letting the kernel choose one @@ -49,14 +66,17 @@ is a 32bit unsigned integer greater than zero. .TP .BI dev " DEVICENAME" Specify the network interface to redirect or mirror to. +.TP +.BI blockid " BLOCKID" +Specify the tc block to redirect or mirror to. .SH EXAMPLES Limit ingress bandwidth on eth0 to 1mbit/s, redirect exceeding traffic to lo for debugging purposes: .RS .EX -# tc qdisc add dev eth0 handle ffff: ingress -# tc filter add dev eth0 parent ffff: u32 \\ +# tc qdisc add dev eth0 handle ffff: clsact +# tc filter add dev eth0 ingress u32 \\ match u32 0 0 \\ action police rate 1mbit burst 100k conform-exceed pipe \\ action mirred egress redirect dev lo @@ -70,8 +90,8 @@ with e.g. tcpdump: .EX # ip link add dummy0 type dummy # ip link set dummy0 up -# tc qdisc add dev eth0 handle ffff: ingress -# tc filter add dev eth0 parent ffff: protocol ip \\ +# tc qdisc add dev eth0 handle ffff: clsact +# tc filter add dev eth0 ingress protocol ip \\ u32 match ip protocol 1 0xff \\ action mirred egress mirror dev dummy0 .EE @@ -87,13 +107,21 @@ interface, it is possible to send ingress traffic through an instance of # modprobe ifb # ip link set ifb0 up # tc qdisc add dev ifb0 root sfq -# tc qdisc add dev eth0 handle ffff: ingress -# tc filter add dev eth0 parent ffff: u32 \\ +# tc qdisc add dev eth0 handle ffff: clsact +# tc filter add dev eth0 ingress u32 \\ match u32 0 0 \\ action mirred egress redirect dev ifb0 .EE .RE +.SH LIMITATIONS +The kernel restricts nesting to four levels to avoid the chance +of nesting loops. +.PP +Do not redirect for one IFB device to another. +IFB is a very specialized case of packet redirecting device. +Redirecting from ifbX->ifbY will cause all packets to be dropped. + .SH SEE ALSO .BR tc (8), .BR tc-u32 (8) diff --git a/upstream/debian-bookworm/man8/tc-pfifo_fast.8 b/upstream/debian-bookworm/man8/tc-pfifo_fast.8 index baf34b1d..0029d67f 100644 --- a/upstream/debian-bookworm/man8/tc-pfifo_fast.8 +++ b/upstream/debian-bookworm/man8/tc-pfifo_fast.8 @@ -27,8 +27,6 @@ have traffic, higher bands are never dequeued. This can be used to prioritize interactive traffic or penalize 'lowest cost' traffic. Each band can be txqueuelen packets long, as configured with -.BR ifconfig (8) -or .BR ip (8). Additional packets coming in are not enqueued but are instead dropped. @@ -40,8 +38,6 @@ for complete details on how TOS bits are translated into bands. txqueuelen The length of the three bands depends on the interface txqueuelen, as specified with -.BR ifconfig (8) -or .BR ip (8). .SH BUGS diff --git a/upstream/debian-bookworm/man8/tc-sfb.8 b/upstream/debian-bookworm/man8/tc-sfb.8 index e4584deb..1f2b8c5e 100644 --- a/upstream/debian-bookworm/man8/tc-sfb.8 +++ b/upstream/debian-bookworm/man8/tc-sfb.8 @@ -67,7 +67,7 @@ the number of non-responsive flows, M. It is (1 - (1 - (1 / 16.0)) ** M) **8, so for example with 10 non-responsive flows approximately 0.2% of responsive flows will be misidentified. -To mitigate this, SFB performs performs periodic re-hashing to avoid +To mitigate this, SFB performs periodic re-hashing to avoid misclassification for prolonged periods of time. The default hashing method will use source and destination ip addresses and port numbers diff --git a/upstream/debian-bookworm/man8/tc-simple.8 b/upstream/debian-bookworm/man8/tc-simple.8 index f565755e..ae1aec31 100644 --- a/upstream/debian-bookworm/man8/tc-simple.8 +++ b/upstream/debian-bookworm/man8/tc-simple.8 @@ -55,11 +55,11 @@ grep the logs to see the logged message display stats again and observe increment by 1 .EX - hadi@noma1:$ tc qdisc add dev eth0 ingress - hadi@noma1:$tc filter add dev eth0 parent ffff: protocol ip prio 5 \\ + $ tc qdisc add dev eth0 ingress + $ tc filter add dev eth0 parent ffff: protocol ip prio 5 \\ u32 match ip protocol 1 0xff flowid 1:1 action simple sdata "Incoming ICMP" - hadi@noma1:$ sudo tc -s filter ls dev eth0 parent ffff: + $ sudo tc -s filter ls dev eth0 parent ffff: filter protocol ip pref 5 u32 filter protocol ip pref 5 u32 fh 800: ht divisor 1 filter protocol ip pref 5 u32 fh 800::800 order 2048 key ht 800 bkt 0 flowid 1:1 @@ -71,7 +71,7 @@ display stats again and observe increment by 1 backlog 0b 0p requeues 0 - hadi@noma1$ ping -c 1 www.google.ca + $ ping -c 1 www.google.ca PING www.google.ca (74.125.225.120) 56(84) bytes of data. 64 bytes from ord08s08-in-f24.1e100.net (74.125.225.120): icmp_req=1 ttl=53 time=31.3 ms @@ -79,10 +79,10 @@ display stats again and observe increment by 1 1 packets transmitted, 1 received, 0% packet loss, time 0ms rtt min/avg/max/mdev = 31.316/31.316/31.316/0.000 ms - hadi@noma1$ dmesg | grep simple + $ dmesg | grep simple [135354.473951] simple: Incoming ICMP_1 - hadi@noma1$ sudo tc/tc -s filter ls dev eth0 parent ffff: + $ sudo tc/tc -s filter ls dev eth0 parent ffff: filter protocol ip pref 5 u32 filter protocol ip pref 5 u32 fh 800: ht divisor 1 filter protocol ip pref 5 u32 fh 800::800 order 2048 key ht 800 bkt 0 flowid 1:1 diff --git a/upstream/debian-bookworm/man8/tc-xt.8 b/upstream/debian-bookworm/man8/tc-xt.8 deleted file mode 100644 index f6dc5add..00000000 --- a/upstream/debian-bookworm/man8/tc-xt.8 +++ /dev/null @@ -1,42 +0,0 @@ -.TH "iptables action in tc" 8 "3 Mar 2016" "iproute2" "Linux" - -.SH NAME -xt - tc iptables action -.SH SYNOPSIS -.in +8 -.ti -8 -.BR tc " ... " "action xt \-j" -.IR TARGET " [ " TARGET_OPTS " ]" -.SH DESCRIPTION -The -.B xt -action allows one to call arbitrary iptables targets for packets matching the filter -this action is attached to. -.SH OPTIONS -.TP -.BI -j " TARGET \fR[\fI TARGET_OPTS \fR]" -Perform a jump to the given iptables target, optionally passing any target -specific options in -.IR TARGET_OPTS . -.SH EXAMPLES -The following will attach a -.B u32 -filter to the -.B ingress -qdisc matching ICMP replies and using the -.B xt -action to make the kernel yell 'PONG' each time: - -.RS -.EX -tc qdisc add dev eth0 ingress -tc filter add dev eth0 parent ffff: proto ip u32 \\ - match ip protocol 1 0xff \\ - match ip icmp_type 0 0xff \\ - action xt -j LOG --log-prefix PONG -.EE -.RE -.SH SEE ALSO -.BR tc (8), -.BR tc-u32 (8), -.BR iptables-extensions (8) diff --git a/upstream/debian-bookworm/man8/tc.8 b/upstream/debian-bookworm/man8/tc.8 index e5bef911..dce58af1 100644 --- a/upstream/debian-bookworm/man8/tc.8 +++ b/upstream/debian-bookworm/man8/tc.8 @@ -127,7 +127,7 @@ tc \- show / manipulate traffic control settings \fB[ \fB-nm \fR| \fB-nam\fR[\fIes\fR] \fB] \fR| \fB[ \fR{ \fB-cf \fR| \fB-c\fR[\fIonf\fR] \fR} \fB[ filename ] \fB] \fR \fB[ -t\fR[imestamp\fR] \fB\] \fR| \fB[ -t\fR[short\fR] \fR| \fB[ --o\fR[neline\fR] \fB]\fR } +-o\fR[neline\fR] \fB] \fR| \fB[ -echo ]\fR } .ti 8 .IR FORMAT " := {" @@ -743,6 +743,10 @@ When\fB\ tc monitor\fR\ runs, print timestamp before the event message in format When\fB\ tc monitor\fR\ runs, prints short timestamp before the event message in format: [<YYYY>-<MM>-<DD>T<hh:mm:ss>.<ms>] +.TP +.BR "\-echo" +Request the kernel to send the applied configuration back. + .SH FORMAT The show command has additional formatting options: @@ -871,6 +875,7 @@ was written by Alexey N. Kuznetsov and added in Linux 2.2. .BR tc-fq_codel (8), .BR tc-fq_pie (8), .BR tc-fw (8), +.BR tc-gact (8), .BR tc-hfsc (7), .BR tc-hfsc (8), .BR tc-htb (8), diff --git a/upstream/debian-bookworm/man8/tipc-nametable.8 b/upstream/debian-bookworm/man8/tipc-nametable.8 index b187d25e..f7c51f19 100644 --- a/upstream/debian-bookworm/man8/tipc-nametable.8 +++ b/upstream/debian-bookworm/man8/tipc-nametable.8 @@ -49,13 +49,13 @@ provided by a port. .B Lower .br The lower bound of the 32-bit instance field of the port name. -The instance field is often used as as a sub-class indicator. +The instance field is often used as a sub-class indicator. .TP .B Upper .br The upper bound of the 32-bit instance field of the port name. -The instance field is often used as as a sub-class indicator. +The instance field is often used as a sub-class indicator. A difference in .BR "lower " "and " upper means the socket is bound to the port name range [lower,upper] diff --git a/upstream/debian-bookworm/man8/tune2fs.8 b/upstream/debian-bookworm/man8/tune2fs.8 index 4b9d77af..c65aa178 100644 --- a/upstream/debian-bookworm/man8/tune2fs.8 +++ b/upstream/debian-bookworm/man8/tune2fs.8 @@ -2,7 +2,7 @@ .\" Initial revision .\" .\" -.TH TUNE2FS 8 "February 2023" "E2fsprogs version 1.47.0" +.TH TUNE2FS 8 "May 2024" "E2fsprogs version 1.47.1-rc2" .SH NAME tune2fs \- adjust tunable file system parameters on ext2/ext3/ext4 file systems .SH SYNOPSIS diff --git a/upstream/debian-bookworm/man8/uuidd.8 b/upstream/debian-bookworm/man8/uuidd.8 index 2cd45913..24adb660 100644 --- a/upstream/debian-bookworm/man8/uuidd.8 +++ b/upstream/debian-bookworm/man8/uuidd.8 @@ -2,12 +2,12 @@ .\" Title: uuidd .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.18 -.\" Date: 2023-03-23 +.\" Date: 2024-03-28 .\" Manual: System Administration .\" Source: util-linux 2.38.1 .\" Language: English .\" -.TH "UUIDD" "8" "2023-03-23" "util\-linux 2.38.1" "System Administration" +.TH "UUIDD" "8" "2024-03-28" "util\-linux 2.38.1" "System Administration" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .ss \n[.ss] 0 |