LDAPVACATION(1)

NAME
ldapvacation - return ``I am not here'' indication

SYNOPSIS
ldapvacation [-VvZ[Z]] [-b searchbase] [-C configfile] [-D binddn] [-d dest] [-f from] [-h ldaphost] [-l logfacility] [-m mailattr] [-p ldapport] [-q query] [-u ldapurl] [-w bindpasswd] [-x spamheader]

DESCRIPTION
ldapvacation returns a message to the sender of a message telling them that you are currently not reading your mail.

The options are as follows:

-V  Show the version number and exit.

-v  Run in verbose mode. Informal message are displayed on standard output and in the syslog.

-Z[Z]
    Issue StartTLS (Transport Layer Security) extended operation. If you use -ZZ, the command will require the operation to be successful.

-b searchbase
    Specify the searchbase for LDAP searches.

-C configfile
    Read configuration options from configfile.

-D binddn
    Specify the distinguished name to use when binding to the LDAP server.

-d dest
    Specify the message destination user. If this option is not set, ldapvacation will use the login name of the user executing it.

-f from
    Specify the envelope sender address.

-h ldaphost
    Specify the hostname of the LDAP server. This option is deprecated, please use a LDAP URL instead.

-l logfacility
    Set the log facility for syslog to logfacility. Possible values are daemon, mail, user, local0, local1, local2, local3, local4, local5, local6, local7, local8, and local9.

-m mailattr
    Specify the LDAP attribute which is used to store local addresses.

-p ldapport
    Specify the TCP port number on which to contact the LDAP server. This option is deprecated, please use a LDAP URL instead.

-q query
    Specify the LDAP query to find entries.

-u ldapurl
    Specify the LDAP URL of the server to connect to.

-w bindpasswd
    Specify the password to use when binding to the LDAP server.

-x spamheader
    An additional header that identifies spam. The first character of this header must either be 'x' or 'X'. For users of smtp-vilter with the SpamAssassin backend, this could be set to

No message will be sent unless dest (or a mail addresse stored in mailattr) is part of either the “To:” or “Cc:” headers of the mail. No messages from “???-REQUEST”, “Postmaster”, “UUCP”, “MAILER”, or “MAILER-DAEMON” will be replied to (where these strings are case insensitive) nor is a notification sent if a “Precedence: bulk”, “Precedence: list”, or “Precedence: junk” line or a user defined header identifying spam is included in the mail headers. The people who have sent you messages are maintained in a ldap(3) directory using the vacationSent attribute.

ldapvacation expects an attribute vacationMsg in your LDAP entry, containing a message to be sent back to each sender. It should be an entire message (including headers). For example, it might contain:

    From: marc@msys.ch (Marc Balmer)
    Subject: I am on vacation
    Delivered-By-The-Graces-Of: The LDAP-Vacation program
    Precedence: bulk
    I am on vacation until July 22.
    If you have something urgent,
    please contact Vera Hardmeier <vera@msys.ch>.
    --marc

Any occurrence of the string $SUBJECT in vacationMsg will be replaced by the subject of the message that triggered the ldapvacation program.

ldapvacation reads the incoming message from standard input, checking the message headers for either the UNIX “From” line or a “Return-Path” header to determine the sender. If both are present the sender from the “Return-Path” header is used.

Fatal errors, such as calling ldapvacation with incorrect arguments, or with non-existent logins, are logged in the system log file, using syslog(3).

FILES
/etc/ldapvacation.conf
    ldapvacation configuration file

SEE ALSO
syslog(3), ldapvacation.conf(5), sendmail(8)

HISTORY
The ldapvacation command was developed on OpenBSD 3.6.

AUTHORS
Marc Balmer <marc@msys.ch>