aboutsummaryrefslogtreecommitdiffstats
path: root/doc/bus-listen.1
diff options
context:
space:
mode:
Diffstat (limited to 'doc/bus-listen.1')
-rw-r--r--doc/bus-listen.132
1 files changed, 32 insertions, 0 deletions
diff --git a/doc/bus-listen.1 b/doc/bus-listen.1
new file mode 100644
index 0000000..89ae7d9
--- /dev/null
+++ b/doc/bus-listen.1
@@ -0,0 +1,32 @@
+.TH BUS-LISTEN 1 BUS-%VERSION%
+.SH NAME
+bus listen - Listen for new messages on a bus
+.SH SYNOPSIS
+.B bus wait
+.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 the \fI$arg\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
+bus(5)
+.SH AUTHORS
+See the LICENSE file for the authors.
+.SH LICENSE
+See the LICENSE file for the terms of redistribution.
+.SH BUGS
+Please report them.
+