summaryrefslogtreecommitdiffstats
path: root/lib
diff options
context:
space:
mode:
authorru <ru@FreeBSD.org>2003-06-01 19:41:49 +0000
committerru <ru@FreeBSD.org>2003-06-01 19:41:49 +0000
commit2515dba9ffa5fb78deb2f57d151c441a4627f298 (patch)
treefb167ce34334358743b0c6c1792f2bf62b2a8804 /lib
parent395a389841261b0c00a85ddeeb14f3f709af41c7 (diff)
downloadFreeBSD-src-2515dba9ffa5fb78deb2f57d151c441a4627f298.zip
FreeBSD-src-2515dba9ffa5fb78deb2f57d151c441a4627f298.tar.gz
Assorted mdoc(7) fixes.
Diffstat (limited to 'lib')
-rw-r--r--lib/libugidfw/bsde_get_rule.345
-rw-r--r--lib/libugidfw/bsde_get_rule_count.324
-rw-r--r--lib/libugidfw/bsde_parse_rule.341
-rw-r--r--lib/libugidfw/bsde_rule_to_string.335
-rw-r--r--lib/libugidfw/libugidfw.320
5 files changed, 91 insertions, 74 deletions
diff --git a/lib/libugidfw/bsde_get_rule.3 b/lib/libugidfw/bsde_get_rule.3
index 7213652..1d8ffb1 100644
--- a/lib/libugidfw/bsde_get_rule.3
+++ b/lib/libugidfw/bsde_get_rule.3
@@ -1,12 +1,12 @@
.\" Copyright (c) 2003 Networks Associates Technology, Inc.
.\" All rights reserved.
-.\"
+.\"
.\" This software was developed for the FreeBSD Project by Chris
.\" Costello at Safeport Network Services and Network Associates
.\" Laboratories, the Security Research Division of Network Associates,
.\" Inc. under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part
.\" of the DARPA CHATS research program.
-.\"
+.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
@@ -15,7 +15,7 @@
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
-.\"
+.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@@ -27,24 +27,31 @@
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
-.\"
+.\"
.\" $FreeBSD$
-.Dd JANUARY 7, 2003
+.\"
+.Dd January 7, 2003
.Os
.Dt BSDE_GET_RULE 3
.Sh NAME
.Nm bsde_get_rule ,
.Nm bsde_set_rule ,
.Nm bsde_delete_rule
-.Nd file system firewall rules list management
+.Nd "file system firewall rules list management"
.Sh LIBRARY
.Lb libugidfw
.Sh SYNOPSIS
.In ugidfw.h
.Ft int
-.Fn bsde_get_rule "int rulenum" "struct mac_bsdextended_rule *rule" "size_t errlen" "char *errstr"
+.Fo bsde_get_rule
+.Fa "int rulenum" "struct mac_bsdextended_rule *rule"
+.Fa "size_t errlen" "char *errstr"
+.Fc
.Ft int
-.Fn bsde_set_rule "int rulenum" "struct mac_bsdextended_rule *rule" "size_t errlen" "char *errstr"
+.Fo bsde_set_rule
+.Fa "int rulenum" "struct mac_bsdextended_rule *rule"
+.Fa "size_t errlen" "char *errstr"
+.Fc
.Ft int
.Fn bsde_delete_rule "int rulenum" "size_t errlen" "char *errstr"
.Sh DESCRIPTION
@@ -59,7 +66,8 @@ If an error occurs,
is filled in with the error string
(up to
.Fa errlen
-characters, including the terminating NUL).
+characters, including the terminating
+.Dv NUL ) .
.Pp
The
.Fn bsde_set_rule
@@ -69,7 +77,7 @@ with the specified rule
(in
.Vt "struct mac_bsdextended_rule"
form, either from
-.Xr bsde_get_rule 3
+.Fn bsde_get_rule
or
.Xr bsde_parse_rule 3 ) .
If an error occurs,
@@ -77,7 +85,8 @@ If an error occurs,
is filled with the error string
(up to
.Fa errlen
-characters, including the terminating NUL).
+characters, including the terminating
+.Dv NUL ) .
.Pp
The
.Fn bsde_delete_rule
@@ -88,19 +97,16 @@ If an error occurs,
is filled with the error string
(up to
.Fa errlen
-characters, including the terminating NUL).
+characters, including the terminating
+.Dv NUL ) .
.Sh RETURN VALUES
The
.Fn bsde_get_rule ,
.Fn bsde_set_rule ,
and
.Fn bsde_delete_rule
-functions return
-.Li 0
-if successful;
-otherwise the value
-.Li \&-1
-is returned and the value of
+functions return 0 if successful;
+otherwise the value \-1 is returned and the value of
.Fa *errstr
is filled in as documented in
.Sx DESCRIPTION .
@@ -118,5 +124,6 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"),
+Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
diff --git a/lib/libugidfw/bsde_get_rule_count.3 b/lib/libugidfw/bsde_get_rule_count.3
index 2152f6a..3453311 100644
--- a/lib/libugidfw/bsde_get_rule_count.3
+++ b/lib/libugidfw/bsde_get_rule_count.3
@@ -1,12 +1,12 @@
.\" Copyright (c) 2003 Networks Associates Technology, Inc.
.\" All rights reserved.
-.\"
+.\"
.\" This software was developed for the FreeBSD Project by Chris
.\" Costello at Safeport Network Services and Network Associates
.\" Laboratories, the Security Research Division of Network Associates,
.\" Inc. under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part
.\" of the DARPA CHATS research program.
-.\"
+.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
@@ -15,7 +15,7 @@
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
-.\"
+.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@@ -27,15 +27,16 @@
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
-.\"
+.\"
.\" $FreeBSD$
-.Dd JANUARY 7, 2003
+.\"
+.Dd January 7, 2003
.Os
.Dt BSDE_GET_RULE_COUNT 3
.Sh NAME
.Nm bsde_get_rule_count ,
.Nm bsde_get_rule_slots
-.Nd file system firewall statistics
+.Nd "file system firewall statistics"
.Sh LIBRARY
.Lb libugidfw
.Sh SYNOPSIS
@@ -49,6 +50,7 @@ The
.Fn bsde_get_rule_count
and
.Fn bsde_get_rule_slots
+functions
return the total number of enforced rules
and the total number of used rule slots, respectively.
If an error occurs,
@@ -56,7 +58,8 @@ If an error occurs,
is filled in with the error string
(up to
.Fa errlen
-characters, including the terminating NUL).
+characters, including the terminating
+.Dv NUL ) .
.Sh RETURN VALUES
The
.Fn bsde_get_rule_count
@@ -65,9 +68,7 @@ and
functions return
the number of enforced rules and rule slots (respectively)
if successful;
-otherwise the value
-.Li \&-1
-is returned and the value of
+otherwise the value \-1 is returned and the value of
.Fa *errstr
is filled in as documented in
.Sx DESCRIPTION .
@@ -86,5 +87,6 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"),
+Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
diff --git a/lib/libugidfw/bsde_parse_rule.3 b/lib/libugidfw/bsde_parse_rule.3
index 47610bf..5a11abc4 100644
--- a/lib/libugidfw/bsde_parse_rule.3
+++ b/lib/libugidfw/bsde_parse_rule.3
@@ -1,12 +1,12 @@
.\" Copyright (c) 2003 Networks Associates Technology, Inc.
.\" All rights reserved.
-.\"
+.\"
.\" This software was developed for the FreeBSD Project by Chris
.\" Costello at Safeport Network Services and Network Associates
.\" Laboratories, the Security Research Division of Network Associates,
.\" Inc. under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part
.\" of the DARPA CHATS research program.
-.\"
+.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
@@ -15,7 +15,7 @@
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
-.\"
+.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@@ -27,28 +27,35 @@
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
-.\"
+.\"
.\" $FreeBSD$
-.Dd JANUARY 7, 2003
+.\"
+.Dd January 7, 2003
.Os
.Dt BSDE_PARSE_RULE 3
.Sh NAME
.Nm bsde_parse_rule ,
.Nm bsde_parse_rule_string
-.Nd parse file system firewall rules
+.Nd "parse file system firewall rules"
.Sh LIBRARY
.Lb libugidfw
.Sh SYNOPSIS
.In ugidfw.h
.Ft int
-.Fn bsde_parse_rule "int argc" "char *argv[]" "struct mac_bsdextended_rule *rule" "size_t buflen" "char *errstr"
+.Fo bsde_parse_rule
+.Fa "int argc" "char *argv[]" "struct mac_bsdextended_rule *rule"
+.Fa "size_t buflen" "char *errstr"
+.Fc
.Ft int
-.Fn bsde_parse_rule_string "const char *string" "struct mac_bsdextended_rule *rule" "size_t buflen" "char *errstr"
+.Fo bsde_parse_rule_string
+.Fa "const char *string" "struct mac_bsdextended_rule *rule"
+.Fa "size_t buflen" "char *errstr"
+.Fc
.Sh DESCRIPTION
The
.Fn bsde_parse_rule
function parses an argument vector
-(e.g.
+(e.g.\&
.Fa argv
as passed to
.Fn main )
@@ -59,24 +66,21 @@ If an error occurs,
is filled in with the error string
(up to
.Fa errlen
-characters, including the terminating NUL).
+characters, including the terminating
+.Dv NUL ) .
.Pp
The
.Fn bsde_parse_rule_string
function is identical to
.Fn bsde_parse_rule ,
-except that it parse a single string, rather than an array of arguments.
+except that it parses a single string rather than an array of arguments.
.Sh RETURN VALUES
The
.Fn bsde_parse_rule_string
and
.Fn bsde_parse_rule
-functions return
-.Li 0
-if successful;
-otherwise the value
-.Li \&-1
-is returned and the value of
+functions return 0 if successful;
+otherwise the value \-1 is returned and the value of
.Fa *errstr
is filled in as documented in
.Sx DESCRIPTION .
@@ -95,5 +99,6 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"),
+Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
diff --git a/lib/libugidfw/bsde_rule_to_string.3 b/lib/libugidfw/bsde_rule_to_string.3
index e022fd6..89a14aa 100644
--- a/lib/libugidfw/bsde_rule_to_string.3
+++ b/lib/libugidfw/bsde_rule_to_string.3
@@ -1,12 +1,12 @@
.\" Copyright (c) 2003 Networks Associates Technology, Inc.
.\" All rights reserved.
-.\"
+.\"
.\" This software was developed for the FreeBSD Project by Chris
.\" Costello at Safeport Network Services and Network Associates
.\" Laboratories, the Security Research Division of Network Associates,
.\" Inc. under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part
.\" of the DARPA CHATS research program.
-.\"
+.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
@@ -15,7 +15,7 @@
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
-.\"
+.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@@ -27,39 +27,39 @@
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
-.\"
+.\"
.\" $FreeBSD$
-.Dd JANUARY 7, 2003
+.\"
+.Dd January 7, 2003
.Os
.Dt BSDE_RULE_TO_STRING 3
.Sh NAME
.Nm bsde_rule_to_string
-.Nd converts a ugidfw rule into its text representation
+.Nd "convert a ugidfw rule into its text representation"
.Sh LIBRARY
.Lb libugidfw
.Sh SYNOPSIS
.In ugidfw.h
.Ft int
-.Fn bsde_rule_to_string "struct mac_bsdextended_rule *rule" "char *buf" "size_t buflen"
+.Fo bsde_rule_to_string
+.Fa "struct mac_bsdextended_rule *rule" "char *buf" "size_t buflen"
+.Fc
.Sh DESCRIPTION
The
.Fn bsde_rule_to_string
function converts a rule in its internal representation
-.Vt ( "struct mac_bsdextended_rule" )
-into its text representation and writes up to
+.Pq Vt "struct mac_bsdextended_rule"
+into its text representation, and writes up to
.Fa buflen
bytes of it to
.Fa buf
-(including the terminating NUL).
+(including the terminating
+.Dv NUL ) .
.Sh RETURN VALUES
The
.Fn bsde_rule_to_string
-function returns
-.Li \&-1
-if the conversion was truncated;
-otherwise the value
-.Li 0
-is returned.
+function returns \-1 if the conversion was truncated;
+otherwise the value 0 is returned.
.Sh SEE ALSO
.Xr bsde_delete_rule 3 ,
.Xr bsde_get_rule 3 ,
@@ -76,5 +76,6 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"),
+Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
diff --git a/lib/libugidfw/libugidfw.3 b/lib/libugidfw/libugidfw.3
index 1bde9d2..5b32be0 100644
--- a/lib/libugidfw/libugidfw.3
+++ b/lib/libugidfw/libugidfw.3
@@ -1,12 +1,12 @@
.\" Copyright (c) 2003 Networks Associates Technology, Inc.
.\" All rights reserved.
-.\"
+.\"
.\" This software was developed for the FreeBSD Project by Chris
.\" Costello at Safeport Network Services and Network Associates
.\" Laboratories, the Security Research Division of Network Associates,
.\" Inc. under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"), as part
.\" of the DARPA CHATS research program.
-.\"
+.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
@@ -15,7 +15,7 @@
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
-.\"
+.\"
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@@ -27,14 +27,15 @@
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
-.\"
+.\"
.\" $FreeBSD$
-.Dd JANUARY 5, 2003
+.\"
+.Dd January 5, 2003
.Os
.Dt LIBUGIDFW 3
.Sh NAME
.Nm libugidfw
-.Nd library interface to the file system firewall MAC policy
+.Nd "library interface to the file system firewall MAC policy"
.Sh LIBRARY
.Lb libugidfw
.Sh SYNOPSIS
@@ -49,10 +50,10 @@ file system firewall MAC policy.
The
.Nm
library defines the following functions:
-.Bl -tag -width "bsde_parse_rule_strong"
+.Bl -tag -width ".Fn bsde_parse_rule_string"
.It Fn bsde_rule_to_string
Converts the internal representation of a rule
-.Vt ( "struct mac_bsdextended_rule" )
+.Pq Vt "struct mac_bsdextended_rule"
into its text representation;
see
.Xr bsde_rule_to_string 3 .
@@ -112,5 +113,6 @@ This software was contributed to the
.Fx
Project by Network Associates Labs,
the Security Research Division of Network Associates
-Inc. under DARPA/SPAWAR contract N66001-01-C-8035 ("CBOSS"),
+Inc. under DARPA/SPAWAR contract N66001-01-C-8035
+.Pq Dq CBOSS ,
as part of the DARPA CHATS research program.
OpenPOWER on IntegriCloud