dns_client.h

Go to the documentation of this file.

// Copyright (C) 2013-2024 Internet Systems Consortium, Inc. ("ISC")
//
// This Source Code Form is subject to the terms of the Mozilla Public
// License, v. 2.0. If a copy of the MPL was not distributed with this
// file, You can obtain one at http://mozilla.org/MPL/2.0/.
 
#ifndef DNS_CLIENT_H
#define DNS_CLIENT_H
 
#include <asiolink/io_service.h>
#include <asiodns/io_fetch.h>
#include <d2srv/d2_tsig_key.h>
#include <d2srv/d2_update_message.h>
#include <util/buffer.h>
 
namespace isc {
namespace d2 {
 
class DNSClient;
typedef boost::shared_ptr<DNSClient> DNSClientPtr;
 
class DNSClientImpl;
 
class DNSClient {
public:
 
    enum Protocol {
        UDP,
        TCP
    };
 
    enum Status {
        SUCCESS,           
        TIMEOUT,           
        IO_STOPPED,        
        INVALID_RESPONSE,  
        OTHER              
    };
 
    class Callback {
    public:
        virtual ~Callback() { }
 
        virtual void operator()(DNSClient::Status status) = 0;
    };
 
    DNSClient(D2UpdateMessagePtr& response_placeholder, Callback* callback,
              const Protocol proto = UDP);
 
    ~DNSClient();
 
    void stop();
 
 
private:
    DNSClient(const DNSClient& source);
    DNSClient& operator=(const DNSClient& source);
 
public:
 
    static unsigned int getMaxTimeout();
 
    void doUpdate(const asiolink::IOServicePtr& io_service,
                  const asiolink::IOAddress& ns_addr,
                  const uint16_t ns_port,
                  D2UpdateMessage& update,
                  const unsigned int wait,
                  const D2TsigKeyPtr& tsig_key = D2TsigKeyPtr());
 
private:
    std::unique_ptr<DNSClientImpl> impl_;
};
 
} // namespace d2
} // namespace isc
 
#endif // DNS_CLIENT_H