isa/citadel
1
0
Fork 0
forked from brl/citadel
Code Pull Requests Activity
a04c1ab907
citadel/poky/meta/recipes-extended/time/time-1.7/debian.patch

1302 lines
45 KiB
Diff
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Upstream-Status: Backport
--- time-1.7.orig/configure.in
+++ time-1.7/configure.in
@@ -1,11 +1,8 @@
dnl Process this file with autoconf to produce a configure script.
AC_INIT(time.c)
-VERSION=1.7
-AC_SUBST(VERSION)
-PACKAGE=time
-AC_SUBST(PACKAGE)
+AM_INIT_AUTOMAKE(time, 1.7)
-AC_ARG_PROGRAM
+AM_MAINTAINER_MODE
dnl Checks for programs.
AC_PROG_CC
@@ -15,7 +12,7 @@
dnl Checks for header files.
AC_HEADER_STDC
AC_HEADER_SYS_WAIT
-AC_CHECK_HEADERS(unistd.h string.h sys/rusage.h)
+AC_CHECK_HEADERS(unistd.h string.h sys/rusage.h sys/resource.h)
dnl Checks for typedefs, structures, and compiler characteristics.
AC_C_CONST
--- time-1.7.orig/version.texi
+++ time-1.7/version.texi
@@ -1,3 +1,3 @@
-@set UPDATED 12 June 1996
+@set UPDATED 9 May 2002
@set EDITION 1.7
@set VERSION 1.7
--- time-1.7.orig/time.c
+++ time-1.7/time.c
@@ -147,6 +147,10 @@
NULL
};
+
+/* If true, do not show the exit message */
+static boolean quiet;
+
/* If true, show an English description next to each statistic. */
static boolean verbose;
@@ -172,6 +176,7 @@
{"help", no_argument, NULL, 'h'},
{"output-file", required_argument, NULL, 'o'},
{"portability", no_argument, NULL, 'p'},
+ {"quiet", no_argument,NULL, 'q'},
{"verbose", no_argument, NULL, 'v'},
{"version", no_argument, NULL, 'V'},
{NULL, no_argument, NULL, 0}
@@ -333,7 +338,8 @@
else if (WIFSIGNALED (resp->waitstatus))
fprintf (fp, "Command terminated by signal %d\n",
WTERMSIG (resp->waitstatus));
- else if (WIFEXITED (resp->waitstatus) && WEXITSTATUS (resp->waitstatus))
+ else if (WIFEXITED (resp->waitstatus) && WEXITSTATUS (resp->waitstatus)
+ && !quiet)
fprintf (fp, "Command exited with non-zero status %d\n",
WEXITSTATUS (resp->waitstatus));
@@ -523,6 +529,7 @@
char *format; /* Format found in environment. */
/* Initialize the option flags. */
+ quiet = false;
verbose = false;
outfile = NULL;
outfp = stderr;
@@ -536,7 +543,7 @@
if (format)
output_format = format;
- while ((optc = getopt_long (argc, argv, "+af:o:pvV", longopts, (int *) 0))
+ while ((optc = getopt_long (argc, argv, "+af:o:pqvV", longopts, (int *) 0))
!= EOF)
{
switch (optc)
@@ -555,6 +562,9 @@
case 'p':
output_format = posix_format;
break;
+ case 'q':
+ quiet = true;
+ break;
case 'v':
verbose = true;
break;
@@ -642,9 +652,9 @@
fflush (outfp);
if (WIFSTOPPED (res.waitstatus))
- exit (WSTOPSIG (res.waitstatus));
+ exit (WSTOPSIG (res.waitstatus) + 128);
else if (WIFSIGNALED (res.waitstatus))
- exit (WTERMSIG (res.waitstatus));
+ exit (WTERMSIG (res.waitstatus) + 128);
else if (WIFEXITED (res.waitstatus))
exit (WEXITSTATUS (res.waitstatus));
}
@@ -657,7 +667,7 @@
fprintf (stream, "\
Usage: %s [-apvV] [-f format] [-o file] [--append] [--verbose]\n\
[--portability] [--format=format] [--output=file] [--version]\n\
- [--help] command [arg...]\n",
+ [--quiet] [--help] command [arg...]\n",
program_name);
exit (status);
}
--- time-1.7.orig/resuse.h
+++ time-1.7/resuse.h
@@ -36,19 +36,8 @@
# include <sys/rusage.h>
#else
# define TV_MSEC tv_usec / 1000
-# if HAVE_WAIT3
+# if HAVE_SYS_RESOURCE_H
# include <sys/resource.h>
-# else
-/* Process resource usage structure. */
-struct rusage
-{
- struct timeval ru_utime; /* User time used. */
- struct timeval ru_stime; /* System time used. */
- int ru_maxrss, ru_ixrss, ru_idrss, ru_isrss,
- ru_minflt, ru_majflt, ru_nswap, ru_inblock,
- ru_oublock, ru_msgsnd, ru_msgrcv, ru_nsignals,
- ru_nvcsw, ru_nivcsw;
-};
# endif
#endif
--- time-1.7.orig/time.texi
+++ time-1.7/time.texi
@@ -11,6 +11,12 @@
@finalout
@end iftex
+@dircategory Individual utilities
+@direntry
+* time: (time). Run programs and summarize
+ system resource usage.
+@end direntry
+
@ifinfo
This file documents the the GNU @code{time} command for running programs
and summarizing the system resources they use.
@@ -185,6 +191,10 @@
sys %S
@end example
+@item -q
+@itemx --quiet
+Suppress non-zero error code from the executed program.
+
@item -v
@itemx --verbose
@cindex format
--- time-1.7.orig/time.info
+++ time-1.7/time.info
@@ -1,5 +1,10 @@
-This is Info file ./time.info, produced by Makeinfo-1.55 from the input
-file time.texi.
+This is time.info, produced by makeinfo version 4.1 from time.texi.
+
+INFO-DIR-SECTION Individual utilities
+START-INFO-DIR-ENTRY
+* time: (time). Run programs and summarize
+ system resource usage.
+END-INFO-DIR-ENTRY
This file documents the the GNU `time' command for running programs
and summarizing the system resources they use.
@@ -31,7 +36,7 @@
* Resource Measurement:: Measuring program resource use.
- -- The Detailed Node Listing --
+ --- The Detailed Node Listing ---
Measuring Program Resource Use
@@ -58,14 +63,14 @@
The `time' command runs another program, then displays information
about the resources used by that program, collected by the system while
the program was running. You can select which information is reported
-and the format in which it is shown (*note Setting Format::.), or have
+and the format in which it is shown (*note Setting Format::), or have
`time' save the information in a file instead of displaying it on the
-screen (*note Redirecting::.).
+screen (*note Redirecting::).
The resources that `time' can report on fall into the general
categories of time, memory, and I/O and IPC calls. Some systems do not
provide much information about program resource use; `time' reports
-unavailable information as zero values (*note Accuracy::.).
+unavailable information as zero values (*note Accuracy::).
The format of the `time' command is:
@@ -132,6 +137,10 @@
user %U
sys %S
+`-q'
+`--quiet'
+ Suppress non-zero error code from the executed program.
+
`-v'
`--verbose'
Use the built-in verbose format, which displays each available
@@ -174,7 +183,7 @@
The resource specifiers, which are a superset of those recognized by
the `tcsh' builtin `time' command, are listed below. Not all resources
are measured by all versions of Unix, so some of the values might be
-reported as zero (*note Accuracy::.).
+reported as zero (*note Accuracy::).
* Menu:
@@ -308,11 +317,11 @@
`-o FILE'
`--output=FILE'
Write the resource use statistics to FILE. By default, this
- *overwrites* the file, destroying the file's previous contents.
+ _overwrites_ the file, destroying the file's previous contents.
`-a'
`--append'
- *Append* the resource use information to the output file instead
+ _Append_ the resource use information to the output file instead
of overwriting it. This option is only useful with the `-o' or
`--output' option.
@@ -437,7 +446,7 @@
`-a'
`--append'
- *Append* the resource use information to the output file instead
+ _Append_ the resource use information to the output file instead
of overwriting it.
`-f FORMAT'
@@ -462,17 +471,17 @@

Tag Table:
-Node: Top934
-Node: Resource Measurement1725
-Node: Setting Format3678
-Node: Format String4907
-Node: Time Resources6214
-Node: Memory Resources6844
-Node: I/O Resources7549
-Node: Command Info8747
-Node: Redirecting8964
-Node: Examples9754
-Node: Accuracy12064
-Node: Invoking time13586
+Node: Top1115
+Node: Resource Measurement1908
+Node: Setting Format3858
+Node: Format String5164
+Node: Time Resources6470
+Node: Memory Resources7100
+Node: I/O Resources7805
+Node: Command Info9003
+Node: Redirecting9220
+Node: Examples10010
+Node: Accuracy12320
+Node: Invoking time13842

End Tag Table
--- time-1.7.orig/time.html
+++ time-1.7/time.html
@@ -0,0 +1,1021 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
+ "http://www.w3.org/TR/html40/loose.dtd">
+<HTML>
+<!-- Created on September, 1 2003 by texi2html 1.66 -->
+<!--
+Written by: Lionel Cons <Lionel.Cons@cern.ch> (original author)
+ Karl Berry <karl@freefriends.org>
+ Olaf Bachmann <obachman@mathematik.uni-kl.de>
+ and many others.
+Maintained by: Many creative people <dev@texi2html.cvshome.org>
+Send bugs and suggestions to <users@texi2html.cvshome.org>
+
+-->
+<HEAD>
+<TITLE>Measuring Program Resource Use</TITLE>
+
+<META NAME="description" CONTENT="Measuring Program Resource Use">
+<META NAME="keywords" CONTENT="Measuring Program Resource Use">
+<META NAME="resource-type" CONTENT="document">
+<META NAME="distribution" CONTENT="global">
+<META NAME="Generator" CONTENT="texi2html 1.66">
+
+</HEAD>
+
+<BODY LANG="en" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#800080" ALINK="#FF0000">
+
+<A NAME="SEC_Top"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H1>Measuring Program Resource Use</H1>
+
+<P>
+
+This file documents the the GNU <CODE>time</CODE> command for running programs
+and summarizing the system resources they use.
+This is edition 1.7, for version 1.7.
+</P>
+<P>
+
+</P>
+<TABLE BORDER="0" CELLSPACING="0">
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC1">1. Measuring Program Resource Use</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP">Measuring program resource use.</TD></TR>
+<TR><TH COLSPAN="3" ALIGN="left" VALIGN="TOP">
+</TH></TR>
+<TR><TH COLSPAN="3" ALIGN="left" VALIGN="TOP"> -- The Detailed Node Listing ---
+</TH></TR>
+<TR><TH COLSPAN="3" ALIGN="left" VALIGN="TOP">
+</TH></TR>
+<TR><TH COLSPAN="3" ALIGN="left" VALIGN="TOP">Measuring Program Resource Use
+</TH></TR>
+<TR><TH COLSPAN="3" ALIGN="left" VALIGN="TOP">
+</TH></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC2">1.1 Setting the Output Format</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP">Selecting the information reported by <CODE>time</CODE>.</TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC3">1.2 The Format String</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP">The information <CODE>time</CODE> can report.</TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC8">1.3 Redirecting Output</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP">Writing the information to a file.</TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC9">1.4 Examples</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP">Examples of using <CODE>time</CODE>.</TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC10">1.5 Accuracy</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP">Limitations on the accuracy of <CODE>time</CODE> output.</TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC11">1.6 Running the <CODE>time</CODE> Command</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP">Summary of the options to the <CODE>time</CODE> command.</TD></TR>
+<TR><TH COLSPAN="3" ALIGN="left" VALIGN="TOP">
+</TH></TR>
+<TR><TH COLSPAN="3" ALIGN="left" VALIGN="TOP">The Format String
+</TH></TR>
+<TR><TH COLSPAN="3" ALIGN="left" VALIGN="TOP">
+</TH></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC4">1.2.1 Time Resources</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC5">1.2.2 Memory Resources</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC6">1.2.3 I/O Resources</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC7">1.2.4 Command Info</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
+</TABLE>
+<P>
+
+<HR SIZE=1>
+<A NAME="SEC1"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> &lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC2"> &gt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[ &lt;&lt; ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<A NAME="Resource Measurement"></A>
+<H1> 1. Measuring Program Resource Use </H1>
+<!--docid::SEC1::-->
+<P>
+
+The <CODE>time</CODE> command runs another program, then displays information
+about the resources used by that program, collected by the system while
+the program was running. You can select which information is reported
+and the format in which it is shown (see section <A HREF="time.html#SEC2">1.1 Setting the Output Format</A>), or have
+<CODE>time</CODE> save the information in a file instead of displaying it on the
+screen (see section <A HREF="time.html#SEC8">1.3 Redirecting Output</A>).
+</P>
+<P>
+
+The resources that <CODE>time</CODE> can report on fall into the general
+categories of time, memory, and I/O and IPC calls. Some systems do not
+provide much information about program resource use; <CODE>time</CODE>
+reports unavailable information as zero values (see section <A HREF="time.html#SEC10">1.5 Accuracy</A>).
+</P>
+<P>
+
+The format of the <CODE>time</CODE> command is:
+</P>
+<P>
+
+<TABLE><tr><td>&nbsp;</td><td class=example><pre>time [option<small>...</small>] <VAR>command</VAR> [<VAR>arg</VAR><small>...</small>]
+</pre></td></tr></table><P>
+
+<A NAME="IDX1"></A>
+<CODE>time</CODE> runs the program <VAR>command</VAR>, with any given arguments
+<VAR>arg</VAR><small>...</small>. When <VAR>command</VAR> finishes, <CODE>time</CODE> displays
+information about resources used by <VAR>command</VAR>.
+</P>
+<P>
+
+Here is an example of using <CODE>time</CODE> to measure the time and other
+resources used by running the program <CODE>grep</CODE>:
+</P>
+<P>
+
+<TABLE><tr><td>&nbsp;</td><td class=example><pre>eg$ time grep nobody /etc/aliases
+nobody:/dev/null
+etc-files:nobody
+misc-group:nobody
+0.07user 0.50system 0:06.69elapsed 8%CPU (0avgtext+489avgdata 324maxresident)k
+46inputs+7outputs (43major+251minor)pagefaults 0swaps
+</pre></td></tr></table><P>
+
+Mail suggestions and bug reports for GNU <CODE>time</CODE> to
+<CODE>bug-gnu-utils@prep.ai.mit.edu</CODE>. Please include the version of
+<CODE>time</CODE>, which you can get by running `<SAMP>time --version</SAMP>', and the
+operating system and C compiler you used.
+</P>
+<P>
+
+<TABLE BORDER="0" CELLSPACING="0">
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC2">1.1 Setting the Output Format</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP">Selecting the information reported by <CODE>time</CODE>.</TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC3">1.2 The Format String</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP">The information <CODE>time</CODE> can report.</TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC8">1.3 Redirecting Output</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP">Writing the information to a file.</TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC9">1.4 Examples</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP">Examples of using <CODE>time</CODE>.</TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC10">1.5 Accuracy</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP">Limitations on the accuracy of <CODE>time</CODE> output.</TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC11">1.6 Running the <CODE>time</CODE> Command</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP">Summary of the options to the <CODE>time</CODE> command.</TD></TR>
+</TABLE>
+<P>
+
+<A NAME="Setting Format"></A>
+<HR SIZE="6">
+<A NAME="SEC2"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> &lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC3"> &gt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> &lt;&lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 1.1 Setting the Output Format </H2>
+<!--docid::SEC2::-->
+<P>
+
+<CODE>time</CODE> uses a <EM>format string</EM> to determine which information to
+display about the resources used by the command it runs. See section <A HREF="time.html#SEC3">1.2 The Format String</A>, for the interpretation of the format string contents.
+</P>
+<P>
+
+You can specify a format string with the command line options listed
+below. If no format is specified on the command line, but the
+<CODE>TIME</CODE> environment variable is set, its value is used as the format
+string. Otherwise, the default format built into <CODE>time</CODE> is used:
+</P>
+<P>
+
+<TABLE><tr><td>&nbsp;</td><td class=example><pre>%Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k
+%Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps
+</pre></td></tr></table><P>
+
+The command line options to set the format are:
+</P>
+<P>
+
+</P>
+<DL COMPACT>
+<DT><CODE>-f <VAR>format</VAR></CODE>
+<DD><DT><CODE>--format=<VAR>format</VAR></CODE>
+<DD>Use <VAR>format</VAR> as the format string.
+<P>
+
+</P>
+<DT><CODE>-p</CODE>
+<DD><DT><CODE>--portability</CODE>
+<DD>Use the following format string, for conformance with POSIX standard
+1003.2:
+<P>
+
+<TABLE><tr><td>&nbsp;</td><td class=example><pre>real %e
+user %U
+sys %S
+</pre></td></tr></table><P>
+
+</P>
+<DT><CODE>-q</CODE>
+<DD><DT><CODE>--quiet</CODE>
+<DD>Suppress non-zero error code from the executed program.
+<P>
+
+</P>
+<DT><CODE>-v</CODE>
+<DD><DT><CODE>--verbose</CODE>
+<DD><A NAME="IDX2"></A>
+Use the built-in verbose format, which displays each available piece of
+information on the program's resource use on its own line, with an
+English description of its meaning.
+</DL>
+<P>
+
+<A NAME="Format String"></A>
+<HR SIZE="6">
+<A NAME="SEC3"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC2"> &lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC4"> &gt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> &lt;&lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 1.2 The Format String </H2>
+<!--docid::SEC3::-->
+<P>
+
+<A NAME="IDX3"></A>
+<A NAME="IDX4"></A>
+The <EM>format string</EM> controls the contents of the <CODE>time</CODE> output.
+It consists of <EM>resource specifiers</EM> and <EM>escapes</EM>, interspersed
+with plain text.
+</P>
+<P>
+
+A backslash introduces an <EM>escape</EM>, which is translated
+into a single printing character upon output. The valid escapes are
+listed below. An invalid escape is output as a question mark followed
+by a backslash.
+</P>
+<P>
+
+</P>
+<DL COMPACT>
+<DT><CODE>\t</CODE>
+<DD>a tab character
+<P>
+
+</P>
+<DT><CODE>\n</CODE>
+<DD>a newline
+<P>
+
+</P>
+<DT><CODE>\\</CODE>
+<DD>a literal backslash
+</DL>
+<P>
+
+<CODE>time</CODE> always prints a newline after printing the resource use
+information, so normally format strings do not end with a newline
+character (or `<SAMP>\n</SAMP>').
+</P>
+<P>
+
+A resource specifier consists of a percent sign followed by another
+character. An invalid resource specifier is output as a question mark
+followed by the invalid character. Use `<SAMP>%%</SAMP>' to output a literal
+percent sign.
+</P>
+<P>
+
+The resource specifiers, which are a superset of those recognized by the
+<CODE>tcsh</CODE> builtin <CODE>time</CODE> command, are listed below. Not all
+resources are measured by all versions of Unix, so some of the values
+might be reported as zero (see section <A HREF="time.html#SEC10">1.5 Accuracy</A>).
+</P>
+<P>
+
+<TABLE BORDER="0" CELLSPACING="0">
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC4">1.2.1 Time Resources</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC5">1.2.2 Memory Resources</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC6">1.2.3 I/O Resources</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
+<TR><TD ALIGN="left" VALIGN="TOP"><A HREF="time.html#SEC7">1.2.4 Command Info</A></TD><TD>&nbsp;&nbsp;</TD><TD ALIGN="left" VALIGN="TOP"></TD></TR>
+</TABLE>
+<P>
+
+<A NAME="Time Resources"></A>
+<HR SIZE="6">
+<A NAME="SEC4"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC3"> &lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC5"> &gt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> &lt;&lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H3> 1.2.1 Time Resources </H3>
+<!--docid::SEC4::-->
+<P>
+
+</P>
+<DL COMPACT>
+<DT><CODE>E</CODE>
+<DD>Elapsed real (wall clock) time used by the process, in
+[hours:]minutes:seconds.
+<P>
+
+</P>
+<DT><CODE>e</CODE>
+<DD>Elapsed real (wall clock) time used by the process, in
+seconds.
+<P>
+
+</P>
+<DT><CODE>S</CODE>
+<DD>Total number of CPU-seconds used by the system on behalf of the process
+(in kernel mode), in seconds.
+<P>
+
+</P>
+<DT><CODE>U</CODE>
+<DD>Total number of CPU-seconds that the process used directly (in user
+mode), in seconds.
+<P>
+
+</P>
+<DT><CODE>P</CODE>
+<DD>Percentage of the CPU that this job got. This is just user + system
+times divied by the total running time.
+</DL>
+<P>
+
+<A NAME="Memory Resources"></A>
+<HR SIZE="6">
+<A NAME="SEC5"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC4"> &lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC6"> &gt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> &lt;&lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H3> 1.2.2 Memory Resources </H3>
+<!--docid::SEC5::-->
+<P>
+
+</P>
+<DL COMPACT>
+<DT><CODE>M</CODE>
+<DD>Maximum resident set size of the process during its lifetime, in
+Kilobytes.
+<P>
+
+</P>
+<DT><CODE>t</CODE>
+<DD>Average resident set size of the process, in Kilobytes.
+<P>
+
+</P>
+<DT><CODE>K</CODE>
+<DD>Average total (data+stack+text) memory use of the process, in Kilobytes.
+<P>
+
+</P>
+<DT><CODE>D</CODE>
+<DD>Average size of the process's unshared data area, in Kilobytes.
+<P>
+
+</P>
+<DT><CODE>p</CODE>
+<DD>Average size of the process's unshared stack, in Kilobytes.
+<P>
+
+</P>
+<DT><CODE>X</CODE>
+<DD>Average size of the process's shared text, in Kilobytes.
+<P>
+
+</P>
+<DT><CODE>Z</CODE>
+<DD>System's page size, in bytes. This is a per-system constant, but
+varies between systems.
+</DL>
+<P>
+
+<A NAME="I/O Resources"></A>
+<HR SIZE="6">
+<A NAME="SEC6"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC5"> &lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC7"> &gt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> &lt;&lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H3> 1.2.3 I/O Resources </H3>
+<!--docid::SEC6::-->
+<P>
+
+</P>
+<DL COMPACT>
+<DT><CODE>F</CODE>
+<DD>Number of major, or I/O-requiring, page faults that occurred while the
+process was running. These are faults where the page has actually
+migrated out of primary memory.
+<P>
+
+</P>
+<DT><CODE>R</CODE>
+<DD>Number of minor, or recoverable, page faults. These are pages that are
+not valid (so they fault) but which have not yet been claimed by other
+virtual pages. Thus the data in the page is still valid but the system
+tables must be updated.
+<P>
+
+</P>
+<DT><CODE>W</CODE>
+<DD>Number of times the process was swapped out of main memory.
+<P>
+
+</P>
+<DT><CODE>c</CODE>
+<DD>Number of times the process was context-switched involuntarily (because
+the time slice expired).
+<P>
+
+</P>
+<DT><CODE>w</CODE>
+<DD>Number of times that the program was context-switched voluntarily, for
+instance while waiting for an I/O operation to complete.
+<P>
+
+</P>
+<DT><CODE>I</CODE>
+<DD>Number of file system inputs by the process.
+<P>
+
+</P>
+<DT><CODE>O</CODE>
+<DD>Number of file system outputs by the process.
+<P>
+
+</P>
+<DT><CODE>r</CODE>
+<DD>Number of socket messages received by the process.
+<P>
+
+</P>
+<DT><CODE>s</CODE>
+<DD>Number of socket messages sent by the process.
+<P>
+
+</P>
+<DT><CODE>k</CODE>
+<DD>Number of signals delivered to the process.
+</DL>
+<P>
+
+<A NAME="Command Info"></A>
+<HR SIZE="6">
+<A NAME="SEC7"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC6"> &lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC8"> &gt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> &lt;&lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H3> 1.2.4 Command Info </H3>
+<!--docid::SEC7::-->
+<P>
+
+</P>
+<DL COMPACT>
+<DT><CODE>C</CODE>
+<DD>Name and command line arguments of the command being timed.
+<P>
+
+</P>
+<DT><CODE>x</CODE>
+<DD>Exit status of the command.
+</DL>
+<P>
+
+<A NAME="Redirecting"></A>
+<HR SIZE="6">
+<A NAME="SEC8"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC7"> &lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC9"> &gt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> &lt;&lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 1.3 Redirecting Output </H2>
+<!--docid::SEC8::-->
+<P>
+
+By default, <CODE>time</CODE> writes the resource use statistics to the
+standard error stream. The options below make it write the statistics
+to a file instead. Doing this can be useful if the program you're
+running writes to the standard error or you're running <CODE>time</CODE>
+noninteractively or in the background.
+</P>
+<P>
+
+</P>
+<DL COMPACT>
+<DT><CODE>-o <VAR>file</VAR></CODE>
+<DD><DT><CODE>--output=<VAR>file</VAR></CODE>
+<DD>Write the resource use statistics to <VAR>file</VAR>. By default, this
+<EM>overwrites</EM> the file, destroying the file's previous contents.
+<P>
+
+</P>
+<DT><CODE>-a</CODE>
+<DD><DT><CODE>--append</CODE>
+<DD><EM>Append</EM> the resource use information to the output file instead
+of overwriting it. This option is only useful with the `<SAMP>-o</SAMP>' or
+`<SAMP>--output</SAMP>' option.
+</DL>
+<P>
+
+<A NAME="Examples"></A>
+<HR SIZE="6">
+<A NAME="SEC9"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC8"> &lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC10"> &gt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> &lt;&lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 1.4 Examples </H2>
+<!--docid::SEC9::-->
+<P>
+
+Run the command `<SAMP>wc /etc/hosts</SAMP>' and show the default information:
+</P>
+<P>
+
+<TABLE><tr><td>&nbsp;</td><td class=example><pre>eg$ time wc /etc/hosts
+ 35 111 1134 /etc/hosts
+0.00user 0.01system 0:00.04elapsed 25%CPU (0avgtext+0avgdata 0maxresident)k
+1inputs+1outputs (0major+0minor)pagefaults 0swaps
+</pre></td></tr></table><P>
+
+Run the command `<SAMP>ls -Fs</SAMP>' and show just the user, system, and
+wall-clock time:
+</P>
+<P>
+
+<TABLE><tr><td>&nbsp;</td><td class=example><pre>eg$ time -f &quot;\t%E real,\t%U user,\t%S sys&quot; ls -Fs
+total 16
+1 account/ 1 db/ 1 mail/ 1 run/
+1 backups/ 1 emacs/ 1 msgs/ 1 rwho/
+1 crash/ 1 games/ 1 preserve/ 1 spool/
+1 cron/ 1 log/ 1 quotas/ 1 tmp/
+ 0:00.03 real, 0.00 user, 0.01 sys
+</pre></td></tr></table><P>
+
+Edit the file `<TT>.bashrc</TT>' and have <CODE>time</CODE> append the elapsed time
+and number of signals to the file `<TT>log</TT>', reading the format string
+from the environment variable <CODE>TIME</CODE>:
+</P>
+<P>
+
+<TABLE><tr><td>&nbsp;</td><td class=example><pre>eg$ export TIME=&quot;\t%E,\t%k&quot; # If using bash or ksh
+eg$ setenv TIME &quot;\t%E,\t%k&quot; # If using csh or tcsh
+eg$ time -a -o log emacs .bashrc
+eg$ cat log
+ 0:16.55, 726
+</pre></td></tr></table><P>
+
+Run the command `<SAMP>sleep 4</SAMP>' and show all of the information about it
+verbosely:
+</P>
+<P>
+
+<TABLE><tr><td>&nbsp;</td><td class=example><pre>eg$ time -v sleep 4
+ Command being timed: &quot;sleep 4&quot;
+ User time (seconds): 0.00
+ System time (seconds): 0.05
+ Percent of CPU this job got: 1%
+ Elapsed (wall clock) time (h:mm:ss or m:ss): 0:04.26
+ Average shared text size (kbytes): 36
+ Average unshared data size (kbytes): 24
+ Average stack size (kbytes): 0
+ Average total size (kbytes): 60
+ Maximum resident set size (kbytes): 32
+ Average resident set size (kbytes): 24
+ Major (requiring I/O) page faults: 3
+ Minor (reclaiming a frame) page faults: 0
+ Voluntary context switches: 11
+ Involuntary context switches: 0
+ Swaps: 0
+ File system inputs: 3
+ File system outputs: 1
+ Socket messages sent: 0
+ Socket messages received: 0
+ Signals delivered: 1
+ Page size (bytes): 4096
+ Exit status: 0
+</pre></td></tr></table><P>
+
+<A NAME="Accuracy"></A>
+<HR SIZE="6">
+<A NAME="SEC10"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC9"> &lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC11"> &gt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> &lt;&lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 1.5 Accuracy </H2>
+<!--docid::SEC10::-->
+<P>
+
+The elapsed time is not collected atomically with the execution of the
+program; as a result, in bizarre circumstances (if the <CODE>time</CODE>
+command gets stopped or swapped out in between when the program being
+timed exits and when <CODE>time</CODE> calculates how long it took to run), it
+could be much larger than the actual execution time.
+</P>
+<P>
+
+When the running time of a command is very nearly zero, some values
+(e.g., the percentage of CPU used) may be reported as either zero (which
+is wrong) or a question mark.
+</P>
+<P>
+
+Most information shown by <CODE>time</CODE> is derived from the <CODE>wait3</CODE>
+system call. The numbers are only as good as those returned by
+<CODE>wait3</CODE>. Many systems do not measure all of the resources that
+<CODE>time</CODE> can report on; those resources are reported as zero. The
+systems that measure most or all of the resources are based on 4.2 or
+4.3BSD. Later BSD releases use different memory management code that
+measures fewer resources.
+</P>
+<P>
+
+On systems that do not have a <CODE>wait3</CODE> call that returns status
+information, the <CODE>times</CODE> system call is used instead. It provides
+much less information than <CODE>wait3</CODE>, so on those systems <CODE>time</CODE>
+reports most of the resources as zero.
+</P>
+<P>
+
+The `<SAMP>%I</SAMP>' and `<SAMP>%O</SAMP>' values are allegedly only &quot;real&quot; input
+and output and do not include those supplied by caching devices. The
+meaning of &quot;real&quot; I/O reported by `<SAMP>%I</SAMP>' and `<SAMP>%O</SAMP>' may be
+muddled for workstations, especially diskless ones.
+</P>
+<P>
+
+<A NAME="Invoking time"></A>
+<HR SIZE="6">
+<A NAME="SEC11"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC10"> &lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt; ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> &lt;&lt; </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ &gt;&gt; ]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT"> &nbsp; <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H2> 1.6 Running the <CODE>time</CODE> Command </H2>
+<!--docid::SEC11::-->
+<P>
+
+The format of the <CODE>time</CODE> command is:
+</P>
+<P>
+
+<TABLE><tr><td>&nbsp;</td><td class=example><pre>time [option<small>...</small>] <VAR>command</VAR> [<VAR>arg</VAR><small>...</small>]
+</pre></td></tr></table><P>
+
+<A NAME="IDX5"></A>
+<CODE>time</CODE> runs the program <VAR>command</VAR>, with any given arguments
+<VAR>arg</VAR><small>...</small>. When <VAR>command</VAR> finishes, <CODE>time</CODE> displays
+information about resources used by <VAR>command</VAR> (on the standard error
+output, by default). If <VAR>command</VAR> exits with non-zero status or is
+terminated by a signal, <CODE>time</CODE> displays a warning message and the
+exit status or signal number.
+</P>
+<P>
+
+Options to <CODE>time</CODE> must appear on the command line before
+<VAR>command</VAR>. Anything on the command line after <VAR>command</VAR> is
+passed as arguments to <VAR>command</VAR>.
+</P>
+<P>
+
+</P>
+<DL COMPACT>
+<DT><CODE>-o <VAR>file</VAR></CODE>
+<DD><DT><CODE>--output=<VAR>file</VAR></CODE>
+<DD>Write the resource use statistics to <VAR>file</VAR>.
+<P>
+
+</P>
+<DT><CODE>-a</CODE>
+<DD><DT><CODE>--append</CODE>
+<DD><EM>Append</EM> the resource use information to the output file instead
+of overwriting it.
+<P>
+
+</P>
+<DT><CODE>-f <VAR>format</VAR></CODE>
+<DD><DT><CODE>--format=<VAR>format</VAR></CODE>
+<DD>Use <VAR>format</VAR> as the format string.
+<P>
+
+</P>
+<DT><CODE>--help</CODE>
+<DD>Print a summary of the command line options to <CODE>time</CODE> and exit.
+<P>
+
+</P>
+<DT><CODE>-p</CODE>
+<DD><DT><CODE>--portability</CODE>
+<DD>Use the POSIX format.
+<P>
+
+</P>
+<DT><CODE>-v</CODE>
+<DD><DT><CODE>--verbose</CODE>
+<DD><A NAME="IDX6"></A>
+Use the built-in verbose format.
+<P>
+
+</P>
+<DT><CODE>-V</CODE>
+<DD><DT><CODE>--version</CODE>
+<DD><A NAME="IDX7"></A>
+Print the version number of <CODE>time</CODE> and exit.
+</DL>
+<P>
+
+<HR SIZE="6">
+<A NAME="SEC_Contents"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H1>Table of Contents</H1>
+<BLOCKQUOTE>
+<A NAME="TOC1" HREF="time.html#SEC1">1. Measuring Program Resource Use</A>
+<BR>
+<BLOCKQUOTE>
+<A NAME="TOC2" HREF="time.html#SEC2">1.1 Setting the Output Format</A>
+<BR>
+<A NAME="TOC3" HREF="time.html#SEC3">1.2 The Format String</A>
+<BR>
+<BLOCKQUOTE>
+<A NAME="TOC4" HREF="time.html#SEC4">1.2.1 Time Resources</A>
+<BR>
+<A NAME="TOC5" HREF="time.html#SEC5">1.2.2 Memory Resources</A>
+<BR>
+<A NAME="TOC6" HREF="time.html#SEC6">1.2.3 I/O Resources</A>
+<BR>
+<A NAME="TOC7" HREF="time.html#SEC7">1.2.4 Command Info</A>
+<BR>
+</BLOCKQUOTE>
+<A NAME="TOC8" HREF="time.html#SEC8">1.3 Redirecting Output</A>
+<BR>
+<A NAME="TOC9" HREF="time.html#SEC9">1.4 Examples</A>
+<BR>
+<A NAME="TOC10" HREF="time.html#SEC10">1.5 Accuracy</A>
+<BR>
+<A NAME="TOC11" HREF="time.html#SEC11">1.6 Running the <CODE>time</CODE> Command</A>
+<BR>
+</BLOCKQUOTE>
+</BLOCKQUOTE>
+<HR SIZE=1>
+<A NAME="SEC_OVERVIEW"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H1>Short Table of Contents</H1>
+<BLOCKQUOTE>
+<A NAME="TOC1" HREF="time.html#SEC1">1. Measuring Program Resource Use</A>
+<BR>
+
+</BLOCKQUOTE>
+<HR SIZE=1>
+<A NAME="SEC_About"></A>
+<TABLE CELLPADDING=1 CELLSPACING=1 BORDER=0>
+<TR><TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top">Top</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Contents">Contents</A>]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[Index]</TD>
+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_About"> ? </A>]</TD>
+</TR></TABLE>
+<H1>About this document</H1>
+This document was generated
+by
+using <A HREF="http://texi2html.cvshome.org"><I>texi2html</I></A>
+<P></P>
+The buttons in the navigation panels have the following meaning:
+<P></P>
+<table border = "1">
+<TR>
+<TH> Button </TH>
+<TH> Name </TH>
+<TH> Go to </TH>
+<TH> From 1.2.3 go to</TH>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [ &lt; ] </TD>
+<TD ALIGN="CENTER">
+Back
+</TD>
+<TD>
+previous section in reading order
+</TD>
+<TD>
+1.2.2
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [ &gt; ] </TD>
+<TD ALIGN="CENTER">
+Forward
+</TD>
+<TD>
+next section in reading order
+</TD>
+<TD>
+1.2.4
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [ &lt;&lt; ] </TD>
+<TD ALIGN="CENTER">
+FastBack
+</TD>
+<TD>
+beginning of this chapter or previous chapter
+</TD>
+<TD>
+1
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [ Up ] </TD>
+<TD ALIGN="CENTER">
+Up
+</TD>
+<TD>
+up section
+</TD>
+<TD>
+1.2
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [ &gt;&gt; ] </TD>
+<TD ALIGN="CENTER">
+FastForward
+</TD>
+<TD>
+next chapter
+</TD>
+<TD>
+2
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [Top] </TD>
+<TD ALIGN="CENTER">
+Top
+</TD>
+<TD>
+cover (top) of document
+</TD>
+<TD>
+ &nbsp;
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [Contents] </TD>
+<TD ALIGN="CENTER">
+Contents
+</TD>
+<TD>
+table of contents
+</TD>
+<TD>
+ &nbsp;
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [Index] </TD>
+<TD ALIGN="CENTER">
+Index
+</TD>
+<TD>
+concept index
+</TD>
+<TD>
+ &nbsp;
+</TD>
+</TR>
+<TR>
+<TD ALIGN="CENTER">
+ [ ? ] </TD>
+<TD ALIGN="CENTER">
+About
+</TD>
+<TD>
+this page
+</TD>
+<TD>
+ &nbsp;
+</TD>
+</TR>
+</TABLE>
+ <P>
+ where the <STRONG> Example </STRONG> assumes that the current position
+ is at <STRONG> Subsubsection One-Two-Three </STRONG> of a document of
+ the following structure:</P>
+ <UL>
+ <LI> 1. Section One
+ <UL>
+ <LI>1.1 Subsection One-One
+ <UL>
+ <LI>...</LI>
+ </UL>
+ <LI>1.2 Subsection One-Two
+ <UL>
+ <LI>1.2.1 Subsubsection One-Two-One</LI>
+ <LI>1.2.2 Subsubsection One-Two-Two</LI>
+ <LI>1.2.3 Subsubsection One-Two-Three &nbsp; &nbsp;
+ <STRONG>&lt;== Current Position </STRONG></LI>
+ <LI>1.2.4 Subsubsection One-Two-Four</LI>
+ </UL>
+ </LI>
+ <LI>1.3 Subsection One-Three
+ <UL>
+ <LI>...</LI>
+ </UL>
+ </LI>
+ <LI>1.4 Subsection One-Four</LI>
+ </UL>
+ </LI>
+ </UL>
+
+<HR SIZE=1>
+<BR>
+<FONT SIZE="-1">
+This document was generated
+by <I>root</I> on <I>September, 1 2003</I>
+using <A HREF="http://texi2html.cvshome.org"><I>texi2html</I></A>
+</FONT>
+
+</BODY>
+</HTML>
View Git Blame Copy Permalink