timex(1) - osol9

1timex(1)                         User Commands                        timex(1)
2
3
4

NAME

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

SYNOPSIS

9       timex [-o] [-p [-fhkmrt]] [-s] command
10
11

DESCRIPTION

13       The  given  command is executed; the elapsed time, user time and system
14       time spent in execution are reported in  seconds.  Optionally,  process
15       accounting  data  for the command and all its children can be listed or
16       summarized, and total system activity during the execution interval can
17       be reported.
18
19
20       The output of timex is written on standard error.
21

OPTIONS

23       The following options are supported:
24
25       -o    Report the total number of blocks read or written and total char‐
26             acters transferred by  command and all its children. This  option
27             works only if the process accounting software is installed.
28
29
30       -p    List process accounting records for command and all its children.
31             This option works only if  the  process  accounting  software  is
32             installed. Suboptions  f, h, k, m, r, and t modify the data items
33             reported. The options are as follows:
34
35             -f    Print the fork(2)/ exec(2) flag and system exit status col‐
36                   umns in the output.
37
38
39             -h    Instead  of  mean  memory  size, show the fraction of total
40                   available CPU time consumed by the process during its  exe‐
41                   cution.  This  ``hog  factor''  is  computed  as (total CPU
42                   time)/(elapsed time).
43
44
45             -k    Instead of memory size, show total kcore-minutes.
46
47
48             -m    Show mean core size (the default).
49
50
51             -r    Show CPU factor (user time/(system-time + user-time)).
52
53
54             -t    Show separate system and user  CPU  times.  The  number  of
55                   blocks  read or written and the number of characters trans‐
56                   ferred are always reported.
57
58
59
60       -s    Report total system activity (not just that due to  command) that
61             occurred  during  the execution interval of command. All the data
62             items listed in  sar(1) are reported.
63
64

EXAMPLES

66       Example 1 Examples of timex.
67
68
69       A simple example:
70
71
72         example% timex -ops sleep 60
73
74
75
76
77       A terminal session of arbitrary complexity can be measured by timing  a
78       sub-shell:
79
80
81         example% timex -opskmt sh
82               session commands
83         EOT
84
85
86

ATTRIBUTES

88       See attributes(5) for descriptions of the following attributes:
89
90
91
92
93       ┌─────────────────────────────┬─────────────────────────────┐
94       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
95       ├─────────────────────────────┼─────────────────────────────┤
96       │Availability                 │SUNWaccu                     │
97       └─────────────────────────────┴─────────────────────────────┘
98

NOTES

103       Process  records associated with command are selected from the account‐
104       ing file /var/adm/pacct by inference, since process  genealogy  is  not
105       available.  Background  processes having the same user ID, terminal ID,
106       and execution time window will be spuriously included.
107
108
109
110SunOS 5.11                        14 Sep 1992                         timex(1)