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.

5.0.2                                               Nov 2020                                          TUPTIME(1)