man(1) Manual page archive


     PLUMBING(1)                                           PLUMBING(1)

     NAME
          plumbing - listen to plumb port and execute commands to
          attend messages

     SYNOPSIS
          plumbing [ -v ] port cmd [ arg... ]

     DESCRIPTION
          Plumbing spawns a child process to listen for messages in
          the plumber(8) port given as an argument. For each message
          received, it executes cmd as a shell command. The command
          has the environment variable $msg defined to contain the
          plumbed message data.

          Flag -v makes the program verbose, to report messages
          received.

          Note that in the octopus using ports(4) is preferred to
          plumber(8) for reporting events, because it does not require
          plumber ports to be created in advance.

     EXAMPLE
          Execute o/newterm each time a message is sent to the netget
          plumber port.

               o/plumbing  netget { /dis/o/newterm $msg & }

     SOURCE
          /usr/octopus/port/plumbing.b

     SEE ALSO
          plumber(8).