169 lines
5.9 KiB
Text
169 lines
5.9 KiB
Text
$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
|