naiveproxy/net/cert/internal/cert_error_id.h
2018-12-09 21:59:24 -05:00

38 lines
1.4 KiB
C++

// 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_