path: root/bus-listen.1

.TH BUS-LISTEN 1 BUS
.SH NAME
bus listen - Listen for new messages on a bus
.SH SYNOPSIS
.B bus listen
.IR pathname
.IR command
.SH DESCRIPTION
Listen for new messages on the bus associated with \fIpathname\fP.  Once
a message is received, \fIcommand\fP will be spawned with \fI$msg\fP set
to the received message.  POSIX shell syntax applies to \fIcommand\fP.
.SH EXIT STATUS
.TP
0
The command was successful.
.TP
1
The command failed.
.TP
2
The command is not recognised.
.SH SEE ALSO
.BR bus (5)