3.16 mailutils-config -- Get the Information about the Mailutils Build

This program is designed for developers wishing to link their programs against libmailbox. 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
Getting Loader Flags
Obtaining General Build Information

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: `libmailbox'. Arguments may be given that alter this behavior. These are:

`auth'

Print flags to link against `libmuauth', the library adding new authentication methods to `libmailbox'.

`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.

`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=0.4.1 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

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 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 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 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 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 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.