Charles.Forsyth20060303-partialeea662d19 years agoHistory
94 lines · 2.0 KB · Text
RawDownload
.TH PLUMBER 8.SH NAMEplumber \- plumber for interapplication message routing.SH SYNOPSIS.B plumber[.B -v] [.B -w] [.BI -c " wmchan"] [.I rulefile\&...].SH DESCRIPTION.I Plumberprovides high-level message-passing between applications.In a plumbed environment,applications can receive messages on an input port, which is given a logical name.Messages are not sent directly between applications but are routed viathe plumber, following user-specified rules..PP.I Plumberis typically started by.IR wm (1)'sstartup script.It reads each.I rulefile(default:.BI /usr/ user /lib/plumbing )in turn.Each file has the form described in.IR plumbing (6);the rules direct the routing of each message.I plumberreceives..I Plumberthen lurks in the background with its mate,awaiting plumbing requests sent by.IR plumbmsg (2),by windowing applications in response to events such as button clicks or drag-and-drop,or by.IR plumb (1)..PPWhen a message arrives,.I plumberapplies the rules to decide how to route it.It forwards the message to the selected application's input port, starting it if necessary.If no rule applies (or some other error occurs),.I plumberreturns an error to the message's sender.The.B -voption causes.I plumberto log the contents of messages it receives, to help debug plumbing rules and applications..PP.I Plumbernormally starts applications directly.For use on devices that have specialisedwindow managers, not.IR wm (1),the.B -woption causes.I plumberto start applications indirectly, by sending a message toa window manager listening on.BR /chan/wm ,allowingthe window manager to track every application started.The.B -coption can select an alternative.I wmchanto.BR /chan/wm . .SH FILES.TF /usr/user/lib/plumbing.TP.BI /usr/ user /lib/plumbingdefault plumbing rules for.I user.SH SOURCE.B /appl/cmd/plumber.b.br.B /appl/lib/plumbing.b.SH SEE ALSO.IR plumb (1),.IR wm (1),.IR plumbmsg (2),.IR plumbing (6)