diff options
author | rwatson <rwatson@FreeBSD.org> | 2002-12-29 20:47:05 +0000 |
---|---|---|
committer | rwatson <rwatson@FreeBSD.org> | 2002-12-29 20:47:05 +0000 |
commit | bce6bfbbec294637e0155592caaded654445629a (patch) | |
tree | 985bdae2196acf3128685ad7f46fecd574f00a3f /lib/libc/posix1e/acl_get.3 | |
parent | 22c41db3e52c6f1d4dc6adf5207326b1259e119b (diff) | |
download | FreeBSD-src-bce6bfbbec294637e0155592caaded654445629a.zip FreeBSD-src-bce6bfbbec294637e0155592caaded654445629a.tar.gz |
Update libc POSIX.1e code and documentation to reflect:
- Updated copyrights, modified dates
- Remove "BUGS" entry indicating that ACLs are unimplemented
- Implement acl_*_link() library wrapper variants for get, set,
delete, aclvalid.
- Document acl_*_link() calls.
Obtained from: TrustedBSD Project
Diffstat (limited to 'lib/libc/posix1e/acl_get.3')
-rw-r--r-- | lib/libc/posix1e/acl_get.3 | 35 |
1 files changed, 21 insertions, 14 deletions
diff --git a/lib/libc/posix1e/acl_get.3 b/lib/libc/posix1e/acl_get.3 index 4ca86b5..e39c0a4 100644 --- a/lib/libc/posix1e/acl_get.3 +++ b/lib/libc/posix1e/acl_get.3 @@ -1,7 +1,9 @@ .\"- -.\" Copyright (c) 2000 Robert N. M. Watson +.\" Copyright (c) 2000, 2002 Robert N. M. Watson .\" All rights reserved. .\" +.\" This software was developed by Robert Watson for the TrustedBSD Project. +.\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: @@ -25,13 +27,14 @@ .\" .\" $FreeBSD$ .\" -.Dd January 28, 2000 +.Dd December 29, 2002 .Dt ACL_GET 3 .Os .Sh NAME .Nm acl_get_fd , .Nm acl_get_fd_np , -.Nm acl_get_file +.Nm acl_get_file , +.Nm acl_get_link_np .Nd get an ACL for a file .Sh LIBRARY .Lb libc @@ -39,23 +42,21 @@ .In sys/types.h .In sys/acl.h .Ft acl_t -.Fn acl_get_file "const char *path_p" "acl_type_t type" -.Ft acl_t .Fn acl_get_fd "int fd" .Ft acl_t .Fn acl_get_fd_np "int fd" "acl_type_t type" +.Ft acl_t +.Fn acl_get_file "const char *path_p" "acl_type_t type" +.Ft acl_t +.Fn acl_get_link_np "const char *path_p" "acl_type_t type" .Sh DESCRIPTION The -.Fn acl_get_file , .Fn acl_get_fd , -and +.Fn acl_get_file , +.Fn acl_get_link_np , .Fn acl_get_fd_np each allow the retrieval of an ACL from a file. The -.Fn acl_get_file -function -is a POSIX.1e call that allows the retrieval of a -specified type of ACL from a file by name; .Fn acl_get_fd is a POSIX.1e call that allows the retrieval of an ACL of type ACL_TYPE_ACCESS @@ -66,8 +67,16 @@ function is a non-portable form of .Fn acl_get_fd that allows the retrieval of any type of ACL from a file descriptor. +.Fn acl_get_file +is a POSIX.1e call that allows the retrieval of a +specified type of ACL from a file by name; +.Fn acl_get_link_np +is a non-portable variation on +.Fn acl_get_file +which does not follow a symlink if the target of the call is a +symlink. .Pp -This function may cause memory to be allocated. The caller should free +These functions may cause memory to be allocated. The caller should free any releasable memory, when the new ACL is no longer required, by calling .Xr acl_free 3 with the @@ -139,5 +148,3 @@ POSIX.1e support was introduced in and development continues. .Sh AUTHORS .An Robert N M Watson -.Sh BUGS -These features are not yet fully implemented. |