amavisd-release.8   [plain text]


.\" -*- nroff -*-
.TH AMAVISD-RELEASE 8 amavisd-release
.\" 
.\" # This is amavisd-release, an EXAMPLE quarantine release utility program.
.\" # It uses AM.PDP protocol to send a request to amavisd daemon to release
.\" # a quarantined mail message.
.\" #
.\" # Usage:
.\" #   amavisd-release mail_file secret_id [alt_recip1 alt_recip2 ..]
.\" #
.\" # To be placed in amavisd.conf:
.\" #   $interface_policy{'SOCK'} = 'AM.PDP';
.\" #   $policy_bank{'AM.PDP'} = {protocol=>'AM.PDP'};
.\" #   $unix_socketname='/var/amavis/amavisd.sock';
.\" #or:
.\" #   $interface_policy{'9998'} = 'AM.PDP';
.\" #   $policy_bank{'AM.PDP'} = {protocol=>'AM.PDP'};
.\" #   $inet_socket_port = [10024,9998];
.\" #
.\" # To obtain secret_id and quar_type belonging to some mail_id:
.\" # $ mysql mail_log -e \
.\" #   'select secret_id,quar_type,content from msgs where mail_id="W+7uJyXUjw32"'
.\" #
.\" # If secret_id is not available, administrator may choose to skip checking
.\" # of secret_id in the amavisd daemon by setting a configuration variable
.\" # $auth_required_release to false (it defaults to true). If the release
.\" # client program specifies a nonempty secret_id in the request, the secret_id
.\" # will be validated and a request will fail if not valid, regardless of the
.\" # setting of $auth_required_release. Turning off a requirement for a valid
.\" # secret_id widens the right to release to anyone who can connect to amavisd
.\" # socket (Unix or inet). Access to the socket therefore needs to be restricted
.\" # using socket protection (unix socket) or @inet_acl (for inet socket).
.\" #
.\" # Author: Mark Martinec <mark.martinec@ijs.si>
.\" # Copyright (C) 2004  Mark Martinec,  All Rights Reserved.
.\" #
.\" # Redistribution and use in source and binary forms, with or without
.\" # modification, are permitted provided that the following conditions are met:
.\" #
.\" # * Redistributions of source code must retain the above copyright notice,
.\" #   this list of conditions and the following disclaimer.
.\" # * Redistributions in binary form must reproduce the above copyright notice,
.\" #   this list of conditions and the following disclaimer in the documentation
.\" #   and/or other materials provided with the distribution.
.\" # * Neither the name of the author, nor the name of the "Jozef Stefan"
.\" #   Institute, nor the names of contributors may be used to endorse or
.\" #   promote products derived from this software without specific prior
.\" #   written permission.
.\" #
.\" # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
.\" # "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
.\" # LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
.\" # PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER
.\" # OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
.\" # EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
.\" # PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
.\" # OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
.\" # WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
.\" # OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF
.\" # ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\" #
.\" #(the license above is the new BSD license, and pertains to this program only)
.\" #
.\" # Patches and problem reports are welcome.
.\" # The latest version of this program is available at:
.\" #   http://www.ijs.si/software/amavisd/
.\" 
.\" $Id: amavisd-release.8,v 1.1 2006/07/19 22:29:05 dasenbro Exp $
.SH NAME
amavisd-release \- Amavisd release
.SH SYNOPSIS
.B amavisd-release
.SH DESCRIPTION
This is
.I amavisd-release
which is an EXAMPLE quarantine release utility program.  It uses AM.PDP protocol
to send a request to amavisd daemon to release a quarantined mail message.

Usage:
   amavisd-release mail_file secret_id [alt_recip1 alt_recip2 ..]
.PP
.SH OPTIONS
.TP
.BI " Debug"
Debug option.
.SH FILES
.TP
.B N/A
.SH SEE ALSO
.PP
\fB\fR