aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorMattias Andrée <maandree@operamail.com>2015-05-17 13:38:00 +0200
committerMattias Andrée <maandree@operamail.com>2015-05-17 13:38:00 +0200
commitc1bd4ebe7f0399478a64f00272a937819566a915 (patch)
tree01c292d4f56fa272597205fbf3be6b224828ec17 /doc
parentspecifications for timed functions + fix manpage formatting (diff)
downloadbus-c1bd4ebe7f0399478a64f00272a937819566a915.tar.gz
bus-c1bd4ebe7f0399478a64f00272a937819566a915.tar.bz2
bus-c1bd4ebe7f0399478a64f00272a937819566a915.tar.xz
mentions stat in manpages
Signed-off-by: Mattias Andrée <maandree@operamail.com>
Diffstat (limited to '')
-rw-r--r--doc/bus-chgrp.17
-rw-r--r--doc/bus-chmod.17
-rw-r--r--doc/bus-chown.17
-rw-r--r--doc/bus_chmod.37
-rw-r--r--doc/bus_chown.37
5 files changed, 30 insertions, 5 deletions
diff --git a/doc/bus-chgrp.1 b/doc/bus-chgrp.1
index 2ae0307..d825e32 100644
--- a/doc/bus-chgrp.1
+++ b/doc/bus-chgrp.1
@@ -10,6 +10,10 @@ bus chgrp - Change group ownership of a bus
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
@@ -22,7 +26,8 @@ The command failed.
The command is not recognised.
.SH SEE ALSO
.BR bus-chown (1),
-.BR bus-chmod (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.
diff --git a/doc/bus-chmod.1 b/doc/bus-chmod.1
index fd88072..24f97e6 100644
--- a/doc/bus-chmod.1
+++ b/doc/bus-chmod.1
@@ -21,6 +21,10 @@ 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
@@ -33,7 +37,8 @@ The command failed.
The command is not recognised.
.SH SEE ALSO
.BR bus-chown (1),
-.BR bus-chgrp (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.
diff --git a/doc/bus-chown.1 b/doc/bus-chown.1
index 2436558..24487a1 100644
--- a/doc/bus-chown.1
+++ b/doc/bus-chown.1
@@ -13,6 +13,10 @@ 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
@@ -25,7 +29,8 @@ The command failed.
The command is not recognised.
.SH SEE ALSO
.BR bus-chgrp (1),
-.BR bus-chmod (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.
diff --git a/doc/bus_chmod.3 b/doc/bus_chmod.3
index 330a9d9..c2ac3f9 100644
--- a/doc/bus_chmod.3
+++ b/doc/bus_chmod.3
@@ -26,6 +26,10 @@ access to the bus. Otherwise the group should have no access.
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.
@@ -48,7 +52,8 @@ as well as any errors specified for the \fIIPC_STAT\fP and
.BR bus (5),
.BR libbus (7),
.BR bus_open (3),
-.BR bus_read (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.
diff --git a/doc/bus_chown.3 b/doc/bus_chown.3
index 186e937..fcde96b 100644
--- a/doc/bus_chown.3
+++ b/doc/bus_chown.3
@@ -13,6 +13,10 @@ The
.BR bus_chown ()
function change 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.
@@ -35,7 +39,8 @@ as well as any errors specified for the \fIIPC_STAT\fP and
.BR bus (5),
.BR libbus (7),
.BR bus_open (3),
-.BR bus_read (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.