Function

SecCodeCheckValidity

Performs dynamic validation of signed code.

Declaration

OSStatus SecCodeCheckValidity(SecCodeRef code, SecCSFlags flags, SecRequirementRef requirement);

Parameters

code

The code object to be validated.

flags

Optional flags; see SecCSFlags for possible values. Pass kSecCSDefaultFlags for standard behavior.

requirement

A code requirement specifying additional conditions the code must satisfy to be considered valid. Specify NULL if you don’t want to impose any additional requirements. Use the SecRequirementCreateWithString or SecRequirementCreateWithStringAndErrors function to create a code requirement object. See Code Signing Guide for a discussion of code requirements.

Return Value

Discussion

This function obtains and verifies the signature on the code specified by the code object. It checks the validity of only those sealed components required to establish identity. For guest code, first the function checks the code object’s dynamic validity status as reported by its host, then it ensures that the code object’s host is in turn valid. For all code, it validates the code against a code requirement if one is specified. The call succeeds if all these conditions are satisfactory.

This function is secure against attempts to modify the file system source of the code object.

See Also

Code Signature Validity

SecCodeCheckValidityWithErrors

Performs dynamic validation of signed code and returns detailed error information in the case of failure.

SecStaticCodeCheckValidity

Validates a static code object.

SecStaticCodeCheckValidityWithErrors

Performs static validation of static signed code and returns detailed error information in the case of failure.

Static Code Validation Flags

Use these supplemental flags to test the validity of a static code signature.