
##############
**sieveshell**
##############

.. highlight:: perl


.. DO NOT EDIT sieveshell.rst: Autogenerated by tools/perl2rst from perl/sieve/scripts/sieveshell.pl

.. cyrusman:: sieveshell(1)

.. _imap-reference-manpages-usercommands-sieveshell:

****
NAME
****


sieveshell - remotely manipulate sieve scripts


********
SYNOPSIS
********


sieveshell [\ **--user**\ =\ *user*\ ] [\ **--authname**\ =\ *authname*\ ]
[\ **--realm**\ =\ *realm*\ ] [\ **--exec**\ =\ *script*\ ] \ *server*\ [\ **:**\ \ *port*\ ]

sieveshell \ **--help**\ 


***********
DESCRIPTION
***********


\ **sieveshell**\  allows users to manipulate their scripts on a remote
server.  It works via MANAGESIEVE, a work in progress.

The following commands are recognized:


\ **list**\  list scripts on server.

\ **put**\  <filename> upload script to server.

\ **get**\  <name> [<filename>] get script. if no filename display to stdout

\ **delete**\  <name> delete script.

\ **activate**\  <name> activate script.

\ **deactivate**\  deactivate all scripts.


*******
OPTIONS
*******



\ **-u**\  \ *user*\ , \ **--user**\ =\ *user*\ 
 
 The authorization name to request; by default, derived from the
 authentication credentials.
 


\ **-a**\  \ *authname*\ , \ **--authname**\ =\ *authname*\ 
 
 The user to use for authentication (defaults to current user).
 


\ **-r**\  \ *realm*\ , \ **--realm**\ =\ *realm*\ 
 
 The realm to attempt authentication in.
 


\ **-e**\  \ *script*\ , \ **--exec**\ =\ *script*\ 
 
 Instead of working interactively, run commands from \ *script*\ , and
 exit when done.
 



**********
REFERENCES
**********


[MANAGESIEVE] Martin, T.; "A Protocol for Remotely Managing Sieve
Scripts", draft-ietf-managesieve-03.txt, Mirapoint, Inc.; May 2001,
work in progress.


******
AUTHOR
******


Tim Martin <tmartin@mirapoint.com>, and the rest of the Cyrus
team.

