4. あらゆるプログラムの振るまい

このノードでは,頑丈なソフトウェアを書くための約束について 説明します.また,エラーメッセージの書き方, コマンド行インターフェース,ライブラリの動作についても標準的な方法を 解説します.

4.1 頑丈なプログラムを書くには
4.2 ライブラリ関数
4.3 エラーメッセージの形式
4.4 一般的なインターフェースの規約
4.5 グラフィカルインターフェースの標準
4.6 コマンド行インターフェースの規約
4.7 長いオプションの表
4.8 メモリの使い方
4.9 ファイルの使い方

4.1 頑丈なプログラムを書くには

ファイル名, 行, ファイル, シンボル等のどんなデータ構造にも, 長さや個数について勝手な制限は設けてはいけません. データ構造用のメモリは動的に確保しましょう. Unix ユーティリティは「長い行はだまって切る」 ものがほとんどですが, GNU のユーティリティではこれは容認できません.

ファイルを読むユーティリティは, NUL 文字,あるいは 0177 以上のコードを含む非印字文字を読み落してはなりません. 唯一の意味のある例外は, これらの文字を扱えないある種のプリンタへの インタフェースのためのユーティリティに限られるでしょう. 可能な限り, マルチバイト文字を表現するバイト列に対しても, UTF-8 等のエンコーディングを使って, プログラムが正しく動作するように しましょう.

わざとエラーを無視したい時以外は, システムコールがエラーを 返しているかどうかを必ずチェックしましょう. システムコールの失敗によるすべてのエラーメッセージには, （ perror あるいはそれと同等のものから得られる）システムの エラーメッセージ文とファイル名,ユーティリティ名を入れましょう. "cannot open foo.c" や "stat failed" だけでは十分ではありません.

malloc や realloc を呼ぶときは戻り値がゼロでないか必ずチェック しましょう. 要求するメモリブロックの大きさの指定を小さくして reallocを 呼ぶときもチェックが必要です. メモリブロックの大きさを２の累乗に切り上げるシステムでは, reallocに 指定するメモリブロックの大きさを小さくして呼び出すと, 異なるメモリブロックが 得られることがあります.

通常の Unix の realloc がゼロを返したときは, メモリ領域を壊している可能性があります. GNU reallocにはこの問題はなく, 失敗した場合も,もとのブロックを 変更しません. この問題は存在しないと考えて良いでしょう. Unix でプログラムを動かすときに,この問題を避けたいのなら GNU malloc を使えば良いのです.

free は解放された後のブロックの内容を変更してしまうと 考えなければなりません. そのブロックから何か取りだしたいなら freeを呼び出す前にしましょう.

非対話的なプログラムで malloc に失敗した場合には, 致命的エラーとしましょう.ユーザからのコマンドを読み込むような, 対話的なプログラムの場合には, 実行中のコマンドを中断して, プログラムの コマンド読み込みのループ部に制御を戻したほうが良いでしょう. こうすれば, 他のプロセスを殺すなどして仮想メモリを空けて, そのコマンドの再実行を試みることができます.

引数のシンタックスに合わない場合以外は, 引数を解析するには getopt_long を使いましょう.

プログラム実行中に書き込みが行われる静的記憶領域は,（宣言ではなく）Cコード中で 明示的に初期化します. Cの初期化宣言は読みだし専用データにだけ使いましょう.

不透明な Unix のデータ構造（ディレクトリ, utmp,カーネルメモリの レイアウトなど ）に対する低レベルインタフェースの使用は避けましょう. それらは互換性があまりないからです. あるディレクトリ内の全てのファイルを見つけたかったら readdir やその他の高レベルのインタフェースを使いましょう. これらは GNU により互換性がサポートされています.

シグナル操作機能として好ましいのは BSD 版の signal と POSIX の sigaction 関数です. USG の signal インターフェースは設計が劣ります.

今や, POSIX のシグナル関数を使うのがプログラムをポータブルに する一番簡単な方法でしょう. signal を使うなら, GNU/Linux で GNU libc バージョン 1 の場合は, `signal.h' の 代わりに `bsd/signal.h' を使うようにして, BSD の動作になるように する必要があります. signal の動作が USG のものしかない システムをサポートするか, あるいはあきらめるかは読者にお任せします.

エラーチェックで”起こりえない”条件を検知したら,単に中断しましょう. 通常,何かのメッセージを出力することには,意味がありません. これらのエラーチェックはバグの存在を示すものです.バグを修正したい人は ソースコードを読みデバッガを走らせないといけません.ですから,ソース内の コメントで問題について説明してください.関係のあるデータは変数の中にあるで しょうから,デバッガを用いて簡単に検査できるので,それらをどこかよそへ移す 事には意味がありません.

エラーの回数をプログラムの終了ステータスとしてはいけません. そうしても思った通りにいきません.終了ステータスは 8 ビットの値, つまり 0 〜 255 に限られるからです.プログラムを一回実行させただけで, 256 回エラーが発生する可能性があります. 256 を終了ステータスとして 返そうとしても,親プロセスには 0 が返されてしまいます.そうすると, そのプログラムはエラー無しで無事終了したものと見なされます.

一時ファイルを作成する場合は,まず環境変数 TMPDIR が 定義されているかどうかを調べる必要があります.定義されている場合には, `/tmp' の代わりに, TMPDIR で指定されたディレクトリを使いましょう.

さらに,誰でも書き込み可能なディレクトリに一時ファイルを作成することに ついてはセキュリティ上の問題が発生する可能性に注意すべきでしょう. C 言語では,以下のような方法で一時ファイルを作成することでこの問題を 回避することができます.

fd = open(filename, O_WRONLY | O_CREAT | O_EXCL, 0600);

あるいは,libiberty ライブラリの mkstemps 関数を 使うこともできます.

bash では,set -C とするとこの問題を回避できます.

4.2 ライブラリ関数

ライブラリ関数はリエントラントになるよう努めてください. 関数が動的なメモリ獲得を必要としているならば,すくなくとも malloc 自身の非リエントラント性以外の非リエントラント性を 避けるようにしましょう.

ライブラリの名前づけには,名前の衝突を避けるための規約があります.

ライブラリ用に２文字以上のプリフィックス名を選んでください. 外部関数と外部変数名は全てこのプリフィックスで始めるようにします. さらに,これらの名前はどのライブラリのメンバ(...o ファイル)にもそれぞれ 一個だけしか現れないようにすべきです. これは通常,それぞれの名前をそれぞれ別々のソースファイルに置くという意味です.

２つの外部シンボルがいつも一緒に使われ,片方をもう一方なしには使えない ようなプログラムは例外です. それらは両方とも同じファイルに入れます.

ユーザからエントリポイントとして見えてはいけない外部シンボルは, `_'で始まる名前にしなければなりません. `_' の後に そのライブラリ用に選んだ名前のプリフィックスを続けるようにして、 他のライブラリとの衝突を避ける必要があります。 こうしておけば,ユーザに見せて良いエントリポイントが あるファイルと同じファイルにいれておくことも可能です.

静的関数と静的変数は好きなように使って良いし, 特に名前付けの規約にも従う 必要もありません.

4.3 エラーメッセージの形式

コンパイラの出すエラーメッセージは次の形式にします.

ソースファイル名:行番号: メッセージ

カラム番号を表示したい場合は次の形式を使います.

ソースファイル名:行番号:カラム: メッセージ

行番号はファイルの先頭が 1 になるように始め, カラム番号は 行頭で 1 になるように始めます. (この規約は互換性のために選ばれました. ) カラム番号を計算する際には, スペースと ASCII の印字可能文字は 全て同じ幅を持ち, タブ・ストップは 8 カラム毎であるとしましょう.

コンパイラ以外の対話的でないプログラムの出すエラーメッセージは 次の形式にします.

プログラム:ソースファイル名:行番号: メッセージ

これは該当するソースファイルがある場合です. 関係するソースファイルがない場合は次のように書きます.

プログラム: メッセージ

カラム番号を表示したい場合は以下の形式を使います.

プログラム:ソースファイル名:行番号:カラム: メッセージ

対話的なプログラム（端末からコマンドを読むようなもの）においては エラーメッセージ中にプログラム名を入れないほうがいいでしょう.どのプログラ ムが動いているかは,プロンプトあるいはスクリーンレイアウトにより示されています. （同じプログラムが端末以外のファイルから入力を読む場合,それは対話的では ありませんから,非対話的な形式でエラーメッセージを印字するの が最良です.）

メッセージの文字列がプログラム名とファイル名の後に続くときは, 大文字で始めてはいけません. また, ピリオドで終わってはいけません.

対話的なプログラムのエラーメッセージや使用法のメッセージは, 大文字で始めます.しかし,ピリオドで終ってはいけません.

4.4 一般的なインターフェースの規約

起動されるときのコマンド名によって, そのユーティリティ・コマンドの 振る舞いを変えるのはやめてください. ユーティリティを違う名前にリンクすると便利なことがあり, その場合でも振る舞いが変わらないようにすべきです.

その代わりに起動時のオプション,あるいはコンパイル時のスイッチ,あるいは その両方で振る舞いを選択できるようにします.

同様に, プログラムの振る舞いを出力先デバイスのタイプによって変えるのは やめてください. デバイスに依存しないことはシステムの設計の重要な 原則です. 単に, 誰かがたまにオプションを入力しなくても済むようにするために 妥協するのはやめてください. (端末を使っているときにエラー・メッセージの 構文を変えるのは構いません. 人々がそのことに依存するようなことのない, 副次的な問題だからです. )

出力先が端末の場合に適した動作と, それとは別に, 出力先がファイルやパイプの場合に適した動作があるなら, デフォルトは端末向けの動作とし, もう一方の動作は何かオプションを 指定したときに実行されるようにするのが良いでしょう.

互換性のために, ある種のプログラムでは出力先のデバイスに依存することが 要求される場合もあります. (出力デバイスに依存するプログラムの代表例である) ls や sh が, 全てのユーザの期待する 通りに動かなかったら, 一大事でしょう. そのような場合には, 我々は, 出力先デバイスに依存しない好ましい別のバージョン のプログラムで補います. 例えば, 我々は dir という, ls とほとんど同じプログラムを提供していますが, デフォルトの出力フォーマットは, 常にマルチカラムのフォーマットにしています.

4.5 グラフィカルインターフェースの標準

グラフィカルユーザインターフェースを提供するプログラムを書く場合は, 機能的に何か別のものを必要とする(例えば,「コンソールモードで JPEG のイメージを表示する」など)のでない限り,X Windows と GTK ツール キットで動作するようにして欲しい.

さらに,その機能を制御するコマンド行インターフェースも提供して欲しい. (多くの場合,グラフィカルユーザインターフェースは,コマンド行プログラム を起動する独立したプログラムとすることが可能である.) これは,同じ作業をスクリプトからでも行なえるようにするためである.

また,CORBA インターフェース(GNOME から使うため),ライブラリインターフェース (C 言語から使うため),キーボード入力駆動とするコンソールインターフェース (コンソールモードからユーザが使うため)を提供することも 検討して欲しい.一度,機能そのものとグラフィカルユーザインターフェスが 動くようになれば,これらはそれほど大変な作業ではない.

4.6 コマンド行インターフェースの規約

プログラムのコマンド行オプションは, posix ガイドラインに従うのが 良いでしょう.そのためにはオプションの解析時にgetoptを使うのが最も 簡単です. GNU 版の getopt では, 特殊な引数`--'を指定しない限り, 引数の中のどこにオプションがあっても良いことにしています. これは posix の仕様ではありません. GNU の拡張です.

Unix風の１文字オプションと同値のオプションを長い名前で定義してください. このようにGNU はもっと親切になりたいと望んでいます. GNU の関数 getopt_long を使えば簡単です.

長い名前のオプションの利点の一つに,プログラム間で一貫性を保てることが あります. 例えば,"verbose" オプションを持つ GNU プログラムではいつでも, そのオプションは `--verbose' と綴られるとユーザが期待しても 良いようにすべきです. このような一貫性を達成するためには, 自分のプログラムのオプション名を選択するときに,共通の長いオプション名の 表があるので,見てください (see section 4.7 長いオプションの表).

普通の引数で与えられるファイル名は入力ファイルに限る, というのは良い考えです. 出力ファイルはオプション（ なるべく `-o' か `--output'）で あたえれば良いのです. 互換性のため,出力ファイル名も通常の引数で与えられるようにしたいと思った時は, 別の方法で指定するためのオプションも同様に提供しましょう. そうすれば GNU のユーティリティ間の一貫性が保たれ,ユーザが特別に 覚えなければならないことが少なくなるからです.

すべてのプログラムは, `--version' と `--help' の二つの 標準オプションをサポートしなければなりません.

--version

このオプションは, 名前, バージョン, 出所, 著作権等のプログラムについての 情報を標準出力に表示し, プログラムを正常終了させます. このオプションが指定された場合は, 他のオプションや引数は無視し, それらの引数が指定された場合の通常の動作を行わないようにする 必要があります.

プログラム情報の一行目は他のプログラムがパースしやすいように してください. バージョン番号自体は, 一行目の最後の空白の後に 書きます. さらに, 次のような形式で, プログラムの正式な名前を書きます.

GNU Emacs 19.30

プログラム名は文字列定数にしてください. argv[0] から 求めてはいけません. というのは, プログラムのファイル名ではなく, 正式な名前を表示するのが目的だからです. コマンドが PATH にあるものなら, 正確なファイル名を知る方法は 別にあります.

プログラムがより大きなパッケージの補助的なものなら, 以下のように, パッケージ名を括弧の中に示します.

emacsserver (GNU Emacs) 19.30

パッケージのバージョン番号とプログラムのバージョン番号が違っている 場合には, 閉じ括弧の前にパッケージのバージョン番号を入れましょう.

プログラムが入っているパッケージとは別に配布されているライブラリの バージョン番号についても表示する必要があるばあいは, ライブラリ毎にバージョン情報を一行ずつ追加表示しましょう. 追加する行は一行目と同じ形式を使ってください.

完全性を追及するためだけの理由で, プログラムが使う全ライブラリに ついて言及するのは避けてください. 役に立たない情報であふれるだけです. デバッグのために非常に重要だと判っているものだけについて, バージョンを 表示するようにしてください.

バージョン表示の後には, 著作権表示を出力します. 著作権表示が複数 ある場合は, 一行に一つずつ表示します.

その次には, プログラムがフリーソフトウェアであること, ある条件の元で コピーや変更を行って良いことを簡単に説明します. プログラムが GNU GPL で カバーされるものなら, この部分にその旨を宣言します. また, 法律で許される範囲で, 無保証であることも述べます.

最後に, プログラムの主要な著者名を挙げて, クレジットの表示としても良いでしょう.

以上の規則に則った例を以下にしめします.

GNU Emacs 19.34.5 Copyright (C) 1996 Free Software Foundation, Inc. GNU Emacs comes with NO WARRANTY, to the extent permitted by law. You may redistribute copies of GNU Emacs under the terms of the GNU General Public License. For more information about these matters, see the files named COPYING.

もちろん, 自分のプログラムに合わせて変更すべき部分があります. 年, 著作権保持者, プログラム名, 配布条件への参照を埋め, 他の部分も必要に応じて変更してください.

著作権表示に示す年は, 最後に変更があった年を示すだけでかまいません. それ以前の変更を行った年を表示する必要はありません. 面倒なら, 著作権表示中にプログラム名を示す必要はありません. 既に一行目に示しています.

以上の行の翻訳は、著作権表示の有効性を保持しなければなりません see section 5.8 国際化)。翻訳に使用する文字セットが対応しているなら、 `(C)' は、以下のように、著作権記号で置き換える必要があります。

(正式な著作権記号、文字 C を円の中に置いたもの) (C)

"Copyright"という語は、そのまま英語で書いて下さい。これを他の言語に 翻訳しては行けません。国際条約は、英単語 "Copyright"を認識しますが、 他の言語に翻訳したものは法的な意味を持ちません。

--help

このオプションは, プログラムの起動方法の簡単な説明を標準出力に 表示し, プログラムを正常終了させます. このオプションが指定された場合は, 他のオプションや引数は無視し, それらの引数が指定された場合の通常の動作を行わないようにする 必要があります.

オプション `--help' の出力の最後に,バグレポートの送り先のメールアドレスを 書いた行を一行含めてください. 以下の形式で書いてください.

Report bugs to mailing-address.

4.7 長いオプションの表

次の表は,GNU プログラムで使われている長い名前のオプションの一覧です. まだ不完全なものですが, 我々は新しいプログラムと互換性のあるオプションを すべて列挙することを目指しています. この表にまだ入っていない名前を使ったら, 意味を書いたリストを bug-standards@gnu.org に送ってくれれば, われわれはこの表を更新します.

`after-date'

tar の `-N' .

`all'

du, ls, nm, stty, uname, unexpand の `-a' .

`all-text'

diff の `-a' .

`almost-all'

ls の `-A'.

`append'

etags, tee, time の `-a', tar の `-r'.

`archive'

cp の `-a' .

`archive-name'

shar の `-n' .

`arglength'

m4 の `-l' .

`ascii'

diff の `-a' .

`assign'

gawk の `-v' .

`assume-new'

Make の `-W'.

`assume-old'

Make の `-o' .

`auto-check'

recode の `-a' .

`auto-pager'

wdiff の `-a' .

`auto-reference'

ptx の `-A' .

`avoid-wraps'

wdiff の `-n' .

`background'

サーバプログラムをバックグランドで走らせる.

`backward-search'

ctags の `-B' .

`basename'

shar の `-f' .

`batch'

GDB で使用.

`baud'

GDB で使用.

`before'

tac の `-b' .

`binary'

cpio と diff の `-b' .

`bits-per-code'

shar の `-b' .

`block-size'

shar の `-b' .

`block-size'

cpio と tar で使用.

`blocks'

head と tail の `-b' .

`break-file'

ptx の `-b' .

`brief'

色々なプログラムで出力を短くするために使われている.

`bytes'

head, split, tail の `-c' .

`c++'

etags の `-C' .

`catenate'

tar の `-A' .

`cd'

色々なプログラムで,使用するディレクトリを指定するために使われている.

`changes'

chgrp と chown の `-c' .

`classify'

ls の `-F' .

`colons'

recode の `-c' .

`command'

su の `-c', GDB の `-x' .

`compare'

tar の `-d' .

`compat'

gawk で使用.

`compress'

tar と shar の `-Z' .

`concatenate'

tar の `-A' .

`confirmation'

tar の `-w' .

`context'

diff で使用.

`copyleft'

gawk の `-W copyleft' .

`copyright'

ptx, recode, wdiff の `-C', gawk の `-W copyright'.

`core'

GDB で使用.

`count'

who の `-q' .

`count-links'

du の `-l' .

`create'

tar と cpio で使用.

`cut-mark'

shar の `-c' .

`cxref'

ctags の `-x' .

`date'

touch の `-d' .

`debug'

Make と m4 の `-d', Bison の `-t' .

`define'

m4 の `-D' .

`defines'

Bison と ctags の `-d' .

`delete'

tar の `-D' .

`dereference'

chgrp, chown, cpio, du, ls, tar の `-L' .

`dereference-args'

du の `-D' .

`device'

入出力装置(特殊ファイル名)を指定する.

`diacritics'

recode の `-d' .

`dictionary-order'

look の `-d' .

`diff'

tar の `-d' .

`digits'

csplit の `-n' .

`directory'

色々なプログラムで, 使用するディレクトリを指定する. ls では, 中身ではなくディレクトリ自身を表示することを意味する. rm と ln では, ディレクトリへのリンクを特別扱いしないようにする.

`discard-all'

strip の `-x' .

`discard-locals'

strip の `-X' .

`dry-run'

Make の `-n' .

`ed'

diff の `-e' .

`elide-empty-files'

csplit の `-z' .

`end-delete'

wdiff の `-x'.

`end-insert'

wdiff の `-z'.

`entire-new-file'

diff の `-N' .

`environment-overrides'

Make の `-e' .

`eof'

xargs の `-e' .

`epoch'

GDB で使用.

`error-limit'

makeinfo で使用.

`error-output'

m4 の `-o' .

`escape'

ls の `-b' .

`exclude-from'

tar の `-X' .

`exec'

GDB で使用.

`exit'

xargs の `-x' .

`exit-0'

unshar の `-e' .

`expand-tabs'

diff の `-t' .

`expression'

sed の `-e' .

`extern-only'

nm の `-g' .

`extract'

cpio の `-i', tar の `-x' .

`faces'

finger の `-f' .

`fast'

su の `-f' .

`fatal-warnings'

m4 の `-E' .

`file'

info, gawk, Make, mt, tar の `-f', sed の `-n', touch の `-r' .

`field-separator'

gawk の `-F' .

`file-prefix'

Bison の `-b' .

`file-type'

ls の `-F' .

`files-from'

tar の `-T' .

`fill-column'

makeinfo で使用.

`flag-truncation'

ptx の `-F' .

`fixed-output-files'

Bison の `-y' .

`follow'

tail の `-f' .

`footnote-style'

makeinfo で使用.

`force'

cp, ln, mv, rm の `-f' .

`force-prefix'

shar の `-F' .

`foreground'

サーバプログラムをフォアグラウンドで走らせる. 言い換えると, サーバをバックグランドで走らせるときに 行なう特別な事は何もやらない.

`format'

ls, time, ptx で使用.

`freeze-state'

m4 の `-F'.

`fullname'

GDB で使用.

`gap-size'

ptx の `-g' .

`get'

tar の `-x' .

`graphic'

ul の `-i' .

`graphics'

recode の `-i' .

`group'

install の `-g' .

`gzip'

tar と shar の `-z' .

`hashsize'

m4 の `-H' .

`header'

objdump と recode の `-h' .

`heading'

who の `-H' .

`help'

簡単な使用法を求めるのに使用.

`here-delimiter'

shar の `-d' .

`hide-control-chars'

ls の `-q' .

`html'

makeinfo で,HTML を出力する.

`idle'

who の `-u' .

`ifdef'

diff の `-D' .

`ignore'

ls の `-I', recode の `-x' .

`ignore-all-space'

diff の `-w' .

`ignore-backups'

ls の `-B' .

`ignore-blank-lines'

diff の `-B' .

`ignore-case'

look と ptx の `-f', diff とwdiff の `-i' .

`ignore-errors'

Make の `-i' .

`ignore-file'

ptx の `-i' .

`ignore-indentation'

etags の `-I' .

`ignore-init-file'

Oleo の `-f'.

`ignore-interrupts'

tee の `-i' .

`ignore-matching-lines'

diff の `-I' .

`ignore-space-change'

diff の `-b' .

`ignore-zeros'

tar の `-i' .

`include'

etags の `-i', m4 の `-I' .

`include-dir'

Make の `-I'.

`incremental'

tar の `-G' .

`info'

Finger の `-i', `-l', `-m' .

`init-file'

いくつかのプログラムで,ユーザの初期化ファイルとして読むファイル名を 指定する.

`initial'

expand の `-i' .

`initial-tab'

diff の `-T' .

`inode'

ls の `-i' .

`interactive'

cp, ln, mv, rm の `-i', m4 の `-e', xargs の `-p', tar の `-w' .

`intermix-type'

shar の `-p' .

`iso-8601'

date で使われている.

`jobs'

Make の `-j'.

`just-print'

Make の `-n'.

`keep-going'

Make の `-k'.

`keep-files'

csplit の `-k'.

`kilobytes'

du と ls の `-k' .

`language'

etags の `-l'.

`less-mode'

wdiff の `-l'.

`level-for-gzip'

shar の`-g' .

`line-bytes'

split の `-C' .

`lines'

split, head, tail で使用.

`link'

cpio の `-l' .

`lint'

`lint-old'

gawk で使用.

`list'

cpio の `-t', recode の `-l' .

`list'

tar の `-t' .

`literal'

ls の `-N' .

`load-average'

Make の `-l'.

`login'

su で使用.

`machine'

これを使っているプログラムはない. 使っているプログラムを見かけたら, gnu@gnu.org まで連絡を.

`macro-name'

ptx の `-M' .

`mail'

hello と uname の `-m' .

`make-directories'

cpio の `-d' .

`makefile'

Make の `-f'.

`mapped'

GDB で使用.

`max-args'

xargs の `-n' .

`max-chars'

xargs の `-n' .

`max-lines'

xargs の `-l' .

`max-load'

Make の `-l'.

`max-procs'

xargs の `-P' .

`mesg'

who の `-T' .

`message'

who の `-T' .

`minimal'

diff の `-d' .

`mixed-uuencode'

shar の `-M' .

`mode'

install, mkdir, mkfifo の `-m' .

`modification-time'

tar の `-m' .

`multi-volume'

tar の `-M' .

`name-prefix'

Bison の `-a'.

`nesting-limit'

m4 の `-L' .

`net-headers'

shar の `-a' .

`new-file'

Make の `-W'.

`no-builtin-rules'

Make の `-r'.

`no-character-count'

shar の `-w' .

`no-check-existing'

shar の `-x' .

`no-common'

wdiff の `-3'.

`no-create'

touch の `-c' .

`no-defines'

etags の `-D' .

`no-deleted'

wdiff の `-1'.

`no-dereference'

cp の `-d' .

`no-inserted'

wdiff の `-2'.

`no-keep-going'

Make の `-S'.

`no-lines'

Bison の `-l'.

`no-piping'

shar の `-P' .

`no-prof'

gprof の `-e' .

`no-regex'

etags の `-R'.

`no-sort'

nm の `-p' .

`no-split'

makeinfo で使用.

`no-static'

gprof の `-a' .

`no-time'

gprof の `-E' .

`no-timestamp'

shar の `-m' .

`no-validate'

makeinfo で使用.

`no-wait'

emacsclient で使用.

`no-warn'

色々なプログラムで警告を抑止するために使用.

`node'

info の `-n' .

`nodename'

uname の `-n' .

`nonmatching'

cpio の `-f' .

`nstuff'

objdump の `-n' .

`null'

xargs の `-0' .

`number'

cat の `-n' .

`number-nonblank'

cat の `-b' .

`numeric-sort'

nm の `-n' .

`numeric-uid-gid'

cpio と ls の `-n'.

`nx'

GDB で使用.

`old-archive'

tar の `-o' .

`old-file'

Make の `-o'.

`one-file-system'

tar, cp, du の `-l' .

`only-file'

ptx の `-o'.

`only-prof'

gprof の `-f' .

`only-time'

gprof の `-F' .

`options'

getopt, fdlist, fdmount, fdmountd, fdumount の `-o' .

`output'

色々なプログラムで出力ファイル名を指定する.

`output-prefix'

shar の `-o' .

`override'

rm の `-o' .

`overwrite'

unshar の `-c' .

`owner'

install の `-o' .

`paginate'

diff の `-l' .

`paragraph-indent'

makeinfo で使用.

`parents'

mkdir と rmdir の `-p' .

`pass-all'

ul の `-p' .

`pass-through'

cpio の `-p' .

`port'

finger の `-P' .

`portability'

cpio と tar の `-c' .

`posix'

gawk で使用.

`prefix-builtins'

m4 の `-P' .

`prefix'

csplit の `-f' .

`preserve'

tar と cp で使用.

`preserve-environment'

su の `-p' .

`preserve-modification-time'

cpio の `-m' .

`preserve-order'

tar の `-s' .

`preserve-permissions'

tar の `-p' .

`print'

diff の `-l' .

`print-chars'

cmp の `-L' .

`print-data-base'

Make の `-p'.

`print-directory'

Make の `-w'.

`print-file-name'

nm の `-o' .

`print-symdefs'

nm の `-s' .

`printer'

wdiff の `-p'.

`prompt'

ed の `-p'.

`proxy'

HTTP のプロキシを指定する.

`query-user'

shar の `-X' .

`question'

Make の `-q'.

`quiet'

多くのプログラムで通常の出力を抑止するのに使用. 注意: `--quiet' を受け付けるプログラムは必ず別名として `--silent' も受け付けなければならない.

`quiet-unshar'

shar の `-Q'.

`quote-name'

ls の `-Q' .

`rcs'

diff の `-n' .

`re-interval'

gawk で使用.

`read-full-blocks'

tar の `-B' .

`readnow'

GDB で使用.

`recon'

Make の `-n'.

`record-number'

tar の `-R' .

`recursive'

chgrp, chown, cp, ls, diff, rmで使用.

`reference-limit'

makeinfo で使用.

`references'

ptx の `-r' .

`regex'

tac と etags の `-r' .

`release'

uname の `-r' .

`reload-state'

m4 の `-R'.

`relocation'

objdump の `-r' .

`rename'

cpio の `-r' .

`replace'

xargs の `-i' .

`report-identical-files'

diff の `-s' .

`reset-access-time'

cpio の `-a' .

`reverse'

ls と nm の `-r' .

`reversed-ed'

diff の `-f' .

`right-side-defs'

ptx の `-R' .

`same-order'

tar の `-s' .

`same-permissions'

tar の `-p' .

`save'

stty の `-g' .

`se'

GDB で使用.

`sentence-regexp'

ptx の `-S' .

`separate-dirs'

du の `-S' .

`separator'

tac の `-s' .

`sequence'

recode で,シーケンスを渡すファイルやパイプを選択するのに 使われる.

`shell'

su の `-s' .

`show-all'

cat の `-A' .

`show-c-function'

diff の `-p' .

`show-ends'

cat の `-E' .

`show-function-line'

diff の `-F' .

`show-tabs'

cat の `-T' .

`silent'

多くのプログラムで通常の出力を抑止するのに使用. 注意: `--silent' を受け付けるプログラムは必ず別名として `--quiet' も受け付けなければならない.

`size'

ls の `-s' .

`socket'

ネットワークサーバが, 新しいソケットをオープンしバインドする代わりに 使うファイル記述子を指定する. これにより, 通常は予約されたポート番号を必要とするサーバプログラムを 特権のないプロセスとして実行することができる.

`sort'

ls で使用.

`source'

gawk の `-W source'.

`sparse'

tar の `-S' .

`speed-large-files'

diff の `-H' .

`split-at'

unshar の `-E' .

`split-size-limit'

shar の `-L' .

`squeeze-blank'

cat の `-s' .

`start-delete'

wdiff の `-w'.

`start-insert'

wdiff の `-y'.

`starting-file'

tar と diff で, ディレクトリ中のどのファイルから処理を 開始するかを指定するのに使用.

`statistics'

wdiff の `-s'.

`stdin-file-list'

shar の `-S' .

`stop'

Make の `-S'.

`strict'

recode の `-s' .

`strip'

install の `-s' .

`strip-all'

strip の `-s' .

`strip-debug'

strip の `-S' .

`submitter'

shar の `-s' .

`suffix'

cp, ln, mv の `-S'.

`suffix-format'

csplit の `-b' .

`sum'

gprof の `-s' .

`summarize'

du の `-s' .

`symbolic'

ln の `-s' .

`symbols'

GDB と objdump で使用 .

`synclines'

m4 の `-s' .

`sysname'

uname の `-s' .

`tabs'

expand と unexpand の `-t' .

`tabsize'

ls の `-T' .

`terminal'

tput と ul の `-T' . wdiff の `-t'.

`text'

diff の `-a' .

`text-files'

shar の `-T' .

`time'

ls と touch で使用.

`timeout'

ある操作をあきらめるまでにどれだけの時間を待つかを指定する.

`to-stdout'

tar の `-O' .

`total'

du の `-c' .

`touch'

Make と ranlib と recode の `-t' .

`trace'

m4 の `-t' .

`traditional'

hello の `-t', gawk の `-W traditional', ed, m4 と ptx の `-G' .

`tty'

GDB で使用.

`typedefs'

ctags の `-t' .

`typedefs-and-c++'

ctags の `-T' .

`typeset-mode'

ptx の `-t' .

`uncompress'

tar の `-z' .

`unconditional'

cpio の `-u' .

`undefine'

m4 の `-U' .

`undefined-only'

nm の `-u' .

`update'

cp, `ctags', `mv', `tar' の `-u'.

`usage'

gawk で使用. `--help' に同じ.

`uuencode'

shar の `-B' .

`vanilla-operation'

shar の `-V' .

`verbose'

進行状況についてより詳細な情報を出力する. 多くのプログラムがサポートしている.

`verify'

tar の `-W' .

`version'

バージョン番号を表示.

`version-control'

cp, ln, mv の `-V' .

`vgrind'

ctags の `-v' .

`volume'

tar の `-V' .

`what-if'

Make の `-W'.

`whole-size-limit'

shar の `-l' .

`width'

ls と ptx の `-w' .

`word-regexp'

ptx の `-W'.

`writable'

who の `-T' .

`zeros'

gprof の `-z' .

4.8 メモリの使い方

プログラムのメモリ使用量が数メガバイト程度なら,使用量を減らそうと四苦八苦する 必要はありません.例えば,数メガバイトを越えるファイルの取扱いが 何か他の理由で難しければ,ファイル全体をメモリに読み込んで取り扱うのが 妥当でしょう.

しかし, cat や tail のように, 非常に大きなファイルに対しても 問題なく使える必要のあるプログラムについては, 取り扱えるファイルの大きさを 人為的に制限するような細工を使うのは避けるべきです. 行単位に動作するプログラムで,ユーザが指定した任意の入力ファイルに 対して適用可能であれば,メモリ中には一行分だけ保持すべきです. これはそれほど難しいことではないし,ユーザはメモリに一度に入り切らない ぐらい大きなファイルが取り扱えることを望むものだからです.

読者の作るプログラムが, 複雑なデータ構造を要するものなら,それを 動的にメモリ中に作り, malloc がゼロを返した場合には致命的 エラーとしましょう.

4.9 ファイルの使い方

プログラムは,`/usr' と `/etc' が読み出し専用ファイルシステム であっても動作するよう用意しておかなければならないでしょう. つまり,プログラムがログファイルや,ロック用ファイル,バックアップ用 ファイル,ソースファイル,あるいはそれ以外のファイルを内部的な 目的で変更することがあるなら,これらのファイルは `/usr' と `/etc' に置いてはいけません.

例外が二つあります.`/etc' はシステムの構成情報を置くのに使われます. プログラムの仕事がシステム構成情報を更新することにあるなら,そのプログラムが `/etc' にあるファイルを変更するのは妥当でしょう. また,ユーザがあるディレクトリにあるファイルを変更することを 明示的に要求したなら,プログラムが同じディレクトリに他のファイルを 置くのも妥当でしょう.