Imported Upstream version 4.6.0.125

Former-commit-id: a2155e9bd80020e49e72e86c44da02a8ac0e57a4

mcs/class/referencesource/System/sys/system/security/accesscontrol/semaphoresecurity.cs

@@ -0,0 +1,267 @@
+// ==++==
+// 
+//   Copyright (c) Microsoft Corporation.  All rights reserved.
+// 
+// ==--==
+/*============================================================
+**
+** Class:  SemaphoreSecurity
+**
+** Purpose: Managed ACL wrapper for Win32 semaphores.
+**
+** Date:  November 26, 2003
+**
+===========================================================*/
+
+using System;
+using System.Collections;
+using System.Security.Permissions;
+using System.Security.Principal;
+using Microsoft.Win32;
+using Microsoft.Win32.SafeHandles;
+using System.Runtime.InteropServices;
+using System.IO;
+using System.Threading;
+
+namespace System.Security.AccessControl
+{
+    // Derive this list of values from winnt.h and MSDN docs:
+    // http://msdn.microsoft.com/library/default.asp?url=/library/en-us/dllproc/base/synchronization_object_security_and_access_rights.asp
+
+    // Win32's interesting values are SEMAPHORE_MODIFY_STATE (0x2) and
+    // SEMAPHORE_ALL_ACCESS (0x1F0003).  I don't know what 0x1 is.
+    [Flags, ComVisible(false)]
+    public enum SemaphoreRights
+    {
+        Modify               = 0x000002,
+        Delete               = 0x010000,
+        ReadPermissions      = 0x020000,
+        ChangePermissions    = 0x040000,
+        TakeOwnership        = 0x080000,
+        Synchronize          = 0x100000,  // SYNCHRONIZE
+        FullControl          = 0x1F0003
+    }
+
+    [ComVisible(false)]
+    public sealed class SemaphoreAccessRule : AccessRule
+    {
+        // Constructor for creating access rules for registry objects
+
+        public SemaphoreAccessRule(IdentityReference identity, SemaphoreRights eventRights, AccessControlType type) 
+            : this(identity, (int) eventRights, false, InheritanceFlags.None, PropagationFlags.None, type)
+        {
+        }
+
+        public SemaphoreAccessRule(String identity, SemaphoreRights eventRights, AccessControlType type) 
+            : this(new NTAccount(identity), (int) eventRights, false, InheritanceFlags.None, PropagationFlags.None, type)
+        {
+        }
+
+        //
+        // Internal constructor to be called by public constructors
+        // and the access rule factory methods of {File|Folder}Security
+        //
+        internal SemaphoreAccessRule(
+            IdentityReference identity,
+            int accessMask,
+            bool isInherited,
+            InheritanceFlags inheritanceFlags,
+            PropagationFlags propagationFlags,
+            AccessControlType type )
+            : base(
+                identity,
+                accessMask,
+                isInherited,
+                inheritanceFlags,
+                propagationFlags,
+                type )
+        {
+        }
+
+        public SemaphoreRights SemaphoreRights { 
+            get { return (SemaphoreRights) base.AccessMask; }
+        }
+    }
+
+    [ComVisible(false)]
+    public sealed class SemaphoreAuditRule : AuditRule
+    {
+        public SemaphoreAuditRule(IdentityReference identity, SemaphoreRights eventRights, AuditFlags flags)
+            : this(identity, (int) eventRights, false, InheritanceFlags.None, PropagationFlags.None, flags)
+        {
+        }
+
+        /*  // Not in the spec
+        public SemaphoreAuditRule(string identity, SemaphoreRights eventRights, AuditFlags flags)
+            : this(new NTAccount(identity), (int) eventRights, false, InheritanceFlags.None, PropagationFlags.None, flags)
+        {
+        }
+        */
+
+        internal SemaphoreAuditRule(IdentityReference identity, int accessMask, bool isInherited, InheritanceFlags inheritanceFlags, PropagationFlags propagationFlags, AuditFlags flags)
+            : base(identity, accessMask, isInherited, inheritanceFlags, propagationFlags, flags)
+        {
+        }
+        
+        public SemaphoreRights SemaphoreRights { 
+            get { return (SemaphoreRights) base.AccessMask; }
+        }
+    }
+
+    [ComVisible(false)]
+    public sealed class SemaphoreSecurity : NativeObjectSecurity
+    {
+        public SemaphoreSecurity()
+            : base(true, ResourceType.KernelObject)
+        {
+        }
+
+        public SemaphoreSecurity(String name, AccessControlSections includeSections)
+            : base(true, ResourceType.KernelObject, name, includeSections, _HandleErrorCode, null)
+        {
+            // Let the underlying ACL API's demand unmanaged code permission.
+        }
+
+        internal SemaphoreSecurity(SafeWaitHandle handle, AccessControlSections includeSections)
+            : base(true, ResourceType.KernelObject, handle, includeSections, _HandleErrorCode, null)
+        {
+            // Let the underlying ACL API's demand unmanaged code permission.
+        }
+
+        private static Exception _HandleErrorCode(int errorCode, string name, SafeHandle handle, object context)
+        {
+            System.Exception exception = null;
+            
+            switch (errorCode) {
+            case NativeMethods.ERROR_INVALID_NAME:
+            case NativeMethods.ERROR_INVALID_HANDLE:
+            case NativeMethods.ERROR_FILE_NOT_FOUND:
+                if ((name != null) && (name.Length != 0))
+                    exception = new WaitHandleCannotBeOpenedException(SR.GetString(SR.WaitHandleCannotBeOpenedException_InvalidHandle, name));
+                else
+                    exception = new WaitHandleCannotBeOpenedException();
+                break;
+
+            default:
+                break;
+            }
+
+            return exception;
+        }
+
+        public override AccessRule AccessRuleFactory(IdentityReference identityReference, int accessMask, bool isInherited, InheritanceFlags inheritanceFlags, PropagationFlags propagationFlags, AccessControlType type)
+        {
+            return new SemaphoreAccessRule(identityReference, accessMask, isInherited, inheritanceFlags, propagationFlags, type);
+        }
+
+        public override AuditRule AuditRuleFactory(IdentityReference identityReference, int accessMask, bool isInherited, InheritanceFlags inheritanceFlags, PropagationFlags propagationFlags, AuditFlags flags)
+        {
+            return new SemaphoreAuditRule(identityReference, accessMask, isInherited, inheritanceFlags, propagationFlags, flags);
+        }
+
+        internal AccessControlSections GetAccessControlSectionsFromChanges()
+        {
+            AccessControlSections persistRules = AccessControlSections.None;
+            if (AccessRulesModified)
+                persistRules = AccessControlSections.Access;
+            if (AuditRulesModified)
+                persistRules |= AccessControlSections.Audit;
+            if (OwnerModified)
+                persistRules |= AccessControlSections.Owner;
+            if (GroupModified)
+                persistRules |= AccessControlSections.Group;
+            return persistRules;
+        }
+
+        internal void Persist(SafeWaitHandle handle)
+        {
+            // Let the underlying ACL API's demand unmanaged code.
+
+            WriteLock();
+
+            try
+            {
+                AccessControlSections persistSections = GetAccessControlSectionsFromChanges();
+                if (persistSections == AccessControlSections.None)
+                    return;  // Don't need to persist anything.
+
+                base.Persist(handle, persistSections);
+                OwnerModified = GroupModified = AuditRulesModified = AccessRulesModified = false;
+            }
+            finally
+            {
+                WriteUnlock();
+            }
+        }
+
+        public void AddAccessRule(SemaphoreAccessRule rule)
+        {
+            base.AddAccessRule(rule);
+        }
+
+        public void SetAccessRule(SemaphoreAccessRule rule)
+        {
+            base.SetAccessRule(rule);
+        }
+
+        public void ResetAccessRule(SemaphoreAccessRule rule)
+        {
+            base.ResetAccessRule(rule);
+        }
+
+        public bool RemoveAccessRule(SemaphoreAccessRule rule)
+        {
+            return base.RemoveAccessRule(rule);
+        }
+
+        public void RemoveAccessRuleAll(SemaphoreAccessRule rule)
+        {
+            base.RemoveAccessRuleAll(rule);
+        }
+
+        public void RemoveAccessRuleSpecific(SemaphoreAccessRule rule)
+        {
+            base.RemoveAccessRuleSpecific(rule);
+        }
+                
+        public void AddAuditRule(SemaphoreAuditRule rule)
+        {
+            base.AddAuditRule(rule);
+        }
+
+        public void SetAuditRule(SemaphoreAuditRule rule)
+        {
+            base.SetAuditRule(rule);
+        }
+
+        public bool RemoveAuditRule(SemaphoreAuditRule rule)
+        {
+            return base.RemoveAuditRule(rule);
+        }
+
+        public void RemoveAuditRuleAll(SemaphoreAuditRule rule)
+        {
+            base.RemoveAuditRuleAll(rule);
+        }
+
+        public void RemoveAuditRuleSpecific(SemaphoreAuditRule rule)
+        {
+            base.RemoveAuditRuleSpecific(rule);
+        }
+
+        public override Type AccessRightType
+        {
+            get { return typeof(SemaphoreRights); }
+        }
+        
+        public override Type AccessRuleType
+        {
+            get { return typeof(SemaphoreAccessRule); }
+        }
+        
+        public override Type AuditRuleType
+        {
+            get { return typeof(SemaphoreAuditRule); }
+        }
+    }
+}