master-interface.h revision cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen/* We are attempting semi-compatibility with Postfix's master process here.
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen Whether this is useful or not remains to be seen. */
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen/* Child processes should send status updates whenever they accept a new
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen connection (decrease available_count) and when they close existing
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen connection (increase available_count). */
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen /* uid is used to check for old/invalid status messages */
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen unsigned int uid;
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen /* number of new connections process is currently accepting */
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen/* When connecting to log service, send this handshake first */
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen /* If magic is invalid, assume the data is already what we want
8e0ce05530ca549ce1dd402f43084a6fa15f05b4Timo Sirainen /* Add this prefix to each logged line */
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen /* unsigned char prefix[]; */
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen/* getenv(MASTER_UID_ENV) provides master_status.uid value */
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen/* getenv(MASTER_CLIENT_LIMIT_ENV) provides maximum
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen master_status.available_count as specified in configuration file */
788f275469ad9ed530e440d6690d0e4381a323b2Timo Sirainen/* getenv(MASTER_SERVICE_COUNT_ENV) specifies how many client connections the
788f275469ad9ed530e440d6690d0e4381a323b2Timo Sirainen process can finish handling before it should kill itself. */
788f275469ad9ed530e440d6690d0e4381a323b2Timo Sirainen#define MASTER_SERVICE_COUNT_ENV "SERVICE_COUNT"
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen/* getenv(MASTER_CONFIG_FILE_ENV) provides path to configuration file/socket */
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen/* getenv(MASTER_DOVECOT_VERSION_ENV) provides master's version number */
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen#define MASTER_DOVECOT_VERSION_ENV "DOVECOT_VERSION"
43d7e7ce608f5451e4907b5f5c48c00beb265802Timo Sirainen/* getenv(MASTER_SSL_KEY_PASSWORD_ENV) returns manually typed SSL key password,
43d7e7ce608f5451e4907b5f5c48c00beb265802Timo Sirainen if dovecot was started with -p parameter. */
43d7e7ce608f5451e4907b5f5c48c00beb265802Timo Sirainen#define MASTER_SSL_KEY_PASSWORD_ENV "SSL_KEY_PASSWORD"
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen/* Write pipe to anvil. */
cf0ad1a0bddb0787f3d7b408a96d721a8b2a98a3Timo Sirainen/* Master's "all processes full" notification fd for login processes */
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen/* Shared pipe to master, used to send master_status reports */
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen/* First file descriptor where process is expected to be listening.
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen The file descriptor count is given in -s parameter, defaulting to 1.
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen master_status.available_count reports how many accept()s we're still
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen accepting. Once no children are listening, master will do it and create
d176f84ce5ca2073f4dfbafb457b9c74f6bf0d76Timo Sirainen new child processes when needed. */