Package: dovecot-common
Version: 1:1.0.15-2
Severity: minor
Tags: patch

Hi,

Currently, there is no manpage for the small utility "dovecotpw". Here
is one :-)

Cheers,
 Xavier


-- System Information:
Debian Release: lenny/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (500, 'testing'), (500, 'stable')
Architecture: i386 (i686)

Kernel: Linux 2.6.26-1-686 (SMP w/1 CPU core)
Locale: LANG=fr_BE.UTF-8, LC_CTYPE=fr_BE.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages dovecot-common depends on:
ii  adduser               3.110              add and remove users and groups
ii  libc6                 2.7-15             GNU C Library: Shared libraries
ii  libcomerr2            1.41.3-1           common error description library
ii  libkrb53              1.6.dfsg.4~beta1-4 MIT Kerberos runtime libraries
ii  libldap-2.4-2         2.4.11-1           OpenLDAP libraries
ii  libmysqlclient15off   5.0.51a-15         MySQL database client library
ii  libpam-runtime        1.0.1-4            Runtime support for the PAM librar
ii  libpam0g              1.0.1-4            Pluggable Authentication Modules l
ii  libpq5                8.3.4-2            PostgreSQL C client library
ii  libsqlite3-0          3.5.9-6            SQLite 3 shared library
ii  libssl0.9.8           0.9.8g-13          SSL shared libraries
ii  openssl               0.9.8g-13          Secure Socket Layer (SSL) binary a
ii  ucf                   3.0010             Update Configuration File: preserv
ii  zlib1g                1:1.2.3.3.dfsg-12  compression library - runtime

dovecot-common recommends no packages.

dovecot-common suggests no packages.

-- no debconf information
.\"                                      Hey, EMACS: -*- nroff -*-
.TH "DOVECOTPW" "1" "6 November 2008"
.\" Please adjust this date whenever revising the manpage.
.\"
.SH NAME
dovecotpw \- a tool to easily generate passwords for a specified password 
scheme. 
.SH SYNOPSIS
\fBdovecotpw\fP [-l] [-p <password>] [-s <scheme>] [-u <user>] [-V]
.br
.SH DESCRIPTION
\fBdovecotpw\fP is a small tool to easily generate passwords for a
specified password scheme known by  \fIdovecot\fR\|(1).  A password scheme means
the format in which any password is stored in password databases.

The main idea behind storing passwords in non-plaintext scheme is that
if an attacker gets access to your server, he can't easily just get
all users' passwords and start using them. With stronger schemes it
takes more time to crack the passwords.

Currently, the password schemes supported by \fBdovecotpw\fP are:
CRYPT MD5 MD5-CRYPT SHA SHA1 SMD5 SSHA PLAIN CLEARTEXT CRAM-MD5
HMAC-MD5 DIGEST-MD5 PLAIN-MD4 PLAIN-MD5 LDAP-MD5 LANMAN NTLM RPA.

\fBdovecotpw\fP  can be used to populate \fIdovecot\fR\|(1) password databases.
.SH OPTIONS
.TP
\fB-l\fP 
List known password schemes.
.TP
\fB-p <password>\fP 
Use <password> as the password to be encoded with the specified scheme. If this 
option is not used, you are prompted for one interactively.
.TP
\fB-s <scheme>\fP 
Specify the password scheme to be used to encrypt the password.  <scheme> must 
be one of the supported password scheme as listed here above. If you omit this 
option, the default scheme is used (HMAC-MD5).
.TP
\fB-u <user>\fP 
Specify the username. This can be needed by some schemes.
.TP
\fB-V\fP 
Internally verify the generated hash.
.SH AUTHOR
.TP
dovecotpw was written by Timo Sirainen <[EMAIL PROTECTED]>.
.PP
This manual page was written by Xavier Lüthi <[EMAIL PROTECTED]>,
for the Debian project (but may be used by others).

Reply via email to