'\" t
.\"     Title: dbmail-sievecmd
.\"    Author: Alan Hicks <ahicks@p-o.co.uk>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 08/28/2026
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "DBMAIL\-SIEVECMD" "8" "08/28/2026" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
dbmail-sievecmd \- manipulates Sieve scripts in DBMail\&.
.SH "SYNOPSIS"
.sp
.nf
dbmail\-sievecmd [common options] \-u username \-\-list
dbmail\-sievecmd [common options] \-u username \-\-activate scriptname
dbmail\-sievecmd [common options] \-u username \-\-deactivate scriptname
dbmail\-sievecmd [common options] \-u username \-\-show scriptname
dbmail\-sievecmd [common options] \-u username \-\-import file
dbmail\-sievecmd [common options] \-u username \-\-edit scriptname
dbmail\-sievecmd [common options] \-u username \-\-remove scriptname
.fi
.SH "DESCRIPTION"
.sp
DBMail stores Sieve scripts in DBMail\&. These scripts are used to sort incoming mail for the email users\&. Each user has their own script space and may upload scripts to the dbmail\-sieved(8) daemon\&. The dbmail\-sievecmd(8) utility provides a convenient method for the system administrator to work with Sieve scripts from the command line\&.
.SH "OPTIONS"
.PP
\-u, \-\-user username
.RS 4
Specify the user whose scripts we will be modifying\&.
.RE
.PP
\-l, \-\-list
.RS 4
List scripts belonging to user
.RE
.PP
\-a, \-\-activate scriptname
.RS 4
Activates scriptname, deactivating all other scripts\&.
.RE
.PP
\-d, \-\-deactivate scriptname
.RS 4
Deactivates scriptname if it was active\&.
.RE
.PP
\-c, \-\-show scriptname
.RS 4
Show the named script\&.
.RE
.PP
\-i, \-\-import scriptname < file
.RS 4
Creates a script called scriptname by importing file\&.
.RE
.PP
\-e, \-\-edit scriptname
.RS 4
Edit the contents of the named script

(if no script is given, the active script is displayed)
.RE
.PP
\-r, \-\-remove scriptname
.RS 4
Remove the named script\&. If the script was active, no script will be active after it is deleted\&.
.RE
.SH "COMMON OPTIONS"
.PP
\-f, \-\-config configfile
.RS 4
Specify an alternate config file\&.

Use dbmail\-<utility> \-\-help to show the default location\&.
.RE
.PP
\-q, \-\-quiet
.RS 4
Quietly skip interactive prompts and helpful status messages which would otherwise be printed to stdout\&. Use two \-q\(cqs to silence errors which would otherwise be printed to stderr\&.
.RE
.PP
\-v, \-\-verbose
.RS 4
Operate verbosely\&. Some of the utilities in the DBMail suite can take two \-v\(cqs for extra verbosity\&. Those which don\(cqt understand this convention won\(cqt complain about having the extra \-v and will simply operate at their normal verbosity\&.
.RE
.PP
\-V, \-\-version
.RS 4
Show the version and copyright, then exit\&.
.RE
.PP
\-h, \-\-help
.RS 4
Show a brief summary of options, then exit\&.
.RE
.SH "SEE ALSO"
.sp
dbmail(1), dbmail\&.conf(5), dbmail\-deliver(1), dbmail\-export(8), dbmail\-httpd(8), dbmail\-imapd(8), dbmail\-lmtpd(8), dbmail\-pop3d(8), dbmail\-sieved(8), dbmail\-sievecmd(8), dbmail\-users(8), dbmail\-util(8)
.SH "BUGS"
.sp
For the latest announcements, please subscribe to the \m[blue]\fBDBMail announce mailing list\fR\m[]\&\s-2\u[1]\d\s+2
.sp
For general discussion, please subscribe to the \m[blue]\fBDBMail general mailing list\fR\m[]\&\s-2\u[2]\d\s+2
.sp
If you experience an issue with DBMail, please report it on the \m[blue]\fBDBMail Bug Tracker\fR\m[]\&\s-2\u[3]\d\s+2\&. It may be helpful to have a debug log available\&.
.SH "LICENSE"
.sp
DBMail and its components are distributed under the terms of the GNU General Public License Version 2\&. Copyrights are held variously by the authors listed below\&.
.SH "AUTHOR(S)"
.sp
DBMail is a collaborative effort among the core developers listed below and the tremendous help of the testers, patchers and bug hunters listed in the AUTHORS and THANKS files found in the DBMail source distribution\&.
.sp
.if n \{\
.RS 4
.\}
.nf
Alan Hicks          Persistent Objects Ltd https://p\-o\&.co\&.uk
Eelco van Beek      Aaron Stone            Paul J Stevens
Roel Rozendaal      Open Source Engineer   NFG Net Facilities Group BV
Ilja Booij          Palo Alto, CA USA      http://www\&.nfg\&.nl
IC&S                                       http://www\&.ic\-s\&.nl
.fi
.if n \{\
.RE
.\}
.SH "AUTHOR"
.PP
\fBAlan Hicks\fR <\&ahicks@p\-o\&.co\&.uk\&>
.RS 4
Author.
.RE
.SH "NOTES"
.IP " 1." 4
DBMail announce mailing list
.RS 4
\%https://dbmail.org/wws/info/dbmail-announce/
.RE
.IP " 2." 4
DBMail general mailing list
.RS 4
\%https://dbmail.org/wws/info/dbmail-general/
.RE
.IP " 3." 4
DBMail Bug Tracker
.RS 4
\%https://github.com/dbmail/dbmail/issues
.RE