]> ruderich.org/simon Gitweb - wall-notify/wall-notify.git/blobdiff - README
remove superfluous braces in comment
[wall-notify/wall-notify.git] / README
diff --git a/README b/README
index 5b30220060c95a9dd48f9dacd7dc43b041eec503..84b7c72f3d8e9c62fbe11621da4ede6a7a711628 100644 (file)
--- a/README
+++ b/README
@@ -11,6 +11,9 @@ wall messages are either directly created by root with the `wall` command or
 sent by other programs like `reboot`, `shutdown` or other processes like NFS
 to warn users when the NFS server terminates.
 
+Optionally X11 can be used to automatically terminate wall-notify when the
+current X11 session terminates, i.e. when the user logs out. See below.
+
 wall-notify is licensed under GPL 3 (or later).
 
 
@@ -20,12 +23,19 @@ DEPENDENCIES
 - C89 compiler
 - libutempter or utmpx.h (utmpx.x requires a setgid utmp binary)
 
+- optional: X11 headers and library, necessary for X11 support
+
 
 INSTALLATION
 ------------
 
     ./configure && make && make check
 
+If libutempter is not available, the binary must be setgid utmp:
+
+    chgrp utmp src/wall-notify
+    chmod g+s src/wall-notify
+
 
 USAGE
 -----
@@ -52,9 +62,23 @@ in the message. For a simple wrapper script which removes those, see
 The shell is not used when running the program.
 
 
+If X11 support is compiled in then the '-X' option can be used to terminate
+wall-notify automatically when the X session quits. This is useful when
+wall-notify is started in `.xinitrc` and should quit when the X session ends,
+i.e the user logs out:
+
+    ./src/wall-notify -X cat
+
+
+By default only messages from root are displayed. To allow messages from other
+users (which includes `rwalld` in most setups) the option '-m' must be used.
+
+
 BUGS
 ----
 
+Doesn't work on OpenBSD which has no support for utmpx.h.
+
 If you find any bugs not mentioned in this document please report them to
 <simon@ruderich.org> with wall-notify in the subject.
 
@@ -70,7 +94,7 @@ LICENSE
 
 wall-notify is licensed under GPL version 3 or later.
 
-Copyright (C) 2014  Simon Ruderich
+Copyright (C) 2014-2015  Simon Ruderich
 
 This program is free software: you can redistribute it and/or modify
 it under the terms of the GNU General Public License as published by
@@ -84,3 +108,5 @@ GNU General Public License for more details.
 
 You should have received a copy of the GNU General Public License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+// vim: ft=asciidoc