Merge branch 'bash-completion-command-lsblk' of https://github.com/akinomyoga/util-linux

* 'bash-completion-command-lsblk' of https://github.com/akinomyoga/util-linux:
  bash-completion: use "command ls" instead of "\ls"
  bash-completion: prefix "command" to other external commands
  bash-completion: prefer "builtin cd" to "cd" to avoid aliases
  bash-completion: prefer "command lsblk" to "lsblk" to avoid aliases

treewide: replace postal address in license specifier with a terse URL

This brings the license specifier into the internet age.

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

docs: stop the copyright verbiage from getting included in the POT file

For some reason the asciidoc parser from `po4a` includes *all* comments
from an adoc file into the util-linux-man.pot file.  Xgettext had a way
to include only certain comments, but `po4a` does not appear to have a
dedicated mechanism for this.

So... use some bricolage: insert a fruitless 'ifdef' as a barrier
between the copyright/license comment and the title line.  This
prevents `po4a` from seeing the two things as belonging together.

This shrinks the util-linux-man.pot file by 1267 lines (2.5%),
equivalent to nearly 67kB (4.8%).

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

docs: make the "po4a:" line the first line, like in all other .adoc files

Also, there should be no space before "po4a:" for the line to be valid.

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

correct the full name of the GPL in various files

Last year, commit f4cb44bd11 corrected the full name of the GPL in
a dozen files, but still left the mistaken name in eight places.

(Also, in the first file, just reshuffle the license line, to be
in the same position as in other files.)

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

remove "Copyright (C) ...." notes from files that claim no copyright

Replace them with a "Written by" or "Authors:" label.

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

remove two leftover license lines from colors.{c,h}

Last March, commit 549a517857 replaced the SPDX line in three files
with a "No copyright is claimed" phrase, but forgot to remove from
two of those files the text lines that correspond to the SPDX.

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

nsenter: (man) improve descriptions for some options

Signed-off-by: Martin Joerg <martin.joerg@gmail.com>

lsclocks: (man) list supported clock types

Document the different types of clocks that are supported by lsclocks(1).

Signed-off-by: Thomas Weißschuh <thomas@t-8ch.de>

bash-completion: use "command ls" instead of "\ls"

The backslash quoting can be used to bypass aliases, but it cannot be
used to bypass shell functions for interactive uses defined by the
users.  We can use "command ls" instead to bypass both aliases and
shell functions.

bash-completion: prefix "command" to other external commands

bash-completion: prefer "builtin cd" to "cd" to avoid aliases

The command "cd" is also often aliased, so we should use "builtin cd"
to make sure to use the built-in version of "cd".

Merge branch 'cachestat' of https://github.com/teknoraver/util-linux

* 'cachestat' of https://github.com/teknoraver/util-linux:
  add option to force cachestat() usage

Merge branch 'PR/Benno-28May' of https://github.com/karelzak/util-linux-work

* 'PR/Benno-28May' of https://github.com/karelzak/util-linux-work:
  textual: harmonize the wording of the error message for an invalid PID
  colrm: make two error messages actually say that something is wrong
  lib/strutils: call gettext() only when argument of --hyperlink is invalid
  lib/colors: call gettext() only when the argument of --color is invalid

Merge branch 'existing' of https://github.com/teknoraver/util-linux

* 'existing' of https://github.com/teknoraver/util-linux:
  fix typo: exciting -> existing

bash-completion: prefer "command lsblk" to "lsblk" to avoid aliases

The user may define an alias lsblk to specify the default formatting,
such as -T, which would conflict with lsblk -r used in the Bash
completion settings. In the Bash completion settings, to prevent the
calls of lsblk -r ... from being replaced with lsblk -T -r ... and
failing, lsblk should be called using command lsblk.

libblkid: Add scoutfs filesystem.

The scoutfs filesystem is maintained out-of-tree, but current enough
that we want to submit it for inclusion in libblkid - there's a few
users out there that would benefit from being able to have lsblk aid in
diagnosing and identifying.

For more information about scoutfs, visit the github page here:
   https://github.com/versity/scoutfs

Test images are provided for both data and meta devices. These were
taken from validation samples.

The wiper is set to only wipe a minute part of the filesystem -
basically only the superblock. This is adequately destructive.

Signed-off-by: Auke Kok <auke.kok@versity.com>

fix typo: exciting -> existing

add option to force cachestat() usage

When cachestat() is not available, mmap() and fincore() are used to get
cache statistics.
This fallback returns less data than cachestat, and potentially hides
read errors by reporting that the file is all mapped in memory:

$ fincore /usr/bin/java
fincore: failed to do cachestat: /usr/bin/java: Operation not permitted
  RES PAGES   SIZE FILE
 208K    13 198,1K /usr/bin/java
$ echo $?
0
$ sudo fincore /usr/bin/java
RES PAGES   SIZE FILE
 0B     0 198,1K /usr/bin/java

Add a --cachestat argument which forces cachestat usage and fails if
it's not available:

$ fincore -C /usr/bin/java
fincore: failed to do cachestat: /usr/bin/java: Operation not permitted
$ echo $?
1

Also, on huge files the fallback is very slow and memory consuming,
so this flag can be user to avoid doing it by mistake.

Merge branch 'patch-1' of https://github.com/Zephkek/util-linux

* 'patch-1' of https://github.com/Zephkek/util-linux:
  Update bufflen
  Update setpwnam.c

textual: harmonize the wording of the error message for an invalid PID

Having four different forms for the same basic message is unneeded.

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

colrm: make two error messages actually say that something is wrong

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

lib/strutils: call gettext() only when argument of --hyperlink is invalid

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

lib/colors: call gettext() only when the argument of --color is invalid

Instead of calling gettext() before starting to interpret the argument
of option -L/--color, call it only when it's needed: when the argument
is not recognized.

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

Merge branch 'PR/Benno-23May' of https://github.com/karelzak/util-linux-work

* 'PR/Benno-23May' of https://github.com/karelzak/util-linux-work:
  hardlink: (man,usage) sort the options mostly alphabetically
  hardlink: (usage) improve the descriptions of three options
  hardlink: (usage) remove mistaken period from two option descriptions
  hexdump: (man) put a list item on a single line, to avoid a warning

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

* 'PR/libmount-verity-deinit' of https://github.com/karelzak/util-linux-work:
  libmount: (verity) use messages API for important errors
  libmount: (verity) use messages API for dlopen errors
  libmount: (verity) fix compiler warning
  libmount: (verity) fix deinitialization

Merge branch 'total' of https://github.com/teknoraver/util-linux

* 'total' of https://github.com/teknoraver/util-linux:
  fincore: add option to show a grand total

hardlink: (man,usage) sort the options mostly alphabetically

Also, improve some markup and wording and grammar.

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

hardlink: (usage) improve the descriptions of three options

The first description was too wordy for a --help text, the second
was vague and seemed to imply that it should be combined with the
preceding option, and the third failed to mention that it doesn't
actually link anything.

(Note: the choice for -m for --maximize and -M for --minimize is
unfortunate, as most people would guess the opposite, especially
since -s is used for --minimum-size and -S for --maximum-size.)

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

hardlink: (usage) remove mistaken period from two option descriptions

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

hexdump: (man) put a list item on a single line, to avoid a warning

Asciidoctor annoyingly warned for every translation that
unindented content was added to a list item.  Avoid this
by not breaking the list item into two lines.

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

AUTHORS: update Zhenwei Pi email

I will be leaving ByteDance so updating my email in AUTHORS to my
personal email.

Signed-off-by: zhenwei pi <pizhenwei@bytedance.com>

libmount: (verity) use messages API for important errors

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

libmount: (verity) use messages API for dlopen errors

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

libmount: (verity) fix compiler warning

libmount/src/hook_veritydev.c: In function 'setup_veritydev':
libmount/src/hook_veritydev.c:457:13: warning: '%s' directive argument is null [-Wformat-overflow=]

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

libmount: (verity) fix deinitialization

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

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

* 'master' of https://github.com/formtapez/util-linux:
  fix sectors typos

Merge branch 'PR/lsblk-pttype' of https://github.com/karelzak/util-linux-work

* 'PR/lsblk-pttype' of https://github.com/karelzak/util-linux-work:
  lsblk: use ID_PART_ENTRY_SCHEME as fallback for PTTYPE

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

* 'PR/AT_SECURE' of https://github.com/karelzak/util-linux-work:
  treewide: improve getauxval(AT_SECURE) usage
  lib/env, ...: use getauxval(AT_SECURE) for SUID check

Update bufflen

Update buflen

lsfd/mkfds-foreign-sockets: skip when lacking sock_diag ability

The ENDPOINTS will need sock_diag ability. The kernel might not
enable related configs. Check and skip in case of lacking such ability.

Fixes: https://github.com/util-linux/util-linux/issues/3590
Signed-off-by: Chen Qi <Qi.Chen@windriver.com>

fix sectors typos

fincore: add option to show a grand total

Similarly to `du`, add a --total option to produce a grand total
of the files analyzed.

Signed-off-by: Matteo Croce <teknoraver@meta.com>

Update setpwnam.c

Merge branch 'xry111/loongarch-isa-linux-6-12' of https://github.com/xry111/util-linux

* 'xry111/loongarch-isa-linux-6-12' of https://github.com/xry111/util-linux:
  lscpu: Fix loongarch op-mode output with recent kernel

lsblk: use ID_PART_ENTRY_SCHEME as fallback for PTTYPE

The udev database typically inherits the ID_PART_TABLE_TYPE property
from the entire disk device to its partitions. However, in some cases,
this property may be missing. Fortunately, blkid/udev also provides
ID_PART_ENTRY_SCHEME for all partitions.

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

lscpu: Fix loongarch op-mode output with recent kernel

Since Linux-6.12, the "loongarch32" item in the ISA field is separated
to "loongarch32r" and "loongarch32s," breaking our expectation.

Link: https://git.kernel.org/torvalds/c/34e3c4500cdc
Signed-off-by: Xi Ruoyao <xry111@xry111.site>

uuidgen.1.adoc: remove superfluous 'plus'

Likely copy-paste mistake from the --time flag

Merge branch 'login_fix' of https://github.com/echoechoin/util-linux

* 'login_fix' of https://github.com/echoechoin/util-linux:
  login: (adoc) add a description about LOGIN_SHELL_FALLBACK
  login: using an avaiable shell while logging in.

fincore: add recursive directory scanning

Add a --recursive flag to fincore which allows to recursively scan
directories.

Co-authored-by: Karel Zak <kzak@redhat.com>
Signed-off-by: Matteo Croce <teknoraver@meta.com>

login: (adoc) add a description about LOGIN_SHELL_FALLBACK

treewide: improve getauxval(AT_SECURE) usage

Let's enhance portability and readability slightly.

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

Merge branch 'at_secure' of https://github.com/MaxKellermann/util-linux into PR/AT_SECURE

* 'at_secure' of https://github.com/MaxKellermann/util-linux:
  lib/env, ...: use getauxval(AT_SECURE) for SUID check

lscpu: fix possible buffer overflow in cpuinfo parser

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

lib/shells: fix indentation

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

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

* 'master' of https://github.com/shashank-mahadasyam/util-linux:
  bash-completion: (chrt) add completion for -e/--ext
  chrt: (man) add SCHED_EXT
  tests: add chrt SCHED_EXT test
  chrt: add support for SCHED_EXT

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

* 'PR/add_ul_prefix' of https://github.com/karelzak/util-linux-work:
  treewide: add ul_ to parse_timestamp() function name
  treewide: add ul_ to parse_switch() function name
  treewide: add ul_ to parse_size() function name
  treewide: add ul_  to parse_range() function name

Merge branch 'only-_exit-in-shlib' of https://github.com/crrodriguez/util-linux

* 'only-_exit-in-shlib' of https://github.com/crrodriguez/util-linux:
  Do not call exit() on code ending in shared libraries

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

* 'master' of https://github.com/stanislav-brabec/util-linux:
  libblkid: Fix crash while parsing config with libeconf

tests/ts/kill/decode: avoid using shell built-in kill command

This test case should do the same as other kill test cases, avoiding
using shell built-in kill command.

Signed-off-by: Chen Qi <Qi.Chen@windriver.com>

shells.c: call setusershell before getusershell

Do not call exit() on code ending in shared libraries

It is not cool to call atexit() handlers of unknown
applications from shared libraries, use _exit instead.

Signed-off-by: Cristian Rodríguez <cristian@rodriguez.im>

libblkid: Fix crash while parsing config with libeconf

As the whole econf_file structure is freed by econf_free(file) at the end
of blkid_read_config(), econf_file structure cannot be defined as static
and initialized only once. The econf_free() is not robust enough and keeps
a pointer to the garbage after the first call of blkid_read_config(). And
if /etc/blkid.conf does not exist, it is called second time.

Signed-off-by: Stanislav Brabec <sbrabec@suse.cz>
Cc: Stefan Schubert <schubi@suse.de>
Link: https://bugzilla.opensuse.org/show_bug.cgi?id=1242705

bash-completion: (chrt) add completion for -e/--ext

chrt's -e/--ext corresponds to the SCHED_EXT scheduling policy,
which, for the purposes of bash completion, behaves just like
--other, --idle, and --batch

Signed-off-by: Shashank Balaji <shashank.mahadasyam@sony.com>

chrt: (man) add SCHED_EXT

Signed-off-by: Shashank Balaji <shashank.mahadasyam@sony.com>

tests: add chrt SCHED_EXT test

Signed-off-by: Shashank Balaji <shashank.mahadasyam@sony.com>

chrt: add support for SCHED_EXT

SCHED_EXT lets processes be scheduled by a BPF program-defined
scheduler. This is supported since kernel version 6.12.

Signed-off-by: Shashank Balaji <shashank.mahadasyam@sony.com>

logger: drop pointless bitfields

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

treewide: add ul_ to parse_timestamp() function name

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

treewide: add ul_ to parse_switch() function name

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

treewide: add ul_ to parse_size() function name

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

treewide: add ul_  to parse_range() function name

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

Merge branch 'PR/PATH-consolidate' of https://github.com/karelzak/util-linux-work

* 'PR/PATH-consolidate' of https://github.com/karelzak/util-linux-work:
  setpriv: follow /etc/login.defs for PATH
  su: use logindefs_setenv_path()
  login: use logindefs_setenv_path()
  logindefs: Add function to set PATH

Merge branch 'PR/login-su-TERM' of https://github.com/karelzak/util-linux-work

* 'PR/login-su-TERM' of https://github.com/karelzak/util-linux-work:
  setpriv: protect COLORTERM and NO_COLOR env. variables
  su: protect COLORTERM and NO_COLOR env. variables
  login: protect COLORTERM and NO_COLOR env. variables

Merge branch 'PR/mount-hint-tty' of https://github.com/karelzak/util-linux-work

* 'PR/mount-hint-tty' of https://github.com/karelzak/util-linux-work:
  mount: check for stdout for fstab reload hint

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

* 'PR/libmount-escape' of https://github.com/karelzak/util-linux-work:
  libmount: add function to remove escaped chars

lib/env, ...: use getauxval(AT_SECURE) for SUID check

Comparing effective and real uid/gid is not a proper way to check for
SUID execution:

1. this does not consider file capabilities

2. this check breaks when NO_NEW_PRIVS is used as the Linux kernel
   resets effective ids during execve(); this means the check is
   false, but the process still has raised capabilities

For more details about the NO_NEW_PRIVS problem, check this post and
the surrounding thread:

 https://lore.kernel.org/lkml/20250509184105.840928-1-max.kellermann@ionos.com/

Signed-off-by: Max Kellermann <max.kellermann@ionos.com>

login: using an avaiable shell while logging in.

setpriv: protect COLORTERM and NO_COLOR env. variables

The patch also replaces set/get env with ul_env_list to protect
variables.

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

setpriv: follow /etc/login.defs for PATH

The patch also cleans up the --reset-env description in the man page.

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

su: use logindefs_setenv_path()

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

login: use logindefs_setenv_path()

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

logindefs: Add function to set PATH

Let's avoid duplicate code in su() and login(1).

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

su: protect COLORTERM and NO_COLOR env. variables

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

login: protect COLORTERM and NO_COLOR env. variables

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

mount: check for stdout for fstab reload hint

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

Merge branch 'ci/openwrt-mips' of https://github.com/t-8ch/util-linux

* 'ci/openwrt-mips' of https://github.com/t-8ch/util-linux:
  ci: build on MIPS
  ci: add OpenWRT subtarget to matrix name

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

* 'PR/parse_switch' of https://github.com/karelzak/util-linux-work:
  fix and add parse_switch() test
  strutils: move an error message to where it is used, and improve it
  irqtop: use standard 'always/never' arguments instead of 'enable/disable'

libmount: add function to remove escaped chars

Follow-up: 8a69fa852dd5f41f8456756d18bfac6d8208219f https://github.com/util-linux/util-linux/pull/3541
Signed-off-by: Karel Zak <kzak@redhat.com>

Merge branch 'PR/bits-build' of https://github.com/karelzak/util-linux-work

* 'PR/bits-build' of https://github.com/karelzak/util-linux-work:
  bits: only build when cpu_set_t is available

Merge branch 'PR/Benno-29Apr' of https://github.com/karelzak/util-linux-work

* 'PR/Benno-29Apr' of https://github.com/karelzak/util-linux-work:
  po-man: add hyperlink.adoc to po4a.cfg
  docs,usage: harmonize description of --hyperlink, and add 2 missing ones
  pipesz: report default size in --help, instead of referring the user
  lsfd: improve grammar, and use angular brackets around placeholder word
  uuidd: put an option and its description in a single message
  pipesz: (man) improve the markup and some wordings
  irqtop: make the wording of an error message identical to that of another
  unshare: make the wording of a message identical to that of three others

Merge branch 'PR/hardlink-logging' of https://github.com/karelzak/util-linux-work

* 'PR/hardlink-logging' of https://github.com/karelzak/util-linux-work:
  hardlink: define more function as inline
  hardlink: fix performance regression (inefficient signal evaluation)
  hardlink: Use macro for verbose output

fix and add parse_switch() test

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

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

* 'master' of https://github.com/echoechoin/util-linux:
  strutils.c: ignore escape characters while parsing options.

strutils: move an error message to where it is used, and improve it

Calling gettext() is somewhat costly: it has to find the given message
among the more than five thousand messages in util-linux's repertoire.
So, call gettext() only when the message actually gets printed.

Besides, allowing to customize the error message for parse_switch() was
a nice gesture, but it's unneeded: a fixed error message is good enough.

Also, "argument error" was rather vague, as it doesn't say _what_ the
error is.  Better say "unsupported argument".

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

irqtop: use standard 'always/never' arguments instead of 'enable/disable'

Most other util-linux tools that accept the option argument "auto"
additionally accept "always" and "never", not "enable" / "disable".

So, make option --cpu-stat accept those standard words (besides the
deviant ones), and adjust the documentation to use the standard words.

Furthermore, make --cpu-stat accept also "on", "off", "yes", "no",
"1", and "0", to allow the user to use shorter words.  The per-CPU
stats can now be suppressed with a succinct: `irqtop -c0`.

CC: Zhenwei Pi <pizhenwei@bytedance.com>
Signed-off-by: Benno Schulenberg <bensberg@telfort.nl>

bits: only build when cpu_set_t is available

Doesn't build on macOS.

Fixes: 6e1301d59 ("text-utils: add bits command")
Signed-off-by: Alyssa Ross <hi@alyssa.is>

po-man: add hyperlink.adoc to po4a.cfg

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

docs,usage: harmonize description of --hyperlink, and add 2 missing ones

Harmonize the description by placing the option in a separate file.

Also, use _when_/<when> (instead of _mode_/<mode>) as the optional
argument, since the possible values are: "always", "never", "auto".

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

pipesz: report default size in --help, instead of referring the user

The man page says where this default size can be found.  In the --help
text it is more useful to directly say what this default size is.

CC: Nathan Sharp <nwsharp@live.com>
Signed-off-by: Benno Schulenberg <bensberg@telfort.nl>