summaryrefslogtreecommitdiffstats
path: root/misc-utils/lsclocks.1.adoc
blob: 12a425bf32dc2959d78688b89ef1c882cf0ab432 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
//po4a: entry man manual
= lsclocks(1)
:doctype: manpage
:man manual: User Commands
:man source: util-linux {release-version}
:page-layout: base
:command: lsclocks

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

include::man-common/help-version.adoc[]

== 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

mailto:thomas@t-8ch.de[Thomas Weißschuh]

== SEE ALSO

*clock_getres*(2) *clock_gettime*(2)

include::man-common/bugreports.adoc[]

include::man-common/footer.adoc[]

ifdef::translation[]
include::man-common/translation.adoc[]
endif::[]