1TIMES(1P)                  POSIX Programmer's Manual                 TIMES(1P)
2
3
4

PROLOG

6       This  manual  page is part of the POSIX Programmer's Manual.  The Linux
7       implementation of this interface may differ (consult the  corresponding
8       Linux  manual page for details of Linux behavior), or the interface may
9       not be implemented on Linux.
10

NAME

12       times — write process times
13

SYNOPSIS

15       times
16

DESCRIPTION

18       The times utility shall write the accumulated user and system times for
19       the  shell  and  for all of its child processes, in the following POSIX
20       locale format:
21
22
23           "%dm%fs %dm%fs\n%dm%fs %dm%fs\n", <shell user minutes>,
24               <shell user seconds>, <shell system minutes>,
25               <shell system seconds>, <children user minutes>,
26               <children user seconds>, <children system minutes>,
27               <children system seconds>
28
29       The four pairs  of  times  shall  correspond  to  the  members  of  the
30       <sys/times.h>  tms structure (defined in the Base Definitions volume of
31       POSIX.1‐2017, Chapter 13, Headers) as returned by  times():  tms_utime,
32       tms_stime, tms_cutime, and tms_cstime, respectively.
33

OPTIONS

35       None.
36

OPERANDS

38       None.
39

STDIN

41       Not used.
42

INPUT FILES

44       None.
45

ENVIRONMENT VARIABLES

47       None.
48

ASYNCHRONOUS EVENTS

50       Default.
51

STDOUT

53       See the DESCRIPTION.
54

STDERR

56       The standard error shall be used only for diagnostic messages.
57

OUTPUT FILES

59       None.
60

EXTENDED DESCRIPTION

62       None.
63

EXIT STATUS

65        0    Successful completion.
66
67       >0    An error occurred.
68

CONSEQUENCES OF ERRORS

70       Default.
71
72       The following sections are informative.
73

APPLICATION USAGE

75       None.
76

EXAMPLES

78       $ times
79       0m0.43s 0m1.11s
80       8m44.18s 1m43.23s
81

RATIONALE

83       The  times  special  built-in from the Single UNIX Specification is now
84       required for all conforming shells.
85

FUTURE DIRECTIONS

87       None.
88

SEE ALSO

90       Section 2.14, Special Built-In Utilities
91
92       The Base Definitions volume of POSIX.1‐2017, <sys_times.h>
93

95       Portions of this text are reprinted and reproduced in  electronic  form
96       from  IEEE Std 1003.1-2017, Standard for Information Technology -- Por‐
97       table Operating System Interface (POSIX), The Open Group Base  Specifi‐
98       cations  Issue  7, 2018 Edition, Copyright (C) 2018 by the Institute of
99       Electrical and Electronics Engineers, Inc and The Open Group.   In  the
100       event of any discrepancy between this version and the original IEEE and
101       The Open Group Standard, the original IEEE and The Open Group  Standard
102       is  the  referee document. The original Standard can be obtained online
103       at http://www.opengroup.org/unix/online.html .
104
105       Any typographical or formatting errors that appear  in  this  page  are
106       most likely to have been introduced during the conversion of the source
107       files to man page format. To report such errors,  see  https://www.ker‐
108       nel.org/doc/man-pages/reporting_bugs.html .
109
110
111
112IEEE/The Open Group                  2017                            TIMES(1P)
Impressum