qjdns.h

Go to the documentation of this file.

/*
 * Copyright (C) 2005,2006  Justin Karneges
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the
 * "Software"), to deal in the Software without restriction, including
 * without limitation the rights to use, copy, modify, merge, publish,
 * distribute, sublicense, and/or sell copies of the Software, and to
 * permit persons to whom the Software is furnished to do so, subject to
 * the following conditions:
 *
 * The above copyright notice and this permission notice shall be included
 * in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
 * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */

 
#ifndef QJDNS_H
#define QJDNS_H
 
#include "jdns_export.h"
#include <QtCore>
#include <QtNetwork>
 
class JDNS_EXPORT QJDns : public QObject
{
    Q_OBJECT
public:
    enum Mode
    {
        Unicast,
        Multicast
    };
 
    enum PublishMode
    {
        Unique,
        Shared
    };
 
    enum Type
    {
        A       = 1,
        Aaaa    = 28,
        Mx      = 15,
        Srv     = 33,
        Cname   = 5,
        Ptr     = 12,
        Txt     = 16,
        Hinfo   = 13,
        Ns      = 2,
        Any     = 255
    };
 
    enum Error
    {
        ErrorGeneric,
        ErrorNXDomain, 
        ErrorTimeout,  
        ErrorConflict  
    };
 
    class JDNS_EXPORT NameServer
    {
    public:
        QHostAddress address;
        int port;
 
        NameServer();
    };
 
    class JDNS_EXPORT DnsHost
    {
    public:
        QByteArray name;
        QHostAddress address;
    };
 
    class JDNS_EXPORT SystemInfo
    {
    public:
        QList<NameServer> nameServers;
        QList<QByteArray> domains;
        QList<DnsHost> hosts;
    };
 
    class JDNS_EXPORT Record
    {
    public:
        QByteArray owner;
        int ttl;
        int type;
        QByteArray rdata;
        bool haveKnown;
 
        // known
        QHostAddress address;    
        QByteArray name;         
        int priority;            
        int weight;              
        int port;                
        QList<QByteArray> texts; 
        QByteArray cpu;          
        QByteArray os;           
 
        Record();
        bool verify() const;
    };
 
    class JDNS_EXPORT Response
    {
    public:
        QList<Record> answerRecords;
        QList<Record> authorityRecords;
        QList<Record> additionalRecords;
    };
 
    QJDns(QObject *parent = 0);
    ~QJDns();
 
    bool init(Mode mode, const QHostAddress &address);
    void shutdown();
    QStringList debugLines();
 
    static SystemInfo systemInfo();
    static QHostAddress detectPrimaryMulticast(const QHostAddress &address);
 
    void setNameServers(const QList<NameServer> &list);
 
    int queryStart(const QByteArray &name, int type);
    void queryCancel(int id);
 
    // for multicast mode only
    int publishStart(PublishMode m, const Record &record);
    void publishUpdate(int id, const Record &record);
    void publishCancel(int id);
 
signals:
    void resultsReady(int id, const QJDns::Response &results);
    void published(int id);
    void error(int id, QJDns::Error e);
    void shutdownFinished();
    void debugLinesReady();
 
private:
    class Private;
    friend class Private;
    Private *d;
};
 
#endif