CachePeer.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_CACHEPEER_H
#define SQUID_SRC_CACHEPEER_H
 
#include "acl/forward.h"
#include "base/CbcPointer.h"
#include "base/forward.h"
#include "enums.h"
#include "http/StatusCode.h"
#include "icp_opcode.h"
#include "ip/Address.h"
#include "security/PeerOptions.h"
 
#include <iosfwd>
 
class NeighborTypeDomainList;
class PconnPool;
class PeerDigest;
class PeerPoolMgr;
 
class CachePeer
{
    CBDATA_CLASS(CachePeer);
 
public:
    explicit CachePeer(const char *hostname);
    ~CachePeer();
 
    void noteSuccess();
 
    void noteFailure();
 
    void rename(const char *);
 
    time_t connectTimeout() const;
 
    Security::FuturePeerContext *securityContext();
 
    u_int index = 0;
 
    char *name = nullptr;
 
    char *host = nullptr;
 
    peer_t type = PEER_NONE;
 
    Ip::Address in_addr;
 
    struct {
        int pings_sent = 0;
        int pings_acked = 0;
        int fetches = 0;
        int rtt = 0;
        int ignored_replies = 0;
        int n_keepalives_sent = 0;
        int n_keepalives_recv = 0;
        time_t probe_start = 0;
        time_t last_query = 0;
        time_t last_reply = 0;
        time_t last_connect_failure = 0;
        time_t last_connect_probe = 0;
        int logged_state = PEER_ALIVE;   
        int conn_open = 0;               
    } stats;
 
    struct icp_ {
        icp_() { memset(&counts, 0, sizeof(counts)); }
        int version = ICP_VERSION_CURRENT;
        int counts[ICP_END+1];
        unsigned short port = CACHE_ICP_PORT;
    } icp;
 
#if USE_HTCP
    struct {
        double version = 0.0;
        int counts[2] = {0, 0};
        unsigned short port = 0;
    } htcp;
#endif
 
    unsigned short http_port = CACHE_HTTP_PORT;
    NeighborTypeDomainList *typelist = nullptr;
    acl_access *access = nullptr;
 
    struct {
        bool proxy_only = false;
        bool no_query = false;
        bool background_ping = false;
        bool no_digest = false;
        bool default_parent = false;
        bool roundrobin = false;
        bool weighted_roundrobin = false;
        bool mcast_responder = false;
        bool closest_only = false;
#if USE_HTCP
        bool htcp = false;
        bool htcp_oldsquid = false;
        bool htcp_no_clr = false;
        bool htcp_no_purge_clr = false;
        bool htcp_only_clr = false;
        bool htcp_forward_clr = false;
#endif
        bool no_netdb_exchange = false;
#if USE_DELAY_POOLS
        bool no_delay = false;
#endif
        bool allow_miss = false;
        bool carp = false;
        struct {
            bool set = false; //If false, whole url is to be used. Overrides others
            bool scheme = false;
            bool host = false;
            bool port = false;
            bool path = false;
            bool params = false;
        } carp_key;
#if USE_AUTH
        bool userhash = false;
#endif
        bool sourcehash = false;
        bool originserver = false;
        bool no_tproxy = false;
        bool mcast_siblings = false;
        bool auth_no_keytab = false;
    } options;
 
    int weight = 1;
    int basetime = 0;
 
    struct {
        double avg_n_members = 0.0;
        int n_times_counted = 0;
        int n_replies_expected = 0;
        int ttl = 0;
        int id = 0;
 
        struct {
            bool count_event_pending = false;
            bool counting = false;
        } flags;
    } mcast;
 
#if USE_CACHE_DIGESTS
    PeerDigest *digest = nullptr;
    char *digest_url = nullptr;
#endif
 
    int tcp_up = 0;
 
    bool reprobe = false;
 
    Ip::Address addresses[10];
    int n_addresses = 0;
    int rr_count = 0;
    int testing_now = 0;
 
    struct {
        unsigned int hash = 0;
        double load_multiplier = 0.0;
        double load_factor = 0.0;     
    } carp;
#if USE_AUTH
    struct {
        unsigned int hash = 0;
        double load_multiplier = 0.0;
        double load_factor = 0.0;     
    } userhash;
#endif
    struct {
        unsigned int hash = 0;
        double load_multiplier = 0.0;
        double load_factor = 0.0;     
    } sourcehash;
 
    char *login = nullptr;        /* Proxy authorization */
    time_t connect_timeout_raw = 0; 
    int connect_fail_limit = 0;
    int max_conn = 0;
 
    struct {
        PconnPool *pool = nullptr;    
        CbcPointer<PeerPoolMgr> mgr;  
        int limit = 0;                
        bool waitingForClose = false; 
    } standby;
 
    char *domain = nullptr; 
 
    // TODO: Remove secure and sslContext when FuturePeerContext below becomes PeerContext
    Security::PeerOptions secure;
    Security::ContextPointer sslContext;
    Security::FuturePeerContext tlsContext;
 
    Security::SessionStatePointer sslSession;
 
    int front_end_https = 0; 
    int connection_auth = 2; 
 
    PrecomputedCodeContextPointer probeCodeContext;
 
private:
    void countFailure();
};
 
inline void
NoteOutgoingConnectionSuccess(CachePeer * const peer)
{
    if (peer)
        peer->noteSuccess();
}
 
inline void
NoteOutgoingConnectionFailure(CachePeer * const peer)
{
    if (peer)
        peer->noteFailure();
}
 
std::ostream &operator <<(std::ostream &, const CachePeer &);
 
#endif /* SQUID_SRC_CACHEPEER_H */