2.16 mailutils-config — Get the Information about the Mailutils Build

This program is designed for developers wishing to link their programs against libmailutils. It allows to examine the particulars of the current build of Mailutils and to get the command line parameters necessary for compiling and linking an application with Mailutils libraries.

Getting Compiler Flags

When invoked with the option ‘--compile’, or its short form ‘-c’, mailutils-config prints the flags that must be given to the compiler for compiling the program using Mailutils functions. An example usage:

 
cc -omyprog.o `mailutils-config --compile` myprog.c

Getting Loader Flags

The ‘--link’, or its short form ‘-l’ prints to the standard output the loader flags necessary to link a program against Mailutils libraries.

When invoked without arguments, it produces the flags necessary to link against the basic library of Mailutils: ‘libmailutils’. Arguments may be given that alter this behavior. These are:

auth

Print flags to link against ‘libmu_auth’, the library adding new authentication methods to ‘libmailutils’.

guile

Print flags to link against ‘libmu_scm’, the Guile interface library.

mbox

Link against mbox format library.

mh

Link against mh format library.

maildir

Link against maildir format library.

mailer

Link against mailer library.

imap

Link against imap format library.

pop

Link against pop format library.

all

Link against all Mailutils format libraries.

The order of arguments does not matter.

For example, if you wrote a program ‘myprog.c’ that uses standard UNIX mailbox format, MH format and the Guile interface, then you would link it with the following command:

 
cc -omyprog myprog.o `mailutils-config --link mbox mh guile`

Obtaining General Build Information

The ‘--info’, or ‘-i’ retrieves the options (flags) used when building Mailutils. It may be used with or without arguments.

When used without arguments, it prints the list of all build flags, e.g.:

 
$ mailutils-config --info
VERSION=2.2
SYSCONFDIR=/usr/local/etc
MAILSPOOLDIR=/var/mail/
SCHEME=mbox
LOG_FACILITY=mail
USE_LIBPAM
HAVE_LIBLTDL
WITH_GDBM
WITH_GNUTLS
WITH_GSASL
WITH_GUILE
WITH_PTHREAD
WITH_READLINE
HAVE_MYSQL
ENABLE_VIRTUAL_DOMAINS
ENABLE_IMAP
ENABLE_POP
ENABLE_MH
ENABLE_MAILDIR
ENABLE_SMTP
ENABLE_SENDMAIL

When this option is used in conjunction with the ‘--verbose’ option, a short description is printed to the right of each keyword, e.g.:

 
$ mailutils-config --info --verbose
VERSION=1.9.93             - Version of this package
SYSCONFDIR=/usr/local/etc  - System configuration directory
MAILSPOOLDIR=/var/mail/    - Default mail spool directory
SCHEME=mbox                - Default mailbox type
LOG_FACILITY=mail          - Default syslog facility
USE_LIBPAM                 - PAM support
HAVE_LIBLTDL               - a portable `dlopen' wrapper library
WITH_GDBM                  - GNU DBM
…

This option also accepts any number of arguments. When these are given, each argument is treated as a name of a build flag. Mailutils-config checks if such a flag was defined and prints its full name if so. It exits with zero code if all the flags given on the command line are defined. Otherwise, it exits with code of 1.

The comparison of the flag names is case-insensitive. The arguments given need not include the leading prefix (i.e. the characters up to and including the first underscore character).

Given the previous example, the invocation

 
$ mailutils --info readline use_libpam pop

will produce the following output:

 
WITH_READLINE
USE_LIBPAM
ENABLE_POP

and will exit with a zero status.

The following command:

 
$ mailutils --info readline gssapi pop

will exit with status 1, and will print:

 
WITH_READLINE
ENABLE_POP

since WITH_GSSAPI flag is not defined.

The flags and their meanings are:

USE_LIBPAM

The Mailutils uses PAM libraries.

HAVE_LIBLTDL

The GNU wrapper library ‘libltdl’ is present and is used by Mailutils. See (libtool)Using libltdl section `Using libltdl' in Using libltdl, for more information on ‘libltdl’ library.

WITH_BDB2

Support for Berkeley DB is compiled in (the package was configured with ‘--with-db2’ option).

WITH_NDBM

Support for NDBM is compiled in (the package was configured with ‘--with-ndbm’ option).

WITH_OLD_DBM

Support for old style DBM is compiled in (the package was configured with ‘--with-dbm’ option).

WITH_GDBM

Support for GNU DBM is compiled in (the package was configured with ‘--with-gdbm’ option). See (gdbm)Top section `Introduction' in The GNU DBM Manual, for more information about this library.

WITH_GNUTLS

Support for GnuTLS (a Transport Layer Security Library) is compiled in (the package was configured with ‘--with-gnutls’ option).

WITH_GSASL

Support for GNU SASL is compiled in (the package was configured with ‘--with-gsasl’ option). See (gsasl)Top section `Introduction' in The GNU SASL Manual, for more information about this library.

WITH_GSSAPI

Support for GSSAPI is compiled in (the package was configured with ‘--with-gssapi’ option).

WITH_GUILE

Support for Guile extension language is built (the package was configured with ‘--with-guile’ option). See (guile)Top section `Overview' in The Guile Reference Manual, for more information about Guile.

WITH_PTHREAD

The POSIX thread support is compiled in.

WITH_READLINE

The readline support is enabled (the package was configured with ‘--with-readline’ option). See (readline)Top section `Top' in The GNU Readline Library, for more information.

HAVE_MYSQL

Authentication via MySQL is supported (the package was configured with ‘--enable-mysql’ option).

ENABLE_VIRTUAL_DOMAINS

Support for mail virtual domains is enabled (the package was configured with ‘--enable-virtual-domains’ option).

ENABLE_IMAP

Support for IMAP4 protocol is enabled.

ENABLE_POP

Support for POP3 protocol is enabled.

ENABLE_MH

Support for mailboxes in MH format is enabled.

ENABLE_MAILDIR

Support for mailboxes in MAILDIR format is enabled.

ENABLE_SMTP

Support for SMTP mailer is enabled.

ENABLE_SENDMAIL

Support for Sendmail mailer is enabled.