NAME

       tuptime  -  Report  historical and statistical real time of the system, keeping it between
       restarts. Total uptime.

SYNOPSIS

       tuptime [-h] [-A STARTUP] [-b] [-c] [-d DATETIME_FMT] [-e DECIMALS] [-E STARTUP] [-f FILE]
       [-g] [-i] [-k] [-l] [-n] [-o TYPE] [-p] [-q] [-r] [-s] [-S STARTUP] [-t] [--tat TIMESTAMP]
       [--tsince TIMESTAMP] [--tuntil TIMESTAMP] [-U STARTUP] [-v] [-V]

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          Limit to this startup number
       -b | --bootid              Show boot identifier
       -c | --csv                 Output in csv format
       -d | --date DATETIME_FMT   Datetime/timestamp format output
       -e | --dec DECIMALS        Number of decimals in percentages
       -E | --exclude STARTUP     Startup numbers to exclude
       -f | --file FILE           Database file (file path)
       -g | --graceful            Register a graceful shutdown
       -i | --invert              Startup    number    in   reverse   count   |   swich   between
                                  longest/shortest on default output
       -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
       -q | --quiet               Update values into DB without output
       -r | --reverse             Reverse order in listings
       -s | --seconds             Output time in seconds and epoch
       -S | --since STARTUP       Limit from this startup number
       -t | --table               Enumerate system life as table
       --tat TIMESTAMP            Report system status at specific timestamp
       --tsince TIMESTAMP         Limit from this epoch timestamp
       --tuntil TIMESTAMP         Limit until this epoch timestamp
       -U | --until STARTUP       Limit up until this startup number
       -v | --verbose             Verbose output
       -V | --version             Show version

   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.

       Longest uptime:
       Longest downtime:
              Time counter and date with the complete longest uptime/downtime register.

       Average uptime:
       Average downtime:
              Average time counter.

       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. Register time values into database.

       /usr/bin/tuptime
              Main and only executable file.

       /usr/share/doc/tuptime/
              Directory with multiple documentation files.

       /lib/systemd/system/tuptime-sync.timer
              Systemd .timer unit for use instead of cron. Only executes tuptime-sync.service.

       /lib/systemd/system/tuptime-sync.service
              Systemd .service unit required by  tuptime-sync.timer.  Updates  time  values  into
              database.

       /usr/share/man/man1/tuptime.1
              Manual page.

SEE ALSO

       /usr/share/doc/tuptime/tuptime-manual.txt.gz
              Detailed documentation.

       https://github.com/rfmoz/tuptime/
              Official repository.

AUTHOR

       Ricardo Fraile <r@rfmoz.eu>

COPYRIGHT

       Copyright (C) 2023 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.