summaryrefslogtreecommitdiff
path: root/chromium/net/ssl/ssl_cipher_suite_names.h
diff options
context:
space:
mode:
Diffstat (limited to 'chromium/net/ssl/ssl_cipher_suite_names.h')
-rw-r--r--chromium/net/ssl/ssl_cipher_suite_names.h51
1 files changed, 51 insertions, 0 deletions
diff --git a/chromium/net/ssl/ssl_cipher_suite_names.h b/chromium/net/ssl/ssl_cipher_suite_names.h
new file mode 100644
index 00000000000..5145fb24c5e
--- /dev/null
+++ b/chromium/net/ssl/ssl_cipher_suite_names.h
@@ -0,0 +1,51 @@
+// 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 NET_SSL_SSL_CIPHER_SUITE_NAMES_H_
+#define NET_SSL_SSL_CIPHER_SUITE_NAMES_H_
+
+#include <string>
+
+#include "base/basictypes.h"
+#include "net/base/net_export.h"
+
+namespace net {
+
+// SSLCipherSuiteToStrings returns three strings for a given cipher suite
+// number, the name of the key exchange algorithm, the name of the cipher and
+// the name of the MAC. The cipher suite number is the number as sent on the
+// wire and recorded at
+// http://www.iana.org/assignments/tls-parameters/tls-parameters.xml
+// If the cipher suite is unknown, the strings are set to "???".
+// In the case of an AEAD cipher suite, *mac_str is NULL and *is_aead is true.
+NET_EXPORT void SSLCipherSuiteToStrings(const char** key_exchange_str,
+ const char** cipher_str,
+ const char** mac_str,
+ bool* is_aead,
+ uint16 cipher_suite);
+
+// SSLVersionToString returns the name of the SSL protocol version
+// specified by |ssl_version|, which is defined in
+// net/ssl/ssl_connection_status_flags.h.
+// If the version is unknown, |name| is set to "???".
+NET_EXPORT void SSLVersionToString(const char** name, int ssl_version);
+
+// Parses a string literal that represents a SSL/TLS cipher suite.
+//
+// Supported literal forms:
+// 0xAABB, where AA is cipher_suite[0] and BB is cipher_suite[1], as
+// defined in RFC 2246, Section 7.4.1.2. Unrecognized but parsable cipher
+// suites in this form will not return an error.
+//
+// Returns true if the cipher suite was successfully parsed, storing the
+// result in |cipher_suite|.
+//
+// TODO(rsleevi): Support the full strings defined in the IANA TLS parameters
+// list.
+NET_EXPORT bool ParseSSLCipherString(const std::string& cipher_string,
+ uint16* cipher_suite);
+
+} // namespace net
+
+#endif // NET_SSL_SSL_CIPHER_SUITE_NAMES_H_