| 1 |
.. cyrusman:: cyr_deny(8) |
| 2 |
|
| 3 |
.. author: Nic Bernstein (Onlight) |
| 4 |
|
| 5 |
.. _imap-reference-manpages-systemcommands-cyr_deny: |
| 6 |
|
| 7 |
============ |
| 8 |
**cyr_deny** |
| 9 |
============ |
| 10 |
|
| 11 |
deny users access to Cyrus services |
| 12 |
|
| 13 |
Synopsis |
| 14 |
======== |
| 15 |
|
| 16 |
.. parsed-literal:: |
| 17 |
|
| 18 |
**cyr_deny** [ **-C** *config-file* ] [ **-s** *services* ] [ **-m** *message* ] *user* |
| 19 |
**cyr_deny** [ **-C** *config-file* ] **-a** *user* |
| 20 |
**cyr_deny** [ **-C** *config-file* ] **-l** |
| 21 |
|
| 22 |
Description |
| 23 |
=========== |
| 24 |
|
| 25 |
**cyr_deny** is used to deny individual users access to Cyrus services. |
| 26 |
The first synopsis denies user *user* access to Cyrus services, the |
| 27 |
second synopsis allows access again. **cyr_deny** works by adding an |
| 28 |
entry to the Cyrus ``user_deny.db`` database; the third synopsis lists |
| 29 |
the entries in the database. The service names to be matched are those |
| 30 |
as used in :cyrusman:`cyrus.conf(5)`. |
| 31 |
|
| 32 |
**cyr_deny** |default-conf-text| |
| 33 |
|
| 34 |
Options |
| 35 |
======= |
| 36 |
|
| 37 |
.. program:: cyr_deny |
| 38 |
|
| 39 |
.. option:: -C config-file |
| 40 |
|
| 41 |
|cli-dash-c-text| |
| 42 |
|
| 43 |
.. option:: -a, --allow |
| 44 |
|
| 45 |
Allow access to all services for user *user* (remove any entry |
| 46 |
from the deny database). |
| 47 |
|
| 48 |
.. option:: -s services, --services=services |
| 49 |
|
| 50 |
Deny access only to the given *services*, which is a |
| 51 |
comma-separated list of wildcard patterns. The default is "*" |
| 52 |
which denies access to all services. |
| 53 |
|
| 54 |
|
| 55 |
.. option:: -m message, --message=message |
| 56 |
|
| 57 |
Provide a message which is sent to the user to explain why access is |
| 58 |
being denied. A default message is used if none is specified. |
| 59 |
|
| 60 |
.. option:: -l, --list |
| 61 |
|
| 62 |
List the entries in the deny database. |
| 63 |
|
| 64 |
Examples |
| 65 |
======== |
| 66 |
|
| 67 |
[NB: Examples needed] |
| 68 |
|
| 69 |
History |
| 70 |
======= |
| 71 |
|
| 72 |
|v3-new-command| |
| 73 |
|
| 74 |
Files |
| 75 |
===== |
| 76 |
|
| 77 |
/etc/imapd.conf, <configdirectory>/user_deny.db |
| 78 |
|
| 79 |
See Also |
| 80 |
======== |
| 81 |
|
| 82 |
:cyrusman:`imapd.conf(5)` |