GNU bug report logs - #41502
[PATCH] Add subsection to cookbook about session locking with xss-lock

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Ludovic Courtès <ludo <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#41502: closed ([PATCH] Add subsection to cookbook about
 session locking with xss-lock)
Date: Sun, 24 May 2020 19:54:02 +0000

[Message part 1 (text/plain, inline)]

Your message dated Sun, 24 May 2020 21:52:55 +0200
with message-id <87eer93yaw.fsf <at> gnu.org>
and subject line Re: [bug#41502] [PATCH v2] Add subsection to cookbook about session locking with xss-lock
has caused the debbugs.gnu.org bug report #41502,
regarding [PATCH] Add subsection to cookbook about session locking with xss-lock
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
41502: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=41502
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Chris Boeg <chris <at> boeg.me>
To: guix-patches <at> gnu.org
Cc: Chris Bøg <chris <at> boeg.me>
Subject: [PATCH] Add subsection to cookbook about session locking with xss-lock
Date: Sun, 24 May 2020 10:54:07 +0200

From: Chris Bøg <chris <at> boeg.me>

---
 doc/guix-cookbook.texi | 41 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/doc/guix-cookbook.texi b/doc/guix-cookbook.texi
index 2a605276e6..4e031859c0 100644
--- a/doc/guix-cookbook.texi
+++ b/doc/guix-cookbook.texi
@@ -1617,6 +1617,47 @@ Then you need to add the following code to a StumpWM configuration file
 (set-font (make-instance 'xft:font :family "DejaVu Sans Mono" :subfamily "Book" :size 11))
 @end lisp
 
+@node Session lock
+@subsection Session lock
+@cindex sessionlock
+
+Depending on your environment, locking the screen of your session might come built in
+or it might be something you have to set up yourself. If you use a desktop environment
+like GNOME or KDE, it's usually built in. If you use a plain window manager like
+StumpWM or EXWM, you might have to set it up yourself.
+
+@node Xorg
+@subsubsection Xorg
+
+If you use Xorg, you can use the utility
+@uref{https://www.mankier.com/1/xss-lock, xss-lock} to lock the screen of your session.
+xss-lock is triggered by DPMS which since Xorg 1.8 is auto-detected and enabled if
+ACPI is also enabled at kernel runtime.
+
+To use xss-lock, you can simple execute it and put it into the background before
+you start your window manager from e.g. your @file{~/.xsession}:
+
+@example
+xss-lock -- slock &
+exec stumpwm
+@end example
+
+In this example, xss-lock uses @code{slock} to do the actual locking of the screen when
+it determines it's appropriate, like when you suspend your device.
+
+For slock to be allowed to be a screen locker for the graphical session, it needs to
+be made setuid-root so it can authenticate users, and it needs a PAM service. This
+can be done by adding the following service to your @file{config.scm}:
+
+@lisp
+(screen-locker-service slock)
+@end lisp
+
+If you manually lock your screen, e.g. by directly calling slock when you want to lock
+your screen but not suspend it, it's a good idea to notify xss-lock about this so no
+confusion happens. This can be done by executing @code{xset s activate} immediately
+before you execute slock.
+
 @node Setting up a bind mount
 @section Setting up a bind mount
 
-- 
2.26.2

[Message part 3 (message/rfc822, inline)]

From: Ludovic Courtès <ludo <at> gnu.org>
To: Chris Boeg <chris <at> boeg.me>
Cc: 41502-done <at> debbugs.gnu.org
Subject: Re: [bug#41502] [PATCH v2] Add subsection to cookbook about session
 locking with xss-lock
Date: Sun, 24 May 2020 21:52:55 +0200

Hi Chris,

Chris Boeg <chris <at> boeg.me> skribis:

>  doc/guix-cookbook.texi | 41 +++++++++++++++++++++++++++++++++++++++++
>  1 file changed, 41 insertions(+)

Nice!  I added a commit log following our conventions and committed it.

Thanks,
Ludo’.

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.