Changeset View
Changeset View
Standalone View
Standalone View
bin/sh/sh.1
Show All 26 Lines | |||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" from: @(#)sh.1 8.6 (Berkeley) 5/4/95 | .\" from: @(#)sh.1 8.6 (Berkeley) 5/4/95 | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd July 6, 2020 | .Dd March 10, 2021 | ||||
.Dt SH 1 | .Dt SH 1 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm sh | .Nm sh | ||||
.Nd command interpreter (shell) | .Nd command interpreter (shell) | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
.Nm | .Nm | ||||
.Op Fl /+abCEefhIimnPpTuVvx | .Op Fl /+abCEefhIimnPpSTuVvx | ||||
.Op Fl /+o Ar longname | .Op Fl /+o Ar longname | ||||
.Oo | .Oo | ||||
.Ar script | .Ar script | ||||
.Op Ar arg ... | .Op Ar arg ... | ||||
.Oc | .Oc | ||||
.Nm | .Nm | ||||
.Op Fl /+abCEefhIimnPpTuVvx | .Op Fl /+abCEefhIimnPpSTuVvx | ||||
.Op Fl /+o Ar longname | .Op Fl /+o Ar longname | ||||
.Fl c Ar string | .Fl c Ar string | ||||
.Oo | .Oo | ||||
.Ar name | .Ar name | ||||
.Op Ar arg ... | .Op Ar arg ... | ||||
.Oc | .Oc | ||||
.Nm | .Nm | ||||
.Op Fl /+abCEefhIimnPpTuVvx | .Op Fl /+abCEefhIimnPpSTuVvx | ||||
.Op Fl /+o Ar longname | .Op Fl /+o Ar longname | ||||
.Fl s | .Fl s | ||||
.Op Ar arg ... | .Op Ar arg ... | ||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
The | The | ||||
.Nm | .Nm | ||||
utility is the standard command interpreter for the system. | utility is the standard command interpreter for the system. | ||||
The current version of | The current version of | ||||
▲ Show 20 Lines • Show All 230 Lines • ▼ Show 20 Lines | |||||
.It Fl s Li stdin | .It Fl s Li stdin | ||||
Read commands from standard input (set automatically | Read commands from standard input (set automatically | ||||
if no file arguments are present). | if no file arguments are present). | ||||
This option has | This option has | ||||
no effect when set after the shell has already started | no effect when set after the shell has already started | ||||
running (i.e., when set with the | running (i.e., when set with the | ||||
.Ic set | .Ic set | ||||
command). | command). | ||||
.It Fl S | |||||
When doing job control, call | |||||
jilles: This clause does not seem to make much sense, since creating a new session implies creating a… | |||||
.Xr setsid 2 | |||||
to create a new session. | |||||
0mpUnsubmitted Not Done Inline ActionsPerhaps we could add some explanation why this option might be useful 0mp: Perhaps we could add some explanation why this option might be useful | |||||
.It Fl T Li trapsasync | .It Fl T Li trapsasync | ||||
When waiting for a child, execute traps immediately. | When waiting for a child, execute traps immediately. | ||||
If this option is not set, | If this option is not set, | ||||
traps are executed after the child exits, | traps are executed after the child exits, | ||||
as specified in | as specified in | ||||
.St -p1003.2 . | .St -p1003.2 . | ||||
This nonstandard option is useful for putting guarding shells around | This nonstandard option is useful for putting guarding shells around | ||||
children that block signals. | children that block signals. | ||||
▲ Show 20 Lines • Show All 2,584 Lines • Show Last 20 Lines |
This clause does not seem to make much sense, since creating a new session implies creating a new process group, so job control would not add anything to the new option. Also, processes from a different session are immune to SIGTTIN and the like.