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 命令关联。分别是 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

指定不允许退出作为有效的响应。

–s signal

指定如果选择退出，将向使用 –k 选项定义的进程 ID pid 发送信号 signal。如果未指定信号，将使用 SIGTERM。

–W width

指定提示、帮助和错误消息的格式设置：行长度为 width。

操作数

支持下列操作数：

input

要根据格式条件验证的输入。

退出状态

将返回以下退出值：

0

成功执行。

1

输入中出现 EOF、–W 选项中的宽度为负数或者用法错误。

3

用户终止（退出）。

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>.

如果选择了退出选项（并且经过允许），将返回 q 以及返回代码 3。valtime 模块不会生成任何输出。如果成功，将返回0 ；如果失败，将返回非零值。