masqmail

changeset 57:ed34413652fc

moved man pages from docs/ to man/
author meillo@marmaro.de
date Sat, 29 May 2010 22:07:07 +0200
parents f6a6f55b7b9e
children 6ab62592cac4
files Makefile.am Makefile.in configure configure.ac docs/Makefile.am docs/Makefile.in docs/masqmail.8 docs/masqmail.aliases.5 docs/masqmail.conf.5 docs/masqmail.get.5 docs/masqmail.route.5 docs/mservdetect.8 man/Makefile.am man/Makefile.in man/masqmail.8 man/masqmail.aliases.5 man/masqmail.conf.5 man/masqmail.get.5 man/masqmail.route.5 man/mservdetect.8
diffstat 20 files changed, 1792 insertions(+), 1798 deletions(-) [+]
line diff
     1.1 --- a/Makefile.am	Sat May 29 21:51:13 2010 +0200
     1.2 +++ b/Makefile.am	Sat May 29 22:07:07 2010 +0200
     1.3 @@ -1,11 +1,8 @@
     1.4  EXTRA_DIST = \
     1.5 -examples/example.get examples/example.route examples/masqmail.conf \
     1.6 -docs/README docs/m*.[0-9] \
     1.7 -tpl/failmsg.tpl tpl/failmsg.tpl.de tpl/failmsg.tpl.fr tpl/failmsg.tpl.it \
     1.8 -tpl/warnmsg.tpl tpl/warnmsg.tpl.de tpl/warnmsg.tpl.fr \
     1.9 +examples/* docs/* man/* tpl/* \
    1.10  INSTALL.agenda INSTALL.ipaq agenda-config.site
    1.11  
    1.12 -SUBDIRS = src docs
    1.13 +SUBDIRS = src man
    1.14  
    1.15  install-data-local: log_dir spool_dir uid_bit conf_dir tpl_dir run_dir
    1.16  
     2.1 --- a/Makefile.in	Sat May 29 21:51:13 2010 +0200
     2.2 +++ b/Makefile.in	Sat May 29 22:07:07 2010 +0200
     2.3 @@ -205,13 +205,10 @@
     2.4  with_spooldir = @with_spooldir@
     2.5  with_user = @with_user@
     2.6  EXTRA_DIST = \
     2.7 -examples/example.get examples/example.route examples/masqmail.conf \
     2.8 -docs/README docs/m*.[0-9] \
     2.9 -tpl/failmsg.tpl tpl/failmsg.tpl.de tpl/failmsg.tpl.fr tpl/failmsg.tpl.it \
    2.10 -tpl/warnmsg.tpl tpl/warnmsg.tpl.de tpl/warnmsg.tpl.fr \
    2.11 +examples/* docs/* man/* tpl/* \
    2.12  INSTALL.agenda INSTALL.ipaq agenda-config.site
    2.13  
    2.14 -SUBDIRS = src docs
    2.15 +SUBDIRS = src man
    2.16  all: config.h
    2.17  	$(MAKE) $(AM_MAKEFLAGS) all-recursive
    2.18  
     3.1 --- a/configure	Sat May 29 21:51:13 2010 +0200
     3.2 +++ b/configure	Sat May 29 22:07:07 2010 +0200
     3.3 @@ -5499,7 +5499,7 @@
     3.4  	fi
     3.5  fi
     3.6  
     3.7 -ac_config_files="$ac_config_files Makefile src/Makefile src/base64/Makefile src/md5/Makefile src/libident/Makefile docs/Makefile"
     3.8 +ac_config_files="$ac_config_files Makefile src/Makefile src/base64/Makefile src/md5/Makefile src/libident/Makefile man/Makefile"
     3.9  
    3.10  cat >confcache <<\_ACEOF
    3.11  # This file is a shell script that caches the results of configure
    3.12 @@ -6218,7 +6218,7 @@
    3.13      "src/base64/Makefile") CONFIG_FILES="$CONFIG_FILES src/base64/Makefile" ;;
    3.14      "src/md5/Makefile") CONFIG_FILES="$CONFIG_FILES src/md5/Makefile" ;;
    3.15      "src/libident/Makefile") CONFIG_FILES="$CONFIG_FILES src/libident/Makefile" ;;
    3.16 -    "docs/Makefile") CONFIG_FILES="$CONFIG_FILES docs/Makefile" ;;
    3.17 +    "man/Makefile") CONFIG_FILES="$CONFIG_FILES man/Makefile" ;;
    3.18  
    3.19    *) as_fn_error "invalid argument: \`$ac_config_target'" "$LINENO" 5;;
    3.20    esac
     4.1 --- a/configure.ac	Sat May 29 21:51:13 2010 +0200
     4.2 +++ b/configure.ac	Sat May 29 22:07:07 2010 +0200
     4.3 @@ -295,5 +295,5 @@
     4.4  	src/base64/Makefile \
     4.5  	src/md5/Makefile \
     4.6  	src/libident/Makefile \
     4.7 -	docs/Makefile
     4.8 +	man/Makefile
     4.9  	)
     5.1 --- a/docs/Makefile.am	Sat May 29 21:51:13 2010 +0200
     5.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     5.3 @@ -1,1 +0,0 @@
     5.4 -man_MANS=masqmail.8 mservdetect.8 masqmail.conf.5 masqmail.route.5 masqmail.get.5 masqmail.aliases.5
     6.1 --- a/docs/Makefile.in	Sat May 29 21:51:13 2010 +0200
     6.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     6.3 @@ -1,454 +0,0 @@
     6.4 -# Makefile.in generated by automake 1.11.1 from Makefile.am.
     6.5 -# @configure_input@
     6.6 -
     6.7 -# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
     6.8 -# 2003, 2004, 2005, 2006, 2007, 2008, 2009  Free Software Foundation,
     6.9 -# Inc.
    6.10 -# This Makefile.in is free software; the Free Software Foundation
    6.11 -# gives unlimited permission to copy and/or distribute it,
    6.12 -# with or without modifications, as long as this notice is preserved.
    6.13 -
    6.14 -# This program is distributed in the hope that it will be useful,
    6.15 -# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
    6.16 -# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
    6.17 -# PARTICULAR PURPOSE.
    6.18 -
    6.19 -@SET_MAKE@
    6.20 -VPATH = @srcdir@
    6.21 -pkgdatadir = $(datadir)/@PACKAGE@
    6.22 -pkgincludedir = $(includedir)/@PACKAGE@
    6.23 -pkglibdir = $(libdir)/@PACKAGE@
    6.24 -pkglibexecdir = $(libexecdir)/@PACKAGE@
    6.25 -am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
    6.26 -install_sh_DATA = $(install_sh) -c -m 644
    6.27 -install_sh_PROGRAM = $(install_sh) -c
    6.28 -install_sh_SCRIPT = $(install_sh) -c
    6.29 -INSTALL_HEADER = $(INSTALL_DATA)
    6.30 -transform = $(program_transform_name)
    6.31 -NORMAL_INSTALL = :
    6.32 -PRE_INSTALL = :
    6.33 -POST_INSTALL = :
    6.34 -NORMAL_UNINSTALL = :
    6.35 -PRE_UNINSTALL = :
    6.36 -POST_UNINSTALL = :
    6.37 -subdir = docs
    6.38 -DIST_COMMON = README $(srcdir)/Makefile.am $(srcdir)/Makefile.in
    6.39 -ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
    6.40 -am__aclocal_m4_deps = $(top_srcdir)/configure.ac
    6.41 -am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
    6.42 -	$(ACLOCAL_M4)
    6.43 -mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
    6.44 -CONFIG_HEADER = $(top_builddir)/config.h
    6.45 -CONFIG_CLEAN_FILES =
    6.46 -CONFIG_CLEAN_VPATH_FILES =
    6.47 -SOURCES =
    6.48 -DIST_SOURCES =
    6.49 -am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
    6.50 -am__vpath_adj = case $$p in \
    6.51 -    $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \
    6.52 -    *) f=$$p;; \
    6.53 -  esac;
    6.54 -am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`;
    6.55 -am__install_max = 40
    6.56 -am__nobase_strip_setup = \
    6.57 -  srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'`
    6.58 -am__nobase_strip = \
    6.59 -  for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||"
    6.60 -am__nobase_list = $(am__nobase_strip_setup); \
    6.61 -  for p in $$list; do echo "$$p $$p"; done | \
    6.62 -  sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \
    6.63 -  $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \
    6.64 -    if (++n[$$2] == $(am__install_max)) \
    6.65 -      { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \
    6.66 -    END { for (dir in files) print dir, files[dir] }'
    6.67 -am__base_list = \
    6.68 -  sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \
    6.69 -  sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g'
    6.70 -man5dir = $(mandir)/man5
    6.71 -am__installdirs = "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(man8dir)"
    6.72 -man8dir = $(mandir)/man8
    6.73 -NROFF = nroff
    6.74 -MANS = $(man_MANS)
    6.75 -DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
    6.76 -ACLOCAL = @ACLOCAL@
    6.77 -AMTAR = @AMTAR@
    6.78 -AUTOCONF = @AUTOCONF@
    6.79 -AUTOHEADER = @AUTOHEADER@
    6.80 -AUTOMAKE = @AUTOMAKE@
    6.81 -AWK = @AWK@
    6.82 -BASE64_LIBS = @BASE64_LIBS@
    6.83 -CC = @CC@
    6.84 -CCDEPMODE = @CCDEPMODE@
    6.85 -CFLAGS = @CFLAGS@
    6.86 -CPP = @CPP@
    6.87 -CPPFLAGS = @CPPFLAGS@
    6.88 -CYGPATH_W = @CYGPATH_W@
    6.89 -DEFS = @DEFS@
    6.90 -DEPDIR = @DEPDIR@
    6.91 -ECHO_C = @ECHO_C@
    6.92 -ECHO_N = @ECHO_N@
    6.93 -ECHO_T = @ECHO_T@
    6.94 -EGREP = @EGREP@
    6.95 -EXEEXT = @EXEEXT@
    6.96 -GLIB_CFLAGS = @GLIB_CFLAGS@
    6.97 -GLIB_LIBS = @GLIB_LIBS@
    6.98 -GREP = @GREP@
    6.99 -IDENT_LIBS = @IDENT_LIBS@
   6.100 -INSTALL = @INSTALL@
   6.101 -INSTALL_DATA = @INSTALL_DATA@
   6.102 -INSTALL_PROGRAM = @INSTALL_PROGRAM@
   6.103 -INSTALL_SCRIPT = @INSTALL_SCRIPT@
   6.104 -INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
   6.105 -LDFLAGS = @LDFLAGS@
   6.106 -LIBOBJS = @LIBOBJS@
   6.107 -LIBS = @LIBS@
   6.108 -LOCKFILE_LIBS = @LOCKFILE_LIBS@
   6.109 -LTLIBOBJS = @LTLIBOBJS@
   6.110 -MAKEINFO = @MAKEINFO@
   6.111 -MD5_LIBS = @MD5_LIBS@
   6.112 -MKDIR_P = @MKDIR_P@
   6.113 -OBJEXT = @OBJEXT@
   6.114 -PACKAGE = @PACKAGE@
   6.115 -PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
   6.116 -PACKAGE_NAME = @PACKAGE_NAME@
   6.117 -PACKAGE_STRING = @PACKAGE_STRING@
   6.118 -PACKAGE_TARNAME = @PACKAGE_TARNAME@
   6.119 -PACKAGE_URL = @PACKAGE_URL@
   6.120 -PACKAGE_VERSION = @PACKAGE_VERSION@
   6.121 -PATH_SEPARATOR = @PATH_SEPARATOR@
   6.122 -PKG_CONFIG = @PKG_CONFIG@
   6.123 -PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@
   6.124 -PKG_CONFIG_PATH = @PKG_CONFIG_PATH@
   6.125 -RANLIB = @RANLIB@
   6.126 -RESOLV_LIBS = @RESOLV_LIBS@
   6.127 -SET_MAKE = @SET_MAKE@
   6.128 -SHELL = @SHELL@
   6.129 -STRIP = @STRIP@
   6.130 -USE_LIBLOCKFILE = @USE_LIBLOCKFILE@
   6.131 -VERSION = @VERSION@
   6.132 -abs_builddir = @abs_builddir@
   6.133 -abs_srcdir = @abs_srcdir@
   6.134 -abs_top_builddir = @abs_top_builddir@
   6.135 -abs_top_srcdir = @abs_top_srcdir@
   6.136 -ac_ct_CC = @ac_ct_CC@
   6.137 -am__include = @am__include@
   6.138 -am__leading_dot = @am__leading_dot@
   6.139 -am__quote = @am__quote@
   6.140 -am__tar = @am__tar@
   6.141 -am__untar = @am__untar@
   6.142 -bindir = @bindir@
   6.143 -build_alias = @build_alias@
   6.144 -builddir = @builddir@
   6.145 -datadir = @datadir@
   6.146 -datarootdir = @datarootdir@
   6.147 -docdir = @docdir@
   6.148 -dvidir = @dvidir@
   6.149 -exec_prefix = @exec_prefix@
   6.150 -has_ident = @has_ident@
   6.151 -host_alias = @host_alias@
   6.152 -htmldir = @htmldir@
   6.153 -includedir = @includedir@
   6.154 -infodir = @infodir@
   6.155 -install_sh = @install_sh@
   6.156 -libdir = @libdir@
   6.157 -libexecdir = @libexecdir@
   6.158 -localedir = @localedir@
   6.159 -localstatedir = @localstatedir@
   6.160 -mandir = @mandir@
   6.161 -mkdir_p = @mkdir_p@
   6.162 -oldincludedir = @oldincludedir@
   6.163 -pdfdir = @pdfdir@
   6.164 -prefix = @prefix@
   6.165 -program_transform_name = @program_transform_name@
   6.166 -psdir = @psdir@
   6.167 -sbindir = @sbindir@
   6.168 -sharedstatedir = @sharedstatedir@
   6.169 -srcdir = @srcdir@
   6.170 -sysconfdir = @sysconfdir@
   6.171 -target_alias = @target_alias@
   6.172 -top_build_prefix = @top_build_prefix@
   6.173 -top_builddir = @top_builddir@
   6.174 -top_srcdir = @top_srcdir@
   6.175 -with_confdir = @with_confdir@
   6.176 -with_group = @with_group@
   6.177 -with_logdir = @with_logdir@
   6.178 -with_spooldir = @with_spooldir@
   6.179 -with_user = @with_user@
   6.180 -man_MANS = masqmail.8 mservdetect.8 masqmail.conf.5 masqmail.route.5 masqmail.get.5 masqmail.aliases.5
   6.181 -all: all-am
   6.182 -
   6.183 -.SUFFIXES:
   6.184 -$(srcdir)/Makefile.in:  $(srcdir)/Makefile.am  $(am__configure_deps)
   6.185 -	@for dep in $?; do \
   6.186 -	  case '$(am__configure_deps)' in \
   6.187 -	    *$$dep*) \
   6.188 -	      ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \
   6.189 -	        && { if test -f $@; then exit 0; else break; fi; }; \
   6.190 -	      exit 1;; \
   6.191 -	  esac; \
   6.192 -	done; \
   6.193 -	echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/Makefile'; \
   6.194 -	$(am__cd) $(top_srcdir) && \
   6.195 -	  $(AUTOMAKE) --gnu docs/Makefile
   6.196 -.PRECIOUS: Makefile
   6.197 -Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
   6.198 -	@case '$?' in \
   6.199 -	  *config.status*) \
   6.200 -	    cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \
   6.201 -	  *) \
   6.202 -	    echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \
   6.203 -	    cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \
   6.204 -	esac;
   6.205 -
   6.206 -$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
   6.207 -	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
   6.208 -
   6.209 -$(top_srcdir)/configure:  $(am__configure_deps)
   6.210 -	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
   6.211 -$(ACLOCAL_M4):  $(am__aclocal_m4_deps)
   6.212 -	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
   6.213 -$(am__aclocal_m4_deps):
   6.214 -install-man5: $(man_MANS)
   6.215 -	@$(NORMAL_INSTALL)
   6.216 -	test -z "$(man5dir)" || $(MKDIR_P) "$(DESTDIR)$(man5dir)"
   6.217 -	@list=''; test -n "$(man5dir)" || exit 0; \
   6.218 -	{ for i in $$list; do echo "$$i"; done; \
   6.219 -	l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
   6.220 -	  sed -n '/\.5[a-z]*$$/p'; \
   6.221 -	} | while read p; do \
   6.222 -	  if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
   6.223 -	  echo "$$d$$p"; echo "$$p"; \
   6.224 -	done | \
   6.225 -	sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \
   6.226 -	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \
   6.227 -	sed 'N;N;s,\n, ,g' | { \
   6.228 -	list=; while read file base inst; do \
   6.229 -	  if test "$$base" = "$$inst"; then list="$$list $$file"; else \
   6.230 -	    echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man5dir)/$$inst'"; \
   6.231 -	    $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man5dir)/$$inst" || exit $$?; \
   6.232 -	  fi; \
   6.233 -	done; \
   6.234 -	for i in $$list; do echo "$$i"; done | $(am__base_list) | \
   6.235 -	while read files; do \
   6.236 -	  test -z "$$files" || { \
   6.237 -	    echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man5dir)'"; \
   6.238 -	    $(INSTALL_DATA) $$files "$(DESTDIR)$(man5dir)" || exit $$?; }; \
   6.239 -	done; }
   6.240 -
   6.241 -uninstall-man5:
   6.242 -	@$(NORMAL_UNINSTALL)
   6.243 -	@list=''; test -n "$(man5dir)" || exit 0; \
   6.244 -	files=`{ for i in $$list; do echo "$$i"; done; \
   6.245 -	l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
   6.246 -	  sed -n '/\.5[a-z]*$$/p'; \
   6.247 -	} | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \
   6.248 -	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \
   6.249 -	test -z "$$files" || { \
   6.250 -	  echo " ( cd '$(DESTDIR)$(man5dir)' && rm -f" $$files ")"; \
   6.251 -	  cd "$(DESTDIR)$(man5dir)" && rm -f $$files; }
   6.252 -install-man8: $(man_MANS)
   6.253 -	@$(NORMAL_INSTALL)
   6.254 -	test -z "$(man8dir)" || $(MKDIR_P) "$(DESTDIR)$(man8dir)"
   6.255 -	@list=''; test -n "$(man8dir)" || exit 0; \
   6.256 -	{ for i in $$list; do echo "$$i"; done; \
   6.257 -	l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
   6.258 -	  sed -n '/\.8[a-z]*$$/p'; \
   6.259 -	} | while read p; do \
   6.260 -	  if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
   6.261 -	  echo "$$d$$p"; echo "$$p"; \
   6.262 -	done | \
   6.263 -	sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \
   6.264 -	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \
   6.265 -	sed 'N;N;s,\n, ,g' | { \
   6.266 -	list=; while read file base inst; do \
   6.267 -	  if test "$$base" = "$$inst"; then list="$$list $$file"; else \
   6.268 -	    echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man8dir)/$$inst'"; \
   6.269 -	    $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man8dir)/$$inst" || exit $$?; \
   6.270 -	  fi; \
   6.271 -	done; \
   6.272 -	for i in $$list; do echo "$$i"; done | $(am__base_list) | \
   6.273 -	while read files; do \
   6.274 -	  test -z "$$files" || { \
   6.275 -	    echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man8dir)'"; \
   6.276 -	    $(INSTALL_DATA) $$files "$(DESTDIR)$(man8dir)" || exit $$?; }; \
   6.277 -	done; }
   6.278 -
   6.279 -uninstall-man8:
   6.280 -	@$(NORMAL_UNINSTALL)
   6.281 -	@list=''; test -n "$(man8dir)" || exit 0; \
   6.282 -	files=`{ for i in $$list; do echo "$$i"; done; \
   6.283 -	l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
   6.284 -	  sed -n '/\.8[a-z]*$$/p'; \
   6.285 -	} | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \
   6.286 -	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \
   6.287 -	test -z "$$files" || { \
   6.288 -	  echo " ( cd '$(DESTDIR)$(man8dir)' && rm -f" $$files ")"; \
   6.289 -	  cd "$(DESTDIR)$(man8dir)" && rm -f $$files; }
   6.290 -tags: TAGS
   6.291 -TAGS:
   6.292 -
   6.293 -ctags: CTAGS
   6.294 -CTAGS:
   6.295 -
   6.296 -
   6.297 -distdir: $(DISTFILES)
   6.298 -	@list='$(MANS)'; if test -n "$$list"; then \
   6.299 -	  list=`for p in $$list; do \
   6.300 -	    if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
   6.301 -	    if test -f "$$d$$p"; then echo "$$d$$p"; else :; fi; done`; \
   6.302 -	  if test -n "$$list" && \
   6.303 -	    grep 'ab help2man is required to generate this page' $$list >/dev/null; then \
   6.304 -	    echo "error: found man pages containing the \`missing help2man' replacement text:" >&2; \
   6.305 -	    grep -l 'ab help2man is required to generate this page' $$list | sed 's/^/         /' >&2; \
   6.306 -	    echo "       to fix them, install help2man, remove and regenerate the man pages;" >&2; \
   6.307 -	    echo "       typically \`make maintainer-clean' will remove them" >&2; \
   6.308 -	    exit 1; \
   6.309 -	  else :; fi; \
   6.310 -	else :; fi
   6.311 -	@srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
   6.312 -	topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
   6.313 -	list='$(DISTFILES)'; \
   6.314 -	  dist_files=`for file in $$list; do echo $$file; done | \
   6.315 -	  sed -e "s|^$$srcdirstrip/||;t" \
   6.316 -	      -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \
   6.317 -	case $$dist_files in \
   6.318 -	  */*) $(MKDIR_P) `echo "$$dist_files" | \
   6.319 -			   sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \
   6.320 -			   sort -u` ;; \
   6.321 -	esac; \
   6.322 -	for file in $$dist_files; do \
   6.323 -	  if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
   6.324 -	  if test -d $$d/$$file; then \
   6.325 -	    dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \
   6.326 -	    if test -d "$(distdir)/$$file"; then \
   6.327 -	      find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
   6.328 -	    fi; \
   6.329 -	    if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
   6.330 -	      cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \
   6.331 -	      find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
   6.332 -	    fi; \
   6.333 -	    cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \
   6.334 -	  else \
   6.335 -	    test -f "$(distdir)/$$file" \
   6.336 -	    || cp -p $$d/$$file "$(distdir)/$$file" \
   6.337 -	    || exit 1; \
   6.338 -	  fi; \
   6.339 -	done
   6.340 -check-am: all-am
   6.341 -check: check-am
   6.342 -all-am: Makefile $(MANS)
   6.343 -installdirs:
   6.344 -	for dir in "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(man8dir)"; do \
   6.345 -	  test -z "$$dir" || $(MKDIR_P) "$$dir"; \
   6.346 -	done
   6.347 -install: install-am
   6.348 -install-exec: install-exec-am
   6.349 -install-data: install-data-am
   6.350 -uninstall: uninstall-am
   6.351 -
   6.352 -install-am: all-am
   6.353 -	@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
   6.354 -
   6.355 -installcheck: installcheck-am
   6.356 -install-strip:
   6.357 -	$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
   6.358 -	  install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
   6.359 -	  `test -z '$(STRIP)' || \
   6.360 -	    echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
   6.361 -mostlyclean-generic:
   6.362 -
   6.363 -clean-generic:
   6.364 -
   6.365 -distclean-generic:
   6.366 -	-test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES)
   6.367 -	-test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES)
   6.368 -
   6.369 -maintainer-clean-generic:
   6.370 -	@echo "This command is intended for maintainers to use"
   6.371 -	@echo "it deletes files that may require special tools to rebuild."
   6.372 -clean: clean-am
   6.373 -
   6.374 -clean-am: clean-generic mostlyclean-am
   6.375 -
   6.376 -distclean: distclean-am
   6.377 -	-rm -f Makefile
   6.378 -distclean-am: clean-am distclean-generic
   6.379 -
   6.380 -dvi: dvi-am
   6.381 -
   6.382 -dvi-am:
   6.383 -
   6.384 -html: html-am
   6.385 -
   6.386 -html-am:
   6.387 -
   6.388 -info: info-am
   6.389 -
   6.390 -info-am:
   6.391 -
   6.392 -install-data-am: install-man
   6.393 -
   6.394 -install-dvi: install-dvi-am
   6.395 -
   6.396 -install-dvi-am:
   6.397 -
   6.398 -install-exec-am:
   6.399 -
   6.400 -install-html: install-html-am
   6.401 -
   6.402 -install-html-am:
   6.403 -
   6.404 -install-info: install-info-am
   6.405 -
   6.406 -install-info-am:
   6.407 -
   6.408 -install-man: install-man5 install-man8
   6.409 -
   6.410 -install-pdf: install-pdf-am
   6.411 -
   6.412 -install-pdf-am:
   6.413 -
   6.414 -install-ps: install-ps-am
   6.415 -
   6.416 -install-ps-am:
   6.417 -
   6.418 -installcheck-am:
   6.419 -
   6.420 -maintainer-clean: maintainer-clean-am
   6.421 -	-rm -f Makefile
   6.422 -maintainer-clean-am: distclean-am maintainer-clean-generic
   6.423 -
   6.424 -mostlyclean: mostlyclean-am
   6.425 -
   6.426 -mostlyclean-am: mostlyclean-generic
   6.427 -
   6.428 -pdf: pdf-am
   6.429 -
   6.430 -pdf-am:
   6.431 -
   6.432 -ps: ps-am
   6.433 -
   6.434 -ps-am:
   6.435 -
   6.436 -uninstall-am: uninstall-man
   6.437 -
   6.438 -uninstall-man: uninstall-man5 uninstall-man8
   6.439 -
   6.440 -.MAKE: install-am install-strip
   6.441 -
   6.442 -.PHONY: all all-am check check-am clean clean-generic distclean \
   6.443 -	distclean-generic distdir dvi dvi-am html html-am info info-am \
   6.444 -	install install-am install-data install-data-am install-dvi \
   6.445 -	install-dvi-am install-exec install-exec-am install-html \
   6.446 -	install-html-am install-info install-info-am install-man \
   6.447 -	install-man5 install-man8 install-pdf install-pdf-am \
   6.448 -	install-ps install-ps-am install-strip installcheck \
   6.449 -	installcheck-am installdirs maintainer-clean \
   6.450 -	maintainer-clean-generic mostlyclean mostlyclean-generic pdf \
   6.451 -	pdf-am ps ps-am uninstall uninstall-am uninstall-man \
   6.452 -	uninstall-man5 uninstall-man8
   6.453 -
   6.454 -
   6.455 -# Tell versions [3.59,3.63) of GNU make to not export all variables.
   6.456 -# Otherwise a system limit (for SysV at least) may be exceeded.
   6.457 -.NOEXPORT:
     7.1 --- a/docs/masqmail.8	Sat May 29 21:51:13 2010 +0200
     7.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     7.3 @@ -1,293 +0,0 @@
     7.4 -.TH masqmail 8 2010-05-07 masqmail-0.2.22 "Maintenance Commands"
     7.5 -
     7.6 -.SH NAME
     7.7 -masqmail \- An offline Mail Transfer Agent
     7.8 -
     7.9 -.SH SYNOPSIS
    7.10 -\fB/usr/sbin/masqmail \fR[\fB\-C \fIfile\fR] [\fB\-odq\fR] [\fB\-bd\fR] [\fB\-q\fIinterval\fR]
    7.11 -
    7.12 -\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-bs\fR]
    7.13 -
    7.14 -\fB/usr/sbin/masqmail \fR[\fB\-bp\fR]
    7.15 -
    7.16 -\fB/usr/sbin/masqmail \fR[\fB\-q\fR]
    7.17 -
    7.18 -\fB/usr/sbin/masqmail \fR[\fB\-qo \fR[\fIname\fR]]
    7.19 -
    7.20 -\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-g \fR[\fIname\fR]]
    7.21 -
    7.22 -\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-go \fR[\fIname\fR]]
    7.23 -
    7.24 -\fB/usr/sbin/masqmail \fR[\fB\-t\fR] [\fB\-oi\fR] [\fB\-f \fIaddress\fR] [\fB\-\-\fR] \fIaddress...
    7.25 -
    7.26 -\fB/usr/sbin/mailq\fR
    7.27 -
    7.28 -
    7.29 -.SH DESCRIPTION
    7.30 -
    7.31 -Masqmail is a mail server designed for hosts that do not have a permanent internet connection
    7.32 -e.g. a home network or a single host at home.
    7.33 -It has special support for connections to different ISPs.
    7.34 -It replaces sendmail or other MTAs such as qmail or exim.
    7.35 -It can also act as a pop3 client.
    7.36 -
    7.37 -
    7.38 -.SH OPTIONS
    7.39 -
    7.40 -Since masqmail is intended to replace sendmail, it uses the same command line options,
    7.41 -but not all are implemented.
    7.42 -There are also two additional options, which are unique to masqmail
    7.43 -(\fB\-qo \fIconnection\fR and \fB\-g\fR)
    7.44 -
    7.45 -.TP
    7.46 -\fB\-\-\fR
    7.47 -
    7.48 -Not a `real' option, it means that all following arguments are to be understood
    7.49 -as arguments and not as options even if they begin with a leading dash `\-'.
    7.50 -Mutt is known to call sendmail with this option.
    7.51 -
    7.52 -.TP
    7.53 -\fB\-bd\fR
    7.54 -
    7.55 -Run as daemon, accepting connections, usually on port 25 if not configured differently.
    7.56 -This is usually used in the startup script at system boot and together with
    7.57 -the \fB\-q\fR option (see below).
    7.58 -
    7.59 -.TP
    7.60 -\fB\-bi\fR
    7.61 -
    7.62 -Old sendmail rebuilds its alias database when invoked with this option.
    7.63 -Masqmail ignores it.
    7.64 -Masqmail reads directly from the file given with `alias_file' in the config file.
    7.65 -
    7.66 -.TP
    7.67 -\fB\-bp\fR
    7.68 -
    7.69 -Show the messages in the queue. Same as calling masqmail as `mailq'.
    7.70 -
    7.71 -.TP
    7.72 -\fB\-bs\fR
    7.73 -
    7.74 -Accept SMTP commands from stdin.
    7.75 -Some mailers (e.g. pine) use this option as an interface.
    7.76 -It can also be used to call masqmail from inetd.
    7.77 -
    7.78 -.TP
    7.79 -\fB\-B \fIarg\fR
    7.80 -
    7.81 -\fIarg\fR is usually 8BITMIME.
    7.82 -Some mailers use this to indicate that the message contains characters > 127.
    7.83 -Masqmail is 8-bit clean and ignores this, so you do not have to recompile elm,
    7.84 -which is very painful ;-).
    7.85 -Note though that this violates some conventions:
    7.86 -masqmail does not convert 8 bit messages to any MIME format if it encounters
    7.87 -a mail server which does not advertise its 8BITMIME capability,
    7.88 -masqmail does not advertise this itself.
    7.89 -This is the same practice as that of exim (but different to sendmail).
    7.90 -
    7.91 -.TP
    7.92 -\fB\-bV \fR
    7.93 -
    7.94 -Show version information.
    7.95 -
    7.96 -.TP
    7.97 -\fB\-C \fIfilename\fR
    7.98 -
    7.99 -Use another configuration than \fI/etc/masqmail/masqmail.conf\fR.
   7.100 -Useful for debugging purposes.
   7.101 -If not invoked by a privileged user, masqmail will drop all privileges.
   7.102 -
   7.103 -.TP
   7.104 -\fB\-d \fInumber\fR
   7.105 -
   7.106 -Set the debug level.
   7.107 -This takes precedence before the value of `debug_level' in the configuration file.
   7.108 -Read the warning in the description of the latter.
   7.109 -
   7.110 -.TP
   7.111 -\fB\-f [\fIaddress\fB]\fR
   7.112 -
   7.113 -Set the return path address to \fIaddress\fR.
   7.114 -Only root, the user mail and anyone in group mail is allowed to do that.
   7.115 -
   7.116 -.TP
   7.117 -\fB\-F [\fIstring\fB]\fR
   7.118 -
   7.119 -Set the full sender name (in the From: header) to \fIstring\fR.
   7.120 -
   7.121 -.TP
   7.122 -\fB\-g [\fIname\fB]\fR
   7.123 -
   7.124 -Get mail (using pop3 or apop),
   7.125 -using the configurations given with get.\fIname\fR in the main configuration.
   7.126 -Without \fIname\fR, all get configurations will be used.
   7.127 -See also \fBmasqmail.get(5)\fR
   7.128 -
   7.129 -.TP
   7.130 -\fB\-go [\fIinterval\fB] [\fIname\fB]\fR
   7.131 -
   7.132 -Can be followed by a connection name.
   7.133 -Use this option in your script which starts as soon as a link to the internet
   7.134 -has been set up (usually ip-up).
   7.135 -When masqmail is called with this option, the specified get configuration(s)
   7.136 -is(are) read and mail will be retrieved from servers on the internet.
   7.137 -The \fIname\fR is defined in the configuration (see \fBonline_gets.\fIname\fR).
   7.138 -
   7.139 -If called with an interval option (recognized by a digit as the first characater),
   7.140 -masqmail starts as a daemon and tries to get mail in these intervals.
   7.141 -It checks for the online status first.
   7.142 -Example: `masqmail \-go 5m' will retrieve mail every five minutes.
   7.143 -
   7.144 -If called without \fIname\fR the online status is determined with the configured method
   7.145 -(see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR).
   7.146 -
   7.147 -.TP
   7.148 -\fB\-i\fR
   7.149 -
   7.150 -Same as \fB\-oi\fR, see below.
   7.151 -
   7.152 -.TP
   7.153 -\fB\-Mrm \fIlist\fR
   7.154 -
   7.155 -Remove given messages from the queue.
   7.156 -Only allowed for privileged users.
   7.157 -The identifiers of messages are listed in the output of
   7.158 -\fImasqmail -bp\fP (\fImailq\fR).
   7.159 -
   7.160 -.TP
   7.161 -\fB\-oem\fR
   7.162 -
   7.163 -If the \fB\-oi\fR ist not also given, always return with a non zero return code.
   7.164 -Maybe someone tells me what this is good for...
   7.165 -
   7.166 -.TP
   7.167 -\fB\-odb\fR
   7.168 -
   7.169 -Deliver in background.
   7.170 -Masqmail always does this, which makes this option pretty much useless.
   7.171 -
   7.172 -.TP
   7.173 -\fB\-odq\fR
   7.174 -
   7.175 -Do not attempt to deliver immediately.
   7.176 -Any messages will be queued until the next queue running process picks them up and delivers them.
   7.177 -You get the same effect by setting the do_queue option in /etc/masqmail/masqmail.conf.
   7.178 -
   7.179 -.TP
   7.180 -\fB\-oi\fR
   7.181 -
   7.182 -A dot as a single character in a line does not terminate the message.
   7.183 -
   7.184 -.TP
   7.185 -\fB\-q [\fIinterval\fB]\fR
   7.186 -
   7.187 -If not given with an argument, run a queue process, i.e. try to deliver all messages in the queue.
   7.188 -Masqmail sends only to those addresses that are on the local net, not to those that are outside.
   7.189 -Use \fB\-qo\fR for those.
   7.190 -
   7.191 -If you have configured inetd to start masqmail,
   7.192 -you can use this option in a cron job which starts in regular time intervals,
   7.193 -to mimic the same effect as starting masqmail with \fB\-bd \-q30m\fR.
   7.194 -
   7.195 -An argument may be a time interval i.e. a numerical value followed by one of the letters.
   7.196 -s,m,h,d,w which are interpreted as seconds, minutes, hours, days or weeks respectively.
   7.197 -Example: \fB\-q30m\fR.
   7.198 -Masqmail starts as a daemon and a queue runner process will be started automatically
   7.199 -once in this time interval.
   7.200 -This is usually used together with \fB\-bd\fR (see above).
   7.201 -
   7.202 -.TP
   7.203 -\fB\-qo [\fIname\fB]\fR
   7.204 -
   7.205 -Can be followed by a connection name.
   7.206 -Use this option in your script which starts as soon as a link to the internet
   7.207 -has been set up (usually ip-up).
   7.208 -When masqmail is called with this option, the specified route configuration
   7.209 -is read and the queued mail with destinations on the internet will be sent.
   7.210 -The \fIname\fR is defined in the configuration (see \fBonline_routes.\fIname\fR).
   7.211 -
   7.212 -If called without \fIname\fR the online status is determined with the configured
   7.213 -method (see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR)
   7.214 -
   7.215 -.TP
   7.216 -\fB\-t\fR
   7.217 -
   7.218 -Read recipients from headers.
   7.219 -Delete `Bcc:' headers.
   7.220 -If any arguments are given, these are interpreted as recipient addresses
   7.221 -and the message will not be sent to these.
   7.222 -
   7.223 -.TP
   7.224 -\fB\-v\fR
   7.225 -
   7.226 -Log also to stdout.
   7.227 -Currently, some log messages are marked as `write to stdout' and additionally,
   7.228 -all messages with priority `LOG_ALERT' and `LOG_WARNING' will be written to stdout
   7.229 -if this option is given. It is disabled in daemon mode.
   7.230 -
   7.231 -
   7.232 -.SH ENVIRONMENT FOR PIPES AND MDAS
   7.233 -
   7.234 -For security reasons, before any pipe command from an alias expansion or an mda is called,
   7.235 -the environment variables will be completely discarded and newly set up. These are:
   7.236 -
   7.237 -SENDER, RETURN_PATH \(en the return path.
   7.238 -
   7.239 -SENDER_DOMAIN \(en the domain part of the return path.
   7.240 -
   7.241 -SENDER_LOCAL \(en the local part of the return path.
   7.242 -
   7.243 -RECEIVED_HOST \(en the host the message was received from (unless local).
   7.244 -
   7.245 -LOCAL_PART, USER, LOGNAME \(en the local part of the (original) recipient.
   7.246 -
   7.247 -MESSAGE_ID \(en the unique message id.
   7.248 -This is not necessarily identical with the Message ID as given in the Message ID: header.
   7.249 -
   7.250 -QUALIFY_DOMAIN \(en the domain which will be appended to unqualified addresses.
   7.251 -
   7.252 -
   7.253 -.SH FILES
   7.254 -
   7.255 -\fI/etc/masqmail/masqmail.conf\fR is the main configuration for masqmail.
   7.256 -Depending on the settings in this file, you will also have other configuration
   7.257 -files in \fI/etc/masqmail/\fR.
   7.258 -
   7.259 -\fI/var/spool/masqmail/\fR is the spool directory where masqmail stores
   7.260 -its spooled messages and the uniq pop ids.
   7.261 -
   7.262 -\fI/var/spool/mail/\fR is the directory where locally delivered mail will be put,
   7.263 -if not configured differently in \fImasqmail.conf\fR.
   7.264 -
   7.265 -\fI/var/log/masqmail/\fR is the directory where masqmail stores its log mesages.
   7.266 -This can also be somewhere else if configured differently by your sysadmin or the package mantainer.
   7.267 -
   7.268 -
   7.269 -.SH CONFORMING TO
   7.270 -
   7.271 -RFC 821, 822, 1869, 1870, 2197, 2554 (SMTP)
   7.272 -
   7.273 -RFC 1725, 1939 (POP3)
   7.274 -
   7.275 -RFC 1321 (MD5)
   7.276 -
   7.277 -RFC 2195 (CRAM-MD5)
   7.278 -
   7.279 -
   7.280 -.SH AUTHOR
   7.281 -
   7.282 -Masqmail was written by Oliver Kurth.
   7.283 -It is now maintained by Markus Schnalke <meillo@marmaro.de>.
   7.284 -
   7.285 -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR.
   7.286 -There is also a mailing list, you will find information about it at masqmail's main site.
   7.287 -
   7.288 -
   7.289 -.SH BUGS
   7.290 -
   7.291 -Please report them to the mailing list.
   7.292 -
   7.293 -
   7.294 -.SH SEE ALSO
   7.295 -
   7.296 -\fBmasqmail.conf(5)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.get(5)\fR, \fBmasqmail.aliases(5)\fR
     8.1 --- a/docs/masqmail.aliases.5	Sat May 29 21:51:13 2010 +0200
     8.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     8.3 @@ -1,54 +0,0 @@
     8.4 -.TH masqmail.aliases 5 2010-05-07 masqmail-0.2.22 "File Formats"
     8.5 -
     8.6 -.SH NAME
     8.7 -masqmail.aliases \- masqmail alias file format
     8.8 -
     8.9 -
    8.10 -.SH DESCRIPTION
    8.11 -
    8.12 -This man page describes the format of the masqmail alias file.
    8.13 -Its usual location is \fI/etc/aliases\fR.
    8.14 -
    8.15 -
    8.16 -.SH FILE FORMAT
    8.17 -
    8.18 -The alias file consists of lines of the form:
    8.19 -local_part: item1, item2, ...
    8.20 -Items can be surrounded by double quotes `"'.
    8.21 -If within the quotes other quotes are needed for an address they can be
    8.22 -escaped with a leading backslash `\\'.
    8.23 -
    8.24 -A leading backslash `\\' indicates that this address shall not be further expanded.
    8.25 -
    8.26 -A leading pipe symbol `|' indicates that the item shall be treated as a pipe command.
    8.27 -The content of the message will then be sent to the standard input of a command.
    8.28 -The command will run under the user id and group id masqmail is running as.
    8.29 -If quotes are needed, the pipe symbol must appear within the quotes.
    8.30 -
    8.31 -Loops will be detected, the offending address will be ignored.
    8.32 -
    8.33 -Aliases will be expanded at delivery time.
    8.34 -This means that if there is a message still in the queue and you change
    8.35 -any alias which matches one of the recipient addresses,
    8.36 -the change will have effect next time a delivery is attemped.
    8.37 -
    8.38 -There is no need to restart masqmail or run any command when the alias file has been changed.
    8.39 -
    8.40 -
    8.41 -.SH AUTHOR
    8.42 -
    8.43 -Masqmail was written by Oliver Kurth.
    8.44 -It is now maintained by Markus Schnalke <meillo@marmaro.de>.
    8.45 -
    8.46 -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR.
    8.47 -There is also a mailing list, you will find information about it at masqmail's main site.
    8.48 -
    8.49 -
    8.50 -.SH BUGS
    8.51 -
    8.52 -Please report bugs to the mailing list.
    8.53 -
    8.54 -
    8.55 -.SH SEE ALSO
    8.56 -
    8.57 -\fBmasqmail.conf(5)\fR, \fBmasqmail(8)\fR, 
     9.1 --- a/docs/masqmail.conf.5	Sat May 29 21:51:13 2010 +0200
     9.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     9.3 @@ -1,492 +0,0 @@
     9.4 -.TH masqmail.conf 5 2010-05-07 masqmail-0.2.22 "File Formats"
     9.5 -
     9.6 -.SH NAME
     9.7 -masqmail.conf \- masqmail configuration file
     9.8 -
     9.9 -
    9.10 -.SH DESCRIPTION
    9.11 -
    9.12 -This man page describes the syntax of the main configuration file of masqmail.
    9.13 -Its usual location is \fI/etc/masqmail/masqmail.conf\fR
    9.14 -
    9.15 -The configuration consists of lines of the form
    9.16 -
    9.17 -\fBval\fR = \fIexpression\fR
    9.18 -
    9.19 -Where \fBval\fR is a variable name and \fIexpression\fR a string,
    9.20 -which can be quoted with double quotes `"'.
    9.21 -If the expression is on multiple lines or contains characters other than letters,
    9.22 -digits or the characters `.', `-', `_', `/', it must be quoted.
    9.23 -You can use quotes inside quotes by escaping them with a backslash.
    9.24 -
    9.25 -Each val has a type, which can be boolean, numeric, string or list.
    9.26 -A boolean variable can be set with one of the values `on', `yes', and `true' or `off', `no' and `false'.
    9.27 -List items are separated with semicolons `;'.
    9.28 -For some values patterns (like `*',`?') can be used.
    9.29 -The spaces before and after the equal sign `=' are optional.
    9.30 -
    9.31 -Most lists (exceptions: \fBlocal_hosts\fR, \fBlocal_nets\fR, \fBlisten_addresses\fR,
    9.32 -\fBonline_routes\fR, and \fBonline_gets\fR) accept files.
    9.33 -These will be recognized by a leading slash `/'.
    9.34 -The contents of these files will be included at the position of the file name,
    9.35 -there can be items or other files before and after the file entry.
    9.36 -The format of the files is different though, within these files each entry is on another line.
    9.37 -(And not separated by semicolons).
    9.38 -This makes it easy to include large lists which are common in different configuration files,
    9.39 -so they do not have to appear in every configuration file.
    9.40 -
    9.41 -Blank lines and lines starting with a hash `#' are ignored.
    9.42 -
    9.43 -
    9.44 -.SH OPTIONS
    9.45 -
    9.46 -.TP
    9.47 -\fBrun_as_user = \fIboolean\fR
    9.48 -
    9.49 -If this is set, masqmail runs with the user id of the user who invoked it and never changes it.
    9.50 -This is for debugging purposes only.
    9.51 -If the user is not root, masqmail will not be able to listen on a port < 1024
    9.52 -and will not be able to deliver local mail to others than the user.
    9.53 -
    9.54 -.TP
    9.55 -\fBuse_syslog = \fIboolean\fR
    9.56 -
    9.57 -If this is set, masqmail uses syslogd for logging.
    9.58 -It uses facility MAIL.
    9.59 -You still have to set \fBlog_dir\fR for debug files.
    9.60 -
    9.61 -.TP
    9.62 -\fBdebug_level = \fIn\fR
    9.63 -
    9.64 -Set the debug level.
    9.65 -Valid values are 0 to 6, increasing it further makes no difference.
    9.66 -Be careful if you set this as high as 5 or higher, the logs may very soon fill your hard drive.
    9.67 -
    9.68 -.TP
    9.69 -\fBlog_dir = \fIfile\fR
    9.70 -
    9.71 -The directory where log are stored, if syslog is not used.
    9.72 -Debug files are stored in this directory anyways.
    9.73 -\fI/var/log/masqmail\fR is a common value.
    9.74 -\fIfile\fR must be an absolute path.
    9.75 -
    9.76 -.TP
    9.77 -\fBmail_dir = \fIfile\fR
    9.78 -
    9.79 -The directory where local mail is stored, usually \fI/var/spool/mail\fR or \fI/var/mail\fR.
    9.80 -\fIfile\fR must be an absolute path.
    9.81 -
    9.82 -.TP
    9.83 -\fBspool_dir = \fIfile\fR
    9.84 -
    9.85 -The directory where masqmail stores its spool files (and later also other stuff).
    9.86 -It must have a subdirectory \fIinput\fR.
    9.87 -Masqmail needs read and write permissions for this directory.
    9.88 -I suggest to use \fI/var/spool/masqmail\fR.
    9.89 -\fIfile\fR must be an absolute path.
    9.90 -
    9.91 -.TP
    9.92 -\fBhost_name = \fIstring\fR
    9.93 -
    9.94 -This is used in different places: Masqmail identifies itself in the greeting banner
    9.95 -on incoming connections and in the HELO/EHLO command for outgoing connections with this name,
    9.96 -it is used in the Received: header and to qualify the sender of a locally originating message.
    9.97 -
    9.98 -If the string begins with a slash `/', it it assumed that it is a filename,
    9.99 -and the first line of this file will be used.
   9.100 -Usually this will be `/etc/mailname' to make masqmail conform to Debian policies.
   9.101 -
   9.102 -It is not used to find whether an address is local. Use \fBlocal_hosts\fR for that.
   9.103 -
   9.104 -.TP
   9.105 -\fBremote_port = \fIn\fR
   9.106 -
   9.107 -The remote port number to be used. This defaults to port 25.
   9.108 -
   9.109 -This option is deprecated.
   9.110 -Use \fBhost_name\fR in the route configuration instead.
   9.111 -See \fBmasqmail.route(5)\fR.
   9.112 -
   9.113 -.TP
   9.114 -\fBlocal_hosts = \fIlist\fR
   9.115 -
   9.116 -A semicolon `;' separated list of hostnames which are considered local.
   9.117 -Normally you set it to "localhost;foo;foo.bar.com" if your host has the
   9.118 -fully qualified domain name `foo.bar.com'.
   9.119 -
   9.120 -.TP
   9.121 -\fBlocal_nets = \fIlist\fR
   9.122 -
   9.123 -A semicolon `;' separated list of hostnames which are on the `local' net.
   9.124 -Delivery to these hosts is attempted immediately.
   9.125 -You can use patterns with `*', e.g. "*.bar.com".
   9.126 -
   9.127 -.TP
   9.128 -\fBlocal_addresses = \fIlist\fR
   9.129 -
   9.130 -A semicolon `;' separated list of fully qualified email-addresses which are
   9.131 -considered local although their domain name part is not in the list of \fBlocal_hosts\fR. 
   9.132 -
   9.133 -For example: There are two people working at your LAN: person1@yourdomain and person2@yourdomain.
   9.134 -But there are other persons @yourdomain which are NOT local.
   9.135 -So you can not put yourdomain to the list of local_hosts.
   9.136 -If person1 now wants to write to person2@yourdomain and this mail should not leave the LAN then you can put
   9.137 -
   9.138 -local_addresses = "person1@yourdomain;person2@yourdomain"
   9.139 -
   9.140 -to your masqmail.conf.
   9.141 -
   9.142 -.TP
   9.143 -\fBnot_local_addresses = \fIlist\fR
   9.144 -
   9.145 -A semicolon `;' separated list of fully qualified email-addresses which are
   9.146 -considered not local although their domain name part is in the list of \fBlocal_hosts\fR. 
   9.147 -
   9.148 -This is the opposite of the previous case.
   9.149 -The majority of addresses of a specific domain are local.
   9.150 -But some users are not.
   9.151 -With this option you can easily exclude these users.
   9.152 -
   9.153 -Example:
   9.154 -
   9.155 -local_hosts = "localhost;myhost;mydomain.net"
   9.156 -
   9.157 -not_local_addresses = "eric@mydomain.net"
   9.158 -
   9.159 -.TP
   9.160 -\fBlisten_addresses = \fIlist\fR
   9.161 -
   9.162 -A semicolon `;' separated list of interfaces on which connections will be accepted.
   9.163 -An interface ist defined by a hostname, optionally followed by a colon `:' and a number for the port.
   9.164 -If this is left out, port 25 will be used.
   9.165 -
   9.166 -You can set this to "localhost:25;foo:25" if your hostname is `foo'.
   9.167 -
   9.168 -Note that the names are resolved to IP addreses.
   9.169 -If your host has different names which resolve to the same IP,
   9.170 -use only one of them, otherwise you will get an error message.
   9.171 -
   9.172 -.TP
   9.173 -\fBdo_save_envelope_to = \fIboolean\fR
   9.174 -
   9.175 -If this is set to true, a possibly existing Envelope-to: header in an incoming mail
   9.176 -which is received via either pop3 or smtp will be saved as an X-Orig-Envelope-to: header.
   9.177 -
   9.178 -This is useful if you retrieve mail from a pop3 server with either masqmail or fetchmail,
   9.179 -and the server supports Envelope-to: headers,
   9.180 -and you want to make use of those with a mail filtering tool, e.g. procmail.
   9.181 -It cannot be preserved because masqmail sets such a header by itself.
   9.182 -
   9.183 -Default is false.
   9.184 -
   9.185 -.TP
   9.186 -\fBdo_relay = \fIboolean\fR
   9.187 -
   9.188 -If this is set to false, mail with a return path that is not local and a destination
   9.189 -that is also not local will not be accepted via smtp and a 550 reply will be given.
   9.190 -Default is true.
   9.191 -
   9.192 -Note that this will not protect you from spammers using open relays,
   9.193 -but from users unable to set their address in their mail clients.
   9.194 -
   9.195 -.TP
   9.196 -\fBdo_queue = \fIboolean\fR
   9.197 -
   9.198 -If this is set, mail will not be delivered immediately when accepted.
   9.199 -Same as calling masqmail with the \fB\-odq\fR option.
   9.200 -
   9.201 -.TP
   9.202 -\fBonline_routes.\fIname\fR = \fIlist\fR
   9.203 -
   9.204 -Replace \fIname\fR with a name to identify a connection.
   9.205 -Set this to a filename (or a list of filenames) for the special route configuration for that connection.
   9.206 -You will use that name to call masqmail with the \fB\-qo\fR option every time a
   9.207 -connection to your ISP is set up.
   9.208 -
   9.209 -Example: Your ISP has the name FastNet.
   9.210 -Then you write the following line in the main configuration:
   9.211 -
   9.212 -\fBonline_routes.FastNet\fR = \fI"/etc/masqmail/fastnet.route"\fR
   9.213 -
   9.214 -\fI/etc/masqmail/fastnet.route\fR is the route configuration file, see \fBmasqmail.route(5)\fR.
   9.215 -As soon as a link to FastNet has been set up, you call masqmail \fB\-qo \fIFastNet\fR.
   9.216 -Masqmail will then read the specified file and send the mails.
   9.217 -
   9.218 -.TP
   9.219 -\fBconnect_route.\fIname\fR = \fIlist\fR
   9.220 -
   9.221 -Old name for \fBonline_routes\fR.
   9.222 -
   9.223 -.TP
   9.224 -\fBlocal_net_route = \fIfile\fR
   9.225 -
   9.226 -This is similar to \fBonline_routes.\fIname\fR but for the local net.
   9.227 -Recipient addresses that are in local_nets will be routed using this route configuration.
   9.228 -Main purpose is to define a mail server with mail_host in your local network.
   9.229 -In simple environments this can be left unset.
   9.230 -If unset, a default route configuration will be used.
   9.231 -
   9.232 -.TP
   9.233 -\fBalias_file = \fIfile\fR
   9.234 -
   9.235 -Set this to the location of your alias file.
   9.236 -If unset, no aliasing will be done.
   9.237 -
   9.238 -.TP
   9.239 -\fBalias_local_caseless = \fIboolean\fR
   9.240 -
   9.241 -If this is set, local parts in the alias file will be matched disregarding upper/lower case.
   9.242 -
   9.243 -.TP
   9.244 -\fBpipe_fromline = \fIboolean\fR
   9.245 -
   9.246 -If this is set, a from line will be prepended to the output stream whenever
   9.247 -a pipe command is called after an alias expansion.
   9.248 -Default is false.
   9.249 -
   9.250 -.TP
   9.251 -\fBpipe_fromhack = \fIboolean\fR
   9.252 -
   9.253 -If this is set, each line beginning with `From ' is replaced with `>From '
   9.254 -whenever a pipe command is called after an alias expansion.
   9.255 -You probably want this if you have set \fBpipe_fromline\fR above.
   9.256 -Default is false.
   9.257 -
   9.258 -.TP
   9.259 -\fBmbox_default = \fIstring\fR
   9.260 -
   9.261 -The default local delivery method.
   9.262 -Can be one of mbox, mda or maildir (the latter only if maildir support is enabled at compile time).
   9.263 -Default is mbox.
   9.264 -You can override this for each user by using the \fBmbox_users\fR, \fBmda_users\fR,
   9.265 -or \fBmaildir_users\fR options (see below).
   9.266 -
   9.267 -.TP
   9.268 -\fBmbox_users = \fIlist\fR
   9.269 -
   9.270 -A list of users which wish delivery to an mbox style mail folder.
   9.271 -
   9.272 -.TP
   9.273 -\fBmda_users = \fIlist\fR
   9.274 -
   9.275 -A list of users which wish local delivery to an mda.
   9.276 -You have to set \fBmda\fR (see below) as well.
   9.277 -
   9.278 -.TP
   9.279 -\fBmaildir_users = \fIlist\fR
   9.280 -
   9.281 -A list of users which wish delivery to a qmail style maildir.
   9.282 -The path to maildir is ~/Maildir/.
   9.283 -The maildir will be created if it does not exist.
   9.284 -
   9.285 -.TP
   9.286 -\fBmda = \fIexpand string\fR
   9.287 -
   9.288 -If you want local delivery to be transferred to an mda (Mail Delivery Agent),
   9.289 -set this to a command.
   9.290 -The argument will be expanded on delivery time,
   9.291 -you can use variables beginning with a dolloar sign `$', optionally enclosed in curly braces.
   9.292 -Variables you can use are:
   9.293 -
   9.294 -uid - the unique message id.
   9.295 -This is not necessarily identical with the Message ID as given in the Message ID: header.
   9.296 -
   9.297 -received_host - the host the mail was received from
   9.298 -
   9.299 -ident - the ident, this is either the ident delivered by the ident protocol
   9.300 -or the user id of the sender if the message was received locally.
   9.301 -
   9.302 -return_path_local - the local part of the return path (sender).
   9.303 -
   9.304 -return_path_domain - the domain part of the return path (sender).
   9.305 -
   9.306 -return_path - the complete return path (sender).
   9.307 -
   9.308 -rcpt_local - the local part of the recipient.
   9.309 -
   9.310 -rcpt_domain - the domain part of the recipient.
   9.311 -
   9.312 -rcpt - the complete recipient address.
   9.313 -
   9.314 -Example:
   9.315 -
   9.316 -mda="/usr/bin/procmail \-Y \-d ${rcpt_local}"
   9.317 -
   9.318 -For the mda, as for pipe commands, a few environment variables will be set as well.
   9.319 -See \fBmasqmail(8)\fR.
   9.320 -To use environment variables for the mda, the dollar sign `$' has to be escaped with a backslash,
   9.321 -otherwise they will be tried to be expanded with the internal variables.
   9.322 -
   9.323 -.TP
   9.324 -\fBmda_fromline = \fIboolean\fR
   9.325 -
   9.326 -If this is set, a from line will be prepended to the output stream whenever
   9.327 -a message is delivered to an mda.
   9.328 -Default is false.
   9.329 -
   9.330 -.TP
   9.331 -\fBmda_fromhack = \fIboolean\fR
   9.332 -
   9.333 -If this is set, each line beginning with `From ' is replaced with `>From '
   9.334 -whenever a message is delivered to an mda.
   9.335 -You probably want this if you have set \fBmda_fromline\fR above.
   9.336 -Default is false.
   9.337 -
   9.338 -.TP
   9.339 -\fBonline_detect = \fIstring\fR
   9.340 -
   9.341 -Defines the method masqmail uses to detect whether there is currently an online connection.
   9.342 -It can have the values \fBfile\fR, \fBpipe\fR, or \fBmserver\fR.
   9.343 -
   9.344 -When it is set to \fBfile\fR, masqmail first checks for the existence of \fBonline_file\fR
   9.345 -(see below) and if it exists, it reads it.
   9.346 -The content of the file should be the name of the current connection as defined
   9.347 -with \fBconnect_route.\fIname\fR (trailing whitespace is removed).
   9.348 -
   9.349 -When it is set to \fBpipe\fR, masqmail calls the executable given by the
   9.350 -\fBonline_pipe\fR option (see below) and reads the current online status from its standard output.
   9.351 -
   9.352 -When it is set to \fBmserver\fR, masqmail connects to the masqdialer server
   9.353 -using the value of \fBmserver_iface\fR and asks it whether a connection exists and for the name,
   9.354 -which should be the name of the current connection as defined with \fBconnect_route.\fIname\fR.
   9.355 -
   9.356 -No matter how masqmail detects the online status,
   9.357 -only messages that are accepted at online time will be delivered using the connection.
   9.358 -The spool still has to be emptied with masqmail \fB\-qo\fIconnection\fR.
   9.359 -
   9.360 -.TP
   9.361 -\fBonline_file = \fIfile\fR
   9.362 -
   9.363 -This is the name of the file checked for when masqmail determines whether it is online.
   9.364 -The file should only exist when there is currently a connection.
   9.365 -Create it in your ip-up script with e.g.
   9.366 -
   9.367 -echo \-n <name> > /var/run/masqmail/masqmail-route
   9.368 -
   9.369 -chmod 0644 /var/run/masqmail/masqmail-route
   9.370 -
   9.371 -Do not forget to delete it in your ip-down script.
   9.372 -
   9.373 -.TP
   9.374 -\fBonline_pipe = \fIfile\fR
   9.375 -
   9.376 -This is the name of the executable which will be called to determine the online status.
   9.377 -This executable should just print the name of the current connection to
   9.378 -the standard output and return a zero status code.
   9.379 -masqmail assumes it is offline if the script returns with a non zero status.
   9.380 -Simple example:
   9.381 -
   9.382 -#!/bin/sh
   9.383 -
   9.384 -[ \-e /var/run/masqmail/masqmail-route ] || exit 1
   9.385 -
   9.386 -cat /var/run/masqmail/masqmail-route
   9.387 -
   9.388 -exit 0
   9.389 -
   9.390 -Of course, instead of the example above you could as well use \fBfile\fR as
   9.391 -the online detection method, but you can do something more sophisticated.
   9.392 -
   9.393 -.TP
   9.394 -\fBmserver_iface = \fIinterface\fR
   9.395 -
   9.396 -The interface the masqdialer server is listening to.
   9.397 -Usually this will be "localhost:224" if mserver is running on the same host as masqmail.
   9.398 -But using this option, you can also let masqmail run on another host by setting
   9.399 -\fBmserver_iface\fR to another hostname, e.g. "foo:224".
   9.400 -
   9.401 -.TP
   9.402 -\fBget.\fIname\fR = \fIfile\fR
   9.403 -
   9.404 -Replace \fIname\fR with a name to identify a get configuration.
   9.405 -Set this to a filename for the get configuration.
   9.406 -These files will be used to retrieve mail when called with the \-g option.
   9.407 -
   9.408 -.TP
   9.409 -\fBonline_gets.\fIname\fR = \fIlist\fR
   9.410 -
   9.411 -Replace \fIname\fR with a name to identify an online configuration.
   9.412 -Set this to a filename (or a list of filenames) for the get configuration.
   9.413 -These files will be used to retrieve mail when called with the \-go option.
   9.414 -
   9.415 -.TP
   9.416 -\fBident_trusted_nets = \fIlist\fR
   9.417 -
   9.418 -\fIlist\fR is a list of networks of the form a.b.c.d/e (e.g. 192.168.1.0/24),
   9.419 -from which the ident given by the ident protocol will be trusted,
   9.420 -so a user can delete his mail from the queue if the ident is identical to his login name.
   9.421 -
   9.422 -.TP
   9.423 -\fBerrmsg_file = \fIfile\fR
   9.424 -
   9.425 -Set this to a template which will be used to generate delivery failure reports.
   9.426 -Variable parts within the template begin with a dollar sign and are identical
   9.427 -to those which can be used as arguments for the mda command, see \fBmda\fR above.
   9.428 -Additional information can be included with @failed_rcpts, @msg_headers and @msg_body,
   9.429 -these must be at the beginning of a line and will be replaced with the list of the failed recipients,
   9.430 -the message headers and the message body of the failed message.
   9.431 -
   9.432 -Default is /usr/share/masqmail/tpl/failmsg.tpl.
   9.433 -
   9.434 -.TP
   9.435 -\fBwarnmsg_file = \fIfile\fR
   9.436 -
   9.437 -Set this to a template which will be used to generate delivery warning reports.
   9.438 -It uses the same mechanisms for variables as \fBerrmsg_file\fR, see above.
   9.439 -
   9.440 -Default is /usr/share/masqmail/tpl/warnmsg.tpl.
   9.441 -
   9.442 -.TP
   9.443 -\fBwarn_intervals\fR = \fIlist\fR
   9.444 -
   9.445 -Set this to a list of time intervals, at which delivery warnings
   9.446 -(starting with the receiving time of the message) shall be generated.
   9.447 -
   9.448 -A warning will only be generated just after an attempt to deliver the mail
   9.449 -and if that attempt failed temporarily.
   9.450 -So a warning may be generated after a longer time, if there was no attempt before.
   9.451 -
   9.452 -Default is "1h;4h;8h;1d;2d;3d"
   9.453 -
   9.454 -.TP
   9.455 -\fBmax_defer_time\fR = \fItime\fR
   9.456 -
   9.457 -This is the maximum time, in which a temporarily failed mail will be kept in the spool.
   9.458 -When this time is exceeded, it will be handled as a delivery failure,
   9.459 -and the message will be bounced.
   9.460 -
   9.461 -The excedence of this time will only be noticed if the message was actually tried to be delivered.
   9.462 -If, for example, the message can only be delivered when online,
   9.463 -but you have not been online for that time, no bounce will be generated.
   9.464 -
   9.465 -Default is 4d (4 days)
   9.466 -
   9.467 -.TP
   9.468 -\fBlog_user = \fIname\fR
   9.469 -
   9.470 -Replace \fIname\fR with a valid local or remote mail address.
   9.471 -
   9.472 -If this option is set, then a copy of every mail,
   9.473 -that passes through the masqmail system will also be sent to the given mail address.
   9.474 -
   9.475 -For example you can feed your mails into a program like hypermail
   9.476 -for archiving purpose by placing an appropriate pipe command in masqmail.alias
   9.477 -
   9.478 -
   9.479 -.SH AUTHOR
   9.480 -
   9.481 -Masqmail was written by Oliver Kurth.
   9.482 -It is now maintained by Markus Schnalke <meillo@marmaro.de>.
   9.483 -
   9.484 -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR.
   9.485 -There is also a mailing list, you will find information about it at masqmail's main site.
   9.486 -
   9.487 -
   9.488 -.SH BUGS
   9.489 -
   9.490 -Please report bugs to the mailing list.
   9.491 -
   9.492 -
   9.493 -.SH SEE ALSO
   9.494 -
   9.495 -\fBmasqmail(8)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.get(5)\fR
    10.1 --- a/docs/masqmail.get.5	Sat May 29 21:51:13 2010 +0200
    10.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    10.3 @@ -1,134 +0,0 @@
    10.4 -.TH masqmail.get 5 2010-05-07 masqmail-0.2.22 "File Formats"
    10.5 -
    10.6 -.SH NAME
    10.7 -masqmail.get \- masqmail get configuration file
    10.8 -
    10.9 -
   10.10 -.SH DESCRIPTION
   10.11 - 
   10.12 -This man page describes the options available for the masqmail get configuration.
   10.13 -
   10.14 -
   10.15 -.SH OPTIONS
   10.16 -
   10.17 -.TP
   10.18 -\fBprotocol\fR = \fIstring\fR
   10.19 -
   10.20 -The protocol with which you retrieve your mail.
   10.21 -Currently only `pop3' and `apop' are supported.
   10.22 -There is no default.
   10.23 -
   10.24 -.TP
   10.25 -\fBserver\fR = \fIstring\fR
   10.26 -
   10.27 -The server you get your mail from.
   10.28 -
   10.29 -.TP
   10.30 -\fBresolve_list\fR = \fIlist\fR
   10.31 -
   10.32 -Specify the method how the domain of the server is resolved.
   10.33 -Possible values are dns_mx, dns_a, byname.
   10.34 -For `dns_mx', the domain is assumed to be an MX pointer to a list of host names,
   10.35 -these will be tried each in order
   10.36 -(lowest preference value first, equal preference values in random order).
   10.37 -For `dns_a', the domain is assumed to be an A pointer.
   10.38 -For `byname', the library function \fBgethostbyname(3)\fR will be used.
   10.39 -
   10.40 -The default is "dns_a;byname".
   10.41 -It does not make much sense here to use `dns_mx'.
   10.42 -
   10.43 -.TP
   10.44 -\fBuser\fR = \fIstring\fR
   10.45 -
   10.46 -Your login name.
   10.47 -
   10.48 -.TP
   10.49 -\fBpass\fR = \fIstring\fR
   10.50 -
   10.51 -Your password.
   10.52 -
   10.53 -.TP
   10.54 -\fBaddress\fR = \fIaddress\fR
   10.55 -
   10.56 -The address where the retrieved mail should be sent to.
   10.57 -It can be any address, but you probably want to set this to a local address on your LAN.
   10.58 -
   10.59 -.TP
   10.60 -\fBreturn_path\fR = \fIaddress\fR
   10.61 -
   10.62 -If set, masqmail sets the return path to this address.
   10.63 -Bounces generated during further delivery will be sent to this address.
   10.64 -If unset, masqmail looks for the Return-Path: header in the mail,
   10.65 -if this does not exist it uses the From: address and if this fails, postmaster will be used.
   10.66 -
   10.67 -It is in most cases not useful to set this to the same address as the `address'
   10.68 -option as this may generate multiple bounces.
   10.69 -postmaster is recommended.
   10.70 -
   10.71 -.TP
   10.72 -\fBdo_keep\fR = \fIboolean\fR
   10.73 -
   10.74 -If you want to keep your mail on the server after you retrieved it, set this to true.
   10.75 -It is recommended that you also set do_uidl,
   10.76 -otherwise you will get the mail again each time you connect to the server.
   10.77 -Masqmail does not check any headers before it retrieves mail, which may mark it as already fetched.
   10.78 -Note that this behaviour is different to that of fetchmail.
   10.79 -The default is false.
   10.80 -
   10.81 -.TP
   10.82 -\fBdo_uidl\fR = \fIboolean\fR
   10.83 -
   10.84 -If set, masqmail keeps a list of unique IDs of mails already fetched,
   10.85 -so that they will not be retrieved again.
   10.86 -Default is false.
   10.87 -
   10.88 -.TP
   10.89 -\fBdo_uidl_dele\fR = \fIboolean\fR
   10.90 -
   10.91 -If set, and \fBdo_uidl\fR is also set, MasqMail sends a delete (DELE) command
   10.92 -to the server for each message uid in the uid listing at the beginning of the session.
   10.93 -This prevents mail to be left on the server if masqmail gets interrupted during
   10.94 -a session before it can send the QUIT command to the server.
   10.95 -Default is false.
   10.96 -
   10.97 -.TP
   10.98 -\fBmax_size\fR = \fInumeric\fR
   10.99 -
  10.100 -If set to a value > 0, only messages smaller than this in bytes will be retrieved.
  10.101 -The default is 0.
  10.102 -
  10.103 -.TP
  10.104 -\fBmax_count\fR = \fInumeric\fR
  10.105 -
  10.106 -If set to a value > 0, only \fBmax_count\fR messages will be retrieved.
  10.107 -The default is 0.
  10.108 -
  10.109 -.TP
  10.110 -\fBwrapper\fR = \fIcommand\fR
  10.111 -
  10.112 -If set, instead of opening a connection to a remote server,
  10.113 -\fIcommand\fR will be called and all traffic will be piped to its stdin and from its stdout.
  10.114 -Purpose is to tunnel ip traffic, e.g. for ssl.
  10.115 -
  10.116 -Example for ssl tunneling:
  10.117 -
  10.118 -wrapper="/usr/bin/openssl s_client \-quiet \-connect pop.gmx.net:995 2>/dev/null"
  10.119 -
  10.120 -
  10.121 -.SH AUTHOR
  10.122 -
  10.123 -Masqmail was written by Oliver Kurth.
  10.124 -It is now maintained by Markus Schnalke <meillo@marmaro.de>.
  10.125 -
  10.126 -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR.
  10.127 -There is also a mailing list, you will find information about it at masqmail's main site.
  10.128 -
  10.129 -
  10.130 -.SH BUGS
  10.131 -
  10.132 -Please report bugs to the mailing list.
  10.133 -
  10.134 -
  10.135 -.SH SEE ALSO
  10.136 -
  10.137 -\fBmasqmail(8)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.conf(5)\fR
    11.1 --- a/docs/masqmail.route.5	Sat May 29 21:51:13 2010 +0200
    11.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    11.3 @@ -1,308 +0,0 @@
    11.4 -.TH masqmail.route 5 2010-05-07 masqmail-0.2.22 "File Formats"
    11.5 -
    11.6 -.SH NAME
    11.7 -masqmail.route \- masqmail route configuration file
    11.8 -
    11.9 -
   11.10 -.SH DESCRIPTION
   11.11 -
   11.12 -This man page describes the syntax of the route configuration files of \fBmasqmail (8)\fR.
   11.13 -Their usual locations are in \fI/etc/masqmail/\fR.
   11.14 -
   11.15 -.SH OPTIONS
   11.16 -
   11.17 -.TP
   11.18 -\fBprotocol\fR = \fIstring\fR
   11.19 -
   11.20 -\fIstring\fR can be one of `smtp' or `pipe', default is `smtp'.
   11.21 -If set to `smtp', mail will be sent with the SMTP protocol to its destination.
   11.22 -If set to `pipe', you also have to set `pipe' to a command, the message will then be piped to a program.
   11.23 -See option `pipe' below.
   11.24 -
   11.25 -.TP
   11.26 -\fBmail_host\fR = \fIstring\fR
   11.27 -
   11.28 -This is preferably the mail server of your ISP.
   11.29 -All outgoing messages will be sent to this host which will distribute them to their destinations.
   11.30 -If you do not set this mails will be sent directly.
   11.31 -Because the mail server is probably `near' to you, mail transfer will be much faster if you use it.
   11.32 -
   11.33 -You can optionally give a port number following the host name and a colon, eg mail_host="mail.foo.com:25".
   11.34 -
   11.35 -.TP
   11.36 -\fBresolve_list\fR = \fIlist\fR
   11.37 -
   11.38 -Specify the method how the domain of the server is resolved.
   11.39 -Possible values are dns_mx, dns_a, byname.
   11.40 -For `dns_mx', the domain is assumed to be an MX pointer to a list of host names,
   11.41 -these will be tried each in order (lowest preference value first, equal preference values in random order).
   11.42 -For `dns_a', the domain is assumed to be an A pointer.
   11.43 -For `byname', the library function \fBgethostbyname(3)\fR will be used.
   11.44 -
   11.45 -The default is "dns_mx;dns_a;byname".
   11.46 -
   11.47 -.TP
   11.48 -\fBconnect_error_fail\fR = \fIboolean\fR
   11.49 -
   11.50 -If this is set, a connection error will cause a mail delivery to fail, ie. it will be bounced.
   11.51 -If it is unset, it will just be defered.
   11.52 -
   11.53 -Default is false.
   11.54 -The reason for this is that masqmail is designed for non permanent internet connections,
   11.55 -where such errors may occur quite often, and a bounce would be annoying.
   11.56 -
   11.57 -For the default local_net route is is set to true.
   11.58 -
   11.59 -.TP
   11.60 -\fBhelo_name\fR = \fIstring\fR
   11.61 -
   11.62 -Set the name given with the HELO/EHLO command. If this is not set,
   11.63 -\fBhost_name\fR from \fImasqmail.conf\fR will be used,
   11.64 -if the \fBdo_correct_helo\fR option (see below) is unset.
   11.65 -
   11.66 -.TP
   11.67 -\fBdo_correct_helo\fR = \fIboolean\fR
   11.68 -
   11.69 -If this is set, masqmail tries to look up your host name as it appears
   11.70 -on the internet and sends this in the HELO/EHLO command.
   11.71 -Some servers are so picky that they want this.
   11.72 -Which is really crazy.
   11.73 -It just does not make any sense to lie about ones own identity,
   11.74 -because it can always be looked up by the server.
   11.75 -Nobody should believe in the name given by HELO/EHLO anyway.
   11.76 -If this is not set, \fBhost_name\fR from \fImasqmail.conf\fR or as given with
   11.77 -the \fBhelo_name\fR (see above) will be used.
   11.78 -
   11.79 -.TP
   11.80 -\fBdo_pipelining\fR = \fIboolean\fR
   11.81 -
   11.82 -If this is set to false, masqmail will not use ESMTP PIPELINING,
   11.83 -even if the server announces that it is able to cope with it.
   11.84 -Default is true.
   11.85 -
   11.86 -You do not want to set this to false unless the mail setup on the
   11.87 -remote server side is really broken.
   11.88 -Keywords: wingate.
   11.89 -
   11.90 -.TP
   11.91 -\fBallowed_mail_locals\fR = \fIlist\fR
   11.92 -
   11.93 -This is a semicolon `;' separated list of local parts which will be allowed
   11.94 -to send mail through this connection.
   11.95 -If unset and \fBnot_allowed_mail_locals\fR is also unset, all users are allowed.
   11.96 -
   11.97 -.TP
   11.98 -\fBnot_allowed_mail_locals\fR = \fIlist\fR
   11.99 -
  11.100 -This is a semicolon `;' separated list of local parts which will be not allowed
  11.101 -to send mail through this connection.
  11.102 -Local parts in this list will not be allowed to use this route even if they
  11.103 -are part of \fBallowed_mail_locals\fR (see above).
  11.104 -
  11.105 -.TP
  11.106 -\fBallowed_return_paths\fR = \fIlist\fR
  11.107 -
  11.108 -This is a semicolon `;' separated list of addresses.
  11.109 -Messages which have one one of these addresses as the return path will be used using this route
  11.110 -(if not also in \fBnot_allowed_return_paths\fR or an item in \fBnot_allowed_mail_locals\fR matches).
  11.111 -
  11.112 -Patterns containing `?' and `*' can be used.
  11.113 -The special item "<>" matches the null sender address (eg. failure notices or delivery notifications).
  11.114 -
  11.115 -.TP
  11.116 -\fBnot_allowed_return_paths\fR = \fIlist\fR
  11.117 -
  11.118 -This is a semicolon `;' separated list of addresses.
  11.119 -Messages which have one one of these addresses as the return path will not
  11.120 -be used using this route (even if also in \fBallowed_return_paths\fR
  11.121 -or an item in \fBallowed_mail_locals\fR matches).
  11.122 -
  11.123 -Patterns containing `?' and `*' can be used.
  11.124 -The special item "<>" matches the null sender address (eg. failure notices or delivery notifications).
  11.125 -
  11.126 -.TP
  11.127 -\fBallowed_rcpt_domains\fR = \fIlist\fR
  11.128 -
  11.129 -A list of recipient domains where mail will be sent to.
  11.130 -This is for example useful if you use this route configuration when connected to another LAN via ppp.
  11.131 -Patterns containing `?' and `*' can be used.
  11.132 -
  11.133 -.TP
  11.134 -\fBnot_allowed_rcpt_domains\fR = \fIlist\fR
  11.135 -
  11.136 -A list of recipient domains where mail will not be sent to.
  11.137 -This is for example useful if you send mail directly (\fBmail_host\fR is not set)
  11.138 -and you know of hosts that will not accept mail from you because they use a dialup list
  11.139 -(eg. \fBhttp://maps.vix.com/dul/\fR).
  11.140 -If any domain matches both \fBallowed_rcpt_domains\fR and \fBnot_allowed_rcpt_domains\fR,
  11.141 -mail will not be sent to this domain.
  11.142 -Patterns containing `?' and `*' can be used.
  11.143 -
  11.144 -.TP
  11.145 -\fBset_h_from_domain\fR = \fIstring\fR
  11.146 -
  11.147 -Replace the domain part in `From:' headers with this value.
  11.148 -This may be useful if you use a private, outside unknown address on your local LAN
  11.149 -and want this to be replaced by the domain of the address of your email addrsss on the internet.
  11.150 -Note that this is different to \fBset_return_path_domain\fR, see below.
  11.151 -
  11.152 -.TP
  11.153 -\fBset_return_path_domain\fR = \fIstring\fR
  11.154 -
  11.155 -Sets the domain part of the envelope from address.
  11.156 -Some hosts check whether this is the same as the net the connection is coming from.
  11.157 -If not, they reject the mail because they suspect spamming.
  11.158 -It should be a valid address, because some mail servers also check that.
  11.159 -You can also use this to set it to your usual address on the internet
  11.160 -and put a local address only known on your LAN in the configuration of your mailer.
  11.161 -Only the domain part will be changed, the local part remains unchanged.
  11.162 -Use \fBmap_return_path_addresses\fR for rewriting local parts.
  11.163 -
  11.164 -.TP
  11.165 -\fBmap_h_from_addresses\fR = \fIlist\fR
  11.166 -
  11.167 -This is similar to \fBset_h_from_domain\fR, but more flexible.
  11.168 -Set this to a list which maps local parts to a full RFC 822 compliant email address,
  11.169 -the local parts (the keys) are separated from the addresses (the values) by colons (`:').
  11.170 -
  11.171 -Example:
  11.172 -
  11.173 -map_h_from_addresses = "john: John Smith <jsmith@mail.academic.edu>; charlie: Charlie Miller <cmiller@mx.commercial.com>"
  11.174 -
  11.175 -You can use patterns, eg. * as keys.
  11.176 -
  11.177 -.TP
  11.178 -\fBmap_h_reply_to_addresses\fR = \fIlist\fR
  11.179 -
  11.180 -Same as \fBmap_h_from_addresses\fR, but for the `Reply-To:' header.
  11.181 -
  11.182 -.TP
  11.183 -\fBmap_h_mail_followup_to_addresses\fR = \fIlist\fR
  11.184 -
  11.185 -Same as \fBmap_h_from_addresses\fR, but for the `Mail-Followup-To:' header.
  11.186 -Useful when replying to mailing lists.
  11.187 -
  11.188 -.TP
  11.189 -\fBmap_return_path_addresses\fR = \fIlist\fR
  11.190 -
  11.191 -This is similar to \fBset_return_path_domain\fR, but more flexible.
  11.192 -Set this to a list which maps local parts to a full RFC 821 compliant email address,
  11.193 -the local parts (the keys) are separated from the addresses (the values) by colons (`:').
  11.194 -Note that this option takes RFC 821 addresses while \fBmap_h_from_addresses\fR takes RFC 822 addresses.
  11.195 -The most important difference is that RFC 821 addresses have no full name.
  11.196 -
  11.197 -Example:
  11.198 -
  11.199 -map_return_path_addresses = "john: <jsmith@mail.academic.edu>; charlie: <cmiller@mx.commercial.com>"
  11.200 -
  11.201 -You can use patterns, eg. * as keys.
  11.202 -
  11.203 -.TP
  11.204 -\fBexpand_h_sender_address\fR = \fIboolean\fR
  11.205 -
  11.206 -This sets the domain of the sender address as given by the Sender: header
  11.207 -to the same address as in the envelope return path address
  11.208 -(which can be set by either \fBset_return_path_domain\fR or \fBmap_return_path_addresses\fR).
  11.209 -This is for mail clients (eg. Microsoft Outlook) which use this address as the sender address.
  11.210 -Though they should use the From: address, see RFC 821.
  11.211 -If \fBfetchmail(1)\fR encounters an unqualified Sender: address,
  11.212 -it will be expanded to the domain of the pop server, which is almost never correct.
  11.213 -Default is true.
  11.214 -
  11.215 -.TP
  11.216 -\fBexpand_h_sender_domain\fR = \fIboolean\fR
  11.217 -
  11.218 -Like \fBexpand_h_sender_address\fR, but sets the domain only.
  11.219 -Deprecated, will be removed in a later version.
  11.220 -
  11.221 -.TP
  11.222 -\fBlast_route\fR = \fIboolean\fR
  11.223 -
  11.224 -If this is set, a mail which would have been delivered using this route,
  11.225 -but has failed temporarily, will not be tried to be delivered using the next route.
  11.226 -
  11.227 -If you have set up a special route with filters using the lists `allowed_rcpt_domains',
  11.228 -`allowed_return_paths', and `allowed_mail_locals' or their complements (not_),
  11.229 -and the mail passing these rules should be delivered using this route only,
  11.230 -you should set this to `true'.
  11.231 -Otherwise the mail would be passed to the next route (if any),
  11.232 -unless that route has rules which prevent that.
  11.233 -
  11.234 -Default is false.
  11.235 -
  11.236 -.TP
  11.237 -\fBauth_name\fR = \fIstring\fR
  11.238 -
  11.239 -Set the authentication type for ESMTP AUTH authentication.
  11.240 -Currently only `cram-md5' and `login' are supported.
  11.241 -
  11.242 -.TP
  11.243 -\fBauth_login\fR = \fIstring\fR
  11.244 -
  11.245 -Your account name for ESMTP AUTH authentication.
  11.246 -
  11.247 -.TP
  11.248 -\fBauth_secret\fR = \fIstring\fR
  11.249 -
  11.250 -Your secret for ESMTP AUTH authentication.
  11.251 -
  11.252 -.TP
  11.253 -\fBpop3_login\fR = \fIfile\fR
  11.254 -
  11.255 -If your Mail server requires SMTP-after-POP,
  11.256 -set this to a get configuration (see \fBmasqmail.get(5)\fR).
  11.257 -If you login to the POP server before you send, this is not necessary.
  11.258 -
  11.259 -.TP
  11.260 -\fBwrapper\fR = \fIcommand\fR
  11.261 -
  11.262 -If set, instead of opening a connection to a remote server,
  11.263 -\fIcommand\fR will be called and all traffic will be piped to its stdin and from its stdout.
  11.264 -Purpose is to tunnel ip traffic, eg. for ssl.
  11.265 -
  11.266 -Example for ssl tunneling:
  11.267 -
  11.268 -wrapper="/usr/bin/openssl s_client \-quiet \-connect pop.gmx.net:995 2>/dev/null"
  11.269 -
  11.270 -.TP
  11.271 -\fBpipe\fR = \fIcommand\fR
  11.272 -
  11.273 -If set, and protocol is set to `pipe',
  11.274 -\fIcommand\fR will be called and the message will be piped to its stdin.
  11.275 -Purpose is to use gateways to uucp, fax, sms or whatever else.
  11.276 -
  11.277 -You can use variables to give as arguments to the command,
  11.278 -these are the same as for the mda in the main configuration, see \fBmasqmail.conf(5)\fR.
  11.279 -
  11.280 -.TP
  11.281 -\fBpipe_fromline = \fIboolean\fR
  11.282 -
  11.283 -If this is set, and protocol is set to `pipe',
  11.284 -a from line will be prepended to the output stream whenever a pipe command is called.
  11.285 -Default is false.
  11.286 -
  11.287 -.TP
  11.288 -\fBpipe_fromhack = \fIboolean\fR
  11.289 -
  11.290 -If this is set, and protocol is set to `pipe',
  11.291 -each line beginning with `From ' is replaced with `>From ' whenever a pipe command is called.
  11.292 -You probably want this if you have set \fBpipe_fromline\fR above.
  11.293 -Default is false.
  11.294 -
  11.295 -
  11.296 -.SH AUTHOR
  11.297 -
  11.298 -Masqmail was written by Oliver Kurth.
  11.299 -It is now maintained by Markus Schnalke <meillo@marmaro.de>.
  11.300 -
  11.301 -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR.
  11.302 -There is also a mailing list, you will find information about it at masqmail's main site.
  11.303 -
  11.304 -
  11.305 -.SH BUGS
  11.306 -
  11.307 -Please report bugs to the mailing list.
  11.308 -
  11.309 -.SH SEE ALSO
  11.310 -
  11.311 -\fBmasqmail(8)\fR, \fBmasqmail.conf(5)\fR, \fBmasqmail.get(5)\fR
    12.1 --- a/docs/mservdetect.8	Sat May 29 21:51:13 2010 +0200
    12.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
    12.3 @@ -1,49 +0,0 @@
    12.4 -.TH mservdetect 8 2010-05-07 masqmail-0.2.22 "Maintenance Commands"
    12.5 -
    12.6 -.SH NAME
    12.7 -mservdetect \- Helper for masqmail and masqdialer
    12.8 -
    12.9 -
   12.10 -.SH SYNOPSIS
   12.11 -\fB/usr/bin/masqmail \fIhost port\fR
   12.12 -
   12.13 -
   12.14 -.SH DESCRIPTION
   12.15 -
   12.16 -Mservdetect is a small helper application for masqmail to detect its online status
   12.17 -if the modem server masqdialer is used.
   12.18 -It connects to the\fIhost\fR at \fIport\fR and prints the connection name to stdout.
   12.19 -
   12.20 -If you want to use it, set \fBonline_detect\fR=\fIpipe\fR and
   12.21 -\fBonline_pipe\fR=\fI"/usr/bin/mservdetect host port"\fR.
   12.22 -
   12.23 -.SH OPTIONS
   12.24 -
   12.25 -.TP
   12.26 -\fBhost\fR
   12.27 -
   12.28 -The hostname where the masqdialer server is running.
   12.29 -
   12.30 -.TP
   12.31 -\fBport\fR
   12.32 -
   12.33 -The port number where the masqdialer server is listening.
   12.34 -
   12.35 -
   12.36 -.SH AUTHOR
   12.37 -
   12.38 -Masqmail was written by Oliver Kurth.
   12.39 -It is now maintained by Markus Schnalke <meillo@marmaro.de>.
   12.40 -
   12.41 -You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR.
   12.42 -There is also a mailing list, you will find information about it at masqmail's main site.
   12.43 -
   12.44 -
   12.45 -.SH BUGS
   12.46 -
   12.47 -Please report bugs to the mailing list.
   12.48 -
   12.49 -
   12.50 -.SH SEE ALSO
   12.51 -
   12.52 -\fBmasqmail.conf(5)\fR
    13.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    13.2 +++ b/man/Makefile.am	Sat May 29 22:07:07 2010 +0200
    13.3 @@ -0,0 +1,1 @@
    13.4 +man_MANS=masqmail.8 mservdetect.8 masqmail.conf.5 masqmail.route.5 masqmail.get.5 masqmail.aliases.5
    14.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    14.2 +++ b/man/Makefile.in	Sat May 29 22:07:07 2010 +0200
    14.3 @@ -0,0 +1,454 @@
    14.4 +# Makefile.in generated by automake 1.11.1 from Makefile.am.
    14.5 +# @configure_input@
    14.6 +
    14.7 +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
    14.8 +# 2003, 2004, 2005, 2006, 2007, 2008, 2009  Free Software Foundation,
    14.9 +# Inc.
   14.10 +# This Makefile.in is free software; the Free Software Foundation
   14.11 +# gives unlimited permission to copy and/or distribute it,
   14.12 +# with or without modifications, as long as this notice is preserved.
   14.13 +
   14.14 +# This program is distributed in the hope that it will be useful,
   14.15 +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
   14.16 +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
   14.17 +# PARTICULAR PURPOSE.
   14.18 +
   14.19 +@SET_MAKE@
   14.20 +VPATH = @srcdir@
   14.21 +pkgdatadir = $(datadir)/@PACKAGE@
   14.22 +pkgincludedir = $(includedir)/@PACKAGE@
   14.23 +pkglibdir = $(libdir)/@PACKAGE@
   14.24 +pkglibexecdir = $(libexecdir)/@PACKAGE@
   14.25 +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
   14.26 +install_sh_DATA = $(install_sh) -c -m 644
   14.27 +install_sh_PROGRAM = $(install_sh) -c
   14.28 +install_sh_SCRIPT = $(install_sh) -c
   14.29 +INSTALL_HEADER = $(INSTALL_DATA)
   14.30 +transform = $(program_transform_name)
   14.31 +NORMAL_INSTALL = :
   14.32 +PRE_INSTALL = :
   14.33 +POST_INSTALL = :
   14.34 +NORMAL_UNINSTALL = :
   14.35 +PRE_UNINSTALL = :
   14.36 +POST_UNINSTALL = :
   14.37 +subdir = man
   14.38 +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in
   14.39 +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
   14.40 +am__aclocal_m4_deps = $(top_srcdir)/configure.ac
   14.41 +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
   14.42 +	$(ACLOCAL_M4)
   14.43 +mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs
   14.44 +CONFIG_HEADER = $(top_builddir)/config.h
   14.45 +CONFIG_CLEAN_FILES =
   14.46 +CONFIG_CLEAN_VPATH_FILES =
   14.47 +SOURCES =
   14.48 +DIST_SOURCES =
   14.49 +am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
   14.50 +am__vpath_adj = case $$p in \
   14.51 +    $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \
   14.52 +    *) f=$$p;; \
   14.53 +  esac;
   14.54 +am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`;
   14.55 +am__install_max = 40
   14.56 +am__nobase_strip_setup = \
   14.57 +  srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'`
   14.58 +am__nobase_strip = \
   14.59 +  for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||"
   14.60 +am__nobase_list = $(am__nobase_strip_setup); \
   14.61 +  for p in $$list; do echo "$$p $$p"; done | \
   14.62 +  sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \
   14.63 +  $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \
   14.64 +    if (++n[$$2] == $(am__install_max)) \
   14.65 +      { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \
   14.66 +    END { for (dir in files) print dir, files[dir] }'
   14.67 +am__base_list = \
   14.68 +  sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \
   14.69 +  sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g'
   14.70 +man5dir = $(mandir)/man5
   14.71 +am__installdirs = "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(man8dir)"
   14.72 +man8dir = $(mandir)/man8
   14.73 +NROFF = nroff
   14.74 +MANS = $(man_MANS)
   14.75 +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
   14.76 +ACLOCAL = @ACLOCAL@
   14.77 +AMTAR = @AMTAR@
   14.78 +AUTOCONF = @AUTOCONF@
   14.79 +AUTOHEADER = @AUTOHEADER@
   14.80 +AUTOMAKE = @AUTOMAKE@
   14.81 +AWK = @AWK@
   14.82 +BASE64_LIBS = @BASE64_LIBS@
   14.83 +CC = @CC@
   14.84 +CCDEPMODE = @CCDEPMODE@
   14.85 +CFLAGS = @CFLAGS@
   14.86 +CPP = @CPP@
   14.87 +CPPFLAGS = @CPPFLAGS@
   14.88 +CYGPATH_W = @CYGPATH_W@
   14.89 +DEFS = @DEFS@
   14.90 +DEPDIR = @DEPDIR@
   14.91 +ECHO_C = @ECHO_C@
   14.92 +ECHO_N = @ECHO_N@
   14.93 +ECHO_T = @ECHO_T@
   14.94 +EGREP = @EGREP@
   14.95 +EXEEXT = @EXEEXT@
   14.96 +GLIB_CFLAGS = @GLIB_CFLAGS@
   14.97 +GLIB_LIBS = @GLIB_LIBS@
   14.98 +GREP = @GREP@
   14.99 +IDENT_LIBS = @IDENT_LIBS@
  14.100 +INSTALL = @INSTALL@
  14.101 +INSTALL_DATA = @INSTALL_DATA@
  14.102 +INSTALL_PROGRAM = @INSTALL_PROGRAM@
  14.103 +INSTALL_SCRIPT = @INSTALL_SCRIPT@
  14.104 +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
  14.105 +LDFLAGS = @LDFLAGS@
  14.106 +LIBOBJS = @LIBOBJS@
  14.107 +LIBS = @LIBS@
  14.108 +LOCKFILE_LIBS = @LOCKFILE_LIBS@
  14.109 +LTLIBOBJS = @LTLIBOBJS@
  14.110 +MAKEINFO = @MAKEINFO@
  14.111 +MD5_LIBS = @MD5_LIBS@
  14.112 +MKDIR_P = @MKDIR_P@
  14.113 +OBJEXT = @OBJEXT@
  14.114 +PACKAGE = @PACKAGE@
  14.115 +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
  14.116 +PACKAGE_NAME = @PACKAGE_NAME@
  14.117 +PACKAGE_STRING = @PACKAGE_STRING@
  14.118 +PACKAGE_TARNAME = @PACKAGE_TARNAME@
  14.119 +PACKAGE_URL = @PACKAGE_URL@
  14.120 +PACKAGE_VERSION = @PACKAGE_VERSION@
  14.121 +PATH_SEPARATOR = @PATH_SEPARATOR@
  14.122 +PKG_CONFIG = @PKG_CONFIG@
  14.123 +PKG_CONFIG_LIBDIR = @PKG_CONFIG_LIBDIR@
  14.124 +PKG_CONFIG_PATH = @PKG_CONFIG_PATH@
  14.125 +RANLIB = @RANLIB@
  14.126 +RESOLV_LIBS = @RESOLV_LIBS@
  14.127 +SET_MAKE = @SET_MAKE@
  14.128 +SHELL = @SHELL@
  14.129 +STRIP = @STRIP@
  14.130 +USE_LIBLOCKFILE = @USE_LIBLOCKFILE@
  14.131 +VERSION = @VERSION@
  14.132 +abs_builddir = @abs_builddir@
  14.133 +abs_srcdir = @abs_srcdir@
  14.134 +abs_top_builddir = @abs_top_builddir@
  14.135 +abs_top_srcdir = @abs_top_srcdir@
  14.136 +ac_ct_CC = @ac_ct_CC@
  14.137 +am__include = @am__include@
  14.138 +am__leading_dot = @am__leading_dot@
  14.139 +am__quote = @am__quote@
  14.140 +am__tar = @am__tar@
  14.141 +am__untar = @am__untar@
  14.142 +bindir = @bindir@
  14.143 +build_alias = @build_alias@
  14.144 +builddir = @builddir@
  14.145 +datadir = @datadir@
  14.146 +datarootdir = @datarootdir@
  14.147 +docdir = @docdir@
  14.148 +dvidir = @dvidir@
  14.149 +exec_prefix = @exec_prefix@
  14.150 +has_ident = @has_ident@
  14.151 +host_alias = @host_alias@
  14.152 +htmldir = @htmldir@
  14.153 +includedir = @includedir@
  14.154 +infodir = @infodir@
  14.155 +install_sh = @install_sh@
  14.156 +libdir = @libdir@
  14.157 +libexecdir = @libexecdir@
  14.158 +localedir = @localedir@
  14.159 +localstatedir = @localstatedir@
  14.160 +mandir = @mandir@
  14.161 +mkdir_p = @mkdir_p@
  14.162 +oldincludedir = @oldincludedir@
  14.163 +pdfdir = @pdfdir@
  14.164 +prefix = @prefix@
  14.165 +program_transform_name = @program_transform_name@
  14.166 +psdir = @psdir@
  14.167 +sbindir = @sbindir@
  14.168 +sharedstatedir = @sharedstatedir@
  14.169 +srcdir = @srcdir@
  14.170 +sysconfdir = @sysconfdir@
  14.171 +target_alias = @target_alias@
  14.172 +top_build_prefix = @top_build_prefix@
  14.173 +top_builddir = @top_builddir@
  14.174 +top_srcdir = @top_srcdir@
  14.175 +with_confdir = @with_confdir@
  14.176 +with_group = @with_group@
  14.177 +with_logdir = @with_logdir@
  14.178 +with_spooldir = @with_spooldir@
  14.179 +with_user = @with_user@
  14.180 +man_MANS = masqmail.8 mservdetect.8 masqmail.conf.5 masqmail.route.5 masqmail.get.5 masqmail.aliases.5
  14.181 +all: all-am
  14.182 +
  14.183 +.SUFFIXES:
  14.184 +$(srcdir)/Makefile.in:  $(srcdir)/Makefile.am  $(am__configure_deps)
  14.185 +	@for dep in $?; do \
  14.186 +	  case '$(am__configure_deps)' in \
  14.187 +	    *$$dep*) \
  14.188 +	      ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \
  14.189 +	        && { if test -f $@; then exit 0; else break; fi; }; \
  14.190 +	      exit 1;; \
  14.191 +	  esac; \
  14.192 +	done; \
  14.193 +	echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu man/Makefile'; \
  14.194 +	$(am__cd) $(top_srcdir) && \
  14.195 +	  $(AUTOMAKE) --gnu man/Makefile
  14.196 +.PRECIOUS: Makefile
  14.197 +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
  14.198 +	@case '$?' in \
  14.199 +	  *config.status*) \
  14.200 +	    cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \
  14.201 +	  *) \
  14.202 +	    echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \
  14.203 +	    cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \
  14.204 +	esac;
  14.205 +
  14.206 +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
  14.207 +	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
  14.208 +
  14.209 +$(top_srcdir)/configure:  $(am__configure_deps)
  14.210 +	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
  14.211 +$(ACLOCAL_M4):  $(am__aclocal_m4_deps)
  14.212 +	cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
  14.213 +$(am__aclocal_m4_deps):
  14.214 +install-man5: $(man_MANS)
  14.215 +	@$(NORMAL_INSTALL)
  14.216 +	test -z "$(man5dir)" || $(MKDIR_P) "$(DESTDIR)$(man5dir)"
  14.217 +	@list=''; test -n "$(man5dir)" || exit 0; \
  14.218 +	{ for i in $$list; do echo "$$i"; done; \
  14.219 +	l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
  14.220 +	  sed -n '/\.5[a-z]*$$/p'; \
  14.221 +	} | while read p; do \
  14.222 +	  if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
  14.223 +	  echo "$$d$$p"; echo "$$p"; \
  14.224 +	done | \
  14.225 +	sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \
  14.226 +	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \
  14.227 +	sed 'N;N;s,\n, ,g' | { \
  14.228 +	list=; while read file base inst; do \
  14.229 +	  if test "$$base" = "$$inst"; then list="$$list $$file"; else \
  14.230 +	    echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man5dir)/$$inst'"; \
  14.231 +	    $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man5dir)/$$inst" || exit $$?; \
  14.232 +	  fi; \
  14.233 +	done; \
  14.234 +	for i in $$list; do echo "$$i"; done | $(am__base_list) | \
  14.235 +	while read files; do \
  14.236 +	  test -z "$$files" || { \
  14.237 +	    echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man5dir)'"; \
  14.238 +	    $(INSTALL_DATA) $$files "$(DESTDIR)$(man5dir)" || exit $$?; }; \
  14.239 +	done; }
  14.240 +
  14.241 +uninstall-man5:
  14.242 +	@$(NORMAL_UNINSTALL)
  14.243 +	@list=''; test -n "$(man5dir)" || exit 0; \
  14.244 +	files=`{ for i in $$list; do echo "$$i"; done; \
  14.245 +	l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
  14.246 +	  sed -n '/\.5[a-z]*$$/p'; \
  14.247 +	} | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \
  14.248 +	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \
  14.249 +	test -z "$$files" || { \
  14.250 +	  echo " ( cd '$(DESTDIR)$(man5dir)' && rm -f" $$files ")"; \
  14.251 +	  cd "$(DESTDIR)$(man5dir)" && rm -f $$files; }
  14.252 +install-man8: $(man_MANS)
  14.253 +	@$(NORMAL_INSTALL)
  14.254 +	test -z "$(man8dir)" || $(MKDIR_P) "$(DESTDIR)$(man8dir)"
  14.255 +	@list=''; test -n "$(man8dir)" || exit 0; \
  14.256 +	{ for i in $$list; do echo "$$i"; done; \
  14.257 +	l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
  14.258 +	  sed -n '/\.8[a-z]*$$/p'; \
  14.259 +	} | while read p; do \
  14.260 +	  if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
  14.261 +	  echo "$$d$$p"; echo "$$p"; \
  14.262 +	done | \
  14.263 +	sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \
  14.264 +	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \
  14.265 +	sed 'N;N;s,\n, ,g' | { \
  14.266 +	list=; while read file base inst; do \
  14.267 +	  if test "$$base" = "$$inst"; then list="$$list $$file"; else \
  14.268 +	    echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man8dir)/$$inst'"; \
  14.269 +	    $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man8dir)/$$inst" || exit $$?; \
  14.270 +	  fi; \
  14.271 +	done; \
  14.272 +	for i in $$list; do echo "$$i"; done | $(am__base_list) | \
  14.273 +	while read files; do \
  14.274 +	  test -z "$$files" || { \
  14.275 +	    echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man8dir)'"; \
  14.276 +	    $(INSTALL_DATA) $$files "$(DESTDIR)$(man8dir)" || exit $$?; }; \
  14.277 +	done; }
  14.278 +
  14.279 +uninstall-man8:
  14.280 +	@$(NORMAL_UNINSTALL)
  14.281 +	@list=''; test -n "$(man8dir)" || exit 0; \
  14.282 +	files=`{ for i in $$list; do echo "$$i"; done; \
  14.283 +	l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
  14.284 +	  sed -n '/\.8[a-z]*$$/p'; \
  14.285 +	} | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \
  14.286 +	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \
  14.287 +	test -z "$$files" || { \
  14.288 +	  echo " ( cd '$(DESTDIR)$(man8dir)' && rm -f" $$files ")"; \
  14.289 +	  cd "$(DESTDIR)$(man8dir)" && rm -f $$files; }
  14.290 +tags: TAGS
  14.291 +TAGS:
  14.292 +
  14.293 +ctags: CTAGS
  14.294 +CTAGS:
  14.295 +
  14.296 +
  14.297 +distdir: $(DISTFILES)
  14.298 +	@list='$(MANS)'; if test -n "$$list"; then \
  14.299 +	  list=`for p in $$list; do \
  14.300 +	    if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
  14.301 +	    if test -f "$$d$$p"; then echo "$$d$$p"; else :; fi; done`; \
  14.302 +	  if test -n "$$list" && \
  14.303 +	    grep 'ab help2man is required to generate this page' $$list >/dev/null; then \
  14.304 +	    echo "error: found man pages containing the \`missing help2man' replacement text:" >&2; \
  14.305 +	    grep -l 'ab help2man is required to generate this page' $$list | sed 's/^/         /' >&2; \
  14.306 +	    echo "       to fix them, install help2man, remove and regenerate the man pages;" >&2; \
  14.307 +	    echo "       typically \`make maintainer-clean' will remove them" >&2; \
  14.308 +	    exit 1; \
  14.309 +	  else :; fi; \
  14.310 +	else :; fi
  14.311 +	@srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
  14.312 +	topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
  14.313 +	list='$(DISTFILES)'; \
  14.314 +	  dist_files=`for file in $$list; do echo $$file; done | \
  14.315 +	  sed -e "s|^$$srcdirstrip/||;t" \
  14.316 +	      -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \
  14.317 +	case $$dist_files in \
  14.318 +	  */*) $(MKDIR_P) `echo "$$dist_files" | \
  14.319 +			   sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \
  14.320 +			   sort -u` ;; \
  14.321 +	esac; \
  14.322 +	for file in $$dist_files; do \
  14.323 +	  if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
  14.324 +	  if test -d $$d/$$file; then \
  14.325 +	    dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \
  14.326 +	    if test -d "$(distdir)/$$file"; then \
  14.327 +	      find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
  14.328 +	    fi; \
  14.329 +	    if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
  14.330 +	      cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \
  14.331 +	      find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
  14.332 +	    fi; \
  14.333 +	    cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \
  14.334 +	  else \
  14.335 +	    test -f "$(distdir)/$$file" \
  14.336 +	    || cp -p $$d/$$file "$(distdir)/$$file" \
  14.337 +	    || exit 1; \
  14.338 +	  fi; \
  14.339 +	done
  14.340 +check-am: all-am
  14.341 +check: check-am
  14.342 +all-am: Makefile $(MANS)
  14.343 +installdirs:
  14.344 +	for dir in "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(man8dir)"; do \
  14.345 +	  test -z "$$dir" || $(MKDIR_P) "$$dir"; \
  14.346 +	done
  14.347 +install: install-am
  14.348 +install-exec: install-exec-am
  14.349 +install-data: install-data-am
  14.350 +uninstall: uninstall-am
  14.351 +
  14.352 +install-am: all-am
  14.353 +	@$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
  14.354 +
  14.355 +installcheck: installcheck-am
  14.356 +install-strip:
  14.357 +	$(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
  14.358 +	  install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
  14.359 +	  `test -z '$(STRIP)' || \
  14.360 +	    echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
  14.361 +mostlyclean-generic:
  14.362 +
  14.363 +clean-generic:
  14.364 +
  14.365 +distclean-generic:
  14.366 +	-test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES)
  14.367 +	-test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES)
  14.368 +
  14.369 +maintainer-clean-generic:
  14.370 +	@echo "This command is intended for maintainers to use"
  14.371 +	@echo "it deletes files that may require special tools to rebuild."
  14.372 +clean: clean-am
  14.373 +
  14.374 +clean-am: clean-generic mostlyclean-am
  14.375 +
  14.376 +distclean: distclean-am
  14.377 +	-rm -f Makefile
  14.378 +distclean-am: clean-am distclean-generic
  14.379 +
  14.380 +dvi: dvi-am
  14.381 +
  14.382 +dvi-am:
  14.383 +
  14.384 +html: html-am
  14.385 +
  14.386 +html-am:
  14.387 +
  14.388 +info: info-am
  14.389 +
  14.390 +info-am:
  14.391 +
  14.392 +install-data-am: install-man
  14.393 +
  14.394 +install-dvi: install-dvi-am
  14.395 +
  14.396 +install-dvi-am:
  14.397 +
  14.398 +install-exec-am:
  14.399 +
  14.400 +install-html: install-html-am
  14.401 +
  14.402 +install-html-am:
  14.403 +
  14.404 +install-info: install-info-am
  14.405 +
  14.406 +install-info-am:
  14.407 +
  14.408 +install-man: install-man5 install-man8
  14.409 +
  14.410 +install-pdf: install-pdf-am
  14.411 +
  14.412 +install-pdf-am:
  14.413 +
  14.414 +install-ps: install-ps-am
  14.415 +
  14.416 +install-ps-am:
  14.417 +
  14.418 +installcheck-am:
  14.419 +
  14.420 +maintainer-clean: maintainer-clean-am
  14.421 +	-rm -f Makefile
  14.422 +maintainer-clean-am: distclean-am maintainer-clean-generic
  14.423 +
  14.424 +mostlyclean: mostlyclean-am
  14.425 +
  14.426 +mostlyclean-am: mostlyclean-generic
  14.427 +
  14.428 +pdf: pdf-am
  14.429 +
  14.430 +pdf-am:
  14.431 +
  14.432 +ps: ps-am
  14.433 +
  14.434 +ps-am:
  14.435 +
  14.436 +uninstall-am: uninstall-man
  14.437 +
  14.438 +uninstall-man: uninstall-man5 uninstall-man8
  14.439 +
  14.440 +.MAKE: install-am install-strip
  14.441 +
  14.442 +.PHONY: all all-am check check-am clean clean-generic distclean \
  14.443 +	distclean-generic distdir dvi dvi-am html html-am info info-am \
  14.444 +	install install-am install-data install-data-am install-dvi \
  14.445 +	install-dvi-am install-exec install-exec-am install-html \
  14.446 +	install-html-am install-info install-info-am install-man \
  14.447 +	install-man5 install-man8 install-pdf install-pdf-am \
  14.448 +	install-ps install-ps-am install-strip installcheck \
  14.449 +	installcheck-am installdirs maintainer-clean \
  14.450 +	maintainer-clean-generic mostlyclean mostlyclean-generic pdf \
  14.451 +	pdf-am ps ps-am uninstall uninstall-am uninstall-man \
  14.452 +	uninstall-man5 uninstall-man8
  14.453 +
  14.454 +
  14.455 +# Tell versions [3.59,3.63) of GNU make to not export all variables.
  14.456 +# Otherwise a system limit (for SysV at least) may be exceeded.
  14.457 +.NOEXPORT:
    15.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    15.2 +++ b/man/masqmail.8	Sat May 29 22:07:07 2010 +0200
    15.3 @@ -0,0 +1,293 @@
    15.4 +.TH masqmail 8 2010-05-07 masqmail-0.2.22 "Maintenance Commands"
    15.5 +
    15.6 +.SH NAME
    15.7 +masqmail \- An offline Mail Transfer Agent
    15.8 +
    15.9 +.SH SYNOPSIS
   15.10 +\fB/usr/sbin/masqmail \fR[\fB\-C \fIfile\fR] [\fB\-odq\fR] [\fB\-bd\fR] [\fB\-q\fIinterval\fR]
   15.11 +
   15.12 +\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-bs\fR]
   15.13 +
   15.14 +\fB/usr/sbin/masqmail \fR[\fB\-bp\fR]
   15.15 +
   15.16 +\fB/usr/sbin/masqmail \fR[\fB\-q\fR]
   15.17 +
   15.18 +\fB/usr/sbin/masqmail \fR[\fB\-qo \fR[\fIname\fR]]
   15.19 +
   15.20 +\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-g \fR[\fIname\fR]]
   15.21 +
   15.22 +\fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-go \fR[\fIname\fR]]
   15.23 +
   15.24 +\fB/usr/sbin/masqmail \fR[\fB\-t\fR] [\fB\-oi\fR] [\fB\-f \fIaddress\fR] [\fB\-\-\fR] \fIaddress...
   15.25 +
   15.26 +\fB/usr/sbin/mailq\fR
   15.27 +
   15.28 +
   15.29 +.SH DESCRIPTION
   15.30 +
   15.31 +Masqmail is a mail server designed for hosts that do not have a permanent internet connection
   15.32 +e.g. a home network or a single host at home.
   15.33 +It has special support for connections to different ISPs.
   15.34 +It replaces sendmail or other MTAs such as qmail or exim.
   15.35 +It can also act as a pop3 client.
   15.36 +
   15.37 +
   15.38 +.SH OPTIONS
   15.39 +
   15.40 +Since masqmail is intended to replace sendmail, it uses the same command line options,
   15.41 +but not all are implemented.
   15.42 +There are also two additional options, which are unique to masqmail
   15.43 +(\fB\-qo \fIconnection\fR and \fB\-g\fR)
   15.44 +
   15.45 +.TP
   15.46 +\fB\-\-\fR
   15.47 +
   15.48 +Not a `real' option, it means that all following arguments are to be understood
   15.49 +as arguments and not as options even if they begin with a leading dash `\-'.
   15.50 +Mutt is known to call sendmail with this option.
   15.51 +
   15.52 +.TP
   15.53 +\fB\-bd\fR
   15.54 +
   15.55 +Run as daemon, accepting connections, usually on port 25 if not configured differently.
   15.56 +This is usually used in the startup script at system boot and together with
   15.57 +the \fB\-q\fR option (see below).
   15.58 +
   15.59 +.TP
   15.60 +\fB\-bi\fR
   15.61 +
   15.62 +Old sendmail rebuilds its alias database when invoked with this option.
   15.63 +Masqmail ignores it.
   15.64 +Masqmail reads directly from the file given with `alias_file' in the config file.
   15.65 +
   15.66 +.TP
   15.67 +\fB\-bp\fR
   15.68 +
   15.69 +Show the messages in the queue. Same as calling masqmail as `mailq'.
   15.70 +
   15.71 +.TP
   15.72 +\fB\-bs\fR
   15.73 +
   15.74 +Accept SMTP commands from stdin.
   15.75 +Some mailers (e.g. pine) use this option as an interface.
   15.76 +It can also be used to call masqmail from inetd.
   15.77 +
   15.78 +.TP
   15.79 +\fB\-B \fIarg\fR
   15.80 +
   15.81 +\fIarg\fR is usually 8BITMIME.
   15.82 +Some mailers use this to indicate that the message contains characters > 127.
   15.83 +Masqmail is 8-bit clean and ignores this, so you do not have to recompile elm,
   15.84 +which is very painful ;-).
   15.85 +Note though that this violates some conventions:
   15.86 +masqmail does not convert 8 bit messages to any MIME format if it encounters
   15.87 +a mail server which does not advertise its 8BITMIME capability,
   15.88 +masqmail does not advertise this itself.
   15.89 +This is the same practice as that of exim (but different to sendmail).
   15.90 +
   15.91 +.TP
   15.92 +\fB\-bV \fR
   15.93 +
   15.94 +Show version information.
   15.95 +
   15.96 +.TP
   15.97 +\fB\-C \fIfilename\fR
   15.98 +
   15.99 +Use another configuration than \fI/etc/masqmail/masqmail.conf\fR.
  15.100 +Useful for debugging purposes.
  15.101 +If not invoked by a privileged user, masqmail will drop all privileges.
  15.102 +
  15.103 +.TP
  15.104 +\fB\-d \fInumber\fR
  15.105 +
  15.106 +Set the debug level.
  15.107 +This takes precedence before the value of `debug_level' in the configuration file.
  15.108 +Read the warning in the description of the latter.
  15.109 +
  15.110 +.TP
  15.111 +\fB\-f [\fIaddress\fB]\fR
  15.112 +
  15.113 +Set the return path address to \fIaddress\fR.
  15.114 +Only root, the user mail and anyone in group mail is allowed to do that.
  15.115 +
  15.116 +.TP
  15.117 +\fB\-F [\fIstring\fB]\fR
  15.118 +
  15.119 +Set the full sender name (in the From: header) to \fIstring\fR.
  15.120 +
  15.121 +.TP
  15.122 +\fB\-g [\fIname\fB]\fR
  15.123 +
  15.124 +Get mail (using pop3 or apop),
  15.125 +using the configurations given with get.\fIname\fR in the main configuration.
  15.126 +Without \fIname\fR, all get configurations will be used.
  15.127 +See also \fBmasqmail.get(5)\fR
  15.128 +
  15.129 +.TP
  15.130 +\fB\-go [\fIinterval\fB] [\fIname\fB]\fR
  15.131 +
  15.132 +Can be followed by a connection name.
  15.133 +Use this option in your script which starts as soon as a link to the internet
  15.134 +has been set up (usually ip-up).
  15.135 +When masqmail is called with this option, the specified get configuration(s)
  15.136 +is(are) read and mail will be retrieved from servers on the internet.
  15.137 +The \fIname\fR is defined in the configuration (see \fBonline_gets.\fIname\fR).
  15.138 +
  15.139 +If called with an interval option (recognized by a digit as the first characater),
  15.140 +masqmail starts as a daemon and tries to get mail in these intervals.
  15.141 +It checks for the online status first.
  15.142 +Example: `masqmail \-go 5m' will retrieve mail every five minutes.
  15.143 +
  15.144 +If called without \fIname\fR the online status is determined with the configured method
  15.145 +(see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR).
  15.146 +
  15.147 +.TP
  15.148 +\fB\-i\fR
  15.149 +
  15.150 +Same as \fB\-oi\fR, see below.
  15.151 +
  15.152 +.TP
  15.153 +\fB\-Mrm \fIlist\fR
  15.154 +
  15.155 +Remove given messages from the queue.
  15.156 +Only allowed for privileged users.
  15.157 +The identifiers of messages are listed in the output of
  15.158 +\fImasqmail -bp\fP (\fImailq\fR).
  15.159 +
  15.160 +.TP
  15.161 +\fB\-oem\fR
  15.162 +
  15.163 +If the \fB\-oi\fR ist not also given, always return with a non zero return code.
  15.164 +Maybe someone tells me what this is good for...
  15.165 +
  15.166 +.TP
  15.167 +\fB\-odb\fR
  15.168 +
  15.169 +Deliver in background.
  15.170 +Masqmail always does this, which makes this option pretty much useless.
  15.171 +
  15.172 +.TP
  15.173 +\fB\-odq\fR
  15.174 +
  15.175 +Do not attempt to deliver immediately.
  15.176 +Any messages will be queued until the next queue running process picks them up and delivers them.
  15.177 +You get the same effect by setting the do_queue option in /etc/masqmail/masqmail.conf.
  15.178 +
  15.179 +.TP
  15.180 +\fB\-oi\fR
  15.181 +
  15.182 +A dot as a single character in a line does not terminate the message.
  15.183 +
  15.184 +.TP
  15.185 +\fB\-q [\fIinterval\fB]\fR
  15.186 +
  15.187 +If not given with an argument, run a queue process, i.e. try to deliver all messages in the queue.
  15.188 +Masqmail sends only to those addresses that are on the local net, not to those that are outside.
  15.189 +Use \fB\-qo\fR for those.
  15.190 +
  15.191 +If you have configured inetd to start masqmail,
  15.192 +you can use this option in a cron job which starts in regular time intervals,
  15.193 +to mimic the same effect as starting masqmail with \fB\-bd \-q30m\fR.
  15.194 +
  15.195 +An argument may be a time interval i.e. a numerical value followed by one of the letters.
  15.196 +s,m,h,d,w which are interpreted as seconds, minutes, hours, days or weeks respectively.
  15.197 +Example: \fB\-q30m\fR.
  15.198 +Masqmail starts as a daemon and a queue runner process will be started automatically
  15.199 +once in this time interval.
  15.200 +This is usually used together with \fB\-bd\fR (see above).
  15.201 +
  15.202 +.TP
  15.203 +\fB\-qo [\fIname\fB]\fR
  15.204 +
  15.205 +Can be followed by a connection name.
  15.206 +Use this option in your script which starts as soon as a link to the internet
  15.207 +has been set up (usually ip-up).
  15.208 +When masqmail is called with this option, the specified route configuration
  15.209 +is read and the queued mail with destinations on the internet will be sent.
  15.210 +The \fIname\fR is defined in the configuration (see \fBonline_routes.\fIname\fR).
  15.211 +
  15.212 +If called without \fIname\fR the online status is determined with the configured
  15.213 +method (see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR)
  15.214 +
  15.215 +.TP
  15.216 +\fB\-t\fR
  15.217 +
  15.218 +Read recipients from headers.
  15.219 +Delete `Bcc:' headers.
  15.220 +If any arguments are given, these are interpreted as recipient addresses
  15.221 +and the message will not be sent to these.
  15.222 +
  15.223 +.TP
  15.224 +\fB\-v\fR
  15.225 +
  15.226 +Log also to stdout.
  15.227 +Currently, some log messages are marked as `write to stdout' and additionally,
  15.228 +all messages with priority `LOG_ALERT' and `LOG_WARNING' will be written to stdout
  15.229 +if this option is given. It is disabled in daemon mode.
  15.230 +
  15.231 +
  15.232 +.SH ENVIRONMENT FOR PIPES AND MDAS
  15.233 +
  15.234 +For security reasons, before any pipe command from an alias expansion or an mda is called,
  15.235 +the environment variables will be completely discarded and newly set up. These are:
  15.236 +
  15.237 +SENDER, RETURN_PATH \(en the return path.
  15.238 +
  15.239 +SENDER_DOMAIN \(en the domain part of the return path.
  15.240 +
  15.241 +SENDER_LOCAL \(en the local part of the return path.
  15.242 +
  15.243 +RECEIVED_HOST \(en the host the message was received from (unless local).
  15.244 +
  15.245 +LOCAL_PART, USER, LOGNAME \(en the local part of the (original) recipient.
  15.246 +
  15.247 +MESSAGE_ID \(en the unique message id.
  15.248 +This is not necessarily identical with the Message ID as given in the Message ID: header.
  15.249 +
  15.250 +QUALIFY_DOMAIN \(en the domain which will be appended to unqualified addresses.
  15.251 +
  15.252 +
  15.253 +.SH FILES
  15.254 +
  15.255 +\fI/etc/masqmail/masqmail.conf\fR is the main configuration for masqmail.
  15.256 +Depending on the settings in this file, you will also have other configuration
  15.257 +files in \fI/etc/masqmail/\fR.
  15.258 +
  15.259 +\fI/var/spool/masqmail/\fR is the spool directory where masqmail stores
  15.260 +its spooled messages and the uniq pop ids.
  15.261 +
  15.262 +\fI/var/spool/mail/\fR is the directory where locally delivered mail will be put,
  15.263 +if not configured differently in \fImasqmail.conf\fR.
  15.264 +
  15.265 +\fI/var/log/masqmail/\fR is the directory where masqmail stores its log mesages.
  15.266 +This can also be somewhere else if configured differently by your sysadmin or the package mantainer.
  15.267 +
  15.268 +
  15.269 +.SH CONFORMING TO
  15.270 +
  15.271 +RFC 821, 822, 1869, 1870, 2197, 2554 (SMTP)
  15.272 +
  15.273 +RFC 1725, 1939 (POP3)
  15.274 +
  15.275 +RFC 1321 (MD5)
  15.276 +
  15.277 +RFC 2195 (CRAM-MD5)
  15.278 +
  15.279 +
  15.280 +.SH AUTHOR
  15.281 +
  15.282 +Masqmail was written by Oliver Kurth.
  15.283 +It is now maintained by Markus Schnalke <meillo@marmaro.de>.
  15.284 +
  15.285 +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR.
  15.286 +There is also a mailing list, you will find information about it at masqmail's main site.
  15.287 +
  15.288 +
  15.289 +.SH BUGS
  15.290 +
  15.291 +Please report them to the mailing list.
  15.292 +
  15.293 +
  15.294 +.SH SEE ALSO
  15.295 +
  15.296 +\fBmasqmail.conf(5)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.get(5)\fR, \fBmasqmail.aliases(5)\fR
    16.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    16.2 +++ b/man/masqmail.aliases.5	Sat May 29 22:07:07 2010 +0200
    16.3 @@ -0,0 +1,54 @@
    16.4 +.TH masqmail.aliases 5 2010-05-07 masqmail-0.2.22 "File Formats"
    16.5 +
    16.6 +.SH NAME
    16.7 +masqmail.aliases \- masqmail alias file format
    16.8 +
    16.9 +
   16.10 +.SH DESCRIPTION
   16.11 +
   16.12 +This man page describes the format of the masqmail alias file.
   16.13 +Its usual location is \fI/etc/aliases\fR.
   16.14 +
   16.15 +
   16.16 +.SH FILE FORMAT
   16.17 +
   16.18 +The alias file consists of lines of the form:
   16.19 +local_part: item1, item2, ...
   16.20 +Items can be surrounded by double quotes `"'.
   16.21 +If within the quotes other quotes are needed for an address they can be
   16.22 +escaped with a leading backslash `\\'.
   16.23 +
   16.24 +A leading backslash `\\' indicates that this address shall not be further expanded.
   16.25 +
   16.26 +A leading pipe symbol `|' indicates that the item shall be treated as a pipe command.
   16.27 +The content of the message will then be sent to the standard input of a command.
   16.28 +The command will run under the user id and group id masqmail is running as.
   16.29 +If quotes are needed, the pipe symbol must appear within the quotes.
   16.30 +
   16.31 +Loops will be detected, the offending address will be ignored.
   16.32 +
   16.33 +Aliases will be expanded at delivery time.
   16.34 +This means that if there is a message still in the queue and you change
   16.35 +any alias which matches one of the recipient addresses,
   16.36 +the change will have effect next time a delivery is attemped.
   16.37 +
   16.38 +There is no need to restart masqmail or run any command when the alias file has been changed.
   16.39 +
   16.40 +
   16.41 +.SH AUTHOR
   16.42 +
   16.43 +Masqmail was written by Oliver Kurth.
   16.44 +It is now maintained by Markus Schnalke <meillo@marmaro.de>.
   16.45 +
   16.46 +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR.
   16.47 +There is also a mailing list, you will find information about it at masqmail's main site.
   16.48 +
   16.49 +
   16.50 +.SH BUGS
   16.51 +
   16.52 +Please report bugs to the mailing list.
   16.53 +
   16.54 +
   16.55 +.SH SEE ALSO
   16.56 +
   16.57 +\fBmasqmail.conf(5)\fR, \fBmasqmail(8)\fR, 
    17.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    17.2 +++ b/man/masqmail.conf.5	Sat May 29 22:07:07 2010 +0200
    17.3 @@ -0,0 +1,492 @@
    17.4 +.TH masqmail.conf 5 2010-05-07 masqmail-0.2.22 "File Formats"
    17.5 +
    17.6 +.SH NAME
    17.7 +masqmail.conf \- masqmail configuration file
    17.8 +
    17.9 +
   17.10 +.SH DESCRIPTION
   17.11 +
   17.12 +This man page describes the syntax of the main configuration file of masqmail.
   17.13 +Its usual location is \fI/etc/masqmail/masqmail.conf\fR
   17.14 +
   17.15 +The configuration consists of lines of the form
   17.16 +
   17.17 +\fBval\fR = \fIexpression\fR
   17.18 +
   17.19 +Where \fBval\fR is a variable name and \fIexpression\fR a string,
   17.20 +which can be quoted with double quotes `"'.
   17.21 +If the expression is on multiple lines or contains characters other than letters,
   17.22 +digits or the characters `.', `-', `_', `/', it must be quoted.
   17.23 +You can use quotes inside quotes by escaping them with a backslash.
   17.24 +
   17.25 +Each val has a type, which can be boolean, numeric, string or list.
   17.26 +A boolean variable can be set with one of the values `on', `yes', and `true' or `off', `no' and `false'.
   17.27 +List items are separated with semicolons `;'.
   17.28 +For some values patterns (like `*',`?') can be used.
   17.29 +The spaces before and after the equal sign `=' are optional.
   17.30 +
   17.31 +Most lists (exceptions: \fBlocal_hosts\fR, \fBlocal_nets\fR, \fBlisten_addresses\fR,
   17.32 +\fBonline_routes\fR, and \fBonline_gets\fR) accept files.
   17.33 +These will be recognized by a leading slash `/'.
   17.34 +The contents of these files will be included at the position of the file name,
   17.35 +there can be items or other files before and after the file entry.
   17.36 +The format of the files is different though, within these files each entry is on another line.
   17.37 +(And not separated by semicolons).
   17.38 +This makes it easy to include large lists which are common in different configuration files,
   17.39 +so they do not have to appear in every configuration file.
   17.40 +
   17.41 +Blank lines and lines starting with a hash `#' are ignored.
   17.42 +
   17.43 +
   17.44 +.SH OPTIONS
   17.45 +
   17.46 +.TP
   17.47 +\fBrun_as_user = \fIboolean\fR
   17.48 +
   17.49 +If this is set, masqmail runs with the user id of the user who invoked it and never changes it.
   17.50 +This is for debugging purposes only.
   17.51 +If the user is not root, masqmail will not be able to listen on a port < 1024
   17.52 +and will not be able to deliver local mail to others than the user.
   17.53 +
   17.54 +.TP
   17.55 +\fBuse_syslog = \fIboolean\fR
   17.56 +
   17.57 +If this is set, masqmail uses syslogd for logging.
   17.58 +It uses facility MAIL.
   17.59 +You still have to set \fBlog_dir\fR for debug files.
   17.60 +
   17.61 +.TP
   17.62 +\fBdebug_level = \fIn\fR
   17.63 +
   17.64 +Set the debug level.
   17.65 +Valid values are 0 to 6, increasing it further makes no difference.
   17.66 +Be careful if you set this as high as 5 or higher, the logs may very soon fill your hard drive.
   17.67 +
   17.68 +.TP
   17.69 +\fBlog_dir = \fIfile\fR
   17.70 +
   17.71 +The directory where log are stored, if syslog is not used.
   17.72 +Debug files are stored in this directory anyways.
   17.73 +\fI/var/log/masqmail\fR is a common value.
   17.74 +\fIfile\fR must be an absolute path.
   17.75 +
   17.76 +.TP
   17.77 +\fBmail_dir = \fIfile\fR
   17.78 +
   17.79 +The directory where local mail is stored, usually \fI/var/spool/mail\fR or \fI/var/mail\fR.
   17.80 +\fIfile\fR must be an absolute path.
   17.81 +
   17.82 +.TP
   17.83 +\fBspool_dir = \fIfile\fR
   17.84 +
   17.85 +The directory where masqmail stores its spool files (and later also other stuff).
   17.86 +It must have a subdirectory \fIinput\fR.
   17.87 +Masqmail needs read and write permissions for this directory.
   17.88 +I suggest to use \fI/var/spool/masqmail\fR.
   17.89 +\fIfile\fR must be an absolute path.
   17.90 +
   17.91 +.TP
   17.92 +\fBhost_name = \fIstring\fR
   17.93 +
   17.94 +This is used in different places: Masqmail identifies itself in the greeting banner
   17.95 +on incoming connections and in the HELO/EHLO command for outgoing connections with this name,
   17.96 +it is used in the Received: header and to qualify the sender of a locally originating message.
   17.97 +
   17.98 +If the string begins with a slash `/', it it assumed that it is a filename,
   17.99 +and the first line of this file will be used.
  17.100 +Usually this will be `/etc/mailname' to make masqmail conform to Debian policies.
  17.101 +
  17.102 +It is not used to find whether an address is local. Use \fBlocal_hosts\fR for that.
  17.103 +
  17.104 +.TP
  17.105 +\fBremote_port = \fIn\fR
  17.106 +
  17.107 +The remote port number to be used. This defaults to port 25.
  17.108 +
  17.109 +This option is deprecated.
  17.110 +Use \fBhost_name\fR in the route configuration instead.
  17.111 +See \fBmasqmail.route(5)\fR.
  17.112 +
  17.113 +.TP
  17.114 +\fBlocal_hosts = \fIlist\fR
  17.115 +
  17.116 +A semicolon `;' separated list of hostnames which are considered local.
  17.117 +Normally you set it to "localhost;foo;foo.bar.com" if your host has the
  17.118 +fully qualified domain name `foo.bar.com'.
  17.119 +
  17.120 +.TP
  17.121 +\fBlocal_nets = \fIlist\fR
  17.122 +
  17.123 +A semicolon `;' separated list of hostnames which are on the `local' net.
  17.124 +Delivery to these hosts is attempted immediately.
  17.125 +You can use patterns with `*', e.g. "*.bar.com".
  17.126 +
  17.127 +.TP
  17.128 +\fBlocal_addresses = \fIlist\fR
  17.129 +
  17.130 +A semicolon `;' separated list of fully qualified email-addresses which are
  17.131 +considered local although their domain name part is not in the list of \fBlocal_hosts\fR. 
  17.132 +
  17.133 +For example: There are two people working at your LAN: person1@yourdomain and person2@yourdomain.
  17.134 +But there are other persons @yourdomain which are NOT local.
  17.135 +So you can not put yourdomain to the list of local_hosts.
  17.136 +If person1 now wants to write to person2@yourdomain and this mail should not leave the LAN then you can put
  17.137 +
  17.138 +local_addresses = "person1@yourdomain;person2@yourdomain"
  17.139 +
  17.140 +to your masqmail.conf.
  17.141 +
  17.142 +.TP
  17.143 +\fBnot_local_addresses = \fIlist\fR
  17.144 +
  17.145 +A semicolon `;' separated list of fully qualified email-addresses which are
  17.146 +considered not local although their domain name part is in the list of \fBlocal_hosts\fR. 
  17.147 +
  17.148 +This is the opposite of the previous case.
  17.149 +The majority of addresses of a specific domain are local.
  17.150 +But some users are not.
  17.151 +With this option you can easily exclude these users.
  17.152 +
  17.153 +Example:
  17.154 +
  17.155 +local_hosts = "localhost;myhost;mydomain.net"
  17.156 +
  17.157 +not_local_addresses = "eric@mydomain.net"
  17.158 +
  17.159 +.TP
  17.160 +\fBlisten_addresses = \fIlist\fR
  17.161 +
  17.162 +A semicolon `;' separated list of interfaces on which connections will be accepted.
  17.163 +An interface ist defined by a hostname, optionally followed by a colon `:' and a number for the port.
  17.164 +If this is left out, port 25 will be used.
  17.165 +
  17.166 +You can set this to "localhost:25;foo:25" if your hostname is `foo'.
  17.167 +
  17.168 +Note that the names are resolved to IP addreses.
  17.169 +If your host has different names which resolve to the same IP,
  17.170 +use only one of them, otherwise you will get an error message.
  17.171 +
  17.172 +.TP
  17.173 +\fBdo_save_envelope_to = \fIboolean\fR
  17.174 +
  17.175 +If this is set to true, a possibly existing Envelope-to: header in an incoming mail
  17.176 +which is received via either pop3 or smtp will be saved as an X-Orig-Envelope-to: header.
  17.177 +
  17.178 +This is useful if you retrieve mail from a pop3 server with either masqmail or fetchmail,
  17.179 +and the server supports Envelope-to: headers,
  17.180 +and you want to make use of those with a mail filtering tool, e.g. procmail.
  17.181 +It cannot be preserved because masqmail sets such a header by itself.
  17.182 +
  17.183 +Default is false.
  17.184 +
  17.185 +.TP
  17.186 +\fBdo_relay = \fIboolean\fR
  17.187 +
  17.188 +If this is set to false, mail with a return path that is not local and a destination
  17.189 +that is also not local will not be accepted via smtp and a 550 reply will be given.
  17.190 +Default is true.
  17.191 +
  17.192 +Note that this will not protect you from spammers using open relays,
  17.193 +but from users unable to set their address in their mail clients.
  17.194 +
  17.195 +.TP
  17.196 +\fBdo_queue = \fIboolean\fR
  17.197 +
  17.198 +If this is set, mail will not be delivered immediately when accepted.
  17.199 +Same as calling masqmail with the \fB\-odq\fR option.
  17.200 +
  17.201 +.TP
  17.202 +\fBonline_routes.\fIname\fR = \fIlist\fR
  17.203 +
  17.204 +Replace \fIname\fR with a name to identify a connection.
  17.205 +Set this to a filename (or a list of filenames) for the special route configuration for that connection.
  17.206 +You will use that name to call masqmail with the \fB\-qo\fR option every time a
  17.207 +connection to your ISP is set up.
  17.208 +
  17.209 +Example: Your ISP has the name FastNet.
  17.210 +Then you write the following line in the main configuration:
  17.211 +
  17.212 +\fBonline_routes.FastNet\fR = \fI"/etc/masqmail/fastnet.route"\fR
  17.213 +
  17.214 +\fI/etc/masqmail/fastnet.route\fR is the route configuration file, see \fBmasqmail.route(5)\fR.
  17.215 +As soon as a link to FastNet has been set up, you call masqmail \fB\-qo \fIFastNet\fR.
  17.216 +Masqmail will then read the specified file and send the mails.
  17.217 +
  17.218 +.TP
  17.219 +\fBconnect_route.\fIname\fR = \fIlist\fR
  17.220 +
  17.221 +Old name for \fBonline_routes\fR.
  17.222 +
  17.223 +.TP
  17.224 +\fBlocal_net_route = \fIfile\fR
  17.225 +
  17.226 +This is similar to \fBonline_routes.\fIname\fR but for the local net.
  17.227 +Recipient addresses that are in local_nets will be routed using this route configuration.
  17.228 +Main purpose is to define a mail server with mail_host in your local network.
  17.229 +In simple environments this can be left unset.
  17.230 +If unset, a default route configuration will be used.
  17.231 +
  17.232 +.TP
  17.233 +\fBalias_file = \fIfile\fR
  17.234 +
  17.235 +Set this to the location of your alias file.
  17.236 +If unset, no aliasing will be done.
  17.237 +
  17.238 +.TP
  17.239 +\fBalias_local_caseless = \fIboolean\fR
  17.240 +
  17.241 +If this is set, local parts in the alias file will be matched disregarding upper/lower case.
  17.242 +
  17.243 +.TP
  17.244 +\fBpipe_fromline = \fIboolean\fR
  17.245 +
  17.246 +If this is set, a from line will be prepended to the output stream whenever
  17.247 +a pipe command is called after an alias expansion.
  17.248 +Default is false.
  17.249 +
  17.250 +.TP
  17.251 +\fBpipe_fromhack = \fIboolean\fR
  17.252 +
  17.253 +If this is set, each line beginning with `From ' is replaced with `>From '
  17.254 +whenever a pipe command is called after an alias expansion.
  17.255 +You probably want this if you have set \fBpipe_fromline\fR above.
  17.256 +Default is false.
  17.257 +
  17.258 +.TP
  17.259 +\fBmbox_default = \fIstring\fR
  17.260 +
  17.261 +The default local delivery method.
  17.262 +Can be one of mbox, mda or maildir (the latter only if maildir support is enabled at compile time).
  17.263 +Default is mbox.
  17.264 +You can override this for each user by using the \fBmbox_users\fR, \fBmda_users\fR,
  17.265 +or \fBmaildir_users\fR options (see below).
  17.266 +
  17.267 +.TP
  17.268 +\fBmbox_users = \fIlist\fR
  17.269 +
  17.270 +A list of users which wish delivery to an mbox style mail folder.
  17.271 +
  17.272 +.TP
  17.273 +\fBmda_users = \fIlist\fR
  17.274 +
  17.275 +A list of users which wish local delivery to an mda.
  17.276 +You have to set \fBmda\fR (see below) as well.
  17.277 +
  17.278 +.TP
  17.279 +\fBmaildir_users = \fIlist\fR
  17.280 +
  17.281 +A list of users which wish delivery to a qmail style maildir.
  17.282 +The path to maildir is ~/Maildir/.
  17.283 +The maildir will be created if it does not exist.
  17.284 +
  17.285 +.TP
  17.286 +\fBmda = \fIexpand string\fR
  17.287 +
  17.288 +If you want local delivery to be transferred to an mda (Mail Delivery Agent),
  17.289 +set this to a command.
  17.290 +The argument will be expanded on delivery time,
  17.291 +you can use variables beginning with a dolloar sign `$', optionally enclosed in curly braces.
  17.292 +Variables you can use are:
  17.293 +
  17.294 +uid - the unique message id.
  17.295 +This is not necessarily identical with the Message ID as given in the Message ID: header.
  17.296 +
  17.297 +received_host - the host the mail was received from
  17.298 +
  17.299 +ident - the ident, this is either the ident delivered by the ident protocol
  17.300 +or the user id of the sender if the message was received locally.
  17.301 +
  17.302 +return_path_local - the local part of the return path (sender).
  17.303 +
  17.304 +return_path_domain - the domain part of the return path (sender).
  17.305 +
  17.306 +return_path - the complete return path (sender).
  17.307 +
  17.308 +rcpt_local - the local part of the recipient.
  17.309 +
  17.310 +rcpt_domain - the domain part of the recipient.
  17.311 +
  17.312 +rcpt - the complete recipient address.
  17.313 +
  17.314 +Example:
  17.315 +
  17.316 +mda="/usr/bin/procmail \-Y \-d ${rcpt_local}"
  17.317 +
  17.318 +For the mda, as for pipe commands, a few environment variables will be set as well.
  17.319 +See \fBmasqmail(8)\fR.
  17.320 +To use environment variables for the mda, the dollar sign `$' has to be escaped with a backslash,
  17.321 +otherwise they will be tried to be expanded with the internal variables.
  17.322 +
  17.323 +.TP
  17.324 +\fBmda_fromline = \fIboolean\fR
  17.325 +
  17.326 +If this is set, a from line will be prepended to the output stream whenever
  17.327 +a message is delivered to an mda.
  17.328 +Default is false.
  17.329 +
  17.330 +.TP
  17.331 +\fBmda_fromhack = \fIboolean\fR
  17.332 +
  17.333 +If this is set, each line beginning with `From ' is replaced with `>From '
  17.334 +whenever a message is delivered to an mda.
  17.335 +You probably want this if you have set \fBmda_fromline\fR above.
  17.336 +Default is false.
  17.337 +
  17.338 +.TP
  17.339 +\fBonline_detect = \fIstring\fR
  17.340 +
  17.341 +Defines the method masqmail uses to detect whether there is currently an online connection.
  17.342 +It can have the values \fBfile\fR, \fBpipe\fR, or \fBmserver\fR.
  17.343 +
  17.344 +When it is set to \fBfile\fR, masqmail first checks for the existence of \fBonline_file\fR
  17.345 +(see below) and if it exists, it reads it.
  17.346 +The content of the file should be the name of the current connection as defined
  17.347 +with \fBconnect_route.\fIname\fR (trailing whitespace is removed).
  17.348 +
  17.349 +When it is set to \fBpipe\fR, masqmail calls the executable given by the
  17.350 +\fBonline_pipe\fR option (see below) and reads the current online status from its standard output.
  17.351 +
  17.352 +When it is set to \fBmserver\fR, masqmail connects to the masqdialer server
  17.353 +using the value of \fBmserver_iface\fR and asks it whether a connection exists and for the name,
  17.354 +which should be the name of the current connection as defined with \fBconnect_route.\fIname\fR.
  17.355 +
  17.356 +No matter how masqmail detects the online status,
  17.357 +only messages that are accepted at online time will be delivered using the connection.
  17.358 +The spool still has to be emptied with masqmail \fB\-qo\fIconnection\fR.
  17.359 +
  17.360 +.TP
  17.361 +\fBonline_file = \fIfile\fR
  17.362 +
  17.363 +This is the name of the file checked for when masqmail determines whether it is online.
  17.364 +The file should only exist when there is currently a connection.
  17.365 +Create it in your ip-up script with e.g.
  17.366 +
  17.367 +echo \-n <name> > /var/run/masqmail/masqmail-route
  17.368 +
  17.369 +chmod 0644 /var/run/masqmail/masqmail-route
  17.370 +
  17.371 +Do not forget to delete it in your ip-down script.
  17.372 +
  17.373 +.TP
  17.374 +\fBonline_pipe = \fIfile\fR
  17.375 +
  17.376 +This is the name of the executable which will be called to determine the online status.
  17.377 +This executable should just print the name of the current connection to
  17.378 +the standard output and return a zero status code.
  17.379 +masqmail assumes it is offline if the script returns with a non zero status.
  17.380 +Simple example:
  17.381 +
  17.382 +#!/bin/sh
  17.383 +
  17.384 +[ \-e /var/run/masqmail/masqmail-route ] || exit 1
  17.385 +
  17.386 +cat /var/run/masqmail/masqmail-route
  17.387 +
  17.388 +exit 0
  17.389 +
  17.390 +Of course, instead of the example above you could as well use \fBfile\fR as
  17.391 +the online detection method, but you can do something more sophisticated.
  17.392 +
  17.393 +.TP
  17.394 +\fBmserver_iface = \fIinterface\fR
  17.395 +
  17.396 +The interface the masqdialer server is listening to.
  17.397 +Usually this will be "localhost:224" if mserver is running on the same host as masqmail.
  17.398 +But using this option, you can also let masqmail run on another host by setting
  17.399 +\fBmserver_iface\fR to another hostname, e.g. "foo:224".
  17.400 +
  17.401 +.TP
  17.402 +\fBget.\fIname\fR = \fIfile\fR
  17.403 +
  17.404 +Replace \fIname\fR with a name to identify a get configuration.
  17.405 +Set this to a filename for the get configuration.
  17.406 +These files will be used to retrieve mail when called with the \-g option.
  17.407 +
  17.408 +.TP
  17.409 +\fBonline_gets.\fIname\fR = \fIlist\fR
  17.410 +
  17.411 +Replace \fIname\fR with a name to identify an online configuration.
  17.412 +Set this to a filename (or a list of filenames) for the get configuration.
  17.413 +These files will be used to retrieve mail when called with the \-go option.
  17.414 +
  17.415 +.TP
  17.416 +\fBident_trusted_nets = \fIlist\fR
  17.417 +
  17.418 +\fIlist\fR is a list of networks of the form a.b.c.d/e (e.g. 192.168.1.0/24),
  17.419 +from which the ident given by the ident protocol will be trusted,
  17.420 +so a user can delete his mail from the queue if the ident is identical to his login name.
  17.421 +
  17.422 +.TP
  17.423 +\fBerrmsg_file = \fIfile\fR
  17.424 +
  17.425 +Set this to a template which will be used to generate delivery failure reports.
  17.426 +Variable parts within the template begin with a dollar sign and are identical
  17.427 +to those which can be used as arguments for the mda command, see \fBmda\fR above.
  17.428 +Additional information can be included with @failed_rcpts, @msg_headers and @msg_body,
  17.429 +these must be at the beginning of a line and will be replaced with the list of the failed recipients,
  17.430 +the message headers and the message body of the failed message.
  17.431 +
  17.432 +Default is /usr/share/masqmail/tpl/failmsg.tpl.
  17.433 +
  17.434 +.TP
  17.435 +\fBwarnmsg_file = \fIfile\fR
  17.436 +
  17.437 +Set this to a template which will be used to generate delivery warning reports.
  17.438 +It uses the same mechanisms for variables as \fBerrmsg_file\fR, see above.
  17.439 +
  17.440 +Default is /usr/share/masqmail/tpl/warnmsg.tpl.
  17.441 +
  17.442 +.TP
  17.443 +\fBwarn_intervals\fR = \fIlist\fR
  17.444 +
  17.445 +Set this to a list of time intervals, at which delivery warnings
  17.446 +(starting with the receiving time of the message) shall be generated.
  17.447 +
  17.448 +A warning will only be generated just after an attempt to deliver the mail
  17.449 +and if that attempt failed temporarily.
  17.450 +So a warning may be generated after a longer time, if there was no attempt before.
  17.451 +
  17.452 +Default is "1h;4h;8h;1d;2d;3d"
  17.453 +
  17.454 +.TP
  17.455 +\fBmax_defer_time\fR = \fItime\fR
  17.456 +
  17.457 +This is the maximum time, in which a temporarily failed mail will be kept in the spool.
  17.458 +When this time is exceeded, it will be handled as a delivery failure,
  17.459 +and the message will be bounced.
  17.460 +
  17.461 +The excedence of this time will only be noticed if the message was actually tried to be delivered.
  17.462 +If, for example, the message can only be delivered when online,
  17.463 +but you have not been online for that time, no bounce will be generated.
  17.464 +
  17.465 +Default is 4d (4 days)
  17.466 +
  17.467 +.TP
  17.468 +\fBlog_user = \fIname\fR
  17.469 +
  17.470 +Replace \fIname\fR with a valid local or remote mail address.
  17.471 +
  17.472 +If this option is set, then a copy of every mail,
  17.473 +that passes through the masqmail system will also be sent to the given mail address.
  17.474 +
  17.475 +For example you can feed your mails into a program like hypermail
  17.476 +for archiving purpose by placing an appropriate pipe command in masqmail.alias
  17.477 +
  17.478 +
  17.479 +.SH AUTHOR
  17.480 +
  17.481 +Masqmail was written by Oliver Kurth.
  17.482 +It is now maintained by Markus Schnalke <meillo@marmaro.de>.
  17.483 +
  17.484 +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR.
  17.485 +There is also a mailing list, you will find information about it at masqmail's main site.
  17.486 +
  17.487 +
  17.488 +.SH BUGS
  17.489 +
  17.490 +Please report bugs to the mailing list.
  17.491 +
  17.492 +
  17.493 +.SH SEE ALSO
  17.494 +
  17.495 +\fBmasqmail(8)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.get(5)\fR
    18.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    18.2 +++ b/man/masqmail.get.5	Sat May 29 22:07:07 2010 +0200
    18.3 @@ -0,0 +1,134 @@
    18.4 +.TH masqmail.get 5 2010-05-07 masqmail-0.2.22 "File Formats"
    18.5 +
    18.6 +.SH NAME
    18.7 +masqmail.get \- masqmail get configuration file
    18.8 +
    18.9 +
   18.10 +.SH DESCRIPTION
   18.11 + 
   18.12 +This man page describes the options available for the masqmail get configuration.
   18.13 +
   18.14 +
   18.15 +.SH OPTIONS
   18.16 +
   18.17 +.TP
   18.18 +\fBprotocol\fR = \fIstring\fR
   18.19 +
   18.20 +The protocol with which you retrieve your mail.
   18.21 +Currently only `pop3' and `apop' are supported.
   18.22 +There is no default.
   18.23 +
   18.24 +.TP
   18.25 +\fBserver\fR = \fIstring\fR
   18.26 +
   18.27 +The server you get your mail from.
   18.28 +
   18.29 +.TP
   18.30 +\fBresolve_list\fR = \fIlist\fR
   18.31 +
   18.32 +Specify the method how the domain of the server is resolved.
   18.33 +Possible values are dns_mx, dns_a, byname.
   18.34 +For `dns_mx', the domain is assumed to be an MX pointer to a list of host names,
   18.35 +these will be tried each in order
   18.36 +(lowest preference value first, equal preference values in random order).
   18.37 +For `dns_a', the domain is assumed to be an A pointer.
   18.38 +For `byname', the library function \fBgethostbyname(3)\fR will be used.
   18.39 +
   18.40 +The default is "dns_a;byname".
   18.41 +It does not make much sense here to use `dns_mx'.
   18.42 +
   18.43 +.TP
   18.44 +\fBuser\fR = \fIstring\fR
   18.45 +
   18.46 +Your login name.
   18.47 +
   18.48 +.TP
   18.49 +\fBpass\fR = \fIstring\fR
   18.50 +
   18.51 +Your password.
   18.52 +
   18.53 +.TP
   18.54 +\fBaddress\fR = \fIaddress\fR
   18.55 +
   18.56 +The address where the retrieved mail should be sent to.
   18.57 +It can be any address, but you probably want to set this to a local address on your LAN.
   18.58 +
   18.59 +.TP
   18.60 +\fBreturn_path\fR = \fIaddress\fR
   18.61 +
   18.62 +If set, masqmail sets the return path to this address.
   18.63 +Bounces generated during further delivery will be sent to this address.
   18.64 +If unset, masqmail looks for the Return-Path: header in the mail,
   18.65 +if this does not exist it uses the From: address and if this fails, postmaster will be used.
   18.66 +
   18.67 +It is in most cases not useful to set this to the same address as the `address'
   18.68 +option as this may generate multiple bounces.
   18.69 +postmaster is recommended.
   18.70 +
   18.71 +.TP
   18.72 +\fBdo_keep\fR = \fIboolean\fR
   18.73 +
   18.74 +If you want to keep your mail on the server after you retrieved it, set this to true.
   18.75 +It is recommended that you also set do_uidl,
   18.76 +otherwise you will get the mail again each time you connect to the server.
   18.77 +Masqmail does not check any headers before it retrieves mail, which may mark it as already fetched.
   18.78 +Note that this behaviour is different to that of fetchmail.
   18.79 +The default is false.
   18.80 +
   18.81 +.TP
   18.82 +\fBdo_uidl\fR = \fIboolean\fR
   18.83 +
   18.84 +If set, masqmail keeps a list of unique IDs of mails already fetched,
   18.85 +so that they will not be retrieved again.
   18.86 +Default is false.
   18.87 +
   18.88 +.TP
   18.89 +\fBdo_uidl_dele\fR = \fIboolean\fR
   18.90 +
   18.91 +If set, and \fBdo_uidl\fR is also set, MasqMail sends a delete (DELE) command
   18.92 +to the server for each message uid in the uid listing at the beginning of the session.
   18.93 +This prevents mail to be left on the server if masqmail gets interrupted during
   18.94 +a session before it can send the QUIT command to the server.
   18.95 +Default is false.
   18.96 +
   18.97 +.TP
   18.98 +\fBmax_size\fR = \fInumeric\fR
   18.99 +
  18.100 +If set to a value > 0, only messages smaller than this in bytes will be retrieved.
  18.101 +The default is 0.
  18.102 +
  18.103 +.TP
  18.104 +\fBmax_count\fR = \fInumeric\fR
  18.105 +
  18.106 +If set to a value > 0, only \fBmax_count\fR messages will be retrieved.
  18.107 +The default is 0.
  18.108 +
  18.109 +.TP
  18.110 +\fBwrapper\fR = \fIcommand\fR
  18.111 +
  18.112 +If set, instead of opening a connection to a remote server,
  18.113 +\fIcommand\fR will be called and all traffic will be piped to its stdin and from its stdout.
  18.114 +Purpose is to tunnel ip traffic, e.g. for ssl.
  18.115 +
  18.116 +Example for ssl tunneling:
  18.117 +
  18.118 +wrapper="/usr/bin/openssl s_client \-quiet \-connect pop.gmx.net:995 2>/dev/null"
  18.119 +
  18.120 +
  18.121 +.SH AUTHOR
  18.122 +
  18.123 +Masqmail was written by Oliver Kurth.
  18.124 +It is now maintained by Markus Schnalke <meillo@marmaro.de>.
  18.125 +
  18.126 +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR.
  18.127 +There is also a mailing list, you will find information about it at masqmail's main site.
  18.128 +
  18.129 +
  18.130 +.SH BUGS
  18.131 +
  18.132 +Please report bugs to the mailing list.
  18.133 +
  18.134 +
  18.135 +.SH SEE ALSO
  18.136 +
  18.137 +\fBmasqmail(8)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.conf(5)\fR
    19.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    19.2 +++ b/man/masqmail.route.5	Sat May 29 22:07:07 2010 +0200
    19.3 @@ -0,0 +1,308 @@
    19.4 +.TH masqmail.route 5 2010-05-07 masqmail-0.2.22 "File Formats"
    19.5 +
    19.6 +.SH NAME
    19.7 +masqmail.route \- masqmail route configuration file
    19.8 +
    19.9 +
   19.10 +.SH DESCRIPTION
   19.11 +
   19.12 +This man page describes the syntax of the route configuration files of \fBmasqmail (8)\fR.
   19.13 +Their usual locations are in \fI/etc/masqmail/\fR.
   19.14 +
   19.15 +.SH OPTIONS
   19.16 +
   19.17 +.TP
   19.18 +\fBprotocol\fR = \fIstring\fR
   19.19 +
   19.20 +\fIstring\fR can be one of `smtp' or `pipe', default is `smtp'.
   19.21 +If set to `smtp', mail will be sent with the SMTP protocol to its destination.
   19.22 +If set to `pipe', you also have to set `pipe' to a command, the message will then be piped to a program.
   19.23 +See option `pipe' below.
   19.24 +
   19.25 +.TP
   19.26 +\fBmail_host\fR = \fIstring\fR
   19.27 +
   19.28 +This is preferably the mail server of your ISP.
   19.29 +All outgoing messages will be sent to this host which will distribute them to their destinations.
   19.30 +If you do not set this mails will be sent directly.
   19.31 +Because the mail server is probably `near' to you, mail transfer will be much faster if you use it.
   19.32 +
   19.33 +You can optionally give a port number following the host name and a colon, eg mail_host="mail.foo.com:25".
   19.34 +
   19.35 +.TP
   19.36 +\fBresolve_list\fR = \fIlist\fR
   19.37 +
   19.38 +Specify the method how the domain of the server is resolved.
   19.39 +Possible values are dns_mx, dns_a, byname.
   19.40 +For `dns_mx', the domain is assumed to be an MX pointer to a list of host names,
   19.41 +these will be tried each in order (lowest preference value first, equal preference values in random order).
   19.42 +For `dns_a', the domain is assumed to be an A pointer.
   19.43 +For `byname', the library function \fBgethostbyname(3)\fR will be used.
   19.44 +
   19.45 +The default is "dns_mx;dns_a;byname".
   19.46 +
   19.47 +.TP
   19.48 +\fBconnect_error_fail\fR = \fIboolean\fR
   19.49 +
   19.50 +If this is set, a connection error will cause a mail delivery to fail, ie. it will be bounced.
   19.51 +If it is unset, it will just be defered.
   19.52 +
   19.53 +Default is false.
   19.54 +The reason for this is that masqmail is designed for non permanent internet connections,
   19.55 +where such errors may occur quite often, and a bounce would be annoying.
   19.56 +
   19.57 +For the default local_net route is is set to true.
   19.58 +
   19.59 +.TP
   19.60 +\fBhelo_name\fR = \fIstring\fR
   19.61 +
   19.62 +Set the name given with the HELO/EHLO command. If this is not set,
   19.63 +\fBhost_name\fR from \fImasqmail.conf\fR will be used,
   19.64 +if the \fBdo_correct_helo\fR option (see below) is unset.
   19.65 +
   19.66 +.TP
   19.67 +\fBdo_correct_helo\fR = \fIboolean\fR
   19.68 +
   19.69 +If this is set, masqmail tries to look up your host name as it appears
   19.70 +on the internet and sends this in the HELO/EHLO command.
   19.71 +Some servers are so picky that they want this.
   19.72 +Which is really crazy.
   19.73 +It just does not make any sense to lie about ones own identity,
   19.74 +because it can always be looked up by the server.
   19.75 +Nobody should believe in the name given by HELO/EHLO anyway.
   19.76 +If this is not set, \fBhost_name\fR from \fImasqmail.conf\fR or as given with
   19.77 +the \fBhelo_name\fR (see above) will be used.
   19.78 +
   19.79 +.TP
   19.80 +\fBdo_pipelining\fR = \fIboolean\fR
   19.81 +
   19.82 +If this is set to false, masqmail will not use ESMTP PIPELINING,
   19.83 +even if the server announces that it is able to cope with it.
   19.84 +Default is true.
   19.85 +
   19.86 +You do not want to set this to false unless the mail setup on the
   19.87 +remote server side is really broken.
   19.88 +Keywords: wingate.
   19.89 +
   19.90 +.TP
   19.91 +\fBallowed_mail_locals\fR = \fIlist\fR
   19.92 +
   19.93 +This is a semicolon `;' separated list of local parts which will be allowed
   19.94 +to send mail through this connection.
   19.95 +If unset and \fBnot_allowed_mail_locals\fR is also unset, all users are allowed.
   19.96 +
   19.97 +.TP
   19.98 +\fBnot_allowed_mail_locals\fR = \fIlist\fR
   19.99 +
  19.100 +This is a semicolon `;' separated list of local parts which will be not allowed
  19.101 +to send mail through this connection.
  19.102 +Local parts in this list will not be allowed to use this route even if they
  19.103 +are part of \fBallowed_mail_locals\fR (see above).
  19.104 +
  19.105 +.TP
  19.106 +\fBallowed_return_paths\fR = \fIlist\fR
  19.107 +
  19.108 +This is a semicolon `;' separated list of addresses.
  19.109 +Messages which have one one of these addresses as the return path will be used using this route
  19.110 +(if not also in \fBnot_allowed_return_paths\fR or an item in \fBnot_allowed_mail_locals\fR matches).
  19.111 +
  19.112 +Patterns containing `?' and `*' can be used.
  19.113 +The special item "<>" matches the null sender address (eg. failure notices or delivery notifications).
  19.114 +
  19.115 +.TP
  19.116 +\fBnot_allowed_return_paths\fR = \fIlist\fR
  19.117 +
  19.118 +This is a semicolon `;' separated list of addresses.
  19.119 +Messages which have one one of these addresses as the return path will not
  19.120 +be used using this route (even if also in \fBallowed_return_paths\fR
  19.121 +or an item in \fBallowed_mail_locals\fR matches).
  19.122 +
  19.123 +Patterns containing `?' and `*' can be used.
  19.124 +The special item "<>" matches the null sender address (eg. failure notices or delivery notifications).
  19.125 +
  19.126 +.TP
  19.127 +\fBallowed_rcpt_domains\fR = \fIlist\fR
  19.128 +
  19.129 +A list of recipient domains where mail will be sent to.
  19.130 +This is for example useful if you use this route configuration when connected to another LAN via ppp.
  19.131 +Patterns containing `?' and `*' can be used.
  19.132 +
  19.133 +.TP
  19.134 +\fBnot_allowed_rcpt_domains\fR = \fIlist\fR
  19.135 +
  19.136 +A list of recipient domains where mail will not be sent to.
  19.137 +This is for example useful if you send mail directly (\fBmail_host\fR is not set)
  19.138 +and you know of hosts that will not accept mail from you because they use a dialup list
  19.139 +(eg. \fBhttp://maps.vix.com/dul/\fR).
  19.140 +If any domain matches both \fBallowed_rcpt_domains\fR and \fBnot_allowed_rcpt_domains\fR,
  19.141 +mail will not be sent to this domain.
  19.142 +Patterns containing `?' and `*' can be used.
  19.143 +
  19.144 +.TP
  19.145 +\fBset_h_from_domain\fR = \fIstring\fR
  19.146 +
  19.147 +Replace the domain part in `From:' headers with this value.
  19.148 +This may be useful if you use a private, outside unknown address on your local LAN
  19.149 +and want this to be replaced by the domain of the address of your email addrsss on the internet.
  19.150 +Note that this is different to \fBset_return_path_domain\fR, see below.
  19.151 +
  19.152 +.TP
  19.153 +\fBset_return_path_domain\fR = \fIstring\fR
  19.154 +
  19.155 +Sets the domain part of the envelope from address.
  19.156 +Some hosts check whether this is the same as the net the connection is coming from.
  19.157 +If not, they reject the mail because they suspect spamming.
  19.158 +It should be a valid address, because some mail servers also check that.
  19.159 +You can also use this to set it to your usual address on the internet
  19.160 +and put a local address only known on your LAN in the configuration of your mailer.
  19.161 +Only the domain part will be changed, the local part remains unchanged.
  19.162 +Use \fBmap_return_path_addresses\fR for rewriting local parts.
  19.163 +
  19.164 +.TP
  19.165 +\fBmap_h_from_addresses\fR = \fIlist\fR
  19.166 +
  19.167 +This is similar to \fBset_h_from_domain\fR, but more flexible.
  19.168 +Set this to a list which maps local parts to a full RFC 822 compliant email address,
  19.169 +the local parts (the keys) are separated from the addresses (the values) by colons (`:').
  19.170 +
  19.171 +Example:
  19.172 +
  19.173 +map_h_from_addresses = "john: John Smith <jsmith@mail.academic.edu>; charlie: Charlie Miller <cmiller@mx.commercial.com>"
  19.174 +
  19.175 +You can use patterns, eg. * as keys.
  19.176 +
  19.177 +.TP
  19.178 +\fBmap_h_reply_to_addresses\fR = \fIlist\fR
  19.179 +
  19.180 +Same as \fBmap_h_from_addresses\fR, but for the `Reply-To:' header.
  19.181 +
  19.182 +.TP
  19.183 +\fBmap_h_mail_followup_to_addresses\fR = \fIlist\fR
  19.184 +
  19.185 +Same as \fBmap_h_from_addresses\fR, but for the `Mail-Followup-To:' header.
  19.186 +Useful when replying to mailing lists.
  19.187 +
  19.188 +.TP
  19.189 +\fBmap_return_path_addresses\fR = \fIlist\fR
  19.190 +
  19.191 +This is similar to \fBset_return_path_domain\fR, but more flexible.
  19.192 +Set this to a list which maps local parts to a full RFC 821 compliant email address,
  19.193 +the local parts (the keys) are separated from the addresses (the values) by colons (`:').
  19.194 +Note that this option takes RFC 821 addresses while \fBmap_h_from_addresses\fR takes RFC 822 addresses.
  19.195 +The most important difference is that RFC 821 addresses have no full name.
  19.196 +
  19.197 +Example:
  19.198 +
  19.199 +map_return_path_addresses = "john: <jsmith@mail.academic.edu>; charlie: <cmiller@mx.commercial.com>"
  19.200 +
  19.201 +You can use patterns, eg. * as keys.
  19.202 +
  19.203 +.TP
  19.204 +\fBexpand_h_sender_address\fR = \fIboolean\fR
  19.205 +
  19.206 +This sets the domain of the sender address as given by the Sender: header
  19.207 +to the same address as in the envelope return path address
  19.208 +(which can be set by either \fBset_return_path_domain\fR or \fBmap_return_path_addresses\fR).
  19.209 +This is for mail clients (eg. Microsoft Outlook) which use this address as the sender address.
  19.210 +Though they should use the From: address, see RFC 821.
  19.211 +If \fBfetchmail(1)\fR encounters an unqualified Sender: address,
  19.212 +it will be expanded to the domain of the pop server, which is almost never correct.
  19.213 +Default is true.
  19.214 +
  19.215 +.TP
  19.216 +\fBexpand_h_sender_domain\fR = \fIboolean\fR
  19.217 +
  19.218 +Like \fBexpand_h_sender_address\fR, but sets the domain only.
  19.219 +Deprecated, will be removed in a later version.
  19.220 +
  19.221 +.TP
  19.222 +\fBlast_route\fR = \fIboolean\fR
  19.223 +
  19.224 +If this is set, a mail which would have been delivered using this route,
  19.225 +but has failed temporarily, will not be tried to be delivered using the next route.
  19.226 +
  19.227 +If you have set up a special route with filters using the lists `allowed_rcpt_domains',
  19.228 +`allowed_return_paths', and `allowed_mail_locals' or their complements (not_),
  19.229 +and the mail passing these rules should be delivered using this route only,
  19.230 +you should set this to `true'.
  19.231 +Otherwise the mail would be passed to the next route (if any),
  19.232 +unless that route has rules which prevent that.
  19.233 +
  19.234 +Default is false.
  19.235 +
  19.236 +.TP
  19.237 +\fBauth_name\fR = \fIstring\fR
  19.238 +
  19.239 +Set the authentication type for ESMTP AUTH authentication.
  19.240 +Currently only `cram-md5' and `login' are supported.
  19.241 +
  19.242 +.TP
  19.243 +\fBauth_login\fR = \fIstring\fR
  19.244 +
  19.245 +Your account name for ESMTP AUTH authentication.
  19.246 +
  19.247 +.TP
  19.248 +\fBauth_secret\fR = \fIstring\fR
  19.249 +
  19.250 +Your secret for ESMTP AUTH authentication.
  19.251 +
  19.252 +.TP
  19.253 +\fBpop3_login\fR = \fIfile\fR
  19.254 +
  19.255 +If your Mail server requires SMTP-after-POP,
  19.256 +set this to a get configuration (see \fBmasqmail.get(5)\fR).
  19.257 +If you login to the POP server before you send, this is not necessary.
  19.258 +
  19.259 +.TP
  19.260 +\fBwrapper\fR = \fIcommand\fR
  19.261 +
  19.262 +If set, instead of opening a connection to a remote server,
  19.263 +\fIcommand\fR will be called and all traffic will be piped to its stdin and from its stdout.
  19.264 +Purpose is to tunnel ip traffic, eg. for ssl.
  19.265 +
  19.266 +Example for ssl tunneling:
  19.267 +
  19.268 +wrapper="/usr/bin/openssl s_client \-quiet \-connect pop.gmx.net:995 2>/dev/null"
  19.269 +
  19.270 +.TP
  19.271 +\fBpipe\fR = \fIcommand\fR
  19.272 +
  19.273 +If set, and protocol is set to `pipe',
  19.274 +\fIcommand\fR will be called and the message will be piped to its stdin.
  19.275 +Purpose is to use gateways to uucp, fax, sms or whatever else.
  19.276 +
  19.277 +You can use variables to give as arguments to the command,
  19.278 +these are the same as for the mda in the main configuration, see \fBmasqmail.conf(5)\fR.
  19.279 +
  19.280 +.TP
  19.281 +\fBpipe_fromline = \fIboolean\fR
  19.282 +
  19.283 +If this is set, and protocol is set to `pipe',
  19.284 +a from line will be prepended to the output stream whenever a pipe command is called.
  19.285 +Default is false.
  19.286 +
  19.287 +.TP
  19.288 +\fBpipe_fromhack = \fIboolean\fR
  19.289 +
  19.290 +If this is set, and protocol is set to `pipe',
  19.291 +each line beginning with `From ' is replaced with `>From ' whenever a pipe command is called.
  19.292 +You probably want this if you have set \fBpipe_fromline\fR above.
  19.293 +Default is false.
  19.294 +
  19.295 +
  19.296 +.SH AUTHOR
  19.297 +
  19.298 +Masqmail was written by Oliver Kurth.
  19.299 +It is now maintained by Markus Schnalke <meillo@marmaro.de>.
  19.300 +
  19.301 +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR.
  19.302 +There is also a mailing list, you will find information about it at masqmail's main site.
  19.303 +
  19.304 +
  19.305 +.SH BUGS
  19.306 +
  19.307 +Please report bugs to the mailing list.
  19.308 +
  19.309 +.SH SEE ALSO
  19.310 +
  19.311 +\fBmasqmail(8)\fR, \fBmasqmail.conf(5)\fR, \fBmasqmail.get(5)\fR
    20.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
    20.2 +++ b/man/mservdetect.8	Sat May 29 22:07:07 2010 +0200
    20.3 @@ -0,0 +1,49 @@
    20.4 +.TH mservdetect 8 2010-05-07 masqmail-0.2.22 "Maintenance Commands"
    20.5 +
    20.6 +.SH NAME
    20.7 +mservdetect \- Helper for masqmail and masqdialer
    20.8 +
    20.9 +
   20.10 +.SH SYNOPSIS
   20.11 +\fB/usr/bin/masqmail \fIhost port\fR
   20.12 +
   20.13 +
   20.14 +.SH DESCRIPTION
   20.15 +
   20.16 +Mservdetect is a small helper application for masqmail to detect its online status
   20.17 +if the modem server masqdialer is used.
   20.18 +It connects to the\fIhost\fR at \fIport\fR and prints the connection name to stdout.
   20.19 +
   20.20 +If you want to use it, set \fBonline_detect\fR=\fIpipe\fR and
   20.21 +\fBonline_pipe\fR=\fI"/usr/bin/mservdetect host port"\fR.
   20.22 +
   20.23 +.SH OPTIONS
   20.24 +
   20.25 +.TP
   20.26 +\fBhost\fR
   20.27 +
   20.28 +The hostname where the masqdialer server is running.
   20.29 +
   20.30 +.TP
   20.31 +\fBport\fR
   20.32 +
   20.33 +The port number where the masqdialer server is listening.
   20.34 +
   20.35 +
   20.36 +.SH AUTHOR
   20.37 +
   20.38 +Masqmail was written by Oliver Kurth.
   20.39 +It is now maintained by Markus Schnalke <meillo@marmaro.de>.
   20.40 +
   20.41 +You will find the newest version of masqmail at \fBhttp://prog.marmaro.de/masqmail/\fR.
   20.42 +There is also a mailing list, you will find information about it at masqmail's main site.
   20.43 +
   20.44 +
   20.45 +.SH BUGS
   20.46 +
   20.47 +Please report bugs to the mailing list.
   20.48 +
   20.49 +
   20.50 +.SH SEE ALSO
   20.51 +
   20.52 +\fBmasqmail.conf(5)\fR