view release on metacpan or  search on metacpan

spamc/spamc.pod  view on Meta::CPAN

Just output the SpamAssassin report text to stdout, for all messages.
See B<-r> for details of the output format used.

=item B<-s> I<max_size>, B<--max-size>=I<max_size>

Set the maximum message size which will be sent to spamd -- any bigger than
this threshold and the message will be returned unprocessed (default: 500 KB).
If spamc gets handed a message bigger than this, it won't be passed to spamd.
The maximum message size is 256 MB.

The size is specified in bytes, as a positive integer greater than 0.
For example, B<-s 500000>. 

=item B<--connect-retries>=I<retries>

Retry connecting to spamd I<retries> times.  The default is 3 times.

=item B<--retry-sleep>=I<sleep>

Sleep for I<sleep> seconds between attempts to connect to spamd.
The default is 1 second.

=item B<--filter-retries>=I<retries>

Retry filtering I<retries> times if the spamd process fails (usually times
out).  This differs from B<--connect-retries> in that it times out the
transaction after the TCP connection has been established successfully.
The default is 1 time (ie. one attempt and no retries).

=item B<--filter-retry-sleep>=I<sleep>

Sleep for I<sleep> seconds between failed spamd filtering attempts.
The default is 1 second.

=item B<-S>, B<--ssl>

If spamc was built with support for SSL, encrypt data to and from the
spamd process with SSL; spamd must support SSL as well.

=item B<--ssl-cert>=I<certfile>

Authenticate to spamd server with a SSL client certificate.  Specify the
certificate file to use.

=item B<--ssl-key>=I<keyfile>

Authenticate to spamd server with a SSL client certificate.  Specify the
certificate key file to use.

=item B<--ssl-ca-file>=I<cafile>

Use the specified Certificate Authority certificate to verify the server
certificate.  The server certificate must be signed by this certificate.

=item B<--ssl-ca-path>=I<capath>

Use the Certificate Authority certificate files in the specified set of
directories to verify the server certificate.  The server certificate must
be signed by one of these Certificate Authorities.  See the man page for
B<IO::Socket::SSL> for additional details.

=item B<-t> I<timeout>, B<--timeout>=I<timeout>

Set the timeout for spamc-to-spamd communications (default: 600, 0 disables).
If spamd takes longer than this many seconds to reply to a message, spamc 
will abort the connection and treat this as a failure to connect; in other 
words the message will be returned unprocessed.  

=item B<-n> I<timeout>, B<--connect-timeout>=I<timeout>

Set the timeout for spamc-to-spamd connection establishment (default: 600, 0
disables). If spamc takes longer than this many seconds to establish a
connection to spamd, spamc will abort the connection and treat this as a
failure to connect; in other words the message will be returned unprocessed.  

=item B<-u> I<username>, B<--username>=I<username>

To have spamd use per-user-config files, run spamc as the user whose config
files spamd should load; by default the effective user-ID is sent to spamd.  If
you're running spamc as some other user, though, (eg. root, mail, nobody,
cyrus, etc.) then you may use this flag to override the default.

=item B<-U> I<socketpath>, B<--socket>=I<path>

Connect to C<spamd> via UNIX domain socket I<socketpath> instead of a
TCP/IP connection.

This option is not supported on Win32 platforms.

=item B<-V>, B<--version>

Report the version of this C<spamc> client.  If built with SSL support,
an additional line will be included noting this, like so:

  SpamAssassin Client version 3.0.0-rc4
    compiled with SSL support (OpenSSL 0.9.7d 17 Mar 2004)

=item B<-x>, B<--no-safe-fallback>

Disables the 'safe fallback' error-recovery method, which passes through the
unaltered message if an error occurs.  Instead, exit with an error code, and
let the MTA queue up the mails for a retry later.  See also L<"EXIT CODES">.

This also disables the TCP fail-over behaviour from B<-d>.

=item B<-X>, B<--unavailable-tempfail>

When disabling 'safe fallback' with B<-x>, this option will turn EX_UNAVAILABLE
errors into EX_TEMPFAIL. This may allow your MTA to defer mails with a 
temporary SMTP error instead of bouncing them with a permanent SMTP error. 
See also L<"EXIT CODES">.

=item B<-y>, B<--tests>

Just output the names of the tests hit to stdout, on one line, separated
by commas.

=item B<-K>

Perform a keep-alive check of spamd, instead of a full message check.