diff options
| author | Denys Dmytriyenko <denis@denix.org> | 2009-03-17 14:32:59 -0400 |
|---|---|---|
| committer | Denys Dmytriyenko <denis@denix.org> | 2009-03-17 14:32:59 -0400 |
| commit | 709c4d66e0b107ca606941b988bad717c0b45d9b (patch) | |
| tree | 37ee08b1eb308f3b2b6426d5793545c38396b838 /packages/time/files | |
| parent | fa6cd5a3b993f16c27de4ff82b42684516d433ba (diff) | |
rename packages/ to recipes/ per earlier agreement
See links below for more details:
http://thread.gmane.org/gmane.comp.handhelds.openembedded/21326
http://thread.gmane.org/gmane.comp.handhelds.openembedded/21816
Signed-off-by: Denys Dmytriyenko <denis@denix.org>
Acked-by: Mike Westerhof <mwester@dls.net>
Acked-by: Philip Balister <philip@balister.org>
Acked-by: Khem Raj <raj.khem@gmail.com>
Acked-by: Marcin Juszkiewicz <hrw@openembedded.org>
Acked-by: Koen Kooi <koen@openembedded.org>
Acked-by: Frans Meulenbroeks <fransmeulenbroeks@gmail.com>
Diffstat (limited to 'packages/time/files')
| -rw-r--r-- | packages/time/files/debian.patch | 1299 |
1 files changed, 0 insertions, 1299 deletions
diff --git a/packages/time/files/debian.patch b/packages/time/files/debian.patch deleted file mode 100644 index 40df19da45..0000000000 --- a/packages/time/files/debian.patch +++ /dev/null @@ -1,1299 +0,0 @@ ---- 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> </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> </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> </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> </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> </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> </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> </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> </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> </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> </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> </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"> < </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC2"> > </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[ << ]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <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> </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> </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> </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> </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> </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> </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> </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> </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"> < </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC3"> > </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> << </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <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> </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> </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"> < </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC4"> > </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> << </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <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> </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> </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> </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> </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"> < </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC5"> > </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> << </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <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"> < </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC6"> > </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> << </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <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"> < </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC7"> > </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> << </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <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"> < </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC8"> > </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> << </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <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"> < </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC9"> > </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC1"> << </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[<A HREF="time.html#SEC_Top"> Up </A>]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT">[ >> ]</TD> -+<TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <TD VALIGN="MIDDLE" ALIGN="LEFT"> <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> |