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 be invoked by  master(8)  with
17       those descriptors attached to a remote client connection.
18
19       httpd reads its configuration options out of the imapd.conf(5) file un‐
20       less 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 en‐
44              crypted 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 ex‐
48              ists.  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 be‐
69       ginning 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), master(8)
78

AUTHOR

80       The Cyrus Team, Nic Bernstein (Onlight)
81

83       1993–2023, The Cyrus Team
84
85
86
87
883.8.1                            Sep 11, 2023                         HTTPD(8)
Impressum