1.\" Copyright (c) 2001 Networks Associates Technology, Inc. 2.\" All rights reserved.
|
3.\"
|
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.\"
|
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.\" 3. The name of the author may not be used to endorse or promote 19.\" products derived from this software without specific prior written 20.\" permission.
|
21.\"
|
21.\" |
22.\" THIS SOFTWARE IS PROVIDED BY THE AUTHORS AND CONTRIBUTORS ``AS IS'' AND 23.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 24.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 25.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE LIABLE 26.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 27.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 28.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 29.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 30.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 31.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 32.\" SUCH DAMAGE.
|
33.\"
34.\" $FreeBSD: head/lib/libc/posix1e/mac_get.3 101242 2002-08-02 21:14:42Z rwatson $
|
33.\" 34.\" $FreeBSD: head/lib/libc/posix1e/mac_get.3 107603 2002-12-04 16:28:45Z ru $ 35.\" |
36.Dd December 21, 2001 37.Dt MAC_GET 3 38.Sh NAME 39.Nm mac_get_file , 40.Nm mac_get_fd , 41.Nm mac_get_proc 42.Nd get the label of a file, socket, socket peer or process
|
43.Sh LIBRARY 44.Lb libc |
45.Sh SYNOPSIS 46.In sys/mac.h 47.Ft mac_t 48.Fn mac_get_file "const char *path_p" 49.Ft mac_t 50.Fn mac_get_fd "int fd" 51.Ft mac_t 52.Fn mac_get_proc 53.Sh DESCRIPTION 54The 55.Fn mac_get_file 56and 57.Fn mac_get_fd 58functions return the MAC label associated 59with the file referenced by 60the pathname pointed to by 61.Fa path_p 62or the file descriptor specified by 63.Fa fd ,
|
61respectively. Note this function will
62fail on socket descriptors. For information on
|
64respectively. 65Note that this function will fail on socket descriptors. 66For information on |
67getting MAC labels on socket descriptors see 68.Xr getsockopt 2 . 69The 70.Fn mac_get_proc 71function returns a MAC label associated 72with the requesting process. 73.Sh ERRORS 74.Bl -tag -width Er 75.It Bq Er EACCES 76A component of 77.Fa path_p 78is not searchable, 79or MAC read access to the file 80is denied. 81.It Bq Er ENAMETOOLONG 82The pathname pointed to by 83.Fa path_p 84exceeds 85.Dv PATH_MAX , 86or a component of the pathname exceeds 87.Dv NAME_MAX . 88.It Bq Er ENOENT 89A component of 90.Fa path_p 91does not exist. 92.It Bq Er ENOMEM 93Insufficient memory is available 94to allocate a new MAC label structure. 95.It Bq Er ENOTDIR 96A component of 97.Fa path_p 98is not a directory. 99.El 100.Sh SEE ALSO 101.Xr mac 3 , 102.Xr mac_free 3 ,
|
99.Xr mac_text 3 ,
100.Xr mac_set 3
|
103.Xr mac_set 3 , 104.Xr mac_text 3 |
105.Sh STANDARDS 106POSIX.1e is described in IEEE POSIX.1e draft 17. 107Discussion of the draft 108continues on the cross-platform POSIX.1e implementation mailing list. 109To join this list, see the 110.Fx 111POSIX.1e implementation page 112for more information.
|