aboutsummaryrefslogtreecommitdiffstats
path: root/doc/man
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man')
-rw-r--r--doc/man/bus-broadcast.135
-rw-r--r--doc/man/bus-chgrp.138
-rw-r--r--doc/man/bus-chmod.149
-rw-r--r--doc/man/bus-chown.141
-rw-r--r--doc/man/bus-create.137
-rw-r--r--doc/man/bus-listen.132
-rw-r--r--doc/man/bus-remove.129
-rw-r--r--doc/man/bus-wait.133
-rw-r--r--doc/man/bus.177
-rw-r--r--doc/man/bus.550
-rw-r--r--doc/man/bus_chmod.364
-rw-r--r--doc/man/bus_chown.351
-rw-r--r--doc/man/bus_close.336
-rw-r--r--doc/man/bus_create.363
-rw-r--r--doc/man/bus_open.367
-rw-r--r--doc/man/bus_poll.387
-rw-r--r--doc/man/bus_read.379
-rw-r--r--doc/man/bus_unlink.356
-rw-r--r--doc/man/bus_write.364
-rw-r--r--doc/man/libbus.739
20 files changed, 0 insertions, 1027 deletions
diff --git a/doc/man/bus-broadcast.1 b/doc/man/bus-broadcast.1
deleted file mode 100644
index a4dc76c..0000000
--- a/doc/man/bus-broadcast.1
+++ /dev/null
@@ -1,35 +0,0 @@
-.TH BUS-BROADCAST 1 BUS-%VERSION%
-.SH NAME
-bus broadcast - Broadcast a message on a bus
-.SH SYNOPSIS
-.B bus broadcast
-.IR [options]
-[--]
-.IR pathname
-.IR message
-.SH DESCRIPTION
-Broadcast \fImessage\fP on the bus associated with \fIpathname\fP.
-.SH OPTIONS
-.TP
-.B \-n
-Fail if another process is attempting to broadcast on the bus.
-.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)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus-chgrp.1 b/doc/man/bus-chgrp.1
deleted file mode 100644
index d825e32..0000000
--- a/doc/man/bus-chgrp.1
+++ /dev/null
@@ -1,38 +0,0 @@
-.TH BUS-CHGRP 1 BUS-%VERSION%
-.SH NAME
-bus chgrp - Change group ownership of a bus
-.SH SYNOPSIS
-.B bus chgrp
-[--]
-.IR group
-.IR pathname
-.SH DESCRIPTION
-Change the group, that owns a bus with an associated \fIpathname\fP,
-to the specified \fIgroup\fP. The \fIgroup\fP can be specified either
-with a GID or with a group name.
-.PP
-The current ownership of a bus can be retrieved by running
-.BR stat (1)
-over the \fIpathname\fP of the bus.
-.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-chown (1),
-.BR bus-chmod (1),
-.BR stat (1)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus-chmod.1 b/doc/man/bus-chmod.1
deleted file mode 100644
index 3a44423..0000000
--- a/doc/man/bus-chmod.1
+++ /dev/null
@@ -1,49 +0,0 @@
-.TH BUS-CHMOD 1 BUS-%VERSION%
-.SH NAME
-bus chmod - Change permissions on a bus
-.SH SYNOPSIS
-.B bus chmod
-[--]
-.IR permissions
-.IR pathname
-.SH DESCRIPTION
-Change who have access to a bus with an associated \fIpathname\fP.
-In the \fIpermissions\fP, the owner, the group, and others (not
-in group) are represented by the symbols \fBu\fP, \fBg\fP, and
-\fBo\fP, respectively. The \fIpermissions\fP string is imagined
-to have always be prefixed with an \fB=\fP. This symbols means
-that all user classes list after it, and only those classes, as
-permission to use the bus. Similarly the symbols \fB+\fP and
-\fB\-\fP can be used to grant and revoke access, respectively.
-The symbols \fB=\fP, \fB+\fP, and \fB\-\fP can be mixed, and are
-interpreted from left to right. Alternatively the \fIpermissions\fP
-string can be a octal number, where the owner is represented by any
-bit in 700 (100, 200, or 400, or any combination thereof), the
-group is represented by any bit in 70, and others (not in the group)
-is represented by any bit in 7.
-.PP
-The current permissions of a bus can be retrieved by running
-.BR stat (1)
-over the \fIpathname\fP of the bus.
-.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-chown (1),
-.BR bus-chgrp (1),
-.BR stat (1)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus-chown.1 b/doc/man/bus-chown.1
deleted file mode 100644
index 24487a1..0000000
--- a/doc/man/bus-chown.1
+++ /dev/null
@@ -1,41 +0,0 @@
-.TH BUS-CHOWN 1 BUS-%VERSION%
-.SH NAME
-bus chown - Change ownership of a bus
-.SH SYNOPSIS
-.B bus chown
-[--]
-.IR owner[:group]
-.IR pathname
-.SH DESCRIPTION
-Change the owner, that owns a bus with an associated \fIpathname\fP,
-to the specified \fIowner\fP. The \fIowner\fP can be specified either
-with a UID or with a user name. If a \fIgroup\fP is specified, the
-bus's owner-group will be set to that \fIgroup\fP, otherwise the group
-will remain unchanged. The \fIgroup\fP can be specified either with
-a GID or with a group name.
-.PP
-The current ownership of a bus can be retrieved by running
-.BR stat (1)
-over the \fIpathname\fP of the bus.
-.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-chgrp (1),
-.BR bus-chmod (1),
-.BR stat (1)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus-create.1 b/doc/man/bus-create.1
deleted file mode 100644
index 91041cf..0000000
--- a/doc/man/bus-create.1
+++ /dev/null
@@ -1,37 +0,0 @@
-.TH BUS-CREATE 1 BUS-%VERSION%
-.SH NAME
-bus create - Create a bus
-.SH SYNOPSIS
-.B bus create
-.IR [options]
-[--]
-.IR [pathname]
-.SH DESCRIPTION
-Create a bus with an associated \fIpathname\fP. If \fIpathname\fP
-is omitted, a random pathname in \fI$XDG_RUNTIME_DIR/bus\fP will be
-created and printed to stdout.
-.SH OPTIONS
-.TP
-.B \-x
-Fail if the \fIpathname\fP already exists.
-.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),
-.BR bus-remove (1)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus-listen.1 b/doc/man/bus-listen.1
deleted file mode 100644
index 4977ce5..0000000
--- a/doc/man/bus-listen.1
+++ /dev/null
@@ -1,32 +0,0 @@
-.TH BUS-LISTEN 1 BUS-%VERSION%
-.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)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus-remove.1 b/doc/man/bus-remove.1
deleted file mode 100644
index 95e805c..0000000
--- a/doc/man/bus-remove.1
+++ /dev/null
@@ -1,29 +0,0 @@
-.TH BUS-REMOVE 1 BUS-%VERSION%
-.SH NAME
-bus remove - Remove a bus
-.SH SYNOPSIS
-.B bus remove
-[--]
-.IR pathname
-.SH DESCRIPTION
-Remove the bus associated with \fIpathname\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)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus-wait.1 b/doc/man/bus-wait.1
deleted file mode 100644
index 4231cd0..0000000
--- a/doc/man/bus-wait.1
+++ /dev/null
@@ -1,33 +0,0 @@
-.TH BUS-WAIT 1 BUS-%VERSION%
-.SH NAME
-bus wait - Listen for a new message on a bus
-.SH SYNOPSIS
-.B bus wait
-[--]
-.IR pathname
-.IR command
-.SH DESCRIPTION
-Listen for a new message on the bus associated with \fIpathname\fP, stop
-listening once a message has been received. 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)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus.1 b/doc/man/bus.1
deleted file mode 100644
index afb3925..0000000
--- a/doc/man/bus.1
+++ /dev/null
@@ -1,77 +0,0 @@
-.TH BUS 1 BUS-%VERSION%
-.SH NAME
-bus - A simple daemonless system for broadcasting messages locally
-.SH SYNOPSIS
-.B bus
-.IR command
-.IR argument\ ...
-.SH COMMANDS
-.TP
-.B create
-Create a bus, see
-.BR bus-create (1)
-for further details.
-.TP
-.B remove
-Remove a bus, see
-.BR bus-remove (1)
-for further details.
-.TP
-.B listen
-Listen for new message on a bus, see
-.BR bus-listen (1)
-for further details.
-.TP
-.B wait
-Listen for one new message only on a bus, see
-.BR bus-wait (1)
-for further details.
-.TP
-.B broadcast
-Broadcast a message on a bus, see
-.BR bus-broadcast (1)
-for further details.
-.TP
-.B chmod
-Change permissions on a bus, see
-.BR bus-chmod (1)
-for further details.
-.TP
-.B chown
-Change ownership of a bus, see
-.BR bus-chown (1)
-for further details.
-.TP
-.B chgrp
-Change group ownership of a bus, see
-.BR bus-chgrp (1)
-for further details.
-.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-create (1),
-.BR bus-remove (1),
-.BR bus-listen (1),
-.BR bus-wait (1),
-.BR bus-broadcast (1),
-.BR bus-chmod (1),
-.BR bus-chown (1),
-.BR bus-chgrp (1),
-.BR bus (5),
-.BR libbus (7)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus.5 b/doc/man/bus.5
deleted file mode 100644
index 0a5de7e..0000000
--- a/doc/man/bus.5
+++ /dev/null
@@ -1,50 +0,0 @@
-.TH BUS 5 BUS-%VERSION%
-.SH NAME
-bus - A simple daemonless system for broadcasting messages locally
-.SH DESCRIPTION
-\fBbus\fP is a simple interprocess communication system for broadcasting
-messages to other processes on the same machine. \fBbus\fP does not use
-any daemon. Instead, all communication and synchronisation is managed
-using System V (XSI) semaphores and System V (XSI) shared memory.
-.PP
-The command \fBbus create\fP can be used to create new buses. By
-convention, buses should be stored in \fI$XDG_RUNTIME_DIR/bus\fP, this is
-what \fBbus create\fP does if no pathname is given. The pathname of the
-bus should be tracked using \fIBUS_X\fP, where \fIX\fP is replaced with
-either:
-.TP
-.B GENERIC
-For the bus used in generic cases. That is all but the cases of the
-buses listed below.
-.TP
-.B AUDIO
-For the bus used in with the audio subsystem is involved.
-.TP
-.B VIDEO
-For the bus used in with the video subsystem is involved.
-.TP
-.B INPUT
-For the bus used in with the input subsystem is involved.
-.TP
-.B FILES
-For the bus used in with the storage subsystem is involved.
-.PP
-Messages broadcasted on a bus cannot be longer than 2047 bytes,
-excluding NULL termination. Message should be encoded in UTF-8,
-and most not contain the NULL character.
-.PP
-Broadcasted message should start with the process ID, or 0 if ephemeral,
-whence the message originated, followed by a single regular space.
-.SH SEE ALSO
-.BR bus (1),
-.BR libbus (7),
-.BR semop (2),
-.BR shmop (2)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus_chmod.3 b/doc/man/bus_chmod.3
deleted file mode 100644
index c2ac3f9..0000000
--- a/doc/man/bus_chmod.3
+++ /dev/null
@@ -1,64 +0,0 @@
-.TH BUS_CHMOD 3 BUS-%VERSION%
-.SH NAME
-bus_chmod - Change bus mode bits
-.SH SYNOPSIS
-.LP
-.nf
-#include <bus.h>
-.P
-int bus_chmod(const char *\fIfile\fP, mode_t \fImode\fP);
-.fi
-.SH DESCRIPTION
-The
-.BR bus_chmod ()
-function gives access to the bus associated with \fIfile\fP
-according to the following rules:
-.TP
-*
-If (\fImode\fP &S_IRWXU) the owner should be given full access to the
-bus. Otherwise the owner should have no access.
-.TP
-*
-If (\fImode\fP &S_IRWXG) the group should be given read and write
-access to the bus. Otherwise the group should have no access.
-.TP
-*
-If (\fImode\fP &S_IRWXO) others (except the group) should be given
-read and write access to the bus. Otherwise others should have no
-access.
-.PP
-The current permissions of a bus can be retrieved by running
-.BR stat (3)
-over the \fIpathname\fP of the bus.
-.SH RETURN VALUES
-Upon successful completion, the function returns 0. Otherwise the
-function returns -1 and sets \fIerrno\fP to indicate the error.
-.SH ERRORS
-The
-.BR bus_chown (3)
-function may fail and set \fIerrno\fP to any of the
-errors specified for
-.BR bus_open (3),
-.BR chmod (3),
-.BR semget (3),
-.BR shmget (3)
-and
-.BR shmctl (3)
-as well as any errors specified for the \fIIPC_STAT\fP and
-\fIIPC_SET\fP commands for
-.BR semctl (3).
-.SH SEE ALSO
-.BR bus-create (1),
-.BR bus (5),
-.BR libbus (7),
-.BR bus_open (3),
-.BR bus_read (3),
-.BR stat (3)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus_chown.3 b/doc/man/bus_chown.3
deleted file mode 100644
index c047d83..0000000
--- a/doc/man/bus_chown.3
+++ /dev/null
@@ -1,51 +0,0 @@
-.TH BUS_CHOWN 3 BUS-%VERSION%
-.SH NAME
-bus_chown - Change bus owner and group
-.SH SYNOPSIS
-.LP
-.nf
-#include <bus.h>
-.P
-int bus_chown(const char *\fIfile\fP, uid_t \fIowner\fP, gid_t \fIgroup\fP);
-.fi
-.SH DESCRIPTION
-The
-.BR bus_chown ()
-function changes the owner and the group of the bus associated with
-\fIfile\fP to the \fIowner\fP and \fIgroup\fP, respectively.
-.PP
-The current ownership of a bus can be retrieved by running
-.BR stat (3)
-over the \fIpathname\fP of the bus.
-.SH RETURN VALUES
-Upon successful completion, the function returns 0. Otherwise the
-function returns -1 and sets \fIerrno\fP to indicate the error.
-.SH ERRORS
-The
-.BR bus_chown (3)
-function may fail and set \fIerrno\fP to any of the
-errors specified for
-.BR bus_open (3),
-.BR chown (3),
-.BR semget (3),
-.BR shmget (3)
-and
-.BR shmctl (3)
-as well as any errors specified for the \fIIPC_STAT\fP and
-\fIIPC_SET\fP commands for
-.BR semctl (3).
-.SH SEE ALSO
-.BR bus-create (1),
-.BR bus (5),
-.BR libbus (7),
-.BR bus_open (3),
-.BR bus_read (3),
-.BR stat (3)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus_close.3 b/doc/man/bus_close.3
deleted file mode 100644
index dc35e6b..0000000
--- a/doc/man/bus_close.3
+++ /dev/null
@@ -1,36 +0,0 @@
-.TH BUS_CLOSE 3 BUS-%VERSION%
-.SH NAME
-bus_close - Close a bus
-.SH SYNOPSIS
-.LP
-.nf
-#include <bus.h>
-.P
-int bus_close(bus_t *\fIbus\fP);
-.fi
-.SH DESCRIPTION
-The
-.BR bus_close ()
-function disposes of resources allocated to the process, as referenced
-in the \fIbus\fP argument.
-.SH RETURN VALUES
-Upon successful completion, the function returns 0. Otherwise the
-function returns -1 and sets \fIerrno\fP to indicate the error.
-.SH ERRORS
-.TP
-.B EINVAL
-The bus does not exist.
-.SH SEE ALSO
-.BR bus-create (1),
-.BR bus (5),
-.BR libbus (7),
-.BR bus_open (3),
-.BR bus_unlink (3)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus_create.3 b/doc/man/bus_create.3
deleted file mode 100644
index 88e6efe..0000000
--- a/doc/man/bus_create.3
+++ /dev/null
@@ -1,63 +0,0 @@
-.TH BUS_CREATE 3 BUS-%VERSION%
-.SH NAME
-bus_create - Create a new bus
-.SH SYNOPSIS
-.LP
-.nf
-#include <bus.h>
-.P
-int bus_create(const char *\fIfile\fP, int \fIflags\fP, char **\fIout_file\fP);
-.fi
-.SH DESCRIPTION
-The
-.BR bus_create ()
-function creates a bus with the asscoiated pathname specifed by the
-value of the parameter \fIfile\fP. If \fIfile\fP is \fINULL\fP a random
-pathname is selected. This pathname adheres to the convention set forth
-by
-.BR bus (5).
-.PP
-If \fIfile\fP is not \fINULL\fP the
-.BR bus_create ()
-function fails if the file already exists if \fIflags\fP contains
-\fIBUS_EXCL\fP. Otherwise if \fIfile\fP is not \fINULL\fP, the
-.BR bus_create ()
-function does nothing if the file already exists.
-.PP
-If \fIflags\fP contains \fIBUS_INTR\fP, the function fails if it is
-interrupted.
-.PP
-Unless \fIout_file\fP is \fINULL\fP, the pathname of the bus should be
-stored in a new char array stored in \fI*out_file\fP. The caller must
-free the allocated stored in \fI*out_file\fP.
-.SH RETURN VALUES
-Upon successful completion, the function returns 0. Otherwise the
-function return -1 with \fIerrno\fP set to indicate the error.
-.SH ERRORS
-.TP
-.B ENOMEM
-The process cannot allocate more memory.
-.PP
-The
-.BR bus_create (3)
-function may also fail and set \fIerrno\fP to any
-of the errors specified for the routines
-.BR open (2)
-and
-.BR write (2).
-.SH SEE ALSO
-.BR bus-create (1),
-.BR bus (5),
-.BR libbus (7),
-.BR bus_unlink (3),
-.BR bus_open (3),
-.BR open (2),
-.BR write (2)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus_open.3 b/doc/man/bus_open.3
deleted file mode 100644
index 683ae9b..0000000
--- a/doc/man/bus_open.3
+++ /dev/null
@@ -1,67 +0,0 @@
-.TH BUS_OPEN 3 BUS-%VERSION%
-.SH NAME
-bus_open - Open a bus
-.SH SYNOPSIS
-.LP
-.nf
-#include <bus.h>
-.P
-int bus_open(bus_t *\fIbus\fP, const char *\fIfile\fP, int \fIflags\fP);
-.fi
-.SH DESCRIPTION
-The
-.BR bus_open ()
-function acquires resources required for the process to use the bus
-associated with the filename stored in \fIfile\fP. The function also
-stores the resources in \fIbus\fP for use by other
-.BR bus
-functions.
-.PP
-Values for \fIflags\fP are constructed by a bitwise inclusive OR of
-flags from the following list.
-.TP
-.B BUS_RDONLY
-The process will only be using the bus for receiving messages.
-.TP
-.B BUS_WRONLY
-The process will only be using the bus for sending messages.
-.TP
-.B BUS_RDWR
-The process will use the bus for both receiving and sending messages.
-.SH RETURN VALUES
-Upon successful completion the function returns 0. Otherwise the
-function returns -1 and set \fIerrno\fP to indicate the error.
-.SH ERRORS
-.TP
-.B ENOMEM
-The process cannot allocate more memory.
-.TP
-.B EACCES
-Operation permission is denied to the calling process.
-.TP
-.B EINVAL
-The described bus does not exist.
-.PP
-The
-.BR bus_open ()
-function may also fail and set \fIerrno\fP to any of the errors
-specified for the routine
-.BR open (2).
-.SH SEE ALSO
-.BR bus-create (1),
-.BR bus (5),
-.BR libbus (7),
-.BR bus_close (3),
-.BR bus_unlink (3),
-.BR bus_write (3),
-.BR bus_read (3),
-.BR bus_poll (3),
-.BR open (2)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus_poll.3 b/doc/man/bus_poll.3
deleted file mode 100644
index 95271ca..0000000
--- a/doc/man/bus_poll.3
+++ /dev/null
@@ -1,87 +0,0 @@
-.TH BUS_POLL 3 BUS-%VERSION%
-.SH NAME
-bus_poll_start, bus_poll_stop, bus_poll, bus_poll_timed - Wait a message to be broadcasted
-.SH SYNOPSIS
-.LP
-.nf
-#include <bus.h>
-.P
-int bus_poll_start(bus_t *\fIbus\fP);
-int bus_poll_stop(const bus_t *\fIbus\fP);
-const char *bus_poll(bus_t *\fIbus\fP, int \fIflags\fP);
-const char *bus_poll_timed(bus_t *\fIbus\fP, const struct timespec *\fItimeout\fP, clockid_t \fIclockid\fP);
-.fi
-.SH DESCRIPTION
-The
-.BR bus_poll ()
-function waits for a message to be broadcasted on the \fIbus\fP, and return
-the message it receives. The function fails if (\fIflags\fP &BUS_NOWAIT)
-and there is not already a message waiting on the bus. Received messages
-shall be copied and parsed, and acted upon, in a separate thread, and
-.BR bus_poll ()
-or
-.BR bus_poll_stop ()
-called again as soon as possible.
-.PP
-The
-.BR bus_poll_start ()
-funcion must be called before
-.BR bus_poll ()
-is called for the first time. When the process is done listening on the
-bus it must call the
-.BR bus_poll_stop ()
-function.
-.PP
-The
-.BR bus_poll_timed ()
-function behaves like
-.BR bus_poll (),
-except if it is not able to read a message within the specified time,
-it will fail and set \fIerrno\fP to \fBEAGAIN\fP. The time is specified
-as an absolute time using the parameter \fItimeout\fP. The behaviour is
-unspecified if \fItimeout\fP is \fINULL\fP. \fItimeout\fP is measured
-with the clock whose ID is specified by the \fIclockid\fP parameter. This
-clock must be a predicitable clock.
-.SH RETURN VALUES
-Upon successful completion, the functions
-.BR bus_poll_start ()
-and
-.BR bus_poll_stop ()
-returns 0. Otherwise the functions returns -1 and sets \fIerrno\fP to
-indicate the error.
-.PP
-Upon successful completion, the functions
-.BR bus_poll ()
-and
-.BR bus_poll_timed ()
-returns the received message. Otherwise the function returns \fINULL\fP
-and sets \fIerrno\fP to indicate the error.
-.SH ERRORS
-The
-.BR bus_poll (3),
-.BR bus_poll_start (3)
-and
-.BR bus_poll_stop (3)
-functions may fail and set \fIerrno\fP to any of the errors specified for
-.BR semop (3).
-The
-.BR bus_poll_timed (3)
-function may also set \fIerrno\fP to any of the errors specified for
-.BR clock_gettime (3).
-.SH SEE ALSO
-.BR bus-create (1),
-.BR bus (5),
-.BR libbus (7),
-.BR bus_open (3),
-.BR bus_write (3),
-.BR bus_read (3),
-.BR semop (3),
-.BR clock_gettime (3)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus_read.3 b/doc/man/bus_read.3
deleted file mode 100644
index 1caadfb..0000000
--- a/doc/man/bus_read.3
+++ /dev/null
@@ -1,79 +0,0 @@
-.TH BUS_READ 3 BUS-%VERSION%
-.SH NAME
-bus_read, bus_read_timed - Listen for new messages a bus
-.SH SYNOPSIS
-.LP
-.nf
-#include <bus.h>
-.P
-int bus_read(const bus_t *\fIbus\fP, int (*\fIcallback\fP)(const char *\fImessage\fP, void *\fIuser_data\fP),
- void *\fIuser_data\fP);
-int bus_read_timed(const bus_t *\fIbus\fP, int (*\fIcallback\fP)(const char *\fImessage\fP, void *\fIuser_data\fP),
- void *\fIuser_data\fP, const struct timespec *\fItimeout\fP, clockid_t \fIclockid\fP);
-.fi
-.SH DESCRIPTION
-The
-.BR bus_read ()
-function waits for new message to be sent on the bus specified in
-\fIbus\fP, as provieded by a previous call to the
-.BR bus_open ()
-function. Once a message is received, the \fIcallback\fP function is
-invoked. The \fImessage\fP argument to the callback is the received
-message, and \fIuser_data\fP for \fIcallback\fP should be
-\fIuser_data\fP from
-.BR bus_read ().
-However, once
-.BR bus_read ()
-has ensured that it will receive any message sent on the bus, it shall
-invoke the \fIcallback\fP function with \fImessage\fP set to \fINULL\fP,
-to notify the process that it can perform any action that requires that
-it is listening on the bus.
-.PP
-After \fIcallback\fP returns, \fImessage\fP may be override. Therefore
-\fIcallback\fP should copy \fImessage\fP and start a new thread that
-uses the copy of \fImessage\fP. \fIcallback\fP shall return -1 on
-failure, 0 if
-.BR bus_read ()
-should stop listening or 1 if
-.BR bus_read ()
-should continue listening.
-.PP
-The
-.BR bus_read_timed ()
-function behaves like
-.BR bus_read (),
-except it will automatically fail and set \fIerrno\fP to \fBEAGAIN\fP
-when the specified time has passed. The time is specified as an
-absolute time using the parameter \fItimeout\fP. The behaviour is
-unspecified if \fItimeout\fP is \fINULL\fP. \fItimeout\fP is measured
-with the clock whose ID is specified by the \fIclockid\fP parameter.
-This clock must be a predicitable clock.
-.SH RETURN VALUES
-Upon successful completion, these functions returns 0. Otherwise the
-function returns -1 and sets \fIerrno\fP to indicate the error.
-.SH ERRORS
-The
-.BR bus_read (3)
-function may fail and set \fIerrno\fP to any of the errors specified for
-.BR semop (3).
-The
-.BR bus_read_timed (3)
-function may also set \fIerrno\fP to any of the errors specified for
-.BR clock_gettime (3).
-.SH SEE ALSO
-.BR bus-create (1),
-.BR bus (5),
-.BR libbus (7),
-.BR bus_open (3),
-.BR bus_write (3),
-.BR bus_poll (3),
-.BR semop (3),
-.BR clock_gettime (3)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus_unlink.3 b/doc/man/bus_unlink.3
deleted file mode 100644
index 83ec760..0000000
--- a/doc/man/bus_unlink.3
+++ /dev/null
@@ -1,56 +0,0 @@
-.TH BUS_UNLINK 3 BUS-%VERSION%
-.SH NAME
-bus_unlink - Remove a bus
-.SH SYNOPSIS
-.LP
-.nf
-#include <bus.h>
-.P
-int bus_unlink(const char *\fIfile\fP);
-.fi
-.SH DESCRIPTION
-The
-.BR bus_unlink ()
-function removes the bus assoicated with the pathname stored in
-\fIfile\fP. The function also unlinks the file.
-.SH RETURN VALUES
-Upon successful completion, the function returns 0. Otherwise the
-function returns -1 and sets \fIerrno\fP to indicate the error.
-.SH ERRORS
-.TP
-.B EINVAL
-The bus does not exist.
-.TP
-.B EACCES
-Operation permission is denied to the calling process.
-.TP
-.B EPERM
-The user does not have permission to remove the bus.
-.PP
-The
-.BR bus_unlink (3)
-function may also fail and set \fIerrno\fP to any of the errors
-specified for the routines
-.BR unlink (2),
-.BR open (2),
-.BR semget (3)
-and
-.BR shmget (3).
-.SH SEE ALSO
-.BR bus-create (1),
-.BR bus (5),
-.BR libbus (7),
-.BR bus_create (3),
-.BR bus_close (3),
-.BR unlink (2),
-.BR open (2),
-.BR semget (3),
-.BR shmget (3)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/bus_write.3 b/doc/man/bus_write.3
deleted file mode 100644
index 4513c29..0000000
--- a/doc/man/bus_write.3
+++ /dev/null
@@ -1,64 +0,0 @@
-.TH BUS_WRITE 3 BUS-%VERSION%
-.SH NAME
-bus_write, bus_write_timed - Broadcast a message a bus
-.SH SYNOPSIS
-.LP
-.nf
-#include <bus.h>
-.P
-int bus_write(const bus_t *\fIbus\fP, const char *\fImessage\fP, int \fIflags\fP);
-int bus_write_timed(const bus_t *\fIbus\fP, const char *\fImessage\fP,
- const struct timespec *\fItimeout\fP, clockid_t \fIclockid\fP);
-.fi
-.SH DESCRIPTION
-The
-.BR bus_write ()
-function broadcasts a message on the bus whose information is stored in
-\fIbus\fP. The message read by the function is stored in the parameter
-\fImessage\fP. It may not exceeed 2048 bytes, including NULL termination.
-.PP
-The
-.BR bus_write ()
-function shall fail, and set \fIerrno\fP to \fIEAGAIN\fP, if the call
-would suspend the process and (\fIflags\fP &BUS_NOWAIT).
-.PP
-The
-.BR bus_write_timed ()
-function behaves like
-.BR bus_write (),
-except if it is not able to write the \fImessage\fP within the specified
-time, it will fail and set \fIerrno\fP to \fBEAGAIN\fP. The time is
-specified as an absolute time using the parameter \fItimeout\fP. The
-behaviour is unspecified if \fItimeout\fP is \fINULL\fP. \fItimeout\fP
-is measured with the clock whose ID is specified by the \fIclockid\fP
-parameter. This clock must be a predicitable clock.
-.SH RETURN VALUES
-Upon successful completion, these functions returns 0. Otherwise the
-function returns -1 and sets \fIerrno\fP to indicate the error.
-.SH ERRORS
-The
-.BR bus_write (3)
-function may fail and set \fIerrno\fP to any of the errors specified for
-.BR semop (3).
-The
-.BR bus_write_timed (3)
-function may also set \fIerrno\fP to any of the errors specified for
-.BR clock_gettime (3).
-.SH SEE ALSO
-.BR bus-create (1),
-.BR bus (5),
-.BR libbus (7),
-.BR bus_open (3),
-.BR bus_read (3),
-.BR bus_poll (3),
-.BR bus_chown (3),
-.BR bus_chmod (3),
-.BR clock_gettime (3)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org
diff --git a/doc/man/libbus.7 b/doc/man/libbus.7
deleted file mode 100644
index 804ee97..0000000
--- a/doc/man/libbus.7
+++ /dev/null
@@ -1,39 +0,0 @@
-.TH LIBBUS 7 BUS-%VERSION%
-.SH NAME
-libbus - A simple daemonless system for broadcasting messages locally
-.SH DESCRIPTION
-.BR bus
-is a stupid-simple, thrilless, daemonless interprocess communication
-system for broadcasting messages.
-.SH RATIONALE
-We need an interprocess communication system similar to message queues.
-But we need broadcasting rather than anycasting, so we have a fast,
-simple and daemonless system for announcing events to any processes that
-might be interested.
-.SH FUTURE DIRECTION
-None.
-.SH SEE ALSO
-.BR bus (1),
-.BR bus (5),
-.BR bus_create (3),
-.BR bus_unlink (3),
-.BR bus_open (3),
-.BR bus_close (3),
-.BR bus_write (3),
-.BR bus_write_timed (3),
-.BR bus_read (3),
-.BR bus_read_timed (3),
-.BR bus_poll_start (3),
-.BR bus_poll_stop (3),
-.BR bus_poll (3),
-.BR bus_poll_timed (3),
-.BR bus_chown (3),
-.BR bus_chmod (3)
-.SH AUTHORS
-Principal author, Mattias Andrée. See the LICENSE file for the full
-list of authors.
-.SH LICENSE
-MIT/X Consortium License.
-.SH BUGS
-Please report bugs to https://github.com/maandree/bus/issues or to
-maandree@member.fsf.org