Scroll to navigation

TUPTIME(1) Linux Manual TUPTIME(1)

NAME

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

SYNOPSIS

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

DESCRIPTION

Tuptime report historical and statistical real time of the system, keeping it between restarts. Indeed, it can:

- Count system startups
- Register first boot time (a.k.a. installation time)
- Count nicely and accidentally shutdowns
- Uptime and downtime percentage since first boot time
- Accumulated system uptime (running and sleeping), downtime and total
- Register used kernels and boot IDs
- Report current uptime
- Print formatted table or list with the system history
- Narrow reports since, until or at a given startup or timestamp
- Output in csv format

OPTIONS

ARGUMENTS

-h | --help Show this help message and exit
-A | --at STARTUP Limit to this startup number
-b | --bootid Show boot identifier
-c | --csv Output in csv format
-d | --date DATETM_FORMAT Datetime/timestamp format output
-e | --dec DECIMALS Number of decimals in percentages
-f | --file FILE Database file (file path)
-g | --graceful Register a graceful shutdown
-i | --invert Startup number in reverse count
-k | --kernel Show kernel version
-l | --list Enumerate system life as list
-n | --noup Avoid update values into DB
-o | --order TYPE Order enumerate by [u|r|s|e|d|k] (u = uptime | r = runtime | s = sleep time | e = end status | d = downtime | k = kernel)
-p | --power Show power states run + sleep
--pctl [1-99] Show percentile number applied over average
-r | --reverse Reverse order in list or table output
-s | --seconds Output time in seconds and epoch
-S | --since STARTUP Limit from this startup number
-t | --table Enumerate system life as table
--tat TIMESTAMP Report system status at specific timestamp
--tsince TIMESTAMP Limit from this epoch timestamp
--tuntil TIMESTAMP Limit until this epoch timestamp
-U | --until STARTUP Limit up until this startup number
-v | --verbose Verbose output
-V | --version Show version
-x | --silent Update values into DB without output

ENVIRONMENT

TUPTIME_DBF

Set an alternative database file path. The argument -f, --filedb takes precedence over this.

DEFAULT OUTPUT

System startups:

Total number of system startups from since first timestamp available.

System shutdowns:
Total number of shutdowns done correctly or incorrectly.

System life:
Time counter since first startup timestamp available.

System uptime:
System downtime:
Percentage of time and time counter.

Average uptime:
Average downtime:
Time counter with the average time.

Current uptime:
Actual time counter and datetime since registered boot timestamp.

EXAMPLES

Default output.
tuptime -t
Enumerate system life as table.
tuptime -l
Enumerate system life as list.
tuptime -k
Add kernel information to the output.
tuptime --csv
Report in csv format.
tuptime -s
Change default human readable datetime/timestamp style and print times in seconds and datetimes in epoch.
tuptime -d '%H:%M:%S %m-%d-%Y'
Change the datetime/timestamp format. By default the output use the configured system locales.
tuptime --tsince -31557600
Report since one year ago.

FILES

/etc/cron.d/tuptime
Scheduled cron file.
/etc/init.d/tuptime
Init file.
/lib/systemd/system/tuptime.service
Systemd service unit file.
/usr/bin/tuptime
Main and only executable file.
/usr/share/doc/tuptime/
Directory with multiple documentation files.
/usr/share/doc/tuptime/examples/tuptime-cron.timer
Optional .timer unit for use instead of cron.
/usr/share/doc/tuptime/examples/tuptime-cron.service
Optional .service unit required by tuptime-cron.timer
/usr/share/man/man1/tuptime.1
Manual page.

SEE ALSO

/usr/share/doc/tuptime/tuptime-manual.txt.gz
Detailed documentation.
https://github.com/rfrail3/tuptime/
Official repository.

AUTHOR

Ricardo Fraile <rfraile@rfraile.eu>

COPYRIGHT

Copyright (C) 2021 by Ricardo F. All Rights Reserved.

This product is distributed in the hope that it will be useful, but WITHOUT any warranty; without even the implied warranty of MERCHANTABILITY or FITNESS for a particular purpose.

Jan 2022 5.1.0