[Pkg-zfsonlinux-devel] Bug#1024128: libpam-zfs: No documentation for homes not in rpool which pam says can't find

[Douglas A. Tutty]

Package: libpam-zfs
Version: 2.0.3-9
Severity: important
Tags: newcomer patch
X-Debbugs-Cc: douglas.tutty at hushmail.com

Although the zfsonlinux root-on-zfs docs use pool names bpool and rpool,
I want my /home/ directories on a different pool, named homepool.  As
installed, libpam-zfs looks for datasets in rpool/home.  Arch-linux wiki
gave a hint (different pam setup, so not a drop-in fix) to add
"homes=/homepool/home" as an option after the pam_zfs_key.so lines in
/etc/pam.d/common-auth, /etc/pam.d/common-password, and
/etc/pam.d/common-session

In the absence of a man page for libpam-zfs, either a separate note in
/usr/share/doc/libpam-zfs or a note at the top of the README there
(which has notes about everything _except_ libpam-zfs) would solve the
issue.

More slick, would be an addition to the debconf post-inst for libpam-zfs
asking for the name(s?) of the home dataset(s?) and have the option
added automatically.


-- System Information:
Debian Release: 11.5
  APT prefers stable-updates
  APT policy: (500, 'stable-updates'), (500, 'stable-security'), (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 5.10.0-19-amd64 (SMP w/4 CPU threads)
Kernel taint flags: TAINT_PROPRIETARY_MODULE, TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE
Locale: LANG=en_CA.UTF-8, LC_CTYPE=en_CA.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages libpam-zfs depends on:
ii  libc6            2.31-13+deb11u5
ii  libnvpair3linux  2.0.3-9
ii  libpam-runtime   1.4.0-9+deb11u1
ii  libpam0g         1.4.0-9+deb11u1
ii  libssl1.1        1.1.1n-0+deb11u3
ii  libzfs4linux     2.0.3-9

libpam-zfs recommends no packages.

libpam-zfs suggests no packages.

-- no debconf information
-------------- next part --------------
67a68,84
> 
> 4. Setting name of home datatset other than default rpool/home
> --------------------------------------------------------------
> 
> libpam-zfs assumes that the location of home directories follows the
> advice in the root-on-zfs HOWTO which places them in rpool/home.  To
> chnge this, add the following option to the end of the line in each of:
> /etc/pam.d/common-auth
> /etc/pam.d/common-password
> /etc/pam.d/common-session
> 
> for example, from common-auth:
> from:
> auth     optional    pam_zfs_key.so
> to:
> auth     optional    pam_zfs_key.so    homes=homepool/home
>