README

   1 README
   2 ======
   3
   4 wall-notify is a simple program which receives all messages written by wall
   5 and passes them to a notification program via stdin. It's designed for
   6 simplistic desktop environments (like tiling window managers) or GNU
   7 Screen/Tmux sessions to notify the user about important messages like reboots.
   8 It was inspired by KDE's knotify.
   9
  10 wall messages are either directly created by root with the `wall` command or
  11 sent by other programs like `reboot`, `shutdown` or other processes like NFS
  12 to warn users when the NFS server terminates.
  13
  14 Optionally X11 can be used to automatically terminate wall-notify when the
  15 current X11 session terminates, i.e. when the user logs out. See below.
  16
  17 wall-notify is licensed under GPL 3 (or later).
  18
  19
  20 DEPENDENCIES
  21 ------------
  22
  23 - C89 compiler
  24 - libutempter or utmpx.h (utmpx.x requires a setgid utmp binary)
  25
  26 - optional: X11 headers and library, necessary for X11 support
  27
  28
  29 INSTALLATION
  30 ------------
  31
  32     ./configure && make && make check
  33
  34 The libutempter is not available, the binary must be setgid utmp:
  35
  36     chgrp utmp src/wall-notify
  37     chmod g+s src/wall-notify
  38
  39
  40 USAGE
  41 -----
  42
  43 To dump all wall messages to stdout use:
  44
  45     ./src/wall-notify cat
  46
  47 All arguments passed to `wall-notify` are used when execing the process, e.g.
  48 to replace all spaces with underlines use:
  49
  50     ./src/wall-notify sed 's/ /_/g'
  51
  52 To display the messages with `xmessage` use:
  53
  54     ./src/wall-notify xmessage -file -
  55
  56 However this will display '^M' (carriage-return) and other control characters
  57 in the message. For a simple wrapper script which removes those, see
  58 `contrib/message-helper`:
  59
  60     ./src/wall-notify contrib/message.sh xmessage -file -
  61
  62 The shell is not used when running the program.
  63
  64
  65 If X11 support is compiled in then the '-X' option can be used to terminate
  66 wall-notify automatically when the X session quits. This is useful when
  67 wall-notify is started in `.xinitrc` and should quit when the X session ends,
  68 i.e the user logs out:
  69
  70     ./src/wall-notify -X cat
  71
  72
  73 BUGS
  74 ----
  75
  76 Doesn't work on OpenBSD which has no support for utmpx.h.
  77
  78 If you find any bugs not mentioned in this document please report them to
  79 <simon@ruderich.org> with wall-notify in the subject.
  80
  81
  82 AUTHORS
  83 -------
  84
  85 Written by Simon Ruderich <simon@ruderich.org>.
  86
  87
  88 LICENSE
  89 -------
  90
  91 wall-notify is licensed under GPL version 3 or later.
  92
  93 Copyright (C) 2014  Simon Ruderich
  94
  95 This program is free software: you can redistribute it and/or modify
  96 it under the terms of the GNU General Public License as published by
  97 the Free Software Foundation, either version 3 of the License, or
  98 (at your option) any later version.
  99
 100 This program is distributed in the hope that it will be useful,
 101 but WITHOUT ANY WARRANTY; without even the implied warranty of
 102 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 103 GNU General Public License for more details.
 104
 105 You should have received a copy of the GNU General Public License
 106 along with this program.  If not, see <http://www.gnu.org/licenses/>.