logo

utils-std

Collection of commonly available Unix tools git clone https://anongit.hacktivis.me/git/utils-std.git

time.1 (1094B)


  1. .\" utils-std: Collection of commonly available Unix tools
  2. .\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
  3. .\" SPDX-License-Identifier: MPL-2.0
  4. .Dd 2022-12-01
  5. .Dt TIME 1
  6. .Os
  7. .Sh NAME
  8. .Nm time
  9. .Nd measure time used by a command
  10. .Sh SYNOPSIS
  11. .Nm
  12. .Op Fl p Ns | Ns Fl v
  13. .Ar command
  14. .Op Ar argument...
  15. .Sh DESCRIPTION
  16. .Nm
  17. measures the wall-clock time, user CPU time, system/kernel CPU time, used by
  18. .Ar command
  19. and outputs it to stderr.
  20. .Sh OPTIONS
  21. .Bl -tag -width _p
  22. .It Fl p
  23. (default) Output in POSIX format.
  24. .It Fl v
  25. Detailed output.
  26. .El
  27. .Sh EXIT STATUS
  28. If
  29. .Ar command
  30. is invoked, the exit status should be the one given by
  31. .Ar command .
  32. Otherwise, it will exit with the following values:
  33. .Bl -tag -width 1-125
  34. .It 1-125
  35. An error occurred in
  36. .Ar command
  37. .It 126
  38. .Ar command
  39. was found but couldn't be invoked
  40. .It 127
  41. .Ar command
  42. could not be found
  43. .El
  44. .Sh SEE ALSO
  45. .Xr getrusage 3 ,
  46. .Xr times 3
  47. .Sh STANDARDS
  48. .Nm
  49. should be compliant with the
  50. IEEE Std 1003.1-2024 (“POSIX.1”)
  51. specification.
  52. .Sh AUTHORS
  53. .An Haelwenn (lanodan) Monnier Aq Mt contact+utils@hacktivis.me