maildirildir.</P ><P >Folders are simply subdirectories inside the main maildir whose names start with a period, and which are themselves maildirs. For example, the command "<B CLASS="COMMAND" >maildirmake -f Drafts mail/Maildir</B >" creates <TT CLASS="FILENAME" >mail/Maildir/.Drafts</TT >, that has the usual <TT CLASS="FILENAME" >tmp</TT >, <TT CLASS="FILENAME" >new</TT > and <TT CLASS="FILENAME" >cur</TT >. You MUST use the <VAR CLASS="OPTION" >-f</VAR > option, instead of specifying <TT CLASS="FILENAME" >mail/Maildir/.Drafts</TT > directly, in order to correctly initialize certain enhanced maildir features.</P ><P >Folders cannot be created directly within other folders. Running <B CLASS="COMMAND" >maildirmake -f Urgent mail/Maildir/.Drafts</B > will not work. Instead, the period character is designated as a hierarchy separator, run <B CLASS="COMMAND" >maildirmake -f Drafts.Urgent mail/Maildir</B > instead. This creates <TT CLASS="FILENAME" >mail/Maildir/.Drafts.Urgent</TT >, and all mail software that supports enhanced maildirs will interpret it as a subfolder Urgent of the Drafts folder.</P ></DIV ><DIV CLASS="REFSECT2" ><A NAME="AEN89" ></A ><H3 >SHARED FOLDERS</H3 ><P >This is another extension to the Maildir format that allows folders to be shared between multiple clients.</P ><DIV CLASS="NOTE" ><P ></P ><TABLE CLASS="NOTE" WIDTH="100%" BORDER="0" ><TR ><TD WIDTH="25" ALIGN="CENTER" VALIGN="TOP" >NOTE:</TD ><TD ALIGN="LEFT" VALIGN="TOP" ><P >The Courier-IMAP folder implements two types of shared folders: filesystem permission-based shared folders, as well as virtual shared folders based on IMAP access control lists. Use the <B CLASS="COMMAND" >maildirmake</B > command to implement shared folders based on filesystem permissions. The <A HREF="maildiracl.html" TARGET="_top" ><SPAN CLASS="CITEREFENTRY" ><SPAN CLASS="REFENTRYTITLE" >maildiracl</SPAN >(1)</SPAN ></A > command manages access control lists, which are used by virtual shared folders.</P ><P >See the Courier-IMAP server documentation for more information.</P ></TD ></TR ></TABLE ></DIV ><P >First, you need to create a collection of sharable folders, as a separate maildir: <A NAME="AEN101" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" ><DIV CLASS="INFORMALEXAMPLE" ><P ></P ><A NAME="AEN102" ></A ><P CLASS="LITERALLAYOUT" ><B CLASS="COMMAND" >maildirmake -S /usr/local/share/maildirs/notices</B ></P ><P ></P ></DIV ></BLOCKQUOTE ></P ><P >Then, create individuals folders that will be accessed in shared mode: <A NAME="AEN106" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" ><DIV CLASS="INFORMALEXAMPLE" ><P ></P ><A NAME="AEN107" ></A ><P CLASS="LITERALLAYOUT" ><B CLASS="COMMAND" >maildirmake -s write -f Weekly /usr/local/share/maildirs/notices</B ></P ><P ></P ></DIV ></BLOCKQUOTE ></P ><P >In this example, the "Weekly" folder is created, with read/write access to everyone. Multiple folders can be created in the same maildir, with different access permissions. Everyone can create a sharable maildir. The access privileges for individual folders are set by the <VAR CLASS="OPTION" >-s</VAR > option, and are implemented using traditional filesystem permissions.</P ><P >Use the <VAR CLASS="OPTION" >--add</VAR > and <VAR CLASS="OPTION" >--del</VAR > options to add a sharable maildir to an existing maildir. Client software that implements this extension will now know where to find sharable folders: <A NAME="AEN115" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" ><DIV CLASS="INFORMALEXAMPLE" ><P ></P ><A NAME="AEN116" ></A ><P CLASS="LITERALLAYOUT" ><B CLASS="COMMAND" >maildirmake --add notices=/usr/local/share/maildirs/notices $HOME/Maildir</B ></P ><P ></P ></DIV ></BLOCKQUOTE ></P ><P ><TT CLASS="FILENAME" >$HOME/Maildir</TT > is your main maildir. The argument to <VAR CLASS="OPTION" >-add</VAR > is <VAR CLASS="REPLACEABLE" >nick</VAR >=<VAR CLASS="REPLACEABLE" >path</VAR >. <VAR CLASS="REPLACEABLE" >nick</VAR > is a nickname for this collection of sharable folders, and <VAR CLASS="REPLACEABLE" >path</VAR > is the location of the sharable maildir. All folders in the sharable maildir that you have access to -- such as "Weekly", in this case, will now be accessible. Multiple sharable maildirs can be added, by giving each one a unique <VAR CLASS="REPLACEABLE" >nick</VAR >.</P ><P >The <VAR CLASS="OPTION" >--del</VAR > option "disconnects" the sharable maildir from the main maildir.</P ></DIV ><DIV CLASS="REFSECT2" ><A NAME="AEN129" ></A ><H3 >GLOBAL SHARED FOLDERS</H3 ><P >Normally <VAR CLASS="OPTION" >-add</VAR > command must be run for every maildir which needs to access the sharable maildir. Alternatively the file <TT CLASS="FILENAME" >/etc/courier/maildirshared</TT > can be created, to specify a default set of sharable maildirs. Each line in this file takes the following format: <A NAME="AEN134" ></A ><BLOCKQUOTE CLASS="BLOCKQUOTE" ><DIV CLASS="INFORMALEXAMPLE" ><P ></P ><A NAME="AEN135" ></A ><P CLASS="LITERALLAYOUT" ><VAR CLASS="REPLACEABLE" >nick</VAR ><SPAN CLASS="TOKEN" ><tab></SPAN ><VAR CLASS="REPLACEABLE" >path</VAR ></P ><P ></P ></D