tldr/pages/linux/trap.md

21 lines
415 B
Markdown
Raw Normal View History

# 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>.
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`):
`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:
`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:
`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:
`trap - {{SIGHUP}} {{SIGINT}}`