Struct SecStaticCode

#[repr(C)]
pub struct SecStaticCode { /* private fields */ }

Available on crate feature CSCommon only.

This is the type of a reference to static code on disk.

See also Apple’s documentation

Implementations

impl SecStaticCode

pub unsafe fn create_with_path( path: &CFURL, flags: SecCSFlags, static_code: NonNull<*const SecStaticCode>, ) -> i32

Available on crate feature SecStaticCode only.

Given a path to a file system object, create a SecStaticCode object representing the code at that location, if possible. Such a SecStaticCode is not inherently linked to running code in the system.

It is possible to create a SecStaticCode object from an unsigned code object. Most uses of such an object will return the errSecCSUnsigned error. However, SecCodeCopyPath and SecCodeCopySigningInformation can be safely applied to such objects.

Parameter path: A path to a location in the file system. Only file:// URLs are currently supported. For bundles, pass a URL to the root directory of the bundle. For single files, pass a URL to the file. If you pass a URL to the main executable of a bundle, the bundle as a whole will be generally recognized. Caution: Paths containing embedded // or /../ within a bundle’s directory may cause the bundle to be misconstrued. If you expect to submit such paths, first clean them with realpath(3) or equivalent.

Parameter flags: Optional flags. Pass kSecCSDefaultFlags for standard behavior.

Parameter staticCode: On successful return, contains a reference to the StaticCode object representing the code at path. Unchanged on error.

Returns: Upon success, errSecSuccess. Upon error, an OSStatus value documented in CSCommon.h or certain other Security framework headers.

impl SecStaticCode

pub unsafe fn create_with_path_and_attributes( path: &CFURL, flags: SecCSFlags, attributes: &CFDictionary, static_code: NonNull<*const SecStaticCode>, ) -> i32

Available on crate feature SecStaticCode only.

Given a path to a file system object, create a SecStaticCode object representing the code at that location, if possible. Such a SecStaticCode is not inherently linked to running code in the system.

It is possible to create a SecStaticCode object from an unsigned code object. Most uses of such an object will return the errSecCSUnsigned error. However, SecCodeCopyPath and SecCodeCopySigningInformation can be safely applied to such objects.

Parameter path: A path to a location in the file system. Only file:// URLs are currently supported. For bundles, pass a URL to the root directory of the bundle. For single files, pass a URL to the file. If you pass a URL to the main executable of a bundle, the bundle as a whole will be generally recognized. Caution: Paths containing embedded // or /../ within a bundle’s directory may cause the bundle to be misconstrued. If you expect to submit such paths, first clean them with realpath(3) or equivalent.

Parameter flags: Optional flags. Pass kSecCSDefaultFlags for standard behavior.

Parameter attributes: A CFDictionary containing additional attributes of the code sought.

Parameter staticCode: On successful return, contains a reference to the StaticCode object representing the code at path. Unchanged on error.

Returns: Upon success, errSecSuccess. Upon error, an OSStatus value documented in CSCommon.h or certain other Security framework headers.

This can be a CFString containing a canonical architecture name (“i386” etc.), or a CFNumber specifying an architecture numerically (see mach/machine.h). This key is ignored if the code is not in Mach-O binary form. If the code is Mach-O but not universal (“thin”), the architecture specified must agree with the actual file contents.

(using the kSecCodeAttributeArchitecture key), specifies any sub-architecture by number. This key is ignored if no main architecture is specified; if it is specified by name; or if the code is not in Mach-O form.

then select the specified framework version. This key is otherwise ignored.

impl SecStaticCode

pub unsafe fn check_validity( self: &SecStaticCode, flags: SecCSFlags, requirement: Option<&SecRequirement>, ) -> i32

Available on crate feature SecStaticCode only.

pub unsafe fn check_validity_with_errors( self: &SecStaticCode, flags: SecCSFlags, requirement: Option<&SecRequirement>, errors: *mut *mut CFError, ) -> i32

Available on crate feature SecStaticCode only.

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 SecStaticCode

fn as_ref(&self) -> &AnyObject

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

impl AsRef<CFType> for SecStaticCode

fn as_ref(&self) -> &CFType

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

impl AsRef<SecStaticCode> for SecStaticCode

fn as_ref(&self) -> &Self

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

impl Borrow<AnyObject> for SecStaticCode

fn borrow(&self) -> &AnyObject

Immutably borrows from an owned value.

impl Borrow<CFType> for SecStaticCode

fn borrow(&self) -> &CFType

Immutably borrows from an owned value.

impl ConcreteType for SecStaticCode

Available on crate feature SecStaticCode only.

fn type_id() -> CFTypeID

Returns the type identifier of all SecStaticCode instances.

impl Debug for SecStaticCode

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

Formats the value using the given formatter.

impl Deref for SecStaticCode

type Target = CFType

The resulting type after dereferencing.

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

Dereferences the value.

impl Hash for SecStaticCode

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 SecStaticCode

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

where Self: Sized,

Increment the reference count of the receiver.

impl PartialEq for SecStaticCode

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 SecStaticCode

const ENCODING_REF: Encoding

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

impl Type for SecStaticCode

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 SecStaticCode