emo/procps
1
0
Fork 0
Code Issues Pull Requests Packages Releases Activity
414e33a8af
procps/man/uptime.1

75 lines
2.2 KiB
Groff
Raw Normal View History

misc: Update copyright of remaining man pages Giving them all a standard format and using either the existing header or the git logs to put the relevant authors in.
2023-02-08 12:58:55 +05:30
.\"
.\" Copyright (c) 2011-2023 Craig Small <csmall@dropbear.xyz>
.\" Copyright (c) 2011-2023 Jim Warner <james.warner@comcast.net>
.\" Copyright (c) 2011-2012 Sami Kerola <kerolasa@iki.fi>
.\" Copyright (c) 2002 Albert Cahalan
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
procps 010114
2002-02-02 04:17:29 +05:30
.\"
uptime: add since option The --since or -s option will show the time since the host was online. Reference(s): http://www.freelists.org/post/procps/Patch-Added-since-option-to-uptime Signed-off-by: Craig Small <csmall@enc.com.au>
2012-12-26 17:44:09 +05:30
.TH UPTIME "1" "December 2012" "procps-ng" "User Commands"
procps 010114
2002-02-02 04:17:29 +05:30
.SH NAME
uptime \- Tell how long the system has been running.
.SH SYNOPSIS
.B uptime
docs: mention long options in man uptime.1 The commit includes few generic manual clean ups as well. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2011-06-07 02:14:05 +05:30
[\fIoptions\fR]
procps 010114
2002-02-02 04:17:29 +05:30
.SH DESCRIPTION
.B uptime
docs: mention long options in man uptime.1 The commit includes few generic manual clean ups as well. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2011-06-07 02:14:05 +05:30
gives a one line display of the following information. The current time, how
long the system has been running, how many users are currently logged on, and
the system load averages for the past 1, 5, and 15 minutes.
.PP
misc: trailing space/tab cleanup following rebase
2011-10-27 20:20:24 +05:30
This is the same information contained in the header line displayed by
procps 010114
2002-02-02 04:17:29 +05:30
.BR w (1).
docs: mention long options in man uptime.1 The commit includes few generic manual clean ups as well. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2011-06-07 02:14:05 +05:30
.PP
System load averages is the average number of processes that are either in a
runnable or uninterruptable state. A process in a runnable state is either
using the CPU or waiting to use the CPU. A process in uninterruptable state
is waiting for some I/O access, eg waiting for disk. The averages are taken
over the three time intervals. Load averages are not normalized for the
number of CPUs in a system, so a load average of 1 means a single CPU system
is loaded all the time while on a 4 CPU system it means it was idle 75% of
the time.
.SH OPTIONS
.TP
Add -p|--pretty option to uptime(1) for pretty output. This patch adds the -p option to the uptime(1) command, which changes the uptime displayed from something like: 10:35:52 up 2:33, 1 user, load average: 1.69, 1.65, 1.63 to: up 2 hours, 33 minutes I originally implemented this as the up(1) program about 14 years ago. In 2008 or 2009, I created a patch for procps to add this functionality to uptime and submitted it to the project. Never heard from the project and no new releases of procps had been made. Then I found out about this project and decided to port my patch to it. So here it is. This is really just for fun. There is no real technical reason to have this functionality. But even now, 14 years later, I still get emails asking where the source code for up is. So I thought it would be nice for the uptime command on Linux to sport the up functionality by default.
2012-02-22 21:05:12 +05:30
\fB\-p\fR, \fB\-\-pretty\fR
show uptime in pretty format
.TP
docs: mention long options in man uptime.1 The commit includes few generic manual clean ups as well. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2011-06-07 02:14:05 +05:30
\fB\-h\fR, \fB\-\-help\fR
display this help text
.TP
uptime: add since option The --since or -s option will show the time since the host was online. Reference(s): http://www.freelists.org/post/procps/Patch-Added-since-option-to-uptime Signed-off-by: Craig Small <csmall@enc.com.au>
2012-12-26 17:44:09 +05:30
\fB\-s\fR, \fB\-\-since\fR
docs: Fix typos in slabtop.1, sysctl.8 and uptime.1
2014-09-16 11:21:13 +05:30
system up since, in yyyy-mm-dd HH:MM:SS format
uptime: add since option The --since or -s option will show the time since the host was online. Reference(s): http://www.freelists.org/post/procps/Patch-Added-since-option-to-uptime Signed-off-by: Craig Small <csmall@enc.com.au>
2012-12-26 17:44:09 +05:30
.TP
docs: mention long options in man uptime.1 The commit includes few generic manual clean ups as well. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2011-06-07 02:14:05 +05:30
\fB\-V\fR, \fB\-\-version\fR
display version information and exit
procps 010114
2002-02-02 04:17:29 +05:30
.SH FILES
Manual pages fixes Taken from Debian with small changes added Authors: Craig Small <csmall@debian.org>, Brendan O'Dea <bod@debian.org>
2011-02-23 13:47:54 +05:30
.TP
.I /var/run/utmp
information about who is currently logged on
.TP
.I /proc
process information
procps 010114
2002-02-02 04:17:29 +05:30
.SH AUTHORS
.B uptime
docs: mention long options in man uptime.1 The commit includes few generic manual clean ups as well. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2011-06-07 02:14:05 +05:30
was written by
docs: fix manual page warnings All warnings where about unnecessary quoting. The scriptlet below will tell what was wrong. for I in ./top/top.1 ./ps/ps.1 ./*.[0-9]; do echo "== $I warnings ==" man --warnings=all $I > /dev/null done This should probably be turned to 'make check' script. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2012-04-16 16:25:53 +05:30
.UR greenfie@gauss.\:rutgers.\:edu
docs: mention long options in man uptime.1 The commit includes few generic manual clean ups as well. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2011-06-07 02:14:05 +05:30
Larry Greenfield
.UE
and
docs: fix manual page warnings All warnings where about unnecessary quoting. The scriptlet below will tell what was wrong. for I in ./top/top.1 ./ps/ps.1 ./*.[0-9]; do echo "== $I warnings ==" man --warnings=all $I > /dev/null done This should probably be turned to 'make check' script. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2012-04-16 16:25:53 +05:30
.UR johnsonm@sunsite.\:unc.\:edu
docs: mention long options in man uptime.1 The commit includes few generic manual clean ups as well. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2011-06-07 02:14:05 +05:30
Michael K. Johnson
.UE
procps 010114
2002-02-02 04:17:29 +05:30
.SH "SEE ALSO"
.BR ps (1),
.BR top (1),
.BR utmp (5),
.BR w (1)
docs: mention long options in man uptime.1 The commit includes few generic manual clean ups as well. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2011-06-07 02:14:05 +05:30
.SH "REPORTING BUGS"
Please send bug reports to
docs: fix manual page warnings All warnings where about unnecessary quoting. The scriptlet below will tell what was wrong. for I in ./top/top.1 ./ps/ps.1 ./*.[0-9]; do echo "== $I warnings ==" man --warnings=all $I > /dev/null done This should probably be turned to 'make check' script. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2012-04-16 16:25:53 +05:30
.UR procps@freelists.org
docs: mention long options in man uptime.1 The commit includes few generic manual clean ups as well. Signed-off-by: Sami Kerola <kerolasa@iki.fi>
2011-06-07 02:14:05 +05:30
.UE
Reference in New Issue Copy Permalink