unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 timex(1)							    timex(1)




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

 SYNOPSIS
      timex [-o] [-p[fhkmrt]] [-s] command

 DESCRIPTION
      timex 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 timex 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
	   -o		  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 software is installed.

	   -p[fhkmrt]	  List process accounting records for command and
			  all its children.  The suboptions f, h, k, m, r,
			  and t modify the data items reported.	 They behave
			  as defined in acctcom(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 /usr/lib/acct/turnacct
			  has been invoked to create /var/adm/pacct.

	   -s		  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:

	   timex -ops sleep 60

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

	   timex -opskmt sh
		session commands
	   EOT



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 timex(1)							    timex(1)




 WARNINGS
      Process records associated with command are selected from the
      accounting file /var/adm/pacct 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: SVID2, SVID3











































 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000