1HTTPD(8)                          Cyrus IMAP                          HTTPD(8)
2
3
4

NAME

6       httpd - Cyrus IMAP documentation
7
8       HTTP server process
9

SYNOPSIS

11       httpd [ -C config-file ] [ -U uses ] [ -T timeout ] [ -D ]
12           [ -s ] [ -p ssf ] [ -q ]
13

DESCRIPTION

15       httpd  is an HTTP server. It accepts commands on its standard input and
16       responds on its standard output. It  MUST  invoked  by  cyrus-master(8)
17       with those descriptors attached to a remote client connection.
18
19       httpd  reads  its  configuration  options out of the imapd.conf(5) file
20       unless specified otherwise by -C.
21
22       If the directory <configdirectory>/log/user  exists,  then  httpd  will
23       create protocol telemetry logs for sessions authenticating as user. The
24       telemetry logs will be stored in the log/user directory with a filename
25       of the httpd process-id.
26

OPTIONS

28       -C config-file
29              Use the specified configuration file config-file rather than the
30              default imapd.conf(5).
31
32       -U uses
33              The maximum number of times that the process should be used  for
34              new connections before shutting down.  The default is 250.
35
36       -T timeout
37              The  number of seconds that the process will wait for a new con‐
38              nection before shutting down.  Note that a  value  of  0  (zero)
39              will disable the timeout.  The default is 60.
40
41       -D     Run external debugger specified in debug_command.
42
43       -s     Serve  HTTP  over  SSL  (https).   All data to and from httpd is
44              encrypted using the Secure Sockets Layer.
45
46       -p ssf Tell httpd that an external  layer  exists.   An  SSF  (security
47              strength  factor)  of  1  means  an  integrity  protection layer
48              exists.  Any higher SSF implies some form of privacy protection.
49
50       -q     Ignore quotas on DAV appends. This  feature  was  introduced  in
51              version 3.0.
52

EXAMPLES

54       httpd  is  commonly  included  in the SERVICES section of cyrus.conf(5)
55       like so:
56
57       SERVICES {
58           imap        cmd="imapd -U 30" listen="imap" prefork=0
59           imaps       cmd="imapd -s -U 30" listen="imaps" prefork=0 maxchild=100
60           lmtpunix    cmd="lmtpd" listen="/var/run/cyrus/socket/lmtp" prefork=0 maxchild=20
61           sieve       cmd="timsieved" listen="sieve" prefork=0
62           notify      cmd="notifyd" listen="/var/run/cyrus/socket/notify" proto="udp" prefork=1
63           httpd       cmd="httpd" listen=8080 prefork=1 maxchild=20
64       }
65

HISTORY

67       A beta release of httpd was first introduced in the  caldav  branch  of
68       Cyrus  in  version  2.4.17,  and  was included in the mainline releases
69       beginning in version 2.5.0.
70
71       The quota override option, -q, was introduced with Cyrus version 3.0.
72

FILES

74       /etc/imapd.conf
75

SEE ALSO

77       imapd.conf(5), cyrus-master(8)
78

AUTHOR

80       The Cyrus Team, Nic Bernstein (Onlight)
81
83       1993-2017, The Cyrus Team
84
85
86
87
883.0.7                            May 18, 2018                         HTTPD(8)
Impressum