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.