libpam-doc: doc-base reports missing files

Bug #2064360 reported by Dan Bungert
8
This bug affects 1 person
Affects Status Importance Assigned to Milestone
pam (Debian)
Fix Released
Unknown
pam (Ubuntu)
Fix Released
High
Dan Bungert
Noble
Fix Released
High
Dan Bungert

Bug Description

[ Impact ]

 * In the pam 1.5.3-1 merge, documents formerly found in libpam-doc
   were omitted. Just a few documents remain in a package that
   formerly had many in /usr/share/doc/libpam-doc/{html,txt}.
 * A debdiff of the dropped files can be found in attachment
   1.5.2-9.1ubuntu3_to_1.5.3-5ubuntu5_libpam-doc.debdiff
 * The fix takes the form of correcting a build dependency, which
   results in the docs being again available.

[ Test Plan ]

 * debdiff
   * Obtain a copy of the current pam binary packages, perhaps with
     `pull-lp-debs libpam-doc 1.5.3-5ubuntu5`
   * Obtain a copy of the proposed pam binary packages, perhaps with
     `pull-lp-debs libpam-doc 1.5.3-5ubuntu5.1`
   * `debdiff libpam-doc_1.5.3-5ubuntu5{,.1}_all.deb`
     and verify that the documents are present
 * upgrade
   * Obtain a mantic test system - I personally used a mantic chroot
   * `apt install libpam-doc doc-base`
   * Adjust apt sources to change mantic to noble and ensure
     noble-proposed is present
   * `apt update; apt install libpam-doc/noble-proposed`
   * Verify that the "Error in /usr/share/doc-base" messages are no
     longer present

[ Where problems could occur ]

 * As usual, no SRU has zero risk
 * Any change to pam risks problems in user logins failing, so that is
   reflected in the regression test plan on LP: #2064350

[ Development release status ]

Issue fixed in merge from Debian and subsequent 1.5.3-7ubuntu1 upload.

[ Other Info ]

 * None at this time

original description follows:
---

Imported from Debian bug http://bugs.debian.org/1065064:

Package: libpam-doc
Version: 1.5.3-4
Severity: normal

An upgrade reported:

  Error in `/usr/share/doc-base/libpam-doc.pam-admin-guide', line 14: all `Format' sections are invalid.
  Error in `/usr/share/doc-base/libpam-doc.pam-applications-guide', line 17: all `Format' sections are invalid.
  Error in `/usr/share/doc-base/libpam-doc.pam-modules-guide', line 14: all `Format' sections are invalid.

This is true; all of /usr/share/doc/libpam-doc/html/Linux-PAM_SAG.html,
/usr/share/doc/libpam-doc/html/sag-*.html,
/usr/share/doc/libpam-doc/txt/Linux-PAM_SAG.txt.gz,
/usr/share/doc/libpam-doc/html/Linux-PAM_ADG.html,
/usr/share/doc/libpam-doc/html/adg*.html,
/usr/share/doc/libpam-doc/txt/Linux-PAM_ADG.txt.gz,
/usr/share/doc/libpam-doc/html/Linux-PAM_MWG.html,
/usr/share/doc/libpam-doc/html/mwg*.html, and
/usr/share/doc/libpam-doc/txt/Linux-PAM_MWG.txt.gz are listed in those
doc-base files but are in fact missing. I don't know whether this is
intentional (in which case the doc-base registrations should be removed
to match), or an accidental build issue that should be fixed.

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

Kernel: Linux 6.6.0-14-generic (SMP w/4 CPU threads; PREEMPT)
Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_FIRMWARE_WORKAROUND, TAINT_OOT_MODULE
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8), LANGUAGE=en_GB:en
Shell: /bin/sh linked to /usr/bin/dash
Init: unable to detect

-- no debconf information

--
Colin Watson (he/him) [<email address hidden>]

Changed in pam (Debian):
importance: Undecided → Unknown
status: New → Fix Released
Dan Bungert (dbungert)
Changed in pam (Ubuntu):
status: New → In Progress
assignee: nobody → Dan Bungert (dbungert)
Dan Bungert (dbungert)
description: updated
Dan Bungert (dbungert)
Changed in pam (Ubuntu):
importance: Undecided → High
status: In Progress → Fix Committed
Changed in pam (Ubuntu Noble):
status: New → In Progress
importance: Undecided → High
assignee: nobody → Dan Bungert (dbungert)
Revision history for this message
Dan Bungert (dbungert) wrote :
tags: added: patch
Dan Bungert (dbungert)
tags: removed: patch
Revision history for this message
Andreas Hasenack (ahasenack) wrote :

For some reason which I cannot explain at the moment, a local build of 1.5.3-5ubuntu5.1 in noble does not produce the expected extra documentation files, so it doesn't look like the change in build-deps is enough to fix it.

Revision history for this message
Dan Bungert (dbungert) wrote :

I incorrectly ported this fix for 5ubuntu5.1. Will reupload.

Revision history for this message
Dan Bungert (dbungert) wrote :

Fixed version uploaded.

Revision history for this message
Timo Aaltonen (tjaalton) wrote : Please test proposed package

Hello Dan, or anyone else affected,

Accepted pam into noble-proposed. The package will build now and be available at https://launchpad.net/ubuntu/+source/pam/1.5.3-5ubuntu5.1 in a few hours, and then in the -proposed repository.

Please help us by testing this new package. See https://wiki.ubuntu.com/Testing/EnableProposed for documentation on how to enable and use -proposed. Your feedback will aid us getting this update out to other Ubuntu users.

If this package fixes the bug for you, please add a comment to this bug, mentioning the version of the package you tested, what testing has been performed on the package and change the tag from verification-needed-noble to verification-done-noble. If it does not fix the bug for you, please add a comment stating that, and change the tag to verification-failed-noble. In either case, without details of your testing we will not be able to proceed.

Further information regarding the verification process can be found at https://wiki.ubuntu.com/QATeam/PerformingSRUVerification . Thank you in advance for helping!

N.B. The updated package will be released to -updates after the bug(s) fixed by this package have been verified and the package has been in -proposed for a minimum of 7 days.

Changed in pam (Ubuntu Noble):
status: In Progress → Fix Committed
tags: added: verification-needed verification-needed-noble
Revision history for this message
Dan Bungert (dbungert) wrote :

I have self-verified the fix and it looks good. mantic schroot for the upgrade test.

tags: added: verification-done verification-done-noble
removed: verification-needed verification-needed-noble
Revision history for this message
Ubuntu SRU Bot (ubuntu-sru-bot) wrote : Autopkgtest regression report (pam/1.5.3-5ubuntu5.1)

All autopkgtests for the newly accepted pam (1.5.3-5ubuntu5.1) for noble have finished running.
The following regressions have been reported in tests triggered by the package:

cron/3.0pl1-184ubuntu2 (s390x)
dovecot/1:2.3.21+dfsg1-2ubuntu5 (s390x)
inetutils/2:2.5-3ubuntu4 (s390x)
libreswan/4.14-1ubuntu2 (s390x)
lxc/1:5.0.3-2ubuntu7 (s390x)
openssh/unknown (armhf, s390x)
samba/2:4.19.5+dfsg-4ubuntu9 (s390x)

Please visit the excuses page listed below and investigate the failures, proceeding afterwards as per the StableReleaseUpdates policy regarding autopkgtest regressions [1].

https://people.canonical.com/~ubuntu-archive/proposed-migration/noble/update_excuses.html#pam

[1] https://wiki.ubuntu.com/StableReleaseUpdates#Autopkgtest_Regressions

Thank you!

Revision history for this message
Dan Bungert (dbungert) wrote :

Marking fix released for Oracular, this was fixed but it wasn't noted in the changelog.

Changed in pam (Ubuntu):
status: Fix Committed → Fix Released
description: updated
Revision history for this message
Launchpad Janitor (janitor) wrote :

This bug was fixed in the package pam - 1.5.3-5ubuntu5.1

---------------
pam (1.5.3-5ubuntu5.1) noble; urgency=medium

  [ Sam Hartman ]
  * Correct Build depends for docbook5 (LP: #2064360)
  * Depend on libdb-dev again, bringing back pam_userdb (LP: #2064350)

 -- Dan Bungert <email address hidden> Thu, 02 May 2024 16:20:13 -0600

Changed in pam (Ubuntu Noble):
status: Fix Committed → Fix Released
Revision history for this message
Brian Murray (brian-murray) wrote : Update Released

The verification of the Stable Release Update for pam has completed successfully and the package is now being released to -updates. Subsequently, the Ubuntu Stable Release Updates Team is being unsubscribed and will not receive messages about this bug report. In the event that you encounter a regression using the package from -updates please report a new bug using ubuntu-bug and tag the bug report regression-update so we can easily find any regressions.

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.