ckkeywd [-Q] [-W width] [-d default] [-h help] [-e error] [-p prompt] [-k pid [-s signal]] keyword [...]
ckkeywd は、ユーザーに入力を要求するプロンプトを出力し、ユーザーの応答を検証します。このユーティリティーでは、ユーザーにキーワードリストのいずれかの入力を促すプロンプトメッセージ、ヘルプメッセージとエラーメッセージ、およびデフォルト値 (ユーザーがキャリッジリターンで応答した場合に返される値) をオプションにより定義できます。このコマンドから返される応答は、定義済みキーワードリストのいずれかと一致しなければなりません。
メッセージの長さはすべて最大 70 文字に制限され、自動的に書式化されます。定義で使用されるスペース (復帰改行を含む) はすべて削除されます。–W オプションは、自動書式化を取り消します。メッセージ定義の最初または最後にチルド文字がある場合は、そこにデフォルトテキストが挿入されて、指定したテキストとデフォルトテキストの両方を表示することができます。
プロンプトメッセージ、ヘルプメッセージ、またはエラーメッセージが定義されていない場合は、デフォルトメッセージ (「注意事項」の項を参照) が表示されます。
サポートしているオプションは、次のとおりです。
default をデフォルト値として定義します。デフォルト値は検証されないため、どのような基準も満たす必要はありません。
error をエラーメッセージとして定義します。
help をヘルプメッセージとして定義します。
ユーザーが中断を選択した場合、プロセス ID pid のプロセスにシグナルを送信するようにします。
prompt をプロンプトメッセージとして定義します。
有効な応答として終了 (quit) を使用できないようにします。
終了が選択された場合、–k オプションで定義されたプロセス ID pid のプロセスに、シグナル signal を送信するようにします。シグナルを指定しないと、SIGTERM を送信します。
プロンプトメッセージ、ヘルプメッセージ、およびエラーメッセージを、width の行長に書式化します。
次のオペランドを指定できます。
応答を照合するときの基準となるキーワード、またはキーワードのリストを定義します。
次の終了ステータスが返されます。
正常終了。
入力で EOF が検出された、–W オプションで負の行長が指定された、選択すべきキーワードがない、あるいは、使用法に誤りがあった。
ユーザー終了 (quit)。
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
ckkeywd のデフォルトのプロンプトは、次のとおりです。
Enter appropriate value [keyword,[ . . . ],?,q]:
デフォルトのエラーメッセージは、次のとおりです。
ERROR: Please enter one of the following keywords: keyword,[ . . . ],q
デフォルトのヘルプメッセージは、次のとおりです。
keyword,[ . . . ],q
終了オプションを選択した場合 (かつ使用できる場合) は、リターンコード 3 と共に q が返されます。