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.
241 Note that many commands return non-zero values to convey information other
247 A do-nothing option for POSIX compliance.
261 In a non-interactive shell,
309 .St -p1003.2 .
315 .Bd -literal -offset indent
316 sh -T -c "trap 'exit 1' 2 ; some-blocking-program"
326 Enable the built-in
343 Another do-nothing option for POSIX compliance.
346 Change the exit status of a pipeline to the last non-zero exit status of
350 counts as a non-zero exit status,
351 this option may cause non-zero exit status for successful pipelines
371 argument, hence multi-word strings must be quoted.
379 both enable the built-in
382 .Bd -literal -offset indent
383 set -E
384 set -o emacs
389 option displays the current option settings in a human-readable format.
393 in a format suitable for re-input into the shell.
404 .Bl -tag -width indent
406 .Bl -column "XXX" "XXX" "XXX" "XXX" "XXX" -offset center -compact
411 .Bl -column "XXX" "XXX" "XXX" "XXX" "XXX" -offset center -compact
413 .It Li <& Ta Li >& Ta Li <<- Ta Li >| Ta \&
433 dollar-single quotes,
435 .Bl -tag -width indent
439 it impossible to put single-quotes in a single-quoted string).
440 .It Dollar-Single Quotes
447 A backslash introduces a C-style escape sequence:
448 .Bl -tag -width xUnnnnnnnn
476 Literal single-quote
478 Literal double-quote
498 UTF-8 locales.
499 They reject code point 0 and UTF-16 surrogates.
502 that byte and the rest of the string until the matching single-quote
518 .Bl -column "XXX" "XXX" "XXX" "XXX" "XXX" -offset center -compact
532 .Bl -column "doneXX" "elifXX" "elseXX" "untilXX" "whileX" -offset center
540 built-in command.
548 .Dq Li "ls -F" ,
555 .Dl "ls -F foobar"
569 .Dl "nohup ls -F foobar"
583 an alias name with a backslash to execute a function, built-in, or
592 .St -p1003.2
603 .Bl -enum
637 .D1 Oo Ar n Oc Ar redir-op file
640 .Ar redir-op
647 .Bl -tag -width "1234567890XX" -offset indent
677 .It Oo Ar n Oc Ns Li <&-
685 .It Oo Ar n Oc Ns Li >&-
691 .Dq here-document .
692 .Bd -unfilled -offset indent
694 .Ar here-doc-text
707 .Ar here-doc-text
713 .Dq Li <<-
718 .Ar here-doc-text
722 built-in commands, and normal programs.
740 Shell built-in commands are executed internally to the shell, without
742 There are two kinds of built-in commands: regular and special.
751 or built-in command, the command is searched for as a normal
778 built-in command by that name.
779 If a built-in command is not found,
781 .Bl -enum
804 with zero for normal or success, and non-zero for failure,
808 Additionally, the built-in commands return exit codes, as does
813 .Li kill -l .
823 .Bl -item -offset indent
829 list or compound-list
879 or the last non-zero exit status of any command in the pipeline otherwise.
902 AND-OR-list
904 .Sx Short-Circuit List Operators )
908 causes asynchronous execution of the preceding AND-OR-list.
937 .Ss Short-Circuit List Operators
941 are AND-OR list operators.
952 .Ss Flow-Control Constructs (if, while, for, case)
956 .Bd -unfilled -offset indent -compact
975 .Bd -unfilled -offset indent -compact
998 .Bd -unfilled -offset indent -compact
1040 These are implemented as special built-in commands.
1045 .Bd -unfilled -offset indent -compact
1078 .Bd -literal -offset indent
1084 .Bd -literal -offset indent
1090 .Bl -enum
1133 .Bd -literal -offset indent
1134 { echo -n "hello"; echo " world"; } > greeting
1165 command is implemented as a built-in command.
1193 .Ql - .
1195 .Ql -
1217 command is implemented as a special built-in command.
1248 built-in commands that have this form.
1260 built-in command can also be used to set or reset them.
1266 .Bl -hang
1270 the expansion occurs within a double-quoted string
1281 the expansion occurs within double-quotes, each positional
1288 is double-quoted.
1302 .Bd -literal -offset indent
1309 .It Li $-
1310 (hyphen) Expands to the current option flags (the single-letter
1314 built-in command, or implicitly
1331 built-in command reports completion of the process.
1343 .Bl -tag -width ".Va HISTSIZE"
1347 built-in.
1351 built-in.
1357 built-in.
1373 built-in.
1428 .Bl -tag -width indent
1440 This system's fully-qualified hostname (FQDN).
1458 Start of a sequence of non-printing characters (used, for example,
1461 End of a sequence of non-printing characters.
1464 The following special and non-printing characters are supported
1465 within the sequence of non-printing characters:
1466 .Bl -tag -width indent
1483 The prefix for the trace output (if
1504 within double-quotes,
1508 .Bl -enum
1555 escaped by a backslash or within a single-quoted or double-quoted
1557 embedded arithmetic expansions, command substitutions, and variable
1562 .Ql - ,
1566 occur within a double-quoted string,
1567 as an extension there may be unquoted parts
1568 (via double-quotes inside the expansion);
1585 If a parameter expansion occurs inside double-quotes:
1586 .Bl -enum
1598 .Bl -tag -width indent
1599 .It Li ${ Ns Ar parameter Ns Li :- Ns Ar word Ns Li }
1659 (unquoted, double-quoted or here-document)
1663 .Bl -tag -width indent
1683 Enclosing the full parameter expansion string in double-quotes does not
1686 .Bl -tag -width indent
1744 Embedded newlines before the end of the output are not removed;
1750 except that the built-in commands
1779 is treated as if it were in double-quotes, except
1780 that a double-quote inside the expression is not treated specially.
1791 .Bl -tag -width "Variables" -offset indent
1805 .Li "! ~ + -"
1807 .Li "* / % + - << >> < <= > >= == != & ^ | && ||"\&
1809 .Li "= += -= *= /= %= <<= >>= &= ^= |="
1819 expansions and substitutions that did not occur in double-quotes for
1839 .Bl -enum
1841 a non-whitespace character in
1851 If a word ends with a non-whitespace character in
1884 and meta-characters.
1885 The meta-characters are
1892 or back quotes are not double-quoted, the value of the
1894 characters and they are turned into meta-characters.
1915 A locale-dependent range of characters may be specified using a minus sign.
1930 has the same effect but is non-standard.
1941 .Ql - ,
1943 .Ss Built-in Commands
1944 This section lists the built-in commands.
1945 .Bl -tag -width indent
1968 A built-in equivalent of
1984 built-in command prints the names and values of all defined aliases
1988 suitable for re-input to the shell.
2002 .Sx Flow-Control Constructs
2005 Execute the specified built-in command,
2008 with the same name as a built-in command.
2084 built-in command.
2109 For ordinary commands the output is the path name; for shell built-in
2135 .Sx Flow-Control Constructs
2138 Print a space-separated list of the arguments to the standard output
2140 .Bl -tag -width indent
2144 Process C-style backslash escape sequences.
2148 .Bl -tag -width indent
2154 Suppress the trailing newline (this has the side-effect of truncating the
2180 .Bd -literal -offset indent
2181 $ echo -e "a\evb"
2184 $ echo -e a\e\evb
2187 $ echo -e "a\e\eb"
2189 $ echo -e a\e\e\e\eb
2201 Then re-parse and execute the command.
2207 (which must be a real program, not a shell built-in command or function).
2231 The only way to un-export a variable is to
2247 lines, suitable for re-input to the shell.
2249 A null command that returns a non-zero (false) exit value.
2255 built-in command lists, or edits and re-executes,
2257 .Bl -tag -width indent
2307 Re-execute the command without invoking an editor.
2320 .Bl -tag -width indent
2332 For example, \-1 is the immediately previous command.
2340 the string form of the first operand cannot contain an embedded equal sign.
2346 .Bl -tag -width ".Va HISTSIZE"
2357 Parse command-line options and arguments.
2376 .Bl -offset indent
2457 A built-in equivalent of
2465 A built-in equivalent of
2469 The built-in command may
2471 built-in command remembers what the current directory
2477 the built-in version of
2572 option is specified, the read-only variables are printed as
2574 lines, suitable for re-input to the shell.
2580 .Oc Op Fl - Ar arg ...
2584 .Bl -item
2596 .Dq Fl -
2602 .Dq Fl -
2608 .Dq Fl -
2613 .Pq Ql -
2654 A built-in equivalent of
2669 In addition, the pseudo-signal
2677 .Pq Ql - ;
2745 .Bl -tag -width indent
2749 The maximal size of core dump files, in 512-byte blocks.
2756 The maximal size of a file, in 512-byte blocks.
2770 The maximal number of process-shared locks
2775 The maximal number of pseudo-terminals for this user ID.
2837 .Sx Built-in Commands )
2839 .Nm vi Ns -mode
2846 .Dq Li "set -o vi"
2848 .Dq Li "set -V" )
2850 .Nm vi Ns -mode
2857 .Nm vi Ns -mode
2867 .Dq Li "set -o emacs"
2869 .Dq Li "set -E" )
2871 .Nm emacs Ns -style
2876 .Bl -tag -width ".Ev LANGXXXXXX"
2902 .Bl -tag -width "/etc/suid_profileXX" -compact
2918 cause the shell to exit with a non-zero exit status.
2969 utility does not recognize multibyte characters other than UTF-8.