| 1 |
.. _imap-developer-guidance-special-chars: |
| 2 |
|
| 3 |
.. Note: This document was converted from the original by Nic Bernstein |
| 4 |
(Onlight). Any formatting mistakes are my fault and not the |
| 5 |
original author's. |
| 6 |
|
| 7 |
Cyrus IMAP Server: Special Characters |
| 8 |
===================================== |
| 9 |
|
| 10 |
This document is supposed to be a repository of "special characters" |
| 11 |
used in Cyrus naming of users, folders, directory paths, etc. |
| 12 |
|
| 13 |
Current Uses |
| 14 |
------------ |
| 15 |
|
| 16 |
| |
| 17 |
| Character: + |
| 18 |
|
| 19 |
- (LMTP) Separation of postuser and target mailbox for delivery |
| 20 |
- (LMTP) Separation of username and submailbox for delivery |
| 21 |
- (IMAP) Flag at end of login name that indicates that LIST should |
| 22 |
return LSUB results (when imapmagicplus is set) |
| 23 |
- (POP3) POP a subfolder directly (e.g. rjs3+foo POPs user.rjs3.foo) |
| 24 |
|
| 25 |
| |
| 26 |
| Character: . / |
| 27 |
|
| 28 |
- [mailbox names] Hierarchy separators |
| 29 |
|
| 30 |
| |
| 31 |
| Character: ^ |
| 32 |
|
| 33 |
- [mailbox names] In unixhierarchysep, ^ is the part of the internal |
| 34 |
name that represents a '.' |
| 35 |
|
| 36 |
| |
| 37 |
| Characters: @ % |
| 38 |
|
| 39 |
- [usernames] These are realm separators for the purposes of |
| 40 |
authentication |
| 41 |
|
| 42 |
| |
| 43 |
|
| 44 |
Future Uses |
| 45 |
----------- |
| 46 |
|
| 47 |
| Character: + |
| 48 |
|
| 49 |
- IMAP LIST filters (e.g. rjs3+foo will only list folders that match |
| 50 |
foo\*) |
| 51 |
- possibly other interpretations here: |
| 52 |
- rjs3+foo will do an effective chroot(foo.) |
| 53 |
- rjs3+foo will only list folders in user.rjs3.foo\* |