aboutsummaryrefslogtreecommitdiffstats
path: root/doc/bus_open.3
diff options
context:
space:
mode:
authorMattias Andrée <maandree@operamail.com>2015-04-17 00:42:04 +0200
committerMattias Andrée <maandree@operamail.com>2015-04-17 00:42:04 +0200
commit4d7037fc66497560abf736786f1ce4cf14106586 (patch)
treeaaa76894627796bb79a599db2636e536674003bf /doc/bus_open.3
parentm libbus.7: future direction (diff)
downloadbus-4d7037fc66497560abf736786f1ce4cf14106586.tar.gz
bus-4d7037fc66497560abf736786f1ce4cf14106586.tar.bz2
bus-4d7037fc66497560abf736786f1ce4cf14106586.tar.xz
add man3
Signed-off-by: Mattias Andrée <maandree@operamail.com>
Diffstat (limited to 'doc/bus_open.3')
-rw-r--r--doc/bus_open.331
1 files changed, 31 insertions, 0 deletions
diff --git a/doc/bus_open.3 b/doc/bus_open.3
new file mode 100644
index 0000000..cdd51cf
--- /dev/null
+++ b/doc/bus_open.3
@@ -0,0 +1,31 @@
+.TH BUS_OPEN 1 BUS-%VERSION%
+.SH NAME
+bus_open - Open a bus
+.SH SYNOPSIS
+#include <bus.h>
+
+int bus_open(bus_t *bus, const char *file, int flags);
+.SH DESCRIPTION
+The \fIbus_open\fP function shall acquire the resources required for the process to use the bus associated with the filename stored in \fIfile\fP. The function shall also store these resource \fIbus\fP for use by other \fBbus\fP functions.
+
+Values for \fIflags\fP are constructed by a bitwise-inclusive OR of flags from the following list.
+.TP
+.IR BUS_RDONLY
+The process will only be using the bus for receiving messages.
+.TP
+.IR BUS_WRONLY
+The process will only be using the bus for sending messages.
+.TP
+.IR BUS_RDWR
+The process will use the bus for both receiving adn sending messages.
+.SH RETURN VALUES
+Upon successful completion, the function shall return 0. Otherwise the function shall return -1 and set \fIerrno\fP to indicate the error.
+.SH SEE ALSO
+bus-create(1), bus(5), libbus(7), bus_open(3), bus_unlink(3)
+.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.
+