运行命令行实用程序

以运行 Calendar Server 的用户和组身份或以 root 身份登录时，运行命令行实用程序。这将在安装过程中指定，默认为 icsuser 和 icsgroup。

例如，如果 Calendar Server 基目录为 cal_svr_base，要运行 cscal 实用程序的 list 命令，应在登录后执行以下命令：

cd cal_svr_base/SUNWics5/cal/sbin
./cscal list

命令行实用程序的语法

Calendar Server 命令行实用程序使用以下语法：

utility [ -option [value]] command [target]

其中：

utility 是可执行实用程序的名称，例如 cscal 或 csuser。

option 决定命令要执行的操作。选项以小写字母表示，前面带有连字符 (-)，例如 -d。括号 ([]) 内的选项为可选选项。如果表明是可选选项，则可以同时使用两个或多个选项。

value 进一步限制了 option 指定的操作，例如随 -d 选项一起使用的说明。括号 ([]) 内的值为可选值。包含空格的值必须括在双引号 (" ") 中。多个值必须括在双引号 (" ") 中，值与值之间必须用空格隔开，除非另有说明（例如使用分号分隔的列表）。

command 是实用程序执行的操作，例如 list 或 create。命令之间用竖线 (|) 隔开，表示可以使用任意一条命令，但不能同时使用这两条命令。

target 是命令执行的对象，例如日历 ID 或用户 ID。

命令行实用程序使用规则

以下规则是命令行实用程序的一般使用准则：

• 如果只指定实用程序名称，它将列出所有命令、选项和多个示例。

• 如果不指定必需的密码，实用程序将提示您输入密码。

• -v（详细）和 -q（静默）选项可用于所有实用程序。

• 如果某个命令具有破坏性（即，可能会导致数据丢失），实用程序将在执行该命令之前提示用户进行确认。举例来说，cscal 和 csuser 就是具有破坏性的命令，前者可以删除日历，后者可以删除用户。但 -q（静默）选项可以禁用确认提示。

• version 命令可用于所有实用程序。

脚本中的返回码

如果从脚本中运行命令行实用程序，则实用程序运行成功时，返回码为 "0"，运行失败时返回码为 "-1"。