agw/gtk-ahfail
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity

docs: make X11 PAM config instructions unambiguous
All checks were successful
Test / test (push) Successful in 6m1s
Details

Browse Source 
Replace bare config snippets with actual tee -a commands so there is no
way to mistake a file entry for a shell command to run directly.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Asger Geel Weirsøe
2026-05-06 16:02:37 +02:00
parent 6a931cf4f0
commit a6de85650d
1 changed files with 13 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

27
readme.md
View File

@@ -83,30 +83,29 @@ gtklock -m /usr/lib/gtklock/ahfail-module.so -- --deadzone=860,440,200,200
---
## Usage Linux - X11 (i3lock, xscreensaver, etc.)
First compile as
Add the PAM module to your screen locker's PAM service file. Use the full path — `$(libdir)/ahfail` is not in PAM's default search path.
**Arch / standard:**
```
auth optional /usr/lib/ahfail/libahfail_pam.so
Add a line to your screen locker's PAM service file (e.g. `/etc/pam.d/i3lock`). This is a config file entry — use `tee -a` to append it, not `sudo` directly:
**Arch / standard (`--prefix=/usr`):**
```bash
echo 'auth optional /usr/lib/ahfail/libahfail_pam.so' | sudo tee -a /etc/pam.d/i3lock
```
**Fedora / RHEL (multilib):**
```
auth optional /usr/lib64/ahfail/libahfail_pam.so
```bash
echo 'auth optional /usr/lib64/ahfail/libahfail_pam.so' | sudo tee -a /etc/pam.d/i3lock
```
**Debian / Ubuntu (multiarch):**
```
auth optional /usr/lib/x86_64-linux-gnu/ahfail/libahfail_pam.so
```bash
echo 'auth optional /usr/lib/x86_64-linux-gnu/ahfail/libahfail_pam.so' | sudo tee -a /etc/pam.d/i3lock
```
Common service files: `/etc/pam.d/i3lock`, `/etc/pam.d/xscreensaver`, `/etc/pam.d/lightdm`.
Replace `i3lock` with your locker's service name (`xscreensaver`, `lightdm`, etc.). The full path is required — `$(libdir)/ahfail` is not in PAM's default search path.
Optionally pass the display binary path as an argument if it is not at the default location:
```
auth optional /usr/lib/ahfail/libahfail_pam.so display_path=/usr/lib/ahfail/ahfail-display
If the display binary is not at the default location, add `display_path=`:
```bash
echo 'auth optional /usr/lib/ahfail/libahfail_pam.so display_path=/usr/lib/ahfail/ahfail-display' | sudo tee -a /etc/pam.d/i3lock
```
---