// Copyright (c) 2012 The Chromium Authors. All rights reserved. // Use of this source code is governed by a BSD-style license that can be // found in the LICENSE file. #ifndef CRYPTO_NSS_UTIL_H_ #define CRYPTO_NSS_UTIL_H_ #include #include #include "base/callback.h" #include "base/compiler_specific.h" #include "base/macros.h" #include "crypto/crypto_export.h" namespace base { class Time; } // namespace base // This file specifically doesn't depend on any NSS or NSPR headers because it // is included by various (non-crypto) parts of chrome to call the // initialization functions. namespace crypto { // Initialize NRPR if it isn't already initialized. This function is // thread-safe, and NSPR will only ever be initialized once. CRYPTO_EXPORT void EnsureNSPRInit(); // Initialize NSS if it isn't already initialized. This must be called before // any other NSS functions. This function is thread-safe, and NSS will only // ever be initialized once. CRYPTO_EXPORT void EnsureNSSInit(); // Check if the current NSS version is greater than or equals to |version|. // A sample version string is "3.12.3". bool CheckNSSVersion(const char* version); #if defined(OS_CHROMEOS) // Indicates that NSS should use the Chaps library so that we // can access the TPM through NSS. InitializeTPMTokenAndSystemSlot and // InitializeTPMForChromeOSUser must still be called to load the slots. CRYPTO_EXPORT void EnableTPMTokenForNSS(); // Returns true if EnableTPMTokenForNSS has been called. CRYPTO_EXPORT bool IsTPMTokenEnabledForNSS(); // Returns true if the TPM is owned and PKCS#11 initialized with the // user and security officer PINs, and has been enabled in NSS by // calling EnableTPMForNSS, and Chaps has been successfully // loaded into NSS. // If |callback| is non-null and the function returns false, the |callback| will // be run once the TPM is ready. |callback| will never be run if the function // returns true. CRYPTO_EXPORT bool IsTPMTokenReady(const base::Closure& callback) WARN_UNUSED_RESULT; // Initialize the TPM token and system slot. The |callback| will run on the same // thread with true if the token and slot were successfully loaded or were // already initialized. |callback| will be passed false if loading failed. Once // called, InitializeTPMTokenAndSystemSlot must not be called again until the // |callback| has been run. CRYPTO_EXPORT void InitializeTPMTokenAndSystemSlot( int system_slot_id, const base::Callback& callback); #endif // Convert a NSS PRTime value into a base::Time object. // We use a int64_t instead of PRTime here to avoid depending on NSPR headers. CRYPTO_EXPORT base::Time PRTimeToBaseTime(int64_t prtime); // Convert a base::Time object into a PRTime value. // We use a int64_t instead of PRTime here to avoid depending on NSPR headers. CRYPTO_EXPORT int64_t BaseTimeToPRTime(base::Time time); } // namespace crypto #endif // CRYPTO_NSS_UTIL_H_