Struct SecACL 

pub struct SecACL { /* private fields */ }

Available on crate feature SecBase only.

Contains information about an access control list (ACL) entry.

See also Apple’s documentation

Implementations

impl SecACL

pub unsafe fn create_from_simple_contents( access: &SecAccess, application_list: Option<&CFArray>, description: &CFString, prompt_selector: NonNull<CSSM_ACL_KEYCHAIN_PROMPT_SELECTOR>, new_acl: NonNull<*mut SecACL>, ) -> i32

👎Deprecated: CSSM is not supported

Available on crate features SecACL and cssmapple and cssmconfig only.

Creates a new access control list entry from the application list, description, and prompt selector provided and adds it to an item’s access.

Parameter access: An access reference.

Parameter applicationList: An array of SecTrustedApplication instances that will be allowed access without prompting.

Parameter description: The human readable name that will be used to refer to this item when the user is prompted.

Parameter promptSelector: A pointer to a CSSM prompt selector.

Parameter newAcl: A pointer to an access control list entry. On return, this points to the reference of the new access control list entry.

Returns: A result code. See “Security Error Codes” (SecBase.h).

This function is deprecated in 10.7 and later; use SecACLCreateWithSimpleContents instead.

Safety

• application_list generic must be of the correct type.
• prompt_selector must be a valid pointer.
• new_acl must be a valid pointer.

pub unsafe fn create_with_simple_contents( access: &SecAccess, application_list: Option<&CFArray>, description: &CFString, prompt_selector: SecKeychainPromptSelector, new_acl: NonNull<*mut SecACL>, ) -> i32

👎Deprecated: SecKeychain is deprecated

Available on crate features SecACL and cssmconfig only.

Creates a new access control list entry from the application list, description, and prompt selector provided and adds it to an item’s access.

Parameter access: An access reference.

Parameter applicationList: An array of SecTrustedApplication instances that will be allowed access without prompting.

Parameter description: The human readable name that will be used to refer to this item when the user is prompted.

Parameter promptSelector: A SecKeychainPromptSelector selector.

Parameter newAcl: A pointer to an access control list entry. On return, this points to the reference of the new access control list entry.

Returns: A result code. See “Security Error Codes” (SecBase.h).

Safety

• application_list generic must be of the correct type.
• new_acl must be a valid pointer.

pub unsafe fn remove(&self) -> i32

👎Deprecated: SecKeychain is deprecated

Available on crate feature SecACL only.

Removes the access control list entry specified.

Parameter aclRef: The reference to the access control list entry to remove.

Returns: A result code. See “Security Error Codes” (SecBase.h).

pub unsafe fn copy_simple_contents( &self, application_list: NonNull<*const CFArray>, description: NonNull<*const CFString>, prompt_selector: NonNull<CSSM_ACL_KEYCHAIN_PROMPT_SELECTOR>, ) -> i32

👎Deprecated: CSSM is not supported

Available on crate features SecACL and cssmapple and cssmconfig only.

Returns the application list, description, and CSSM prompt selector for a given access control list entry.

Parameter acl: An access control list entry reference.

Parameter applicationList: On return, An array of SecTrustedApplication instances that will be allowed access without prompting, for the given access control list entry. The caller needs to call CFRelease on this array when it’s no longer needed.

Parameter description: On return, the human readable name that will be used to refer to this item when the user is prompted, for the given access control list entry. The caller needs to call CFRelease on this string when it’s no longer needed.

Parameter promptSelector: A pointer to a CSSM prompt selector. On return, this points to the CSSM prompt selector for the given access control list entry.

Returns: A result code. See “Security Error Codes” (SecBase.h).

This function is deprecated in 10.7 and later; use SecACLCopyContents instead.

Safety

• application_list must be a valid pointer.
• description must be a valid pointer.
• prompt_selector must be a valid pointer.

pub unsafe fn copy_contents( &self, application_list: NonNull<*const CFArray>, description: NonNull<*const CFString>, prompt_selector: NonNull<SecKeychainPromptSelector>, ) -> i32

👎Deprecated: SecKeychain is deprecated

Available on crate features SecACL and cssmconfig only.

Returns the application list, description, and prompt selector for a given access control list entry.

Parameter acl: An access control list entry reference.

Parameter applicationList: On return, An array of SecTrustedApplication instances that will be allowed access without prompting, for the given access control list entry. The caller needs to call CFRelease on this array when it’s no longer needed.

Parameter description: On return, the human readable name that will be used to refer to this item when the user is prompted, for the given access control list entry. The caller needs to call CFRelease on this string when it’s no longer needed.

Parameter promptSelector: A pointer to a SecKeychainPromptSelector. On return, this points to the SecKeychainPromptSelector for the given access control list entry.

Returns: A result code. See “Security Error Codes” (SecBase.h).

Safety

• application_list must be a valid pointer.
• description must be a valid pointer.
• prompt_selector must be a valid pointer.

pub unsafe fn set_simple_contents( &self, application_list: Option<&CFArray>, description: &CFString, prompt_selector: NonNull<CSSM_ACL_KEYCHAIN_PROMPT_SELECTOR>, ) -> i32

👎Deprecated: CSSM is not supported

Available on crate features SecACL and cssmapple and cssmconfig only.

Sets the application list, description, and CSSM prompt selector for a given access control list entry.

Parameter acl: A reference to the access control list entry to edit.

Parameter applicationList: An application list reference.

Parameter description: The human readable name that will be used to refer to this item when the user is prompted.

Parameter promptSelector: A pointer to a CSSM prompt selector.

Returns: A result code. See “Security Error Codes” (SecBase.h).

This function is deprecated in 10.7 and later; use SecACLSetContents instead.

Safety

• application_list generic must be of the correct type.
• prompt_selector must be a valid pointer.

pub unsafe fn set_contents( &self, application_list: Option<&CFArray>, description: &CFString, prompt_selector: SecKeychainPromptSelector, ) -> i32

👎Deprecated: SecKeychain is deprecated

Available on crate features SecACL and cssmconfig only.

Sets the application list, description, and prompt selector for a given access control list entry.

Parameter acl: A reference to the access control list entry to edit.

Parameter applicationList: An application list reference.

Parameter description: The human readable name that will be used to refer to this item when the user is prompted.

Parameter promptSelector: A SecKeychainPromptSelector selector.

Returns: A result code. See “Security Error Codes” (SecBase.h).

Safety

application_list generic must be of the correct type.

pub unsafe fn get_authorizations( &self, tags: NonNull<CSSM_ACL_AUTHORIZATION_TAG>, tag_count: NonNull<uint32>, ) -> i32

👎Deprecated: CSSM is not supported

Available on crate features SecACL and cssmconfig and cssmtype only.

Retrieve the CSSM authorization tags of a given access control list entry.

Parameter acl: An access control list entry reference.

Parameter tags: On return, this points to the first item in an array of CSSM authorization tags.

Parameter tagCount: On return, this points to the number of tags in the CSSM authorization tag array.

Returns: A result code. See “Security Error Codes” (SecBase.h).

This function is deprecated in 10.7 and later; use SecACLCopyAuthorizations instead.

Safety

• tags must be a valid pointer.
• tag_count must be a valid pointer.

pub unsafe fn authorizations(&self) -> CFRetained<CFArray>

👎Deprecated: SecKeychain is deprecated

Available on crate feature SecACL only.

Retrieve the authorization tags of a given access control list entry.

Parameter acl: An access control list entry reference.

Returns: On return, a CFArrayRef of the authorizations for this ACL.

pub unsafe fn set_authorizations( &self, tags: NonNull<CSSM_ACL_AUTHORIZATION_TAG>, tag_count: uint32, ) -> i32

👎Deprecated: CSSM is not supported

Available on crate features SecACL and cssmconfig and cssmtype only.

Sets the CSSM authorization tags of a given access control list entry.

Parameter acl: An access control list entry reference.

Parameter tags: A pointer to the first item in an array of CSSM authorization tags.

Parameter tagCount: The number of tags in the CSSM authorization tag array.

Returns: A result code. See “Security Error Codes” (SecBase.h).

This function is deprecated in 10.7 and later; use SecACLUpdateAuthorizations instead.

Safety

tags must be a valid pointer.

pub unsafe fn update_authorizations(&self, authorizations: &CFArray) -> i32

👎Deprecated: SecKeychain is deprecated

Available on crate feature SecACL only.

Sets the authorization tags of a given access control list entry.

Parameter acl: An access control list entry reference.

Parameter authorizations: A pointer to an array of authorization tags.

Returns: A result code. See “Security Error Codes” (SecBase.h).

Safety

authorizations generic must be of the correct type.

Methods from Deref<Target = CFType>

pub fn downcast_ref<T>(&self) -> Option<&T>

where T: ConcreteType,

Available on crate feature SecCustomTransform only.

Attempt to downcast the type to that of type T.

This is the reference-variant. Use CFRetained::downcast if you want to convert a retained type. See also ConcreteType for more details on which types support being converted to.

pub fn retain_count(&self) -> usize

Available on crate feature SecCustomTransform only.

Get the reference count of the object.

This function may be useful for debugging. You normally do not use this function otherwise.

Beware that some things (like CFNumbers, small CFStrings etc.) may not have a normal retain count for optimization purposes, and can return usize::MAX in that case.

Trait Implementations

impl AsRef<AnyObject> for SecACL

fn as_ref(&self) -> &AnyObject

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<CFType> for SecACL

fn as_ref(&self) -> &CFType

Converts this type into a shared reference of the (usually inferred) input type.

impl AsRef<SecACL> for SecACL

fn as_ref(&self) -> &Self

Converts this type into a shared reference of the (usually inferred) input type.

impl Borrow<AnyObject> for SecACL

fn borrow(&self) -> &AnyObject

Immutably borrows from an owned value.

impl Borrow<CFType> for SecACL

fn borrow(&self) -> &CFType

Immutably borrows from an owned value.

impl ConcreteType for SecACL

Available on crate feature SecACL only.

fn type_id() -> CFTypeID

Returns the type identifier of SecACL instances.

Returns: The CFTypeID of SecACL instances.

impl Debug for SecACL

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Deref for SecACL

type Target = CFType

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl Hash for SecACL

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Message for SecACL

fn retain(&self) -> Retained<Self>

where Self: Sized,

Increment the reference count of the receiver.

impl PartialEq for SecACL

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl RefEncode for SecACL

const ENCODING_REF: Encoding

The Objective-C type-encoding for a reference of this type.

impl Type for SecACL

fn retain(&self) -> CFRetained<Self>

where Self: Sized,

Increment the reference count of the receiver.

fn as_concrete_TypeRef(&self) -> &Self

👎Deprecated: this is redundant

Helper for easier transition from the core-foundation crate.

unsafe fn wrap_under_get_rule(ptr: *const Self) -> CFRetained<Self>

where Self: Sized,

👎Deprecated: use CFRetained::retain

Helper for easier transition from the core-foundation crate.

fn as_CFTypeRef(&self) -> &CFType

where Self: AsRef<CFType>,

👎Deprecated: this is redundant (CF types deref to CFType)

Helper for easier transition from the core-foundation crate.

unsafe fn wrap_under_create_rule(ptr: *const Self) -> CFRetained<Self>

where Self: Sized,

👎Deprecated: use CFRetained::from_raw

Helper for easier transition from the core-foundation crate.

impl Eq for SecACL