PAM-manpage-section

Patch to put the PAM manpage in section 7 (general topics) instead of 8
(system administration commands)

Authors: Steve Langasek <vorlon@debian.org>

Upstream status: maybe provide a backwards-compatibility link first?

Gbp-Pq: Name PAM-manpage-section

40 files changed, 212 insertions, 68 deletions

diff --git a/doc/man/Makefile.am b/doc/man/Makefile.am
index aec365cf..b81ca724 100644
--- a/doc/man/Makefile.am
+++ b/doc/man/Makefile.am
@@ -7,7 +7,7 @@ MAINTAINERCLEANFILES = $(MANS)
 
 EXTRA_DIST = $(MANS) $(XMLS)
 
-man_MANS = pam.3 PAM.8 pam.8 pam.conf.5 pam.d.5 \
+man_MANS = pam.3 PAM.7 pam.7 pam.conf.5 pam.d.5 \
 	pam_acct_mgmt.3 pam_authenticate.3 \
 	pam_chauthtok.3 pam_close_session.3 pam_conv.3 \
 	pam_end.3 pam_error.3 \
@@ -46,7 +46,8 @@ XMLS = pam.3.xml pam.8.xml pam.conf.5.xml \
 
 
 if ENABLE_REGENERATE_MAN
-PAM.8: pam.8
+pam.8: pam.8.xml
+PAM.7 pam.7: pam.8
 pam_get_authtok_noverify.3: pam_get_authtok.3
 pam_get_authtok_verify.3: pam_get_authtok.3
 pam_verror.3: pam_error.3
diff --git a/doc/man/Makefile.in b/doc/man/Makefile.in
index d18dc7d4..30da4d09 100644
--- a/doc/man/Makefile.in
+++ b/doc/man/Makefile.in
@@ -1,7 +1,7 @@
-# Makefile.in generated by automake 1.16.3 from Makefile.am.
+# Makefile.in generated by automake 1.16.5 from Makefile.am.
 # @configure_input@
 
-# Copyright (C) 1994-2020 Free Software Foundation, Inc.
+# Copyright (C) 1994-2021 Free Software Foundation, Inc.
 
 # This Makefile.in is free software; the Free Software Foundation
 # gives unlimited permission to copy and/or distribute it,
@@ -163,9 +163,9 @@ am__uninstall_files_from_dir = { \
   }
 man3dir = $(mandir)/man3
 am__installdirs = "$(DESTDIR)$(man3dir)" "$(DESTDIR)$(man5dir)" \
-	"$(DESTDIR)$(man8dir)"
+	"$(DESTDIR)$(man7dir)"
 man5dir = $(mandir)/man5
-man8dir = $(mandir)/man8
+man7dir = $(mandir)/man7
 NROFF = nroff
 MANS = $(man_MANS)
 am__tagged_files = $(HEADERS) $(SOURCES) $(TAGS_FILES) $(LISP)
@@ -192,6 +192,8 @@ CPPFLAGS = @CPPFLAGS@
 CRYPTO_LIBS = @CRYPTO_LIBS@
 CRYPT_CFLAGS = @CRYPT_CFLAGS@
 CRYPT_LIBS = @CRYPT_LIBS@
+CSCOPE = @CSCOPE@
+CTAGS = @CTAGS@
 CYGPATH_W = @CYGPATH_W@
 DEFS = @DEFS@
 DEPDIR = @DEPDIR@
@@ -205,6 +207,7 @@ ECHO_T = @ECHO_T@
 ECONF_CFLAGS = @ECONF_CFLAGS@
 ECONF_LIBS = @ECONF_LIBS@
 EGREP = @EGREP@
+ETAGS = @ETAGS@
 EXEEXT = @EXEEXT@
 EXE_CFLAGS = @EXE_CFLAGS@
 EXE_LDFLAGS = @EXE_LDFLAGS@
@@ -354,6 +357,7 @@ pdfdir = @pdfdir@
 prefix = @prefix@
 program_transform_name = @program_transform_name@
 psdir = @psdir@
+runstatedir = @runstatedir@
 sbindir = @sbindir@
 sharedstatedir = @sharedstatedir@
 srcdir = @srcdir@
@@ -366,7 +370,7 @@ top_srcdir = @top_srcdir@
 CLEANFILES = *~
 MAINTAINERCLEANFILES = $(MANS)
 EXTRA_DIST = $(MANS) $(XMLS)
-man_MANS = pam.3 PAM.8 pam.8 pam.conf.5 pam.d.5 \
+man_MANS = pam.3 PAM.7 pam.7 pam.conf.5 pam.d.5 \
 	pam_acct_mgmt.3 pam_authenticate.3 \
 	pam_chauthtok.3 pam_close_session.3 pam_conv.3 \
 	pam_end.3 pam_error.3 \
@@ -528,56 +532,55 @@ uninstall-man5:
 	} | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^5][0-9a-z]*$$,5,;x' \
 	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \
 	dir='$(DESTDIR)$(man5dir)'; $(am__uninstall_files_from_dir)
-install-man8: $(man_MANS)
+install-man7: $(man_MANS)
 	@$(NORMAL_INSTALL)
 	@list1=''; \
 	list2='$(man_MANS)'; \
-	test -n "$(man8dir)" \
+	test -n "$(man7dir)" \
 	  && test -n "`echo $$list1$$list2`" \
 	  || exit 0; \
-	echo " $(MKDIR_P) '$(DESTDIR)$(man8dir)'"; \
-	$(MKDIR_P) "$(DESTDIR)$(man8dir)" || exit 1; \
+	echo " $(MKDIR_P) '$(DESTDIR)$(man7dir)'"; \
+	$(MKDIR_P) "$(DESTDIR)$(man7dir)" || exit 1; \
 	{ for i in $$list1; do echo "$$i"; done;  \
 	if test -n "$$list2"; then \
 	  for i in $$list2; do echo "$$i"; done \
-	    | sed -n '/\.8[a-z]*$$/p'; \
+	    | sed -n '/\.7[a-z]*$$/p'; \
 	fi; \
 	} | while read p; do \
 	  if test -f $$p; then d=; else d="$(srcdir)/"; fi; \
 	  echo "$$d$$p"; echo "$$p"; \
 	done | \
-	sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \
+	sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^7][0-9a-z]*$$,7,;x' \
 	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \
 	sed 'N;N;s,\n, ,g' | { \
 	list=; while read file base inst; do \
 	  if test "$$base" = "$$inst"; then list="$$list $$file"; else \
-	    echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man8dir)/$$inst'"; \
-	    $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man8dir)/$$inst" || exit $$?; \
+	    echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man7dir)/$$inst'"; \
+	    $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man7dir)/$$inst" || exit $$?; \
 	  fi; \
 	done; \
 	for i in $$list; do echo "$$i"; done | $(am__base_list) | \
 	while read files; do \
 	  test -z "$$files" || { \
-	    echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man8dir)'"; \
-	    $(INSTALL_DATA) $$files "$(DESTDIR)$(man8dir)" || exit $$?; }; \
+	    echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man7dir)'"; \
+	    $(INSTALL_DATA) $$files "$(DESTDIR)$(man7dir)" || exit $$?; }; \
 	done; }
 
-uninstall-man8:
+uninstall-man7:
 	@$(NORMAL_UNINSTALL)
-	@list=''; test -n "$(man8dir)" || exit 0; \
+	@list=''; test -n "$(man7dir)" || exit 0; \
 	files=`{ for i in $$list; do echo "$$i"; done; \
 	l2='$(man_MANS)'; for i in $$l2; do echo "$$i"; done | \
-	  sed -n '/\.8[a-z]*$$/p'; \
-	} | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^8][0-9a-z]*$$,8,;x' \
+	  sed -n '/\.7[a-z]*$$/p'; \
+	} | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^7][0-9a-z]*$$,7,;x' \
 	      -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \
-	dir='$(DESTDIR)$(man8dir)'; $(am__uninstall_files_from_dir)
+	dir='$(DESTDIR)$(man7dir)'; $(am__uninstall_files_from_dir)
 tags TAGS:
 
 ctags CTAGS:
 
 cscope cscopelist:
 
-
 distdir: $(BUILT_SOURCES)
 	$(MAKE) $(AM_MAKEFLAGS) distdir-am
 
@@ -615,7 +618,7 @@ check-am: all-am
 check: check-am
 all-am: Makefile $(MANS)
 installdirs:
-	for dir in "$(DESTDIR)$(man3dir)" "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(man8dir)"; do \
+	for dir in "$(DESTDIR)$(man3dir)" "$(DESTDIR)$(man5dir)" "$(DESTDIR)$(man7dir)"; do \
 	  test -z "$$dir" || $(MKDIR_P) "$$dir"; \
 	done
 install: install-am
@@ -686,7 +689,7 @@ install-info: install-info-am
 
 install-info-am:
 
-install-man: install-man3 install-man5 install-man8
+install-man: install-man3 install-man5 install-man7
 
 install-pdf: install-pdf-am
 
@@ -716,7 +719,7 @@ ps-am:
 
 uninstall-am: uninstall-man
 
-uninstall-man: uninstall-man3 uninstall-man5 uninstall-man8
+uninstall-man: uninstall-man3 uninstall-man5 uninstall-man7
 
 .MAKE: install-am install-strip
 
@@ -726,18 +729,19 @@ uninstall-man: uninstall-man3 uninstall-man5 uninstall-man8
 	install install-am install-data install-data-am install-dvi \
 	install-dvi-am install-exec install-exec-am install-html \
 	install-html-am install-info install-info-am install-man \
-	install-man3 install-man5 install-man8 install-pdf \
+	install-man3 install-man5 install-man7 install-pdf \
 	install-pdf-am install-ps install-ps-am install-strip \
 	installcheck installcheck-am installdirs maintainer-clean \
 	maintainer-clean-generic mostlyclean mostlyclean-generic \
 	mostlyclean-libtool pdf pdf-am ps ps-am tags-am uninstall \
 	uninstall-am uninstall-man uninstall-man3 uninstall-man5 \
-	uninstall-man8
+	uninstall-man7
 
 .PRECIOUS: Makefile
 
 
-@ENABLE_REGENERATE_MAN_TRUE@PAM.8: pam.8
+@ENABLE_REGENERATE_MAN_TRUE@pam.8: pam.8.xml
+@ENABLE_REGENERATE_MAN_TRUE@PAM.7 pam.7: pam.8
 @ENABLE_REGENERATE_MAN_TRUE@pam_get_authtok_noverify.3: pam_get_authtok.3
 @ENABLE_REGENERATE_MAN_TRUE@pam_get_authtok_verify.3: pam_get_authtok.3
 @ENABLE_REGENERATE_MAN_TRUE@pam_verror.3: pam_error.3
diff --git a/doc/man/PAM.7 b/doc/man/PAM.7
new file mode 100644
index 00000000..00b313f8
--- /dev/null
+++ b/doc/man/PAM.7
@@ -0,0 +1,138 @@
+'\" t
+.\"     Title: pam
+.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
+.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
+.\"      Date: 09/15/2023
+.\"    Manual: Linux-PAM Manual
+.\"    Source: Linux-PAM
+.\"  Language: English
+.\"
+.TH "PAM" "7" "09/15/2023" "Linux\-PAM" "Linux\-PAM Manual"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el       .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+PAM, pam \- Pluggable Authentication Modules for Linux
+.SH "DESCRIPTION"
+.PP
+This manual is intended to offer a quick introduction to
+\fBLinux\-PAM\fR\&. For more information the reader is directed to the
+\fBLinux\-PAM system administrators\*(Aq guide\fR\&.
+.PP
+\fBLinux\-PAM\fR
+is a system of libraries that handle the authentication tasks of applications (services) on the system\&. The library provides a stable general interface (Application Programming Interface \- API) that privilege granting programs (such as
+\fBlogin\fR(1)
+and
+\fBsu\fR(1)) defer to to perform standard authentication tasks\&.
+.PP
+The principal feature of the PAM approach is that the nature of the authentication is dynamically configurable\&. In other words, the system administrator is free to choose how individual service\-providing applications will authenticate users\&. This dynamic configuration is set by the contents of the single
+\fBLinux\-PAM\fR
+configuration file
+/etc/pam\&.conf\&. Alternatively and preferably, the configuration can be set by individual configuration files located in a
+pam\&.d
+directory\&. The presence of this directory will cause
+\fBLinux\-PAM\fR
+to
+\fIignore\fR
+/etc/pam\&.conf\&.
+.PP
+Vendor\-supplied PAM configuration files might be installed in the system directory
+/usr/lib/pam\&.d/
+or a configurable vendor specific directory instead of the machine configuration directory
+/etc/pam\&.d/\&. If no machine configuration file is found, the vendor\-supplied file is used\&. All files in
+/etc/pam\&.d/
+override files with the same name in other directories\&.
+.PP
+From the point of view of the system administrator, for whom this manual is provided, it is not of primary importance to understand the internal behavior of the
+\fBLinux\-PAM\fR
+library\&. The important point to recognize is that the configuration file(s)
+\fIdefine\fR
+the connection between applications
+(\fBservices\fR) and the pluggable authentication modules
+(\fBPAM\fRs) that perform the actual authentication tasks\&.
+.PP
+\fBLinux\-PAM\fR
+separates the tasks of
+\fIauthentication\fR
+into four independent management groups:
+\fBaccount\fR
+management;
+\fBauth\fRentication management;
+\fBpassword\fR
+management; and
+\fBsession\fR
+management\&. (We highlight the abbreviations used for these groups in the configuration file\&.)
+.PP
+Simply put, these groups take care of different aspects of a typical user\*(Aqs request for a restricted service:
+.PP
+\fBaccount\fR
+\- provide account verification types of service: has the user\*(Aqs password expired?; is this user permitted access to the requested service?
+.PP
+\fBauth\fRentication \- authenticate a user and set up user credentials\&. Typically this is via some challenge\-response request that the user must satisfy: if you are who you claim to be please enter your password\&. Not all authentications are of this type, there exist hardware based authentication schemes (such as the use of smart\-cards and biometric devices), with suitable modules, these may be substituted seamlessly for more standard approaches to authentication \- such is the flexibility of
+\fBLinux\-PAM\fR\&.
+.PP
+\fBpassword\fR
+\- this group\*(Aqs responsibility is the task of updating authentication mechanisms\&. Typically, such services are strongly coupled to those of the
+\fBauth\fR
+group\&. Some authentication mechanisms lend themselves well to being updated with such a function\&. Standard UN*X password\-based access is the obvious example: please enter a replacement password\&.
+.PP
+\fBsession\fR
+\- this group of tasks cover things that should be done prior to a service being given and after it is withdrawn\&. Such tasks include the maintenance of audit trails and the mounting of the user\*(Aqs home directory\&. The
+\fBsession\fR
+management group is important as it provides both an opening and closing hook for modules to affect the services available to a user\&.
+.SH "FILES"
+.PP
+/etc/pam\&.conf
+.RS 4
+the configuration file
+.RE
+.PP
+/etc/pam\&.d
+.RS 4
+the
+\fBLinux\-PAM\fR
+configuration directory\&. Generally, if this directory is present, the
+/etc/pam\&.conf
+file is ignored\&.
+.RE
+.PP
+/usr/lib/pam\&.d
+.RS 4
+the
+\fBLinux\-PAM\fR
+vendor configuration directory\&. Files in
+/etc/pam\&.d
+override files with the same name in this directory\&.
+.RE
+.SH "ERRORS"
+.PP
+Typically errors generated by the
+\fBLinux\-PAM\fR
+system of libraries, will be written to
+\fBsyslog\fR(3)\&.
+.SH "CONFORMING TO"
+.PP
+DCE\-RFC 86\&.0, October 1995\&. Contains additional features, but remains backwardly compatible with this RFC\&.
+.SH "SEE ALSO"
+.PP
+\fBpam\fR(3),
+\fBpam_authenticate\fR(3),
+\fBpam_sm_setcred\fR(3),
+\fBpam_strerror\fR(3),
+\fBPAM\fR(8)
diff --git a/doc/man/misc_conv.3 b/doc/man/misc_conv.3
index 62656642..85d32db2 100644
--- a/doc/man/misc_conv.3
+++ b/doc/man/misc_conv.3
@@ -117,7 +117,7 @@ This function pointer is initialized to
 .SH "SEE ALSO"
 .PP
 \fBpam_conv\fR(3),
-\fBpam\fR(8)
+\fBpam\fR(7)
 .SH "STANDARDS"
 .PP
 The
diff --git a/doc/man/misc_conv.3.xml b/doc/man/misc_conv.3.xml
index 92d4acd1..2971b3a8 100644
--- a/doc/man/misc_conv.3.xml
+++ b/doc/man/misc_conv.3.xml
@@ -168,7 +168,7 @@
         <refentrytitle>pam_conv</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam.7 b/doc/man/pam.7
new file mode 100644
index 00000000..a15cab92
--- /dev/null
+++ b/doc/man/pam.7
@@ -0,0 +1 @@
+.so PAM.7
diff --git a/doc/man/pam.8.xml b/doc/man/pam.8.xml
index 7f3b051c..cb6a7d88 100644
--- a/doc/man/pam.8.xml
+++ b/doc/man/pam.8.xml
@@ -2,7 +2,7 @@
 
   <refmeta>
     <refentrytitle>pam</refentrytitle>
-    <manvolnum>8</manvolnum>
+    <manvolnum>7</manvolnum>
     <refmiscinfo class="source">Linux-PAM</refmiscinfo>
     <refmiscinfo class="manual">Linux-PAM Manual</refmiscinfo>
   </refmeta>
diff --git a/doc/man/pam_acct_mgmt.3 b/doc/man/pam_acct_mgmt.3
index 18e91d56..1cfb5016 100644
--- a/doc/man/pam_acct_mgmt.3
+++ b/doc/man/pam_acct_mgmt.3
@@ -97,4 +97,4 @@ User unknown to password service\&.
 \fBpam_authenticate\fR(3),
 \fBpam_chauthtok\fR(3),
 \fBpam_strerror\fR(3),
-\fBpam\fR(8)
+\fBpam\fR(7)
diff --git a/doc/man/pam_acct_mgmt.3.xml b/doc/man/pam_acct_mgmt.3.xml
index de6a94ab..6ff3ccb3 100644
--- a/doc/man/pam_acct_mgmt.3.xml
+++ b/doc/man/pam_acct_mgmt.3.xml
@@ -136,7 +136,7 @@
         <refentrytitle>pam_strerror</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_authenticate.3 b/doc/man/pam_authenticate.3
index 1760e2ac..463a5184 100644
--- a/doc/man/pam_authenticate.3
+++ b/doc/man/pam_authenticate.3
@@ -107,4 +107,4 @@ User unknown to authentication service\&.
 \fBpam_setcred\fR(3),
 \fBpam_chauthtok\fR(3),
 \fBpam_strerror\fR(3),
-\fBpam\fR(8)
+\fBpam\fR(7)
diff --git a/doc/man/pam_authenticate.3.xml b/doc/man/pam_authenticate.3.xml
index 794a5c71..948b950f 100644
--- a/doc/man/pam_authenticate.3.xml
+++ b/doc/man/pam_authenticate.3.xml
@@ -160,7 +160,7 @@
         <refentrytitle>pam_strerror</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_chauthtok.3 b/doc/man/pam_chauthtok.3
index 60d267ff..d7a1c1b2 100644
--- a/doc/man/pam_chauthtok.3
+++ b/doc/man/pam_chauthtok.3
@@ -106,4 +106,4 @@ User unknown to password service\&.
 \fBpam_setcred\fR(3),
 \fBpam_get_item\fR(3),
 \fBpam_strerror\fR(3),
-\fBpam\fR(8)
+\fBpam\fR(7)
diff --git a/doc/man/pam_chauthtok.3.xml b/doc/man/pam_chauthtok.3.xml
index e184f45f..95af359f 100644
--- a/doc/man/pam_chauthtok.3.xml
+++ b/doc/man/pam_chauthtok.3.xml
@@ -155,7 +155,7 @@
         <refentrytitle>pam_strerror</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_conv.3 b/doc/man/pam_conv.3
index 5ada0837..35c35d07 100644
--- a/doc/man/pam_conv.3
+++ b/doc/man/pam_conv.3
@@ -174,4 +174,4 @@ Success\&.
 \fBpam_set_item\fR(3),
 \fBpam_get_item\fR(3),
 \fBpam_strerror\fR(3),
-\fBpam\fR(8)
+\fBpam\fR(7)
diff --git a/doc/man/pam_conv.3.xml b/doc/man/pam_conv.3.xml
index 31834f3c..96bfd237 100644
--- a/doc/man/pam_conv.3.xml
+++ b/doc/man/pam_conv.3.xml
@@ -219,7 +219,7 @@ struct pam_conv {
         <refentrytitle>pam_strerror</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_error.3 b/doc/man/pam_error.3
index 9a6c3f8d..6f04998e 100644
--- a/doc/man/pam_error.3
+++ b/doc/man/pam_error.3
@@ -80,7 +80,7 @@ System error\&.
 \fBpam_vinfo\fR(3),
 \fBpam_prompt\fR(3),
 \fBpam_vprompt\fR(3),
-\fBpam\fR(8)
+\fBpam\fR(7)
 .SH "STANDARDS"
 .PP
 The
diff --git a/doc/man/pam_error.3.xml b/doc/man/pam_error.3.xml
index 0f294c22..82ea7098 100644
--- a/doc/man/pam_error.3.xml
+++ b/doc/man/pam_error.3.xml
@@ -102,7 +102,7 @@
         <refentrytitle>pam_vprompt</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_get_authtok.3 b/doc/man/pam_get_authtok.3
index 105a217e..3e6ddda3 100644
--- a/doc/man/pam_get_authtok.3
+++ b/doc/man/pam_get_authtok.3
@@ -162,7 +162,7 @@ New authentication tokens mismatch\&.
 .RE
 .SH "SEE ALSO"
 .PP
-\fBpam\fR(8)
+\fBpam\fR(7)
 .SH "STANDARDS"
 .PP
 The
diff --git a/doc/man/pam_get_authtok.3.xml b/doc/man/pam_get_authtok.3.xml
index ba6d955e..1cb7566e 100644
--- a/doc/man/pam_get_authtok.3.xml
+++ b/doc/man/pam_get_authtok.3.xml
@@ -229,7 +229,7 @@
     <title>SEE ALSO</title>
     <para>
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_get_item.3 b/doc/man/pam_get_item.3
index d08fde5f..894c7f6d 100644
--- a/doc/man/pam_get_item.3
+++ b/doc/man/pam_get_item.3
@@ -2,12 +2,12 @@
 .\"     Title: pam_get_item
 .\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
 .\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
-.\"      Date: 05/07/2023
+.\"      Date: 09/15/2023
 .\"    Manual: Linux-PAM Manual
 .\"    Source: Linux-PAM
 .\"  Language: English
 .\"
-.TH "PAM_GET_ITEM" "3" "05/07/2023" "Linux\-PAM" "Linux\-PAM Manual"
+.TH "PAM_GET_ITEM" "3" "09/15/2023" "Linux\-PAM" "Linux\-PAM Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
diff --git a/doc/man/pam_getenv.3 b/doc/man/pam_getenv.3
index d0d39990..f639ef96 100644
--- a/doc/man/pam_getenv.3
+++ b/doc/man/pam_getenv.3
@@ -57,4 +57,4 @@ function returns NULL on failure\&.
 \fBpam_start\fR(3),
 \fBpam_getenvlist\fR(3),
 \fBpam_putenv\fR(3),
-\fBpam\fR(8)
+\fBpam\fR(7)
diff --git a/doc/man/pam_getenv.3.xml b/doc/man/pam_getenv.3.xml
index df25863b..b5dbc124 100644
--- a/doc/man/pam_getenv.3.xml
+++ b/doc/man/pam_getenv.3.xml
@@ -58,7 +58,7 @@
         <refentrytitle>pam_putenv</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_getenvlist.3 b/doc/man/pam_getenvlist.3
index 83697643..e2ae9499 100644
--- a/doc/man/pam_getenvlist.3
+++ b/doc/man/pam_getenvlist.3
@@ -63,4 +63,4 @@ function returns NULL on failure\&.
 \fBpam_start\fR(3),
 \fBpam_getenv\fR(3),
 \fBpam_putenv\fR(3),
-\fBpam\fR(8)
+\fBpam\fR(7)
diff --git a/doc/man/pam_getenvlist.3.xml b/doc/man/pam_getenvlist.3.xml
index 54b1f411..7f755e5b 100644
--- a/doc/man/pam_getenvlist.3.xml
+++ b/doc/man/pam_getenvlist.3.xml
@@ -76,7 +76,7 @@
         <refentrytitle>pam_putenv</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_info.3 b/doc/man/pam_info.3
index d66dee4b..a76e039f 100644
--- a/doc/man/pam_info.3
+++ b/doc/man/pam_info.3
@@ -76,7 +76,7 @@ System error\&.
 .RE
 .SH "SEE ALSO"
 .PP
-\fBpam\fR(8)
+\fBpam\fR(7)
 .SH "STANDARDS"
 .PP
 The
diff --git a/doc/man/pam_info.3.xml b/doc/man/pam_info.3.xml
index 5155d419..9b4a3f02 100644
--- a/doc/man/pam_info.3.xml
+++ b/doc/man/pam_info.3.xml
@@ -90,7 +90,7 @@
     <title>SEE ALSO</title>
     <para>
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_misc_drop_env.3 b/doc/man/pam_misc_drop_env.3
index b3d162ce..ca84c1c1 100644
--- a/doc/man/pam_misc_drop_env.3
+++ b/doc/man/pam_misc_drop_env.3
@@ -52,7 +52,7 @@ all memory before
 .SH "SEE ALSO"
 .PP
 \fBpam_getenvlist\fR(3),
-\fBpam\fR(8)
+\fBpam\fR(7)
 .SH "STANDARDS"
 .PP
 The
diff --git a/doc/man/pam_misc_drop_env.3.xml b/doc/man/pam_misc_drop_env.3.xml
index a7f6cc80..c7a25760 100644
--- a/doc/man/pam_misc_drop_env.3.xml
+++ b/doc/man/pam_misc_drop_env.3.xml
@@ -43,7 +43,7 @@
         <refentrytitle>pam_getenvlist</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_misc_paste_env.3 b/doc/man/pam_misc_paste_env.3
index d707daa4..6ca8c50d 100644
--- a/doc/man/pam_misc_paste_env.3
+++ b/doc/man/pam_misc_paste_env.3
@@ -47,7 +47,7 @@ PAM_SUCCESS\&.
 .SH "SEE ALSO"
 .PP
 \fBpam_putenv\fR(3),
-\fBpam\fR(8)
+\fBpam\fR(7)
 .SH "STANDARDS"
 .PP
 The
diff --git a/doc/man/pam_misc_paste_env.3.xml b/doc/man/pam_misc_paste_env.3.xml
index 06194a9d..2d99a1fe 100644
--- a/doc/man/pam_misc_paste_env.3.xml
+++ b/doc/man/pam_misc_paste_env.3.xml
@@ -41,7 +41,7 @@
         <refentrytitle>pam_putenv</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_misc_setenv.3 b/doc/man/pam_misc_setenv.3
index 70030b74..0b1380ab 100644
--- a/doc/man/pam_misc_setenv.3
+++ b/doc/man/pam_misc_setenv.3
@@ -52,7 +52,7 @@ are concatenated with an \*(Aq=\*(Aq to form a name=value and passed to
 .SH "SEE ALSO"
 .PP
 \fBpam_putenv\fR(3),
-\fBpam\fR(8)
+\fBpam\fR(7)
 .SH "STANDARDS"
 .PP
 The
diff --git a/doc/man/pam_misc_setenv.3.xml b/doc/man/pam_misc_setenv.3.xml
index 4414d54d..c9403c58 100644
--- a/doc/man/pam_misc_setenv.3.xml
+++ b/doc/man/pam_misc_setenv.3.xml
@@ -48,7 +48,7 @@
         <refentrytitle>pam_putenv</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_prompt.3 b/doc/man/pam_prompt.3
index 30707477..aeaaac0e 100644
--- a/doc/man/pam_prompt.3
+++ b/doc/man/pam_prompt.3
@@ -2,12 +2,12 @@
 .\"     Title: pam_prompt
 .\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
 .\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
-.\"      Date: 05/07/2023
+.\"      Date: 09/15/2023
 .\"    Manual: Linux-PAM Manual
 .\"    Source: Linux-PAM
 .\"  Language: English
 .\"
-.TH "PAM_PROMPT" "3" "05/07/2023" "Linux\-PAM" "Linux\-PAM Manual"
+.TH "PAM_PROMPT" "3" "09/15/2023" "Linux\-PAM" "Linux\-PAM Manual"
 .\" -----------------------------------------------------------------
 .\" * Define some portability stuff
 .\" -----------------------------------------------------------------
@@ -70,7 +70,7 @@ System error\&.
 .RE
 .SH "SEE ALSO"
 .PP
-\fBpam\fR(8),
+\fBpam\fR(7),
 \fBpam_conv\fR(3)
 .SH "STANDARDS"
 .PP
diff --git a/doc/man/pam_prompt.3.xml b/doc/man/pam_prompt.3.xml
index c65a0c90..b53f5022 100644
--- a/doc/man/pam_prompt.3.xml
+++ b/doc/man/pam_prompt.3.xml
@@ -92,7 +92,7 @@
     <title>SEE ALSO</title>
     <para>
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>,
       <citerefentry>
         <refentrytitle>pam_conv</refentrytitle><manvolnum>3</manvolnum>
diff --git a/doc/man/pam_putenv.3 b/doc/man/pam_putenv.3
index 3b826b19..0e1002b2 100644
--- a/doc/man/pam_putenv.3
+++ b/doc/man/pam_putenv.3
@@ -108,4 +108,4 @@ The environment variable was successfully updated\&.
 \fBpam_getenv\fR(3),
 \fBpam_getenvlist\fR(3),
 \fBpam_strerror\fR(3),
-\fBpam\fR(8)
+\fBpam\fR(7)
diff --git a/doc/man/pam_putenv.3.xml b/doc/man/pam_putenv.3.xml
index 7267046f..8daca001 100644
--- a/doc/man/pam_putenv.3.xml
+++ b/doc/man/pam_putenv.3.xml
@@ -143,7 +143,7 @@
         <refentrytitle>pam_strerror</refentrytitle><manvolnum>3</manvolnum>
       </citerefentry>,
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_strerror.3 b/doc/man/pam_strerror.3
index 408eb3a0..d6c5d51b 100644
--- a/doc/man/pam_strerror.3
+++ b/doc/man/pam_strerror.3
@@ -49,4 +49,4 @@ function returns a pointer to a string describing the error code passed in the a
 This function returns always a pointer to a string\&.
 .SH "SEE ALSO"
 .PP
-\fBpam\fR(8)
+\fBpam\fR(7)
diff --git a/doc/man/pam_strerror.3.xml b/doc/man/pam_strerror.3.xml
index b76cbc4d..2c7a8a90 100644
--- a/doc/man/pam_strerror.3.xml
+++ b/doc/man/pam_strerror.3.xml
@@ -48,7 +48,7 @@
     <title>SEE ALSO</title>
     <para>
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>
diff --git a/doc/man/pam_syslog.3 b/doc/man/pam_syslog.3
index 82231311..d1f25896 100644
--- a/doc/man/pam_syslog.3
+++ b/doc/man/pam_syslog.3
@@ -67,7 +67,7 @@ with the difference that it takes a set of arguments which have been obtained us
 variable argument list macros\&.
 .SH "SEE ALSO"
 .PP
-\fBpam\fR(8)
+\fBpam\fR(7)
 .SH "STANDARDS"
 .PP
 The
diff --git a/doc/man/pam_syslog.3.xml b/doc/man/pam_syslog.3.xml
index f5be287f..50054765 100644
--- a/doc/man/pam_syslog.3.xml
+++ b/doc/man/pam_syslog.3.xml
@@ -63,7 +63,7 @@
     <title>SEE ALSO</title>
     <para>
       <citerefentry>
-        <refentrytitle>pam</refentrytitle><manvolnum>8</manvolnum>
+        <refentrytitle>pam</refentrytitle><manvolnum>7</manvolnum>
       </citerefentry>
     </para>
   </refsect1>