手册页部分 1: 用户命令

退出打印视图

更新时间: 2014 年 7 月
 
 

ckdate(1)

名称

ckdate, errdate, helpdate, valdate - 提示输入并验证日期

用法概要

ckdate [-Q] [-W width] [-f format] [-d default] [-h help] 
     [-e error] [-p prompt] [-k pid [-s signal]]
/usr/sadm/bin/errdate [-W width] [-e error] [-f format]
/usr/sadm/bin/helpdate [-W width] [-h help] [-f format]
/usr/sadm/bin/valdate [-f format] input

描述

ckdate 实用程序可提示用户并验证回复。其作用之一是定义回复应该为日期的提示消息、帮助和错误消息的文本以及缺省值(用户按 RETURN 键时返回)。用户回复必须符合定义的日期格式。

所有消息的长度均不得超过 70 个字符,消息格式将自动设置。定义中使用的任何空格(包括换行符)都将除去。使用 –W 选项可以取消自动格式设置。如果在消息定义开头或结尾输入波浪号,将在该位置插入缺省文本,这样便可同时显示定制文本和缺省文本。

如果未定义提示、帮助或错误消息,将显示缺省消息(如“附注”部分所定义)。

有三个可视化工具模块与 ckdate 命令关联。分别是 errdate(用于错误消息的格式设置和显示)、helpdate(用于帮助消息的格式设置和显示)和 valdate(用于验证回复)。这些模块应该与 FML 对象一起使用。在这种情况下,FML 对象将定义提示。如果在 errdatehelpdate 模块中定义了 format,则消息将说明应当采用的格式。

选项

支持以下选项:

–d default

将缺省值定义为 default。缺省值无需符合格式条件。

–e error

将错误消息定义为 error

–f format

指定验证输入所依据的格式。可能的格式及其定义如下:

%b =

缩写的月份名称(例如 jan、feb、mar)

%B =

完整的月份名称 %d = 月中某日 (01 - 31)

%D =

%m/%d/%y 格式(缺省格式)的日期

%e =

月中某日(1 - 31;一个数字前面有一个空格)

%h =

缩写的月份名称,与 %b% 相同

%m =

月份数字 (01 - 12)

%y =

一个世纪内的年份(例如 89)

%Y =

CCYY 格式的年份(例如 1989)

–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)

附注

ckdate 的缺省提示为:

Enter the date [?,q]:

缺省错误消息为:

ERROR - Please enter a date.  Format is <format>.

缺省帮助消息为:

Please enter a date. Format is <format>.

如果选择了退出选项(并且经过允许),将返回 q 以及返回代码 3。valdate 模块不会生成任何输出。如果成功,将返回零;如果失败,将返回非零值。