lsclocks(1) — Linux manual page


LSCLOCKS(1)                   User Commands                  LSCLOCKS(1)

NAME         top

       lsclocks - display system clocks

SYNOPSIS         top

       lsclocks [option]

DESCRIPTION         top

       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

OPTIONS         top

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

       -r, --raw
           Use raw output format.

       -r, --time clock
           Show current time of one specific clock.

           Do not try to discover dynamic clocks.

       -d, --dynamic-clock path
           Also display specified dynamic clock. Can be specified
           multiple times.

           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
           Print version and exit.

OUTPUT COLUMNS         top

       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         top

       Thomas Weißschuh <>

SEE ALSO         top

       clock_getres(2) clock_gettime(2)

REPORTING BUGS         top

       For bug reports, use the issue tracker at

AVAILABILITY         top

       The lsclocks command is part of the util-linux package which can
       be downloaded from Linux Kernel Archive
       <>. This page
       is part of the util-linux (a random collection of Linux
       utilities) project. Information about the project can be found at
       ⟨⟩. If you have
       a bug report for this manual page, send it to This page was obtained from the
       project's upstream Git repository
       ⟨git://⟩ on
       2024-06-14. (At that time, the date of the most recent commit
       that was found in the repository was 2024-06-10.) If you discover
       any rendering problems in this HTML version of the page, or you
       believe there is a better or more up-to-date source for the page,
       or you have corrections or improvements to the information in
       this COLOPHON (which is not part of the original manual page),
       send a mail to

util-linux 2.41.devel-537-e... 2024-01-28                    LSCLOCKS(1)