aboutsummaryrefslogtreecommitdiff
path: root/libbsm/au_control.3
diff options
context:
space:
mode:
Diffstat (limited to 'libbsm/au_control.3')
-rw-r--r--libbsm/au_control.353
1 files changed, 40 insertions, 13 deletions
diff --git a/libbsm/au_control.3 b/libbsm/au_control.3
index b3576ef1c87f..622fae21df3f 100644
--- a/libbsm/au_control.3
+++ b/libbsm/au_control.3
@@ -23,7 +23,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $P4: //depot/projects/trustedbsd/openbsm/libbsm/au_control.3#11 $
+.\" $P4: //depot/projects/trustedbsd/openbsm/libbsm/au_control.3#17 $
.\"
.Dd April 19, 2005
.Dt AU_CONTROL 3
@@ -32,10 +32,12 @@
.Nm setac ,
.Nm endac ,
.Nm getacdir ,
-.Nm getacmin ,
+.Nm getacdist ,
.Nm getacexpire ,
.Nm getacfilesz ,
.Nm getacflg ,
+.Nm getachost ,
+.Nm getacmin ,
.Nm getacna ,
.Nm getacpol ,
.Nm au_poltostr ,
@@ -52,7 +54,7 @@
.Ft int
.Fn getacdir "char *name" "int len"
.Ft int
-.Fn getacmin "int *min_val"
+.Fn getacdist "void"
.Ft int
.Fn getacexpire "int *andflg, time_t *age, size_t *size"
.Ft int
@@ -60,6 +62,10 @@
.Ft int
.Fn getacflg "char *auditstr" "int len"
.Ft int
+.Fn getachost "char *auditstr" "int len"
+.Ft int
+.Fn getacmin "int *min_val"
+.Ft int
.Fn getacna "char *auditstr" "int len"
.Ft int
.Fn getacpol "char *auditstr" "size_t len"
@@ -96,16 +102,13 @@ of length
.Fa len .
.Pp
The
-.Fn getacmin
-function
-returns the minimum free disk space for the audit log target file system via
-the passed
-.Fa min_val
-variable.
+.Fn getacdist
+function returns a value that allows to decide if trail files distribution is
+turned on or off.
.Pp
The
.Fn getacexpire
-function
+function
returns the audit trail file expiration parameters in the passed
.Vt int
buffer
@@ -113,7 +116,7 @@ buffer
.Vt time_t
buffer
.Fa age
-and
+and
.Vt size_t
buffer
.Fa size .
@@ -138,6 +141,23 @@ of length
.Fa len .
.Pp
The
+.Fn getachost
+function
+returns the local systems's audit host information via the the passed character
+buffer
+.Fa auditstr
+of length
+.Fa len .
+.Pp
+The
+.Fn getacmin
+function
+returns the minimum free disk space for the audit log target file system via
+the passed
+.Fa min_val
+variable.
+.Pp
+The
.Fn getacna
function
returns the non-attributable flags via the passed character buffer
@@ -172,10 +192,12 @@ to a numeric audit policy mask returned via
.Fa policy .
.Sh RETURN VALULES
The
+.Fn getacfilesz ,
.Fn getacdir ,
-.Fn getacmin ,
.Fn getacexpire ,
.Fn getacflg ,
+.Fn getachost ,
+.Fn getacmin ,
.Fn getacna ,
.Fn getacpol ,
and
@@ -191,6 +213,11 @@ function
returns a string length of 0 or more on success, or a negative value on
if there is a failure.
.Pp
+The
+.Fn getacdist
+function returns 1 if trail files distribution is turned on, 0 if it is turned
+off or negative value on failure.
+.Pp
Functions that return a string value will return a failure if there is
insufficient room in the passed character buffer for the full string.
.Sh SEE ALSO
@@ -221,7 +248,7 @@ The implementation should be changed to return an error via
when
.Dv NULL
is returned.
-.Sh BUGS
+.Pp
There is no reason for the
.Fn setac
interface to be exposed as part of the public API, as it is called implicitly