以執行 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" 。