aboutsummaryrefslogtreecommitdiffstats
path: root/bus-listen.1
diff options
context:
space:
mode:
Diffstat (limited to 'bus-listen.1')
-rw-r--r--bus-listen.123
1 files changed, 23 insertions, 0 deletions
diff --git a/bus-listen.1 b/bus-listen.1
new file mode 100644
index 0000000..75a6106
--- /dev/null
+++ b/bus-listen.1
@@ -0,0 +1,23 @@
+.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)