'\" t
.\"     Title: yash
.\"    Author: 渡邊 裕貴[FAMILY Given] <magicant@users.sourceforge.jp>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 2014-04-06
.\"    Manual: \ \&
.\"    Source: \ \& 2.36
.\"  Language: Japanese
.\"
.TH "YASH" "1" "2014\-04\-06" "\ \& 2\&.36" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "名前"
yash \- POSIX 準拠コマンドラインシェル
.SH "概要"
.sp
\fByash [オプション\&...] [\-\-] [オペランド\&...]\fR
.SH "はじめに"
.sp
\fIYet another shell\fR (yash) は Unix 系 OS 用コマンドラインシェルです。POSIX\&.1\-2008 規格に (一部の例外を除いて) 準拠しています。POSIX 準拠を謳う他のシェルよりも精確な準拠を目指しています。また、コマンド履歴やコマンドライン編集など、対話シェルとして標準的な機能も備えています。
.sp
このプログラムは GNU General Public License (Version 2) の元で自由に再配布・変更などができます。\fBただし、プログラムの利用は全て各自の自己責任の下で行っていただくことになります。\fR作者はプログラムの瑕疵に対して一切責任を取りません。また、このマニュアルはクリエイティブ・コモンズの表示\-継承 2\&.1 日本ライセンスの下で自由に再配布・変更などができます。
.sp
Yash は渡邊裕貴 (通称まじかんと) という一人の開発者によって開発されています。Yash の開発プロジェクトおよび ホームページは SourceForge\&.jp がホストしています。
.SH "シェルの起動"
.sp
Yash がプログラムとして起動されると、yash はいくつかの初期化処理を行った後、コマンドを読み取って実行する処理に移ります。これらの処理の内容は、主に起動時のコマンドライン引数によって決まります。
.SS "起動時のコマンドライン引数"
.sp
Yash の起動時のコマンドライン引数は POSIX に準拠しています。POSIX で定められているとおり、引数は \fIオプション\fR と \fIオペランド\fR に分類されます。引数の書式に関する一般的な説明についてはコマンドの引数の構文を参照してください。オプションはオペランドより前に指定する必要があります。
.sp
オプションに \fB\-c\fR (\fB\-\-cmdline\fR) オプションが含まれている場合、オペランドを少なくとも一つ与える必要があります。シェルは、この最初のオペランドをコマンドとして解釈・実行します。二つ目のオペランドがある場合は、特殊パラメータ \fB0\fR がそれに初期化されます。三つ目以降のオペランドは、位置パラメータになります。 \fB\-c\fR (\fB\-\-cmdline\fR) オプションを指定した場合は、ファイルや標準入力からコマンドを読み込むことはありません (ドット組込みコマンドを使用したときを除く)。
.sp
オプションに \fB\-s\fR (\fB\-\-stdin\fR) オプションが含まれている場合、シェルは標準入力から一行ずつコマンドを読み取って、解釈・実行します。オペランドはすべて位置パラメータの初期化に使われます。特殊パラメータ \fB0\fR はこのシェルが起動されたときに元のプログラムから受け取った最初の引数に初期化されます。
.sp
\fB\-c\fR (\fB\-\-cmdline\fR) オプションも \fB\-s\fR (\fB\-\-stdin\fR) オプションも指定されなかった場合は、シェルはファイルからコマンドを読み取って解釈・実行します。最初のオペランドが読み込むファイル名と見なされ、特殊パラメータ \fB0\fR の値となります。残りのオペランドは位置パラメータになります。オペランドが一つもない場合は、 \fB\-s\fR (\fB\-\-stdin\fR) オプションを指定したときと同様に標準入力からコマンドを読み込みます。
.sp
\fB\-c\fR (\fB\-\-cmdline\fR) オプションと \fB\-s\fR (\fB\-\-stdin\fR) オプションを同時に使用することはできません。
.sp
\fB\-\-help\fR オプションまたは \fB\-\-version\fR オプションが指定されている場合は、通常の初期化処理やコマンドの解釈・実行は一切行いません。それぞれシェルのコマンドライン引数の簡単な説明とバージョン情報を標準出力に出力した後、そのままシェルは終了します。 \fB\-\-version\fR オプションを \fB\-\-verbose\fR オプションと共に使用すると、シェルで利用可能な機能の一覧も出力されます。
.sp
\fB\-i\fR (\fB\-\-interactive\fR) オプションが指定されている場合、シェルは対話モードになります。逆に \fB+i\fR (\fB++interactive\fR) オプションが指定されている場合、シェルは対話モードになりません。
.sp
\fB\-l\fR (\fB\-\-login\fR) オプションが指定されている場合、シェルはログインシェルとして動作します。
.sp
\fB\-\-noprofile\fR, \fB\-\-norcfile\fR, \fB\-\-profile\fR, \fB\-\-rcfile\fR 各オプションは、シェルの初期化処理の動作を指定します (後述)。
.sp
その他のオプションとして、set 組込みコマンドで指定可能な各種オプションをシェルの起動時に指定することができます。(\fB+\fR で始まるオプションを含む)
.sp
最初のオペランドが \fB\-\fR であり、かつオプションとオペランドが \fB\-\-\fR で区切られていない場合、そのオペランドは特別に無視されます。
.SS "シェルの初期化処理"
.sp
シェルの初期化処理は以下のように行われます。
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
Yash はまず、(コマンドライン引数の前に渡される) それ自身の起動時の名前を解析します。その名前が
\fB\-\fR
で始まる場合は、シェルはログインシェルとして動作します。また名前が
\fBsh\fR
である場合 (\fB/bin/sh\fR
のように
\fBsh\fR
で終わる場合を含む) は、シェルは
POSIX 準拠モードになります。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
オペランドが一つもなく、かつ標準入力と標準エラーがどちらも端末ならば、シェルは自動的に対話モードになります。ただし
\fB+i\fR
(\fB++interactive\fR) オプションが指定されている場合はそちらを優先します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
対話モードのシェルでは自動的にジョブ制御が有効になります。ただし
\fB+m\fR
(\fB++monitor\fR) オプションが指定されている場合はそちらを優先します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
シェルは以下の初期化スクリプトを読み込んで解釈・実行します。(ただしシェルプロセスの実ユーザ ID と実効ユーザ ID が異なっているか、実グループ ID と実効グループ ID が異なっている場合を除く)
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
シェルがログインシェルとして動作している場合は、
\fB\-\-profile=\fR\fB\fIファイル名\fR\fR
オプションで指定したファイルを読み込んで実行します。(ただし
\fB\-\-noprofile\fR
オプションが指定されているか
POSIX 準拠モードの場合を除く)
\fB\-\-profile=\fR\fB\fIファイル名\fR\fR
オプションが指定されていない場合は、
~/\&.yash_profile がデフォルトのファイルとして使われます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
シェルが対話モードの場合は、
\fB\-\-rcfile=\fR\fB\fIファイル名\fR\fR
オプションで指定したファイルを読み込んで実行します。(ただし
\fB\-\-norcfile\fR
オプションが指定されている場合を除く)
\fB\-\-rcfile\fR
オプションが指定されていない場合は、非 POSIX 準拠モードではファイル
~/\&.yashrc がデフォルトのファイルとして使われます。POSIX 準拠モードでは、
\fBENV\fR 環境変数の値がパラメータ展開され、その結果をファイル名と見なしてファイルを読み込みます。
.RE
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB注記\fR
.ps -1
.br
.sp
Yash は /etc/profile や /etc/yashrc や ~/\&.profile を自動的に読むことはありません。
.sp .5v
.RE
.SH "コマンドの文法"
.sp
シェルはコマンドを一行ずつ読み込んで解釈し、実行します。一行に複数のコマンドがある場合は、それら全てを解釈してから実行します。一つのコマンドが複数行にまたがっている場合は、そのコマンドを解釈し終えるのに必要なだけ後続の行が読み込まれます。コマンドを正しく解釈できない場合は、文法エラーとなり、コマンドは実行されません。
.sp
非対話モードで文法エラーが発生した時は、シェルはコマンドの読み込みを中止するため、それ以降のコマンドは一切読み込まれません。
.SS "トークンの解析と予約語"
.sp
コマンドは、いくつかのトークンによって構成されます。\fIトークン\fRとは、シェルの文法における一つ一つの単語のことを言います。トークンは原則として空白 (空白文字またはタブ文字) によって区切られます。ただしコマンド置換などに含まれる空白はトークンの区切りとは見なしません。
.sp
以下の記号は、シェルの文法において特別な意味を持っています。これらの記号も多くの場合他の通常のトークンの区切りとなります。
.sp
.if n \{\
.RS 4
.\}
.nf
; & | < > ( ) [newline]
.fi
.if n \{\
.RE
.\}
.sp
以下の記号はトークンの区切りにはなりませんが、文法上特別な意味を持っています。
.sp
.if n \{\
.RS 4
.\}
.nf
$ ` \e " \*(Aq * ? [ # ~ = %
.fi
.if n \{\
.RE
.\}
.sp
以下のトークンは特定の場面において\fI予約語\fRと見なされます。予約語は複合コマンドなどを構成する一部となります。
.sp
.if n \{\
.RS 4
.\}
.nf
! { } case do done elif else esac fi
for function if in then until while
.fi
.if n \{\
.RE
.\}
.sp
これらのトークンは以下の場面において予約語となります。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
それがコマンドの最初のトークンのとき
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
それが他の予約語 (\fBcase\fR,
\fBfor\fR,
\fBin\fR
を除く) の直後のトークンのとき
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
それがコマンドの最初のトークンではないが、複合コマンドの中で予約語として扱われるべきトークンであるとき
.RE
.sp
トークンが \fB#\fR で始まる場合、その \fB#\fR から行末までは\fIコメント\fRと見なされます。コマンドの解釈においてコメントは完全に無視されます。
.SS "クォート"
.sp
空白や上記の区切り記号・予約語などを通常の文字と同じように扱うには、適切な引用符でクォートする必要があります。引用符は、それ自体をクォートしない限り通常の文字としては扱われません。シェルでは以下の三種類の引用符が使えます。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
バックスラッシュ (\fB\e\fR) は直後の一文字をクォートします。

例外として、バックスラッシュの直後に改行がある場合、それは改行をクォートしているのではなく、\fI行の連結\fRと見なされます。バックスラッシュと改行が削除され、バックスラッシュがあった行とその次の行が元々一つの行であったかのように扱われます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
二つの一重引用符 (\fB\*(Aq\fR) で囲んだ部分では、全ての文字は通常の文字と同じように扱われます。改行を一重引用符で囲むこともできます。ただし、一重引用符を一重引用符で囲むことはできません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
二つの二重引用符 (\fB"\fR) で囲んだ部分も一重引用符で囲んだ部分と同様にクォートされますが、いくつか例外があります。二重引用符で囲んだ部分では、パラメータ展開・コマンド置換・数式展開が通常通り解釈されます。またバックスラッシュは
\fB$\fR,
\fB`\fR,
\fB"\fR,
\fB\e\fR
の直前にある場合および行の連結を行う場合にのみ引用符として扱われ、それ以外のバックスラッシュは通常の文字と同様に扱われます。
.RE
.SS "エイリアス"
.sp
コマンドを構成する各トークンは、それが予め登録されたエイリアスの名前に一致するかどうか調べられます。一致するものがあれば、そのトークンはそのエイリアスの内容に置き換えられて、その後コマンドの解析が続けられます。これを\fIエイリアス置換\fRといいます。
.sp
エイリアスの名前に引用符を含めることはできないので、引用符を含むトークンはエイリアス置換されません。また、予約語やコマンドを区切る記号もエイリアス置換されません。
.sp
エイリアスには通常のエイリアスとグローバルエイリアスの二種類があります。\fI通常のエイリアス\fRは、コマンドの最初のトークンにのみ一致します。\fIグローバルエイリアス\fRはコマンド内の全てのトークンが一致の対象です。グローバルエイリアスは POSIX 規格にはない拡張機能です。
.sp
通常のエイリアスで置換された部分の最後の文字が空白の場合、特例としてその直後のトークンにも通常のエイリアスの置換が行われます。
.sp
エイリアス置換の結果がさらに別のエイリアスに一致して置換される場合もあります。しかし、同じエイリアスに再び一致することはありません。
.sp
エイリアスを登録するには alias 組込みコマンドを、登録を削除するには unalias 組込みコマンドを使用します。
.SS "単純コマンド"
.sp
最初のトークンが予約語でないコマンドは、\fI単純コマンド\fRです。単純コマンドは単純コマンドの実行のしかたに従って実行されます。
.sp
単純コマンドの初めのトークンが \fI名前\fR=\fI値\fR の形式になっている場合は、それは変数代入と見なされます。ただしここでの\fI名前\fRは、一文字以上のアルファベット・数字または下線 (\fB_\fR) で、かつ最初が数字でないものです。変数代入ではない最初のトークンはコマンドの名前と解釈されます。それ以降のトークンは (たとえ変数代入の形式をしていたとしても) コマンドの引数と解釈されます。
.sp
\fI名前\fR=(\fIトークン列\fR) の形になっている変数代入は、配列の代入となります。括弧内には任意の個数のトークンを書くことができます。またこれらのトークンは空白・タブだけでなく改行で区切ることもできます。
.SS "パイプライン"
.sp
\fIパイプライン\fRは、一つ以上のコマンド (単純コマンド、複合コマンド、または関数定義) を記号 \fB|\fR で繋いだものです。
.sp
二つ以上のコマンドからなるパイプラインの実行は、パイプラインに含まれる各コマンドをそれぞれ独立したサブシェルで同時に実行することで行われます。この時、各コマンドの標準出力は次のコマンドの標準入力にパイプで受け渡されます。最初のコマンドの標準入力と最後のコマンドの標準出力は元のままです。最後のコマンドの終了ステータスがパイプラインの終了ステータスになります。
.sp
パイプラインの先頭には、記号 \fB!\fR を付けることができます。この場合、パイプラインの終了ステータスが\fI逆転\fRします。つまり、最後のコマンドの終了ステータスが 0 のときはパイプラインの終了ステータスは 1 になり、それ以外の場合は 0 になります。
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB注記\fR
.ps -1
.br
.sp
最後のコマンドの終了ステータスがパイプラインの終了ステータスになるため、パイプラインの実行が終了するのは少なくとも最後のコマンドの実行が終了した後です。しかしそのとき他のコマンドの実行が終了しているとは限りません。また、最後のコマンドの実行が終了したらすぐにパイプラインの実行が終了するとも限りません。(シェルは、他のコマンドの実行が終わるまで待つ場合があります)
.sp .5v
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB注記\fR
.ps -1
.br
.sp
POSIX 規格では、パイプライン内の各コマンドはサブシェルではなく現在のシェルで実行してもよいことになっています。
.sp .5v
.RE
.SS "And/or リスト"
.sp
\fIAnd/or リスト\fRは一つ以上のパイプラインを記号 \fB&&\fR または \fB||\fR で繋いだものです。
.sp
And/or リストの実行は、and/or リストに含まれる各パイプラインを条件付きで実行することで行われます。最初のパイプラインは常に実行されます。それ以降のパイプラインの実行は、前のパイプラインの終了ステータスによります。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
二つのパイプラインが
\fB&&\fR
で繋がれている場合、前のパイプラインの終了ステータスが 0 ならば後のパイプラインが実行されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
二つのパイプラインが
\fB||\fR
で繋がれている場合、前のパイプラインの終了ステータスが 0 でなければ後のパイプラインが実行されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
それ以外の場合は、and/or リストの実行はそこで終了し、それ以降のパイプラインは実行されません。
.RE
.sp
最後に実行したパイプラインの終了ステータスが and/or リストの終了ステータスになります。
.sp
構文上、and/or リストの直後には原則として記号 \fB;\fR または \fB&\fR が必要です (コマンドの区切りと非同期コマンド参照)。
.SS "コマンドの区切りと非同期コマンド"
.sp
シェルが受け取るコマンドの全体は、and/or リストを \fB;\fR または \fB&\fR で区切ったものです。行末、 \fB;;\fR または \fB)\fR の直前にある \fB;\fR は省略できますが、それ以外の場合は and/or リストの直後には必ず \fB;\fR と \fB&\fR のどちらかが必要です。
.sp
And/or リストの直後に \fB;\fR がある場合は、その and/or リストは同期的に実行されます。すなわち、その and/or リストの実行が終わった後に次の and/or リストが実行されます。And/or リストの直後に \fB&\fR がある場合は、その and/or リストは非同期的に実行されます。すなわち、その and/or リストの実行を開始した後、終了を待たずに、すぐさま次の and/or リストの実行に移ります。非同期な and/or リストは常にサブシェルで実行されます。また終了ステータスは常に 0 です。
.sp
ジョブ制御を行っていないシェルにおける非同期な and/or リストでは、標準入力が自動的に /dev/null にリダイレクトされるとともに、SIGINT と SIGQUIT を受信したときの動作が 『無視』 に設定されこれらのシグナルを受けてもプログラムが終了しないようにします。(POSIX 準拠モードでは、標準入力を /dev/null にリダイレクトするのはジョブ制御を行っていないシェルではなく対話モードのシェルです。また POSIX 準拠モードではジョブ制御を行っていても SIGINT と SIGQUIT が 『無視』 に設定されます)
.sp
ジョブ制御を行っているかどうかにかかわらず、非同期コマンドを実行するとシェルはそのコマンドのプロセス ID を記憶します。特殊パラメータ \fB!\fR を参照すると非同期コマンドのプロセス ID を知ることができます。非同期コマンドの状態や終了ステータスは jobs や wait 組込みコマンドで知ることができます。
.SS "複合コマンド"
.sp
複合コマンドは、より複雑なプログラムの制御を行う手段を提供します。
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBグルーピング\fR
.RS 4
.sp
グルーピングを使うと、複数のコマンドを一つのコマンドとして扱うことができます。
.PP
通常のグルーピングの構文
.RS 4
\fB{ \fR\fB\fIコマンド\fR\fR\fB\&...; }\fR
.RE
.PP
サブシェルのグルーピングの構文
.RS 4
\fB(\fR\fB\fIコマンド\fR\fR\fB\&...)\fR
.RE
.sp
\fB{\fR と \fB}\fR は予約語なので、他のコマンドのトークンとくっつけて書いてはいけません。一方 \fB(\fR と \fB)\fR は特殊な区切り記号と見なされるので、他のトークンとくっつけて書くことができます。
.sp
通常のグルーピング構文 (\fB{\fR と \fB}\fR で囲む) では、コマンドは (他のコマンドと同様に) 現在のシェルで実行されます。サブシェルのグルーピング構文 (\fB(\fR と \fB)\fR で囲む) では、括弧内のコマンドは新たな\:サブシェルで実行されます。
.sp
POSIX 準拠モードでは括弧内に少なくとも一つのコマンドが必要ですが、非 POSIX 準拠モードではコマンドは一つもなくても構いません。
.sp
グルーピングの終了ステータスは、グルーピングの中で実行された最後のコマンドの終了ステータスです。グルーピング内にコマンドが一つもない場合、グルーピングの終了ステータスはグルーピングの直前に実行されたコマンドの終了ステータスになります。
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBIf 文\fR
.RS 4
.sp
If 文は条件分岐を行います。分岐の複雑さに応じていくつか構文のバリエーションがあります。
.PP
If 文の基本構文
.RS 4
\fBif \fR\fB\fI条件コマンド\fR\fR\fB\&...; then \fR\fB\fI内容コマンド\fR\fR\fB\&...; fi\fR
.RE
.PP
Else がある場合
.RS 4
\fBif \fR\fB\fI条件コマンド\fR\fR\fB\&...; then \fR\fB\fI内容コマンド\fR\fR\fB\&...; else \fR\fB\fI内容コマンド\fR\fR\fB\&...; fi\fR
.RE
.PP
Elif がある場合
.RS 4
\fBif \fR\fB\fI条件コマンド\fR\fR\fB\&...; then \fR\fB\fI内容コマンド\fR\fR\fB\&...; elif \fR\fB\fI条件コマンド\fR\fR\fB\&...; then \fR\fB\fI内容コマンド\fR\fR\fB\&...; fi\fR
.RE
.PP
Elif と else がある場合
.RS 4
\fBif \fR\fB\fI条件コマンド\fR\fR\fB\&...; then \fR\fB\fI内容コマンド\fR\fR\fB\&...; elif \fR\fB\fI条件コマンド\fR\fR\fB\&...; then \fR\fB\fI内容コマンド\fR\fR\fB\&...; else \fR\fB\fI内容コマンド\fR\fR\fB\&...; fi\fR
.RE
.sp
If 文の実行では、どの構文の場合でも、\fBif\fR の直後にある\fI条件コマンド\fRがまず実行されます。条件コマンドの終了ステータスが 0 ならば、条件が真であると見なされて \fBthen\fR の直後にある\fI内容コマンド\fRが実行され、if 文の実行はそれで終了します。終了ステータスが 0 でなければ、条件が偽であると見なされます。ここで \fBelse\fR も \fBelif\fR もなければ、if 文の実行はこれで終わりです。\fBelse\fR がある場合は、\fBelse\fR の直後の\fI内容コマンド\fRが実行されます。\fBelif\fR がある場合は、\fBelif\fR の直後の\fI条件コマンド\fRが実行され、その終了ステータスが 0 であるかどうか判定されます。その後は先程と同様に条件分岐を行います。
.sp
\fBelif \&...; then \&...;\fR は一つの if 文内に複数あっても構いません。
.sp
If 文全体の終了ステータスは、実行された内容コマンドの終了ステータスです。内容コマンドが実行されなかった場合 (どの条件も偽で、\fBelse\fR がない場合) は 0 です。
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBWhile および until ループ\fR
.RS 4
.sp
While ループと until ループは単純なループ構文です。
.PP
While ループの構文
.RS 4
\fBwhile \fR\fB\fI条件コマンド\fR\fR\fB\&...; do \fR\fB\fI内容コマンド\fR\fR\fB\&...; done\fR
.RE
.PP
Until ループの構文
.RS 4
\fBuntil \fR\fB\fI条件コマンド\fR\fR\fB\&...; do \fR\fB\fI内容コマンド\fR\fR\fB\&...; done\fR
.RE
.sp
非 POSIX 準拠モードでは \fB\fI条件コマンド\fR\fR\fB\&...;\fR および \fB\fI内容コマンド\fR\fR\fB\&...;\fR は省略可能です。
.sp
While ループの実行ではまず\fI条件コマンド\fRが実行されます。そのコマンドの終了ステータスが 0 ならば、\fI内容コマンド\fRが実行されたのち、再び\fI条件コマンド\fRの実行に戻ります。この繰り返しは\fI条件コマンド\fRの終了ステータスが 0 でなくなるまで続きます。
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB注記\fR
.ps -1
.br
.sp
\fI条件コマンド\fRの終了ステータスが最初から 0 でないときは、\fI内容コマンド\fRは一度も実行されません。
.sp .5v
.RE
.sp
Until ループは、ループを続行する条件が逆になっている以外は while ループと同じです。すなわち、\fI条件コマンド\fRの終了ステータスが 0 でなければ\fI内容コマンド\fRが実行されます。
.sp
While/until ループ全体の終了ステータスは、最後に実行した\fI内容コマンド\fRの終了ステータスです。(\fI内容コマンド\fRが存在しないか、一度も実行されなかったときは 0)
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBFor ループ\fR
.RS 4
.sp
For ループは指定されたそれぞれの単語について同じコマンドを実行します。
.PP
For ループの構文
.RS 4
\fBfor \fR\fB\fI変数名\fR\fR\fB in \fR\fB\fI単語\fR\fR\fB\&...; do \fR\fB\fIコマンド\fR\fR\fB\&...; done\fR\fBfor \fR\fB\fI変数名\fR\fR\fB do \fR\fB\fIコマンド\fR\fR\fB\&...; done\fR
.RE
.sp
\fBin\fR の直後の\fI単語\fRは一つもなくても構いませんが、\fBdo\fR の直前の \fB;\fR (または改行) は必要です。これらの単語トークンは予約語としては認識されませんが、\fB&\fR などの記号を含めるには適切なクォートが必要です。\fBin \&...;\fR を省略する場合は、本来は変数名と \fBdo\fR の間に \fB;\fR を入れてはいけませんが、非 POSIX 準拠モードでは \fB;\fR があっても許容されます。また非 POSIX 準拠モードでは \fB\fIコマンド\fR\fR\fB\&...;\fR がなくても構いません。
.sp
For ループの実行ではまず\fI単語\fRが単純コマンド実行時の単語の展開と同様に展開されます (\fBin \&...;\fR がない構文を使用している場合は、\fBin "$@";\fR が省略されているものと見なされます)。続いて、展開で生成されたそれぞれの単語について順番に一度ずつ以下の処理を行います。
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
単語を\fI変数名\fRで指定した変数に代入する
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
\fIコマンド\fRを実行する
.RE
.sp
単語はローカル変数として代入されます (POSIX 準拠モードのときを除く)。展開の結果単語が一つも生成されなかった場合は、\fIコマンド\fRは一切実行されません。
.sp
For ループ全体の終了ステータスは、最後に実行した\fIコマンド\fRの終了ステータスです。\fIコマンド\fRがあるのに一度も実行されなかったときは 0 です。\fIコマンド\fRがない場合、for ループの終了ステータスは for ループの一つ前に実行されたコマンドの終了ステータスになります。
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBCase 文\fR
.RS 4
.sp
Case 文は単語に対してパターンマッチングを行い、その結果に対応するコマンドを実行します。
.PP
Case 文の構文
.RS 4
\fBcase \fR\fB\fI単語\fR\fR\fB in \fR\fB\fIcaseitem\fR\fR\fB\&... esac\fR
.RE
.PP
Caseitem の構文
.RS 4
\fB(\fR\fB\fIパターン\fR\fR\fB) \fR\fB\fIコマンド\fR\fR\fB\&...;;\fR
.RE
.sp
\fBcase\fR と \fBin\fR の間の単語はちょうど一トークンでなければなりません。この単語トークンは予約語としては認識されませんが、\fB&\fR などの記号を含めるには適切なクォートが必要です。\fBin\fR と \fBesac\fR の間には任意の個数の caseitem を置きます (0 個でもよい)。Caseitem の最初の \fB(\fR と \fBesac\fR の直前の \fB;;\fR は省略できます。また\fIコマンド\fRが \fB;\fR で終わる場合はその \fB;\fR も省略できます。Caseitem の \fB)\fR と \fB;;\fR との間に\fIコマンド\fRが一つもなくても構いません。
.sp
Caseitem の\fIパターン\fRにはトークンを指定します。各トークンを \fB|\fR で区切ることで複数のトークンをパターンとして指定することもできます。
.sp
Case 文の実行では、まず\fI単語\fRが四種展開されます。その後、各 caseitem に対して順に以下の動作を行います。
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
\fIパターン\fRトークンを\fI単語\fRと同様に展開し、展開したパターンが展開した単語にマッチするかどうか調べます (パターンマッチング記法参照)。\fIパターン\fRとして指定されたトークンが複数ある場合はそれら各トークンに対してマッチするかどうか調べます (どれかのパターントークンがマッチしたらそれ以降のパターントークンは展開されません。Yash はトークンが書かれている順番にマッチするかどうかを調べますが、他のシェルもこの順序で調べるとは限りません)。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
マッチした場合は、直後の\fIコマンド\fRを実行し、それでこの case 文の実行は終了です。マッチしなかった場合は、次の caseitem の処理に移ります。
.RE
.sp
Case 文全体の終了ステータスは、実行した\fIコマンド\fRの終了ステータスです。\fIコマンド\fRが実行されなかった場合 (どのパターンもマッチしなかったか、caseitem が一つもないか、マッチしたパターンの後にコマンドがない場合) は、終了ステータスは 0 です。
.sp
POSIX 準拠モードでは、(\fB|\fR で区切られた最初の) \fIパターン\fRトークンを \fBesac\fR にすることはできません。
.RE
.SS "関数定義"
.sp
関数定義コマンドは、関数を定義します。
.PP
関数定義コマンドの構文
.RS 4
\fB\fI関数名\fR\fR\fB ( ) \fR\fB\fI複合コマンド\fR\fR\fBfunction \fR\fB\fI関数名\fR\fR\fB \fR\fB\fI複合コマンド\fR\fR\fBfunction \fR\fB\fI関数名\fR\fR\fB ( ) \fR\fB\fI複合コマンド\fR\fR
.RE
.sp
予約語 \fBfunction\fR を用いない一つ目の形式では、\fI関数名\fRには引用符などの特殊な記号を含めることはできません。予約語 \fBfunction\fR を用いる二つ目または三つ目の形式では、\fI関数名\fRは実行時に四種展開されます。(POSIX 準拠モードでは予約語 \fBfunction\fR を用いる形式の関数定義は使えません。)
.sp
関数定義コマンドを実行すると、指定した\fI関数名\fRの関数が\fI複合コマンド\fRを内容として定義されます。
.sp
関数定義コマンドに対して直接リダイレクトを行うことはできません。関数定義コマンドの最後にあるリダイレクトは、関数の内容である\fI複合コマンド\fRに対するリダイレクトと見なされます。例えば \fBfunc() { cat; } >/dev/null\fR と書いた場合、リダイレクトされるのは \fBfunc() { cat; }\fR ではなく \fB{ cat; }\fR です。
.sp
関数定義コマンドの終了ステータスは、関数が正しく定義された場合は 0、そうでなければ非 0 です。
.SH "パラメータと変数"
.sp
\fIパラメータ\fRとは、パラメータ展開で値に置き換えられるデータを言います。パラメータには位置パラメータ・特殊パラメータ・変数の三種類があります。
.SS "位置パラメータ"
.sp
\fI位置パラメータ\fRは 1 以上の自然数によって識別されるパラメータです。例えば位置パラメータが三つある場合、それらは順に \fB1\fR, \fB2\fR, \fB3\fR という名称で識別されます。位置パラメータの個数は特殊パラメータ \fB#\fR で取得できます。また全ての位置パラメータを表す特殊パラメータとして \fB*\fR と \fB@\fR があります。
.sp
位置パラメータは、シェルの起動時に、シェルのコマンドライン引数を元に初期化されます (起動時のコマンドライン引数参照)。引数のうち、位置パラメータの値として与えられたオペランドが順に一つずつ位置パラメータとなります。
.sp
シェルのコマンド実行中に関数が呼び出されるとき、位置パラメータはその関数の呼び出しに対する引数に変更されます。すなわち、関数の実行中は位置パラメータによって関数の引数を参照できます。関数呼び出しの直前の位置パラメータの値は保存されており、関数の実行が終了する際に元の値に戻ります。
.sp
位置パラメータは、set や shift などの組込みコマンドによって変更できます。
.sp
\fB0\fR は位置パラメータとは見なされません (特殊パラメータの一つです)。
.SS "特殊パラメータ"
.sp
\fI特殊パラメータ\fRは一文字の記号によって識別されるパラメータです。特殊パラメータにはユーザが明示的に値を代入することはできません。
.sp
Yash では以下の特殊パラメータが利用可能です。
.PP
\fB0\fR
.RS 4
このパラメータの値は、シェルの起動時に与えられたシェルの実行ファイルの名称またはスクリプトファイルの名称です。(起動時のコマンドライン引数参照)
.RE
.PP
\fB#\fR
.RS 4
このパラメータの値は、現在の位置パラメータの個数を表す 0 以上の整数です。
.RE
.PP
\fB$\fR
.RS 4
このパラメータの値は、シェル自身のプロセス ID を表す正の整数です。この値はサブシェルにおいても変わりません。
.RE
.PP
\fB\-\fR
.RS 4
このパラメータの値は、現在シェルで有功になっているオプションの文字をつなげたものです。この値には、シェルの起動時にコマンドライン引数で指定できる一文字のオプションのうち現在有効になっているものが全て含まれます。set 組込みコマンドでオプションを変更した場合は、その変更がこのパラメータの値にも反映されます。
.RE
.PP
\fB?\fR
.RS 4
このパラメータの値は、最後に終了したパイプラインの終了ステータスを表す 0 以上の整数です。
.RE
.PP
\fB!\fR
.RS 4
このパラメータの値は、最後に実行した非同期コマンドのプロセス ID です。
.RE
.PP
\fB*\fR
.RS 4
このパラメータの値は、現在の位置パラメータの値です。位置パラメータが一つもない場合、このパラメータの値は空文字列です。位置パラメータが複数ある場合、このパラメータの値は全ての位置パラメータの値を連結したものです。各位置パラメータの値の間は以下に従って区切られます。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
変数
\fBIFS\fR
が存在し、その値が空でない場合、各位置パラメータは変数
\fBIFS\fR
の値の最初の文字で区切られます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
変数
\fBIFS\fR
が存在し、その値が空の場合、各位置パラメータは間に何も置かずに連結されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
変数
\fBIFS\fR
が存在しない場合、各位置パラメータは空白文字で区切られます。
.RE
.RE
.PP
\fB@\fR
.RS 4
このパラメータは、パラメータ
\fB*\fR
と同様に現在の全ての位置パラメータを表します。ただし、このパラメータが二重引用符によるクォートの中で展開される場合の扱いがパラメータ
\fB*\fR
と異なります。この場合、各位置パラメータは文字で区切られるのではなく、(クォートの内部であるにもかかわらず)
単語分割されます。また位置パラメータが一つもない場合、このパラメータは展開後の単語には残りません。
.sp
例えば位置パラメータが一つもないとき、コマンドライン
\fBecho 1 "$@" 2\fR
は
\fBecho\fR、\fB1\fR、\fB2\fR
という三つの単語に展開されます。位置パラメータが
\fB1\fR、\fB2 2\fR、\fB3\fR
の三つのとき、コマンドライン
\fBecho "$@"\fR
は
\fBecho\fR、\fB1\fR、\fB2 2\fR、\fB3\fR
という四つの単語に展開され、コマンドライン
\fBecho "a$@b"\fR
は
\fBecho\fR、\fBa1\fR、\fB2 2\fR、\fB3b\fR
という四つの単語に展開されます。
.RE
.SS "変数"
.sp
\fI変数\fRとはユーザが自由に代入可能なパラメータです。各変数は名前で区別され、それぞれが文字列の値を持ちます。
.sp
変数の名前は、英数字と下線 (\fB_\fR) から構成されます。ただし変数名の頭文字を数字にすることはできません。環境によってはこれ以外の文字も変数名に使用できます。
.sp
シェルが扱う変数のうち、エクスポートの対象となっているものは\fI環境変数\fRといいます。これらの変数はシェルが外部コマンドを起動する際に外部コマンドに渡されます。シェルが起動されたときにシェルを起動したプログラムから渡された変数は自動的に環境変数になります。
.sp
変数は、単純コマンドによって代入できます。また typeset 組込みコマンドなどでも変数に代入することができます。変数を削除するには unset 組込みコマンドを使います。
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBシェルが使用する変数\fR
.RS 4
.sp
以下の名前の変数は、yash の実行において特別な意味を持っています。
.PP
\fBCDPATH\fR
.RS 4
この変数は
cd 組込みコマンドで移動先ディレクトリを検索するために使われます。
.RE
.PP
\fBCOLUMNS\fR
.RS 4
この変数は端末ウィンドウの横幅 (文字数) を指定します。この変数が設定されている場合、デフォルトの横幅ではなくこの変数の値で指定された横幅が行編集で使われます。
.RE
.PP
\fBCOMMAND_NOT_FOUND_HANDLER\fR
.RS 4
シェルが実行しようとしたコマンドが見つからなかったとき、この変数の値がコマンドとして実行されます。不明なコマンドを実行したときに何か別のコマンドを実行させたい時に便利です。単純コマンドの実行を参照。
.sp
この機能は
POSIX 準拠モードでは働きません。
.RE
.PP
\fBDIRSTACK\fR
.RS 4
この配列変数はディレクトリスタックの実装に使われています。pushd 組込みコマンドでディレクトリを移動したとき、前のディレクトリを覚えておくためにそのパス名がこの配列に入れられます。この配列の内容を変更することは、ディレクトリスタックの内容を直接変更することになります。
.RE
.PP
\fBECHO_STYLE\fR
.RS 4
この変数は
echo 組込みコマンドの挙動を指定します。
.RE
.PP
\fBENV\fR
.RS 4
POSIX 準拠モードで対話モードのシェルが起動されたとき、この変数の値で示されるパスのファイルが初期化スクリプトとして読み込まれます (シェルの初期化処理参照)。
.RE
.PP
\fBFCEDIT\fR
.RS 4
Fc 組込みコマンドでコマンドを編集する際、この変数の値で示されたエディタがコマンドの編集に使われます。
.RE
.PP
\fBHANDLED\fR
.RS 4
この変数は
\fBCOMMAND_NOT_FOUND_HANDLER\fR
変数の値が実行された後に、コマンドが見つからなかったことをエラーとするかどうかを指示します。単純コマンドの実行を参照。
.RE
.PP
\fBHISTFILE\fR
.RS 4
コマンド履歴を保存するファイルのパスを指定します。
.RE
.PP
\fBHISTRMDUP\fR
.RS 4
コマンド履歴の重複をチェックする個数を指定します。履歴にコマンドを追加する際、既に履歴にあるコマンドのうちここで指定した個数のコマンドが新しく追加されるコマンドと同じかどうかをチェックします。同じコマンドが既に履歴にあれば、それは履歴から削除されます。
.sp
例えばこの変数の値が
\fB1\fR
のときは、履歴に追加されるコマンドが一つ前のコマンドと同じならばそれは削除されます。それより古い履歴のコマンドは、(履歴に追加されるコマンドと同じでも) 削除されません。もしこの変数の値が
\fBHISTSIZE\fR
変数の値と同じなら、履歴の中で重複するコマンドはすべて削除されます。あるいはもしこの変数の値が
\fB0\fR
なら、重複する履歴は一切削除されません。
.RE
.PP
\fBHISTSIZE\fR
.RS 4
コマンド履歴に保存される履歴項目の個数を指定します。
.RE
.PP
\fBHOME\fR
.RS 4
ユーザのホームディレクトリのパスを指定します。チルダ展開や
cd 組込みコマンドの動作に影響します。
.RE
.PP
\fBIFS\fR
.RS 4
この変数は単語分割の区切りを指定します。シェルの起動時にこの変数の値は空白文字・タブ・改行の三文字に初期化されます。
.RE
.PP
\fBLANG\fR, \fBLC_ALL\fR, \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, \fBLC_MONETARY\fR, \fBLC_NUMERIC\fR, \fBLC_TIME\fR
.RS 4
これらの変数はシェルが動作するロケールを指定します。シェルが読み書きするファイルのエンコーディングやエラーメッセージの内容などはこの変数で指定されたロケールに従います。
.sp
\fBLC_CTYPE\fR
変数の値はシェルの起動時にのみ反映されます。シェルの実行中にこの変数を変更してもシェルのロケールは変わりません (シェルが非
POSIX 準拠モードで対話モードの場合を除く)。
.RE
.PP
\fBLINENO\fR
.RS 4
この変数の値は、現在シェルが読み込んで実行しているファイルにおける、現在実行中のコマンドのある行番号を示します。(対話モードでは、コマンドを入力して実行するたびに行番号は 1 に戻ります)
.sp
一度この変数に代入したり変数を削除したりすると、この変数を用いて行番号を取得することはできなくなります。
.RE
.PP
\fBLINES\fR
.RS 4
この変数は端末ウィンドウの行数を指定します。この変数が設定されている場合、デフォルトの行数ではなくこの変数の値で指定された行数が行編集で使われます。
.RE
.PP
\fBMAIL\fR
.RS 4
この変数はメールチェックの対象となるファイルのパスを指定します。
.RE
.PP
\fBMAILCHECK\fR
.RS 4
この変数はメールチェックを行う間隔を秒単位で指定します。この変数の値はシェルの起動時に
\fB600\fR
に初期化されます。
.RE
.PP
\fBMAILPATH\fR
.RS 4
この変数はメールチェックの対象となるファイルのパスを指定します。
.RE
.PP
\fBNLSPATH\fR
.RS 4
POSIX によるとこの変数の値はロケール依存のメッセージデータファイルのパスを指示することになっていますが、yash では使用していません。
.RE
.PP
\fBOLDPWD\fR
.RS 4
Cd 組込みコマンドなどで作業ディレクトリを変更したときに、変更前の作業ディレクトリパスがこの変数に設定されます。この変数はデフォルトでエクスポート対象になります。
.RE
.PP
\fBOPTARG\fR
.RS 4
Getopts 組込みコマンドで引数付きのオプションを読み込んだとき、その引数の値がこの変数に設定されます。
.RE
.PP
\fBOPTIND\fR
.RS 4
この変数の値は、getopts 組込みコマンドで次に読み込むオプションのインデックスを表します。シェルの起動時にこの変数は
\fB1\fR
に初期化されます。
.RE
.PP
\fBPATH\fR
.RS 4
この変数は、コマンドの検索時にコマンドのありかを示すパスを指定します。
.RE
.PP
\fBPPID\fR
.RS 4
この変数の値は、シェルの親プロセスのプロセス ID を表す正の整数です。この変数はシェルの起動時に初期化されます。この変数の値はサブシェルにおいても変わりません。
.RE
.PP
\fBPROMPT_COMMAND\fR
.RS 4
POSIX 準拠モードでない対話モードのシェルにおいて、シェルが各コマンドのプロンプトを出す直前に、この変数の値がコマンドとして解釈・実行されます。これは、プロンプトを出す直前に毎回
\fBeval \-i \-\- "${PROMPT_COMMAND\-}"\fR
というコマンドが実行されるのと同じですが、このコマンドの実行結果は次のコマンドでの
\fB?\fR
特殊パラメータの値には影響しません。
.RE
.PP
\fBPS1\fR
.RS 4
この変数の値は、対話モードのシェルが出力する標準のコマンドプロンプトを指定します。この値の書式についてはプロンプトの項を参照してください。
.sp
この変数はシェルの起動時に
\fB\e$ \fR
に初期化されます。(POSIX 準拠モード
なら実効ユーザ ID が 0 かどうかによって
\fB$ \fR
と
\fB# \fR
のどちらか)
.RE
.PP
\fBPS1R\fR
.RS 4
この変数の値は、対話モードのシェルがコマンドを読み込む際に、入力されるコマンドの右側に表示されるプロンプトを指定します。この値の書式についてはプロンプトの項を参照してください。
.RE
.PP
\fBPS1S\fR
.RS 4
この変数の値は、対話モードのシェルがコマンドを読み込む際に、入力されるコマンドを表示するフォントの書式を指定します。この値の書式についてはプロンプトの項を参照してください。
.RE
.PP
\fBPS2\fR
.RS 4
この変数の値は、対話モードのシェルが出力する補助的なコマンドプロンプトを指定します。この値の書式についてはプロンプトの項を参照してください。 この変数はシェルの起動時に
\fB> \fR
に初期化されます。
.RE
.PP
\fBPS2R\fR
.RS 4
この変数は
\fBPS1R\fR
変数と同様ですが、プロンプトとして
\fBPS1\fR
変数ではなく
\fBPS2\fR
変数の値が使用されるときに使用されます。
.RE
.PP
\fBPS2S\fR
.RS 4
この変数は
\fBPS1S\fR
変数と同様ですが、プロンプトとして
\fBPS1\fR
変数ではなく
\fBPS2\fR
変数の値が使用されるときに使用されます。
.RE
.PP
\fBPS4\fR
.RS 4
Xtrace オプションが有効なとき、この変数の値が各トレース出力の前に出力されます。ただし出力の前にこの変数の値に対してパラメータ展開、コマンド置換、数式展開を行います。また
POSIX 準拠モードでなければ、\fBPS1\fR
変数と同様に、バックスラッシュで始まる特殊な記法が利用できます。
.sp
この変数はシェルの起動時に
\fB+ \fR
に初期化されます。
.RE
.PP
\fBPS4S\fR
.RS 4
この変数は
\fBPS1S\fR
変数と同様ですが、プロンプトとして
\fBPS1\fR
変数が使用されるときではなく、トレース出力の際に
\fBPS4\fR
変数の値が使用されるときに使用されます。この変数を使うとトレース出力のフォントの書式を変更することができます。
.RE
.PP
\fBPWD\fR
.RS 4
この変数の値は現在の作業ディレクトリの絶対パスを表します。この変数はシェルの起動時に正しいパスに初期化され、cd 組込みコマンドなどで作業ディレクトリを変更する度に再設定されます。この変数はデフォルトでエクスポート対象になります。
.RE
.PP
\fBRANDOM\fR
.RS 4
この変数は乱数を取得するために使用できます。この変数の値は 0 以上 32768 未満の一様分布乱数になっています。
.sp
この変数に非負整数を代入すると乱数を生成する\fI種\fRを再設定できます。
.sp
一度この変数を削除すると、この変数を用いて乱数を取得することはできなくなります。またシェルが
POSIX 準拠モードで起動された場合、この変数で乱数を取得することはできません。
.RE
.PP
\fBTERM\fR
.RS 4
この変数は対話モードのシェルが動作している端末の種類を指定します。ここで指定された端末の種類に従って行編集機能は端末を制御します。
.RE
.PP
\fBYASH_AFTER_CD\fR
.RS 4
この変数の値は、cd 組込みコマンドや
pushd 組込みコマンドで作業ディレクトリが変更された後にコマンドとして解釈・実行されます。これは、作業ディレクトリが変わった後に毎回
\fBeval \-i \-\- "${YASH_AFTER_CD\-}"\fR
というコマンドが実行されるのと同じです。
.RE
.PP
\fBYASH_LOADPATH\fR
.RS 4
ドット組込みコマンドで読み込むスクリプトファイルのあるディレクトリを指定します。\fBPATH\fR
変数と同様に、コロンで区切って複数のディレクトリを指定できます。この変数はシェルの起動時に、yash に付属している共通スクリプトのあるディレクトリ名に初期化されます。
.RE
.PP
\fBYASH_LE_TIMEOUT\fR
.RS 4
この変数は行編集機能で曖昧な文字シーケンスが入力されたときに、入力文字を確定させるためにシェルが待つ時間をミリ秒単位で指定します。行編集を行う際にこの変数が存在しなければ、デフォルトとして 100 ミリ秒が指定されます。
.RE
.PP
\fBYASH_VERSION\fR
.RS 4
この変数はシェルの起動時にシェルのバージョン番号に初期化されます。
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB配列\fR
.RS 4
.sp
\fI配列\fRとは、一つの変数に複数の値 (文字列) を持たせたものです。一つの配列の複数の値は位置パラメータと同様に 1 以上の自然数で識別されます。
.sp
配列は、単純コマンドによって代入できます。また array 組込みコマンドなどでも配列に代入することができます。配列を削除するには変数と同様に unset 組込みコマンドを使います。
.sp
配列を配列のままエクスポートすることはできません。配列をエクスポートしようとすると、配列の各値をコロンで区切って繋いだ一つの文字列の値を持つ変数としてエクスポートされます。
.sp
POSIX 準拠モードでは配列は使えません。
.RE
.SH "単語の展開"
.sp
コマンドを構成する各単語は、そのコマンドが実行されるときに展開されます。\fI展開\fRとは単語に含まれるパラメータやパターンを処理して具体的な文字列値に置き換えることです。展開には以下の七種類があります。
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
チルダ展開
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
パラメータ展開
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
コマンド置換
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
数式展開
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
ブレース展開
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  6." 4.2
.\}
単語分割
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  7." 4.2
.\}
パス名展開
.RE
.sp
これらの展開は上に挙げた順序で行われます。特に最初の四つ (チルダ展開・パラメータ展開・コマンド置換・数式展開) を\fI四種展開\fRといいます。
.SS "チルダ展開"
.sp
\fIチルダ展開\fRは、\fB~\fR で始まる単語を特定のパス名に置き換える展開です。単語の先頭にある \fB~\fR から最初の \fB/\fR まで (\fB/\fR がない場合は単語全体) が指定されたパス名に変換されます。ただし、置き換えられる部分が一文字でもクォートされている場合は、チルダ展開は行われません。
.sp
展開される内容は、置き換えられる部分の書式によって以下のように決まります。
.PP
\fB~\fR
.RS 4
単なる
\fB~\fR
は、\fBHOME\fR 変数の値に置き換えられます。
.RE
.PP
\fB~\fR\fB\fIusername\fR\fR
.RS 4
\fB~\fR
の後にユーザ名が書かれている場合は、そのユーザのホームディレクトリのパス名に置き換えられます。
.RE
.PP
\fB~+\fR
.RS 4
\fB~+\fR
は、\fBPWD\fR 変数の値に置き換えられます。
.RE
.PP
\fB~\-\fR
.RS 4
\fB~\-\fR
は、\fBOLDPWD\fR 変数の値に置き換えられます。
.RE
.PP
\fB~+\fR\fB\fIn\fR\fR, \fB~\-\fR\fB\fIn\fR\fR
.RS 4
この
\fIn\fR
は 0 以上の整数でなければなりません。この形式のチルダ展開は、+\fIn\fR
または \-\fIn\fR
で指定されるディレクトリスタック内のパスの一つに展開されます。(dirs 組込みコマンド参照)
.RE
.sp
変数代入の値に対してチルダ展開が行われる際、値がコロンで区切ってある場合は、コロンで区切ってある各部分をそれぞれ単語とみなしてチルダ展開します。例えば \fBHOME\fR 変数の値が \fB/home/foo\fR のとき、
.sp
.if n \{\
.RS 4
.\}
.nf
VAR=~/a:~/b:~/c
.fi
.if n \{\
.RE
.\}
.sp
は
.sp
.if n \{\
.RS 4
.\}
.nf
VAR=/home/foo/a:/home/foo/b:/home/foo/c
.fi
.if n \{\
.RE
.\}
.sp
と等価です。
.sp
チルダ展開に失敗した場合 (指定されたパス名が何らかの原因で得られなかった場合) の動作は POSIX では規定されていませんが、yash では何事もなかったかのように処理を続行します (置き換えられるはずだった部分はそのまま残され、エラーメッセージなどは出ません)。
.sp
POSIX 準拠モードでは \fB~\fR と \fB~\fR\fB\fIユーザ名\fR\fR の形式の展開のみが有効です。
.SS "パラメータ展開"
.sp
\fIパラメータ展開\fRは、単語の一部をパラメータの値に置き換える展開です。
.sp
よく使われる単純なパラメータ展開の形式は \fB${\fR\fB\fIパラメータ名\fR\fR\fB}\fR です。これは\fIパラメータ名\fRで指定されたパラメータの値に展開されます。さらに、以下の場合には\fIパラメータ名\fRを囲む括弧を省略して \fB$\fR\fB\fIパラメータ名\fR\fR のように書くこともできます。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIパラメータ名\fRが特殊パラメータの場合
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIパラメータ名\fRが一桁の位置パラメータの場合
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIパラメータ名\fRが変数名で、直後に変数名の一部として誤解される恐れのある文字がない場合。例えば
\fB${path}\-name\fR
という単語は
\fB$path\-name\fR
と書くこともできますが、
\fB${path}name\fR
を
\fB$pathname\fR
と書くことはできません。
.RE
.sp
\fIパラメータ名\fRとして特殊パラメータでも位置パラメータでも変数名でもないものを指定した場合は、構文エラーになります。(Yash 以外のシェルでは構文エラーではなく展開エラーになるものもあります)
.sp
シェルの unset オプションが無効な場合、\fIパラメータ名\fRに存在しない変数を指定すると展開エラーになります。Unset オプションが有効な場合は、存在しない変数は空文字列に展開されます。
.sp
より複雑なパラメータ展開の形式では、パラメータの値を加工することができます。パラメータ展開の一般形は以下の通りです。
.PP
パラメータ展開
.RS 4
\fB${ \fR\fB\fI前置詞\fR\fR\fB \fR\fB\fIパラメータ名\fR\fR\fB \fR\fB\fIインデックス\fR\fR\fB \fR\fB\fI加工指定\fR\fR\fB }\fR
.RE
.sp
ここでは便宜上\fIパラメータ名\fRや\fIインデックス\fRの周りに空白を入れましたが、実際には空白を入れてはいけません。\fIパラメータ名\fR以外の部分はいずれも省略可能です。
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB前置詞\fR
.RS 4
.sp
\fI前置詞\fRとして\fIパラメータ名\fRの直前に記号 \fB#\fR を置くことができます。この場合、このパラメータ展開はいま展開しようとしている値の文字数を表す整数に展開されます。展開しようとしているのが配列変数の場合、各要素がそれぞれ文字数を表す整数に置き換えられます。
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBパラメータ名\fR
.RS 4
.sp
\fIパラメータ名\fRには、特殊パラメータ・位置パラメータ・変数を指定することができます。この場合、パラメータ展開は指定されたパラメータの値に展開されます。指定した\fIパラメータ名\fRが配列変数の場合、配列の各要素が特殊パラメータ \fB@\fR の場合と同様に単語分割されます (インデックス \fB[*]\fR が指定された場合を除く)。
.sp
\fIパラメータ名\fRとしてパラメータ展開・コマンド置換・数式展開を指定することもできます。これは特に\fI展開の入れ子\fRと言います。この場合、パラメータ展開は内側の展開の展開結果に展開されます。なお、内側のパラメータ展開の括弧 \fB{ }\fR は省略できません。また展開の入れ子は POSIX 準拠モードでは使えません。
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBインデックス\fR
.RS 4
.sp
\fIインデックス\fRは展開する値の一部を抜き出すのに使います。インデックスは以下の書式をしています。
.PP
インデックス
.RS 4
\fB[\fR\fB\fI単語1\fR\fR\fB]\fR
.sp
\fB[\fR\fB\fI単語1\fR\fR\fB,\fR\fB\fI単語2\fR\fR\fB]\fR
.RE
.sp
ここでの\fI単語1\fRおよび\fI単語2\fRは通常のトークンと同様に解釈されますが、\fB,\fR と \fB]\fR で強制的に区切られます。また空白やタブはトークンの区切りとはみなしません。
.sp
インデックスは、以下のように解釈されます。
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
まず、\fIインデックス\fRに含まれる\fI単語1\fR・\fI単語2\fRに対してパラメータ展開・コマンド置換・数式展開を行います。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
\fIインデックス\fRが
\fB[\fR\fB\fI単語1\fR\fR\fB]\fR
の書式をしていて、\fI単語1\fRの上記展開結果が
\fB*\fR、\fB@\fR、\fB#\fR
のいずれかの場合は、インデックスの解釈は終了です。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
\fI単語1\fRと\fI単語2\fRの上記展開結果を数式とみなして、数式展開と同様に計算します。計算の結果得られる整数がインデックスとなります。数式展開の結果が整数でない場合は展開エラーです。\fI単語2\fRがない形式でインデックスを指定している場合は、\fI単語2\fRは\fI単語1\fRと同じ整数を指定しているものとみなされます。
.RE
.sp
\fIパラメータ名\fRが配列変数の場合または特殊パラメータ \fB*\fR または \fB@\fR の場合、インデックスは配列の要素または位置パラメータの一部を指定しているものとみなされます。\fIパラメータ名\fRが上記以外の場合は、パラメータの値の一部を指定しているものとみなされます。インデックスで選択された配列の要素またはパラメータの値の一部のみが、パラメータ展開の結果として展開結果に残ります。インデックスによる選択について以下の規則が適用されます。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
インデックスの整数が負数のときは、要素または文字を最後から数えるものとみなされます。例えばインデックス
\fB[\-2,\-1]\fR
は配列の最後の二つの要素 (またはパラメータの値の最後の 2 文字) を選択します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
インデックスの整数が存在しない要素または文字を指示している場合でも、エラーにはなりません。例えば配列の要素数が 4 のときにインデックス
\fB[3,5]\fR
が与えられたときは 3 番目以降の全ての要素が選択され、インデックス
\fB[5,7]\fR
が与えられた時はどの要素も選択されません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
インデックスの整数の一方が 0 ならば、(もう一方が何であれ) 展開結果には何も残りません。
.RE
.sp
\fIインデックス\fRが \fB[\fR\fB\fI単語1\fR\fR\fB]\fR の書式をしていて、\fI単語1\fRの展開結果が \fB*\fR、\fB@\fR、\fB#\fR のいずれかだった場合は、パラメータは以下のように処理されます。
.PP
\fB*\fR
.RS 4
\fIパラメータ名\fRが配列変数の場合、配列の全要素を連結し一つの文字列にします。\fIパラメータ名\fRが特殊パラメータ
\fB*\fR
または
\fB@\fR
の場合、全ての位置パラメータを連結し一つの文字列にします。それ以外の場合はインデックス
\fB[1,\-1]\fR
と同様です。(連結の仕方は特殊パラメータ \fB*\fR
の位置パラメータの連結の仕方と同じです)
.RE
.PP
\fB@\fR
.RS 4
インデックス
\fB[1,\-1]\fR
と同様です。
.RE
.PP
\fB#\fR
.RS 4
\fIパラメータ名\fRが配列変数の場合、このパラメータ展開は配列の要素数を表す整数に展開されます。\fIパラメータ名\fRが特殊パラメータ
\fB*\fR
または
\fB@\fR
の場合、このパラメータ展開は位置パラメータの個数を表す整数に展開されます。それ以外の場合、このパラメータ展開はいま展開しようとしている値の文字数を表す整数に展開されます。
.RE
.sp
パラメータ展開に\fIインデックス\fRが指定されていない場合は、\fIインデックス\fRとして \fB[@]\fR が指定されたものとみなされます。\fIインデックス\fRはPOSIX 準拠モードでは一切使えません。
.PP
\fB例1 通常の変数の展開\fR
.sp
以下のコマンドは文字列 \fBABC\fR を出力します:
.sp
.if n \{\
.RS 4
.\}
.nf
var=\*(Aq123ABC789\*(Aq
echo "${var[4,6]}"
.fi
.if n \{\
.RE
.\}
.PP
\fB例2 位置パラメータの展開\fR
.sp
以下のコマンドは文字列 \fB2 3 4\fR を出力します:
.sp
.if n \{\
.RS 4
.\}
.nf
set 1 2 3 4 5
echo "${*[2,\-2]}"
.fi
.if n \{\
.RE
.\}
.PP
\fB例3 配列の展開\fR
.sp
以下のコマンドは文字列 \fB2 3 4\fR を出力します:
.sp
.if n \{\
.RS 4
.\}
.nf
array=(1 2 3 4 5)
echo "${array[2,\-2]}"
.fi
.if n \{\
.RE
.\}
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB加工指定\fR
.RS 4
.sp
\fI加工指定\fRはパラメータの値を加工します。加工された後の値がパラメータ展開の結果として展開されます。加工指定には以下の形式があります。
.PP
\fB\-\fR\fB\fI単語\fR\fR
.RS 4
\fIパラメータ名\fRが存在しない変数を指示している場合は、このパラメータ展開は\fI単語\fRに展開されます。(Unset オプションが無効な時でもエラーになりません)
.RE
.PP
\fB+\fR\fB\fI単語\fR\fR
.RS 4
\fIパラメータ名\fRが存在する変数を指示している場合は、このパラメータ展開は\fI単語\fRに展開されます。(Unset オプションが無効な時でもエラーになりません)
.RE
.PP
\fB=\fR\fB\fI単語\fR\fR
.RS 4
\fIパラメータ名\fRが存在しない変数を指示している場合は、\fI単語\fRの展開結果がその変数に代入された後、このパラメータ展開はその値に展開されます。変数以外のものに対して代入しようとすると展開エラーになります。(Unset オプションが無効な時でもエラーになりません)
.RE
.PP
\fB?\fR\fB\fI単語\fR\fR
.RS 4
\fIパラメータ名\fRが存在しない変数を指示している場合は、エラーメッセージとして\fI単語\fRを標準エラーに出力します。(\fI単語\fRがない場合はデフォルトのエラーメッセージが出ます)
.RE
.PP
\fB:\-\fR\fB\fI単語\fR\fR, \fB:+\fR\fB\fI単語\fR\fR, \fB:=\fR\fB\fI単語\fR\fR, \fB:?\fR\fB\fI単語\fR\fR
.RS 4
これらは上記の
\fB\-\fR、\fB+\fR、\fB=\fR、\fB?\fR
と\fI単語\fRの組み合わせの加工指定と同様ですが、\fI単語\fRを使用する条件が異なります。先頭に
\fB:\fR
が付かないものでは 『変数が存在するかどうか』 で判定されますが、\fB:\fR
が付くものでは 『変数が存在し、その値が空文字列でないかどうか』 で判定されます。
.RE
.PP
\fB#\fR\fB\fI単語\fR\fR
.RS 4
\fI単語\fRをパターンとして見たとき、それがいま展開しようとしている値の先頭部分にマッチするならば、そのマッチする部分を削除します。結果として、このパラメータ展開はマッチしなかった残りの部分に展開されます。マッチの仕方が複数通りある場合はできるだけ短くマッチさせます。
.RE
.PP
\fB##\fR\fB\fI単語\fR\fR
.RS 4
この加工指定は
\fB#\fR\fB\fI単語\fR\fR
と同様ですが、マッチの仕方が複数通りある場合はできるだけ長くマッチさせる点が異なります。
.RE
.PP
\fB%\fR\fB\fI単語\fR\fR
.RS 4
この加工指定は
\fB#\fR\fB\fI単語\fR\fR
と同様ですが、値の先頭部分ではなく末尾部分にマッチさせる点が異なります。
.RE
.PP
\fB%%\fR\fB\fI単語\fR\fR
.RS 4
この加工指定は
\fB%\fR\fB\fI単語\fR\fR
と同様ですが、マッチの仕方が複数通りある場合はできるだけ長くマッチさせる点が異なります。
.RE
.PP
\fB/\fR\fB\fI単語1\fR\fR\fB/\fR\fB\fI単語2\fR\fR
.RS 4
\fI単語1\fRをパターンとして見たとき、それがいま展開しようとしている値の一部にマッチするならば、そのマッチする部分を\fI単語2\fRに置き換えます。結果として、このパラメータ展開はマッチした部分を\fI単語2\fRに置き換えた値に展開されます。マッチする箇所が複数ある場合は、最初の箇所が選ばれます。マッチの仕方が複数通りある場合はできるだけ長くマッチさせます。
.sp
この加工指定は
POSIX 準拠モードでは使えません。
.RE
.PP
\fB/#\fR\fB\fI単語1\fR\fR\fB/\fR\fB\fI単語2\fR\fR
.RS 4
この加工指定は
\fB/\fR\fB\fI単語1\fR\fR\fB/\fR\fB\fI単語2\fR\fR
と同様ですが、いま展開しようとしている値の先頭部分にしかマッチしない点が異なります。
.RE
.PP
\fB/%\fR\fB\fI単語1\fR\fR\fB/\fR\fB\fI単語2\fR\fR
.RS 4
この加工指定は
\fB/\fR\fB\fI単語1\fR\fR\fB/\fR\fB\fI単語2\fR\fR
と同様ですが、いま展開しようとしている値の末尾部分にしかマッチしない点が異なります。
.RE
.PP
\fB//\fR\fB\fI単語1\fR\fR\fB/\fR\fB\fI単語2\fR\fR
.RS 4
この加工指定は
\fB/\fR\fB\fI単語1\fR\fR\fB/\fR\fB\fI単語2\fR\fR
と同様ですが、マッチする箇所が複数ある場合は最初の箇所だけではなく全ての箇所を\fI単語2\fRに置き換える点が異なります。
.RE
.PP
\fB:/\fR\fB\fI単語1\fR\fR\fB/\fR\fB\fI単語2\fR\fR
.RS 4
この加工指定は
\fB/\fR\fB\fI単語1\fR\fR\fB/\fR\fB\fI単語2\fR\fR
と同様ですが、いま展開しようとしている値全体にマッチする場合しか対象としない点が異なります。
.RE
.sp
いずれの形式においても、加工指定に含まれる単語は (それが使用されるときのみ) 四種展開されます。
.sp
展開しようとしている\fIパラメータ名\fRが配列変数または特殊パラメータ \fB@\fR または \fB*\fR の場合、加工指定は配列の各要素または各位置パラメータに対してそれぞれ作用します。
.RE
.SS "コマンド置換"
.sp
\fIコマンド置換\fRは、指定されたコマンドを実行してその出力をコマンドラインに展開します。コマンド置換の書式は以下の通りです。
.PP
コマンド置換
.RS 4
\fB$(\fR\fB\fIコマンド\fR\fR\fB)\fR
.sp
\fB`\fR\fB\fIコマンド\fR\fR\fB`\fR
.RE
.sp
コマンド置換では、\fIコマンド\fRがサブシェルで実行されます。このときコマンドの標準出力がパイプを通じてシェルに送られます。結果として、コマンド置換はコマンドの出力結果に置き換えられます。ただし、コマンドの出力の末尾にある改行は除きます。
.sp
\fB$(\fR と \fB)\fR で囲んだコマンド置換の\fIコマンド\fRは、コマンド置換の入れ子やリダイレクトなどを考慮して予め解析されます。従って、\fB$(\fR と \fB)\fR の間には基本的に通常通りコマンドを書くことができます。ただし、数式展開との混同を避けるため、中の\fIコマンド\fRが \fB(\fR で始まる場合は\fIコマンド\fRの最初に空白を挿し挟んでください。
.sp
\fB`\fR で囲むコマンド置換では、コマンド置換の入れ子などは考慮せずに、\fIコマンド\fRの中に最初に (バックスラッシュでクォートしていない) \fB`\fR が現れたところでコマンド置換の終わりとみなされます。\fB`\fR で囲んだコマンド置換の中に \fB`\fR で囲んだコマンド置換を書く場合は、内側の \fB`\fR をバックスラッシュでクォートする必要があります。その他、\fIコマンド\fRの一部として \fB`\fR を入れたいときは、(それが\fIコマンド\fR内部で一重または二重引用符でクォートされていても) バックスラッシュでクォートする必要があります。
.sp
\fB$(\fR と \fB)\fR で囲んだコマンド置換の中のコマンドは、そのコマンド置換を含むコマンドを解析する時に一緒に解析されます (POSIX 準拠モードを除く)。\fB`\fR で囲んだコマンド置換の中のコマンドは、POSIX 準拠モードであるかどうかに関わらず、そのコマンド置換が実行される時に毎回解析されます。
.SS "数式展開"
.sp
\fI数式展開\fRは、文字列を数式として解釈して、その計算結果を表す数値に展開します。数式展開の書式は以下の通りです。
.PP
数式展開
.RS 4
\fB$((\fR\fB\fI式\fR\fR\fB))\fR
.RE
.sp
数式展開では、まず\fI式\fRに対してパラメータ展開・コマンド置換・(入れ子の) 数式展開が行われます。その結果得られた文字列を以下のように数式として解釈し、その計算結果を表す数値に展開されます。
.sp
Yash では、数式の中で整数 (C 言語の long 型) と浮動小数点数 (C 言語の double 型) を扱うことができます。ただし POSIX 準拠モードでは浮動小数点数は使えません。整数同士の演算の結果は整数に、浮動小数点数を含む演算の結果は浮動小数点数になります。
.sp
数式では C 言語と (ほぼ) 同様に以下の演算子が使えます。
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
\fB( )\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
\fB++\fR\fB\-\-\fR
(後置演算子)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
\fB++\fR\fB\-\-\fR\fB+\fR\fB\-\fR\fB~\fR\fB!\fR
(前置演算子)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
\fB*\fR\fB/\fR\fB%\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
\fB+\fR\fB\-\fR
(二項演算子)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  6." 4.2
.\}
\fB<<\fR\fB>>\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  7." 4.2
.\}
\fB<\fR\fB<=\fR\fB>\fR\fB>=\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 8.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  8." 4.2
.\}
\fB==\fR\fB!=\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 9.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  9." 4.2
.\}
\fB&\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'10.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "10." 4.2
.\}
\fB^\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'11.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "11." 4.2
.\}
\fB|\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'12.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "12." 4.2
.\}
\fB&&\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'13.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "13." 4.2
.\}
\fB||\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'14.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "14." 4.2
.\}
\fB? :\fR
(三項演算子)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'15.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "15." 4.2
.\}
\fB=\fR\fB*=\fR\fB/=\fR\fB%=\fR\fB+=\fR\fB\-=\fR\fB<<=\fR\fB>>=\fR\fB&=\fR\fB^=\fR\fB|=\fR
.RE
.sp
\fB++\fR および \fB\-\-\fR 演算子は POSIX 準拠モードでは使えません。
.sp
原子式としては整数リテラル・浮動小数点数リテラル・変数が使用できます。数リテラルの書式は C 言語に準じます。\fB0\fR で始まる整数リテラルは八進数、\fB0x\fR で始まる整数リテラルは十六進数とみなされます。浮動小数点数リテラルでは指数表記も使えます (例えば 1\&.23\(mu106 は \fB1\&.23e+6\fR)。変数の値が計算で使われるとき、その値が数値でない場合はエラーになります。
.sp
POSIX 準拠モードでは、変数は必ず数値として解釈されます。 POSIX 準拠モードでないときは、計算で使われる変数のみが数値として解釈され、他の変数はそのまま残ります。
.sp
.if n \{\
.RS 4
.\}
.nf
set +o posixly\-correct
foo=bar
echo $((0 ? foo : foo)) # 「bar」を出力
echo $((foo + 0))       # エラー
.fi
.if n \{\
.RE
.\}
.SS "ブレース展開"
.sp
\fIブレース展開\fRは、ブレース (\fB{ }\fR) で囲んだ部分をいくつかの単語に分割します。ブレース展開は brace\-expand オプションが有効な時のみ行われます。ブレース展開には二種類の形式があります。
.PP
カンマ区切りのブレース展開
.RS 4
\fB{\fR\fB\fI単語1\fR\fR\fB,\fR\fB\fI単語2\fR\fR\fB,\&...,\fR\fB\fI単語n\fR\fR\fB}\fR
.RE
.PP
連続した数値のブレース展開
.RS 4
\fB{\fR\fB\fI始点\fR\fR\fB\&.\&.\fR\fB\fI終点\fR\fR\fB}\fR
.sp
\fB{\fR\fB\fI始点\fR\fR\fB\&.\&.\fR\fB\fI終点\fR\fR\fB\&.\&.\fR\fB\fI差分\fR\fR\fB}\fR
.RE
.sp
一つ目の形式は、ブレースで囲んだ部分を一つ以上のカンマ (\fB,\fR) で区切ったものです。区切られたそれぞれの部分がブレース展開の前後の部分と結合されて、それぞれ単語として展開されます。例えば \fBa{1,2,3}b\fR は \fBa1b\fR、\fBa2b\fR、\fBa3b\fR という三つの単語に展開されます。
.sp
二つ目の形式は \fB\fI{始点\fR\fR\fB\&.\&.\fR\fB\fI終点\fR\fR\fB}\fR または \fB\fI{始点\fR\fR\fB\&.\&.\fR\fB\fI終点\fR\fR\fB\&.\&.\fR\fB\fI差分\fR\fR\fB}\fR です。\fI始点\fR・\fI終点\fR・\fI差分\fRは全て整数である必要があります。この形式のブレース展開では、\fI始点\fRから\fI終点\fRまでの各整数がブレース展開の前後の部分と結合されて、それぞれ単語として展開されます。\fI差分\fRは整数の間隔を指定します。例えば \fBa{1\&.\&.3}b\fR は \fBa1b\fR、\fBa2b\fR、\fBa3b\fR という三つの単語に展開され、\fBa{1\&.\&.7\&.\&.2}b\fR は \fBa1b\fR、\fBa3b\fR、\fBa5b\fR、\fBa7b\fR という四つの単語に展開されます。\fI始点\fRが\fI終点\fRより大きい場合は整数は降順に展開されます。
.sp
複数のブレース展開を組み合わせたり、入れ子にしたりすることもできます。ブレースをブレース展開としてでなく通常の文字として扱うには、ブレースをクォートしてください。またカンマを区切りとしてでなく通常の文字として扱うには、カンマをクォートしてください。
.sp
ブレース展開では展開エラーは発生しません。ブレース展開が正しくできない場合は、単にそれはブレース展開ではなかったものとして、そのまま残されます。
.SS "単語分割"
.sp
\fI単語分割\fRは、展開の結果をいくつかの単語に分割します。
.sp
単語分割で分割の対象となるのは、パラメータ展開・コマンド置換・数式展開で展開された結果の部分だけです。また、二重引用符によるクォートの中で展開された部分は、(特殊パラメータ \fB@\fR の展開を除いて) 分割の対象となりません。
.sp
単語分割は \fBIFS\fR 変数の値に従って行われます。\fBIFS\fR 変数が存在しない場合は、空白文字・タブ・改行の三文字が \fBIFS\fR 変数の値として使われます。
.sp
\fBIFS\fR 変数の値に含まれている文字を \fIIFS 文字\fRといいます。IFS 文字のうち空白文字またはタブまたは改行であるものを \fIIFS 空白類\fRといいます。IFS 空白類以外の IFS 文字を \fIIFS 非空白類\fRといいます。
.sp
分割は以下の規則に従って行われます。
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
分割は、分割の対象となる展開結果の部分の中で、IFS 文字が現れる箇所で行われます。以下このような箇所を\fI分割点\fRと呼びます。複数の IFS 文字が連続して現れる場合は、それらをまとめて一つの分割点とします。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
分割点に IFS 非空白類が含まれている場合、その分割点に含まれる IFS 空白類はすべて無視されます。そして分割点に含まれる各 IFS 非空白類の前後で単語が分割されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
分割点に IFS 非空白類が含まれていない (分割点が IFS 空白類だけからなる) 場合、その分割点の前後で単語が分割されます。ただし、このような分割点が元の単語の先頭または末尾にある場合を除きます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
いずれの場合も、分割点は単語分割後の単語には残りません。
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB注記\fR
.ps -1
.br
.sp
\fBIFS\fR 変数の値が空文字列の場合は、単語は一切分割されません。
.sp .5v
.RE
.SS "パス名展開"
.sp
\fIパス名展開\fRは、単語をパターンとみなしてファイルを検索し、パターンにマッチする実在のファイルへのパス名に展開します。 パス名展開は glob オプションが無効な時は行われません。
.sp
パス名展開においてパターンがマッチするには、検索の対象となるディレクトリの読み込み権限が必要です。検索しようとしたディレクトリがシェルにとって読み込み可能でなければ、シェルはそのディレクトリは空であるとみなします。
.sp
以下のオプションがパス名展開の結果に影響します。
.PP
null\-glob
.RS 4
マッチするファイルがない時、通常 (このオプションが無効な時) はパターンはそのまま残りますが、このオプションが有効な時はパターンは削除され何も残りません。
.RE
.PP
case\-glob
.RS 4
通常 (このオプションが有効な時) は、大文字と小文字を区別してマッチングを行いますが、このオプションが無効な時は大文字と小文字を区別せずマッチングを行います。
.RE
.PP
dot\-glob
.RS 4
通常 (このオプションが無効な時) は、\fB*\fR
や
\fB?\fR
などのワイルドカードやブラケット記法で始まるパターンはピリオドで始まるファイル名にマッチしません。しかしこのオプションが有効な時はこのような制約は解除されます。
.RE
.PP
mark\-dirs
.RS 4
このオプションを有効にすると、マッチしたファイルの種類がディレクトリの場合に展開されるパス名の最後に
\fB/\fR
が付きます。
.RE
.PP
extended\-glob
.RS 4
このオプションを有効にすると、パス名展開における拡張機能 (後述) が使えるようになります。
.RE
.sp
パス名展開ではエラーは発生しません。マッチするファイルがない場合またはパターンが不正な場合は、展開は行われずパターンはそのまま残ります (null\-glob オプションが有効な時を除く)。
.sp
ファイルの検索とパターンマッチングは \fB/\fR で区切られたパス名の構成要素ごとに行われます。ワイルドカードやブラケット記法を全く含まない構成要素はパターンとはみなされず、検索とマッチングは行われません。従って、case\-glob オプションが無効な時、\fB/*/foo\fR と \fB/*/fo[o]\fR の展開結果が異なる可能性があります (前者では \fBfoo\fR の部分がパターンとはみなされないので、例えば /bar/FOO というファイルがあってもマッチしません。)。
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBパス名展開の拡張機能\fR
.RS 4
.sp
Extended-glob オプションが有効な時は、以下の特殊なパターンが使えるようになります。
.PP
\fB**\fR
.RS 4
指定されたディレクトリツリーに対し再帰的に検索を行います。すなわち、指定されたディレクトリと、そのサブディレクトリ、さらにそのサブディレクトリなどに対し検索を行います。ただし名前がピリオドで始まるディレクトリは検索の対象になりません。例えば
\fBdir/**/file\fR
というパターンは、dir/file や dir/foo/file や dir/a/b/c/file など、dir ディレクトリの中にある全ての file ファイルへのパスに展開されます。
.sp
この特殊なパターンは、
\fBfoo/bar/**\fR
のようにパターン全体の最後にある場合には効果がありません。
.RE
.PP
\fB\&.**\fR
.RS 4
\fB**\fR
パターンと同様ですが、名前がピリオドで始まるディレクトリも含めて検索する点が異なります。
.RE
.PP
\fB***\fR
.RS 4
\fB**\fR
パターンと同様ですが、検索の中でディレクトリへのシンボリックリンクが見つかった場合、そのディレクトリの中も検索の対象に含める点が異なります。
.RE
.PP
\fB\&.***\fR
.RS 4
\fB***\fR
パターンと同様ですが、名前がピリオドで始まるディレクトリも含めて検索する点が異なります。
.RE
.RE
.SH "パターンマッチング記法"
.sp
\fIパターンマッチング記法\fRは特定の文字列の集合を表す\fIパターン\fRの書式と意味の定義です。ある文字列があるパターンの表す文字列の集合に含まれる時、その文字列はそのパターンに\fIマッチする\fRといいます。文字列がパターンに当てはまるかどうかは、以下に示す定義に従って判定されます。
.SS "通常の文字"
.sp
クォートしてある文字および以下に示す特殊な意味を持つ文字以外のすべての文字は、通常の文字として扱われます。パターンに含まれる通常の文字は、その文字自身に当てはまります。
.sp
例えば \fBabc\fR というパターンは \fBabc\fR という文字列に当てはまります。(そしてこれ以外の文字列には一切当てはまりません)
.SS "一文字ワイルドカード"
.sp
文字 \fB?\fR は任意の一文字に当てはまります。
.sp
例えば \fBa?c\fR というパターンは \fBaac\fR、\fBabc\fR、\fBa;c\fR など、\fBa\fR で始まり \fBc\fR で終わる任意の 3 文字の文字列に当てはまります。
.SS "複数文字ワイルドカード"
.sp
文字 \fB*\fR は任意の文字列に当てはまります。ここでいう任意の文字列には空文字列も含まれます。 例えば \fBa*c\fR というパターンは \fBac\fR、\fBabc\fR、\fBa;xyz;c\fR など、\fBa\fR で始まり \fBc\fR で終わる任意の文字列に当てはまります。
.SS "ブラケット記法"
.sp
括弧 \fB[\fR と \fB]\fR で囲まれた部分は\fIブラケット記法\fRとみなされます。ただし、括弧の間には少なくとも一文字挟まれている必要があります。括弧の間にある文字は以下に示すブラケット記法のための特殊なパターン (\fIブラケット記法パターン\fR) として解釈されます。ブラケット記法は、括弧の間にあるブラケット記法パターンが示す文字のどれか一つに当てはまります。
.sp
最初の括弧 \fB[\fR の直後に記号 \fB!\fR がある場合、ブラケット記法に当てはまる文字と当てはまらない文字とが逆転します (そしてこの \fB!\fR はブラケット記法パターンの一部とはみなされません)。Yash では \fB[\fR の直後に \fB^\fR がある場合も同様に当てはまる文字と当てはまらない文字とが逆転します (が、他のシェルでは \fB^\fR の扱いが異なることもあります)。
.sp
最初の括弧 \fB[\fR の直後 (あるいは上述の \fB!\fR または \fB^\fR がある場合はその直後) に括弧 \fB]\fR がある場合は、それはブラケット記法の終わりを示す括弧としてではなくブラケット記法パターンの一部とみなされます。ブラケット記法パターンの解釈はクォートの処理の後に行われるので、クォートによってブラケット記法パターン内の文字を通常の文字として扱わせることはできません。
.sp
パターンの中に \fB[\fR が含まれていても、それが正しいブラケット記法の形式になっていない場合は、その \fB[\fR はブラケット記法ではなく通常の文字として扱われます。
.SS "(ブラケット記法パターンにおける) 通常の文字"
.sp
以下に示す特殊な意味を持つ記号以外の文字はすべて通常の文字として扱われます。通常の文字はその文字自身を表します。
.sp
例えば \fB[abc]\fR というブラケット記法は \fBa\fR、\fBb\fR、\fBc\fR のどれかの文字に当てはまります。従って \fBa[abc]c\fR というパターンは \fBaac\fR、\fBabc\fR、\fBacc\fR という三つの文字列に当てはまります (そしてこれ以外の文字列には当てはまりません)。
.SS "範囲指定"
.sp
二つの文字 (または照合シンボル) をハイフン (\fB\-\fR) でつないだものは\fI範囲指定\fRとみなされます。範囲指定は、その二つの文字と照合順序上その間にある全ての文字を表します。\fI照合順序\fRとは文字を辞書順に並べるためにロケールデータに定義される文字の順序関係です。使用中のロケールに定義されている照合順序に従って二つの文字の間にある文字が決まります。
.sp
ハイフンの後に \fB]\fR を置いた場合は、この \fB]\fR はブラケット記法の終わりを示す括弧とみなされ、ハイフンは通常の文字として扱われます。
.sp
例えば \fB[1\-5]\fR というブラケット記法は \fB1\fR、\fB2\fR、\fB3\fR、\fB4\fR、\fB5\fR という五つの文字のどれか一つに当てはまります。
.SS "照合シンボル"
.sp
\fI照合シンボル\fRを用いることで複数の文字からなる照合要素を一つの文字として扱うことができます。(\fI照合要素\fRとは複数の文字をまとめて一つの文字として扱うことができるようにするために考えられた、より一般的な文字の概念です。パターンマッチングにおいて全ての文字は実際には照合要素として扱われています。) 照合シンボルは括弧 \fB[\&. \&.]\fR の中に照合要素を挟んだものとして表します。括弧内に書ける照合要素は使用中のロケールデータにおいて照合要素として登録されているものに限ります。
.sp
例えば従来スペイン語では 『ch』 という二文字を合わせて一文字として扱っていました。この二文字の組み合わせが照合要素としてロケールに登録されているならば、\fB[[\&.ch\&.]df]\fR というブラケット記法は \fBch\fR、\fBd\fR、\fBf\fR のどれかに当てはまります。もしここで \fB[chdf]\fR というブラケット記法を使うと、これは \fBc\fR、\fBh\fR、\fBd\fR、\fBf\fR のどれかに当てはまり、\fBch\fR には当てはまりません。
.SS "等価クラス"
.sp
等価クラスを用いることで、ある文字と\fI等価\fRであるとみなされる文字を指定することができます。等価クラスは括弧 \fB[= =]\fR の中に文字を挟んだものとして表します。括弧の間には照合シンボルのように複数の文字からなる照合要素を書くこともできます (上記参照)。等価クラスは、括弧で挟んだ文字そのものの他に、その文字と同じ第一等価クラスに属する全ての文字を表します。どの文字が第一等価クラスに属するかの定義は使用中のロケールデータに従います。
.sp
例えばロケールデータにおいて a, \(`a, \('a, \(^a, \(~a, \(:a の 6 文字が同じ第一等価クラスに属すると定義されているとき、\fB[[=a=]]\fR というブラケット記法はこれら六つの文字のどれか一つに当てはまります。\fB[[=\(`a=]]\fR や \fB[[=\('a=]]\fR も同様です。
.SS "文字クラス"
.sp
\fI文字クラス\fRは特定の種類の文字の集合を表します。文字クラスは括弧 \fB[: :]\fR の間に文字クラスの名前を囲んだものとして表します。文字クラスの名前としては、以下に挙げる共通の文字クラスの他に、使用中のロケールで定義された独自の文字クラスが使用できます。いずれの文字クラスの場合も、文字クラスにどの文字が含まれるのかは使用中のロケールにおける文字クラスの定義に従います。
.PP
\fB[:lower:]\fR
.RS 4
小文字の集合
.RE
.PP
\fB[:upper:]\fR
.RS 4
大文字の集合
.RE
.PP
\fB[:alpha:]\fR
.RS 4
アルファベットの集合 (\fB[:lower:]\fR
と
\fB[:upper:]\fR
を含む)
.RE
.PP
\fB[:digit:]\fR
.RS 4
十進法の数字の集合
.RE
.PP
\fB[:xdigit:]\fR
.RS 4
十六進法の数字の集合
.RE
.PP
\fB[:alnum:]\fR
.RS 4
アルファベットと数字の集合 (\fB[:alpha:]\fR
と
\fB[:digit:]\fR
を含む)
.RE
.PP
\fB[:blank:]\fR
.RS 4
空白文字の集合 (改行を含まない)
.RE
.PP
\fB[:space:]\fR
.RS 4
空白文字の集合 (改行等を含む)
.RE
.PP
\fB[:punct:]\fR
.RS 4
句読点等の集合
.RE
.PP
\fB[:print:]\fR
.RS 4
表示可能な文字の集合
.RE
.PP
\fB[:cntrl:]\fR
.RS 4
制御文字の集合
.RE
.sp
例えば \fB[[:lower:][:upper:]]\fR というブラケット記法は一文字の小文字または大文字に当てはまります。
.SH "リダイレクト"
.sp
\fIリダイレクト\fRはコマンドのファイル記述子を変更する機能です。リダイレクトを使用すると、コマンドの標準入力や標準出力を通常とは異なるファイルに繋ぎ換えた状態でコマンドを実行することができます。
.sp
リダイレクトはコマンド (単純コマンドまたは複合コマンド) にリダイレクト演算子を付することで行います。単純コマンドでは (他のトークンとくっつかない限り) どこでもリダイレクト演算子を置くことができます。複合コマンドではコマンドの最後にリダイレクト演算子を付けます。
.sp
リダイレクトはコマンドの実行が始まる前に処理されます。一つのコマンドに複数のリダイレクトがある場合は、リダイレクト演算子が書いてある順序で処理されます。オペランドなしの exec 組込みコマンドを実行する場合を除き、リダイレクトは対象となっているコマンドに対してのみ働きます。すなわち、対象のコマンドの実行が終わるとリダイレクトによって変更されたファイル記述子は元の状態に戻ります。
.sp
リダイレクト演算子は、\fB<\fR または \fB>\fR で始まります。\fB<\fR で始まるリダイレクト演算子はデフォルトでは標準入力 (ファイル記述子 0) に作用します。\fB>\fR で始まるリダイレクト演算子はデフォルトでは標準出力 (ファイル記述子 1) に作用します。どちらの種類の演算子でも、演算子の直前に非負整数を指定することでデフォルト以外のファイル記述子に作用させることができます (このとき整数と演算子との間に一切空白などを入れてはいけません。また整数をクォートしてもいけません)。
.SS "ファイルへのリダイレクト"
.sp
最もよく使われるリダイレクトは、ファイルへのリダイレクトです。
.PP
入力のリダイレクト
.RS 4
\fB< \fR\fB\fIトークン\fR\fR
.RE
.PP
出力のリダイレクト
.RS 4
\fB> \fR\fB\fIトークン\fR\fR
.sp
\fB>| \fR\fB\fIトークン\fR\fR
.sp
\fB>> \fR\fB\fIトークン\fR\fR
.RE
.PP
入出力のリダイレクト
.RS 4
\fB<> \fR\fB\fIトークン\fR\fR
.RE
.sp
リダイレクトに含まれる\fIトークン\fRは四種展開されます。対話シェルではさらにパス名展開も行われます (パス名展開の結果が一つのファイルでなければエラーです)。\fIトークン\fRの展開結果がリダイレクト対象のファイル名として使われます。
.sp
入力のリダイレクトでは標準入力が対象ファイルからの読み込み専用ファイル記述子に置き換えられます。対象ファイルを開くことができなければエラーになります。
.sp
出力のリダイレクトでは標準出力が対象ファイルへの書き込み専用ファイル記述子に置き換えられます。対象ファイルが存在しなければ空の通常ファイルが作成されます。対象ファイルが既にある場合はそのファイルが開かれます。ただし演算子の種類によって以下のように挙動が異なります。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
演算子
\fB>|\fR
では、対象ファイルが存在しそれが通常のファイルの場合、ファイルを開く際にファイルの内容を空にします。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
演算子
\fB>\fR
は、clobber オプションが有効ならば演算子
\fB>|\fR
と同じです。しかし clobber オプションが無効ならば、対象ファイルが存在しそれが通常のファイルの場合、エラーになります。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
演算子
\fB>>\fR
では、ファイルを追記モードで開きます。ファイルへの書き込みは常にファイルの末尾へ追記する形で行われます。
.RE
.sp
入出力のリダイレクトでは標準入力が対象ファイルへの読み書き両用ファイル記述子に置き換えられます。対象ファイルが存在しなければ空の通常ファイルが作成されます。
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBソケットリダイレクト\fR
.RS 4
.sp
ファイルのリダイレクトにおいて、対象ファイル名が \fB/dev/tcp/\fR\fB\fIホスト名\fR\fR\fB/\fR\fB\fIポート\fR\fR または \fB/dev/udp/\fR\fB\fIホスト名\fR\fR\fB/\fR\fB\fIポート\fR\fR の形式をしていて、そのファイルを開くことができない場合、ファイル名に含まれる\fIホスト名\fRと\fIポート\fRに対して通信を行うためのソケットが開かれます。
.sp
\fB/dev/tcp/\fR\fB\fIホスト名\fR\fR\fB/\fR\fB\fIポート\fR\fR が対象の場合はストリーム通信ソケットを、\fB/dev/udp/\fR\fB\fIホスト名\fR\fR\fB/\fR\fB\fIポート\fR\fR が対象の場合はデータグラム通信ソケットを開きます。典型的には、前者は TCP を、後者は UDP をプロトコルとして使用します。
.sp
ソケットリダイレクトはどのリダイレクト演算子を使っているかにかかわらず常に読み書き両用のファイル記述子を開きます。
.sp
ソケットリダイレクトは POSIX 規格にはない yash の独自拡張です。ただし、bash にも同様の機能があります。
.RE
.SS "ファイル記述子の複製"
.sp
ファイル記述子の複製のリダイレクトでは、既存のファイル記述子をコピーしたり閉じたりできます。
.PP
ファイル記述子の複製
.RS 4
\fB<& \fR\fB\fIトークン\fR\fR
.sp
\fB>& \fR\fB\fIトークン\fR\fR
.RE
.sp
\fIトークン\fRはファイルのリダイレクトの場合と同様に展開されますが、これはファイル名ではなくファイル記述子として解釈されます。すなわち、\fIトークン\fRの展開結果はファイル記述子を表す非負整数となる必要があります。
.sp
演算子 \fB<&\fR は\fIトークン\fRの展開結果で示されたファイル記述子を標準入力に複製します。演算子 \fB>&\fR は\fIトークン\fRの展開結果で示されたファイル記述子を標準出力に複製します。演算子の直前に非負整数を指定することで、複製先のファイル記述子を変更できます。
.sp
\fIトークン\fRの展開結果が非負整数ではなくハイフン (\fB\-\fR) となった場合は、ファイル記述子を複製する代わりに閉じます。演算子 \fB<&\fR では標準入力が、演算子 \fB>&\fR では標準出力がデフォルトで閉じられますが、演算子の直前に非負整数を指定することで、閉じるファイル記述子を変更できます。
.sp
POSIX 準拠モードでは、\fB<&\fR で複製するファイル記述子は読み込み可能でなければならず、\fB>&\fR で複製するファイル記述子は書き込み可能でなければなりません。
.SS "ヒアドキュメントとヒアストリング"
.sp
\fIヒアドキュメント\fR・\fIヒアストリング\fRを使うとコマンドに直接テキストを渡すことができます。
.PP
ヒアドキュメント
.RS 4
\fB<< \fR\fB\fIトークン\fR\fR
.sp
\fB<<\- \fR\fB\fIトークン\fR\fR
.RE
.PP
ヒアストリング
.RS 4
\fB<<< \fR\fB\fIトークン\fR\fR
.RE
.sp
ヒアドキュメント・ヒアストリングでは、標準入力がヒアドキュメント・ヒアストリングの内容を読み込み可能なファイル記述子に置き換えられます。
.sp
ヒアドキュメント演算子 (\fB<<\fR または \fB<<\-\fR) がコマンド中に現れると、その演算子のある行の次の行からはヒアドキュメントの内容とみなされます。ヒアドキュメントの内容の部分は、シェルのコマンドとしては解釈されません。演算子の後にある\fIトークン\fRはヒアドキュメントの内容の終わりを表します。(\fIトークン\fRでは展開は行われませんが、クォートは認識されます。) 演算子のある行より後の行で\fIトークン\fRだけからなる行が現れた時点でヒアドキュメントの内容は終わりだと判断されます。終わりを表す行はヒアドキュメントの内容には含まれません。演算子 \fB<<\-\fR を使っている場合は、ヒアドキュメントの内容の各行頭にあるタブはすべて削除されます。このとき\fIトークン\fRの前にタブがあっても (その行に他の余計な文字がなければ) ヒアドキュメントの内容の終わりとして認識します。
.sp
一行のコマンドに複数のリダイレクト演算子がある場合は、リダイレクトの内容は順番に処理されます。すなわち、その行の次の行からは最初のリダイレクトの内容として扱われ、その内容が終わったら、その次の行からは次のリダイレクトの内容として扱われます。最後のリダイレクトの内容が終わったら、その次の行からは再びコマンドとして解釈されます。
.sp
リダイレクトの内容は基本的に単なる文字列として扱われます。内容に含まれる空白やタブ、その他の記号はそのままコマンドに渡されます。ただし、\fIトークン\fRが全くクォートされていない場合は、ヒアドキュメントの内容はパラメータ展開・コマンド置換・数式展開され、\fB$\fR, \fB`\fR, \fB"\fR, \fB\e\fR の直前にある場合および行の連結を行う場合にのみバックスラッシュを引用符として扱えます。
.sp
ヒアストリングでは、演算子の後にある\fIトークン\fRはファイルのリダイレクトの場合と同様に展開されます。この展開結果がヒアストリングの内容となります。ただしヒアストリングの内容の末尾には自動的に改行が付きます。
.sp
ヒアストリングは POSIX 規格にはない yash の独自拡張ですが、bash, ksh, zsh にも同様の機能があります。
.SS "パイプリダイレクト"
.sp
\fIパイプリダイレクト\fRを用いるとプロセス間通信に利用可能なパイプを開くことができます。
.PP
パイプリダイレクト
.RS 4
\fB>>| \fR\fB\fIトークン\fR\fR
.RE
.sp
\fIトークン\fRはファイルのリダイレクトの場合と同様に展開されますが、これはファイル名ではなくファイル記述子として解釈されます。すなわち、\fIトークン\fRの展開結果はファイル記述子を表す非負整数となる必要があります。
.sp
パイプリダイレクトはパイプを開きます。標準出力 (演算子 \fB>>|\fR の直前に非負整数を指定している場合はその値のファイル記述子) がパイプに書きこむためのファイル記述子になります。また\fIトークン\fRの展開結果で示されたファイル記述子がパイプから読み込むためのファイル記述子になります。
.sp
パイプリダイレクトは POSIX 規格にはない yash の独自拡張です。
.SS "プロセスリダイレクト"
.sp
プロセスリダイレクトを用いると別のコマンドの入力または出力を受け渡せるパイプを開くことができます。
.PP
プロセスリダイレクト
.RS 4
\fB<(\fR\fB\fIサブコマンド\fR\fR\fB\&...)\fR
.sp
\fB>(\fR\fB\fIサブコマンド\fR\fR\fB\&...)\fR
.RE
.sp
プロセスリダイレクトでは、\fIサブコマンド\fRがサブシェルで実行されます。このとき、\fB<(\fR\fB\fIサブコマンド\fR\fR\fB\&...)\fR の形式のプロセスリダイレクトでは、\fIサブコマンド\fRの標準出力がこのコマンドの標準入力に渡るようパイプが開かれます。\fB>(\fR\fB\fIサブコマンド\fR\fR\fB\&...)\fR の形式のプロセスリダイレクトでは、このコマンドの標準出力が\fIサブコマンド\fRの標準入力に渡るようパイプが開かれます。
.sp
プロセスリダイレクトは POSIX 規格にはない yash の独自拡張です。Bash と zsh にはプロセスリダイレクトと同様の構文を用いるプロセス置換という機能がありますが、プロセスリダイレクトとプロセス置換の挙動は異なっており、互換性はありません。
.SH "コマンドの実行とその環境"
.sp
この節ではコマンドがどのように実行されるかを説明します。
.SS "単純コマンドの実行"
.sp
単純コマンドは以下の手順に従って実行されます。
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
単純コマンドに含まれる、変数代入とリダイレクト以外のトークンを全て展開します。展開エラーが発生した場合は、この単純コマンドの実行は中止されます (このとき単純コマンドの終了ステータスは非 0 です)。

以下、展開の結果得られた最初の単語を\fIコマンド名\fR、それ以外の単語を\fIコマンド引数\fRと呼びます。得られた単語が一つの場合は、コマンド引数は存在しません。得られた単語が一つもない場合は、コマンド名もコマンド引数も存在しません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
単純コマンドに対するリダイレクトを実行します。リダイレクトに含まれるトークンの展開はここで行われます。リダイレクトエラーが発生した場合は、この単純コマンドの実行は中止されます (このとき単純コマンドの終了ステータスは非 0 です)。リダイレクトに含まれるトークンの展開時のエラーはリダイレクトエラーに含まれます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
単純コマンドに含まれる変数代入を実行します (配列の代入を含む)。それぞれの変数代入について、値が展開され、指定された名前の変数に代入されます。代入エラーが発生した場合は、この単純コマンドの実行は中止されます (このとき単純コマンドの終了ステータスは非 0 です)。代入される値の展開時のエラーは代入エラーに含まれます。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンド名が存在しないか、あるいはコマンド名が特殊組込みまたは関数を示している場合は、変数代入は恒久的です。すなわち、代入の結果はこの単純コマンドの実行が終わった後もそのまま残ります。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
それ以外の場合は、変数代入は一時的です。すなわち、代入の効果はこの単純コマンドの実行中のみ有効で、実行が終わった後に代入は取り消されます。
.RE
.sp
コマンド名が指定された場合または
all\-export オプションが有効な場合は、代入される変数は自動的にエクスポート対象になります。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
コマンド名が存在しない場合は、単純コマンドの実行はこれで終わりです。単純コマンドの終了ステータスは 0 になります (ただし単純コマンド実行中にコマンド置換が行われた時は、最後のコマンド置換のコマンドの終了ステータスが単純コマンドの終了ステータスになります)。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
後述のコマンドの検索の仕方に従って実行すべきコマンドを特定し、そのコマンドを実行します。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンドが外部コマンドの場合は、コマンドはサブシェルで exec システムコールを呼び出すことにより実行されます。コマンド名とコマンド引数が起動するコマンドに渡されます。またエクスポート対象となっている変数が環境変数としてコマンドに渡されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンドが組込みコマンドの場合は、コマンド引数を引数として組込みコマンドが実行されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンドが関数の場合は、その関数の内容が実行されます。コマンド引数が関数の引数として渡されます。
.RE
.sp
実行したコマンドの終了ステータスがこの単純コマンドの終了ステータスになります。コマンドが見つからなかった場合は、コマンドは実行されず終了ステータスは 127 になります。コマンドが見つかったが起動に失敗した場合は、終了ステータスは 126 になります。コマンドが起動されたがシグナルによって中断された場合は、終了ステータスはそのシグナルの番号に 384 を足した数になります。
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB注記\fR
.ps -1
.br
POSIX ではコマンドがシグナルによって中断された場合の終了ステータスは 128 より大きな数としか定められていないので、yash 以外のシェルでは終了ステータスが異なることがあります。
.sp .5v
.RE
非
POSIX 準拠モードにおいてコマンドが見つからなかったとき、コマンド
\fBeval \-i \-\- "${COMMAND_NOT_FOUND_HANDLER\-}"\fR
が実行されます。ただしこのとき位置パラメータはコマンド名とコマンド引数に一時的に置き換えられます。またこのコマンドの実行中に定義されたローカル変数はこのコマンドの終了時に削除されます。このコマンドの実行時には
\fBHANDLED\fR ローカル変数が空文字列を値としてあらかじめ定義されます。このコマンドの実行後にこの変数の値が空文字列でなくなっていれば、このコマンドの終了ステータスがこの単純コマンドの終了ステータスとなり、コマンドが見つからなかったことはエラーとはみなされません。
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBコマンドの検索\fR
.RS 4
.sp
単純コマンドで実行すべきコマンドは、展開で得られたコマンド名に基づいて以下の手順で特定されます。
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  1." 4.2
.\}
コマンド名にスラッシュ (\fB/\fR) が含まれている場合は、それが実行すべき外部コマンドへのパス名であると特定されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  2." 4.2
.\}
コマンド名が特殊組込みコマンドならば、その組込みコマンドが実行すべきコマンドとして特定されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  3." 4.2
.\}
コマンド名と同じ名前の関数が存在すれば、その関数が実行すべきコマンドとして特定されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  4." 4.2
.\}
コマンド名が準特殊組込みコマンドならば、その組込みコマンドが実行すべきコマンドとして特定されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  5." 4.2
.\}
コマンド名が通常の組込みコマンドならば、その組込みコマンドが実行すべきコマンドとして特定されます。(POSIX 準拠モードのときを除く)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.sp -1
.IP "  6." 4.2
.\}
\fBPATH\fR 変数の値に従って、実行すべき外部コマンドを検索しそのパス名を特定します。
.sp
\fBPATH\fR
変数の値は、いくつかのディレクトリのパス名をコロン (\fB:\fR) で区切ったものとみなされます (空のパス名はシェルの作業ディレクトリを表しているものとみなします)。それらの各ディレクトリについて順に、ディレクトリの中にコマンド名と同じ名前の実行可能な通常のファイルがあるか調査します。そのようなファイルがあれば、そのファイルが実行すべき外部コマンドとして特定されます (ただし、コマンド名と同じ名前の組込みコマンドがあれば、代わりにその組込みコマンドが実行すべきコマンドとして特定されます)。どのディレクトリにもそのようなファイルが見つからなければ、実行すべきコマンドは見つからなかったものとみなされます。
.RE
.sp
外部コマンドの検索が成功しパス名が特定できた場合、そのパス名が絶対パスならば、シェルはそのパス名を記憶し、再び同じコマンドを実行する際に検索の手間を省きます。ただし、再びコマンドを実行しようとした際に、記憶しているパス名に実行可能ファイルが見当たらない場合は、検索をやり直します。シェルが記憶しているパス名は hash 組込みコマンドで管理できます。
.RE
.SS "シェルの終了"
.sp
シェルは、入力が終わりに達して全てのコマンドを解釈・実行し終えた時や、exit 組込みコマンドを実行したときなどに終了します。シェルの終了ステータスは、シェルが最後に実行したコマンドの終了ステータスを 256 で割った余りです (一つもコマンドを実行しなかったときは 0)。
.sp
Trap 組込みコマンドでシェル終了時のハンドラが登録されている場合は、シェルが終了する直前にそのハンドラが実行されます。ただしこのハンドラ内で実行したコマンドはシェルの終了ステータスには影響しません。
.sp
対話モードでないシェルの実行中に下記エラーが発生した場合、シェルは直ちに終了します。このときシェルの終了ステータスは非 0 です。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
文法エラーのためコマンドを解釈できないとき (シェルの初期化中を除く)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
POSIX 準拠モードで、特殊組込みコマンドのオプションやオペランドの使い方が間違っているとき
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
POSIX 準拠モードで、特殊組込みコマンドに対してリダイレクトエラーまたは代入エラーが発生したとき
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
展開エラーが発生したとき (シェルの初期化中を除く)
.RE
.if n \{\
.sp
.\}
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB注記\fR
.ps -1
.br
.sp
Yash はそうではありませんが、コマンドの検索において実行すべきコマンドが見つからなかったときに直ちに終了するようなシェルもあります。
.sp .5v
.RE
.SS "関数"
.sp
\fI関数\fRは一つの複合コマンドを単純コマンドのように呼び出せるようにする機構です。関数は関数定義コマンドによって定義でき、単純コマンドによって実行できます。関数を削除するには unset 組込みコマンドを使います。
.sp
Yash には、シェルの起動時に最初から定義されている関数は一つもありません。
.sp
関数の実行は、関数の内容である複合コマンドを実行することによって行われます。関数の実行中は、関数の引数が位置パラメータになります。それまでの位置パラメータは一時的に使えなくなりますが関数の実行が終わった時に元の位置パラメータに戻ります。
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBローカル変数\fR
.RS 4
.sp
\fIローカル変数\fRとは、関数の実行中にだけ有効な一時的な変数です。ローカル変数は typeset 組込みコマンドを使って作ることができます。関数の実行中に作られたローカル変数は関数の実行が終わった時に削除され、ローカル変数を作る前の元の変数の状態に戻ります。
.sp
関数内で定義したローカル変数は、関数の実行に先立って定義してあった同名の他の変数を\fI隠蔽\fRします。隠蔽された変数は、関数の実行が終わってローカル変数がなくなるまで使えなくなります。
.sp
関数の実行中でないときにローカル変数を作ることはできません。ローカル変数を作ろうとしても、通常の変数になります。
.RE
.SS "コマンドの実行環境"
.sp
シェルは実行時に以下の情報を保持します。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
作業ディレクトリ
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
開いているファイル記述子
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ファイル作成マスク (umask)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
受信時の挙動が 『無視』 に設定されたシグナルの集合 (trap)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
環境変数
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
リソース制限 (ulimit)
.RE
.sp
これらの情報はシェルが起動されたときに元のプログラムからシェルに受け継がれます。そしてシェルが起動する外部コマンドやサブシェルにもシェルから受け継がれます。
.sp
これらの情報は所定の組込みコマンド等を使って変更可能です。
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBサブシェル\fR
.RS 4
.sp
\fIサブシェル\fRは、実行中のシェルのプロセスのコピーです。サブシェルは括弧 \fB( )\fR で囲んだグルーピングやパイプラインで使われます。
.sp
サブシェルはシェルのプロセスのコピーであるため、上記の情報の他にシェルで定義された関数やエイリアスなどの情報も元のシェルから受け継ぎます。ただし、
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Trap 組込みコマンドで登録したシグナルハンドラは、(受信時の挙動が 『無視』 のものを除き) サブシェルではすべて解除されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
サブシェルでは対話モードとジョブ制御は解除され、元のシェルのジョブの情報は受け継がれません。
.RE
.sp
サブシェルは元のシェルとは独立しているため、サブシェルでの作業ディレクトリの変更や変数代入は元のシェルに影響しません。
.RE
.SH "対話モード"
.sp
\fI対話モード\fRは、利用者が直接シェルを操作することを意図したモードです。シェルの起動時に \fB\-i\fR オプションを指定した場合 (その他対話モードが有効になる条件が満たされている場合)、シェルは対話モードになります。シェルが起動した後は、そのシェルの対話モードのオン・オフを切り替えることはできません。
.sp
対話モードが有効な時\&...\&...
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
シェルの初期化時に初期化スクリプトを読み込んで実行します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンドを読み込む際にメールチェックを行い、プロンプトを表示します。ジョブ制御が有効ならジョブの状態変化も表示します。端末の種類によっては行編集が使えます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
実行したコマンドは自動的にコマンド履歴に登録されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
実行したコマンドが SIGINT/SIGPIPE 以外のシグナルによって中断されたとき、シェルはそのことを示す警告メッセージを標準エラーに出力します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ファイルのリダイレクトの対象ファイルを指示するトークンに対してパス名展開を行います。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
非同期コマンドの標準入力が自動的に /dev/null にリダイレクトされません。(POSIX 準拠モードのみ)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンド解釈・実行時に文法エラーや展開エラーが発生してもシェルは終了しません。(シェルの終了を参照)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
SIGINT, SIGTERM, SIGQUIT シグナルを受けても、シェルは終了しません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
シグナル受信時の挙動がシェルの起動時に最初から 『無視』 に設定されていても
trap 組込みコマンドでシグナル受信時の挙動を変更できます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
特殊パラメータ\fB\-\fR
の値に
\fBi\fR
が含まれます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
シェル実行中に
\fBLC_CTYPE\fR 変数の値が変わった時、それを直ちにシェルのロケール情報に反映します。(POSIX 準拠モードを除く)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Exec オプションが無効な時でもコマンドを実行します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Ignore\-eof オプションが効果を発揮します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Exit 組込みコマンドでシェルを終了しようとした時、停止しているジョブがあれば、シェルは警告を表示してすぐには終了しません。このときは続けざまにもう一度 exit コマンドを実行すると本当にシェルを終了させることができます。シェルへの入力が終わりに達した場合も同様です。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Suspend 組込みコマンドでシェルを停止させようとした時、シェルがセッションリーダーならエラーを出力して停止しません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ドット組込みコマンドで読み込むスクリプトファイルが見つからなくても、シェルは終了しません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Exec 組込みコマンドでコマンドの実行に失敗したときでもシェルは終了しません。(POSIX 準拠モードのときを除く)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Wait 組込みコマンドで待っているジョブが終了したとき、そのことを示すメッセージを出力します。(ジョブ制御が有効な時のみ。POSIX 準拠モードを除く)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Read 組込みコマンドが二行目以降を読むときプロンプトを出します。
.RE
.SS "プロンプト"
.sp
対話モードでは、シェルはコマンドの入力を読み取る直前に\fIプロンプト\fRを標準エラーに出力します。プロンプトの内容は \fBPS1\fR 変数で指定します。ただし、複数行にわたるコマンドを読み取る際、二行目以降の読み取りには \fBPS1\fR ではなく \fBPS2\fR 変数の値がプロンプトとして表示されます。
.sp
プロンプトの表示の際には、まず \fBPS1\fR (または \fBPS2\fR) 変数の値がパラメータ展開・コマンド置換・数式展開で展開されます (ただし POSIX によればパラメータ展開だけが行われることになっています)。この展開後の値は以下の通り解釈され、その結果がプロンプトとして標準エラーに出力されます。
.sp
POSIX 準拠モードでは、値に含まれる \fB!\fR はこれから入力しようとしているコマンドの履歴番号に変換されます。感嘆符そのものをプロンプトに表示させるには \fB!!\fR と二つ続けて書きます。これ以外の文字はプロンプトにそのまま表示されます。
.sp
POSIX 準拠モードでないときは、バックスラッシュで始まる以下の記法が解釈されます。これらの記法以外の文字はそのままプロンプトに表示されます。
.PP
\fB\ea\fR
.RS 4
ベル文字 (ASCII コード番号 7)
.RE
.PP
\fB\ee\fR
.RS 4
エスケープ文字 (ASCII コード番号 27)
.RE
.PP
\fB\ej\fR
.RS 4
現在シェルが抱えているジョブの数
.RE
.PP
\fB\en\fR
.RS 4
改行文字 (ASCII コード番号 10)
.RE
.PP
\fB\er\fR
.RS 4
復帰文字 (ASCII コード番号 13)
.RE
.PP
\fB\e!\fR
.RS 4
これから入力しようとしているコマンドの履歴番号
.RE
.PP
\fB\e$\fR
.RS 4
シェルの実効ユーザ ID が 0 のときは
\fB#\fR、それ以外の時は
\fB$\fR。
.RE
.PP
\fB\e\e\fR
.RS 4
バックスラッシュ (\fB\e\fR)
.RE
.PP
\fB\e[\fR, \fB\e]\fR
.RS 4
この二つの記法は、実際には端末に表示されないプロンプトの一部分を指示するのに使います。\fB\e[\fR
と
\fB\e]\fR
で囲んだ部分は、行編集がプロンプトの文字数を計算する際に、文字数に数えられません。端末に表示されないエスケープシーケンスなどをプロンプトに含める際は、その部分を
\fB\e[\fR
と
\fB\e]\fR
で囲んでください。この指定を怠ると、行編集の表示が乱れることがあります。
.RE
.PP
\fB\ef\fR\fB\fIフォント指定\fR\fR\fB\&.\fR
.RS 4
行編集を使用している場合、この記法は端末のフォントの表示を変更するための特殊な文字の羅列に変換されます (端末が対応している場合のみ)。行編集を使用していない場合や端末が対応していない場合は、この記法は単に無視されます。\fIフォント指定\fRの部分にはフォントの種類を指定するための以下の文字を指定します。
.PP
\fBk\fR
.RS 4
文字の色を黒にする
.RE
.PP
\fBr\fR
.RS 4
文字の色を赤にする
.RE
.PP
\fBg\fR
.RS 4
文字の色を緑にする
.RE
.PP
\fBy\fR
.RS 4
文字の色を黄にする
.RE
.PP
\fBb\fR
.RS 4
文字の色を青にする
.RE
.PP
\fBm\fR
.RS 4
文字の色をマゼンタにする
.RE
.PP
\fBc\fR
.RS 4
文字の色をシアンにする
.RE
.PP
\fBw\fR
.RS 4
文字の色を白にする
.RE
.PP
\fBK\fR
.RS 4
背景の色を黒にする
.RE
.PP
\fBR\fR
.RS 4
背景の色を赤にする
.RE
.PP
\fBG\fR
.RS 4
背景の色を緑にする
.RE
.PP
\fBY\fR
.RS 4
背景の色を黄にする
.RE
.PP
\fBB\fR
.RS 4
背景の色を青にする
.RE
.PP
\fBM\fR
.RS 4
背景の色をマゼンタにする
.RE
.PP
\fBC\fR
.RS 4
背景の色をシアンにする
.RE
.PP
\fBW\fR
.RS 4
背景の色を白にする
.RE
.PP
\fBt\fR
.RS 4
文字または背景の色を明るくする (上記の文字・背景の色を変更する文字の直後でのみ有効)
.RE
.PP
\fBd\fR
.RS 4
文字と背景の色を標準状態に戻す
.RE
.PP
\fBs\fR
.RS 4
文字を目立たせる
.RE
.PP
\fBu\fR
.RS 4
文字に下線を引く
.RE
.PP
\fBv\fR
.RS 4
文字の色を反転させる
.RE
.PP
\fBb\fR
.RS 4
文字を点滅させる
.RE
.PP
\fBi\fR
.RS 4
文字の色を暗くする
.RE
.PP
\fBo\fR
.RS 4
文字を太く目立たせる
.RE
.PP
\fBx\fR
.RS 4
文字を見えなくする
.RE
.PP
\fBD\fR
.RS 4
色と装飾を標準状態に戻す
.RE
.sp
文字と背景の色は最終的に端末によって決まるため、実際にはここで指定した色と異なる色で表示されることがあります。
.RE
.sp
入力するコマンドの右側に表示されるプロンプトを指定することもできます (\fI右プロンプト\fR)。\fBPS1\fR/\fBPS2\fR 変数に対応する右プロンプトは \fBPS1R\fR/\fBPS2R\fR 変数で指定します。
.sp
また、プロンプトのフォントだけでなく、入力するコマンドのフォントを変えることもできます。\fBPS1S\fR (または \fBPS2S\fR) 変数に上述のフォントを指定するシーケンスを指定することで、コマンド入力時のコマンドのフォントが変わります。
.sp
POSIX 準拠モードでないときは、プロンプトを出す前に \fBPROMPT_COMMAND\fR 変数の値がコマンドとして実行されます。
.SS "コマンド履歴"
.sp
\fIコマンド履歴\fRは実行したコマンドを記録し後で再び実行することのできる機能です。対話モードでシェルが読み込んだコマンドは自動的にコマンド履歴に記録されます。履歴に記録したコマンドは行編集で呼び出して再実行することができます。また fc・history 組込みコマンドで履歴のコマンドを再実行したり編集したりすることもできます。
.sp
コマンドは行単位で履歴に記録されます。空白以外の文字を一切含まない行は履歴には記録されません。また hist\-space オプションが有効なときは空白で始まる行は履歴に記録されません。
.sp
コマンド履歴の内容は \fBHISTFILE\fR 変数で指定されるファイルに保存されます。対話モードのシェルの起動後に履歴関連の機能が初めて使用されるとき、\fBHISTFILE\fR 変数の値をファイル名とみなしてファイルを開きます。既にファイルに履歴データが保存されている場合は、それが読み込まれます。ファイルが存在しないか内容が履歴データではない場合は、新しい履歴ファイルに初期化されます。\fBHISTFILE\fR 変数が存在しない場合やファイルを開くことができない場合は履歴はファイルに保存されませんが、履歴機能自体は使用できます。
.sp
シェルが記録するコマンドの数は \fBHISTSIZE\fR 変数で指定します。履歴の件数がこの変数の値を超えると順次古いデータから削除されます。この変数が存在しない場合または値が自然数でない場合は、履歴は 500 件まで記録されます。
.sp
\fBHISTFILE\fR および \fBHISTSIZE\fR 変数は履歴機能が初めて使用されるときにのみ参照され、それ以降は変数を再設定しても履歴機能の動作に影響しません。履歴機能が利用されるときというのは、具体的には以下のタイミングです。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Fc
または
history
組込みコマンドを実行したとき
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
行編集を使用してコマンドを入力するとき (履歴データを行編集の中で使わなくても履歴機能は使われます)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
入力したコマンドが履歴に登録されるとき
.RE
.sp
このため \fBHISTFILE\fR および \fBHISTSIZE\fR 変数は原則としてシェルの起動時に読み込まれる初期化スクリプトの中で設定する必要があります。
.sp
複数のシェルプロセスが同じ履歴ファイルを使用している場合、これらのシェルは一つの履歴データを共有します。このとき例えばあるシェルプロセスで実行したコマンドを別のシェルプロセスで実行することができます。同じ履歴を使用しているシェルの間で \fBHISTSIZE\fR が異なっていると履歴が正しく共有されないので、\fBHISTSIZE\fR の値は統一するようにしてください。
.sp
Yash は独自の形式の履歴ファイルを使用しているため、履歴ファイルを他の種類のシェルと共用することはできません。
.sp
履歴に同じコマンドを記録する無駄を解消するため、\fBHISTRMDUP\fR 変数を使用することができます。新しくコマンドを履歴に記録しようとする際、すでに同じコマンドが最近の \fI$HISTRMDUP\fR 件の履歴データの中に記録されていれば、その既に記録されているコマンドは履歴から削除されます。
.SS "メールチェック"
.sp
対話モードのシェルには、電子メールが届いたらそれを知らせる機能があります。これは所定のファイルの更新日時を調べて、更新日時が変わっていたらメッセージを表示するというものです。受信したメールのデータが保存されるファイルをチェック対象として指定しておくことで、メールを受信したときにメッセージが表示されるようになります。
.sp
ファイル更新のチェックはシェルがプロンプトを出す直前に行います。チェックを行う間隔を \fBMAILCHECK\fR 変数で指定することができます。この変数で指定した秒数が経過するごとに、シェルはプロンプトを出す直前にチェックを行います。この変数の値が 0 になっている場合は、プロンプトを出す直前に毎回チェックを行います。また変数の値が 0 以上の整数でない場合は、チェックは一切行いません。
.sp
更新日時をチェックする対象のファイルは \fBMAIL\fR 変数で指定します。この変数にチェックしたいファイルのパス名を指定しておくと、シェルはそのファイルの更新日時をチェックします。ファイルの更新日時が前回チェックしたときと変わっていたら、新着メールを知らせるメッセージを標準エラーに出力します。(ただしファイルが空のときはメッセージは出ません (POSIX 準拠モードのときを除く))
.sp
複数のファイルをチェックの対象にしたい場合やメッセージを自分で指定したい場合は、\fBMAIL\fR 変数の代わりに \fBMAILPATH\fR 変数を使うことができます。\fBMAILPATH\fR 変数が設定されている場合は、\fBMAIL\fR 変数の設定は無視されます。\fBMAILPATH\fR 変数の値には、一つ以上のファイルのパス名をコロン (\fB:\fR) で区切って指定することができます。シェルは毎回のチェックでそれぞれのファイルの更新日時を調べ、ファイルが更新されていたらメッセージを表示します。メッセージを自分で指定するには、パス名の直後にパーセント (\fB%\fR) を置き、続けて表示させたいメッセージを置きます。それぞれのファイルごとに異なるメッセージを指定することができます。(パーセントをパス名とメッセージとの区切りではなくパス名の一部としたい場合はパーセントをバックスラッシュでクォートしてください) パーセントの後に指定されたメッセージは、表示の前にパラメータ展開されます。
.sp
例えば \fBMAILPATH\fR 変数の値が \fB/foo/mail%New mail!:/bar/mailbox%You\*(Aqve got mail:/baz/mail\e%data\fR だとすると、ファイル /foo/mail が更新されたときは \fBNew mail!\fR が、/bar/mailbox が更新されたときは \fBYou\*(Aqve got mail\fR が、/baz/mail%data が更新されたときはデフォルトのメッセージが表示されます。
.SH "ジョブ制御"
.sp
\fIジョブ制御\fRとは、複数のコマンドを同時に実行し、必要に応じてそれらを中断・再開させる機能です。シェルは、オペレーティングシステムが提供する端末の機能やプロセスグループ管理機構などを用いて、ジョブ制御を実現します。
.sp
ジョブ制御が有効な時\&...\&...
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
シェルが起動する各プロセスは、パイプラインごとに共通の一意なプロセスグループに属します。すなわち、シェルが起動するコマンドはそれぞれパイプラインごとに\fIジョブ\fRとして扱われます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
シェルがジョブを起動しそのジョブのプロセスが終了するのを待っている間にそのプロセスが停止した場合、シェルは (プロセスが実際に終了したときと同様に) 次のコマンドの処理に移ります。このときシェルはジョブが停止したことを覚えているので、後でジョブを再開させることができます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ジョブが同期的に実行される場合、そのジョブの実行中はそのジョブのプロセスグループが端末のフォアグラウンドプロセスグループになります。ジョブの実行が終了 (または停止) すると、再びシェルがフォアグラウンドになります。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンド置換のコマンドを実行するサブシェルもまた独立したプロセスグループに属します。しかしシェルはこれをジョブとしては扱わないため、停止・再開させることはできません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
シェルが対話モードの場合、プロンプトを出す前に毎回コマンド
\fBjobs\fR\fB \-n\fR
を実行するのと同様にしてジョブの状態変化を報告します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
非同期コマンドの標準入力が自動的に /dev/null にリダイレクトされません。(POSIX 準拠モードのときを除く)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
SIGTSTP シグナルを受けても、シェルは停止しません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
特殊パラメータ \fB\-\fR
の値に
\fBm\fR
が含まれます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Wait 組込みコマンドで待っているジョブが終了したとき、そのことを示すメッセージを出力します。(対話モードの時のみ。POSIX 準拠モードを除く)
.RE
.sp
ジョブ制御が無効な時、シェルが起動する各プロセスはシェルと同じプロセスグループに属しますが、実行した非同期コマンドはそれぞれジョブ制御の対象となっていないジョブとして扱います。
.sp
ここでジョブ制御に関連する組込みコマンドを簡単に紹介します。
.PP
jobs
.RS 4
現在シェルが管理しているジョブを表示します。
.RE
.PP
fg および bg
.RS 4
ジョブをフォアグラウンドまたはバックグラウンドで実行します。主に停止したジョブを再開させるのに使います。
.RE
.PP
wait
.RS 4
ジョブが終了 (または停止) するまで待ちます。
.RE
.PP
disown
.RS 4
ジョブの存在を忘れます。
.RE
.PP
kill
.RS 4
プロセスにシグナルを送ります。
.RE
.sp
対話モードでジョブ制御が有効な時、シェルはプロンプトを出す直前にジョブの状態変化を報告します。これ以外のタイミングで状態変化を報告してほしい場合は、以下のオプションを指定することができます。
.PP
notify
.RS 4
タイミングにかかわらず、ジョブの状態が変化したら直ちにそれを報告します。
.RE
.PP
notify\-le
.RS 4
行編集を行っている最中にジョブの状態が変化したら直ちにそれを報告します。
.RE
.sp
シェルが管理しているジョブは以下のタイミングで削除されます。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ジョブの実行が終了した後、そのことを
jobs 組込みコマンドやプロンプト前の自動報告で表示したとき
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Wait 組込みコマンドでジョブの終了を待ったとき
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Disown 組込みコマンドでジョブを削除したとき
.RE
.SS "ジョブ ID"
.sp
いくつかの組込みコマンドでは、操作対象のジョブを指定するために\fIジョブ ID\fR という以下のような記法を用います。
.PP
\fB%\fR, \fB%%\fR, \fB%+\fR
.RS 4
現在のジョブ
.RE
.PP
\fB%\-\fR
.RS 4
前のジョブ
.RE
.PP
\fB%\fR\fB\fIn\fR\fR
.RS 4
ジョブ番号が
\fIn\fR
のジョブ (\fIn\fR
は自然数)
.RE
.PP
\fB%\fR\fB\fIstring\fR\fR
.RS 4
ジョブ名が\fI文字列\fRで始まるジョブ
.RE
.PP
\fB%?\fR\fB\fIstring\fR\fR
.RS 4
ジョブ名が\fI文字列\fRを含むジョブ
.RE
.sp
\fI現在のジョブ\fR及び\fI前のジョブ\fRとは、シェルが特定の方法で選んだジョブのことで、fg 組込みコマンドなどでジョブを選択しやすくするために用意されています。現在のジョブと前のジョブは以下の規則を満たすように選ばれます。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
停止中のジョブがある場合は、現在のジョブはその中から選ばれます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
現在のジョブ以外に停止中のジョブがある場合は、前のジョブはその中から選ばれます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
現在のジョブと前のジョブは異なるジョブになるように選ばれます。ジョブが一つしかないときはそれが現在のジョブになり、前のジョブはなくなります。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
現在のジョブが終了したときは、前のジョブが現在のジョブになります。これ以外に現在のジョブが変更される場合は、元の現在のジョブは前のジョブになります。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
フォアグラウンドで実行していたジョブが停止したときは、そのジョブは現在のジョブになります。
.RE
.sp
Yash には、現在のジョブを選択する方針を指示するためにいくつかのオプションが用意されています。ただしこれらのオプションよりも上記の規則のほうが優先します。
.PP
cur\-async
.RS 4
新しく非同期コマンドを起動したとき、それは現在のジョブになります。
.RE
.PP
cur\-bg
.RS 4
Bg 組込みコマンドでジョブを再開したとき、そのジョブは現在のジョブになります。
.RE
.PP
cur\-stop
.RS 4
実行中のジョブが停止したとき、そのジョブは現在のジョブになります。
.RE
.sp
これらの規則・オプションに反しない限り、一度選ばれた現在のジョブ・前のジョブはずっと現在のジョブ・前のジョブのままです。
.sp
POSIX は現在のジョブ・前のジョブの選択方法を細かく定めていないため、他のシェルでは選び方が異なることがあります。
.SH "組込みコマンド"
.sp
\fI組込みコマンド\fRとはシェルに内蔵されたコマンドです。組込みコマンドは外部のプログラムを起動することなくシェル自身によって実行されます。
.SS "組込みコマンドの種類"
.sp
Yash の組込みコマンドは特殊組込みコマンド・準特殊組込みコマンド・通常の組込みコマンドの三種類に分けられます。
.sp
\fI特殊組込みコマンド\fRは他の組込みコマンドよりも特に重要なコマンドで、他のコマンドとは異なる性質をいくつか持っています。まず、特殊組込みコマンドは対応する外部コマンドの存在に関係なく常に実行されます。また特殊組込みコマンドにおける変数代入の結果はコマンドの実行が終わった後も残ります。さらに POSIX 準拠モードでは、特殊組込みコマンドにおいてリダイレクトエラーまたは代入エラーが発生した場合あるいはコマンドのオプションやオペランドの使い方が間違っている場合、シェルが対話モードでなければシェルは直ちに非 0 の終了ステータスで終了します。
.sp
\fI準特殊組込みコマンド\fRは特殊組込みコマンドに次いで重要な組込みコマンドで、対応する外部コマンドの存在に関係なく常に実行されます。その他の点では準特殊組込みコマンドは通常の組込みコマンドと同じです。
.sp
外部コマンドとして実装可能な組込みコマンドや POSIX に規定されていない組込みコマンドを含む、重要度の低い組込みコマンドは\fI通常の組込みコマンド\fRです。POSIX 準拠モードでは、通常の組込みコマンドは対応する外部コマンドが \fBPATH\fR 変数の検索で見つかった場合のみ実行されます。
.SS "コマンドの引数の構文"
.sp
ここでは組込みコマンドの引数に関する一般的な規則について説明します。Yash の組込みコマンドの引数の指定・解釈の仕方は、他に断りがない限りこの規則に従います。
.sp
コマンドの引数は、オプションとオペランドの二種類に分けられます。\fIオプション\fRはハイフン (\fB\-\fR) で始まる引数で、主にコマンドの動作を変更するのに使われます。オプションの中にはそれに対応する引数をとるものもあります。\fIオペランド\fRはオプション以外の引数で、主にコマンドが処理を行う対象を指定するのに使われます。
.sp
一つのコマンドに複数のオプションを与える場合、原則としてそれらのオプションの順序はコマンドの動作に影響しません。しかしオペランドの順序には意味があります。
.sp
オプションには一文字のオプションと長いオプションとがあります。\fI一文字のオプション\fRは英数字一文字によって識別されるオプションです。\fI長いオプション\fRはもっと長い文字列によって識別されるオプションです。POSIX 規格は一文字のオプションについてしか規定していないため、POSIX 準拠モードでは長いオプションは使えません。
.sp
一文字のオプションは、一つのハイフンと一文字の英数字からなります。例えば \fB\-a\fR は一文字のオプションです。引数をとるオプションでは、コマンドに与えられた引数の並びの中でそのオプションの直後に位置している引数がそのオプションに対する引数とみなされます。
.PP
\fB例4 Set 組込みコマンドと一文字のオプション\fR
.sp
Set 組込みコマンドにおいて、\fB\-m\fR は引数をとらない一文字のオプション、\fB\-o\fR は引数をとる一文字のオプションです。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBset \-o errexit \-m\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBset \-oerrexit \-m\fR
.RE
.sp
この二つの例では、\fBerrexit\fR が \fB\-o\fR オプションに対する引数となります。
.sp
上の二つ目の例では、\fB\-o\fR オプションとそれに対する引数が一つのコマンドライン引数になっています。POSIX はこのような書き方は避けなければならないと定めており、POSIX に従うアプリケーションは必ず一つ目の例のようにオプションとそれに対する引数を別々のコマンドライン引数として与えなければなりません。しかし yash はどちらの指定の仕方も受け付けるようになっています。
.sp
引数をとらない複数の一文字のオプションは、一つにまとめて書くことができます。例えば \fB\-a\fR, \fB\-b\fR, \fB\-c\fR という三つのオプションは \fB\-abc\fR と書けます。
.sp
長いオプションは、二つのハイフンとオプション名を表す文字列からなります。例えば \fB\-\-long\-option\fR は長いオプションです。オプション名は他と紛らわしくない限り末尾を省略できます。例えば他に \fB\-\-long\fR で始まる長いオプションがなければ、\fB\-\-long\-option\fR は \fB\-\-long\fR と省略できます。引数をとるオプションでは、一文字のオプションの場合と同様に、オプションの直後にあるコマンドライン引数がそのオプションに対する引数とみなされます。あるいは、オプション名の後に等号 (\fB=\fR) で区切って直接引数を与えることもできます。
.PP
\fB例5 Fc 組込みコマンドと長いオプション\fR
.sp
Fc 組込みコマンドにおいて、\fB\-\-quiet\fR は引数をとらない長いオプション、\fB\-\-editor\fR は引数をとる長いオプションです。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBfc \-\-editor vi \-\-quiet\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBfc \-\-editor=vi \-\-quiet\fR
.RE
.sp
この二つの例では、\fBvi\fR が \fB\-\-editor\fR オプションに対する引数となります。
.sp
オプション (およびオプションに対する引数) 以外の引数は、全てオペランドとみなされます。POSIX は、オペランドは全てオプションより後に書かなければならないと定めています。そのため POSIX 準拠モードでは、最初のオペランドより後にある引数は (たとえそれがオプションであるように見えても) 全てオペランドとして解釈します。POSIX 準拠モードでないときは、オペランドの後にオプションを書いても構いません。
.sp
POSIX 準拠モードであるかどうかにかかわらず、ハイフン二つからなる引数 (\fB\-\-\fR) はオプションとオペランドとの区切りとして使えます。この区切り以降の全てのコマンドライン引数はオペランドとして解釈されるため、ハイフンで始まるオペランドを正しく指定できます。
.PP
\fB例6 Set 組込みコマンドのオプションとオペランド\fR
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBset \-a \-b \-\- \-c \-d\fR
.RE
.sp
この例では、\fB\-a\fR と \fB\-b\fR がオプションで、\fB\-c\fR と \fB\-d\fR がオペランドとなります。区切り (\fB\-\-\fR) 自体はオプションでもオペランドでもありません。
.sp
POSIX 準拠モードであるかどうかにかかわらず、ハイフン一つからなる引数 (\fB\-\fR) は常にオペランドとみなされます。
.SH "行編集"
.sp
\fI行編集\fR機能は、対話モードのシェルにコマンドを入力する際に使える、コマンドの簡易編集機能です。行編集機能は、コマンドを編集するための簡単なエディタとして働きます。行編集機能はコマンド履歴とも連携しており、fc コマンドを使ってエディタを起動する代わりに行編集で直接コマンドを編集・再実行できます。
.sp
行編集には複数の編集モードがあり、モードごとにキー操作の割り当てが異なります。行編集の有効・無効を切り替えたりモードを選択したりするには、set 組込みコマンドで編集モードに対応するオプションを設定します。あるモードに対応するオプションを有効にすると、そのモードの行編集が有効になります (同時に他のモードのオプションは自動的に無効になります)。現在有効になっているモードのオプションを無効にすると、行編集は無効になります。現在 yash が搭載している編集モードは vi 風と emacs 風の二種類で、それぞれ対応するオプションは \fB\-o vi\fR と \fB\-o emacs\fR です。
.sp
シェルが対話モードで起動したとき、標準入力と標準エラーがともに端末ならば、vi 風行編集が自動的に有効になります。
.sp
行編集は、標準入力と標準エラーがともに端末のときだけ使えます。この条件が満たされていないときは、行編集は働きません。行編集が働くとき、シェルは termios インタフェースを使用して端末の入出力モードを一時的に変更し、terminfo インタフェースを使用して入力されたキーの判別などを行います。
.SS "行編集のオプション"
.sp
行編集を有効にし編集モードを選択するオプションとして、以下のオプションが set 組込みコマンドで設定できます。
.PP
vi
.RS 4
Vi 風編集モードを有効にします
.RE
.PP
emacs
.RS 4
Emacs 風編集モードを有効にします
.RE
.sp
この他に、行編集に関わるものとして以下のオプションが設定できます。
.PP
le\-always\-rp
.RS 4
このオプションが無効な時は、長いコマンドを入力してコマンドが右プロンプトに達すると、右プロンプトは見えなくなります。このオプションが有効な時は、右プロンプトは見えなくなる代わりに下に移動します。
.RE
.PP
le\-comp\-debug
.RS 4
補完を行う際にデバッグ用の情報を出力します
.RE
.PP
le\-conv\-meta
.RS 4
Terminfo データベースで得られた情報を無視し、入力の 8 ビット目を常に meta\-key フラグとみなします。
.RE
.PP
le\-no\-conv\-meta
.RS 4
Terminfo データベースで得られた情報を無視し、入力の 8 ビット目を他のビットと同様に扱います。
.sp
Le\-conv\-meta オプションと le\-no\-conv\-meta オプションは片方しか有効にできません (片方を有効にするともう片方は自動的に無効になります)。どちらも無効な時は terminfo データベースの情報に従って 8 ビット目を meta\-key とみなすかどうか判断します。
.RE
.PP
le\-prompt\-sp
.RS 4
このオプションが有効な時、シェルはプロンプトを出力する前に、プロンプトが必ず行頭に来るようにカーソルを移動するための特殊な文字列を出力します。
.sp
このオプションは最初から有効になっています。
.RE
.PP
le\-visible\-bell
.RS 4
シェルが警告を発する際、警告音を鳴らす代わりに端末を点滅させます。
.RE
.SS "編集モード"
.sp
\fIVi 風編集モード\fRは vi に似たキー操作で編集を行う編集モードです。Vi 風編集モードでは、挿入モードとコマンドモードの二つのモードを適宜切り替えて編集を行います。編集が始まるときはモードは必ず挿入モードになっています。挿入モードでは入力した文字が基本的にそのままバッファに挿入されます。コマンドモードでは入力した文字はカーソルを移動したり文字を消去したりするコマンドとして解釈されます。
.sp
\fIEmacs 風編集モード\fRは emacs に似たキー操作で編集を行う編集モードです。入力した文字は基本的にそのままバッファに挿入されますが、コマンドとして解釈される一部のキー操作が vi 風編集モードの挿入モードと異なります。
.sp
これらのモードの他に、コマンドの検索の際に用いる検索モードが vi 風と emacs 風とそれぞれにあります。
.SS "行編集コマンド"
.sp
行編集中に入力された文字は全て以下の行編集コマンドのいずれかとして解釈されます。コマンドとキーの対応は bindkey 組込みコマンドで変更できます (検索モードを除く)。
.sp
以下の一覧には各コマンドに対応するキー入力の初期設定も示してあります。なお、 『vi\-insert』 は vi 風編集モードの挿入モードを、 『vi\-command』 は vi 風編集モードのコマンドモードを、 『vi\-search』 は vi 風編集モードの検索モードを、 『emacs』 は emacs 風編集モードを、 『emacs\-search』 は emacs 風編集モードの検索モードを示します。
.sp
コマンドの中には引数を指定することでその動作を変更できるものがあります。例えば forward\-char コマンドは通常はカーソルを一文字分前に移動しますが、引数を指定するとその引数の文字数分だけカーソルを移動します。引数は、目的のコマンドの直前に digit\-argument コマンドを使うことで指定できます。
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB基本的な編集コマンド\fR
.RS 4
.PP
noop
.RS 4
何も行いません。
.PP
vi\-command
.RS 4
\fB\e^[\fR
.RE
.RE
.PP
alert
.RS 4
警告音を発しまたは端末を点滅させます。
.RE
.PP
self\-insert
.RS 4
入力した文字を現在のカーソルの位置に挿入します。(エスケープシーケンスによるエスケープの対象となる文字は挿入できません)
.PP
vi\-insert, emacs
.RS 4
\fB\e\e\fR
.RE
.RE
.PP
insert\-tab
.RS 4
タブを現在のカーソルの位置に挿入します。
.PP
emacs
.RS 4
\fB\e^[\e^I\fR
.RE
.RE
.PP
expect\-verbatim
.RS 4
このコマンドの直後に入力する一文字を現在のカーソル位置に挿入します。このコマンドを使うと self\-insert コマンドで入力できない文字も入力できます (ナル文字
\fB\*(Aq\e0\*(Aq\fR
を除く)。
.PP
vi\-insert, vi\-search, emacs\-search
.RS 4
\fB\e^V\fR
.RE
.PP
emacs
.RS 4
\fB\e^Q\fR,
\fB\e^V\fR
.RE
.RE
.PP
digit\-argument
.RS 4
このコマンドは数字またはハイフンの入力に対してのみ有効です。入力した数字を次のコマンドへの引数として受け付けます (ハイフンの場合は符号を反転します)。
.sp
Digit\-argument コマンドを連続して使うことで複数桁の引数を指定できます。例えば vi 風編集モードのコマンドモードで
\fB12l\fR
と入力すると、forward\-char コマンドに引数 12 を与えたことになります (すなわちカーソルが左に 12 文字分移動します)。
.PP
vi\-command
.RS 4
\fB1\fR,
\fB2\fR,
\fB3\fR,
\fB4\fR,
\fB5\fR,
\fB6\fR,
\fB7\fR,
\fB8\fR,
\fB9\fR
.RE
.PP
emacs
.RS 4
\fB\e^[0\fR,
\fB\e^[1\fR,
\fB\e^[2\fR,
\fB\e^[3\fR,
\fB\e^[4\fR,
\fB\e^[5\fR,
\fB\e^[6\fR,
\fB\e^[7\fR,
\fB\e^[8\fR,
\fB\e^[9\fR,
\fB\e^[\-\fR,
.RE
.RE
.PP
bol\-or\-digit
.RS 4
引数がない場合は beginning\-of\-line コマンドと同じように、引数がある場合は digit\-argument コマンドと同じように動作します。
.PP
vi\-command
.RS 4
\fB0\fR
.RE
.RE
.PP
accept\-line
.RS 4
行編集を終了し、現在のバッファの内容をシェルへの入力として与えます。行の末尾には自動的に改行が付け加わります。
.PP
vi\-insert, vi\-command, emacs, emacs\-search
.RS 4
\fB\e^J\fR,
\fB\e^M\fR
.RE
.RE
.PP
abort\-line
.RS 4
行編集を中止し、空の入力をシェルに与えます。
.PP
vi\-insert, vi\-command, vi\-search, emacs, emacs\-search
.RS 4
\fB\e!\fR,
\fB\e^C\fR
.RE
.RE
.PP
eof
.RS 4
シェルに入力の終わりを知らせます (これによりシェルは終了します)。
.RE
.PP
eof\-if\-empty
.RS 4
バッファが空ならば、行編集を終了し、シェルに入力の終わりを知らせます (これによりシェルは終了します)。バッファが空でなければ、alert コマンドと同じ動作をします。
.PP
vi\-insert, vi\-command
.RS 4
\fB\e#\fR,
\fB\e^D\fR
.RE
.RE
.PP
eof\-or\-delete
.RS 4
バッファが空ならば、行編集を終了し、シェルに入力の終わりを知らせます (これによりシェルは終了します)。バッファが空でなければ、delete\-char コマンドと同じ動作をします。
.PP
emacs
.RS 4
\fB\e#\fR,
\fB\e^D\fR
.RE
.RE
.PP
accept\-with\-hash
.RS 4
引数が与えられていないかバッファの最初の文字が
\fB#\fR
でなければ、バッファの最初に
\fB#\fR
を挿入します。そうでなければバッファの最初の
\fB#\fR
を削除します。いずれの場合も、その後 accept\-line コマンドと同じ動作をします。
.PP
vi\-command
.RS 4
\fB#\fR
.RE
.PP
emacs
.RS 4
\fB\e^[#\fR
.RE
.RE
.PP
setmode\-viinsert
.RS 4
編集モードを vi 風編集モードの挿入モードに変更します。
.PP
vi\-command
.RS 4
\fBi\fR,
\fB\eI\fR
.RE
.RE
.PP
setmode\-vicommand
.RS 4
編集モードを vi 風編集モードのコマンドモードに変更します。
.PP
vi\-insert
.RS 4
\fB\e^[\fR
.RE
.RE
.PP
setmode\-emacs
.RS 4
編集モードを emacs 風編集モードに変更します。
.RE
.PP
expect\-char, abort\-expect\-char
.RS 4
これは find\-char コマンドなどを実装するために yash 内部で使われているコマンドで、直接使用しても意味はありません。
.RE
.PP
redraw\-all
.RS 4
行編集のプロンプトやバッファを端末に表示しなおします。
.PP
vi\-insert, vi\-command, vi\-search, emacs, emacs\-search
.RS 4
\fB\e^L\fR
.RE
.RE
.PP
clear\-and\-redraw\-all
.RS 4
端末の表示をクリアし、行編集のプロンプトやバッファを端末に表示しなおします。
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB移動コマンド\fR
.RS 4
.sp
\fI移動コマンド\fRはカーソルを移動させるコマンドです。ほとんどの移動コマンドは引数を与えることでそのコマンドを引数の回数だけ実行するのと同じように動作させられます。例えば forward\-char コマンドに引数 4 を与えると、カーソルを 4 文字先に進めます。
.sp
以下、\fIbigword\fR とは一文字以上の連続した空白でない文字をいい、\fIsemiword\fR とは一文字以上の連続した空白でも句読点でもない文字をいい、\fIemacsword\fR とは一文字以上の連続した英数字をいいます。また \fIviword\fR とは以下のいずれかをいいます
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
一文字以上の連続した英数字または下線 (\fB_\fR)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
一文字以上の連続した、英数字でも下線でも空白でもない文字
.RE
.sp
以下に移動コマンドの一覧を示します。
.PP
forward\-char
.RS 4
カーソルを次の文字に移動します。
.PP
vi\-insert
.RS 4
\fB\eR\fR
.RE
.PP
vi\-command
.RS 4
\fBl\fR, (space),
\fB\eR\fR
.RE
.PP
emacs
.RS 4
\fB\eR\fR,
\fB\e^F\fR
.RE
.RE
.PP
backward\-char
.RS 4
カーソルを前の文字に移動します。
.PP
vi\-insert
.RS 4
\fB\eL\fR
.RE
.PP
vi\-command
.RS 4
\fBh\fR,
\fB\eB\fR,
\fB\eL\fR,
\fB\e?\fR,
\fB\e^H\fR
.RE
.PP
emacs
.RS 4
\fB\eL\fR,
\fB\e^B\fR
.RE
.RE
.PP
forward\-bigword
.RS 4
カーソルを次の bigword に移動します。
.PP
vi\-command
.RS 4
\fBW\fR
.RE
.RE
.PP
end\-of\-bigword
.RS 4
カーソルを bigword の終わりまで移動します。
.PP
vi\-command
.RS 4
\fBE\fR
.RE
.RE
.PP
backward\-bigword
.RS 4
カーソルを前の bigword に移動します。
.PP
vi\-command
.RS 4
\fBB\fR
.RE
.RE
.PP
forward\-semiword
.RS 4
カーソルを次の semiword に移動します。
.RE
.PP
end\-of\-semiword
.RS 4
カーソルを semiword の終わりまで移動します。
.RE
.PP
backward\-semiword
.RS 4
カーソルを前の semiword に移動します。
.RE
.PP
forward\-viword
.RS 4
カーソルを次の viword に移動します。
.PP
vi\-command
.RS 4
\fBw\fR
.RE
.RE
.PP
end\-of\-viword
.RS 4
カーソルを viword の終わりまで移動します。
.PP
vi\-command
.RS 4
\fBe\fR
.RE
.RE
.PP
backward\-viword
.RS 4
カーソルを前の viword に移動します。
.PP
vi\-command
.RS 4
\fBb\fR
.RE
.RE
.PP
forward\-emacsword
.RS 4
カーソルを次の emacsword に移動します。
.PP
emacs
.RS 4
\fB\e^[f\fR,
\fB\e^[F\fR
.RE
.RE
.PP
backward\-emacsword
.RS 4
カーソルを前の emacsword に移動します。
.PP
emacs
.RS 4
\fB\e^[b\fR,
\fB\e^[B\fR
.RE
.RE
.PP
beginning\-of\-line
.RS 4
カーソルをバッファの先頭に移動します。
.PP
vi\-insert, vi\-command
.RS 4
\fB\eH\fR
.RE
.PP
emacs
.RS 4
\fB\eH\fR,
\fB\e^A\fR
.RE
.RE
.PP
end\-of\-line
.RS 4
カーソルをバッファの末尾に移動します。
.PP
vi\-insert
.RS 4
\fB\eE\fR
.RE
.PP
vi\-command
.RS 4
\fB$\fR,
\fB\eE\fR
.RE
.PP
emacs
.RS 4
\fB\eE\fR,
\fB\e^E\fR
.RE
.RE
.PP
go\-to\-column
.RS 4
カーソルをバッファ内の
\fIn\fR
文字目に移動します。ただし
\fIn\fR
は引数です (引数が与えられていない場合は 1)。
.PP
vi\-command
.RS 4
\fB|\fR
.RE
.RE
.PP
first\-nonblank
.RS 4
カーソルをバッファ内の最初の空白でない文字に移動します。
.PP
vi\-command
.RS 4
\fB^\fR
.RE
.RE
.PP
find\-char
.RS 4
このコマンドの直後に入力した文字がある位置までカーソルを進めます。
.PP
vi\-command
.RS 4
\fBf\fR
.RE
.PP
emacs
.RS 4
\fB\e^]\fR
.RE
.RE
.PP
find\-char\-rev
.RS 4
このコマンドの直後に入力した文字がある位置までカーソルを戻します。
.PP
vi\-command
.RS 4
\fBF\fR
.RE
.PP
emacs
.RS 4
\fB\e^[\e^]\fR
.RE
.RE
.PP
till\-char
.RS 4
このコマンドの直後に入力した文字がある位置の直前までカーソルを進めます。
.PP
vi\-command
.RS 4
\fBt\fR
.RE
.RE
.PP
till\-char\-rev
.RS 4
このコマンドの直後に入力した文字がある位置の直後までカーソルを戻します。
.PP
vi\-command
.RS 4
\fBT\fR
.RE
.RE
.PP
refind\-char
.RS 4
前回実行した find\-char, find\-char\-rev, till\-char, till\-char\-rev コマンドを再実行します。
.PP
vi\-command
.RS 4
\fB;\fR
.RE
.RE
.PP
refind\-char\-rev
.RS 4
前回実行した find\-char, find\-char\-rev, till\-char, till\-char\-rev コマンドを、カーソルの進む向きを逆にして再実行します。
.PP
vi\-command
.RS 4
\fB,\fR
.RE
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB編集コマンド\fR
.RS 4
.sp
編集コマンドはバッファの内容を変更するコマンドです。ほとんどの編集コマンドは引数を与えることでそのコマンドを引数の回数だけ実行するのと同じように動作させられます。
.sp
名前に 『kill』 が付くコマンドで削除した文字列は\fIキルリング\fRという場所に保管され、後で put などのコマンドでバッファに戻すことができます。
.sp
以下に編集コマンドの一覧を示します。
.PP
delete\-char
.RS 4
カーソルのところにある文字を削除します。引数を与えた場合は kill\-char コマンドと同じ動作をします。
.PP
vi\-insert, emacs
.RS 4
\fB\eX\fR
.RE
.RE
.PP
delete\-bigword
.RS 4
カーソルのところにある bigword を削除します。引数を与えた場合は kill\-bigword コマンドと同じ動作をします。
.RE
.PP
delete\-semiword
.RS 4
カーソルのところにある semiword を削除します。引数を与えた場合は kill\-semiword コマンドと同じ動作をします。
.RE
.PP
delete\-viword
.RS 4
カーソルのところにある viword を削除します。引数を与えた場合は kill\-viword コマンドと同じ動作をします。
.RE
.PP
delete\-emacsword
.RS 4
カーソルのところにある emacsword を削除します。引数を与えた場合は kill\-emacsword コマンドと同じ動作をします。
.RE
.PP
backward\-delete\-char
.RS 4
カーソルの前にある文字を削除します。引数を与えた場合は backward\-kill\-char コマンドと同じ動作をします。
.PP
vi\-insert, emacs
.RS 4
\fB\eB\fR,
\fB\e?\fR,
\fB\e^H\fR
.RE
.RE
.PP
backward\-delete\-bigword
.RS 4
カーソルの前にある bigword を削除します。引数を与えた場合は backward\-kill\-bigword コマンドと同じ動作をします。
.RE
.PP
backward\-delete\-semiword
.RS 4
カーソルの前にある semiword を削除します。引数を与えた場合は backward\-kill\-semiword コマンドと同じ動作をします。
.PP
vi\-insert
.RS 4
\fB\e^W\fR
.RE
.RE
.PP
backward\-delete\-viword
.RS 4
カーソルの前にある viword を削除します。引数を与えた場合は backward\-kill\-viword コマンドと同じ動作をします。
.RE
.PP
backward\-delete\-emacsword
.RS 4
カーソルの前にある emacsword を削除します。引数を与えた場合は backward\-kill\-emacsword コマンドと同じ動作をします。
.RE
.PP
delete\-line
.RS 4
バッファの内容を全て削除します。
.RE
.PP
forward\-delete\-line
.RS 4
カーソル以降の全ての文字を削除します。
.RE
.PP
backward\-delete\-line
.RS 4
カーソルより前の全ての文字を削除します。
.PP
vi\-insert
.RS 4
\fB\e$\fR,
\fB\e^U\fR
.RE
.RE
.PP
kill\-char
.RS 4
カーソルのところにある文字を削除し、キルリングに保管します。
.PP
vi\-command
.RS 4
\fBx\fR,
\fB\eX\fR
.RE
.RE
.PP
kill\-bigword
.RS 4
カーソルのところにある bigword を削除し、キルリングに保管します。
.RE
.PP
kill\-semiword
.RS 4
カーソルのところにある semiword を削除し、キルリングに保管します。
.RE
.PP
kill\-viword
.RS 4
カーソルのところにある viword を削除し、キルリングに保管します。
.RE
.PP
kill\-emacsword
.RS 4
カーソルのところにある emacsword を削除し、キルリングに保管します。
.PP
emacs
.RS 4
\fB\e^[d\fR,
\fB\e^[D\fR
.RE
.RE
.PP
backward\-kill\-char
.RS 4
カーソルの前にある文字を削除し、キルリングに保管します。
.PP
vi\-command
.RS 4
\fBX\fR
.RE
.RE
.PP
backward\-kill\-bigword
.RS 4
カーソルの前にある bigword を削除し、キルリングに保管します。
.PP
emacs
.RS 4
\fB\e^W\fR
.RE
.RE
.PP
backward\-kill\-semiword
.RS 4
カーソルの前にある semiword を削除し、キルリングに保管します。
.RE
.PP
backward\-kill\-viword
.RS 4
カーソルの前にある viword を削除し、キルリングに保管します。
.RE
.PP
backward\-kill\-emacsword
.RS 4
カーソルの前にある emacsword を削除し、キルリングに保管します。
.PP
emacs
.RS 4
\fB\e^[\eB\fR,
\fB\e^[\e?\fR,
\fB\e^[\e^H\fR
.RE
.RE
.PP
kill\-line
.RS 4
バッファの内容を全て削除し、キルリングに保管します。
.RE
.PP
forward\-kill\-line
.RS 4
カーソル以降の全ての文字を削除し、キルリングに保管します。
.PP
emacs
.RS 4
\fB\e^K\fR
.RE
.RE
.PP
backward\-kill\-line
.RS 4
カーソルより前の全ての文字を削除し、キルリングに保管します。
.PP
emacs
.RS 4
\fB\e$\fR,
\fB\e^U\fR,
\fB\e^X\eB\fR,
\fB\e^X\e?\fR
.RE
.RE
.PP
put\-before
.RS 4
最後にキルリングに保管した文字列をカーソルの直前に挿入します。カーソルは挿入した文字列の最後の文字のところに移動します。
.PP
vi\-command
.RS 4
\fBP\fR
.RE
.RE
.PP
put
.RS 4
最後にキルリングに保管した文字列をカーソルの直後に挿入します。カーソルは挿入した文字列の最後の文字のところに移動します。
.PP
vi\-command
.RS 4
\fBp\fR
.RE
.RE
.PP
put\-left
.RS 4
最後にキルリングに保管した文字列をカーソルの直前に挿入します。カーソルは挿入した文字列の直後に移動します。
.PP
emacs
.RS 4
\fB\e^Y\fR
.RE
.RE
.PP
put\-pop
.RS 4
このコマンドは put\-before, put, put\-left, put\-pop コマンドの直後にだけ使えます。このコマンドは直前のコマンドでキルリングから挿入した文字列を削除し、代わりにその文字列の前にキルリングに保管した文字列を挿入します。
.PP
emacs
.RS 4
\fB\e^[y\fR,
\fB\e^[Y\fR
.RE
.RE
.PP
undo
.RS 4
直前の編集コマンドを取り消し、バッファの内容を前の状態に戻します。
.PP
vi
.RS 4
\fBu\fR
.RE
.PP
emacs
.RS 4
\fB\e^_\fR,
\fB\e^X\e$\fR,
\fB\e^X\e^U\fR
.RE
.RE
.PP
undo\-all
.RS 4
全ての編集コマンドを取り消し、バッファの内容を初期状態に戻します。
.PP
vi
.RS 4
\fBU\fR
.RE
.PP
emacs
.RS 4
\fB\e^[\e^R\fR,
\fB\e^[r\fR,
\fB\e^[R\fR
.RE
.RE
.PP
cancel\-undo
.RS 4
undo, undo\-all による編集コマンドの取り消しを取り消し、バッファの内容を復元します。
.PP
vi
.RS 4
\fB\e^R\fR
.RE
.RE
.PP
cancel\-undo\-all
.RS 4
undo, undo\-all による編集コマンドの取り消しを全て取り消し、バッファの内容を復元します。
.RE
.PP
redo
.RS 4
直前の編集コマンドを繰り返します。
.PP
vi\-command
.RS 4
\fB\&.\fR
.RE
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB補完コマンド\fR
.RS 4
.PP
complete
.RS 4
現在のカーソル位置で補完を行います。補完候補が複数ある場合はその一覧を表示します。
.RE
.PP
complete\-next\-candidate
.RS 4
補完候補の一覧を既に表示している場合は一覧の中から次の候補を選択します。それ以外の場合は complete コマンドと同じ動作をします。
.PP
vi\-insert, emacs
.RS 4
\fB\e^I\fR
.RE
.RE
.PP
complete\-prev\-candidate
.RS 4
補完候補の一覧を既に表示している場合は一覧の中から前の候補を選択します。それ以外の場合は complete コマンドと同じ動作をします。
.PP
vi\-insert, emacs
.RS 4
\fB\ebt\fR
.RE
.RE
.PP
complete\-next\-column
.RS 4
補完候補の一覧を既に表示している場合は一覧の中から次の列の最初の候補を選択します。それ以外の場合は complete コマンドと同じ動作をします。
.RE
.PP
complete\-prev\-column
.RS 4
補完候補の一覧を既に表示している場合は一覧の中から前の列の最初の候補を選択します。それ以外の場合は complete コマンドと同じ動作をします。
.RE
.PP
complete\-next\-page
.RS 4
補完候補の一覧を既に表示している場合は一覧の中から次のページの最初の候補を選択します。それ以外の場合は complete コマンドと同じ動作をします。
.RE
.PP
complete\-prev\-page
.RS 4
補完候補の一覧を既に表示している場合は一覧の中から前のページの最初の候補を選択します。それ以外の場合は complete コマンドと同じ動作をします。
.RE
.PP
complete\-list
.RS 4
現在のカーソル位置で補完を行います。引数を指定しない場合、補完候補の一覧を表示します。引数を指定すると、その番号の候補で補完内容を確定します。
.PP
emacs
.RS 4
\fB\e^[?\fR,
\fB\e^[=\fR
.RE
.RE
.PP
complete\-all
.RS 4
現在のカーソル位置で補完を行い、カーソル位置にある単語をすべての補完候補で置き換えます。
.PP
emacs
.RS 4
\fB\e^[*\fR
.RE
.RE
.PP
complete\-max
.RS 4
現在のカーソル位置で補完を行い、各補完候補の最長共通先頭部分をカーソル位置に挿入します。
.RE
.PP
clear\-candidates
.RS 4
補完候補の一覧を消去します。
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBVi 固有のコマンド\fR
.RS 4
.PP
vi\-replace\-char
.RS 4
カーソルのところにある文字を、このコマンドの直後に入力した文字に置き換えます。
.PP
vi\-command
.RS 4
\fBr\fR
.RE
.RE
.PP
vi\-insert\-beginning
.RS 4
カーソルをバッファの先頭に移動したのち、setmode\-viinsert コマンドと同じ動作をします。
.PP
vi\-command
.RS 4
\fBI\fR
.RE
.RE
.PP
vi\-append
.RS 4
カーソルを次の文字に移動したのち、setmode\-viinsert コマンドと同じ動作をします。
.PP
vi\-command
.RS 4
\fBI\fR
.RE
.RE
.PP
vi\-append\-to\-eol
.RS 4
カーソルをバッファの末尾に移動したのち、setmode\-viinsert コマンドと同じ動作をします。
.PP
vi\-command
.RS 4
\fBA\fR
.RE
.RE
.PP
vi\-replace
.RS 4
Setmode\-viinsert コマンドと同じ動作をしますが、同時に上書きモードを有効にします。上書きモードでは、self\-insert コマンドは文字を挿入する代わりにカーソルのところにある文字を置き換えます。上書きモードは編集モードを変更するまで有効です。
.PP
vi\-command
.RS 4
\fBR\fR
.RE
.RE
.PP
vi\-switch\-case
.RS 4
このコマンドの直後には移動コマンドを入力する必要があります。移動コマンドが動かしたカーソルの範囲にある文字の大文字と小文字を入れ替えます。
.RE
.PP
vi\-switch\-case\-char
.RS 4
カーソルのところにある文字の大文字と小文字を入れ替えて、カーソルを次の文字に移動します。
.PP
vi\-command
.RS 4
\fB~\fR
.RE
.RE
.PP
vi\-yank
.RS 4
このコマンドの直後には移動コマンドを入力する必要があります。移動コマンドが動かしたカーソルの範囲にある文字をキルリングに保管します。
.PP
vi\-command
.RS 4
\fBy\fR
.RE
.RE
.PP
vi\-yank\-to\-eol
.RS 4
カーソルの位置からバッファの末尾までにある文字をキルリングに保管します。
.PP
vi\-command
.RS 4
\fBY\fR
.RE
.RE
.PP
vi\-delete
.RS 4
このコマンドの直後には移動コマンドを入力する必要があります。移動コマンドが動かしたカーソルの範囲にある文字を削除し、キルリングに保管します。
.PP
vi\-command
.RS 4
\fBd\fR
.RE
.RE
.PP
vi\-delete\-to\-eol
.RS 4
カーソルの位置からバッファの末尾までにある文字を削除し、キルリングに保管します。
.PP
vi\-command
.RS 4
\fBD\fR
.RE
.RE
.PP
vi\-change
.RS 4
このコマンドの直後には移動コマンドを入力する必要があります。移動コマンドが動かしたカーソルの範囲にある文字を削除し、その後編集モードを vi 風編集モードの挿入モードに変更します。
.PP
vi\-command
.RS 4
\fBc\fR
.RE
.RE
.PP
vi\-change\-to\-eol
.RS 4
カーソルの位置からバッファの末尾までにある文字を削除し、その後編集モードを vi 風編集モードの挿入モードに変更します。 Delete the characters from the current cursor position to the end of the line and switch to the vi insert mode\&.
.PP
vi\-command
.RS 4
\fBC\fR
.RE
.RE
.PP
vi\-change\-line
.RS 4
バッファの内容を全て削除し、その後編集モードを vi 風編集モードの挿入モードに変更します。
.PP
vi\-command
.RS 4
\fBS\fR
.RE
.RE
.PP
vi\-yank\-and\-change
.RS 4
Vi\-change コマンドと同様ですが、削除した文字列はキルリングに補完されます。
.RE
.PP
vi\-yank\-and\-change\-to\-eol
.RS 4
Vi\-change\-to\-eol コマンドと同様ですが、削除した文字列はキルリングに補完されます。
.RE
.PP
vi\-yank\-and\-change\-line
.RS 4
Vi\-change\-line コマンドと同様ですが、削除した文字列はキルリングに補完されます。
.RE
.PP
vi\-substitute
.RS 4
カーソルのところにある文字を削除しキルリングに保管した後、編集モードを vi 風編集モードの挿入モードに変更します。
.PP
vi\-command
.RS 4
\fBs\fR
.RE
.RE
.PP
vi\-append\-last\-bigword
.RS 4
コマンド履歴の中で最も新しいコマンドにおける最後の bigword を、空白文字に続けてカーソルの位置の直後に挿入します。引数
\fIn\fR
を与えたときは最後の bigword の代わりに
\fIn\fR
番目の bigword を挿入します。その後、setmode\-viinsert コマンドと同じ動作をします。
.PP
vi\-command
.RS 4
\fB_\fR
.RE
.RE
.PP
vi\-exec\-alias
.RS 4
このコマンドの直後に入力した文字を
\fIc\fR
とすると、\fB_\fR\fB\fIc\fR\fR
という名前のエイリアスの内容をシェルへの入力とみなして行編集コマンドとして解釈・実行します。
.PP
vi\-command
.RS 4
\fB@\fR
.RE
.RE
.PP
vi\-edit\-and\-accept
.RS 4
エディタとして vi を起動し、バッファの内容を編集させます。エディタが終了すると編集後の内容をバッファに反映した後 accept\-line コマンドと同じ動作をします。ただしエディタの終了ステータスが 0 でないときは何も行いません。
.PP
vi\-command
.RS 4
\fBv\fR
.RE
.RE
.PP
vi\-complete\-list
.RS 4
Complete\-list コマンドと同様ですが、候補を確定したとき編集モードを vi 風編集モードの挿入モードに変更します。
.PP
vi\-command
.RS 4
\fB=\fR
.RE
.RE
.PP
vi\-complete\-all
.RS 4
Complete\-all コマンドと同様ですが、単語を置き換えた後、編集モードを vi 風編集モードの挿入モードに変更します。
.PP
vi\-command
.RS 4
\fB*\fR
.RE
.RE
.PP
vi\-complete\-max
.RS 4
Complete\-max コマンドと同様ですが、候補を挿入した後、編集モードを vi 風編集モードの挿入モードに変更します。
.PP
vi\-command
.RS 4
\fB\e\e\fR
.RE
.RE
.PP
vi\-search\-forward
.RS 4
順方向の履歴検索を開始します。編集モードを vi 風編集モードの検索モードに変更します。
.PP
vi\-command
.RS 4
\fB?\fR
.RE
.RE
.PP
vi\-search\-backward
.RS 4
逆方向の履歴検索を開始します。編集モードを vi 風編集モードの検索モードに変更します。
.PP
vi\-command
.RS 4
\fB/\fR
.RE
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBEmacs 固有のコマンド\fR
.RS 4
.PP
emacs\-transpose\-chars
.RS 4
カーソルの前にある文字を右に移動します。
.PP
emacs
.RS 4
\fB\e^T\fR
.RE
.RE
.PP
emacs\-transpose\-words
.RS 4
カーソルの前にある emacsword を右に移動します。
.PP
emacs
.RS 4
\fB\e^[t\fR,
\fB\e^[T\fR
.RE
.RE
.PP
emacs\-downcase\-word
.RS 4
カーソルの後にある emacsword を小文字に変換します。
.PP
emacs
.RS 4
\fB\e^[l\fR,
\fB\e^[L\fR
.RE
.RE
.PP
emacs\-upcase\-word
.RS 4
カーソルの後にある emacsword を大文字に変換します。
.PP
emacs
.RS 4
\fB\e^[u\fR,
\fB\e^[U\fR
.RE
.RE
.PP
emacs\-capitalize\-word
.RS 4
カーソルの後にある emacsword をキャピタライズします (各単語の頭文字だけ大文字にする)。
.PP
emacs
.RS 4
\fB\e^[c\fR,
\fB\e^[u\fR
.RE
.RE
.PP
emacs\-delete\-horizontal\-space
.RS 4
カーソルの前後にある空白を削除します。引数を与えるとカーソルの前にある空白を削除します。
.PP
emacs
.RS 4
\fB\e^[\e\e\fR
.RE
.RE
.PP
emacs\-just\-one\-space
.RS 4
カーソルの前後にある空白の個数を一つに調整します。引数を与えるとその引数の数だけ空白を残します。
.PP
emacs
.RS 4
\fB\e^[\fR
(エスケープの後に空白文字)
.RE
.RE
.PP
emacs\-search\-forward
.RS 4
順方向の履歴検索を開始します。編集モードを emacs 風編集モードの検索モードに変更します。
.PP
emacs
.RS 4
\fB\e^S\fR
.RE
.RE
.PP
emacs\-search\-backward
.RS 4
順方向の履歴検索を開始します。編集モードを emacs 風編集モードの検索モードに変更します。
.PP
emacs
.RS 4
\fB\e^R\fR
.RE
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBコマンド履歴関連のコマンド\fR
.RS 4
.PP
oldest\-history
.RS 4
コマンド履歴の中で最も古いコマンドに移動します。引数を与えるとそれを履歴番号とみなしてその番号のコマンドに移動します。カーソルの位置は変わりません。
.RE
.PP
newest\-history
.RS 4
コマンド履歴の中で最も新しいコマンドに移動します。引数を与えるとそれを履歴番号とみなしてその番号のコマンドに移動します。カーソルの位置は変わりません。
.RE
.PP
return\-history
.RS 4
コマンド履歴のどのコマンドにも対応しない新規バッファに移動します。引数を与えるとそれを履歴番号とみなしてその番号のコマンドに移動します。カーソルの位置は変わりません。
.RE
.PP
oldest\-history\-bol
.RS 4
コマンド履歴の中で最も古いコマンドに移動します。引数を与えるとそれを履歴番号とみなしてその番号のコマンドに移動します。カーソルはバッファの先頭に移動します。
.PP
vi\-command
.RS 4
\fBG\fR
.RE
.RE
.PP
newest\-history\-bol
.RS 4
コマンド履歴の中で最も新しいコマンドに移動します。引数を与えるとそれを履歴番号とみなしてその番号のコマンドに移動します。カーソルはバッファの先頭に移動します。
.RE
.PP
return\-history\-bol
.RS 4
コマンド履歴のどのコマンドにも対応しない新規バッファに移動します。引数を与えるとそれを履歴番号とみなしてその番号のコマンドに移動します。カーソルはバッファの先頭に移動します。
.PP
vi\-command
.RS 4
\fBg\fR
.RE
.RE
.PP
oldest\-history\-eol
.RS 4
コマンド履歴の中で最も古いコマンドに移動します。引数を与えるとそれを履歴番号とみなしてその番号のコマンドに移動します。カーソルはバッファの末尾に移動します。
.PP
emacs
.RS 4
\fB\e^[<\fR
.RE
.RE
.PP
newest\-history\-eol
.RS 4
コマンド履歴の中で最も新しいコマンドに移動します。引数を与えるとそれを履歴番号とみなしてその番号のコマンドに移動します。カーソルはバッファの末尾に移動します。
.RE
.PP
return\-history\-eol
.RS 4
コマンド履歴のどのコマンドにも対応しない新規バッファに移動します。引数を与えるとそれを履歴番号とみなしてその番号のコマンドに移動します。カーソルはバッファの末尾に移動します。
.PP
emacs
.RS 4
\fB\e^[>\fR
.RE
.RE
.PP
next\-history
.RS 4
コマンド履歴の中で次のコマンドに移動します。カーソルの位置は変わりません。
.RE
.PP
prev\-history
.RS 4
コマンド履歴の中で前のコマンドに移動します。カーソルの位置は変わりません。
.RE
.PP
next\-history\-bol
.RS 4
コマンド履歴の中で次のコマンドに移動します。カーソルはバッファの先頭に移動します
.PP
vi\-command
.RS 4
\fBj\fR,
\fB+\fR,
\fB\eD\fR,
\fB\e^N\fR
.RE
.RE
.PP
prev\-history\-bol
.RS 4
コマンド履歴の中で前のコマンドに移動します。カーソルはバッファの先頭に移動します
.PP
vi\-command
.RS 4
\fBk\fR,
\fB\-\fR,
\fB\eU\fR,
\fB\e^P\fR
.RE
.RE
.PP
next\-history\-eol
.RS 4
コマンド履歴の中で次のコマンドに移動します。カーソルはバッファの末尾に移動します
.PP
vi\-insert, emacs
.RS 4
\fB\eD\fR,
\fB\e^N\fR
.RE
.RE
.PP
prev\-history\-eol
.RS 4
コマンド履歴の中で前のコマンドに移動します。カーソルはバッファの末尾に移動します
.PP
vi\-insert, emacs
.RS 4
\fB\eU\fR,
\fB\e^P\fR
.RE
.RE
.PP
search\-again
.RS 4
最後に行ったコマンド履歴検索をもう一度行います。
.PP
vi\-command
.RS 4
\fBn\fR
.RE
.RE
.PP
search\-again\-rev
.RS 4
最後に行ったコマンド履歴検索を方向を逆にしてもう一度行います。
.PP
vi\-command
.RS 4
\fBN\fR
.RE
.RE
.PP
search\-again\-forward
.RS 4
最後に行ったコマンド履歴検索を順方向にもう一度行います。
.RE
.PP
search\-again\-backward
.RS 4
最後に行ったコマンド履歴検索を逆方向にもう一度行います。
.RE
.PP
beginning\-search\-forward
.RS 4
コマンド履歴を順方向に検索し、バッファの先頭から現在のカーソル位置までの間にある文字列が同じ次のコマンドに移動します。カーソル位置は変わりません。
.RE
.PP
beginning\-search\-backward
.RS 4
コマンド履歴を逆方向に検索し、バッファの先頭から現在のカーソル位置までの間にある文字列が同じ前のコマンドに移動します。カーソル位置は変わりません。
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBコマンド履歴検索モードのコマンド\fR
.RS 4
.PP
srch\-self\-insert
.RS 4
入力した文字を検索用バッファに挿入します。(エスケープシーケンスによるエスケープの対象となる文字は挿入できません)
.PP
vi\-search, emacs\-search
.RS 4
\fB\e\e\fR
.RE
.RE
.PP
srch\-backward\-delete\-char
.RS 4
検索用バッファの最後の一文字を削除します。検索用バッファが空の場合は:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
vi 風編集モードでは srch\-abort\-search コマンドと同じ動作をします。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
emacs 風編集モードでは alert コマンドと同じ動作をします。
.RE
.PP
vi\-search, emacs\-search
.RS 4
\fB\eB\fR,
\fB\e?\fR,
\fB\e^H\fR
.RE
.RE
.PP
srch\-backward\-delete\-line
.RS 4
検索用バッファの内容を全て削除します。
.PP
vi\-search, emacs\-search
.RS 4
\fB\e$\fR,
\fB\e^U\fR
.RE
.RE
.PP
srch\-continue\-forward
.RS 4
現在表示している暫定検索結果の次の結果を順方向に探します。
.PP
emacs\-search
.RS 4
\fB\e^S\fR
.RE
.RE
.PP
srch\-continue\-backward
.RS 4
現在表示している暫定検索結果の次の結果を逆方向に探します。
.PP
emacs\-search
.RS 4
\fB\e^R\fR
.RE
.RE
.PP
srch\-accept\-search
.RS 4
検索を終了し、現在表示している暫定検索結果を確定します。検索結果に移動します。
.PP
vi\-search
.RS 4
\fB\e^J\fR,
\fB\e^M\fR
.RE
.PP
emacs\-search
.RS 4
\fB\e^J\fR,
\fB\e^[\fR
.RE
.RE
.PP
srch\-abort\-search
.RS 4
検索を中止し、検索を開始する前の状態に戻ります。
.PP
vi\-search
.RS 4
\fB\e^[\fR
.RE
.PP
emacs\-search
.RS 4
\fB\e^G\fR
.RE
.RE
.RE
.SS "エスケープシーケンス"
.sp
Bindkey コマンドで行編集のキー設定を表示・設定する際、ファンクションキーなどの特殊なキーはエスケープシーケンスで表わします。エスケープシーケンスは全てバックスラッシュ (\fB\e\fR) で始まります。またバックスラッシュそのものもエスケープの対象です。エスケープシーケンスに対するキーの割り当ては以下の通りです。
.PP
\fB\e\e\fR
.RS 4
バックスラッシュ (\fB\e\fR)
.RE
.PP
\fB\eB\fR
.RS 4
Backspace
.RE
.PP
\fB\eD\fR
.RS 4
↓矢印キー
.RE
.PP
\fB\eE\fR
.RS 4
End
.RE
.PP
\fB\eH\fR
.RS 4
Home
.RE
.PP
\fB\eI\fR
.RS 4
Insert (Insert\-char, Enter\-insert\-mode)
.RE
.PP
\fB\eL\fR
.RS 4
←矢印キー
.RE
.PP
\fB\eN\fR
.RS 4
Page\-down (Next\-page)
.RE
.PP
\fB\eP\fR
.RS 4
Page\-up (Previous\-page)
.RE
.PP
\fB\eR\fR
.RS 4
→矢印キー
.RE
.PP
\fB\eU\fR
.RS 4
↑矢印キー
.RE
.PP
\fB\eX\fR
.RS 4
Delete
.RE
.PP
\fB\e!\fR
.RS 4
INTR
.RE
.PP
\fB\e#\fR
.RS 4
EOF
.RE
.PP
\fB\e$\fR
.RS 4
KILL
.RE
.PP
\fB\e?\fR
.RS 4
ERASE
.RE
.PP
\fB\e^@\fR
.RS 4
Ctrl + @
.RE
.PP
\fB\e^A\fR, \fB\e^B\fR, \&..., \fB\e^Z\fR
.RS 4
Ctrl + A, Ctrl + B, \&..., Ctrl + Z
.sp
※ Ctrl + I は Tab、Ctrl + J は Newline、Ctrl + M は Carriage\-return です。
.RE
.PP
\fB\e^[\fR
.RS 4
Ctrl + [ (Escape)
.RE
.PP
\fB\e^\e\fR
.RS 4
Ctrl + \e
.RE
.PP
\fB\e^]\fR
.RS 4
Ctrl + ]
.RE
.PP
\fB\e^^\fR
.RS 4
Ctrl + ^
.RE
.PP
\fB\e^_\fR
.RS 4
Ctrl + _
.RE
.PP
\fB\e^?\fR
.RS 4
Ctrl + ? (Delete)
.RE
.PP
\fB\eF00\fR, \fB\eF01\fR, \&..., \fB\eF63\fR
.RS 4
F0, F1, \&..., F63
.RE
.PP
\fB\ea1\fR
.RS 4
キーパッドの左上キー
.RE
.PP
\fB\ea3\fR
.RS 4
キーパッドの右上キー
.RE
.PP
\fB\eb2\fR
.RS 4
キーパッドの中央キー
.RE
.PP
\fB\ebg\fR
.RS 4
Beginning
.RE
.PP
\fB\ebt\fR
.RS 4
Back\-tab
.RE
.PP
\fB\ec1\fR
.RS 4
キーパッドの左下キー
.RE
.PP
\fB\ec3\fR
.RS 4
キーパッドの右下キー
.RE
.PP
\fB\eca\fR
.RS 4
Clear\-all\-tabs
.RE
.PP
\fB\ecl\fR
.RS 4
Close
.RE
.PP
\fB\ecn\fR
.RS 4
Cancel
.RE
.PP
\fB\eco\fR
.RS 4
Command
.RE
.PP
\fB\ecp\fR
.RS 4
Copy
.RE
.PP
\fB\ecr\fR
.RS 4
Create
.RE
.PP
\fB\ecs\fR
.RS 4
Clear\-screen または erase
.RE
.PP
\fB\ect\fR
.RS 4
Clear\-tab
.RE
.PP
\fB\edl\fR
.RS 4
Delete\-line
.RE
.PP
\fB\eei\fR
.RS 4
Exit\-insert\-mode
.RE
.PP
\fB\eel\fR
.RS 4
Clear\-to\-end\-of\-line
.RE
.PP
\fB\ees\fR
.RS 4
Clear\-to\-end\-of\-screen
.RE
.PP
\fB\eet\fR
.RS 4
Enter (Send)
.RE
.PP
\fB\eex\fR
.RS 4
Exit
.RE
.PP
\fB\efd\fR
.RS 4
Find
.RE
.PP
\fB\ehp\fR
.RS 4
Help
.RE
.PP
\fB\eil\fR
.RS 4
Insert\-line
.RE
.PP
\fB\ell\fR
.RS 4
Home\-down
.RE
.PP
\fB\eme\fR
.RS 4
Message
.RE
.PP
\fB\emk\fR
.RS 4
Mark
.RE
.PP
\fB\ems\fR
.RS 4
マウスイベント
.RE
.PP
\fB\emv\fR
.RS 4
Move
.RE
.PP
\fB\enx\fR
.RS 4
Next\-object
.RE
.PP
\fB\eon\fR
.RS 4
Open
.RE
.PP
\fB\eop\fR
.RS 4
Options
.RE
.PP
\fB\epr\fR
.RS 4
Print (Copy)
.RE
.PP
\fB\epv\fR
.RS 4
Previous\-object
.RE
.PP
\fB\erd\fR
.RS 4
Redo
.RE
.PP
\fB\ere\fR
.RS 4
Resume
.RE
.PP
\fB\erf\fR
.RS 4
Ref (Reference)
.RE
.PP
\fB\erh\fR
.RS 4
Refresh
.RE
.PP
\fB\erp\fR
.RS 4
Replace
.RE
.PP
\fB\ers\fR
.RS 4
Restart
.RE
.PP
\fB\esf\fR
.RS 4
Scroll\-forward (Scroll\-down)
.RE
.PP
\fB\esl\fR
.RS 4
Select
.RE
.PP
\fB\esr\fR
.RS 4
Scroll\-backward (Scroll\-up)
.RE
.PP
\fB\est\fR
.RS 4
Set\-tab
.RE
.PP
\fB\esu\fR
.RS 4
Suspend
.RE
.PP
\fB\esv\fR
.RS 4
Save
.RE
.PP
\fB\eud\fR
.RS 4
Undo
.RE
.PP
\fB\eSE\fR
.RS 4
Shift + End
.RE
.PP
\fB\eSH\fR
.RS 4
Shift + Home
.RE
.PP
\fB\eSI\fR
.RS 4
Shift + Insert
.RE
.PP
\fB\eSL\fR
.RS 4
Shift + ←矢印キー
.RE
.PP
\fB\eSR\fR
.RS 4
Shift + →矢印キー
.RE
.PP
\fB\eSX\fR
.RS 4
Shift + Delete
.RE
.PP
\fB\eSbg\fR
.RS 4
Shift + Beginning
.RE
.PP
\fB\eScn\fR
.RS 4
Shift + Cancel
.RE
.PP
\fB\eSco\fR
.RS 4
Shift + Command
.RE
.PP
\fB\eScp\fR
.RS 4
Shift + Copy
.RE
.PP
\fB\eScr\fR
.RS 4
Shift + Create
.RE
.PP
\fB\eSdl\fR
.RS 4
Shift + Delete\-line
.RE
.PP
\fB\eSel\fR
.RS 4
Shift + End\-of\-line
.RE
.PP
\fB\eSex\fR
.RS 4
Shift + Exit
.RE
.PP
\fB\eSfd\fR
.RS 4
Shift + Find
.RE
.PP
\fB\eShp\fR
.RS 4
Shift + Help
.RE
.PP
\fB\eSmg\fR
.RS 4
Shift + Message
.RE
.PP
\fB\eSmv\fR
.RS 4
Shift + Move
.RE
.PP
\fB\eSnx\fR
.RS 4
Shift + Next
.RE
.PP
\fB\eSop\fR
.RS 4
Shift + Options
.RE
.PP
\fB\eSpr\fR
.RS 4
Shift + Print
.RE
.PP
\fB\eSpv\fR
.RS 4
Shift + Previous
.RE
.PP
\fB\eSrd\fR
.RS 4
Shift + Redo
.RE
.PP
\fB\eSre\fR
.RS 4
Shift + Resume
.RE
.PP
\fB\eSrp\fR
.RS 4
Shift + Replace
.RE
.PP
\fB\eSsu\fR
.RS 4
Shift + Suspend
.RE
.PP
\fB\eSsv\fR
.RS 4
Shift + Save
.RE
.PP
\fB\eSud\fR
.RS 4
Shift + Undo
.RE
.sp
INTR, EOF, KILL, ERASE の四つは stty コマンドなどで設定される端末の特殊文字です。一般的な環境では、INTR は Ctrl + C に、EOF は Ctrl + D に、KILL は Ctrl + U に、ERASE は Ctrl + H または Ctrl + ? に設定されています。これら四つは他のキー入力よりも優先して認識されます。
.SS "コマンドライン補完"
.sp
行編集でコマンドを入力している途中で Tab キーを押すことで、コマンドの名前やオプション、引数を補完することができます。コマンド名やファイル名を途中まで打ち込んだところで Tab キーを押すと、その名前に一致するコマンド名やファイル名の一覧が現れます。さらに続けて Tab キーを押すと、入力したい名前を一覧の中から選ぶことができます。(一致する名前が一つしかない場合は、一覧は現れず、直接名前がコマンドラインに入力されます。)
.sp
補完の対象となる名前に \fB*\fR や \fB?\fR などの文字が入っている場合は、そのパターンに一致する名前全てがコマンドラインに展開されます。(一覧による選択はできません)
.sp
標準状態では、コマンド名を入力しているときはコマンド名が、コマンドの引数を入力しているときはファイル名が補完されます。しかし補完を行う関数 (\fI補完関数\fR) を定義することで補完内容を変更することができます。
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB補完動作の詳細\fR
.RS 4
.sp
シェルを起動してから初めて補完を行おうとしたとき、コマンド \fB\&.\fR\fB \-AL completion/INIT\fR を実行するのと同様にして、ファイル completion/INIT をロードパスから読み込みます。ファイルが見つからない場合は、そのまま補完動作を続けます。(この処理は主にシェルに付属している補完関数を読み込むためのものですが、ロードパス内に自分で用意したファイルを置いておくことで代わりにそれを読み込ませることもできます。)
.sp
補完は、対象に応じて以下のように行います。
.PP
コマンド名
.RS 4
関数
\fBcompletion//command\fR
が定義されている場合は、それを補完関数として実行します。定義されていない場合は、入力中の単語をコマンド名として補完します。
.RE
.PP
コマンドの引数
.RS 4
関数
\fBcompletion//argument\fR
が定義されている場合は、それを補完関数として実行します。定義されていない場合は、入力中の単語をファイル名として補完します。
.RE
.sp
この他、チルダ展開におけるユーザ名やパラメータ展開におけるパラメータ名を入力しているときは、ユーザ名やパラメータ名が常に補完されます。(補完のしかたを変更することはできません)
.sp
補完関数は普通の関数と同様に (位置パラメータなしで) 実行されます。ただし、補完関数の実行時には以下のローカル変数が自動的に設定されます。
.PP
\fBIFS\fR
.RS 4
空白文字・タブ・改行の三文字 (シェル起動時のデフォルト)
.RE
.PP
\fBWORDS\fR
.RS 4
既に入力されているコマンド名とコマンドの引数を含む配列です。コマンド名を補完しようとしているときは、この配列は空になります。
.RE
.PP
\fBTARGETWORD\fR
.RS 4
現在補完を行おうとしている、途中まで入力されたコマンド名またはコマンドの引数です。
.RE
.sp
補完関数の中で complete 組込みコマンドを実行することで、補完候補が生成されます。シェルは補完関数実行中に生成された補完候補を用いて補完を行います。
.sp
補完関数の実行中は、端末に対して入出力を行ってはなりません (端末の表示が乱れてしまいます)。スムーズな補完を行うために、補完の実行中に長い時間のかかる処理を行うのは避けてください。
.sp
補完の実行中は、POSIX 準拠モードが強制的に解除されます。また errexit オプションは無効となり、トラップは実行されません。
.RE
.SH "POSIX 準拠モード"
.sp
Yash は基本的に POSIX\&.1\-2008 のシェルの規定に従って動作しますが、利便性や分かりやすさのために POSIX の規定とは異なる動作をする点もあります。そのため標準状態の yash は POSIX の規定するシェルとして供するには向きません。\fIPOSIX 準拠モード\fRを有効にすると、yash はできる限り POSIX の規定通りに動作するようになります。POSIX 準拠シェルとしての互換性が必要な場面では、POSIX 準拠モードを有効にしてください。
.sp
シェルの起動時の起動時の名前が \fBsh\fR ならばシェルは自動的に POSIX 準拠モードになります。また起動時に \fB\-o posixlycorrect\fR オプションが指定されている場合も POSIX 準拠モードになります。また起動後は、\fBset\fR\fB \-o posixlycorrect\fR を実行することで POSIX 準拠モードを有効にできます。
.sp
POSIX 準拠モードを有効にすると、yash は POSIX の規定にできるだけ従うようになるだけでなく、POSIX が\fI未定義\fRや\fI未規定\fRと定めている場合のほとんどをエラーにするようになります。すなわち、yash 独自の拡張機能の多くは使えなくなります。具体的には、POSIX 準拠モードを有効にすると以下のような挙動の変化があります。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
シェルの起動時の初期化で読み込むスクリプトファイルが異なります。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
グローバルエイリアスの置換を行いません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
複合コマンドのグルーピングや
if 文の内容が空の場合エラーになります。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
For ループで展開した単語はグローバル変数として代入します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Case 文の最初のパターンを
\fBesac\fR
にすることはできません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
予約語
\fBfunction\fR
を用いる形式の関数定義構文は使えません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
単純コマンドでの配列の代入はできません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
シェル実行中に
\fBLC_CTYPE\fR 変数の値が変わっても、それをシェルのロケール情報に反映しません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBRANDOM\fR 変数は使えません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
チルダ展開で
\fB~\fR
と
\fB~\fR\fB\fIユーザ名\fR\fR
以外の形式の展開が使えません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
パラメータ展開の入れ子はできません。またインデックスの指定はできません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB$(\fR
と
\fB)\fR
で囲んだコマンド置換に含まれるコマンドは、コマンド置換が実行される時に毎回解析されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
数式展開で小数ならびに
\fB++\fR
および
\fB\-\-\fR
演算子が使えません。数値でない変数は常にエラーになります。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ファイルのリダイレクトで、パス名展開の結果が一つでない場合、すぐにはエラーにせず、パス名展開を行わなかったときと同様に扱います。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ソケットリダイレクト・ヒアストリング・パイプリダイレクト・プロセスリダイレクトは使用できません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
単純コマンドの実行時、コマンドが見つからなくても
\fBCOMMAND_NOT_FOUND_HANDLER\fR 変数の値は実行しません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンドの検索において通常の組込みコマンドは対応する外部コマンドがないと見つかりません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ジョブ制御が有効でも、非同期コマンドは SIGINT と SIGQUIT を無視します。また非同期コマンドの標準入力を /dev/null にリダイレクトする条件が変わります (ジョブ制御が無効のときではなく、対話モードが無効なときにリダイレクト)。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
いくつかの組込みコマンドで特定のオプションが使えなくなるなど挙動が変わります。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
対話モードでないとき、特殊組込みコマンドのオプションやオペランドの使い方が間違っているとシェルは直ちに終了します。また特殊組込みコマンドで代入エラーやリダイレクトエラーが発生したときも直ちに終了します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
対話モードのプロンプトを出す前に
\fBPROMPT_COMMAND\fR 変数の値を実行しません。\fBPS1\fR 変数・\fBPS2\fR 変数・\fBPS4\fR 変数の値の解釈の仕方が違います。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
メールチェックにおいて、ファイルが更新されている場合はファイルが空でも新着メールメッセージを出力します。
.RE
.SH "構文の形式的定義"
.sp
ここに yash の文法の形式的定義を示します。Yash の文法は解析表現文法で定義されます。
.sp
Yash の文法における終端記号の集合は、yash を実行する環境が扱える任意の文字の集合 (実行文字集合) です (ただしナル文字 \fB\*(Aq\e0\*(Aq\fR を除く)。
.sp
以下は、yash の文法を構成する非終端記号とそれに対応する終端記号の一覧です。ただしここに挙げる文法の定義にはヒアドキュメントの内容とその終わりを表す行の解析のための規則は含まれていません。また POSIX 準拠モードでは構文が若干変わりますが、ここには示しません。
.PP
CompleteCommand
.RS 4
SequenceEOF
.RE
.PP
Sequence
.RS 4
N*
List*
.RE
.PP
List
.RS 4
Pipeline
((\fB&&\fR
/
\fB||\fR)
N* Pipeline)*
ListSeparator
.RE
.PP
Pipeline
.RS 4
Bang?
Command
(\fB|\fRN* Command)*
.RE
.PP
Command
.RS 4
CompoundCommandRedirection* /

!RFunctionDefinition
/

!R
SimpleCommand
.RE
.PP
CompoundCommand
.RS 4
Subshell
/
Grouping
/
IfCommand
/
ForCommand
/
WhileCommand
/
CaseCommand
/
FunctionCommand
.RE
.PP
Subshell
.RS 4
\fB(\fRSequence\fB)\fRS*
.RE
.PP
Grouping
.RS 4
LeftBraceSequenceRightBrace
.RE
.PP
IfCommand
.RS 4
IfSequenceThen
Sequence (Elif
Sequence
Then
Sequence)* (Else
Sequence)?
Fi
.RE
.PP
ForCommand
.RS 4
ForNameS*
Separator? (InWord*
Separator)?
DoSequenceDone
.RE
.PP
WhileCommand
.RS 4
(While
/
Until)
SequenceDo
Sequence
Done
.RE
.PP
CaseCommand
.RS 4
CaseWordN*
In
N*
CaseItem*
Esac
.RE
.PP
CaseItem
.RS 4
!Esac
(\fB(\fRS*)?
Word
(\fB|\fR
S* Word)*
\fB)\fRSequence
(\fB;;\fR
/ &Esac)
.RE
.PP
FunctionCommand
.RS 4
FunctionWord
(\fB(\fRS*
\fB)\fR)?
N*
CompoundCommandRedirection*
.RE
.PP
FunctionDefinition
.RS 4
NameS*
\fB(\fR
S*
\fB)\fRN*
CompoundCommandRedirection*
.RE
.PP
SimpleCommand
.RS 4
&(Word
/
Redirection) (Assignment
/ Redirection)* (Word / Redirection)*
.RE
.PP
Assignment
.RS 4
Name\fB=\fRWord
/

Name
\fB=(\fRN* (Word N*)*
\fB)\fR
.RE
.PP
Name
.RS 4
![[:digit:]] [[:alnum:]
\fB_\fR]+
.RE
.PP
PortableName
.RS 4
![\fB0\fR\-\fB9\fR] [\fB0\fR\-\fB9\fR\fBABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_\fR]+
.RE
.PP
Word
.RS 4
(WordElement
/ !SpecialChar
\&.)+
S*
.RE
.PP
WordElement
.RS 4
\fB\e\fR
\&. /
\fB\*(Aq\fR
(!\fB\*(Aq\fR
\&.)*
\fB\*(Aq\fR
/
\fB"\fRQuoteElement*
\fB"\fR
/
Parameter
/
Arithmetic
/
CommandSubstitution
.RE
.PP
QuoteElement
.RS 4
\fB\e\fR
([\fB$`"\e\fR] /
NL) /
Parameter
/
Arithmetic
/
CommandSubstitution
/

![\fB`"\e\fR] \&.
.RE
.PP
Parameter
.RS 4
\fB$\fR
[\fB@*#?\-$!\fR
[:digit:]] /
\fB$\fRPortableName
/
\fB$\fRParameterBody
.RE
.PP
ParameterBody
.RS 4
\fB{\fRParameterNumber? (ParameterName
/ ParameterBody /
Parameter)
ParameterIndex?
ParameterMatch?
\fB}\fR
.RE
.PP
ParameterNumber
.RS 4
\fB#\fR
![\fB+=:/%\fR] !([\fB\-?#\fR]
\fB}\fR)
.RE
.PP
ParameterName
.RS 4
[\fB@*#?\-$!\fR] /

[[:alnum:]
\fB_\fR]+
.RE
.PP
ParameterIndex
.RS 4
\fB[\fRParameterIndexWord
(\fB,\fR
ParameterIndexWord)?
\fB]\fR
.RE
.PP
ParameterIndexWord
.RS 4
(WordElement
/ ![\fB"\*(Aq],\fR] \&.)+
.RE
.PP
ParameterMatch
.RS 4
\fB:\fR? [\fB\-+=?\fR]
ParameterMatchWord
/

(\fB#\fR
/
\fB##\fR
/
\fB%\fR
/
\fB%%\fR) ParameterMatchWord /

(\fB:/\fR
/
\fB/\fR
[\fB#%/\fR]?)
ParameterMatchWordNoSlash
(\fB/\fR
ParameterMatchWord)?
.RE
.PP
ParameterMatchWord
.RS 4
(WordElement
/ ![\fB"\*(Aq}\fR] \&.)*
.RE
.PP
ParameterMatchWordNoSlash
.RS 4
(WordElement
/ ![\fB"\*(Aq/}\fR] \&.)*
.RE
.PP
Arithmetic
.RS 4
\fB$((\fRArithmeticBody*
\fB))\fR
.RE
.PP
ArithmeticBody
.RS 4
\fB\e\fR
\&. /
Parameter
/
Arithmetic
/
CommandSubstitution
/
\fB(\fR
ArithmeticBody
\fB)\fR
/

![\fB`()\fR] \&.
.RE
.PP
CommandSubstitution
.RS 4
\fB$(\fRSequence\fB)\fR
/
\fB`\fRCommandSubstitutionBody*
\fB`\fR
.RE
.PP
CommandSubstitutionBody
.RS 4
\fB\e\fR
[\fB$`\e\fR] /

!\fB`\fR
\&.
.RE
.PP
Redirection
.RS 4
RedirectionFDRedirectionOperatorS*
Word
/

RedirectionFD
\fB<(\fRSequence\fB)\fR
/

RedirectionFD
\fB>(\fR
Sequence
\fB)\fR
.RE
.PP
RedirectionFD
.RS 4
[[:digit:]]*
.RE
.PP
RedirectionOperator
.RS 4
\fB<\fR
/
\fB<>\fR
/
\fB>\fR
/
\fB>|\fR
/
\fB>>\fR
/
\fB>>|\fR
/
\fB<&\fR
/
\fB>&\fR
/
\fB<<\fR
/
\fB<<\-\fR
/
\fB<<<\fR
.RE
.PP
ListSeparator
.RS 4
Separator
/
\fB&\fRN* /

&\fB)\fR
/

&\fB;;\fR
.RE
.PP
Separator
.RS 4
\fB;\fRN* /
N+ /
EOF
.RE
.PP
N
.RS 4
S*
NL
.RE
.PP
S
.RS 4
[[:blank:]] /
Comment
.RE
.PP
Comment
.RS 4
\fB#\fR
(!NL
\&.)*
.RE
.PP
R
.RS 4
Bang
/
LeftBrace
/
RightBrace
/
Case
/
Do
/
Done
/
Elif
/
Else
/
Esac
/
Fi
/
For
/
If
/
In
/
Then
/
Until
/
While
.RE
.PP
Bang
.RS 4
\fB!\fRD
.RE
.PP
LeftBrace
.RS 4
\fB{\fRD
.RE
.PP
RightBrace
.RS 4
\fB}\fRD
.RE
.PP
Case
.RS 4
\fBcase\fRD
.RE
.PP
Do
.RS 4
\fBdo\fRD
.RE
.PP
Done
.RS 4
\fBdone\fRD
.RE
.PP
Elif
.RS 4
\fBelif\fRD
.RE
.PP
Else
.RS 4
\fBelse\fRD
.RE
.PP
Esac
.RS 4
\fBesac\fRD
.RE
.PP
Fi
.RS 4
\fBfi\fRD
.RE
.PP
For
.RS 4
\fBfor\fRD
.RE
.PP
Function
.RS 4
\fBfunction\fRD
.RE
.PP
If
.RS 4
\fBif\fRD
.RE
.PP
In
.RS 4
\fBin\fRD
.RE
.PP
Then
.RS 4
\fBthen\fRD
.RE
.PP
Until
.RS 4
\fBuntil\fRD
.RE
.PP
While
.RS 4
\fBwhile\fRD
.RE
.PP
D
.RS 4
!WordS*
.RE
.PP
SpecialChar
.RS 4
[\fB|&;<>()`\e"\*(Aq\fR
[:blank:]] /
NL
.RE
.PP
NL
.RS 4
<newline>
.RE
.PP
EOF
.RS 4
!\&.
.RE
.SH "ALIAS 組込みコマンド"
.sp
\fIAlias 組込みコマンド\fRはエイリアスを設定・表示します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBalias [\-gp] [\fR\fB\fIエイリアス名\fR\fR\fB[=\fR\fB\fI値\fR\fR\fB]\&...]\fR
.RE
.SS "説明"
.sp
Alias コマンドはエイリアスをオペランドに従って設定または表示します。表示は、コマンド (の一部) として解釈可能な形式で標準出力に出力します。オペランドを一つも与えない場合、alias コマンドは現在設定されている全てのエイリアスを表示します。
.SS "オプション"
.PP
\fB\-g\fR, \fB\-\-global\fR
.RS 4
このオプションを指定した場合、設定するエイリアスはグローバルエイリアスになります。このオプションを指定しない場合、設定するエイリアスは通常のエイリアスになります。
.RE
.PP
\fB\-p\fR, \fB\-\-prefix\fR
.RS 4
このオプションは表示の書式を選択します。このオプションを指定した場合、alias コマンドとそのコマンドライン引数全てを表示します。このオプションを指定しない場合、alias コマンドに渡すオペランドだけを表示します。
.RE
.SS "オペランド"
.PP
\fIエイリアス名\fR
.RS 4
表示するエイリアスの名前です。
.RE
.PP
\fIエイリアス名\fR=\fI値\fR
.RS 4
設定するエイリアスの名前とその内容です。
.RE
.SS "終了ステータス"
.sp
エラーがない限り alias コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
Yash でエイリアスの名前として使えない文字は、空白文字・タブ・改行、および \fB=$<>\e\*(Aq"`;&|()#\fR の各文字です。エイリアスの内容にはすべての文字が使えます。
.sp
Alias コマンドは準特殊組込みコマンドです。
.sp
POSIX にはオプションに関する規定はありません。よってオプションは POSIX 準拠モードでは使えません。
.SH "ARRAY 組込みコマンド"
.sp
\fIArray 組込みコマンド\fRは配列の表示や操作を行います。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBarray\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBarray \fR\fB\fI配列名\fR\fR\fB [\fR\fB\fI値\fR\fR\fB\&...]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBarray \-d \fR\fB\fI配列名\fR\fR\fB [\fR\fB\fIインデックス\fR\fR\fB\&...]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBarray \-i \fR\fB\fI配列名\fR\fR\fB \fR\fB\fIインデックス\fR\fR\fB [\fR\fB\fI値\fR\fR\fB\&...]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBarray \-s \fR\fB\fI配列名\fR\fR\fB \fR\fB\fIインデックス\fR\fR\fB \fR\fB\fI値\fR\fR
.RE
.SS "説明"
.sp
オプションもオペランドも指定せずに実行すると、array コマンドは全ての配列の定義を (コマンドとして解釈可能な形式で) 標準出力に出力します。
.sp
オプションを指定せずに\fI配列名\fRと\fI値\fRを与えて実行すると、array コマンドはその配列の内容を指定された値に設定します。
.sp
\fB\-d\fR (\fB\-\-delete\fR) オプションを指定して実行すると、array コマンドは指定した配列の指定したインデックスにある要素を削除します。配列の要素数は削除した要素の分だけ少なくなります。存在しない要素のインデックスを指定したときは無視します。
.sp
\fB\-i\fR (\fB\-\-insert\fR) オプションを指定して実行すると、array コマンドは指定した配列の指定したインデックスにある要素の直後に指定した値を要素として追加します。配列の要素数は追加した要素の分だけ増えます。\fIインデックス\fR として 0 を指定すると配列の先頭に要素を追加します。\fIインデックス\fRとして配列の要素数より大きな数を指定すると配列の末尾に要素を追加します。
.sp
\fB\-s\fR (\fB\-\-set\fR) オプションを指定して実行すると、array コマンドは指定した配列の指定したインデックスにある要素の値を指定した値に変更します。
.SS "オプション"
.PP
\fB\-d\fR, \fB\-\-delete\fR
.RS 4
配列の要素を削除します。
.RE
.PP
\fB\-i\fR, \fB\-\-insert\fR
.RS 4
配列に要素を挿入します。
.RE
.PP
\fB\-s\fR, \fB\-\-set\fR
.RS 4
配列の要素を変更します。
.RE
.SS "オペランド"
.PP
\fI配列名\fR
.RS 4
表示または操作する配列の名前です。
.RE
.PP
\fIインデックス\fR
.RS 4
配列の要素を指定する自然数です。インデックスは最初の要素から順に 1, 2, 3, \&... と割り振られます。
.RE
.PP
\fI値\fR
.RS 4
配列の要素となる文字列です。
.RE
.SS "終了ステータス"
.sp
エラーがない限り array コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
POSIX には array コマンドに関する規定はありません。
.sp
\fBarray \fR\fB\fI配列名\fR\fR\fB [\fR\fB\fI値\fR\fR\fB\&...]\fR の形式の array コマンドは変数代入を用いて \fB\fI配列名\fR\fR\fB=(\fR\fB\fI値\fR\fR\fB\&...)\fR と書くこともできます。
.SH "BG 組込みコマンド"
.sp
\fIBg 組込みコマンド\fRはジョブをバックグラウンドで実行します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBbg [\fR\fB\fIジョブ\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
Bg コマンドはジョブをバックグラウンドで実行します。ジョブには SIGCONT シグナルが送られ、ジョブが停止している場合は再開されます。
.sp
ジョブの実行を再開する前に bg コマンドはジョブの名前を標準出力に出力します。
.sp
Bg コマンドはジョブ制御が有効な時しか使えません。
.SS "オペランド"
.PP
\fIジョブ\fR
.RS 4
実行するジョブのジョブ ID。
.sp
ジョブを複数指定することもできます。何も指定しないと現在のジョブを実行します。
.sp
非
POSIX 準拠モードではジョブ ID の先頭の
\fB%\fR
は省略できます。
.RE
.SS "終了ステータス"
.sp
エラーがない限り bg コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
Bg コマンドは準特殊組込みコマンドです。
.sp
POSIX は指定したジョブが既に実行中の場合は bg コマンドは何もしないと規定していますが、yash の bg コマンドはジョブが実行中かどうかにかかわらず SIGCONT シグナルを送信します。
.SH "BINDKEY 組込みコマンド"
.sp
\fIBindkey 組込みコマンド\fRは\:行編集におけるキーバインド設定を表示・設定します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBbindkey \-aev [\fR\fB\fIキー\fR\fR\fB [\fR\fB\fIコマンド\fR\fR\fB]]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBbindkey \-l\fR
.RE
.SS "説明"
.sp
\fB\-l\fR (\fB\-\-list\fR) オプションを付けて実行すると、bindkey コマンドはキーバインド設定で利用可能な\:行編集コマンドの一覧を標準出力に出力します。
.sp
他のオプションを付けて実行すると、bindkey コマンドはキーバインド設定の表示または設定を行います。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
オペランドとして\fIキー\fR・\fIコマンド\fRを与えない場合、現在のキーバインド設定の内容を (コマンドとして解釈可能な形式で) 標準出力に出力します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIキー\fRのみを与えると、そのキーに対する現在の設定だけを出力します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIキー\fRと\fIコマンド\fRを両方与えると、そのキーを入力したときに実行するコマンドを指定したコマンドに設定します。
.RE
.SS "オプション"
.PP
\fB\-a\fR, \fB\-\-vi\-command\fR
.RS 4
Vi 風編集モードのコマンドモードにおけるキーバインドを表示・設定します。
.RE
.PP
\fB\-e\fR, \fB\-\-emacs\fR
.RS 4
Emacs 風編集モードにおけるキーバインドを表示・設定します。
.RE
.PP
\fB\-v\fR, \fB\-\-vi\-insert\fR
.RS 4
Vi 風編集モードの挿入モードにおけるキーバインドを表示・設定します。
.RE
.SS "オペランド"
.PP
\fIキー\fR
.RS 4
表示・設定する対象のキー入力シーケンスです。このオペランドの値にはバックスラッシュで始まるエスケープシーケンスが利用できます。
.RE
.PP
\fIコマンド\fR
.RS 4
設定する行編集コマンドです。ハイフン一つ (\fB\-\fR) を指定すると、指定した\fIキー\fRに対する設定を削除します。
.RE
.SS "終了ステータス"
.sp
エラーがない限り bindkey コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
POSIX には bindkey コマンドに関する規定はありません。
.SH "BREAK 組込みコマンド"
.sp
\fIBreak 組込みコマンド\fRは実行中のループを中断します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBbreak [\fR\fB\fI深さ\fR\fR\fB]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBbreak \-i\fR
.RE
.SS "説明"
.sp
\fB\-i\fR (\fB\-\-iteration\fR) オプションを付けずに実行すると、break コマンドは現在実行中の for ループまたは while ループまたは until ループを中断します。多重ループの中で実行した場合、内側から数えて\fI深さ\fR番目のループを中断します。\fI深さ\fRが指定されていないときは、最も内側のループを中断します (\fI深さ\fR = 1)。指定された\fI深さ\fRが実際に実行している多重ループの深さより大きい場合は最も外側のループを中断します。
.sp
\fB\-i\fR (\fB\-\-iteration\fR) オプションを付けて実行すると、break コマンドは現在実行中の反復実行を中断します。
.SS "オプション"
.PP
\fB\-i\fR, \fB\-\-iteration\fR
.RS 4
ループではなく反復実行を中断します。
.RE
.SS "オペランド"
.PP
\fInest\fR
.RS 4
内側から何番目のループを中断するのかを指定する 1 以上の自然数です。
.RE
.SS "終了ステータス"
.sp
ループの中断に成功すると終了ステータスは 0 です。反復実行の中断に成功すると break コマンドの直前に実行されたコマンドの終了ステータスが break コマンドの終了ステータスになります。
.SS "補足"
.sp
Break コマンドは特殊組込みコマンドです。
.sp
POSIX には \fB\-i\fR (\fB\-\-interact\fR) オプションに関する規定はありません。よってこのオプションは POSIX 準拠モードでは使えません。
.SH "CD 組込みコマンド"
.sp
\fICd 組込みコマンド\fRはシェルの作業ディレクトリを変更します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcd [\-L|\-P] [\fR\fB\fIディレクトリ\fR\fR\fB]\fR
.RE
.SS "説明"
.sp
Cd コマンドはシェルの作業ディレクトリをオペランドで指定したディレクトリに変更します。新しい作業ディレクトリに応じて \fBPWD\fR 変数の値が再設定されるとともに、前の \fBPWD\fR 変数の値が \fBOLDPWD\fR 変数に設定されます。
.sp
指定した\fIディレクトリ\fRが相対パスの場合 (最初が \fB\&.\fR または \fB\&.\&.\fR で始まるものを除く)、コマンドの検索における \fBPATH\fR 変数の検索と同様にして、\fBCDPATH\fR 変数の値にあるコロンで区切った各ディレクトリ内に指定した\fIディレクトリ\fRがあるかどうか調べます。ディレクトリが見つかった場合は、そのディレクトリが新しい作業ディレクトリになります。見つからなかった場合は、\fIディレクトリ\fRは現在の作業ディレクトリからの相対パスとなります。
.sp
\fBCDPATH\fR 変数の検索で新しい作業ディレクトリが見つかった場合または\fIディレクトリ\fRとして \fB\-\fR が指定された場合は新しい作業ディレクトリのパスを標準出力に出力します。
.sp
作業ディレクトリの変更に成功した場合、\fBYASH_AFTER_CD\fR 変数が設定されていればその値がコマンドとして解釈・実行されます (非 POSIX 準拠モード時)。
.SS "オプション"
.PP
\fB\-L\fR, \fB\-\-logical\fR
.RS 4
ディレクトリパスに含まれるシンボリックリンクを解決せずに新しい作業ディレクトリを決定します。新しい
\fBPWD\fR
変数の値にはシンボリックリンクになっているパス名コンポーネントがそのまま残ります。
.RE
.PP
\fB\-P\fR, \fB\-\-physical\fR
.RS 4
ディレクトリパスに含まれるシンボリックリンクを解決します。新しい
\fBPWD\fR
変数の値はシンボリックリンクを含みません。
.RE
.PP
\fB\-\-default\-directory=\fR\fB\fIディレクトリ\fR\fR
.RS 4
\fIディレクトリ\fRオペランドが与えられていない場合は、代わりにこのオプションで指定した\fIディレクトリ\fRを新しい作業ディレクトリとします。
.RE
.sp
\fB\-L\fR (\fB\-\-logical\fR) オプションと \fB\-P\fR (\fB\-\-physical\fR) オプションの両方を指定した場合、後に指定したほうを優先します。どちらも指定していない場合は、\fB\-L\fR を指定したものとみなします。
.SS "オペランド"
.PP
\fIディレクトリ\fR
.RS 4
新しい作業ディレクトリのパス名です。絶対パスまたは元の作業ディレクトリからの相対パスで指定します。
.sp
この値がハイフン一つ (「\-」) の場合、\fBOLDPWD\fR 変数の値が指定されたものとみなします。このオペランドが与えられていない場合、\fBHOME\fR 変数の値が指定されたものとみなします (\fB\-\-default\-directory\fR
オプションを指定した場合を除く)。
.RE
.SS "終了ステータス"
.sp
作業ディレクトリを正しく変更できた場合、終了ステータスは 0 です。エラーがあると終了ステータスは非 0 です。
.SS "補足"
.sp
Cd コマンドは準特殊組込みコマンドです。
.sp
POSIX には \fBYASH_AFTER_CD\fR 変数および \fB\-\-default\-directory=\&...\fR オプションに関する規定はありません。POSIX は\fIディレクトリ\fRとしてハイフン一つを指定したときに \fB\-L\fR または \fB\-P\fR オプションを併用することを認めていません。
.sp
\fBYASH_AFTER_CD\fR 変数の実行結果は cd コマンドの終了ステータスには影響しません。
.SH "コロン組込みコマンド"
.sp
\fIコロン組込みコマンド\fRは何も行わない組込みコマンドです。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB: [\fR\fB\fI引数\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
コロンコマンドは何も行いません。コマンドライン引数は一切無視します。
.SS "終了ステータス"
.sp
コロンコマンドの終了ステータスは 0 です。
.SS "補足"
.sp
コロンコマンドは特殊組込みコマンドです。
.sp
引数の展開とリダイレクトは他のコマンドと同様に行います。
.sp
True コマンドはコロンコマンドと同様に何も行いませんが、コロンコマンドは特殊組込みコマンドであるのに対し true コマンドは準特殊組込みコマンドです。
.SH "COMMAND 組込みコマンド"
.sp
\fICommand 組込みコマンド\fRはコマンドを実行します。またコマンドの種類を特定します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcommand [\-befp] \fR\fB\fIコマンド\fR\fR\fB [\fR\fB\fI引数\fR\fR\fB\&...]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcommand \-v|\-V [\-abefkp] \fR\fB\fIコマンド\fR\fR\fB\&...\fR
.RE
.SS "説明"
.sp
\fB\-v\fR (\fB\-\-identify\fR) オプションならびに \fB\-V\fR (\fB\-\-verbose\-identify\fR) オプションを付けずに実行すると、command コマンドは与えられた\fIコマンド\fRを与えられた\fI引数\fRで実行します。コマンドの実行の仕方は単純コマンドの実行の最後のステップに準じますが、コマンドの検索では外部コマンド・組込みコマンド・関数の内オプションで指定したものしか検索しません。またコマンドが特殊組込みコマンドの場合、コマンドのオプションやオペランドの使い方が間違っていたりリダイレクトエラーや代入エラーが起きたりしてもシェルは終了しません。
.sp
\fB\-v\fR (\fB\-\-identify\fR) オプションまたは \fB\-V\fR (\fB\-\-verbose\-identify\fR) オプションを付けて実行すると、command コマンドは与えられた\fIコマンド\fRの種類とパスを特定しそれを標準出力に出力します。\fIコマンド\fRはエイリアスや関数であっても構いません。
.sp
\fB\-v\fR (\fB\-\-identify\fR) オプションを付けて実行したときの出力は以下のようになります。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンドの検索の結果見つかったコマンドおよびその他の外部コマンドは、その絶対パスを出力します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンドの検索によらず実行される組込みコマンドや関数は、単にその名前を出力します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
予約語は、単にその名前を出力します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
エイリアスは、コマンドとして実行可能な形式でその名前と値を出力します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンドが見つからなかった場合は、何も出力しません。(終了ステータスが非 0 になります)
.RE
.sp
\fB\-V\fR (\fB\-\-verbose\-identify\fR) オプション使用時は、出力の形式が人間にとってより読みやすくなります。
.SS "オプション"
.PP
\fB\-a\fR, \fB\-\-alias\fR
.RS 4
\fIコマンド\fRとしてエイリアスを検索の対象にします。
\fB\-v\fR
(\fB\-\-identify\fR) または
\fB\-V\fR
(\fB\-\-verbose\-identify\fR) オプションと一緒に使う必要があります。
.RE
.PP
\fB\-b\fR, \fB\-\-builtin\-command\fR
.RS 4
\fIコマンド\fRとして組込みコマンドを検索の対象にします。
.RE
.PP
\fB\-e\fR, \fB\-\-external\-command\fR
.RS 4
\fIコマンド\fRとして外部コマンドを検索の対象にします。
.RE
.PP
\fB\-f\fR, \fB\-\-function\fR
.RS 4
\fIコマンド\fRとして関数を検索の対象にします。
.RE
.PP
\fB\-k\fR, \fB\-\-keyword\fR
.RS 4
\fIコマンド\fRとして予約語を検索の対象にします。
\fB\-v\fR
(\fB\-\-identify\fR) または
\fB\-V\fR
(\fB\-\-verbose\-identify\fR) オプションと一緒に使う必要があります。
.RE
.PP
\fB\-p\fR, \fB\-\-standard\-path\fR
.RS 4
コマンドの検索において、\fBPATH\fR 変数の代わりに、標準のコマンドをすべて含むようなシステム固有のデフォルトパスを用いて外部コマンドを検索します。
.RE
.PP
\fB\-v\fR, \fB\-\-identify\fR
.RS 4
与えられた\fIコマンド\fRの種類とパスを特定し、簡単な形式で標準出力に出力します。
.RE
.PP
\fB\-V\fR, \fB\-\-verbose\-identify\fR
.RS 4
与えられた\fIコマンド\fRの種類とパスを特定し、人間にとって読みやすい形式で標準出力に出力します。
.RE
.sp
\fB\-a\fR (\fB\-\-alias\fR), \fB\-b\fR (\fB\-\-builtin\-command\fR), \fB\-e\fR (\fB\-\-external\-command\fR), \fB\-f\fR (\fB\-\-function\fR), \fB\-k\fR (\fB\-\-keyword\fR) オプションのどれも指定しなかった場合は、以下のオプションを指定したものとみなします。
.PP
\fB\-v\fR (\fB\-\-identify\fR) あるいは \fB\-V\fR (\fB\-\-verbose\-identify\fR) オプションを指定していないとき
.RS 4
\fB\-b \-e\fR
.RE
.PP
\fB\-v\fR (\fB\-\-identify\fR) または \fB\-V\fR (\fB\-\-verbose\-identify\fR) オプションを指定しているとき
.RS 4
\fB\-a \-b \-e \-f \-k\fR
.RE
.SS "オペランド"
.PP
\fIコマンド\fR
.RS 4
実行するまたは種類を特定するコマンドの名前です。
.RE
.PP
\fI引数\fR\&...
.RS 4
実行するコマンドに渡すコマンドライン引数です。
.RE
.SS "終了ステータス"
.PP
\fB\-v\fR (\fB\-\-identify\fR) あるいは \fB\-V\fR (\fB\-\-verbose\-identify\fR) オプションを指定していないとき
.RS 4
実行したコマンドの終了ステータス
.RE
.PP
\fB\-v\fR (\fB\-\-identify\fR) または \fB\-V\fR (\fB\-\-verbose\-identify\fR) オプションを指定しているとき
.RS 4
エラーがない限り 0
.RE
.SS "補足"
.sp
Command コマンドは準特殊組込みコマンドです。
.sp
POSIX に規定のあるオプションは \fB\-p\fR, \fB\-v\fR, \fB\-V\fR だけです。これ以外のオプションは POSIX 準拠モードでは使えません。また POSIX 準拠モードでは \fB\-v\fR または \fB\-V\fR オプションを使用するとき\fIコマンド\fRはちょうど一つしか指定できません。
.sp
POSIX は \fB\-v\fR オプションと \fB\-V\fR オプションを同時に指定することを認めていません。Yash ではこれら二つのオプションを両方指定すると最後に指定したものが有効になります。
.SH "COMPLETE 組込みコマンド"
.sp
\fIComplete 組込みコマンド\fRはコマンドライン補完において補完候補を生成します。この組込みコマンドは補完関数の実行中にだけ使えます。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcomplete [\-A \fR\fB\fIパターン\fR\fR\fB] [\-R \fR\fB\fIパターン\fR\fR\fB] [\-T] [\-P \fR\fB\fI接頭辞\fR\fR\fB] [\-S \fR\fB\fI接尾辞\fR\fR\fB] [\-abcdfghjkuv] [[\-O] [\-D \fR\fB\fI説明\fR\fR\fB] \fR\fB\fI単語\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
補完関数の中でこの組込みコマンドを実行すると、complete コマンドは指定した引数に従って補完候補を生成します。どのオプション・オペランドで候補を生成するにせよ、実際に生成される候補は現在補完しようとしている (コマンドライン上に途中まで入力された) 単語に一致するものに限られます。
.SS "オプション"
.PP
\fB\-A \fR\fB\fIパターン\fR\fR, \fB\-\-accept=\fR\fB\fIパターン\fR\fR
.RS 4
このオプションを指定すると、指定した\fIパターン\fRにマッチする候補だけを生成します。このオプションは複数回指定できます (指定した全ての\fIパターン\fRにマッチする候補だけを生成します)。
.RE
.PP
\fB\-D \fR\fB\fI説明\fR\fR, \fB\-\-description=\fR\fB\fI説明\fR\fR
.RS 4
このオプションを指定すると、このオプションで指定した\fI説明\fRが補完の際に候補の説明として表示されます。
.RE
.PP
\fB\-O\fR, \fB\-\-option\fR
.RS 4
生成する候補をコマンドのオプションとみなすようにします。候補を画面上に一覧表示する際に自動的に先頭にハイフンを付加します。
.RE
.PP
\fB\-P \fR\fB\fI接頭辞\fR\fR, \fB\-\-prefix=\fR\fB\fI接頭辞\fR\fR
.RS 4
このオプションで指定する\fI接頭辞\fRは現在補完しようとしている単語の接頭辞になっていなければなりません。このオプションを指定すると、候補生成の際にこのオプションで指定した\fI接頭辞\fRを無視してマッチングを行います。例えば補完しようとしている単語が
\fBfile:///home/user/docume\fR
であり、この URL をファイル名として補完したいとしましょう。この場合は、\fBcomplete \-P file:// \-f\fR
とすると URL から
\fBfile://\fR
を除いた残りの
\fB/home/user/docume\fR
の部分に対してファイル名としての補完候補が生成されます。
.RE
.PP
\fB\-R \fR\fB\fIパターン\fR\fR, \fB\-\-reject=\fR\fB\fIパターン\fR\fR
.RS 4
このオプションを指定すると、指定した\fIパターン\fRにマッチする候補を生成しません。このオプションは複数回指定できます (指定した\fIパターン\fRの少なくとも一つにマッチする候補を全て除外します)。
.RE
.PP
\fB\-S \fR\fB\fI接尾辞\fR\fR, \fB\-\-suffix=\fR\fB\fI接尾辞\fR\fR
.RS 4
生成した各候補の末尾に\fI接尾辞\fRを付加します。
.RE
.PP
\fB\-T\fR, \fB\-\-no\-termination\fR
.RS 4
通常は、補完が終わった後に次の単語をすぐ入力できるように、補完した単語の直後に空白を自動的に挿入しますが、このオプションを指定したときは空白を挿入しません。
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB補完方式設定のためのオプション\fR
.RS 4
.PP
\fB\-a\fR, \fB\-\-alias\fR
.RS 4
エイリアス
(\fB\-\-normal\-alias \-\-global\-alias\fR
に同じ)
.RE
.PP
\fB\-\-array\-variable\fR
.RS 4
配列
.RE
.PP
\fB\-\-bindkey\fR
.RS 4
Bindkey コマンドで利用可能な\:行編集コマンド
.RE
.PP
\fB\-b\fR, \fB\-\-builtin\-command\fR
.RS 4
組込みコマンド
(\fB\-\-special\-builtin \-\-semi\-special\-builtin \-\-regular\-builtin\fR
に同じ)
.RE
.PP
\fB\-c\fR, \fB\-\-command\fR
.RS 4
コマンド (\fB\-\-builtin\-command \-\-external\-command \-\-function\fR
に同じ)
.RE
.PP
\fB\-d\fR, \fB\-\-directory\fR
.RS 4
ディレクトリ
.RE
.PP
\fB\-\-dirstack\-index\fR
.RS 4
ディレクトリスタックのインデックス
.RE
.PP
\fB\-\-executable\-file\fR
.RS 4
実行可能ファイル
.RE
.PP
\fB\-\-external\-command\fR
.RS 4
外部コマンド
.RE
.PP
\fB\-f\fR, \fB\-\-file\fR
.RS 4
ファイル (ディレクトリ含む)
.RE
.PP
\fB\-\-finished\-job\fR
.RS 4
終了したジョブのジョブ ID
.RE
.PP
\fB\-\-function\fR
.RS 4
関数
.RE
.PP
\fB\-\-global\-alias\fR
.RS 4
グローバルエイリアス
.RE
.PP
\fB\-g\fR, \fB\-\-group\fR
.RS 4
(ファイルのパーミッションなどにおける) グループ
.RE
.PP
\fB\-h\fR, \fB\-\-hostname\fR
.RS 4
ホスト名
.RE
.PP
\fB\-j\fR, \fB\-\-job\fR
.RS 4
ジョブ ID
.RE
.PP
\fB\-k\fR, \fB\-\-keyword\fR
.RS 4
シェルの予約語
.RE
.PP
\fB\-\-normal\-alias\fR
.RS 4
通常の (グローバルでない)
エイリアス
.RE
.PP
\fB\-\-regular\-builtin\fR
.RS 4
通常の組込みコマンド
.RE
.PP
\fB\-\-running\-job\fR
.RS 4
実行中のジョブのジョブ ID
.RE
.PP
\fB\-\-scalar\-variable\fR
.RS 4
(配列を除いた通常の)
変数
.RE
.PP
\fB\-\-semi\-special\-builtin\fR
.RS 4
準特殊組込みコマンド
.RE
.PP
\fB\-\-signal\fR
.RS 4
シグナル
.RE
.PP
\fB\-\-special\-builtin\fR
.RS 4
特殊組込みコマンド
.RE
.PP
\fB\-\-stopped\-job\fR
.RS 4
停止中のジョブのジョブ ID
.RE
.PP
\fB\-u\fR, \fB\-\-username\fR
.RS 4
ユーザのログイン名
.RE
.PP
\fB\-v\fR, \fB\-\-variable\fR
.RS 4
変数
.RE
.sp
\fB\-d\fR (\fB\-\-directory\fR) オプションを指定せずに \fB\-f\fR (\fB\-\-file\fR) オプションを指定した場合、\fB\-S \&...\fR (\fB\-\-suffix=\&...\fR) オプションの指定の有無にかかわらず、ディレクトリ名を表す補完候補には接尾辞としてスラッシュが付き、候補の直後には空白が入りません (\fB\-S / \-T\fR を指定したときと同じ動作)。
.sp
ジョブ ID の補完は先頭の \fB%\fR を除いた部分に対して行われるので、補完しようとしている単語が既に \fB%\fR を含んでいる場合は \fB%\fR を接頭辞として指定してください。
.RE
.SS "オペランド"
.sp
Complete コマンドのオペランドは、各オペランドがそれぞれ補完候補として扱われます。指定したオペランドのうち、現在補完しようとしている単語に合うものが補完候補となります。
.SS "終了ステータス"
.sp
候補が少なくとも一つ生成できた場合は、終了ステータスは 0 です。新たな候補が一つも生成できなかったときは、終了ステータスは 1 です。その他のエラーの場合は 2 以上の終了ステータスになります。
.SS "補足"
.sp
POSIX には complete コマンドに関する規定はありません。
.SH "CONTINUE 組込みコマンド"
.sp
\fIContinue 組込みコマンド\fRは実行中のループの次の繰り返しに処理を移します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcontinue [\fR\fB\fI深さ\fR\fR\fB]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBcontinue \-i\fR
.RE
.SS "説明"
.sp
\fB\-i\fR (\fB\-\-iteration\fR) オプションを付けずに実行すると、continue コマンドは現在実行中の for ループまたは while ループまたは until ループの繰り返しを中断し、直ちに次の繰り返しを開始します (while/until ループについては、ループの実行条件の判定からやり直します)。多重ループの中で実行した場合、内側から数えて\fI深さ\fR番目のループに対してこの動作を行います。\fI深さ\fRが指定されていないときは、最も内側のループに対してこの動作を行います (\fI深さ\fR = 1)。指定された\fI深さ\fRが実際に実行している多重ループの深さより大きい場合は最も外側のループに対してこの動作を行います。
.sp
\fB\-i\fR (\fB\-\-iteration\fR) オプションを付けて実行すると、continue コマンドは現在実行中の反復実行の現在のコマンドの実行を中断し、直ちに次のコマンドの実行を開始します。
.SS "オプション"
.PP
\fB\-i\fR, \fB\-\-iteration\fR
.RS 4
ループではなく反復実行に対して作用します。
.RE
.SS "オペランド"
.PP
\fI深さ\fR
.RS 4
内側から何番目のループに作用するのかを指定する 1 以上の自然数です。
.RE
.SS "終了ステータス"
.sp
\fB\-i\fR (\fB\-\-iteration\fR) オプションが指定されていないとき、continue コマンドの処理が成功すると終了ステータスは 0 です。\fB\-i\fR (\fB\-\-iteration\fR) オプションが指定されているとき、continue コマンドの処理が成功すると continue コマンドの直前に実行されたコマンドの終了ステータスが continue コマンドの終了ステータスになります。
.SS "補足"
.sp
Continue コマンドは特殊組込みコマンドです。
.sp
POSIX には \fB\-i\fR (\fB\-\-interact\fR) オプションに関する規定はありません。よってこのオプションは POSIX 準拠モードでは使えません。
.SH "DIRS 組込みコマンド"
.sp
\fIDirs 組込みコマンド\fRはディレクトリスタックの内容を表示します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBdirs [\-cv] [\fR\fB\fIインデックス\fR\fR\fB\&.\&.]\fR
.RE
.SS "説明"
.sp
\fIディレクトリスタック\fRとは、作業ディレクトリの変更の履歴をとる仕組みです。Pushd コマンドで作業ディレクトリを変更すると、元の作業ディレクトリがディレクトリスタックに追加されます。Popd コマンドを使うと、ディレクトリスタックに保存してある元の作業ディレクトリに戻ることができます。Dirs コマンドを使うと、ディレクトリスタックの内容を表示することができます。ディレクトリスタックの内容は \fBDIRSTACK\fR 配列と \fBPWD\fR 変数に保存されます。これらの値を変更すると、ディレクトリスタックの動作に影響します。
.sp
ディレクトリスタックに保存してあるディレクトリは\fIインデックス\fRで区別します。インデックスは \fB\-v\fR (\fB\-\-verbose\fR) オプションを付けて dirs コマンドを実行することで知ることができます。インデックスは正号 (\fB+\fR) または負号 (\fB\-\fR) の付いた整数の形で表わします。整数は pushd コマンドでディレクトリスタックに追加した順に振られます。例えばインデックス \fB+0\fR は現在の作業ディレクトリに対応します。インデックス \fB+1\fR は最後に追加したディレクトリで、インデックス \fB+2\fR はその一つ前に追加したディレクトリに対応します。インデックス \fB\-0\fR は最初に 追加したディレクトリ、インデックス \fB\-1\fR はその次に追加したディレクトリに対応します。
.sp
\fB\-c\fR (\fB\-\-clear\fR) オプションを付けずに実行すると、dirs コマンドは現在のディレクトリスタックの要素を一つずつ標準出力に出力します。 \fB\-c\fR (\fB\-\-clear\fR) オプションを付けて実行すると、dirs コマンドはディレクトリスタックのインデックス \fB+0\fR 以外の要素をすべて削除します。
.SS "オプション"
.PP
\fB\-c\fR, \fB\-\-clear\fR
.RS 4
ディレクトリスタックの要素を (現在の作業ディレクトリに対応するものを除いて) すべて削除します。
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
ディレクトリスタックの要素のインデックスも出力します。
.RE
.SS "オペランド"
.PP
\fIインデックス\fR
.RS 4
表示するディレクトリスタックの要素のインデックスです。インデックスを一つも指定しないときは、全ての要素をインデックス
\fB+0\fR
のものから順に表示します。
.RE
.SS "終了ステータス"
.sp
エラーがない限り dirs コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
POSIX には dirs コマンドに関する規定はありません。
.SH "DISOWN 組込みコマンド"
.sp
\fIDisown 組込みコマンド\fRはジョブを削除します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBdisown [\-a] [\fR\fB\fIジョブ\fR\fR\fB\&...}\fR
.RE
.SS "説明"
.sp
Disown コマンドはシェルが管理しているジョブを削除します。削除したジョブはジョブ制御の対象から外れますが、ジョブを構成するコマンドの実行は継続します。
.SS "オプション"
.PP
\fB\-a\fR, \fB\-\-all\fR
.RS 4
全てのジョブを削除します。
.RE
.SS "オペランド"
.PP
\fIジョブ\fR
.RS 4
削除するジョブのジョブ ID。
.sp
複数指定することもできます。何も指定しないと現在のジョブを削除します。非
POSIX 準拠モードではジョブ ID の先頭の
\fB%\fR
は省略できます。
.RE
.SS "終了ステータス"
.sp
エラーがない限り disown コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
POSIX には disown コマンドに関する規定はありません。
.SH "ドット組込みコマンド"
.sp
\fIドット組込みコマンド\fRはテキストファイルを開いて、その内容をコマンドとして解釈し実行します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\&. [\-AL] \fR\fB\fIファイル名\fR\fR\fB [\fR\fB\fI引数\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
ドットコマンドは与えられた\fIファイル名\fRのファイルを開き、その内容をコマンドとして解釈し現在のコマンド実行環境で実行します。
.sp
\fIファイル名\fRに続けて\fI引数\fRが与えられているときは、関数の実行の時と同様に、コマンドの実行前に\fI引数\fRが位置パラメータに設定され、実行後に元の位置パラメータに戻ります。
.sp
\fIファイル名\fRにスラッシュ (\fB/\fR) が一つも入っていない場合は、コマンドの検索のときと同様に \fBPATH\fR 変数の検索を行い、開くべきファイルを探します。ただしファイルは読み込み可能でさえあれば実行可能である必要はありません。検索の結果ファイルが見つかれば、そのファイルの内容を解釈・実行します。ファイルが見つからなかった場合、POSIX 準拠モードでは直ちにエラーになります。POSIX 準拠モードでないときは現在の作業ディレクトリのファイルを開くことを試みます。
.SS "オプション"
.PP
\fB\-A\fR, \fB\-\-no\-alias\fR
.RS 4
ファイルを読み込んで実行する際、エイリアス展開を行いません。
.RE
.PP
\fB\-L\fR, \fB\-\-autoload\fR
.RS 4
\fIファイル名\fRがスラッシュを含んでいるかどうかにかかわらず、\fBPATH\fR
変数の代わりに
\fBYASH_LOADPATH\fR 変数を検索して開くべきファイルを探します。\fIファイル名\fRは現在の作業ディレクトリからの相対パス名とはみなしません。
.RE
.sp
ドットコマンドでは、最初のオペランドより後にあるコマンドライン引数は全てオペランドとして解釈します。
.SS "オペランド"
.PP
\fIファイル名\fR
.RS 4
読み込むファイルのパス名です。
.RE
.PP
\fI引数\fR\&...
.RS 4
ファイルの内容を実行している間に位置パラメータに設定する文字列です。
.RE
.SS "終了ステータス"
.sp
ドットコマンドの終了ステータスは、ファイルから読み込んで実行した最後のコマンドの終了ステータスです。ファイルの内容に一つもコマンドが入っていなかったときは終了ステータスは 0 です。ファイルが見つからなかったり開けなかったりしたときは終了ステータスは非 0 です。
.SS "補足"
.sp
ドットコマンドは特殊組込みコマンドです。
.sp
シェルが POSIX 準拠モードで、かつ対話モードでないとき、読み込むべきファイルが見つからなかったり開けなかったりするとシェルは直ちに終了します。
.sp
POSIX にはオプションに関する規定はありません。よってオプションは POSIX 準拠モードでは使えません。
.sp
POSIX には\fI引数\fRオペランドによって位置パラメータを変更できることについての規定はありません。よって POSIX 準拠モードでは\fI引数\fRオペランドを与えるとエラーになります。
.SH "ECHO 組込みコマンド"
.sp
\fIEcho 組込みコマンド\fRはコマンドライン引数を標準出力に出力します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBecho [\fR\fB\fI文字列\fR\fR\fB\&...]\fR
.RE
.sp
Echo コマンドはコマンドライン引数を全てオペランドとして解釈します。オプションは、以下に述べる例外を除いて一切解釈しません。オプションはオペランドより前に置く必要があります。Echo コマンドでは構文エラーは絶対に起きません。
.SS "説明"
.sp
Echo コマンドは与えられたコマンドライン引数と改行を標準出力に出力します。引数がない場合は改行だけを出力します。引数が複数ある場合はそれぞれを空白文字で区切って出力します。
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBエスケープシーケンス\fR
.RS 4
.sp
Echo コマンドに与える引数では、後述の \fBECHO_STYLE\fR 変数と \fB\-e\fR オプションの指定によって以下のエスケープシーケンスを使用することができます。
.PP
\fB\ea\fR
.RS 4
ベル文字 (ASCII コード番号 7)
.RE
.PP
\fB\eb\fR
.RS 4
バックスペース (ASCII コード番号 8)
.RE
.PP
\fB\ec\fR
.RS 4
これ以降何も出力しない。
.RE
.PP
\fB\ee\fR
.RS 4
エスケープ文字 (ASCII コード番号 27)
.RE
.PP
\fB\ef\fR
.RS 4
フォームフィード (ASCII コード番号 12)
.RE
.PP
\fB\en\fR
.RS 4
改行文字 (ASCII コード番号 10)
.RE
.PP
\fB\er\fR
.RS 4
復帰文字 (ASCII コード番号 13)
.RE
.PP
\fB\et\fR
.RS 4
水平タブ (ASCII コード番号 9)
.RE
.PP
\fB\ev\fR
.RS 4
垂直タブ (ASCII コード番号 11)
.RE
.PP
\fB\e\e\fR
.RS 4
バックスラッシュ
.RE
.PP
\fB\e0\fR\fB\fIxxx\fR\fR
.RS 4
八進数
\fIxxx\fR
(最大三桁) で表わされるコード番号の文字
.RE
.sp
エスケープシーケンスが無効の時は、エスケープシーケンスは解釈せずにそのまま出力します。
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBECHO_STYLE 変数\fR
.RS 4
.sp
Echo コマンドがオプションやエスケープシーケンスを解釈するかどうかは \fBECHO_STYLE\fR 変数の値によります。以下に、この変数の値と echo コマンドの動作との対応を示します。
.PP
\fBSYSV\fR, \fBXSI\fR
.RS 4
オプションは一切解釈しません。常にエスケープシーケンスを解釈します。
.RE
.PP
\fBBSD\fR
.RS 4
\fB\-n\fR
オプションを解釈します。エスケープシーケンスは一切解釈しません。
.RE
.PP
\fBGNU\fR
.RS 4
\fB\-n\fR,
\fB\-e\fR,
\fB\-E\fR
オプションを解釈します。エスケープシーケンスは
\fB\-e\fR
オプションを指定したときだけ解釈します。
.RE
.PP
\fBZSH\fR
.RS 4
\fB\-n\fR,
\fB\-e\fR,
\fB\-E\fR
オプションを解釈します。エスケープシーケンスは
\fB\-E\fR
オプションを指定しないかぎり解釈します。
.RE
.PP
\fBDASH\fR
.RS 4
\fB\-n\fR
オプションを解釈します。常にエスケープシーケンスを解釈します。
.RE
.PP
\fBRAW\fR
.RS 4
オプションもエスケープシーケンスも一切解釈しません。
.RE
.sp
\fBECHO_STYLE\fR 変数が設定されていないときは、値が \fBSYSV\fR または \fBXSI\fR の場合の動作をします。
.RE
.SS "オプション"
.PP
\fB\-n\fR
.RS 4
最後に改行を出力しないようにする。
.RE
.PP
\fB\-e\fR
.RS 4
エスケープシーケンスを解釈するようにする。
.RE
.PP
\fB\-E\fR
.RS 4
エスケープシーケンスを解釈せず、全ての文字をそのまま出力するようにする。
.RE
.SS "終了ステータス"
.sp
エラーがない限り echo コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
POSIX には \fBECHO_STYLE\fR 変数およびオプションに関する規定はありません。POSIX では、\fB\-n\fR オプションが指定されたときまたは引数にバックスラッシュが含まれている場合の動作を規定していません。可搬性のあるシェルスクリプトを書くには、echo コマンドよりも printf コマンドの使用を推奨します。
.SH "EVAL 組込みコマンド"
.sp
\fIEval 組込みコマンド\fRはオペランドをコマンドとして解釈して実行します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBeval [\-i] [\fR\fB\fIコマンド\fR\fR\fB\&...]\fR
.RE
.sp
Eval コマンドでは、POSIX 準拠モードであるかどうかにかかわらずオプションはオペランドより先に全て指定しなければなりません。最初のオペランドより後にあるコマンドライン引数は全てオペランドとして解釈します。
.SS "説明"
.sp
Eval コマンドは、与えられたオペランドをシェルのコマンドとして解釈し、現在のコマンド実行環境で実行します。
.sp
\fB\-i\fR (\fB\-\-iteration\fR) オプションが指定されていないときは、コマンドをまとめて一度に解釈・実行します。複数のオペランドがある場合は、それらを順に連結して一つにしてから解釈・実行します (連結の際、各オペランド間に空白文字を一つずつ区切りとして挿入します)。
.sp
\fB\-i\fR (\fB\-\-iteration\fR) オプションが指定されているときは、オペランドを順に一つずつ解釈・実行します。これを\fI反復実行\fRといいます。反復実行の途中で continue コマンドを \fB\-i\fR オプション付きで実行した場合、コマンドの実行は中断され、eval コマンドに与えられた次のオペランドの解釈・実行に移ります。反復実行の途中で break コマンドを \fB\-i\fR オプション付きで実行した場合、反復実行は中断され、この eval コマンドの実行は終了します。
.SS "オプション"
.PP
\fB\-i\fR, \fB\-\-iteration\fR
.RS 4
与えられたコマンドを順に反復実行します。
.RE
.SS "オペランド"
.PP
\fIコマンド\fR
.RS 4
コマンドとして解釈・実行する文字列です。
.RE
.SS "終了ステータス"
.sp
オペランドが一つもない場合またはオペランドの中にコマンドが一つも含まれていなかった場合、終了ステータスは 0 です。コマンドが一つ以上解釈・実行された場合、最後に実行したコマンドの終了ステータスが eval コマンドの終了ステータスになります。
.SS "補足"
.sp
Eval コマンドは特殊組込みコマンドです。
.sp
POSIX にはオプションに関する規定はありません。よってオプションは POSIX 準拠モードでは使えません。
.SH "EXEC 組込みコマンド"
.sp
\fIExec 組込みコマンド\fRはシェルのプロセスを別の外部コマンドに置き換えます。またシェルのプロセスに対してリダイレクトを実行します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBexec [\-cf] [\-a \fR\fB\fIコマンド名\fR\fR\fB] [\fR\fB\fIコマンド\fR\fR\fB [\fR\fB\fI引数\fR\fR\fB\&...]]\fR
.RE
.sp
Exec コマンドでは、POSIX 準拠モードであるかどうかにかかわらずオプションはオペランドより先に全て指定しなければなりません。これは exec コマンドに対するオプションと\fIコマンド\fRに対するオプションを区別するために重要です。\fIコマンド\fRより後にある引数はすべて\fI引数\fRとみなされます。
.SS "説明"
.sp
Exec コマンドを\fIコマンド\fRを指定して実行すると、シェルは単純コマンドの実行の最後のステップと同様にしてコマンドを実行します。ただし、コマンドは必ず外部コマンドとしてみなされ、関数や組込みコマンドは無視します。そしてその外部コマンドはサブシェルではなく現在のコマンド実行環境で exec システムコールを呼び出すことで実行します。これにより、シェルのプロセスは新しく起動するコマンドに置き換わります。
.sp
シェルが POSIX 準拠モードのときまたは対話モードでないとき、コマンドの起動に失敗するとシェルは直ちに終了します。
.sp
シェルが POSIX 準拠モードではなくかつ対話モードのとき、停止中のジョブがあると、シェルは警告を表示し、コマンドを起動しません。一度 exec が実行されると、シェルが持っているジョブの情報は失われるため、手動でシグナルを送ってジョブを再開または終了させなければならなくなります。警告を無視してコマンドを起動するには \fB\-f\fR (\fB\-\-force\fR) オプションを付けてください。
.sp
\fIコマンド\fRなしで実行した場合 exec コマンドは何も行いませんが、この exec コマンドを実行する際に行ったリダイレクトの効果は現在のコマンド実行環境に残ります。
.SS "オプション"
.PP
\fB\-a \fR\fB\fIコマンド名\fR\fR, \fB\-\-as=\fR\fB\fIコマンド名\fR\fR
.RS 4
\fIコマンド\fRの代わりに\fIコマンド名\fRをコマンド名としてコマンドに渡します。
.RE
.PP
\fB\-c\fR, \fB\-\-clear\fR
.RS 4
既存の環境変数をすべて削除した状態でコマンドを実行します。ただしこの exec コマンドを実行する際に行った変数代入の結果は環境変数としてコマンドに渡します。
.RE
.PP
\fB\-f\fR, \fB\-\-force\fR
.RS 4
警告を無視してコマンドを実行します。
.RE
.SS "オペランド"
.PP
\fIコマンド\fR
.RS 4
実行するコマンドです。
.RE
.PP
\fI引数\fR\&...
.RS 4
実行するコマンドに渡すコマンドライン引数です。
.RE
.SS "終了ステータス"
.sp
指定されたコマンドの起動に成功した場合、シェルのプロセスはそのコマンドのプロセスに置き換わってしまうので、終了ステータスはありません。
.sp
実行しようとしたコマンドが見つからなかった場合、終了ステータスは 127 です。コマンドが見つかったが実行できなかった場合、終了ステータスは 126 です。\fIコマンド\fRを指定せずに exec コマンドを実行した場合、終了ステータスは 0 です。
.SS "補足"
.sp
Exec コマンドは特殊組込みコマンドです。
.sp
POSIX にはオプションに関する規定はありません。よってオプションは POSIX 準拠モードでは使えません。
.SH "EXIT 組込みコマンド"
.sp
\fIExit 組込みコマンド\fRコマンドはシェルの実行を終了します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBexit [\-f] [\fR\fB\fI終了ステータス\fR\fR\fB]\fR
.RE
.SS "説明"
.sp
Exit コマンドは、このコマンドを実行したシェル (またはサブシェル) を終了します。
.sp
停止しているジョブのある対話モードのシェルを終了しようとすると、シェルは警告を表示し、終了しません。\fB\-f\fR (\fB\-\-force\fR) オプションを付けて実行するか exit コマンドを二連続で実行すると警告を無視してシェルを終了します。
.sp
シェル終了時のトラップが設定されている場合は、シェルが終了する前にそれが実行されます。
.SS "オプション"
.PP
\fB\-f\fR, \fB\-\-force\fR
.RS 4
警告を無視してシェルを終了します。
.RE
.SS "オペランド"
.PP
\fI終了ステータス\fR
.RS 4
終了するシェルの終了ステータスを指定する 0 以上の自然数です。
.sp
このオペランドが与えられていない場合は、exit コマンドの直前に実行されたコマンドの終了ステータスを用います (ただしトラップを実行中の場合はトラップに入る直前のコマンドの終了ステータス)。
.sp
終了するシェルの実際の終了ステータスは、オペランドで与えられた数を 256 で割った余りになります。
.RE
.SS "終了ステータス"
.sp
Exit コマンドはシェルを終了するので、exit コマンドそのものの終了ステータスはありません。
.sp
例外として、exit コマンドが警告を表示して、シェルを終了しなかった場合、exit コマンドの終了ステータスは非 0 です。
.SS "補足"
.sp
Exit コマンドは特殊組込みコマンドです。
.sp
POSIX では、\fI終了ステータス\fRの値は 0 以上 256 未満でなければならないとしています。Yash では拡張として 256 以上の値も受け付けるようになっています。
.sp
POSIX には \fB\-f\fR (\fB\-\-force\fR) オプションに関する規定はありません。よってこのオプションは POSIX 準拠モードでは使えません。
.sp
シェル終了時のトラップの実行中に exit コマンドを実行すると、再びトラップが実行されることはなくそのままシェルは終了します。このとき exit コマンドに\fI終了ステータス\fRが与えられていない場合は、もし終了時のトラップが設定されていなかった場合にシェルが返したろう終了ステータスでシェルは終了します。(シェルの終了も参照)
.SH "EXPORT 組込みコマンド"
.sp
\fIExport 組込みコマンド\fRはエクスポート対象の変数を表示・設定します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBexport [\-prX] [\fR\fB\fI変数\fR\fR\fB[=\fR\fB\fI値\fR\fR\fB]\&...]\fR
.RE
.SS "説明"
.sp
Export コマンドは typeset コマンドに \fB\-gx\fR オプションを付けたものと同じです。その他オプション・オペランド・終了ステータスは typeset コマンドと同様です。
.SS "補足"
.sp
Export コマンドは特殊組込みコマンドです。
.sp
POSIX には export コマンドに関する規定はありますが、オプションは \fB\-p\fR しか規定がありません。その他のオプションは POSIX 準拠モードでは使えません。また POSIX は \fB\-p\fR オプションをオペランドとともに使うことを認めていません。
.SH "FALSE 組込みコマンド"
.sp
\fIFalse 組込みコマンド\fRは何も行わずに非 0 の終了ステータスで終了します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBfalse\fR
.RE
.SS "説明"
.sp
False コマンドは何も行いません。コマンドライン引数は一切無視します。
.SS "終了ステータス"
.sp
False コマンドの終了ステータスは非 0 です。
.SS "補足"
.sp
False コマンドは準特殊組込みコマンドです。
.SH "FC 組込みコマンド"
.sp
\fIFc 組込みコマンド\fRはコマンド履歴に記録されたコマンドを再実行・表示します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBfc [\-qr] [\-e \fR\fB\fIエディタ\fR\fR\fB] [\fR\fB\fI始点\fR\fR\fB [\fR\fB\fI終点\fR\fR\fB]]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBfc \-s[q] [\fR\fB\fI前\fR\fR\fB=\fR\fB\fI後\fR\fR\fB] [\fR\fB\fI始点\fR\fR\fB]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBfc \-l[nrv] [\fR\fB\fI始点\fR\fR\fB [\fR\fB\fI終点\fR\fR\fB]]\fR
.RE
.SS "説明"
.sp
\fB\-l\fR (\fB\-\-list\fR) オプションを付けずに実行すると、fc コマンドはオペランドで指定したコマンド履歴のコマンドを再実行します。\fB\-s\fR (\fB\-\-silent\fR) オプションを付けていない場合、シェルはコマンドを再実行する前にエディタを起動し、コマンドを編集できるようにします。エディタが終了するとシェルは編集後のコマンドを実行します。\fB\-s\fR (\fB\-\-silent\fR) オプションを付けた場合、シェルはエディタを起動せず直接コマンドを再実行します。いずれの場合も、実行するコマンドは標準出力に出力しコマンド履歴に追加されます。
.sp
\fB\-l\fR (\fB\-\-list\fR) オプションを付けて実行すると、fc コマンドはオペランドで指定した範囲のコマンド履歴を標準出力に出力します。標準では履歴内のコマンドの内容を履歴番号とともに表示しますが、\fB\-n\fR (\fB\-\-no\-numbers\fR) および \fB\-v\fR (\fB\-\-verbose\fR) オプションにより出力形式を変更できます。
.SS "オプション"
.PP
\fB\-e \fR\fB\fIエディタ\fR\fR, \fB\-\-editor=\fR\fB\fIエディタ\fR\fR
.RS 4
コマンドの編集に用いるエディタ。
.sp
このオプションを指定しない場合、\fBFCEDIT\fR 変数の値をエディタとして使用します。\fBFCEDIT\fR
変数も設定されていない場合は、vi をエディタとして使用します。
.RE
.PP
\fB\-l\fR, \fB\-\-list\fR
.RS 4
コマンド履歴の内容を表示します。
.RE
.PP
\fB\-n\fR, \fB\-\-no\-numbers\fR
.RS 4
コマンド履歴の内容を表示する際、履歴番号を省いてコマンドのみ表示します。
.RE
.PP
\fB\-q\fR, \fB\-\-quiet\fR
.RS 4
コマンドを実行する前にコマンドを出力しないようにします。
.RE
.PP
\fB\-r\fR, \fB\-\-reverse\fR
.RS 4
\fI始点\fRと\fI終点\fRを入れ替えます。
.RE
.PP
\fB\-s\fR, \fB\-\-silent\fR
.RS 4
コマンドを編集せずに直接再実行します。
.RE
.PP
\fB\-v\fR, \fB\-\-verbose\fR
.RS 4
コマンド履歴の内容を表示する際、コマンドの時刻も表示します。
.RE
.SS "オペランド"
.PP
\fI始点\fRと\fI終点\fR
.RS 4
\fI始点\fRと\fI終点\fRのオペランドは、再実行または表示するコマンドの範囲を指定します。\fI始点\fRあるいは\fI終点\fRに整数を指定すると、それは履歴番号とみなします。負の整数は最新の履歴から数えた番号となります。例えば
\fB\-2\fR
は最後から二番目に履歴に登録されたコマンドを表します。整数以外の文字列を\fI始点\fRあるいは\fI終点\fRに指定すると、その文字列で始まる最新の履歴を指定しているものとみなします。
.sp
Fc コマンドが再実行または表示するコマンドは、\fI始点\fRと\fI終点\fRで指定したコマンドとその間にある履歴のコマンドです。\fI始点\fRが\fI終点\fRより後のコマンドを指している場合、コマンドの順序は逆になります。
.sp
\fI始点\fRまたは\fI終点\fRが与えられていない場合のデフォルト値は以下の表のとおりです。
.TS
allbox tab(:);
ltB ltB ltB.
T{

T}:T{
\fB\-l\fR あり
T}:T{
\fB\-l\fR なし
T}
.T&
lt lt lt
lt lt lt.
T{
\fI始点\fR
T}:T{
\-16
T}:T{
\-1
T}
T{
\fI終点\fR
T}:T{
\-16
T}:T{
\fI始点\fRに同じ
T}
.TE
.sp 1
.RE
.PP
\fI前\fR=\fI後\fR
.RS 4
\fI前\fR=\fI後\fRの形式のオペランドは、コマンドの一部を書き換えることを指示します。再実行するコマンドの中に\fI前\fRと同じ文字列がある場合は、その部分を\fI後\fRに置き換えて実行します。該当部分が複数ある場合は、最初のものだけを置き換えます。
.RE
.SS "終了ステータス"
.sp
コマンドを正しく再実行できた場合、fc コマンドの終了ステータスは再実行したコマンドの終了ステータスになります。\fB\-l\fR (\fB\-\-list\fR) オプションを指定した場合は、履歴が正しく出力できれば終了ステータスは 0 です。
.SS "補足"
.sp
Fc コマンドは準特殊組込みコマンドです。
.sp
POSIX には \fB\-q\fR (\fB\-\-quiet\fR) および \fB\-v\fR (\fB\-\-verbose\fR) オプションに関する規定はありません。よってこれらのオプションは POSIX 準拠モードでは使えません。
.sp
行編集の動作中は履歴の内容を変更することはできません。
.SH "FG 組込みコマンド"
.sp
\fIFg 組込みコマンド\fRはジョブをフォアグラウンドで実行します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBfg [\fR\fB\fIジョブ\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
Fg コマンドはジョブをフォアグラウンドに移動し SIGCONT シグナルを送ります。これにより、ジョブが停止していた場合はフォアグラウンドで実行が再開されます。Fg コマンドはジョブの実行が終了するまで待機し、ジョブの終了ステータスを返します。
.sp
ジョブの実行を再開する前に fg コマンドはジョブの名前を標準出力に出力します。
.sp
Fg コマンドはジョブ制御が有効な時しか使えません。
.SS "オペランド"
.PP
\fIジョブ\fR
.RS 4
実行するジョブのジョブ ID。
.sp
複数指定すると指定した順に一つずつジョブをフォアグラウンドで実行します。何も指定しないと現在のジョブを実行します。
.sp
非
POSIX 準拠モードではジョブ ID の先頭の
\fB%\fR
は省略できます。
.RE
.SS "終了ステータス"
.sp
ジョブを正しく実行できた場合、fg コマンドの終了ステータスは (最後に) 実行したジョブの終了ステータスです。エラーが発生した場合は終了ステータスは非 0 です。
.SS "補足"
.sp
Fg コマンドは準特殊組込みコマンドです。
.sp
POSIX 準拠モードでは\fIジョブ\fRは一つまでしか指定できません。
.SH "GETOPTS 組込みコマンド"
.sp
\fIGetopts 組込みコマンド\fRはコマンドライン引数のオプションを解析します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBgetopts \fR\fB\fIオプションリスト\fR\fR\fB \fR\fB\fI変数名\fR\fR\fB [\fR\fB\fI引数\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
Getopts コマンドは、オペランドで与えられたコマンドライン引数に含まれている一文字のオプションを解析します。Getopts コマンドを一回呼び出すたびにオプションが一つ解析され、そのオプションを表す一文字が\fI変数名\fRで指定した変数に代入されます。
.sp
解析の対象となるオプションの種類もオペランドで指定します。\fIオプションリスト\fRには受け付けるオプションの文字を並べて指定します。文字の後にコロン (\fB:\fR) を付けるとそのオプションは引数をとるものとみなします。例えば、\fB\-a\fR, \fB\-b\fR, \fB\-c\fR の三種類のオプションを受け付け、さらにこれらのうち \fB\-b\fR が引数をとる場合、\fIオプションリスト\fRには \fBab:c\fR を指定します。
.sp
引数をとるオプションを解析したとき、その引数の値が \fBOPTARG\fR 変数に代入されます。
.sp
\fIオプションリスト\fRで与えられていないオプションに出くわしたときまたは引数をとるオプションに引数が与えられていないときの動作は、\fIオプションリスト\fRの最初の文字がコロン (\fB:\fR) であるかどうかで決まります。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIオプションリスト\fRの最初の文字がコロンの場合、そのオプションの文字が
\fBOPTARG\fR
変数に代入され、\fI変数名\fRで指定した変数には
\fB?\fR
(\fIオプションリスト\fRで与えられていないオプションに出くわしたとき) または
\fB:\fR
(引数をとるオプションに引数が与えられていないとき) が代入されます。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fIオプションリスト\fRの最初の文字がコロンでない場合、\fBOPTARG\fR
変数は削除され、\fI変数名\fRで指定した変数には
\fB?\fR
が代入されます。またこのとき標準エラーにエラーメッセージが出力されますが、それでも getopts コマンドの終了ステータスは 0 になります。
.RE
.sp
Getopts コマンドは、実行するたびに一つずつオプションを解析します。全てのオプションを解析するには、毎回同じ\fI引数\fRで getopts コマンドを繰り返し実行する必要があります。シェルは、オプションをどこまで解析したかを覚えておくために、\fBOPTIND\fR 変数を用います。全てのオプションを解析し終わるまでにこの変数を変更してはいけません。全てのオプションを解析し終わると、\fBOPTIND\fR 変数には\fI引数\fR (または位置パラメータ) の中で最初のオペランドに当たるもののインデックスが代入されます (オペランドがない場合は\fI引数\fRまたは位置パラメータの個数 + 1 になります)。
.sp
異なる\fI引数\fRを解析させたい場合は、getopts コマンドに新しい\fI引数\fRを与える前に \fBOPTIND\fR 変数に \fB1\fR を代入してください。
.SS "オペランド"
.PP
\fIオプションリスト\fR
.RS 4
解析の対象となるオプションの文字の羅列です。
.RE
.PP
\fI変数名\fR
.RS 4
解析結果の値を代入する変数の名前です。
.RE
.PP
\fI引数\fRs
.RS 4
解析するコマンドライン引数です。
.sp
このオペランドを指定しない場合は、位置パラメータを解析します。
.RE
.SS "終了ステータス"
.sp
\fI引数\fRの中にオプションが見つかった場合は、(それが\fIオプションリスト\fRに含まれているかどうかにかかわらず) 終了ステータスは 0 です。全てのオプションを解析し終わった時は、終了ステータスは非 0 です。
.SS "使用例"
.sp
.if n \{\
.RS 4
.\}
.nf
aopt=false bopt= copt=false
while getopts ab:c opt
do
  case $opt in
  a) aopt=true ;;
  b) bopt=$OPTARG ;;
  c) copt=true ;;
  \e?) return 2 ;;
  esac
done
if $aopt;          then echo オプション \-a が指定されました;       fi
if [ \-n "$bopt" ]; then echo オプション \-b $bopt が指定されました; fi
if $copt;          then echo オプション \-c が指定されました;       fi
shift $((OPTIND \- 1))
echo オペランドは $*
.fi
.if n \{\
.RE
.\}
.SS "補足"
.sp
Getopts コマンドが解析するコマンドライン引数では、オプションは全てオペランドより前に指定してある必要があります。最初にオペランドが現れた時点で、getopts コマンドは解析を終了します。
.sp
Getopts コマンドは準特殊組込みコマンドです。
.sp
POSIX は、\fBOPTIND\fR 変数に \fB1\fR 以外の値を代入した場合の動作を規定していません。
.SH "HASH 組込みコマンド"
.sp
\fIHash 組込みコマンド\fRは外部コマンドのパスを検索・表示します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBhash \fR\fB\fIコマンド\fR\fR\fB\&...\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBhash \-r [\fR\fB\fIコマンド\fR\fR\fB\&...]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBhash [\-a]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBhash \-d \fR\fB\fIユーザ名\fR\fR\fB\&...\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBhash \-dr [\fR\fB\fIユーザ名\fR\fR\fB\&...]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBhash \-d\fR
.RE
.SS "説明"
.sp
オプションを指定しない場合、hash コマンドはオペランドで指定した外部コマンドのパスを検索し、結果を記憶します (既に記憶している場合は再度検索・記憶します)。
.sp
\fB\-r\fR (\fB\-\-remove\fR) オプションを指定している場合、hash コマンドはオペランドで指定した外部コマンドのパスに関する記憶を消去します。\fB\-r\fR (\fB\-\-remove\fR) オプションを指定しかつ\fIコマンド\fRを指定しない場合、全ての記憶を消去します。
.sp
\fB\-r\fR (\fB\-\-remove\fR) オプションを指定せず\fIコマンド\fRも指定しない場合、記憶しているパスの一覧を標準出力に出力します。
.sp
\fB\-d\fR (\fB\-\-directory\fR) オプションを指定した場合、hash コマンドは外部コマンドのパスの代わりにユーザのホームディレクトリのパスを検索・記憶または表示します。記憶したパスはチルダ展開で使用します。
.SS "オプション"
.PP
\fB\-a\fR, \fB\-\-all\fR
.RS 4
シェルが記憶している全てのパスを出力します。
.sp
このオプションを指定しない場合、シェルが記憶しているパスのうち組込みコマンドに対するものは出力しません。
.RE
.PP
\fB\-d\fR, \fB\-\-directory\fR
.RS 4
外部コマンドのパスの代わりにユーザのホームディレクトリのパスを扱います。
.RE
.PP
\fB\-r\fR, \fB\-\-remove\fR
.RS 4
指定したコマンドまたはユーザ名に対するパスの記憶を消去します。
.RE
.SS "オペランド"
.PP
\fIコマンド\fR
.RS 4
パスを記憶・消去する外部コマンドの名前です。スラッシュを含むパスを指定することはできません。
.RE
.PP
\fIユーザ名\fR
.RS 4
ホームディレクトリのパスを記憶・消去するユーザ名です。
.RE
.SS "終了ステータス"
.sp
エラーがない限り hash コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
シェルは、外部コマンド (またはチルダ展開) を実行する際に自動的にコマンド (またはホームディレクトリ) のパスを記憶するので、通常はわざわざ hash コマンドを使ってパスを記憶させる必要はありません。
.sp
\fBPATH\fR 変数の値が変わった時は、記憶した外部コマンドのパスは自動的にすべて消去されます。
.sp
POSIX が規定しているオプションは \fB\-r\fR だけです。よって他のオプションは POSIX 準拠モードでは使えません。
.SH "HELP 組込みコマンド"
.sp
\fIHelp 組込みコマンド\fRは組込みコマンドに関する説明を表示します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBhelp [\fR\fB\fIコマンド\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
Help 組込みコマンドは、オペランドで指定した組込みコマンドに関する説明を出力します。
.sp
このコマンドは、\fBman yash\fR の出力の一部を抜き出して標準出力に出力します。従って、マニュアルページがインストールされていなければ正しく動作しません。また、man コマンドの出力の形式によっては正しく説明を抜き出せないことがあります。
.SS "オペランド"
.PP
\fIコマンド\fR
.RS 4
説明を表示する組込みコマンドの名前です。
.RE
.SS "終了ステータス"
.sp
エラーがない限り help コマンドの終了ステータスは 0 です。 The exit status of the help built\-in is zero unless there is any error\&.
.SS "補足"
.sp
POSIX には help コマンドに関する規定はありません。
.sp
Yash の多くの組込みコマンドでは、\fB\-\-help\fR オプションを与えることで help コマンドの出力と同様の説明を表示させることができます。
.SH "HISTORY 組込みコマンド"
.sp
\fIHistory 組込みコマンド\fRはコマンド履歴を編集します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBhistory [\-cF] [\-d \fR\fB\fI項目\fR\fR\fB] [\-s \fR\fB\fIコマンド\fR\fR\fB] [\-r \fR\fB\fIファイル\fR\fR\fB] [\-w \fR\fB\fIファイル\fR\fR\fB] [\fR\fB\fI個数\fR\fR\fB]\fR
.RE
.SS "説明"
.sp
History コマンドはコマンド履歴の内容を編集・表示します。
.sp
オプションが指定してある場合、history コマンドはそのオプションに従ってコマンド履歴の内容を編集します。複数のオプションがある場合は指定した順に処理します。
.sp
オペランドで\fI個数\fRが与えられている場合、history コマンドはコマンド履歴の内容をその個数だけ標準出力に出力します。出力の形式は fc コマンドに準じます。
.sp
オプションもオペランドも与えられていない場合、history コマンドはコマンド履歴の内容を全て標準出力に出力します。
.SS "オプション"
.PP
\fB\-c\fR, \fB\-\-clear\fR
.RS 4
コマンド履歴をすべて削除します。
.RE
.PP
\fB\-d \fR\fB\fI項目\fR\fR, \fB\-\-delete=\fR\fB\fI項目\fR\fR
.RS 4
指定した\fI項目\fRをコマンド履歴から削除します。\fI項目\fRの指定の仕方は
fc コマンドの\fI始点\fR・\fI終点\fRオペランドと同じです。
.RE
.PP
\fB\-F\fR, \fB\-\-flush\-file\fR
.RS 4
履歴ファイルを再構築します。
.RE
.PP
\fB\-r \fR\fB\fIファイル\fR\fR, \fB\-\-read=\fR\fB\fIファイル\fR\fR
.RS 4
指定した\fIファイル\fRからコマンドを読み込み履歴に追加します。ファイルの内容は単なるテキストファイルとして解釈され、それぞれの行の内容が一つのコマンドとして追加されます。
.RE
.PP
\fB\-s \fR\fB\fIコマンド\fR\fR, \fB\-\-set=\fR\fB\fIコマンド\fR\fR
.RS 4
コマンド履歴の最後の項目を削除し、代わりに指定した\fIコマンド\fRを追加します。
.RE
.PP
\fB\-w \fR\fB\fIファイル\fR\fR, \fB\-\-write=\fR\fB\fIファイル\fR\fR
.RS 4
指定した\fIファイル\fRに現在のコマンド履歴の内容を全て書き出します。既にあるファイルの内容は消去します。履歴は単なるテキストとして一行ずつ書き出します。
.RE
.SS "オペランド"
.PP
\fI個数\fR
.RS 4
表示する履歴の個数です。
.RE
.SS "終了ステータス"
.sp
エラーがない限り history コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
POSIX には history コマンドに関する規定はありません。
.sp
行編集の動作中は履歴の内容を変更することはできません。
.SH "JOBS 組込みコマンド"
.sp
\fIJobs 組込みコマンド\fRはシェルが有しているジョブを表示します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBjobs [\-lnprs] [\fR\fB\fIジョブ\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
Jobs コマンドはシェルが現在有しているジョブの名前や状態を表示します。
.sp
標準では各ジョブについて以下の情報を一行ずつ表示します。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ジョブ番号
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
現在のジョブ・前のジョブを示す記号 (\fB+\fR
または
\fB\-\fR)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
状態
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
コマンド名
.RE
.SS "オプション"
.PP
\fB\-l\fR, \fB\-\-verbose\fR
.RS 4
ジョブを構成しているパイプラインの要素ごとにプロセス ID と状態とコマンド名を表示します。
.RE
.PP
\fB\-n\fR, \fB\-\-new\fR
.RS 4
状態が変化してからまだ一度も表示していないジョブだけを表示します。
.RE
.PP
\fB\-p\fR, \fB\-\-pgid\-only\fR
.RS 4
ジョブのプロセスグループ ID だけを表示します。
.RE
.PP
\fB\-r\fR, \fB\-\-running\-only\fR
.RS 4
実行中のジョブだけを表示します。
.RE
.PP
\fB\-s\fR, \fB\-\-stopped\-only\fR
.RS 4
停止中のジョブだけを表示します。
.RE
.SS "オペランド"
.PP
\fIジョブ\fR
.RS 4
表示するジョブのジョブ ID
です。一つも指定しない場合は全てのジョブを表示します。
.RE
.SS "終了ステータス"
.sp
エラーがない限り jobs コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
Jobs コマンドは準特殊組込みコマンドです。
.sp
POSIX で規定されているオプションは \fB\-l\fR と \fB\-p\fR だけです。従って POSIX 準拠モードではこれ以外のオプションは使えません。また POSIX 準拠モードでは、\fB\-l\fR オプション指定時、プロセスごとではなくジョブごとに状態を表示します。
.sp
Yash では、ジョブのプロセスグループ ID はジョブを構成するパイプラインの最初のコマンドのプロセス ID に一致します。
.SH "KILL 組込みコマンド"
.sp
\fIKill 組込みコマンド\fRはプロセスにシグナルを送ります。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBkill [\-\fR\fB\fIシグナル\fR\fR\fB|\-s \fR\fB\fIシグナル\fR\fR\fB|\-n \fR\fB\fIシグナル\fR\fR\fB] \fR\fB\fIプロセス\fR\fR\fB\&...\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBkill \-l [\-v] [\fR\fB\fIシグナル\fR\fR\fB\&...]\fR
.RE
.sp
Kill コマンドでは、POSIX 準拠モードであるかどうかにかかわらずオプションはオペランドより先に全て指定しなければなりません。最初のオペランドより後にあるコマンドライン引数は全てオペランドとして解釈します。
.SS "説明"
.sp
\fB\-l\fR オプションを付けずに実行すると、kill コマンドは指定した\fIプロセス\fRにシグナルを送信します。送信するシグナルの種類は\fIシグナル指定オプション\fRで指定します。シグナルの種類を指定しない場合は SIGTERM シグナルを送信します。
.sp
\fB\-l\fR オプションを付けて実行すると、kill コマンドは指定した\fIシグナル\fRに関する情報を標準出力に出力します。\fIシグナル\fRを指定しない場合は全てのシグナルに関する情報を表示します。
.SS "オプション"
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBシグナル指定オプション\fR
.RS 4
.PP
\fB\-\fR\fB\fIシグナル\fR\fR, \fB\-s \fR\fB\fIシグナル\fR\fR, \fB\-n \fR\fB\fIシグナル\fR\fR
.RS 4
送信するシグナルを指定します。\fIシグナル\fRにはシグナル番号とシグナル名のどちらかを指定します。シグナル番号として 0 を指定すると、シグナルを送ることができるかどうかの判定だけを行い、実際にはシグナルを送信しません。シグナルを名前で指定する際は、大文字と小文字の区別はありません。
.RE
.sp
シグナル指定オプションは一度に一つまでしか使えません。
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB他のオプション\fR
.RS 4
.PP
\fB\-l\fR
.RS 4
シグナルに関する情報を表示します。
.RE
.PP
\fB\-v\fR
.RS 4
シグナルに関する情報をより詳しく表示します。\fB\-v\fR
オプションを指定していない場合は単にシグナル名を出力しますが、指定している場合はシグナル番号・シグナル名・シグナルの簡単な説明を出力します。
.sp
このオプションを指定したときは同時に
\fB\-l\fR
も指定してあるとみなします。
.RE
.RE
.SS "オペランド"
.PP
\fIプロセス\fR
.RS 4
シグナルを送信するプロセスをプロセス ID・プロセスグループ ID・ジョブ ID
のいずれかで指定します。プロセスグループ ID を指定するときは、先頭に負号 (\fB\-\fR) を付けます。プロセスとして
\fB0\fR
を指定すると、シェルプロセスが属するプロセスグループを指定したものとみなします。プロセスとして
\fB\-1\fR
を指定すると、全てのプロセスにシグナルを送信します。
.RE
.PP
\fIシグナル\fR
.RS 4
情報を表示するシグナルの名前または番号です。シグナルによって中断したコマンドの終了ステータスを指定することもできます。
.RE
.SS "終了ステータス"
.sp
エラーがない限り kill コマンドの終了ステータスは 0 です。一つ以上のプロセスにシグナルを送ることができた場合、他にシグナルを送れなかったプロセスがあったとしても終了ステータスは 0 になります。
.SS "補足"
.sp
Kill コマンドは準特殊組込みコマンドです。
.sp
負数に見えるコマンドライン引数の扱いには注意が必要です。例えば \fBkill \-1 \-2\fR では \fB\-1\fR がシグナル指定オプション、\fB\-2\fR がオペランドとなるので、番号 1 のシグナルをプロセスグループ 2 に送信します。\fBkill \(em \-1 \-2\fR や \fBkill \-TERM \-1 \-2\fR では \fB\-1\fR と \fB\-2\fR はどちらもオペランドになります。
.sp
POSIX には \fB\-v\fR および \fB\-n\fR オプションに関する規定はありません。よってこれらのオプションは POSIX 準拠モードでは使えません。また POSIX は \fB\-s\fR オプションの引数としてシグナル番号を指定することを認めていません。POSIX は\fIシグナル\fRのオペランドとしてシグナルの名前を指定することを認めていません。
.sp
POSIX は、シグナル名は \fBINT\fR や \fBQUIT\fR のように最初の SIG を除いた形で指定しなければならないと規定しています。非 POSIX 準拠モードの yash では、拡張として SIG を付けた形でも指定できます。
.SH "POPD 組込みコマンド"
.sp
\fIPopd 組込みコマンド\fRはディレクトリスタックからディレクトリを削除し、シェルの作業ディレクトリを戻します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBpopd [\fR\fB\fIインデックス\fR\fR\fB]\fR
.RE
.SS "説明"
.sp
Popd コマンドはディレクトリスタックからオペランドで指定したインデックスの要素を削除します。インデックス \fB+0\fR の要素を削除した場合は、新たにインデックス \fB+0\fR の要素となったディレクトリにシェルの作業ディレクトリを変更し、そのディレクトリ名を標準出力に出力します。
.SS "オペランド"
.PP
\fIインデックス\fR
.RS 4
削除するディレクトリスタックの要素のインデックスです。省略すると
\fB+0\fR
を指定したものとみなします。
.RE
.SS "終了ステータス"
.sp
ディレクトリスタックの要素を正しく削除し作業ディレクトリを変更できた場合、終了ステータスは 0 です。エラーがあると終了ステータスは非 0 です。
.SS "補足"
.sp
ディレクトリスタックに要素が一つしかない場合はそれ以上要素を削除できないので、エラーになります。
.sp
POSIX には popd コマンドに関する規定はありません。
.SH "PRINTF 組込みコマンド"
.sp
\fIPrintf 組込みコマンド\fRはオペランドを整形して出力します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBprintf \fR\fB\fI書式\fR\fR\fB [\fR\fB\fI値\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
Printf コマンドはオペランドで指定した\fI書式\fRに従って\fI値\fRを整形し、標準出力に出力します。Echo コマンドとは異なり、出力の最後には自動的に改行は付きません。
.sp
書式の指定の仕方は C 言語の printf 関数とよく似ています。書式の中では \fB%\fR で始まる変換指定と \fB\e\fR で始まるエスケープシーケンスを使用できます。書式に含まれる変換指定とエスケープ以外の文字はそのまま出力します。
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB変換指定\fR
.RS 4
.sp
変換指定はパーセント記号 (\fB%\fR) から始まります。
.sp
\fB%%\fR 以外の変換指定は、対応する値をとります。変換指定は、値を特定の形式に整形して出力します。変換指定と値は与えられた順番に対応付けられます。値が余った場合は、全ての値を処理し終わるまで書式の整形・出力を繰り返します。値が足りない場合は、空文字列 (文字列に関する変換指定の場合) または 0 (数値に関する変換指定の場合) を仮定します。値が一つも与えられていない場合は、書式は一度だけ出力されます。
.sp
利用可能な変換指定は以下の通りです。
.PP
\fB%d\fR, \fB%i\fR
.RS 4
整数の値を (符号付き) 十進整数として出力します。
.RE
.PP
\fB%u\fR
.RS 4
整数の値を (符号なし) 十進非負整数として出力します。
.RE
.PP
\fB%o\fR
.RS 4
整数の値を (符号なし) 八進非負整数として出力します。
.RE
.PP
\fB%x\fR
.RS 4
整数の値を小文字の (符号なし) 十六進非負整数として出力します。
.RE
.PP
\fB%X\fR
.RS 4
整数の値を大文字の (符号なし) 十六進非負整数として出力します。
.RE
.PP
\fB%f\fR
.RS 4
実数の値を小文字の (符号付き) 小数として出力します。
.RE
.PP
\fB%F\fR
.RS 4
実数の値を大文字の (符号付き) 小数として出力します。
.RE
.PP
\fB%e\fR
.RS 4
実数の値を小文字の (符号付き) 指数表記小数で出力します。
.RE
.PP
\fB%E\fR
.RS 4
実数の値を大文字の (符号付き) 指数表記小数で出力します。
.RE
.PP
\fB%g\fR
.RS 4
値の大きさや精度に応じて
\fB%f\fR
と
\fB%e\fR
のどちらかの形式で出力します。
.RE
.PP
\fB%G\fR
.RS 4
値の大きさや精度に応じて
\fB%F\fR
と
\fB%E\fR
のどちらかの形式で出力します。
.RE
.PP
\fB%c\fR
.RS 4
文字列の値の最初の文字を出力します。
.RE
.PP
\fB%s\fR
.RS 4
文字列の値をそのまま出力します。
.RE
.PP
\fB%b\fR
.RS 4
文字列の値を、エスケープシーケンスを解釈しながら出力します。ここで使えるエスケープシーケンスは
echo コマンドで使えるエスケープシーケンスと同じです。
.RE
.PP
\fB%%\fR
.RS 4
パーセント記号 (\fB%\fR) を出力します。
.RE
.sp
\fB%g\fR と \fB%G\fR では、小数の指数部が \-5 以上精度以下の時に \fB%f\fR または \fB%F\fR を、それ以外の時に \fB%e\fR または \fB%E\fR を使用します。
.sp
\fB%%\fR 以外の変換指定では、最初の \fB%\fR の直後に変換指定フラグ・フィールド幅・精度をこの順で指定できます。これらを指定することで出力の形式を細かく調整できます。
.sp
指定できる変換指定フラグは以下の通りです。フラグを複数指定しても構いません。
.PP
マイナス (\fB\-\fR)
.RS 4
このフラグを指定すると、指定したフィールド幅の中で値を左に寄せて出力します。このフラグを指定しない場合、値は右に寄ります。
.RE
.PP
プラス (\fB+\fR)
.RS 4
数値の符号 (正号または負号) を必ず出力します。
.RE
.PP
空白文字 (\fB \fR)
.RS 4
出力する数値に符号 (正号または負号) が付かない場合は、符号の代わりに空白文字を出力します。
.RE
.PP
\fB#\fR
.RS 4
値を別形式で出力します。 変換指定が
\fB%o\fR
の場合、出力する八進数の先頭に必ず一桁以上の 0 が付くように、必要に応じて 0 を付加します。 変換指定が
\fB%x\fR
(または
\fB%X\fR) の場合、値が 0 でなければ数値の先頭に
\fB0x\fR
(または
\fB0X\fR) を付加します。 変換指定が
\fB%e\fR,
\fB%E\fR,
\fB%f\fR,
\fB%F\fR,
\fB%g\fR,
\fB%G\fR
の場合、小数点の後に数字がない場合でも小数点を省略しないようにします。また変換指定が
\fB%g\fR,
\fB%G\fR
の場合、小数点の後に 0 以外の数字がない場合でも 0 を省略しないようにします。
.RE
.PP
ゼロ (\fB0\fR)
.RS 4
変換指定が
\fB%d\fR,
\fB%i\fR,
\fB%u\fR,
\fB%o\fR,
\fB%x\fR,
\fB%X\fR,
\fB%e\fR,
\fB%E\fR,
\fB%f\fR,
\fB%F\fR,
\fB%g\fR,
\fB%G\fR
の場合、出力が指定したフィールド幅いっぱいになるまで数値の先頭に 0 を付加します。
.sp
マイナスフラグが指定されている場合、このフラグは無視されます。
.sp
変換指定が
\fB%d\fR,
\fB%i\fR,
\fB%u\fR,
\fB%o\fR,
\fB%x\fR,
\fB%X\fR
で、精度が指定されている場合、このフラグは無視されます。
.RE
.sp
フィールド幅は、先頭に 0 の付かない十進整数の形で指定します。
.sp
フィールド幅は出力の最低バイト数を指示します。出力のバイト数がフィールド幅に満たないときは、バイト数がフィールド幅に一致するまで空白文字を付加します。
.sp
精度は、ピリオド (\fB\&.\fR) の直後に十進整数を置いたものの形で指定します。ピリオドの後に整数がなければ、0 が指定してあるものとみなします。
.sp
変換指定が \fB%d\fR, \fB%i\fR, \fB%u\fR, \fB%o\fR, \fB%x\fR, \fB%X\fR の場合、精度は出力の最低桁数を指示します。数値が最低桁数に満たない場合は最低桁数に達するまで先頭に 0 を付加します。精度が指定されていない場合、精度は 1 とみなします。
.sp
変換指定が \fB%e\fR, \fB%E\fR, \fB%f\fR, \fB%F\fR の場合、精度は小数点以降の桁数を指示します。精度が指定されていない場合、精度は 6 とみなします。
.sp
変換指定が \fB%g\fR, \fB%G\fR の場合、精度は数値の最大有効桁数を指示します。精度が指定されていない場合、精度は 6 とみなします。
.sp
変換指定が \fB%s\fR, \fB%b\fR の場合、精度は出力する文字列の最大バイト数を指示します。精度が指定されていない場合、精度は無限大とみなします。
.sp
変換指定 \fB%f\fR にゼロフラグを指定し、フィールド幅に 8、精度に 3 を指定する場合、最終的な変換指定は \fB%08\&.3f\fR となります。この変換指定に対して値 12\&.34 を与えると、出力は \fB0012\&.340\fR となります。
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBエスケープシーケンス\fR
.RS 4
.sp
書式の中で使えるエスケープシーケンスは以下の通りです。
.PP
\fB\ea\fR
.RS 4
ベル文字 (ASCII コード番号 7)
.RE
.PP
\fB\eb\fR
.RS 4
バックスペース (ASCII コード番号 8)
.RE
.PP
\fB\ef\fR
.RS 4
フォームフィード (ASCII コード番号 12)
.RE
.PP
\fB\en\fR
.RS 4
改行文字 (ASCII コード番号 10)
.RE
.PP
\fB\er\fR
.RS 4
復帰文字 (ASCII コード番号 13)
.RE
.PP
\fB\et\fR
.RS 4
水平タブ (ASCII コード番号 9)
.RE
.PP
\fB\ev\fR
.RS 4
垂直タブ (ASCII コード番号 11)
.RE
.PP
\fB\e\e\fR
.RS 4
バックスラッシュ
.RE
.PP
\fB\e"\fR
.RS 4
二重引用符
.RE
.PP
\fB\e\*(Aq\fR
.RS 4
一重引用符 (アポストロフィー)
.RE
.PP
\fB\e\fR\fB\fIxxx\fR\fR
.RS 4
八進数
\fIxxx\fR
(最大三桁) で表わされるコード番号の文字
.RE
.RE
.SS "オペランド"
.PP
\fI書式\fR
.RS 4
出力する文字列の書式です。
.RE
.PP
\fI値\fR
.RS 4
変換指定が出力する値 (数値または文字列) です。
.sp
数値を値として指定する際、一重または二重引用符の後に何か文字を置いたものを指定することで、その文字のコード番号を数値として指定できます。例えば
\fB3\fR
という文字のコード番号が 51 ならば、
\fBprintf \*(Aq%d\*(Aq \*(Aq"3\*(Aq\fR
は
\fB51\fR
を出力します。
.RE
.SS "終了ステータス"
.sp
エラーがない限り printf コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
POSIX では、マルチバイト文字の扱いについて厳密に定義していません。\fB%s\fR 変換指定で精度を指定した場合や、\fB%c\fR 変換指定を使用する場合、値にマルチバイト文字が含まれていると適切な出力が得られないかもしれません。Yash では、マルチバイト文字は全てワイド文字に変換してから処理するので、マルチバイト文字の一部のバイトだけが出力されるようなことはありません。
.SH "PUSHD 組込みコマンド"
.sp
\fIPushd 組込みコマンド\fRはディレクトリスタックにディレクトリを追加し、シェルの作業ディレクトリをそのディレクトリに変更します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBpushd [\-L|\-P] [\fR\fB\fIディレクトリ\fR\fR\fB]\fR
.RE
.SS "説明"
.sp
Pushd コマンドは cd コマンドと同様に、シェルの作業ディレクトリをオペランドで指定したディレクトリに変更します。作業ディレクトリの変更に成功すると、新しい作業ディレクトリをディレクトリスタックに追加します。
.SS "オプション"
.sp
Cd コマンドで使えるオプションに加えて以下のオプションが pushd コマンドで使えます。
.PP
\fB\-\-remove\-duplicates\fR
.RS 4
新しい作業ディレクトリが既にディレクトリスタックに入っている場合は、元々入っていた要素を削除して重複をなくします。
.RE
.SS "オペランド"
.PP
\fIディレクトリ\fR
.RS 4
新しい作業ディレクトリのパス名です。絶対パスまたは元の作業ディレクトリからの相対パスで指定します。
.sp
この値がハイフン一つ (\fB\-\fR) の場合、\fBOLDPWD\fR 変数の値が指定されたものとみなします。
.sp
この値が符号付き整数の場合、その整数をディレクトリスタックの要素のインデックスとみなして、その要素が表すディレクトリが指定されたものとみなします (指定された要素はディレクトリスタックから削除されます)。
.sp
このオペランドが与えられていない場合、インデックス
\fB+1\fR
が指定されたものとみなします (\fB\-\-default\-directory\fR
オプションを指定した場合を除く)。
.RE
.SS "終了ステータス"
.sp
作業ディレクトリを正しく変更しディレクトリスタックに追加できた場合、終了ステータスは 0 です。エラーがあると終了ステータスは非 0 です。
.SS "補足"
.sp
POSIX には pushd コマンドに関する規定はありません。
.SH "PWD 組込みコマンド"
.sp
\fIPwd 組込みコマンド\fRはシェルの現在の作業ディレクトリを表示します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBpwd [\-L|\-P]\fR
.RE
.SS "説明"
.sp
Pwd コマンドはシェルの現在の作業ディレクトリを絶対パスで標準出力に出力します。
.SS "オプション"
.PP
\fB\-L\fR, \fB\-\-logical\fR
.RS 4
\fBPWD\fR 変数の値が現在の作業ディレクトリの絶対パスで、中に
\fB\&.\fR
や
\fB\&.\&.\fR
を含んでいなければ、それを出力します。それ以外の場合は
\fB\-P\fR
を指定した場合と同様に出力します。
.RE
.PP
\fB\-P\fR, \fB\-\-physical\fR
.RS 4
現在の作業ディレクトリの絶対パスを、中にシンボリックリンクを含まないかたちで出力します。
.RE
.sp
\fB\-L\fR (\fB\-\-logical\fR) オプションと \fB\-P\fR (\fB\-\-physical\fR) オプションの両方を指定した場合、後に指定したほうを優先します。どちらも指定していない場合は、\fB\-L\fR を指定したものとみなします。
.SS "終了ステータス"
.sp
エラーがない限り pwd コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
Pwd コマンドは準特殊組込みコマンドです。
.SH "READ 組込みコマンド"
.sp
\fIRead 組込みコマンド\fRは標準入力から行を読み込み変数に代入します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBread [\-Ar] \fR\fB\fI変数名\fR\fR\fB\&...\fR
.RE
.SS "説明"
.sp
Read コマンドは標準入力から一行の文字列を読み込み、それを変数に代入します。シェルが対話モードで、行編集を利用するオプションが有効ならば、読み込みに行編集を使用します。
.sp
\fB\-r\fR (\fB\-\-raw\-mode\fR) オプションを付けると、行内のバックスラッシュは通常の文字と同様に扱われます。
.sp
\fB\-r\fR (\fB\-\-raw\-mode\fR) オプションを付けない場合、読み込んだ文字列の中のバックスラッシュ (\fB\e\fR) は引用符として働きます。バックスラッシュが行末にあるときは行の連結を行います。対話モードのシェルが 2 行目以降を読み込むとき、標準入力が端末ならば \fBPS2\fR 変数の値がプロンプトとして出力されます。
.sp
読み込んだ文字列は、単語分割によって分割します。分割後の各文字列が、それぞれオペランドで指定された変数の値に順に設定されます。指定された変数の数より分割結果のほうが多い場合は、最後の変数に残りの分割結果の全てが入ります。分割結果の数より指定された変数のほうが多い場合は、余った変数には空文字列が入ります。
.SS "オプション"
.PP
\fB\-A\fR, \fB\-\-array\fR
.RS 4
最後に指定した変数を配列にします。分割後の各文字列が配列の要素として設定されます。
.RE
.PP
\fB\-r\fR, \fB\-\-raw\-mode\fR
.RS 4
読み込んだ文字列の中のバックスラッシュを引用符として扱わないようにします。
.RE
.SS "オペランド"
.PP
\fI変数名\fR
.RS 4
読み込んだ文字列を格納する変数の名前です。
.RE
.SS "終了ステータス"
.sp
エラーがない限り read コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
Read コマンドは準特殊組込みコマンドです。
.sp
POSIX には \fB\-A\fR (\fB\-\-array\fR) オプションに関する規定はありません。よってこのオプションは POSIX 準拠モードでは使えません。
.SH "READONLY 組込みコマンド"
.sp
\fIReadonly 組込みコマンド\fRは読み取り専用の変数または関数を表示・設定します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBreadonly [\-pxX] [\fR\fB\fI変数\fR\fR\fB[=\fR\fB\fI値\fR\fR\fB]\&...]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBreadonly \-f[p] [\fR\fB\fI変数\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
Readonly コマンドは typeset コマンドに \fB\-gr\fR オプションを付けたものと同じです。その他オプション・オペランド・終了ステータスは typeset コマンドと同様です。
.SS "補足"
.sp
readonly コマンドは特殊組込みコマンドです。
.sp
POSIX には readonly コマンドに関する規定はありますが、オプションは \fB\-p\fR しか規定がありません。その他のオプションは POSIX 準拠モードでは使えません。また POSIX は \fB\-p\fR オプションをオペランドとともに使うことを認めていません。
.SH "RETURN 組込みコマンド"
.sp
\fIReturn 組込みコマンド\fRは現在実行中の関数またはスクリプトの実行を終了します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBreturn [\-n] [\fR\fB\fI終了ステータス\fR\fR\fB]\fR
.RE
.SS "説明"
.sp
\fB\-n\fR (\fB\-\-no\-return\fR) オプションを付けずに return コマンドを実行すると、以下のうち当てはまる動作を行います:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
関数の実行中の場合は、その関数の実行を終了します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
ドットコマンドでファイルを開いてコマンドを実行している途中の場合は、そのファイルの読み込み・実行を終了します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
Eval コマンドでコマンドを実行している途中の場合は、そのコマンドの実行を終了します。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
これ以外の場合は、(対話モードのときを除いて) シェルは終了します。
.RE
.sp
\fB\-n\fR (\fB\-\-no\-return\fR) オプションを付けて return コマンドを実行すると、return コマンドはただ単にオペランドで指定されている終了ステータスを返します。
.SS "オプション"
.PP
\fB\-n\fR, \fB\-\-no\-return\fR
.RS 4
コマンドの実行を中断しません。
.RE
.SS "オペランド"
.PP
\fI終了ステータス\fR
.RS 4
Return コマンドの終了ステータスを指定する 0 以上の自然数です。
.sp
このオペランドが与えられていない場合は、return コマンドの直前に実行されたコマンドの終了ステータスを用います (ただしトラップを実行中の場合はトラップに入る直前のコマンドの終了ステータス)。
.RE
.SS "終了ステータス"
.sp
Return コマンドの終了ステータスはオペランドで与えられた値です。Return コマンドの終了ステータスは return コマンドが終了する関数・ドットコマンド・eval コマンド・シェル自身の終了ステータスにもなります。
.SS "補足"
.sp
Return コマンドは特殊組込みコマンドです。
.sp
POSIX では、\fI終了ステータス\fRの値は 0 以上 256 未満でなければならないとしています。Yash では拡張として 256 以上の値も受け付けるようになっています。
.sp
POSIX では関数あるいはドットコマンドの実行中以外における return コマンドの動作を定めていません。
.sp
POSIX には \fB\-n\fR (\fB\-\-no\-return\fR) オプションに関する規定はありません。よってこのオプションは POSIX 準拠モードでは使えません。
.SH "SET 組込みコマンド"
.sp
\fISet 組込みコマンド\fRはシェルのオプションの設定と位置パラメータの変更を行います。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBset [\fR\fB\fIオプション\fR\fR\fB\&...] [\fR\fB\fIオペランド\fR\fR\fB\&...]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBset \-o\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBset +o\fR
.RE
.sp
Set コマンドでは、POSIX 準拠モードであるかどうかにかかわらずオプションはオペランドより先に全て指定しなければなりません。最初のオペランドより後にあるコマンドライン引数は全てオペランドとして解釈します。
.SS "説明"
.sp
コマンドライン引数を一切与えずに set コマンドを実行すると、現在シェルに設定されている全ての変数の一覧をアルファベット順で (コマンドとして解釈可能な形式で) 標準出力に出力します。
.sp
\fB\-o\fR を唯一のコマンドライン引数として与えた場合は現在のシェルのオプション設定を一覧にして標準出力に出力します。\fB+o\fR を唯一のコマンドライン引数として与えた場合も同様ですが、この場合はコマンドとして解釈可能な形式で出力します。
.sp
これ以外の場合は、set コマンドは以下のようにシェルのオプションの設定と位置パラメータの変更のどちらかまたは両方の動作を行います。
.SS "オプション"
.sp
オプションが一つ以上与えられている場合、set コマンドはそれらの有効・無効を切り替えます。通常の形式でオプションを与えると、そのオプションは有効になります。オプションの先頭のハイフン (\fB\-\fR) の代わりにプラス (\fB+\fR) を付けて指定すると、そのオプションは無効になります。例えば \fB\-m\fR や \fB\-o monitor\fR や \fB\-\-monitor\fR はシェルのジョブ制御を有効にし、逆に \fB+m\fR や \fB+o monitor\fR や \fB++monitor\fR はジョブ制御を無効にします。
.sp
長いオプションの名前に含まれる英数字以外の文字は無視され、大文字と小文字の区別はありません。例えば \fB\-\-Le\-Comp\-Debug\fR は \fB\-\-lecompdebug\fR に同じです。また長いオプションの名前の先頭に \fBno\fR を付けることで、オプションの有効・無効を逆転することができます。例えば \fB\-\-noallexport\fR は \fB++allexport\fR に同じく、また \fB++nonotify\fR は \fB\-\-notify\fR に同じです。
.sp
オプションは以下に挙げる形式で指定することができます:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
長いオプション (例:
\fB\-\-allexport\fR)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
引数としてオプション名を指定した
\fB\-o\fR
オプション (例:
\fB\-o allexport\fR)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
一文字のオプション (例:
\fB\-a\fR)
.RE
.sp
ただし全てのオプションが一文字のオプションで指定できるわけではありません。
.sp
利用可能なオプションは以下のとおりです:
.PP
all\-export (\fB\-a\fR)
.RS 4
このオプションが有効な時、変数に代入をするとその変数は自動的にエクスポート対象になります。
.RE
.PP
brace\-expand
.RS 4
このオプションはブレース展開を有効にします。
.RE
.PP
case\-glob
.RS 4
このオプションが有効な時、パス名展開におけるパターンマッチングは大文字と小文字を区別して行います。このオプションはシェルの起動時に最初から有効になっています。
.RE
.PP
clobber (\fB+C\fR)
.RS 4
このオプションを無効にすると、
\fB>\fR
演算子によるリダイレクトで既存のファイルを上書きすることはできなくなります。このオプションはシェルの起動時に最初から有効になっています。
.RE
.PP
cur\-async, cur\-bg, cur\-stop
.RS 4
これらのオプションは現在のジョブの選択の仕方に影響します。(ジョブ ID
参照)。これらのオプションはシェルの起動時に最初から有効になっています。
.RE
.PP
dot\-glob
.RS 4
このオプションが有効な時、パス名展開においてファイル名の先頭のピリオドを特別に扱いません。
.RE
.PP
emacs
.RS 4
このオプションは emacs 風行編集を有効にします。
.RE
.PP
err\-exit (\fB\-e\fR)
.RS 4
このオプションが有効な時、実行したパイプラインの終了ステータスが 0 でなければ、シェルは直ちに終了します。ただし、以下の場合を除きます。
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
そのコマンドが
if 文の分岐や
while/until 文のループ条件の判定に使われる場合
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
パイプラインの先頭に
\fB!\fR
が付いている場合
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
パイプラインがサブシェルグルーピング以外の単独の複合コマンドから構成される場合
.RE
.RE
.PP
exec (\fB+n\fR)
.RS 4
このオプションが無効な時、シェルはコマンドの解釈だけを行い、実際にはコマンドを実行しません。このオプションはシェルスクリプトの文法チェックをするのに便利です。このオプションはシェルの起動時に最初から有効になっています。対話モードでは、このオプションに関わらずコマンドは常に実行されます。
.RE
.PP
extended\-glob
.RS 4
このオプションはパス名展開における拡張機能を有効にします。
.RE
.PP
glob (\fB+f\fR)
.RS 4
このオプションが有効なときはシェルはパス名展開を行います。このオプションはシェルの起動時に最初から有効になっています。
.RE
.PP
hash\-on\-def (\fB\-h\fR)
.RS 4
このオプションが有効なとき関数を定義すると、直ちにその関数内で使われる各コマンドの
PATH 検索を行いコマンドのパス名を記憶します。
.RE
.PP
hist\-space
.RS 4
このオプションが有効な時は空白で始まる行はコマンド履歴に自動的に追加しません。
.RE
.PP
ignore\-eof
.RS 4
このオプションが有効な時、対話モードのシェルに EOF (入力の終わり) が入力されてもシェルはそれを無視してコマンドの読み込みを続けます。これにより、誤って Ctrl\-D を押してしまってもシェルは終了しなくなります。
.RE
.PP
le\-always\-rp, le\-comp\-debug, le\-conv\-meta, le\-no\-conv\-meta, le\-prompt\-sp, le\-visible\-bell
.RS 4
これらのオプションは行編集の動作に影響します。行編集のオプションを参照してください。
.RE
.PP
mark\-dirs
.RS 4
このオプションが有効な時、パス名展開の展開結果においてディレクトリを表すものの末尾にスラッシュを付けます。
.RE
.PP
monitor (\fB\-m\fR)
.RS 4
このオプションはジョブ制御を有効にします。シェルを対話モードで起動したときこのオプションは自動的に有効になります。
.RE
.PP
notify (\fB\-b\fR)
.RS 4
このオプションが有効な時は、バックグラウンドのジョブの実行状態が変化するとシェルは直ちにそれを標準エラーに報告します。このオプションは notifyle オプションより優先します。
.RE
.PP
notify\-le
.RS 4
このオプションは notify オプションとほぼ同じですが、行編集を行っている最中のみジョブの状態変化を報告します。
.RE
.PP
null\-glob
.RS 4
このオプションが有効な時、パス名展開でマッチするパス名がないとき元のパターンは残りません。
.RE
.PP
posixly\-correct
.RS 4
このオプションは
POSIX 準拠モードを有効にします。
.RE
.PP
trace\-all
.RS 4
このオプションは、補助コマンド実行中も
x-trace オプションを機能させるかどうかを指定します。補助コマンドとは、
\fBCOMMAND_NOT_FOUND_HANDLER\fR、
\fBPROMPT_COMMAND\fR、および
\fBYASH_AFTER_CD\fR
変数の値として定義され、特定のタイミングで解釈・実行されるコマンドです。 このオプションはシェルの起動時に最初から有効になっています。
.RE
.PP
unset (\fB+u\fR)
.RS 4
このオプションが有効な時、パラメータ展開で存在しない変数を展開するとエラーにはならず空文字列に展開されます。このオプションはシェルの起動時に最初から有効になっています。
.RE
.PP
verbose (\fB\-v\fR)
.RS 4
このオプションが有効な時、シェルは読み込んだコマンドをそのまま標準エラーに出力します。
.RE
.PP
vi
.RS 4
このオプションは vi 風行編集を有効にします。対話モードが有効で標準入力と標準エラーがともに端末ならばこのオプションはシェルの起動時に自動的に有効になります。
.RE
.PP
x\-trace (\fB\-x\fR)
.RS 4
このオプションが有効な時、コマンドを実行する前に展開の結果を標準エラーに出力します。この出力は、各行頭に
\fBPS4\fR 変数の値を展開した結果を付けて示されます。
Trace-all オプションも参照してください。
.RE
.SS "オペランド"
.sp
Set コマンドにオペランドが与えられている場合またはオプションとオペランドを区切るハイフン二つ (\fB\-\-\fR, コマンドの引数の構文参照) がコマンドライン引数に入っている場合は、現在の位置パラメータは削除され、与えられたオペランドがそれぞれ新しく位置パラメータになります。ハイフン二つが与えられていてかつオペランドがない場合は位置パラメータはなくなります。
.SS "終了ステータス"
.sp
オプションの指定が間違っている場合を除き、set コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
Set コマンドは特殊組込みコマンドです。
.sp
POSIX 規格に定義されているオプションは限られています。規格の定義では、
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-allexport\fR
などの長いオプションは使えません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
オプション名に
\fBno\fR
を付けてオプションを無効にすることはできません。
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
オプション名に大文字や英字でない記号は使えません。
.RE
.sp
規格に定義されているオプションは以下のとおりです:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-a\fR,
\fB\-o allexport\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-e\fR,
\fB\-o errexit\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-m\fR,
\fB\-o monitor\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-C\fR,
\fB\-o noclobber\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-n\fR,
\fB\-o noexec\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-f\fR,
\fB\-o noglob\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-b\fR,
\fB\-o notify\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-u\fR,
\fB\-o nounset\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-v\fR,
\fB\-o verbose\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-x\fR,
\fB\-o xtrace\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-h\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-o ignoreeof\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-o nolog\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-o vi\fR
.RE
.sp
POSIX ではこのほかに、関数定義をコマンド履歴に登録しないようにする \fB\-o nolog\fR オプションを規定していますが、yash はこれをサポートしていません。
.SH "SHIFT 組込みコマンド"
.sp
\fIShift 組込みコマンド\fRは位置パラメータのいくつかを削除します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBshift [\fR\fB\fI個数\fR\fR\fB]\fR
.RE
.SS "説明"
.sp
Shift コマンドは位置パラメータのうち最初のいくつかを削除します。削除するパラメータの数はオペランドで指定します。
.SS "オペランド"
.PP
\fI個数\fR
.RS 4
削除する位置パラメータの個数を指示する 0 以上の自然数です。
.sp
実際の位置パラメータの個数より大きい数を指定するとエラーになります。省略すると 1 を指定したものとみなします。
.RE
.SS "終了ステータス"
.sp
エラーがない限り shift コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
Shift コマンドは特殊組込みコマンドです。
.sp
位置パラメータの個数は特殊パラメータ \fB#\fR によって知ることができます。
.SH "SUSPEND 組込みコマンド"
.sp
\fISuspend 組込みコマンド\fRはシェルを停止 (サスペンド) します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBsuspend [\-f]\fR
.RE
.SS "説明"
.sp
Suspend コマンドはシェルプロセスが属するプロセスグループ内のすべてのプロセスに対して SIGSTOP シグナルを送信します。これにより、シグナルを送られた各プロセス (シェル自身を含む) は停止 (サスペンド) 状態になります。停止状態になったプロセスは SIGCONT シグナルを受信すると実行を再開します。
.sp
シェルが対話モードで、さらにシェルプロセスのプロセスグループ ID がセッションリーダーのプロセス ID に等しいときは、\fB\-f\fR (\fB\-\-force\fR) オプションを付けない限りシェルは警告を表示し、シグナルを送信しません。これはシェルが停止した後実行を再開させることができなくなってしまうのを未然に防ぐためです。
.SS "オプション"
.PP
\fB\-f\fR, \fB\-\-force\fR
.RS 4
警告を無視してシェルを停止します。
.RE
.SS "終了ステータス"
.sp
Suspend コマンドの終了ステータスは、SIGSTOP シグナルをシェルに正しく送信できたときは 0、それ以外なら非 0 です。
.SS "補足"
.sp
POSIX には suspend コマンドに関する規定はありません。
.SH "TEST 組込みコマンド"
.sp
\fITest 組込みコマンド\fRは引数で指定した内容の判定を行います。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBtest \fR\fB\fI判定式\fR\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB[ \fR\fB\fI判定式\fR\fR\fB ]\fR
.RE
.sp
Test コマンドはオプションとオペランドとを区別しません。コマンドライン引数は全て\fI判定式\fRとして解釈します。コマンドが \fB[\fR の名前で実行された時は、判定式の後に \fB]\fR が必要です。
.SS "説明"
.sp
Test コマンドは引数で与えられた\fI判定式\fRを評価し、結果が真ならば 0 の終了ステータスを、偽ならば 1 の終了ステータスで終了します。判定式は何種類かの演算子とそれに対する被演算子とからなります。
.sp
ファイルに関する判定を行う単項演算子は以下の通りです。指定したファイルがシンボリックリンクの場合、そのシンボリックリンクが指している先のファイルについて判定を行います (\fB\-h\fR, \fB\-L\fR 演算子を除く)。
.PP
\fB\-b \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRがブロックスペシャルファイルかどうか
.RE
.PP
\fB\-c \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRがキャラクタスペシャルファイルかどうか
.RE
.PP
\fB\-d \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRがディレクトリかどうか
.RE
.PP
\fB\-e \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRが存在するかどうか
.RE
.PP
\fB\-f \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRが通常のファイルかどうか
.RE
.PP
\fB\-G \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRのグループ ID がシェルの実効グループ ID に等しいかどうか
.RE
.PP
\fB\-g \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRの set\-group\-ID ビットが設定されているかどうか
.RE
.PP
\fB\-h \fR\fB\fIファイル\fR\fR
.RS 4
\fB\-L \fR\fB\fIファイル\fR\fR
に同じ
.RE
.PP
\fB\-k \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRの sticky ビットが設定されているかどうか
.RE
.PP
\fB\-L \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRがシンボリックリンクかどうか
.RE
.PP
\fB\-N \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRの最終変更日時が最終アクセス日時より後かどうか
.RE
.PP
\fB\-O \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRのユーザ ID がシェルの実効ユーザ ID に等しいかどうか
.RE
.PP
\fB\-p \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRが FIFO (名前付きパイプ) かどうか
.RE
.PP
\fB\-r \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRが読み込み可能かどうか
.RE
.PP
\fB\-S \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRがソケットかどうか
.RE
.PP
\fB\-s \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRサイズが空でないかどうか
.RE
.PP
\fB\-u \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRの set\-user\-ID ビットが設定されているかどうか
.RE
.PP
\fB\-w \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRが書き込み可能かどうか
.RE
.PP
\fB\-x \fR\fB\fIファイル\fR\fR
.RS 4
\fIファイル\fRが実行可能かどうか
.RE
.sp
ファイル記述子に関する判定を行う単項演算子は以下の通りです。
.PP
\fB\-t \fR\fB\fIファイル記述子\fR\fR
.RS 4
\fIファイル記述子\fRが端末かどうか (ファイル記述子は 0 以上の自然数で指定します)
.RE
.sp
文字列に関する判定を行う単項演算子は以下の通りです。
.PP
\fB\-n \fR\fB\fI文字列\fR\fR
.RS 4
文字列が空文字列でないかどうか
.RE
.PP
\fB\-z \fR\fB\fI文字列\fR\fR
.RS 4
文字列が空文字列かどうか
.RE
.sp
シェルのオプションに関する判定を行う単項演算子は以下の通りです。
.PP
\fB\-o ?\fR\fB\fIオプション\fR\fR
.RS 4
\fIオプション\fRが正しいオプション名であるかどうか
.RE
.PP
\fB\-o \fR\fB\fIオプション\fR\fR
.RS 4
\fIオプション\fRが正しいオプション名であり、かつオプションが有効に設定されているかどうか
.RE
.sp
ファイルに関する判定を行う二項演算子は以下の通りです (存在しないファイルは他のファイルより古いとみなします)。
.PP
\fB\fIファイル1\fR\fR\fB \-nt \fR\fB\fIファイル2\fR\fR
.RS 4
\fIファイル1\fRの更新時刻が\fIファイル2\fRより新しいかどうか
.RE
.PP
\fB\fIファイル1\fR\fR\fB \-ot \fR\fB\fIファイル2\fR\fR
.RS 4
\fIファイル1\fRの更新時刻が\fIファイル2\fRより古いかどうか
.RE
.PP
\fB\fIファイル1\fR\fR\fB \-ef \fR\fB\fIファイル2\fR\fR
.RS 4
二つのファイルが互いのハードリンクであるかどうか
.RE
.sp
文字列に関する判定を行う二項演算子は以下の通りです。
.PP
\fB\fI文字列1\fR\fR\fB = \fR\fB\fI文字列2\fR\fR
.RS 4
二つの文字列が同じかどうか
.RE
.PP
\fB\fI文字列1\fR\fR\fB != \fR\fB\fI文字列2\fR\fR
.RS 4
二つの文字列が異なるかどうか
.RE
.sp
以下の二項演算子は現在のロケールの辞書式順序に従って文字列を比較します。
.PP
\fB\fI文字列1\fR\fR\fB === \fR\fB\fI文字列2\fR\fR
.RS 4
二つの文字列が同じかどうか
.RE
.PP
\fB\fI文字列1\fR\fR\fB !== \fR\fB\fI文字列2\fR\fR
.RS 4
二つの文字列が異なるかどうか
.RE
.PP
\fB\fI文字列1\fR\fR\fB < \fR\fB\fI文字列2\fR\fR
.RS 4
\fI文字列1\fR
が
\fI文字列2\fR
よりも順序が手前かどうか
.RE
.PP
\fB\fI文字列1\fR\fR\fB <= \fR\fB\fI文字列2\fR\fR
.RS 4
\fI文字列1\fR
が
\fI文字列2\fR
よりも順序が手前または同じかどうか
.RE
.PP
\fB\fI文字列1\fR\fR\fB > \fR\fB\fI文字列2\fR\fR
.RS 4
\fI文字列1\fR
が
\fI文字列2\fR
よりも順序が後かどうか
.RE
.PP
\fB\fI文字列1\fR\fR\fB >= \fR\fB\fI文字列2\fR\fR
.RS 4
\fI文字列1\fR
が
\fI文字列2\fR
よりも順序が後または同じかどうか
.RE
.sp
パターンマッチングを行う二項演算子は以下の通りです。
.PP
\fB\fI文字列\fR\fR\fB =~ \fR\fB\fIパターン\fR\fR
.RS 4
拡張正規表現\fIパターン\fRが\fI文字列\fRにマッチするかどうか
.RE
.sp
整数に関する判定を行う二項演算子は以下の通りです。
.PP
\fB\fIv1\fR\fR\fB \-eq \fR\fB\fIv2\fR\fR
.RS 4
\fIv1\fR
と
\fIv2\fR
が等しいかどうか
.RE
.PP
\fB\fIv1\fR\fR\fB \-ne \fR\fB\fIv2\fR\fR
.RS 4
\fIv1\fR
と
\fIv2\fR
が異なるかどうか
.RE
.PP
\fB\fIv1\fR\fR\fB \-gt \fR\fB\fIv2\fR\fR
.RS 4
\fIv1\fR
が
\fIv2\fR
よりも大きいかどうか
.RE
.PP
\fB\fIv1\fR\fR\fB \-ge \fR\fB\fIv2\fR\fR
.RS 4
\fIv1\fR
が
\fIv2\fR
以上かどうか
.RE
.PP
\fB\fIv1\fR\fR\fB \-lt \fR\fB\fIv2\fR\fR
.RS 4
\fIv1\fR
が
\fIv2\fR
よりも小さいかどうか
.RE
.PP
\fB\fIv1\fR\fR\fB \-le \fR\fB\fIv2\fR\fR
.RS 4
\fIv1\fR
が
\fIv2\fR
以下かどうか
.RE
.sp
バージョン番号を表す文字列に関する判定を行う二項演算子は以下の通りです。文字列のバージョン番号としての比較のしかたは後述します。
.PP
\fB\fIv1\fR\fR\fB \-veq \fR\fB\fIv2\fR\fR
.RS 4
\fIv1\fR
と
\fIv2\fR
が等しいかどうか
.RE
.PP
\fB\fIv1\fR\fR\fB \-vne \fR\fB\fIv2\fR\fR
.RS 4
\fIv1\fR
と
\fIv2\fR
が異なるかどうか
.RE
.PP
\fB\fIv1\fR\fR\fB \-vgt \fR\fB\fIv2\fR\fR
.RS 4
\fIv1\fR
が
\fIv2\fR
よりも大きいかどうか
.RE
.PP
\fB\fIv1\fR\fR\fB \-vge \fR\fB\fIv2\fR\fR
.RS 4
\fIv1\fR
が
\fIv2\fR
以上かどうか
.RE
.PP
\fB\fIv1\fR\fR\fB \-vlt \fR\fB\fIv2\fR\fR
.RS 4
\fIv1\fR
が
\fIv2\fR
よりも小さいかどうか
.RE
.PP
\fB\fIv1\fR\fR\fB \-vle \fR\fB\fIv2\fR\fR
.RS 4
\fIv1\fR
が
\fIv2\fR
以下かどうか
.RE
.sp
他の判定式を組み合わせてより複雑な判定式を作る演算子は以下の通りです。
.PP
\fB! \fR\fB\fI判定式\fR\fR
.RS 4
\fI判定式\fRが偽かどうか (判定式の真偽を逆転します)
.RE
.PP
\fB( \fR\fB\fI判定式\fR\fR\fB )\fR
.RS 4
\fI判定式\fRが真かどうか (判定式の構文上の優先順位を高くします)
.RE
.PP
\fB\fI判定式1\fR\fR\fB \-a \fR\fB\fI判定式2\fR\fR
.RS 4
二つの判定式が両方とも真かどうか
.RE
.PP
\fB\fI判定式1\fR\fR\fB \-o \fR\fB\fI判定式2\fR\fR
.RS 4
二つの判定式の少なくとも片方が真かどうか
.RE
.sp
判定式が空の場合、結果は偽とみなします。判定式が (演算子の付いていない) 文字列一つの場合、その文字列が空文字列でないかどうかを判定します。
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fBバージョン番号の比較\fR
.RS 4
.sp
文字列のバージョン番号としての比較は、基本的には現在のロケール情報に従った辞書式順序で行います。ただし、連続する数字は一つの自然数として比較します。また数字とそれ以外の文字との比較では常に数字の方が大きいとみなします。
.sp
例えば、\fB0\&.1\&.2\-3\fR と \fB00\&.001\&.02\-3\fR は等しく、\fB0\&.2\&.1\fR と \fB0\&.10\&.0\fR とでは後者の方が大きいと判定されます。
.RE
.SS "終了ステータス"
.sp
Test コマンドの終了ステータスは、\fI判定式\fRの評価結果が真ならば 0、偽ならば 1 です。\fI判定式\fRの構文に誤りがある場合その他のエラーが発生したときは、終了ステータスは 2 です。
.SS "補足"
.sp
複雑な判定式は誤って解釈されることがあるので避けることをお勧めします。例えば \fB[ 1 \-eq 1 \-a \-t = 1 \-a ! foo ]\fR は \fB[ 1 \-eq 1 ] && [ \-t = 1 ] && ! [ foo ]\fR のようにコマンドを分けると式がより明確になります。
.sp
POSIX は、エラーが発生した場合の終了ステータスを 『2 以上』 と定めています。また POSIX には以下の演算子の規定はありません: \fB\-nt\fR, \fB\-ot\fR, \fB\-ef\fR, \fB==\fR, \fB===\fR, \fB!==\fR, \fB<\fR, \fB<=\fR, \fB>\fR, \fB>=\fR, \fB=~\fR, \fB\-veq\fR, \fB\-vne\fR, \fB\-vgt\fR, \fB\-vge\fR, \fB\-vlt\fR, \fB\-vle\fR。 POSIX に \fB\-o\fR の単項演算子としての規定はありません。
.SH "TIMES 組込みコマンド"
.sp
\fITimes 組込みコマンド\fRはシェルとシェルが起動したコマンドが消費した CPU 時間を表示します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBtimes\fR
.RE
.SS "説明"
.sp
Times コマンドはシェルプロセスとその子プロセスが消費した CPU 時間を標準出力に出力します。一行目にシェルプロセス自身がユーザモードおよびシステムモードで消費した CPU 時間をそれぞれ表示します。二行目にシェルの全ての子孫プロセス (親プロセスが wait していないものを除く) がユーザモードおよびシステムモードで消費した CPU 時間をそれぞれ表示します。
.SS "終了ステータス"
.sp
エラーがない限り times コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
Times コマンドは特殊組込みコマンドです。
.SH "TRAP 組込みコマンド"
.sp
\fITrap 組込みコマンド\fRはシェルがシグナルを受信したときの動作を設定します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBtrap\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBtrap \fR\fB\fI動作\fR\fR\fB \fR\fB\fIシグナル\fR\fR\fB\&...\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBtrap \fR\fB\fIシグナル番号\fR\fR\fB [\fR\fB\fIシグナル\fR\fR\fB\&...]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBtrap \-p [\fR\fB\fIシグナル\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
Trap コマンドはシェルプロセスがシグナルを受信したときの動作 (\fIトラップ\fR) を表示または設定します。
.sp
オペランドに\fI動作\fRと\fIシグナル\fRを指定して trap コマンドを実行すると、シェルが\fIシグナル\fRを受信した際に指定した\fI動作\fRを行うようになります。最初のオペランドが\fIシグナル番号\fRの場合、それと残りの\fIシグナル\fRに対する動作は、動作として \fB\-\fR が指定されたときと同様に標準の動作に設定されます。
.sp
\fB\-p\fR (\fB\-\-print\fR) オプションを指定した場合またはオペランドを一つも指定していない場合は、trap コマンドは現在のトラップの設定状況をコマンドとして解釈可能な形式で標準出力に出力します。\fIシグナル\fRが与えられているときはそのシグナルに関する設定を、与えられてないときは全ての設定を出力します。
.SS "オプション"
.PP
\fB\-p\fR, \fB\-\-print\fR
.RS 4
現在のトラップの設定を表示します。
.RE
.SS "オペランド"
.PP
\fI動作\fR
.RS 4
シグナルを受信した際の動作を指定します。\fI動作\fRがハイフン一つ (\fB\-\fR) ならば、シェルはシステムで規定された標準の動作を行います。\fI動作\fRが空文字列ならば、シェルはシグナルを無視します。それ以外の値を指定すると、シェルはこのオペランドをコマンドとみなして、シグナル受信時にこれを解釈・実行します (コマンドの実行中にシグナルを受信したときは、コマンドが終了した後にトラップを実行します)。
.RE
.PP
\fIシグナル\fR
.RS 4
動作の対象となるシグナルです。シグナルはシグナル番号とシグナル名のどちらかで指定します。
.sp
\fIシグナル\fRとして
\fB0\fR
または
\fBEXIT\fR
を指定すると、これはシェルの終了時に発生する仮想のシグナルを指定しているとみなします。この仮想のシグナルに対して設定された\fI動作\fRは、シェルが正常終了する直前に実行されます。
.RE
.PP
\fIシグナル番号\fR
.RS 4
\fIシグナル\fRと同様ですが、シグナルを番号で指定します。
.RE
.SS "終了ステータス"
.sp
トラップが正しく設定または表示されたときは終了ステータスは 0 です。エラーがあると終了ステータスは非 0 です。
.SS "補足"
.sp
Trap コマンドは特殊組込みコマンドです。
.sp
POSIX は、シグナル名は \fBINT\fR や \fBQUIT\fR のように最初の SIG を除いた形で指定しなければならないと規定しています。Yash では、拡張として SIG を付けた形でも指定できますし、シグナル名の大文字と小文字を区別しません (このような拡張は POSIX でも認められています)。
.SH "TRUE 組込みコマンド"
.sp
\fITrue 組込みコマンド\fRは何も行わずに 0 の終了ステータスで終了します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBtrue\fR
.RE
.SS "説明"
.sp
True コマンドは何も行いません。コマンドライン引数は一切無視します。
.SS "終了ステータス"
.sp
True コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
True コマンドは準特殊組込みコマンドです。
.sp
コロンコマンドは true コマンドと同様に何も行いませんが、true コマンドは準特殊組込みコマンドであるのに対しコロンコマンドは特殊組込みコマンドです。
.SH "TYPE 組込みコマンド"
.sp
\fIType 組込みコマンド\fRはコマンドの種類を特定します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBtype [\-abefkp] [\fR\fB\fIコマンド\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
Type コマンドは command コマンドに \fB\-V\fR オプションを付けたものと同じです。その他オプション・オペランド・終了ステータスは command コマンドと同じです。
.SS "補足"
.sp
POSIX では、type コマンドと command コマンドとの関係について規定していません。従って他のシェルの type コマンドは command コマンドに \fB\-V\fR オプションを付けたものとは異なる動作をすることがあります。また POSIX は type コマンドのオプションを規定していません。
.sp
POSIX 準拠モードでは少なくとも一つ\fIコマンド\fRを指定する必要があります。
.SH "TYPESET 組込みコマンド"
.sp
\fITypeset 組込みコマンド\fRは変数または関数を表示・設定します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBtypeset [\-gprxX] [\fR\fB\fI変数\fR\fR\fB[=\fR\fB\fI値\fR\fR\fB]\&...]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBtypeset \-f[pr] [\fR\fB\fI関数\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
\fB\-f\fR (\fB\-\-functions\fR) オプションを付けずに実行すると、typeset コマンドは変数を出力または設定します。\fB\-f\fR (\fB\-\-functions\fR) オプションを付けて実行すると、typeset コマンドは関数を出力または設定します。
.sp
\fB\-p\fR (\fB\-\-print\fR) オプションを付けて実行すると、typeset コマンドはオペランドで指定した変数または関数を標準出力に出力します。\fB\-p\fR (\fB\-\-print\fR) オプションを付けずに実行すると、typeset コマンドはオペランドで指定した変数または関数を設定します。オペランドを一つも与えずに実行すると、\fB\-p\fR (\fB\-\-print\fR) オプションの有無にかかわらず typeset コマンドは全ての変数または関数を出力します (このとき \fB\-g\fR (\fB\-\-global\fR) オプションがあれば本当にすべての変数を、そうでないときはローカル変数だけを出力します)。
.SS "オプション"
.PP
\fB\-f\fR, \fB\-\-functions\fR
.RS 4
変数ではなく関数を表示または設定します。
.RE
.PP
\fB\-g\fR, \fB\-\-global\fR
.RS 4
このオプションを指定すると、新しく変数を作成する場合その変数をグローバル変数とします。すなわち変数は関数の実行が終わっても残ります。このオプションを指定しない場合、設定する変数はローカル変数になります。
.sp
オペランドがない場合は、このオプションを指定していると全ての変数を出力します。このオプションを指定していないとローカル変数だけ出力します。
.RE
.PP
\fB\-p\fR, \fB\-\-print\fR
.RS 4
変数または関数の定義を (コマンドとして解釈可能な形式で) 出力します。
.RE
.PP
\fB\-r\fR, \fB\-\-readonly\fR
.RS 4
設定する変数・関数を\fI読み取り専用\fRにします。読み取り専用の変数・関数は、値を変更したり削除したりできなくなります。
.sp
変数・関数を出力する際は、読み取り専用の変数・関数だけ出力します。
.RE
.PP
\fB\-x\fR, \fB\-\-export\fR
.RS 4
設定する変数をエクスポート対象にします。
.sp
変数を出力する際は、エクスポート対象の変数だけ出力します。
.RE
.PP
\fB\-X\fR, \fB\-\-unexport\fR
.RS 4
設定する変数をエクスポート対象から外します。
.RE
.SS "オペランド"
.PP
\fI変数\fR
.RS 4
出力または設定する変数の名前です。
.sp
変数が既に存在する場合、変数の値は変わりません。存在しない変数を指定した場合、変数は存在するがその値は存在しない状態になります (このような変数はパラメータ展開では存在しない変数として扱います)。
.RE
.PP
\fI変数\fR=\fI値\fR
.RS 4
設定する変数の名前とその値です。
.sp
指定した\fI値\fRが変数の値として設定されます。この形式のオペランドでは、\fB\-p\fR
(\fB\-\-print\fR) オプションを指定したときでもこの変数は出力ではなく設定されます。
.RE
.PP
\fI関数\fR
.RS 4
出力または設定する関数の名前です。存在しない関数を指定することはできません。
.RE
.SS "終了ステータス"
.sp
エラーがない限り typeset コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
既にローカル変数が存在する場合、それを無視してグローバル変数を新しく作ることはできません (\fB\-g\fR (\fB\-\-global\fR) オプションを指定していても既存のローカル変数が再設定されます)。
.sp
POSIX には typeset コマンドに関する規定はありません。</p>
.sp
Export コマンドは typeset コマンドに \fB\-gx\fR オプションを付けたものと同じです。Readonly コマンドは typeset コマンドに \fB\-gr\fR オプションを付けたものと同じです。
.SH "ULIMIT 組込みコマンド"
.sp
\fIUlimit 組込みコマンド\fRはシェルプロセスのリソース制限を表示・設定します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBulimit \-a [\-H|\-S]\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBulimit [\-H|\-S] [\-efilnqrstuvx] [\fR\fB\fI値\fR\fR\fB]\fR
.RE
.SS "説明"
.sp
Ulimit コマンドはシェルプロセスのリソース制限値を表示または設定します。
.sp
\fB\-a\fR (\fB\-\-all\fR) オプションを付けて実行すると、ulimit コマンドは全ての種類のリソースについて現在の制限値を一覧形式で標準出力に出力します。\fB\-a\fR (\fB\-\-all\fR) オプションを付けないで実行すると、一種類のリソースについて制限値を表示または設定します。オペランドで\fI値\fRを指定している場合、その値に制限値を設定します。\fI値\fRを指定していない場合は現在の制限値を標準出力に出力します。表示・設定するリソースの種類はオプションで指定します。設定したリソースの制限値はシェルが起動する各コマンドに受け継がれます。
.sp
リソースの各種類について、\fIハードリミット\fRと\fIソフトリミット\fRの二種類の制限値があります。ソフトリミットがハードリミットを超えることはできません。またハードリミットを緩めるには専用の権限が必要です。
.sp
\fB\-H\fR (\fB\-\-hard\fR) オプションを指定している場合、ulimit コマンドはハードリミットを表示または設定します。\fB\-S\fR (\fB\-\-soft\fR) オプションを指定している場合、ulimit コマンドはソフトリミットを表示または設定します。どちらのオプションも指定してない場合、ulimit コマンドはソフトリミットのみを表示するかまたはハードリミットとソフトリミットの両方を設定します。
.SS "オプション"
.PP
\fB\-H\fR, \fB\-\-hard\fR
.RS 4
ハードリミットを表示または設定します。
.RE
.PP
\fB\-S\fR, \fB\-\-soft\fR
.RS 4
ソフトリミットを表示または設定します。
.RE
.PP
\fB\-a\fR, \fB\-\-all\fR
.RS 4
全種類のリソース制限値を表示します。
.RE
.sp
以下のオプションは表示・設定するリソースの種類を指定します。これらのオプションがどれも与えられていないときは、\fB\-f\fR が与えられたものとみなします。(表示・設定可能なリソースの種類はシステムによって異なります)
.PP
\fB\-c\fR, \fB\-\-core\fR
.RS 4
プロセスが強制終了させられたときにできるコアファイルのサイズの限界 (512 バイト単位)
.RE
.PP
\fB\-d\fR, \fB\-\-data\fR
.RS 4
プロセスが使用できるデータセグメント領域のサイズの限界 (キロバイト単位)
.RE
.PP
\fB\-e\fR, \fB\-\-nice\fR
.RS 4
スケジューリング優先度 (nice 値) の限界
.RE
.PP
\fB\-f\fR, \fB\-\-fsize\fR
.RS 4
プロセスが作成できるファイルのサイズの限界 (512 バイト単位)
.RE
.PP
\fB\-i\fR, \fB\-\-sigpending\fR
.RS 4
プロセスの処理待ちシグナルの個数の限界
.RE
.PP
\fB\-l\fR, \fB\-\-memlock\fR
.RS 4
RAM 上にロック可能なメモリサイズの限界 (キロバイト単位)
.RE
.PP
\fB\-m\fR, \fB\-\-rss\fR
.RS 4
プロセスの resident set (RAM 上に存在する仮想ページ) の数の限界 (キロバイト単位)
.RE
.PP
\fB\-n\fR, \fB\-\-nofile\fR
.RS 4
プロセスが使用できるファイル記述子の最大値 + 1
.RE
.PP
\fB\-q\fR, \fB\-\-msgqueue\fR
.RS 4
POSIX メッセージキューのサイズの限界
.RE
.PP
\fB\-r\fR, \fB\-\-rtprio\fR
.RS 4
リアルタイムスケジューリングの優先度の限界
.RE
.PP
\fB\-s\fR, \fB\-\-stack\fR
.RS 4
プロセスが使用できるスタック領域のサイズの限界 (キロバイト単位)
.RE
.PP
\fB\-t\fR, \fB\-\-cpu\fR
.RS 4
プロセスが使用できる CPU 時間の限界 (秒単位)
.RE
.PP
\fB\-u\fR, \fB\-\-nproc\fR
.RS 4
プロセスが起動できる子プロセスの個数の限界
.RE
.PP
\fB\-v\fR, \fB\-\-as\fR
.RS 4
プロセスが使用できるメモリ領域全体のサイズの限界 (キロバイト単位)
.RE
.PP
\fB\-x\fR, \fB\-\-locks\fR
.RS 4
プロセスがロックできるファイルの個数の限界
.RE
.SS "オペランド"
.PP
\fI値\fR
.RS 4
設定するリソース制限値です。
.sp
値は基本的に 0 以上の自然数で指定しますが、自然数の代わりに
\fBhard\fR、\fBsoft\fR、\fBunlimited\fR
のいずれかの文字列を指定することもできます。これらの文字列はそれぞれ現在のハードリミットの値、現在のソフトリミットの値、無制限を表します。
.RE
.SS "終了ステータス"
.sp
リソース制限値が正しく出力または設定できたときは、終了ステータスは 0 です。エラーがあると終了ステータスは非 0 です。
.SS "補足"
.sp
POSIX が規定しているオプションは \fB\-f\fR だけです。また POSIX はオペランドの\fI値\fRとして自然数しか規定していません。
.SH "UMASK 組込みコマンド"
.sp
\fIUmask 組込みコマンド\fRはシェルプロセスのファイルモード作成マスクを表示・設定します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBumask \fR\fB\fIマスク\fR\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBumask [\-S]\fR
.RE
.SS "説明"
.sp
オペランドが与えられていないとき、umask コマンドはシェルプロセスの現在のファイルモード作成マスクを標準出力に出力します。\fB\-S\fR (\fB\-\-symbolic\fR) オプションで出力の形式を指定できます。出力はオペランドとして再利用可能な形式になっています。
.sp
オペランドが与えられているとき、umask コマンドはシェルプロセスのファイルモード作成マスクを与えられたオペランドの値に設定します。
.SS "オプション"
.PP
\fB\-S\fR, \fB\-\-symbolic\fR
.RS 4
このオプションが指定されているときは、記号形式でファイルモード作成マスクを出力します。このオプションが指定されていないときは、数値形式で出力します。
.RE
.SS "オペランド"
.PP
\fIマスク\fR
.RS 4
このオペランドが与えられているときは、umask コマンドはファイルモード作成マスクをこの値に設定します。値は以下に述べる数値形式と記号形式のどちらかで与えます。
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB数値形式\fR
.RS 4
.sp
数値形式は 0 以上の八進整数でマスクを指定します。これは以下の各モードを表す自然数のいくつかの和です。
.PP
0400
.RS 4
ユーザの読み取り権限
.RE
.PP
0200
.RS 4
ユーザの書き込み権限
.RE
.PP
0100
.RS 4
ユーザの実行権限
.RE
.PP
0040
.RS 4
グループの読み取り権限
.RE
.PP
0020
.RS 4
グループの書き込み権限
.RE
.PP
0010
.RS 4
グループの実行権限
.RE
.PP
0004
.RS 4
その他の読み取り権限
.RE
.PP
0002
.RS 4
その他の書き込み権限
.RE
.PP
0001
.RS 4
その他の実行権限
.RE
.RE
.sp
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
\fB記号形式\fR
.RS 4
.sp
記号形式は以下のような書式の記号列でマスク\fBしない\fR権限を指定します。
.sp
記号列は一つ以上の\fI節\fRをカンマ (\fB,\fR) で区切ったものです。 \fI節\fRは\fI対象\fRの列と一つ以上の\fI動作\fRからなります。
.sp
\fI対象\fRには以下の記号をいくつでも指定できます。
.PP
\fBu\fR
.RS 4
ユーザ
.RE
.PP
\fBg\fR
.RS 4
グループ
.RE
.PP
\fBo\fR
.RS 4
その他
.RE
.PP
\fBa\fR
.RS 4
ユーザ・グループ・その他の全て
.RE
.sp
\fI対象\fRが一つも指定されていない場合は \fBa\fR が指定されているものとみなします。
.sp
\fI動作\fRは以下の\fI演算子\fRと\fI権限\fRの組み合わせです。 \fI演算子\fRは以下のどれかです。
.PP
\fB=\fR
.RS 4
\fI対象\fRに対する設定を\fI権限\fRにします。
.RE
.PP
\fB+\fR
.RS 4
\fI対象\fRに対する設定に\fI権限\fRを加えます。
.RE
.PP
\fB\-\fR
.RS 4
\fI対象\fRに対する設定から\fI権限\fRを除きます。
.RE
.sp
\fI権限\fRは以下のどれかです。
.PP
\fBr\fR
.RS 4
読み取り権限
.RE
.PP
\fBw\fR
.RS 4
書き込み権限
.RE
.PP
\fBx\fR
.RS 4
実行権限
.RE
.PP
\fBX\fR
.RS 4
実行権限 (元々実行権限が設定されていた場合のみ)
.RE
.PP
\fBs\fR
.RS 4
Set\-user\-ID, Set\-group\-ID
.RE
.PP
\fBu\fR
.RS 4
現在のユーザの値
.RE
.PP
\fBg\fR
.RS 4
現在のグループの値
.RE
.PP
\fBo\fR
.RS 4
現在のその他の値
.RE
.sp
\fBr\fR, \fBw\fR, \fBx\fR, \fBX\fR, \fBs\fR の記号同士は一度に組み合わせて指定できます。
.sp
例えば \fBumask u=rwx,go+r\-w\fR を実行すると、ユーザの読み取り権限と書き込み権限と実行権限をマスクしないようにし、グループとその他の読み取り権限をマスクしないようにし、グループとその他の書き込み権限をマスクするようにします。
.RE
.SS "終了ステータス"
.sp
ファイルモード作成マスクが正しく出力または設定できたときは、終了ステータスは 0 です。エラーがあると終了ステータスは非 0 です。
.SS "補足"
.sp
Ulimit コマンドは準特殊組込みコマンドです。
.sp
POSIX は \fB\-S\fR オプションを指定しなかった場合の出力形式が必ずしも数値形式であるとは規定していません。
.SH "UNALIAS 組込みコマンド"
.sp
\fIUnalias 組込みコマンド\fRはエイリアスを削除します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBunalias \fR\fB\fIエイリアス名\fR\fR\fB\&...\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBunalias \-a\fR
.RE
.SS "説明"
.sp
Unalias コマンドはオペランドで指定したエイリアスを削除します。
.SS "オプション"
.PP
\fB\-a\fR, \fB\-\-all\fR
.RS 4
全てのエイリアスを削除します。
.RE
.SS "オペランド"
.PP
\fIエイリアス名\fR
.RS 4
削除するエイリアスの名前です。
.RE
.SS "終了ステータス"
.sp
エラーがない限り unalias コマンドの終了ステータスは 0 です。存在しないエイリアスをオペランドで指定した場合はエラーになります。
.SS "補足"
.sp
Unalias コマンドは準特殊組込みコマンドです。
.SH "UNSET 組込みコマンド"
.sp
\fIUnset 組込みコマンド\fRは変数または関数を削除します。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBunset [\-fv] [\fR\fB\fI名前\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
Unset コマンドはオペランドで指定した名前の変数または関数を削除します。
.sp
元々存在しない変数・関数を削除しようとしても、何も起こりません (エラーにはなりません)。
.SS "オプション"
.PP
\fB\-f\fR, \fB\-\-functions\fR
.RS 4
関数を削除します。
.RE
.PP
\fB\-v\fR, \fB\-\-variables\fR
.RS 4
変数を削除します。
.RE
.sp
\fB\-f\fR (\fB\-\-functions\fR) オプションと \fB\-v\fR (\fB\-\-variables\fR) オプションの両方を指定した場合、後に指定したほうを優先します。どちらも指定していない場合は、\fB\-v\fR を指定したものとみなします。
.SS "オペランド"
.PP
\fI名前\fR
.RS 4
削除する変数または関数の名前です。
.RE
.SS "終了ステータス"
.sp
エラーがない限り unset コマンドの終了ステータスは 0 です。
.SS "補足"
.sp
Unset コマンドは特殊組込みコマンドです。
.sp
POSIX では、\fB\-f\fR と \fB\-v\fR のどちらのオプションも指定されていない場合、指定した名前の変数がない場合はかわりにその名前の関数を削除してよいと規定しています。
.sp
POSIX 準拠モードでは少なくとも一つ\fI名前\fRを指定する必要があります。
.SH "WAIT 組込みコマンド"
.sp
\fIWait 組込みコマンド\fRはバックグラウンドのジョブが終了するのを待ちます。
.SS "構文"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fBwait [\fR\fB\fIジョブ\fR\fR\fB\&...]\fR
.RE
.SS "説明"
.sp
Wait コマンドは実行中のバックグラウンドジョブが終了するのを待ちます。ジョブ制御が有効な時は、ジョブが停止したときも終了したとみなします。
.sp
Wait コマンドはジョブ制御が有効でないときでも非同期コマンドの終了を待つのに使えます。
.sp
Wait コマンドの実行中にシェルがシグナルを受信した場合、そのシグナルに対しトラップが設定してあればそのトラップを直ちに実行し wait コマンドはそのまま終了します。またジョブ制御が有効な場合、シェルが SIGINT シグナルを受信すると wait コマンドは中断されます。
.SS "オペランド"
.PP
\fIジョブ\fR
.RS 4
終了を待つジョブ・非同期コマンドのジョブ ID
またはプロセス ID です。
.RE
.sp
\fIジョブ\fRを何も指定しないとシェルが有する全てのジョブ・非同期コマンドの終了を待ちます。
.sp
存在しないジョブ・非同期コマンドを指定すると、終了ステータス 127 で既に終了したジョブをしたものとみなし、エラーにはしません。
.SS "終了ステータス"
.sp
\fIジョブ\fRが一つも与えられておらず、シェルが全てのジョブ・非同期コマンドの終了を正しく待つことができた場合、終了ステータスは 0 です。\fIジョブ\fRが一つ以上与えられているときは、最後の\fIジョブ\fRの終了ステータスが wait コマンドの終了ステータスになります。
.sp
Wait コマンドがシグナルによって中断された場合、終了ステータスはそのシグナルを表す 128 以上の整数です。その他の理由で wait コマンドがジョブの終了を正しく待つことができなかった場合、終了ステータスは 1 以上 126 以下です。
.SS "補足"
.sp
Wait コマンドは準特殊組込みコマンドです。
.sp
非同期コマンドのプロセス ID は非同期コマンドを実行した直後に特殊パラメータ \fB!\fR の値を見ることで知ることができます。ジョブ制御が有効なときは jobs コマンドでプロセス ID を調べることもできます。
.SH "著者"
.PP
\fB渡邊 裕貴[FAMILY Given]\fR <\&magicant@users\&.sourceforge\&.jp\&>
.RS 4
著者.
.RE