shithub: purgatorio

ref: 1dbb193077af7ba6ff7fb70a4dd465480764382e
dir: /man/1/plumb/

View raw version
.TH PLUMB 1
.SH NAME
plumb \- send message to plumber
.SH SYNOPSIS
.B plumb
[
.BI -s " src"
] [
.BI -d " dest"
] [
.BI -w " wdir"
] [
.BI -t " type"
] [
.BI -a " name value"
] [
.B -i
]
.I data
\&...
.SH DESCRIPTION
.I Plumb
sends a message to the plumber,
.IR plumber (8),
which is normally started by
.IR wm (1)'s
start up script.
.PP
The options and arguments are used as components of the message.
See
.IR plumbing (6)
for their interpretation.
The options are:
.TP
.BI -s " src"
Set the source to
.I src
(default: unspecified).
.TP
.BI -d " dest"
Set the destination to
.I dest
(default: unspecified).
.TP
.BI -w " wdir"
Set the working directory to
.I wdir
(default: current directory as reported by
.IR pwd (1)
or
.IR workdir (2)).
.TP
.BI -t " type"
Set the type of data to
.I type
(default:
.BR text )
.TP
.BI -a " name value"
Include an attribute
.RI ` name = value ';
there can be more than one.
.TP
.B -i
Take the
.I data
from the standard input not from the argument strings.
If an
.B action
attribute is not otherwise specified,
.I plumb
will add an
.B action=showdata
attribute to the message.
.PP
The remaining arguments are sent, separated by spaces, as the
.I data
of the message.
The plumber
will apply its rules to the resulting message to decide how to route it.
.SH FILES
.TF /chan/plumb.input
.TP
.B /chan/plumb.input
.IR plumber (8)
input channel
.SH SOURCE
.B /appl/cmd/plumb.b
.SH SEE ALSO
.IR plumbmsg (2),
.IR plumbing (6),
.IR plumber (8)