2023-12-29 13:07:58 +00:00
|
|
|
# trap
|
|
|
|
|
common/*: update pages of some POSIX special built-in utilities (#11956)
* exec, export, readonly, set, shift, trap: replace command descriptions
* exec, exit, export, readonly, set, shift, trap, exec, export: replace example descriptions
* exec, trap: replace "More information" links
* trap: remove prefix "SIG" from some command arguments
Although POSIX allows implementations to specify signal names without
the prefix "SIG", I will choose the most portable form.
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* set: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exec: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exit: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* readonly: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* set: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* shift: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* trap: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exec: explain environment of child process
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
---------
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
2024-01-07 22:38:34 +00:00
|
|
|
> Execute a command upon an event.
|
|
|
|
> More information: <https://www.gnu.org/software/bash/manual/bash.html#index-trap>.
|
2023-12-29 13:07:58 +00:00
|
|
|
|
common/*: update pages of some POSIX special built-in utilities (#11956)
* exec, export, readonly, set, shift, trap: replace command descriptions
* exec, exit, export, readonly, set, shift, trap, exec, export: replace example descriptions
* exec, trap: replace "More information" links
* trap: remove prefix "SIG" from some command arguments
Although POSIX allows implementations to specify signal names without
the prefix "SIG", I will choose the most portable form.
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* set: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exec: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exit: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* readonly: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* set: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* shift: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* trap: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exec: explain environment of child process
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
---------
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
2024-01-07 22:38:34 +00:00
|
|
|
- List the available event names (e.g. `SIGWINCH`):
|
2023-12-29 13:07:58 +00:00
|
|
|
|
|
|
|
`trap -l`
|
|
|
|
|
common/*: update pages of some POSIX special built-in utilities (#11956)
* exec, export, readonly, set, shift, trap: replace command descriptions
* exec, exit, export, readonly, set, shift, trap, exec, export: replace example descriptions
* exec, trap: replace "More information" links
* trap: remove prefix "SIG" from some command arguments
Although POSIX allows implementations to specify signal names without
the prefix "SIG", I will choose the most portable form.
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* set: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exec: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exit: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* readonly: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* set: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* shift: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* trap: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exec: explain environment of child process
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
---------
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
2024-01-07 22:38:34 +00:00
|
|
|
- List the commands and the names of the expected events:
|
2023-12-29 13:07:58 +00:00
|
|
|
|
|
|
|
`trap -p`
|
|
|
|
|
common/*: update pages of some POSIX special built-in utilities (#11956)
* exec, export, readonly, set, shift, trap: replace command descriptions
* exec, exit, export, readonly, set, shift, trap, exec, export: replace example descriptions
* exec, trap: replace "More information" links
* trap: remove prefix "SIG" from some command arguments
Although POSIX allows implementations to specify signal names without
the prefix "SIG", I will choose the most portable form.
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* set: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exec: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exit: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* readonly: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* set: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* shift: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* trap: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exec: explain environment of child process
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
---------
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
2024-01-07 22:38:34 +00:00
|
|
|
- Execute a command when a signal is received:
|
2023-12-29 13:07:58 +00:00
|
|
|
|
|
|
|
`trap 'echo "Caught signal {{SIGHUP}}"' {{SIGHUP}}`
|
|
|
|
|
common/*: update pages of some POSIX special built-in utilities (#11956)
* exec, export, readonly, set, shift, trap: replace command descriptions
* exec, exit, export, readonly, set, shift, trap, exec, export: replace example descriptions
* exec, trap: replace "More information" links
* trap: remove prefix "SIG" from some command arguments
Although POSIX allows implementations to specify signal names without
the prefix "SIG", I will choose the most portable form.
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* set: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace term
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exec: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exit: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* export: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* readonly: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* set: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* shift: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* trap: replace Open Group link
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
* exec: explain environment of child process
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
---------
Co-authored-by: Vitor Henrique <87824454+vitorhcl@users.noreply.github.com>
2024-01-07 22:38:34 +00:00
|
|
|
- Remove commands:
|
2023-12-29 13:07:58 +00:00
|
|
|
|
|
|
|
`trap - {{SIGHUP}} {{SIGINT}}`
|