手册页部分 1: 用户命令

退出打印视图

更新时间: 2014 年 7 月
 
 

Intro(1)

名称

Intro , intro - 命令和应用程序的介绍

描述

本节介绍了此操作系统可用的命令(按字母顺序排列)。

需特别关注的页面归类如下:

1B

只能在 SunOS/BSD 兼容性软件包中找到的命令。

1C

用于与其他系统进行通信的命令。

1G

Solaris 命令的替代开源实现。

1S

特定于 SunOS 的命令。

其他节

有关更多信息,请参见 SunOS 参考手册的以下各节。

  • 第 1M 节介绍了系统维护命令。

  • 第 4 节介绍了有关文件格式的信息。

  • 第 5 节是关于公共可用文件和杂项信息页的描述。

有关这些命令和过程的教程信息,请参见在 Oracle Solaris 11.2 中管理系统信息、进程和性能

手册页命令语法

除非另有说明,手册页的“用法概要”部分介绍的命令将按以下语法接受选项和其他参数,并应按下述方式进行解释。

name [option...] [cmdarg...] 其中:

[ ]

将非必需的选项cmdarg 括在其中。

...

表示有多个选项cmdarg

name

可执行文件的名称。

{ }

括在大括号内的选项和/或参数是相互依赖的,因此必须将大括号中的所有内容视为一个单元。

option

(始终以 "-" 开头。)noargletter... 或 argletter optarg[,...]

noargletter

表示不带选项参数的选项的单个字母。注意,可以将多个 noargletter 选项组合在一个 "-" 之后(请参见下文的准则 5)。

argletter

表示需要选项参数的选项的单个字母。

optarg

符合前面的某个 argletter 的选项参数(字符串)。请注意,在 argletter 后面的 optargs 组必须以逗号分隔,或者以制表符或空格字符分隔并用引号括起来(请参见下文的准则 8)。

cmdarg

以 "-" 开头的路径名(或其他命令参数),或者本身表示标准输入的 "-"。

除非另有说明,否则,只要操作数或选项参数是数字值,或者包含数字值:

  • 该数字就被解释为十进制整数。

  • 0 到 2147483647 范围内的数字从语法上可识别为数字值。

  • 如果实用程序描述中指出它可接受负数作为操作数或选项参数,则 -2147483647 到 2147483647 范围内的数字从语法上可识别为数字值。

  • 允许比此处列出的范围更大的范围。

命令语法标准:准则

并不是所有当前命令都遵循这些命令语法准则,但新命令很可能遵循它们。所有 shell 程序都应当使用 getopts(1) 来解析位置参数和检查合法选项。它支持下面的准则 3 至 10。其他准则的实施必须由命令本身来执行。

  1. 命令名称(请参见上面的 name)的长度应该为 2 到 9 个字符。

  2. 命令名称应该只包括小写字母和数字。

  3. 选项名称(请参见上面的 option)的长度必须为一个字符。

  4. 所有选项都必须以 "-" 开头。

  5. 可以将没有参数的多个选项组合在单个 "-" 之后。

  6. 一个选项之后的第一个选项参数(请参见上面的 optarg)必须以制表符或空格字符开头。

  7. 选项参数不是可选的。

  8. 一个选项之后的选项参数组必须以逗号分隔,或者以制表符或空格字符分隔并用引号括起来(–o xxx,z,yy 或 –o"xxx z yy")。

  9. 在命令行上所有选项都必须位于操作数(请参见上面的 cmdarg)之前。

  10. "- -" 可以用来表示选项的结尾。

  11. 选项相对于彼此的顺序应当无关紧要。

  12. 操作数(请参见上面的 cmdarg)的相对顺序能够以操作数随之出现的命令所决定的方式影响操作数的意义。

  13. 只应使用前后都有一个空格字符的 "-" 来表示标准输入。

已经为 Solaris 和其他 Sun 产品开发了一组扩展的准则,称为 CLIP,即命令行界接口范例 (Command Line Interface Paradigm)。其目的是提供与 Linux 系统上广泛应用的 GNU 命令行语法更为密切一致的命令行语法,而不是为了改进现有的实用程序或将此应用于所有新的实用程序。按照计划,该组扩展准则只在合适的时候应用于正在开发中的实用程序集。

CLIP 是上面讨论的准则的一个完整超集,与 IEEE Std. 1003.1-2001 (SUSv3) 密切一致。它并未包括所有的 GNU 语法。GNU 语法允许使用与 IEEE 规则冲突的结构或具有二义性的结构。这些结构是不允许的。

扩展的 CLIP 命令行语法为:

utility_name -a --longopt1 -c option_argument \
   -f option_argument --longopt2=option_argument \
   --longopt3 option_argument operand

示例中的实用程序被命名为 utility_name。它后面跟有选项、选项参数和操作数,这些统称为参数。由一个连字符及紧跟其后的单个字母或数字组成的参数(如 –a)称为短选项。由两个连字符及紧跟其后的一系列字母、数字和连字符组成的参数(如 –-longopt1)称为长选项。短选项和长选项统称为选项(以前称为标志)。某些选项后面跟有选项参数,如 –c option_argument 所示。最后一个选项和选项参数后面的参数称为操作数。一旦遇到第一个操作数,所有后续的参数都被解释为操作数。

选项参数有时显示为以空格与其短选项隔开,有时显示为直接相邻。这反映了以下情形,在某些情况下,选项参数与选项包含在同一参数字符串内;大多数情况下,它作为下一个参数。此规范要求选项是与其选项参数隔开的一个参数,但为确保以前的应用程序能够继续运行,也有一些例外。

  • 如果实用程序的“用法概要”部分在短选项和选项参数之间显示了一个空格(如此示例中的 –c option_argument 所示),则应用程序应当将该选项及其选项参数用作隔开的参数。

  • 如果未显示空格(如此示例中的 –f option_argument 所示),则应用程序期望选项与其选项参数在同一参数字符串中直接相邻,而不插入空格。

  • 尽管存在上述要求,但无论概要行中是否存在空格,应用程序都应接受短选项和选项参数作为单个参数或隔开的参数。

  • 具有选项参数的长选项始终规定如下:使用等号作为选项名称和选项参数之间的分隔符。如果实用程序的“选项”部分在长选项与其选项参数之间显示了一个等号 (=)(如此示例中的 –-longopt2= option_argument 所示),则应用程序应当还允许将该选项与其选项参数作为隔开的参数使用(如此示例中的 –-longopt1 option_argument 所示)。

CLIP 扩展了前面讨论的准则,附加了下列准则:

14.

可以使用 command subcommand [options] [operands] 格式对类似的操作进行分组。子命令名称应该与命令名称遵循相同的约定,如准则 1 和 2 中所述。

15.

长选项应该以 –- 开头,并且只应当包含可移植字符集中的字母数字字符和连字符。选项名称通常为 1 到 3 个单词长度,并以连字符分隔每个单词。

16.

应当使用 –-name=argument 来指定长选项的选项参数。还允许 –-name argument 格式。

17.

所有实用程序都应该支持两个标准长选项:–-version(具有短选项同义词 –V)和 –-help(具有短选项同义词 –?)。如果 –-version 的该首选短选项同义词已被使用,可以更换其短选项同义词(但必须提供一个短选项同义词)。在遇到这两个选项时,都会停止进一步处理参数,并且在显示相应的输出后,实用程序会成功退出。

18.

每个短选项只应当有一个对应的长选项,每个长选项只应当有一个对应的短选项。为了与以前的做法或等效实用程序的社区版本兼容,允许使用同义选项。

19.

短选项名称应该根据以下规则从长选项名称中获取:

  1. 使用长选项名称的第一个字母作为短选项名称。

  2. 如果第一个字母与其他短选项名称冲突,则选择一个显眼的辅音字母。

  3. 如果第一个字母和显眼的辅音字母均与其他短选项名称冲突,则选择一个显眼的元音字母。

  4. 如果长选项名称中的字母都不可用,则选择一个任意字符。

20.

如果长选项名称由单个字符组成,它必须使用同一字符作为短选项名称。应避免单字符的长选项。只有单个字符是最具描述性的名称时,才允许单字符的长选项,这种情况极少。

21.

附加的 CLIP 准则的准则 1 中描述的这种格式的子命令一般是必需的。如果省略了该子命令,则命令将不接受任何操作数,并且只允许所定义的在遇到时会停止进一步处理参数的选项。在不提供子命令和参数的情况下使用此格式调用命令是错误的。提供此准则是为了允许以命令-子命令结构接受常用格式的命令 –-help、命令 –?、命令 –-version 以及命令 –V

其中的一些准则只有实用程序的创作者才会感兴趣。在此处提供它们是为了方便想要编写遵循此语法的实用程序的人使用。

致谢

致谢

Oracle America, Inc. 非常感谢 The Open Group 允许复制版权归其所有的部分文档。可以通过 http://www.opengroup.org/bookstore/ 在线访问 The Open Group 的原始文档。

美国电气及电子工程师学会 (Institute of Electrical and Electronics Engineers, IEEE) 与 The Open Group 已授予我们部分翻印其文档的权限。

在以下陈述中,短语“此文本”指部分的系统文档。

Sun 操作系统参考手册中以电子形式从以下来源翻印和复制了此文本的一部分:IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX),The Open Group Base Specifications Issue 6, 版权所有 (C) 2001-2004,美国电气及电子工程师学会与 The Open Group。In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document.原始标准可通过 http://www.opengroup.org/unix/online.html 在线访问。

在所有包含该资料的产品中都应提供此声明。

另请参见

getopts(1)wait(1)exit(2)getopt(3C)

诊断

在终止时,每个命令返回两个状态字节,一个由系统提供并给出终止原因,在“正常”终止的情况下,另一个由程序提供 [请参见 exit(2)]。前一个字节为 0,表示正常终止。后一个字节通常为 0,表示成功执行,而非零则表示出现故障,例如参数错误、数据错误或无法访问数据。它的名称不一,可称为“退出代码”、“退出状态”或“返回代码”,仅在涉及特殊约定时才会进行描述。

警告

当处理包含空字符的文件时,某些命令会产生异常结果。这些命令通常将文本输入行视为字符串,因此在行中遇到空字符(字符串结束符)时会出现混乱。