LSCLOCKS

Section: User Commands (1)
Updated: 202-0-04
Index Return to Main Contents

---

 

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. Different kinds of clocks are supported.

* POSIX clocks: CLOCK_MONOTONIC, CLOCK_REALTIME, CLOCK_BOOTTIME, etc.

* CPU clocks: clock_getcpuclockid(3).

* PTP clocks: /dev/ptp0.

* RTC clocks: /dev/rtc0.

* Auxiliary clocks: CLOCK_AUX0, CLOCK_AUX1, etc.

 

OPTIONS

-J, --json

Use JSON output format.

-n, --noheadings

Doncqt 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.

-t, --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.

 

ENVIRONMENT

LSCLOCKS_COLUMNS=

Specifies a comma-separated list of output columns to print. All columns listed in OUTPUT COLUMNS can be used.

LIBSMARTCOLS_DEBUG=all

enables libsmartcols debug output.

LIBSMARTCOLS_DEBUG_PADDING=on

use visible padding characters.

LIBSMARTCOLS_JSON=compact|lines

Controls JSON output format when using --json. Supported values are compact for JSON output with minimal whitespace, and lines for JSON Lines format (one JSON object per line). If unset or set to any other value, pretty-printed JSON is used.

 

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(2).

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

 

SEE ALSO

clock_getres(2) clock_gettime(2)  

REPORTING BUGS

For bug reports, use the https://github.com/uti-linux/uti-linux/issues <L>issue tracker  

AVAILABILITY

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

---

 

Index

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

ENVIRONMENT

OUTPUT COLUMNS

AUTHORS

SEE ALSO

REPORTING BUGS

AVAILABILITY