From 6d908a38e05b9d4135c65d23114a5874215b5bb8 Mon Sep 17 00:00:00 2001 From: Lukc Date: Sat, 11 Dec 2010 19:15:23 +0100 Subject: Engagement initial. --- time/.footprint | 6 ++ time/.md5sum | 2 + time/Pkgfile | 20 +++++ time/Pkgfile.old | 18 ++++ time/time.1 | 270 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 316 insertions(+) create mode 100644 time/.footprint create mode 100644 time/.md5sum create mode 100644 time/Pkgfile create mode 100644 time/Pkgfile.old create mode 100644 time/time.1 (limited to 'time') 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 -- cgit v1.2.3-54-g00ecf