• Skip to content
  • Skip to link menu
KDE 4.1 API Reference
  • KDE API Reference
  • kdelibs
  • Sitemap
  • Contact Us
 

KDECore

KNetwork::KReverseResolver

KNetwork::KReverseResolver Class Reference

#include <k3reverseresolver.h>

Inheritance diagram for KNetwork::KReverseResolver:

Inheritance graph
[legend]

List of all members.


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 <thiago@kde.org>

Definition at line 50 of file k3reverseresolver.h.


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

const KSocketAddress & address () const
virtual bool event (QEvent *)
bool failure () const
bool isRunning () const
 KReverseResolver (const KSocketAddress &addr, int flags=0, QObject *=0L)
QString node () const
QString service () const
bool start ()
bool success () const
virtual ~KReverseResolver ()

Static Public Member Functions

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

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 74 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

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

bool KReverseResolver::event ( QEvent *  e  )  [virtual]

Overrides event handling.

Reimplemented from QObject.

Definition at line 175 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 138 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 128 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 143 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 208 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 195 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 148 of file k3reverseresolver.cpp.

bool KReverseResolver::start (  ) 

Starts the resolution.

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

Definition at line 158 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 133 of file k3reverseresolver.cpp.


The documentation for this class was generated from the following files:
  • k3reverseresolver.h
  • k3reverseresolver.cpp

KDECore

Skip menu "KDECore"
  • Main Page
  • Modules
  • Namespace List
  • Class Hierarchy
  • Alphabetical List
  • Class List
  • File List
  • Namespace Members
  • Class Members
  • Related Pages

kdelibs

Skip menu "kdelibs"
  • DNSSD
  • Interfaces
  •   KHexEdit
  •   KMediaPlayer
  •   KSpeech
  •   KTextEditor
  • Kate
  • kconf_update
  • KDE3Support
  •   KUnitTest
  • KDECore
  • KDED
  • KDEsu
  • KDEUI
  • KDocTools
  • KFile
  • KHTML
  • KImgIO
  • KInit
  • KIO
  • KIOSlave
  • KJS
  •   KJS-API
  •   WTF
  • kjsembed
  • KNewStuff
  • KParts
  • Kross
  • KUtils
  • Nepomuk
  • Solid
  • Sonnet
  • ThreadWeaver
Generated for kdelibs by doxygen 1.5.4
This website is maintained by Adriaan de Groot and Allen Winter.
KDE® and the K Desktop Environment® logo are registered trademarks of KDE e.V. | Legal