Detail.h

Go to the documentation of this file.

/*
 * Copyright (C) 1996-2025 The Squid Software Foundation and contributors
 *
 * Squid software is distributed under GPLv2+ license and includes
 * contributions from numerous individuals and organizations.
 * Please see the COPYING and CONTRIBUTORS files for details.
 */
 
#ifndef SQUID_SRC_ERROR_DETAIL_H
#define SQUID_SRC_ERROR_DETAIL_H
 
#include "base/Here.h"
#include "base/RefCount.h"
#include "error/forward.h"
#include "http/forward.h"
#include "mem/forward.h"
#include "sbuf/forward.h"
 
class ErrorDetail: public RefCountable
{
public:
    using Pointer = ErrorDetailPointer;
 
    ~ErrorDetail() override {}
 
    virtual SBuf brief() const = 0;
 
    virtual SBuf verbose(const HttpRequestPointer &) const = 0;
 
    // Duplicate details for the same error typically happen when we update some
    // error storage (e.g., ALE) twice from the same detail source (e.g., the
    // same HttpRequest object reachable via two different code/pointer paths)
    // or retag the error with the same context information (e.g., WITH_CLIENT).
    // In all those cases, comparing detail object addresses is enough to detect
    // duplicates. In other cases (if they exist), a duplicate detail would
    // imply inefficient or buggy error detailing code. Instead of spending ink
    // and CPU cycles on hiding them, this comparison may expose those (minor)
    // problems (in hope that they get fixed).
    bool equals(const ErrorDetail &other) const { return this == &other; }
};
 
ErrorDetail::Pointer MakeNamedErrorDetail(const char *name);
 
std::ostream &operator <<(std::ostream &os, const ErrorDetail &);
 
// XXX: Every ErrorDetail child, especially those declaring their own Pointer
// types should overload this operator. The compiler will not find this overload
// for child pointers. See Security::ErrorDetail overload for an example.
std::ostream &operator <<(std::ostream &os, const ErrorDetail::Pointer &);
 
#endif /* SQUID_SRC_ERROR_DETAIL_H */