KNetwork::KReverseResolver Class Reference

#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=nullptr)
	~KReverseResolver () override
const KSocketAddress &	address () const
bool	event (QEvent *) override
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)
bool	blockSignals (bool block)
const QObjectList &	children () const const
QMetaObject::Connection	connect (const QObject *sender, const char *signal, const char *method, Qt::ConnectionType type) const const
void	deleteLater ()
void	destroyed (QObject *obj)
bool	disconnect (const char *signal, const QObject *receiver, const char *method) const const
bool	disconnect (const QObject *receiver, const char *method) const const
void	dumpObjectInfo ()
void	dumpObjectInfo () const const
void	dumpObjectTree ()
void	dumpObjectTree () const const
QList< QByteArray >	dynamicPropertyNames () const const
virtual bool	eventFilter (QObject *watched, QEvent *event)
T	findChild (const QString &name, Qt::FindChildOptions options) const const
QList< T >	findChildren (const QRegExp &regExp, Qt::FindChildOptions options) const const
QList< T >	findChildren (const QRegularExpression &re, Qt::FindChildOptions options) const const
QList< T >	findChildren (const QString &name, Qt::FindChildOptions options) const const
bool	inherits (const char *className) const const
void	installEventFilter (QObject *filterObj)
bool	isWidgetType () const const
bool	isWindowType () const const
void	killTimer (int id)
virtual const QMetaObject *	metaObject () const const
void	moveToThread (QThread *targetThread)
QString	objectName () const const
void	objectNameChanged (const QString &objectName)
QObject *	parent () const const
QVariant	property (const char *name) const const
	Q_CLASSINFO (Name, Value)
	Q_DISABLE_COPY (Class)
	Q_DISABLE_COPY_MOVE (Class)
	Q_DISABLE_MOVE (Class)
	Q_EMIT Q_EMIT
	Q_ENUM (...)
	Q_ENUM_NS (...)
	Q_ENUMS (...)
	Q_FLAG (...)
	Q_FLAG_NS (...)
	Q_FLAGS (...)
	Q_GADGET Q_GADGET
	Q_INTERFACES (...)
	Q_INVOKABLE Q_INVOKABLE
	Q_NAMESPACE Q_NAMESPACE
	Q_NAMESPACE_EXPORT (EXPORT_MACRO)
	Q_OBJECT Q_OBJECT
	Q_PROPERTY (...)
	Q_REVISION Q_REVISION
	Q_SET_OBJECT_NAME (Object)
	Q_SIGNAL Q_SIGNAL
	Q_SIGNALS Q_SIGNALS
	Q_SLOT Q_SLOT
	Q_SLOTS Q_SLOTS
T	qFindChild (const QObject *obj, const QString &name)
QList< T >	qFindChildren (const QObject *obj, const QRegExp &regExp)
QList< T >	qFindChildren (const QObject *obj, const QString &name)
T	qobject_cast (const QObject *object)
T	qobject_cast (QObject *object)
	QT_NO_NARROWING_CONVERSIONS_IN_CONNECT QT_NO_NARROWING_CONVERSIONS_IN_CONNECT
void	removeEventFilter (QObject *obj)
void	setObjectName (const QString &name)
void	setParent (QObject *parent)
bool	setProperty (const char *name, const QVariant &value)
bool	signalsBlocked () const const
int	startTimer (int interval, Qt::TimerType timerType)
int	startTimer (std::chrono::milliseconds time, Qt::TimerType timerType)
QThread *	thread () const 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
QMetaObject::Connection	connect (const QObject *sender, const char *signal, const QObject *receiver, const char *method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, const QMetaMethod &signal, const QObject *receiver, const QMetaMethod &method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, const QObject *context, Functor functor, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method, Qt::ConnectionType type)
QMetaObject::Connection	connect (const QObject *sender, PointerToMemberFunction signal, Functor functor)
bool	disconnect (const QMetaObject::Connection &connection)
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)
bool	disconnect (const QObject *sender, PointerToMemberFunction signal, const QObject *receiver, PointerToMemberFunction method)
QString	tr (const char *sourceText, const char *disambiguation, int n)
QString	trUtf8 (const char *sourceText, const char *disambiguation, int n)

Additional Inherited Members
Properties inherited from QObject
	objectName
Public Attributes inherited from QObject
typedef	QObjectList
Protected Member Functions inherited from QObject
virtual void	childEvent (QChildEvent *event)
virtual void	connectNotify (const QMetaMethod &signal)
virtual void	customEvent (QEvent *event)
virtual void	disconnectNotify (const QMetaMethod &signal)
bool	isSignalConnected (const QMetaMethod &signal) const const
int	receivers (const char *signal) const const
QObject *	sender () const const
int	senderSignalIndex () const const
virtual void	timerEvent (QTimerEvent *event)

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[email protected][email protected][email protected]e.org

Deprecated:

Use KSocketFactory or KLocalSocket instead

Definition at line 52 of file k3reverseresolver.h.

Member Enumeration Documentation

Flags

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.

Definition at line 76 of file k3reverseresolver.h.

Constructor & Destructor Documentation

KReverseResolver()

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

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::~KReverseResolver ( )

override

Destructor.

Definition at line 122 of file k3reverseresolver.cpp.

Member Function Documentation

address()

const KSocketAddress & KReverseResolver::address

(

)

const

Returns the socket address which was subject to resolution.

Definition at line 155 of file k3reverseresolver.cpp.

event()

bool KReverseResolver::event ( QEvent *  e )

overridevirtual

Overrides event handling.

Reimplemented from QObject.

Definition at line 178 of file k3reverseresolver.cpp.

failure()

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 140 of file k3reverseresolver.cpp.

finished

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

isRunning()

bool KReverseResolver::isRunning

(

)

const

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

Definition at line 130 of file k3reverseresolver.cpp.

node()

QString KReverseResolver::node

(

)

const

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

Definition at line 145 of file k3reverseresolver.cpp.

resolve() [1/2]

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 199 of file k3reverseresolver.cpp.

resolve() [2/2]

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 211 of file k3reverseresolver.cpp.

service()

QString KReverseResolver::service

(

)

const

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

Definition at line 150 of file k3reverseresolver.cpp.

start()

bool KReverseResolver::start

(

)

Starts the resolution.

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

Definition at line 160 of file k3reverseresolver.cpp.

success()

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 135 of file k3reverseresolver.cpp.

---

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

• k3reverseresolver.h
• k3reverseresolver.cpp