| Index: crypto/nss_util.h
|
| ===================================================================
|
| --- crypto/nss_util.h (revision 0)
|
| +++ crypto/nss_util.h (revision 0)
|
| @@ -0,0 +1,138 @@
|
| +// Copyright (c) 2011 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_
|
| +#pragma once
|
| +
|
| +#include <string>
|
| +#include "base/basictypes.h"
|
| +
|
| +#if defined(USE_NSS)
|
| +class FilePath;
|
| +#endif // defined(USE_NSS)
|
| +
|
| +namespace base {
|
| +class Lock;
|
| +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 {
|
| +
|
| +#if defined(USE_NSS)
|
| +// EarlySetupForNSSInit performs lightweight setup which must occur before the
|
| +// process goes multithreaded. This does not initialise NSS. For test, see
|
| +// EnsureNSSInit.
|
| +void EarlySetupForNSSInit();
|
| +#endif
|
| +
|
| +// Initialize NRPR if it isn't already initialized. This function is
|
| +// thread-safe, and NSPR will only ever be initialized once.
|
| +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.
|
| +void EnsureNSSInit();
|
| +
|
| +// Call this before calling EnsureNSSInit() will force NSS to initialize
|
| +// without a persistent DB. This is used for the special case where access of
|
| +// persistent DB is prohibited.
|
| +//
|
| +// TODO(hclam): Isolate loading default root certs.
|
| +//
|
| +// NSS will be initialized without loading any user security modules, including
|
| +// the built-in root certificates module. User security modules need to be
|
| +// loaded manually after NSS initialization.
|
| +//
|
| +// If EnsureNSSInit() is called before then this function has no effect.
|
| +//
|
| +// Calling this method only has effect on Linux.
|
| +//
|
| +// WARNING: Use this with caution.
|
| +void ForceNSSNoDBInit();
|
| +
|
| +// This methods is used to disable checks in NSS when used in a forked process.
|
| +// NSS checks whether it is running a forked process to avoid problems when
|
| +// using user security modules in a forked process. However if we are sure
|
| +// there are no modules loaded before the process is forked then there is no
|
| +// harm disabling the check.
|
| +//
|
| +// This method must be called before EnsureNSSInit() to take effect.
|
| +//
|
| +// WARNING: Use this with caution.
|
| +void DisableNSSForkCheck();
|
| +
|
| +// Load NSS library files. This function has no effect on Mac and Windows.
|
| +// This loads the necessary NSS library files so that NSS can be initialized
|
| +// after loading additional library files is disallowed, for example when the
|
| +// sandbox is active.
|
| +//
|
| +// Note that this does not load libnssckbi.so which contains the root
|
| +// certificates.
|
| +void LoadNSSLibraries();
|
| +
|
| +// 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)
|
| +// Open the r/w nssdb that's stored inside the user's encrypted home
|
| +// directory. This is the default slot returned by
|
| +// GetPublicNSSKeySlot().
|
| +void OpenPersistentNSSDB();
|
| +
|
| +// Load the opencryptoki library into NSS so that we can access the
|
| +// TPM through NSS. Once this is called, GetPrivateNSSKeySlot() will
|
| +// return the TPM slot if one was found. Returns false if it was
|
| +// unable to load opencryptoki or open the TPM slot.
|
| +bool EnableTPMForNSS();
|
| +
|
| +// Get name for the built-in TPM token on ChromeOS.
|
| +std::string GetTPMTokenName();
|
| +
|
| +// Get the user PIN for the built-in TPM token on ChromeOS.
|
| +std::string GetTPMUserPIN();
|
| +#endif
|
| +
|
| +// Convert a NSS PRTime value into a base::Time object.
|
| +// We use a int64 instead of PRTime here to avoid depending on NSPR headers.
|
| +base::Time PRTimeToBaseTime(int64 prtime);
|
| +
|
| +#if defined(USE_NSS)
|
| +// Exposed for unittests only. |path| should be an existing directory under
|
| +// which the DB files will be placed. |description| is a user-visible name for
|
| +// the DB, as a utf8 string, which will be truncated at 32 bytes.
|
| +bool OpenTestNSSDB(const FilePath& path, const char* description);
|
| +void CloseTestNSSDB();
|
| +
|
| +// NSS has a bug which can cause a deadlock or stall in some cases when writing
|
| +// to the certDB and keyDB. It also has a bug which causes concurrent key pair
|
| +// generations to scribble over each other. To work around this, we synchronize
|
| +// writes to the NSS databases with a global lock. The lock is hidden beneath a
|
| +// function for easy disabling when the bug is fixed. Callers should allow for
|
| +// it to return NULL in the future.
|
| +//
|
| +// See https://bugzilla.mozilla.org/show_bug.cgi?id=564011
|
| +base::Lock* GetNSSWriteLock();
|
| +
|
| +// A helper class that acquires the NSS write Lock while the AutoNSSWriteLock
|
| +// is in scope.
|
| +class AutoNSSWriteLock {
|
| + public:
|
| + AutoNSSWriteLock();
|
| + ~AutoNSSWriteLock();
|
| + private:
|
| + base::Lock *lock_;
|
| + DISALLOW_COPY_AND_ASSIGN(AutoNSSWriteLock);
|
| +};
|
| +
|
| +#endif // defined(USE_NSS)
|
| +
|
| +} // namespace crypto
|
| +
|
| +#endif // CRYPTO_NSS_UTIL_H_
|
|
|
| Property changes on: crypto\nss_util.h
|
| ___________________________________________________________________
|
| Added: svn:eol-style
|
| + LF
|
|
|
|
|