#include <k3reverseresolver.h>

Inheritance diagram for KNetwork::KReverseResolver:

Public Types
enum	Flags { NumericHost = 0x01, NumericService = 0x02, NodeNameOnly = 0x04, Datagram = 0x08, NumericScope = 0x10, ResolutionRequired = 0x20 }

Signals
void	finished (const KNetwork::KReverseResolver &obj)

Public Member Functions
	KReverseResolver (const KSocketAddress &addr, int flags=0, QObject *parent=0L)

virtual	~KReverseResolver ()

const KSocketAddress &	address () const

virtual bool	event (QEvent *)

bool	failure () const

bool	isRunning () const

QString	node () const

QString	service () const

bool	start ()

bool	success () const

Public Member Functions inherited from QObject
	QObject (QObject *parent)

	QObject (QObject parent, const char name)

virtual	~QObject ()

bool	blockSignals (bool block)

QObject *	child (const char objName, const char inheritsClass, bool recursiveSearch) const

const QObjectList &	children () const

const char *	className () const

bool	connect (const QObject sender, const char signal, const char *method, Qt::ConnectionType type) const

void	deleteLater ()

void	destroyed (QObject *obj)

bool	disconnect (const QObject receiver, const char method)

bool	disconnect (const char signal, const QObject receiver, const char *method)

void	dumpObjectInfo ()

void	dumpObjectTree ()

QList< QByteArray >	dynamicPropertyNames () const

virtual bool	eventFilter (QObject watched, QEvent event)

T	findChild (const QString &name) const

QList< T >	findChildren (const QRegExp &regExp) const

QList< T >	findChildren (const QString &name) const

bool	inherits (const char *className) const

void	insertChild (QObject *object)

void	installEventFilter (QObject *filterObj)

bool	isA (const char *className) const

bool	isWidgetType () const

void	killTimer (int id)

virtual const QMetaObject *	metaObject () const

void	moveToThread (QThread *targetThread)

const char *	name () const

const char *	name (const char *defaultName) const

QString	objectName () const

QObject *	parent () const

QVariant	property (const char *name) const

void	removeChild (QObject *object)

void	removeEventFilter (QObject *obj)

void	setName (const char *name)

void	setObjectName (const QString &name)

void	setParent (QObject *parent)

bool	setProperty (const char *name, const QVariant &value)

bool	signalsBlocked () const

int	startTimer (int interval)

QThread *	thread () const

Static Public Member Functions
static bool	resolve (const KSocketAddress &addr, QString &node, QString &serv, int flags=0)

static bool	resolve (const struct sockaddr *sa, quint16 salen, QString &node, QString &serv, int flags=0)

Static Public Member Functions inherited from QObject
bool	connect (const QObject sender, const char signal, const QObject receiver, const char method, Qt::ConnectionType type)

bool	connect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method, Qt::ConnectionType type)

bool	disconnect (const QObject sender, const char signal, const QObject receiver, const char method)

bool	disconnect (const QObject sender, const QMetaMethod &signal, const QObject receiver, const QMetaMethod &method)

QString	tr (const char sourceText, const char disambiguation, int n)

QString	trUtf8 (const char sourceText, const char disambiguation, int n)

Additional Inherited Members
Protected Member Functions inherited from QObject
bool	checkConnectArgs (const char signal, const QObject object, const char *method)

virtual void	childEvent (QChildEvent *event)

virtual void	connectNotify (const char *signal)

virtual void	customEvent (QEvent *event)

virtual void	disconnectNotify (const char *signal)

int	receivers (const char *signal) const

QObject *	sender () const

int	senderSignalIndex () const

virtual void	timerEvent (QTimerEvent *event)

Static Protected Member Functions inherited from QObject
QByteArray	normalizeSignalSlot (const char *signalSlot)

Properties inherited from QObject
	objectName

Detailed Description

Run a reverse-resolution on a socket address.

This class is provided as a counterpart to KResolver in such a way as it produces a reverse resolution: it resolves a socket address from its binary representations into a textual representation.

Most users will use the static functions resolve(), which work both synchronously (blocking) and asynchronously (non-blocking).

Author: Thiago Macieira thiag.nosp@m.o@kd.nosp@m.e.org

Deprecated:: Use KSocketFactory or KLocalSocket instead

Definition at line 51 of file k3reverseresolver.h.

Member Enumeration Documentation

enum KNetwork::KReverseResolver::Flags

Flags for the reverse resolution.

These flags are used by the reverse resolution functions for setting resolution parameters. The possible values are:

NumericHost: don't try to resolve the host address to a text form. Instead, convert the address to its numeric textual representation.
NumericService: the same as NumericHost, but for the service name
NodeNameOnly: returns the node name only (i.e., not the Fully Qualified Domain Name)
Datagram: in case of ambiguity in the service name, prefer the name associated with the datagram protocol
NumericScope: for those addresses which have the concept of scope, resolve using the numeric value instead of the proper scope name.
ResolutionRequired: normally, when resolving, if the name resolution fails, the process normally converts the numeric address into its presentation forms. This flag causes the function to return with error instead.

Enumerator
NumericHost
NumericService
NodeNameOnly
Datagram
NumericScope
ResolutionRequired

Definition at line 75 of file k3reverseresolver.h.

Constructor & Destructor Documentation

KReverseResolver::KReverseResolver	(	const KSocketAddress &	addr,
		int	flags = `0`,
		QObject *	parent = `0L`
	)

explicit

Constructs this object to resolve the given socket address.

Parameters

addr	the address to resolve
flags	the flags to use, see Flags
parent	the parent object (see QObject)

Definition at line 115 of file k3reverseresolver.cpp.

KReverseResolver::~KReverseResolver ( )

virtual

Destructor.

Definition at line 122 of file k3reverseresolver.cpp.

Member Function Documentation

const KSocketAddress & KReverseResolver::address ( ) const

Returns the socket address which was subject to resolution.

Definition at line 154 of file k3reverseresolver.cpp.

bool KReverseResolver::event ( QEvent * e )

virtual

Overrides event handling.

Reimplemented from QObject.

Definition at line 176 of file k3reverseresolver.cpp.

bool KReverseResolver::failure ( ) const

This function returns true if the processing has finished with failure, false if it's still running or succeeded.

Definition at line 139 of file k3reverseresolver.cpp.

void KNetwork::KReverseResolver::finished ( const KNetwork::KReverseResolver & obj )

signal

This signal is emitted when the resolution has finished.

Parameters

obj	this class, which contains the results

bool KReverseResolver::isRunning ( ) const

This function returns 'true' if the processing is still running.

Definition at line 129 of file k3reverseresolver.cpp.

QString KReverseResolver::node ( ) const

Returns the resolved node name, if the resolution has finished successfully, or QString() otherwise.

Definition at line 144 of file k3reverseresolver.cpp.

bool KReverseResolver::resolve	(	const KSocketAddress &	addr,
		QString &	node,
		QString &	serv,
		int	flags = `0`
	)

static

Resolves a socket address to its textual representation.

FIXME!! How can we do this in a non-blocking manner!?

This function is used to resolve a socket address from its binary representation to a textual form, even if numeric only.

Parameters

addr	the socket address to be resolved
node	the QString where we will store the resolved node
serv	the QString where we will store the resolved service
flags	flags to be used for this resolution.

Returns: true if the resolution succeeded, false if not

See also: ReverseFlags for the possible values for flags

Definition at line 196 of file k3reverseresolver.cpp.

bool KReverseResolver::resolve	(	const struct sockaddr *	sa,
		quint16	salen,
		QString &	node,
		QString &	serv,
		int	flags = `0`
	)

static

Resolves a socket address to its textual representation.

FIXME!! How can we do this in a non-blocking manner!?

This function behaves just like the above one, except it takes a sockaddr structure and its size as parameters.

Parameters

sa	the sockaddr structure containing the address to be resolved
salen	the length of the sockaddr structure
node	the QString where we will store the resolved node
serv	the QString where we will store the resolved service
flags	flags to be used for this resolution.

Returns: true if the resolution succeeded, false if not

See also: ReverseFlags for the possible values for flags

Definition at line 209 of file k3reverseresolver.cpp.

QString KReverseResolver::service ( ) const

Returns the resolved service name, if the resolution has finished successfully, or QString() otherwise.

Definition at line 149 of file k3reverseresolver.cpp.

bool KReverseResolver::start ( )

Starts the resolution.

This function returns 'true' if the resolution has started successfully.

Definition at line 159 of file k3reverseresolver.cpp.

bool KReverseResolver::success ( ) const

This function returns true if the processing has finished with success, false if it's still running or failed.

Definition at line 134 of file k3reverseresolver.cpp.

The documentation for this class was generated from the following files:

KDECore

Public Types

Signals

Public Member Functions

Static Public Member Functions

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

KDECore

kdelibs API Reference

Search