Bug#671015: sasl2-bin: should suggest cyrus-sasl2-doc for LDAP_SASLAUTHD

[Luca Capello]

Package: sasl2-bin
Version: 2.1.25.dfsg1-4
Severity: minor
File: /usr/share/man/man8/saslauthd.8.gz
Tags: patch
Usertags: pca.it-authentication

Hi there!

While trying to configure LDAP authentication via Cyrus-SASL for prosody
(see bug #670549), I was hit by the fact sasl2-bin does not ship
LDAP_SASLAUTHD despite `man 8 saslauthd` says:

  AUTHENTICATION MECHANISMS

  [...]

     ldap       (All platforms that support OpenLDAP 2.0 or higher)

                Authenticate against an ldap server.  The ldap
                configuration parameters are read from
                /etc/saslauthd.conf.  The location of this file can be
                changed with the -O parameter. See the LDAP_SASLAUTHD
                file included with the distribution for the list of
                available parameters.

This file was included in sasl2-bin because of bug #201893, but at some
point was moved to cyrus-sasl2-doc (note the different prefix for the
binary package) and nothing is present in the debian/changelog.

While IMHO LDAP_SASLAUTHD should be shipped together with sasl2-bin, if
not at least sasl2-bin should Suggests: cyrus-sasl2-doc, here a simple
patch:

--8<---------------cut here---------------start------------->8---
diff --git a/debian/control b/debian/control
index 59e27de..bccf316 100644
--- a/debian/control
+++ b/debian/control
@@ -15,12 +15,16 @@ Section: utils
 Priority: optional
 Architecture: any
 Depends: libsasl2-2 (>= ${binary:Version}), ${shlibs:Depends}, ${misc:Depends}, lsb-base (>= 3.0-6), db-util, debconf (>= 1.4.69) | cdebconf (>= 0.39)
+Suggests: cyrus-sasl2-doc
 Description: Cyrus SASL - administration programs for SASL users database
  This is the Cyrus SASL API implementation, version 2.1. See package
  libsasl2-2 and RFC 2222 for more information.
  .
  This package contains administration programs for the SASL users
  database and common binary files for plugin modules.    
+ .
+ Please install the suggested cyrus-sasl2-doc package for the full
+ documentation (e.g. the LDAP_SASLAUTHD file for LDAP authentication).
 
 Package: cyrus-sasl2-doc
 Section: doc
--8<---------------cut here---------------end--------------->8---

Thx, bye,
Gismo / Luca

-- System Information:
Debian Release: wheezy/sid
  APT prefers unstable
  APT policy: (990, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 3.2.0-2-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages sasl2-bin depends on:
ii  db-util                5.1.4
ii  debconf [debconf-2.0]  1.5.42
ii  libc6                  2.13-30
ii  libcomerr2             1.42.2-2
ii  libdb5.1               5.1.29-1
ii  libgssapi-krb5-2       1.10+dfsg~beta1-2
ii  libk5crypto3           1.10+dfsg~beta1-2
ii  libkrb5-3              1.10+dfsg~beta1-2
ii  libldap-2.4-2          2.4.28-1.2
ii  libpam0g               1.1.3-7
ii  libsasl2-2             2.1.25.dfsg1-4
ii  libssl1.0.0            1.0.1b-1
ii  lsb-base               4.1+Debian2

sasl2-bin recommends no packages.

sasl2-bin suggests no packages.

-- Configuration Files:
/etc/default/saslauthd changed:
START=yes
DESC="SASL Authentication Daemon"
NAME="saslauthd"
MECHANISMS="pam"
MECH_OPTIONS=""
THREADS=5
OPTIONS="-c -m /var/spool/postfix/var/run/saslauthd"


-- debconf information:
  cyrus-sasl2/upgrade-sasldb2-failed:
  cyrus-sasl2/backup-sasldb2: /var/backups/sasldb2.bak
  cyrus-sasl2/upgrade-sasldb2-backup-failed:
  cyrus-sasl2/purge-sasldb2: false
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 835 bytes
Desc: not available
URL: <http://lists.alioth.debian.org/pipermail/pkg-cyrus-sasl2-debian-devel/attachments/20120501/31ddc799/attachment.pgp>