hexdump: Add missing section header in man page

fadvise: Fix markup in man page

mount: Fix markup and typos in man page

fstab: Fix markup in man page

uuidd: Fix markup in man page (uuidd.8)

lsfd: Fix typos in man page

lsclocks: Fix markup and typos in man page

hardlink: Fix markup in man page

sfdisk: Fix markup in man page

autotools: add missing dist_noinst_DATA

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

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

* 'patch-15' of https://github.com/mariobl/util-linux:
  man: Add enosys and lsclocks to po4a.cfg

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

* 'patch-14' of https://github.com/mariobl/util-linux:
  lsclocks: Fix markup in man page

Merge branch 'wipefs/improvements' of https://github.com/t-8ch/util-linux

* 'wipefs/improvements' of https://github.com/t-8ch/util-linux:
  wipefs: allow storage of backups in specific location
  wipefs: (tests) remove necessity of root permissions

Merge branch 'PR/dmesg-timestamps' of github.com:karelzak/util-linux-work

* 'PR/dmesg-timestamps' of github.com:karelzak/util-linux-work:
  Dividing tests into subtest based on recommendation from review
  util-linux/sys-utils test dmesg support for additional human-readable timestamp
  dmesg: man and coding style changes
  dmesg: support for additional human readable timestamp

hwclock: Improve set error in the face of jitter

set_hardware_clock_exact() spins in a loop, trying to exit when we are
`delay` seconds from an integer time on the system clock. However, there
might be jitter which causes an exit a little bit later than ideal.

The prior code could cause a relatively small error in loop exit time to
produce a relatively large error in the RTC.

For example, suppose upon exit from the loop, we have:

    sethwtime=1704239206
    refsystime=1704239206.000000
    nowsystime=1704239206.500372
    delay=0.5

In this case, the error is very small: 0.000372. However, we will
compute:

    newhwtime = 1704239206 + ceil(0.500371 - 0.5) = 1704239207

And in slightly less than `delay` seconds, the system clock will be
1704239207 while the RTC will be approximately 1704239208, about 1
second of error.

We are better off rounding in this case. The RTC will be behind the
system clock, but only very slightly:

    newhwtime = 1704239206 + round(0.500371 - 0.5) = 1704239206

I find passing `--ul-debug 0xffff` readily produces the original issue.

Signed-off-by: Eric Badger <ebadger@purestorage.com>

libmount: reduce utab.lock permissions

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

libmount: introduce /run/mount/utab.event

The mnt_monitor_...() API uses /run/mount/utab.lock to monitor utab
changes. The same file is used to control access to the utab file.

The utab can be updated more than once during one mount(8) call, for
example, one update is done in /sbin/mount.nfs and next in mount(8).
This situation triggers two (e.g. inotify) events when monitoring is
based on the lock file.

It seems better to introduce separate file to trigger the event and do
not trigger this event in /sbin/mount.<type> helpers.

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

libmount: add mnt_context_within_helper() wrapper

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

logger: make sure path is terminated [coverity scan]

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

man: Add enosys and lsclocks to po4a.cfg

lsclocks: Fix markup in man page

wipefs: allow storage of backups in specific location

This also avoids cluttering the home directory during test execution.

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

wipefs: (tests) remove necessity of root permissions

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

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

* 'fixes' of https://github.com/t-8ch/util-linux:
  libmount: (context) avoid dead store
  libmount: (utils) avoid dead store
  pipesz: avoid dead store
  fileeq: optimize size of ul_fileeq_method
  sha1: properly wipe variables
  libfdisk: (sgi): use strncpy over strcpy
  libfdisk: (sun) properly initialize partition data
  libmount: (tests) fix --filesystems crash on invalid argument
  libmount: (tests) fix --filesystems test argument parsing
  libmount: (veritydev) use asprintf to build string
  libsmartcols: (samples/fromfile) properly handle return value from getline()
  libuuid: (test_uuid) make reading UUIDs from file more robust
  libblkid: (dev) use strdup to duplicate string
  pg: use snprintf to build string
  hexdump: use xasprintf to build string
  readprofile: use xasprintf to build string
  cal: avoid out of bound write
  logger: use strncpy instead of strcpy
  exec_shell: use xasprintf
  strv: make strv_new_api static

libblkid: (bcachefs) add support for superblock at end of disk

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

libblkid: (bcachefs) add support for 2nd superblock at 2MiB

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

wipefs: (tests) add test for all detected signatures

This is useful to validate that multiple signatures were detected.
Use it for bcachefs, as that prober will gain support for backup
superblocks.

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

libblkid: (bcachefs) compare against offset from idmag

A future patch will introduce more superblock locations which need to
use their matching superblock location.

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

libblkid: introduce helper to get offset for idmag

As idmag->kboff can be negative to refer to an offset from the end of
the device, introduce a helper so probers don't have to worry about this
detail.

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

libmount: (context) avoid dead store

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

libmount: (utils) avoid dead store

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

pipesz: avoid dead store

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

fileeq: optimize size of ul_fileeq_method

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

sha1: properly wipe variables

Dead stores may very well be optimized away.

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

libfdisk: (sgi): use strncpy over strcpy

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

libfdisk: (sun) properly initialize partition data

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

libmount: (tests) fix --filesystems crash on invalid argument

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

libmount: (tests) fix --filesystems test argument parsing

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

libmount: (veritydev) use asprintf to build string

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

libsmartcols: (samples/fromfile) properly handle return value from getline()

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

libuuid: (test_uuid) make reading UUIDs from file more robust

Instead of relying on fixed width entries, read line-by-line.

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

libblkid: (dev) use strdup to duplicate string

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

pg: use snprintf to build string

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

hexdump: use xasprintf to build string

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

readprofile: use xasprintf to build string

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

cal: avoid out of bound write

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

logger: use strncpy instead of strcpy

This is not strictly necessary but better style.

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

exec_shell: use xasprintf

It removes an unbounded strcpy and makes the code shorter and clearer.

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

strv: make strv_new_api static

It is never used outside of strv.c.

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

Merge branch 'wdctl/timeout-condition' of https://github.com/t-8ch/util-linux

* 'wdctl/timeout-condition' of https://github.com/t-8ch/util-linux:
  wdctl: properyl test timeout conditions

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

* 'patch-12' of https://github.com/mariobl/util-linux:
  Update po4a.cfg to assign exch.1 correctly to misc-utils
  exch: Add man page to po4a.cfg to make it translatable

Merge branch 'fallocate/warning' of https://github.com/t-8ch/util-linux

* 'fallocate/warning' of https://github.com/t-8ch/util-linux:
  fdisk: guard posix variable

exch: use NULL rather than zero

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

Merge branch 'exch/options' of https://github.com/t-8ch/util-linux

* 'exch/options' of https://github.com/t-8ch/util-linux:
  build-sys: fail build for untracked files
  gitignore: ignore exch
  exch: properly terminate options array

Merge branch 'logger-wrong-typo' of https://github.com/chentooerl/util-linux

* 'logger-wrong-typo' of https://github.com/chentooerl/util-linux:
  Fix typo: octen -> octet

login: unify pw_shell script test

At first, a blank in pw_shell is sufficient to assume that the user
login shell is actually a shell script.

If execution fails, the test consists of testing argv[0] for "/bin/sh"
which is set in case of shell script.

But "/bin/sh" can also be the actual login shell set for the user.
If execution fails, the error message erroneously talks about a shell
script.

Keep a boolean variable around to perform the test exactly once to
have a precise error message.

Signed-off-by: Tobias Stoeckmann <tobias@stoeckmann.org>

login: simplify name creation

The function xasprintf is simpler to handle than calling xstrncpy
and xstrdup for the same task.

Introduced buff variable to make the whole else-block look like the
if-block.

Signed-off-by: Tobias Stoeckmann <tobias@stoeckmann.org>

wdctl: properyl test timeout conditions

Fixes #2660

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

Update po4a.cfg to assign exch.1 correctly to misc-utils

exch: Add man page to po4a.cfg to make it translatable

fdisk: guard posix variable

Otherwise it can generate a unused variable warning.

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

Dividing tests into subtest based on recommendation from review

Signed-off-by: Rishabh Thukral <rthukral@arista.com>

util-linux/sys-utils test dmesg support for additional human-readable timestamp

This commit adds tests for new functionality in dmesg to support multiple timestamp formats.
The user can specify multiple timestamp formats with --time-format option and dmesg prints all the logs with desired timestamp formats in the sequence of user-provided formats.

This test verifies that output contains multiple formats in the sequence of input and it also tests for the special case where the user specifies delta format along with either ctime or raw.

Signed-off-by: Rishabh Thukral <rthukral@arista.com>

build-sys: fail build for untracked files

All build artifacts should be covered by a gitignore entry.
Validate that at build-time.

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

gitignore: ignore exch

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

build-sys: (tests) validate that time_t is 64bit

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

meson: try to always use 64bit time support on glibc

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

build-sys: try to always use 64bit time support on glibc

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

build-sys: backport autoconf year2038 macros

Backported from 2.72e which is a release candidate for the final 2.72
release.

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

tests: add sysinfo to show sizeof(time_t)

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

tests: constify a sysinfo helpers struct

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

exch: properly terminate options array

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

Fix typo: octen -> octet

lsclocks: refer to correct lsclocks(1) manpage

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

exch: fix typo

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

docs: move Copyright in boilerplate.c

Let's keep it in order

SPDX-License-Identifier
License block
Copyright
command description

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

build-sys: add --disable-exch

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

exch: cosmetic changes

* use the same license header as in other utuls
* make sure SYS_renamea2 defined
* small change to usage()

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

exch: new command exchaging two files atomically

An example session:

$ echo A > a
$ echo B > b
$ ./exch a b
$ cat a
B
$ cat b
A

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

Merge branch 'fix-getsz-verbose-output' of https://github.com/calestyo/util-linux

* 'fix-getsz-verbose-output' of https://github.com/calestyo/util-linux:
  blockdev: add missing verbose output for --getsz

libsmartcols: fix typo in comment

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

Merge branch 'PR/libsmartcols-cell-data' of github.com:karelzak/util-linux-work

* 'PR/libsmartcols-cell-data' of github.com:karelzak/util-linux-work:
  libsmartcols: fix memory leak on filter parser error
  libsmartcols: free after error in filter sample
  libsmartcols: make cell data printing more robust

gitignore: ignore setpgid binary

Signed-off-by: Christian Göttsche <cgzones@googlemail.com>

libsmartcols: fix memory leak on filter parser error

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

libsmartcols: free after error in filter sample

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

libsmartcols: make cell data printing more robust

* use zero terminated data in continuous sample

* don't call strlen() for empty strings

* make sure library check for data size during printing

  Unfortunately, previous library versions support cell data buffer
  update without inform library about a change.

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

libsmartcols: (tests) add test for continuous json output

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

libsmartcols: only recognize closed object as final element

When streaming JSON normal values also have indent == 1.
For those however it is incorrect to close the stream.

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

libsmartcols: flush correct stream

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

libsmartcols: drop spourious newline in between streamed JSON objects

scols_table_print_range() already appends a newline correctly.

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

blockdev: add missing verbose output for --getsz

Signed-off-by: Christoph Anton Mitterer <mail@christoph.anton.mitterer.name>

dmesg: man and coding style changes

* add note about delta time to the man page
* make the latest changes to the code less talkative

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

dmesg: support for additional human readable timestamp

The dmesg logs have timestamps in seconds since boot format which can
be converted to other formats. However, there is no option to include
both the original timestamp as present in the buffer along with the
converted timestamp in the specified format.

This change updates the --time-format option in dmesg to enable the
user to specify it multiple times with different formats with each
input providing a timestamp format among the currently supported
choices. This enables seeing the dmesg logs in both seconds since boot
and human readable format simultaneously in each row of the log output.
The sequence of timestamp format follows the order
in which the user provides the desired formats.

Signed-off-by: Rishabh Thukral <rthukral@arista.com>

Merge branch 'dmesg/kmsg-file' of https://github.com/t-8ch/util-linux

* 'dmesg/kmsg-file' of https://github.com/t-8ch/util-linux:
  dmesg: support reading kmsg format from file

Merge branch 'dmesg/tests' of https://github.com/t-8ch/util-linux

* 'dmesg/tests' of https://github.com/t-8ch/util-linux:
  dmesg: use symbolic defines for second conversions
  dmesg: add support for reserved and local facilities
  dmesg: (tests) validate json output
  dmesg: only write one message to json
  jsonwrt: add ul_jsonwrt_value_s_sized
  dmesg: open-code LOG_MAKEPRI
  dmesg: correctly print all supported facility names
  dmesg: error out instead of silently ignoring force_prefix

dmesg: support reading kmsg format from file

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

setpriv: add landlock support

landlock [0] is a Linux stackable LSM that can be used by unprivileged
processes to build a sandbox around them.

With support for landlock in setpriv users can easily construct a
sandbox on-the-fly when executing programs.

[0] https://landlock.io/

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

sys-utils: cleanup license lines, add SPDX

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

dmesg: use symbolic defines for second conversions

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

dmesg: add support for reserved and local facilities

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