diff options
Diffstat (limited to 'lib/libc/posix1e/acl_valid.3')
-rw-r--r-- | lib/libc/posix1e/acl_valid.3 | 26 |
1 files changed, 18 insertions, 8 deletions
diff --git a/lib/libc/posix1e/acl_valid.3 b/lib/libc/posix1e/acl_valid.3 index 6e1b3d9..3d47da5 100644 --- a/lib/libc/posix1e/acl_valid.3 +++ b/lib/libc/posix1e/acl_valid.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_VALID 3 .Os .Sh NAME .Nm acl_valid , .Nm acl_valid_fd_np , -.Nm acl_valid_file_np +.Nm acl_valid_file_np , +.Nm acl_valid_link_np .Nd validate an ACL .Sh LIBRARY .Lb libc @@ -44,6 +47,8 @@ .Fn acl_valid_fd_np "int fd" "acl_type_t type" "acl_t acl" .Ft int .Fn acl_valid_file_np "const char *path_p" "acl_type_t type" "acl_t acl" +.Ft int +.Fn acl_valid_link_np "const char *path_p" "acl_type_t type" "acl_t acl" .Sh DESCRIPTION These functions check that the ACL referred to by the argument .Va acl @@ -51,13 +56,20 @@ is valid. The POSIX.1e routine, .Fn acl_valid , checks this validity only with POSIX.1e ACL semantics, and irrespective of the context in which the ACL is to be used. The non-portable forms, -.Fn acl_valid_fd_np -and +.Fn acl_valid_fd_np , .Fn acl_valid_file_np , +and +.Fn acl_valid_link_np allow an ACL to be checked in the context of a specific acl type, .Va type , -and file system object. In environments where additional ACL types are +and file system object. +In environments where additional ACL types are supported than just POSIX.1e, this makes more sense. +Whereas +.Fn acl_valid_file_np +will follow the symlink if the specified path is to a symlink, +.Fn acl_valid_link_np +will not. .Pp For POSIX.1e semantics, the checks include: .Bd -literal -offset indent @@ -140,5 +152,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. |