>From 3d02256bc3302cd60df969836a52b3dcdbb2ab55 Mon Sep 17 00:00:00 2001 From: Matthieu Patou Date: Sat, 13 Oct 2012 15:02:57 -0700 Subject: [PATCH] security: Add documentation Names seems to be a bit cryptic and misleading (at least for me). So documenting them should remove at least partially this problem. --- libcli/security/security.h | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/libcli/security/security.h b/libcli/security/security.h index 659d341..6e4b172 100644 --- a/libcli/security/security.h +++ b/libcli/security/security.h @@ -89,6 +89,15 @@ #define SHARE_ALL_ACCESS FILE_GENERIC_ALL #define SHARE_READ_ONLY (FILE_GENERIC_READ|FILE_EXECUTE) +/** + * Remaining access is a bit mask of remaining access rights (bits) that have + * to be granted in order to fulfill the requested access. + * + * The GUID is optional, if specified it restricts this object tree and its + * childs to object/attributes that inherits from this GUID. + * For DS access an object inherits from a GUID if one of its class has this GUID + * in the schemaIDGUID attribute. + */ struct object_tree { uint32_t remaining_access; struct GUID guid; -- 1.7.9.5