timex(1)						      General Commands Manual							  timex(1)

NAME

       timex - time a command; report process data and system activity

SYNOPSIS

       command

DESCRIPTION

       reports	in  seconds  the elapsed time, user time, and system time spent in execution of the given command.  Optionally, process accounting
       data for command and all its children can be listed or summarized, and total system activity during the execution interval can be reported.

       The output of is written on the standard error. Timex returns an exit status of 1 if it is used incorrectly, if it is unable to fork, or if
       it could not exec command . Otherwise, timex returns the exit status of command.

   Options
	      Report the total number of blocks read or written and
			     total  characters transferred by command and all its children. This option works only if the process accounting soft-
			     ware is installed.

	      List process accounting records for
			     command and all its children.  The suboptions and modify the data items reported.	They behave as	defined  in  acct-
			     com(1M).  The number of blocks read or written and the number of characters transferred are always reported.

			     This option works only if the process accounting software is installed and has been invoked to create

	      Report total system activity (not just that due to
			     command) that occurred during the execution interval of command.  All the data items listed in sar(1M) are reported.

EXAMPLES

       A simple example:

       A terminal session of arbitrary complexity can be measured by timing a sub-shell:

		   session commands
	      EOT

WARNINGS

       Process	records  associated  with  command  are  selected from the accounting file by inference, since process genealogy is not available.
       Background processes having the same user-ID, terminal-ID, and execution time window are spuriously included.

SEE ALSO

       sar(1M), acctcom(1M).

STANDARDS CONFORMANCE

																	  timex(1)