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

tuptime: 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.

AUTHOR

Ricardo Fraile <rfraile@rfraile.eu>

COPYRIGHT

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.