libjdns-dev 2.0.3-1build1 / usr / include / jdns / qjdns.h

/*
 * 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.
 */

// this is the Qt wrapper to jdns.  it requires Qt 4.1+

#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, // query only
		ErrorTimeout,  // query only
		ErrorConflict  // publish only
	};

	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;    // for A, Aaaa
		QByteArray name;         // for Mx, Srv, Cname, Ptr, Ns
		int priority;            // for Mx, Srv
		int weight;              // for Srv
		int port;                // for Srv
		QList<QByteArray> texts; // for Txt
		QByteArray cpu;          // for Hinfo
		QByteArray os;           // for Hinfo

		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