12.1 Smap Configuration

Smap reads its configuration from the main Mailutils configuration file. See Mailutils Configuration File: (mailutils)configuration section `configuration' in GNU Mailutils Manual, for a description of GNU Mailutils configuration system. In few words, this means that it reads the configuration from the GNU Mailutils configuration file. It looks for smap-specific settings in the section ‘program smap’.

The following standard Mailutils statements are understood:

Statement Reference
server See Mailutils Configuration File: (mailutils)Server Settings section `Server Settings' in GNU Mailutils Manual.
auth See Mailutils Configuration File: (mailutils)Auth Statement section `Auth Statement' in GNU Mailutils Manual.
pam See Mailutils Configuration File: (mailutils)PAM Statement section `PAM Statement' in GNU Mailutils Manual.
virtdomain See Mailutils Configuration File: (mailutils)Virtdomain Statement section `Virtdomain Statement' in GNU Mailutils Manual.
radius See Mailutils Configuration File: (mailutils)Radius Statement section `Radius Statement' in GNU Mailutils Manual.
sql See Mailutils Configuration File: (mailutils)SQL Statement section `SQL Statement' in GNU Mailutils Manual.
ldap See Mailutils Configuration File: (mailutils)LDAP Statement section `LDAP Statement' in GNU Mailutils Manual.
debug See Mailutils Configuration File: (mailutils)Debug Statement section `Debug Statement' in GNU Mailutils Manual.
logging See Mailutils Configuration File: (mailutils)Logging Statement section `Logging Statement' in GNU Mailutils Manual.
include See Mailutils Configuration File: (mailutils)Include section `Include' in GNU Mailutils Manual.

Smap uses GNU Mailutils authorization databases to obtain the requested data. This concept is described in detail in Mailutils Configuration File: (mailutils)Auth Statement section `Auth Statement' in GNU Mailutils Manual.

Pmult Conf: user username

After startup switch to the UID and GID of the user username. Example:

 
user meta1m;
Pmult Conf: group groups

When switching to the username privileges, retain also supplementary groups. The argument is a list of group names or GIDs. Example:

 
group (mail, smtp);
Pmult Conf: allgroups bool

If bool is ‘true’, retain all supplementary groups of which the user supplied by the user statement is a member.

Pmult Conf: positive-reply string

If the item is found, reply with the string. Before replying, string is subject to the meta-variable expansion, whereby any sequence ‘${variable}’ is replaced with the value of variable. Valid variable names and their corresponding values are:

key

The lookup key.

name

The ‘name’ field from the retrieved record.

passwd

The ‘passwd’ field from the retrieved record.

uid

The ‘uid’ field from the retrieved record.

gid

The ‘gid’ field from the retrieved record.

gecos

The ‘gecos’ field from the retrieved record.

dir

The ‘dir’ field from the retrieved record.

shell

The ‘shell’ field from the retrieved record.

mailbox

The ‘mailbox’ field from the retrieved record.

quota

The ‘quota’ field from the retrieved record.

Pmult Conf: negative-reply string

If the item is found, reply with the string. Before replying, any occurrence of ‘${key}’ in string is replaced with the actual lookup key.