# HG changeset patch # User meillo@marmaro.de # Date 1222458010 -7200 # Node ID 8c55886cacd8d8a3a5034d4efefdf37107cf461d # Parent 653aef34b225ed20edb7ce3c1a121dd456730b29 man pages will be maintained in troff now diff -r 653aef34b225 -r 8c55886cacd8 Makefile.am --- a/Makefile.am Fri Sep 26 21:26:36 2008 +0200 +++ b/Makefile.am Fri Sep 26 21:40:10 2008 +0200 @@ -1,6 +1,6 @@ EXTRA_DIST = \ examples/example.get examples/example.route examples/masqmail.conf \ -docs/README docs/man/m*.[0-9] \ +docs/README docs/m*.[0-9] \ suse/masqmail suse/masqmail.spec suse/masqmail.spec.in \ redhat/masqmail redhat/masqmail.spec redhat/masqmail.spec.in \ tpl/failmsg.tpl tpl/failmsg.tpl.de tpl/failmsg.tpl.fr tpl/failmsg.tpl.it \ diff -r 653aef34b225 -r 8c55886cacd8 Makefile.in --- a/Makefile.in Fri Sep 26 21:26:36 2008 +0200 +++ b/Makefile.in Fri Sep 26 21:40:10 2008 +0200 @@ -128,7 +128,7 @@ with_user = @with_user@ EXTRA_DIST = \ examples/example.get examples/example.route examples/masqmail.conf \ -docs/README docs/man/m*.[0-9] \ +docs/README docs/m*.[0-9] \ suse/masqmail suse/masqmail.spec suse/masqmail.spec.in \ redhat/masqmail redhat/masqmail.spec redhat/masqmail.spec.in \ tpl/failmsg.tpl tpl/failmsg.tpl.de tpl/failmsg.tpl.fr tpl/failmsg.tpl.it \ @@ -337,7 +337,7 @@ distdir: $(DISTFILES) $(am__remove_distdir) mkdir $(distdir) - $(mkinstalldirs) $(distdir)/docs $(distdir)/docs/man $(distdir)/examples $(distdir)/redhat $(distdir)/suse $(distdir)/tpl + $(mkinstalldirs) $(distdir)/docs $(distdir)/examples $(distdir)/redhat $(distdir)/suse $(distdir)/tpl @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ list='$(DISTFILES)'; for file in $$list; do \ diff -r 653aef34b225 -r 8c55886cacd8 config.status.lineno --- a/config.status.lineno Fri Sep 26 21:26:36 2008 +0200 +++ b/config.status.lineno Fri Sep 26 21:40:10 2008 +0200 @@ -301,7 +301,7 @@ " # Files that config.status was made for. -config_files=" Makefile debian/Makefile docs/Makefile docs/man/Makefile docs/xml/Makefile tests/Makefile src/Makefile src/base64/Makefile src/md5/Makefile src/libident/Makefile suse/masqmail.spec redhat/masqmail.spec" +config_files=" Makefile debian/Makefile tests/Makefile src/Makefile src/base64/Makefile src/md5/Makefile src/libident/Makefile suse/masqmail.spec redhat/masqmail.spec" config_headers=" config.h" config_commands=" depfiles" @@ -438,9 +438,6 @@ "depfiles") CONFIG_COMMANDS="$CONFIG_COMMANDS depfiles" ;; "Makefile") CONFIG_FILES="$CONFIG_FILES Makefile" ;; "debian/Makefile") CONFIG_FILES="$CONFIG_FILES debian/Makefile" ;; - "docs/Makefile") CONFIG_FILES="$CONFIG_FILES docs/Makefile" ;; - "docs/man/Makefile") CONFIG_FILES="$CONFIG_FILES docs/man/Makefile" ;; - "docs/xml/Makefile") CONFIG_FILES="$CONFIG_FILES docs/xml/Makefile" ;; "tests/Makefile") CONFIG_FILES="$CONFIG_FILES tests/Makefile" ;; "src/Makefile") CONFIG_FILES="$CONFIG_FILES src/Makefile" ;; "src/base64/Makefile") CONFIG_FILES="$CONFIG_FILES src/base64/Makefile" ;; diff -r 653aef34b225 -r 8c55886cacd8 configure --- a/configure Fri Sep 26 21:26:36 2008 +0200 +++ b/configure Fri Sep 26 21:40:10 2008 +0200 @@ -6494,7 +6494,7 @@ fi fi -ac_config_files="$ac_config_files Makefile debian/Makefile docs/Makefile docs/man/Makefile docs/xml/Makefile tests/Makefile src/Makefile src/base64/Makefile src/md5/Makefile src/libident/Makefile suse/masqmail.spec redhat/masqmail.spec" +ac_config_files="$ac_config_files Makefile debian/Makefile tests/Makefile src/Makefile src/base64/Makefile src/md5/Makefile src/libident/Makefile suse/masqmail.spec redhat/masqmail.spec" cat >confcache <<\_ACEOF # This file is a shell script that caches the results of configure @@ -7076,9 +7076,6 @@ "depfiles") CONFIG_COMMANDS="$CONFIG_COMMANDS depfiles" ;; "Makefile") CONFIG_FILES="$CONFIG_FILES Makefile" ;; "debian/Makefile") CONFIG_FILES="$CONFIG_FILES debian/Makefile" ;; - "docs/Makefile") CONFIG_FILES="$CONFIG_FILES docs/Makefile" ;; - "docs/man/Makefile") CONFIG_FILES="$CONFIG_FILES docs/man/Makefile" ;; - "docs/xml/Makefile") CONFIG_FILES="$CONFIG_FILES docs/xml/Makefile" ;; "tests/Makefile") CONFIG_FILES="$CONFIG_FILES tests/Makefile" ;; "src/Makefile") CONFIG_FILES="$CONFIG_FILES src/Makefile" ;; "src/base64/Makefile") CONFIG_FILES="$CONFIG_FILES src/base64/Makefile" ;; diff -r 653aef34b225 -r 8c55886cacd8 configure.ac --- a/configure.ac Fri Sep 26 21:26:36 2008 +0200 +++ b/configure.ac Fri Sep 26 21:40:10 2008 +0200 @@ -289,9 +289,6 @@ AC_OUTPUT(Makefile \ debian/Makefile \ - docs/Makefile \ - docs/man/Makefile \ - docs/xml/Makefile \ tests/Makefile \ src/Makefile \ src/base64/Makefile \ diff -r 653aef34b225 -r 8c55886cacd8 docs/Makefile.am --- a/docs/Makefile.am Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,46 +0,0 @@ -SUBDIRS=man xml - -man: man/masqmail.8 man/mservdetect.8 man/masqmail.conf.5 man/masqmail.route.5 man/masqmail.get.5 man/masqmail.aliases.5 - -html: html/masqmail.8.html html/mservdetect.8.html html/masqmail.conf.5.html html/masqmail.route.5.html html/masqmail.get.5.html html/masqmail.aliases.5.html - -man/masqmail.8: xml/masqmail.8.xml - xmltoman $< >$@ - -man/mservdetect.8: xml/mservdetect.8.xml - xmltoman $< >$@ - -man/masqmail.conf.5: xml/masqmail.conf.5.xml - xmltoman $< >$@ - -man/masqmail.route.5: xml/masqmail.route.5.xml - xmltoman $< >$@ - -man/masqmail.get.5: xml/masqmail.get.5.xml - xmltoman $< >$@ - -man/masqmail.aliases.5: xml/masqmail.aliases.5.xml - xmltoman $< >$@ - - -html/masqmail.8.html: xml/masqmail.8.xml - xmlmantohtml $< >$@ - -html/mservdetect.8.html: xml/mservdetect.8.xml - xmlmantohtml $< >$@ - -html/masqmail.conf.5.html: xml/masqmail.conf.5.xml - xmlmantohtml $< >$@ - -html/masqmail.route.5.html: xml/masqmail.route.5.xml - xmlmantohtml $< >$@ - -html/masqmail.get.5.html: xml/masqmail.get.5.xml - xmlmantohtml $< >$@ - -html/masqmail.aliases.5.html: xml/masqmail.aliases.5.xml - xmlmantohtml $< >$@ - -#clean: -# rm -f man/*.[58] -# rm -r html/*.html diff -r 653aef34b225 -r 8c55886cacd8 docs/Makefile.in --- a/docs/Makefile.in Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,459 +0,0 @@ -# Makefile.in generated by automake 1.7.9 from Makefile.am. -# @configure_input@ - -# Copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003 -# 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@ - -srcdir = @srcdir@ -top_srcdir = @top_srcdir@ -VPATH = @srcdir@ -pkgdatadir = $(datadir)/@PACKAGE@ -pkglibdir = $(libdir)/@PACKAGE@ -pkgincludedir = $(includedir)/@PACKAGE@ -top_builddir = .. - -am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd -INSTALL = @INSTALL@ -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 = : -ACLOCAL = @ACLOCAL@ -AMDEP_FALSE = @AMDEP_FALSE@ -AMDEP_TRUE = @AMDEP_TRUE@ -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_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@ -OBJEXT = @OBJEXT@ -PACKAGE = @PACKAGE@ -PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ -PACKAGE_NAME = @PACKAGE_NAME@ -PACKAGE_STRING = @PACKAGE_STRING@ -PACKAGE_TARNAME = @PACKAGE_TARNAME@ -PACKAGE_VERSION = @PACKAGE_VERSION@ -PATH_SEPARATOR = @PATH_SEPARATOR@ -PKG_CONFIG = @PKG_CONFIG@ -RANLIB = @RANLIB@ -RESOLV_LIBS = @RESOLV_LIBS@ -SET_MAKE = @SET_MAKE@ -SHELL = @SHELL@ -STRIP = @STRIP@ -USE_LIBLOCKFILE = @USE_LIBLOCKFILE@ -VERSION = @VERSION@ -ac_ct_CC = @ac_ct_CC@ -am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ -am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ -am__include = @am__include@ -am__leading_dot = @am__leading_dot@ -am__quote = @am__quote@ -bindir = @bindir@ -build_alias = @build_alias@ -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@ -oldincludedir = @oldincludedir@ -pdfdir = @pdfdir@ -prefix = @prefix@ -program_transform_name = @program_transform_name@ -psdir = @psdir@ -sbindir = @sbindir@ -sharedstatedir = @sharedstatedir@ -sysconfdir = @sysconfdir@ -target_alias = @target_alias@ -with_confdir = @with_confdir@ -with_group = @with_group@ -with_logdir = @with_logdir@ -with_spooldir = @with_spooldir@ -with_user = @with_user@ -SUBDIRS = man xml -subdir = docs -ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs -CONFIG_HEADER = $(top_builddir)/config.h -CONFIG_CLEAN_FILES = -DIST_SOURCES = - -RECURSIVE_TARGETS = info-recursive dvi-recursive pdf-recursive \ - ps-recursive install-info-recursive uninstall-info-recursive \ - all-recursive install-data-recursive install-exec-recursive \ - installdirs-recursive install-recursive uninstall-recursive \ - check-recursive installcheck-recursive -DIST_COMMON = README $(srcdir)/Makefile.in Makefile.am -DIST_SUBDIRS = $(SUBDIRS) -all: all-recursive - -.SUFFIXES: -$(srcdir)/Makefile.in: Makefile.am $(top_srcdir)/configure.ac $(ACLOCAL_M4) - cd $(top_srcdir) && \ - $(AUTOMAKE) --gnu docs/Makefile -Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status - cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe) -uninstall-info-am: - -# This directory's subdirectories are mostly independent; you can cd -# into them and run `make' without going through this Makefile. -# To change the values of `make' variables: instead of editing Makefiles, -# (1) if the variable is set in `config.status', edit `config.status' -# (which will cause the Makefiles to be regenerated when you run `make'); -# (2) otherwise, pass the desired values on the `make' command line. -$(RECURSIVE_TARGETS): - @set fnord $$MAKEFLAGS; amf=$$2; \ - dot_seen=no; \ - target=`echo $@ | sed s/-recursive//`; \ - list='$(SUBDIRS)'; for subdir in $$list; do \ - echo "Making $$target in $$subdir"; \ - if test "$$subdir" = "."; then \ - dot_seen=yes; \ - local_target="$$target-am"; \ - else \ - local_target="$$target"; \ - fi; \ - (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ - || case "$$amf" in *=*) exit 1;; *k*) fail=yes;; *) exit 1;; esac; \ - done; \ - if test "$$dot_seen" = "no"; then \ - $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \ - fi; test -z "$$fail" - -mostlyclean-recursive clean-recursive distclean-recursive \ -maintainer-clean-recursive: - @set fnord $$MAKEFLAGS; amf=$$2; \ - dot_seen=no; \ - case "$@" in \ - distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \ - *) list='$(SUBDIRS)' ;; \ - esac; \ - rev=''; for subdir in $$list; do \ - if test "$$subdir" = "."; then :; else \ - rev="$$subdir $$rev"; \ - fi; \ - done; \ - rev="$$rev ."; \ - target=`echo $@ | sed s/-recursive//`; \ - for subdir in $$rev; do \ - echo "Making $$target in $$subdir"; \ - if test "$$subdir" = "."; then \ - local_target="$$target-am"; \ - else \ - local_target="$$target"; \ - fi; \ - (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \ - || case "$$amf" in *=*) exit 1;; *k*) fail=yes;; *) exit 1;; esac; \ - done && test -z "$$fail" -tags-recursive: - list='$(SUBDIRS)'; for subdir in $$list; do \ - test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \ - done -ctags-recursive: - list='$(SUBDIRS)'; for subdir in $$list; do \ - test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \ - done - -ETAGS = etags -ETAGSFLAGS = - -CTAGS = ctags -CTAGSFLAGS = - -tags: TAGS - -ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES) - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) ' { files[$$0] = 1; } \ - END { for (i in files) print i; }'`; \ - mkid -fID $$unique - -TAGS: tags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ - $(TAGS_FILES) $(LISP) - tags=; \ - here=`pwd`; \ - if (etags --etags-include --version) >/dev/null 2>&1; then \ - include_option=--etags-include; \ - else \ - include_option=--include; \ - fi; \ - list='$(SUBDIRS)'; for subdir in $$list; do \ - if test "$$subdir" = .; then :; else \ - test -f $$subdir/TAGS && \ - tags="$$tags $$include_option=$$here/$$subdir/TAGS"; \ - fi; \ - done; \ - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) ' { files[$$0] = 1; } \ - END { for (i in files) print i; }'`; \ - test -z "$(ETAGS_ARGS)$$tags$$unique" \ - || $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \ - $$tags $$unique - -ctags: CTAGS -CTAGS: ctags-recursive $(HEADERS) $(SOURCES) $(TAGS_DEPENDENCIES) \ - $(TAGS_FILES) $(LISP) - tags=; \ - here=`pwd`; \ - list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \ - unique=`for i in $$list; do \ - if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \ - done | \ - $(AWK) ' { files[$$0] = 1; } \ - END { for (i in files) print i; }'`; \ - test -z "$(CTAGS_ARGS)$$tags$$unique" \ - || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \ - $$tags $$unique - -GTAGS: - here=`$(am__cd) $(top_builddir) && pwd` \ - && cd $(top_srcdir) \ - && gtags -i $(GTAGS_ARGS) $$here - -distclean-tags: - -rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) - -top_distdir = .. -distdir = $(top_distdir)/$(PACKAGE)-$(VERSION) - -distdir: $(DISTFILES) - @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ - topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ - list='$(DISTFILES)'; for file in $$list; do \ - case $$file in \ - $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ - $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ - esac; \ - if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ - dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ - if test "$$dir" != "$$file" && test "$$dir" != "."; then \ - dir="/$$dir"; \ - $(mkinstalldirs) "$(distdir)$$dir"; \ - else \ - dir=''; \ - fi; \ - if test -d $$d/$$file; then \ - if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ - cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ - fi; \ - cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ - else \ - test -f $(distdir)/$$file \ - || cp -p $$d/$$file $(distdir)/$$file \ - || exit 1; \ - fi; \ - done - list='$(SUBDIRS)'; for subdir in $$list; do \ - if test "$$subdir" = .; then :; else \ - test -d $(distdir)/$$subdir \ - || mkdir $(distdir)/$$subdir \ - || exit 1; \ - (cd $$subdir && \ - $(MAKE) $(AM_MAKEFLAGS) \ - top_distdir="$(top_distdir)" \ - distdir=../$(distdir)/$$subdir \ - distdir) \ - || exit 1; \ - fi; \ - done -check-am: all-am -check: check-recursive -all-am: Makefile -installdirs: installdirs-recursive -installdirs-am: - -install: install-recursive -install-exec: install-exec-recursive -install-data: install-data-recursive -uninstall: uninstall-recursive - -install-am: all-am - @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am - -installcheck: installcheck-recursive -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: - -rm -f $(CONFIG_CLEAN_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-recursive - -clean-am: clean-generic mostlyclean-am - -distclean: distclean-recursive - -rm -f Makefile -distclean-am: clean-am distclean-generic distclean-tags - -dvi: dvi-recursive - -dvi-am: - -info: info-recursive - -info-am: - -install-data-am: - -install-exec-am: - -install-info: install-info-recursive - -install-man: - -installcheck-am: - -maintainer-clean: maintainer-clean-recursive - -rm -f Makefile -maintainer-clean-am: distclean-am maintainer-clean-generic - -mostlyclean: mostlyclean-recursive - -mostlyclean-am: mostlyclean-generic - -pdf: pdf-recursive - -pdf-am: - -ps: ps-recursive - -ps-am: - -uninstall-am: uninstall-info-am - -uninstall-info: uninstall-info-recursive - -.PHONY: $(RECURSIVE_TARGETS) CTAGS GTAGS all all-am check check-am clean \ - clean-generic clean-recursive ctags ctags-recursive distclean \ - distclean-generic distclean-recursive distclean-tags distdir \ - dvi dvi-am dvi-recursive info info-am info-recursive install \ - install-am install-data install-data-am install-data-recursive \ - install-exec install-exec-am install-exec-recursive \ - install-info install-info-am install-info-recursive install-man \ - install-recursive install-strip installcheck installcheck-am \ - installdirs installdirs-am installdirs-recursive \ - maintainer-clean maintainer-clean-generic \ - maintainer-clean-recursive mostlyclean mostlyclean-generic \ - mostlyclean-recursive pdf pdf-am pdf-recursive ps ps-am \ - ps-recursive tags tags-recursive uninstall uninstall-am \ - uninstall-info-am uninstall-info-recursive uninstall-recursive - - -man: man/masqmail.8 man/mservdetect.8 man/masqmail.conf.5 man/masqmail.route.5 man/masqmail.get.5 man/masqmail.aliases.5 - -html: html/masqmail.8.html html/mservdetect.8.html html/masqmail.conf.5.html html/masqmail.route.5.html html/masqmail.get.5.html html/masqmail.aliases.5.html - -man/masqmail.8: xml/masqmail.8.xml - xmltoman $< >$@ - -man/mservdetect.8: xml/mservdetect.8.xml - xmltoman $< >$@ - -man/masqmail.conf.5: xml/masqmail.conf.5.xml - xmltoman $< >$@ - -man/masqmail.route.5: xml/masqmail.route.5.xml - xmltoman $< >$@ - -man/masqmail.get.5: xml/masqmail.get.5.xml - xmltoman $< >$@ - -man/masqmail.aliases.5: xml/masqmail.aliases.5.xml - xmltoman $< >$@ - -html/masqmail.8.html: xml/masqmail.8.xml - xmlmantohtml $< >$@ - -html/mservdetect.8.html: xml/mservdetect.8.xml - xmlmantohtml $< >$@ - -html/masqmail.conf.5.html: xml/masqmail.conf.5.xml - xmlmantohtml $< >$@ - -html/masqmail.route.5.html: xml/masqmail.route.5.xml - xmlmantohtml $< >$@ - -html/masqmail.get.5.html: xml/masqmail.get.5.xml - xmlmantohtml $< >$@ - -html/masqmail.aliases.5.html: xml/masqmail.aliases.5.xml - xmlmantohtml $< >$@ - -#clean: -# rm -f man/*.[58] -# rm -r html/*.html -# 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 653aef34b225 -r 8c55886cacd8 docs/README --- a/docs/README Fri Sep 26 21:26:36 2008 +0200 +++ b/docs/README Fri Sep 26 21:40:10 2008 +0200 @@ -1,11 +1,2 @@ -Since version 0.1.1 the documentation within the masqmail package is -in man pages. The source is in in xml, the xml sources can be -converted to man pages or html pages with the perl scripts xml2man and -xmlman2html. - -The xml sources are availabe in another package. - -The perl scripts will be available at http://masqmail.cx/xml2man/ - -If you want to conribute to the documentation, please use the xml -sources, changes in html or man pages will be lost. +Since masqmail-0.3, documentation is maintained in troff (man page) format. +The old XML sources are no longer used. diff -r 653aef34b225 -r 8c55886cacd8 docs/man/Makefile.am --- a/docs/man/Makefile.am Fri Sep 26 21:26:36 2008 +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 \ No newline at end of file diff -r 653aef34b225 -r 8c55886cacd8 docs/man/Makefile.in --- a/docs/man/Makefile.in Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,369 +0,0 @@ -# Makefile.in generated by automake 1.7.9 from Makefile.am. -# @configure_input@ - -# Copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003 -# 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@ - -srcdir = @srcdir@ -top_srcdir = @top_srcdir@ -VPATH = @srcdir@ -pkgdatadir = $(datadir)/@PACKAGE@ -pkglibdir = $(libdir)/@PACKAGE@ -pkgincludedir = $(includedir)/@PACKAGE@ -top_builddir = ../.. - -am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd -INSTALL = @INSTALL@ -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 = : -ACLOCAL = @ACLOCAL@ -AMDEP_FALSE = @AMDEP_FALSE@ -AMDEP_TRUE = @AMDEP_TRUE@ -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_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@ -OBJEXT = @OBJEXT@ -PACKAGE = @PACKAGE@ -PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ -PACKAGE_NAME = @PACKAGE_NAME@ -PACKAGE_STRING = @PACKAGE_STRING@ -PACKAGE_TARNAME = @PACKAGE_TARNAME@ -PACKAGE_VERSION = @PACKAGE_VERSION@ -PATH_SEPARATOR = @PATH_SEPARATOR@ -PKG_CONFIG = @PKG_CONFIG@ -RANLIB = @RANLIB@ -RESOLV_LIBS = @RESOLV_LIBS@ -SET_MAKE = @SET_MAKE@ -SHELL = @SHELL@ -STRIP = @STRIP@ -USE_LIBLOCKFILE = @USE_LIBLOCKFILE@ -VERSION = @VERSION@ -ac_ct_CC = @ac_ct_CC@ -am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ -am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ -am__include = @am__include@ -am__leading_dot = @am__leading_dot@ -am__quote = @am__quote@ -bindir = @bindir@ -build_alias = @build_alias@ -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@ -oldincludedir = @oldincludedir@ -pdfdir = @pdfdir@ -prefix = @prefix@ -program_transform_name = @program_transform_name@ -psdir = @psdir@ -sbindir = @sbindir@ -sharedstatedir = @sharedstatedir@ -sysconfdir = @sysconfdir@ -target_alias = @target_alias@ -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 -subdir = docs/man -ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs -CONFIG_HEADER = $(top_builddir)/config.h -CONFIG_CLEAN_FILES = -DIST_SOURCES = - -NROFF = nroff -MANS = $(man_MANS) -DIST_COMMON = $(srcdir)/Makefile.in Makefile.am -all: all-am - -.SUFFIXES: -$(srcdir)/Makefile.in: Makefile.am $(top_srcdir)/configure.ac $(ACLOCAL_M4) - cd $(top_srcdir) && \ - $(AUTOMAKE) --gnu docs/man/Makefile -Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status - cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe) -uninstall-info-am: - -man5dir = $(mandir)/man5 -install-man5: $(man5_MANS) $(man_MANS) - @$(NORMAL_INSTALL) - $(mkinstalldirs) $(DESTDIR)$(man5dir) - @list='$(man5_MANS) $(dist_man5_MANS) $(nodist_man5_MANS)'; \ - l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ - for i in $$l2; do \ - case "$$i" in \ - *.5*) list="$$list $$i" ;; \ - esac; \ - done; \ - for i in $$list; do \ - if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \ - else file=$$i; fi; \ - ext=`echo $$i | sed -e 's/^.*\\.//'`; \ - case "$$ext" in \ - 5*) ;; \ - *) ext='5' ;; \ - esac; \ - inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ - inst=`echo $$inst | sed -e 's/^.*\///'`; \ - inst=`echo $$inst | sed '$(transform)'`.$$ext; \ - echo " $(INSTALL_DATA) $$file $(DESTDIR)$(man5dir)/$$inst"; \ - $(INSTALL_DATA) $$file $(DESTDIR)$(man5dir)/$$inst; \ - done -uninstall-man5: - @$(NORMAL_UNINSTALL) - @list='$(man5_MANS) $(dist_man5_MANS) $(nodist_man5_MANS)'; \ - l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ - for i in $$l2; do \ - case "$$i" in \ - *.5*) list="$$list $$i" ;; \ - esac; \ - done; \ - for i in $$list; do \ - ext=`echo $$i | sed -e 's/^.*\\.//'`; \ - case "$$ext" in \ - 5*) ;; \ - *) ext='5' ;; \ - esac; \ - inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ - inst=`echo $$inst | sed -e 's/^.*\///'`; \ - inst=`echo $$inst | sed '$(transform)'`.$$ext; \ - echo " rm -f $(DESTDIR)$(man5dir)/$$inst"; \ - rm -f $(DESTDIR)$(man5dir)/$$inst; \ - done - -man8dir = $(mandir)/man8 -install-man8: $(man8_MANS) $(man_MANS) - @$(NORMAL_INSTALL) - $(mkinstalldirs) $(DESTDIR)$(man8dir) - @list='$(man8_MANS) $(dist_man8_MANS) $(nodist_man8_MANS)'; \ - l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ - for i in $$l2; do \ - case "$$i" in \ - *.8*) list="$$list $$i" ;; \ - esac; \ - done; \ - for i in $$list; do \ - if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \ - else file=$$i; fi; \ - ext=`echo $$i | sed -e 's/^.*\\.//'`; \ - case "$$ext" in \ - 8*) ;; \ - *) ext='8' ;; \ - esac; \ - inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ - inst=`echo $$inst | sed -e 's/^.*\///'`; \ - inst=`echo $$inst | sed '$(transform)'`.$$ext; \ - echo " $(INSTALL_DATA) $$file $(DESTDIR)$(man8dir)/$$inst"; \ - $(INSTALL_DATA) $$file $(DESTDIR)$(man8dir)/$$inst; \ - done -uninstall-man8: - @$(NORMAL_UNINSTALL) - @list='$(man8_MANS) $(dist_man8_MANS) $(nodist_man8_MANS)'; \ - l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \ - for i in $$l2; do \ - case "$$i" in \ - *.8*) list="$$list $$i" ;; \ - esac; \ - done; \ - for i in $$list; do \ - ext=`echo $$i | sed -e 's/^.*\\.//'`; \ - case "$$ext" in \ - 8*) ;; \ - *) ext='8' ;; \ - esac; \ - inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \ - inst=`echo $$inst | sed -e 's/^.*\///'`; \ - inst=`echo $$inst | sed '$(transform)'`.$$ext; \ - echo " rm -f $(DESTDIR)$(man8dir)/$$inst"; \ - rm -f $(DESTDIR)$(man8dir)/$$inst; \ - done -tags: TAGS -TAGS: - -ctags: CTAGS -CTAGS: - -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) - -top_distdir = ../.. -distdir = $(top_distdir)/$(PACKAGE)-$(VERSION) - -distdir: $(DISTFILES) - @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ - topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ - list='$(DISTFILES)'; for file in $$list; do \ - case $$file in \ - $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ - $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ - esac; \ - if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ - dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ - if test "$$dir" != "$$file" && test "$$dir" != "."; then \ - dir="/$$dir"; \ - $(mkinstalldirs) "$(distdir)$$dir"; \ - else \ - dir=''; \ - fi; \ - if test -d $$d/$$file; then \ - if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ - cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ - fi; \ - cp -pR $$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: - $(mkinstalldirs) $(DESTDIR)$(man5dir) $(DESTDIR)$(man8dir) -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: - -rm -f $(CONFIG_CLEAN_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: - -info: info-am - -info-am: - -install-data-am: install-man - -install-exec-am: - -install-info: install-info-am - -install-man: install-man5 install-man8 - -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-info-am uninstall-man - -uninstall-man: uninstall-man5 uninstall-man8 - -.PHONY: all all-am check check-am clean clean-generic distclean \ - distclean-generic distdir dvi dvi-am info info-am install \ - install-am install-data install-data-am install-exec \ - install-exec-am install-info install-info-am install-man \ - install-man5 install-man8 install-strip installcheck \ - installcheck-am installdirs maintainer-clean \ - maintainer-clean-generic mostlyclean mostlyclean-generic pdf \ - pdf-am ps ps-am uninstall uninstall-am uninstall-info-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 653aef34b225 -r 8c55886cacd8 docs/man/masqmail.8 --- a/docs/man/masqmail.8 Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,213 +0,0 @@ -.TH masqmail 8 User Manuals -.SH NAME -masqmail \- An offline Mail Transfer Agent -.SH SYNOPSIS -\fB/usr/sbin/masqmail [-C \fIfile\f1\fB] [-odq] [-bd] [-q\fIinterval\f1\fB] - -\fB/usr/sbin/masqmail [-odq] [-bs] - -\fB/usr/sbin/masqmail [-bp] - -\fB/usr/sbin/masqmail [-q] - -\fB/usr/sbin/masqmail [-qo [\fIname\f1\fB]] - -\fB/usr/sbin/masqmail [-odq] [-g [\fIname\f1\fB]] - -\fB/usr/sbin/masqmail [-odq] [-go [\fIname\f1\fB]] - -\fB/usr/sbin/masqmail [-t] [-oi] [-f \fIaddress\f1\fB] [--] \fIaddress...\f1\fB - -\fB/usr/sbin/mailq - -\fB -.SH DESCRIPTION - -MasqMail is a mail server designed for hosts that do not have a permanent internet connection eg. 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 (-qo \fIconnection\f1 and -g) -.TP - -\fB--\f1 - -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\f1 - -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 -q option (see below). -.TP - -\fB-bi\f1 - -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\f1 - -Show the messages in the queue. Same as calling masqmail as 'mailq'. -.TP - -\fB-bs\f1 - -Accept SMTP commands from stdin. Some mailers (eg pine) use this option as an interface. It can also be used to call masqmail from inetd. -.TP - -\fB-B \fIarg\f1\fB\f1 - -\fIarg\f1 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 \f1 - -Show version information. -.TP - -\fB-C \f1\fIfilename\f1 - -Use another configuration than \fI/etc/masqmail/masqmail.conf\f1. Useful for debugging purposes. If not invoked by a privileged user, masqmail will drop all privileges. -.TP - -\fB-d \fInumber\f1\fB\f1 - -Set the debug level. This takes precedence before the value ofdebug_level in the configuration file. Read the warning in the description of the latter. -.TP - -\fB-f [\fIaddress\f1\fB]\f1 - -Set the return path address to \fIaddress\f1. Only root, the user mail and anyoune in group trusted is allowed to do that. -.TP - -\fB-F [\fIstring\f1\fB]\f1 - -Set the full sender name (in the From: header) to \fIstring\f1. -.TP - -\fB-g [\fIname\f1\fB]\f1 - -Get mail (using pop3 or apop), using the configurations given with get.\fIname\f1 in the main configuration. Without \fIname\f1, all get configurations will be used. See also \fBmasqmail.get (5)\f1 -.TP - -\fB-go [\fIinterval\f1\fB] [\fIname\f1\fB]\f1 - -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\f1 is defined in the configuration (see \fBonline_gets.\fIname\f1\fB\f1). - -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 all five minutes. - -If called without \fIname\f1 the online status is determined with the configured method (see \fBonline_detect\f1 in config.html). -.TP - -\fB-i\f1 - -Same as -oi, see below. -.TP - -\fB-Mrm \fIlist\f1\fB\f1 - -Remove given messages from the queue. Only allowed for privileged users. -.TP - -\fB-oem\f1 - -If the -oi ist not also given, always return with a non zero return code. Maybe someone tells me what this is good for... -.TP - -\fB-odb\f1 - -Deliver in background. Masqmail always does this, which makes this option pretty much useless. -.TP - -\fB-odq\f1 - -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\f1 - -A dot as a single character in a line does not terminate the message. -.TP - -\fB-q [\fIinterval\f1\fB]\f1 - -If not given with an argument, run a queue process, ie. 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 -qo 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 -bd -q30m. - -An argument may be a time interval ie. 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: -q30m. 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 -bd (see above). -.TP - -\fB-qo [\fIname\f1\fB]\f1 - -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\f1 is defined in the configuration (see \fBonline_routes.\fIname\f1\fB\f1). - -If called without \fIname\f1 the online status is determined with the configured method (see \fBonline_detect\f1 in config.html) -.TP - -\fB-t\f1 - -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\f1 - -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 - the return path. - -SENDER_DOMAIN - the domain part of the return path. - -SENDER_LOCAL - the local part of the return path. - -RECEIVED_HOST - the host the message was received from (unless local). - -LOCAL_PART, USER, LOGNAME - the local part of the (original) recipient. - -MESSAGE_ID - the unique message id. This is not necessarily identical with the Message ID as given in the Message ID: header. - -QUALIFY_DOMAIN - the domain which will be appended to unqualified addresses. - -.SH FILES - -\fI/etc/masqmail/masqmail.conf\f1 is the main configuration for masqmail. Depending on the settings in this file, you will also have other configuration files in \fI/etc/masqmail/\f1. - -\fI/etc/aliases\f1 is the alias file, if not set differently in \fI/etc/masqmail/masqmail.conf\f1. - -\fI/var/spool/masqmail/\f1 is the spool directory where masqmail stores its spooled messages and the uniq pop ids. - -\fI/var/spool/mail/\f1 is the directory where locally delivered mail will be put, if not configured differently in \fImasqmail.conf\f1. - -\fI/var/log/masqmail/\f1 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 - -You will find the newest version of masqmail at \fBhttp://masqmail.cx/masqmail/\f1 or search for it in freshmeat (\fBhttp://www.freshmeat.net\f1). There is also a mailing list, you will find information about it at masqmails main site. - -.SH BUGS - -You should report them to the mailing list. - -.SH SEE ALSO - -\fBmasqmail.conf (5)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.get (5)\f1, \fBmasqmail.aliases (5)\f1 - -.SH COMMENTS - -This man page was written using \fBxml2man (1)\f1 by the same author. - diff -r 653aef34b225 -r 8c55886cacd8 docs/man/masqmail.aliases.5 --- a/docs/man/masqmail.aliases.5 Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,41 +0,0 @@ -.TH masqmail.aliases 5 User Manuals -.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\f1. - -.SH FILE FORMAT - -The alias file consists of lines of the form: -local_part: item1, item2, ... -Items can be surrounded by quotes '"'. If within the quotes other quotes are needed for an address they can be escaped with a leading backslash '\'. - -A leading '\' 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 - -You will find the newest version of masqmail at \fBhttp://masqmail.cx/masqmail/\f1 or search for it in freshmeat (\fBhttp://www.freshmeat.net\f1). There is also a mailing list, you will find information about it at masqmails main site. - -.SH BUGS - -You should report them to the mailing list. - -.SH SEE ALSO - -\fBmasqmail.conf (5)\f1, \fBmasqmail (8)\f1, - -.SH COMMENTS - -This man page was written using \fBxml2man (1)\f1 by the same author. - diff -r 653aef34b225 -r 8c55886cacd8 docs/man/masqmail.conf.5 --- a/docs/man/masqmail.conf.5 Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,345 +0,0 @@ -.TH masqmail.conf 5 User Manuals -.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\f1 - -The configuration consists of lines of the form - -\fBval\f1 = \fIexpression\f1 - -Where \fBval\f1 is a variable name and \fIexpression\f1 a string, which can be quoted with '"'. 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 ';'. For some values patterns (like '*','?') can be used. The spaces before and after the '=' are optional. - -Most lists (exceptions: \fBlocal_hosts\f1,\fBlocal_nets\f1, \fBlisten_addresses\f1, \fBonline_routes\f1 and \fBonline_gets\f1) 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 '#' are ignored. - -.SH OPTIONS -.TP - -\fBrun_as_user = \fIboolean\f1\fB\f1 - -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\f1\fB\f1 - -If this is set, masqmail uses syslogd for logging. It uses facility MAIL. You still have to set \fBlog_dir\f1 for debug files. -.TP - -\fBdebug_level = \fIn\f1\fB\f1 - -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 - -\fBmail_dir = \fIfile\f1\fB\f1 - -The directory where local mail is stored, usually \fI/var/spool/mail\f1 or \fI/var/mail\f1. -.TP - -\fBspool_dir = \fIfile\f1\fB\f1 - -The directory where masqmail stores its spool files (and later also other stuff). It must have a subdirectory \fIinput\f1. Masqmail needs read and write permissions for this directory. I suggest to use \fI/var/spool/masqmail\f1. -.TP - -\fBhost_name = \fIstring\f1\fB\f1 - -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\f1 for that. -.TP - -\fBremote_port = \fIn\f1\fB\f1 - -The remote port number to be used. This defaults to port 25. - -This option is deprecated. Use \fBhost_name\f1 in the route configuration instead. See \fBmasqmail.route (5)\f1. -.TP - -\fBlocal_hosts = \fIlist\f1\fB\f1 - -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\f1\fB\f1 - -A semicolon ';' separated list of hostnames which are on the 'local' net. Delivery to these hosts is attempted immediately. You can use patterns with '*', eg. "*.bar.com". -.TP - -\fBlocal_addresses = \fIlist\f1\fB\f1 - -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\f1. - -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\f1\fB\f1 - -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\f1. - -This ist 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\f1\fB\f1 - -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\f1\fB\f1 - -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, eg. procmail. It cannot be preserved because masqmail sets such a header by itself. - -Default is false. -.TP - -\fBdo_relay = \fIboolean\f1\fB\f1 - -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\f1\fB\f1 - -If this is set, mail will not be delivered immediately when accepted. Same as calling masqmail with the \fB-odq\f1 option. -.TP - -\fBonline_routes.\fIname\f1\fB = \fIlist\f1\fB\f1 - -Replace \fIname\f1 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\f1 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\f1 = \fI"/etc/masqmail/fastnet.route"\f1 - -\fI/etc/masqmail/fastnet.route\f1 is the route configuration file, see \fBmasqmail.route (5)\f1. As soon as a link to FastNet has been set up, you call masqmail \fB-qo\f1 \fIFastNet\f1. Masqmail will then read the specified file and send the mails. -.TP - -\fBconnect_route.\fIname\f1\fB = \fIlist\f1\fB\f1 - -Old name for \fBonline_routes\f1. -.TP - -\fBlocal_net_route = \fIfile\f1\fB\f1 - -This is similar to \fBonline_routes.\fIname\f1\fB\f1 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\f1\fB\f1 - -Set this to the location of your alias file. If unset, no aliasing will be done. -.TP - -\fBalias_local_caseless = \fIboolean\f1\fB\f1 - -If this is set, local parts in the alias file will be matched disregarding upper/lower case. -.TP - -\fBpipe_fromline = \fIboolean\f1\fB\f1 - -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\f1\fB\f1 - -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\f1 above. Default is false. -.TP - -\fBmbox_default = \fIstring\f1\fB\f1 - -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\f1, \fBmda_users\f1 or \fBmaildir_users\f1 options (see below). -.TP - -\fBmbox_users = \fIlist\f1\fB\f1 - -A list of users which wish delivery to an mbox style mail folder. -.TP - -\fBmda_users = \fIlist\f1\fB\f1 - -A list of users which wish local delivery to an mda. You have to set \fBmda\f1 (see below) as well. -.TP - -\fBmaildir_users = \fIlist\f1\fB\f1 - -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\f1\fB\f1 - -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 '$' 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)\f1. To use environment variables for the mda, the '$' sign has to be escaped with a backslash, otherwise they will be tried to be expanded with the internal variables. -.TP - -\fBmda_fromline = \fIboolean\f1\fB\f1 - -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\f1\fB\f1 - -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\f1 above. Default is false. -.TP - -\fBonline_detect = \fIstring\f1\fB\f1 - -Defines the method MasqMail uses to detect whether there is currently an online connection. It can have the values \fBfile\f1, \fBpipe\f1 or \fBmserver\f1. - -When it is set to \fBfile\f1, MasqMail first checks for the existence of \fBonline_file\f1 (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\f1\fB\f1 (without a trailing newline character). - -When it is set to \fBpipe\f1, MasqMail calls the executable given by the \fBonline_pipe\f1 option (see below) and reads the current online status from its standard output. - -When it is set to \fBmserver\f1, MasqMail connects to the masqdialer server using the value of \fBmserver_iface\f1 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\f1\fB\f1. - -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\f1\fIconnection\f1. -.TP - -\fBonline_file = \fIfile\f1\fB\f1 - -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 eg. - -echo -n > /tmp/connect_route - -chmod 0644 /tmp/connect_route - -Do not forget to delete it in your ip-down script. -.TP - -\fBonline_pipe = \fIfile\f1\fB\f1 - -This is the name of the executable which will be called to determine the online status. This executable should just print the name oif 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 /tmp/connect_route ] || exit 1 - -cat /tmp/connect_route - -exit 0 - -Of course, instead of the example above you could as well use \fBfile\f1 as the online detection method, but you can do something more sophisticated. -.TP - -\fBmserver_iface = \fIinterface\f1\fB\f1 - -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\f1 to another hostname, eg. "foo:224". -.TP - -\fBget.\fIname\f1\fB = \fIfile\f1\fB\f1 - -Replace \fIname\f1 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\f1\fB = \fIlist\f1\fB\f1 - -Replace \fIname\f1 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\f1\fB\f1 - -\fIlist\f1 is a list of networks of the form a.b.c.d/e (eg. 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\f1\fB\f1 - -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\f1 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\f1\fB\f1 - -Set this to a template which will be used to generate delivery warning reports. It uses the same mechanisms for variables as \fBerrmsg_file\f1, see above. - -Default is /usr/share/masqmail/tpl/warnmsg.tpl. -.TP - -\fBwarn_intervals\f1 = \fIlist\f1 - -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\f1 = \fItime\f1 - -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\f1\fB\f1 - -Replace \fIname\f1 with a valid local or remote mail address. - -If this option is not empty, then a copy of every mail, that passes trough 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 - -You will find the newest version of masqmail at \fBhttp://masqmail.cx/masqmail/\f1 or search for it in freshmeat (\fBhttp://www.freshmeat.net\f1). There is also a mailing list, you will find information about it at masqmails main site. - -.SH BUGS - -You should report them to the mailing list. - -.SH SEE ALSO - -\fBmasqmail (8)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.get (5)\f1 - -.SH COMMENTS - -This man page was written using \fBxml2man (1)\f1 by the same author. - diff -r 653aef34b225 -r 8c55886cacd8 docs/man/masqmail.get.5 --- a/docs/man/masqmail.get.5 Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,99 +0,0 @@ -.TH masqmail.get 5 User Manuals -.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\f1 = \fIstring\f1 - -The protocol with which you retrieve your mail. Currently only 'pop3' and 'apop' are supported. There is no default. -.TP - -\fBserver\f1 = \fIstring\f1 - -The server you get your mail from. -.TP - -\fBresolve_list\f1 = \fIlist\f1 - -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)\f1 will be used. - -The default is "dns_a;byname". It does not make much sense here to use 'dns_mx'. -.TP - -\fBuser\f1 = \fIstring\f1 - -Your login name. -.TP - -\fBpass\f1 = \fIstring\f1 - -Your password. -.TP - -\fBaddress\f1 = \fIaddress\f1 - -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\f1 = \fIaddress\f1 - -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\f1 = \fIboolean\f1 - -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\f1 = \fIboolean\f1 - -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\f1 = \fIboolean\f1 - -If set, and \fBdo_uidl\f1 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\f1 = \fInumeric\f1 - -If set to a value > 0, only messages smaller than this in bytes will be retrieved. The default is 0. -.TP - -\fBmax_count\f1 = \fInumeric\f1 - -If set to a value > 0, only \fBmax_count\f1 messages will be retrieved. The default is 0. -.TP - -\fBwrapper\f1 = \fIcommand\f1 - -If set, instead of opening a connection to a remote server, \fIcommand\f1 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" -.SH AUTHOR - -masqmail was written by Oliver Kurth - -You will find the newest version of masqmail at \fBhttp://masqmail.cx/masqmail/\f1 or search for it in freshmeat (\fBhttp://www.freshmeat.net\f1). There is also a mailing list, you will find information about it at masqmails main site. - -.SH BUGS - -You should report them to the mailing list. - -.SH SEE ALSO - -\fBmasqmail (8)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.conf (5)\f1 - -.SH COMMENTS - -This man page was written using \fBxml2man (1)\f1 by the same author. - diff -r 653aef34b225 -r 8c55886cacd8 docs/man/masqmail.route.5 --- a/docs/man/masqmail.route.5 Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,212 +0,0 @@ -.TH masqmail.route 5 User Manuals -.SH NAME -masqmail.route \- masqmail route configuration file -.SH DESCRIPTION - -This man page describes the syntax of the route configuration files of \fBmasqmail (8)\f1. Their usual locations are in \fI/etc/masqmail/\f1. - -.SH OPTIONS -.TP - -\fBprotocol\f1 = \fIstring\f1 - -\fIstring\f1 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\f1 = \fIstring\f1 - -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\f1 = \fIlist\f1 - -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)\f1 will be used. - -The default is "dns_mx;dns_a;byname". -.TP - -\fBconnect_error_fail\f1 = \fIboolean\f1 - -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\f1 = \fIstring\f1 - -Set the name given with the HELO/EHLO command. If this is not set, \fBhost_name\f1 from \fImasqmail.conf\f1 will be used, if the \fBdo_correct_helo\f1 option (see below) is unset. -.TP - -\fBdo_correct_helo\f1 = \fIboolean\f1 - -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\f1 from \fImasqmail.conf\f1 or as given with the \fBhelo_name\f1 (see above) will be used. -.TP - -\fBdo_pipelining\f1 = \fIboolean\f1 - -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\f1 = \fIlist\f1 - -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\f1 is also unset, all users are allowed. -.TP - -\fBnot_allowed_mail_locals\f1 = \fIlist\f1 - -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\f1 (see above). -.TP - -\fBallowed_return_paths\f1 = \fIlist\f1 - -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\f1 or an item in \fBnot_allowed_mail_locals\f1 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\f1 = \fIlist\f1 - -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\f1 or an item in \fBallowed_mail_locals\f1 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\f1 = \fIlist\f1 - -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\f1 = \fIlist\f1 - -A list of recipient domains where mail will not be sent to. This is for example useful if you send mail directly (\fBmail_host\f1 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/\f1. If any domain matches both \fBallowed_rcpt_domains\f1 and \fBnot_allowed_rcpt_domains\f1, mail will not be sent to this domain. Patterns containing '?' and '*' can be used. -.TP - -\fBset_h_from_domain\f1 = \fIstring\f1 - -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\f1, see below. -.TP - -\fBset_return_path_domain\f1 = \fIstring\f1 - -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\f1 for rewriting local parts. -.TP - -\fBmap_h_from_addresses\f1 = \fIlist\f1 - -This is similar to \fBset_h_from_domain\f1, 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\f1 = \fIlist\f1 - -Same as \fBmap_h_from_addresses\f1, but for the 'Reply-To:' header. -.TP - -\fBmap_h_mail_followup_to_addresses\f1 = \fIlist\f1 - -Same as \fBmap_h_from_addresses\f1, but for the 'Mail-Followup-To:' header. Useful when replying to mailing lists. -.TP - -\fBmap_return_path_addresses\f1 = \fIlist\f1 - -This is similar to \fBset_return_path_domain\f1, 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\f1 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\f1 = \fIboolean\f1 - -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\f1 or \fBmap_return_path_addresses\f1). 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)\f1 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\f1 = \fIboolean\f1 - -Like \fBexpand_h_sender_address\f1, but sets the domain only. Deprecated, will be removed in a later version. -.TP - -\fBlast_route\f1 = \fIboolean\f1 - -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\f1 = \fIstring\f1 - -Set the authentication type for ESMTP AUTH authentification. Currently only 'cram-md5' and 'login' are supported. -.TP - -\fBauth_login\f1 = \fIstring\f1 - -Your account name for ESMTP AUTH authentification. -.TP - -\fBauth_secret\f1 = \fIstring\f1 - -Your secret for ESMTP AUTH authentification. -.TP - -\fBpop3_login\f1 = \fIfile\f1 - -If your Mail server requires SMTP-after-POP, set this to a get configuration (see \fBmasqmail.get (5)\f1). If you login to the POP server before you send, this is not necessary. -.TP - -\fBwrapper\f1 = \fIcommand\f1 - -If set, instead of opening a connection to a remote server, \fIcommand\f1 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\f1 = \fIcommand\f1 - -If set, and protocol is set to 'pipe', \fIcommand\f1 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)\f1. -.TP - -\fBpipe_fromline = \fIboolean\f1\fB\f1 - -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\f1\fB\f1 - -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\f1 above. Default is false. -.SH AUTHOR - -masqmail was written by Oliver Kurth - -You will find the newest version of masqmail at \fBhttp://masqmail.cx/masqmail/\f1 or search for it in freshmeat (\fBhttp://www.freshmeat.net\f1). There is also a mailing list, you will find information about it at masqmails main site. - -.SH BUGS - -You should report them to the mailing list. - -.SH SEE ALSO - -\fBmasqmail (8)\f1, \fBmasqmail.conf (5)\f1, \fBmasqmail.get (5)\f1 - -.SH COMMENTS - -This man page was written using \fBxml2man (1)\f1 by the same author. - diff -r 653aef34b225 -r 8c55886cacd8 docs/man/mservdetect.8 --- a/docs/man/mservdetect.8 Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,42 +0,0 @@ -.TH mservdetect 8 User Manuals -.SH NAME -mservdetect \- Helper for masqmail and masqdialer -.SH SYNOPSIS -\fB/usr/bin/masqmail \fIhost\f1\fB \fIport\f1\fB - -\fB -.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\f1 at \fIport\f1 and prints the connection name to stdout. - -If you want to use it, set \fBonline_detect\f1=\fIpipe\f1 and \fBonline_pipe\f1=\fI"/usr/bin/mservdetect host port"\f1. - -.SH OPTIONS -.TP - -\fBhost\f1 - -The hostname where the masqdialer server is running. -.TP - -\fBport\f1 - -The port number where the masqdialer server is listening. -.SH AUTHOR - -masqmail was written by Oliver Kurth - -You will find the newest version of masqmail at \fBhttp://masqmail.cx/masqmail/\f1 or search for it in freshmeat (\fBhttp://www.freshmeat.net\f1). There is also a mailing list, you will find information about it at masqmails main site. - -.SH BUGS - -You should report them to the mailing list. - -.SH SEE ALSO - -\fBmasqmail.conf (5)\f1 - -.SH COMMENTS - -This man page was written using \fBxml2man (1)\f1 by the same author. - diff -r 653aef34b225 -r 8c55886cacd8 docs/masqmail.8 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/masqmail.8 Fri Sep 26 21:40:10 2008 +0200 @@ -0,0 +1,213 @@ +.TH masqmail 8 User Manuals +.SH NAME +masqmail \- An offline Mail Transfer Agent +.SH SYNOPSIS +\fB/usr/sbin/masqmail [-C \fIfile\f1\fB] [-odq] [-bd] [-q\fIinterval\f1\fB] + +\fB/usr/sbin/masqmail [-odq] [-bs] + +\fB/usr/sbin/masqmail [-bp] + +\fB/usr/sbin/masqmail [-q] + +\fB/usr/sbin/masqmail [-qo [\fIname\f1\fB]] + +\fB/usr/sbin/masqmail [-odq] [-g [\fIname\f1\fB]] + +\fB/usr/sbin/masqmail [-odq] [-go [\fIname\f1\fB]] + +\fB/usr/sbin/masqmail [-t] [-oi] [-f \fIaddress\f1\fB] [--] \fIaddress...\f1\fB + +\fB/usr/sbin/mailq + +\fB +.SH DESCRIPTION + +MasqMail is a mail server designed for hosts that do not have a permanent internet connection eg. 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 (-qo \fIconnection\f1 and -g) +.TP + +\fB--\f1 + +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\f1 + +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 -q option (see below). +.TP + +\fB-bi\f1 + +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\f1 + +Show the messages in the queue. Same as calling masqmail as 'mailq'. +.TP + +\fB-bs\f1 + +Accept SMTP commands from stdin. Some mailers (eg pine) use this option as an interface. It can also be used to call masqmail from inetd. +.TP + +\fB-B \fIarg\f1\fB\f1 + +\fIarg\f1 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 \f1 + +Show version information. +.TP + +\fB-C \f1\fIfilename\f1 + +Use another configuration than \fI/etc/masqmail/masqmail.conf\f1. Useful for debugging purposes. If not invoked by a privileged user, masqmail will drop all privileges. +.TP + +\fB-d \fInumber\f1\fB\f1 + +Set the debug level. This takes precedence before the value ofdebug_level in the configuration file. Read the warning in the description of the latter. +.TP + +\fB-f [\fIaddress\f1\fB]\f1 + +Set the return path address to \fIaddress\f1. Only root, the user mail and anyoune in group trusted is allowed to do that. +.TP + +\fB-F [\fIstring\f1\fB]\f1 + +Set the full sender name (in the From: header) to \fIstring\f1. +.TP + +\fB-g [\fIname\f1\fB]\f1 + +Get mail (using pop3 or apop), using the configurations given with get.\fIname\f1 in the main configuration. Without \fIname\f1, all get configurations will be used. See also \fBmasqmail.get (5)\f1 +.TP + +\fB-go [\fIinterval\f1\fB] [\fIname\f1\fB]\f1 + +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\f1 is defined in the configuration (see \fBonline_gets.\fIname\f1\fB\f1). + +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 all five minutes. + +If called without \fIname\f1 the online status is determined with the configured method (see \fBonline_detect\f1 in config.html). +.TP + +\fB-i\f1 + +Same as -oi, see below. +.TP + +\fB-Mrm \fIlist\f1\fB\f1 + +Remove given messages from the queue. Only allowed for privileged users. +.TP + +\fB-oem\f1 + +If the -oi ist not also given, always return with a non zero return code. Maybe someone tells me what this is good for... +.TP + +\fB-odb\f1 + +Deliver in background. Masqmail always does this, which makes this option pretty much useless. +.TP + +\fB-odq\f1 + +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\f1 + +A dot as a single character in a line does not terminate the message. +.TP + +\fB-q [\fIinterval\f1\fB]\f1 + +If not given with an argument, run a queue process, ie. 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 -qo 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 -bd -q30m. + +An argument may be a time interval ie. 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: -q30m. 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 -bd (see above). +.TP + +\fB-qo [\fIname\f1\fB]\f1 + +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\f1 is defined in the configuration (see \fBonline_routes.\fIname\f1\fB\f1). + +If called without \fIname\f1 the online status is determined with the configured method (see \fBonline_detect\f1 in config.html) +.TP + +\fB-t\f1 + +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\f1 + +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 - the return path. + +SENDER_DOMAIN - the domain part of the return path. + +SENDER_LOCAL - the local part of the return path. + +RECEIVED_HOST - the host the message was received from (unless local). + +LOCAL_PART, USER, LOGNAME - the local part of the (original) recipient. + +MESSAGE_ID - the unique message id. This is not necessarily identical with the Message ID as given in the Message ID: header. + +QUALIFY_DOMAIN - the domain which will be appended to unqualified addresses. + +.SH FILES + +\fI/etc/masqmail/masqmail.conf\f1 is the main configuration for masqmail. Depending on the settings in this file, you will also have other configuration files in \fI/etc/masqmail/\f1. + +\fI/etc/aliases\f1 is the alias file, if not set differently in \fI/etc/masqmail/masqmail.conf\f1. + +\fI/var/spool/masqmail/\f1 is the spool directory where masqmail stores its spooled messages and the uniq pop ids. + +\fI/var/spool/mail/\f1 is the directory where locally delivered mail will be put, if not configured differently in \fImasqmail.conf\f1. + +\fI/var/log/masqmail/\f1 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 + +You will find the newest version of masqmail at \fBhttp://masqmail.cx/masqmail/\f1 or search for it in freshmeat (\fBhttp://www.freshmeat.net\f1). There is also a mailing list, you will find information about it at masqmails main site. + +.SH BUGS + +You should report them to the mailing list. + +.SH SEE ALSO + +\fBmasqmail.conf (5)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.get (5)\f1, \fBmasqmail.aliases (5)\f1 + +.SH COMMENTS + +This man page was written using \fBxml2man (1)\f1 by the same author. + diff -r 653aef34b225 -r 8c55886cacd8 docs/masqmail.aliases.5 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/masqmail.aliases.5 Fri Sep 26 21:40:10 2008 +0200 @@ -0,0 +1,41 @@ +.TH masqmail.aliases 5 User Manuals +.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\f1. + +.SH FILE FORMAT + +The alias file consists of lines of the form: +local_part: item1, item2, ... +Items can be surrounded by quotes '"'. If within the quotes other quotes are needed for an address they can be escaped with a leading backslash '\'. + +A leading '\' 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 + +You will find the newest version of masqmail at \fBhttp://masqmail.cx/masqmail/\f1 or search for it in freshmeat (\fBhttp://www.freshmeat.net\f1). There is also a mailing list, you will find information about it at masqmails main site. + +.SH BUGS + +You should report them to the mailing list. + +.SH SEE ALSO + +\fBmasqmail.conf (5)\f1, \fBmasqmail (8)\f1, + +.SH COMMENTS + +This man page was written using \fBxml2man (1)\f1 by the same author. + diff -r 653aef34b225 -r 8c55886cacd8 docs/masqmail.conf.5 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/masqmail.conf.5 Fri Sep 26 21:40:10 2008 +0200 @@ -0,0 +1,345 @@ +.TH masqmail.conf 5 User Manuals +.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\f1 + +The configuration consists of lines of the form + +\fBval\f1 = \fIexpression\f1 + +Where \fBval\f1 is a variable name and \fIexpression\f1 a string, which can be quoted with '"'. 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 ';'. For some values patterns (like '*','?') can be used. The spaces before and after the '=' are optional. + +Most lists (exceptions: \fBlocal_hosts\f1,\fBlocal_nets\f1, \fBlisten_addresses\f1, \fBonline_routes\f1 and \fBonline_gets\f1) 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 '#' are ignored. + +.SH OPTIONS +.TP + +\fBrun_as_user = \fIboolean\f1\fB\f1 + +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\f1\fB\f1 + +If this is set, masqmail uses syslogd for logging. It uses facility MAIL. You still have to set \fBlog_dir\f1 for debug files. +.TP + +\fBdebug_level = \fIn\f1\fB\f1 + +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 + +\fBmail_dir = \fIfile\f1\fB\f1 + +The directory where local mail is stored, usually \fI/var/spool/mail\f1 or \fI/var/mail\f1. +.TP + +\fBspool_dir = \fIfile\f1\fB\f1 + +The directory where masqmail stores its spool files (and later also other stuff). It must have a subdirectory \fIinput\f1. Masqmail needs read and write permissions for this directory. I suggest to use \fI/var/spool/masqmail\f1. +.TP + +\fBhost_name = \fIstring\f1\fB\f1 + +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\f1 for that. +.TP + +\fBremote_port = \fIn\f1\fB\f1 + +The remote port number to be used. This defaults to port 25. + +This option is deprecated. Use \fBhost_name\f1 in the route configuration instead. See \fBmasqmail.route (5)\f1. +.TP + +\fBlocal_hosts = \fIlist\f1\fB\f1 + +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\f1\fB\f1 + +A semicolon ';' separated list of hostnames which are on the 'local' net. Delivery to these hosts is attempted immediately. You can use patterns with '*', eg. "*.bar.com". +.TP + +\fBlocal_addresses = \fIlist\f1\fB\f1 + +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\f1. + +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\f1\fB\f1 + +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\f1. + +This ist 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\f1\fB\f1 + +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\f1\fB\f1 + +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, eg. procmail. It cannot be preserved because masqmail sets such a header by itself. + +Default is false. +.TP + +\fBdo_relay = \fIboolean\f1\fB\f1 + +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\f1\fB\f1 + +If this is set, mail will not be delivered immediately when accepted. Same as calling masqmail with the \fB-odq\f1 option. +.TP + +\fBonline_routes.\fIname\f1\fB = \fIlist\f1\fB\f1 + +Replace \fIname\f1 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\f1 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\f1 = \fI"/etc/masqmail/fastnet.route"\f1 + +\fI/etc/masqmail/fastnet.route\f1 is the route configuration file, see \fBmasqmail.route (5)\f1. As soon as a link to FastNet has been set up, you call masqmail \fB-qo\f1 \fIFastNet\f1. Masqmail will then read the specified file and send the mails. +.TP + +\fBconnect_route.\fIname\f1\fB = \fIlist\f1\fB\f1 + +Old name for \fBonline_routes\f1. +.TP + +\fBlocal_net_route = \fIfile\f1\fB\f1 + +This is similar to \fBonline_routes.\fIname\f1\fB\f1 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\f1\fB\f1 + +Set this to the location of your alias file. If unset, no aliasing will be done. +.TP + +\fBalias_local_caseless = \fIboolean\f1\fB\f1 + +If this is set, local parts in the alias file will be matched disregarding upper/lower case. +.TP + +\fBpipe_fromline = \fIboolean\f1\fB\f1 + +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\f1\fB\f1 + +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\f1 above. Default is false. +.TP + +\fBmbox_default = \fIstring\f1\fB\f1 + +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\f1, \fBmda_users\f1 or \fBmaildir_users\f1 options (see below). +.TP + +\fBmbox_users = \fIlist\f1\fB\f1 + +A list of users which wish delivery to an mbox style mail folder. +.TP + +\fBmda_users = \fIlist\f1\fB\f1 + +A list of users which wish local delivery to an mda. You have to set \fBmda\f1 (see below) as well. +.TP + +\fBmaildir_users = \fIlist\f1\fB\f1 + +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\f1\fB\f1 + +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 '$' 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)\f1. To use environment variables for the mda, the '$' sign has to be escaped with a backslash, otherwise they will be tried to be expanded with the internal variables. +.TP + +\fBmda_fromline = \fIboolean\f1\fB\f1 + +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\f1\fB\f1 + +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\f1 above. Default is false. +.TP + +\fBonline_detect = \fIstring\f1\fB\f1 + +Defines the method MasqMail uses to detect whether there is currently an online connection. It can have the values \fBfile\f1, \fBpipe\f1 or \fBmserver\f1. + +When it is set to \fBfile\f1, MasqMail first checks for the existence of \fBonline_file\f1 (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\f1\fB\f1 (without a trailing newline character). + +When it is set to \fBpipe\f1, MasqMail calls the executable given by the \fBonline_pipe\f1 option (see below) and reads the current online status from its standard output. + +When it is set to \fBmserver\f1, MasqMail connects to the masqdialer server using the value of \fBmserver_iface\f1 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\f1\fB\f1. + +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\f1\fIconnection\f1. +.TP + +\fBonline_file = \fIfile\f1\fB\f1 + +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 eg. + +echo -n > /tmp/connect_route + +chmod 0644 /tmp/connect_route + +Do not forget to delete it in your ip-down script. +.TP + +\fBonline_pipe = \fIfile\f1\fB\f1 + +This is the name of the executable which will be called to determine the online status. This executable should just print the name oif 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 /tmp/connect_route ] || exit 1 + +cat /tmp/connect_route + +exit 0 + +Of course, instead of the example above you could as well use \fBfile\f1 as the online detection method, but you can do something more sophisticated. +.TP + +\fBmserver_iface = \fIinterface\f1\fB\f1 + +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\f1 to another hostname, eg. "foo:224". +.TP + +\fBget.\fIname\f1\fB = \fIfile\f1\fB\f1 + +Replace \fIname\f1 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\f1\fB = \fIlist\f1\fB\f1 + +Replace \fIname\f1 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\f1\fB\f1 + +\fIlist\f1 is a list of networks of the form a.b.c.d/e (eg. 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\f1\fB\f1 + +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\f1 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\f1\fB\f1 + +Set this to a template which will be used to generate delivery warning reports. It uses the same mechanisms for variables as \fBerrmsg_file\f1, see above. + +Default is /usr/share/masqmail/tpl/warnmsg.tpl. +.TP + +\fBwarn_intervals\f1 = \fIlist\f1 + +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\f1 = \fItime\f1 + +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\f1\fB\f1 + +Replace \fIname\f1 with a valid local or remote mail address. + +If this option is not empty, then a copy of every mail, that passes trough 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 + +You will find the newest version of masqmail at \fBhttp://masqmail.cx/masqmail/\f1 or search for it in freshmeat (\fBhttp://www.freshmeat.net\f1). There is also a mailing list, you will find information about it at masqmails main site. + +.SH BUGS + +You should report them to the mailing list. + +.SH SEE ALSO + +\fBmasqmail (8)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.get (5)\f1 + +.SH COMMENTS + +This man page was written using \fBxml2man (1)\f1 by the same author. + diff -r 653aef34b225 -r 8c55886cacd8 docs/masqmail.get.5 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/masqmail.get.5 Fri Sep 26 21:40:10 2008 +0200 @@ -0,0 +1,99 @@ +.TH masqmail.get 5 User Manuals +.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\f1 = \fIstring\f1 + +The protocol with which you retrieve your mail. Currently only 'pop3' and 'apop' are supported. There is no default. +.TP + +\fBserver\f1 = \fIstring\f1 + +The server you get your mail from. +.TP + +\fBresolve_list\f1 = \fIlist\f1 + +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)\f1 will be used. + +The default is "dns_a;byname". It does not make much sense here to use 'dns_mx'. +.TP + +\fBuser\f1 = \fIstring\f1 + +Your login name. +.TP + +\fBpass\f1 = \fIstring\f1 + +Your password. +.TP + +\fBaddress\f1 = \fIaddress\f1 + +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\f1 = \fIaddress\f1 + +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\f1 = \fIboolean\f1 + +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\f1 = \fIboolean\f1 + +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\f1 = \fIboolean\f1 + +If set, and \fBdo_uidl\f1 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\f1 = \fInumeric\f1 + +If set to a value > 0, only messages smaller than this in bytes will be retrieved. The default is 0. +.TP + +\fBmax_count\f1 = \fInumeric\f1 + +If set to a value > 0, only \fBmax_count\f1 messages will be retrieved. The default is 0. +.TP + +\fBwrapper\f1 = \fIcommand\f1 + +If set, instead of opening a connection to a remote server, \fIcommand\f1 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" +.SH AUTHOR + +masqmail was written by Oliver Kurth + +You will find the newest version of masqmail at \fBhttp://masqmail.cx/masqmail/\f1 or search for it in freshmeat (\fBhttp://www.freshmeat.net\f1). There is also a mailing list, you will find information about it at masqmails main site. + +.SH BUGS + +You should report them to the mailing list. + +.SH SEE ALSO + +\fBmasqmail (8)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.conf (5)\f1 + +.SH COMMENTS + +This man page was written using \fBxml2man (1)\f1 by the same author. + diff -r 653aef34b225 -r 8c55886cacd8 docs/masqmail.route.5 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/masqmail.route.5 Fri Sep 26 21:40:10 2008 +0200 @@ -0,0 +1,212 @@ +.TH masqmail.route 5 User Manuals +.SH NAME +masqmail.route \- masqmail route configuration file +.SH DESCRIPTION + +This man page describes the syntax of the route configuration files of \fBmasqmail (8)\f1. Their usual locations are in \fI/etc/masqmail/\f1. + +.SH OPTIONS +.TP + +\fBprotocol\f1 = \fIstring\f1 + +\fIstring\f1 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\f1 = \fIstring\f1 + +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\f1 = \fIlist\f1 + +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)\f1 will be used. + +The default is "dns_mx;dns_a;byname". +.TP + +\fBconnect_error_fail\f1 = \fIboolean\f1 + +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\f1 = \fIstring\f1 + +Set the name given with the HELO/EHLO command. If this is not set, \fBhost_name\f1 from \fImasqmail.conf\f1 will be used, if the \fBdo_correct_helo\f1 option (see below) is unset. +.TP + +\fBdo_correct_helo\f1 = \fIboolean\f1 + +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\f1 from \fImasqmail.conf\f1 or as given with the \fBhelo_name\f1 (see above) will be used. +.TP + +\fBdo_pipelining\f1 = \fIboolean\f1 + +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\f1 = \fIlist\f1 + +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\f1 is also unset, all users are allowed. +.TP + +\fBnot_allowed_mail_locals\f1 = \fIlist\f1 + +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\f1 (see above). +.TP + +\fBallowed_return_paths\f1 = \fIlist\f1 + +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\f1 or an item in \fBnot_allowed_mail_locals\f1 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\f1 = \fIlist\f1 + +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\f1 or an item in \fBallowed_mail_locals\f1 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\f1 = \fIlist\f1 + +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\f1 = \fIlist\f1 + +A list of recipient domains where mail will not be sent to. This is for example useful if you send mail directly (\fBmail_host\f1 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/\f1. If any domain matches both \fBallowed_rcpt_domains\f1 and \fBnot_allowed_rcpt_domains\f1, mail will not be sent to this domain. Patterns containing '?' and '*' can be used. +.TP + +\fBset_h_from_domain\f1 = \fIstring\f1 + +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\f1, see below. +.TP + +\fBset_return_path_domain\f1 = \fIstring\f1 + +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\f1 for rewriting local parts. +.TP + +\fBmap_h_from_addresses\f1 = \fIlist\f1 + +This is similar to \fBset_h_from_domain\f1, 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\f1 = \fIlist\f1 + +Same as \fBmap_h_from_addresses\f1, but for the 'Reply-To:' header. +.TP + +\fBmap_h_mail_followup_to_addresses\f1 = \fIlist\f1 + +Same as \fBmap_h_from_addresses\f1, but for the 'Mail-Followup-To:' header. Useful when replying to mailing lists. +.TP + +\fBmap_return_path_addresses\f1 = \fIlist\f1 + +This is similar to \fBset_return_path_domain\f1, 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\f1 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\f1 = \fIboolean\f1 + +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\f1 or \fBmap_return_path_addresses\f1). 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)\f1 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\f1 = \fIboolean\f1 + +Like \fBexpand_h_sender_address\f1, but sets the domain only. Deprecated, will be removed in a later version. +.TP + +\fBlast_route\f1 = \fIboolean\f1 + +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\f1 = \fIstring\f1 + +Set the authentication type for ESMTP AUTH authentification. Currently only 'cram-md5' and 'login' are supported. +.TP + +\fBauth_login\f1 = \fIstring\f1 + +Your account name for ESMTP AUTH authentification. +.TP + +\fBauth_secret\f1 = \fIstring\f1 + +Your secret for ESMTP AUTH authentification. +.TP + +\fBpop3_login\f1 = \fIfile\f1 + +If your Mail server requires SMTP-after-POP, set this to a get configuration (see \fBmasqmail.get (5)\f1). If you login to the POP server before you send, this is not necessary. +.TP + +\fBwrapper\f1 = \fIcommand\f1 + +If set, instead of opening a connection to a remote server, \fIcommand\f1 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\f1 = \fIcommand\f1 + +If set, and protocol is set to 'pipe', \fIcommand\f1 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)\f1. +.TP + +\fBpipe_fromline = \fIboolean\f1\fB\f1 + +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\f1\fB\f1 + +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\f1 above. Default is false. +.SH AUTHOR + +masqmail was written by Oliver Kurth + +You will find the newest version of masqmail at \fBhttp://masqmail.cx/masqmail/\f1 or search for it in freshmeat (\fBhttp://www.freshmeat.net\f1). There is also a mailing list, you will find information about it at masqmails main site. + +.SH BUGS + +You should report them to the mailing list. + +.SH SEE ALSO + +\fBmasqmail (8)\f1, \fBmasqmail.conf (5)\f1, \fBmasqmail.get (5)\f1 + +.SH COMMENTS + +This man page was written using \fBxml2man (1)\f1 by the same author. + diff -r 653aef34b225 -r 8c55886cacd8 docs/mservdetect.8 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/docs/mservdetect.8 Fri Sep 26 21:40:10 2008 +0200 @@ -0,0 +1,42 @@ +.TH mservdetect 8 User Manuals +.SH NAME +mservdetect \- Helper for masqmail and masqdialer +.SH SYNOPSIS +\fB/usr/bin/masqmail \fIhost\f1\fB \fIport\f1\fB + +\fB +.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\f1 at \fIport\f1 and prints the connection name to stdout. + +If you want to use it, set \fBonline_detect\f1=\fIpipe\f1 and \fBonline_pipe\f1=\fI"/usr/bin/mservdetect host port"\f1. + +.SH OPTIONS +.TP + +\fBhost\f1 + +The hostname where the masqdialer server is running. +.TP + +\fBport\f1 + +The port number where the masqdialer server is listening. +.SH AUTHOR + +masqmail was written by Oliver Kurth + +You will find the newest version of masqmail at \fBhttp://masqmail.cx/masqmail/\f1 or search for it in freshmeat (\fBhttp://www.freshmeat.net\f1). There is also a mailing list, you will find information about it at masqmails main site. + +.SH BUGS + +You should report them to the mailing list. + +.SH SEE ALSO + +\fBmasqmail.conf (5)\f1 + +.SH COMMENTS + +This man page was written using \fBxml2man (1)\f1 by the same author. + diff -r 653aef34b225 -r 8c55886cacd8 docs/xml/Makefile.am --- a/docs/xml/Makefile.am Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,1 +0,0 @@ -EXTRA_DIST = *.xml diff -r 653aef34b225 -r 8c55886cacd8 docs/xml/Makefile.in --- a/docs/xml/Makefile.in Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,268 +0,0 @@ -# Makefile.in generated by automake 1.7.9 from Makefile.am. -# @configure_input@ - -# Copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003 -# 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@ - -srcdir = @srcdir@ -top_srcdir = @top_srcdir@ -VPATH = @srcdir@ -pkgdatadir = $(datadir)/@PACKAGE@ -pkglibdir = $(libdir)/@PACKAGE@ -pkgincludedir = $(includedir)/@PACKAGE@ -top_builddir = ../.. - -am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd -INSTALL = @INSTALL@ -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 = : -ACLOCAL = @ACLOCAL@ -AMDEP_FALSE = @AMDEP_FALSE@ -AMDEP_TRUE = @AMDEP_TRUE@ -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_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@ -OBJEXT = @OBJEXT@ -PACKAGE = @PACKAGE@ -PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ -PACKAGE_NAME = @PACKAGE_NAME@ -PACKAGE_STRING = @PACKAGE_STRING@ -PACKAGE_TARNAME = @PACKAGE_TARNAME@ -PACKAGE_VERSION = @PACKAGE_VERSION@ -PATH_SEPARATOR = @PATH_SEPARATOR@ -PKG_CONFIG = @PKG_CONFIG@ -RANLIB = @RANLIB@ -RESOLV_LIBS = @RESOLV_LIBS@ -SET_MAKE = @SET_MAKE@ -SHELL = @SHELL@ -STRIP = @STRIP@ -USE_LIBLOCKFILE = @USE_LIBLOCKFILE@ -VERSION = @VERSION@ -ac_ct_CC = @ac_ct_CC@ -am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ -am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ -am__include = @am__include@ -am__leading_dot = @am__leading_dot@ -am__quote = @am__quote@ -bindir = @bindir@ -build_alias = @build_alias@ -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@ -oldincludedir = @oldincludedir@ -pdfdir = @pdfdir@ -prefix = @prefix@ -program_transform_name = @program_transform_name@ -psdir = @psdir@ -sbindir = @sbindir@ -sharedstatedir = @sharedstatedir@ -sysconfdir = @sysconfdir@ -target_alias = @target_alias@ -with_confdir = @with_confdir@ -with_group = @with_group@ -with_logdir = @with_logdir@ -with_spooldir = @with_spooldir@ -with_user = @with_user@ -EXTRA_DIST = *.xml -subdir = docs/xml -ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs -CONFIG_HEADER = $(top_builddir)/config.h -CONFIG_CLEAN_FILES = -DIST_SOURCES = -DIST_COMMON = $(srcdir)/Makefile.in Makefile.am -all: all-am - -.SUFFIXES: -$(srcdir)/Makefile.in: Makefile.am $(top_srcdir)/configure.ac $(ACLOCAL_M4) - cd $(top_srcdir) && \ - $(AUTOMAKE) --gnu docs/xml/Makefile -Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status - cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe) -uninstall-info-am: -tags: TAGS -TAGS: - -ctags: CTAGS -CTAGS: - -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) - -top_distdir = ../.. -distdir = $(top_distdir)/$(PACKAGE)-$(VERSION) - -distdir: $(DISTFILES) - @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ - topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ - list='$(DISTFILES)'; for file in $$list; do \ - case $$file in \ - $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ - $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ - esac; \ - if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ - dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ - if test "$$dir" != "$$file" && test "$$dir" != "."; then \ - dir="/$$dir"; \ - $(mkinstalldirs) "$(distdir)$$dir"; \ - else \ - dir=''; \ - fi; \ - if test -d $$d/$$file; then \ - if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ - cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ - fi; \ - cp -pR $$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 - -installdirs: -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: - -rm -f $(CONFIG_CLEAN_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: - -info: info-am - -info-am: - -install-data-am: - -install-exec-am: - -install-info: install-info-am - -install-man: - -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-info-am - -.PHONY: all all-am check check-am clean clean-generic distclean \ - distclean-generic distdir dvi dvi-am info info-am install \ - install-am install-data install-data-am install-exec \ - install-exec-am install-info install-info-am install-man \ - install-strip installcheck installcheck-am installdirs \ - maintainer-clean maintainer-clean-generic mostlyclean \ - mostlyclean-generic pdf pdf-am ps ps-am uninstall uninstall-am \ - uninstall-info-am - -# 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 653aef34b225 -r 8c55886cacd8 docs/xml/masqmail.8.xml --- a/docs/xml/masqmail.8.xml Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,302 +0,0 @@ - - - - - - -/usr/sbin/masqmail [-C file] [-odq] [-bd] [-qinterval] -/usr/sbin/masqmail [-odq] [-bs] -/usr/sbin/masqmail [-bp] -/usr/sbin/masqmail [-q] -/usr/sbin/masqmail [-qo [name]] -/usr/sbin/masqmail [-odq] [-g [name]] -/usr/sbin/masqmail [-odq] [-go [name]] -/usr/sbin/masqmail [-t] [-oi] [-f address] [--] address... -/usr/sbin/mailq - - - -

MasqMail is a mail server designed for hosts that do -not have a permanent internet connection eg. 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.

- - - -

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 (-qo connection and -g) -

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
- -

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 - the return path.

-

SENDER_DOMAIN - the domain part of the return path.

-

SENDER_LOCAL - the local part of the return path.

-

RECEIVED_HOST - the host the message was received from (unless local).

-

LOCAL_PART, USER, LOGNAME - the local part of the (original) recipient.

-

MESSAGE_ID - the unique message id. This is not necessarily identical with the Message ID as given in the Message ID: header.

-

QUALIFY_DOMAIN - the domain which will be appended to unqualified addresses.

- -
- -
-

/etc/masqmail/masqmail.conf is the main configuration -for masqmail. Depending on the settings in this file, you will also -have other configuration files in /etc/masqmail/.

-

/etc/aliases is the alias file, if not set differently -in /etc/masqmail/masqmail.conf.

-

/var/spool/masqmail/ is the spool directory where masqmail -stores its spooled messages and the uniq pop ids.

-

/var/spool/mail/ is the directory where locally delivered mail will be put, if not configured differently in masqmail.conf.

-

/var/log/masqmail/ 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.

-
- -
-

RFC 821, 822, 1869, 1870, 2197, 2554 (SMTP)

-

RFC 1725, 1939 (POP3)

-

RFC 1321 (MD5)

-

RFC 2195 (CRAM-MD5)

-
- -
-

masqmail was written by Oliver Kurth -<oku@masqmail.cx>

You will find the newest version of -masqmail at or search for it -in freshmeat (). There is also a mailing list, -you will find information about it at masqmails main site.

-
- -
-

You should report them to the mailing list.

-
- -
-

-, , , -

-
- -
-

This man page was written using by the same author.

-
- - diff -r 653aef34b225 -r 8c55886cacd8 docs/xml/masqmail.aliases.5.xml --- a/docs/xml/masqmail.aliases.5.xml Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,63 +0,0 @@ - - - - - - -

This man page describes the format of the masqmail alias file. Its usual location is /etc/aliases.

- - -
-

The alias file consists of lines of the form:

-
-local_part: item1, item2, ...
-
- -

Items can be surrounded by quotes '"'. If within the quotes other -quotes are needed for an address they can be escaped with a leading -backslash '\'.

- -

A leading '\' 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.

-
- -
-

masqmail was written by Oliver Kurth -<oku@masqmail.cx>

You will find the newest version of -masqmail at or search for it -in freshmeat (). There is also a mailing list, -you will find information about it at masqmails main site.

-
- -
-

You should report them to the mailing list.

-
- -
-

-, , -

-
- -
-

This man page was written using by the same author.

-
- - diff -r 653aef34b225 -r 8c55886cacd8 docs/xml/masqmail.conf.5.xml --- a/docs/xml/masqmail.conf.5.xml Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,561 +0,0 @@ - - - - - - -

This man page describes the syntax of the main configuration file -of masqmail. Its usual location is /etc/masqmail/masqmail.conf

- -

The configuration consists of lines of the form

- -

val = expression

- -

Where val is a variable name and expression a string, -which can be quoted with '"'. 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 ';'. For some values patterns (like '*','?') can be used. The -spaces before and after the '=' are optional.

- -

Most lists (exceptions: local_hosts, -local_nets, listen_addresses, online_routes and online_gets) 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 '#' are ignored.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-

masqmail was written by Oliver Kurth -<oku@masqmail.cx>

You will find the newest version of -masqmail at or search for it -in freshmeat (). There is also a mailing list, -you will find information about it at masqmails main site.

-
- -
-

You should report them to the mailing list.

-
- -
-

-, , -

-
- - -
-

This man page was written using by the same -author.

-
- - - diff -r 653aef34b225 -r 8c55886cacd8 docs/xml/masqmail.get.5.xml --- a/docs/xml/masqmail.get.5.xml Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,165 +0,0 @@ - - - - - -

This man page describes the options available for the -masqmail get configuration.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-

masqmail was written by Oliver Kurth -<oku@masqmail.cx>

You will find the newest version of -masqmail at or search for it -in freshmeat (). There is also a mailing list, -you will find information about it at masqmails main site.

-
- -
-

You should report them to the mailing list.

-
- -
-

-, , -

-
- -
-

This man page was written using by the same -author.

-
- - - diff -r 653aef34b225 -r 8c55886cacd8 docs/xml/masqmail.route.5.xml --- a/docs/xml/masqmail.route.5.xml Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,376 +0,0 @@ - - - - - - -

This man page describes the syntax of the route configuration files -of . Their usual locations are in /etc/masqmail/.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-

masqmail was written by Oliver Kurth -<oku@masqmail.cx>

You will find the newest version of -masqmail at or search for it -in freshmeat (). There is also a mailing list, -you will find information about it at masqmails main site.

-
- -
-

You should report them to the mailing list.

-
- -
-

-, , -

-
- -
-

This man page was written using by the same -author.

-
- - - diff -r 653aef34b225 -r 8c55886cacd8 docs/xml/mservdetect.8.xml --- a/docs/xml/mservdetect.8.xml Fri Sep 26 21:26:36 2008 +0200 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,60 +0,0 @@ - - - - - - -/usr/bin/masqmail host port - - - -

-mservdetect is a small helper application for masqmail to detect its online -status if the modem server masqdialer is used. It connects to the -host at port and prints the connection name to -stdout.

-

If you want to use it, set online_detect=pipe and online_pipe="/usr/bin/mservdetect host port".

- - - - - - - - - - -
-

masqmail was written by Oliver Kurth -<oku@masqmail.cx>

You will find the newest version of -masqmail at or search for it -in freshmeat (). There is also a mailing list, -you will find information about it at masqmails main site.

-
- -
-

You should report them to the mailing list.

-
- -
-

- -

-
- -
-

This man page was written using by the same author.

-
- -