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.