1TUPTIME(1) Linux Manual TUPTIME(1)
2
6 tuptime - Report historical and statistical real time of the system,
7 keeping it between restarts. Total uptime.
8
11 tuptime [-h] [-A STARTUP] [-b] [-c] [-d DATETIME_FMT] [-e DECIMALS] [-E
12 STARTUP] [-f FILE] [-g] [-i] [-k] [-l] [-n] [-o TYPE] [-p] [-q] [-r]
13 [-s] [-S STARTUP] [-t] [--tat TIMESTAMP] [--tsince TIMESTAMP] [--tuntil
14 TIMESTAMP] [-U STARTUP] [-v] [-V]
15
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
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 DATETIME_FMT Datetime/timestamp format output
40 -e | --dec DECIMALS Number of decimals in percentages
41 -E | --exclude STARTUP Startup numbers to exclude
42 -f | --file FILE Database file (file path)
43 -g | --graceful Register a graceful shutdown
44 -i | --invert Startup number in reverse count | swich be‐
45 tween longest/shortest on default output
46 -k | --kernel Show kernel version
47 -l | --list Enumerate system life as list
48 -n | --noup Avoid update values into DB
49 -o | --order TYPE Order enumerate by [u|r|s|e|d|k] (u = uptime
50 | r = runtime | s = sleep time | e = end
51 status | d = downtime | k = kernel)
52 -p | --power Show power states run + sleep
53 -q | --quiet Update values into DB without output
54 -r | --reverse Reverse order in listings
55 -s | --seconds Output time in seconds and epoch
56 -S | --since STARTUP Limit from this startup number
57 -t | --table Enumerate system life as table
58 --tat TIMESTAMP Report system status at specific timestamp
59 --tsince TIMESTAMP Limit from this epoch timestamp
60 --tuntil TIMESTAMP Limit until this epoch timestamp
61 -U | --until STARTUP Limit up until this startup number
62 -v | --verbose Verbose output
63 -V | --version Show version
64 ENVIRONMENT
66 TUPTIME_DBF
67 Set an alternative database file path. The argument -f, --filedb
68 takes precedence over this.
69
72 System startups:
73 Total number of system startups from since first timestamp
74 available.
75 System shutdowns:
77 Total number of shutdowns done correctly or incorrectly.
78 System life:
80 Time counter since first startup timestamp available.
81 System uptime:
83 System downtime:
84 Percentage of time and time counter.
85 Longest uptime:
87 Longest downtime:
88 Time counter and date with the complete longest uptime/downtime
89 register.
90 Average uptime:
92 Average downtime:
93 Average time counter.
94 Current uptime:
96 Actual time counter and datetime since registered boot time‐
97 stamp.
98
101 tuptime
102 Default output.
103 tuptime -t
105 Enumerate system life as table.
106 tuptime -l
108 Enumerate system life as list.
109 tuptime -k
111 Add kernel information to the output.
112 tuptime --csv
114 Report in csv format.
115 tuptime -s
117 Change default human readable datetime/timestamp style and print
118 times in seconds and datetimes in epoch.
119 tuptime -d '%H:%M:%S %m-%d-%Y'
121 Change the datetime/timestamp format. By default the output use
122 the configured system locales.
123 tuptime --tsince -31557600
125 Report since one year ago.
126
129 /etc/cron.d/tuptime
130 Scheduled cron file.
131 /etc/init.d/tuptime
133 Init file.
134 /lib/systemd/system/tuptime.service
136 Systemd service unit file. Register time values into database.
137 /usr/bin/tuptime
139 Main and only executable file.
140 /usr/share/doc/tuptime/
142 Directory with multiple documentation files.
143 /lib/systemd/system/tuptime-sync.timer
145 Systemd .timer unit for use instead of cron. Only executes tup‐
146 time-sync.service.
147 /lib/systemd/system/tuptime-sync.service
149 Systemd .service unit required by tuptime-sync.timer. Updates
150 time values into database.
151 /usr/share/man/man1/tuptime.1
153 Manual page.
154
157 /usr/share/doc/tuptime/tuptime-manual.txt.gz
158 Detailed documentation.
159 https://github.com/rfmoz/tuptime/
161 Official repository.
162
165 Ricardo Fraile <r@rfmoz.eu>
166
169 Copyright (C) 2023 by Ricardo F. All Rights Reserved.
170 This product is distributed in the hope that it will be useful, but
172 WITHOUT any warranty; without even the implied warranty of MER‐
173 CHANTABILITY or FITNESS for a particular purpose.
1745.2.2 Jan 2023 TUPTIME(1)