Manpage logo

lsclocks - display system clocks

NAME  SYNOPSIS  DESCRIPTION  OPTIONS  OUTPUT COLUMNS  AUTHORS  SEE ALSO  REPORTING BUGS  AVAILABILITY 

NAME

lsclocks − display system clocks

SYNOPSIS

lsclocks [option]

DESCRIPTION

lsclocks is a simple command to display system clocks.

It allows to display information like current time and resolution of clocks like CLOCK_MONOTONIC, CLOCK_REALTIME and CLOCK_BOOTTIME.

OPTIONS

−J, −−json

Use JSON output format.

−n, −−noheadings

Don’t print headings.

−o, −−output list

Specify which output columns to print. See the OUTPUT COLUMNS section for details of available columns.

−−output−all

Output all columns.

−r, −−raw

Use raw output format.

−r, −−time clock

Show current time of one specific clock.

−−no−discover−dynamic

Do not try to discover dynamic clocks.

−d, −−dynamic−clock path

Also display specified dynamic clock. Can be specified multiple times.

−−no−discover−rtc

Do not try to discover RTCs.

−x, −−rtc path

Also display specified RTC. Can be specified multiple times.

−c, −−cpu−clock pid

Also display CPU clock of specified process. Can be specified multiple times.

−h, −−help

Display help text and exit.

−V, −−version

Display version and exit.

OUTPUT COLUMNS

Each column has a type. Types are surround by < and >.

TYPE <string>

Clock type.

ID <number>

Numeric clock ID.

CLOCK <string>

Name in the form CLOCK_

NAME <string>

Shorter, easier to read name.

TIME <number>

Current clock timestamp as returned by clock_gettime().

ISO_TIME <string>

ISO8601 formatted version of TIME.

RESOL_RAW <number>

Clock resolution as returned by clock_getres(2).

RESOL <number>

Human readable version of RESOL_RAW.

REL_TIME <string>

TIME time formatted as time range.

NS_OFFSET <number>

Offset of the current namespace to the parent namespace as read from /proc/self/timens_offsets.

AUTHORS

Thomas WeiÃschuh <thomas@t−8ch.de>

SEE ALSO

clock_getres(2) clock_gettime(2)

REPORTING BUGS

For bug reports, use the issue tracker <https://github.com/util−linux/util−linux/issues>.

AVAILABILITY

The lsclocks command is part of the util−linux package which can be downloaded from Linux Kernel Archive <https://www.kernel.org/pub/linux/utils/util−linux/>.


Updated 2026-06-01 - jenkler.se | uex.se