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.