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>] [{-b | --bootid}] [{-c | --csv}] [{-d | --date}=<datetime format>] [-e | --dec=<decimals>] [{-f | --filedb}=<file>] [{-g | --graceful}] [{-i | --invert}] [{-k | --kernel}] [{-l | --list}] [{-n | --noup}] [{-o | --order}=[u|r|s|e|d|k]] [{-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
    - 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 | Restrict 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
-r | --reverse | Reverse order in list or table output
-s | --seconds | Output time in seconds and epoch
-S | --since STARTUP | Restrict from this startup number
-t | --table | Enumerate system life as table
--tat TIMESTAMP | Report system status at specific timestamp
--tsince TIMESTAMP | Restrict from 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 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.

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.