git: 409d1bf7d6de - main - Address review comments from 0mp, debdrup and oshogbo
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Tue, 16 Nov 2021 14:00:45 UTC
The branch main has been updated by gnn:
URL: https://cgit.FreeBSD.org/src/commit/?id=409d1bf7d6deef77ccf685e1624589997247a267
commit 409d1bf7d6deef77ccf685e1624589997247a267
Author: George V. Neville-Neil <gnn@FreeBSD.org>
AuthorDate: 2021-11-10 13:18:32 +0000
Commit: George V. Neville-Neil <gnn@FreeBSD.org>
CommitDate: 2021-11-10 18:09:18 +0000
Address review comments from 0mp, debdrup and oshogbo
---
lib/libcasper/libcasper/libcasper.3 | 19 ++++++++++---------
lib/libcasper/libcasper/libcasper_service.3 | 14 +++++++-------
lib/libcasper/services/cap_net/cap_net.3 | 2 +-
3 files changed, 18 insertions(+), 17 deletions(-)
diff --git a/lib/libcasper/libcasper/libcasper.3 b/lib/libcasper/libcasper/libcasper.3
index c08ea0f21f8b..02c08270dcf2 100644
--- a/lib/libcasper/libcasper/libcasper.3
+++ b/lib/libcasper/libcasper/libcasper.3
@@ -28,7 +28,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd January 3, 2021
+.Dd November 15, 2021
.Dt LIBCASPER 3
.Os
.Sh NAME
@@ -78,7 +78,8 @@
.Sh DESCRIPTION
The
.Nm libcasper
-library provides for the control of application capabilities through the casper process.
+library provides for the control of application capabilities through
+the casper process.
.Pp
An application capability, represented by the
.Vt cap_channel_t
@@ -86,7 +87,7 @@ type, is a communication channel between the caller and the casper
daemon or an instance of one of the daemon's services.
A capability to the casper process, obtained with the
.Fn cap_init
-function, allows a program to create capabilities to acacce
+function, allows a program to create capabilities to access
the casper daemon's services via the
.Fn cap_service_open
function.
@@ -107,7 +108,7 @@ system call,
or sent over a
.Xr unix 4
domain socket as a file descriptor,
-nd has to be converted into a
+and has to be converted into a
.Vt cap_channel_t .
The
.Fa flags
@@ -115,16 +116,15 @@ argument defines the channel behavior.
The supported flags are:
.Bl -ohang -offset indent
.It CASPER_NO_UNIQ
-The communication between the process and the casper daemon no unique version of nvlist.
+The communication between the process and the casper daemon no
+unique version of nvlist.
.El
.Pp
The
.Fn cap_unwrap
function returns the
.Xr unix 4
-domain socket that was provided to the
-.Fn cap_wrap
-function,
+domain socket used by the daemon service,
and frees the
.Vt cap_channel_t
structure.
@@ -191,7 +191,8 @@ The
.Fn cap_xfer_nvlist
function sends the given
.Xr nvlist 9 ,
-destroys it, and receives a new
+destroys it,
+and receives a new
.Xr nvlist 9
in response over the given capability.
It does not matter if the function succeeds or fails, the
diff --git a/lib/libcasper/libcasper/libcasper_service.3 b/lib/libcasper/libcasper/libcasper_service.3
index c210cdde182a..9e0f76cf98d0 100644
--- a/lib/libcasper/libcasper/libcasper_service.3
+++ b/lib/libcasper/libcasper/libcasper_service.3
@@ -24,7 +24,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd May 5, 2020
+.Dd November 15, 2021
.Dt LIBCASPER 3
.Os
.Sh NAME
@@ -47,7 +47,7 @@ typedef int service_command_func_t(const char *, const nvlist_t *, nvlist_t *,
.Sh DESCRIPTION
The
.Nm CREATE_SERVICE
-macro is used to create a new Casper service.
+macro is used to create a new casper service.
The
.Fa name
is a string containing the service name, which will be used in the
@@ -61,7 +61,7 @@ is a function of type
where the first argument of the function contains an containing
.Xr nvlist 9 ,
old service limits and the second argument contains the new limits.
-If the service wasn't limited then the old limits will be set to
+If the service was not limited then the old limits will be set to
.Dv NULL .
This function must not allow the extension of service limits.
The
@@ -76,7 +76,7 @@ contains the current limits and the second contains an
with the current request.
The last argument contains a return value
.Xr nvlist 9
-which contains the response from Casper.
+which contains the response from casper.
.Pp
The
.Fa flags
@@ -84,14 +84,14 @@ argument defines the limits of the service.
The supported flags are:
.Bl -ohang -offset indent
.It CASPER_SERVICE_STDIO
-The Casper service has access to the stdio descriptors from the process it was
+The casper service has access to the stdio descriptors from the process it was
spawned from.
.It CASPER_SERVICE_FD
-The Casper service has access to all of the descriptors,
+The casper service has access to all of the descriptors,
besides the stdio descriptors,
from the process it was spawned from.
.It CASPER_SERVICE_NO_UNIQ_LIMITS
-The whole Casper communication is using an
+The whole casper communication is using an
.Xr nvlist 9
with the
.Xr NVLIST_NO_UNIQ 9
diff --git a/lib/libcasper/services/cap_net/cap_net.3 b/lib/libcasper/services/cap_net/cap_net.3
index 765abbdf41aa..e64038a48330 100644
--- a/lib/libcasper/services/cap_net/cap_net.3
+++ b/lib/libcasper/services/cap_net/cap_net.3
@@ -23,7 +23,7 @@
.\"
.\" $FreeBSD$
.\"
-.Dd August 15, 2020
+.Dd November 15, 2021
.Dt CAP_NET 3
.Os
.Sh NAME