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
  35 USAGE
  36 -----
  37
  38 To dump all wall messages to stdout use:
  39
  40     ./src/wall-notify cat
  41
  42 All arguments passed to `wall-notify` are used when execing the process, e.g.
  43 to replace all spaces with underlines use:
  44
  45     ./src/wall-notify sed 's/ /_/g'
  46
  47 To display the messages with `xmessage` use:
  48
  49     ./src/wall-notify xmessage -file -
  50
  51 However this will display '^M' (carriage-return) and other control characters
  52 in the message. For a simple wrapper script which removes those, see
  53 `contrib/message-helper`:
  54
  55     ./src/wall-notify contrib/message.sh xmessage -file -
  56
  57 The shell is not used when running the program.
  58
  59
  60 If X11 support is compiled in then the '-X' option can be used to terminate
  61 wall-notify automatically when the X session quits. This is useful when
  62 wall-notify is started in `.xinitrc` and should quit when the X session ends,
  63 i.e the user logs out:
  64
  65     ./src/wall-notify -X cat
  66
  67
  68 BUGS
  69 ----
  70
  71 Doesn't work on OpenBSD which has no support for utmpx.h.
  72
  73 If you find any bugs not mentioned in this document please report them to
  74 <simon@ruderich.org> with wall-notify in the subject.
  75
  76
  77 AUTHORS
  78 -------
  79
  80 Written by Simon Ruderich <simon@ruderich.org>.
  81
  82
  83 LICENSE
  84 -------
  85
  86 wall-notify is licensed under GPL version 3 or later.
  87
  88 Copyright (C) 2014  Simon Ruderich
  89
  90 This program is free software: you can redistribute it and/or modify
  91 it under the terms of the GNU General Public License as published by
  92 the Free Software Foundation, either version 3 of the License, or
  93 (at your option) any later version.
  94
  95 This program is distributed in the hope that it will be useful,
  96 but WITHOUT ANY WARRANTY; without even the implied warranty of
  97 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  98 GNU General Public License for more details.
  99
 100 You should have received a copy of the GNU General Public License
 101 along with this program.  If not, see <http://www.gnu.org/licenses/>.