dovecot-2.2: man: Added doveadm-exec.1.
dovecot at dovecot.org
dovecot at dovecot.org
Mon Aug 5 19:08:38 EEST 2013
details: http://hg.dovecot.org/dovecot-2.2/rev/d3e554bccf68
changeset: 16649:d3e554bccf68
user: Pascal Volk <user at localhost.localdomain.org>
date: Mon Aug 05 15:52:52 2013 +0000
description:
man: Added doveadm-exec.1.
diffstat:
.hgignore | 2 +-
doc/man/Makefile.am | 4 +++-
doc/man/doveadm-exec.1.in | 47 +++++++++++++++++++++++++++++++++++++++++++++++
doc/man/doveadm.1.in | 7 ++++++-
doc/man/sed.sh | 5 ++++-
5 files changed, 61 insertions(+), 4 deletions(-)
diffs (129 lines):
diff -r 692c1797a8c9 -r d3e554bccf68 .hgignore
--- a/.hgignore Mon Aug 05 17:38:13 2013 +0300
+++ b/.hgignore Mon Aug 05 15:52:52 2013 +0000
@@ -105,5 +105,5 @@
syntax: regexp
src/.*/test-[^\.]*$
-doc/man/doveadm-(altmove|auth|deduplicate|director|dump|expunge|fetch|flags|import|instance|index|force-resync|help|kick|log|mailbox|mount|move|penalty|purge|pw|quota|search|user|who)\.1$
+doc/man/doveadm-(altmove|auth|deduplicate|director|dump|exec|expunge|fetch|flags|import|instance|index|force-resync|help|kick|log|mailbox|mount|move|penalty|purge|pw|quota|search|user|who)\.1$
doc/man/(doveadm|doveconf|dovecot-lda|dovecot|dsync)\.1$
diff -r 692c1797a8c9 -r d3e554bccf68 doc/man/Makefile.am
--- a/doc/man/Makefile.am Mon Aug 05 17:38:13 2013 +0300
+++ b/doc/man/Makefile.am Mon Aug 05 15:52:52 2013 +0000
@@ -18,6 +18,7 @@
doveadm-deduplicate.1 \
doveadm-director.1 \
doveadm-dump.1 \
+ doveadm-exec.1 \
doveadm-expunge.1 \
doveadm-fetch.1 \
doveadm-flags.1 \
@@ -58,6 +59,7 @@
doveadm-deduplicate.1.in \
doveadm-director.1.in \
doveadm-dump.1.in \
+ doveadm-exec.1.in \
doveadm-expunge.1.in \
doveadm-fetch.1.in \
doveadm-flags.1.in \
@@ -89,4 +91,4 @@
.1.in.1: $(man_includefiles) Makefile
$(SHELL) $(srcdir)/sed.sh $(srcdir) $(rundir) $(pkgsysconfdir) \
- < $< > $@
+ $(pkglibexecdir) < $< > $@
diff -r 692c1797a8c9 -r d3e554bccf68 doc/man/doveadm-exec.1.in
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/man/doveadm-exec.1.in Mon Aug 05 15:52:52 2013 +0000
@@ -0,0 +1,47 @@
+.\" Copyright (c) 2013 Dovecot authors, see the included COPYING file
+.TH DOVEADM\-EXEC 1 "2013-08-05" "Dovecot v2.2" "Dovecot"
+.SH NAME
+doveadm\-exec \- easily execute commands from Dovecot\(aqs libexec_dir
+.\"------------------------------------------------------------------------
+.SH SYNOPSIS
+.BR doveadm " [" \-Dv "] " exec
+.IR binary " [" "binary arguments" ]
+.\"------------------------------------------------------------------------
+.SH DESCRIPTION
+This command allows administrators and local users to simply execute
+commands from within
+.IR libexec_dir .
+So for example a logged in system user could start a pre\-authenticated
+imap session, using the command:
+.BR "doveadm exec imap" .
+An administrator would use the command:
+.B "doveadm exec imap \-u"
+.IR username .
+.\"------------------------------------------------------------------------
+ at INCLUDE:global-options@
+.\"------------------------------------------------------------------------
+.SH ARGUMENTS
+.TP
+.I binary
+the name of an executable located in
+.IR @pkglibexecdir@ .
+.\"-------------------------------------
+.TP
+.I binary arguments
+options and arguments, wich will be passed through to the
+.IR binary .
+.\"------------------------------------------------------------------------
+.SH EXAMPLE
+This example demonstrates how to deliver a message from a file to a
+user\(aqs mailbox.
+.sp
+.nf
+.B doveadm exec dovecot\-lda \-d user at example.net \(rs
+.B \-f admin at example.net < \(ti/stuff/welcome.msg
+.fi
+.\"------------------------------------------------------------------------
+ at INCLUDE:reporting-bugs@
+.\"------------------------------------------------------------------------
+.SH SEE ALSO
+.BR doveadm (1),
+.BR dovecot\-lda (1)
\ No newline at end of file
diff -r 692c1797a8c9 -r d3e554bccf68 doc/man/doveadm.1.in
--- a/doc/man/doveadm.1.in Mon Aug 05 17:38:13 2013 +0300
+++ b/doc/man/doveadm.1.in Mon Aug 05 15:52:52 2013 +0000
@@ -1,5 +1,5 @@
.\" Copyright (c) 2010-2013 Dovecot authors, see the included COPYING file
-.TH DOVEADM 1 "2013-08-02" "Dovecot v2.2" "Dovecot"
+.TH DOVEADM 1 "2013-08-05" "Dovecot v2.2" "Dovecot"
.SH NAME
doveadm \- Dovecot\(aqs administration utility
.\"------------------------------------------------------------------------
@@ -44,6 +44,11 @@
Manage Dovecot directors (if used by proxy servers).
.\"-------------------------------------
.TP
+.B doveadm exec
+.BR doveadm\-exec (1),
+Easily execute commands from Dovecot\(aqs libexec_dir.
+.\"-------------------------------------
+.TP
.B doveadm instance
.BR doveadm\-instance (1),
Manage the list of running Dovecot instances.
diff -r 692c1797a8c9 -r d3e554bccf68 doc/man/sed.sh
--- a/doc/man/sed.sh Mon Aug 05 17:38:13 2013 +0300
+++ b/doc/man/sed.sh Mon Aug 05 15:52:52 2013 +0000
@@ -3,6 +3,7 @@
SRCDIR="${1:-`pwd`}"
RUNDIR="${2:-/usr/local/var/run/dovecot}"
PKGSYSCONFDIR="${3:-/usr/local/etc/dovecot}"
+PKGLIBEXECDIR="${4:-/usr/local/libexec/dovecot}"
sed -e "/^@INCLUDE:global-options@$/{
r ${SRCDIR}/global-options.inc
@@ -27,5 +28,7 @@
-e "/^@INCLUDE:reporting-bugs@$/{
r ${SRCDIR}/reporting-bugs.inc
d
- }" | sed -e "s|@pkgsysconfdir@|${PKGSYSCONFDIR}|" -e "s|@rundir@|${RUNDIR}|"
+ }" | sed -e "s|@pkgsysconfdir@|${PKGSYSCONFDIR}|" \
+ -e "s|@rundir@|${RUNDIR}|" \
+ -e "s|@pkglibexecdir@|${PKGLIBEXECDIR}|"
More information about the dovecot-cvs
mailing list