TIMES(1POSIX)

📦 version 2017a, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 TIMES(1POSIX) 💖

okay so bestie, welcome to the POSIX Programmer's Manual — this one's TIMES(1POSIX) and it's honestly a whole vibe ✨

🌸 PROLOG 🌸

okay real talk before we get into it: this page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ (so like, go check the corresponding Linux manual page for the actual deets on Linux behavior), or — plot twist — the interface might not even be implemented on Linux at all. 🙈

🎀 NAME 🎀

times — write process times ⏱️

✨ SYNOPSIS ✨

times

that's it. that's the whole thing. no flags, no args, she's low maintenance 💅

🦋 DESCRIPTION 🦋

So times shall write the accumulated user and system times — for the shell itself AND for all of its child processes. yes, all of them. the whole family. 👑

It comes out in the POSIX locale format, which looks like this:

"%dm%fs %dm%fs\n%dm%fs %dm%fs\n", <shell user minutes>,
    <shell user seconds>, <shell system minutes>,
    <shell system seconds>, <children user minutes>,
    <children user seconds>, <children system minutes>,
    <children system seconds>

and the four pairs of times? they shall correspond to the members of the <sys/times.h> tms structure (defined in the Base Definitions volume of POSIX.1‐2017, Chapter 13, Headers) as returned by times(), in this exact order:

  • tms_utime
  • tms_stime
  • tms_cutime
  • tms_cstime

respectively. in that order. no cap. 🫶

🌈 OPTIONS 🌈

None.

literally none. she doesn't do options. iconic behavior honestly.

🍓 OPERANDS 🍓

None.

🧚 STDIN 🧚

Not used.

💜 INPUT FILES 💜

None.

⭐ ENVIRONMENT VARIABLES ⭐

None.

🔥 ASYNCHRONOUS EVENTS 🔥

Default.

💖 STDOUT 💖

See the DESCRIPTION. (scroll up bestie, it's all there 🫶)

🎀 STDERR 🎀

The standard error shall be used only for diagnostic messages.

🦋 OUTPUT FILES 🦋

None.

✨ EXTENDED DESCRIPTION ✨

None.

🌸 EXIT STATUS 🌸

  • 0 — Successful completion. slay. 💅
  • >0 — An error occurred. 😭

🌈 CONSEQUENCES OF ERRORS 🌈

Default.

The following sections are informative. 👀 (translation: this is the bonus content, not the binding rules)

🍓 APPLICATION USAGE 🍓

None.

🧚 EXAMPLES 🧚

$ times
0m0.43s 0m1.11s
8m44.18s 1m43.23s

look at her go 😌✨

💜 RATIONALE 💜

The times special built-in from the Single UNIX Specification is now required for all conforming shells. periodt. no opting out. 👑

⭐ FUTURE DIRECTIONS ⭐

None.

🔥 SEE ALSO 🔥

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

Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html .

Any typographical or formatting errors that appear in this page are most likely to have been introduced during the conversion of the source files to man page format. To report such errors, see https://www.kernel.org/doc/man-pages/reporting_bugs.html .

and that's the whole page bestie 🫶 this one's brought to you by IEEE/The Open Group, dated 2017, and the page itself is TIMES(1POSIX) — go touch some grass now, you've earned it 🌱💖

📦 where this page comes from