| // Copyright 2016 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_CERT_INTERNAL_CERT_ERROR_ID_H_ | |
| #define NET_CERT_INTERNAL_CERT_ERROR_ID_H_ | |
| #include "net/base/net_export.h" | |
| namespace net { | |
| // Each "class" of certificate error/warning has its own unique ID. This is | |
| // essentially like an error code, however the value is not stable. Under the | |
| // hood these IDs are pointers and use the process's address space to ensure | |
| // uniqueness. | |
| // | |
| // Equality of CertErrorId can be done using the == operator. | |
| // | |
| // To define new error IDs use the macro DEFINE_CERT_ERROR_ID(). | |
| using CertErrorId = const void*; | |
| // DEFINE_CERT_ERROR_ID() creates a CertErrorId given a non-null C-string | |
| // literal. The string should be a textual name for the error which will appear | |
| // when pretty-printing errors for debugging. It should be ASCII. | |
| // | |
| // TODO(crbug.com/634443): Implement this -- add magic to ensure that storage | |
| // of identical strings isn't pool. | |
| #define DEFINE_CERT_ERROR_ID(name, c_str_literal) \ | |
| const CertErrorId name = c_str_literal | |
| // Returns a debug string for a CertErrorId. In practice this returns the | |
| // string literal given to DEFINE_CERT_ERROR_ID(), which is human-readable. | |
| NET_EXPORT const char* CertErrorIdToDebugString(CertErrorId id); | |
| } // namespace net | |
| #endif // NET_CERT_INTERNAL_CERT_ERROR_ID_H_ |