bash-hackers-wiki/docs/commands/builtin/trap.md
Hanson Char b75c3a588b Fix hyperlinks of markdown pages at depth 3
find docs/ -depth 3  -name '*.md' | xargs grep '(.*/' -l | \
  xargs -I{} \
  sed -i '' \
  -e 's%(/\([^/#).][^/#).]*\)/\([^/#).][^/#).]*\)\(.md\)\{0\})%(../../\1/\2.md)%g' \
  -e 's%(/\([^/#).][^/#).]*\)/\([^/#).][^/#).]*\)#\([a-zA-Z_-][0-9a-zA-Z_-]*\))%(../../\1/\2.md#\3)%g' \
  -e 's%(/\([^/#).][^/#).]*\)/\([^/#).][^/#).]*\)/\([^/#).][^/#).]*\)\(.md\)\{0\})%(../../\1/\2/\3.md)%g' \
  -e 's%(/\([^/#).][^/#).]*\)/\([^/#).][^/#).]*\)/\([^/#).][^/#).]*\)#\([a-zA-Z_-][0-9a-zA-Z_-]*\))%(../../\1/\2/\3.md#\4)%g' \
  -e 's%](\([^:.>)#][^:.>)#]*\))%](../../\1.md)%g' \
  -e 's%](\([^:.>)#][^:.>)#]*\)#\([^:.>)#][^:.>)#]*\))%](../../\1.md#\2)%g' \
  {}

Related to https://github.com/flokoe/bash-hackers-wiki/issues/10
2024-01-28 17:26:57 -08:00

2.3 KiB

The trap builtin command

Synopsis

trap [-lp] [[ARGUMENT] SIGNAL]

Description

The trap command is used to "trap" signals and other events. In this context, "trapping" means to install handler code.

The shell code ARGUMENT is to be read and executed whenever the shell receives a signal or another event SIGNAL. The given SIGNAL specification can be

  • the name of a signal with the SIG prefix, e.g. SIGTERM
  • the name of a signal without the SIG prefix, e.g. TERM
  • the number of a signal (see trap -l), e.g. 15
  • the name or number of a special event (see table below), e.g. EXIT

Without any options or operands, trap prints a list of installed traps in a reusable format (equivalent to the -p option).

Special ARGUMENTs

  • if ARGUMENT is absent or - (dash), the signal/event handler is reset to its original value
  • if ARGUMENT is the null string, the signal/event is ignored

Special events

Name Code Description


EXIT 0 executed on shell exit DEBUG executed before every simple command RETURN executed when a shell function or a sourced code finishes executing ERR executed each time a command's failure would cause the shell to exit when the -e option (errexit) is enabled

Options

Option Description


-l print a list of signal names and their corresponding numbers -p display the trap commands associated with each signal specification in a reusable format

Return status

Status Reason


0 no error/success !=0 invalid option !=0 invalid signal specification

Examples

List installed traps

trap

Ignore terminal interrupt (Ctrl-C, SIGINT)

trap '' INT

Portability considerations

  • trap is specified by POSIX(R) without the -l and -p options
  • in POSIX(R), beside signals, only EXIT (0) is valid as an event

See also