Linux / Unix: time Command Examples

time command

I am new Linux and Unix systems user. How do I display the time of the execution of a command/script on Linux or Unix-like operating systems using shell prompt?

You need to use the time command to display the elapsed time during the execution of a command or script.[donotprint]

time command details
DescriptionReport time consumed by
command execution
CategoryN/A
DifficultyEasy
Root privilegesNo
Estimated completion time10m
Contents
[/donotprint]The time command show the following information on screen (on the standard error output, by default) about resources used by command:

  1. real time
  2. user time
  3. sys time

Purpose

Run command/programs or script and summarize system resource usage

Syntax

The basic syntax is as follows:

time command

OR

time command arg1 arg2 ... argN

OR

time [options] command arg1 arg2 ... argN

Note: The time command is also built into the BASH/KSH/CSH/TCSH with a different syntax. To run the time command while in the shells, type:

/usr/bin/time -p command/usr/bin/time -p command arg1 arg2

time command examples

To measure the time required to run a program called date, enter:
$ time date
OR
$ /usr/bin/time -p date
Sample outputs:
time command demo

How do I redirect time command output to a file?

The syntax is as follows to save a record of the time command information in a file called output.time.txt, run:

time date 2> output.time.txt
/usr/bin/time -p date 2> output.time.txt

If above command failed, try the following to save a record of the time command information in a file:

( time date ) 2> output.time.txt
## OR ##
{ time date ; } 2> output.time.txt

Use the cat command to display output on screen:
$ cat output.time.txt

A note about GNU/Linux time command

GNU/Linux user can use the following syntax to write the resource use statistics to file instead of to the standard error stream:
$ /usr/bin/time -o output.time.txt -p date
$ cat output.time.txt

Pass the -a option to append the resource use information to the output file instead of overwriting it. This option is only useful with the -o option:
$ /usr/bin/time -a -o output.time.txt -p sleep 2
$ cat output.time.txt

You can control time command output format using -f FORMAT as follows:
$ /usr/bin/time -f 'FORMAT' -p command
Use FORMAT as the format string that controls the output of time as follows:

Fomat Meaning
 %  A literal `%’.
 C  Name and command line arguments of the command being timed.
 D  Average size of the process’s unshared data area, in Kilobytes.
 E  Elapsed real (wall clock) time used by the process, in [hours:]minutes:seconds.
 F  Number of major, or I/O-requiring, page faults that occurred while the process was running. These are faults where the page has actually migrated out of primary memory.
 I  Number of file system inputs by the process.
 K  Average total (data+stack+text) memory use of the process, in Kilobytes.
 M  Maximum resident set size of the process during its lifetime, in Kilobytes.
 O  Number of file system outputs by the process.
 P  Percentage of the CPU that this job got. This is just user + system times divided by the total running time. It also prints a percentage sign.
 R  Number of minor, or recoverable, page faults. These are pages that are not valid (so they fault) but which have not yet been claimed by other virtual pages. Thus the data in the page is still valid but the system tables must be updated.
 S  Total number of CPU-seconds used by the system on behalf of the process (in kernel mode), in seconds.
 U  Total number of CPU-seconds that the process used directly (in user mode), in seconds.
 W  Number of times the process was swapped out of main memory.
 X  Average amount of shared text in the process, in Kilobytes.
 Z  System’s page size, in bytes. This is a per-system constant, but varies between systems.
 c  Number of times the process was context-switched involuntarily (because the time slice expired).
 e  Elapsed real (wall clock) time used by the process, in seconds.
 k  Number of signals delivered to the process.
 p  Average unshared stack size of the process, in Kilobytes.
 r  Number of socket messages received by the process.
 s  Number of socket messages sent by the process.
 t  Average resident set size of the process, in Kilobytes.
 w  Number of times that the program was context-switched voluntarily, for instance while waiting for an I/O operation to complete.
 x  Exit status of the command.

In this example, show just the user, system, and total time using format option:
$ /usr/bin/time -f "%E real,%U user,%S sys" sleep 2
$ /usr/bin/time -f "%E real,%U user,%S sys" /path/to/script

Sample outputs:

0:02.00 real,0.00 user,0.00 sys
See also
  • time(1) Linux/Unix command man page
🐧 If you liked this page, please support my work on Patreon or with a donation.
🐧 Get the latest tutorials on SysAdmin, Linux/Unix, Open Source/DevOps topics:
CategoryList of Unix and Linux commands
File Managementcat
FirewallAlpine Awall CentOS 8 OpenSUSE RHEL 8 Ubuntu 16.04 Ubuntu 18.04 Ubuntu 20.04
Network Utilitiesdig host ip nmap
OpenVPNCentOS 7 CentOS 8 Debian 10 Debian 8/9 Ubuntu 18.04 Ubuntu 20.04
Package Managerapk apt
Processes Managementbg chroot cron disown fg jobs killall kill pidof pstree pwdx time
Searchinggrep whereis which
User Informationgroups id lastcomm last lid/libuser-lid logname members users whoami who w
WireGuard VPNAlpine CentOS 8 Debian 10 Firewall Ubuntu 20.04
3 comments… add one
  • Revanth kumar Jan 15, 2015 @ 0:56

    Why are we using /usr/bin/time? when not using any options simply writing time is working but when should we go for /usr/bin/time when using options? This is working but i dont understand the logic. when :
    time -o output.txt ls //is used i am getting error as no bash command -o
    /usr/bin/time -o output.txt ls //is working fine

    • Revanth kumar Jan 15, 2015 @ 1:03

      Got the answer. time simply referes to time command of bash which has no options. /usr/bin/time referes to the time command which this tutorial is speaking about. bash time command help: help time, normal time command help: man time

  • sudhakar Aug 28, 2020 @ 10:54

    I use for bench marking, say, browsers:

    $cat cost.sh
    /usr/bin/time -f '------------------\nPrice of %C:\nKB %M\nSwitches %w\n------------------' $@

    Price of firefox:
    KB       117300
    Switches 1636
    

Leave a Reply

Your email address will not be published. Required fields are marked *

Use HTML <pre>...</pre>, <code>...</code> and <kbd>...</kbd> for code samples.