Lines Matching +full:embedded +full:- +full:trace +full:- +full:extension

1 .\"-
2 .\" SPDX-License-Identifier: BSD-3-Clause
68 .St -p1003.1
86 addition to data storage, along with built-in history and line
90 language is common to both interactive and non-interactive
110 .Pq Ql - ,
144 The first non-option argument specified on the command line
160 closes a well-known, and sometimes easily exploitable security
183 built-in command
185 .Sx Built-in Commands ) .
187 .Pq Ql -
193 .Dq Li --
195 .Ql -
204 .Bl -tag -width indent
215 Enable the built-in
222 Exit immediately if any untested command fails in non-interactive mode.
249 A do-nothing option for POSIX compliance.
263 In a non-interactive shell,
311 .St -p1003.2 .
317 .Bd -literal -offset indent
318 sh -T -c "trap 'exit 1' 2 ; some-blocking-program"
328 Enable the built-in
345 Another do-nothing option for POSIX compliance.
348 Change the exit status of a pipeline to the last non-zero exit status of
352 counts as a non-zero exit status,
353 this option may cause non-zero exit status for successful pipelines
373 argument, hence multi-word strings must be quoted.
381 both enable the built-in
384 .Bd -literal -offset indent
385 set -E
386 set -o emacs
391 option displays the current option settings in a human-readable format.
395 in a format suitable for re-input into the shell.
406 .Bl -tag -width indent
408 .Bl -column "XXX" "XXX" "XXX" "XXX" "XXX" -offset center -compact
413 .Bl -column "XXX" "XXX" "XXX" "XXX" "XXX" -offset center -compact
415 .It Li <& Ta Li >& Ta Li <<- Ta Li >| Ta \&
435 dollar-single quotes,
437 .Bl -tag -width indent
441 it impossible to put single-quotes in a single-quoted string).
442 .It Dollar-Single Quotes
449 A backslash introduces a C-style escape sequence:
450 .Bl -tag -width xUnnnnnnnn
478 Literal single-quote
480 Literal double-quote
500 UTF-8 locales.
501 They reject code point 0 and UTF-16 surrogates.
504 that byte and the rest of the string until the matching single-quote
520 .Bl -column "XXX" "XXX" "XXX" "XXX" "XXX" -offset center -compact
534 .Bl -column "doneXX" "elifXX" "elseXX" "untilXX" "whileX" -offset center
542 built-in command.
550 .Dq Li "ls -F" ,
557 .Dl "ls -F foobar"
571 .Dl "nohup ls -F foobar"
585 an alias name with a backslash to execute a function, built-in, or
594 .St -p1003.2
605 .Bl -enum
639 .D1 Oo Ar n Oc Ar redir-op file
642 .Ar redir-op
649 .Bl -tag -width "1234567890XX" -offset indent
679 .It Oo Ar n Oc Ns Li <&-
687 .It Oo Ar n Oc Ns Li >&-
693 .Dq here-document .
694 .Bd -unfilled -offset indent
696 .Ar here-doc-text
709 .Ar here-doc-text
715 .Dq Li <<-
720 .Ar here-doc-text
724 built-in commands, and normal programs.
742 Shell built-in commands are executed internally to the shell, without
744 There are two kinds of built-in commands: regular and special.
753 or built-in command, the command is searched for as a normal
780 built-in command by that name.
781 If a built-in command is not found,
783 .Bl -enum
806 with zero for normal or success, and non-zero for failure,
810 Additionally, the built-in commands return exit codes, as does
815 .Li kill -l .
825 .Bl -item -offset indent
831 list or compound-list
881 or the last non-zero exit status of any command in the pipeline otherwise.
904 AND-OR-list
906 .Sx Short-Circuit List Operators )
910 causes asynchronous execution of the preceding AND-OR-list.
939 .Ss Short-Circuit List Operators
943 are AND-OR list operators.
954 .Ss Flow-Control Constructs (if, while, for, case)
958 .Bd -unfilled -offset indent -compact
977 .Bd -unfilled -offset indent -compact
1000 .Bd -unfilled -offset indent -compact
1042 These are implemented as special built-in commands.
1047 .Bd -unfilled -offset indent -compact
1080 .Bd -literal -offset indent
1086 .Bd -literal -offset indent
1092 .Bl -enum
1135 .Bd -literal -offset indent
1136 { echo -n "hello"; echo " world"; } > greeting
1167 command is implemented as a built-in command.
1195 .Ql - .
1197 .Ql -
1219 command is implemented as a special built-in command.
1250 built-in commands that have this form.
1262 built-in command can also be used to set or reset them.
1268 .Bl -hang
1272 the expansion occurs within a double-quoted string
1283 the expansion occurs within double-quotes, each positional
1290 is double-quoted.
1304 .Bd -literal -offset indent
1311 .It Li $-
1312 (hyphen) Expands to the current option flags (the single-letter
1316 built-in command, or implicitly
1333 built-in command reports completion of the process.
1345 .Bl -tag -width ".Va HISTSIZE"
1349 built-in.
1353 built-in.
1359 built-in.
1375 built-in.
1430 .Bl -tag -width indent
1442 This system's fully-qualified hostname (FQDN).
1460 Start of a sequence of non-printing characters (used, for example,
1463 End of a sequence of non-printing characters.
1466 The following special and non-printing characters are supported
1467 within the sequence of non-printing characters:
1468 .Bl -tag -width indent
1485 The prefix for the trace output (if
1506 within double-quotes,
1510 .Bl -enum
1557 escaped by a backslash or within a single-quoted or double-quoted
1559 embedded arithmetic expansions, command substitutions, and variable
1564 .Ql - ,
1568 occur within a double-quoted string,
1569 as an extension there may be unquoted parts
1570 (via double-quotes inside the expansion);
1587 If a parameter expansion occurs inside double-quotes:
1588 .Bl -enum
1600 .Bl -tag -width indent
1601 .It Li ${ Ns Ar parameter Ns Li :- Ns Ar word Ns Li }
1661 (unquoted, double-quoted or here-document)
1665 .Bl -tag -width indent
1685 Enclosing the full parameter expansion string in double-quotes does not
1688 .Bl -tag -width indent
1746 Embedded newlines before the end of the output are not removed;
1752 except that the built-in commands
1781 is treated as if it were in double-quotes, except
1782 that a double-quote inside the expression is not treated specially.
1793 .Bl -tag -width "Variables" -offset indent
1807 .Li "! ~ + -"
1809 .Li "* / % + - << >> < <= > >= == != & ^ | && ||"\&
1811 .Li "= += -= *= /= %= <<= >>= &= ^= |="
1821 expansions and substitutions that did not occur in double-quotes for
1841 .Bl -enum
1843 a non-whitespace character in
1853 If a word ends with a non-whitespace character in
1886 and meta-characters.
1887 The meta-characters are
1894 or back quotes are not double-quoted, the value of the
1896 characters and they are turned into meta-characters.
1917 A locale-dependent range of characters may be specified using a minus sign.
1932 has the same effect but is non-standard.
1943 .Ql - ,
1945 .Ss Built-in Commands
1946 This section lists the built-in commands.
1947 .Bl -tag -width indent
1970 A built-in equivalent of
1986 built-in command prints the names and values of all defined aliases
1990 suitable for re-input to the shell.
2004 .Sx Flow-Control Constructs
2007 Execute the specified built-in command,
2010 with the same name as a built-in command.
2086 built-in command.
2111 For ordinary commands the output is the path name; for shell built-in
2137 .Sx Flow-Control Constructs
2140 Print a space-separated list of the arguments to the standard output
2142 .Bl -tag -width indent
2146 Process C-style backslash escape sequences.
2150 .Bl -tag -width indent
2156 Suppress the trailing newline (this has the side-effect of truncating the
2182 .Bd -literal -offset indent
2183 $ echo -e "a\evb"
2186 $ echo -e a\e\evb
2189 $ echo -e "a\e\eb"
2191 $ echo -e a\e\e\e\eb
2203 Then re-parse and execute the command.
2209 (which must be a real program, not a shell built-in command or function).
2233 The only way to un-export a variable is to
2249 lines, suitable for re-input to the shell.
2251 A null command that returns a non-zero (false) exit value.
2257 built-in command lists, or edits and re-executes,
2259 .Bl -tag -width indent
2309 Re-execute the command without invoking an editor.
2322 .Bl -tag -width indent
2334 For example, \-1 is the immediately previous command.
2342 the string form of the first operand cannot contain an embedded equal sign.
2348 .Bl -tag -width ".Va HISTSIZE"
2427 A built-in equivalent of
2435 A built-in equivalent of
2439 The built-in command may
2441 built-in command remembers what the current directory
2447 the built-in version of
2542 option is specified, the read-only variables are printed as
2544 lines, suitable for re-input to the shell.
2550 .Oc Op Fl - Ar arg ...
2554 .Bl -item
2566 .Dq Fl -
2572 .Dq Fl -
2578 .Dq Fl -
2583 .Pq Ql -
2624 A built-in equivalent of
2639 In addition, the pseudo-signal
2647 .Pq Ql - ;
2715 .Bl -tag -width indent
2719 The maximal size of core dump files, in 512-byte blocks.
2726 The maximal size of a file, in 512-byte blocks.
2740 The maximal number of process-shared locks
2745 The maximal number of pseudo-terminals for this user ID.
2807 .Sx Built-in Commands )
2809 .Nm vi Ns -mode
2816 .Dq Li "set -o vi"
2818 .Dq Li "set -V" )
2820 .Nm vi Ns -mode
2827 .Nm vi Ns -mode
2837 .Dq Li "set -o emacs"
2839 .Dq Li "set -E" )
2841 .Nm emacs Ns -style
2846 .Bl -tag -width ".Ev LANGXXXXXX"
2872 .Bl -tag -width "/etc/suid_profileXX" -compact
2888 cause the shell to exit with a non-zero exit status.
2939 utility does not recognize multibyte characters other than UTF-8.