Lines Matching +full:non +full:- +full:specified

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
174 The long name for an option may be specified as an argument to the
179 the long name for an option may be specified as an argument to the
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,
308 as specified in
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
703 if it is specified.
706 as specified on the initial line is quoted, then the
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
859 pipeline before any redirection specified by redirection
875 exit status is the exit status of the last command specified
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
1311 option names concatenated into a string) as specified on
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
1504 within double-quotes,
1508 .Bl -enum
1555 escaped by a backslash or within a single-quoted or double-quoted
1562 .Ql - ,
1566 occur within a double-quoted string,
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
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
1872 each pattern with a string that matches the specified pattern.
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.
1918 may be specified by surrounding the name with
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
1950 The commands in the specified file are read and executed by the shell.
1968 A built-in equivalent of
1973 is specified, the shell defines the alias
1979 is specified, the value of the alias
1984 built-in command prints the names and values of all defined aliases
1988 suitable for re-input to the shell.
1993 Continue the specified jobs
2002 .Sx Flow-Control Constructs
2005 Execute the specified built-in command,
2008 with the same name as a built-in command.
2011 Switch to the specified
2013 to the directory specified in the
2017 is specified or
2018 to the directory specified in the
2033 searched for the specified
2056 option is specified,
2063 option is specified,
2084 built-in command.
2088 The first form of invocation executes the specified
2098 option is specified, the command search is performed using a
2105 option is specified,
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
2198 options may be specified.
2201 Then re-parse and execute the command.
2206 the shell process is replaced with the specified program
2207 (which must be a real program, not a shell built-in command or function).
2229 The specified names are exported so that they will
2231 The only way to un-export a variable is to
2245 option is specified, the exported variables are printed as
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
2272 is not specified.
2307 Re-execute the command without invoking an editor.
2320 .Bl -tag -width indent
2332 For example, \-1 is the immediately previous command.
2338 operand is not also specified with
2346 .Bl -tag -width ".Va HISTSIZE"
2353 Move the specified
2357 Parse command-line options and arguments.
2362 The specified variable
2372 is not specified by
2376 .Bl -offset indent
2398 when the option was not specified by
2420 command removes each specified
2434 Print the process IDs of the processes in the specified
2440 Print information about the specified jobs, or all jobs if no
2447 option is specified, the PID of each job is also printed.
2450 option is specified, only the process IDs for the process group leaders
2454 option is specified, only the PIDs of the job commands are printed, one per
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
2483 option is specified, symbolic links are resolved.
2486 option is specified, the shell's notion of the current directory
2495 option is specified
2516 specified.
2528 option is specified and the
2557 Each specified
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
2592 it sets or clears the specified options as described in the section called
2596 .Dq Fl -
2597 option is specified,
2602 .Dq Fl -
2608 .Dq Fl -
2613 .Pq Ql -
2621 Assigns the specified
2623 to the specified
2638 is not specified.
2654 A built-in equivalent of
2665 when any specified
2668 The signals are specified by name or number.
2669 In addition, the pseudo-signal
2677 .Pq Ql - ;
2678 the former causes the specified signal to be ignored
2712 is specified, the named resource will be set;
2717 is specified, the hard limits will be set or displayed.
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.
2793 value specified by
2798 option is specified, the output is symbolic, otherwise the output is octal.
2800 The specified alias names are removed.
2803 is specified, all aliases are removed.
2805 The specified variables or functions are unset and unexported.
2808 option is specified or no options are given, the
2813 option is specified, the
2817 Wait for each specified
2820 last specified
2824 specified is unknown to the shell, it is treated as if it
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.