bash-hackers-wiki/docs/commands/builtin/exit.md

# The exit builtin command

## Synopsis

    exit [N]

## Description

The `exit` command terminates the current shell (or script).

If `N` is given, the return code to the parent process is set to `N`. If
not, the returned status the the status of the most recently executed
command (i.e. `$?`).

A [trap](../../commands/builtin/trap.md) on `EXIT` is executed before the shell
exits, except the executed `exit` command is part of an already running
trap.

### Options

There are no options.

### Exit status

Naturally, you can't ask for the exit status from within the shell that
executed the `exit` command, because the shell exits.

|Status|Reason|
|------|------|
|255|invalid (e.g. non-numeric) argument - this staus is returned to the parent|

## Examples

### Exit the shell and explicitely set its exit status

    exit 3

## Portability considerations

-   if `N` is specified, but its value is not between 0 and 255
    inclusively, the exit status is undefined.

## See also

-   [The trap builtin command](../../commands/builtin/trap.md)
-   [The exit status](../../dict/exit_status.md)
Convert all builtin commands to Markdown 2023-07-05 10:53:12 +02:00			`# The exit builtin command`

			`## Synopsis`

			`exit [N]`

			`## Description`

			The `exit` command terminates the current shell (or script).

			If `N` is given, the return code to the parent process is set to `N`. If
			`not, the returned status the the status of the most recently executed`
			command (i.e. `$?`).

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-29 02:07:56 +01:00			A [trap](../../commands/builtin/trap.md) on `EXIT` is executed before the shell
Convert all builtin commands to Markdown 2023-07-05 10:53:12 +02:00			exits, except the executed `exit` command is part of an already running
			`trap.`

			`### Options`

			`There are no options.`

			`### Exit status`

format(docs): remove escaped t's 2024-03-30 20:09:26 +01:00			`Naturally, you can't ask for the exit status from within the shell that`
Convert all builtin commands to Markdown 2023-07-05 10:53:12 +02:00			executed the `exit` command, because the shell exits.

missed some table formatting in last commit. 2024-10-19 00:57:25 +02:00			`\|Status\|Reason\|`
			`\|------\|------\|`
			`\|255\|invalid (e.g. non-numeric) argument - this staus is returned to the parent\|`
Convert all builtin commands to Markdown 2023-07-05 10:53:12 +02:00
			`## Examples`

			`### Exit the shell and explicitely set its exit status`

			`exit 3`

			`## Portability considerations`

			- if `N` is specified, but its value is not between 0 and 255
			`inclusively, the exit status is undefined.`

			`## See also`

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-29 02:07:56 +01:00			`- [The trap builtin command](../../commands/builtin/trap.md)`
Fix "relative links target not found" warnings 2024-04-02 23:19:23 +02:00			`- [The exit status](../../dict/exit_status.md)`