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