3/15/72                                                    TM (I)





NAME            tm  --  provide time information



SYNOPSIS        tm [ command arg  .... ]
                                1


DESCRIPTION     tm is used to provide timing information.  When

                used without an argument, output like the follow-

                ing is given:



                        tim 371:51:09     2:00.8

                        ovh  20:00:33       17.0

                        swp  13:43:20        4.6

                        dsk  27:14:35        4.5

                        idl 533:08:03     1:33.3

                        usr  24:53:50        1.2

                        der    0,  54     0,   0



                The first column of numbers gives totals in the

                named categories since the last time the system

                was cold-booted;  the second column gives the

                changes since the last time tm was invoked.  The

                tim row is total real time

                (hours:minutes:seconds); unlike the other times,

                its origin is the creation date of tm's temporary

                file.  ovh is time spent executing in the system;

                swp is time waiting for swap I/O; dsk is time

                spent waiting for file system disk I/O; idl is

                idle time; usr is user execution time; der is RF

                disk error count (left number) and RK disk error

                count (right number).



                tm can be invoked with arguments which are as-

                sumed to constitute a command to be timed.  In

                this case the output is as follows:



                      tim        2.7

                      ovh        0.3

                      swp        0.5

                      dsk        1.8

                      idl        0.0

                      usr        0.0



                The given times represent the number of seconds

                spent in each category during execution of the

                command.



FILES           /tmp/ttmp, /dev/rf0 (for absolute times) contains

                the information used to calculate the differen-

                tial times.



SEE ALSO        file system(V)



DIAGNOSTICS     "?" if the command cannot be executed; "can't

                creat temp file" if trouble with ttmp; "cant read

                super-block" if times cannot be read from system.



BUGS            (1) when invoked with a command argument, every-

                thing going on at the moment is counted, not just

                the command itself.  (2) Two users doing tm si-

                multaneously interfere with each other's use of

                the temporary file.



OWNER           ken, dmr