/usr/share/doc/cyrus-doc/html/install-admin-mb.html is in cyrus-doc 2.4.18-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 | <!-- $Id: install-admin-mb.html,v 1.7 2010/01/06 17:01:29 murch Exp $ -->
<HTML>
<HEAD>
<TITLE>Administering Mailboxes
</title>
</head>
<h1>Administering Mailboxes</h1>
<body>
The "<tt>cyradm</tt>" command (see the <tt>cyradm</tt>(1) man page for
complete documentation) manages the creation of, deletion of, ACLs on,
and quotas on mailboxes. To get an overview of the command, type
"<kbd>cyradm <var><host></var></kbd>". Once "<tt>cyradm</tt>" has started,
the user prompt is replaced with the name of the host followed by a
"<tt>></tt>". Type "<kbd>help</kbd>" at the new prompt. The
following information is displayed:
<pre>
createmailbox, cm create a mailbox
deleteaclmailbox, dam delete an ACL on a mailbox
deletemailbox, dm delete a mailbox
help get help on commands
listaclmailbox, lam list the ACL on a mailbox
listmailbox, lm list mailboxes
listquota, lq list quota on root
listquotaroot, lqr, lqm list quota roots on mailbox
quit exit program
renamemailbox, renm rename a mailbox
setaclmailbox, sam set an ACL on a mailbox
setquota, sq set quota limits
</pre>
<b>Note:</b>It's not necessary to run "<tt>cyradm</tt>" on the same
system as the IMAP server.
<p><b>Note:</b>If you run "<tt>cyradm</tt>" on a system not using
Kerberos for authentication, you will be prompted for your user name
and password before you can issue any "<tt>cyradm</tt>" commands. By
default, you will be prompted for the password of the user ID of the
current shell. If you want to authenticate as a different user, use
the "<tt>-a</tt>" option. If the user that you authenticate as is a
Cyrus admin, you can proxy as a particular user by also using the
"<tt>-u</tt>" option.
<p>The mailbox naming convention requires that the primary mailbox (INBOX)
for anyone must be named "<tt>user.<var><userid></var></tt>".
To create a mailbox, type:
<pre>
<kbd> createmailbox user.<var><userid></var>
</kbd></pre>
For example, to create a mailbox for the userid "<tt>smith</tt>", type:
<pre>
<kbd> createmailbox user.smith
</kbd></pre>
To limit "<tt>smith</tt>" to 10,000 kilobytes of mail, type:
<pre>
<kbd> setquota user.smith 10000
</kbd></pre>
Once the INBOX is created, users can create their own additional mailboxes
from a mail program. If Smith created a work mailbox and a play mailbox,
the full names of the mailboxes would be:
<pre>
user.smith.work
user.smith.play
</pre>
<p>Access rights are discussed in detail in the <tt>cyradm</tt>(1) man pages.
Note that the administrator must grant herself create/delete access
explicitly before she can delete a mailbox:
<pre>
<kbd> setaclmailbox <var><mail_box></var> <var><admin_userid></var> c
deletemailbox <var><mail_box></var>
</kbd></pre>
Once you have created mailboxes, your IMAP server installation is
done. You must then configure a mail interface, such as <a
href="http://www.washington.edu/pine/">Pine</a> or <a
href="http://www.cyrusoft.com/mulberry/">Mulberry</a>, to work with the
IMAP server.
<P><HR>
last modified: $Date: 2010/01/06 17:01:29 $
</BODY></HTML>
|