tuptime(1)

1TUPTIME(1)                       Linux Manual                       TUPTIME(1)
2
3
4

NAME

6       tuptime  -  Report  historical and statistical real time of the system,
7       keeping it between restarts. Total uptime.
8
9

SYNOPSIS

11       tuptime [-h] [-A STARTUP] [-b] [-c] [-d  DATETM_FORMAT]  [-e  DECIMALS]
12       [-f  FILE] [-g] [-i] [-k] [-l] [-n] [-o TYPE] [-p] [--pctl [1-99]] [-r]
13       [-s] [-S STARTUP] [-t] [--tat TIMESTAMP] [--tsince TIMESTAMP] [--tuntil
14       TIMESTAMP] [-U STARTUP] [-v] [-V] [-x]
15
16

DESCRIPTION

18       Tuptime  report  historical  and  statistical  real time of the system,
19       keeping it between restarts. Indeed, it can:
20              - Count system startups
21              - Register first boot time (a.k.a. installation time)
22              - Count nicely and accidentally shutdowns
23              - Uptime and downtime percentage since first boot time
24              - Accumulated system uptime (running and sleeping), downtime and
25              total
26              - Register used kernels and boot IDs
27              - Report current uptime
28              - Print formatted table or list with the system history
29              - Narrow reports since, until or at a given startup or timestamp
30              - Output in csv format
31
32

OPTIONS

34   ARGUMENTS
35       -h | --help                 Show this help message and exit
36       -A | --at STARTUP           Limit to this startup number
37       -b | --bootid               Show boot identifier
38       -c | --csv                  Output in csv format
39       -d | --date DATETM_FORMAT   Datetime/timestamp format output
40       -e | --dec DECIMALS         Number of decimals in percentages
41       -f | --file FILE            Database file (file path)
42       -g | --graceful             Register a graceful shutdown
43       -i | --invert               Startup number in reverse count
44       -k | --kernel               Show kernel version
45       -l | --list                 Enumerate system life as list
46       -n | --noup                 Avoid update values into DB
47       -o | --order TYPE           Order  enumerate  by [u|r|s|e|d|k] (u = up‐
48                                   time | r = runtime | s = sleep time |  e  =
49                                   end status | d = downtime | k = kernel)
50       -p | --power                Show power states run + sleep
51       --pctl [1-99]               Show percentile number applied over average
52       -r | --reverse              Reverse order in list or table output
53       -s | --seconds              Output time in seconds and epoch
54       -S | --since STARTUP        Limit from this startup number
55       -t | --table                Enumerate system life as table
56       --tat TIMESTAMP             Report system status at specific timestamp
57       --tsince TIMESTAMP          Limit from this epoch timestamp
58       --tuntil TIMESTAMP          Limit until this epoch timestamp
59       -U | --until STARTUP        Limit up until this startup number
60       -v | --verbose              Verbose output
61       -V | --version              Show version
62       -x | --silent               Update values into DB without output
63
64   ENVIRONMENT
65       TUPTIME_DBF
66              Set an alternative database file path. The argument -f, --filedb
67              takes precedence over this.
68
69

DEFAULT OUTPUT

71       System startups:
72              Total number of  system  startups  from  since  first  timestamp
73              available.
74
75       System shutdowns:
76              Total number of shutdowns done correctly or incorrectly.
77
78       System life:
79              Time counter since first startup timestamp available.
80
81       System uptime:
82       System downtime:
83              Percentage of time and time counter.
84
85       Average uptime:
86       Average downtime:
87              Time counter with the average time.
88
89       Current uptime:
90              Actual  time  counter  and  datetime since registered boot time‐
91              stamp.
92
93

EXAMPLES

95       tuptime
96              Default output.
97
98       tuptime -t
99              Enumerate system life as table.
100
101       tuptime -l
102              Enumerate system life as list.
103
104       tuptime -k
105              Add kernel information to the output.
106
107       tuptime --csv
108              Report in csv format.
109
110       tuptime -s
111              Change default human readable datetime/timestamp style and print
112              times in seconds and datetimes in epoch.
113
114       tuptime -d '%H:%M:%S %m-%d-%Y'
115              Change  the datetime/timestamp format. By default the output use
116              the configured system locales.
117
118       tuptime --tsince -31557600
119              Report since one year ago.
120
121

FILES

123       /etc/cron.d/tuptime
124              Scheduled cron file.
125
126       /etc/init.d/tuptime
127              Init file.
128
129       /lib/systemd/system/tuptime.service
130              Systemd service unit file.
131
132       /usr/bin/tuptime
133              Main and only executable file.
134
135       /usr/share/doc/tuptime/
136              Directory with multiple documentation files.
137
138       /usr/share/doc/tuptime/examples/tuptime-cron.timer
139              Optional .timer unit for use instead of cron.
140
141       /usr/share/doc/tuptime/examples/tuptime-cron.service
142              Optional .service unit required by tuptime-cron.timer
143
144       /usr/share/man/man1/tuptime.1
145              Manual page.
146
147

AUTHOR

157       Ricardo Fraile <rfraile@rfraile.eu>
158
159

COPYRIGHT

161       Copyright (C) 2021 by Ricardo F. All Rights Reserved.
162
163       This product is distributed in the hope that it  will  be  useful,  but
164       WITHOUT  any  warranty;  without  even  the  implied  warranty  of MER‐
165       CHANTABILITY or FITNESS for a particular purpose.
166
167
168
1695.1.0                              Jan 2022                         TUPTIME(1)