From: FeRD (Frank Dana) Date: Mon, 9 May 2022 11:32:44 +0000 (-0400) Subject: hardlink: Move reflink options in manpage X-Git-Tag: v2.39-rc1~664^2~2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=2d16e519c53c17b3f8708ab9812e45d89b5ba50c;p=thirdparty%2Futil-linux.git hardlink: Move reflink options in manpage The documentation for the --reflink and --skip-reflink options felt sort of shoe-horned into the rest of the options, in the man page. Reorder to match where they appear in the --help output. Signed-off-by: FeRD (Frank Dana) --- diff --git a/misc-utils/hardlink.1.adoc b/misc-utils/hardlink.1.adoc index 3503d4c2bb..f83a855bed 100644 --- a/misc-utils/hardlink.1.adoc +++ b/misc-utils/hardlink.1.adoc @@ -56,21 +56,6 @@ Crypto API is not available. The methods based on checksums are implemented in zero-copy way, in this case file contents are not copied to the userspace and all calculation is done in kernel. -*--reflink*[=_when_]:: -Create copy-on-write clones (aka reflinks) rather than hardlinks. The reflinked files -share only on-disk data, but the file mode and owner can be different. It's recommended -to use it with *--ignore-owner* and *--ignore-mode* options. This option implies -*--skip-reflinks* to ignore already cloned files. -+ -The optional argument _when_ can be *never*, *always*, or *auto*. If the _when_ argument -is omitted, it defaults to *auto*, in this case, *hardlink* checks filesystem type and -uses reflinks on BTRFS and XFS only, and fallback to hardlinks when creating reflink is impossible. -The argument *always* disables filesystem type detection and fallback to hardlinks, in this case, -only reflinks are allowed. - -*--skip-reflinks*:: -Ignore already cloned files. This option may be used without *--reflink* when creating classic hardlinks. - *-f*, *--respect-name*:: Only try to link files with the same (base)name. It's strongly recommended to use long options rather than *-f* which is interpreted in a different way by other *hardlink* implementations. @@ -89,6 +74,21 @@ Consider only file content, not attributes, when determining whether two files a *-X*, *--respect-xattrs*:: Only try to link files with the same extended attributes. +*--reflink*[=_when_]:: +Create copy-on-write clones (aka reflinks) rather than hardlinks. The reflinked files +share only on-disk data, but the file mode and owner can be different. It's recommended +to use it with *--ignore-owner* and *--ignore-mode* options. This option implies +*--skip-reflinks* to ignore already cloned files. ++ +The optional argument _when_ can be *never*, *always*, or *auto*. If the _when_ argument +is omitted, it defaults to *auto*, in this case, *hardlink* checks filesystem type and +uses reflinks on BTRFS and XFS only, and fallback to hardlinks when creating reflink is impossible. +The argument *always* disables filesystem type detection and fallback to hardlinks, in this case, +only reflinks are allowed. + +*--skip-reflinks*:: +Ignore already cloned files. This option may be used without *--reflink* when creating classic hardlinks. + *-m*, *--maximize*:: Among equal files, keep the file with the highest link count.