FileSigning.h

Go to the documentation of this file.

 
#ifndef __FILESIGNING__
#define __FILESIGNING__
 
#ifndef __MACTYPES__
#include <MacTypes.h>
#endif
 
#ifndef __FILES__
#include <Files.h>
#endif
 
#ifndef __KEYCHAIN__
#include <Keychain.h>
#endif
 
#ifndef __CRYPTOMESSAGESYNTAX__
#include <CryptoMessageSyntax.h>
#endif
 
#if PRAGMA_ONCE
#pragma once
#endif
 
#ifdef __cplusplus
extern "C" {
#endif
 
#if PRAGMA_IMPORT
#pragma import on
#endif
 
#if PRAGMA_STRUCT_ALIGN
#pragma options align = mac68k
#elif PRAGMA_STRUCT_PACKPUSH
#pragma pack(push, 2)
#elif PRAGMA_STRUCT_PACK
#pragma pack(2)
#endif
 
/* Data structures and types */
typedef SInt32 SecOptions;
enum {
  kSecOptionProgress = 1 << 0,
  kSecOptionShowVerifyUI = 1 << 1,
  kSecOptionNeverShowUI = 1 << 2,
  kCertUsageReserved =
      0x7FFFFF00 /* Last 3 bytes reserved for SecOptions flags */
};
 
typedef UInt32 SecSignatureType;
enum {
  kSecSignatureTypeRawPKCS7 = 0,
  kSecSignatureTypeCMS = 1,
  kSecSignatureTypePGP = 2 /* reserved but not implemented */
};
 
typedef UInt32 SecTrustPolicy;
enum { kSecTrustPolicyCodeSigning = 0, kSecTrustPolicyPersonalFileSigning = 1 };
 
struct SecProgressCallbackInfo {
  UInt32 version;
  UInt32 bytesProcessed;
  UInt32 totalBytes;
  UInt32 itemsRemainingToSign;
  UInt32 totalItemsToSign;
  UInt32 secondsRemaining;
  UInt32 secondsElapsed;
  UInt32 microSecondsPerByte;
  Str255 fileName;
};
typedef struct SecProgressCallbackInfo SecProgressCallbackInfo;
typedef CALLBACK_API(OSStatus, SecProgressCallbackProcPtr)(
    SecProgressCallbackInfo *callbackInfo, void *userContext);
typedef STACK_UPP_TYPE(SecProgressCallbackProcPtr) SecProgressCallbackUPP;
#if CALL_NOT_IN_CARBON
SecProgressCallbackUPP
NewSecProgressCallbackUPP(SecProgressCallbackProcPtr userRoutine);
#if !OPAQUE_UPP_TYPES
enum {
  uppSecProgressCallbackProcInfo = 0x000003F0
}; /* pascal 4_bytes Func(4_bytes, 4_bytes) */
#ifdef __cplusplus
inline SecProgressCallbackUPP
NewSecProgressCallbackUPP(SecProgressCallbackProcPtr userRoutine) {
  return (SecProgressCallbackUPP)NewRoutineDescriptor(
      (ProcPtr)(userRoutine), uppSecProgressCallbackProcInfo,
      GetCurrentArchitecture());
}
#else
#define NewSecProgressCallbackUPP(userRoutine)                                 \
  (SecProgressCallbackUPP) NewRoutineDescriptor(                               \
      (ProcPtr)(userRoutine), uppSecProgressCallbackProcInfo,                  \
      GetCurrentArchitecture())
#endif
#endif
 
void
DisposeSecProgressCallbackUPP(SecProgressCallbackUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline void DisposeSecProgressCallbackUPP(SecProgressCallbackUPP userUPP) {
  DisposeRoutineDescriptor((UniversalProcPtr)userUPP);
}
#else
#define DisposeSecProgressCallbackUPP(userUPP) DisposeRoutineDescriptor(userUPP)
#endif
#endif
 
OSStatus
InvokeSecProgressCallbackUPP(SecProgressCallbackInfo *callbackInfo,
                             void *userContext, SecProgressCallbackUPP userUPP);
#if !OPAQUE_UPP_TYPES
#ifdef __cplusplus
inline OSStatus
InvokeSecProgressCallbackUPP(SecProgressCallbackInfo *callbackInfo,
                             void *userContext,
                             SecProgressCallbackUPP userUPP) {
  return (OSStatus)CALL_TWO_PARAMETER_UPP(
      userUPP, uppSecProgressCallbackProcInfo, callbackInfo, userContext);
}
#else
#define InvokeSecProgressCallbackUPP(callbackInfo, userContext, userUPP)       \
  (OSStatus) CALL_TWO_PARAMETER_UPP((userUPP), uppSecProgressCallbackProcInfo, \
                                    (callbackInfo), (userContext))
#endif
#endif
 
#endif /* CALL_NOT_IN_CARBON */
 
#if CALL_NOT_IN_CARBON || OLDROUTINENAMES
/* support for pre-Carbon UPP routines: New...Proc and Call...Proc */
#define NewSecProgressCallbackProc(userRoutine)                                \
  NewSecProgressCallbackUPP(userRoutine)
#define CallSecProgressCallbackProc(userRoutine, callbackInfo, userContext)    \
  InvokeSecProgressCallbackUPP(callbackInfo, userContext, userRoutine)
#endif /* CALL_NOT_IN_CARBON */
 
#if CALL_NOT_IN_CARBON
OSStatus
SecSetProgressCallback(SecProgressCallbackUPP callbackProc, void *userContext);
 
OSStatus
SecRemoveProgressCallback(SecProgressCallbackUPP callbackProc);
 
OSStatus
DefaultSecProgressCallbackProc(SecProgressCallbackInfo *info,
                               void *userContext);
 
#endif /* CALL_NOT_IN_CARBON */
 
enum { kSecDefaultSignatureResID = 1 };
 
#if CALL_NOT_IN_CARBON
OSStatus
SecMacSignFile(FSSpec *theFile, KCItemRef signingCertificate, Handle sigH,
               SecOptions options, SecProgressCallbackUPP progressProc,
               void *userContext);
 
OSStatus
SecMacSignFileSimple(FSSpec *theFile, KCItemRef signingCertificate,
                     SecOptions options);
 
OSStatus
SecMacLoadSigPound(FSSpec *theFile, Handle *resHandle);
 
OSStatus
SecMacRemoveSignature(FSSpec *theFile, SecSignatureType signatureType,
                      SInt16 signatureToRemove);
 
OSStatus
SecMacRemoveAllSignatures(FSSpec *theFile, SecSignatureType signatureType);
 
OSStatus
SecMacVerifyFile(FSSpec *theFile, SecOptions options,
                 SecProgressCallbackUPP progressProc, void *userContext,
                 SInt16 signatureToVerify, CFArrayRef policyOIDs,
                 KCVerifyStopOn stopOn, SecSignerRef *signer);
 
OSStatus
SecMacVerifyFileSimple(FSSpec *theFile, SecOptions options,
                       SecTrustPolicy trustPolicy, SecSignerRef *signer);
 
Boolean
SecMacHasSignature(FSSpec *theFile, SecSignatureType signatureType);
 
OSStatus
SecMacFindSignatureToVerify(FSSpec *theFile, SecSignatureType signatureType,
                            SInt16 *signatureToVerify);
 
CFArrayRef
SecMacGetDefaultPolicyOIDs(SecTrustPolicy trustPolicy);
 
OSStatus
SecMacDisplaySigner(OSStatus inputErr, SecSignerRef signer,
                    Boolean alwaysShowUI, FSSpec *theFile);
 
/* Errors Codes */
#endif /* CALL_NOT_IN_CARBON */
 
enum {
  errSecTooManySigners = -13839,
  errSecSigningFailed = -13838,
  errSecCorruptSigPound = -13837,
  errSecNoSignatureFound = -13836
};
 
#if PRAGMA_STRUCT_ALIGN
#pragma options align = reset
#elif PRAGMA_STRUCT_PACKPUSH
#pragma pack(pop)
#elif PRAGMA_STRUCT_PACK
#pragma pack()
#endif
 
#ifdef PRAGMA_IMPORT_OFF
#pragma import off
#elif PRAGMA_IMPORT
#pragma import reset
#endif
 
#ifdef __cplusplus
}
#endif
 
#endif /* __FILESIGNING__ */