getopt: (usage) make the description of -U fit within 80 columns

(It is good practice to keep --help output from causing ugly
wrapped text when printed to a standard 80-column terminal.)

Signed-off-by: Benno Schulenberg <bensberg@telfort.nl>

tools: improve git-version-bump with validation and help

- Add --help option with usage information
- Validate script runs only on stable/vX.Y branches
- Validate version format (X.Y, X.Y.Z, X.Y-rcN, X.Y.Z-rcN)

Signed-off-by: Karel Zak <kzak@redhat.com>

tools: improve git-version-next to always output version variables

- Always output UL_NEXT_FINAL_RELEASE (previously only for RC releases)
- Add UL_LAST_FINAL_RELEASE for last stable (non-RC) release
- Remove _RAW variables from output for cleaner interface

The UL_NEXT_FINAL_RELEASE now represents the version that will be
released after code stabilization, while UL_LAST_FINAL_RELEASE
represents the last stable release without -rc suffix.

Signed-off-by: Karel Zak <kzak@redhat.com>

tools: add git-version-next script release versioning

- Only works on stable/* branches (releases are generated from stable branches)
- Supports util-linux versioning: vX.Y (major), vX.Y.Z (maintenance)
- Command-line options: --rc, --release-master, --release-update
- Safety check prevents --release-master on branches with existing releases
- Testing support via --last-release and --last-xy-release overrides

Version Schema:
  Major releases:      vX.Y-rc1, vX.Y-rc2, [vX.Y-rc3], vX.Y
  Maintenance releases: vX.Y.Z-rc1, vX.Y.Z

Signed-off-by: Karel Zak <kzak@redhat.com>

libblkid: Fix probe_ioctl_tp assigning BLKGETDISKSEQ as physical sector size

Fix issue introduced by PR#2908 in probe_ioctl_tp where the BLKGETDISKSEQ ioctl
result is incorrectly assigned to the topology with
blkid_topology_set_physical_sector_size instead of blkid_topology_set_diskseq.

This issue was observed while using a Debian 13 container on a RHEL 9.4 host
attempting to format a volume. The physical sector size was incorrectly
reported as 3. This issue also presents with the fdisk command,
which also uses this library to resolve physical sector size of devices.

Example fdisk output:
root@r94p121-PA:~ # fdisk --list /dev/sdb
Disk /dev/sdb: 90 GiB, 96636764160 bytes, 188743680 sectors
Units: sectors of 1 * 512 = 512 bytes
Sector size (logical/physical): 512 bytes / 3 bytes
I/O size (minimum/optimal): 512 bytes / 3 bytes

Strace of relevant ioctls:
ioctl(3, BLKALIGNOFF, [0])              = 0
ioctl(3, BLKIOMIN, [512])               = 0
ioctl(3, BLKIOOPT, [0])                 = 0
ioctl(3, BLKPBSZGET, [512])             = 0
ioctl(3, BLKGETDISKSEQ, [3])            = 0
ioctl(3, BLKSSZGET, [512])              = 0

blkid: correct an erroneous error message

Running `blkid -p -n no /dev/sda2` would report:

  blkid: error: -u <list> argument is empty

(Mentioning -u instead of -n, and falsely claiming emptiness.)

Now the above command will report:

  blkid: invalid argument: no

(I don't think option -n needs to be mentioned, as it will be obvious
when inspecting the command line.  Not mentioning the option allows
reusing an existing error message, avoiding needless ballooning and
allowing the patch to be applied to the stable branch.)

Signed-off-by: Benno Schulenberg <bensberg@telfort.nl>

Merge branch 'PR/column-wrap-separator' of https://github.com/karelzak/util-linux-work

* 'PR/column-wrap-separator' of https://github.com/karelzak/util-linux-work:
  column: add --wrap-separator option for custom text wrapping

Merge branch 'namespace-man-pages' of https://github.com/masatake/util-linux

* 'namespace-man-pages' of https://github.com/masatake/util-linux:
  nsenter,unshare: (man) add the NS-related commands to SEE ALSO

Merge branch 'lsfd--test-use-stat-Ld' of https://github.com/masatake/util-linux

* 'lsfd--test-use-stat-Ld' of https://github.com/masatake/util-linux:
  tests: (lsfd/column-source-btrfs) extract a minor number in a more reliable way

column: add --wrap-separator option for custom text wrapping

Add a new --wrap-separator option that allows users to specify custom
separator characters for text wrapping within table columns. When used
with --table-wrap, the separator is replaced with newlines to enable
wrapping at specific points rather than just by column width.

The implementation:
- Processes wrap separator replacement in modify_table() after column
  wrap flags are set
- Uses scols_cell_refer_memory() for data containing embedded nulls
- Enables scols_wrapzero_nextchunk for columns with wrapping enabled
- Only applies to columns that have the wrap flag set via --table-wrap

Example usage:
  $ echo -e 'Name:Desc\nJohn:A|software|dev' | \
column --table --separator ':' \
                       --table-wrap 2 --wrap-separator '|'
  Name  Desc
  John  A
        software
        dev

Fixes: https://github.com/util-linux/util-linux/issues/3739
Signed-off-by: Karel Zak <kzak@redhat.com>

findmnt: (usage) add a needed equals sign before an optional argument

The argument of --kernel is optional, so an '=' is required when an
argument is specified.

Also tweak the wording, and add a semicolon between two phrases.

Signed-off-by: Benno Schulenberg <bensberg@telfort.nl>

nsenter,unshare: (man) add the NS-related commands to SEE ALSO

The NS-related commands in util-linux complement each other.
Users should know them.

Signed-off-by: Masatake YAMATO <yamato@redhat.com>

tests: (lsfd/column-source-btrfs) extract a minor number in a more reliable way

This change fixes a potential bug in the test case.

The original code used the %d of stat command to extract the device minor
number for a file based on a wrong assumption. Use %Ld instead.

Signed-off-by: Masatake YAMATO <yamato@redhat.com>

Merge branch 'PR/libmount-fsconfig-nofail' of https://github.com/karelzak/util-linux-work

* 'PR/libmount-fsconfig-nofail' of https://github.com/karelzak/util-linux-work:
  libmount: don't report fsconfig errors with "nofail"

Merge branch 'PR/libfdisk-collision-report' of https://github.com/karelzak/util-linux-work

* 'PR/libfdisk-collision-report' of https://github.com/karelzak/util-linux-work:
  libfdisk: improve collision reporting

Merge branch 'PR/logger-stdin-overflow' of https://github.com/karelzak/util-linux-work

* 'PR/logger-stdin-overflow' of https://github.com/karelzak/util-linux-work:
  logger: fix buffer overflow when read stdin

libmount: don't report fsconfig errors with "nofail"

The new kernel API returns EINVAL on FSCONFIG_CMD_CREATE if the mount
source is inaccessible. We do not want to report this as an error when
the "nofail" mount option is specified.

Note that EINVAL may also be returned by other fsconfig() settings, so
we need to check whether a source is specified and whether it is really
inaccessible. This is just a heuristic (as with the old mount(2)).

Fixes: https://github.com/util-linux/util-linux/issues/3741
Signed-off-by: Karel Zak <kzak@redhat.com>

lscpu: New Arm C1 parts

Arm has announced the C1-Nano with a TRM here:
https://developer.arm.com/documentation/107753/latest

The C1-Pro with a TRM here:
https://developer.arm.com/documentation/107771/latest

The C1-Ultra with a TRM here:
https://developer.arm.com/documentation/108014/latest

The C1-Premium with a TRM here:
https://developer.arm.com/documentation/109416/latest

Signed-off-by: Jeremy Linton <jeremy.linton@arm.com>

sfdisk: (man) do not use the common 'include' for --help and --version

Anomalously, `sfdisk` uses -v for --version instead of the standard
uppercase -V.  In `sfdisk` -V means --verify.

This effectively reverts commit 82d0bfe59a from last week, and
adds a comment to try and prevent the mistake in the future.

CC: Mario Blättermann <mario.blaettermann@gmail.com>
Signed-off-by: Benno Schulenberg <bensberg@telfort.nl>

logger: fix buffer overflow when read stdin

$ perl -e 'print "<" . "0"x10240' | logger --prio-prefix
Segmentation fault (core dumped)

Signed-off-by: Karel Zak <kzak@redhat.com>

Merge branch 'PR/libfdisk-script-format' of https://github.com/karelzak/util-linux-work

* 'PR/libfdisk-script-format' of https://github.com/karelzak/util-linux-work:
  libfdisk: (script) improve separator usage in named-fields dump
  libfdisk: (script) fix device name separator parsing

rev: add --zero option to --help output

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

Merge branch 'fix/doc_list_columns_lscpu_man' of https://github.com/cgoesche/util-linux-fork

* 'fix/doc_list_columns_lscpu_man' of https://github.com/cgoesche/util-linux-fork:
  lscpu: (man) add description of the --list-columns option

Merge branch 'master' of https://github.com/mariobl/util-linux

* 'master' of https://github.com/mariobl/util-linux:
  Fix another issue in login.1.adoc
  sfdisk.8.adoc: Replace --help and --version with external entity
  Fix markup in pam_lastlog2.8.adoc
  Fix markup in column.1.adoc
  Fix markup in mount.8.adoc
  Fix typo and markup in getopt.1.adoc
  Fix markup in lsfd.1.adoc
  Fix markup, grammar and spelling in scols-filter.5.adoc
  Fix login.1.adoc

lscpu: Add NVIDIA Olympus arm64 core

Add an entry for NVIDIA Olympus arm64 core.

Signed-off-by: Matthew R. Ochs <mochs@nvidia.com>

libfdisk: improve collision reporting

In some cases, a collision occurs in the first sector. Creating a new
partition table overwrites this sector, but updating an existing table
does not. In the latter case, promising to wipe the collision is a
bug.

Because we cannot know whether the collision is expected (e.g., hybrid
or boot disks) or unintended, we inform the user and let them decide.
libfdisk can wipe the unwanted signature only when creating a new
partition table; otherwise, the user can use wipefs.

This commit introduces fdisk_is_collision_area(), an API to detect
where the collision occurs. The function is generic and not limited to
the first sector.

Fixes: https://github.com/util-linux/util-linux/issues/3659
Signed-off-by: Karel Zak <kzak@redhat.com>

lscpu: (man) add description of the --list-columns option

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

Fix another issue in login.1.adoc

sfdisk.8.adoc: Replace --help and --version with external entity

sfdisk.8.adoc still had the literal --help and --version options, in contrary to all other .adoc files, which have the man-common/help-version.adoc entity.

Fix markup in pam_lastlog2.8.adoc

Fix markup in column.1.adoc

Fix markup in mount.8.adoc

Fix typo and markup in getopt.1.adoc

Fix markup in lsfd.1.adoc

Fix markup, grammar and spelling in scols-filter.5.adoc

Fix login.1.adoc

Something went wrong in the last commit... Instead fixing markup issues, *login* went to an empty **.

hardlink: (man) add note note about ULFILEEQ_DEBUG=

Addresses: https://github.com/util-linux/util-linux/discussions/3323
Signed-off-by: Karel Zak <kzak@redhat.com>

Merge branch 'feat/lscpu_add_microcode_column' of https://github.com/cgoesche/util-linux-fork

* 'feat/lscpu_add_microcode_column' of https://github.com/cgoesche/util-linux-fork:
  bash-completion: add MICROCODE to $OPTS_ALL
  lscpu: add MICROCODE output column

libfdisk: (script) improve separator usage in named-fields dump

Ensure that name=value pairs are separated by commas.

Signed-off-by: Karel Zak <kzak@redhat.com>

libfdisk: (script) fix device name separator parsing

In the named-fields script format, the colon is used as the separator
between the device name and other values. The device name may also
contain colons. This commit ensures it is treated as a separator only
when there is a space before or after the colon.

Note that the device name is optional and may be omitted. There is no
escaping for problematic characters in the name. Use " : " as the
separator.

Fixes: https://github.com/util-linux/util-linux/issues/3723
Signed-off-by: Karel Zak <kzak@redhat.com>

Merge branch 'fix/fix_lsns_list_columns_opt' of https://github.com/cgoesche/util-linux-fork

* 'fix/fix_lsns_list_columns_opt' of https://github.com/cgoesche/util-linux-fork:
  bash-completion: (lsns) add -H/--list-columns options
  lsns: fix --list-columns option

Signed-off-by: Karel Zak <kzak@redhat.com>

Merge branch 'feat/allow_killing_with_pidfd' of https://github.com/cgoesche/util-linux-fork

* 'feat/allow_killing_with_pidfd' of https://github.com/cgoesche/util-linux-fork:
  textual: rename list_colunms() to list_columns() and remove trailing whitespaces
  include/strutils: add missing header guard comment
  lib: fix bad indentation in meson.build
  kill: add support for race-free process kills using pidfd inodes

Merge branch 'feat/add_columns_env_ls_cmds' of https://github.com/cgoesche/util-linux-fork

* 'feat/add_columns_env_ls_cmds' of https://github.com/cgoesche/util-linux-fork:
  lscpu: (man) document the LSCPU_{CACHES_}COLUMNS environment variables
  bash-completion: (lscpu) add -H/--list-columns options
  lscpu: add --list-columns option and declutter --help output
  lscpu: add support for LSCPU_{CACHES_}COLUMNS environment variables
  lsclocks: add support for LSCLOCKS_COLUMNS environmental variable
  tests: (lsmem) update expected/lscpu/* with 'ZONES' column
  lsmem: add support for LSMEM_COLUMNS environmental variable

Merge branch 'feat/lslocks_output_env' of https://github.com/cgoesche/util-linux-fork

* 'feat/lslocks_output_env' of https://github.com/cgoesche/util-linux-fork:
  lslocks: (man) add LSLOCKS_COLUMNS description in new ENVIRONMENT section
  lslocks: add support for LSLOCKS_COLUMNS environmental variable

Merge branch 'PR/libmount-canonicalize-cleanup' of https://github.com/karelzak/util-linux-work

* 'PR/libmount-canonicalize-cleanup' of https://github.com/karelzak/util-linux-work:
  lib/canonicalize: use ul_ prefix
  lib/canonicalize: introduce generic drop-permission caller
  meson: cleanup tests to use libcommon.la
  autotools: cleanup tests to use libcommon.la
  tests: add canonicalize test
  lib/canonicalize: refactor canonicalize_path()
  lib/canonicalize: rename to ul_absolute_path()

textual: rename list_colunms() to list_columns() and remove trailing whitespaces

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

include/strutils: add missing header guard comment

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

lib: fix bad indentation in meson.build

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

kill: add support for race-free process kills using pidfd inodes

The 6.9 Linux kernel added support for pidfds which introduces inodes
that stay unique for the system lifetime and can be used to reference
a process with both its traditional pid and pid fd inode number.
This enables race-free killing of processes and protects from false
referencing due to pid rollovers.

This patch adds a new way of addressing processes with the format
'pid:pidfd_inode'. When the new format is used, 'kill' assumes the user wishes
to use a pidfd to signal a process, and will therefore use pidfd_* routines
to complete the task if the provided inode matches the one from a previously
acquired pidfd.

Addresses: #3252
Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

bash-completion: add MICROCODE to $OPTS_ALL

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

lscpu: add MICROCODE output column

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

bash-completion: (lsns) add -H/--list-columns options

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

lsns: fix --list-columns option

This patch makes it so that we continue parsing all CLI options even
when we find -H/--list-columns. Therefore we don't miss any format
specifying options, namely --json and --raw, and print the columns
in the desired form.

Closes: #3725
Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

lscpu: (man) document the LSCPU_{CACHES_}COLUMNS environment variables

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

bash-completion: (lscpu) add -H/--list-columns options

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

lscpu: add --list-columns option and declutter --help output

This moves the list of available columns from the --help output
to the '--list-columns' option and makes the usage information
more readable.

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

lscpu: add support for LSCPU_{CACHES_}COLUMNS environment variables

This provides alternate ways of specifying output columns similar
to the '--parse', '--extended' and '--caches' options.

Addresses: #2816
Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

lsclocks: add support for LSCLOCKS_COLUMNS environmental variable

This provides an alternate way to specify output columns similar
to the --output option.

Addresses: #2816
Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

tests: (lsmem) update expected/lscpu/* with 'ZONES' column

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

lsmem: add support for LSMEM_COLUMNS environmental variable

This provides an alternate way to specify output columns similar
to the --output option.

Addresses: #2816
Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

lslocks: (man) add LSLOCKS_COLUMNS description in new ENVIRONMENT section

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

lslocks: add support for LSLOCKS_COLUMNS environmental variable

This provides an alternate way to specify output columns similar
to the --output option.

Addresses: #2816
Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

fallocate: update FALLOC_FL_WRITE_ZEROES

Update to Zhang Yi's latest version of the patch.

Unfortunately, I missed that he was still working on it (it was sent
to the kernel mailing lists rather than the util-linux mailing list).

Signed-off-by: Karel Zak <kzak@redhat.com>

lib/canonicalize: use ul_ prefix

Signed-off-by: Karel Zak <kzak@redhat.com>

lib/canonicalize: introduce generic drop-permission caller

* add ul_restricted_path_oper() to fileutils.c

* use it as backed for canonicalize_path_restricted()

Signed-off-by: Karel Zak <kzak@redhat.com>

meson: cleanup tests to use libcommon.la

This change simplifies future test work.

Signed-off-by: Karel Zak <kzak@redhat.com>

autotools: cleanup tests to use libcommon.la

This change simplifies future test work.

Signed-off-by: Karel Zak <kzak@redhat.com>

tests: add canonicalize test

* add canonicalize_path_restricted() to test_canonicalize program

* add test for root and non-root (but suid) user

Signed-off-by: Karel Zak <kzak@redhat.com>

Merge branch 'master' of https://github.com/mariobl/util-linux

* 'master' of https://github.com/mariobl/util-linux:
  Fix markup in pam_lastlog2.8.adoc
  Fix markup in ll2_import_lastlog.3.adoc
  Fix markup in more.1.adoc
  Fix markup in column.1.adoc
  Fix markup in mesg.1.adoc
  Fix markup in unshare.1.adoc
  Fix markup in swapon.8.adoc
  Fix typos and markup in setpriv.1.adoc
  Fix markup in lsirq.1.adoc
  Fix markup in flock.1.adoc
  Fix markup in chmem.8.adoc
  Fix markup in lastlog2.8.adoc
  Fix markup in findmnt.8.adoc
  Fix markup in su.1.adoc
  Fix markup in login.1.adoc
  Fix markup in scols-filter.5.adoc

Merge branch 'lsfd--no-hypertext' of https://github.com/masatake/util-linux

* 'lsfd--no-hypertext' of https://github.com/masatake/util-linux:
  lsfd: revise the code disabling hyperlinks

Merge branch 'zramctl-max_comp_streams_fix' of https://github.com/mentha/util-linux

* 'zramctl-max_comp_streams_fix' of https://github.com/mentha/util-linux:
  zramctl: ignore ENOENT when setting max_comp_streams

Merge branch 'fix/findmnt_output_regression' of https://github.com/cgoesche/util-linux-fork

* 'fix/findmnt_output_regression' of https://github.com/cgoesche/util-linux-fork:
  findmnt: add missing newline in --raw, --pair and --list output formats

Merge branch 'man-ipcrm' of https://github.com/PrasannaPaithankar/util-linux

* 'man-ipcrm' of https://github.com/PrasannaPaithankar/util-linux:
  man: Fixed incorrect ipcrm options

Merge branch 'feat/improve_umount_bash_comp' of https://github.com/cgoesche/util-linux-fork

* 'feat/improve_umount_bash_comp' of https://github.com/cgoesche/util-linux-fork:
  bash-completion: add fallback to filename expansion for umount

lsfd: revise the code disabling hyperlinks

In the original code, the code was at file.c.  This change lifts up
the code to upper layer.  As a result the fill_column method of struct
file becomes simple.

As a side effect. this change disables hyperlinks for the entries of
UNKN type (e.g. eventpool, or pidfd). This is a bug fix.

Signed-off-by: Masatake YAMATO <yamato@redhat.com>

Fix markup in pam_lastlog2.8.adoc

Fix markup in ll2_import_lastlog.3.adoc

Fix markup in more.1.adoc

Fix markup in column.1.adoc

Fix markup in mesg.1.adoc

Fix markup in unshare.1.adoc

Fix markup in swapon.8.adoc

Fix typos and markup in setpriv.1.adoc

Fix markup in lsirq.1.adoc

Fix markup in flock.1.adoc

Fix markup in chmem.8.adoc

Fix markup in lastlog2.8.adoc

Fix markup in findmnt.8.adoc

Fix markup in su.1.adoc

Fix markup in login.1.adoc

Fix markup in scols-filter.5.adoc

zramctl: ignore ENOENT when setting max_comp_streams

The `max_comp_streams` attribute of zram devices has been deprecated and
all writes were silently ignored by the kernel since 2016. It was
finally removed in 6.15, causing zramctl to fail on ENOENT, when it
should just ignore the error.

Signed-off-by: Jiang XueQian <jiangxueqian@gmail.com>

findmnt: add missing newline in --raw, --pair and --list output formats

Addresses: #3711
Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

man: Fixed incorrect ipcrm options

Signed-off-by: Prasanna Paithankar <paithankarprasanna@gmail.com>

Merge branch 'zfs-reflinks' of https://github.com/lordcheeto/util-linux

* 'zfs-reflinks' of https://github.com/lordcheeto/util-linux:
  Add reflink support for ZFS.

lib/canonicalize: refactor canonicalize_path()

 * introduce do_canonicalize() with proper return values

 * use do_canonicalize() everywhere

Signed-off-by: Karel Zak <kzak@redhat.com>

bash-completion: add fallback to filename expansion for umount

If the user defined path can not be found in the mount table
fallback to simple filename expansion.

Addresses: #1333
Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

Add reflink support for ZFS.

OpenZFS has added the block cloning feature, which implements reflinks for its copy-on-write filesystem. It is now stable and enabled by default on OpenZFS 2.3.0.

getopt: add member posixly_correct to struct getopt_control

Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>

getopt: add feature to ignore unknown options

This feature addition will add the '-U' and '--unknown' options
It'll allow getopt to ignore unknown options and leave them untouched.
Additionally, it will surpress any error messages generated by getopt(3).

Addresses: #701
Signed-off-by: Christian Goeschel Ndjomouo <cgoesc2@wgu.edu>