UPTIME(1)           RISC/os Reference Manual            UPTIME(1)



NAME
     uptime - display system up time and load statistics

SYNOPSIS
     uptime [ -l ] [ -s ] [ -n ] [ -f format ]

DESCRIPTION
     The uptime command displays statistics on how long the sys-
     tem has been up, how many users are on the system, and three
     types of load averages:  standard (exponentially decaying
     for 1, 5, and 15 minutes), extended (exponentially decaying
     for 1, 5, and 20 seconds plus the standard load average),
     and rolling average (for 1, 5, and 15 minutes).

     The default format of output looks similar to the BSD UNIX
     command of the same name.  The following shows how this
     might look:


          10:33am  up 16:50,  17 users,  load average: 1.03, 0.50, 0.00

     Command-line options provide similar formats using the vari-
     ous types of available load averages.  In addition, the for-
     mat can be defined by the user by using the -f option or the
     UPTIME_FORMAT environment variable.

     The format string can contain any text.  The sequences \n,
     \t, \f, \r, \b, and \\ are handled just like C escapes.  All
     other escaped characters are printed as-is.  Statistics are
     printed by using %-specifiers, as in the date(1) command.
     The available sequences are:

          t    Current time as HH:MM on a 12 hour clock
          T    Current time as HH:MM on a 24 hour clock
          r    ``am'' or ``pm''
          R    ``AM'' or ``PM''
          u    Number of users with idle time less than an hour
          U    Number of users on the system
          d    Number of days the system has been up
          h    Number of hours the system has been up not includ-
               ing days
          H    Number of hours the system has been up including
               days
          m    Number of minutes the system has been up not
               including days and hours
          M    Number of minutes the system has been up including
               days and hours
          D    Date sentence (hh:mm or d day(s), hh:mm)
          p    Plurality -- `s' if last %-specifier used was not
               exactly 1
          a    Exponentially decaying load average as: x.xx,
               x.xx, x.xx



                        Printed 11/19/92                   Page 1

UPTIME(1)           RISC/os Reference Manual            UPTIME(1)



          A    Extended load average as: x.xx, x.xx, x.xx, x.xx,
               x.xx, x.xx
          1a   Exponentially decaying load average over last 1
               second
          2a   Exponentially decaying load average over last 5
               seconds
          3a   Exponentially decaying load average over last 20
               seconds
          4a   Exponentially decaying load average over last 60
               seconds
          5a   Exponentially decaying load average over last 300
               seconds
          6a   Exponentially decaying load average over last 900
               seconds
          s    Rolling average as: x.xx, x.xx, x.xx
          1s   Rolling average over last 60 seconds
          2s   Rolling average over last 300 seconds
          3s   Rolling average over last 900 seconds
          %    The character %

     The specifiers %[456]s are interpreted as %s.  The sequences
     %[1-6][^as] cause nothing to be printed.

     The default format is given by the following string:


          %t%r  up %D,  %U user%p,  load average: %a

     Any format option (-l, -s, -n, or -f,) given overrides the
     UPTIME_FORMAT variable.

OPTIONS
     -l        Use the standard format, but display all exponen-
               tially decaying load averages (%A) instead of just
               the oldest 3 (%a).

     -s        Use the standard format, but display rolling aver-
               age (%s) instead of exponentially decaying aver-
               ages (%a).

     -n        Use the default format (see above).  This should
               be used in all shell script applications that need
               to use the default format, since it overrides the
               UPTIME_FORMAT environment variable.

     -f format Use the format given by format to print the
               statistics.  The format string should be quoted in
               the shell to avoid interpretation by the shell.

FILES
     /unix          Operating system executable




 Page 2                 Printed 11/19/92

UPTIME(1)           RISC/os Reference Manual            UPTIME(1)



     /dev/kmem      Operating system memory image

SEE ALSO
     ruptime(1C).



















































                        Printed 11/19/92                   Page 3