1 <?xml version="1.0" encoding="utf-8"?>
3 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V4.4//EN"
4 "file:///usr/share/xml/docbook/schema/dtd/4.4/docbookx.dtd"
11 <email>shuber@sthu.org</email>
14 <firstname>Stefan</firstname>
15 <surname>Huber</surname>
17 <date>2015-09-27</date>
21 <refentrytitle>smailq</refentrytitle>
22 <manvolnum>1</manvolnum>
23 <refmiscinfo>smailq 1.2</refmiscinfo>
27 <refname><application>smailq</application></refname>
28 <refpurpose>A simple mail queue.</refpurpose>
33 <command>smailq</command>
34 <option>--send</option>
35 <arg rep="repeat"><replaceable>recipient</replaceable></arg>
37 <arg rep="repeat"><replaceable>MSA options</replaceable></arg>
40 <command>smailq</command>
41 <option>--list</option>
44 <command>smailq</command>
45 <option>--deliver-all</option>
48 <command>smailq</command>
49 <option>--deliver</option>
50 <arg rep="repeat"><replaceable>ID</replaceable></arg>
53 <command>smailq</command>
54 <option>--delete</option>
55 <arg rep="repeat"><replaceable>ID</replaceable></arg>
58 <command>smailq</command>
59 <option>--help</option>
62 <command>smailq</command>
63 <option>--version</option>
68 <title>DESCRIPTION</title>
71 <command>smailq</command> is a mail queue for lightweight SMTP
72 clients (MSAs) like msmtp that do not provide a queue. It basically
73 provides the functionality of sendmail and mailq.
77 When <command>smailq</command> sends a mail it first inserts the
78 mail into the message queue and then attempts to deliver all mails
79 in the queue using an external MSA such as msmtp.
85 <title>COMMANDS</title>
90 <term><option>--delete</option></term>
92 <para>Remove the mails with given IDs from the queue.</para>
97 <term><option>--deliver</option></term>
99 <para>Attempt to deliver the mails with given IDs only.</para>
104 <term><option>--deliver-all</option></term>
106 <para>Attempt to deliver all mails in the queue.</para>
111 <term><option>-h</option></term>
112 <term><option>--help</option></term>
114 <para>Print usage text.</para>
119 <term><option>--list</option></term>
121 <para>List all mails in the queue. This is the default.</para>
126 <term><option>--send</option></term>
128 <para>Read a mail from stdin, insert it into the queue, and
129 attempt to deliver all mails in the queue. Options after
130 "--" are passed forward to the MSA for this particular
136 <term><option>-V</option></term>
137 <term><option>--version</option></term>
139 <para>Show version info.</para>
148 <title>OPTIONS</title>
153 <term><option>-C</option></term>
154 <term><option>--config FILE</option></term>
156 <para>Use the given configuration file instead of
157 "$HOME/.smailq.conf".</para>
162 <term><option>-q</option></term>
163 <term><option>--quiet</option></term>
165 <para>Do not print info messages.</para>
170 <term><option>-v</option></term>
171 <term><option>--verbose</option></term>
173 <para>Increase output verbosity.</para>
181 <title>CONFIGURATION FILES</title>
184 By default, <command>smailq</command> looks at $HOME/.smailq.conf
185 and /etc/smailq.conf (in that order) for a configuration file,
186 unless the configuration file is explicitly specified by an option.
187 The syntax follows RFC 822. A sample configuration file contains
193 # Optional: The directory where the log file is written to. The special
194 # value 'syslog' causes smailq to log to syslog.
195 logdir = ~/.smailq/log/
196 # Optional: The directory where smailq saves the mail queue data
197 datadir = ~/.smailq/data/
199 # Settings for the network (TCP) connectivity test
201 # Optional: The host to connect to
202 host = www.google.com
203 # Optional: The port to connect to
205 # Optional: The timeout
208 # Settings concerning the mail submission agent
210 # This command is called when smailq attempts to deliver a mail. The
211 # MSA-options passed to smailq are appended to this line.
219 Bug reports to Stefan Huber <email>shuber@sthu.org</email>.
223 <title>AUTHOR</title>
227 <firstname>Stefan</firstname>
228 <surname>Huber</surname>
229 <contrib>Original author</contrib>
230 <email>shuber@sthu.org</email>