1.1 --- a/Makefile.am	Fri Sep 26 21:26:36 2008 +0200
     1.2 +++ b/Makefile.am	Fri Sep 26 21:40:10 2008 +0200
     1.3 @@ -1,6 +1,6 @@
     1.4  EXTRA_DIST = \
     1.5  examples/example.get examples/example.route examples/masqmail.conf \
     1.6 -docs/README docs/man/m*.[0-9] \
     1.7 +docs/README docs/m*.[0-9] \
     1.8  suse/masqmail suse/masqmail.spec suse/masqmail.spec.in \
     1.9  redhat/masqmail redhat/masqmail.spec redhat/masqmail.spec.in \
    1.10  tpl/failmsg.tpl tpl/failmsg.tpl.de tpl/failmsg.tpl.fr tpl/failmsg.tpl.it \

     2.1 --- a/Makefile.in	Fri Sep 26 21:26:36 2008 +0200
     2.2 +++ b/Makefile.in	Fri Sep 26 21:40:10 2008 +0200
     2.3 @@ -128,7 +128,7 @@
     2.4  with_user = @with_user@
     2.5  EXTRA_DIST = \
     2.6  examples/example.get examples/example.route examples/masqmail.conf \
     2.7 -docs/README docs/man/m*.[0-9] \
     2.8 +docs/README docs/m*.[0-9] \
     2.9  suse/masqmail suse/masqmail.spec suse/masqmail.spec.in \
    2.10  redhat/masqmail redhat/masqmail.spec redhat/masqmail.spec.in \
    2.11  tpl/failmsg.tpl tpl/failmsg.tpl.de tpl/failmsg.tpl.fr tpl/failmsg.tpl.it \
    2.12 @@ -337,7 +337,7 @@
    2.13  distdir: $(DISTFILES)
    2.14  	$(am__remove_distdir)
    2.15  	mkdir $(distdir)
    2.16 -	$(mkinstalldirs) $(distdir)/docs $(distdir)/docs/man $(distdir)/examples $(distdir)/redhat $(distdir)/suse $(distdir)/tpl
    2.17 +	$(mkinstalldirs) $(distdir)/docs $(distdir)/examples $(distdir)/redhat $(distdir)/suse $(distdir)/tpl
    2.18  	@srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \
    2.19  	topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \
    2.20  	list='$(DISTFILES)'; for file in $$list; do \

     3.1 --- a/config.status.lineno	Fri Sep 26 21:26:36 2008 +0200
     3.2 +++ b/config.status.lineno	Fri Sep 26 21:40:10 2008 +0200
     3.3 @@ -301,7 +301,7 @@
     3.4  "
     3.5  
     3.6  # Files that config.status was made for.
     3.7 -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"
     3.8 +config_files=" Makefile debian/Makefile tests/Makefile src/Makefile src/base64/Makefile src/md5/Makefile src/libident/Makefile suse/masqmail.spec redhat/masqmail.spec"
     3.9  config_headers=" config.h"
    3.10  config_commands=" depfiles"
    3.11  
    3.12 @@ -438,9 +438,6 @@
    3.13      "depfiles") CONFIG_COMMANDS="$CONFIG_COMMANDS depfiles" ;;
    3.14      "Makefile") CONFIG_FILES="$CONFIG_FILES Makefile" ;;
    3.15      "debian/Makefile") CONFIG_FILES="$CONFIG_FILES debian/Makefile" ;;
    3.16 -    "docs/Makefile") CONFIG_FILES="$CONFIG_FILES docs/Makefile" ;;
    3.17 -    "docs/man/Makefile") CONFIG_FILES="$CONFIG_FILES docs/man/Makefile" ;;
    3.18 -    "docs/xml/Makefile") CONFIG_FILES="$CONFIG_FILES docs/xml/Makefile" ;;
    3.19      "tests/Makefile") CONFIG_FILES="$CONFIG_FILES tests/Makefile" ;;
    3.20      "src/Makefile") CONFIG_FILES="$CONFIG_FILES src/Makefile" ;;
    3.21      "src/base64/Makefile") CONFIG_FILES="$CONFIG_FILES src/base64/Makefile" ;;

     4.1 --- a/configure	Fri Sep 26 21:26:36 2008 +0200
     4.2 +++ b/configure	Fri Sep 26 21:40:10 2008 +0200
     4.3 @@ -6494,7 +6494,7 @@
     4.4  	fi
     4.5  fi
     4.6  
     4.7 -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"
     4.8 +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"
     4.9  
    4.10  cat >confcache <<\_ACEOF
    4.11  # This file is a shell script that caches the results of configure
    4.12 @@ -7076,9 +7076,6 @@
    4.13      "depfiles") CONFIG_COMMANDS="$CONFIG_COMMANDS depfiles" ;;
    4.14      "Makefile") CONFIG_FILES="$CONFIG_FILES Makefile" ;;
    4.15      "debian/Makefile") CONFIG_FILES="$CONFIG_FILES debian/Makefile" ;;
    4.16 -    "docs/Makefile") CONFIG_FILES="$CONFIG_FILES docs/Makefile" ;;
    4.17 -    "docs/man/Makefile") CONFIG_FILES="$CONFIG_FILES docs/man/Makefile" ;;
    4.18 -    "docs/xml/Makefile") CONFIG_FILES="$CONFIG_FILES docs/xml/Makefile" ;;
    4.19      "tests/Makefile") CONFIG_FILES="$CONFIG_FILES tests/Makefile" ;;
    4.20      "src/Makefile") CONFIG_FILES="$CONFIG_FILES src/Makefile" ;;
    4.21      "src/base64/Makefile") CONFIG_FILES="$CONFIG_FILES src/base64/Makefile" ;;

     5.1 --- a/configure.ac	Fri Sep 26 21:26:36 2008 +0200
     5.2 +++ b/configure.ac	Fri Sep 26 21:40:10 2008 +0200
     5.3 @@ -289,9 +289,6 @@
     5.4  
     5.5  AC_OUTPUT(Makefile \
     5.6  	debian/Makefile \
     5.7 -	docs/Makefile \
     5.8 -	docs/man/Makefile \
     5.9 -	docs/xml/Makefile \
    5.10  	tests/Makefile \
    5.11  	src/Makefile \
    5.12  	src/base64/Makefile \

     6.1 --- a/docs/Makefile.am	Fri Sep 26 21:26:36 2008 +0200
     6.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     6.3 @@ -1,46 +0,0 @@
     6.4 -SUBDIRS=man xml
     6.5 -
     6.6 -man: man/masqmail.8 man/mservdetect.8 man/masqmail.conf.5 man/masqmail.route.5 man/masqmail.get.5 man/masqmail.aliases.5
     6.7 -
     6.8 -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
     6.9 -
    6.10 -man/masqmail.8:	xml/masqmail.8.xml
    6.11 -	xmltoman $< >$@
    6.12 -
    6.13 -man/mservdetect.8:	xml/mservdetect.8.xml
    6.14 -	xmltoman $< >$@
    6.15 -
    6.16 -man/masqmail.conf.5:	xml/masqmail.conf.5.xml
    6.17 -	xmltoman $< >$@
    6.18 -
    6.19 -man/masqmail.route.5:	xml/masqmail.route.5.xml
    6.20 -	xmltoman $< >$@
    6.21 -
    6.22 -man/masqmail.get.5:	xml/masqmail.get.5.xml
    6.23 -	xmltoman $< >$@
    6.24 -
    6.25 -man/masqmail.aliases.5:	xml/masqmail.aliases.5.xml
    6.26 -	xmltoman $< >$@
    6.27 -
    6.28 -
    6.29 -html/masqmail.8.html:	xml/masqmail.8.xml
    6.30 -	xmlmantohtml $< >$@
    6.31 -
    6.32 -html/mservdetect.8.html:	xml/mservdetect.8.xml
    6.33 -	xmlmantohtml $< >$@
    6.34 -
    6.35 -html/masqmail.conf.5.html:	xml/masqmail.conf.5.xml
    6.36 -	xmlmantohtml $< >$@
    6.37 -
    6.38 -html/masqmail.route.5.html:	xml/masqmail.route.5.xml
    6.39 -	xmlmantohtml $< >$@
    6.40 -
    6.41 -html/masqmail.get.5.html:	xml/masqmail.get.5.xml
    6.42 -	xmlmantohtml $< >$@
    6.43 -
    6.44 -html/masqmail.aliases.5.html:	xml/masqmail.aliases.5.xml
    6.45 -	xmlmantohtml $< >$@
    6.46 -
    6.47 -#clean:
    6.48 -#	rm -f man/*.[58]
    6.49 -#	rm -r html/*.html

     7.1 --- a/docs/Makefile.in	Fri Sep 26 21:26:36 2008 +0200
     7.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     7.3 @@ -1,459 +0,0 @@
     7.4 -# Makefile.in generated by automake 1.7.9 from Makefile.am.
     7.5 -# @configure_input@
     7.6 -
     7.7 -# Copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
     7.8 -# Free Software Foundation, Inc.
     7.9 -# This Makefile.in is free software; the Free Software Foundation
    7.10 -# gives unlimited permission to copy and/or distribute it,
    7.11 -# with or without modifications, as long as this notice is preserved.
    7.12 -
    7.13 -# This program is distributed in the hope that it will be useful,
    7.14 -# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
    7.15 -# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
    7.16 -# PARTICULAR PURPOSE.
    7.17 -
    7.18 -@SET_MAKE@
    7.19 -
    7.20 -srcdir = @srcdir@
    7.21 -top_srcdir = @top_srcdir@
    7.22 -VPATH = @srcdir@
    7.23 -pkgdatadir = $(datadir)/@PACKAGE@
    7.24 -pkglibdir = $(libdir)/@PACKAGE@
    7.25 -pkgincludedir = $(includedir)/@PACKAGE@
    7.26 -top_builddir = ..
    7.27 -
    7.28 -am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
    7.29 -INSTALL = @INSTALL@
    7.30 -install_sh_DATA = $(install_sh) -c -m 644
    7.31 -install_sh_PROGRAM = $(install_sh) -c
    7.32 -install_sh_SCRIPT = $(install_sh) -c
    7.33 -INSTALL_HEADER = $(INSTALL_DATA)
    7.34 -transform = $(program_transform_name)
    7.35 -NORMAL_INSTALL = :
    7.36 -PRE_INSTALL = :
    7.37 -POST_INSTALL = :
    7.38 -NORMAL_UNINSTALL = :
    7.39 -PRE_UNINSTALL = :
    7.40 -POST_UNINSTALL = :
    7.41 -ACLOCAL = @ACLOCAL@
    7.42 -AMDEP_FALSE = @AMDEP_FALSE@
    7.43 -AMDEP_TRUE = @AMDEP_TRUE@
    7.44 -AMTAR = @AMTAR@
    7.45 -AUTOCONF = @AUTOCONF@
    7.46 -AUTOHEADER = @AUTOHEADER@
    7.47 -AUTOMAKE = @AUTOMAKE@
    7.48 -AWK = @AWK@
    7.49 -BASE64_LIBS = @BASE64_LIBS@
    7.50 -CC = @CC@
    7.51 -CCDEPMODE = @CCDEPMODE@
    7.52 -CFLAGS = @CFLAGS@
    7.53 -CPP = @CPP@
    7.54 -CPPFLAGS = @CPPFLAGS@
    7.55 -CYGPATH_W = @CYGPATH_W@
    7.56 -DEFS = @DEFS@
    7.57 -DEPDIR = @DEPDIR@
    7.58 -ECHO_C = @ECHO_C@
    7.59 -ECHO_N = @ECHO_N@
    7.60 -ECHO_T = @ECHO_T@
    7.61 -EGREP = @EGREP@
    7.62 -EXEEXT = @EXEEXT@
    7.63 -GLIB_CFLAGS = @GLIB_CFLAGS@
    7.64 -GLIB_LIBS = @GLIB_LIBS@
    7.65 -GREP = @GREP@
    7.66 -IDENT_LIBS = @IDENT_LIBS@
    7.67 -INSTALL_DATA = @INSTALL_DATA@
    7.68 -INSTALL_PROGRAM = @INSTALL_PROGRAM@
    7.69 -INSTALL_SCRIPT = @INSTALL_SCRIPT@
    7.70 -INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
    7.71 -LDFLAGS = @LDFLAGS@
    7.72 -LIBOBJS = @LIBOBJS@
    7.73 -LIBS = @LIBS@
    7.74 -LOCKFILE_LIBS = @LOCKFILE_LIBS@
    7.75 -LTLIBOBJS = @LTLIBOBJS@
    7.76 -MAKEINFO = @MAKEINFO@
    7.77 -MD5_LIBS = @MD5_LIBS@
    7.78 -OBJEXT = @OBJEXT@
    7.79 -PACKAGE = @PACKAGE@
    7.80 -PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
    7.81 -PACKAGE_NAME = @PACKAGE_NAME@
    7.82 -PACKAGE_STRING = @PACKAGE_STRING@
    7.83 -PACKAGE_TARNAME = @PACKAGE_TARNAME@
    7.84 -PACKAGE_VERSION = @PACKAGE_VERSION@
    7.85 -PATH_SEPARATOR = @PATH_SEPARATOR@
    7.86 -PKG_CONFIG = @PKG_CONFIG@
    7.87 -RANLIB = @RANLIB@
    7.88 -RESOLV_LIBS = @RESOLV_LIBS@
    7.89 -SET_MAKE = @SET_MAKE@
    7.90 -SHELL = @SHELL@
    7.91 -STRIP = @STRIP@
    7.92 -USE_LIBLOCKFILE = @USE_LIBLOCKFILE@
    7.93 -VERSION = @VERSION@
    7.94 -ac_ct_CC = @ac_ct_CC@
    7.95 -am__fastdepCC_FALSE = @am__fastdepCC_FALSE@
    7.96 -am__fastdepCC_TRUE = @am__fastdepCC_TRUE@
    7.97 -am__include = @am__include@
    7.98 -am__leading_dot = @am__leading_dot@
    7.99 -am__quote = @am__quote@
   7.100 -bindir = @bindir@
   7.101 -build_alias = @build_alias@
   7.102 -datadir = @datadir@
   7.103 -datarootdir = @datarootdir@
   7.104 -docdir = @docdir@
   7.105 -dvidir = @dvidir@
   7.106 -exec_prefix = @exec_prefix@
   7.107 -has_ident = @has_ident@
   7.108 -host_alias = @host_alias@
   7.109 -htmldir = @htmldir@
   7.110 -includedir = @includedir@
   7.111 -infodir = @infodir@
   7.112 -install_sh = @install_sh@
   7.113 -libdir = @libdir@
   7.114 -libexecdir = @libexecdir@
   7.115 -localedir = @localedir@
   7.116 -localstatedir = @localstatedir@
   7.117 -mandir = @mandir@
   7.118 -oldincludedir = @oldincludedir@
   7.119 -pdfdir = @pdfdir@
   7.120 -prefix = @prefix@
   7.121 -program_transform_name = @program_transform_name@
   7.122 -psdir = @psdir@
   7.123 -sbindir = @sbindir@
   7.124 -sharedstatedir = @sharedstatedir@
   7.125 -sysconfdir = @sysconfdir@
   7.126 -target_alias = @target_alias@
   7.127 -with_confdir = @with_confdir@
   7.128 -with_group = @with_group@
   7.129 -with_logdir = @with_logdir@
   7.130 -with_spooldir = @with_spooldir@
   7.131 -with_user = @with_user@
   7.132 -SUBDIRS = man xml
   7.133 -subdir = docs
   7.134 -ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
   7.135 -mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
   7.136 -CONFIG_HEADER = $(top_builddir)/config.h
   7.137 -CONFIG_CLEAN_FILES =
   7.138 -DIST_SOURCES =
   7.139 -
   7.140 -RECURSIVE_TARGETS = info-recursive dvi-recursive pdf-recursive \
   7.141 -	ps-recursive install-info-recursive uninstall-info-recursive \
   7.142 -	all-recursive install-data-recursive install-exec-recursive \
   7.143 -	installdirs-recursive install-recursive uninstall-recursive \
   7.144 -	check-recursive installcheck-recursive
   7.145 -DIST_COMMON = README $(srcdir)/Makefile.in Makefile.am
   7.146 -DIST_SUBDIRS = $(SUBDIRS)
   7.147 -all: all-recursive
   7.148 -
   7.149 -.SUFFIXES:
   7.150 -$(srcdir)/Makefile.in:  Makefile.am  $(top_srcdir)/configure.ac $(ACLOCAL_M4)
   7.151 -	cd $(top_srcdir) && \
   7.152 -	  $(AUTOMAKE) --gnu  docs/Makefile
   7.153 -Makefile:  $(srcdir)/Makefile.in  $(top_builddir)/config.status
   7.154 -	cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)
   7.155 -uninstall-info-am:
   7.156 -
   7.157 -# This directory's subdirectories are mostly independent; you can cd
   7.158 -# into them and run `make' without going through this Makefile.
   7.159 -# To change the values of `make' variables: instead of editing Makefiles,
   7.160 -# (1) if the variable is set in `config.status', edit `config.status'
   7.161 -#     (which will cause the Makefiles to be regenerated when you run `make');
   7.162 -# (2) otherwise, pass the desired values on the `make' command line.
   7.163 -$(RECURSIVE_TARGETS):
   7.164 -	@set fnord $$MAKEFLAGS; amf=$$2; \
   7.165 -	dot_seen=no; \
   7.166 -	target=`echo $@ | sed s/-recursive//`; \
   7.167 -	list='$(SUBDIRS)'; for subdir in $$list; do \
   7.168 -	  echo "Making $$target in $$subdir"; \
   7.169 -	  if test "$$subdir" = "."; then \
   7.170 -	    dot_seen=yes; \
   7.171 -	    local_target="$$target-am"; \
   7.172 -	  else \
   7.173 -	    local_target="$$target"; \
   7.174 -	  fi; \
   7.175 -	  (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \
   7.176 -	   || case "$$amf" in *=*) exit 1;; *k*) fail=yes;; *) exit 1;; esac; \
   7.177 -	done; \
   7.178 -	if test "$$dot_seen" = "no"; then \
   7.179 -	  $(MAKE) $(AM_MAKEFLAGS) "$$target-am" || exit 1; \
   7.180 -	fi; test -z "$$fail"
   7.181 -
   7.182 -mostlyclean-recursive clean-recursive distclean-recursive \
   7.183 -maintainer-clean-recursive:
   7.184 -	@set fnord $$MAKEFLAGS; amf=$$2; \
   7.185 -	dot_seen=no; \
   7.186 -	case "$@" in \
   7.187 -	  distclean-* | maintainer-clean-*) list='$(DIST_SUBDIRS)' ;; \
   7.188 -	  *) list='$(SUBDIRS)' ;; \
   7.189 -	esac; \
   7.190 -	rev=''; for subdir in $$list; do \
   7.191 -	  if test "$$subdir" = "."; then :; else \
   7.192 -	    rev="$$subdir $$rev"; \
   7.193 -	  fi; \
   7.194 -	done; \
   7.195 -	rev="$$rev ."; \
   7.196 -	target=`echo $@ | sed s/-recursive//`; \
   7.197 -	for subdir in $$rev; do \
   7.198 -	  echo "Making $$target in $$subdir"; \
   7.199 -	  if test "$$subdir" = "."; then \
   7.200 -	    local_target="$$target-am"; \
   7.201 -	  else \
   7.202 -	    local_target="$$target"; \
   7.203 -	  fi; \
   7.204 -	  (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) $$local_target) \
   7.205 -	   || case "$$amf" in *=*) exit 1;; *k*) fail=yes;; *) exit 1;; esac; \
   7.206 -	done && test -z "$$fail"
   7.207 -tags-recursive:
   7.208 -	list='$(SUBDIRS)'; for subdir in $$list; do \
   7.209 -	  test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) tags); \
   7.210 -	done
   7.211 -ctags-recursive:
   7.212 -	list='$(SUBDIRS)'; for subdir in $$list; do \
   7.213 -	  test "$$subdir" = . || (cd $$subdir && $(MAKE) $(AM_MAKEFLAGS) ctags); \
   7.214 -	done
   7.215 -
   7.216 -ETAGS = etags
   7.217 -ETAGSFLAGS =
   7.218 -
   7.219 -CTAGS = ctags
   7.220 -CTAGSFLAGS =
   7.221 -
   7.222 -tags: TAGS
   7.223 -
   7.224 -ID: $(HEADERS) $(SOURCES) $(LISP) $(TAGS_FILES)
   7.225 -	list='$(SOURCES) $(HEADERS) $(LISP) $(TAGS_FILES)'; \
   7.226 -	unique=`for i in $$list; do \
   7.227 -	    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
   7.228 -	  done | \
   7.229 -	  $(AWK) '    { files[$$0] = 1; } \
   7.230 -	       END { for (i in files) print i; }'`; \
   7.231 -	mkid -fID $$unique
   7.232 -
   7.233 -TAGS: tags-recursive $(HEADERS) $(SOURCES)  $(TAGS_DEPENDENCIES) \
   7.234 -		$(TAGS_FILES) $(LISP)
   7.235 -	tags=; \
   7.236 -	here=`pwd`; \
   7.237 -	if (etags --etags-include --version) >/dev/null 2>&1; then \
   7.238 -	  include_option=--etags-include; \
   7.239 -	else \
   7.240 -	  include_option=--include; \
   7.241 -	fi; \
   7.242 -	list='$(SUBDIRS)'; for subdir in $$list; do \
   7.243 -	  if test "$$subdir" = .; then :; else \
   7.244 -	    test -f $$subdir/TAGS && \
   7.245 -	      tags="$$tags $$include_option=$$here/$$subdir/TAGS"; \
   7.246 -	  fi; \
   7.247 -	done; \
   7.248 -	list='$(SOURCES) $(HEADERS)  $(LISP) $(TAGS_FILES)'; \
   7.249 -	unique=`for i in $$list; do \
   7.250 -	    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
   7.251 -	  done | \
   7.252 -	  $(AWK) '    { files[$$0] = 1; } \
   7.253 -	       END { for (i in files) print i; }'`; \
   7.254 -	test -z "$(ETAGS_ARGS)$$tags$$unique" \
   7.255 -	  || $(ETAGS) $(ETAGSFLAGS) $(AM_ETAGSFLAGS) $(ETAGS_ARGS) \
   7.256 -	     $$tags $$unique
   7.257 -
   7.258 -ctags: CTAGS
   7.259 -CTAGS: ctags-recursive $(HEADERS) $(SOURCES)  $(TAGS_DEPENDENCIES) \
   7.260 -		$(TAGS_FILES) $(LISP)
   7.261 -	tags=; \
   7.262 -	here=`pwd`; \
   7.263 -	list='$(SOURCES) $(HEADERS)  $(LISP) $(TAGS_FILES)'; \
   7.264 -	unique=`for i in $$list; do \
   7.265 -	    if test -f "$$i"; then echo $$i; else echo $(srcdir)/$$i; fi; \
   7.266 -	  done | \
   7.267 -	  $(AWK) '    { files[$$0] = 1; } \
   7.268 -	       END { for (i in files) print i; }'`; \
   7.269 -	test -z "$(CTAGS_ARGS)$$tags$$unique" \
   7.270 -	  || $(CTAGS) $(CTAGSFLAGS) $(AM_CTAGSFLAGS) $(CTAGS_ARGS) \
   7.271 -	     $$tags $$unique
   7.272 -
   7.273 -GTAGS:
   7.274 -	here=`$(am__cd) $(top_builddir) && pwd` \
   7.275 -	  && cd $(top_srcdir) \
   7.276 -	  && gtags -i $(GTAGS_ARGS) $$here
   7.277 -
   7.278 -distclean-tags:
   7.279 -	-rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags
   7.280 -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
   7.281 -
   7.282 -top_distdir = ..
   7.283 -distdir = $(top_distdir)/$(PACKAGE)-$(VERSION)
   7.284 -
   7.285 -distdir: $(DISTFILES)
   7.286 -	@srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \
   7.287 -	topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \
   7.288 -	list='$(DISTFILES)'; for file in $$list; do \
   7.289 -	  case $$file in \
   7.290 -	    $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \
   7.291 -	    $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \
   7.292 -	  esac; \
   7.293 -	  if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
   7.294 -	  dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \
   7.295 -	  if test "$$dir" != "$$file" && test "$$dir" != "."; then \
   7.296 -	    dir="/$$dir"; \
   7.297 -	    $(mkinstalldirs) "$(distdir)$$dir"; \
   7.298 -	  else \
   7.299 -	    dir=''; \
   7.300 -	  fi; \
   7.301 -	  if test -d $$d/$$file; then \
   7.302 -	    if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
   7.303 -	      cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \
   7.304 -	    fi; \
   7.305 -	    cp -pR $$d/$$file $(distdir)$$dir || exit 1; \
   7.306 -	  else \
   7.307 -	    test -f $(distdir)/$$file \
   7.308 -	    || cp -p $$d/$$file $(distdir)/$$file \
   7.309 -	    || exit 1; \
   7.310 -	  fi; \
   7.311 -	done
   7.312 -	list='$(SUBDIRS)'; for subdir in $$list; do \
   7.313 -	  if test "$$subdir" = .; then :; else \
   7.314 -	    test -d $(distdir)/$$subdir \
   7.315 -	    || mkdir $(distdir)/$$subdir \
   7.316 -	    || exit 1; \
   7.317 -	    (cd $$subdir && \
   7.318 -	      $(MAKE) $(AM_MAKEFLAGS) \
   7.319 -	        top_distdir="$(top_distdir)" \
   7.320 -	        distdir=../$(distdir)/$$subdir \
   7.321 -	        distdir) \
   7.322 -	      || exit 1; \
   7.323 -	  fi; \
   7.324 -	done
   7.325 -check-am: all-am
   7.326 -check: check-recursive
   7.327 -all-am: Makefile
   7.328 -installdirs: installdirs-recursive
   7.329 -installdirs-am:
   7.330 -
   7.331 -install: install-recursive
   7.332 -install-exec: install-exec-recursive
   7.333 -install-data: install-data-recursive
   7.334 -uninstall: uninstall-recursive
   7.335 -
   7.336 -install-am: all-am
   7.337 -	@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
   7.338 -
   7.339 -installcheck: installcheck-recursive
   7.340 -install-strip:
   7.341 -	$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
   7.342 -	  install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
   7.343 -	  `test -z '$(STRIP)' || \
   7.344 -	    echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
   7.345 -mostlyclean-generic:
   7.346 -
   7.347 -clean-generic:
   7.348 -
   7.349 -distclean-generic:
   7.350 -	-rm -f $(CONFIG_CLEAN_FILES)
   7.351 -
   7.352 -maintainer-clean-generic:
   7.353 -	@echo "This command is intended for maintainers to use"
   7.354 -	@echo "it deletes files that may require special tools to rebuild."
   7.355 -clean: clean-recursive
   7.356 -
   7.357 -clean-am: clean-generic mostlyclean-am
   7.358 -
   7.359 -distclean: distclean-recursive
   7.360 -	-rm -f Makefile
   7.361 -distclean-am: clean-am distclean-generic distclean-tags
   7.362 -
   7.363 -dvi: dvi-recursive
   7.364 -
   7.365 -dvi-am:
   7.366 -
   7.367 -info: info-recursive
   7.368 -
   7.369 -info-am:
   7.370 -
   7.371 -install-data-am:
   7.372 -
   7.373 -install-exec-am:
   7.374 -
   7.375 -install-info: install-info-recursive
   7.376 -
   7.377 -install-man:
   7.378 -
   7.379 -installcheck-am:
   7.380 -
   7.381 -maintainer-clean: maintainer-clean-recursive
   7.382 -	-rm -f Makefile
   7.383 -maintainer-clean-am: distclean-am maintainer-clean-generic
   7.384 -
   7.385 -mostlyclean: mostlyclean-recursive
   7.386 -
   7.387 -mostlyclean-am: mostlyclean-generic
   7.388 -
   7.389 -pdf: pdf-recursive
   7.390 -
   7.391 -pdf-am:
   7.392 -
   7.393 -ps: ps-recursive
   7.394 -
   7.395 -ps-am:
   7.396 -
   7.397 -uninstall-am: uninstall-info-am
   7.398 -
   7.399 -uninstall-info: uninstall-info-recursive
   7.400 -
   7.401 -.PHONY: $(RECURSIVE_TARGETS) CTAGS GTAGS all all-am check check-am clean \
   7.402 -	clean-generic clean-recursive ctags ctags-recursive distclean \
   7.403 -	distclean-generic distclean-recursive distclean-tags distdir \
   7.404 -	dvi dvi-am dvi-recursive info info-am info-recursive install \
   7.405 -	install-am install-data install-data-am install-data-recursive \
   7.406 -	install-exec install-exec-am install-exec-recursive \
   7.407 -	install-info install-info-am install-info-recursive install-man \
   7.408 -	install-recursive install-strip installcheck installcheck-am \
   7.409 -	installdirs installdirs-am installdirs-recursive \
   7.410 -	maintainer-clean maintainer-clean-generic \
   7.411 -	maintainer-clean-recursive mostlyclean mostlyclean-generic \
   7.412 -	mostlyclean-recursive pdf pdf-am pdf-recursive ps ps-am \
   7.413 -	ps-recursive tags tags-recursive uninstall uninstall-am \
   7.414 -	uninstall-info-am uninstall-info-recursive uninstall-recursive
   7.415 -
   7.416 -
   7.417 -man: man/masqmail.8 man/mservdetect.8 man/masqmail.conf.5 man/masqmail.route.5 man/masqmail.get.5 man/masqmail.aliases.5
   7.418 -
   7.419 -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
   7.420 -
   7.421 -man/masqmail.8:	xml/masqmail.8.xml
   7.422 -	xmltoman $< >$@
   7.423 -
   7.424 -man/mservdetect.8:	xml/mservdetect.8.xml
   7.425 -	xmltoman $< >$@
   7.426 -
   7.427 -man/masqmail.conf.5:	xml/masqmail.conf.5.xml
   7.428 -	xmltoman $< >$@
   7.429 -
   7.430 -man/masqmail.route.5:	xml/masqmail.route.5.xml
   7.431 -	xmltoman $< >$@
   7.432 -
   7.433 -man/masqmail.get.5:	xml/masqmail.get.5.xml
   7.434 -	xmltoman $< >$@
   7.435 -
   7.436 -man/masqmail.aliases.5:	xml/masqmail.aliases.5.xml
   7.437 -	xmltoman $< >$@
   7.438 -
   7.439 -html/masqmail.8.html:	xml/masqmail.8.xml
   7.440 -	xmlmantohtml $< >$@
   7.441 -
   7.442 -html/mservdetect.8.html:	xml/mservdetect.8.xml
   7.443 -	xmlmantohtml $< >$@
   7.444 -
   7.445 -html/masqmail.conf.5.html:	xml/masqmail.conf.5.xml
   7.446 -	xmlmantohtml $< >$@
   7.447 -
   7.448 -html/masqmail.route.5.html:	xml/masqmail.route.5.xml
   7.449 -	xmlmantohtml $< >$@
   7.450 -
   7.451 -html/masqmail.get.5.html:	xml/masqmail.get.5.xml
   7.452 -	xmlmantohtml $< >$@
   7.453 -
   7.454 -html/masqmail.aliases.5.html:	xml/masqmail.aliases.5.xml
   7.455 -	xmlmantohtml $< >$@
   7.456 -
   7.457 -#clean:
   7.458 -#	rm -f man/*.[58]
   7.459 -#	rm -r html/*.html
   7.460 -# Tell versions [3.59,3.63) of GNU make to not export all variables.
   7.461 -# Otherwise a system limit (for SysV at least) may be exceeded.
   7.462 -.NOEXPORT:

     8.1 --- a/docs/README	Fri Sep 26 21:26:36 2008 +0200
     8.2 +++ b/docs/README	Fri Sep 26 21:40:10 2008 +0200
     8.3 @@ -1,11 +1,2 @@
     8.4 -Since version 0.1.1 the documentation within the masqmail package is
     8.5 -in man pages. The source is in in xml, the xml sources can be
     8.6 -converted to man pages or html pages with the perl scripts xml2man and
     8.7 -xmlman2html.
     8.8 -
     8.9 -The xml sources are availabe in another package.
    8.10 -
    8.11 -The perl scripts will be available at http://masqmail.cx/xml2man/
    8.12 -
    8.13 -If you want to conribute to the documentation, please use the xml
    8.14 -sources, changes in html or man pages will be lost.
    8.15 +Since masqmail-0.3, documentation is maintained in troff (man page) format.
    8.16 +The old XML sources are no longer used.

     9.1 --- a/docs/man/Makefile.am	Fri Sep 26 21:26:36 2008 +0200
     9.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     9.3 @@ -1,1 +0,0 @@
     9.4 -man_MANS=masqmail.8 mservdetect.8 masqmail.conf.5 masqmail.route.5 masqmail.get.5 masqmail.aliases.5
     9.5 \ No newline at end of file

    10.1 --- a/docs/man/Makefile.in	Fri Sep 26 21:26:36 2008 +0200
    10.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    10.3 @@ -1,369 +0,0 @@
    10.4 -# Makefile.in generated by automake 1.7.9 from Makefile.am.
    10.5 -# @configure_input@
    10.6 -
    10.7 -# Copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
    10.8 -# Free Software Foundation, Inc.
    10.9 -# This Makefile.in is free software; the Free Software Foundation
   10.10 -# gives unlimited permission to copy and/or distribute it,
   10.11 -# with or without modifications, as long as this notice is preserved.
   10.12 -
   10.13 -# This program is distributed in the hope that it will be useful,
   10.14 -# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
   10.15 -# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
   10.16 -# PARTICULAR PURPOSE.
   10.17 -
   10.18 -@SET_MAKE@
   10.19 -
   10.20 -srcdir = @srcdir@
   10.21 -top_srcdir = @top_srcdir@
   10.22 -VPATH = @srcdir@
   10.23 -pkgdatadir = $(datadir)/@PACKAGE@
   10.24 -pkglibdir = $(libdir)/@PACKAGE@
   10.25 -pkgincludedir = $(includedir)/@PACKAGE@
   10.26 -top_builddir = ../..
   10.27 -
   10.28 -am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
   10.29 -INSTALL = @INSTALL@
   10.30 -install_sh_DATA = $(install_sh) -c -m 644
   10.31 -install_sh_PROGRAM = $(install_sh) -c
   10.32 -install_sh_SCRIPT = $(install_sh) -c
   10.33 -INSTALL_HEADER = $(INSTALL_DATA)
   10.34 -transform = $(program_transform_name)
   10.35 -NORMAL_INSTALL = :
   10.36 -PRE_INSTALL = :
   10.37 -POST_INSTALL = :
   10.38 -NORMAL_UNINSTALL = :
   10.39 -PRE_UNINSTALL = :
   10.40 -POST_UNINSTALL = :
   10.41 -ACLOCAL = @ACLOCAL@
   10.42 -AMDEP_FALSE = @AMDEP_FALSE@
   10.43 -AMDEP_TRUE = @AMDEP_TRUE@
   10.44 -AMTAR = @AMTAR@
   10.45 -AUTOCONF = @AUTOCONF@
   10.46 -AUTOHEADER = @AUTOHEADER@
   10.47 -AUTOMAKE = @AUTOMAKE@
   10.48 -AWK = @AWK@
   10.49 -BASE64_LIBS = @BASE64_LIBS@
   10.50 -CC = @CC@
   10.51 -CCDEPMODE = @CCDEPMODE@
   10.52 -CFLAGS = @CFLAGS@
   10.53 -CPP = @CPP@
   10.54 -CPPFLAGS = @CPPFLAGS@
   10.55 -CYGPATH_W = @CYGPATH_W@
   10.56 -DEFS = @DEFS@
   10.57 -DEPDIR = @DEPDIR@
   10.58 -ECHO_C = @ECHO_C@
   10.59 -ECHO_N = @ECHO_N@
   10.60 -ECHO_T = @ECHO_T@
   10.61 -EGREP = @EGREP@
   10.62 -EXEEXT = @EXEEXT@
   10.63 -GLIB_CFLAGS = @GLIB_CFLAGS@
   10.64 -GLIB_LIBS = @GLIB_LIBS@
   10.65 -GREP = @GREP@
   10.66 -IDENT_LIBS = @IDENT_LIBS@
   10.67 -INSTALL_DATA = @INSTALL_DATA@
   10.68 -INSTALL_PROGRAM = @INSTALL_PROGRAM@
   10.69 -INSTALL_SCRIPT = @INSTALL_SCRIPT@
   10.70 -INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
   10.71 -LDFLAGS = @LDFLAGS@
   10.72 -LIBOBJS = @LIBOBJS@
   10.73 -LIBS = @LIBS@
   10.74 -LOCKFILE_LIBS = @LOCKFILE_LIBS@
   10.75 -LTLIBOBJS = @LTLIBOBJS@
   10.76 -MAKEINFO = @MAKEINFO@
   10.77 -MD5_LIBS = @MD5_LIBS@
   10.78 -OBJEXT = @OBJEXT@
   10.79 -PACKAGE = @PACKAGE@
   10.80 -PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
   10.81 -PACKAGE_NAME = @PACKAGE_NAME@
   10.82 -PACKAGE_STRING = @PACKAGE_STRING@
   10.83 -PACKAGE_TARNAME = @PACKAGE_TARNAME@
   10.84 -PACKAGE_VERSION = @PACKAGE_VERSION@
   10.85 -PATH_SEPARATOR = @PATH_SEPARATOR@
   10.86 -PKG_CONFIG = @PKG_CONFIG@
   10.87 -RANLIB = @RANLIB@
   10.88 -RESOLV_LIBS = @RESOLV_LIBS@
   10.89 -SET_MAKE = @SET_MAKE@
   10.90 -SHELL = @SHELL@
   10.91 -STRIP = @STRIP@
   10.92 -USE_LIBLOCKFILE = @USE_LIBLOCKFILE@
   10.93 -VERSION = @VERSION@
   10.94 -ac_ct_CC = @ac_ct_CC@
   10.95 -am__fastdepCC_FALSE = @am__fastdepCC_FALSE@
   10.96 -am__fastdepCC_TRUE = @am__fastdepCC_TRUE@
   10.97 -am__include = @am__include@
   10.98 -am__leading_dot = @am__leading_dot@
   10.99 -am__quote = @am__quote@
  10.100 -bindir = @bindir@
  10.101 -build_alias = @build_alias@
  10.102 -datadir = @datadir@
  10.103 -datarootdir = @datarootdir@
  10.104 -docdir = @docdir@
  10.105 -dvidir = @dvidir@
  10.106 -exec_prefix = @exec_prefix@
  10.107 -has_ident = @has_ident@
  10.108 -host_alias = @host_alias@
  10.109 -htmldir = @htmldir@
  10.110 -includedir = @includedir@
  10.111 -infodir = @infodir@
  10.112 -install_sh = @install_sh@
  10.113 -libdir = @libdir@
  10.114 -libexecdir = @libexecdir@
  10.115 -localedir = @localedir@
  10.116 -localstatedir = @localstatedir@
  10.117 -mandir = @mandir@
  10.118 -oldincludedir = @oldincludedir@
  10.119 -pdfdir = @pdfdir@
  10.120 -prefix = @prefix@
  10.121 -program_transform_name = @program_transform_name@
  10.122 -psdir = @psdir@
  10.123 -sbindir = @sbindir@
  10.124 -sharedstatedir = @sharedstatedir@
  10.125 -sysconfdir = @sysconfdir@
  10.126 -target_alias = @target_alias@
  10.127 -with_confdir = @with_confdir@
  10.128 -with_group = @with_group@
  10.129 -with_logdir = @with_logdir@
  10.130 -with_spooldir = @with_spooldir@
  10.131 -with_user = @with_user@
  10.132 -man_MANS = masqmail.8 mservdetect.8 masqmail.conf.5 masqmail.route.5 masqmail.get.5 masqmail.aliases.5
  10.133 -subdir = docs/man
  10.134 -ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
  10.135 -mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
  10.136 -CONFIG_HEADER = $(top_builddir)/config.h
  10.137 -CONFIG_CLEAN_FILES =
  10.138 -DIST_SOURCES =
  10.139 -
  10.140 -NROFF = nroff
  10.141 -MANS = $(man_MANS)
  10.142 -DIST_COMMON = $(srcdir)/Makefile.in Makefile.am
  10.143 -all: all-am
  10.144 -
  10.145 -.SUFFIXES:
  10.146 -$(srcdir)/Makefile.in:  Makefile.am  $(top_srcdir)/configure.ac $(ACLOCAL_M4)
  10.147 -	cd $(top_srcdir) && \
  10.148 -	  $(AUTOMAKE) --gnu  docs/man/Makefile
  10.149 -Makefile:  $(srcdir)/Makefile.in  $(top_builddir)/config.status
  10.150 -	cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)
  10.151 -uninstall-info-am:
  10.152 -
  10.153 -man5dir = $(mandir)/man5
  10.154 -install-man5: $(man5_MANS) $(man_MANS)
  10.155 -	@$(NORMAL_INSTALL)
  10.156 -	$(mkinstalldirs) $(DESTDIR)$(man5dir)
  10.157 -	@list='$(man5_MANS) $(dist_man5_MANS) $(nodist_man5_MANS)'; \
  10.158 -	l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \
  10.159 -	for i in $$l2; do \
  10.160 -	  case "$$i" in \
  10.161 -	    *.5*) list="$$list $$i" ;; \
  10.162 -	  esac; \
  10.163 -	done; \
  10.164 -	for i in $$list; do \
  10.165 -	  if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \
  10.166 -	  else file=$$i; fi; \
  10.167 -	  ext=`echo $$i | sed -e 's/^.*\\.//'`; \
  10.168 -	  case "$$ext" in \
  10.169 -	    5*) ;; \
  10.170 -	    *) ext='5' ;; \
  10.171 -	  esac; \
  10.172 -	  inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
  10.173 -	  inst=`echo $$inst | sed -e 's/^.*\///'`; \
  10.174 -	  inst=`echo $$inst | sed '$(transform)'`.$$ext; \
  10.175 -	  echo " $(INSTALL_DATA) $$file $(DESTDIR)$(man5dir)/$$inst"; \
  10.176 -	  $(INSTALL_DATA) $$file $(DESTDIR)$(man5dir)/$$inst; \
  10.177 -	done
  10.178 -uninstall-man5:
  10.179 -	@$(NORMAL_UNINSTALL)
  10.180 -	@list='$(man5_MANS) $(dist_man5_MANS) $(nodist_man5_MANS)'; \
  10.181 -	l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \
  10.182 -	for i in $$l2; do \
  10.183 -	  case "$$i" in \
  10.184 -	    *.5*) list="$$list $$i" ;; \
  10.185 -	  esac; \
  10.186 -	done; \
  10.187 -	for i in $$list; do \
  10.188 -	  ext=`echo $$i | sed -e 's/^.*\\.//'`; \
  10.189 -	  case "$$ext" in \
  10.190 -	    5*) ;; \
  10.191 -	    *) ext='5' ;; \
  10.192 -	  esac; \
  10.193 -	  inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
  10.194 -	  inst=`echo $$inst | sed -e 's/^.*\///'`; \
  10.195 -	  inst=`echo $$inst | sed '$(transform)'`.$$ext; \
  10.196 -	  echo " rm -f $(DESTDIR)$(man5dir)/$$inst"; \
  10.197 -	  rm -f $(DESTDIR)$(man5dir)/$$inst; \
  10.198 -	done
  10.199 -
  10.200 -man8dir = $(mandir)/man8
  10.201 -install-man8: $(man8_MANS) $(man_MANS)
  10.202 -	@$(NORMAL_INSTALL)
  10.203 -	$(mkinstalldirs) $(DESTDIR)$(man8dir)
  10.204 -	@list='$(man8_MANS) $(dist_man8_MANS) $(nodist_man8_MANS)'; \
  10.205 -	l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \
  10.206 -	for i in $$l2; do \
  10.207 -	  case "$$i" in \
  10.208 -	    *.8*) list="$$list $$i" ;; \
  10.209 -	  esac; \
  10.210 -	done; \
  10.211 -	for i in $$list; do \
  10.212 -	  if test -f $(srcdir)/$$i; then file=$(srcdir)/$$i; \
  10.213 -	  else file=$$i; fi; \
  10.214 -	  ext=`echo $$i | sed -e 's/^.*\\.//'`; \
  10.215 -	  case "$$ext" in \
  10.216 -	    8*) ;; \
  10.217 -	    *) ext='8' ;; \
  10.218 -	  esac; \
  10.219 -	  inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
  10.220 -	  inst=`echo $$inst | sed -e 's/^.*\///'`; \
  10.221 -	  inst=`echo $$inst | sed '$(transform)'`.$$ext; \
  10.222 -	  echo " $(INSTALL_DATA) $$file $(DESTDIR)$(man8dir)/$$inst"; \
  10.223 -	  $(INSTALL_DATA) $$file $(DESTDIR)$(man8dir)/$$inst; \
  10.224 -	done
  10.225 -uninstall-man8:
  10.226 -	@$(NORMAL_UNINSTALL)
  10.227 -	@list='$(man8_MANS) $(dist_man8_MANS) $(nodist_man8_MANS)'; \
  10.228 -	l2='$(man_MANS) $(dist_man_MANS) $(nodist_man_MANS)'; \
  10.229 -	for i in $$l2; do \
  10.230 -	  case "$$i" in \
  10.231 -	    *.8*) list="$$list $$i" ;; \
  10.232 -	  esac; \
  10.233 -	done; \
  10.234 -	for i in $$list; do \
  10.235 -	  ext=`echo $$i | sed -e 's/^.*\\.//'`; \
  10.236 -	  case "$$ext" in \
  10.237 -	    8*) ;; \
  10.238 -	    *) ext='8' ;; \
  10.239 -	  esac; \
  10.240 -	  inst=`echo $$i | sed -e 's/\\.[0-9a-z]*$$//'`; \
  10.241 -	  inst=`echo $$inst | sed -e 's/^.*\///'`; \
  10.242 -	  inst=`echo $$inst | sed '$(transform)'`.$$ext; \
  10.243 -	  echo " rm -f $(DESTDIR)$(man8dir)/$$inst"; \
  10.244 -	  rm -f $(DESTDIR)$(man8dir)/$$inst; \
  10.245 -	done
  10.246 -tags: TAGS
  10.247 -TAGS:
  10.248 -
  10.249 -ctags: CTAGS
  10.250 -CTAGS:
  10.251 -
  10.252 -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
  10.253 -
  10.254 -top_distdir = ../..
  10.255 -distdir = $(top_distdir)/$(PACKAGE)-$(VERSION)
  10.256 -
  10.257 -distdir: $(DISTFILES)
  10.258 -	@srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \
  10.259 -	topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \
  10.260 -	list='$(DISTFILES)'; for file in $$list; do \
  10.261 -	  case $$file in \
  10.262 -	    $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \
  10.263 -	    $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \
  10.264 -	  esac; \
  10.265 -	  if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
  10.266 -	  dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \
  10.267 -	  if test "$$dir" != "$$file" && test "$$dir" != "."; then \
  10.268 -	    dir="/$$dir"; \
  10.269 -	    $(mkinstalldirs) "$(distdir)$$dir"; \
  10.270 -	  else \
  10.271 -	    dir=''; \
  10.272 -	  fi; \
  10.273 -	  if test -d $$d/$$file; then \
  10.274 -	    if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
  10.275 -	      cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \
  10.276 -	    fi; \
  10.277 -	    cp -pR $$d/$$file $(distdir)$$dir || exit 1; \
  10.278 -	  else \
  10.279 -	    test -f $(distdir)/$$file \
  10.280 -	    || cp -p $$d/$$file $(distdir)/$$file \
  10.281 -	    || exit 1; \
  10.282 -	  fi; \
  10.283 -	done
  10.284 -check-am: all-am
  10.285 -check: check-am
  10.286 -all-am: Makefile $(MANS)
  10.287 -
  10.288 -installdirs:
  10.289 -	$(mkinstalldirs) $(DESTDIR)$(man5dir) $(DESTDIR)$(man8dir)
  10.290 -install: install-am
  10.291 -install-exec: install-exec-am
  10.292 -install-data: install-data-am
  10.293 -uninstall: uninstall-am
  10.294 -
  10.295 -install-am: all-am
  10.296 -	@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
  10.297 -
  10.298 -installcheck: installcheck-am
  10.299 -install-strip:
  10.300 -	$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
  10.301 -	  install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
  10.302 -	  `test -z '$(STRIP)' || \
  10.303 -	    echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
  10.304 -mostlyclean-generic:
  10.305 -
  10.306 -clean-generic:
  10.307 -
  10.308 -distclean-generic:
  10.309 -	-rm -f $(CONFIG_CLEAN_FILES)
  10.310 -
  10.311 -maintainer-clean-generic:
  10.312 -	@echo "This command is intended for maintainers to use"
  10.313 -	@echo "it deletes files that may require special tools to rebuild."
  10.314 -clean: clean-am
  10.315 -
  10.316 -clean-am: clean-generic mostlyclean-am
  10.317 -
  10.318 -distclean: distclean-am
  10.319 -	-rm -f Makefile
  10.320 -distclean-am: clean-am distclean-generic
  10.321 -
  10.322 -dvi: dvi-am
  10.323 -
  10.324 -dvi-am:
  10.325 -
  10.326 -info: info-am
  10.327 -
  10.328 -info-am:
  10.329 -
  10.330 -install-data-am: install-man
  10.331 -
  10.332 -install-exec-am:
  10.333 -
  10.334 -install-info: install-info-am
  10.335 -
  10.336 -install-man: install-man5 install-man8
  10.337 -
  10.338 -installcheck-am:
  10.339 -
  10.340 -maintainer-clean: maintainer-clean-am
  10.341 -	-rm -f Makefile
  10.342 -maintainer-clean-am: distclean-am maintainer-clean-generic
  10.343 -
  10.344 -mostlyclean: mostlyclean-am
  10.345 -
  10.346 -mostlyclean-am: mostlyclean-generic
  10.347 -
  10.348 -pdf: pdf-am
  10.349 -
  10.350 -pdf-am:
  10.351 -
  10.352 -ps: ps-am
  10.353 -
  10.354 -ps-am:
  10.355 -
  10.356 -uninstall-am: uninstall-info-am uninstall-man
  10.357 -
  10.358 -uninstall-man: uninstall-man5 uninstall-man8
  10.359 -
  10.360 -.PHONY: all all-am check check-am clean clean-generic distclean \
  10.361 -	distclean-generic distdir dvi dvi-am info info-am install \
  10.362 -	install-am install-data install-data-am install-exec \
  10.363 -	install-exec-am install-info install-info-am install-man \
  10.364 -	install-man5 install-man8 install-strip installcheck \
  10.365 -	installcheck-am installdirs maintainer-clean \
  10.366 -	maintainer-clean-generic mostlyclean mostlyclean-generic pdf \
  10.367 -	pdf-am ps ps-am uninstall uninstall-am uninstall-info-am \
  10.368 -	uninstall-man uninstall-man5 uninstall-man8
  10.369 -
  10.370 -# Tell versions [3.59,3.63) of GNU make to not export all variables.
  10.371 -# Otherwise a system limit (for SysV at least) may be exceeded.
  10.372 -.NOEXPORT:

    11.1 --- a/docs/man/masqmail.8	Fri Sep 26 21:26:36 2008 +0200
    11.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    11.3 @@ -1,213 +0,0 @@
    11.4 -.TH masqmail 8 User Manuals
    11.5 -.SH NAME
    11.6 -masqmail \- An offline Mail Transfer Agent
    11.7 -.SH SYNOPSIS
    11.8 -\fB/usr/sbin/masqmail [-C \fIfile\f1\fB] [-odq] [-bd] [-q\fIinterval\f1\fB]
    11.9 -
   11.10 -\fB/usr/sbin/masqmail [-odq] [-bs]
   11.11 -
   11.12 -\fB/usr/sbin/masqmail [-bp]
   11.13 -
   11.14 -\fB/usr/sbin/masqmail [-q]
   11.15 -
   11.16 -\fB/usr/sbin/masqmail [-qo [\fIname\f1\fB]]
   11.17 -
   11.18 -\fB/usr/sbin/masqmail [-odq] [-g [\fIname\f1\fB]]
   11.19 -
   11.20 -\fB/usr/sbin/masqmail [-odq] [-go [\fIname\f1\fB]]
   11.21 -
   11.22 -\fB/usr/sbin/masqmail [-t] [-oi] [-f \fIaddress\f1\fB] [--] \fIaddress...\f1\fB
   11.23 -
   11.24 -\fB/usr/sbin/mailq
   11.25 -
   11.26 -\fB
   11.27 -.SH DESCRIPTION
   11.28 -
   11.29 -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.
   11.30 -
   11.31 -.SH OPTIONS
   11.32 -
   11.33 -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)
   11.34 -.TP
   11.35 -
   11.36 -\fB--\f1
   11.37 -
   11.38 -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.
   11.39 -.TP
   11.40 -
   11.41 -\fB-bd\f1
   11.42 -
   11.43 -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).
   11.44 -.TP
   11.45 -
   11.46 -\fB-bi\f1
   11.47 -
   11.48 -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.
   11.49 -.TP
   11.50 -
   11.51 -\fB-bp\f1
   11.52 -
   11.53 -Show the messages in the queue. Same as calling masqmail as 'mailq'.
   11.54 -.TP
   11.55 -
   11.56 -\fB-bs\f1
   11.57 -
   11.58 -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.
   11.59 -.TP
   11.60 -
   11.61 -\fB-B \fIarg\f1\fB\f1
   11.62 -
   11.63 -\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).
   11.64 -.TP
   11.65 -
   11.66 -\fB-bV \f1
   11.67 -
   11.68 -Show version information.
   11.69 -.TP
   11.70 -
   11.71 -\fB-C \f1\fIfilename\f1
   11.72 -
   11.73 -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.
   11.74 -.TP
   11.75 -
   11.76 -\fB-d \fInumber\f1\fB\f1
   11.77 -
   11.78 -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.
   11.79 -.TP
   11.80 -
   11.81 -\fB-f [\fIaddress\f1\fB]\f1
   11.82 -
   11.83 -Set the return path address to \fIaddress\f1. Only root, the user mail and anyoune in group trusted is allowed to do that.
   11.84 -.TP
   11.85 -
   11.86 -\fB-F [\fIstring\f1\fB]\f1
   11.87 -
   11.88 -Set the full sender name (in the From: header) to \fIstring\f1.
   11.89 -.TP
   11.90 -
   11.91 -\fB-g [\fIname\f1\fB]\f1
   11.92 -
   11.93 -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
   11.94 -.TP
   11.95 -
   11.96 -\fB-go [\fIinterval\f1\fB] [\fIname\f1\fB]\f1
   11.97 -
   11.98 -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).
   11.99 -
  11.100 -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.
  11.101 -
  11.102 -If called without \fIname\f1 the online status is determined with the configured method (see \fBonline_detect\f1 in config.html).
  11.103 -.TP
  11.104 -
  11.105 -\fB-i\f1
  11.106 -
  11.107 -Same as -oi, see below.
  11.108 -.TP
  11.109 -
  11.110 -\fB-Mrm \fIlist\f1\fB\f1
  11.111 -
  11.112 -Remove given messages from the queue. Only allowed for privileged users.
  11.113 -.TP
  11.114 -
  11.115 -\fB-oem\f1
  11.116 -
  11.117 -If the -oi ist not also given, always return with a non zero return code. Maybe someone tells me what this is good for...
  11.118 -.TP
  11.119 -
  11.120 -\fB-odb\f1
  11.121 -
  11.122 -Deliver in background. Masqmail always does this, which makes this option pretty much useless.
  11.123 -.TP
  11.124 -
  11.125 -\fB-odq\f1
  11.126 -
  11.127 -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.
  11.128 -.TP
  11.129 -
  11.130 -\fB-oi\f1
  11.131 -
  11.132 -A dot as a single character in a line does not terminate the message.
  11.133 -.TP
  11.134 -
  11.135 -\fB-q [\fIinterval\f1\fB]\f1
  11.136 -
  11.137 -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.
  11.138 -
  11.139 -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.
  11.140 -
  11.141 -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).
  11.142 -.TP
  11.143 -
  11.144 -\fB-qo [\fIname\f1\fB]\f1
  11.145 -
  11.146 -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).
  11.147 -
  11.148 -If called without \fIname\f1 the online status is determined with the configured method (see \fBonline_detect\f1 in config.html)
  11.149 -.TP
  11.150 -
  11.151 -\fB-t\f1
  11.152 -
  11.153 -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.
  11.154 -.TP
  11.155 -
  11.156 -\fB-v\f1
  11.157 -
  11.158 -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.
  11.159 -.SH ENVIRONMENT FOR PIPES AND MDAS
  11.160 -
  11.161 -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:
  11.162 -
  11.163 -SENDER, RETURN_PATH - the return path.
  11.164 -
  11.165 -SENDER_DOMAIN - the domain part of the return path.
  11.166 -
  11.167 -SENDER_LOCAL - the local part of the return path.
  11.168 -
  11.169 -RECEIVED_HOST - the host the message was received from (unless local).
  11.170 -
  11.171 -LOCAL_PART, USER, LOGNAME - the local part of the (original) recipient.
  11.172 -
  11.173 -MESSAGE_ID - the unique message id. This is not necessarily identical with the Message ID as given in the Message ID: header.
  11.174 -
  11.175 -QUALIFY_DOMAIN - the domain which will be appended to unqualified addresses.
  11.176 -
  11.177 -.SH FILES
  11.178 -
  11.179 -\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.
  11.180 -
  11.181 -\fI/etc/aliases\f1 is the alias file, if not set differently in \fI/etc/masqmail/masqmail.conf\f1.
  11.182 -
  11.183 -\fI/var/spool/masqmail/\f1 is the spool directory where masqmail stores its spooled messages and the uniq pop ids.
  11.184 -
  11.185 -\fI/var/spool/mail/\f1 is the directory where locally delivered mail will be put, if not configured differently in \fImasqmail.conf\f1.
  11.186 -
  11.187 -\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.
  11.188 -
  11.189 -.SH CONFORMING TO
  11.190 -
  11.191 -RFC 821, 822, 1869, 1870, 2197, 2554 (SMTP)
  11.192 -
  11.193 -RFC 1725, 1939 (POP3)
  11.194 -
  11.195 -RFC 1321 (MD5)
  11.196 -
  11.197 -RFC 2195 (CRAM-MD5)
  11.198 -
  11.199 -.SH AUTHOR
  11.200 -
  11.201 -masqmail was written by Oliver Kurth <oku@masqmail.cx>
  11.202 -
  11.203 -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.
  11.204 -
  11.205 -.SH BUGS
  11.206 -
  11.207 -You should report them to the mailing list.
  11.208 -
  11.209 -.SH SEE ALSO
  11.210 -
  11.211 -\fBmasqmail.conf (5)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.get (5)\f1, \fBmasqmail.aliases (5)\f1
  11.212 -
  11.213 -.SH COMMENTS
  11.214 -
  11.215 -This man page was written using \fBxml2man (1)\f1 by the same author.
  11.216 -

    12.1 --- a/docs/man/masqmail.aliases.5	Fri Sep 26 21:26:36 2008 +0200
    12.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    12.3 @@ -1,41 +0,0 @@
    12.4 -.TH masqmail.aliases 5 User Manuals
    12.5 -.SH NAME
    12.6 -masqmail.aliases \- masqmail alias file format
    12.7 -.SH DESCRIPTION
    12.8 -
    12.9 -This man page describes the format of the masqmail alias file. Its usual location is \fI/etc/aliases\f1.
   12.10 -
   12.11 -.SH FILE FORMAT
   12.12 -
   12.13 -The alias file consists of lines of the form:
   12.14 -local_part: item1, item2, ...
   12.15 -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 '\'.
   12.16 -
   12.17 -A leading '\' indicates that this address shall not be further expanded.
   12.18 -
   12.19 -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.
   12.20 -
   12.21 -Loops will be detected, the offending address will be ignored.
   12.22 -
   12.23 -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.
   12.24 -
   12.25 -There is no need to restart masqmail or run any command when the alias file has been changed.
   12.26 -
   12.27 -.SH AUTHOR
   12.28 -
   12.29 -masqmail was written by Oliver Kurth <oku@masqmail.cx>
   12.30 -
   12.31 -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.
   12.32 -
   12.33 -.SH BUGS
   12.34 -
   12.35 -You should report them to the mailing list.
   12.36 -
   12.37 -.SH SEE ALSO
   12.38 -
   12.39 -\fBmasqmail.conf (5)\f1, \fBmasqmail (8)\f1, 
   12.40 -
   12.41 -.SH COMMENTS
   12.42 -
   12.43 -This man page was written using \fBxml2man (1)\f1 by the same author.
   12.44 -

    13.1 --- a/docs/man/masqmail.conf.5	Fri Sep 26 21:26:36 2008 +0200
    13.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    13.3 @@ -1,345 +0,0 @@
    13.4 -.TH masqmail.conf 5 User Manuals
    13.5 -.SH NAME
    13.6 -masqmail.conf \- masqmail configuration file
    13.7 -.SH DESCRIPTION
    13.8 -
    13.9 -This man page describes the syntax of the main configuration file of masqmail. Its usual location is \fI/etc/masqmail/masqmail.conf\f1
   13.10 -
   13.11 -The configuration consists of lines of the form
   13.12 -
   13.13 -\fBval\f1 = \fIexpression\f1
   13.14 -
   13.15 -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.
   13.16 -
   13.17 -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.
   13.18 -
   13.19 -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.
   13.20 -
   13.21 -Blank lines and lines starting with '#' are ignored.
   13.22 -
   13.23 -.SH OPTIONS
   13.24 -.TP
   13.25 -
   13.26 -\fBrun_as_user = \fIboolean\f1\fB\f1
   13.27 -
   13.28 -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.
   13.29 -.TP
   13.30 -
   13.31 -\fBuse_syslog = \fIboolean\f1\fB\f1
   13.32 -
   13.33 -If this is set, masqmail uses syslogd for logging. It uses facility MAIL. You still have to set \fBlog_dir\f1 for debug files.
   13.34 -.TP
   13.35 -
   13.36 -\fBdebug_level = \fIn\f1\fB\f1
   13.37 -
   13.38 -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.
   13.39 -.TP
   13.40 -
   13.41 -\fBmail_dir = \fIfile\f1\fB\f1
   13.42 -
   13.43 -The directory where local mail is stored, usually \fI/var/spool/mail\f1 or \fI/var/mail\f1.
   13.44 -.TP
   13.45 -
   13.46 -\fBspool_dir = \fIfile\f1\fB\f1
   13.47 -
   13.48 -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.
   13.49 -.TP
   13.50 -
   13.51 -\fBhost_name = \fIstring\f1\fB\f1
   13.52 -
   13.53 -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.
   13.54 -
   13.55 -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.
   13.56 -
   13.57 -It is not used to find whether an address is local. Use \fBlocal_hosts\f1 for that.
   13.58 -.TP
   13.59 -
   13.60 -\fBremote_port = \fIn\f1\fB\f1
   13.61 -
   13.62 -The remote port number to be used. This defaults to port 25.
   13.63 -
   13.64 -This option is deprecated. Use \fBhost_name\f1 in the route configuration instead. See \fBmasqmail.route (5)\f1.
   13.65 -.TP
   13.66 -
   13.67 -\fBlocal_hosts = \fIlist\f1\fB\f1
   13.68 -
   13.69 -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'.
   13.70 -.TP
   13.71 -
   13.72 -\fBlocal_nets = \fIlist\f1\fB\f1
   13.73 -
   13.74 -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".
   13.75 -.TP
   13.76 -
   13.77 -\fBlocal_addresses = \fIlist\f1\fB\f1
   13.78 -
   13.79 -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. 
   13.80 -
   13.81 -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
   13.82 -
   13.83 -local_addresses = "person1@yourdomain;person2@yourdomain"
   13.84 -
   13.85 -to your masqmail.conf.
   13.86 -.TP
   13.87 -
   13.88 -\fBnot_local_addresses = \fIlist\f1\fB\f1
   13.89 -
   13.90 -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. 
   13.91 -
   13.92 -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.
   13.93 -
   13.94 -Example:
   13.95 -
   13.96 -local_hosts = "localhost;myhost;mydomain.net"
   13.97 -
   13.98 -not_local_addresses = "eric@mydomain.net"
   13.99 -.TP
  13.100 -
  13.101 -\fBlisten_addresses = \fIlist\f1\fB\f1
  13.102 -
  13.103 -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.
  13.104 -
  13.105 -You can set this to "localhost:25;foo:25" if your hostname is 'foo'.
  13.106 -
  13.107 -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.
  13.108 -.TP
  13.109 -
  13.110 -\fBdo_save_envelope_to = \fIboolean\f1\fB\f1
  13.111 -
  13.112 -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.
  13.113 -
  13.114 -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.
  13.115 -
  13.116 -Default is false.
  13.117 -.TP
  13.118 -
  13.119 -\fBdo_relay = \fIboolean\f1\fB\f1
  13.120 -
  13.121 -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.
  13.122 -
  13.123 -Note that this will not protect you from spammers using open relays, but from users unable to set their address in their mail clients.
  13.124 -.TP
  13.125 -
  13.126 -\fBdo_queue = \fIboolean\f1\fB\f1
  13.127 -
  13.128 -If this is set, mail will not be delivered immediately when accepted. Same as calling masqmail with the \fB-odq\f1 option.
  13.129 -.TP
  13.130 -
  13.131 -\fBonline_routes.\fIname\f1\fB = \fIlist\f1\fB\f1
  13.132 -
  13.133 -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.
  13.134 -
  13.135 -Example: Your ISP has the name FastNet. Then you write the following line in the main configuration:
  13.136 -
  13.137 -\fBonline_routes.FastNet\f1 = \fI"/etc/masqmail/fastnet.route"\f1
  13.138 -
  13.139 -\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.
  13.140 -.TP
  13.141 -
  13.142 -\fBconnect_route.\fIname\f1\fB = \fIlist\f1\fB\f1
  13.143 -
  13.144 -Old name for \fBonline_routes\f1.
  13.145 -.TP
  13.146 -
  13.147 -\fBlocal_net_route = \fIfile\f1\fB\f1
  13.148 -
  13.149 -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.
  13.150 -.TP
  13.151 -
  13.152 -\fBalias_file = \fIfile\f1\fB\f1
  13.153 -
  13.154 -Set this to the location of your alias file. If unset, no aliasing will be done.
  13.155 -.TP
  13.156 -
  13.157 -\fBalias_local_caseless = \fIboolean\f1\fB\f1
  13.158 -
  13.159 -If this is set, local parts in the alias file will be matched disregarding upper/lower case.
  13.160 -.TP
  13.161 -
  13.162 -\fBpipe_fromline = \fIboolean\f1\fB\f1
  13.163 -
  13.164 -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.
  13.165 -.TP
  13.166 -
  13.167 -\fBpipe_fromhack = \fIboolean\f1\fB\f1
  13.168 -
  13.169 -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.
  13.170 -.TP
  13.171 -
  13.172 -\fBmbox_default = \fIstring\f1\fB\f1
  13.173 -
  13.174 -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).
  13.175 -.TP
  13.176 -
  13.177 -\fBmbox_users = \fIlist\f1\fB\f1
  13.178 -
  13.179 -A list of users which wish delivery to an mbox style mail folder.
  13.180 -.TP
  13.181 -
  13.182 -\fBmda_users = \fIlist\f1\fB\f1
  13.183 -
  13.184 -A list of users which wish local delivery to an mda. You have to set \fBmda\f1 (see below) as well.
  13.185 -.TP
  13.186 -
  13.187 -\fBmaildir_users = \fIlist\f1\fB\f1
  13.188 -
  13.189 -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.
  13.190 -.TP
  13.191 -
  13.192 -\fBmda = \fIexpand string\f1\fB\f1
  13.193 -
  13.194 -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:
  13.195 -
  13.196 -uid - the unique message id. This is not necessarily identical with the Message ID as given in the Message ID: header.
  13.197 -
  13.198 -received_host - the host the mail was received from
  13.199 -
  13.200 -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.
  13.201 -
  13.202 -return_path_local - the local part of the return path (sender).
  13.203 -
  13.204 -return_path_domain - the domain part of the return path (sender).
  13.205 -
  13.206 -return_path - the complete return path (sender).
  13.207 -
  13.208 -rcpt_local - the local part of the recipient.
  13.209 -
  13.210 -rcpt_domain - the domain part of the recipient.
  13.211 -
  13.212 -rcpt - the complete recipient address.
  13.213 -
  13.214 -Example:
  13.215 -
  13.216 -mda="/usr/bin/procmail -Y -d ${rcpt_local}"
  13.217 -
  13.218 -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.
  13.219 -.TP
  13.220 -
  13.221 -\fBmda_fromline = \fIboolean\f1\fB\f1
  13.222 -
  13.223 -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.
  13.224 -.TP
  13.225 -
  13.226 -\fBmda_fromhack = \fIboolean\f1\fB\f1
  13.227 -
  13.228 -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.
  13.229 -.TP
  13.230 -
  13.231 -\fBonline_detect = \fIstring\f1\fB\f1
  13.232 -
  13.233 -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.
  13.234 -
  13.235 -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).
  13.236 -
  13.237 -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.
  13.238 -
  13.239 -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.
  13.240 -
  13.241 -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.
  13.242 -.TP
  13.243 -
  13.244 -\fBonline_file = \fIfile\f1\fB\f1
  13.245 -
  13.246 -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.
  13.247 -
  13.248 -echo -n <name> > /tmp/connect_route
  13.249 -
  13.250 -chmod 0644 /tmp/connect_route
  13.251 -
  13.252 -Do not forget to delete it in your ip-down script.
  13.253 -.TP
  13.254 -
  13.255 -\fBonline_pipe = \fIfile\f1\fB\f1
  13.256 -
  13.257 -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:
  13.258 -
  13.259 -#!/bin/sh
  13.260 -
  13.261 -
  13.262 -
  13.263 -[ -e /tmp/connect_route ] || exit 1
  13.264 -
  13.265 -cat /tmp/connect_route
  13.266 -
  13.267 -exit 0
  13.268 -
  13.269 -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.
  13.270 -.TP
  13.271 -
  13.272 -\fBmserver_iface = \fIinterface\f1\fB\f1
  13.273 -
  13.274 -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".
  13.275 -.TP
  13.276 -
  13.277 -\fBget.\fIname\f1\fB = \fIfile\f1\fB\f1
  13.278 -
  13.279 -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.
  13.280 -.TP
  13.281 -
  13.282 -\fBonline_gets.\fIname\f1\fB = \fIlist\f1\fB\f1
  13.283 -
  13.284 -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.
  13.285 -.TP
  13.286 -
  13.287 -\fBident_trusted_nets = \fIlist\f1\fB\f1
  13.288 -
  13.289 -\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.
  13.290 -.TP
  13.291 -
  13.292 -\fBerrmsg_file = \fIfile\f1\fB\f1
  13.293 -
  13.294 -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.
  13.295 -
  13.296 -Default is /usr/share/masqmail/tpl/failmsg.tpl.
  13.297 -.TP
  13.298 -
  13.299 -\fBwarnmsg_file = \fIfile\f1\fB\f1
  13.300 -
  13.301 -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.
  13.302 -
  13.303 -Default is /usr/share/masqmail/tpl/warnmsg.tpl.
  13.304 -.TP
  13.305 -
  13.306 -\fBwarn_intervals\f1 = \fIlist\f1
  13.307 -
  13.308 -Set this to a list of time intervals, at which delivery warnings (starting with the receiving time of the message) shall be generated.
  13.309 -
  13.310 -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.
  13.311 -
  13.312 -Default is "1h;4h;8h;1d;2d;3d"
  13.313 -.TP
  13.314 -
  13.315 -\fBmax_defer_time\f1 = \fItime\f1
  13.316 -
  13.317 -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.
  13.318 -
  13.319 -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.
  13.320 -
  13.321 -Default is 4d (4 days)
  13.322 -.TP
  13.323 -
  13.324 -\fBlog_user = \fIname\f1\fB\f1
  13.325 -
  13.326 -Replace \fIname\f1 with a valid local or remote mail address.
  13.327 -
  13.328 -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.
  13.329 -
  13.330 -For example you can feed your mails into a program like hypermail for archiving purpose by placing an appropriate pipe command in masqmail.alias
  13.331 -.SH AUTHOR
  13.332 -
  13.333 -masqmail was written by Oliver Kurth <oku@masqmail.cx>
  13.334 -
  13.335 -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.
  13.336 -
  13.337 -.SH BUGS
  13.338 -
  13.339 -You should report them to the mailing list.
  13.340 -
  13.341 -.SH SEE ALSO
  13.342 -
  13.343 -\fBmasqmail (8)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.get (5)\f1
  13.344 -
  13.345 -.SH COMMENTS
  13.346 -
  13.347 -This man page was written using \fBxml2man (1)\f1 by the same author.
  13.348 -

    14.1 --- a/docs/man/masqmail.get.5	Fri Sep 26 21:26:36 2008 +0200
    14.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    14.3 @@ -1,99 +0,0 @@
    14.4 -.TH masqmail.get 5 User Manuals
    14.5 -.SH NAME
    14.6 -masqmail.get \- masqmail get configuration file
    14.7 -.SH DESCRIPTION
    14.8 - 
    14.9 -This man page describes the options available for the masqmail get configuration.
   14.10 -
   14.11 -.SH OPTIONS
   14.12 -.TP
   14.13 -
   14.14 -\fBprotocol\f1 = \fIstring\f1
   14.15 -
   14.16 -The protocol with which you retrieve your mail. Currently only 'pop3' and 'apop' are supported. There is no default.
   14.17 -.TP
   14.18 -
   14.19 -\fBserver\f1 = \fIstring\f1
   14.20 -
   14.21 -The server you get your mail from.
   14.22 -.TP
   14.23 -
   14.24 -\fBresolve_list\f1 = \fIlist\f1
   14.25 -
   14.26 -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.
   14.27 -
   14.28 -The default is "dns_a;byname". It does not make much sense here to use 'dns_mx'.
   14.29 -.TP
   14.30 -
   14.31 -\fBuser\f1 = \fIstring\f1
   14.32 -
   14.33 -Your login name.
   14.34 -.TP
   14.35 -
   14.36 -\fBpass\f1 = \fIstring\f1
   14.37 -
   14.38 -Your password.
   14.39 -.TP
   14.40 -
   14.41 -\fBaddress\f1 = \fIaddress\f1
   14.42 -
   14.43 -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.
   14.44 -.TP
   14.45 -
   14.46 -\fBreturn_path\f1 = \fIaddress\f1
   14.47 -
   14.48 -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.
   14.49 -
   14.50 -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.
   14.51 -.TP
   14.52 -
   14.53 -\fBdo_keep\f1 = \fIboolean\f1
   14.54 -
   14.55 -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.
   14.56 -.TP
   14.57 -
   14.58 -\fBdo_uidl\f1 = \fIboolean\f1
   14.59 -
   14.60 -If set, MasqMail keeps a list of unique IDs of mails already fetched, so that they will not be retrieved again. Default is false.
   14.61 -.TP
   14.62 -
   14.63 -\fBdo_uidl_dele\f1 = \fIboolean\f1
   14.64 -
   14.65 -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.
   14.66 -.TP
   14.67 -
   14.68 -\fBmax_size\f1 = \fInumeric\f1
   14.69 -
   14.70 -If set to a value > 0, only messages smaller than this in bytes will be retrieved. The default is 0.
   14.71 -.TP
   14.72 -
   14.73 -\fBmax_count\f1 = \fInumeric\f1
   14.74 -
   14.75 -If set to a value > 0, only \fBmax_count\f1 messages will be retrieved. The default is 0.
   14.76 -.TP
   14.77 -
   14.78 -\fBwrapper\f1 = \fIcommand\f1
   14.79 -
   14.80 -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.
   14.81 -
   14.82 -Example for ssl tunneling:
   14.83 -
   14.84 -wrapper="/usr/bin/openssl s_client -quiet -connect pop.gmx.net:995 2>/dev/null"
   14.85 -.SH AUTHOR
   14.86 -
   14.87 -masqmail was written by Oliver Kurth <oku@masqmail.cx>
   14.88 -
   14.89 -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.
   14.90 -
   14.91 -.SH BUGS
   14.92 -
   14.93 -You should report them to the mailing list.
   14.94 -
   14.95 -.SH SEE ALSO
   14.96 -
   14.97 -\fBmasqmail (8)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.conf (5)\f1
   14.98 -
   14.99 -.SH COMMENTS
  14.100 -
  14.101 -This man page was written using \fBxml2man (1)\f1 by the same author.
  14.102 -

    15.1 --- a/docs/man/masqmail.route.5	Fri Sep 26 21:26:36 2008 +0200
    15.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    15.3 @@ -1,212 +0,0 @@
    15.4 -.TH masqmail.route 5 User Manuals
    15.5 -.SH NAME
    15.6 -masqmail.route \- masqmail route configuration file
    15.7 -.SH DESCRIPTION
    15.8 -
    15.9 -This man page describes the syntax of the route configuration files of \fBmasqmail (8)\f1. Their usual locations are in \fI/etc/masqmail/\f1.
   15.10 -
   15.11 -.SH OPTIONS
   15.12 -.TP
   15.13 -
   15.14 -\fBprotocol\f1 = \fIstring\f1
   15.15 -
   15.16 -\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.
   15.17 -.TP
   15.18 -
   15.19 -\fBmail_host\f1 = \fIstring\f1
   15.20 -
   15.21 -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.
   15.22 -
   15.23 -You can optionally give a port number following the host name and a colon, eg mail_host="mail.foo.com:25".
   15.24 -.TP
   15.25 -
   15.26 -\fBresolve_list\f1 = \fIlist\f1
   15.27 -
   15.28 -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.
   15.29 -
   15.30 -The default is "dns_mx;dns_a;byname".
   15.31 -.TP
   15.32 -
   15.33 -\fBconnect_error_fail\f1 = \fIboolean\f1
   15.34 -
   15.35 -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.
   15.36 -
   15.37 -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.
   15.38 -
   15.39 -For the default local_net route is is set to true.
   15.40 -.TP
   15.41 -
   15.42 -\fBhelo_name\f1 = \fIstring\f1
   15.43 -
   15.44 -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.
   15.45 -.TP
   15.46 -
   15.47 -\fBdo_correct_helo\f1 = \fIboolean\f1
   15.48 -
   15.49 -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.
   15.50 -.TP
   15.51 -
   15.52 -\fBdo_pipelining\f1 = \fIboolean\f1
   15.53 -
   15.54 -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.
   15.55 -
   15.56 -You do not want to set this to false unless the mail setup on the remote server side is really broken. Keywords: wingate.
   15.57 -.TP
   15.58 -
   15.59 -\fBallowed_mail_locals\f1 = \fIlist\f1
   15.60 -
   15.61 -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.
   15.62 -.TP
   15.63 -
   15.64 -\fBnot_allowed_mail_locals\f1 = \fIlist\f1
   15.65 -
   15.66 -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).
   15.67 -.TP
   15.68 -
   15.69 -\fBallowed_return_paths\f1 = \fIlist\f1
   15.70 -
   15.71 -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).
   15.72 -
   15.73 -Patterns containing '?' and '*' can be used. The special item "<>" matches the null sender address (eg. failure notices or delivery notifications).
   15.74 -.TP
   15.75 -
   15.76 -\fBnot_allowed_return_paths\f1 = \fIlist\f1
   15.77 -
   15.78 -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).
   15.79 -
   15.80 -Patterns containing '?' and '*' can be used. The special item "<>" matches the null sender address (eg. failure notices or delivery notifications).
   15.81 -.TP
   15.82 -
   15.83 -\fBallowed_rcpt_domains\f1 = \fIlist\f1
   15.84 -
   15.85 -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.
   15.86 -.TP
   15.87 -
   15.88 -\fBnot_allowed_rcpt_domains\f1 = \fIlist\f1
   15.89 -
   15.90 -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.
   15.91 -.TP
   15.92 -
   15.93 -\fBset_h_from_domain\f1 = \fIstring\f1
   15.94 -
   15.95 -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.
   15.96 -.TP
   15.97 -
   15.98 -\fBset_return_path_domain\f1 = \fIstring\f1
   15.99 -
  15.100 -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.
  15.101 -.TP
  15.102 -
  15.103 -\fBmap_h_from_addresses\f1 = \fIlist\f1
  15.104 -
  15.105 -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 (':').
  15.106 -
  15.107 -Example:
  15.108 -
  15.109 -map_h_from_addresses = "john: John Smith <jsmith@mail.academic.edu>; charlie: Charlie Miller <cmiller@mx.commercial.com>"
  15.110 -
  15.111 -You can use patterns, eg. * as keys.
  15.112 -.TP
  15.113 -
  15.114 -\fBmap_h_reply_to_addresses\f1 = \fIlist\f1
  15.115 -
  15.116 -Same as \fBmap_h_from_addresses\f1, but for the 'Reply-To:' header.
  15.117 -.TP
  15.118 -
  15.119 -\fBmap_h_mail_followup_to_addresses\f1 = \fIlist\f1
  15.120 -
  15.121 -Same as \fBmap_h_from_addresses\f1, but for the 'Mail-Followup-To:' header. Useful when replying to mailing lists.
  15.122 -.TP
  15.123 -
  15.124 -\fBmap_return_path_addresses\f1 = \fIlist\f1
  15.125 -
  15.126 -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.
  15.127 -
  15.128 -Example:
  15.129 -
  15.130 -map_return_path_addresses = "john: <jsmith@mail.academic.edu>; charlie: <cmiller@mx.commercial.com>"
  15.131 -
  15.132 -You can use patterns, eg. * as keys.
  15.133 -.TP
  15.134 -
  15.135 -\fBexpand_h_sender_address\f1 = \fIboolean\f1
  15.136 -
  15.137 -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.
  15.138 -.TP
  15.139 -
  15.140 -\fBexpand_h_sender_domain\f1 = \fIboolean\f1
  15.141 -
  15.142 -Like \fBexpand_h_sender_address\f1, but sets the domain only. Deprecated, will be removed in a later version.
  15.143 -.TP
  15.144 -
  15.145 -\fBlast_route\f1 = \fIboolean\f1
  15.146 -
  15.147 -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.
  15.148 -
  15.149 -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.
  15.150 -
  15.151 -Default is false.
  15.152 -.TP
  15.153 -
  15.154 -\fBauth_name\f1 = \fIstring\f1
  15.155 -
  15.156 -Set the authentication type for ESMTP AUTH authentification. Currently only 'cram-md5' and 'login' are supported.
  15.157 -.TP
  15.158 -
  15.159 -\fBauth_login\f1 = \fIstring\f1
  15.160 -
  15.161 -Your account name for ESMTP AUTH authentification.
  15.162 -.TP
  15.163 -
  15.164 -\fBauth_secret\f1 = \fIstring\f1
  15.165 -
  15.166 -Your secret for ESMTP AUTH authentification.
  15.167 -.TP
  15.168 -
  15.169 -\fBpop3_login\f1 = \fIfile\f1
  15.170 -
  15.171 -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.
  15.172 -.TP
  15.173 -
  15.174 -\fBwrapper\f1 = \fIcommand\f1
  15.175 -
  15.176 -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.
  15.177 -
  15.178 -Example for ssl tunneling:
  15.179 -
  15.180 -wrapper="/usr/bin/openssl s_client -quiet -connect pop.gmx.net:995 2>/dev/null"
  15.181 -.TP
  15.182 -
  15.183 -\fBpipe\f1 = \fIcommand\f1
  15.184 -
  15.185 -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.
  15.186 -
  15.187 -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.
  15.188 -.TP
  15.189 -
  15.190 -\fBpipe_fromline = \fIboolean\f1\fB\f1
  15.191 -
  15.192 -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.
  15.193 -.TP
  15.194 -
  15.195 -\fBpipe_fromhack = \fIboolean\f1\fB\f1
  15.196 -
  15.197 -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.
  15.198 -.SH AUTHOR
  15.199 -
  15.200 -masqmail was written by Oliver Kurth <oku@masqmail.cx>
  15.201 -
  15.202 -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.
  15.203 -
  15.204 -.SH BUGS
  15.205 -
  15.206 -You should report them to the mailing list.
  15.207 -
  15.208 -.SH SEE ALSO
  15.209 -
  15.210 -\fBmasqmail (8)\f1, \fBmasqmail.conf (5)\f1, \fBmasqmail.get (5)\f1
  15.211 -
  15.212 -.SH COMMENTS
  15.213 -
  15.214 -This man page was written using \fBxml2man (1)\f1 by the same author.
  15.215 -

    16.1 --- a/docs/man/mservdetect.8	Fri Sep 26 21:26:36 2008 +0200
    16.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    16.3 @@ -1,42 +0,0 @@
    16.4 -.TH mservdetect 8 User Manuals
    16.5 -.SH NAME
    16.6 -mservdetect \- Helper for masqmail and masqdialer
    16.7 -.SH SYNOPSIS
    16.8 -\fB/usr/bin/masqmail \fIhost\f1\fB \fIport\f1\fB
    16.9 -
   16.10 -\fB
   16.11 -.SH DESCRIPTION
   16.12 -
   16.13 -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.
   16.14 -
   16.15 -If you want to use it, set \fBonline_detect\f1=\fIpipe\f1 and \fBonline_pipe\f1=\fI"/usr/bin/mservdetect host port"\f1.
   16.16 -
   16.17 -.SH OPTIONS
   16.18 -.TP
   16.19 -
   16.20 -\fBhost\f1
   16.21 -
   16.22 -The hostname where the masqdialer server is running.
   16.23 -.TP
   16.24 -
   16.25 -\fBport\f1
   16.26 -
   16.27 -The port number where the masqdialer server is listening.
   16.28 -.SH AUTHOR
   16.29 -
   16.30 -masqmail was written by Oliver Kurth <oku@masqmail.cx>
   16.31 -
   16.32 -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.
   16.33 -
   16.34 -.SH BUGS
   16.35 -
   16.36 -You should report them to the mailing list.
   16.37 -
   16.38 -.SH SEE ALSO
   16.39 -
   16.40 -\fBmasqmail.conf (5)\f1
   16.41 -
   16.42 -.SH COMMENTS
   16.43 -
   16.44 -This man page was written using \fBxml2man (1)\f1 by the same author.
   16.45 -

    17.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    17.2 +++ b/docs/masqmail.8	Fri Sep 26 21:40:10 2008 +0200
    17.3 @@ -0,0 +1,213 @@
    17.4 +.TH masqmail 8 User Manuals
    17.5 +.SH NAME
    17.6 +masqmail \- An offline Mail Transfer Agent
    17.7 +.SH SYNOPSIS
    17.8 +\fB/usr/sbin/masqmail [-C \fIfile\f1\fB] [-odq] [-bd] [-q\fIinterval\f1\fB]
    17.9 +
   17.10 +\fB/usr/sbin/masqmail [-odq] [-bs]
   17.11 +
   17.12 +\fB/usr/sbin/masqmail [-bp]
   17.13 +
   17.14 +\fB/usr/sbin/masqmail [-q]
   17.15 +
   17.16 +\fB/usr/sbin/masqmail [-qo [\fIname\f1\fB]]
   17.17 +
   17.18 +\fB/usr/sbin/masqmail [-odq] [-g [\fIname\f1\fB]]
   17.19 +
   17.20 +\fB/usr/sbin/masqmail [-odq] [-go [\fIname\f1\fB]]
   17.21 +
   17.22 +\fB/usr/sbin/masqmail [-t] [-oi] [-f \fIaddress\f1\fB] [--] \fIaddress...\f1\fB
   17.23 +
   17.24 +\fB/usr/sbin/mailq
   17.25 +
   17.26 +\fB
   17.27 +.SH DESCRIPTION
   17.28 +
   17.29 +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.
   17.30 +
   17.31 +.SH OPTIONS
   17.32 +
   17.33 +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)
   17.34 +.TP
   17.35 +
   17.36 +\fB--\f1
   17.37 +
   17.38 +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.
   17.39 +.TP
   17.40 +
   17.41 +\fB-bd\f1
   17.42 +
   17.43 +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).
   17.44 +.TP
   17.45 +
   17.46 +\fB-bi\f1
   17.47 +
   17.48 +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.
   17.49 +.TP
   17.50 +
   17.51 +\fB-bp\f1
   17.52 +
   17.53 +Show the messages in the queue. Same as calling masqmail as 'mailq'.
   17.54 +.TP
   17.55 +
   17.56 +\fB-bs\f1
   17.57 +
   17.58 +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.
   17.59 +.TP
   17.60 +
   17.61 +\fB-B \fIarg\f1\fB\f1
   17.62 +
   17.63 +\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).
   17.64 +.TP
   17.65 +
   17.66 +\fB-bV \f1
   17.67 +
   17.68 +Show version information.
   17.69 +.TP
   17.70 +
   17.71 +\fB-C \f1\fIfilename\f1
   17.72 +
   17.73 +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.
   17.74 +.TP
   17.75 +
   17.76 +\fB-d \fInumber\f1\fB\f1
   17.77 +
   17.78 +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.
   17.79 +.TP
   17.80 +
   17.81 +\fB-f [\fIaddress\f1\fB]\f1
   17.82 +
   17.83 +Set the return path address to \fIaddress\f1. Only root, the user mail and anyoune in group trusted is allowed to do that.
   17.84 +.TP
   17.85 +
   17.86 +\fB-F [\fIstring\f1\fB]\f1
   17.87 +
   17.88 +Set the full sender name (in the From: header) to \fIstring\f1.
   17.89 +.TP
   17.90 +
   17.91 +\fB-g [\fIname\f1\fB]\f1
   17.92 +
   17.93 +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
   17.94 +.TP
   17.95 +
   17.96 +\fB-go [\fIinterval\f1\fB] [\fIname\f1\fB]\f1
   17.97 +
   17.98 +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).
   17.99 +
  17.100 +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.
  17.101 +
  17.102 +If called without \fIname\f1 the online status is determined with the configured method (see \fBonline_detect\f1 in config.html).
  17.103 +.TP
  17.104 +
  17.105 +\fB-i\f1
  17.106 +
  17.107 +Same as -oi, see below.
  17.108 +.TP
  17.109 +
  17.110 +\fB-Mrm \fIlist\f1\fB\f1
  17.111 +
  17.112 +Remove given messages from the queue. Only allowed for privileged users.
  17.113 +.TP
  17.114 +
  17.115 +\fB-oem\f1
  17.116 +
  17.117 +If the -oi ist not also given, always return with a non zero return code. Maybe someone tells me what this is good for...
  17.118 +.TP
  17.119 +
  17.120 +\fB-odb\f1
  17.121 +
  17.122 +Deliver in background. Masqmail always does this, which makes this option pretty much useless.
  17.123 +.TP
  17.124 +
  17.125 +\fB-odq\f1
  17.126 +
  17.127 +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.
  17.128 +.TP
  17.129 +
  17.130 +\fB-oi\f1
  17.131 +
  17.132 +A dot as a single character in a line does not terminate the message.
  17.133 +.TP
  17.134 +
  17.135 +\fB-q [\fIinterval\f1\fB]\f1
  17.136 +
  17.137 +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.
  17.138 +
  17.139 +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.
  17.140 +
  17.141 +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).
  17.142 +.TP
  17.143 +
  17.144 +\fB-qo [\fIname\f1\fB]\f1
  17.145 +
  17.146 +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).
  17.147 +
  17.148 +If called without \fIname\f1 the online status is determined with the configured method (see \fBonline_detect\f1 in config.html)
  17.149 +.TP
  17.150 +
  17.151 +\fB-t\f1
  17.152 +
  17.153 +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.
  17.154 +.TP
  17.155 +
  17.156 +\fB-v\f1
  17.157 +
  17.158 +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.
  17.159 +.SH ENVIRONMENT FOR PIPES AND MDAS
  17.160 +
  17.161 +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:
  17.162 +
  17.163 +SENDER, RETURN_PATH - the return path.
  17.164 +
  17.165 +SENDER_DOMAIN - the domain part of the return path.
  17.166 +
  17.167 +SENDER_LOCAL - the local part of the return path.
  17.168 +
  17.169 +RECEIVED_HOST - the host the message was received from (unless local).
  17.170 +
  17.171 +LOCAL_PART, USER, LOGNAME - the local part of the (original) recipient.
  17.172 +
  17.173 +MESSAGE_ID - the unique message id. This is not necessarily identical with the Message ID as given in the Message ID: header.
  17.174 +
  17.175 +QUALIFY_DOMAIN - the domain which will be appended to unqualified addresses.
  17.176 +
  17.177 +.SH FILES
  17.178 +
  17.179 +\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.
  17.180 +
  17.181 +\fI/etc/aliases\f1 is the alias file, if not set differently in \fI/etc/masqmail/masqmail.conf\f1.
  17.182 +
  17.183 +\fI/var/spool/masqmail/\f1 is the spool directory where masqmail stores its spooled messages and the uniq pop ids.
  17.184 +
  17.185 +\fI/var/spool/mail/\f1 is the directory where locally delivered mail will be put, if not configured differently in \fImasqmail.conf\f1.
  17.186 +
  17.187 +\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.
  17.188 +
  17.189 +.SH CONFORMING TO
  17.190 +
  17.191 +RFC 821, 822, 1869, 1870, 2197, 2554 (SMTP)
  17.192 +
  17.193 +RFC 1725, 1939 (POP3)
  17.194 +
  17.195 +RFC 1321 (MD5)
  17.196 +
  17.197 +RFC 2195 (CRAM-MD5)
  17.198 +
  17.199 +.SH AUTHOR
  17.200 +
  17.201 +masqmail was written by Oliver Kurth <oku@masqmail.cx>
  17.202 +
  17.203 +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.
  17.204 +
  17.205 +.SH BUGS
  17.206 +
  17.207 +You should report them to the mailing list.
  17.208 +
  17.209 +.SH SEE ALSO
  17.210 +
  17.211 +\fBmasqmail.conf (5)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.get (5)\f1, \fBmasqmail.aliases (5)\f1
  17.212 +
  17.213 +.SH COMMENTS
  17.214 +
  17.215 +This man page was written using \fBxml2man (1)\f1 by the same author.
  17.216 +

    18.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    18.2 +++ b/docs/masqmail.aliases.5	Fri Sep 26 21:40:10 2008 +0200
    18.3 @@ -0,0 +1,41 @@
    18.4 +.TH masqmail.aliases 5 User Manuals
    18.5 +.SH NAME
    18.6 +masqmail.aliases \- masqmail alias file format
    18.7 +.SH DESCRIPTION
    18.8 +
    18.9 +This man page describes the format of the masqmail alias file. Its usual location is \fI/etc/aliases\f1.
   18.10 +
   18.11 +.SH FILE FORMAT
   18.12 +
   18.13 +The alias file consists of lines of the form:
   18.14 +local_part: item1, item2, ...
   18.15 +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 '\'.
   18.16 +
   18.17 +A leading '\' indicates that this address shall not be further expanded.
   18.18 +
   18.19 +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.
   18.20 +
   18.21 +Loops will be detected, the offending address will be ignored.
   18.22 +
   18.23 +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.
   18.24 +
   18.25 +There is no need to restart masqmail or run any command when the alias file has been changed.
   18.26 +
   18.27 +.SH AUTHOR
   18.28 +
   18.29 +masqmail was written by Oliver Kurth <oku@masqmail.cx>
   18.30 +
   18.31 +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.
   18.32 +
   18.33 +.SH BUGS
   18.34 +
   18.35 +You should report them to the mailing list.
   18.36 +
   18.37 +.SH SEE ALSO
   18.38 +
   18.39 +\fBmasqmail.conf (5)\f1, \fBmasqmail (8)\f1, 
   18.40 +
   18.41 +.SH COMMENTS
   18.42 +
   18.43 +This man page was written using \fBxml2man (1)\f1 by the same author.
   18.44 +

    19.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    19.2 +++ b/docs/masqmail.conf.5	Fri Sep 26 21:40:10 2008 +0200
    19.3 @@ -0,0 +1,345 @@
    19.4 +.TH masqmail.conf 5 User Manuals
    19.5 +.SH NAME
    19.6 +masqmail.conf \- masqmail configuration file
    19.7 +.SH DESCRIPTION
    19.8 +
    19.9 +This man page describes the syntax of the main configuration file of masqmail. Its usual location is \fI/etc/masqmail/masqmail.conf\f1
   19.10 +
   19.11 +The configuration consists of lines of the form
   19.12 +
   19.13 +\fBval\f1 = \fIexpression\f1
   19.14 +
   19.15 +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.
   19.16 +
   19.17 +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.
   19.18 +
   19.19 +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.
   19.20 +
   19.21 +Blank lines and lines starting with '#' are ignored.
   19.22 +
   19.23 +.SH OPTIONS
   19.24 +.TP
   19.25 +
   19.26 +\fBrun_as_user = \fIboolean\f1\fB\f1
   19.27 +
   19.28 +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.
   19.29 +.TP
   19.30 +
   19.31 +\fBuse_syslog = \fIboolean\f1\fB\f1
   19.32 +
   19.33 +If this is set, masqmail uses syslogd for logging. It uses facility MAIL. You still have to set \fBlog_dir\f1 for debug files.
   19.34 +.TP
   19.35 +
   19.36 +\fBdebug_level = \fIn\f1\fB\f1
   19.37 +
   19.38 +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.
   19.39 +.TP
   19.40 +
   19.41 +\fBmail_dir = \fIfile\f1\fB\f1
   19.42 +
   19.43 +The directory where local mail is stored, usually \fI/var/spool/mail\f1 or \fI/var/mail\f1.
   19.44 +.TP
   19.45 +
   19.46 +\fBspool_dir = \fIfile\f1\fB\f1
   19.47 +
   19.48 +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.
   19.49 +.TP
   19.50 +
   19.51 +\fBhost_name = \fIstring\f1\fB\f1
   19.52 +
   19.53 +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.
   19.54 +
   19.55 +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.
   19.56 +
   19.57 +It is not used to find whether an address is local. Use \fBlocal_hosts\f1 for that.
   19.58 +.TP
   19.59 +
   19.60 +\fBremote_port = \fIn\f1\fB\f1
   19.61 +
   19.62 +The remote port number to be used. This defaults to port 25.
   19.63 +
   19.64 +This option is deprecated. Use \fBhost_name\f1 in the route configuration instead. See \fBmasqmail.route (5)\f1.
   19.65 +.TP
   19.66 +
   19.67 +\fBlocal_hosts = \fIlist\f1\fB\f1
   19.68 +
   19.69 +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'.
   19.70 +.TP
   19.71 +
   19.72 +\fBlocal_nets = \fIlist\f1\fB\f1
   19.73 +
   19.74 +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".
   19.75 +.TP
   19.76 +
   19.77 +\fBlocal_addresses = \fIlist\f1\fB\f1
   19.78 +
   19.79 +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. 
   19.80 +
   19.81 +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
   19.82 +
   19.83 +local_addresses = "person1@yourdomain;person2@yourdomain"
   19.84 +
   19.85 +to your masqmail.conf.
   19.86 +.TP
   19.87 +
   19.88 +\fBnot_local_addresses = \fIlist\f1\fB\f1
   19.89 +
   19.90 +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. 
   19.91 +
   19.92 +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.
   19.93 +
   19.94 +Example:
   19.95 +
   19.96 +local_hosts = "localhost;myhost;mydomain.net"
   19.97 +
   19.98 +not_local_addresses = "eric@mydomain.net"
   19.99 +.TP
  19.100 +
  19.101 +\fBlisten_addresses = \fIlist\f1\fB\f1
  19.102 +
  19.103 +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.
  19.104 +
  19.105 +You can set this to "localhost:25;foo:25" if your hostname is 'foo'.
  19.106 +
  19.107 +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.
  19.108 +.TP
  19.109 +
  19.110 +\fBdo_save_envelope_to = \fIboolean\f1\fB\f1
  19.111 +
  19.112 +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.
  19.113 +
  19.114 +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.
  19.115 +
  19.116 +Default is false.
  19.117 +.TP
  19.118 +
  19.119 +\fBdo_relay = \fIboolean\f1\fB\f1
  19.120 +
  19.121 +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.
  19.122 +
  19.123 +Note that this will not protect you from spammers using open relays, but from users unable to set their address in their mail clients.
  19.124 +.TP
  19.125 +
  19.126 +\fBdo_queue = \fIboolean\f1\fB\f1
  19.127 +
  19.128 +If this is set, mail will not be delivered immediately when accepted. Same as calling masqmail with the \fB-odq\f1 option.
  19.129 +.TP
  19.130 +
  19.131 +\fBonline_routes.\fIname\f1\fB = \fIlist\f1\fB\f1
  19.132 +
  19.133 +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.
  19.134 +
  19.135 +Example: Your ISP has the name FastNet. Then you write the following line in the main configuration:
  19.136 +
  19.137 +\fBonline_routes.FastNet\f1 = \fI"/etc/masqmail/fastnet.route"\f1
  19.138 +
  19.139 +\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.
  19.140 +.TP
  19.141 +
  19.142 +\fBconnect_route.\fIname\f1\fB = \fIlist\f1\fB\f1
  19.143 +
  19.144 +Old name for \fBonline_routes\f1.
  19.145 +.TP
  19.146 +
  19.147 +\fBlocal_net_route = \fIfile\f1\fB\f1
  19.148 +
  19.149 +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.
  19.150 +.TP
  19.151 +
  19.152 +\fBalias_file = \fIfile\f1\fB\f1
  19.153 +
  19.154 +Set this to the location of your alias file. If unset, no aliasing will be done.
  19.155 +.TP
  19.156 +
  19.157 +\fBalias_local_caseless = \fIboolean\f1\fB\f1
  19.158 +
  19.159 +If this is set, local parts in the alias file will be matched disregarding upper/lower case.
  19.160 +.TP
  19.161 +
  19.162 +\fBpipe_fromline = \fIboolean\f1\fB\f1
  19.163 +
  19.164 +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.
  19.165 +.TP
  19.166 +
  19.167 +\fBpipe_fromhack = \fIboolean\f1\fB\f1
  19.168 +
  19.169 +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.
  19.170 +.TP
  19.171 +
  19.172 +\fBmbox_default = \fIstring\f1\fB\f1
  19.173 +
  19.174 +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).
  19.175 +.TP
  19.176 +
  19.177 +\fBmbox_users = \fIlist\f1\fB\f1
  19.178 +
  19.179 +A list of users which wish delivery to an mbox style mail folder.
  19.180 +.TP
  19.181 +
  19.182 +\fBmda_users = \fIlist\f1\fB\f1
  19.183 +
  19.184 +A list of users which wish local delivery to an mda. You have to set \fBmda\f1 (see below) as well.
  19.185 +.TP
  19.186 +
  19.187 +\fBmaildir_users = \fIlist\f1\fB\f1
  19.188 +
  19.189 +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.
  19.190 +.TP
  19.191 +
  19.192 +\fBmda = \fIexpand string\f1\fB\f1
  19.193 +
  19.194 +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:
  19.195 +
  19.196 +uid - the unique message id. This is not necessarily identical with the Message ID as given in the Message ID: header.
  19.197 +
  19.198 +received_host - the host the mail was received from
  19.199 +
  19.200 +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.
  19.201 +
  19.202 +return_path_local - the local part of the return path (sender).
  19.203 +
  19.204 +return_path_domain - the domain part of the return path (sender).
  19.205 +
  19.206 +return_path - the complete return path (sender).
  19.207 +
  19.208 +rcpt_local - the local part of the recipient.
  19.209 +
  19.210 +rcpt_domain - the domain part of the recipient.
  19.211 +
  19.212 +rcpt - the complete recipient address.
  19.213 +
  19.214 +Example:
  19.215 +
  19.216 +mda="/usr/bin/procmail -Y -d ${rcpt_local}"
  19.217 +
  19.218 +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.
  19.219 +.TP
  19.220 +
  19.221 +\fBmda_fromline = \fIboolean\f1\fB\f1
  19.222 +
  19.223 +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.
  19.224 +.TP
  19.225 +
  19.226 +\fBmda_fromhack = \fIboolean\f1\fB\f1
  19.227 +
  19.228 +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.
  19.229 +.TP
  19.230 +
  19.231 +\fBonline_detect = \fIstring\f1\fB\f1
  19.232 +
  19.233 +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.
  19.234 +
  19.235 +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).
  19.236 +
  19.237 +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.
  19.238 +
  19.239 +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.
  19.240 +
  19.241 +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.
  19.242 +.TP
  19.243 +
  19.244 +\fBonline_file = \fIfile\f1\fB\f1
  19.245 +
  19.246 +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.
  19.247 +
  19.248 +echo -n <name> > /tmp/connect_route
  19.249 +
  19.250 +chmod 0644 /tmp/connect_route
  19.251 +
  19.252 +Do not forget to delete it in your ip-down script.
  19.253 +.TP
  19.254 +
  19.255 +\fBonline_pipe = \fIfile\f1\fB\f1
  19.256 +
  19.257 +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:
  19.258 +
  19.259 +#!/bin/sh
  19.260 +
  19.261 +
  19.262 +
  19.263 +[ -e /tmp/connect_route ] || exit 1
  19.264 +
  19.265 +cat /tmp/connect_route
  19.266 +
  19.267 +exit 0
  19.268 +
  19.269 +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.
  19.270 +.TP
  19.271 +
  19.272 +\fBmserver_iface = \fIinterface\f1\fB\f1
  19.273 +
  19.274 +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".
  19.275 +.TP
  19.276 +
  19.277 +\fBget.\fIname\f1\fB = \fIfile\f1\fB\f1
  19.278 +
  19.279 +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.
  19.280 +.TP
  19.281 +
  19.282 +\fBonline_gets.\fIname\f1\fB = \fIlist\f1\fB\f1
  19.283 +
  19.284 +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.
  19.285 +.TP
  19.286 +
  19.287 +\fBident_trusted_nets = \fIlist\f1\fB\f1
  19.288 +
  19.289 +\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.
  19.290 +.TP
  19.291 +
  19.292 +\fBerrmsg_file = \fIfile\f1\fB\f1
  19.293 +
  19.294 +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.
  19.295 +
  19.296 +Default is /usr/share/masqmail/tpl/failmsg.tpl.
  19.297 +.TP
  19.298 +
  19.299 +\fBwarnmsg_file = \fIfile\f1\fB\f1
  19.300 +
  19.301 +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.
  19.302 +
  19.303 +Default is /usr/share/masqmail/tpl/warnmsg.tpl.
  19.304 +.TP
  19.305 +
  19.306 +\fBwarn_intervals\f1 = \fIlist\f1
  19.307 +
  19.308 +Set this to a list of time intervals, at which delivery warnings (starting with the receiving time of the message) shall be generated.
  19.309 +
  19.310 +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.
  19.311 +
  19.312 +Default is "1h;4h;8h;1d;2d;3d"
  19.313 +.TP
  19.314 +
  19.315 +\fBmax_defer_time\f1 = \fItime\f1
  19.316 +
  19.317 +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.
  19.318 +
  19.319 +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.
  19.320 +
  19.321 +Default is 4d (4 days)
  19.322 +.TP
  19.323 +
  19.324 +\fBlog_user = \fIname\f1\fB\f1
  19.325 +
  19.326 +Replace \fIname\f1 with a valid local or remote mail address.
  19.327 +
  19.328 +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.
  19.329 +
  19.330 +For example you can feed your mails into a program like hypermail for archiving purpose by placing an appropriate pipe command in masqmail.alias
  19.331 +.SH AUTHOR
  19.332 +
  19.333 +masqmail was written by Oliver Kurth <oku@masqmail.cx>
  19.334 +
  19.335 +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.
  19.336 +
  19.337 +.SH BUGS
  19.338 +
  19.339 +You should report them to the mailing list.
  19.340 +
  19.341 +.SH SEE ALSO
  19.342 +
  19.343 +\fBmasqmail (8)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.get (5)\f1
  19.344 +
  19.345 +.SH COMMENTS
  19.346 +
  19.347 +This man page was written using \fBxml2man (1)\f1 by the same author.
  19.348 +

    20.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    20.2 +++ b/docs/masqmail.get.5	Fri Sep 26 21:40:10 2008 +0200
    20.3 @@ -0,0 +1,99 @@
    20.4 +.TH masqmail.get 5 User Manuals
    20.5 +.SH NAME
    20.6 +masqmail.get \- masqmail get configuration file
    20.7 +.SH DESCRIPTION
    20.8 + 
    20.9 +This man page describes the options available for the masqmail get configuration.
   20.10 +
   20.11 +.SH OPTIONS
   20.12 +.TP
   20.13 +
   20.14 +\fBprotocol\f1 = \fIstring\f1
   20.15 +
   20.16 +The protocol with which you retrieve your mail. Currently only 'pop3' and 'apop' are supported. There is no default.
   20.17 +.TP
   20.18 +
   20.19 +\fBserver\f1 = \fIstring\f1
   20.20 +
   20.21 +The server you get your mail from.
   20.22 +.TP
   20.23 +
   20.24 +\fBresolve_list\f1 = \fIlist\f1
   20.25 +
   20.26 +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.
   20.27 +
   20.28 +The default is "dns_a;byname". It does not make much sense here to use 'dns_mx'.
   20.29 +.TP
   20.30 +
   20.31 +\fBuser\f1 = \fIstring\f1
   20.32 +
   20.33 +Your login name.
   20.34 +.TP
   20.35 +
   20.36 +\fBpass\f1 = \fIstring\f1
   20.37 +
   20.38 +Your password.
   20.39 +.TP
   20.40 +
   20.41 +\fBaddress\f1 = \fIaddress\f1
   20.42 +
   20.43 +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.
   20.44 +.TP
   20.45 +
   20.46 +\fBreturn_path\f1 = \fIaddress\f1
   20.47 +
   20.48 +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.
   20.49 +
   20.50 +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.
   20.51 +.TP
   20.52 +
   20.53 +\fBdo_keep\f1 = \fIboolean\f1
   20.54 +
   20.55 +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.
   20.56 +.TP
   20.57 +
   20.58 +\fBdo_uidl\f1 = \fIboolean\f1
   20.59 +
   20.60 +If set, MasqMail keeps a list of unique IDs of mails already fetched, so that they will not be retrieved again. Default is false.
   20.61 +.TP
   20.62 +
   20.63 +\fBdo_uidl_dele\f1 = \fIboolean\f1
   20.64 +
   20.65 +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.
   20.66 +.TP
   20.67 +
   20.68 +\fBmax_size\f1 = \fInumeric\f1
   20.69 +
   20.70 +If set to a value > 0, only messages smaller than this in bytes will be retrieved. The default is 0.
   20.71 +.TP
   20.72 +
   20.73 +\fBmax_count\f1 = \fInumeric\f1
   20.74 +
   20.75 +If set to a value > 0, only \fBmax_count\f1 messages will be retrieved. The default is 0.
   20.76 +.TP
   20.77 +
   20.78 +\fBwrapper\f1 = \fIcommand\f1
   20.79 +
   20.80 +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.
   20.81 +
   20.82 +Example for ssl tunneling:
   20.83 +
   20.84 +wrapper="/usr/bin/openssl s_client -quiet -connect pop.gmx.net:995 2>/dev/null"
   20.85 +.SH AUTHOR
   20.86 +
   20.87 +masqmail was written by Oliver Kurth <oku@masqmail.cx>
   20.88 +
   20.89 +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.
   20.90 +
   20.91 +.SH BUGS
   20.92 +
   20.93 +You should report them to the mailing list.
   20.94 +
   20.95 +.SH SEE ALSO
   20.96 +
   20.97 +\fBmasqmail (8)\f1, \fBmasqmail.route (5)\f1, \fBmasqmail.conf (5)\f1
   20.98 +
   20.99 +.SH COMMENTS
  20.100 +
  20.101 +This man page was written using \fBxml2man (1)\f1 by the same author.
  20.102 +

    21.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    21.2 +++ b/docs/masqmail.route.5	Fri Sep 26 21:40:10 2008 +0200
    21.3 @@ -0,0 +1,212 @@
    21.4 +.TH masqmail.route 5 User Manuals
    21.5 +.SH NAME
    21.6 +masqmail.route \- masqmail route configuration file
    21.7 +.SH DESCRIPTION
    21.8 +
    21.9 +This man page describes the syntax of the route configuration files of \fBmasqmail (8)\f1. Their usual locations are in \fI/etc/masqmail/\f1.
   21.10 +
   21.11 +.SH OPTIONS
   21.12 +.TP
   21.13 +
   21.14 +\fBprotocol\f1 = \fIstring\f1
   21.15 +
   21.16 +\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.
   21.17 +.TP
   21.18 +
   21.19 +\fBmail_host\f1 = \fIstring\f1
   21.20 +
   21.21 +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.
   21.22 +
   21.23 +You can optionally give a port number following the host name and a colon, eg mail_host="mail.foo.com:25".
   21.24 +.TP
   21.25 +
   21.26 +\fBresolve_list\f1 = \fIlist\f1
   21.27 +
   21.28 +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.
   21.29 +
   21.30 +The default is "dns_mx;dns_a;byname".
   21.31 +.TP
   21.32 +
   21.33 +\fBconnect_error_fail\f1 = \fIboolean\f1
   21.34 +
   21.35 +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.
   21.36 +
   21.37 +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.
   21.38 +
   21.39 +For the default local_net route is is set to true.
   21.40 +.TP
   21.41 +
   21.42 +\fBhelo_name\f1 = \fIstring\f1
   21.43 +
   21.44 +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.
   21.45 +.TP
   21.46 +
   21.47 +\fBdo_correct_helo\f1 = \fIboolean\f1
   21.48 +
   21.49 +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.
   21.50 +.TP
   21.51 +
   21.52 +\fBdo_pipelining\f1 = \fIboolean\f1
   21.53 +
   21.54 +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.
   21.55 +
   21.56 +You do not want to set this to false unless the mail setup on the remote server side is really broken. Keywords: wingate.
   21.57 +.TP
   21.58 +
   21.59 +\fBallowed_mail_locals\f1 = \fIlist\f1
   21.60 +
   21.61 +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.
   21.62 +.TP
   21.63 +
   21.64 +\fBnot_allowed_mail_locals\f1 = \fIlist\f1
   21.65 +
   21.66 +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).
   21.67 +.TP
   21.68 +
   21.69 +\fBallowed_return_paths\f1 = \fIlist\f1
   21.70 +
   21.71 +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).
   21.72 +
   21.73 +Patterns containing '?' and '*' can be used. The special item "<>" matches the null sender address (eg. failure notices or delivery notifications).
   21.74 +.TP
   21.75 +
   21.76 +\fBnot_allowed_return_paths\f1 = \fIlist\f1
   21.77 +
   21.78 +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).
   21.79 +
   21.80 +Patterns containing '?' and '*' can be used. The special item "<>" matches the null sender address (eg. failure notices or delivery notifications).
   21.81 +.TP
   21.82 +
   21.83 +\fBallowed_rcpt_domains\f1 = \fIlist\f1
   21.84 +
   21.85 +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.
   21.86 +.TP
   21.87 +
   21.88 +\fBnot_allowed_rcpt_domains\f1 = \fIlist\f1
   21.89 +
   21.90 +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.
   21.91 +.TP
   21.92 +
   21.93 +\fBset_h_from_domain\f1 = \fIstring\f1
   21.94 +
   21.95 +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.
   21.96 +.TP
   21.97 +
   21.98 +\fBset_return_path_domain\f1 = \fIstring\f1
   21.99 +
  21.100 +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.
  21.101 +.TP
  21.102 +
  21.103 +\fBmap_h_from_addresses\f1 = \fIlist\f1
  21.104 +
  21.105 +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 (':').
  21.106 +
  21.107 +Example:
  21.108 +
  21.109 +map_h_from_addresses = "john: John Smith <jsmith@mail.academic.edu>; charlie: Charlie Miller <cmiller@mx.commercial.com>"
  21.110 +
  21.111 +You can use patterns, eg. * as keys.
  21.112 +.TP
  21.113 +
  21.114 +\fBmap_h_reply_to_addresses\f1 = \fIlist\f1
  21.115 +
  21.116 +Same as \fBmap_h_from_addresses\f1, but for the 'Reply-To:' header.
  21.117 +.TP
  21.118 +
  21.119 +\fBmap_h_mail_followup_to_addresses\f1 = \fIlist\f1
  21.120 +
  21.121 +Same as \fBmap_h_from_addresses\f1, but for the 'Mail-Followup-To:' header. Useful when replying to mailing lists.
  21.122 +.TP
  21.123 +
  21.124 +\fBmap_return_path_addresses\f1 = \fIlist\f1
  21.125 +
  21.126 +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.
  21.127 +
  21.128 +Example:
  21.129 +
  21.130 +map_return_path_addresses = "john: <jsmith@mail.academic.edu>; charlie: <cmiller@mx.commercial.com>"
  21.131 +
  21.132 +You can use patterns, eg. * as keys.
  21.133 +.TP
  21.134 +
  21.135 +\fBexpand_h_sender_address\f1 = \fIboolean\f1
  21.136 +
  21.137 +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.
  21.138 +.TP
  21.139 +
  21.140 +\fBexpand_h_sender_domain\f1 = \fIboolean\f1
  21.141 +
  21.142 +Like \fBexpand_h_sender_address\f1, but sets the domain only. Deprecated, will be removed in a later version.
  21.143 +.TP
  21.144 +
  21.145 +\fBlast_route\f1 = \fIboolean\f1
  21.146 +
  21.147 +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.
  21.148 +
  21.149 +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.
  21.150 +
  21.151 +Default is false.
  21.152 +.TP
  21.153 +
  21.154 +\fBauth_name\f1 = \fIstring\f1
  21.155 +
  21.156 +Set the authentication type for ESMTP AUTH authentification. Currently only 'cram-md5' and 'login' are supported.
  21.157 +.TP
  21.158 +
  21.159 +\fBauth_login\f1 = \fIstring\f1
  21.160 +
  21.161 +Your account name for ESMTP AUTH authentification.
  21.162 +.TP
  21.163 +
  21.164 +\fBauth_secret\f1 = \fIstring\f1
  21.165 +
  21.166 +Your secret for ESMTP AUTH authentification.
  21.167 +.TP
  21.168 +
  21.169 +\fBpop3_login\f1 = \fIfile\f1
  21.170 +
  21.171 +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.
  21.172 +.TP
  21.173 +
  21.174 +\fBwrapper\f1 = \fIcommand\f1
  21.175 +
  21.176 +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.
  21.177 +
  21.178 +Example for ssl tunneling:
  21.179 +
  21.180 +wrapper="/usr/bin/openssl s_client -quiet -connect pop.gmx.net:995 2>/dev/null"
  21.181 +.TP
  21.182 +
  21.183 +\fBpipe\f1 = \fIcommand\f1
  21.184 +
  21.185 +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.
  21.186 +
  21.187 +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.
  21.188 +.TP
  21.189 +
  21.190 +\fBpipe_fromline = \fIboolean\f1\fB\f1
  21.191 +
  21.192 +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.
  21.193 +.TP
  21.194 +
  21.195 +\fBpipe_fromhack = \fIboolean\f1\fB\f1
  21.196 +
  21.197 +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.
  21.198 +.SH AUTHOR
  21.199 +
  21.200 +masqmail was written by Oliver Kurth <oku@masqmail.cx>
  21.201 +
  21.202 +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.
  21.203 +
  21.204 +.SH BUGS
  21.205 +
  21.206 +You should report them to the mailing list.
  21.207 +
  21.208 +.SH SEE ALSO
  21.209 +
  21.210 +\fBmasqmail (8)\f1, \fBmasqmail.conf (5)\f1, \fBmasqmail.get (5)\f1
  21.211 +
  21.212 +.SH COMMENTS
  21.213 +
  21.214 +This man page was written using \fBxml2man (1)\f1 by the same author.
  21.215 +

    22.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    22.2 +++ b/docs/mservdetect.8	Fri Sep 26 21:40:10 2008 +0200
    22.3 @@ -0,0 +1,42 @@
    22.4 +.TH mservdetect 8 User Manuals
    22.5 +.SH NAME
    22.6 +mservdetect \- Helper for masqmail and masqdialer
    22.7 +.SH SYNOPSIS
    22.8 +\fB/usr/bin/masqmail \fIhost\f1\fB \fIport\f1\fB
    22.9 +
   22.10 +\fB
   22.11 +.SH DESCRIPTION
   22.12 +
   22.13 +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.
   22.14 +
   22.15 +If you want to use it, set \fBonline_detect\f1=\fIpipe\f1 and \fBonline_pipe\f1=\fI"/usr/bin/mservdetect host port"\f1.
   22.16 +
   22.17 +.SH OPTIONS
   22.18 +.TP
   22.19 +
   22.20 +\fBhost\f1
   22.21 +
   22.22 +The hostname where the masqdialer server is running.
   22.23 +.TP
   22.24 +
   22.25 +\fBport\f1
   22.26 +
   22.27 +The port number where the masqdialer server is listening.
   22.28 +.SH AUTHOR
   22.29 +
   22.30 +masqmail was written by Oliver Kurth <oku@masqmail.cx>
   22.31 +
   22.32 +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.
   22.33 +
   22.34 +.SH BUGS
   22.35 +
   22.36 +You should report them to the mailing list.
   22.37 +
   22.38 +.SH SEE ALSO
   22.39 +
   22.40 +\fBmasqmail.conf (5)\f1
   22.41 +
   22.42 +.SH COMMENTS
   22.43 +
   22.44 +This man page was written using \fBxml2man (1)\f1 by the same author.
   22.45 +

    23.1 --- a/docs/xml/Makefile.am	Fri Sep 26 21:26:36 2008 +0200
    23.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    23.3 @@ -1,1 +0,0 @@
    23.4 -EXTRA_DIST = *.xml

    24.1 --- a/docs/xml/Makefile.in	Fri Sep 26 21:26:36 2008 +0200
    24.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    24.3 @@ -1,268 +0,0 @@
    24.4 -# Makefile.in generated by automake 1.7.9 from Makefile.am.
    24.5 -# @configure_input@
    24.6 -
    24.7 -# Copyright 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003
    24.8 -# Free Software Foundation, Inc.
    24.9 -# This Makefile.in is free software; the Free Software Foundation
   24.10 -# gives unlimited permission to copy and/or distribute it,
   24.11 -# with or without modifications, as long as this notice is preserved.
   24.12 -
   24.13 -# This program is distributed in the hope that it will be useful,
   24.14 -# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
   24.15 -# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
   24.16 -# PARTICULAR PURPOSE.
   24.17 -
   24.18 -@SET_MAKE@
   24.19 -
   24.20 -srcdir = @srcdir@
   24.21 -top_srcdir = @top_srcdir@
   24.22 -VPATH = @srcdir@
   24.23 -pkgdatadir = $(datadir)/@PACKAGE@
   24.24 -pkglibdir = $(libdir)/@PACKAGE@
   24.25 -pkgincludedir = $(includedir)/@PACKAGE@
   24.26 -top_builddir = ../..
   24.27 -
   24.28 -am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
   24.29 -INSTALL = @INSTALL@
   24.30 -install_sh_DATA = $(install_sh) -c -m 644
   24.31 -install_sh_PROGRAM = $(install_sh) -c
   24.32 -install_sh_SCRIPT = $(install_sh) -c
   24.33 -INSTALL_HEADER = $(INSTALL_DATA)
   24.34 -transform = $(program_transform_name)
   24.35 -NORMAL_INSTALL = :
   24.36 -PRE_INSTALL = :
   24.37 -POST_INSTALL = :
   24.38 -NORMAL_UNINSTALL = :
   24.39 -PRE_UNINSTALL = :
   24.40 -POST_UNINSTALL = :
   24.41 -ACLOCAL = @ACLOCAL@
   24.42 -AMDEP_FALSE = @AMDEP_FALSE@
   24.43 -AMDEP_TRUE = @AMDEP_TRUE@
   24.44 -AMTAR = @AMTAR@
   24.45 -AUTOCONF = @AUTOCONF@
   24.46 -AUTOHEADER = @AUTOHEADER@
   24.47 -AUTOMAKE = @AUTOMAKE@
   24.48 -AWK = @AWK@
   24.49 -BASE64_LIBS = @BASE64_LIBS@
   24.50 -CC = @CC@
   24.51 -CCDEPMODE = @CCDEPMODE@
   24.52 -CFLAGS = @CFLAGS@
   24.53 -CPP = @CPP@
   24.54 -CPPFLAGS = @CPPFLAGS@
   24.55 -CYGPATH_W = @CYGPATH_W@
   24.56 -DEFS = @DEFS@
   24.57 -DEPDIR = @DEPDIR@
   24.58 -ECHO_C = @ECHO_C@
   24.59 -ECHO_N = @ECHO_N@
   24.60 -ECHO_T = @ECHO_T@
   24.61 -EGREP = @EGREP@
   24.62 -EXEEXT = @EXEEXT@
   24.63 -GLIB_CFLAGS = @GLIB_CFLAGS@
   24.64 -GLIB_LIBS = @GLIB_LIBS@
   24.65 -GREP = @GREP@
   24.66 -IDENT_LIBS = @IDENT_LIBS@
   24.67 -INSTALL_DATA = @INSTALL_DATA@
   24.68 -INSTALL_PROGRAM = @INSTALL_PROGRAM@
   24.69 -INSTALL_SCRIPT = @INSTALL_SCRIPT@
   24.70 -INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
   24.71 -LDFLAGS = @LDFLAGS@
   24.72 -LIBOBJS = @LIBOBJS@
   24.73 -LIBS = @LIBS@
   24.74 -LOCKFILE_LIBS = @LOCKFILE_LIBS@
   24.75 -LTLIBOBJS = @LTLIBOBJS@
   24.76 -MAKEINFO = @MAKEINFO@
   24.77 -MD5_LIBS = @MD5_LIBS@
   24.78 -OBJEXT = @OBJEXT@
   24.79 -PACKAGE = @PACKAGE@
   24.80 -PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
   24.81 -PACKAGE_NAME = @PACKAGE_NAME@
   24.82 -PACKAGE_STRING = @PACKAGE_STRING@
   24.83 -PACKAGE_TARNAME = @PACKAGE_TARNAME@
   24.84 -PACKAGE_VERSION = @PACKAGE_VERSION@
   24.85 -PATH_SEPARATOR = @PATH_SEPARATOR@
   24.86 -PKG_CONFIG = @PKG_CONFIG@
   24.87 -RANLIB = @RANLIB@
   24.88 -RESOLV_LIBS = @RESOLV_LIBS@
   24.89 -SET_MAKE = @SET_MAKE@
   24.90 -SHELL = @SHELL@
   24.91 -STRIP = @STRIP@
   24.92 -USE_LIBLOCKFILE = @USE_LIBLOCKFILE@
   24.93 -VERSION = @VERSION@
   24.94 -ac_ct_CC = @ac_ct_CC@
   24.95 -am__fastdepCC_FALSE = @am__fastdepCC_FALSE@
   24.96 -am__fastdepCC_TRUE = @am__fastdepCC_TRUE@
   24.97 -am__include = @am__include@
   24.98 -am__leading_dot = @am__leading_dot@
   24.99 -am__quote = @am__quote@
  24.100 -bindir = @bindir@
  24.101 -build_alias = @build_alias@
  24.102 -datadir = @datadir@
  24.103 -datarootdir = @datarootdir@
  24.104 -docdir = @docdir@
  24.105 -dvidir = @dvidir@
  24.106 -exec_prefix = @exec_prefix@
  24.107 -has_ident = @has_ident@
  24.108 -host_alias = @host_alias@
  24.109 -htmldir = @htmldir@
  24.110 -includedir = @includedir@
  24.111 -infodir = @infodir@
  24.112 -install_sh = @install_sh@
  24.113 -libdir = @libdir@
  24.114 -libexecdir = @libexecdir@
  24.115 -localedir = @localedir@
  24.116 -localstatedir = @localstatedir@
  24.117 -mandir = @mandir@
  24.118 -oldincludedir = @oldincludedir@
  24.119 -pdfdir = @pdfdir@
  24.120 -prefix = @prefix@
  24.121 -program_transform_name = @program_transform_name@
  24.122 -psdir = @psdir@
  24.123 -sbindir = @sbindir@
  24.124 -sharedstatedir = @sharedstatedir@
  24.125 -sysconfdir = @sysconfdir@
  24.126 -target_alias = @target_alias@
  24.127 -with_confdir = @with_confdir@
  24.128 -with_group = @with_group@
  24.129 -with_logdir = @with_logdir@
  24.130 -with_spooldir = @with_spooldir@
  24.131 -with_user = @with_user@
  24.132 -EXTRA_DIST = *.xml
  24.133 -subdir = docs/xml
  24.134 -ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
  24.135 -mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
  24.136 -CONFIG_HEADER = $(top_builddir)/config.h
  24.137 -CONFIG_CLEAN_FILES =
  24.138 -DIST_SOURCES =
  24.139 -DIST_COMMON = $(srcdir)/Makefile.in Makefile.am
  24.140 -all: all-am
  24.141 -
  24.142 -.SUFFIXES:
  24.143 -$(srcdir)/Makefile.in:  Makefile.am  $(top_srcdir)/configure.ac $(ACLOCAL_M4)
  24.144 -	cd $(top_srcdir) && \
  24.145 -	  $(AUTOMAKE) --gnu  docs/xml/Makefile
  24.146 -Makefile:  $(srcdir)/Makefile.in  $(top_builddir)/config.status
  24.147 -	cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)
  24.148 -uninstall-info-am:
  24.149 -tags: TAGS
  24.150 -TAGS:
  24.151 -
  24.152 -ctags: CTAGS
  24.153 -CTAGS:
  24.154 -
  24.155 -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
  24.156 -
  24.157 -top_distdir = ../..
  24.158 -distdir = $(top_distdir)/$(PACKAGE)-$(VERSION)
  24.159 -
  24.160 -distdir: $(DISTFILES)
  24.161 -	@srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \
  24.162 -	topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \
  24.163 -	list='$(DISTFILES)'; for file in $$list; do \
  24.164 -	  case $$file in \
  24.165 -	    $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \
  24.166 -	    $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \
  24.167 -	  esac; \
  24.168 -	  if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
  24.169 -	  dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \
  24.170 -	  if test "$$dir" != "$$file" && test "$$dir" != "."; then \
  24.171 -	    dir="/$$dir"; \
  24.172 -	    $(mkinstalldirs) "$(distdir)$$dir"; \
  24.173 -	  else \
  24.174 -	    dir=''; \
  24.175 -	  fi; \
  24.176 -	  if test -d $$d/$$file; then \
  24.177 -	    if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
  24.178 -	      cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \
  24.179 -	    fi; \
  24.180 -	    cp -pR $$d/$$file $(distdir)$$dir || exit 1; \
  24.181 -	  else \
  24.182 -	    test -f $(distdir)/$$file \
  24.183 -	    || cp -p $$d/$$file $(distdir)/$$file \
  24.184 -	    || exit 1; \
  24.185 -	  fi; \
  24.186 -	done
  24.187 -check-am: all-am
  24.188 -check: check-am
  24.189 -all-am: Makefile
  24.190 -
  24.191 -installdirs:
  24.192 -install: install-am
  24.193 -install-exec: install-exec-am
  24.194 -install-data: install-data-am
  24.195 -uninstall: uninstall-am
  24.196 -
  24.197 -install-am: all-am
  24.198 -	@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
  24.199 -
  24.200 -installcheck: installcheck-am
  24.201 -install-strip:
  24.202 -	$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
  24.203 -	  install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
  24.204 -	  `test -z '$(STRIP)' || \
  24.205 -	    echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
  24.206 -mostlyclean-generic:
  24.207 -
  24.208 -clean-generic:
  24.209 -
  24.210 -distclean-generic:
  24.211 -	-rm -f $(CONFIG_CLEAN_FILES)
  24.212 -
  24.213 -maintainer-clean-generic:
  24.214 -	@echo "This command is intended for maintainers to use"
  24.215 -	@echo "it deletes files that may require special tools to rebuild."
  24.216 -clean: clean-am
  24.217 -
  24.218 -clean-am: clean-generic mostlyclean-am
  24.219 -
  24.220 -distclean: distclean-am
  24.221 -	-rm -f Makefile
  24.222 -distclean-am: clean-am distclean-generic
  24.223 -
  24.224 -dvi: dvi-am
  24.225 -
  24.226 -dvi-am:
  24.227 -
  24.228 -info: info-am
  24.229 -
  24.230 -info-am:
  24.231 -
  24.232 -install-data-am:
  24.233 -
  24.234 -install-exec-am:
  24.235 -
  24.236 -install-info: install-info-am
  24.237 -
  24.238 -install-man:
  24.239 -
  24.240 -installcheck-am:
  24.241 -
  24.242 -maintainer-clean: maintainer-clean-am
  24.243 -	-rm -f Makefile
  24.244 -maintainer-clean-am: distclean-am maintainer-clean-generic
  24.245 -
  24.246 -mostlyclean: mostlyclean-am
  24.247 -
  24.248 -mostlyclean-am: mostlyclean-generic
  24.249 -
  24.250 -pdf: pdf-am
  24.251 -
  24.252 -pdf-am:
  24.253 -
  24.254 -ps: ps-am
  24.255 -
  24.256 -ps-am:
  24.257 -
  24.258 -uninstall-am: uninstall-info-am
  24.259 -
  24.260 -.PHONY: all all-am check check-am clean clean-generic distclean \
  24.261 -	distclean-generic distdir dvi dvi-am info info-am install \
  24.262 -	install-am install-data install-data-am install-exec \
  24.263 -	install-exec-am install-info install-info-am install-man \
  24.264 -	install-strip installcheck installcheck-am installdirs \
  24.265 -	maintainer-clean maintainer-clean-generic mostlyclean \
  24.266 -	mostlyclean-generic pdf pdf-am ps ps-am uninstall uninstall-am \
  24.267 -	uninstall-info-am
  24.268 -
  24.269 -# Tell versions [3.59,3.63) of GNU make to not export all variables.
  24.270 -# Otherwise a system limit (for SysV at least) may be exceeded.
  24.271 -.NOEXPORT:

    25.1 --- a/docs/xml/masqmail.8.xml	Fri Sep 26 21:26:36 2008 +0200
    25.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    25.3 @@ -1,302 +0,0 @@
    25.4 -<?xml version="1.0" standalone='no'?>
    25.5 -<!DOCTYPE spec SYSTEM "man.dtd">
    25.6 -
    25.7 -<manpage name="masqmail" section="8" desc="An offline Mail Transfer Agent">
    25.8 -
    25.9 -<synopsis>
   25.10 -<cmd>/usr/sbin/masqmail [-C <arg>file</arg>] [-odq] [-bd] [-q<arg>interval</arg>]</cmd>
   25.11 -<cmd>/usr/sbin/masqmail [-odq] [-bs]</cmd>
   25.12 -<cmd>/usr/sbin/masqmail [-bp]</cmd>
   25.13 -<cmd>/usr/sbin/masqmail [-q]</cmd>
   25.14 -<cmd>/usr/sbin/masqmail [-qo [<arg>name</arg>]]</cmd>
   25.15 -<cmd>/usr/sbin/masqmail [-odq] [-g [<arg>name</arg>]]</cmd>
   25.16 -<cmd>/usr/sbin/masqmail [-odq] [-go [<arg>name</arg>]]</cmd>
   25.17 -<cmd>/usr/sbin/masqmail [-t] [-oi] [-f <arg>address</arg>] [--] <arg>address...</arg></cmd>
   25.18 -<cmd>/usr/sbin/mailq</cmd>
   25.19 -</synopsis>
   25.20 -
   25.21 -<description>
   25.22 -<p>MasqMail is a mail server designed for hosts that do
   25.23 -not have a permanent internet connection eg. a home network or a
   25.24 -single host at home. It has special support for connections to
   25.25 -different ISPs. It replaces sendmail or other MTAs such as qmail or
   25.26 -exim. It can also act as a pop3 client.</p>
   25.27 -</description>
   25.28 -
   25.29 -<options>
   25.30 -<p>Since masqmail is intended to replace sendmail, it uses the same
   25.31 -command line options, but not all are implemented. There are also two
   25.32 -additional options, which are unique to masqmail (-qo <arg>connection</arg> and -g)
   25.33 -</p>
   25.34 -
   25.35 -<option>
   25.36 -<p><opt>--</opt></p>
   25.37 -<optdesc><p>Not a 'real' option, it means that all following arguments are to
   25.38 -be understood as arguments and not as options even if they begin with a
   25.39 -leading dash '-'. Mutt is known to call sendmail with this option.</p></optdesc>
   25.40 -</option>
   25.41 -
   25.42 -<option>
   25.43 -<p><opt>-bd</opt></p>
   25.44 -<optdesc><p>Run as daemon, accepting connections, usually on port 25 if not
   25.45 -configured differently. This is usually used in the startup script at system boot and
   25.46 -together with the -q option (see below).</p></optdesc>
   25.47 -</option>
   25.48 -
   25.49 -<option>
   25.50 -<p><opt>-bi</opt></p>
   25.51 -<optdesc><p>Old sendmail rebuilds its alias database when invoked with this
   25.52 -option. Masqmail ignores it. Masqmail reads directly from the file
   25.53 -given with <b>alias_file</b> in the config file.</p></optdesc>
   25.54 -</option>
   25.55 -
   25.56 -<option>
   25.57 -<p><opt>-bp</opt></p>
   25.58 -<optdesc><p>Show the messages in the queue. Same as calling masqmail as
   25.59 -'mailq'.</p></optdesc>
   25.60 -</option>
   25.61 -
   25.62 -<option>
   25.63 -<p><opt>-bs</opt></p>
   25.64 -<optdesc><p>Accept SMTP commands from stdin. Some mailers (eg pine) use this
   25.65 -option as an interface. It can also be used to call masqmail from
   25.66 -inetd.</p></optdesc>
   25.67 -</option>
   25.68 -
   25.69 -<option>
   25.70 -<p><opt>-B <arg>arg</arg></opt></p>
   25.71 -<optdesc><p><arg>arg</arg> is usually 8BITMIME. Some mailers use this
   25.72 -to indicate that the message contains characters &gt; 127. Masqmail is
   25.73 -8-bit clean and ignores this, so you do not have to recompile elm,
   25.74 -which is very painful ;-). Note though that this violates some
   25.75 -conventions: masqmail <em>does not</em> convert 8 bit messages to any
   25.76 -MIME format if it encounters a mail server which does not advertise
   25.77 -its 8BITMIME capability, masqmail does not advertise this itself. This
   25.78 -is the same practice as that of exim (but different to
   25.79 -sendmail).</p></optdesc></option>
   25.80 -
   25.81 -<option>
   25.82 -<p><opt>-bV </opt></p>
   25.83 -<optdesc><p>Show version information.</p>
   25.84 -</optdesc>
   25.85 -</option>
   25.86 -
   25.87 -<option>
   25.88 -<p><opt>-C </opt><arg>filename</arg></p>
   25.89 -<optdesc><p>Use another configuration than <file>/etc/masqmail/masqmail.conf</file>. Useful for
   25.90 -debugging purposes. If not invoked by a privileged user, masqmail will drop all privileges.
   25.91 -</p></optdesc>
   25.92 -</option>
   25.93 -
   25.94 -<option>
   25.95 -<p><opt>-d <arg>number</arg></opt></p>
   25.96 -<optdesc>
   25.97 -<p>Set the debug level. This takes precedence before the value of
   25.98 -<b>debug_level</b> in the configuration file. Read the warning in the
   25.99 -description of the latter.
  25.100 -</p>
  25.101 -</optdesc>
  25.102 -</option>
  25.103 -
  25.104 -<option>
  25.105 -<p><opt>-f [<arg>address</arg>]</opt></p>
  25.106 -<optdesc>
  25.107 -<p>Set the return path address to <arg>address</arg>. Only root, the
  25.108 -user mail and anyoune in group trusted is allowed to do that.</p>
  25.109 -</optdesc>
  25.110 -</option>
  25.111 -
  25.112 -<option>
  25.113 -<p><opt>-F [<arg>string</arg>]</opt></p>
  25.114 -<optdesc>
  25.115 -<p>Set the full sender name (in the From: header)
  25.116 -to <arg>string</arg>.</p>
  25.117 -</optdesc>
  25.118 -</option>
  25.119 -
  25.120 -<option>
  25.121 -<p><opt>-g [<arg>name</arg>]</opt></p>
  25.122 -<optdesc>
  25.123 -<p>Get mail (using pop3 or apop), using the configurations given
  25.124 -with <b>get.<arg>name</arg></b> in the main configuration. Without <arg>name</arg>,
  25.125 -all get configurations will be used. See also <manref
  25.126 -name = "masqmail.get" section="5" href="masqmail.get.5.html"/></p>
  25.127 -</optdesc>
  25.128 -</option>
  25.129 -
  25.130 -<option>
  25.131 -<p><opt>-go [<arg>interval</arg>] [<arg>name</arg>]</opt></p>
  25.132 -<optdesc>
  25.133 -<p>Can be followed by a connection name. Use this option in your
  25.134 -script which starts as soon as a link to the internet has been set up
  25.135 -(usually ip-up). When masqmail is called with this option, the
  25.136 -specified get configuration(s) is(are) read and mail will be
  25.137 -retrieved from servers on the internet.
  25.138 -The <arg>name</arg> is defined
  25.139 -in the configuration (see <opt>online_gets.<arg>name</arg></opt>).
  25.140 -</p><p>
  25.141 -If called with an interval option (recognized by a digit
  25.142 -as the first characater), masqmail starts as a daemon and tries to
  25.143 -get mail in these intervals. It checks for the online status first.
  25.144 -Example: masqmail -go 5m will retrieve mail
  25.145 -all five minutes.
  25.146 -</p><p>
  25.147 -If called without <arg>name</arg> the online status is determined with
  25.148 -the configured method (see <opt>online_detect</opt> in <a
  25.149 -href="config.html">config.html</a>).
  25.150 -</p>
  25.151 -</optdesc>
  25.152 -</option>
  25.153 -
  25.154 -<option>
  25.155 -<p><opt>-i</opt></p>
  25.156 -<optdesc><p>Same as <b>-oi</b>, see below.</p></optdesc>
  25.157 -</option>
  25.158 -
  25.159 -<option>
  25.160 -<p><opt>-Mrm <arg>list</arg></opt></p>
  25.161 -<optdesc><p>Remove given messages from the queue. Only allowed for privileged users.</p></optdesc>
  25.162 -</option>
  25.163 -
  25.164 -<option>
  25.165 -<p><opt>-oem</opt></p>
  25.166 -<optdesc><p>If the <b>-oi</b> ist not also given, always return with a non zero
  25.167 -return code. Maybe someone tells me what this is good for...</p></optdesc>
  25.168 -</option>
  25.169 -
  25.170 -<option>
  25.171 -<p><opt>-odb</opt></p>
  25.172 -<optdesc><p>Deliver in background. Masqmail always does this, which
  25.173 -makes this option pretty much useless.</p></optdesc>
  25.174 -</option>
  25.175 -
  25.176 -<option>
  25.177 -<p><opt>-odq</opt></p>
  25.178 -<optdesc><p>Do not attempt to deliver immediately. Any messages will be queued
  25.179 -until the next queue running process picks them up and delivers
  25.180 -them. You get the same effect by setting the <i>do_queue</i> option in
  25.181 -/etc/masqmail/masqmail.conf.</p></optdesc>
  25.182 -</option>
  25.183 -
  25.184 -<option>
  25.185 -<p><opt>-oi</opt></p>
  25.186 -<optdesc><p>A dot as a single character in a line does <em>not</em> terminate
  25.187 -the message.</p></optdesc>
  25.188 -</option>
  25.189 -
  25.190 -<option>
  25.191 -<p><opt>-q [<arg>interval</arg>]</opt></p>
  25.192 -<optdesc><p>If not given with an argument, run a queue process, ie. try to
  25.193 -deliver all messages in the queue. Masqmail sends only to those
  25.194 -addresses that are on the <em>local</em> net, not to those that are
  25.195 -outside. Use -qo for those.</p>
  25.196 -<p>
  25.197 -If you have configured inetd to start masqmail, you can use this
  25.198 -option in a cron job which starts in regular time intervals, to mimic
  25.199 -the same effect as starting masqmail with -bd -q30m.
  25.200 -</p><p>
  25.201 -An argument may be a time interval ie. a numerical value followed
  25.202 -by one of the letters. s,m,h,d,w which are interpreted as seconds,
  25.203 -minutes, hours, days or weeks respectively. Example: -q30m. Masqmail
  25.204 -starts as a daemon and a queue runner process will be started
  25.205 -automatically once in this time interval. This is usually used
  25.206 -together with -bd (see above).
  25.207 -</p>
  25.208 -</optdesc>
  25.209 -</option>
  25.210 -
  25.211 -<option>
  25.212 -<p><opt>-qo [<arg>name</arg>]</opt></p>
  25.213 -<optdesc>
  25.214 -<p>Can be followed by a connection name. Use this option in your
  25.215 -script which starts as soon as a link to the internet has been set up
  25.216 -(usually ip-up). When masqmail is called with this option, the
  25.217 -specified route configuration is read and the queued mail with
  25.218 -destinations on the internet will be sent. The <arg>name</arg> is defined
  25.219 -in the configuration (see <opt>online_routes.<arg>name</arg></opt>).
  25.220 -</p><p>
  25.221 -If called without <arg>name</arg> the online status is determined with
  25.222 -the configured method (see <opt>online_detect</opt> in <a
  25.223 -href="config.html">config.html</a>)
  25.224 -</p>
  25.225 -</optdesc>
  25.226 -</option>
  25.227 -
  25.228 -<option>
  25.229 -<p><opt>-t</opt></p>
  25.230 -<optdesc><p>Read recipients from headers. Delete 'Bcc:' headers. If any
  25.231 -arguments are given, these are interpreted as recipient addresses and
  25.232 -the message will <em>not</em> be sent to these.</p></optdesc>
  25.233 -</option>
  25.234 -
  25.235 -<option>
  25.236 -<p><opt>-v</opt></p>
  25.237 -<optdesc><p>Log also to stdout. Currently, some log messages are
  25.238 -marked as 'write to stdout' and additionally, all messages with
  25.239 -priority 'LOG_ALERT' and 'LOG_WARNING' will be written to stdout
  25.240 -if this option is given. It is disabled in daemon mode.
  25.241 -</p></optdesc>
  25.242 -</option>
  25.243 -
  25.244 -</options>
  25.245 -
  25.246 -<section name = "Environment for pipes and mdas">
  25.247 -
  25.248 -<p>For security reasons, before any pipe command from an alias
  25.249 -expansion or an mda is called, the environment variables will be
  25.250 -completely discarded and newly set up. These are:</p>
  25.251 -<p>SENDER, RETURN_PATH - the return path.</p>
  25.252 -<p>SENDER_DOMAIN - the domain part of the return path.</p>
  25.253 -<p>SENDER_LOCAL - the local part of the return path.</p>
  25.254 -<p>RECEIVED_HOST - the host the message was received from (unless local).</p>
  25.255 -<p>LOCAL_PART, USER, LOGNAME - the local part of the (original) recipient.</p>
  25.256 -<p>MESSAGE_ID - the unique message id. This is not necessarily identical with the Message ID as given in the Message ID: header.</p>
  25.257 -<p>QUALIFY_DOMAIN - the domain which will be appended to unqualified addresses.</p>
  25.258 -
  25.259 -</section>
  25.260 -
  25.261 -<section name = "Files">
  25.262 -<p><file>/etc/masqmail/masqmail.conf</file> is the main configuration
  25.263 -for masqmail. Depending on the settings in this file, you will also
  25.264 -have other configuration files in <file>/etc/masqmail/</file>.</p>
  25.265 -<p><file>/etc/aliases</file> is the alias file, if not set differently
  25.266 -in <file>/etc/masqmail/masqmail.conf</file>.</p>
  25.267 -<p><file>/var/spool/masqmail/</file> is the spool directory where masqmail
  25.268 -stores its spooled messages and the uniq pop ids.</p>
  25.269 -<p><file>/var/spool/mail/</file> is the directory where locally delivered mail will be put, if not configured differently in <file>masqmail.conf</file>.</p>
  25.270 -<p><file>/var/log/masqmail/</file> is the directory where masqmail stores
  25.271 -its log mesages. This can also be somewhere else if configured
  25.272 -differently by your sysadmin or the package mantainer.</p>
  25.273 -</section>
  25.274 -
  25.275 -<section name="Conforming to">
  25.276 -<p><b>RFC 821, 822, 1869, 1870, 2197, 2554</b> (SMTP)</p>
  25.277 -<p><b>RFC 1725, 1939</b> (POP3)</p>
  25.278 -<p><b>RFC 1321</b> (MD5)</p>
  25.279 -<p><b>RFC 2195</b> (CRAM-MD5)</p>
  25.280 -</section>
  25.281 -
  25.282 -<section name = "Author">
  25.283 -<p>masqmail was written by Oliver Kurth
  25.284 -&lt;oku@masqmail.cx&gt;</p><p>You will find the newest version of
  25.285 -masqmail at <url href="http://masqmail.cx/masqmail/"/> or search for it
  25.286 -in freshmeat (<url href="http://www.freshmeat.net"/>). There is also a mailing list,
  25.287 -you will find information about it at masqmails main site.</p>
  25.288 -</section>
  25.289 -
  25.290 -<section name = "Bugs">
  25.291 -<p>You should report them to the mailing list.</p>
  25.292 -</section>
  25.293 -
  25.294 -<section name = "See also">
  25.295 -<p>
  25.296 -<manref name="masqmail.conf" section="5" href="masqmail.conf.5.html"/>, <manref name="masqmail.route" section="5" href="masqmail.route.5.html"/>, <manref name="masqmail.get" section="5" href="masqmail.get.5.html"/>, <manref name="masqmail.aliases" section="5" href="masqmail.aliases.5.html"/>
  25.297 -</p>
  25.298 -</section>
  25.299 -
  25.300 -<section name = "Comments">
  25.301 -<p>This man page was written using <manref name="xml2man" section="1"
  25.302 -href="http://masqmail.cx/xml2man/"/> by the same author.</p>
  25.303 -</section>
  25.304 -
  25.305 -</manpage>

    26.1 --- a/docs/xml/masqmail.aliases.5.xml	Fri Sep 26 21:26:36 2008 +0200
    26.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    26.3 @@ -1,63 +0,0 @@
    26.4 -<?xml version="1.0" standalone='no'?>
    26.5 -<!DOCTYPE spec SYSTEM "man.dtd">
    26.6 -
    26.7 -<manpage name="masqmail.aliases" section="5" desc="masqmail alias file format">
    26.8 -
    26.9 -<description>
   26.10 -<p>This man page describes the format of the masqmail alias file. Its usual location is <file>/etc/aliases</file>.</p>
   26.11 -</description>
   26.12 -
   26.13 -<section name="File Format">
   26.14 -<p>The alias file consists of lines of the form:</p>
   26.15 -<pre>
   26.16 -local_part: item1, item2, ...
   26.17 -</pre>
   26.18 -
   26.19 -<p>Items can be surrounded by quotes '"'. If within the quotes other
   26.20 -quotes are needed for an address they can be escaped with a leading
   26.21 -backslash '\'.</p>
   26.22 -
   26.23 -<p>A leading '\' indicates that this address shall not be further
   26.24 -expanded.</p>
   26.25 -
   26.26 -<p>A leading pipe symbol '|' indicates that the item shall be treated
   26.27 -as a pipe command. The content of the message will then be sent to the
   26.28 -standard input of a command. The command will run under the user id
   26.29 -and group id masqmail is running as. If quotes are needed, the pipe
   26.30 -symbol must appear <i>within</i> the quotes.</p>
   26.31 -
   26.32 -<p>Loops will be detected, the offending address will be ignored.</p>
   26.33 -
   26.34 -<p>Aliases will be expanded at <i>delivery</i> time. This means that
   26.35 -if there is a message still in the queue and you change any alias
   26.36 -which matches one of the recipient addresses, the change will have
   26.37 -effect next time a delivery is attemped.</p>
   26.38 -
   26.39 -<p>There is no need to restart masqmail or run any command when the
   26.40 -alias file has been changed.</p>
   26.41 -</section>
   26.42 -
   26.43 -<section name = "Author">
   26.44 -<p>masqmail was written by Oliver Kurth
   26.45 -&lt;oku@masqmail.cx&gt;</p><p>You will find the newest version of
   26.46 -masqmail at <url href="http://masqmail.cx/masqmail/"/> or search for it
   26.47 -in freshmeat (<url href="http://www.freshmeat.net"/>). There is also a mailing list,
   26.48 -you will find information about it at masqmails main site.</p>
   26.49 -</section>
   26.50 -
   26.51 -<section name = "Bugs">
   26.52 -<p>You should report them to the mailing list.</p>
   26.53 -</section>
   26.54 -
   26.55 -<section name = "See also">
   26.56 -<p>
   26.57 -<manref name="masqmail.conf" section="5" href="masqmail.conf.5.html"/>, <manref name="masqmail" section="8" href="masqmail.8.html"/>, 
   26.58 -</p>
   26.59 -</section>
   26.60 -
   26.61 -<section name = "Comments">
   26.62 -<p>This man page was written using <manref name="xml2man" section="1"
   26.63 - href="http://masqmail.cx/xml2man/"/> by the same author.</p>
   26.64 -</section>
   26.65 -
   26.66 -</manpage>

    27.1 --- a/docs/xml/masqmail.conf.5.xml	Fri Sep 26 21:26:36 2008 +0200
    27.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    27.3 @@ -1,561 +0,0 @@
    27.4 -<?xml version="1.0" standalone='no'?>
    27.5 -<!DOCTYPE spec SYSTEM "man.dtd">
    27.6 -
    27.7 -<manpage name="masqmail.conf" section="5" desc="masqmail configuration file">
    27.8 -
    27.9 -<description>
   27.10 -<p>This man page describes the syntax of the main configuration file
   27.11 -of masqmail. Its usual location is <file>/etc/masqmail/masqmail.conf</file></p>
   27.12 -
   27.13 -<p>The configuration consists of lines of the form</p>
   27.14 -
   27.15 -<p><opt>val</opt> = <arg>expression</arg></p>
   27.16 -
   27.17 -<p>Where <opt>val</opt> is a variable name and <arg>expression</arg> a string,
   27.18 -which can be quoted with '"'. If the expression is on multiple lines
   27.19 -or contains characters other than letters, digits or the characters
   27.20 -'.', '-', '_', '/', it <em>must</em> be quoted. You can use quotes inside quotes
   27.21 -by escaping them with a backslash.</p>
   27.22 -
   27.23 -<p>Each val has a <i>type</i>, which can be boolean, numeric, string
   27.24 -or list. A boolean variable can be set with one of the values 'on',
   27.25 -'yes', and 'true' or 'off', 'no' and 'false'. List items are separated
   27.26 -with ';'. For some values patterns (like '*','?') can be used. The
   27.27 -spaces before and after the '=' are optional.</p>
   27.28 -
   27.29 -<p>Most lists (exceptions: <opt>local_hosts</opt>,
   27.30 -<opt>local_nets</opt>, <opt>listen_addresses</opt>, <opt>online_routes</opt> and <opt>online_gets</opt>) accept
   27.31 -files. These will be recognized by a leading slash '/'. The contents
   27.32 -of these files will be included at the position of the file name,
   27.33 -there can be items or other files before and after the file entry. The
   27.34 -format of the files is different though, within these files each entry
   27.35 -is on another line. (And not separated by semicolons). This makes it
   27.36 -easy to include large lists which are common in different
   27.37 -configuration files, so they do not have to appear in every
   27.38 -configuration file.</p>
   27.39 -
   27.40 -<p>Blank lines and lines starting with '#' are ignored.</p>
   27.41 -
   27.42 -</description>
   27.43 -
   27.44 -<options>
   27.45 -<option>
   27.46 -<p><opt>run_as_user = <arg>boolean</arg></opt></p>
   27.47 -<optdesc>
   27.48 -<p>If this is set, masqmail runs with the user id of the user who
   27.49 -invoked it and never changes it. This is for debugging purposes 
   27.50 -<em>only</em>. If the user is not root, masqmail will not be able to
   27.51 -listen on a port &lt; 1024 and will not be able to deliver local mail
   27.52 -to others than the user.</p>
   27.53 -</optdesc>
   27.54 -</option>
   27.55 -
   27.56 -<option>
   27.57 -<p><opt>use_syslog = <arg>boolean</arg></opt></p>
   27.58 -<optdesc>
   27.59 -<p>If this is set, masqmail uses syslogd for logging. It uses facility
   27.60 -MAIL. You still have to set <opt>log_dir</opt> for debug files.</p>
   27.61 -</optdesc>
   27.62 -</option>
   27.63 -
   27.64 -<option>
   27.65 -<p><opt>debug_level = <arg>n</arg></opt></p>
   27.66 -<optdesc>
   27.67 -<p>Set the debug level. Valid values are 0 to 6, increasing it further
   27.68 -makes no difference. Be careful if you set this as high as 5 or higher,
   27.69 -the logs may very soon fill your hard drive.</p>
   27.70 -</optdesc>
   27.71 -</option>
   27.72 -
   27.73 -<option>
   27.74 -<p><opt>mail_dir = <arg>file</arg></opt></p>
   27.75 -<optdesc>
   27.76 -<p>The directory where local mail is stored,
   27.77 -usually <file>/var/spool/mail</file> or <file>/var/mail</file>.</p>
   27.78 -</optdesc>
   27.79 -</option>
   27.80 -
   27.81 -<option>
   27.82 -<p><opt>spool_dir = <arg>file</arg></opt></p>
   27.83 -<optdesc>
   27.84 -<p>The directory where masqmail stores its spool files (and later also
   27.85 -other stuff). It <em>must</em> have a subdirectory <file>input</file>.
   27.86 -Masqmail needs read and write permissions for this
   27.87 -directory. I suggest to use <file>/var/spool/masqmail</file>.</p>
   27.88 -</optdesc>
   27.89 -</option>
   27.90 -
   27.91 -<option>
   27.92 -<p><opt>host_name = <arg>string</arg></opt></p>
   27.93 -<optdesc>
   27.94 -<p>This is used in different places: Masqmail identifies itself in the
   27.95 -greeting banner on incoming connections and in the HELO/EHLO command
   27.96 -for outgoing connections with this name, it is used in the Received:
   27.97 -header and to qualify the sender of a locally originating message.</p>
   27.98 -
   27.99 -<p>If the string begins with a slash '/', it it assumed that it is a
  27.100 -filename, and the first line of this file will be used. Usually this will
  27.101 -be '/etc/mailname' to make masqmail conform to Debian policies.</p>
  27.102 -
  27.103 -<p>It is <em>not</em> used to find whether an address is local.
  27.104 -Use <opt>local_hosts</opt> for that.</p>
  27.105 -</optdesc>
  27.106 -</option>
  27.107 -
  27.108 -<option>
  27.109 -<p><opt>remote_port = <arg>n</arg></opt></p>
  27.110 -<optdesc>
  27.111 -<p>The remote port number to be used. This defaults to port 25.</p>
  27.112 -<p>This option is deprecated. Use <opt>host_name</opt> in the route
  27.113 -configuration instead. See <manref name="masqmail.route" section="5"
  27.114 -href="masqmail.route.5.html"/>.</p>
  27.115 -</optdesc>
  27.116 -</option>
  27.117 -
  27.118 -<option>
  27.119 -<p><opt>local_hosts = <arg>list</arg></opt></p>
  27.120 -<optdesc>
  27.121 -<p>A semicolon ';' separated list of hostnames which are considered
  27.122 -local. Normally you set it to "localhost;foo;foo.bar.com" if your host
  27.123 -has the fully qualified domain name 'foo.bar.com'.</p>
  27.124 -</optdesc>
  27.125 -</option>
  27.126 -
  27.127 -<option>
  27.128 -<p><opt>local_nets = <arg>list</arg></opt></p>
  27.129 -<optdesc>
  27.130 -<p>A semicolon ';' separated list of hostnames which are on the
  27.131 -'local' net. Delivery to these hosts is attempted immediately. You can
  27.132 -use patterns with '*', eg. "*.bar.com".</p>
  27.133 -</optdesc>
  27.134 -</option>
  27.135 -
  27.136 -<option>
  27.137 -<p><opt>local_addresses = <arg>list</arg></opt></p>
  27.138 -<optdesc>
  27.139 -<p>A semicolon ';' separated list of fully qualified email-addresses
  27.140 -which are considered local although their domain name part is not in
  27.141 -the list of <opt>local_hosts</opt>. </p>
  27.142 -<p>For example: There are two people working at your
  27.143 -LAN: person1@yourdomain and person2@yourdomain. But there are
  27.144 -other persons @yourdomain which are NOT local. So you can not put
  27.145 -yourdomain to the list of local_hosts. If person1 now wants
  27.146 -to write to person2@yourdomain and this mail should not leave the LAN
  27.147 -then you can put</p>
  27.148 -<p>local_addresses = "person1@yourdomain;person2@yourdomain"</p>
  27.149 -<p>to your masqmail.conf.</p>
  27.150 -</optdesc>
  27.151 -</option>
  27.152 -
  27.153 -<option>
  27.154 -<p><opt>not_local_addresses = <arg>list</arg></opt></p>
  27.155 -<optdesc>
  27.156 -<p>A semicolon ';' separated list of fully qualified email-addresses
  27.157 -which are considered not local although their domain name part is in
  27.158 -the list of <opt>local_hosts</opt>. </p>
  27.159 -<p>This ist the opposite of the previous case. The majority of addresses
  27.160 -of a specific domain are local. But some users are not. With this
  27.161 -option you can easily exclude these users.</p>
  27.162 -<p>Example:</p>
  27.163 -<p>local_hosts = "localhost;myhost;mydomain.net"</p>
  27.164 -<p>not_local_addresses = "eric@mydomain.net"</p>
  27.165 -</optdesc>
  27.166 -</option>
  27.167 -
  27.168 -<option>
  27.169 -<p><opt>listen_addresses = <arg>list</arg></opt></p>
  27.170 -<optdesc>
  27.171 -<p>A semicolon ';' separated list of interfaces on which connections
  27.172 -will be accepted. An interface ist defined by a hostname, optionally
  27.173 -followed by a colon ':' and a number for the port. If this is left out,
  27.174 -port 25 will be used.</p>
  27.175 -<p>You can set this to "localhost:25;foo:25" if your hostname is 'foo'.</p>
  27.176 -<p>Note that the names are resolved to IP addreses. If your host has
  27.177 -different names which resolve to the same IP, use only one of them,
  27.178 -otherwise you will get an error message.
  27.179 -</p>
  27.180 -</optdesc>
  27.181 -</option>
  27.182 -
  27.183 -<option>
  27.184 -<p><opt>do_save_envelope_to = <arg>boolean</arg></opt></p>
  27.185 -<optdesc>
  27.186 -<p>If this is set to true, a possibly existing Envelope-to: header in an
  27.187 -incoming mail which is received via either pop3 or smtp will be saved as
  27.188 -an X-Orig-Envelope-to: header.</p>
  27.189 -<p>This is useful if you retrieve mail from a pop3 server with either masqmail
  27.190 -or fetchmail, and the server supports Envelope-to: headers, and you want to make use
  27.191 -of those with a mail filtering tool, eg. procmail. It cannot be preserved because
  27.192 -masqmail sets such a header by itself.</p>
  27.193 -<p>Default is false.</p>
  27.194 -</optdesc>
  27.195 -</option>
  27.196 -
  27.197 -<option>
  27.198 -<p><opt>do_relay = <arg>boolean</arg></opt></p>
  27.199 -<optdesc>
  27.200 -<p>If this is set to false, mail with a return path that is not local and a
  27.201 -destination that is also not local will not be accepted via smtp and a 550
  27.202 -reply will be given. Default is true.</p>
  27.203 -<p>Note that this will not protect you from spammers using open relays, but from
  27.204 -users unable to set their address in their mail clients.</p>
  27.205 -</optdesc>
  27.206 -</option>
  27.207 -
  27.208 -<option>
  27.209 -<p><opt>do_queue = <arg>boolean</arg></opt></p>
  27.210 -<optdesc>
  27.211 -<p>If this is set, mail will not be delivered immediately when
  27.212 -accepted. Same as calling masqmail with the <opt>-odq</opt> option.</p>
  27.213 -</optdesc>
  27.214 -</option>
  27.215 -
  27.216 -<option>
  27.217 -<p><opt>online_routes.<arg>name</arg> = <arg>list</arg></opt></p>
  27.218 -<optdesc>
  27.219 -
  27.220 -<p>Replace <arg>name</arg> with a name to identify a connection. Set this
  27.221 -to a filename (or a list of filenames) for the special route configuration for that
  27.222 -connection. You will use that name to call masqmail with the
  27.223 - <opt>-qo</opt> option every time a connection to your ISP is set
  27.224 -up.</p>
  27.225 -
  27.226 -<p>Example: Your ISP has the name <i>FastNet</i>. Then you write the
  27.227 -following line in the main configuration:</p>
  27.228 -
  27.229 -<p><opt>online_routes.FastNet</opt> = <arg>"/etc/masqmail/fastnet.route"</arg></p>
  27.230 -
  27.231 -<p><file>/etc/masqmail/fastnet.route</file> is the route configuration
  27.232 -file, see <manref name="masqmail.route" section="5" href="masqmail.route.5.html"/>. As soon as a link to FastNet has been set up, you
  27.233 -call masqmail <opt>-qo</opt> <arg>FastNet</arg>. Masqmail will then
  27.234 -read the specified file and send the mails.</p>
  27.235 -
  27.236 -</optdesc>
  27.237 -</option>
  27.238 -
  27.239 -<option>
  27.240 -<p><opt>connect_route.<arg>name</arg> = <arg>list</arg></opt></p>
  27.241 -<optdesc>
  27.242 -<p>Old name for <opt>online_routes</opt>.</p>
  27.243 -</optdesc>
  27.244 -</option>
  27.245 -
  27.246 -
  27.247 -<option>
  27.248 -<p><opt>local_net_route = <arg>file</arg></opt></p>
  27.249 -<optdesc>
  27.250 -<p>This is similar to <opt>online_routes.<arg>name</arg></opt> but for the
  27.251 -local net. Recipient addresses that are in <b>local_nets</b> will be
  27.252 -routed using this route configuration. Main purpose is to define a
  27.253 -mail server with <b>mail_host</b> in your local network. In simple
  27.254 -environments this can be left unset. If unset, a default route
  27.255 -configuration will be used.</p>
  27.256 -</optdesc>
  27.257 -</option>
  27.258 -
  27.259 -<option>
  27.260 -<p><opt>alias_file = <arg>file</arg></opt></p>
  27.261 -<optdesc>
  27.262 -<p>Set this to the location of your alias file. If unset, no aliasing
  27.263 -will be done.</p>
  27.264 -</optdesc>
  27.265 -</option>
  27.266 -
  27.267 -<option>
  27.268 -<p><opt>alias_local_caseless = <arg>boolean</arg></opt></p>
  27.269 -<optdesc>
  27.270 -<p>If this is set, local parts in the alias file will be matched
  27.271 -disregarding upper/lower case.</p>
  27.272 -</optdesc>
  27.273 -</option>
  27.274 -
  27.275 -<option>
  27.276 -<p><opt>pipe_fromline = <arg>boolean</arg></opt></p>
  27.277 -<optdesc>
  27.278 -<p>If this is set, a from line will be prepended to the output stream whenever
  27.279 -a pipe command is called after an alias expansion. Default is false.</p>
  27.280 -</optdesc>
  27.281 -</option>
  27.282 -
  27.283 -<option>
  27.284 -<p><opt>pipe_fromhack = <arg>boolean</arg></opt></p>
  27.285 -<optdesc>
  27.286 -<p>If this is set, each line beginning with 'From ' is replaced with '>From ' whenever
  27.287 -a pipe command is called after an alias expansion. You probably want this if you have
  27.288 -set <opt>pipe_fromline</opt> above. Default is false.</p>
  27.289 -</optdesc>
  27.290 -</option>
  27.291 -
  27.292 -<option>
  27.293 -<p><opt>mbox_default = <arg>string</arg></opt></p>
  27.294 -<optdesc>
  27.295 -<p>The default local delivery method. Can be one of mbox, mda or
  27.296 -maildir (the latter only if maildir support is enabled at compile
  27.297 -time). Default is mbox. You can override this for each user by using
  27.298 -the <opt>mbox_users</opt>, <opt>mda_users</opt> or <opt>maildir_users</opt> options
  27.299 -(see below).
  27.300 -</p>
  27.301 -</optdesc>
  27.302 -</option>
  27.303 -
  27.304 -<option>
  27.305 -<p><opt>mbox_users = <arg>list</arg></opt></p>
  27.306 -<optdesc>
  27.307 -<p>A list of users which wish delivery to an mbox style mail folder.</p>
  27.308 -</optdesc>
  27.309 -</option>
  27.310 -
  27.311 -<option>
  27.312 -<p><opt>mda_users = <arg>list</arg></opt></p>
  27.313 -<optdesc>
  27.314 -<p>A list of users which wish local delivery to an mda. You have to
  27.315 -set <opt>mda</opt> (see below) as well.</p>
  27.316 -</optdesc>
  27.317 -</option>
  27.318 -
  27.319 -<option>
  27.320 -<p><opt>maildir_users = <arg>list</arg></opt></p>
  27.321 -<optdesc>
  27.322 -<p>A list of users which wish delivery to a qmail style maildir. The
  27.323 -path to maildir is ~/Maildir/. The maildir will be created if it
  27.324 -does not exist.</p>
  27.325 -</optdesc>
  27.326 -</option>
  27.327 -
  27.328 -<option>
  27.329 -<p><opt>mda = <arg>expand string</arg></opt></p>
  27.330 -<optdesc>
  27.331 -<p>If you want local delivery to be transferred to an mda (Mail
  27.332 -Delivery Agent), set this to a command. The argument will be expanded
  27.333 -on delivery time, you can use variables beginning with a '$' sign,
  27.334 -optionally enclosed in curly braces. Variables you can use are:</p>
  27.335 -<p>uid - the unique message id. This is not necessarily identical with
  27.336 -the Message ID as given in the Message ID: header.</p>
  27.337 -<p>received_host - the host the mail was received from</p>
  27.338 -<p>ident - the ident, this is either the ident delivered by the ident
  27.339 -protocol or the user id of the sender if the message was received locally.</p>
  27.340 -<p>return_path_local - the local part of the return path (sender).</p>
  27.341 -<p>return_path_domain - the domain part of the return path (sender).</p>
  27.342 -<p>return_path - the complete return path (sender).</p>
  27.343 -<p>rcpt_local - the local part of the recipient.</p>
  27.344 -<p>rcpt_domain - the domain part of the recipient.</p>
  27.345 -<p>rcpt - the complete recipient address.</p>
  27.346 -<p>Example:</p><p>mda="/usr/bin/procmail -Y -d ${rcpt_local}"</p>
  27.347 -<p>For the mda, as for pipe commands, a few environment variables will
  27.348 -be set as well. See <manref name="masqmail" section="8"
  27.349 -href="masqmail.8.html"/>. To use environment variables for the mda,
  27.350 -the '$' sign has to be escaped with a backslash, otherwise they will
  27.351 -be tried to be expanded with the internal variables.</p>
  27.352 -
  27.353 -</optdesc>
  27.354 -</option>
  27.355 -
  27.356 -<option>
  27.357 -<p><opt>mda_fromline = <arg>boolean</arg></opt></p>
  27.358 -<optdesc>
  27.359 -<p>If this is set, a from line will be prepended to the output stream whenever
  27.360 -a message is delivered to an mda. Default is false.</p>
  27.361 -</optdesc>
  27.362 -</option>
  27.363 -
  27.364 -<option>
  27.365 -<p><opt>mda_fromhack = <arg>boolean</arg></opt></p>
  27.366 -<optdesc>
  27.367 -<p>If this is set, each line beginning with 'From ' is replaced with '>From ' whenever
  27.368 -a message is delivered to an mda. You probably want this if you have
  27.369 -set <opt>mda_fromline</opt> above. Default is false.</p>
  27.370 -</optdesc>
  27.371 -</option>
  27.372 -
  27.373 -<option>
  27.374 -<p><opt>online_detect = <arg>string</arg></opt></p>
  27.375 -<optdesc>
  27.376 -<p>Defines the method MasqMail uses to detect whether there is
  27.377 -currently an online connection. It can have the
  27.378 -values <opt>file</opt>, <opt>pipe</opt> or <opt>mserver</opt>.</p>
  27.379 -
  27.380 -<p>When it is set to <opt>file</opt>, MasqMail first checks for the
  27.381 -existence of <opt>online_file</opt> (see below) and if it exists, it reads
  27.382 -it. The content of the file should be the name of the current
  27.383 -connection as defined with <opt>connect_route.<arg>name</arg></opt> (without
  27.384 -a trailing newline character).</p>
  27.385 -
  27.386 -<p>When it is set to <opt>pipe</opt>, MasqMail calls the executable given by
  27.387 -the <opt>online_pipe</opt> option (see below) and reads the current online
  27.388 -status from its standard output.</p>
  27.389 -
  27.390 -<p>When it is set to <opt>mserver</opt>, MasqMail connects to the
  27.391 -masqdialer server using the value of <opt>mserver_iface</opt> and asks it
  27.392 -whether a connection exists and for the name, which should be the name
  27.393 -of the current connection as defined with <opt>connect_route.<arg>name</arg></opt>.</p>
  27.394 -
  27.395 -<p>No matter how MasqMail detects the online status, only messages
  27.396 -that are accepted at online time will be delivered using the
  27.397 -connection. The spool still has to be emptied with masqmail <opt>-qo</opt>
  27.398 -<arg>connection</arg>.</p>
  27.399 -</optdesc>
  27.400 -</option>
  27.401 -
  27.402 -<option>
  27.403 -<p><opt>online_file = <arg>file</arg></opt></p>
  27.404 -<optdesc>
  27.405 -<p>This is the name of the file checked for when MasqMail determines
  27.406 -whether it is online. The file should only exist when there is
  27.407 -currently a connection. Create it in your ip-up script with eg.</p>
  27.408 -
  27.409 -<p>echo -n &lt;name&gt; &gt; /tmp/connect_route</p>
  27.410 -<p>chmod 0644 /tmp/connect_route</p>
  27.411 -
  27.412 -<p>Do not forget to delete it in your ip-down script.</p>
  27.413 -</optdesc>
  27.414 -</option>
  27.415 -
  27.416 -<option>
  27.417 -<p><opt>online_pipe = <arg>file</arg></opt></p>
  27.418 -<optdesc>
  27.419 -<p>This is the name of the executable which will be called to determine
  27.420 -the online status. This executable should just print the name oif the current
  27.421 -connection to the standard output and return a zero status code. masqmail assumes
  27.422 -it is offline if the script returns with a non zero status. Simple example:</p>
  27.423 -
  27.424 -<p>#!/bin/sh</p>
  27.425 -<p></p>
  27.426 -<p>[ -e /tmp/connect_route ] || exit 1</p>
  27.427 -<p>cat /tmp/connect_route</p>
  27.428 -<p>exit 0</p>
  27.429 -
  27.430 -<p>Of course, instead of the example above you could as well use <opt>file</opt> as
  27.431 -the online detection method, but you can do something more sophisticated.</p>
  27.432 -</optdesc>
  27.433 -</option>
  27.434 -
  27.435 -<option>
  27.436 -<p><opt>mserver_iface = <arg>interface</arg></opt></p>
  27.437 -<optdesc>
  27.438 -<p>The interface the masqdialer server is listening to. Usually this
  27.439 -will be "localhost:224" if mserver is running on the same host as
  27.440 -masqmail. But using this option, you can also let masqmail run on
  27.441 -another host by setting <opt>mserver_iface</opt> to another hostname,
  27.442 -eg. "foo:224".</p>
  27.443 -</optdesc>
  27.444 -</option>
  27.445 -
  27.446 -<option>
  27.447 -<p><opt>get.<arg>name</arg> = <arg>file</arg></opt></p>
  27.448 -<optdesc>
  27.449 -<p>Replace <arg>name</arg> with a name to identify a get
  27.450 -configuration. Set this to a filename for the get configuration. These
  27.451 -files will be used to retrieve mail when called with the -g option.</p>
  27.452 -</optdesc>
  27.453 -</option>
  27.454 -
  27.455 -<option>
  27.456 -<p><opt>online_gets.<arg>name</arg> = <arg>list</arg></opt></p>
  27.457 -<optdesc>
  27.458 -<p>Replace <arg>name</arg> with a name to identify an online
  27.459 -configuration. Set this to a filename (or a list of filenames) for the get configuration. These
  27.460 -files will be used to retrieve mail when called with the -go option.</p>
  27.461 -</optdesc>
  27.462 -</option>
  27.463 -
  27.464 -<option>
  27.465 -<p><opt>ident_trusted_nets = <arg>list</arg></opt></p>
  27.466 -<optdesc>
  27.467 -<p><arg>list</arg> is a list of networks of the form a.b.c.d/e
  27.468 -(eg. 192.168.1.0/24), from which the ident given by the ident protocol
  27.469 -will be trusted, so a user can delete his mail from the queue if the
  27.470 -ident is identical to his login name.</p>
  27.471 -</optdesc>
  27.472 -</option>
  27.473 -
  27.474 -<option>
  27.475 -<p><opt>errmsg_file = <arg>file</arg></opt></p>
  27.476 -<optdesc>
  27.477 -<p>Set this to a template which will be used to generate delivery failure
  27.478 -reports. Variable parts within the template begin with a dollar sign and
  27.479 -are identical to those which can be used as arguments for the mda command,
  27.480 -see <opt>mda</opt> above. Additional information can be included with
  27.481 -@failed_rcpts, @msg_headers and @msg_body, these <b>must</b> be at the
  27.482 -beginning of a line and will be replaced with the list of the failed recipients,
  27.483 -the message headers and the message body of the failed message.</p>
  27.484 -<p>Default is /usr/share/masqmail/tpl/failmsg.tpl.</p>
  27.485 -</optdesc>
  27.486 -</option>
  27.487 -
  27.488 -<option>
  27.489 -<p><opt>warnmsg_file = <arg>file</arg></opt></p>
  27.490 -<optdesc>
  27.491 -<p>Set this to a template which will be used to generate delivery warning
  27.492 -reports. It uses the same mechanisms for variables as <opt>errmsg_file</opt>,
  27.493 -see above.
  27.494 -</p>
  27.495 -<p>Default is /usr/share/masqmail/tpl/warnmsg.tpl.</p>
  27.496 -</optdesc>
  27.497 -</option>
  27.498 -
  27.499 -<option>
  27.500 -<p><opt>warn_intervals</opt> = <arg>list</arg></p>
  27.501 -<optdesc>
  27.502 -<p>Set this to a list of time intervals, at which delivery warnings (starting
  27.503 -with the receiving time of the message) shall be generated.</p>
  27.504 -<p>A warning will only be generated just after an attempt to deliver the
  27.505 -mail and if that attempt failed temporarily. So a warning may be generated after
  27.506 -a longer time, if there was no attempt before.</p>
  27.507 -<p>Default is "1h;4h;8h;1d;2d;3d"</p>
  27.508 -</optdesc>
  27.509 -</option>
  27.510 -
  27.511 -<option>
  27.512 -<p><opt>max_defer_time</opt> = <arg>time</arg></p>
  27.513 -<optdesc>
  27.514 -<p>This is the maximum time, in which a temporarily failed mail will be kept
  27.515 -in the spool. When this time is exceeded, it will be handled as a delivery failure,
  27.516 -and the message will be bounced.</p>
  27.517 -<p>The excedence of this time will only be noticed if the message was actually
  27.518 -tried to be delivered. If, for example, the message can only be delivered when
  27.519 -online, but you have not been online for that time, no bounce will be generated.</p>
  27.520 -<p>Default is 4d (4 days)</p>
  27.521 -</optdesc>
  27.522 -</option>
  27.523 -
  27.524 -<option>
  27.525 -<p><opt>log_user = <arg>name</arg></opt></p>
  27.526 -<optdesc>
  27.527 -<p>Replace <arg>name</arg> with a valid local or remote mail address.</p>
  27.528 -<p>If this option is not empty, then a copy of every mail,
  27.529 -that passes trough the masqmail system will also be sent to the
  27.530 -given mail address.</p>
  27.531 -<p>For example you can feed your mails into a program like <i>hypermail</i> for
  27.532 -archiving purpose by placing an appropriate pipe command in masqmail.alias</p>
  27.533 -</optdesc>
  27.534 -</option>
  27.535 -
  27.536 -</options>
  27.537 -
  27.538 -<section name = "Author">
  27.539 -<p>masqmail was written by Oliver Kurth
  27.540 -&lt;oku@masqmail.cx&gt;</p><p>You will find the newest version of
  27.541 -masqmail at <url href="http://masqmail.cx/masqmail/"/> or search for it
  27.542 -in freshmeat (<url href="http://www.freshmeat.net"/>). There is also a mailing list,
  27.543 -you will find information about it at masqmails main site.</p>
  27.544 -</section>
  27.545 -
  27.546 -<section name = "Bugs">
  27.547 -<p>You should report them to the mailing list.</p>
  27.548 -</section>
  27.549 -
  27.550 -<section name = "See also">
  27.551 -<p>
  27.552 -<manref name="masqmail" section="8" href="masqmail.8.html"/>, <manref name="masqmail.route" section="5" href="masqmail.route.5.html"/>, <manref name="masqmail.get" section="5" href="masqmail.get.5.html"/>
  27.553 -</p>
  27.554 -</section>
  27.555 -
  27.556 -
  27.557 -<section name = "Comments">
  27.558 -<p>This man page was written using <manref name="xml2man" section="1"
  27.559 -href="http://masqmail.cx/xml2man/"/> by the same
  27.560 -author.</p>
  27.561 -</section>
  27.562 -
  27.563 -</manpage>
  27.564 -