ipeer.h

Go to the documentation of this file.

/*
 * Copyright (c) 2013 Juniper Networks, Inc. All rights reserved.
 */
 
#ifndef SRC_BGP_IPEER_H_
#define SRC_BGP_IPEER_H_
 
#include <atomic>
#include "bgp/bgp_proto.h"
#include "base/address.h"
 
class DBTablePartBase;
class BgpPath;
class BgpRoute;
class BgpServer;
class BgpTable;
class IPeer;
class PeerCloseManager;
 
class IPeerUpdate {
public:
    virtual ~IPeerUpdate() { }
    virtual bool send_ready() const { return true; }
 
    // Printable name
    virtual const std::string &ToString() const = 0;
 
    // Send an update.
    // Returns true if the peer can send additional messages.
    virtual bool SendUpdate(const uint8_t *msg, size_t msgsize) = 0;
    virtual bool SendUpdate(const uint8_t *msg, size_t msgsize,
                            const std::string *msg_str) {
        return SendUpdate(msg, msgsize);
    }
 
    // Flush any accumulated updates.
    // Returns true if the peer can send additional messages.
    virtual bool FlushUpdate() { return true; }
};
 
class IPeerDebugStats {
public:
    struct ProtoStats {
        ProtoStats() {
            total = 0;
            open = 0;
            keepalive = 0;
            notification = 0;
            update = 0;
            close = 0;
        }
        uint64_t total;
        uint64_t open;
        uint64_t keepalive;
        uint64_t notification;
        uint64_t update;
        uint64_t close;
    };
 
    struct ErrorStats {
        ErrorStats() {
            connect_error = 0;
            connect_timer = 0;
            hold_timer = 0;
            open_error = 0;
            update_error = 0;
        }
        uint64_t connect_error;
        uint64_t connect_timer;
        uint64_t hold_timer;
        uint64_t open_error;
        uint64_t update_error;
    };
 
    struct RxErrorStats {
        RxErrorStats() {
            inet6_bad_xml_token_count = 0;
            inet6_bad_prefix_count = 0;
            inet6_bad_nexthop_count = 0;
            inet6_bad_afi_safi_count = 0;
        }
        uint64_t inet6_bad_xml_token_count;
        uint64_t inet6_bad_prefix_count;
        uint64_t inet6_bad_nexthop_count;
        uint64_t inet6_bad_afi_safi_count;
    };
 
    struct RxRouteStats {
        RxRouteStats() {
            total_path_count = 0;
            primary_path_count = 0;
        }
        uint64_t total_path_count;
        uint64_t primary_path_count;
    };
 
    struct UpdateStats {
        UpdateStats() {
            end_of_rib = 0;
            total = 0;
            reach = 0;
            unreach = 0;
        }
        uint64_t end_of_rib;
        uint64_t total;
        uint64_t reach;
        uint64_t unreach;
    };
 
    struct SocketStats {
        SocketStats() {
            calls = 0;
            bytes = 0;
            blocked_count = 0;
            blocked_duration_usecs = 0;
        }
        uint64_t calls;
        uint64_t bytes;
        uint64_t blocked_count;
        uint64_t blocked_duration_usecs;
    };
 
    virtual ~IPeerDebugStats() { }
 
    // Reset all counters
    virtual void Clear() = 0;
    // Printable name
    virtual std::string ToString() const = 0;
    // Previous State of the peer
    virtual std::string last_state() const = 0;
    // Last state change At
    virtual std::string last_state_change_at() const = 0;
    // Last error on this peer
    virtual std::string last_error() const = 0;
    // Last Event on this peer
    virtual std::string last_event() const = 0;
    // When was the Last
    virtual std::string last_flap() const = 0;
    // Total number of flaps
    virtual uint64_t num_flaps() const = 0;
 
    virtual void GetRxProtoStats(ProtoStats *stats) const = 0;
    virtual void GetRxRouteUpdateStats(UpdateStats *stats) const = 0;
    virtual void GetRxSocketStats(SocketStats *stats) const = 0;
    virtual void GetRxErrorStats(RxErrorStats *stats) const = 0;
    virtual void GetRxRouteStats(RxRouteStats *stats) const = 0;
 
    virtual void GetTxProtoStats(ProtoStats *stats) const = 0;
    virtual void GetTxRouteUpdateStats(UpdateStats *stats) const = 0;
    virtual void GetTxSocketStats(SocketStats *stats) const = 0;
 
    virtual void UpdateTxReachRoute(uint64_t count) = 0;
    virtual void UpdateTxUnreachRoute(uint64_t count) = 0;
};
 
// Interface for PeerCloseManager clients
class IPeerClose {
public:
    typedef std::set<Address::Family> Families;
 
    virtual ~IPeerClose() { }
    virtual void Close(bool graceful) = 0;
    virtual bool IsCloseGraceful() const = 0;
    virtual bool IsCloseLongLivedGraceful() const = 0;
    virtual void CustomClose() = 0;
    virtual void CloseComplete() = 0;
    virtual void Delete() = 0;
    virtual void GracefulRestartStale() = 0;
    virtual void LongLivedGracefulRestartStale() = 0;
    virtual void GracefulRestartSweep() = 0;
    virtual void GetGracefulRestartFamilies(Families *) const = 0;
    virtual int GetGracefulRestartTime() const = 0;
    virtual int GetLongLivedGracefulRestartTime() const = 0;
    virtual void GetLongLivedGracefulRestartFamilies(Families *) const = 0;
    virtual bool IsReady() const = 0;
    virtual IPeer *peer() const = 0;
    virtual void ReceiveEndOfRIB(Address::Family family) = 0;
    virtual void MembershipRequestCallbackComplete() = 0;
    virtual const char *GetTaskName() const = 0;
    virtual int GetTaskInstance() const = 0;
    virtual PeerCloseManager *GetManager() const = 0;
    virtual void UpdateRouteStats(Address::Family family,
        const BgpPath *old_path, uint32_t path_flags) const = 0;
};
 
class IPeer : public IPeerUpdate {
public:
    virtual ~IPeer() { }
    // Printable name
    virtual const std::string &ToString() const = 0;
    virtual const std::string &ToUVEKey() const = 0;
    virtual BgpServer *server() = 0;
    virtual BgpServer *server() const = 0;
    virtual IPeerClose *peer_close() const = 0;
    virtual IPeerClose *peer_close() = 0;
    virtual IPeerDebugStats *peer_stats() = 0;
    virtual const IPeerDebugStats *peer_stats() const = 0;
    virtual bool IsReady() const = 0;
    virtual bool IsXmppPeer() const = 0;
    virtual bool IsRouterTypeBGPaaS() const = 0;
    //
    // Whether the peer must register to a table
    // before it could push the route to VRF.
    // Control is mostly required in MockPeer in unit tests.
    //
    virtual bool IsRegistrationRequired() const = 0;
    virtual void Close(bool graceful) = 0;
    virtual BgpProto::BgpPeerType PeerType() const = 0;
    virtual uint32_t bgp_identifier() const = 0;
    virtual const std::string GetStateName() const = 0;
    virtual void UpdateTotalPathCount(int count) const = 0;
    virtual int GetTotalPathCount() const = 0;
    virtual bool IsAs4Supported() const = 0;
    virtual void ProcessPathTunnelEncapsulation(const BgpPath *path,
        BgpAttr *attr, ExtCommunityDB *extcomm_db,
        const BgpTable *table) const = 0;
    virtual const std::vector<std::string> GetDefaultTunnelEncap(
        const Address::Family family) const = 0;
    virtual void UpdatePrimaryPathCount(int count,
        Address::Family family = Address::UNSPEC) const = 0;
    virtual int GetPrimaryPathCount() const = 0;
    virtual void MembershipRequestCallback(BgpTable *table) = 0;
    virtual bool MembershipPathCallback(DBTablePartBase *tpart,
        BgpRoute *route, BgpPath *path) = 0;
    virtual bool CanUseMembershipManager() const = 0;
    virtual bool IsInGRTimerWaitState() const = 0;
    virtual void UpdateCloseRouteStats(Address::Family family,
        const BgpPath *old_path, uint32_t path_flags) const = 0;
    virtual bool CheckSplitHorizon(uint32_t cluster_id = 0,
            uint32_t ribout_cid = 0) const {
        return PeerType() == BgpProto::IBGP;
    }
};
 
#endif  // SRC_BGP_IPEER_H_