'\" te

.\" Copyright (c) 2008, 2011, Oracle and/or its affiliates. All rights reserved.

.\" Copyright 1989 AT&T

.\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved

.\"  Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at http://www.opengroup.org/bookstore/.

.\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html. This notice shall appear on any product containing this material. 

.TH sh 1 "2011 年 7 月 12 日" "SunOS 5.11" "ユーザーコマンド"

.SH 名前

sh, jsh \- 標準シェルとジョブ制御シェルおよびコマンドインタプリタ

.SH 形式

.LP

.nf

\fB/usr/bin/sh\fR  [\fB-acefhiknprstuvx\fR] [\fIargument\fR]...

.fi

.LP

.nf

\fB/usr/xpg4/bin/sh\fR  [\(+- abCefhikmnoprstuvx]

     [\(+- o \fIoption\fR]... [\fB-c\fR \fIstring\fR] [\fIarg\fR]...

.fi

.LP

.nf

\fB/usr/bin/jsh\fR  [\fB-acefhiknprstuvx\fR] [\fIargument\fR]...

.fi

.SH 機能説明

.sp

.LP

\fB/usr/bin/sh\fR ユーティリティは、端末またはファイルから読み取られたコマンドを 実行するコマンドおよびプログラミング言語です。

.sp

.LP

\fB/usr/xpg4/bin/sh\fR ユーティリティーは標準に準拠したシェルです。このユーティリティーは \fBksh88\fR(1) のすべての機能を提供します。ただし、\fBksh\fR(1) で説明しているように、動作が異なる場合を除きます。

.sp

.LP

\fBjsh\fR ユーティリティーは、\fBsh\fR のすべての機能を備えた、かつジョブ制御を可能にするシェルへのインタフェースです (下記の「ジョブ制御」を参照)。\fB\fR

.sp

.LP

シェルへの引数については、後述の「呼び出し」にリストされています。\fB\fR

.SS "定義"

.sp

.LP

ブランク (\fIblank\fR) はタブ (tab) またはスペース (space) です。名前 (\fIname\fR) は \fBASCII\fR 英文字、数字、または下線の並びで、先頭文字は英文字または下線です。パラメータ ( \fIparameter\fR) は、名前、複数、または \fB*\fR、\fB@\fR、\fB#\fR、\fB?\fR、\fB-\fR、\fB$\fR、\fB!\fR などの文字のいずれかです。

.SH 使用法

.SS "コマンド (Commands)"

.sp

.LP

単純コマンド (\fIsimple-command\fR) は、ブランクで区切られた、ブランクでないワードの並びです。先頭のワードは、実行するコマンド名を指定します。\fI\fR\fI\fR\fI\fR残りのワードは、次に述べる場合を除き、呼び出されたコマンドに引数として渡されます。\fI\fRコマンド名は引数 0 として渡されます (\fBexec\fR(2) を参照)。単純コマンドの値 (\fIvalue\fR) は、正常終了した場合は終了ステータス、異常終了した場合は \fB200\fR+\fIstatus\fR (8 進数) です。\fI\fRステータス値の一覧表については、\fBsignal.h\fR(3HEAD) を参照してください。

.sp

.LP

パイプライン (\fIpipeline\fR) は、パイプ (\fB|\fR) で区切られた 1 つ以上のコマンドの並びです。\fI\fR最後のコマンドを除き、各コマンドの標準出力は \fBpipe\fR(2) によってその次のコマンドの標準入力と結合されます。\fI\fR\fI\fR各コマンドは、別々のプロセスとして実行されます。\fI\fRシェルは最後のコマンドが終了するのを待ちます。\fI\fR最後のコマンドの終了ステータスがパイプライン全体の終了ステータスとなります。\fI\fR\fI\fR

.sp

.LP

リスト (\fIlist\fR) は、\fB;\fR、\fB&\fR、\fB&&\fR、または \fB|\||\fR で区切られた 1 つ以上のパイプラインの並びです。その並びの終わりに \fB;\fR または \fB&\fR を記述することもできます。\fI\fRこれら 4 つの記号の中で、\fB;\fR と \fB&\fR の優先度は同じで、\fB&&\fR と \fB|\||\fR の優先度より低くなります。\fB&&\fR と \fB|\||\fR の優先度は同じです。セミコロン (\fB;\fR) によって、直前のパイプラインが順次実行されます。つまりシェルはパイプラインが終了するのを待ってから、セミコロンの後のコマンドを実行します。\fI\fR\fI\fRアンパサンド記号 (\fB&\fR) によって、直前のパイプラインが非同期的に実行されます。つまりシェルはパイプラインが終了するのを待ちません。\fB\fR\fB&&\fR という記号は、直前のパイプラインの終了ステータスが 0 の場合にだけ、後続のリストを実行するものです。反対に (\|\fB|\||\fR) は、終了ステータスが 0 以外の場合にだけ、後続のリストを実行します。\fI\fRコマンドの区切りとして、セミコロンの代わりに任意の数の復帰改行を \fIlist\fR に指定できます。

.sp

.LP

コマンド (\fIcommand\fR) は、単純コマンドまたは次のいずれかです。\fI\fR特に断わりのないかぎり、コマンドが返す値は、そのコマンド中で最後に実行された単純コマンドの値です。\fI\fR

.sp

.ne 2

.mk

.na

\fB\fBfor\fR \fIname\fR [ \fBin\fR \fIword\fR .\|.\|. ] \fBdo\fR \fIlist\fR \fBdone\fR\fR

.ad

.sp .6

.RS 4n

\fBfor\fR コマンドが実行されるたびに、\fIname\fR は \fBin\fR \fIword\fR リストから次に得られる \fIword\fR に設定されます。If \fBin\fR \fIword\fR .\|.\|. を省略すると、\fBfor\fR コマンドは、設定された各定位値パラメータに対して、\fBdo\fR \fIlist\fR を 1 回実行します (後述の「パラメータ置換」を参照)。\fB\fRリストの word がなくなると、実行は終了します。

.RE

.sp

.ne 2

.mk

.na

\fB\fBcase\fR \fIword\fR \fBin\fR [ \fIpattern\fR [ | \fIpattern\fR ] \fB)\fR \fIlist\fR \fB;\|;\fR ] .\|.\|. \fBesac\fR\fR

.ad

.sp .6

.RS 4n

\fBcase\fR コマンドは、\fIword\fR に一致する最初の \fIpattern\fR に対応した \fIlist\fR を実行します。パターンの形式は、ファイル名生成に使用される形式と同じです (「ファイル名の生成」の節を参照)。ただしスラッシュ、先行するドット、およびスラッシュ直後のドットは、明示的に一致しなくてもかまいません。\fB\fR

.RE

.sp

.LP

\fBif\fR \fIlist\fR \fB; then\fR \fIlist\fR \fBelif\fR \fIlist\fR \fB; then\fR \fIlist\fR \fB;\fR ] .\|.\|. [ \fBelse\fR \fI list\fR \fB;\fR ] \fBfi\fR

.sp

.LP

\fIif\fR の後の \fBlist\fR を実行後、\fIlist\fR が 0 の終了ステータスを返すと、最初の \fBthen\fR の後の list を実行します。それ以外の場合、\fBelif\fR の後の \fIlist\fR を実行します。この値が 0 の場合、次の \fBthen\fR の後の \fIlist\fR を実行します。これが失敗すると、\fBelse\fR \fIlist\fR を実行します。\fBelse\fR \fIlist\fR も \fBthen\fR \fIlist\fR も実行しない場合、\fBif\fR コマンドは 0 の終了ステータスを返します。

.sp

.ne 2

.mk

.na

\fB\fBwhile\fR \fIlist\fR \fBdo\fR \fIlist\fR \fBdone\fR\fR

.ad

.RS 27n

.rt  

\fBwhile\fR コマンドは、\fBwhile\fR \fIlist\fR を繰り返し実行し、list 中の最後のコマンドの終了ステータスが 0 の場合、\fBdo\fR \fIlist\fR を実行します。それ以外の場合、ループは終了します。\fBdo\fR \fIlist\fR 中のコマンドを実行しない場合、\fBwhile\fR コマンドは 0 の終了ステータスを返します。ループ終了条件の判定を逆にするには、\fBwhile\fR の代わりに \fBuntil\fR を使用します。

.RE

.sp

.ne 2

.mk

.na

\fB\fB(\fR\fIlist\fR\fB)\fR\fR

.ad

.RS 27n

.rt  

サブシェル内の \fIlist\fR の実行

.RE

.sp

.ne 2

.mk

.na

\fB\fB{\fR \fIlist\fR\fB;}\fR\fR

.ad

.RS 27n

.rt  

現在の (つまり、親) シェル内での \fIlist\fR の実行。記号 \fB{\fR の後にはスペースが必要です。

.RE

.sp

.ne 2

.mk

.na

\fB\fIname\fR \fB(\|) {\fR \fIlist\fR\fB;}\fR\fR

.ad

.RS 27n

.rt  

\fIname\fR が参照する関数を定義します。\fB{\fR と \fB}\fR の間のコマンド群 (\fIlist\fR) が関数の本体となります (後述の「関数」参照)。記号 \fB{\fR の後にはスペースが必要です。関数の実行については「実行」の節で後述します。\fB\fR関数の本体が、前述の「コマンド」の節で定義したようなコマンドの場合、\fB{\fR および \fB}\fR は必要ではありません。\fI\fR\fB\fR

.RE

.sp

.LP

下記のワードは、コマンドの最初に現れたとき、およびクォートされずに記述されたときに認識されます。

.sp

.LP

\fBif then else elif fi case esac for while until do done { }\fR

.SS "注釈行"

.sp

.LP

\fB#\fR でワードを始めると、そのワードおよび以降の 復帰改行までの文字がすべて無視されます。

.SS "コマンド置換"

.sp

.LP

シェルは、2 つの逆引用符 (\fB``\fR) で囲まれた文字列からコマンドを読み取ります。これらのコマンドからの標準出力は、ワードの一部または全体として使用できます。標準出力上で最後につく復帰改行は削除されます。

.sp

.LP

文字列は、読み取られる前にはいっさい解釈されません。ただし例外として、文字のエスケープに使用されるバックスラッシュ (\fB\e\fR) の削除だけは行われます。バックスラッシュは、逆引用符 (\fB`\fR) または別のバックスラッシュ (\fB\e\fR) をエスケープするためにも使用され、コマンド文字列の読み取り前に削除されます。逆引用符をエスケープすることにより、コマンド置換のネストが可能になります。コマンド置換が、一対の二重引用符に囲まれている場合 (\fB" .\|.\|.\|` .\|.\|.\|` .\|.\|.\| "\fR)、二重引用符 (\fB\e"\fR) をエスケープするために使用されたバックスラッシュが削除されます。その他の場合は、変更がないままです。

.sp

.LP

復帰改行文字のエスケープにバックスラッシュを用いた場合は (\fB\enewline\fR)、バックスラッシュと復帰改行の両方が削除されます (後述の「クォート」の節の後半を参照)。\fB\fRさらに、ドル記号 (\fB\e$\fR) をエスケープしているバックスラッシュも削除されます。コマンド文字列に対するパラメータの置換は 読み取り前には行われないので、バックスラッシュでドル記号をエスケープしようとしても 無意味です。\fB\e\fR、\fB`\fR、\fB"\fR、復帰改行 (\fBnewline\fR)、および \fB$\fR 以外の文字の前に付くバックスラッシュは、コマンド文字列の読み取り時にもそのまま残ります。

.SS "パラメータ置換"

.sp

.LP

文字 \fB$\fR は、置換可能なパラメータ (\fIparameter\fR) を示します。パラメータには、定位置パラメータとキーワードパラメータの 2 種類があります。パラメータが数字の場合、これは定位置パラメータです。\fI\fR定位置パラメータには、\fBset\fR によって値を割り当てることができます。キーワードパラメータ (変数とも呼ばれる) には、次の記述により値を代入することもできます。

.sp

.LP

\fIname\fR\fB=\fR\fIvalue\fR [ \fIname\fR\fB=\fR\fIvalue\fR ] .\|.\|.

.sp

.LP

\fIvalue\fR に対しては、パターンマッチングは行われません。同じ \fIname\fR を持つ関数と変数が存在することはできません。

.sp

.ne 2

.mk

.na

\fB\fB${\fR\fIparameter\fR\fB}\fR\fR

.ad

.RS 25n

.rt  

パラメータの値 ( もしあれば ) は置換されます。中括弧が必要となるのは、パラメータの後に、その名前の一部として解釈すべきでない文字、数字、または下線を指定するときだけです。\fI\fR\fIparameter\fR が \fB*\fR または \fB@\fR の場合、\fB$1\fR で始まる定位値パラメータはすべて (スペースで区切られて) 置換されます。パラメータ \fB$0\fR は、シェルが呼び出されたときに、引数 0 から設定されます。

.RE

.sp

.ne 2

.mk

.na

\fB\fB${\fR\fIparameter\fR\fB:\(mi\fR\fIword\fR\fB}\fR\fR

.ad

.RS 25n

.rt  

デフォルト値の使用。\fIparameter\fR が未設定または NULL の場合は、\fIword\fR の展開結果に置換されます。それ以外の場合は、\fIparameter\fR の値に置換されます。

.RE

.sp

.ne 2

.mk

.na

\fB\fB${\fR\fIparameter\fR\fB:=\fR\fIword\fR\fB}\fR\fR

.ad

.RS 25n

.rt  

デフォルト値の割り当て。\fIparameter\fR が未設定または NULL の場合は、\fIword\fR の展開結果が \fIparameter\fR に割り当てられます。どのような場合でも、\fIparameter\fR の最終的な値に置換されます。この割り当て方法は変数だけに使用可能で、定位置パラメータや特殊パラメータには使用できません。

.RE

.sp

.ne 2

.mk

.na

\fB\fB${\fR\fIparameter\fR\fB:?\fR\fIword\fR\fB}\fR\fR

.ad

.RS 25n

.rt  

\fIparameter\fR が NULL 以外の値に設定されている場合、その値に置き換えられます。その他の場合、\fIword\fR を出力しシェルを終了します。\fIword\fR を省略すると、メッセージ "parameter null or not set" が出力されます。

.RE

.sp

.ne 2

.mk

.na

\fB\fB${\fR\fIparameter\fR\fB:+\fR\fIword\fR\fB}\fR\fR

.ad

.RS 25n

.rt  

\fIparameter\fR が NULL 以外の値に設定されている場合、\fIword\fR に置き換えられます。その他の場合は置換を行いません。

.RE

.sp

.LP

前述にあるように、\fIword\fR は、代入用文字列として使用する場合にだけ評価されます。たとえば次の例では、\fBpwd\fR が実行されるのは、\fBd\fR が設定されていないかあるいは NULL に設定されている場合だけです。

.sp

.in +2

.nf

\fBecho  ${d:\(mi`pwd`}\fR

.fi

.in -2

.sp

.sp

.LP

前述の式からコロン (\fB:\fR) を省略すると、シェルは \fIparameter\fR が設定されているかどうかだけをチェックします。

.sp

.LP

次のパラメータは、シェルが自動的に設定します。

.sp

.ne 2

.mk

.na

\fB\fB#\fR\fR

.ad

.RS 8n

.rt  

定位置パラメータ数 (10 進数 )

.RE

.sp

.ne 2

.mk

.na

\fB\fB\(mi\fR\fR

.ad

.RS 8n

.rt  

呼び出し時にまたは \fBset\fR コマンドによってシェルに与えられたフラグ

.RE

.sp

.ne 2

.mk

.na

\fB\fB?\fR\fR

.ad

.RS 8n

.rt  

最後に同期実行されたコマンドが返した 10 進数

.RE

.sp

.ne 2

.mk

.na

\fB\fB$\fR\fR

.ad

.RS 8n

.rt  

このシェルのプロセス番号

.RE

.sp

.ne 2

.mk

.na

\fB\fB!\fR\fR

.ad

.RS 8n

.rt  

最後に呼び出されたバックグラウンドコマンドのプロセス番号

.RE

.sp

.LP

次のパラメータはシェルによって使用されます。このセクションのパラメータは、環境変数とも呼ばれます。

.sp

.ne 2

.mk

.na

\fB\fBHOME\fR\fR

.ad

.RS 13n

.rt  

\fBcd\fR コマンドのデフォルト引数 (ホームディレクトリ)。\fBlogin\fR(1) によって、パスワードファイルから ユーザーのログインディレクトリに設定されます (\fBpasswd\fR(4) を参照)。

.RE

.sp

.ne 2

.mk

.na

\fB\fBPATH\fR\fR

.ad

.RS 13n

.rt  

コマンド用検索パス (後述の「実行」を参照)。\fB\fR

.RE

.sp

.ne 2

.mk

.na

\fB\fBCDPATH\fR\fR

.ad

.RS 13n

.rt  

\fBcd\fR コマンドの検索パスを指定します。

.RE

.sp

.ne 2

.mk

.na

\fB\fBMAIL\fR\fR

.ad

.RS 13n

.rt  

このパラメータにメールファイルの名前がセットされていて、かつ \fBMAILPATH\fR パラメータが設定されていない場合、シェルは指定されたファイルにメールが到着するとユーザーに通知します。\fI\fR

.RE

.sp

.ne 2

.mk

.na

\fB\fBMAILCHECK\fR\fR

.ad

.RS 13n

.rt  

このパラメータは、\fBMAILPATH\fR または \fBMAIL\fR パラメータで指定されたファイルへメールが到着したか否かを、シェルが何秒ごとにチェックするかを指定します。デフォルト値は \fB600\fR 秒 (10 分) です。0 が設定された場合、シェルは各プロンプトを出す前にチェックを行います。

.RE

.sp

.ne 2

.mk

.na

\fB\fBMAILPATH\fR\fR

.ad

.RS 13n

.rt  

コロン (:) で区切ったファイル名のリスト。このパラメータが設定されると、指定されたいずれかのファイルにメールが到着するたびに、シェルはユーザーに通知します。各ファイル名の後には、% および更新時刻の変更時に出力されるメッセージを指定できます。デフォルトのメッセージは \fByou have mail\fR です。

.RE

.sp

.ne 2

.mk

.na

\fB\fBPS1\fR\fR

.ad

.RS 13n

.rt  

1 次プロンプト文字列。デフォルトは " $ \|" です。

.RE

.sp

.ne 2

.mk

.na

\fB\fBPS2\fR\fR

.ad

.RS 13n

.rt  

2 次プロンプト文字列。デフォルトは " > \|" です。

.RE

.sp

.ne 2

.mk

.na

\fB\fBIFS\fR\fR

.ad

.RS 13n

.rt  

内部フィールドセパレータ。通常はスペース、タブ、および復帰改行です (「ブランクの解釈」を参照)。\fB\fR\fB\fR\fB\fR\fB\fR

.RE

.sp

.ne 2

.mk

.na

\fB\fBSHACCT\fR\fR

.ad

.RS 13n

.rt  

このパラメータにユーザーが書き込み可能なファイル名が設定された場合、シェルは、実行された各シェルプロシージャーごとのアカウンティングレコードをこのファイルに書き込みます。

.RE

.sp

.ne 2

.mk

.na

\fB\fBSHELL\fR\fR

.ad

.RS 13n

.rt  

シェルは、呼び出されると、このパラメータが示す名前が環境中に存在するかを確かめます (「環境」の節を参照)。\fB\fR

.RE

.sp

.LP

\fBsh\fR の実行に影響を与える次の環境変数についての詳細は、\fBenviron\fR(5) を参照してください。\fBLC_CTYPE\fR および \fBLC_MESSAGES\fR。

.sp

.LP

シェルは、\fBPATH\fR、\fBPS1\fR、\fBPS2\fR、\fBMAILCHECK\fR、および \fBIFS\fR にデフォルト値を割り当てます。\fBHOME\fR および \fBMAIL\fR のデフォルト値は \fBlogin\fR(1) で設定します。

.SS "ブランクの解釈"

.sp

.LP

パラメータとコマンドの置換後、置換の結果内でフィールドセパレータ文字 (\fBIFS\fR で発見されるもの) を検索し、その文字が現れた位置で分割します。分割された各々が引数となります。明示的な NULL 引数 (\fB""\fR または \fB\&''\fR) は保持されます。暗示的な NULL 引数 (値を持たないパラメータにより生ずるもの) は削除されます。\fI\fR

.SS "入出力のリダイレクト"

.sp

.LP

シェルが解釈する特殊表記法によって、入出力をリダイレクションできます。以下は、単純コマンド内の任意の位置およびコマンドの前後に指定することができ、起動されたコマンドには引数として引き渡されません。\fI\fR\fI\fR\fB\fR\fB注: \fR \fIword\fR または \fIdigit\fR を使用する前にコマンドとパラメータの置換が発生します。

.sp

.ne 2

.mk

.na

\fB\fB<\fR\fIword\fR\fR

.ad

.RS 13n

.rt  

\fIword\fR というファイルを標準入力 ( ファイル記述子 0) として使用します。

.RE

.sp

.ne 2

.mk

.na

\fB\fB>\fR\fIword\fR\fR

.ad

.RS 13n

.rt  

\fIword\fR というファイルを標準出力 ( ファイル記述子 1) として使用します。ファイルが存在しない場合は作成します。ファイルが存在していれば、ファイルの長さを 0 にします。

.RE

.sp

.ne 2

.mk

.na

\fB\fB>>\fR\fIword\fR\fR

.ad

.RS 13n

.rt  

\fIword\fR というファイルを標準出力として使用します。ファイルが存在する場合、(\fBEOF\fR までシークしたあと) そのファイルに出力を追加します。そうでない場合は、ファイルを作成します。

.RE

.sp

.ne 2

.mk

.na

\fB\fB<\|>\fR\fIword\fR\fR

.ad

.RS 13n

.rt  

\fIword\fR というファイルを標準入力として読み書き用に開きます。

.RE

.sp

.ne 2

.mk

.na

\fB\fB<<\fR[\fB-\fR]\fIword\fR\fR

.ad

.RS 13n

.rt  

\fIword\fR に対するパラメータおよびコマンド置換が行われた後、その結果得られた \fIword\fR と文字どおり一致する最初の行が現れるまで、または \fBEOF\fR に達するまでシェルへの入力が読み取られます。ただし \fB<<\fR に \fB\(mi\fR が付加されて指定された場合は、以下のようになります。

.RS +4

.TP

1.

まず、シェルへの入力の読み取り前に (ただしパラメータとコマンドの置換後) 、先行するタブを \fIword\fR から取り除きます。\fI\fR

.RE

.RS +4

.TP

2.

読み取ったシェルへの入力の各行を \fIword\fR と比較する前に、その行から先行するタブを取り除きます。そして、

.RE

.RS +4

.TP

3.

その結果得られた \fIword\fR と文字どおり一致する最初の行が現れるまで、または \fBEOF\fR に達するまでシェルへの入力が読み取られます。

.RE

\fIword\fR 中のいずれかの文字がクォートされている場合 (後述の「クォート」を参照) 、シェルへの入力に対して追加処理は行われません。\fB\fR\fIword\fR 中のどの文字もクォートされていない場合は、以下のようになります。

.RS +4

.TP

1.

まずパラメータとコマンドの置換を実施します。

.RE

.RS +4

.TP

2.

エスケープされた復帰改行 ( \fB\enewline\fR ) を削除します。

.RE

.RS +4

.TP

3.

文字 \fB\e\fR、\fB$\fR、および \fB`\fR に対しては、\fB\e\fR を使ってクォートしなければなりません。

.RE

その結果得られるドキュメントが標準入力となります。

.RE

.sp

.ne 2

.mk

.na

\fB\fB<&\fR\fIdigit\fR\fR

.ad

.RS 13n

.rt  

ファイル記述子 \fIdigit\fR に対応するファイルを標準入力として使用します。同様に、標準出力の使用には \fB>&\fR\fIdigit\fR を指定します。

.RE

.sp

.ne 2

.mk

.na

\fB\fB<&-\fR\fR

.ad

.RS 13n