+subject: mspd - receive message using MSP

MSPD(1)                                                   MSPD(1)



NAME
       mspd - receive message using MSP

SYNOPSIS
       mspd [options] [deliver [arg]]

DESCRIPTION
       mspd  receives  messages via the message send protocol MSP
       as described in RFC 1312 and delivers it to  any  terminal
       the  user is logged in.  If at least one terminal is found
       mspd acknowledges the delivery if the message was  a  uni-
       cast  packet.   An alternative deliver program can be used
       for different delivery behaviour.   In  this  mode  mspd's
       acknowledgement  means  only  the  succesful  start of the
       delivery program, not the delivery itself.

       mspd can be launched from inetd(8).  A possible configura-
       tion could be

          18  dgram  udp  wait  root  \
              /usr/local/sbin/mspd mspd -bc

       in your inetd.conf.

       If it finds that it's not connected to an UDP port (and is
       therefore not started by inetd)  it  enters  automatically
       it's  daemon  mode,  binding itself to UDP port 18 waiting
       for incoming packets.

   External Delivery
       mspd has a builtin  understanding  of  how  to  deliver  a
       received  message.   You might want to change this by sup-
       plying your own deliver program,  with  or  without  addi-
       tional  arguments  on  mspd's  command line.  The delivery
       program receives the message parameters in  the  following
       environment variables:

       MSG_CLIENT
              the client's IP number

       MSG_COOKIE
              the message's cookie.

       MSG_LINES
              number of lines in the message.

       MSG_PID
              the server's process id.

       MSG_PORT
              the   server's   port  on  which  the  message  was
              received.

       MSG_RCPT
              the addressed recipient.

       MSG_SENDER
              the message's sender.

       MSG_SIGNATURE
              the message signature.

       MSG_SIZE
              message size in bytes.

       MSG_SRCPORT
              the client's source port.

       MSG_STERM
              the sender's terminal.

       MSG_TERM
              the recipient's terminal as addressed by  the  mes-
              sage.

       MSG_TEXT
              the message itself.

       MSG_TIME
              the  time in seconds since 01.01.1970 when the mes-
              sage was received.

       Notice that some of the variables above may be empty.

OPTIONS
       send supports the following options:

       -b     beep on delivery.

       -c     colorize the messages.

       -m     write received messages only to those  terminal  on
              which  the receiving user granted permissions using
              mesg(1).

       -p [interface:]port
              binds to port on interface in daemon mode.

       -s     write errors to syslog.  This option  is  automati-
              cally turned on if mspd is started from

       -w ttylist
              bypass  the  internal  tty  selection and write all
              messages to any of  the  given  ttys.   ttylist  is
              expected to be a comma separated list of tty names,
              not device names.

       The options -b, -c and -m are only in effect if no  exter-
       nal delivery program is given.  inetd(8).

SEE ALSO
       mesg(1), send(1).



                         07 NOVEMBER 2003                 MSPD(1)