ckpath(1)

名称

ckpath , errpath , helppath , valpath - 显示提示；验证并返回路径名

用法概要

ckpath [-Q] [-W width] [-a | l] [-b | c | f | y] 
     [-n [o | z]] [-rtwx] [-d default] [-h help] 
     [-e error] [-p prompt] [-k pid [-s signal]]

/usr/sadm/bin/errpath [-W width] [-a | l] [-b | c | f | y] 
     [-n [o | z]] [-rtwx] [-e error]

/usr/sadm/bin/helppath [-W width] [-a | l] [-b | c | f | y] 
     [-n [o | z]] [-rtwx] [-h help]

/usr/sadm/bin/valpath [-a | l] [-b | c | f | y] 
     [-n [o | z]] [-rtwx] input

描述

ckpath 实用程序可提示用户并验证回复。其作用之一是定义回复应该为路径名的提示消息、帮助和错误消息的文本以及缺省值（用户按 RETURN 键时返回）。

路径名必须符合第一组选项指定的条件。如果未定义条件，则路径名必须对应于常规文件而且尚未存在。如果 –a（绝对路径）和 –l（相对路径）均未指定，则认为两者均无效。

所有消息的长度均不得超过 79 个字符，消息格式将自动设置。将删除消息定义中一个空格字符后的制表符和换行符，但是不删除空格。如果在消息定义开头或结尾输入波浪号，将在该位置插入缺省文本，这样便可同时显示定制文本和缺省文本。

如果未定义提示、帮助或错误消息，将显示缺省消息（如“示例”部分所定义）。

有三个可视化工具模块与 ckpath 命令关联。分别是 errpath（用于标准输出中错误消息的格式设置和显示）、helppath（用于标准输出中帮助消息的格式设置和显示）和 valpath（用于验证回复）。

选项

支持以下选项：

–a

路径名必须是指绝对路径。

–b

路径名必须对应于块特殊文件。

–c

路径名必须对应于字符特殊文件。

–d default

将缺省值定义为 default。缺省值不进行验证，因此无需符合任何条件。

–e error

将错误消息定义为 error。

–f

路径名必须对应于正规文件。

–h help

将帮助消息定义为 help。

–k pid

指定如果用户选择退出，将向进程 ID pid 发送信号。

–l

路径名必须是指相对路径。

–n

路径名必须不存在（必须是新路径名）。

–o

路径名必须存在（必须是旧路径名）。

–p prompt

将提示消息定义为 prompt。

–Q

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

–r

路径名必须可读。

–s signal

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

–t

路径名必须可创建（可处理）。如果路径名尚未存在，则创建路径名。

–w

路径名必须可写。

–W width

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

–x

路径名必须可执行。

–y

路径名必须对应于目录。

–z

路径名下必须有一个文件的大小大于零字节。

操作数

支持下列操作数：

input

要根据验证选项验证的输入。

示例

ckpath 的缺省消息文本取决于使用的条件选项。

示例 1 缺省提示

ckpath（使用 –a 选项）的缺省提示示例如下：

example% ckpath –a
Enter an absolute pathname [?,q]

示例 2 缺省错误消息

缺省错误消息（使用 –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 (/)

示例 3 缺省帮助消息

缺省帮助消息（使用 –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 (/)

示例 4 退出选项

如果选择了退出选项（并且经过允许），将返回 q 以及返回代码 3。退出输入时会添加一个尾随的换行符。

示例 5 使用 valpath 模块

valpath 模块将生成有关标准错误的使用消息。如果成功，将返回0 ；如果失败，将返回非零值。

example% /usr/sadm/bin/valpath
usage: valpath [–[a|l][b|c|f|y][n|[o|z]]rtwx] input
    .
    .
    .

退出状态

将返回以下退出值：

0

成功执行。

1

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

2

互斥选项。

3

用户终止（退出）。

4

互斥选项。

属性

有关下列属性的说明，请参见 attributes(5)：

属性类型 属性值 可用性 system/core-os

另请参见

signal.h(3HEAD)、attributes(5)