summaryrefslogtreecommitdiffstats
path: root/time
diff options
context:
space:
mode:
authorLukc <lukc@upyum.com>2010-12-11 19:15:23 +0100
committerLukc <lukc@upyum.com>2010-12-11 19:15:35 +0100
commit6d908a38e05b9d4135c65d23114a5874215b5bb8 (patch)
treeb5e6da6d95b9a1235d82032b509b80483a886ff5 /time
downloadbase-6d908a38e05b9d4135c65d23114a5874215b5bb8.tar.gz
base-6d908a38e05b9d4135c65d23114a5874215b5bb8.tar.bz2
base-6d908a38e05b9d4135c65d23114a5874215b5bb8.tar.xz
base-6d908a38e05b9d4135c65d23114a5874215b5bb8.zip
Engagement initial.
Diffstat (limited to 'time')
-rw-r--r--time/.footprint6
-rw-r--r--time/.md5sum2
-rw-r--r--time/Pkgfile20
-rw-r--r--time/Pkgfile.old18
-rw-r--r--time/time.1270
5 files changed, 316 insertions, 0 deletions
diff --git a/time/.footprint b/time/.footprint
new file mode 100644
index 0000000..a3f8961
--- /dev/null
+++ b/time/.footprint
@@ -0,0 +1,6 @@
+drwxr-xr-x root/root usr/
+drwxr-xr-x root/root usr/bin/
+-rwxr-xr-x root/root usr/bin/time
+drwxr-xr-x root/root usr/man/
+drwxr-xr-x root/root usr/man/man1/
+-rw-r--r-- root/root usr/man/man1/time.1.gz
diff --git a/time/.md5sum b/time/.md5sum
new file mode 100644
index 0000000..224e24e
--- /dev/null
+++ b/time/.md5sum
@@ -0,0 +1,2 @@
+e38d2b8b34b1ca259cf7b053caac32b3 time-1.7.tar.gz
+99e5fb64056521a3cacb95e74f5e527f time.1
diff --git a/time/Pkgfile b/time/Pkgfile
new file mode 100644
index 0000000..ffc2636
--- /dev/null
+++ b/time/Pkgfile
@@ -0,0 +1,20 @@
+description="Measures many of the CPU resources that programs use"
+packager=""
+maintainer="CRUX System Team, core-ports at crux dot nu"
+url="http://www.gnu.org/software/time/"
+depends=()
+
+name=time
+version=1.7
+release=1
+source=(http://ftp.gnu.org/gnu/time/time-1.7.tar.gz time.1)
+build ()
+{
+ cd $name-$version;
+ ./configure --prefix=/usr;
+ make;
+ make prefix=$PKG/usr install;
+ rm -rf $PKG/usr/info;
+ mkdir -p $PKG/usr/man/man1;
+ cp ../$name.1 $PKG/usr/man/man1
+}
diff --git a/time/Pkgfile.old b/time/Pkgfile.old
new file mode 100644
index 0000000..19d5095
--- /dev/null
+++ b/time/Pkgfile.old
@@ -0,0 +1,18 @@
+# Description: Measures many of the CPU resources that programs use
+# URL: http://www.gnu.org/software/time/
+# Maintainer: CRUX System Team, core-ports at crux dot nu
+
+name=time
+version=1.7
+release=1
+source=(http://ftp.gnu.org/gnu/$name/$name-$version.tar.gz $name.1)
+
+build() {
+ cd $name-$version
+ ./configure --prefix=/usr
+ make
+ make prefix=$PKG/usr install
+ rm -rf $PKG/usr/info
+ mkdir -p $PKG/usr/man/man1
+ cp ../$name.1 $PKG/usr/man/man1
+}
diff --git a/time/time.1 b/time/time.1
new file mode 100644
index 0000000..29d1265
--- /dev/null
+++ b/time/time.1
@@ -0,0 +1,270 @@
+.\" Copyright Andries Brouwer, 2000
+.\"
+.\" This page is distributed under GPL.
+.\" Some fragments of text came from the time-1.7 info file.
+.\" Inspired by kromJx@crosswinds.net.
+.\"
+.TH TIME 1 "11 December 2000" "" ""
+.SH NAME
+time \- time a simple command or give resource usage
+.SH SYNOPSIS
+.BI "time [" options "] " command " [" arguments... "] "
+.SH DESCRIPTION
+The
+.B time
+command runs the specified program
+.I command
+with the given arguments.
+When
+.I command
+finishes,
+.B time
+writes a message to standard output giving timing statistics
+about this program run.
+These statistics consist of (i) the elapsed real time
+between invocation and termination, (ii) the user CPU time
+(the sum of the
+.I tms_utime
+and
+.I tms_cutime
+values in a
+.I "struct tms"
+as returned by
+.BR times (2)),
+and (iii) the system CPU time (the sum of the
+.I tms_stime
+and
+.I tms_cstime
+values in a
+.I "struct tms"
+as returned by
+.BR times (2)).
+.SH OPTION
+.TP
+.B \-p
+When in the POSIX locale, use the precise traditional format
+.br
+.in +5
+"real %f\enuser %f\ensys %f\en"
+.in -5
+.br
+(with numbers in seconds)
+where the number of decimals in the output for %f is unspecified
+but is sufficient to express the clock tick accuracy, and at least one.
+.SH ENVIRONMENT
+The variables LANG, LC_ALL, LC_CTYPE, LC_MESSAGES, LC_NUMERIC,
+NLSPATH and PATH are used. The last one to search for
+.IR command .
+The remaining ones for the text and formatting of the output.
+.SH "EXIT STATUS"
+If
+.I command
+was invoked, the exit status is that of
+.IR command .
+Otherwise it is 127 if
+.I command
+could not be found, 126 if it could be found but could not be invoked,
+and some other nonzero value (1-125) if something else went wrong.
+.SH "SEE ALSO"
+.BR times (2),
+.sp 2
+.SH "GNU VERSION"
+Below a description of the GNU 1.7 version of
+.BR time .
+Disregarding the name of the utility, GNU makes it output lots of
+useful information, not only about time used, but also on other
+resources like memory, I/O and IPC calls (where available).
+The output is formatted using a format string that can be specified
+using the \-f option or the TIME environment variable.
+.LP
+The default format string is
+.br
+.in +3
+%Uuser %Ssystem %Eelapsed %PCPU (%Xtext+%Ddata %Mmax)k
+.br
+%Iinputs+%Ooutputs (%Fmajor+%Rminor)pagefaults %Wswaps
+.br
+.in -3
+.LP
+When the \-p option is given the (portable) output format
+.br
+.in +3
+real %e
+.br
+user %U
+.br
+sys %S
+.br
+.in -3
+is used.
+.SS "The format string"
+The format is interpreted in the usual printf-like way.
+Ordinary characters are directly copied, tab, newline
+and backslash are escaped using \et, \en and \e\e,
+a percent sign is represented by %%, and otherwise %
+indicates a conversion. The program
+.B time
+will always add a trailing newline itself.
+The conversions follow. All of those used by
+.BR tcsh (1)
+are supported.
+.LP
+.B "Time"
+.TP
+.B %E
+Elapsed real time (in [hours:]minutes:seconds).
+.TP
+.B %e
+(Not in tcsh.) Elapsed real time (in seconds).
+.TP
+.B %S
+Total number of CPU-seconds that the process spent in kernel mode.
+.TP
+.B %U
+Total number of CPU-seconds that the process spent in user mode.
+.TP
+.B %P
+Percentage of the CPU that this job got, computed as (%U + %S) / %E.
+.LP
+.B "Memory"
+.TP
+.B %M
+Maximum resident set size of the process during its lifetime, in Kbytes.
+.TP
+.B %t
+(Not in tcsh.) Average resident set size of the process, in Kbytes.
+.TP
+.B %K
+Average total (data+stack+text) memory use of the process,
+in Kbytes.
+.TP
+.B %D
+Average size of the process's unshared data area, in Kbytes.
+.TP
+.B %p
+(Not in tcsh.) Average size of the process's unshared stack space, in Kbytes.
+.TP
+.B %X
+Average size of the process's shared text space, in Kbytes.
+.TP
+.B %Z
+(Not in tcsh.) System's page size, in bytes.
+This is a per-system constant, but varies between systems.
+.TP
+.B %F
+Number of major page faults that occurred while the process was running.
+These are faults where the page has to be read in from disk.
+.TP
+.B %R
+Number of minor, or recoverable, page faults.
+These are faults for pages that are not valid 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.
+.TP
+.B %W
+Number of times the process was swapped out of main memory.
+.TP
+.B %c
+Number of times the process was context-switched involuntarily
+(because the time slice expired).
+.TP
+.B %w
+Number of waits: times that the program was context-switched voluntarily,
+for instance while waiting for an I/O operation to complete.
+.LP
+.B "I/O"
+.TP
+.B %I
+Number of file system inputs by the process.
+.TP
+.B %O
+Number of file system outputs by the process.
+.TP
+.B %r
+Number of socket messages received by the process.
+.TP
+.B %s
+Number of socket messages sent by the process.
+.TP
+.B %k
+Number of signals delivered to the process.
+.TP
+.B %C
+(Not in tcsh.) Name and command line arguments of the command being timed.
+.TP
+.B %x
+(Not in tcsh.) Exit status of the command.
+.SH "GNU OPTIONS"
+.TP
+.BI "\-f " FORMAT ", \-\-format=" FORMAT
+Specify output format, possibly overriding the format specified
+in the environment variable TIME.
+.TP
+.B "\-p, \-\-portability"
+Use the portable output format.
+.TP
+.BI "\-o " FILE ", \-\-output=" FILE
+Do not send the results to stderr, but overwrite the specified file.
+.TP
+.B "\-a, \-\-append"
+(Used together with \-o.) Do not overwrite but append.
+.TP
+.B "\-v, \-\-verbose"
+Give very verbose output about all the program knows about.
+.SH "GNU STANDARD OPTIONS"
+.TP
+.B "\-\-help"
+Print a usage message on standard output and exit successfully.
+.TP
+.B "\-V, \-\-version"
+Print version information on standard output, then exit successfully.
+.TP
+.B "\-\-"
+Terminate option list.
+.SH BUGS
+Not all resources are measured by all versions of Unix,
+so some of the values might be reported as zero.
+The present selection was mostly inspired by the data
+provided by 4.2 or 4.3BSD.
+.LP
+GNU time version 1.7 is not yet localized.
+Thus, it does not implement the POSIX requirements.
+.LP
+The environment variable TIME was badly chosen.
+It is not unusual for systems like autoconf or make
+to use environment variables with the name of a utility to override
+the utility to be used. Uses like MORE or TIME for options to programs
+(instead of program path names) tend to lead to difficulties.
+.LP
+It seems unfortunate that \-o overwrites instead of appends.
+(That is, the \-a option should be the default.)
+.LP
+Mail suggestions and bug reports for GNU
+.B time
+to
+.br
+.I bug-utils@prep.ai.mit.edu
+.br
+Please include the version of
+.B time ,
+which you can get by running
+.br
+.I time --version
+.br
+and the operating system
+and C compiler you used.
+.SH "SEE ALSO"
+.BR tcsh (1),
+.BR times (2),
+.BR wait3 (2)
+.SH AUTHORS
+.TP
+.IP "David Keppel"
+Original version
+.IP "David MacKenzie"
+POSIXization, autoconfiscation, GNU getoptization,
+documentation, other bug fixes and improvements.
+.IP "Arne Henrik Juul"
+Helped with portability
+.IP "Francois Pinard"
+Helped with portability