[src/netbsd-1-5]: src/usr.bin/time Pull up revisions 1.9-1.12 (requested by h...

[he <he%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/ff3701c8c0a2
branches:  netbsd-1-5
changeset: 490588:ff3701c8c0a2
user:      he <he%NetBSD.org@localhost>
date:      Sat Feb 03 19:41:06 2001 +0000

description:
Pull up revisions 1.9-1.12 (requested by hubertf):
  Note that ``time'' is also a builtin in ksh, and document rusage
  information.  Fixes PR#11975.  Also use "EXIT STATUS" instead of
  "DIAGNOSTICS".

diffstat:

 usr.bin/time/time.1 |  60 +++++++++++++++++++++++++++++++++++++++++++---------
 1 files changed, 49 insertions(+), 11 deletions(-)

diffs (100 lines):

diff -r d39f0f45fa5f -r ff3701c8c0a2 usr.bin/time/time.1
--- a/usr.bin/time/time.1       Sat Feb 03 19:23:32 2001 +0000
+++ b/usr.bin/time/time.1       Sat Feb 03 19:41:06 2001 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: time.1,v 1.8 1999/06/05 19:19:19 kleink Exp $
+.\"    $NetBSD: time.1,v 1.8.8.1 2001/02/03 19:41:06 he Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -65,30 +65,67 @@
 Available options:
 .Bl -tag -width Ds
 .It Fl l
+Lists resource utilization information.
 The contents of the
 .Ar utility
 process'
 .Em rusage
-structure are printed.
+structure are printed, see below.
 .It Fl p
 The output is formatted as specified by
 .St -p1003.2-92 .
 .El
 .Pp
-The
+Some shells, such as
 .Xr csh 1
-has its own and syntactically different builtin version of
+and
+.Xr ksh 1 "" ,
+have their own and syntactically different builtin version of
 .Nm "" .
 The utility described here
 is available as
 .Pa /usr/bin/time
-to
-.Xr csh
-users.
-.Sh DIAGNOSTICS
+to users of these shells.
+.Ss Resource Utilization
+If the
+.Fl l
+option is given, the following resource usage 
+informations are displayed
+in addition to the timing information:
+.Bl -item -offset indent -compact
+.It
+maximum resident set size
+.It
+average shared memory size
+.It
+average unshared data size
+.It
+average unshared stack size
+.It
+page reclaims
+.It
+page faults
+.It
+swaps
+.It
+block input operations
+.It
+block output operations
+.It
+messages sent
+.It
+messages received
+.It
+signals received
+.It
+voluntary context switches
+.It
+involuntary context switches
+.El
+.Sh EXIT STATUS
 The
 .Nm
-utility shall exit with one of the following values:
+utility exits with one of the following values:
 .Bl -tag -width indent
 .It 1-125
 An error occurred in the 
@@ -106,11 +143,12 @@
 .Pp
 Otherwise, the exit status of 
 .Nm
-shall be that of 
+will be that of 
 .Ar utility .
 .Sh SEE ALSO
 .Xr csh 1 ,
-.Xr getrusage 2
+.Xr getrusage 2 ,
+.Xr ksh 1
 .Sh FILES
 .Bl -tag -width <sys/resource.h> -compact
 .It <sys/resource.h>