/usr/bin/dash: Difference between revisions

このセクションでは、別のプロセスでは実行できない何らかの操作を行う必要があるためにビルトインされているビルトインコマンドを列挙する。 これら以外にも、効率化のためにビルトインされるコマンドがいくつかある（例：'''[[/usr/bin/printf|printf]]''', '''[[/usr/bin/echo|echo]]''', '''[[/usr/bin/test|test]]''' など）。

:終了値0（真）を返すヌルコマンドである。

:指定されたファイル内のコマンドをシェルが読み込んで実行する。

:name=stringが指定された場合、シェルはエイリアス名を値文字列で定義する。 name だけが指定された場合，エイリアス名の値が表示される。 引数を指定しない場合，alias builtinは，定義されたすべてのエイリアスの名前と値を表示する（unaliasを参照）。

:指定されたジョブ（ジョブが指定されていない場合は現在のジョブ）をバックグラウンドで継続する。

:指定されたコマンドを実行するが、そのコマンドを検索する際にシェル関数を無視する。 (これは、組み込みコマンドと同じ名前のシェル関数がある場合に便利である)。

:PATH を使ってコマンドを検索し、すべての標準ユーティリティを見つけることが保証される。

:コマンドを実行せず、コマンドを検索し、コマンド検索の解答を表示する。 これはタイプビルトインと同じである。

:指定されたディレクトリに切り替える（デフォルトはHOME）。 cdコマンドの環境にCDPATHの項目があるか，シェル変数CDPATHが設定されていて，ディレクトリ名がスラッシュで始まらない場合，CDPATHに記載されているディレクトリを検索して，指定したディレクトリに移動する。 CDPATHの形式は，PATHの形式と同じである。 引数に単一のダッシュが指定された場合、それはOLDPWDの値に置き換えられる。 cdコマンドは，実際に切り替えたディレクトリの名前が，ユーザが与えた名前と異なる場合，その名前を出力する。 これらは、CDPATH機構が使用されたためか、引数がダッシュ1つであったためか、異なる可能性がある。 Pオプションは、物理的なディレクトリ構造を使用するようにする。つまり、すべてのシンボリックリンクはそれぞれの値に解決される。 Lオプションは、先行する-Pオプションの効果を無効にする。

:引数をスペースで区切って標準出力に出力する。 nオプションがない限り、引数の後に改行が出力される。

:出力中に以下の文字列のいずれかに遭遇した場合、その文字列は出力されない。 出力中に以下の文字列に遭遇した場合、その文字列は出力されず、代わりに指定された動作が実行される：

::\b      バックスペース文字が出力される。

::\c      その後の出力を抑制する。 通常、最後の引数の末尾で使用し、echo が出力するはずの末尾の改行を抑止する。

::\e      エスケープ文字(ESC)を出力する。

::\f      フォームフィードを出力する。

::\n      改行文字を出力する。

::\r     キャリッジリターンを出力する。

::\t      （横）タブ文字を出力する。

::\v     （縦）タブを出力する。

:::8進数0～3桁で与えられる値を持つ文字を出力する。 0桁の場合はnul文字が出力される。

::\\      バックスラッシュを出力する。

:それ以外のバックスラッシュの配列は、未定義の動作を引き起こす。

:すべての引数をスペースで連結する。 その後、コマンドを再パースして実行する。

:commandが省略されない限り、シェルプロセスは指定されたプログラム（これはシェルの組み込みや関数ではなく、実際のプログラムでなければならない）に置き換えられる。 execコマンドのリダイレクションは、execコマンドの終了時に元に戻らないように、永久的なものとしてマークされる。

:シェルプロセスを終了させる。 exitstatusが与えられた場合は、シェルの終了ステータスとして使用され、それ以外の場合は、直前のコマンドの終了ステータスが使用される。

:指定された名前は、後続のコマンドの環境に表示されるようにエクスポートされる。 変数のエクスポートを解除する唯一の方法は、変数の設定を解除することである。 シェルでは，次のように書くことで，変数のエクスポートと同時に変数の値を設定することができる。

:引数を指定しない場合、exportコマンドはエクスポートされたすべての変数名を一覧表示する。 pオプションを指定すると、出力は非対話的な使用のために適切にフォーマットされる。

:fcビルトインは、対話型シェルに過去に入力したコマンドを一覧表示したり、編集して再実行する。

::コマンドの編集には、editorで指定されたエディタを使用する。 エディタ文字列はコマンド名であり、PATH変数による検索の対象となる。 eが指定されない場合、FCEDIT変数の値がデフォルトとして使用される。 FCEDITがNULLまたは未設定の場合は、EDITOR変数の値が使用される。 EDITORがNULLまたは未設定の場合、エディタとして'''[[/usr/bin/ed|ed]]'''が使用される。

::コマンドに対してエディタを起動するのではなく、コマンドをリストアップする。 コマンドは，-rの影響を受けて，最初と最後のオペランドで示される順序で書かれ，各コマンドの前にはコマンド番号が付けられる．

:-n    -lでリストアップする際に、コマンド番号を表示しないようにする。

:-r    リストアップされたコマンド（-l付き）または編集されたコマンド（-lも-sもなし）の順序を逆にする。

:-s    エディタを起動せずにコマンドを再実行する。

:last  リストアップまたは編集するコマンドを選択する。 アクセスできる前のコマンドの数は、変数HISTSIZEの値によって決定される。 firstまたはlast、あるいはその両方の値は、次のいずれかである：

:::コマンド番号を表す正の数。コマンド番号は-lオプションで表示することができる。

:::何個か前に実行されたコマンドを表す負の10進数である。 例えば、-1 は直前のコマンドである。

::その文字列で始まる、最も最近入力されたコマンドを示す文字列である。 old=newオペランドが-sでも指定されない場合、最初のオペランドの文字列形式は、埋め込まれた等号を含むことはできない。

:以下の環境変数がfcの実行に影響を与える：

:FCEDIT    使用するエディターの名前。

:HISTSIZE  アクセス可能な過去のコマンドの数。

:指定されたジョブまたは現在のジョブをフォアグラウンドに移動させる。

:POSIXのgetoptsコマンドで、ベル研由来の'''[[/usr/bin/getopt|getopt]]'''と混同しないように。

:最初の引数は、一連の文字でなければならず、それぞれの文字には、オプションが引数を必要とすることを示すコロンがオプションとして続くことができる。 指定された変数は，解析されたオプションに設定される。

:getoptsコマンドは、空白を含む引数の扱いのため、古い'''[[/usr/bin/getopt|getopt]]'''ユーティリティを非推奨とする。

:getopts 組み込み関数を使って、パラメータのリストからオプションとその引数を取得することができる。 getoptsは，起動されると，リスト中のオプション文字列から次のオプションの値をvarで指定されるシェル変数に，そのインデックスをシェル変数OPTINDに置く。 シェルが起動されると、OPTINDは1に初期化される。 引数を必要とする各オプションについて、getopts 組み込み関数がシェル変数 OPTARG に配置する。 オプションがoptstringで許可されていない場合、OPTARGはアンセットされる。

:optstring は、認識されたオプション文字列である ('''[https://manpages.debian.org/bullseye/manpages-dev/getopt.3.en.html getopt]]'''(3) を参照)。 文字にコロンが続く場合、そのオプションは空白で区切られていてもいなくてもよい引数を持つことが期待される。 オプション文字が期待通りに見つからなかった場合、getopts は変数 var を "?" に設定する; 次に getopts は OPTARG をアンセットして標準エラーに出力を書き出す。 optstringの最初の文字にコロンを指定することで、すべてのエラーを無視することができる。

:最後のオプションの後、getoptsは0以外の値を返し、varに"?"をセットする。

:次のコードは、オプション<nowiki>[a]</nowiki>と<nowiki>[b]</nowiki>、および引数を必要とするオプション<nowiki>[c]</nowiki>を取ることができるコマンドの引数をどのように処理するかを示している。

:本コードは、以下のいずれかを等価として受け付ける：

:シェルは、コマンドの位置を記憶するハッシュテーブルを保持している。 引数なしで、hashコマンドはこのテーブルの内容をプリントアウトする。 最後にcdコマンドを実行してから一度も見ていない項目には、アスタリスクが付けられている。これらの項目が無効である可能性もある。

:引数を指定すると、hashコマンドは指定されたコマンドをハッシュテーブルから削除し（それが関数でない限り）、次にそれらの位置を特定する。 -vオプションをつけると、ハッシュは見つけたコマンドの位置を表示する。 -rオプションをつけると、hashコマンドはハッシュテーブルの関数を除くすべてのエントリーを削除する。

:内蔵コマンドは、毎回再計算するのではなく、カレントディレクトリが何であるかを記憶している。そのため、より高速に動作する。 しかし，カレントディレクトリの名前が変更された場合，pwdのビルトイン版はディレクトリの古い名前を表示しつづける． -Pオプションは、現在の作業ディレクトリの物理的な値を表示する、つまり、すべてのシンボリックリンクがそれぞれの値に解決されるようにする。 -Lオプションは，先行する-Pオプションの効果を無効にする．

:-pオプションが指定され，標準入力が端末である場合は，プロンプトが表示される。 次に，標準入力から1行が読み込まれる。 行末の改行が削除され，上記の単語分割の項で説明したように行が分割され，その断片が順番に変数に代入される。 少なくとも1つの変数が指定されなければならない。 駒が変数より多い場合は、残りの駒（駒を区切ったIFSの文字とともに）が最後の変数に代入される。 ピースより変数の方が多い場合は、残りの変数にヌル文字列が代入される。 入力で EOF に遭遇しない限り、read 組み込みは成功を示し、その場合は失敗が返される。

:デフォルトでは、-rオプションが指定されない限り、バックスラッシュ"˶"はエスケープ文字として機能し、次の文字を文字通りに処理する。 バックスラッシュの後に改行がある場合、バックスラッシュと改行は削除される。

:指定された名前は読み取り専用としてマークされ、その後に変更したり設定を解除したりすることはできない。 シェルは，変数の値を，それが読み取り専用にマークされると同時に設定することを，次のように書くことで可能にする。

:引数を指定しない場合、readonlyコマンドはすべての読み取り専用変数の名前を一覧表示する。 -pオプションを指定すると、出力は非対話的な使用に適した形式になる。

:printfは、フォーマットの制御の下、引数をフォーマットし、最初の引数の後に印刷する。 フォーマットは，3種類のオブジェクトを含む文字列である。すなわち，単に標準出力にコピーされるプレーン文字，変換されて標準出力にコピーされる文字エスケープシーケンス，およびフォーマット指定であり，その各々が次の連続する引数の印刷を引き起こす。

:第1引数以降の引数は，対応する形式がb，c，sのいずれかであれば文字列として扱われ，そうでなければC定数として評価され，次のように拡張される：

::•  先頭のプラスまたはマイナス記号は許容される。

::•  先頭の文字がシングルクォートまたはダブルクォートの場合、値は次の文字のASCIIコードとなる。

:書式文字列は，引数を満たすのに必要な回数だけ再利用される。 余分な書式指定は，0またはNULL文字列で評価される。

:文字エスケープシーケンスは、ANSI X3.159-1989（"ANSI C89"）で定義されているバックスラッシュ表記である。 文字とその意味は次の通りである：

::\a      <bell>のキャラクターを書く。

::\b      <backspace>文字を書く。

::\e      <escape>（ESC）文字を書く。

::\f      <form-feed>文字を書く。

::\n      <改行>文字を書く。

::\r      <carriage return>文字を書く。

::\t      <tab>文字を書く。

::\v      <垂直タブ>文字を書く。

::\\      バックスラッシュ文字を書き込む。

::\num    ASCII値が1桁、2桁、3桁の8進数numである8ビット文字を書く。

:各フォーマット指定は，パーセント文字(``%'')によって導入される。 フォーマット指定の残りは，次の順序で，以下を含む：

:以下のフラグのうち、0個以上を指定する：

::#      代替形式で表示されることを指定する `#' 文字を指定する。 b，c，d，sフォーマットでは，このオプションは何の効果もない。 oフォーマットでは，数値の精度を上げて，出力文字列の最初の文字をゼロにする。 x(エックス)フォーマットでは，0以外の結果には，文字列0x(0X)が先頭に付く。 e、E、f、g、G形式では、小数点以下の桁がない場合でも、結果には常に小数点が含まれる（通常、これらの形式の結果には、小数点以下の桁がある場合にのみ小数点が表示される）。 gおよびGフォーマットでは、末尾のゼロは、他の場合と同様に結果から取り除かれない。

::-      マイナス記号 `-' は、指定されたフィールドの出力を左に調整することを指定する；

::+      符号付き書式を使用する場合、数値の前に常に符号を置くことを指定する `+' 文字。

::' ’    符号付きフォーマットの場合、正の数の前に空白を残すことを指定する。 両方が使われている場合、`+'はスペースより優先される；

::0      '0'文字は、空白パディングではなく、ゼロパディングを使用することを示す。 両方が使用される場合、`-' は `0' に優先する；

::出力文字列の文字数がフィールド幅より少ない場合，フィールド幅を補うために左側（左調整インジケータが与えられている場合は右側）に空白パディングされる（先行ゼロはフラグであるが，埋め込まれたゼロはフィールド幅の一部であることに注意すること）；

::オプションのピリオド，'.'の後に，eおよびf形式の場合は小数点以下の桁数，bおよびs形式の場合は文字列から出力される最大バイト数を指定する精度を与えるオプションの数字文字列が続く；

::使用するフォーマットの種類を示す文字（diouxXfwEgGbcs のいずれか）である。

:フィールドの幅や精度は，数字文字列の代わりに'*'とすることもできる。 この場合，引数でフィールドの幅や精度を指定する。

:フォーマット文字とその意味は次の通りである：

::diouXx      引数は，それぞれ符号付き10進数（dまたはi），符号なし8進数，符号なし10進数，符号なし16進数（Xまたはx）として出力される。

::f          引数は，[-]ddd.dddのスタイルで表示され，小数点以下のdの数が引数の精度指定と等しくなる。 精度がない場合は6桁が与えられ，精度が明示的に0である場合は，桁と小数点は表示されない。

::eE          引数は，[-]d.ddde±ddのスタイルで印刷される。ここで，小数点以下の桁数は引数の精度指定に等しく，精度が不足する場合は6桁が生成される。 E'形式には，大文字のEが使われる。

::gG          引数は，スタイルfまたはスタイルe（E）のどちらか，最小限のスペースで完全な精度を与えるほうで印刷される。

::b          文字列引数の文字は、バックスラッシュ・エスケープ・シーケンスを展開した状態で印刷される。以下の追加バックスラッシュ・エスケープ・シーケンスがサポートされている：

::\c      dashを含む文字列オペランドの残りの文字、残りの文字列オペランド、およびformatオペランドの追加文字を無視するようにする。

::\0num  ASCII値が1桁、2桁、3桁の8進数numである8ビット文字を書く。

::c          引数の1文字目を印字する。

::s          文字列引数の文字は，末尾に達するか，精度指定で示されるバイト数に達するまで印刷される。精度が省略された場合，文字列のすべての文字が印刷される。

::%          引数なしで `%' を表示する。

:パディングは、指定されたフィールド幅が実際の幅を超える場合にのみ行われる。

:setコマンドは、3つの異なる機能を実行する。

:引数なしで、すべてのシェル変数の値をリストアップする。

:オプションが与えられた場合、引数リスト処理というセクションで説明されているように、指定されたオプションフラグを設定し、またはそれらをクリアする。 特殊なケースとして、オプションが-oまたは+oで引数が与えられない場合、シェルはそのすべてのオプションの設定を印刷する。 オプションが-oの場合，設定は人間が読める形式で印刷され，オプションが+oの場合，設定は，同じオプション設定に影響を与えるためにシェルに再入力するのに適した形式で印刷される。

:setコマンドの3つ目の使い方は、シェルの位置パラメーターの値を指定されたargsに設定することである。 オプションを変更せずに位置パラメータを変更するには、setの第1引数として「--」を使用する。 引数がない場合、setコマンドはすべての位置パラメータをクリアする（「shift $#」を実行するのと同じことである）。

:位置パラメータをn回シフトさせる。 シフトは、$1の値を$2の値に、$2の値を$3の値に...と、$#の値を1つずつ減らしていくように設定する。 nが位置パラメータの数より大きい場合、shiftはエラーメッセージを発行し、リターンステータス2で終了する。

:testユーティリティは、式を評価し、それが真と評価された場合、0（真）の終了ステータスを返し、そうでない場合、1（偽）を返す。 式がない場合、testは1（false）を返す。

:すべての演算子やフラグは、テストユーティリティの個別の引数である。

:表現を構築するために、以下のプライマリーを使用する：

::-b file      fileが存在し、ブロック特殊ファイルである場合はtrueとなる。

::-c file      fileが存在し、かつ文字特殊ファイルである場合にtrueとなる。

::-d file      ファイルが存在し、ディレクトリであればtrueとなる。

::-e file      ファイルが存在する場合、（タイプに関係なく）trueとなる。

::-f file      ファイルが存在し、通常のファイルであればtrueとなる。

::-g file      ファイルが存在し、そのグループIDフラグが設定されている場合はtrueとなる。

::-h file      ファイルが存在し、シンボリックリンクである場合はtrueとなる。

::-k file      ファイルが存在し、そのスティッキービットが設定されている場合はtrueとなる。

::-n string    文字列の長さが0でない場合、trueとなる。

::-p file      fileが名前付きパイプ（FIFO）であればtrueとなる。

::-r file      ファイルが存在し、読み取り可能であればtrueとなる。

::-s file      ファイルが存在し、かつサイズが0より大きい場合、trueとなる。

:::ファイルディスクリプタ番号がfile_descriptorであるファイルが開いており、かつ端末と関連付けられている場合にtrueとなる。

::-u file      ファイルが存在し、そのユーザIDフラグが設定されている場合はtrueとなる。

::-w file      ファイルが存在し、書き込み可能であればtrueとなる。 Trueは、書き込みフラグがオンであることだけを示す。 このテストが真であっても、読み取り専用ファイルシステム上では、ファイルは書き込み可能ではない。

::-x file      ファイルが存在し、実行可能であればtrueとなる。 trueは、実行フラグがオンであることのみを示す。 fileがディレクトリの場合、trueはファイルが検索可能であることを示す。

::-z string    文字列の長さがゼロの場合、trueとなる。

::-L file      ファイルが存在し、シンボリックリンクである場合はtrueとなる。 この演算子は、このプログラムの以前のバージョンとの互換性のために残されている。 この演算子の存在に依存せず、代わりに-hを使用する。

::-O file      ファイルが存在し、その所有者がこのプロセスの有効なユーザIDと一致する場合、trueとなる。

::-G file      ファイルが存在し、そのグループがこのプロセスの有効なグループIDに一致する場合、trueとなる。

::-S file      ファイルが存在し、かつソケットであればtrueとなる。

:::file1とfile2が存在し、file1がfile2より新しい場合にtrueとなる。

:::file1とfile2が存在し、file1がfile2より古い場合にtrueとなる。

:::file1とfile2が存在し、同じファイルを参照している場合はtrueとなる。

::string        stringがNULL文字列でない場合はtrueとなる。

::s1 = s2      文字列s1、s2が同一であればtrueとなる。

::s1 != s2      文字列s1、s2が同一でない場合にtrueとなる。

::s1 < s2      文字列s1がs2より先に来た場合、それらの文字のASCII値に基づいてtrueとなる。

::s1 > s2      文字列s1がs2の後に来る場合、それらの文字のASCII値に基づいてtrueとなる。

::n1 -eq n2    整数n1、n2が代数的に等しければtrueなる。

::n1 -ne n2    整数n1、n2が代数的に等しくない場合はtrueとなる。

::n1 -gt n2    整数n1が整数n2より代数的に大きい場合にtrueとなる。

::n1 -ge n2    整数n1が整数n2より代数的に大きいか等しい場合に真となる。

::n1 -lt n2    整数n1が整数n2より代数的に小さい場合に真となる。

::n1 -le n2    整数n1が代数的に整数n2より小さいか等しい場合にtrueとなる。

:これらのプライマリーは、以下の演算子で組み合わせることができる：

::!式がfalseの場合、trueとなる。

:::expression1 と expression2 の両方が真であればtrueとなる。

:::expression1 と expression2 のいずれかが真であればtrueとなる。

::(expression)  式がtrueであればtrueとする。

:-a演算子は-o演算子より優先順位が高い。

;times   

:シェルおよびシェルから実行されたプロセスの累積ユーザ時間およびシステム時間を表示する。戻りステータスは 0 である。

:指定されたシグナルのいずれかを受信したときに、シェルに解析とアクションの実行を行わせる。シグナルは、シグナル番号またはシグナル名で指定する。 signalが0またはEXITの場合、シェルが終了したときにアクションが実行される。 actionは空（''）でもよく、この場合指定されたシグナルは無視される。 actionが省略されるか`-'に設定されると、指定されたシグナルはそのデフォルトのアクションに設定される。 シェルがサブシェルからフォークするとき、トラップされた（しかし無視されない）シグナルをデフォルトのアクションにリセットする。 trapコマンドは、シェルに入ったときに無視されたシグナルには効果がない。引数なしのtrapは、同じトラップ結果を達成するシェルの入力として適した形式で、シグナルのリストとそれに関連するアクションを標準出力に書き出す。

::トラップされた信号とそれに対応するアクションをリストアップする

:各名前をコマンドとして解釈し、コマンド検索の解決策を表示する。 可能な解決方法は，シェルキーワード，エイリアス，シェル組み込み，コマンド，追跡されたエイリアス，見つからなかった，である。 エイリアスの場合は，エイリアスの展開が表示され，コマンドと追跡エイリアスの場合は，コマンドの完全なパス名が表示される．

:プロセスのハードリミットやソフトリミットについて問い合わせたり、新たなリミットを設定する。 ハードリミット（どのプロセスも違反することは許されず、一度下げたら上げることはできない）とソフトリミット（プロセスがシグナルを受けるが、必ずしも殺されるわけではなく、上げることができる）の選択は、これらのフラグで行うことができる：

::-H          ハードリミットをセットあるいは問い合わせる

::-S          ソフトリミットを設定または問い合わせる。 -Hも-Sも指定しない場合、ソフトリミットを表示するか、両方のリミットが設定される。 両方が指定された場合、最後に指定されたものが優先される。

:そして、これらのフラグのいずれかを指定することで、質問または設定するリミットを選択する：

::-a         現在制限されているものを表示する

::-t         CPU時間の制限を表示または設定する（秒単位）。

::-f         作成できる最大ファイルの上限を表示または設定する（512バイトブロック単位）。

::-d         プロセスのデータセグメントサイズの制限を表示または設定する（キロバイト単位）。

::-s         プロセスのスタックサイズの上限を表示または設定する（キロバイト単位）。

::-c         生成できる最大のコアダンプサイズの制限を表示または設定する（512バイトブロック単位）。

::-m         プロセスが使用できる物理メモリの合計の上限を表示または設定する（キロバイト単位）。

::-l         プロセスが '''[https://manpages.debian.org/bullseye/manpages-dev/mlock.2.en.html mlock]'''(2) でロックできるメモリの上限を表示または設定する (キロバイト単位)。

::-p         このユーザーが一度に持つことのできるプロセス数の制限を表示または設定する

::-n         プロセスが一度に開くことができるファイル数の制限を表示または設定する

::-v         プロセスが使用できる仮想メモリの合計の上限を表示または設定する（キロバイト単位）。

::-r          プロセスのリアルタイムスケジューリング優先度の上限を表示または設定する

:これらのいずれもが指定されない場合、表示または設定されるのはファイルサイズの制限値である。 valueが指定されている場合は、その数値が制限値として設定され、そうでない場合は、現在の制限値が表示される。

 

:'''[[/usr/sbin/sysctl|sysctl]]'''ユーティリティを用いて、任意のプロセスの制限値を表示・設定することができる。

:umask ('''[https://manpages.debian.org/bullseye/manpages-dev/umask.2.en.html umask]'''(2)を参照)の値を、指定された8進数の値に設定する。 引数が省略された場合，umaskの値が表示される。

:nameが指定された場合、シェルはそのエイリアスを削除する。 aが指定された場合、すべてのエイリアスが削除される。

:指定された変数と関数はアンセットされ、アンエクスポートされる。 -fまたは-vが指定された場合、それぞれ対応する関数または変数が設定解除される。 与えられた名前が変数と関数の両方に対応し、オプションが与えられていない場合、変数のみがアンセットされる。

:指定されたジョブが完了するのを待ち、そのジョブ内の最後のプロセスの終了ステータスを返す。 引数が省略された場合、すべてのジョブの完了を待ち、終了ステータスを0として返す。