FDM(1)
NAME
fdm -- fetch and deliver mail
SYNOPSIS
fdm [-hklmnqv] [-a account] [-D name= value] [-f conffile] [-u user] [-x account] [fetch | poll]
DESCRIPTION
The fdm program fetches mail from a POP3 or IMAP server or from stdin and
delivers it based on a ruleset in the configuration file.
The options are as follows:
- -a name
- Process only the specified account. This option may appear multiple times. The account name may include shell glob characters to match multiple accounts.
- -D name=value
- This option defines a macro for use when parsing the configuration file. The macro name must be prefixed with $ or % to specify a string or numeric macro. This option may appear multiple
times. - -f conffile
- Specify the configuration file location. Default is ~/.fdm.conf, or /etc/fdm.conf if that doesn't exist.
- -h Look at the HOME environment variable to ascertain the user's
- home directory.
- -k Keep all mail after delivery, regardless of whether it matches a
- drop action. Note that mails kept in this way will be refetched by fdm if it is run again on the same account.
- -l Log using syslog(3) rather than to stderr.
- -m Ignore the lock file and run regardless of other instances of
- fdm.
- -n Do not process any accounts, just verify the configuration file
- syntax and exit.
- -q Quiet mode. Only print errors.
- -u user
- Specify the default user for delivery. This overrides the
default-user option in the configuration file. - -v Request verbose logging. This option may be specified multiple
- times. -vv will print information on configuration (useful with -n). -vvvv duplicates all traffic to and from remote servers to stdout. This feature is disabled when using the -l flag.
- -x name
- Exclude the named account. Multiple -x options may be specified. As with -a, shell glob characters may be used.
- fetch | poll | cache
- The fetch command instructs fdm to fetch and deliver messages. The poll command polls the accounts in the configuration file and reports a message count for each. cache allows fdm cache files to be manipulated: see the next section.
CACHE COMMANDS
The following cache manipulation commands are supported:
cache add path string
- cache remove path string
- Add or remove string as a key in the cache at path.
- cache list [path]
- List the number of keys in the specified cache, or if path is omitted, in all caches declared in the configuration file.
- cache dump path
- Dump the contents of the cache path to stdout. Each key is printed followed by a space and the timestamp as Unix time.
- cache clear path
- Delete all keys from the cache at path.
FILES
- ~/.fdm.conf
- default fdm configuration file
- /etc/fdm.conf
- default system-wide configuration file
- ~/.fdm.lock
- default lock file
- /var/db/fdm.lock
- lock file for root user
SEE ALSO
mail(1), fdm.conf(5), sendmail(8)
AUTHORS
- Nicholas Marriott <nicm@users.sourceforge.net>