170 lines
5.9 KiB
Plaintext
170 lines
5.9 KiB
Plaintext
$NetBSD: patch-aa,v 1.1.1.1 2004/05/27 21:52:46 reed Exp $
|
|
|
|
--- time.info.orig 2004-04-30 12:16:05.573682624 -0700
|
|
+++ time.info 2004-04-30 12:16:10.970862128 -0700
|
|
@@ -1,5 +1,9 @@
|
|
-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.6 from time.texi.
|
|
+
|
|
+INFO-DIR-SECTION Individual utilities
|
|
+START-INFO-DIR-ENTRY
|
|
+* time: (time). Report resource utilization.
|
|
+END-INFO-DIR-ENTRY
|
|
|
|
This file documents the the GNU `time' command for running programs
|
|
and summarizing the system resources they use.
|
|
@@ -31,7 +35,7 @@
|
|
|
|
* Resource Measurement:: Measuring program resource use.
|
|
|
|
- -- The Detailed Node Listing --
|
|
+ --- The Detailed Node Listing ---
|
|
|
|
Measuring Program Resource Use
|
|
|
|
@@ -55,17 +59,17 @@
|
|
Measuring Program Resource Use
|
|
******************************
|
|
|
|
- The `time' command runs another program, then displays information
|
|
+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:
|
|
|
|
@@ -105,8 +109,8 @@
|
|
Setting the Output Format
|
|
=========================
|
|
|
|
- `time' uses a "format string" to determine which information to
|
|
-display about the resources used by the command it runs. *Note Format
|
|
+`time' uses a "format string" to determine which information to display
|
|
+about the resources used by the command it runs. *Note Format
|
|
String::, for the interpretation of the format string contents.
|
|
|
|
You can specify a format string with the command line options listed
|
|
@@ -144,7 +148,7 @@
|
|
The Format String
|
|
=================
|
|
|
|
- The "format string" controls the contents of the `time' output. It
|
|
+The "format string" controls the contents of the `time' output. It
|
|
consists of "resource specifiers" and "escapes", interspersed with
|
|
plain text.
|
|
|
|
@@ -174,7 +178,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:
|
|
|
|
@@ -299,20 +303,20 @@
|
|
Redirecting Output
|
|
==================
|
|
|
|
- By default, `time' 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 `time'
|
|
-noninteractively or in the background.
|
|
+By default, `time' 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 `time' noninteractively or in
|
|
+the background.
|
|
|
|
`-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.
|
|
|
|
@@ -384,11 +388,11 @@
|
|
Accuracy
|
|
========
|
|
|
|
- The elapsed time is not collected atomically with the execution of
|
|
-the program; as a result, in bizarre circumstances (if the `time'
|
|
-command gets stopped or swapped out in between when the program being
|
|
-timed exits and when `time' calculates how long it took to run), it
|
|
-could be much larger than the actual execution time.
|
|
+The elapsed time is not collected atomically with the execution of the
|
|
+program; as a result, in bizarre circumstances (if the `time' command
|
|
+gets stopped or swapped out in between when the program being timed
|
|
+exits and when `time' calculates how long it took to run), it could be
|
|
+much larger than the actual execution time.
|
|
|
|
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
|
|
@@ -417,7 +421,7 @@
|
|
Running the `time' Command
|
|
==========================
|
|
|
|
- The format of the `time' command is:
|
|
+The format of the `time' command is:
|
|
|
|
time [option...] COMMAND [ARG...]
|
|
|
|
@@ -437,7 +441,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 +466,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: Top1054
|
|
+Node: Resource Measurement1847
|
|
+Node: Setting Format3794
|
|
+Node: Format String5020
|
|
+Node: Time Resources6323
|
|
+Node: Memory Resources6953
|
|
+Node: I/O Resources7658
|
|
+Node: Command Info8856
|
|
+Node: Redirecting9073
|
|
+Node: Examples9860
|
|
+Node: Accuracy12170
|
|
+Node: Invoking time13689
|
|
|
|
End Tag Table
|