名前 | 形式 | 機能説明 | オプション | オペランド | 使用例 | 終了ステータス | 属性 | 関連項目
ckpath ユーティリティは、ユーザーに入力を要求するプロンプトを出力し、ユーザーの応答を検証します。このユーティリティでは、ユーザーにパス名の入力を促すプロンプトメッセージ、ヘルプメッセージおよびエラーメッセージ、およびデフォルト値 (ユーザーが RETURN キーで応答した場合に返される値) をオプションにより定義できます。
パス名は、最初のオプショングループで指定した基準に従わなければなりません。基準が定義されていない場合、パス名はまだ存在していない通常のファイルに対するものでなければなりません。-a (絶対) と -l (相対) のいずれも指定されていない場合は、どちらかが有効であるとみなされます。
メッセージの長さはすべて最大 79 文字に制限され、自動的に書式化されます。メッセージ定義内で 1 つの空白文字の後にあるタブと復帰改行は削除されますが、空白は削除されません。メッセージ定義の最初または最後にチルド文字がある場合は、そこにデフォルトテキストが挿入されて、指定したテキストとデフォルトテキストの両方を表示することができます。
プロンプトメッセージ、ヘルプメッセージ、またはエラーメッセージが定義されていない場合は、デフォルトメッセージ (「使用例」の項を参照) が表示されます。
ckpath コマンドには、3 つのビジュアルツールモジュールがリンクされています。これらのモジュールは、errpath (標準出力上にエラーメッセージを書式化して表示する)、helppath (標準出力上にヘルプメッセージを書式化して表示する)、および valpath (応答を検証する) です。これらのモジュールは、フレームドアクセスコマンド環境 (FACE) オブジェクトと組み合わせて使用する必要があります。この場合、FACE オブジェクトはプロンプトを定義します。
次のオプションを指定できます。
パス名は絶対パスでなければなりません。
パス名はブロック型特殊ファイルでなければなりません。
パス名は文字型特殊ファイルでなければなりません。
default をデフォルト値として定義します。デフォルト値は検証されないため、どのような基準も満たす必要はありません。
error をエラーメッセージとして定義します。
パス名は通常ファイルでなければなりません。
help をヘルプメッセージとして定義します。
ユーザーが中断を選択した場合、プロセス ID pid のプロセスにシグナルを送信するようにします。
パス名は相対パスでなければなりません。
パス名が存在していてはなりません (新規のものでなければなりません)。
パス名が存在していなければなりません (既存のものでなければなりません)。
prompt をプロンプトメッセージとして定義します。
有効な応答として終了 (quit) を使用できないようにします。
パス名は読み取り可能でなければなりません。
終了が選択された場合、-k オプションで定義されたプロセス ID pid のプロセスに、シグナル signal を送信するようにします。シグナルを指定しないと、SIGTERM
を送信します。
パス名は作成可能 (処理可能) でなければなりません。パス名が、まだ存在していない場合には作成されます。
パス名は書き込み可能でなければなりません。
プロンプトメッセージ、ヘルプメッセージ、およびエラーメッセージを、width の行長に書式化します。
パス名は実行可能でなければなりません。
パス名はディレクトリでなければなりません。
パス名には、0 バイトを超えるサイズのファイルがなければなりません。
ckpath のデフォルトメッセージのテキストは、使用されている基準オプションによって異なります。
ckpath (-a オプションを使用) のデフォルトプロンプトの例は、次のとおりです。
example% ckpath -a Enter an absolute pathname [?,q] |
デフォルトのエラーメッセージ (-a オプションを使用) の例は、次のとおりです。
example% /usr/sadm/bin/errpath -a ERROR: A pathname is a filename, optionally preceded by parent directories. The pathname you enter: - must begin with a slash (/) |
デフォルトのヘルプメッセージ (-a オプションを使用) の例は、次のとおりです。
example% /usr/sadm/bin/helppath -a A pathname is a filename, optionally preceded by parent directories. The pathname you enter: - must begin with a slash (/) |
終了オプションを選択した場合 (かつ使用できる場合)、リターンコード 3 と共に q が返されます。終了を入力すると、後に復帰改行が続きます。
valpath モジュールは、標準エラー出力に使用法に関するメッセージを出力します。正常終了した場合は 0、失敗した場合には 0 以外の値を返します。
example% /usr/sadm/bin/valpath usage: valpath [-[a|l][b|c|f|y][n|[o|z]]rtwx] input . . . |
次の終了ステータスが返されます。
正常終了
入力で EOF
が検出された、-W オプションで負の行長が指定された、あるいは使用法に誤りがあった
同時に指定できないオプション
ユーザー終了 (quit)
同時に指定できないオプション
次の属性については、attributes(5) のマニュアルページを参照してください。
属性タイプ | 属性値 |
---|---|
使用条件 | SUNWcsu |