xref: /freebsd/lib/libc/posix1e/mac_is_present.3 (revision d97fcfce273eb3bc3984441c9e4bcbd5231fb1f5)
1d97fcfceSRobert Watson.\" Copyright (c) 2002 Networks Associates Technology, Inc.
2d97fcfceSRobert Watson.\" All rights reserved.
3d97fcfceSRobert Watson.\"
4d97fcfceSRobert Watson.\" This software was developed for the FreeBSD Project by Chris
5d97fcfceSRobert Watson.\" Costello at Safeport Network Services and NAI Labs, the Security
6d97fcfceSRobert Watson.\" Research Division of Network Associates, Inc. under DARPA/SPAWAR
7d97fcfceSRobert Watson.\" contract N66001-01-C-8035 ("CBOSS"), as part of the DARPA CHATS
8d97fcfceSRobert Watson.\" research program.
9d97fcfceSRobert Watson.\"
10d97fcfceSRobert Watson.\" Redistribution and use in source and binary forms, with or without
11d97fcfceSRobert Watson.\" modification, are permitted provided that the following conditions
12d97fcfceSRobert Watson.\" are met:
13d97fcfceSRobert Watson.\" 1. Redistributions of source code must retain the above copyright
14d97fcfceSRobert Watson.\"    notice, this list of conditions and the following disclaimer.
15d97fcfceSRobert Watson.\" 2. Redistributions in binary form must reproduce the above copyright
16d97fcfceSRobert Watson.\"    notice, this list of conditions and the following disclaimer in the
17d97fcfceSRobert Watson.\"    documentation and/or other materials provided with the distribution.
18d97fcfceSRobert Watson.\" 3. The name of the author may not be used to endorse or promote
19d97fcfceSRobert Watson.\"    products derived from this software without specific prior written
20d97fcfceSRobert Watson.\"    permission.
21d97fcfceSRobert Watson.\"
22d97fcfceSRobert Watson.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND
23d97fcfceSRobert Watson.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
24d97fcfceSRobert Watson.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
25d97fcfceSRobert Watson.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE
26d97fcfceSRobert Watson.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
27d97fcfceSRobert Watson.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
28d97fcfceSRobert Watson.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
29d97fcfceSRobert Watson.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
30d97fcfceSRobert Watson.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
31d97fcfceSRobert Watson.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
32d97fcfceSRobert Watson.\" SUCH DAMAGE.
33d97fcfceSRobert Watson.\"
34d97fcfceSRobert Watson.\" $FreeBSD$
35d97fcfceSRobert Watson.Dd January 9, 2002
36d97fcfceSRobert Watson.Dt MAC_IS_PRESENT_NP 3
37d97fcfceSRobert Watson.Sh NAME
38d97fcfceSRobert Watson.Nm mac_is_present_np
39d97fcfceSRobert Watson.Nd report whether the running system has MAC support
40d97fcfceSRobert Watson.Sh SYNOPSIS
41d97fcfceSRobert Watson.In sys/mac.h
42d97fcfceSRobert Watson.Ft int
43d97fcfceSRobert Watson.Fn mac_is_present "const char *policyname"
44d97fcfceSRobert Watson.Sh DESCRIPTION
45d97fcfceSRobert WatsonThe
46d97fcfceSRobert Watson.Fn mac_is_present_np
47d97fcfceSRobert Watsonfunction determines whether the currently-running kernel supports MAC for
48d97fcfceSRobert Watsona given policy or not.
49d97fcfceSRobert WatsonIf
50d97fcfceSRobert Watson.Fa policyname
51d97fcfceSRobert Watsonis non-
52d97fcfceSRobert Watson.Ns Dv NULL ,
53d97fcfceSRobert Watsonthe presence of the named policy
54d97fcfceSRobert Watson(e.g.
55d97fcfceSRobert Watson.Dq biba ,
56d97fcfceSRobert Watson.Dq mls ,
57d97fcfceSRobert Watson.Dq te )
58d97fcfceSRobert Watsonis checked, otherwise the presence of any MAC policies at all is checked.
59d97fcfceSRobert Watson.Sh RETURN VALUES
60d97fcfceSRobert WatsonIf the system supports the given MAC policy, the value 1 is returned.
61d97fcfceSRobert WatsonIf the specified MAC policy is not supported, the value 0 is returned.
62d97fcfceSRobert WatsonIf an error occurs, the value -1 is returned.
63d97fcfceSRobert Watson.Sh ERRORS
64d97fcfceSRobert Watson.Bl -tag -width Er
65d97fcfceSRobert Watson.It Bq Er EINVAL
66d97fcfceSRobert WatsonThe value of
67d97fcfceSRobert Watson.Fa policyname
68d97fcfceSRobert Watsonis not valid.
69d97fcfceSRobert Watson.It Bq Er ENOMEM
70d97fcfceSRobert WatsonInsufficient memory was available to allocate internal storage.
71d97fcfceSRobert Watson.El
72d97fcfceSRobert Watson.Sh SEE ALSO
73d97fcfceSRobert Watson.Xr mac 3
74