From a443014e94b4283b0c14d1c88c498e16ccff6edf Mon Sep 17 00:00:00 2001 From: FRIGN Date: Thu, 5 Mar 2015 00:22:36 +0100 Subject: [PATCH] Add time(1) manpage --- time.1 | 47 +++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 45 insertions(+), 2 deletions(-) diff --git a/time.1 b/time.1 index 5cab06b..16ace9f 100644 --- a/time.1 +++ b/time.1 @@ -1,6 +1,49 @@ -.Dd February 28, 2015 +.Dd March 5, 2015 .Dt TIME 1 .Os sbase .Sh NAME .Nm time -.Nd TODO +.Nd time a command +.Sh SYNOPSIS +.Nm +.Op Fl p +.Ar cmd +.Op Ar arg ... +.Sh DESCRIPTION +.Nm +executes +.Ar cmd +and writes timing statistics to stderr after it finishes. +The statistics include the elapsed real time +between invocation and termination and the user +and system CPU time (see +.Xr times 2 ) . +.Sh OPTIONS +.Bl -tag -width Ds +.It Fl p +Use the format "real %f\enuser %f\ensys %f\en" for printing. +This is the default. +.El +.Sh EXIT STATUS +.Bl -tag -width Ds +.It 0 +.Ar cmd +executed successfully. +.It 1 +Internal error. +.It 126 +.Ar cmd +was found but could not be executed. +.It 127 +.Ar cmd +could not be found. +.El +.Sh SEE ALSO +.Xr times 2 , +.Xr waitpid 2 +.Sh STANDARDS +The +.Nm +utility is compliant with the +.St -p1003.1-2008 +specification.