valtime(1)

名前

cktime, errtime, helptime, valtime - 時間の入力要求とその検証

形式

cktime [-Q] [-W width] [-f format] [-d default] [-h help] [-e error] [-p prompt] [-k pid [-s signal]]

/usr/sadm/bin/errtime [-W width] [-e error] [-f format]

/usr/sadm/bin/helptime [-W width] [-h help] [-f format]

/usr/sadm/bin/valtime [-f format] input

説明

cktime ユーティリティーは、ユーザーに入力を要求してその応答を検証します。このユーティリティーでは、ユーザーに時間の入力を促すプロンプトメッセージ、ヘルプメッセージとエラーメッセージ、およびデフォルト値 (ユーザーが RETURN キーで応答した場合に返される値) をオプションにより定義できます。ユーザー応答は、時間について定義されている書式に一致しなければなりません。

メッセージの長さはすべて最大 70 文字に制限され、自動的に書式化されます。定義で使用されるスペース (復帰改行を含む) はすべて削除されます。–W オプションは、自動書式化を取り消します。メッセージ定義の最初または最後にチルド文字がある場合は、そこにデフォルトテキストが挿入されて、指定したテキストとデフォルトテキストの両方を表示することができます。

プロンプトメッセージ、ヘルプメッセージ、またはエラーメッセージが定義されていない場合は、デフォルトメッセージ (「注意事項」の項を参照) が表示されます。

cktime コマンドには、3 つのビジュアルツールモジュールがリンクされています。これらのモジュールは、errtime (エラーメッセージを書式化して表示する) と helptime (ヘルプメッセージを書式化して表示する) と、valtime (応答を検証する) です。これらのモジュールは、FML オブジェクトと組み合わせて使用する必要があります。この場合、FML オブジェクトはプロンプトを定義します。errtime および helptime の各モジュールに format が定義されている場合、メッセージには指定した書式も含まれます。

オプション

サポートしているオプションは、次のとおりです。

–d default

default をデフォルト値として定義します。デフォルト値は検証されないため、どのような基準も満たす必要はありません。

–e error

error をエラーメッセージとして定義します。

–f format

入力を検証するときの基準となる書式を指定します。次の書式と定義を指定できます。

%H  =  hour (00 - 23)
%I  =  hour (00 - 12)
%M  =  minute (00 - 59)
%p  =  ante meridian or post meridian
%r  =  time as %I:%M:%S %p
%R  =  time as %H:%M (the default format)
%S  =  seconds (00 - 59)
%T  =  time as %H:%M:%S

–h help

help をヘルプメッセージとして定義します。

–k pid

ユーザーが中断を選択した場合、プロセス ID pid のプロセスにシグナルを送信するようにします。

–p prompt

prompt をプロンプトメッセージとして定義します。

–Q

有効な応答として終了 (quit) を使用できないようにします。

–s signal

終了が選択された場合、–k オプションで定義されたプロセス ID pid のプロセスに、シグナル signal を送信するようにします。シグナルを指定しないと、SIGTERM を送信します。

–W width

プロンプトメッセージ、ヘルプメッセージ、およびエラーメッセージを、width の行長に書式化します。

オペランド

次のオペランドを指定できます。

input

書式基準と照合される入力

終了ステータス

次の終了ステータスが返されます。

0

正常終了。

1

入力で EOF が検出された、–W オプションで負の行長が指定された、あるいは使用法に誤りがあった。

3

ユーザー終了 (quit)。

4

無効な書式引数。

属性

属性についての詳細は、マニュアルページの attributes(5) を参照してください。

属性タイプ 属性値 使用条件 system/core-os

関連項目

attributes(5)

注

cktime のデフォルトのプロンプトは、次のとおりです。

Enter a time of day [?,q]:

デフォルトのエラーメッセージは、次のとおりです。

ERROR: Please enter the time of day.  Format is <format>.

デフォルトのヘルプメッセージは、次のとおりです。

Please enter the time of day.  Format is <format>.

終了オプションを選択した場合 (かつ使用できる場合) は、リターンコード 3 と共に q が返されます。valtime モジュールは、出力を生成しません。正常終了した場合は 0、失敗した場合には 0 以外の値を返します。