TUPTIME(1)

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

SYNOPSIS
tuptime [{-h | --help}] [{-A | --at}=<startup>] [{-c | --csv}] [{-d | --date}=<date format>] [--decp=<decimals>] [{-f | --filedb}=<file>] [{-g | --graceful}] [{-k | --kernel}] [{-l | --list}] [{-n | --noup}] [{-o | --order}={d|e|k|r|s|u}] [{-p | --power}] [{-r | --reverse}] [{-s | --seconds}] [{-S | --since}=<startup>] [{-t | --table}] [--tat=<timestamp>] [--tsince=<timestamp>] [--tuntil=<timestamp>] [{-U | --until}=<startup>] [{-v | --verbose}] [{-V | --version}] [{-x | --silent}]

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
    - Current uptime
    - Register used kernels
    - Print formatted table or list with most of the previous values
    - Narrow reports since and/or until a given startup or timestamp
    - Reports in csv

OPTIONS

  ARGUMENTS
-h | --help | Show this help message and exit
-A | --at STARTUP | Restrict at this startup number
-c | --csv | Output in csv format
-d | --date TIMESTAMP | Date format
--decp DECIMALS | Number of decimals in percentages
-f | --file FILE | Database file
-g | --graceful | Register a graceful shutdown
-k | --kernel | Print kernel information
-l | --list | Enumerate system life as list
-n | --noup | Avoid update values
-o | --order TYPE | Order enumerate by [<d|e|k|r|s|u>] d = downtime | e = end status | k = kernel | r = runtime | s = sleep time | u = uptime
-r | --reverse | Reverse order in list or table output
-p | --power | Print power states run + sleep
-s | --seconds | Output time in seconds and epoch
-S | --since STARTUP | Restric since this startup number
-t | --table | Enumerate system life as table
--tat TIMESTAMP | Report system status at specific timestamp
--tsince TIMESTAMP | Restrict since this epoch timestamp
--tuntil TIMESTAMP | Restrict until this epoch timestamp
-U | --until STARTUP | Restrict up until this startup number
-v | --verbose | Verbose output
-V | --version | Show version.
-x | --silent | Update values without print

  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 to until date.
System shutdowns:
    Total number of shutdowns done correctly or incorrectly. The separator points to the state of last shutdown (<-) ok, (->) bad if any filter is used.
System uptime:
    Percentage of uptime and time counter.
System downtime:
    Percentage of downtime and time counter.
System life:
    Time counter since first startup date until last.
Largest uptime:
Shortest uptime:
Largest downtime:
Shortest downtime:
    Time counter and date with the largest/shortest uptime register.
Average uptime:
Average downtime:
    Time counter with the average time.
Current uptime:
    Actual time counter and date. Always is update.

EXAMPLES

tuptime
    Default output.

tuptime -t
    Enumerate as table each startup number, startup date, uptime, shutdown date, end status and downtime.

tuptime -l
    Enumerate as list each startup number, startup date, uptime, shutdown date, end status and offtime.

tuptime -k
    Add kernel information to the output.

tuptime --csv
    Report in csv format.

tuptime -s
    Change default human readable date style and print times in seconds and dates in epoch.

tuptime -d '%H:%M:%S %m-%d-%Y'
    Change the date format. By default it's printed based on 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/doc/tuptime/contrib/uptimed-to-tuptime.py
    Uptimed to Tuptime migration script.

/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) 2020 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.