Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
timex(1)			 User Commands			      timex(1)

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

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

DESCRIPTION
       The  given  command is executed;	the elapsed time, user time and	system
       time spent in execution are reported in	seconds.  Optionally,  process
       accounting  data	 for the 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 standard error.

OPTIONS
       The following options are supported:

       -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 in-
		stalled.

       -p	List process accounting	records	for command and	all its	 chil-
		dren.  This  option works only if the process accounting soft-
		ware is	installed. Suboptions  f, h, k,	m, r, and t modify the
		data items reported. The options are as	follows:

		-f	 Print	the fork(2)/ exec(2) flag and system exit sta-
			 tus columns in	the output.

		-h	 Instead of mean memory	size, show the fraction	of to-
			 tal available CPU time	consumed by the	process	during
			 its execution.	This ``hog  factor''  is  computed  as
			 (total	CPU time)/(elapsed time).

		-k	 Instead of memory size, show total kcore-minutes.

		-m	 Show mean core	size (the default).

		-r	 Show  CPU  factor  (user  time/(system-time  +	 user-
			 time)).

		-t	 Show separate system and user CPU times.  The	number
			 of  blocks  read or written and the number of charac-
			 ters transferred are always reported.

       -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(1) are reported.

EXAMPLES
       Example 1: Examples of timex.

       A simple	example:

       example%	timex -ops sleep 60

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

       example%	timex -opskmt sh
	     session commands
       EOT

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWaccu			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       sar(1), time(1),	exec(2), fork(2), times(2), attributes(	5)

NOTES
       Process	records	associated with	command	are selected from the account-
       ing 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 will be spuriously included.

SunOS 5.10			  14 Sep 1992			      timex(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=timex&sektion=1&manpath=SunOS+5.10>

home | help