# HG changeset patch # User meillo@marmaro.de # Date 1275163627 -7200 # Node ID ed34413652fcf331d2acec79f8ab4a68d719fb7e # Parent f6a6f55b7b9e8475b0dc989bbbcb2cb9ca7fe222 moved man pages from docs/ to man/ diff -r f6a6f55b7b9e -r ed34413652fc Makefile.am --- a/Makefile.am Sat May 29 21:51:13 2010 +0200 +++ b/Makefile.am Sat May 29 22:07:07 2010 +0200 @@ -1,11 +1,8 @@ EXTRA_DIST = \ -examples/example.get examples/example.route examples/masqmail.conf \ -docs/README docs/m*.[0-9] \ -tpl/failmsg.tpl tpl/failmsg.tpl.de tpl/failmsg.tpl.fr tpl/failmsg.tpl.it \ -tpl/warnmsg.tpl tpl/warnmsg.tpl.de tpl/warnmsg.tpl.fr \ +examples/* docs/* man/* tpl/* \ INSTALL.agenda INSTALL.ipaq agenda-config.site -SUBDIRS = src docs +SUBDIRS = src man install-data-local: log_dir spool_dir uid_bit conf_dir tpl_dir run_dir diff -r f6a6f55b7b9e -r ed34413652fc Makefile.in --- a/Makefile.in Sat May 29 21:51:13 2010 +0200 +++ b/Makefile.in Sat May 29 22:07:07 2010 +0200 @@ -205,13 +205,10 @@ with_spooldir = @with_spooldir@ with_user = @with_user@ EXTRA_DIST = \ -examples/example.get examples/example.route examples/masqmail.conf \ -docs/README docs/m*.[0-9] \ -tpl/failmsg.tpl tpl/failmsg.tpl.de tpl/failmsg.tpl.fr tpl/failmsg.tpl.it \ -tpl/warnmsg.tpl tpl/warnmsg.tpl.de tpl/warnmsg.tpl.fr \ +examples/* docs/* man/* tpl/* \ INSTALL.agenda INSTALL.ipaq agenda-config.site -SUBDIRS = src docs +SUBDIRS = src man all: config.h $(MAKE) $(AM_MAKEFLAGS) all-recursive diff -r f6a6f55b7b9e -r ed34413652fc configure --- a/configure Sat May 29 21:51:13 2010 +0200 +++ b/configure Sat May 29 22:07:07 2010 +0200 @@ -5499,7 +5499,7 @@ fi fi -ac_config_files="$ac_config_files Makefile src/Makefile src/base64/Makefile src/md5/Makefile src/libident/Makefile docs/Makefile" +ac_config_files="$ac_config_files Makefile src/Makefile src/base64/Makefile src/md5/Makefile src/libident/Makefile man/Makefile" cat >confcache <<\_ACEOF # This file is a shell script that caches the results of configure @@ -6218,7 +6218,7 @@ "src/base64/Makefile") CONFIG_FILES="$CONFIG_FILES src/base64/Makefile" ;; "src/md5/Makefile") CONFIG_FILES="$CONFIG_FILES src/md5/Makefile" ;; "src/libident/Makefile") CONFIG_FILES="$CONFIG_FILES src/libident/Makefile" ;; - "docs/Makefile") CONFIG_FILES="$CONFIG_FILES docs/Makefile" ;; + "man/Makefile") CONFIG_FILES="$CONFIG_FILES man/Makefile" ;; *) as_fn_error "invalid argument: \`$ac_config_target'" "$LINENO" 5;; esac diff -r f6a6f55b7b9e -r ed34413652fc configure.ac --- a/configure.ac Sat May 29 21:51:13 2010 +0200 +++ b/configure.ac Sat May 29 22:07:07 2010 +0200 @@ -295,5 +295,5 @@ src/base64/Makefile \ src/md5/Makefile \ src/libident/Makefile \ - docs/Makefile + man/Makefile ) diff -r f6a6f55b7b9e -r ed34413652fc docs/Makefile.am --- a/docs/Makefile.am Sat May 29 21:51:13 2010 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -man_MANS=masqmail.8 mservdetect.8 masqmail.conf.5 masqmail.route.5 masqmail.get.5 masqmail.aliases.5 diff -r f6a6f55b7b9e -r ed34413652fc docs/Makefile.in --- a/docs/Makefile.in Sat May 29 21:51:13 2010 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,454 +0,0 @@ -# Makefile.in generated by automake 1.11.1 from Makefile.am. -# @configure_input@ - -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, -# 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, -# Inc. -# This Makefile.in is free software; the Free Software Foundation -# gives unlimited permission to copy and/or distribute it, -# with or without modifications, as long as this notice is preserved. - -# This program is distributed in the hope that it will be useful, -# but WITHOUT ANY WARRANTY, to the extent permitted by law; without -# even the implied warranty of MERCHANTABILITY or FITNESS FOR A -# PARTICULAR PURPOSE. - -@SET_MAKE@ -VPATH = @srcdir@ -pkgdatadir = $(datadir)/@PACKAGE@ -pkgincludedir = $(includedir)/@PACKAGE@ -pkglibdir = $(libdir)/@PACKAGE@ -pkglibexecdir = $(libexecdir)/@PACKAGE@ -am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd -install_sh_DATA = $(install_sh) -c -m 644 -install_sh_PROGRAM = $(install_sh) -c -install_sh_SCRIPT = $(install_sh) -c -INSTALL_HEADER = $(INSTALL_DATA) -transform = $(program_transform_name) -NORMAL_INSTALL = : -PRE_INSTALL = : -POST_INSTALL = : -NORMAL_UNINSTALL = : -PRE_UNINSTALL = : -POST_UNINSTALL = : -subdir = docs -DIST_COMMON = README $(srcdir)/Makefile.am $(srcdir)/Makefile.in -ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/configure.ac -am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ - $(ACLOCAL_M4) -mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs -CONFIG_HEADER = $(top_builddir)/config.h -CONFIG_CLEAN_FILES = -CONFIG_CLEAN_VPATH_FILES = -SOURCES = -DIST_SOURCES = -am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; -am__vpath_adj = case $$p in \ - $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ - *) f=$$p;; \ - esac; -am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`; -am__install_max = 40 -am__nobase_strip_setup = \ - srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'` -am__nobase_strip = \ - for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||" -am__nobase_list = $(am__nobase_strip_setup); \ - for p in $$list; do echo "$$p $$p"; done | \ - sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \ - $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \ - if (++n[$$2] == $(am__install_max)) \ - { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \ - END { for (dir in files) print dir, files[dir] }' -am__base_list = \ - sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \ - sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g' -man5dir = $(mandir)/man5 -am__installdirs = "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(man8dir)" -man8dir = $(mandir)/man8 -NROFF = nroff -MANS = $(man_MANS) -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) -ACLOCAL = @ACLOCAL@ -AMTAR = @AMTAR@ -AUTOCONF = @AUTOCONF@ -AUTOHEADER = @AUTOHEADER@ -AUTOMAKE = @AUTOMAKE@ -AWK = @AWK@ -BASE64_LIBS = @BASE64_LIBS@ -CC = @CC@ -CCDEPMODE = @CCDEPMODE@ -CFLAGS = @CFLAGS@ -CPP = @CPP@ -CPPFLAGS = @CPPFLAGS@ -CYGPATH_W = @CYGPATH_W@ -DEFS = @DEFS@ -DEPDIR = @DEPDIR@ -ECHO_C = @ECHO_C@ -ECHO_N = @ECHO_N@ -ECHO_T = @ECHO_T@ -EGREP = @EGREP@ -EXEEXT = @EXEEXT@ -GLIB_CFLAGS = @GLIB_CFLAGS@ -GLIB_LIBS = @GLIB_LIBS@ -GREP = @GREP@ -IDENT_LIBS = @IDENT_LIBS@ -INSTALL = @INSTALL@ -INSTALL_DATA = @INSTALL_DATA@ -INSTALL_PROGRAM = @INSTALL_PROGRAM@ -INSTALL_SCRIPT = @INSTALL_SCRIPT@ -INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ -LDFLAGS = @LDFLAGS@ -LIBOBJS = @LIBOBJS@ -LIBS = @LIBS@ -LOCKFILE_LIBS = @LOCKFILE_LIBS@ -LTLIBOBJS = @LTLIBOBJS@ -MAKEINFO = @MAKEINFO@ -MD5_LIBS = @MD5_LIBS@ -MKDIR_P = @MKDIR_P@ -OBJEXT = @OBJEXT@ -PACKAGE = @PACKAGE@ -PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ -PACKAGE_NAME = @PACKAGE_NAME@ -PACKAGE_STRING = @PACKAGE_STRING@ -PACKAGE_TARNAME = @PACKAGE_TARNAME@ -PACKAGE_URL = @PACKAGE_URL@ -PACKAGE_VERSION = @PACKAGE_VERSION@ -PATH_SEPARATOR = @PATH_SEPARATOR@ -PKG_CONFIG = @PKG_CONFIG@ -PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ -PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ -RANLIB = @RANLIB@ -RESOLV_LIBS = @RESOLV_LIBS@ -SET_MAKE = @SET_MAKE@ -SHELL = @SHELL@ -STRIP = @STRIP@ -USE_LIBLOCKFILE = @USE_LIBLOCKFILE@ -VERSION = @VERSION@ -abs_builddir = @abs_builddir@ -abs_srcdir = @abs_srcdir@ -abs_top_builddir = @abs_top_builddir@ -abs_top_srcdir = @abs_top_srcdir@ -ac_ct_CC = @ac_ct_CC@ -am__include = @am__include@ -am__leading_dot = @am__leading_dot@ -am__quote = @am__quote@ -am__tar = @am__tar@ -am__untar = @am__untar@ -bindir = @bindir@ -build_alias = @build_alias@ -builddir = @builddir@ -datadir = @datadir@ -datarootdir = @datarootdir@ -docdir = @docdir@ -dvidir = @dvidir@ -exec_prefix = @exec_prefix@ -has_ident = @has_ident@ -host_alias = @host_alias@ -htmldir = @htmldir@ -includedir = @includedir@ -infodir = @infodir@ -install_sh = @install_sh@ -libdir = @libdir@ -libexecdir = @libexecdir@ -localedir = @localedir@ -localstatedir = @localstatedir@ -mandir = @mandir@ -mkdir_p = @mkdir_p@ -oldincludedir = @oldincludedir@ -pdfdir = @pdfdir@ -prefix = @prefix@ -program_transform_name = @program_transform_name@ -psdir = @psdir@ -sbindir = @sbindir@ -sharedstatedir = @sharedstatedir@ -srcdir = @srcdir@ -sysconfdir = @sysconfdir@ -target_alias = @target_alias@ -top_build_prefix = @top_build_prefix@ -top_builddir = @top_builddir@ -top_srcdir = @top_srcdir@ -with_confdir = @with_confdir@ -with_group = @with_group@ -with_logdir = @with_logdir@ -with_spooldir = @with_spooldir@ -with_user = @with_user@ -man_MANS = masqmail.8 mservdetect.8 masqmail.conf.5 masqmail.route.5 masqmail.get.5 masqmail.aliases.5 -all: all-am - -.SUFFIXES: -$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(am__configure_deps) - @for dep in $?; do \ - case '$(am__configure_deps)' in \ - *$$dep*) \ - ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ - && { if test -f $@; then exit 0; else break; fi; }; \ - exit 1;; \ - esac; \ - done; \ - echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/Makefile'; \ - $(am__cd) $(top_srcdir) && \ - $(AUTOMAKE) --gnu docs/Makefile -.PRECIOUS: Makefile -Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status - @case '$?' in \ - *config.status*) \ - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ - *) \ - echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ - cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ - esac; - -$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh - -$(top_srcdir)/configure: $(am__configure_deps) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh -$(ACLOCAL_M4): $(am__aclocal_m4_deps) - cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh -$(am__aclocal_m4_deps): -install-man5: $(man_MANS) - @$(NORMAL_INSTALL) - test -z "$(man5dir)" || $(MKDIR_P) "$(DESTDIR)$(man5dir)" - @list=''; test -n "$(man5dir)" || exit 0; \ - { for i in $$list; do echo "$$i"; done; \ - l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ - sed -n '/\.5[a-z]*$$/p'; \ - } | while read p; do \ - if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ - echo "$$d$$p"; echo "$$p"; \ - done | \ - sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \ - -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ - sed 'N;N;s,\n, ,g' | { \ - list=; while read file base inst; do \ - if test "$$base" = "$$inst"; then list="$$list $$file"; else \ - echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man5dir)/$$inst'"; \ - $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man5dir)/$$inst" || exit $$?; \ - fi; \ - done; \ - for i in $$list; do echo "$$i"; done | $(am__base_list) | \ - while read files; do \ - test -z "$$files" || { \ - echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man5dir)'"; \ - $(INSTALL_DATA) $$files "$(DESTDIR)$(man5dir)" || exit $$?; }; \ - done; } - -uninstall-man5: - @$(NORMAL_UNINSTALL) - @list=''; test -n "$(man5dir)" || exit 0; \ - files=`{ for i in $$list; do echo "$$i"; done; \ - l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ - sed -n '/\.5[a-z]*$$/p'; \ - } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \ - -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ - test -z "$$files" || { \ - echo " ( cd '$(DESTDIR)$(man5dir)' && rm -f" $$files ")"; \ - cd "$(DESTDIR)$(man5dir)" && rm -f $$files; } -install-man8: $(man_MANS) - @$(NORMAL_INSTALL) - test -z "$(man8dir)" || $(MKDIR_P) "$(DESTDIR)$(man8dir)" - @list=''; test -n "$(man8dir)" || exit 0; \ - { for i in $$list; do echo "$$i"; done; \ - l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ - sed -n '/\.8[a-z]*$$/p'; \ - } | while read p; do \ - if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ - echo "$$d$$p"; echo "$$p"; \ - done | \ - sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \ - -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ - sed 'N;N;s,\n, ,g' | { \ - list=; while read file base inst; do \ - if test "$$base" = "$$inst"; then list="$$list $$file"; else \ - echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man8dir)/$$inst'"; \ - $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man8dir)/$$inst" || exit $$?; \ - fi; \ - done; \ - for i in $$list; do echo "$$i"; done | $(am__base_list) | \ - while read files; do \ - test -z "$$files" || { \ - echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man8dir)'"; \ - $(INSTALL_DATA) $$files "$(DESTDIR)$(man8dir)" || exit $$?; }; \ - done; } - -uninstall-man8: - @$(NORMAL_UNINSTALL) - @list=''; test -n "$(man8dir)" || exit 0; \ - files=`{ for i in $$list; do echo "$$i"; done; \ - l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ - sed -n '/\.8[a-z]*$$/p'; \ - } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \ - -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ - test -z "$$files" || { \ - echo " ( cd '$(DESTDIR)$(man8dir)' && rm -f" $$files ")"; \ - cd "$(DESTDIR)$(man8dir)" && rm -f $$files; } -tags: TAGS -TAGS: - -ctags: CTAGS -CTAGS: - - -distdir: $(DISTFILES) - @list='$(MANS)'; if test -n "$$list"; then \ - list=`for p in $$list; do \ - if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ - if test -f "$$d$$p"; then echo "$$d$$p"; else :; fi; done`; \ - if test -n "$$list" && \ - grep 'ab help2man is required to generate this page' $$list >/dev/null; then \ - echo "error: found man pages containing the \`missing help2man' replacement text:" >&2; \ - grep -l 'ab help2man is required to generate this page' $$list | sed 's/^/ /' >&2; \ - echo " to fix them, install help2man, remove and regenerate the man pages;" >&2; \ - echo " typically \`make maintainer-clean' will remove them" >&2; \ - exit 1; \ - else :; fi; \ - else :; fi - @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ - topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ - list='$(DISTFILES)'; \ - dist_files=`for file in $$list; do echo $$file; done | \ - sed -e "s|^$$srcdirstrip/||;t" \ - -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ - case $$dist_files in \ - */*) $(MKDIR_P) `echo "$$dist_files" | \ - sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ - sort -u` ;; \ - esac; \ - for file in $$dist_files; do \ - if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ - if test -d $$d/$$file; then \ - dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ - if test -d "$(distdir)/$$file"; then \ - find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ - fi; \ - if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ - cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ - find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ - fi; \ - cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ - else \ - test -f "$(distdir)/$$file" \ - || cp -p $$d/$$file "$(distdir)/$$file" \ - || exit 1; \ - fi; \ - done -check-am: all-am -check: check-am -all-am: Makefile $(MANS) -installdirs: - for dir in "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(man8dir)"; do \ - test -z "$$dir" || $(MKDIR_P) "$$dir"; \ - done -install: install-am -install-exec: install-exec-am -install-data: install-data-am -uninstall: uninstall-am - -install-am: all-am - @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am - -installcheck: installcheck-am -install-strip: - $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ - install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ - `test -z '$(STRIP)' || \ - echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install -mostlyclean-generic: - -clean-generic: - -distclean-generic: - -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) - -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) - -maintainer-clean-generic: - @echo "This command is intended for maintainers to use" - @echo "it deletes files that may require special tools to rebuild." -clean: clean-am - -clean-am: clean-generic mostlyclean-am - -distclean: distclean-am - -rm -f Makefile -distclean-am: clean-am distclean-generic - -dvi: dvi-am - -dvi-am: - -html: html-am - -html-am: - -info: info-am - -info-am: - -install-data-am: install-man - -install-dvi: install-dvi-am - -install-dvi-am: - -install-exec-am: - -install-html: install-html-am - -install-html-am: - -install-info: install-info-am - -install-info-am: - -install-man: install-man5 install-man8 - -install-pdf: install-pdf-am - -install-pdf-am: - -install-ps: install-ps-am - -install-ps-am: - -installcheck-am: - -maintainer-clean: maintainer-clean-am - -rm -f Makefile -maintainer-clean-am: distclean-am maintainer-clean-generic - -mostlyclean: mostlyclean-am - -mostlyclean-am: mostlyclean-generic - -pdf: pdf-am - -pdf-am: - -ps: ps-am - -ps-am: - -uninstall-am: uninstall-man - -uninstall-man: uninstall-man5 uninstall-man8 - -.MAKE: install-am install-strip - -.PHONY: all all-am check check-am clean clean-generic distclean \ - distclean-generic distdir dvi dvi-am html html-am info info-am \ - install install-am install-data install-data-am install-dvi \ - install-dvi-am install-exec install-exec-am install-html \ - install-html-am install-info install-info-am install-man \ - install-man5 install-man8 install-pdf install-pdf-am \ - install-ps install-ps-am install-strip installcheck \ - installcheck-am installdirs maintainer-clean \ - maintainer-clean-generic mostlyclean mostlyclean-generic pdf \ - pdf-am ps ps-am uninstall uninstall-am uninstall-man \ - uninstall-man5 uninstall-man8 - - -# Tell versions [3.59,3.63) of GNU make to not export all variables. -# Otherwise a system limit (for SysV at least) may be exceeded. -.NOEXPORT: diff -r f6a6f55b7b9e -r ed34413652fc docs/masqmail.8 --- a/docs/masqmail.8 Sat May 29 21:51:13 2010 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,293 +0,0 @@ -.TH masqmail 8 2010-05-07 masqmail-0.2.22 "Maintenance Commands" - -.SH NAME -masqmail \- An offline Mail Transfer Agent - -.SH SYNOPSIS -\fB/usr/sbin/masqmail \fR[\fB\-C \fIfile\fR] [\fB\-odq\fR] [\fB\-bd\fR] [\fB\-q\fIinterval\fR] - -\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-bs\fR] - -\fB/usr/sbin/masqmail \fR[\fB\-bp\fR] - -\fB/usr/sbin/masqmail \fR[\fB\-q\fR] - -\fB/usr/sbin/masqmail \fR[\fB\-qo \fR[\fIname\fR]] - -\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-g \fR[\fIname\fR]] - -\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-go \fR[\fIname\fR]] - -\fB/usr/sbin/masqmail \fR[\fB\-t\fR] [\fB\-oi\fR] [\fB\-f \fIaddress\fR] [\fB\-\-\fR] \fIaddress... - -\fB/usr/sbin/mailq\fR - - -.SH DESCRIPTION - -Masqmail is a mail server designed for hosts that do not have a permanent internet connection -e.g. a home network or a single host at home. -It has special support for connections to different ISPs. -It replaces sendmail or other MTAs such as qmail or exim. -It can also act as a pop3 client. - - -.SH OPTIONS - -Since masqmail is intended to replace sendmail, it uses the same command line options, -but not all are implemented. -There are also two additional options, which are unique to masqmail -(\fB\-qo \fIconnection\fR and \fB\-g\fR) - -.TP -\fB\-\-\fR - -Not a `real' option, it means that all following arguments are to be understood -as arguments and not as options even if they begin with a leading dash `\-'. -Mutt is known to call sendmail with this option. - -.TP -\fB\-bd\fR - -Run as daemon, accepting connections, usually on port 25 if not configured differently. -This is usually used in the startup script at system boot and together with -the \fB\-q\fR option (see below). - -.TP -\fB\-bi\fR - -Old sendmail rebuilds its alias database when invoked with this option. -Masqmail ignores it. -Masqmail reads directly from the file given with `alias_file' in the config file. - -.TP -\fB\-bp\fR - -Show the messages in the queue. Same as calling masqmail as `mailq'. - -.TP -\fB\-bs\fR - -Accept SMTP commands from stdin. -Some mailers (e.g. pine) use this option as an interface. -It can also be used to call masqmail from inetd. - -.TP -\fB\-B \fIarg\fR - -\fIarg\fR is usually 8BITMIME. -Some mailers use this to indicate that the message contains characters > 127. -Masqmail is 8-bit clean and ignores this, so you do not have to recompile elm, -which is very painful ;-). -Note though that this violates some conventions: -masqmail does not convert 8 bit messages to any MIME format if it encounters -a mail server which does not advertise its 8BITMIME capability, -masqmail does not advertise this itself. -This is the same practice as that of exim (but different to sendmail). - -.TP -\fB\-bV \fR - -Show version information. - -.TP -\fB\-C \fIfilename\fR - -Use another configuration than \fI/etc/masqmail/masqmail.conf\fR. -Useful for debugging purposes. -If not invoked by a privileged user, masqmail will drop all privileges. - -.TP -\fB\-d \fInumber\fR - -Set the debug level. -This takes precedence before the value of `debug_level' in the configuration file. -Read the warning in the description of the latter. - -.TP -\fB\-f [\fIaddress\fB]\fR - -Set the return path address to \fIaddress\fR. -Only root, the user mail and anyone in group mail is allowed to do that. - -.TP -\fB\-F [\fIstring\fB]\fR - -Set the full sender name (in the From: header) to \fIstring\fR. - -.TP -\fB\-g [\fIname\fB]\fR - -Get mail (using pop3 or apop), -using the configurations given with get.\fIname\fR in the main configuration. -Without \fIname\fR, all get configurations will be used. -See also \fBmasqmail.get(5)\fR - -.TP -\fB\-go [\fIinterval\fB] [\fIname\fB]\fR - -Can be followed by a connection name. -Use this option in your script which starts as soon as a link to the internet -has been set up (usually ip-up). -When masqmail is called with this option, the specified get configuration(s) -is(are) read and mail will be retrieved from servers on the internet. -The \fIname\fR is defined in the configuration (see \fBonline_gets.\fIname\fR). - -If called with an interval option (recognized by a digit as the first characater), -masqmail starts as a daemon and tries to get mail in these intervals. -It checks for the online status first. -Example: `masqmail \-go 5m' will retrieve mail every five minutes. - -If called without \fIname\fR the online status is determined with the configured method -(see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR). - -.TP -\fB\-i\fR - -Same as \fB\-oi\fR, see below. - -.TP -\fB\-Mrm \fIlist\fR - -Remove given messages from the queue. -Only allowed for privileged users. -The identifiers of messages are listed in the output of -\fImasqmail -bp\fP (\fImailq\fR). - -.TP -\fB\-oem\fR - -If the \fB\-oi\fR ist not also given, always return with a non zero return code. -Maybe someone tells me what this is good for... - -.TP -\fB\-odb\fR - -Deliver in background. -Masqmail always does this, which makes this option pretty much useless. - -.TP -\fB\-odq\fR - -Do not attempt to deliver immediately. -Any messages will be queued until the next queue running process picks them up and delivers them. -You get the same effect by setting the do_queue option in /etc/masqmail/masqmail.conf. - -.TP -\fB\-oi\fR - -A dot as a single character in a line does not terminate the message. - -.TP -\fB\-q [\fIinterval\fB]\fR - -If not given with an argument, run a queue process, i.e. try to deliver all messages in the queue. -Masqmail sends only to those addresses that are on the local net, not to those that are outside. -Use \fB\-qo\fR for those. - -If you have configured inetd to start masqmail, -you can use this option in a cron job which starts in regular time intervals, -to mimic the same effect as starting masqmail with \fB\-bd \-q30m\fR. - -An argument may be a time interval i.e. a numerical value followed by one of the letters. -s,m,h,d,w which are interpreted as seconds, minutes, hours, days or weeks respectively. -Example: \fB\-q30m\fR. -Masqmail starts as a daemon and a queue runner process will be started automatically -once in this time interval. -This is usually used together with \fB\-bd\fR (see above). - -.TP -\fB\-qo [\fIname\fB]\fR - -Can be followed by a connection name. -Use this option in your script which starts as soon as a link to the internet -has been set up (usually ip-up). -When masqmail is called with this option, the specified route configuration -is read and the queued mail with destinations on the internet will be sent. -The \fIname\fR is defined in the configuration (see \fBonline_routes.\fIname\fR). - -If called without \fIname\fR the online status is determined with the configured -method (see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR) - -.TP -\fB\-t\fR - -Read recipients from headers. -Delete `Bcc:' headers. -If any arguments are given, these are interpreted as recipient addresses -and the message will not be sent to these. - -.TP -\fB\-v\fR - -Log also to stdout. -Currently, some log messages are marked as `write to stdout' and additionally, -all messages with priority `LOG_ALERT' and `LOG_WARNING' will be written to stdout -if this option is given. It is disabled in daemon mode. - - -.SH ENVIRONMENT FOR PIPES AND MDAS - -For security reasons, before any pipe command from an alias expansion or an mda is called, -the environment variables will be completely discarded and newly set up. These are: - -SENDER, RETURN_PATH \(en the return path. - -SENDER_DOMAIN \(en the domain part of the return path. - -SENDER_LOCAL \(en the local part of the return path. - -RECEIVED_HOST \(en the host the message was received from (unless local). - -LOCAL_PART, USER, LOGNAME \(en the local part of the (original) recipient. - -MESSAGE_ID \(en the unique message id. -This is not necessarily identical with the Message ID as given in the Message ID: header. - -QUALIFY_DOMAIN \(en the domain which will be appended to unqualified addresses. - - -.SH FILES - -\fI/etc/masqmail/masqmail.conf\fR is the main configuration for masqmail. -Depending on the settings in this file, you will also have other configuration -files in \fI/etc/masqmail/\fR. - -\fI/var/spool/masqmail/\fR is the spool directory where masqmail stores -its spooled messages and the uniq pop ids. - -\fI/var/spool/mail/\fR is the directory where locally delivered mail will be put, -if not configured differently in \fImasqmail.conf\fR. - -\fI/var/log/masqmail/\fR is the directory where masqmail stores its log mesages. -This can also be somewhere else if configured differently by your sysadmin or the package mantainer. - - -.SH CONFORMING TO - -RFC 821, 822, 1869, 1870, 2197, 2554 (SMTP) - -RFC 1725, 1939 (POP3) - -RFC 1321 (MD5) - -RFC 2195 (CRAM-MD5) - - -.SH AUTHOR - -Masqmail was written by Oliver Kurth. -It is now maintained by Markus Schnalke . - -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. -There is also a mailing list, you will find information about it at masqmail's main site. - - -.SH BUGS - -Please report them to the mailing list. - - -.SH SEE ALSO - -\fBmasqmail.conf(5)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.get(5)\fR, \fBmasqmail.aliases(5)\fR diff -r f6a6f55b7b9e -r ed34413652fc docs/masqmail.aliases.5 --- a/docs/masqmail.aliases.5 Sat May 29 21:51:13 2010 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,54 +0,0 @@ -.TH masqmail.aliases 5 2010-05-07 masqmail-0.2.22 "File Formats" - -.SH NAME -masqmail.aliases \- masqmail alias file format - - -.SH DESCRIPTION - -This man page describes the format of the masqmail alias file. -Its usual location is \fI/etc/aliases\fR. - - -.SH FILE FORMAT - -The alias file consists of lines of the form: -local_part: item1, item2, ... -Items can be surrounded by double quotes `"'. -If within the quotes other quotes are needed for an address they can be -escaped with a leading backslash `\\'. - -A leading backslash `\\' indicates that this address shall not be further expanded. - -A leading pipe symbol `|' indicates that the item shall be treated as a pipe command. -The content of the message will then be sent to the standard input of a command. -The command will run under the user id and group id masqmail is running as. -If quotes are needed, the pipe symbol must appear within the quotes. - -Loops will be detected, the offending address will be ignored. - -Aliases will be expanded at delivery time. -This means that if there is a message still in the queue and you change -any alias which matches one of the recipient addresses, -the change will have effect next time a delivery is attemped. - -There is no need to restart masqmail or run any command when the alias file has been changed. - - -.SH AUTHOR - -Masqmail was written by Oliver Kurth. -It is now maintained by Markus Schnalke . - -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. -There is also a mailing list, you will find information about it at masqmail's main site. - - -.SH BUGS - -Please report bugs to the mailing list. - - -.SH SEE ALSO - -\fBmasqmail.conf(5)\fR, \fBmasqmail(8)\fR, diff -r f6a6f55b7b9e -r ed34413652fc docs/masqmail.conf.5 --- a/docs/masqmail.conf.5 Sat May 29 21:51:13 2010 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,492 +0,0 @@ -.TH masqmail.conf 5 2010-05-07 masqmail-0.2.22 "File Formats" - -.SH NAME -masqmail.conf \- masqmail configuration file - - -.SH DESCRIPTION - -This man page describes the syntax of the main configuration file of masqmail. -Its usual location is \fI/etc/masqmail/masqmail.conf\fR - -The configuration consists of lines of the form - -\fBval\fR = \fIexpression\fR - -Where \fBval\fR is a variable name and \fIexpression\fR a string, -which can be quoted with double quotes `"'. -If the expression is on multiple lines or contains characters other than letters, -digits or the characters `.', `-', `_', `/', it must be quoted. -You can use quotes inside quotes by escaping them with a backslash. - -Each val has a type, which can be boolean, numeric, string or list. -A boolean variable can be set with one of the values `on', `yes', and `true' or `off', `no' and `false'. -List items are separated with semicolons `;'. -For some values patterns (like `*',`?') can be used. -The spaces before and after the equal sign `=' are optional. - -Most lists (exceptions: \fBlocal_hosts\fR, \fBlocal_nets\fR, \fBlisten_addresses\fR, -\fBonline_routes\fR, and \fBonline_gets\fR) accept files. -These will be recognized by a leading slash `/'. -The contents of these files will be included at the position of the file name, -there can be items or other files before and after the file entry. -The format of the files is different though, within these files each entry is on another line. -(And not separated by semicolons). -This makes it easy to include large lists which are common in different configuration files, -so they do not have to appear in every configuration file. - -Blank lines and lines starting with a hash `#' are ignored. - - -.SH OPTIONS - -.TP -\fBrun_as_user = \fIboolean\fR - -If this is set, masqmail runs with the user id of the user who invoked it and never changes it. -This is for debugging purposes only. -If the user is not root, masqmail will not be able to listen on a port < 1024 -and will not be able to deliver local mail to others than the user. - -.TP -\fBuse_syslog = \fIboolean\fR - -If this is set, masqmail uses syslogd for logging. -It uses facility MAIL. -You still have to set \fBlog_dir\fR for debug files. - -.TP -\fBdebug_level = \fIn\fR - -Set the debug level. -Valid values are 0 to 6, increasing it further makes no difference. -Be careful if you set this as high as 5 or higher, the logs may very soon fill your hard drive. - -.TP -\fBlog_dir = \fIfile\fR - -The directory where log are stored, if syslog is not used. -Debug files are stored in this directory anyways. -\fI/var/log/masqmail\fR is a common value. -\fIfile\fR must be an absolute path. - -.TP -\fBmail_dir = \fIfile\fR - -The directory where local mail is stored, usually \fI/var/spool/mail\fR or \fI/var/mail\fR. -\fIfile\fR must be an absolute path. - -.TP -\fBspool_dir = \fIfile\fR - -The directory where masqmail stores its spool files (and later also other stuff). -It must have a subdirectory \fIinput\fR. -Masqmail needs read and write permissions for this directory. -I suggest to use \fI/var/spool/masqmail\fR. -\fIfile\fR must be an absolute path. - -.TP -\fBhost_name = \fIstring\fR - -This is used in different places: Masqmail identifies itself in the greeting banner -on incoming connections and in the HELO/EHLO command for outgoing connections with this name, -it is used in the Received: header and to qualify the sender of a locally originating message. - -If the string begins with a slash `/', it it assumed that it is a filename, -and the first line of this file will be used. -Usually this will be `/etc/mailname' to make masqmail conform to Debian policies. - -It is not used to find whether an address is local. Use \fBlocal_hosts\fR for that. - -.TP -\fBremote_port = \fIn\fR - -The remote port number to be used. This defaults to port 25. - -This option is deprecated. -Use \fBhost_name\fR in the route configuration instead. -See \fBmasqmail.route(5)\fR. - -.TP -\fBlocal_hosts = \fIlist\fR - -A semicolon `;' separated list of hostnames which are considered local. -Normally you set it to "localhost;foo;foo.bar.com" if your host has the -fully qualified domain name `foo.bar.com'. - -.TP -\fBlocal_nets = \fIlist\fR - -A semicolon `;' separated list of hostnames which are on the `local' net. -Delivery to these hosts is attempted immediately. -You can use patterns with `*', e.g. "*.bar.com". - -.TP -\fBlocal_addresses = \fIlist\fR - -A semicolon `;' separated list of fully qualified email-addresses which are -considered local although their domain name part is not in the list of \fBlocal_hosts\fR. - -For example: There are two people working at your LAN: person1@yourdomain and person2@yourdomain. -But there are other persons @yourdomain which are NOT local. -So you can not put yourdomain to the list of local_hosts. -If person1 now wants to write to person2@yourdomain and this mail should not leave the LAN then you can put - -local_addresses = "person1@yourdomain;person2@yourdomain" - -to your masqmail.conf. - -.TP -\fBnot_local_addresses = \fIlist\fR - -A semicolon `;' separated list of fully qualified email-addresses which are -considered not local although their domain name part is in the list of \fBlocal_hosts\fR. - -This is the opposite of the previous case. -The majority of addresses of a specific domain are local. -But some users are not. -With this option you can easily exclude these users. - -Example: - -local_hosts = "localhost;myhost;mydomain.net" - -not_local_addresses = "eric@mydomain.net" - -.TP -\fBlisten_addresses = \fIlist\fR - -A semicolon `;' separated list of interfaces on which connections will be accepted. -An interface ist defined by a hostname, optionally followed by a colon `:' and a number for the port. -If this is left out, port 25 will be used. - -You can set this to "localhost:25;foo:25" if your hostname is `foo'. - -Note that the names are resolved to IP addreses. -If your host has different names which resolve to the same IP, -use only one of them, otherwise you will get an error message. - -.TP -\fBdo_save_envelope_to = \fIboolean\fR - -If this is set to true, a possibly existing Envelope-to: header in an incoming mail -which is received via either pop3 or smtp will be saved as an X-Orig-Envelope-to: header. - -This is useful if you retrieve mail from a pop3 server with either masqmail or fetchmail, -and the server supports Envelope-to: headers, -and you want to make use of those with a mail filtering tool, e.g. procmail. -It cannot be preserved because masqmail sets such a header by itself. - -Default is false. - -.TP -\fBdo_relay = \fIboolean\fR - -If this is set to false, mail with a return path that is not local and a destination -that is also not local will not be accepted via smtp and a 550 reply will be given. -Default is true. - -Note that this will not protect you from spammers using open relays, -but from users unable to set their address in their mail clients. - -.TP -\fBdo_queue = \fIboolean\fR - -If this is set, mail will not be delivered immediately when accepted. -Same as calling masqmail with the \fB\-odq\fR option. - -.TP -\fBonline_routes.\fIname\fR = \fIlist\fR - -Replace \fIname\fR with a name to identify a connection. -Set this to a filename (or a list of filenames) for the special route configuration for that connection. -You will use that name to call masqmail with the \fB\-qo\fR option every time a -connection to your ISP is set up. - -Example: Your ISP has the name FastNet. -Then you write the following line in the main configuration: - -\fBonline_routes.FastNet\fR = \fI"/etc/masqmail/fastnet.route"\fR - -\fI/etc/masqmail/fastnet.route\fR is the route configuration file, see \fBmasqmail.route(5)\fR. -As soon as a link to FastNet has been set up, you call masqmail \fB\-qo \fIFastNet\fR. -Masqmail will then read the specified file and send the mails. - -.TP -\fBconnect_route.\fIname\fR = \fIlist\fR - -Old name for \fBonline_routes\fR. - -.TP -\fBlocal_net_route = \fIfile\fR - -This is similar to \fBonline_routes.\fIname\fR but for the local net. -Recipient addresses that are in local_nets will be routed using this route configuration. -Main purpose is to define a mail server with mail_host in your local network. -In simple environments this can be left unset. -If unset, a default route configuration will be used. - -.TP -\fBalias_file = \fIfile\fR - -Set this to the location of your alias file. -If unset, no aliasing will be done. - -.TP -\fBalias_local_caseless = \fIboolean\fR - -If this is set, local parts in the alias file will be matched disregarding upper/lower case. - -.TP -\fBpipe_fromline = \fIboolean\fR - -If this is set, a from line will be prepended to the output stream whenever -a pipe command is called after an alias expansion. -Default is false. - -.TP -\fBpipe_fromhack = \fIboolean\fR - -If this is set, each line beginning with `From ' is replaced with `>From ' -whenever a pipe command is called after an alias expansion. -You probably want this if you have set \fBpipe_fromline\fR above. -Default is false. - -.TP -\fBmbox_default = \fIstring\fR - -The default local delivery method. -Can be one of mbox, mda or maildir (the latter only if maildir support is enabled at compile time). -Default is mbox. -You can override this for each user by using the \fBmbox_users\fR, \fBmda_users\fR, -or \fBmaildir_users\fR options (see below). - -.TP -\fBmbox_users = \fIlist\fR - -A list of users which wish delivery to an mbox style mail folder. - -.TP -\fBmda_users = \fIlist\fR - -A list of users which wish local delivery to an mda. -You have to set \fBmda\fR (see below) as well. - -.TP -\fBmaildir_users = \fIlist\fR - -A list of users which wish delivery to a qmail style maildir. -The path to maildir is ~/Maildir/. -The maildir will be created if it does not exist. - -.TP -\fBmda = \fIexpand string\fR - -If you want local delivery to be transferred to an mda (Mail Delivery Agent), -set this to a command. -The argument will be expanded on delivery time, -you can use variables beginning with a dolloar sign `$', optionally enclosed in curly braces. -Variables you can use are: - -uid - the unique message id. -This is not necessarily identical with the Message ID as given in the Message ID: header. - -received_host - the host the mail was received from - -ident - the ident, this is either the ident delivered by the ident protocol -or the user id of the sender if the message was received locally. - -return_path_local - the local part of the return path (sender). - -return_path_domain - the domain part of the return path (sender). - -return_path - the complete return path (sender). - -rcpt_local - the local part of the recipient. - -rcpt_domain - the domain part of the recipient. - -rcpt - the complete recipient address. - -Example: - -mda="/usr/bin/procmail \-Y \-d ${rcpt_local}" - -For the mda, as for pipe commands, a few environment variables will be set as well. -See \fBmasqmail(8)\fR. -To use environment variables for the mda, the dollar sign `$' has to be escaped with a backslash, -otherwise they will be tried to be expanded with the internal variables. - -.TP -\fBmda_fromline = \fIboolean\fR - -If this is set, a from line will be prepended to the output stream whenever -a message is delivered to an mda. -Default is false. - -.TP -\fBmda_fromhack = \fIboolean\fR - -If this is set, each line beginning with `From ' is replaced with `>From ' -whenever a message is delivered to an mda. -You probably want this if you have set \fBmda_fromline\fR above. -Default is false. - -.TP -\fBonline_detect = \fIstring\fR - -Defines the method masqmail uses to detect whether there is currently an online connection. -It can have the values \fBfile\fR, \fBpipe\fR, or \fBmserver\fR. - -When it is set to \fBfile\fR, masqmail first checks for the existence of \fBonline_file\fR -(see below) and if it exists, it reads it. -The content of the file should be the name of the current connection as defined -with \fBconnect_route.\fIname\fR (trailing whitespace is removed). - -When it is set to \fBpipe\fR, masqmail calls the executable given by the -\fBonline_pipe\fR option (see below) and reads the current online status from its standard output. - -When it is set to \fBmserver\fR, masqmail connects to the masqdialer server -using the value of \fBmserver_iface\fR and asks it whether a connection exists and for the name, -which should be the name of the current connection as defined with \fBconnect_route.\fIname\fR. - -No matter how masqmail detects the online status, -only messages that are accepted at online time will be delivered using the connection. -The spool still has to be emptied with masqmail \fB\-qo\fIconnection\fR. - -.TP -\fBonline_file = \fIfile\fR - -This is the name of the file checked for when masqmail determines whether it is online. -The file should only exist when there is currently a connection. -Create it in your ip-up script with e.g. - -echo \-n > /var/run/masqmail/masqmail-route - -chmod 0644 /var/run/masqmail/masqmail-route - -Do not forget to delete it in your ip-down script. - -.TP -\fBonline_pipe = \fIfile\fR - -This is the name of the executable which will be called to determine the online status. -This executable should just print the name of the current connection to -the standard output and return a zero status code. -masqmail assumes it is offline if the script returns with a non zero status. -Simple example: - -#!/bin/sh - -[ \-e /var/run/masqmail/masqmail-route ] || exit 1 - -cat /var/run/masqmail/masqmail-route - -exit 0 - -Of course, instead of the example above you could as well use \fBfile\fR as -the online detection method, but you can do something more sophisticated. - -.TP -\fBmserver_iface = \fIinterface\fR - -The interface the masqdialer server is listening to. -Usually this will be "localhost:224" if mserver is running on the same host as masqmail. -But using this option, you can also let masqmail run on another host by setting -\fBmserver_iface\fR to another hostname, e.g. "foo:224". - -.TP -\fBget.\fIname\fR = \fIfile\fR - -Replace \fIname\fR with a name to identify a get configuration. -Set this to a filename for the get configuration. -These files will be used to retrieve mail when called with the \-g option. - -.TP -\fBonline_gets.\fIname\fR = \fIlist\fR - -Replace \fIname\fR with a name to identify an online configuration. -Set this to a filename (or a list of filenames) for the get configuration. -These files will be used to retrieve mail when called with the \-go option. - -.TP -\fBident_trusted_nets = \fIlist\fR - -\fIlist\fR is a list of networks of the form a.b.c.d/e (e.g. 192.168.1.0/24), -from which the ident given by the ident protocol will be trusted, -so a user can delete his mail from the queue if the ident is identical to his login name. - -.TP -\fBerrmsg_file = \fIfile\fR - -Set this to a template which will be used to generate delivery failure reports. -Variable parts within the template begin with a dollar sign and are identical -to those which can be used as arguments for the mda command, see \fBmda\fR above. -Additional information can be included with @failed_rcpts, @msg_headers and @msg_body, -these must be at the beginning of a line and will be replaced with the list of the failed recipients, -the message headers and the message body of the failed message. - -Default is /usr/share/masqmail/tpl/failmsg.tpl. - -.TP -\fBwarnmsg_file = \fIfile\fR - -Set this to a template which will be used to generate delivery warning reports. -It uses the same mechanisms for variables as \fBerrmsg_file\fR, see above. - -Default is /usr/share/masqmail/tpl/warnmsg.tpl. - -.TP -\fBwarn_intervals\fR = \fIlist\fR - -Set this to a list of time intervals, at which delivery warnings -(starting with the receiving time of the message) shall be generated. - -A warning will only be generated just after an attempt to deliver the mail -and if that attempt failed temporarily. -So a warning may be generated after a longer time, if there was no attempt before. - -Default is "1h;4h;8h;1d;2d;3d" - -.TP -\fBmax_defer_time\fR = \fItime\fR - -This is the maximum time, in which a temporarily failed mail will be kept in the spool. -When this time is exceeded, it will be handled as a delivery failure, -and the message will be bounced. - -The excedence of this time will only be noticed if the message was actually tried to be delivered. -If, for example, the message can only be delivered when online, -but you have not been online for that time, no bounce will be generated. - -Default is 4d (4 days) - -.TP -\fBlog_user = \fIname\fR - -Replace \fIname\fR with a valid local or remote mail address. - -If this option is set, then a copy of every mail, -that passes through the masqmail system will also be sent to the given mail address. - -For example you can feed your mails into a program like hypermail -for archiving purpose by placing an appropriate pipe command in masqmail.alias - - -.SH AUTHOR - -Masqmail was written by Oliver Kurth. -It is now maintained by Markus Schnalke . - -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. -There is also a mailing list, you will find information about it at masqmail's main site. - - -.SH BUGS - -Please report bugs to the mailing list. - - -.SH SEE ALSO - -\fBmasqmail(8)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.get(5)\fR diff -r f6a6f55b7b9e -r ed34413652fc docs/masqmail.get.5 --- a/docs/masqmail.get.5 Sat May 29 21:51:13 2010 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,134 +0,0 @@ -.TH masqmail.get 5 2010-05-07 masqmail-0.2.22 "File Formats" - -.SH NAME -masqmail.get \- masqmail get configuration file - - -.SH DESCRIPTION - -This man page describes the options available for the masqmail get configuration. - - -.SH OPTIONS - -.TP -\fBprotocol\fR = \fIstring\fR - -The protocol with which you retrieve your mail. -Currently only `pop3' and `apop' are supported. -There is no default. - -.TP -\fBserver\fR = \fIstring\fR - -The server you get your mail from. - -.TP -\fBresolve_list\fR = \fIlist\fR - -Specify the method how the domain of the server is resolved. -Possible values are dns_mx, dns_a, byname. -For `dns_mx', the domain is assumed to be an MX pointer to a list of host names, -these will be tried each in order -(lowest preference value first, equal preference values in random order). -For `dns_a', the domain is assumed to be an A pointer. -For `byname', the library function \fBgethostbyname(3)\fR will be used. - -The default is "dns_a;byname". -It does not make much sense here to use `dns_mx'. - -.TP -\fBuser\fR = \fIstring\fR - -Your login name. - -.TP -\fBpass\fR = \fIstring\fR - -Your password. - -.TP -\fBaddress\fR = \fIaddress\fR - -The address where the retrieved mail should be sent to. -It can be any address, but you probably want to set this to a local address on your LAN. - -.TP -\fBreturn_path\fR = \fIaddress\fR - -If set, masqmail sets the return path to this address. -Bounces generated during further delivery will be sent to this address. -If unset, masqmail looks for the Return-Path: header in the mail, -if this does not exist it uses the From: address and if this fails, postmaster will be used. - -It is in most cases not useful to set this to the same address as the `address' -option as this may generate multiple bounces. -postmaster is recommended. - -.TP -\fBdo_keep\fR = \fIboolean\fR - -If you want to keep your mail on the server after you retrieved it, set this to true. -It is recommended that you also set do_uidl, -otherwise you will get the mail again each time you connect to the server. -Masqmail does not check any headers before it retrieves mail, which may mark it as already fetched. -Note that this behaviour is different to that of fetchmail. -The default is false. - -.TP -\fBdo_uidl\fR = \fIboolean\fR - -If set, masqmail keeps a list of unique IDs of mails already fetched, -so that they will not be retrieved again. -Default is false. - -.TP -\fBdo_uidl_dele\fR = \fIboolean\fR - -If set, and \fBdo_uidl\fR is also set, MasqMail sends a delete (DELE) command -to the server for each message uid in the uid listing at the beginning of the session. -This prevents mail to be left on the server if masqmail gets interrupted during -a session before it can send the QUIT command to the server. -Default is false. - -.TP -\fBmax_size\fR = \fInumeric\fR - -If set to a value > 0, only messages smaller than this in bytes will be retrieved. -The default is 0. - -.TP -\fBmax_count\fR = \fInumeric\fR - -If set to a value > 0, only \fBmax_count\fR messages will be retrieved. -The default is 0. - -.TP -\fBwrapper\fR = \fIcommand\fR - -If set, instead of opening a connection to a remote server, -\fIcommand\fR will be called and all traffic will be piped to its stdin and from its stdout. -Purpose is to tunnel ip traffic, e.g. for ssl. - -Example for ssl tunneling: - -wrapper="/usr/bin/openssl s_client \-quiet \-connect pop.gmx.net:995 2>/dev/null" - - -.SH AUTHOR - -Masqmail was written by Oliver Kurth. -It is now maintained by Markus Schnalke . - -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. -There is also a mailing list, you will find information about it at masqmail's main site. - - -.SH BUGS - -Please report bugs to the mailing list. - - -.SH SEE ALSO - -\fBmasqmail(8)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.conf(5)\fR diff -r f6a6f55b7b9e -r ed34413652fc docs/masqmail.route.5 --- a/docs/masqmail.route.5 Sat May 29 21:51:13 2010 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,308 +0,0 @@ -.TH masqmail.route 5 2010-05-07 masqmail-0.2.22 "File Formats" - -.SH NAME -masqmail.route \- masqmail route configuration file - - -.SH DESCRIPTION - -This man page describes the syntax of the route configuration files of \fBmasqmail (8)\fR. -Their usual locations are in \fI/etc/masqmail/\fR. - -.SH OPTIONS - -.TP -\fBprotocol\fR = \fIstring\fR - -\fIstring\fR can be one of `smtp' or `pipe', default is `smtp'. -If set to `smtp', mail will be sent with the SMTP protocol to its destination. -If set to `pipe', you also have to set `pipe' to a command, the message will then be piped to a program. -See option `pipe' below. - -.TP -\fBmail_host\fR = \fIstring\fR - -This is preferably the mail server of your ISP. -All outgoing messages will be sent to this host which will distribute them to their destinations. -If you do not set this mails will be sent directly. -Because the mail server is probably `near' to you, mail transfer will be much faster if you use it. - -You can optionally give a port number following the host name and a colon, eg mail_host="mail.foo.com:25". - -.TP -\fBresolve_list\fR = \fIlist\fR - -Specify the method how the domain of the server is resolved. -Possible values are dns_mx, dns_a, byname. -For `dns_mx', the domain is assumed to be an MX pointer to a list of host names, -these will be tried each in order (lowest preference value first, equal preference values in random order). -For `dns_a', the domain is assumed to be an A pointer. -For `byname', the library function \fBgethostbyname(3)\fR will be used. - -The default is "dns_mx;dns_a;byname". - -.TP -\fBconnect_error_fail\fR = \fIboolean\fR - -If this is set, a connection error will cause a mail delivery to fail, ie. it will be bounced. -If it is unset, it will just be defered. - -Default is false. -The reason for this is that masqmail is designed for non permanent internet connections, -where such errors may occur quite often, and a bounce would be annoying. - -For the default local_net route is is set to true. - -.TP -\fBhelo_name\fR = \fIstring\fR - -Set the name given with the HELO/EHLO command. If this is not set, -\fBhost_name\fR from \fImasqmail.conf\fR will be used, -if the \fBdo_correct_helo\fR option (see below) is unset. - -.TP -\fBdo_correct_helo\fR = \fIboolean\fR - -If this is set, masqmail tries to look up your host name as it appears -on the internet and sends this in the HELO/EHLO command. -Some servers are so picky that they want this. -Which is really crazy. -It just does not make any sense to lie about ones own identity, -because it can always be looked up by the server. -Nobody should believe in the name given by HELO/EHLO anyway. -If this is not set, \fBhost_name\fR from \fImasqmail.conf\fR or as given with -the \fBhelo_name\fR (see above) will be used. - -.TP -\fBdo_pipelining\fR = \fIboolean\fR - -If this is set to false, masqmail will not use ESMTP PIPELINING, -even if the server announces that it is able to cope with it. -Default is true. - -You do not want to set this to false unless the mail setup on the -remote server side is really broken. -Keywords: wingate. - -.TP -\fBallowed_mail_locals\fR = \fIlist\fR - -This is a semicolon `;' separated list of local parts which will be allowed -to send mail through this connection. -If unset and \fBnot_allowed_mail_locals\fR is also unset, all users are allowed. - -.TP -\fBnot_allowed_mail_locals\fR = \fIlist\fR - -This is a semicolon `;' separated list of local parts which will be not allowed -to send mail through this connection. -Local parts in this list will not be allowed to use this route even if they -are part of \fBallowed_mail_locals\fR (see above). - -.TP -\fBallowed_return_paths\fR = \fIlist\fR - -This is a semicolon `;' separated list of addresses. -Messages which have one one of these addresses as the return path will be used using this route -(if not also in \fBnot_allowed_return_paths\fR or an item in \fBnot_allowed_mail_locals\fR matches). - -Patterns containing `?' and `*' can be used. -The special item "<>" matches the null sender address (eg. failure notices or delivery notifications). - -.TP -\fBnot_allowed_return_paths\fR = \fIlist\fR - -This is a semicolon `;' separated list of addresses. -Messages which have one one of these addresses as the return path will not -be used using this route (even if also in \fBallowed_return_paths\fR -or an item in \fBallowed_mail_locals\fR matches). - -Patterns containing `?' and `*' can be used. -The special item "<>" matches the null sender address (eg. failure notices or delivery notifications). - -.TP -\fBallowed_rcpt_domains\fR = \fIlist\fR - -A list of recipient domains where mail will be sent to. -This is for example useful if you use this route configuration when connected to another LAN via ppp. -Patterns containing `?' and `*' can be used. - -.TP -\fBnot_allowed_rcpt_domains\fR = \fIlist\fR - -A list of recipient domains where mail will not be sent to. -This is for example useful if you send mail directly (\fBmail_host\fR is not set) -and you know of hosts that will not accept mail from you because they use a dialup list -(eg. \fBhttp://maps.vix.com/dul/\fR). -If any domain matches both \fBallowed_rcpt_domains\fR and \fBnot_allowed_rcpt_domains\fR, -mail will not be sent to this domain. -Patterns containing `?' and `*' can be used. - -.TP -\fBset_h_from_domain\fR = \fIstring\fR - -Replace the domain part in `From:' headers with this value. -This may be useful if you use a private, outside unknown address on your local LAN -and want this to be replaced by the domain of the address of your email addrsss on the internet. -Note that this is different to \fBset_return_path_domain\fR, see below. - -.TP -\fBset_return_path_domain\fR = \fIstring\fR - -Sets the domain part of the envelope from address. -Some hosts check whether this is the same as the net the connection is coming from. -If not, they reject the mail because they suspect spamming. -It should be a valid address, because some mail servers also check that. -You can also use this to set it to your usual address on the internet -and put a local address only known on your LAN in the configuration of your mailer. -Only the domain part will be changed, the local part remains unchanged. -Use \fBmap_return_path_addresses\fR for rewriting local parts. - -.TP -\fBmap_h_from_addresses\fR = \fIlist\fR - -This is similar to \fBset_h_from_domain\fR, but more flexible. -Set this to a list which maps local parts to a full RFC 822 compliant email address, -the local parts (the keys) are separated from the addresses (the values) by colons (`:'). - -Example: - -map_h_from_addresses = "john: John Smith ; charlie: Charlie Miller " - -You can use patterns, eg. * as keys. - -.TP -\fBmap_h_reply_to_addresses\fR = \fIlist\fR - -Same as \fBmap_h_from_addresses\fR, but for the `Reply-To:' header. - -.TP -\fBmap_h_mail_followup_to_addresses\fR = \fIlist\fR - -Same as \fBmap_h_from_addresses\fR, but for the `Mail-Followup-To:' header. -Useful when replying to mailing lists. - -.TP -\fBmap_return_path_addresses\fR = \fIlist\fR - -This is similar to \fBset_return_path_domain\fR, but more flexible. -Set this to a list which maps local parts to a full RFC 821 compliant email address, -the local parts (the keys) are separated from the addresses (the values) by colons (`:'). -Note that this option takes RFC 821 addresses while \fBmap_h_from_addresses\fR takes RFC 822 addresses. -The most important difference is that RFC 821 addresses have no full name. - -Example: - -map_return_path_addresses = "john: ; charlie: " - -You can use patterns, eg. * as keys. - -.TP -\fBexpand_h_sender_address\fR = \fIboolean\fR - -This sets the domain of the sender address as given by the Sender: header -to the same address as in the envelope return path address -(which can be set by either \fBset_return_path_domain\fR or \fBmap_return_path_addresses\fR). -This is for mail clients (eg. Microsoft Outlook) which use this address as the sender address. -Though they should use the From: address, see RFC 821. -If \fBfetchmail(1)\fR encounters an unqualified Sender: address, -it will be expanded to the domain of the pop server, which is almost never correct. -Default is true. - -.TP -\fBexpand_h_sender_domain\fR = \fIboolean\fR - -Like \fBexpand_h_sender_address\fR, but sets the domain only. -Deprecated, will be removed in a later version. - -.TP -\fBlast_route\fR = \fIboolean\fR - -If this is set, a mail which would have been delivered using this route, -but has failed temporarily, will not be tried to be delivered using the next route. - -If you have set up a special route with filters using the lists `allowed_rcpt_domains', -`allowed_return_paths', and `allowed_mail_locals' or their complements (not_), -and the mail passing these rules should be delivered using this route only, -you should set this to `true'. -Otherwise the mail would be passed to the next route (if any), -unless that route has rules which prevent that. - -Default is false. - -.TP -\fBauth_name\fR = \fIstring\fR - -Set the authentication type for ESMTP AUTH authentication. -Currently only `cram-md5' and `login' are supported. - -.TP -\fBauth_login\fR = \fIstring\fR - -Your account name for ESMTP AUTH authentication. - -.TP -\fBauth_secret\fR = \fIstring\fR - -Your secret for ESMTP AUTH authentication. - -.TP -\fBpop3_login\fR = \fIfile\fR - -If your Mail server requires SMTP-after-POP, -set this to a get configuration (see \fBmasqmail.get(5)\fR). -If you login to the POP server before you send, this is not necessary. - -.TP -\fBwrapper\fR = \fIcommand\fR - -If set, instead of opening a connection to a remote server, -\fIcommand\fR will be called and all traffic will be piped to its stdin and from its stdout. -Purpose is to tunnel ip traffic, eg. for ssl. - -Example for ssl tunneling: - -wrapper="/usr/bin/openssl s_client \-quiet \-connect pop.gmx.net:995 2>/dev/null" - -.TP -\fBpipe\fR = \fIcommand\fR - -If set, and protocol is set to `pipe', -\fIcommand\fR will be called and the message will be piped to its stdin. -Purpose is to use gateways to uucp, fax, sms or whatever else. - -You can use variables to give as arguments to the command, -these are the same as for the mda in the main configuration, see \fBmasqmail.conf(5)\fR. - -.TP -\fBpipe_fromline = \fIboolean\fR - -If this is set, and protocol is set to `pipe', -a from line will be prepended to the output stream whenever a pipe command is called. -Default is false. - -.TP -\fBpipe_fromhack = \fIboolean\fR - -If this is set, and protocol is set to `pipe', -each line beginning with `From ' is replaced with `>From ' whenever a pipe command is called. -You probably want this if you have set \fBpipe_fromline\fR above. -Default is false. - - -.SH AUTHOR - -Masqmail was written by Oliver Kurth. -It is now maintained by Markus Schnalke . - -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. -There is also a mailing list, you will find information about it at masqmail's main site. - - -.SH BUGS - -Please report bugs to the mailing list. - -.SH SEE ALSO - -\fBmasqmail(8)\fR, \fBmasqmail.conf(5)\fR, \fBmasqmail.get(5)\fR diff -r f6a6f55b7b9e -r ed34413652fc docs/mservdetect.8 --- a/docs/mservdetect.8 Sat May 29 21:51:13 2010 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,49 +0,0 @@ -.TH mservdetect 8 2010-05-07 masqmail-0.2.22 "Maintenance Commands" - -.SH NAME -mservdetect \- Helper for masqmail and masqdialer - - -.SH SYNOPSIS -\fB/usr/bin/masqmail \fIhost port\fR - - -.SH DESCRIPTION - -Mservdetect is a small helper application for masqmail to detect its online status -if the modem server masqdialer is used. -It connects to the\fIhost\fR at \fIport\fR and prints the connection name to stdout. - -If you want to use it, set \fBonline_detect\fR=\fIpipe\fR and -\fBonline_pipe\fR=\fI"/usr/bin/mservdetect host port"\fR. - -.SH OPTIONS - -.TP -\fBhost\fR - -The hostname where the masqdialer server is running. - -.TP -\fBport\fR - -The port number where the masqdialer server is listening. - - -.SH AUTHOR - -Masqmail was written by Oliver Kurth. -It is now maintained by Markus Schnalke . - -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. -There is also a mailing list, you will find information about it at masqmail's main site. - - -.SH BUGS - -Please report bugs to the mailing list. - - -.SH SEE ALSO - -\fBmasqmail.conf(5)\fR diff -r f6a6f55b7b9e -r ed34413652fc man/Makefile.am --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/man/Makefile.am Sat May 29 22:07:07 2010 +0200 @@ -0,0 +1,1 @@ +man_MANS=masqmail.8 mservdetect.8 masqmail.conf.5 masqmail.route.5 masqmail.get.5 masqmail.aliases.5 diff -r f6a6f55b7b9e -r ed34413652fc man/Makefile.in --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/man/Makefile.in Sat May 29 22:07:07 2010 +0200 @@ -0,0 +1,454 @@ +# Makefile.in generated by automake 1.11.1 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation, +# Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkglibexecdir = $(libexecdir)/@PACKAGE@ +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +subdir = man +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs +CONFIG_HEADER = $(top_builddir)/config.h +CONFIG_CLEAN_FILES = +CONFIG_CLEAN_VPATH_FILES = +SOURCES = +DIST_SOURCES = +am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; +am__vpath_adj = case $$p in \ + $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ + *) f=$$p;; \ + esac; +am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`; +am__install_max = 40 +am__nobase_strip_setup = \ + srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'` +am__nobase_strip = \ + for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||" +am__nobase_list = $(am__nobase_strip_setup); \ + for p in $$list; do echo "$$p $$p"; done | \ + sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \ + $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \ + if (++n[$$2] == $(am__install_max)) \ + { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \ + END { for (dir in files) print dir, files[dir] }' +am__base_list = \ + sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \ + sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g' +man5dir = $(mandir)/man5 +am__installdirs = "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(man8dir)" +man8dir = $(mandir)/man8 +NROFF = nroff +MANS = $(man_MANS) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +AMTAR = @AMTAR@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +BASE64_LIBS = @BASE64_LIBS@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +EXEEXT = @EXEEXT@ +GLIB_CFLAGS = @GLIB_CFLAGS@ +GLIB_LIBS = @GLIB_LIBS@ +GREP = @GREP@ +IDENT_LIBS = @IDENT_LIBS@ +INSTALL = @INSTALL@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +LDFLAGS = @LDFLAGS@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LOCKFILE_LIBS = @LOCKFILE_LIBS@ +LTLIBOBJS = @LTLIBOBJS@ +MAKEINFO = @MAKEINFO@ +MD5_LIBS = @MD5_LIBS@ +MKDIR_P = @MKDIR_P@ +OBJEXT = @OBJEXT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_URL = @PACKAGE_URL@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PKG_CONFIG = @PKG_CONFIG@ +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@ +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@ +RANLIB = @RANLIB@ +RESOLV_LIBS = @RESOLV_LIBS@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +USE_LIBLOCKFILE = @USE_LIBLOCKFILE@ +VERSION = @VERSION@ +abs_builddir = @abs_builddir@ +abs_srcdir = @abs_srcdir@ +abs_top_builddir = @abs_top_builddir@ +abs_top_srcdir = @abs_top_srcdir@ +ac_ct_CC = @ac_ct_CC@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build_alias = @build_alias@ +builddir = @builddir@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +has_ident = @has_ident@ +host_alias = @host_alias@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +srcdir = @srcdir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +top_build_prefix = @top_build_prefix@ +top_builddir = @top_builddir@ +top_srcdir = @top_srcdir@ +with_confdir = @with_confdir@ +with_group = @with_group@ +with_logdir = @with_logdir@ +with_spooldir = @with_spooldir@ +with_user = @with_user@ +man_MANS = masqmail.8 mservdetect.8 masqmail.conf.5 masqmail.route.5 masqmail.get.5 masqmail.aliases.5 +all: all-am + +.SUFFIXES: +$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \ + && { if test -f $@; then exit 0; else break; fi; }; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu man/Makefile'; \ + $(am__cd) $(top_srcdir) && \ + $(AUTOMAKE) --gnu man/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(am__aclocal_m4_deps): +install-man5: $(man_MANS) + @$(NORMAL_INSTALL) + test -z "$(man5dir)" || $(MKDIR_P) "$(DESTDIR)$(man5dir)" + @list=''; test -n "$(man5dir)" || exit 0; \ + { for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.5[a-z]*$$/p'; \ + } | while read p; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + echo "$$d$$p"; echo "$$p"; \ + done | \ + sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ + sed 'N;N;s,\n, ,g' | { \ + list=; while read file base inst; do \ + if test "$$base" = "$$inst"; then list="$$list $$file"; else \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man5dir)/$$inst'"; \ + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man5dir)/$$inst" || exit $$?; \ + fi; \ + done; \ + for i in $$list; do echo "$$i"; done | $(am__base_list) | \ + while read files; do \ + test -z "$$files" || { \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man5dir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(man5dir)" || exit $$?; }; \ + done; } + +uninstall-man5: + @$(NORMAL_UNINSTALL) + @list=''; test -n "$(man5dir)" || exit 0; \ + files=`{ for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.5[a-z]*$$/p'; \ + } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ + test -z "$$files" || { \ + echo " ( cd '$(DESTDIR)$(man5dir)' && rm -f" $$files ")"; \ + cd "$(DESTDIR)$(man5dir)" && rm -f $$files; } +install-man8: $(man_MANS) + @$(NORMAL_INSTALL) + test -z "$(man8dir)" || $(MKDIR_P) "$(DESTDIR)$(man8dir)" + @list=''; test -n "$(man8dir)" || exit 0; \ + { for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.8[a-z]*$$/p'; \ + } | while read p; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + echo "$$d$$p"; echo "$$p"; \ + done | \ + sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ + sed 'N;N;s,\n, ,g' | { \ + list=; while read file base inst; do \ + if test "$$base" = "$$inst"; then list="$$list $$file"; else \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man8dir)/$$inst'"; \ + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man8dir)/$$inst" || exit $$?; \ + fi; \ + done; \ + for i in $$list; do echo "$$i"; done | $(am__base_list) | \ + while read files; do \ + test -z "$$files" || { \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man8dir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(man8dir)" || exit $$?; }; \ + done; } + +uninstall-man8: + @$(NORMAL_UNINSTALL) + @list=''; test -n "$(man8dir)" || exit 0; \ + files=`{ for i in $$list; do echo "$$i"; done; \ + l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \ + sed -n '/\.8[a-z]*$$/p'; \ + } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ + test -z "$$files" || { \ + echo " ( cd '$(DESTDIR)$(man8dir)' && rm -f" $$files ")"; \ + cd "$(DESTDIR)$(man8dir)" && rm -f $$files; } +tags: TAGS +TAGS: + +ctags: CTAGS +CTAGS: + + +distdir: $(DISTFILES) + @list='$(MANS)'; if test -n "$$list"; then \ + list=`for p in $$list; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + if test -f "$$d$$p"; then echo "$$d$$p"; else :; fi; done`; \ + if test -n "$$list" && \ + grep 'ab help2man is required to generate this page' $$list >/dev/null; then \ + echo "error: found man pages containing the \`missing help2man' replacement text:" >&2; \ + grep -l 'ab help2man is required to generate this page' $$list | sed 's/^/ /' >&2; \ + echo " to fix them, install help2man, remove and regenerate the man pages;" >&2; \ + echo " typically \`make maintainer-clean' will remove them" >&2; \ + exit 1; \ + else :; fi; \ + else :; fi + @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ + list='$(DISTFILES)'; \ + dist_files=`for file in $$list; do echo $$file; done | \ + sed -e "s|^$$srcdirstrip/||;t" \ + -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \ + case $$dist_files in \ + */*) $(MKDIR_P) `echo "$$dist_files" | \ + sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \ + sort -u` ;; \ + esac; \ + for file in $$dist_files; do \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + if test -d $$d/$$file; then \ + dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test -d "$(distdir)/$$file"; then \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \ + find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \ + fi; \ + cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \ + else \ + test -f "$(distdir)/$$file" \ + || cp -p $$d/$$file "$(distdir)/$$file" \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-am +all-am: Makefile $(MANS) +installdirs: + for dir in "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(man8dir)"; do \ + test -z "$$dir" || $(MKDIR_P) "$$dir"; \ + done +install: install-am +install-exec: install-exec-am +install-data: install-data-am +uninstall: uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +clean: clean-am + +clean-am: clean-generic mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic + +dvi: dvi-am + +dvi-am: + +html: html-am + +html-am: + +info: info-am + +info-am: + +install-data-am: install-man + +install-dvi: install-dvi-am + +install-dvi-am: + +install-exec-am: + +install-html: install-html-am + +install-html-am: + +install-info: install-info-am + +install-info-am: + +install-man: install-man5 install-man8 + +install-pdf: install-pdf-am + +install-pdf-am: + +install-ps: install-ps-am + +install-ps-am: + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: uninstall-man + +uninstall-man: uninstall-man5 uninstall-man8 + +.MAKE: install-am install-strip + +.PHONY: all all-am check check-am clean clean-generic distclean \ + distclean-generic distdir dvi dvi-am html html-am info info-am \ + install install-am install-data install-data-am install-dvi \ + install-dvi-am install-exec install-exec-am install-html \ + install-html-am install-info install-info-am install-man \ + install-man5 install-man8 install-pdf install-pdf-am \ + install-ps install-ps-am install-strip installcheck \ + installcheck-am installdirs maintainer-clean \ + maintainer-clean-generic mostlyclean mostlyclean-generic pdf \ + pdf-am ps ps-am uninstall uninstall-am uninstall-man \ + uninstall-man5 uninstall-man8 + + +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: diff -r f6a6f55b7b9e -r ed34413652fc man/masqmail.8 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/man/masqmail.8 Sat May 29 22:07:07 2010 +0200 @@ -0,0 +1,293 @@ +.TH masqmail 8 2010-05-07 masqmail-0.2.22 "Maintenance Commands" + +.SH NAME +masqmail \- An offline Mail Transfer Agent + +.SH SYNOPSIS +\fB/usr/sbin/masqmail \fR[\fB\-C \fIfile\fR] [\fB\-odq\fR] [\fB\-bd\fR] [\fB\-q\fIinterval\fR] + +\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-bs\fR] + +\fB/usr/sbin/masqmail \fR[\fB\-bp\fR] + +\fB/usr/sbin/masqmail \fR[\fB\-q\fR] + +\fB/usr/sbin/masqmail \fR[\fB\-qo \fR[\fIname\fR]] + +\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-g \fR[\fIname\fR]] + +\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-go \fR[\fIname\fR]] + +\fB/usr/sbin/masqmail \fR[\fB\-t\fR] [\fB\-oi\fR] [\fB\-f \fIaddress\fR] [\fB\-\-\fR] \fIaddress... + +\fB/usr/sbin/mailq\fR + + +.SH DESCRIPTION + +Masqmail is a mail server designed for hosts that do not have a permanent internet connection +e.g. a home network or a single host at home. +It has special support for connections to different ISPs. +It replaces sendmail or other MTAs such as qmail or exim. +It can also act as a pop3 client. + + +.SH OPTIONS + +Since masqmail is intended to replace sendmail, it uses the same command line options, +but not all are implemented. +There are also two additional options, which are unique to masqmail +(\fB\-qo \fIconnection\fR and \fB\-g\fR) + +.TP +\fB\-\-\fR + +Not a `real' option, it means that all following arguments are to be understood +as arguments and not as options even if they begin with a leading dash `\-'. +Mutt is known to call sendmail with this option. + +.TP +\fB\-bd\fR + +Run as daemon, accepting connections, usually on port 25 if not configured differently. +This is usually used in the startup script at system boot and together with +the \fB\-q\fR option (see below). + +.TP +\fB\-bi\fR + +Old sendmail rebuilds its alias database when invoked with this option. +Masqmail ignores it. +Masqmail reads directly from the file given with `alias_file' in the config file. + +.TP +\fB\-bp\fR + +Show the messages in the queue. Same as calling masqmail as `mailq'. + +.TP +\fB\-bs\fR + +Accept SMTP commands from stdin. +Some mailers (e.g. pine) use this option as an interface. +It can also be used to call masqmail from inetd. + +.TP +\fB\-B \fIarg\fR + +\fIarg\fR is usually 8BITMIME. +Some mailers use this to indicate that the message contains characters > 127. +Masqmail is 8-bit clean and ignores this, so you do not have to recompile elm, +which is very painful ;-). +Note though that this violates some conventions: +masqmail does not convert 8 bit messages to any MIME format if it encounters +a mail server which does not advertise its 8BITMIME capability, +masqmail does not advertise this itself. +This is the same practice as that of exim (but different to sendmail). + +.TP +\fB\-bV \fR + +Show version information. + +.TP +\fB\-C \fIfilename\fR + +Use another configuration than \fI/etc/masqmail/masqmail.conf\fR. +Useful for debugging purposes. +If not invoked by a privileged user, masqmail will drop all privileges. + +.TP +\fB\-d \fInumber\fR + +Set the debug level. +This takes precedence before the value of `debug_level' in the configuration file. +Read the warning in the description of the latter. + +.TP +\fB\-f [\fIaddress\fB]\fR + +Set the return path address to \fIaddress\fR. +Only root, the user mail and anyone in group mail is allowed to do that. + +.TP +\fB\-F [\fIstring\fB]\fR + +Set the full sender name (in the From: header) to \fIstring\fR. + +.TP +\fB\-g [\fIname\fB]\fR + +Get mail (using pop3 or apop), +using the configurations given with get.\fIname\fR in the main configuration. +Without \fIname\fR, all get configurations will be used. +See also \fBmasqmail.get(5)\fR + +.TP +\fB\-go [\fIinterval\fB] [\fIname\fB]\fR + +Can be followed by a connection name. +Use this option in your script which starts as soon as a link to the internet +has been set up (usually ip-up). +When masqmail is called with this option, the specified get configuration(s) +is(are) read and mail will be retrieved from servers on the internet. +The \fIname\fR is defined in the configuration (see \fBonline_gets.\fIname\fR). + +If called with an interval option (recognized by a digit as the first characater), +masqmail starts as a daemon and tries to get mail in these intervals. +It checks for the online status first. +Example: `masqmail \-go 5m' will retrieve mail every five minutes. + +If called without \fIname\fR the online status is determined with the configured method +(see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR). + +.TP +\fB\-i\fR + +Same as \fB\-oi\fR, see below. + +.TP +\fB\-Mrm \fIlist\fR + +Remove given messages from the queue. +Only allowed for privileged users. +The identifiers of messages are listed in the output of +\fImasqmail -bp\fP (\fImailq\fR). + +.TP +\fB\-oem\fR + +If the \fB\-oi\fR ist not also given, always return with a non zero return code. +Maybe someone tells me what this is good for... + +.TP +\fB\-odb\fR + +Deliver in background. +Masqmail always does this, which makes this option pretty much useless. + +.TP +\fB\-odq\fR + +Do not attempt to deliver immediately. +Any messages will be queued until the next queue running process picks them up and delivers them. +You get the same effect by setting the do_queue option in /etc/masqmail/masqmail.conf. + +.TP +\fB\-oi\fR + +A dot as a single character in a line does not terminate the message. + +.TP +\fB\-q [\fIinterval\fB]\fR + +If not given with an argument, run a queue process, i.e. try to deliver all messages in the queue. +Masqmail sends only to those addresses that are on the local net, not to those that are outside. +Use \fB\-qo\fR for those. + +If you have configured inetd to start masqmail, +you can use this option in a cron job which starts in regular time intervals, +to mimic the same effect as starting masqmail with \fB\-bd \-q30m\fR. + +An argument may be a time interval i.e. a numerical value followed by one of the letters. +s,m,h,d,w which are interpreted as seconds, minutes, hours, days or weeks respectively. +Example: \fB\-q30m\fR. +Masqmail starts as a daemon and a queue runner process will be started automatically +once in this time interval. +This is usually used together with \fB\-bd\fR (see above). + +.TP +\fB\-qo [\fIname\fB]\fR + +Can be followed by a connection name. +Use this option in your script which starts as soon as a link to the internet +has been set up (usually ip-up). +When masqmail is called with this option, the specified route configuration +is read and the queued mail with destinations on the internet will be sent. +The \fIname\fR is defined in the configuration (see \fBonline_routes.\fIname\fR). + +If called without \fIname\fR the online status is determined with the configured +method (see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR) + +.TP +\fB\-t\fR + +Read recipients from headers. +Delete `Bcc:' headers. +If any arguments are given, these are interpreted as recipient addresses +and the message will not be sent to these. + +.TP +\fB\-v\fR + +Log also to stdout. +Currently, some log messages are marked as `write to stdout' and additionally, +all messages with priority `LOG_ALERT' and `LOG_WARNING' will be written to stdout +if this option is given. It is disabled in daemon mode. + + +.SH ENVIRONMENT FOR PIPES AND MDAS + +For security reasons, before any pipe command from an alias expansion or an mda is called, +the environment variables will be completely discarded and newly set up. These are: + +SENDER, RETURN_PATH \(en the return path. + +SENDER_DOMAIN \(en the domain part of the return path. + +SENDER_LOCAL \(en the local part of the return path. + +RECEIVED_HOST \(en the host the message was received from (unless local). + +LOCAL_PART, USER, LOGNAME \(en the local part of the (original) recipient. + +MESSAGE_ID \(en the unique message id. +This is not necessarily identical with the Message ID as given in the Message ID: header. + +QUALIFY_DOMAIN \(en the domain which will be appended to unqualified addresses. + + +.SH FILES + +\fI/etc/masqmail/masqmail.conf\fR is the main configuration for masqmail. +Depending on the settings in this file, you will also have other configuration +files in \fI/etc/masqmail/\fR. + +\fI/var/spool/masqmail/\fR is the spool directory where masqmail stores +its spooled messages and the uniq pop ids. + +\fI/var/spool/mail/\fR is the directory where locally delivered mail will be put, +if not configured differently in \fImasqmail.conf\fR. + +\fI/var/log/masqmail/\fR is the directory where masqmail stores its log mesages. +This can also be somewhere else if configured differently by your sysadmin or the package mantainer. + + +.SH CONFORMING TO + +RFC 821, 822, 1869, 1870, 2197, 2554 (SMTP) + +RFC 1725, 1939 (POP3) + +RFC 1321 (MD5) + +RFC 2195 (CRAM-MD5) + + +.SH AUTHOR + +Masqmail was written by Oliver Kurth. +It is now maintained by Markus Schnalke . + +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. +There is also a mailing list, you will find information about it at masqmail's main site. + + +.SH BUGS + +Please report them to the mailing list. + + +.SH SEE ALSO + +\fBmasqmail.conf(5)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.get(5)\fR, \fBmasqmail.aliases(5)\fR diff -r f6a6f55b7b9e -r ed34413652fc man/masqmail.aliases.5 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/man/masqmail.aliases.5 Sat May 29 22:07:07 2010 +0200 @@ -0,0 +1,54 @@ +.TH masqmail.aliases 5 2010-05-07 masqmail-0.2.22 "File Formats" + +.SH NAME +masqmail.aliases \- masqmail alias file format + + +.SH DESCRIPTION + +This man page describes the format of the masqmail alias file. +Its usual location is \fI/etc/aliases\fR. + + +.SH FILE FORMAT + +The alias file consists of lines of the form: +local_part: item1, item2, ... +Items can be surrounded by double quotes `"'. +If within the quotes other quotes are needed for an address they can be +escaped with a leading backslash `\\'. + +A leading backslash `\\' indicates that this address shall not be further expanded. + +A leading pipe symbol `|' indicates that the item shall be treated as a pipe command. +The content of the message will then be sent to the standard input of a command. +The command will run under the user id and group id masqmail is running as. +If quotes are needed, the pipe symbol must appear within the quotes. + +Loops will be detected, the offending address will be ignored. + +Aliases will be expanded at delivery time. +This means that if there is a message still in the queue and you change +any alias which matches one of the recipient addresses, +the change will have effect next time a delivery is attemped. + +There is no need to restart masqmail or run any command when the alias file has been changed. + + +.SH AUTHOR + +Masqmail was written by Oliver Kurth. +It is now maintained by Markus Schnalke . + +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. +There is also a mailing list, you will find information about it at masqmail's main site. + + +.SH BUGS + +Please report bugs to the mailing list. + + +.SH SEE ALSO + +\fBmasqmail.conf(5)\fR, \fBmasqmail(8)\fR, diff -r f6a6f55b7b9e -r ed34413652fc man/masqmail.conf.5 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/man/masqmail.conf.5 Sat May 29 22:07:07 2010 +0200 @@ -0,0 +1,492 @@ +.TH masqmail.conf 5 2010-05-07 masqmail-0.2.22 "File Formats" + +.SH NAME +masqmail.conf \- masqmail configuration file + + +.SH DESCRIPTION + +This man page describes the syntax of the main configuration file of masqmail. +Its usual location is \fI/etc/masqmail/masqmail.conf\fR + +The configuration consists of lines of the form + +\fBval\fR = \fIexpression\fR + +Where \fBval\fR is a variable name and \fIexpression\fR a string, +which can be quoted with double quotes `"'. +If the expression is on multiple lines or contains characters other than letters, +digits or the characters `.', `-', `_', `/', it must be quoted. +You can use quotes inside quotes by escaping them with a backslash. + +Each val has a type, which can be boolean, numeric, string or list. +A boolean variable can be set with one of the values `on', `yes', and `true' or `off', `no' and `false'. +List items are separated with semicolons `;'. +For some values patterns (like `*',`?') can be used. +The spaces before and after the equal sign `=' are optional. + +Most lists (exceptions: \fBlocal_hosts\fR, \fBlocal_nets\fR, \fBlisten_addresses\fR, +\fBonline_routes\fR, and \fBonline_gets\fR) accept files. +These will be recognized by a leading slash `/'. +The contents of these files will be included at the position of the file name, +there can be items or other files before and after the file entry. +The format of the files is different though, within these files each entry is on another line. +(And not separated by semicolons). +This makes it easy to include large lists which are common in different configuration files, +so they do not have to appear in every configuration file. + +Blank lines and lines starting with a hash `#' are ignored. + + +.SH OPTIONS + +.TP +\fBrun_as_user = \fIboolean\fR + +If this is set, masqmail runs with the user id of the user who invoked it and never changes it. +This is for debugging purposes only. +If the user is not root, masqmail will not be able to listen on a port < 1024 +and will not be able to deliver local mail to others than the user. + +.TP +\fBuse_syslog = \fIboolean\fR + +If this is set, masqmail uses syslogd for logging. +It uses facility MAIL. +You still have to set \fBlog_dir\fR for debug files. + +.TP +\fBdebug_level = \fIn\fR + +Set the debug level. +Valid values are 0 to 6, increasing it further makes no difference. +Be careful if you set this as high as 5 or higher, the logs may very soon fill your hard drive. + +.TP +\fBlog_dir = \fIfile\fR + +The directory where log are stored, if syslog is not used. +Debug files are stored in this directory anyways. +\fI/var/log/masqmail\fR is a common value. +\fIfile\fR must be an absolute path. + +.TP +\fBmail_dir = \fIfile\fR + +The directory where local mail is stored, usually \fI/var/spool/mail\fR or \fI/var/mail\fR. +\fIfile\fR must be an absolute path. + +.TP +\fBspool_dir = \fIfile\fR + +The directory where masqmail stores its spool files (and later also other stuff). +It must have a subdirectory \fIinput\fR. +Masqmail needs read and write permissions for this directory. +I suggest to use \fI/var/spool/masqmail\fR. +\fIfile\fR must be an absolute path. + +.TP +\fBhost_name = \fIstring\fR + +This is used in different places: Masqmail identifies itself in the greeting banner +on incoming connections and in the HELO/EHLO command for outgoing connections with this name, +it is used in the Received: header and to qualify the sender of a locally originating message. + +If the string begins with a slash `/', it it assumed that it is a filename, +and the first line of this file will be used. +Usually this will be `/etc/mailname' to make masqmail conform to Debian policies. + +It is not used to find whether an address is local. Use \fBlocal_hosts\fR for that. + +.TP +\fBremote_port = \fIn\fR + +The remote port number to be used. This defaults to port 25. + +This option is deprecated. +Use \fBhost_name\fR in the route configuration instead. +See \fBmasqmail.route(5)\fR. + +.TP +\fBlocal_hosts = \fIlist\fR + +A semicolon `;' separated list of hostnames which are considered local. +Normally you set it to "localhost;foo;foo.bar.com" if your host has the +fully qualified domain name `foo.bar.com'. + +.TP +\fBlocal_nets = \fIlist\fR + +A semicolon `;' separated list of hostnames which are on the `local' net. +Delivery to these hosts is attempted immediately. +You can use patterns with `*', e.g. "*.bar.com". + +.TP +\fBlocal_addresses = \fIlist\fR + +A semicolon `;' separated list of fully qualified email-addresses which are +considered local although their domain name part is not in the list of \fBlocal_hosts\fR. + +For example: There are two people working at your LAN: person1@yourdomain and person2@yourdomain. +But there are other persons @yourdomain which are NOT local. +So you can not put yourdomain to the list of local_hosts. +If person1 now wants to write to person2@yourdomain and this mail should not leave the LAN then you can put + +local_addresses = "person1@yourdomain;person2@yourdomain" + +to your masqmail.conf. + +.TP +\fBnot_local_addresses = \fIlist\fR + +A semicolon `;' separated list of fully qualified email-addresses which are +considered not local although their domain name part is in the list of \fBlocal_hosts\fR. + +This is the opposite of the previous case. +The majority of addresses of a specific domain are local. +But some users are not. +With this option you can easily exclude these users. + +Example: + +local_hosts = "localhost;myhost;mydomain.net" + +not_local_addresses = "eric@mydomain.net" + +.TP +\fBlisten_addresses = \fIlist\fR + +A semicolon `;' separated list of interfaces on which connections will be accepted. +An interface ist defined by a hostname, optionally followed by a colon `:' and a number for the port. +If this is left out, port 25 will be used. + +You can set this to "localhost:25;foo:25" if your hostname is `foo'. + +Note that the names are resolved to IP addreses. +If your host has different names which resolve to the same IP, +use only one of them, otherwise you will get an error message. + +.TP +\fBdo_save_envelope_to = \fIboolean\fR + +If this is set to true, a possibly existing Envelope-to: header in an incoming mail +which is received via either pop3 or smtp will be saved as an X-Orig-Envelope-to: header. + +This is useful if you retrieve mail from a pop3 server with either masqmail or fetchmail, +and the server supports Envelope-to: headers, +and you want to make use of those with a mail filtering tool, e.g. procmail. +It cannot be preserved because masqmail sets such a header by itself. + +Default is false. + +.TP +\fBdo_relay = \fIboolean\fR + +If this is set to false, mail with a return path that is not local and a destination +that is also not local will not be accepted via smtp and a 550 reply will be given. +Default is true. + +Note that this will not protect you from spammers using open relays, +but from users unable to set their address in their mail clients. + +.TP +\fBdo_queue = \fIboolean\fR + +If this is set, mail will not be delivered immediately when accepted. +Same as calling masqmail with the \fB\-odq\fR option. + +.TP +\fBonline_routes.\fIname\fR = \fIlist\fR + +Replace \fIname\fR with a name to identify a connection. +Set this to a filename (or a list of filenames) for the special route configuration for that connection. +You will use that name to call masqmail with the \fB\-qo\fR option every time a +connection to your ISP is set up. + +Example: Your ISP has the name FastNet. +Then you write the following line in the main configuration: + +\fBonline_routes.FastNet\fR = \fI"/etc/masqmail/fastnet.route"\fR + +\fI/etc/masqmail/fastnet.route\fR is the route configuration file, see \fBmasqmail.route(5)\fR. +As soon as a link to FastNet has been set up, you call masqmail \fB\-qo \fIFastNet\fR. +Masqmail will then read the specified file and send the mails. + +.TP +\fBconnect_route.\fIname\fR = \fIlist\fR + +Old name for \fBonline_routes\fR. + +.TP +\fBlocal_net_route = \fIfile\fR + +This is similar to \fBonline_routes.\fIname\fR but for the local net. +Recipient addresses that are in local_nets will be routed using this route configuration. +Main purpose is to define a mail server with mail_host in your local network. +In simple environments this can be left unset. +If unset, a default route configuration will be used. + +.TP +\fBalias_file = \fIfile\fR + +Set this to the location of your alias file. +If unset, no aliasing will be done. + +.TP +\fBalias_local_caseless = \fIboolean\fR + +If this is set, local parts in the alias file will be matched disregarding upper/lower case. + +.TP +\fBpipe_fromline = \fIboolean\fR + +If this is set, a from line will be prepended to the output stream whenever +a pipe command is called after an alias expansion. +Default is false. + +.TP +\fBpipe_fromhack = \fIboolean\fR + +If this is set, each line beginning with `From ' is replaced with `>From ' +whenever a pipe command is called after an alias expansion. +You probably want this if you have set \fBpipe_fromline\fR above. +Default is false. + +.TP +\fBmbox_default = \fIstring\fR + +The default local delivery method. +Can be one of mbox, mda or maildir (the latter only if maildir support is enabled at compile time). +Default is mbox. +You can override this for each user by using the \fBmbox_users\fR, \fBmda_users\fR, +or \fBmaildir_users\fR options (see below). + +.TP +\fBmbox_users = \fIlist\fR + +A list of users which wish delivery to an mbox style mail folder. + +.TP +\fBmda_users = \fIlist\fR + +A list of users which wish local delivery to an mda. +You have to set \fBmda\fR (see below) as well. + +.TP +\fBmaildir_users = \fIlist\fR + +A list of users which wish delivery to a qmail style maildir. +The path to maildir is ~/Maildir/. +The maildir will be created if it does not exist. + +.TP +\fBmda = \fIexpand string\fR + +If you want local delivery to be transferred to an mda (Mail Delivery Agent), +set this to a command. +The argument will be expanded on delivery time, +you can use variables beginning with a dolloar sign `$', optionally enclosed in curly braces. +Variables you can use are: + +uid - the unique message id. +This is not necessarily identical with the Message ID as given in the Message ID: header. + +received_host - the host the mail was received from + +ident - the ident, this is either the ident delivered by the ident protocol +or the user id of the sender if the message was received locally. + +return_path_local - the local part of the return path (sender). + +return_path_domain - the domain part of the return path (sender). + +return_path - the complete return path (sender). + +rcpt_local - the local part of the recipient. + +rcpt_domain - the domain part of the recipient. + +rcpt - the complete recipient address. + +Example: + +mda="/usr/bin/procmail \-Y \-d ${rcpt_local}" + +For the mda, as for pipe commands, a few environment variables will be set as well. +See \fBmasqmail(8)\fR. +To use environment variables for the mda, the dollar sign `$' has to be escaped with a backslash, +otherwise they will be tried to be expanded with the internal variables. + +.TP +\fBmda_fromline = \fIboolean\fR + +If this is set, a from line will be prepended to the output stream whenever +a message is delivered to an mda. +Default is false. + +.TP +\fBmda_fromhack = \fIboolean\fR + +If this is set, each line beginning with `From ' is replaced with `>From ' +whenever a message is delivered to an mda. +You probably want this if you have set \fBmda_fromline\fR above. +Default is false. + +.TP +\fBonline_detect = \fIstring\fR + +Defines the method masqmail uses to detect whether there is currently an online connection. +It can have the values \fBfile\fR, \fBpipe\fR, or \fBmserver\fR. + +When it is set to \fBfile\fR, masqmail first checks for the existence of \fBonline_file\fR +(see below) and if it exists, it reads it. +The content of the file should be the name of the current connection as defined +with \fBconnect_route.\fIname\fR (trailing whitespace is removed). + +When it is set to \fBpipe\fR, masqmail calls the executable given by the +\fBonline_pipe\fR option (see below) and reads the current online status from its standard output. + +When it is set to \fBmserver\fR, masqmail connects to the masqdialer server +using the value of \fBmserver_iface\fR and asks it whether a connection exists and for the name, +which should be the name of the current connection as defined with \fBconnect_route.\fIname\fR. + +No matter how masqmail detects the online status, +only messages that are accepted at online time will be delivered using the connection. +The spool still has to be emptied with masqmail \fB\-qo\fIconnection\fR. + +.TP +\fBonline_file = \fIfile\fR + +This is the name of the file checked for when masqmail determines whether it is online. +The file should only exist when there is currently a connection. +Create it in your ip-up script with e.g. + +echo \-n > /var/run/masqmail/masqmail-route + +chmod 0644 /var/run/masqmail/masqmail-route + +Do not forget to delete it in your ip-down script. + +.TP +\fBonline_pipe = \fIfile\fR + +This is the name of the executable which will be called to determine the online status. +This executable should just print the name of the current connection to +the standard output and return a zero status code. +masqmail assumes it is offline if the script returns with a non zero status. +Simple example: + +#!/bin/sh + +[ \-e /var/run/masqmail/masqmail-route ] || exit 1 + +cat /var/run/masqmail/masqmail-route + +exit 0 + +Of course, instead of the example above you could as well use \fBfile\fR as +the online detection method, but you can do something more sophisticated. + +.TP +\fBmserver_iface = \fIinterface\fR + +The interface the masqdialer server is listening to. +Usually this will be "localhost:224" if mserver is running on the same host as masqmail. +But using this option, you can also let masqmail run on another host by setting +\fBmserver_iface\fR to another hostname, e.g. "foo:224". + +.TP +\fBget.\fIname\fR = \fIfile\fR + +Replace \fIname\fR with a name to identify a get configuration. +Set this to a filename for the get configuration. +These files will be used to retrieve mail when called with the \-g option. + +.TP +\fBonline_gets.\fIname\fR = \fIlist\fR + +Replace \fIname\fR with a name to identify an online configuration. +Set this to a filename (or a list of filenames) for the get configuration. +These files will be used to retrieve mail when called with the \-go option. + +.TP +\fBident_trusted_nets = \fIlist\fR + +\fIlist\fR is a list of networks of the form a.b.c.d/e (e.g. 192.168.1.0/24), +from which the ident given by the ident protocol will be trusted, +so a user can delete his mail from the queue if the ident is identical to his login name. + +.TP +\fBerrmsg_file = \fIfile\fR + +Set this to a template which will be used to generate delivery failure reports. +Variable parts within the template begin with a dollar sign and are identical +to those which can be used as arguments for the mda command, see \fBmda\fR above. +Additional information can be included with @failed_rcpts, @msg_headers and @msg_body, +these must be at the beginning of a line and will be replaced with the list of the failed recipients, +the message headers and the message body of the failed message. + +Default is /usr/share/masqmail/tpl/failmsg.tpl. + +.TP +\fBwarnmsg_file = \fIfile\fR + +Set this to a template which will be used to generate delivery warning reports. +It uses the same mechanisms for variables as \fBerrmsg_file\fR, see above. + +Default is /usr/share/masqmail/tpl/warnmsg.tpl. + +.TP +\fBwarn_intervals\fR = \fIlist\fR + +Set this to a list of time intervals, at which delivery warnings +(starting with the receiving time of the message) shall be generated. + +A warning will only be generated just after an attempt to deliver the mail +and if that attempt failed temporarily. +So a warning may be generated after a longer time, if there was no attempt before. + +Default is "1h;4h;8h;1d;2d;3d" + +.TP +\fBmax_defer_time\fR = \fItime\fR + +This is the maximum time, in which a temporarily failed mail will be kept in the spool. +When this time is exceeded, it will be handled as a delivery failure, +and the message will be bounced. + +The excedence of this time will only be noticed if the message was actually tried to be delivered. +If, for example, the message can only be delivered when online, +but you have not been online for that time, no bounce will be generated. + +Default is 4d (4 days) + +.TP +\fBlog_user = \fIname\fR + +Replace \fIname\fR with a valid local or remote mail address. + +If this option is set, then a copy of every mail, +that passes through the masqmail system will also be sent to the given mail address. + +For example you can feed your mails into a program like hypermail +for archiving purpose by placing an appropriate pipe command in masqmail.alias + + +.SH AUTHOR + +Masqmail was written by Oliver Kurth. +It is now maintained by Markus Schnalke . + +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. +There is also a mailing list, you will find information about it at masqmail's main site. + + +.SH BUGS + +Please report bugs to the mailing list. + + +.SH SEE ALSO + +\fBmasqmail(8)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.get(5)\fR diff -r f6a6f55b7b9e -r ed34413652fc man/masqmail.get.5 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/man/masqmail.get.5 Sat May 29 22:07:07 2010 +0200 @@ -0,0 +1,134 @@ +.TH masqmail.get 5 2010-05-07 masqmail-0.2.22 "File Formats" + +.SH NAME +masqmail.get \- masqmail get configuration file + + +.SH DESCRIPTION + +This man page describes the options available for the masqmail get configuration. + + +.SH OPTIONS + +.TP +\fBprotocol\fR = \fIstring\fR + +The protocol with which you retrieve your mail. +Currently only `pop3' and `apop' are supported. +There is no default. + +.TP +\fBserver\fR = \fIstring\fR + +The server you get your mail from. + +.TP +\fBresolve_list\fR = \fIlist\fR + +Specify the method how the domain of the server is resolved. +Possible values are dns_mx, dns_a, byname. +For `dns_mx', the domain is assumed to be an MX pointer to a list of host names, +these will be tried each in order +(lowest preference value first, equal preference values in random order). +For `dns_a', the domain is assumed to be an A pointer. +For `byname', the library function \fBgethostbyname(3)\fR will be used. + +The default is "dns_a;byname". +It does not make much sense here to use `dns_mx'. + +.TP +\fBuser\fR = \fIstring\fR + +Your login name. + +.TP +\fBpass\fR = \fIstring\fR + +Your password. + +.TP +\fBaddress\fR = \fIaddress\fR + +The address where the retrieved mail should be sent to. +It can be any address, but you probably want to set this to a local address on your LAN. + +.TP +\fBreturn_path\fR = \fIaddress\fR + +If set, masqmail sets the return path to this address. +Bounces generated during further delivery will be sent to this address. +If unset, masqmail looks for the Return-Path: header in the mail, +if this does not exist it uses the From: address and if this fails, postmaster will be used. + +It is in most cases not useful to set this to the same address as the `address' +option as this may generate multiple bounces. +postmaster is recommended. + +.TP +\fBdo_keep\fR = \fIboolean\fR + +If you want to keep your mail on the server after you retrieved it, set this to true. +It is recommended that you also set do_uidl, +otherwise you will get the mail again each time you connect to the server. +Masqmail does not check any headers before it retrieves mail, which may mark it as already fetched. +Note that this behaviour is different to that of fetchmail. +The default is false. + +.TP +\fBdo_uidl\fR = \fIboolean\fR + +If set, masqmail keeps a list of unique IDs of mails already fetched, +so that they will not be retrieved again. +Default is false. + +.TP +\fBdo_uidl_dele\fR = \fIboolean\fR + +If set, and \fBdo_uidl\fR is also set, MasqMail sends a delete (DELE) command +to the server for each message uid in the uid listing at the beginning of the session. +This prevents mail to be left on the server if masqmail gets interrupted during +a session before it can send the QUIT command to the server. +Default is false. + +.TP +\fBmax_size\fR = \fInumeric\fR + +If set to a value > 0, only messages smaller than this in bytes will be retrieved. +The default is 0. + +.TP +\fBmax_count\fR = \fInumeric\fR + +If set to a value > 0, only \fBmax_count\fR messages will be retrieved. +The default is 0. + +.TP +\fBwrapper\fR = \fIcommand\fR + +If set, instead of opening a connection to a remote server, +\fIcommand\fR will be called and all traffic will be piped to its stdin and from its stdout. +Purpose is to tunnel ip traffic, e.g. for ssl. + +Example for ssl tunneling: + +wrapper="/usr/bin/openssl s_client \-quiet \-connect pop.gmx.net:995 2>/dev/null" + + +.SH AUTHOR + +Masqmail was written by Oliver Kurth. +It is now maintained by Markus Schnalke . + +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. +There is also a mailing list, you will find information about it at masqmail's main site. + + +.SH BUGS + +Please report bugs to the mailing list. + + +.SH SEE ALSO + +\fBmasqmail(8)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.conf(5)\fR diff -r f6a6f55b7b9e -r ed34413652fc man/masqmail.route.5 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/man/masqmail.route.5 Sat May 29 22:07:07 2010 +0200 @@ -0,0 +1,308 @@ +.TH masqmail.route 5 2010-05-07 masqmail-0.2.22 "File Formats" + +.SH NAME +masqmail.route \- masqmail route configuration file + + +.SH DESCRIPTION + +This man page describes the syntax of the route configuration files of \fBmasqmail (8)\fR. +Their usual locations are in \fI/etc/masqmail/\fR. + +.SH OPTIONS + +.TP +\fBprotocol\fR = \fIstring\fR + +\fIstring\fR can be one of `smtp' or `pipe', default is `smtp'. +If set to `smtp', mail will be sent with the SMTP protocol to its destination. +If set to `pipe', you also have to set `pipe' to a command, the message will then be piped to a program. +See option `pipe' below. + +.TP +\fBmail_host\fR = \fIstring\fR + +This is preferably the mail server of your ISP. +All outgoing messages will be sent to this host which will distribute them to their destinations. +If you do not set this mails will be sent directly. +Because the mail server is probably `near' to you, mail transfer will be much faster if you use it. + +You can optionally give a port number following the host name and a colon, eg mail_host="mail.foo.com:25". + +.TP +\fBresolve_list\fR = \fIlist\fR + +Specify the method how the domain of the server is resolved. +Possible values are dns_mx, dns_a, byname. +For `dns_mx', the domain is assumed to be an MX pointer to a list of host names, +these will be tried each in order (lowest preference value first, equal preference values in random order). +For `dns_a', the domain is assumed to be an A pointer. +For `byname', the library function \fBgethostbyname(3)\fR will be used. + +The default is "dns_mx;dns_a;byname". + +.TP +\fBconnect_error_fail\fR = \fIboolean\fR + +If this is set, a connection error will cause a mail delivery to fail, ie. it will be bounced. +If it is unset, it will just be defered. + +Default is false. +The reason for this is that masqmail is designed for non permanent internet connections, +where such errors may occur quite often, and a bounce would be annoying. + +For the default local_net route is is set to true. + +.TP +\fBhelo_name\fR = \fIstring\fR + +Set the name given with the HELO/EHLO command. If this is not set, +\fBhost_name\fR from \fImasqmail.conf\fR will be used, +if the \fBdo_correct_helo\fR option (see below) is unset. + +.TP +\fBdo_correct_helo\fR = \fIboolean\fR + +If this is set, masqmail tries to look up your host name as it appears +on the internet and sends this in the HELO/EHLO command. +Some servers are so picky that they want this. +Which is really crazy. +It just does not make any sense to lie about ones own identity, +because it can always be looked up by the server. +Nobody should believe in the name given by HELO/EHLO anyway. +If this is not set, \fBhost_name\fR from \fImasqmail.conf\fR or as given with +the \fBhelo_name\fR (see above) will be used. + +.TP +\fBdo_pipelining\fR = \fIboolean\fR + +If this is set to false, masqmail will not use ESMTP PIPELINING, +even if the server announces that it is able to cope with it. +Default is true. + +You do not want to set this to false unless the mail setup on the +remote server side is really broken. +Keywords: wingate. + +.TP +\fBallowed_mail_locals\fR = \fIlist\fR + +This is a semicolon `;' separated list of local parts which will be allowed +to send mail through this connection. +If unset and \fBnot_allowed_mail_locals\fR is also unset, all users are allowed. + +.TP +\fBnot_allowed_mail_locals\fR = \fIlist\fR + +This is a semicolon `;' separated list of local parts which will be not allowed +to send mail through this connection. +Local parts in this list will not be allowed to use this route even if they +are part of \fBallowed_mail_locals\fR (see above). + +.TP +\fBallowed_return_paths\fR = \fIlist\fR + +This is a semicolon `;' separated list of addresses. +Messages which have one one of these addresses as the return path will be used using this route +(if not also in \fBnot_allowed_return_paths\fR or an item in \fBnot_allowed_mail_locals\fR matches). + +Patterns containing `?' and `*' can be used. +The special item "<>" matches the null sender address (eg. failure notices or delivery notifications). + +.TP +\fBnot_allowed_return_paths\fR = \fIlist\fR + +This is a semicolon `;' separated list of addresses. +Messages which have one one of these addresses as the return path will not +be used using this route (even if also in \fBallowed_return_paths\fR +or an item in \fBallowed_mail_locals\fR matches). + +Patterns containing `?' and `*' can be used. +The special item "<>" matches the null sender address (eg. failure notices or delivery notifications). + +.TP +\fBallowed_rcpt_domains\fR = \fIlist\fR + +A list of recipient domains where mail will be sent to. +This is for example useful if you use this route configuration when connected to another LAN via ppp. +Patterns containing `?' and `*' can be used. + +.TP +\fBnot_allowed_rcpt_domains\fR = \fIlist\fR + +A list of recipient domains where mail will not be sent to. +This is for example useful if you send mail directly (\fBmail_host\fR is not set) +and you know of hosts that will not accept mail from you because they use a dialup list +(eg. \fBhttp://maps.vix.com/dul/\fR). +If any domain matches both \fBallowed_rcpt_domains\fR and \fBnot_allowed_rcpt_domains\fR, +mail will not be sent to this domain. +Patterns containing `?' and `*' can be used. + +.TP +\fBset_h_from_domain\fR = \fIstring\fR + +Replace the domain part in `From:' headers with this value. +This may be useful if you use a private, outside unknown address on your local LAN +and want this to be replaced by the domain of the address of your email addrsss on the internet. +Note that this is different to \fBset_return_path_domain\fR, see below. + +.TP +\fBset_return_path_domain\fR = \fIstring\fR + +Sets the domain part of the envelope from address. +Some hosts check whether this is the same as the net the connection is coming from. +If not, they reject the mail because they suspect spamming. +It should be a valid address, because some mail servers also check that. +You can also use this to set it to your usual address on the internet +and put a local address only known on your LAN in the configuration of your mailer. +Only the domain part will be changed, the local part remains unchanged. +Use \fBmap_return_path_addresses\fR for rewriting local parts. + +.TP +\fBmap_h_from_addresses\fR = \fIlist\fR + +This is similar to \fBset_h_from_domain\fR, but more flexible. +Set this to a list which maps local parts to a full RFC 822 compliant email address, +the local parts (the keys) are separated from the addresses (the values) by colons (`:'). + +Example: + +map_h_from_addresses = "john: John Smith ; charlie: Charlie Miller " + +You can use patterns, eg. * as keys. + +.TP +\fBmap_h_reply_to_addresses\fR = \fIlist\fR + +Same as \fBmap_h_from_addresses\fR, but for the `Reply-To:' header. + +.TP +\fBmap_h_mail_followup_to_addresses\fR = \fIlist\fR + +Same as \fBmap_h_from_addresses\fR, but for the `Mail-Followup-To:' header. +Useful when replying to mailing lists. + +.TP +\fBmap_return_path_addresses\fR = \fIlist\fR + +This is similar to \fBset_return_path_domain\fR, but more flexible. +Set this to a list which maps local parts to a full RFC 821 compliant email address, +the local parts (the keys) are separated from the addresses (the values) by colons (`:'). +Note that this option takes RFC 821 addresses while \fBmap_h_from_addresses\fR takes RFC 822 addresses. +The most important difference is that RFC 821 addresses have no full name. + +Example: + +map_return_path_addresses = "john: ; charlie: " + +You can use patterns, eg. * as keys. + +.TP +\fBexpand_h_sender_address\fR = \fIboolean\fR + +This sets the domain of the sender address as given by the Sender: header +to the same address as in the envelope return path address +(which can be set by either \fBset_return_path_domain\fR or \fBmap_return_path_addresses\fR). +This is for mail clients (eg. Microsoft Outlook) which use this address as the sender address. +Though they should use the From: address, see RFC 821. +If \fBfetchmail(1)\fR encounters an unqualified Sender: address, +it will be expanded to the domain of the pop server, which is almost never correct. +Default is true. + +.TP +\fBexpand_h_sender_domain\fR = \fIboolean\fR + +Like \fBexpand_h_sender_address\fR, but sets the domain only. +Deprecated, will be removed in a later version. + +.TP +\fBlast_route\fR = \fIboolean\fR + +If this is set, a mail which would have been delivered using this route, +but has failed temporarily, will not be tried to be delivered using the next route. + +If you have set up a special route with filters using the lists `allowed_rcpt_domains', +`allowed_return_paths', and `allowed_mail_locals' or their complements (not_), +and the mail passing these rules should be delivered using this route only, +you should set this to `true'. +Otherwise the mail would be passed to the next route (if any), +unless that route has rules which prevent that. + +Default is false. + +.TP +\fBauth_name\fR = \fIstring\fR + +Set the authentication type for ESMTP AUTH authentication. +Currently only `cram-md5' and `login' are supported. + +.TP +\fBauth_login\fR = \fIstring\fR + +Your account name for ESMTP AUTH authentication. + +.TP +\fBauth_secret\fR = \fIstring\fR + +Your secret for ESMTP AUTH authentication. + +.TP +\fBpop3_login\fR = \fIfile\fR + +If your Mail server requires SMTP-after-POP, +set this to a get configuration (see \fBmasqmail.get(5)\fR). +If you login to the POP server before you send, this is not necessary. + +.TP +\fBwrapper\fR = \fIcommand\fR + +If set, instead of opening a connection to a remote server, +\fIcommand\fR will be called and all traffic will be piped to its stdin and from its stdout. +Purpose is to tunnel ip traffic, eg. for ssl. + +Example for ssl tunneling: + +wrapper="/usr/bin/openssl s_client \-quiet \-connect pop.gmx.net:995 2>/dev/null" + +.TP +\fBpipe\fR = \fIcommand\fR + +If set, and protocol is set to `pipe', +\fIcommand\fR will be called and the message will be piped to its stdin. +Purpose is to use gateways to uucp, fax, sms or whatever else. + +You can use variables to give as arguments to the command, +these are the same as for the mda in the main configuration, see \fBmasqmail.conf(5)\fR. + +.TP +\fBpipe_fromline = \fIboolean\fR + +If this is set, and protocol is set to `pipe', +a from line will be prepended to the output stream whenever a pipe command is called. +Default is false. + +.TP +\fBpipe_fromhack = \fIboolean\fR + +If this is set, and protocol is set to `pipe', +each line beginning with `From ' is replaced with `>From ' whenever a pipe command is called. +You probably want this if you have set \fBpipe_fromline\fR above. +Default is false. + + +.SH AUTHOR + +Masqmail was written by Oliver Kurth. +It is now maintained by Markus Schnalke . + +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. +There is also a mailing list, you will find information about it at masqmail's main site. + + +.SH BUGS + +Please report bugs to the mailing list. + +.SH SEE ALSO + +\fBmasqmail(8)\fR, \fBmasqmail.conf(5)\fR, \fBmasqmail.get(5)\fR diff -r f6a6f55b7b9e -r ed34413652fc man/mservdetect.8 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/man/mservdetect.8 Sat May 29 22:07:07 2010 +0200 @@ -0,0 +1,49 @@ +.TH mservdetect 8 2010-05-07 masqmail-0.2.22 "Maintenance Commands" + +.SH NAME +mservdetect \- Helper for masqmail and masqdialer + + +.SH SYNOPSIS +\fB/usr/bin/masqmail \fIhost port\fR + + +.SH DESCRIPTION + +Mservdetect is a small helper application for masqmail to detect its online status +if the modem server masqdialer is used. +It connects to the\fIhost\fR at \fIport\fR and prints the connection name to stdout. + +If you want to use it, set \fBonline_detect\fR=\fIpipe\fR and +\fBonline_pipe\fR=\fI"/usr/bin/mservdetect host port"\fR. + +.SH OPTIONS + +.TP +\fBhost\fR + +The hostname where the masqdialer server is running. + +.TP +\fBport\fR + +The port number where the masqdialer server is listening. + + +.SH AUTHOR + +Masqmail was written by Oliver Kurth. +It is now maintained by Markus Schnalke . + +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR. +There is also a mailing list, you will find information about it at masqmail's main site. + + +.SH BUGS + +Please report bugs to the mailing list. + + +.SH SEE ALSO + +\fBmasqmail.conf(5)\fR