6.3.9 LIST 命令

参数 (基本形式):

• reference 名称
• 可能包含通配符的 mailbox 名称

参数 (扩展形式):

• selection option (OPTIONAL)
• reference 名称
• mailbox pattern
• return option (OPTIONAL)

响应: 不带标签响应: LIST

结果:

• OK - list 已完成
• NO - list 失败: 无法列出该 reference 或 mailbox 名称
• BAD - 命令未知或参数无效

LIST 命令从客户端可用的所有 mailbox 名称完整集合中返回一个 mailbox 名称子集. 返回零个或多个不带标签的 LIST 响应, 其中包含 name attribute, 层级分隔符, 名称以及可能的扩展信息; 更多细节见 LIST 响应的描述 (第 7.3.1 节).

LIST 命令 SHOULD 快速返回其数据, 不应有不适当的延迟. 扩展 LIST 命令最初由 [RFC5258] 引入, 提供了超出原始 IMAP LIST 命令的能力.

Selection Option 告诉服务器限制 LIST 操作所选择的 mailbox 名称.

Return Option 控制针对每个匹配 mailbox 返回哪些信息.

有关语法, 通配符, selection option 和 return option 的详细规范, 请参考完整 RFC 文本.

---