15821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Copyright (c) 2012 The Chromium Authors. All rights reserved. 25821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Use of this source code is governed by a BSD-style license that can be 35821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// found in the LICENSE file. 45821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 55821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#ifndef CRYPTO_CSSM_INIT_H_ 65821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#define CRYPTO_CSSM_INIT_H_ 75821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 85821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include <Security/cssm.h> 95821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 105821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "base/basictypes.h" 115821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#include "crypto/crypto_export.h" 125821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 135821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)namespace crypto { 145821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 155821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Initialize CSSM if it isn't already initialized. This must be called before 165821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// any other CSSM functions. This function is thread-safe, and CSSM will only 175821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// ever be initialized once. CSSM will be properly shut down on program exit. 185821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)CRYPTO_EXPORT void EnsureCSSMInit(); 195821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 205821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns the shared CSP handle used by CSSM functions. 215821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)CRYPTO_EXPORT CSSM_CSP_HANDLE GetSharedCSPHandle(); 225821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 235821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns the shared CL handle used by CSSM functions. 245821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)CRYPTO_EXPORT CSSM_CL_HANDLE GetSharedCLHandle(); 255821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 265821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Returns the shared TP handle used by CSSM functions. 275821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)CRYPTO_EXPORT CSSM_TP_HANDLE GetSharedTPHandle(); 285821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 295821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Set of pointers to memory function wrappers that are required for CSSM 305821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)extern const CSSM_API_MEMORY_FUNCS kCssmMemoryFunctions; 315821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 325821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Utility function to log an error message including the error name. 335821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)CRYPTO_EXPORT void LogCSSMError(const char *function_name, CSSM_RETURN err); 345821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 355821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Utility functions to allocate and release CSSM memory. 365821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)void* CSSMMalloc(CSSM_SIZE size); 375821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)CRYPTO_EXPORT void CSSMFree(void* ptr); 385821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 395821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Wrapper class for CSSM_DATA type. This should only be used when using the 405821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// CL/TP/CSP handles from above, since that's the only time we're guaranteed (or 415821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// supposed to be guaranteed) that our memory management functions will be used. 425821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// Apple's Sec* APIs manage their own memory so it shouldn't be used for those. 435821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// The constructor initializes data_ to zero and the destructor releases the 445821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)// data properly. 455821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)class ScopedCSSMData { 465821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) public: 475821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ScopedCSSMData(); 485821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) ~ScopedCSSMData(); 495821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) operator CSSM_DATA*() { return &data_; } 505821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CSSM_DATA* operator ->() { return &data_; } 515821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 525821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) private: 535821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) CSSM_DATA data_; 545821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 555821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) DISALLOW_COPY_AND_ASSIGN(ScopedCSSMData); 565821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)}; 575821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 585821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)} // namespace crypto 595821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles) 605821806d5e7f356e8fa4b058a389a808ea183019Torne (Richard Coles)#endif // CRYPTO_CSSM_INIT_H_ 61