3. Conventions Used in This Document (本文档中的约定)
3. Conventions Used in This Document (本文档中的约定)
与 SSH 协议相关的所有文档在描述需求时应使用关键词 MUST, MUST NOT, REQUIRED, SHALL, SHALL NOT, SHOULD, SHOULD NOT, RECOMMENDED, MAY 与 OPTIONAL. 这些关键词应按 [RFC2119] 中所述解释. 在中文叙述中, 对应关系可理解为: MUST 表示必须, SHOULD 表示应该, MAY 表示可以 (以及 MUST NOT 表示不得, SHOULD NOT 表示不应等).
当本文档中出现用于描述命名空间分配的关键词 PRIVATE USE, HIERARCHICAL ALLOCATION, FIRST COME FIRST SERVED, EXPERT REVIEW, SPECIFICATION REQUIRED, IESG APPROVAL, IETF CONSENSUS 与 STANDARDS ACTION 时, 应按 [RFC2434] 中所述解释.
协议字段及其可填取值在本系列文档中定义. 字段在消息定义中给出. 例如, SSH_MSG_CHANNEL_DATA 定义如下.
byte SSH_MSG_CHANNEL_DATA
uint32 recipient channel
string data
在本系列文档中, 引用字段时使用单引号; 引用填入字段的取值时使用双引号. 依上例, data 的可能取值为 "foo" 与 "bar".