summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDavid Bremner <bremner@debian.org>2017-11-11 08:46:16 -0400
committerDavid Bremner <bremner@debian.org>2017-11-11 08:46:16 -0400
commitddd3f417602bdd5fd55b741900f9450402c6ad02 (patch)
tree541c8e8e99eff11f58504975dc782d7ee931598b /doc
Import nullmailer_2.1.orig.tar.gz
[dgit import orig nullmailer_2.1.orig.tar.gz]
Diffstat (limited to 'doc')
-rw-r--r--doc/DIAGRAM25
-rw-r--r--doc/Makefile.am9
-rw-r--r--doc/Makefile.in584
-rw-r--r--doc/nullmailer-dsn.1125
-rw-r--r--doc/nullmailer-inject.1256
-rw-r--r--doc/nullmailer-queue.853
-rw-r--r--doc/nullmailer-send.8204
-rw-r--r--doc/nullmailer.737
-rw-r--r--doc/sendmail.193
9 files changed, 1386 insertions, 0 deletions
diff --git a/doc/DIAGRAM b/doc/DIAGRAM
new file mode 100644
index 0000000..4557037
--- /dev/null
+++ b/doc/DIAGRAM
@@ -0,0 +1,25 @@
+ sendmail --------------- mailq
+ / \
+ / \
+ / \
+nullmailer-inject nullmailer-smtpd
+ \ /
+ \ /
+ \ /
+ nullmailer-inject
+ |
+ |
+ |
+ nullmailer-queue
+ |
+ |
+ |
+ QUEUE/tmp -> QUEUE/queue -> QUEUE/failed
+ |
+ |
+ |
+ nullmailer-send ---- nullmailer-dsn
+ |
+ |
+ |
+ BIN/PROTOCOL
diff --git a/doc/Makefile.am b/doc/Makefile.am
new file mode 100644
index 0000000..c3428b8
--- /dev/null
+++ b/doc/Makefile.am
@@ -0,0 +1,9 @@
+# info_TEXINFOS = nullmailer.texi
+man_MANS = \
+ nullmailer-dsn.1 \
+ nullmailer-inject.1 \
+ sendmail.1 \
+ nullmailer.7 \
+ nullmailer-queue.8 \
+ nullmailer-send.8
+EXTRA_DIST = DIAGRAM $(man_MANS)
diff --git a/doc/Makefile.in b/doc/Makefile.in
new file mode 100644
index 0000000..9b65515
--- /dev/null
+++ b/doc/Makefile.in
@@ -0,0 +1,584 @@
+# Makefile.in generated by automake 1.15 from Makefile.am.
+# @configure_input@
+
+# Copyright (C) 1994-2014 Free Software Foundation, Inc.
+
+# This Makefile.in is free software; the Free Software Foundation
+# gives unlimited permission to copy and/or distribute it,
+# with or without modifications, as long as this notice is preserved.
+
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
+# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
+# PARTICULAR PURPOSE.
+
+@SET_MAKE@
+VPATH = @srcdir@
+am__is_gnu_make = { \
+ if test -z '$(MAKELEVEL)'; then \
+ false; \
+ elif test -n '$(MAKE_HOST)'; then \
+ true; \
+ elif test -n '$(MAKE_VERSION)' && test -n '$(CURDIR)'; then \
+ true; \
+ else \
+ false; \
+ fi; \
+}
+am__make_running_with_option = \
+ case $${target_option-} in \
+ ?) ;; \
+ *) echo "am__make_running_with_option: internal error: invalid" \
+ "target option '$${target_option-}' specified" >&2; \
+ exit 1;; \
+ esac; \
+ has_opt=no; \
+ sane_makeflags=$$MAKEFLAGS; \
+ if $(am__is_gnu_make); then \
+ sane_makeflags=$$MFLAGS; \
+ else \
+ case $$MAKEFLAGS in \
+ *\\[\ \ ]*) \
+ bs=\\; \
+ sane_makeflags=`printf '%s\n' "$$MAKEFLAGS" \
+ | sed "s/$$bs$$bs[$$bs $$bs ]*//g"`;; \
+ esac; \
+ fi; \
+ skip_next=no; \
+ strip_trailopt () \
+ { \
+ flg=`printf '%s\n' "$$flg" | sed "s/$$1.*$$//"`; \
+ }; \
+ for flg in $$sane_makeflags; do \
+ test $$skip_next = yes && { skip_next=no; continue; }; \
+ case $$flg in \
+ *=*|--*) continue;; \
+ -*I) strip_trailopt 'I'; skip_next=yes;; \
+ -*I?*) strip_trailopt 'I';; \
+ -*O) strip_trailopt 'O'; skip_next=yes;; \
+ -*O?*) strip_trailopt 'O';; \
+ -*l) strip_trailopt 'l'; skip_next=yes;; \
+ -*l?*) strip_trailopt 'l';; \
+ -[dEDm]) skip_next=yes;; \
+ -[JT]) skip_next=yes;; \
+ esac; \
+ case $$flg in \
+ *$$target_option*) has_opt=yes; break;; \
+ esac; \
+ done; \
+ test $$has_opt = yes
+am__make_dryrun = (target_option=n; $(am__make_running_with_option))
+am__make_keepgoing = (target_option=k; $(am__make_running_with_option))
+pkgdatadir = $(datadir)/@PACKAGE@
+pkgincludedir = $(includedir)/@PACKAGE@
+pkglibdir = $(libdir)/@PACKAGE@
+pkglibexecdir = $(libexecdir)/@PACKAGE@
+am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
+install_sh_DATA = $(install_sh) -c -m 644
+install_sh_PROGRAM = $(install_sh) -c
+install_sh_SCRIPT = $(install_sh) -c
+INSTALL_HEADER = $(INSTALL_DATA)
+transform = $(program_transform_name)
+NORMAL_INSTALL = :
+PRE_INSTALL = :
+POST_INSTALL = :
+NORMAL_UNINSTALL = :
+PRE_UNINSTALL = :
+POST_UNINSTALL = :
+subdir = doc
+ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
+am__aclocal_m4_deps = $(top_srcdir)/acinclude.m4 \
+ $(top_srcdir)/configure.ac
+am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
+ $(ACLOCAL_M4)
+DIST_COMMON = $(srcdir)/Makefile.am $(am__DIST_COMMON)
+mkinstalldirs = $(install_sh) -d
+CONFIG_HEADER = $(top_builddir)/config.h
+CONFIG_CLEAN_FILES =
+CONFIG_CLEAN_VPATH_FILES =
+AM_V_P = $(am__v_P_@AM_V@)
+am__v_P_ = $(am__v_P_@AM_DEFAULT_V@)
+am__v_P_0 = false
+am__v_P_1 = :
+AM_V_GEN = $(am__v_GEN_@AM_V@)
+am__v_GEN_ = $(am__v_GEN_@AM_DEFAULT_V@)
+am__v_GEN_0 = @echo " GEN " $@;
+am__v_GEN_1 =
+AM_V_at = $(am__v_at_@AM_V@)
+am__v_at_ = $(am__v_at_@AM_DEFAULT_V@)
+am__v_at_0 = @
+am__v_at_1 =
+SOURCES =
+DIST_SOURCES =
+am__can_run_installinfo = \
+ case $$AM_UPDATE_INFO_DIR in \
+ n|no|NO) false;; \
+ *) (install-info --version) >/dev/null 2>&1;; \
+ esac
+am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`;
+am__vpath_adj = case $$p in \
+ $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \
+ *) f=$$p;; \
+ esac;
+am__strip_dir = f=`echo $$p | sed -e 's|^.*/||'`;
+am__install_max = 40
+am__nobase_strip_setup = \
+ srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*|]/\\\\&/g'`
+am__nobase_strip = \
+ for p in $$list; do echo "$$p"; done | sed -e "s|$$srcdirstrip/||"
+am__nobase_list = $(am__nobase_strip_setup); \
+ for p in $$list; do echo "$$p $$p"; done | \
+ sed "s| $$srcdirstrip/| |;"' / .*\//!s/ .*/ ./; s,\( .*\)/[^/]*$$,\1,' | \
+ $(AWK) 'BEGIN { files["."] = "" } { files[$$2] = files[$$2] " " $$1; \
+ if (++n[$$2] == $(am__install_max)) \
+ { print $$2, files[$$2]; n[$$2] = 0; files[$$2] = "" } } \
+ END { for (dir in files) print dir, files[dir] }'
+am__base_list = \
+ sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \
+ sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g'
+am__uninstall_files_from_dir = { \
+ test -z "$$files" \
+ || { test ! -d "$$dir" && test ! -f "$$dir" && test ! -r "$$dir"; } \
+ || { echo " ( cd '$$dir' && rm -f" $$files ")"; \
+ $(am__cd) "$$dir" && rm -f $$files; }; \
+ }
+man1dir = $(mandir)/man1
+am__installdirs = "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(man7dir)" \
+ "$(DESTDIR)$(man8dir)"
+man7dir = $(mandir)/man7
+man8dir = $(mandir)/man8
+NROFF = nroff
+MANS = $(man_MANS)
+am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP)
+am__DIST_COMMON = $(srcdir)/Makefile.in
+DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
+ACLOCAL = @ACLOCAL@
+AMTAR = @AMTAR@
+AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@
+AUTOCONF = @AUTOCONF@
+AUTOHEADER = @AUTOHEADER@
+AUTOMAKE = @AUTOMAKE@
+AWK = @AWK@
+CC = @CC@
+CCDEPMODE = @CCDEPMODE@
+CFLAGS = @CFLAGS@
+CPPFLAGS = @CPPFLAGS@
+CXX = @CXX@
+CXXCPP = @CXXCPP@
+CXXDEPMODE = @CXXDEPMODE@
+CXXFLAGS = @CXXFLAGS@
+CYGPATH_W = @CYGPATH_W@
+DEFS = @DEFS@
+DEPDIR = @DEPDIR@
+ECHO_C = @ECHO_C@
+ECHO_N = @ECHO_N@
+ECHO_T = @ECHO_T@
+EGREP = @EGREP@
+EXEEXT = @EXEEXT@
+GREP = @GREP@
+HAVE_GETADDRINFO = @HAVE_GETADDRINFO@
+INSTALL = @INSTALL@
+INSTALL_DATA = @INSTALL_DATA@
+INSTALL_PROGRAM = @INSTALL_PROGRAM@
+INSTALL_SCRIPT = @INSTALL_SCRIPT@
+INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
+LDFLAGS = @LDFLAGS@
+LIBOBJS = @LIBOBJS@
+LIBS = @LIBS@
+LTLIBOBJS = @LTLIBOBJS@
+MAKEINFO = @MAKEINFO@
+MKDIR = @MKDIR@
+MKDIR_P = @MKDIR_P@
+OBJEXT = @OBJEXT@
+PACKAGE = @PACKAGE@
+PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
+PACKAGE_NAME = @PACKAGE_NAME@
+PACKAGE_STRING = @PACKAGE_STRING@
+PACKAGE_TARNAME = @PACKAGE_TARNAME@
+PACKAGE_URL = @PACKAGE_URL@
+PACKAGE_VERSION = @PACKAGE_VERSION@
+PATH_SEPARATOR = @PATH_SEPARATOR@
+RANLIB = @RANLIB@
+RM = @RM@
+SET_MAKE = @SET_MAKE@
+SHELL = @SHELL@
+STRIP = @STRIP@
+VERSION = @VERSION@
+abs_builddir = @abs_builddir@
+abs_srcdir = @abs_srcdir@
+abs_top_builddir = @abs_top_builddir@
+abs_top_srcdir = @abs_top_srcdir@
+ac_ct_CC = @ac_ct_CC@
+ac_ct_CXX = @ac_ct_CXX@
+am__include = @am__include@
+am__leading_dot = @am__leading_dot@
+am__quote = @am__quote@
+am__tar = @am__tar@
+am__untar = @am__untar@
+bindir = @bindir@
+build_alias = @build_alias@
+builddir = @builddir@
+datadir = @datadir@
+datarootdir = @datarootdir@
+docdir = @docdir@
+dvidir = @dvidir@
+exec_prefix = @exec_prefix@
+host_alias = @host_alias@
+htmldir = @htmldir@
+includedir = @includedir@
+infodir = @infodir@
+install_sh = @install_sh@
+libdir = @libdir@
+libexecdir = @libexecdir@
+localedir = @localedir@
+localstatedir = @localstatedir@
+mandir = @mandir@
+mkdir_p = @mkdir_p@
+oldincludedir = @oldincludedir@
+pdfdir = @pdfdir@
+prefix = @prefix@
+program_transform_name = @program_transform_name@
+psdir = @psdir@
+sbindir = @sbindir@
+sharedstatedir = @sharedstatedir@
+srcdir = @srcdir@
+sysconfdir = @sysconfdir@
+target_alias = @target_alias@
+top_build_prefix = @top_build_prefix@
+top_builddir = @top_builddir@
+top_srcdir = @top_srcdir@
+
+# info_TEXINFOS = nullmailer.texi
+man_MANS = \
+ nullmailer-dsn.1 \
+ nullmailer-inject.1 \
+ sendmail.1 \
+ nullmailer.7 \
+ nullmailer-queue.8 \
+ nullmailer-send.8
+
+EXTRA_DIST = DIAGRAM $(man_MANS)
+all: all-am
+
+.SUFFIXES:
+$(srcdir)/Makefile.in: $(srcdir)/Makefile.am $(am__configure_deps)
+ @for dep in $?; do \
+ case '$(am__configure_deps)' in \
+ *$$dep*) \
+ ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \
+ && { if test -f $@; then exit 0; else break; fi; }; \
+ exit 1;; \
+ esac; \
+ done; \
+ echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu doc/Makefile'; \
+ $(am__cd) $(top_srcdir) && \
+ $(AUTOMAKE) --gnu doc/Makefile
+Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
+ @case '$?' in \
+ *config.status*) \
+ cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \
+ *) \
+ echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \
+ cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \
+ esac;
+
+$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
+ cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
+
+$(top_srcdir)/configure: $(am__configure_deps)
+ cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
+$(ACLOCAL_M4): $(am__aclocal_m4_deps)
+ cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
+$(am__aclocal_m4_deps):
+install-man1: $(man_MANS)
+ @$(NORMAL_INSTALL)
+ @list1=''; \
+ list2='$(man_MANS)'; \
+ test -n "$(man1dir)" \
+ && test -n "`echo $$list1$$list2`" \
+ || exit 0; \
+ echo " $(MKDIR_P) '$(DESTDIR)$(man1dir)'"; \
+ $(MKDIR_P) "$(DESTDIR)$(man1dir)" || exit 1; \
+ { for i in $$list1; do echo "$$i"; done; \
+ if test -n "$$list2"; then \
+ for i in $$list2; do echo "$$i"; done \
+ | sed -n '/\.1[a-z]*$$/p'; \
+ fi; \
+ } | while read p; do \
+ if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
+ echo "$$d$$p"; echo "$$p"; \
+ done | \
+ sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \
+ -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \
+ sed 'N;N;s,\n, ,g' | { \
+ list=; while read file base inst; do \
+ if test "$$base" = "$$inst"; then list="$$list $$file"; else \
+ echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \
+ $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst" || exit $$?; \
+ fi; \
+ done; \
+ for i in $$list; do echo "$$i"; done | $(am__base_list) | \
+ while read files; do \
+ test -z "$$files" || { \
+ echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man1dir)'"; \
+ $(INSTALL_DATA) $$files "$(DESTDIR)$(man1dir)" || exit $$?; }; \
+ done; }
+
+uninstall-man1:
+ @$(NORMAL_UNINSTALL)
+ @list=''; test -n "$(man1dir)" || exit 0; \
+ files=`{ for i in $$list; do echo "$$i"; done; \
+ l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
+ sed -n '/\.1[a-z]*$$/p'; \
+ } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \
+ -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \
+ dir='$(DESTDIR)$(man1dir)'; $(am__uninstall_files_from_dir)
+install-man7: $(man_MANS)
+ @$(NORMAL_INSTALL)
+ @list1=''; \
+ list2='$(man_MANS)'; \
+ test -n "$(man7dir)" \
+ && test -n "`echo $$list1$$list2`" \
+ || exit 0; \
+ echo " $(MKDIR_P) '$(DESTDIR)$(man7dir)'"; \
+ $(MKDIR_P) "$(DESTDIR)$(man7dir)" || exit 1; \
+ { for i in $$list1; do echo "$$i"; done; \
+ if test -n "$$list2"; then \
+ for i in $$list2; do echo "$$i"; done \
+ | sed -n '/\.7[a-z]*$$/p'; \
+ fi; \
+ } | while read p; do \
+ if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
+ echo "$$d$$p"; echo "$$p"; \
+ done | \
+ sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^7][0-9a-z]*$$,7,;x' \
+ -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \
+ sed 'N;N;s,\n, ,g' | { \
+ list=; while read file base inst; do \
+ if test "$$base" = "$$inst"; then list="$$list $$file"; else \
+ echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man7dir)/$$inst'"; \
+ $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man7dir)/$$inst" || exit $$?; \
+ fi; \
+ done; \
+ for i in $$list; do echo "$$i"; done | $(am__base_list) | \
+ while read files; do \
+ test -z "$$files" || { \
+ echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man7dir)'"; \
+ $(INSTALL_DATA) $$files "$(DESTDIR)$(man7dir)" || exit $$?; }; \
+ done; }
+
+uninstall-man7:
+ @$(NORMAL_UNINSTALL)
+ @list=''; test -n "$(man7dir)" || exit 0; \
+ files=`{ for i in $$list; do echo "$$i"; done; \
+ l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
+ sed -n '/\.7[a-z]*$$/p'; \
+ } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^7][0-9a-z]*$$,7,;x' \
+ -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \
+ dir='$(DESTDIR)$(man7dir)'; $(am__uninstall_files_from_dir)
+install-man8: $(man_MANS)
+ @$(NORMAL_INSTALL)
+ @list1=''; \
+ list2='$(man_MANS)'; \
+ test -n "$(man8dir)" \
+ && test -n "`echo $$list1$$list2`" \
+ || exit 0; \
+ echo " $(MKDIR_P) '$(DESTDIR)$(man8dir)'"; \
+ $(MKDIR_P) "$(DESTDIR)$(man8dir)" || exit 1; \
+ { for i in $$list1; do echo "$$i"; done; \
+ if test -n "$$list2"; then \
+ for i in $$list2; do echo "$$i"; done \
+ | sed -n '/\.8[a-z]*$$/p'; \
+ fi; \
+ } | while read p; do \
+ if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
+ echo "$$d$$p"; echo "$$p"; \
+ done | \
+ sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \
+ -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \
+ sed 'N;N;s,\n, ,g' | { \
+ list=; while read file base inst; do \
+ if test "$$base" = "$$inst"; then list="$$list $$file"; else \
+ echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man8dir)/$$inst'"; \
+ $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man8dir)/$$inst" || exit $$?; \
+ fi; \
+ done; \
+ for i in $$list; do echo "$$i"; done | $(am__base_list) | \
+ while read files; do \
+ test -z "$$files" || { \
+ echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man8dir)'"; \
+ $(INSTALL_DATA) $$files "$(DESTDIR)$(man8dir)" || exit $$?; }; \
+ done; }
+
+uninstall-man8:
+ @$(NORMAL_UNINSTALL)
+ @list=''; test -n "$(man8dir)" || exit 0; \
+ files=`{ for i in $$list; do echo "$$i"; done; \
+ l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
+ sed -n '/\.8[a-z]*$$/p'; \
+ } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \
+ -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \
+ dir='$(DESTDIR)$(man8dir)'; $(am__uninstall_files_from_dir)
+tags TAGS:
+
+ctags CTAGS:
+
+cscope cscopelist:
+
+
+distdir: $(DISTFILES)
+ @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
+ topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
+ list='$(DISTFILES)'; \
+ dist_files=`for file in $$list; do echo $$file; done | \
+ sed -e "s|^$$srcdirstrip/||;t" \
+ -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \
+ case $$dist_files in \
+ */*) $(MKDIR_P) `echo "$$dist_files" | \
+ sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \
+ sort -u` ;; \
+ esac; \
+ for file in $$dist_files; do \
+ if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
+ if test -d $$d/$$file; then \
+ dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \
+ if test -d "$(distdir)/$$file"; then \
+ find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
+ fi; \
+ if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
+ cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \
+ find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
+ fi; \
+ cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \
+ else \
+ test -f "$(distdir)/$$file" \
+ || cp -p $$d/$$file "$(distdir)/$$file" \
+ || exit 1; \
+ fi; \
+ done
+check-am: all-am
+check: check-am
+all-am: Makefile $(MANS)
+installdirs:
+ for dir in "$(DESTDIR)$(man1dir)" "$(DESTDIR)$(man7dir)" "$(DESTDIR)$(man8dir)"; do \
+ test -z "$$dir" || $(MKDIR_P) "$$dir"; \
+ done
+install: install-am
+install-exec: install-exec-am
+install-data: install-data-am
+uninstall: uninstall-am
+
+install-am: all-am
+ @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
+
+installcheck: installcheck-am
+install-strip:
+ if test -z '$(STRIP)'; then \
+ $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+ install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+ install; \
+ else \
+ $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
+ install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
+ "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'" install; \
+ fi
+mostlyclean-generic:
+
+clean-generic:
+
+distclean-generic:
+ -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES)
+ -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES)
+
+maintainer-clean-generic:
+ @echo "This command is intended for maintainers to use"
+ @echo "it deletes files that may require special tools to rebuild."
+clean: clean-am
+
+clean-am: clean-generic mostlyclean-am
+
+distclean: distclean-am
+ -rm -f Makefile
+distclean-am: clean-am distclean-generic
+
+dvi: dvi-am
+
+dvi-am:
+
+html: html-am
+
+html-am:
+
+info: info-am
+
+info-am:
+
+install-data-am: install-man
+
+install-dvi: install-dvi-am
+
+install-dvi-am:
+
+install-exec-am:
+
+install-html: install-html-am
+
+install-html-am:
+
+install-info: install-info-am
+
+install-info-am:
+
+install-man: install-man1 install-man7 install-man8
+
+install-pdf: install-pdf-am
+
+install-pdf-am:
+
+install-ps: install-ps-am
+
+install-ps-am:
+
+installcheck-am:
+
+maintainer-clean: maintainer-clean-am
+ -rm -f Makefile
+maintainer-clean-am: distclean-am maintainer-clean-generic
+
+mostlyclean: mostlyclean-am
+
+mostlyclean-am: mostlyclean-generic
+
+pdf: pdf-am
+
+pdf-am:
+
+ps: ps-am
+
+ps-am:
+
+uninstall-am: uninstall-man
+
+uninstall-man: uninstall-man1 uninstall-man7 uninstall-man8
+
+.MAKE: install-am install-strip
+
+.PHONY: all all-am check check-am clean clean-generic cscopelist-am \
+ ctags-am distclean distclean-generic distdir dvi dvi-am html \
+ html-am info info-am install install-am install-data \
+ install-data-am install-dvi install-dvi-am install-exec \
+ install-exec-am install-html install-html-am install-info \
+ install-info-am install-man install-man1 install-man7 \
+ install-man8 install-pdf install-pdf-am install-ps \
+ install-ps-am install-strip installcheck installcheck-am \
+ installdirs maintainer-clean maintainer-clean-generic \
+ mostlyclean mostlyclean-generic pdf pdf-am ps ps-am tags-am \
+ uninstall uninstall-am uninstall-man uninstall-man1 \
+ uninstall-man7 uninstall-man8
+
+.PRECIOUS: Makefile
+
+
+# Tell versions [3.59,3.63) of GNU make to not export all variables.
+# Otherwise a system limit (for SysV at least) may be exceeded.
+.NOEXPORT:
diff --git a/doc/nullmailer-dsn.1 b/doc/nullmailer-dsn.1
new file mode 100644
index 0000000..5a321a1
--- /dev/null
+++ b/doc/nullmailer-dsn.1
@@ -0,0 +1,125 @@
+.TH nullmailer-dsn 1
+.SH NAME
+nullmailer-dsn \- Reformat a queued message into a delivery status notification (DSN)
+.SH SYNOPSIS
+.B nullmailer-dsn
+[
+.B options
+]
+.I status-code
+<
+.I message
+.SH DESCRIPTION
+This program reads a nullmailer queue message from standard input,
+transforms it into a delivery status notification, and writes the result
+to standard output. The output is formatted to be fed into
+.BR nullmailer-queue .
+.P
+All times in the options are expressed as seconds since midnight GMT January 1, 1970 (the UNIX epoch).
+.SH OPTIONS
+.TP
+.BI \-\-diagnostic\-code= STRING
+Sets the actual diagnostic code issued by the mail transport. Must be in the form of
+"\fItype\fR; \fItext\fR", where
+.I type
+would typically be the protocol name, such as
+.BR SMTP .
+This adds a
+.B Diagnostic-Code
+header for each recipient.
+.TP
+.BI \-\-envelope\-id= STRING
+Original envelope ID. Setting this adds a
+.B Original-Envelope-Id
+header to the delivery status section.
+.TP
+.BI \-\-last\-attempt= TIME
+Sets the time of the last attempted delivery. Defaults to the access time of the input message.
+This sets the date in the
+.B Last-Attempt-Date
+header for each recipient.
+.TP
+.BI \-\-max\-lines= COUNT
+Sets the maximum number of lines of the original message to copy into the generated message.
+A value of zero copies only the original header.
+Negative values copy the whole message.
+Defaults to
+.I bouncelines
+below, or zero if that is empty.
+.TP
+.BI \-\-orig\-timestamp= TIME
+Sets the time of the original message. Defaults to the change time of
+the input message. This sets the date in the
+.B Arrival-Date
+header in the delivery status section.
+.TP
+.BI \-\-remote= STRING
+Sets the name of the remote MTA server.
+This adds a
+.B Remote-MTA
+header for each recipient.
+.TP
+.BI \-\-retry\-until= TIME
+Sets the time of the (future) final delivery attempt. No default. This adds a
+.B Will-Retry-Until
+header for each recipient.
+.SH RETURN VALUE
+Exits 0 if it was successful, otherwise it prints a diagnostic message
+to standard error and exits 1.
+.SH CONTROL FILES
+.TP
+.B adminaddr
+If
+.B doublebounceto
+is empty, double bounces are delivered to this address instead.
+If no address is configured, double bounces are not generated.
+.TP
+.B bouncelines
+Sets the maximum number of lines of the original message to copy.
+May be overridden by
+.B \-\-max\-lines
+as above.
+.TP
+.B bounceto
+The address to which all bounces should be sent.
+If it is empty, the original sender address is used.
+.TP
+.B defaultdomain
+The content of this file is appended to any host name that does not
+contain a period (except
+.BR localhost ),
+including
+.I defaulthost
+and
+.IR idhost .
+Defaults to the value of the
+.B me
+control file, if it exists, otherwise the literal name
+.BR defaultdomain .
+.TP
+.B defaulthost
+The content of this file is appended to any address that is missing a
+host name.
+Defaults to the value of the
+.I me
+control file, if it exists, otherwise the literal name
+.BR defaulthost .
+.TP
+.B doublebounceto
+If the original sender was empty (the original message was a delivery
+status or disposition notification), the double bounce is sent to the
+address in this file.
+.TP
+.B idhost
+The content of this file is used when building the message-id string
+for the message.
+Defaults to the canonicalized value of
+.IR defaulthost .
+.TP
+.B me
+The fully-qualified host name of the computer running nullmailer.
+Defaults to the literal name
+.BR me .
+.SH SEE ALSO
+nullmailer-queue(8),
+nullmailer-send(8)
diff --git a/doc/nullmailer-inject.1 b/doc/nullmailer-inject.1
new file mode 100644
index 0000000..6acae7b
--- /dev/null
+++ b/doc/nullmailer-inject.1
@@ -0,0 +1,256 @@
+.TH nullmailer-inject 1
+.SH NAME
+nullmailer-inject \- Reformat and inject a message into the queue.
+.SH SYNOPSIS
+.B nullmailer-inject
+[\-a]
+[\-b]
+[\-e]
+[\-f sender]
+[\-h]
+.I [recipient [recipient ...]]
+.SH DESCRIPTION
+This program reads a email message from standard input, reformats its
+header to comply with RFC822, and sends the resulting message to the
+queue.
+.SS HEADER FIELDS
+The following lines are parsed for recipient addresses:
+.IR To ,
+.IR Cc ,
+.IR Bcc ,
+.IR Apparently-To ,
+.IR Resent-To ,
+.IR Resent-Cc ,
+and
+.IR Resent-Bcc .
+
+The following sender address lines are parsed and rewritten:
+.IR Sender ,
+.IR From ,
+.IR Reply-To ,
+.IR Return-Path ,
+.IR Return-Receipt-To ,
+.IR Errors-To ,
+.IR Resent-Sender ,
+.IR Resent-From ,
+and
+.IR Resent-Reply-To .
+If the
+.I Return-Path
+header field is present and contains a single address, its contents
+will be used to set the envelope sender address.
+
+If the message contains any of the following fields, it is treated as
+a resent message:
+.IR Resent-Sender ,
+.IR Resent-From ,
+.IR Resent-Reply-To ,
+.IR Resent-To ,
+.IR Resent-Cc ,
+.IR Resent-Bcc ,
+.IR Resent-Date ,
+.IR Resent-Message-ID .
+If the message is resent, only the recipient fields prefixed with
+.I Resent-
+are examined for addresses.
+
+Any occurrences of
+.IR Bcc ,
+.IR Resent-Bcc ,
+.IR Return-Path ,
+or
+.I Content-Length
+are discarded after they are parsed (if necessary).
+
+If the header lacks a
+.I Message-Id
+field, a unique string is generated and added to the message.
+If the header lacks a
+.I Date
+field, the current local date and time in RFC822 format is appended to
+the message.
+If the message has no
+.I To
+or
+.I Cc
+fields, the following line is appended to the message:
+
+.EX
+ Cc: recipient list not shown: ;
+.EE
+.SS ADDRESS LISTS
+Address lists are expected to follow the syntax set out in RFC822.
+The following is a simplified explanation of the syntax.
+
+An address list is list of addresses separated by commas.
+An individual address may have one of the following three forms:
+.IR user@fqdn ,
+.IR comment <user@fqdn> ,
+or
+.IR phrase: address-list; .
+Any of the first two forms may be used within the address list of the
+third form.
+Any word containing special characters must be placed in double quotes
+and the special characters must be preceded with a backslash.
+Comments may be placed between addresses in parenthesis.
+All comments are ignored.
+
+Addresses lists are reformatted as they are parsed for ease of later
+re-parsing when the message reaches the destination(s).
+If an address is missing a fqdn,
+.B nullmailer-inject
+adds one.
+.SH OPTIONS
+.TP
+.I \-a
+Use only the command line arguments as recipient addresses.
+Ignore the header recipient lines.
+.TP
+.I \-b
+Use both the command line arguments and data from the message header
+as recipient addresses.
+.TP
+.I \-e
+Use either the command line arguments (if there are any) or data from
+the message header (if there are no arguments) as the recipient
+addresses.
+.TP
+.I \-f sender
+Set the envelope sender address to
+.IR sender .
+.TP
+.I \-h
+Use only data from the message header as the recipient addresses.
+.TP
+.I \-n
+Do not queue the message, but print the reformatted contents to
+standard output.
+.TP
+.I \-v
+Print out the envelope (sender and recipient addresses) preceding the
+message when printing the message to standard output.
+.SH RETURN VALUE
+Exits 0 if it was successful, otherwise it prints a diagnostic message
+to standard error and exits 1.
+.SH ENVIRONMENT
+The environment variable
+.BR NULLMAILER_FLAGS
+is parsed and the behavior of
+.B nullmailer-inject
+is modified if any of the following letters are present:
+.TP
+.B c
+Use "address (comment)" style in the generated
+.B From
+field instead of the default "comment <address>" style.
+.TP
+.B f
+Ignore and remove any
+.B From
+header lines and always insert a generated one.
+.TP
+.B i
+Ignore and remove any
+.B Message-Id
+header lines.
+.TP
+.B s
+Ignore and remove any
+.B Return-Path
+header lines.
+.TP
+.B t
+Insert a
+.BR To
+line containing a list of the recipients if the header does not
+contain either a
+.B To
+or a
+.B Cc
+field.
+If the message is determined to be a resent message (see above), a
+.B Resent-To
+field is added if the header does not contain either a
+.BR Resent-To
+or a
+.BR Resent-Cc
+field.
+.PP
+The user name is set by
+.BR NULLMAILER_USER ,
+.BR MAILUSER ,
+.BR USER ,
+or
+.BR LOGNAME ,
+whichever comes first. If none of the above are set the name is taken
+from the password file, or set to
+.I unknown
+if that fails.
+
+The host name is set by the canonicalized value of
+.BR NULLMAILER_HOST ,
+.BR MAILHOST ,
+or
+.BR HOSTNAME ,
+whichever comes first, or the
+.I defaulthost
+config file if none of the above are set (see below).
+
+The full name of the user is set by
+.BR NULLMAILER_NAME ,
+.BR MAILNAME ,
+or
+.BR NAME ,
+whichever comes first.
+
+The user and host name of the envelope sender default to the user and
+host name set above, but may be overridden by
+.BR NULLMAILER_SUSER
+and
+.BR NULLMAILER_SHOST .
+
+If
+.BR NULLMAILER_QUEUE
+is set, the program named is used in place of
+.B nullmailer-queue
+to queue the formatted message.
+.SH CONTROL FILES
+When reading the following files, a single line is read and stripped
+of all leading and trailing whitespace characters.
+.TP
+.B defaultdomain
+The content of this file is appended to any host name that does not
+contain a period (except
+.BR localhost ),
+including
+.I defaulthost
+and
+.IR idhost .
+Defaults to the value of the
+.B me
+control file, if it exists, otherwise the literal name
+.BR defaultdomain .
+.TP
+.B defaulthost
+The content of this file is appended to any address that is missing a
+host name.
+Defaults to the value of the
+.I me
+control file, if it exists, otherwise the literal name
+.BR defaulthost .
+.TP
+.B idhost
+The content of this file is used when building the message-id string
+for the message.
+Defaults to the canonicalized value of
+.IR defaulthost .
+.TP
+.B me
+The fully-qualified host name of the computer running nullmailer.
+Defaults to the literal name
+.BR me .
+.SH SEE ALSO
+nullmailer-queue(8)
+.SH NOTES
+This document glosses over very many details of how address parsing
+and rewriting actually works (among other things).
diff --git a/doc/nullmailer-queue.8 b/doc/nullmailer-queue.8
new file mode 100644
index 0000000..291ea65
--- /dev/null
+++ b/doc/nullmailer-queue.8
@@ -0,0 +1,53 @@
+.TH nullmailer-queue 8
+.SH NAME
+nullmailer-queue \- insert mail messages into the queue
+.SH SYNOPSIS
+.B nullmailer-queue
+.SH DESCRIPTION
+This program reads a formatted mail message from standard input and
+safely injects it into the outgoing mail queue.
+.PP
+The data sent into standard input is expected to have the following
+format: one line containing the envelope sender, one or more lines
+containing the recipients, a single blank line, and then the contents
+of the message exactly as it is to be transmitted to the destination.
+All lines are terminated with a single line-feed character.
+All addresses must contain a fully-qualified domain name.
+.PP
+.SH RETURN VALUE
+Exits 0 if it successfully queues the message.
+If it failed to queue the message, it exits 1 and prints an error
+message to stdandard output.
+.SH CONTROL FILES
+.TP
+.B adminaddr
+If this file is not empty, all recipients to users at either
+"localhost" (the literal string) or the canonical host name (from the
+.I me
+control file) are remapped to this address.
+This is provided to allow local daemons to be able to send email to
+"somebody@localhost" and have it go somewhere sensible instead of
+being bounced by your relay host. To send to multiple addresses, put
+them all on one line separated by a comma.
+.TP
+.B allmailfrom
+If this file is not empty, its contents will override the envelope
+sender on all messages.
+.SH OTHER FILES
+.TP
+.B /var/spool/nullmailer/queue
+The directory into which the completed messages are moved.
+.TP
+.B /var/spool/nullmailer/tmp
+The directory in which messages are formed temporarily.
+.TP
+.B /var/spool/nullmailer/trigger
+A pipe used to trigger
+.BR nullmailer-send
+to immediately start sending the message from the queue.
+.SH SEE ALSO
+nullmailer-inject(1),
+nullmailer-send(8)
+.SH LIMITATIONS
+This program should enforce system-wide configurable message length
+limits.
diff --git a/doc/nullmailer-send.8 b/doc/nullmailer-send.8
new file mode 100644
index 0000000..34e5f96
--- /dev/null
+++ b/doc/nullmailer-send.8
@@ -0,0 +1,204 @@
+.TH nullmailer-send 8
+.SH NAME
+nullmailer-send \- Send queued messages
+.SH SYNOPSIS
+.B nullmailer-send
+.SH DESCRIPTION
+This program is responsible for coordinating the transmission of
+messages that have been queued by
+.BR nullmailer-queue .
+It uses a variety of protocol modules to deliver the messages from the
+queue to remote "smart" servers.
+.P
+When the program starts, the queue is scanned to build a list of
+messages to send.
+The queue is rescanned when either the trigger is pulled, or after
+.B pausetime
+seconds have elapsed after the last failed delivery.
+When there are no messages in the queue, nullmailer does no rescanning
+until the trigger is pulled.
+Pulling the trigger consists of opening up the trigger named pipe and
+writing a single byte to it, which causes this program to be awakened
+(if it's not already processing the queue).
+This procedure is done by
+.B nullmailer-queue
+to ensure that messages are delivered immediately.
+You can start delivery by hand from the command line like this:
+
+.EX
+ echo 1 > trigger
+.EE
+.P
+Delivery of messages consists of reading the list of remote servers and
+then trying to deliver the messages to these servers as follows.
+For each remote in the list, the named protocol handler is executed once
+for each message remaining in the queue.
+If the protocol handler succeeds, the message is removed from the queue
+and processing continues with the next message.
+If the protocol handler reports a permanent failure
+or the message has been in the queue longer than
+.IR queuelifetime ,
+the message is moved into the
+.B failed
+queue and a bounce message is generated with
+.BR nullmailer-dsn .
+If any messages remain in the queue, processing of the remaining
+messages continues with the next remote.
+When all the remotes have been tried,
+.B nullmailer-send
+sleeps for a number of seconds specified by
+.B pausetime
+before retrying sending the contents of the queue.
+.SH CONTROL FILES
+All the control files are reread each time the queue is run.
+.TP
+.B helohost
+Sets the environment variable
+.B $HELOHOST
+which is used by the SMTP protocol module to set the parameter given to
+the
+.I HELO
+command. Defaults to the value of the
+.B me
+configuration file.
+.TP
+.B maxpause
+The maximum time to pause between successive queue runs, in seconds.
+Defaults to 24 hours
+.RB ( 86400 ).
+.TP
+.B pausetime
+The minimum time to pause between successive queue runs
+when there are messages in the queue, in seconds.
+Defaults to 1 minute
+.RB ( 60 ).
+Each time this timeout is reached, the timeout is doubled to a maximum
+of
+.BR maxpause .
+After new messages are injected, the timeout is reset.
+If this is set to
+.BR 0 ,
+nullmailer-send will exit immediately after going through the queue once
+(one-shot mode).
+.TP
+.B queuelifetime
+The maximum time a message is allowed to live in the queue before being
+considered permanently failed, in seconds. Defaults to 7 days
+.RB ( 604800 ).
+.TP
+.B remotes
+This file contains a list of remote servers to which to send each
+message.
+Each line of this file contains a remote host name or address followed
+by an optional protocol string, separated by white space.
+The protocol name defaults to
+.BR smtp ,
+and may be followed by additional options for that module.
+See the "PROTOCOL OPTIONS" section for a list of the available options.
+The options may optionally be prefixed by
+.I --
+but this is not required.
+The line is parsed according to standard shell quoting rules.
+For example, to connect to port 2525 on your SMTP smart host,
+which also requires SMTP authentication, and initiate TLS with
+STARTTLS, use:
+
+.EX
+ smarthost.dom smtp port=2525 starttls user=user pass='my pass phrase'
+.EE
+
+Blank lines and lines starting with a pound (\fI#\fR) are ignored.
+.TP
+.B sendtimeout
+The time to wait for a remote module listed above to complete sending a
+message before killing it and trying again, in seconds.
+Defaults to 1 hour
+.RB ( 3600 ).
+If this is set to
+.BR 0 ,
+.B nullmailer-send
+will wait forever for messages to complete sending.
+.SH "PROTOCOL OPTIONS"
+.TP
+.B port=\fIPORT
+Set an alternate port number to connect to on the remote host. For example, SMTP may use
+.B port=587
+for the alternate SMTP "submission" port.
+.TP
+.B user=\fIUSERNAME
+Set the SMTP authentication user name.
+.TP
+.B pass=\fIPASSWORD
+Set the SMTP authentication password.
+.TP
+.BI source= HOSTNAME
+Set the source address for connections to the remote host.
+.TP
+.B auth-login
+Force SMTP "AUTH LOGIN" mode instead of auto-detecting.
+.TP
+.B tls
+Connect using TLS.
+This will automatically switch the default port to
+.BR 465 .
+.TP
+.B ssl
+Alias for the
+.B tls
+option for compatibility.
+.TP
+.B starttls
+Use the
+.B STARTTLS
+command to initiate a TLS session.
+.TP
+.B x509certfile=\fIFILENAME
+Set the filename for a TLS client certificate to send to the server.
+.TP
+.B x509keyfile=\fIFILENAME
+Set the filename for the private key for a TLS client certificate.
+Defaults to the same file name as
+.BR x509certfile .
+.TP
+.B x509cafile=\fIFILENAME
+Set the TLS certificate authority trust filename. Defaults to
+.BR /etc/ssl/certs/ca-certificates.crt .
+.TP
+.B x509crlfile=\fIFILENAME
+Set the TLS certificate revocation list filename.
+.TP
+.B x509fmtder
+Specify that TLS X.509 files above are in DER format instead of PEM.
+.TP
+.B insecure
+Don't abort a TLS connection if the server certificate fails validation.
+Use this only if you know the server uses an invalid certificate.
+.TP
+.B tls-anon-auth
+Use TLS anonymous authentication - replacing certificate authentication.
+This means no external certificates or passwords are needed to set up the connection.
+With this option your connection is vulnerable to man-in-the-middle (active or redirection) attacks.
+However, the data are integrity protected and encrypted from passive eavesdroppers.
+This option must be used with the insecure option - to acknowledge that you know what you are doing.
+.SH FILES
+.TP
+.B /var/spool/nullmailer/failed
+The failed message queue.
+.TP
+.B /var/spool/nullmailer/queue
+The outgoing message queue.
+.TP
+.B /var/spool/nullmailer/trigger
+A trigger file to cause immediate delivery.
+.TP
+.B /usr/local/etc/nullmailer
+The configuration directory.
+.TP
+.B /usr/local/libexec/nullmailer
+The protocol program directory.
+.SH SEE ALSO
+nullmailer-dsn(1),
+nullmailer-inject(1),
+nullmailer-queue(8),
+mailq(1)
+http://www.postfix.org/TLS_README.html on how to setup a certificate-less Postfix SMTP server
diff --git a/doc/nullmailer.7 b/doc/nullmailer.7
new file mode 100644
index 0000000..6ccb524
--- /dev/null
+++ b/doc/nullmailer.7
@@ -0,0 +1,37 @@
+.TH nullmailer 7
+.SH NAME
+nullmailer \- Overview of nullmailer documentation
+.SH INTRODUCTION
+.B nullmailer
+is a simple and secure relay-only mail transport agent.
+.P
+Documentation on how messages are reformatted and injected into the
+queue can be found in
+.BR nullmailer-inject (1).
+Documentation on how messages are actually inserted into the queue can
+be found in
+.BR nullmailer-queue (8).
+The process of sending queued messages is described in
+.BR nullmailer-send (8).
+.P
+The following table lists all the control files used by
+.BR nullmailer .
+.P
+.RS
+.nf
+.ta 5c
+control file used by
+.I adminaddr \fBnullmailer-dsn\fR, \fBnullmailer-queue
+.I allmailfrom \fBnullmailer-queue
+.I defaultdomain \fBnullmailer-dsn\fR, \fBnullmailer-inject
+.I defaulthost \fBnullmailer-dsn\fR, \fBnullmailer-inject
+.I doublebounceto \fBnullmailer-dsn
+.I helohost \fBnullmailer-send
+.I idhost \fBnullmailer-dsn\fR, \fBnullmailer-inject
+.I maxpause \fBnullmailer-send
+.I me \fBnullmailer-dsn\fR, \fBnullmailer-inject
+.I pausetime \fBnullmailer-send
+.I remotes \fBnullmailer-send
+.I sendtimeout \fBnullmailer-send
+.fi
+.RE
diff --git a/doc/sendmail.1 b/doc/sendmail.1
new file mode 100644
index 0000000..705034f
--- /dev/null
+++ b/doc/sendmail.1
@@ -0,0 +1,93 @@
+.TH sendmail 1
+.SH NAME
+sendmail \- sendmail emulator interface for nullmailer
+.SH SYNOPSIS
+.B sendmail
+[
+.B flags
+] [
+.I recipients
+] <
+.I message
+.SH DESCRIPTION
+This program is a front end program for
+.B nullmailer-inject
+and
+.BR nullmailer-smtpd .
+It is used by programs that expect a
+.I sendmail
+interface for sending email.
+After parsing the command-line arguments, this program executes either
+.B nullmailer-inject
+or
+.B nullmailer-smtpd
+depending on the presence of the
+.I \-bs
+option on the command-line.
+See the documentation for
+.B nullmailer-inject
+for details on how messages are reformatted and queued.
+.SH OPTIONS
+.TP
+.B \-B TYPE
+.TP
+.B \-C FILE
+.TP
+.B \-d DEBUG
+.TP
+.B \-h COUNT
+.TP
+.B \-i
+.TP
+.B \-L TAG
+.TP
+.B \-N DSN
+.TP
+.B \-n
+.TP
+.B \-O OPTION
+.TP
+.B \-o OPTION
+.TP
+.B \-p PROTOCOL
+.TP
+.B \-q TIME
+.TP
+.B \-R RETURN
+.TP
+.B \-U
+.TP
+.B \-V ENVID
+.TP
+.B \-v
+.TP
+.B \-X LOGFILE
+Ignored for compatibility
+.TP
+.B \-bm
+Read mail from standard input (default).
+.TP
+.B \-bp
+List information about mail queue. This executes
+.BR mailq .
+.TP
+.B \-bs
+Use the SMTP protocol on standard input and standard output. This
+executes
+.BR nullmailer-smtpd .
+.TP
+.B \-F ADDRESS
+Sets the full name of the sender.
+.TP
+.B \-f ADDRESS
+Sets the envelope sender address.
+.TP
+.B \-r ADDRESS
+An alternate and obsolete form of the \-f flag.
+.TP
+.B \-t
+Read message for recipients and ignore the command-line arguments.
+.SH SEE ALSO
+mailq(1),
+nullmailer-inject(1),
+nullmailer-smtpd(1)