packages icon
1/Introduction
2/Compilation
3/Use
4/feedback

1/Introduction
==============

gmessage+ is an enhanced clone of xmessage for gnome. It displays
a text that is specified either on the command line, or in a file,
or through a pipe, or through a socket.
When using sockets, gmessage+ can be either the server or the client.

2/Compilation
=============

To compile and install, see INSTALL.
However, here is the common way to do it:

./configure
make
make install

If you prefer RPMS, try this:

rpm -ta gmessage+-version.tgz

3/Use
=====

3.1/Simple use
--------------
Try gmsgp --help to get help on gmsgp.

3.2/Use in client mode
----------------------
gmessage+ contains a small utility f2sd. The job of f2sd is to read a file (for
example /etc/motd), then become a server that sends the content of that file.

Try this (as root for f2sd; replace "hostname" with your own hostname if gmsgp
command line):
f2sd -f /etc/motd -p 2000 &
gmsgp -f "socket://hostname:2000"
enjoy

3.3/Use in server mode
----------------------
Launch gmessage+ this way:
gmsgp -f "server://3000" --follow
                  (3000 is the server port. Change it as you wish)
WARNING: do not forget the "--follow" option,
                             otherwise, gmsgp will read... nothing!

Then, you can connect to the server via telnet or your own program.
For example:
telnet yourmachine.yourdomain 3000

You can also use the netsend program with this syntax:
netsend -m "your message" -s yourmachine.yourdomain -p 3000

netsend can read the message specified with the "-m" option through a pipe:
echo "your message" | netsend -m "-" -s yourmachine.yourdomain -p 3000

4/Feedback
==========

Send me feedback (ymettier@free.fr) to tell me, well... whatever you want!

French speaking people: n'hésitez pas à m'écrire en français, c'est ma langue
maternelle!