Formatting Syntax

The format string controls how to show every entry in the history. It consists of resource specifiers (described below) and plain text.

It is based on the GNU time, and most format strings for GNU time should be usable here.

Specifiers

The following resource specifiers are accepted in the format string:

Specifiers	Header	Description
`\\`		A backslash.
`\e`		An ESC character.
`\n`		A newline.
`\t`		A tab character.
`\u{H*}`		A Unicode character.
`%%`		A literal '%'.
`%(pid)`	`PID`	Process identifier.
`%(sys_time_us)`	`SYSTIME`	System (kernel) time (microseconds).
`%(time:FORMAT)`	`STARTED`	Start time with a custom format.
`%(user_time_us)`	`USERTIME`	User time (microseconds).
`%C` `%(args)`	`COMMAND`	Command name and arguments.
`%c` `%(nivcsw)`	`IVCSW`	Involuntary context switches.
`%E`	`ELAPSED`	Elapsed real (wall clock) time in [hour:]min:sec.
`%e`	`ELAPSED`	Elapsed real time in seconds.
`%F` `%(majflt)`	`MAJFL`	Major page faults (required physical I/O).
`%I` `%(inblock)`	`FSIN`	File system inputs.
`%M` `%(maxrss)`	`MAXRSS`	Maximum resident set size in Kib.
`%n`	`NUMBER`	Entry number in the history.
`%N` `%(filename)`	`FILENAME`	Filename of the executable.
`%O` `%(oublock)`	`FSOUT`	File system outputs.
`%P` `%(cpu)`	`%CPU`	Percent of CPU this job got.
`%R` `%(minflt)`	`MINFL`	Minor page faults (reclaims; no physical I/O involved).
`%S` `%(sys_time)`	`SYSTIME`	System (kernel) time (seconds).
`%Tn`	`SIGNAL`	Signal number, if terminated by a signal.
`%Tt`	`EXTYPE`	Termination type: normal, signalled, stopped.
`%Tx`	`EXIT`	Exit code, if terminated normally.
`%u`	`ELAPSED`	Elapsed real time in microseconds.
`%U` `%(user_time)`	`USERTIME`	User time (seconds).
`%w` `%(nvcsw)`	`VCSW`	Voluntary context switches.
`%x` `%(status)`	`STATUS`	Exit status of command.

Options are surrounded by brackets at the beginning of the format string. There are two valid options:

header

Print a header containing the field labels.
table

Render the history list as a table. Columns are separated by the tab character.

Example:

[header,table]%n\t%e\t%C

The syntax for the %(time) specifier is from the chrono library.

Examples:

%(time:%F %X)     YYYY-MM-DD hh:mm:ss
%(time:%+)        ISO-8601.
%(time:%s)        UNIX timestamp.