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