\section{KNetwork::KResolver Class Reference}
\label{classKNetwork_1_1KResolver}\index{KNetwork::KResolver@{KNetwork::KResolver}}
Name and service resolution class.  


{\tt \#include $<$kresolver.h$>$}

Inheritance diagram for KNetwork::KResolver:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=73pt]{classKNetwork_1_1KResolver__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KNetwork::KResolver:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=95pt]{classKNetwork_1_1KResolver__coll__graph}
\end{center}
\end{figure}
\subsection*{Public Types}
\begin{CompactItemize}
\item 
enum {\bf Socket\-Families} \{ \par
{\bf Unknown\-Family} =  0x0001, 
{\bf Unix\-Family} =  0x0002, 
{\bf Local\-Family} =  Unix\-Family, 
{\bf IPv4Family} =  0x0004, 
\par
{\bf IPv6Family} =  0x0008, 
{\bf Internet\-Family} =  IPv4Family $|$ IPv6Family, 
{\bf Inet\-Family} =  Internet\-Family, 
{\bf Known\-Family} =  $\sim$Unknown\-Family, 
\par
{\bf Any\-Family} =  Known\-Family $|$ Unknown\-Family
 \}
\item 
enum {\bf Flags} \{ \par
{\bf Passive} =  0x01, 
{\bf Canon\-Name} =  0x02, 
{\bf No\-Resolve} =  0x04, 
{\bf No\-Srv} =  0x08, 
\par
{\bf Multiport} =  0x10
 \}
\item 
enum {\bf Error\-Codes} \{ \par
{\bf No\-Error} =  0, 
{\bf Addr\-Family} =  -1, 
{\bf Try\-Again} =  -2, 
{\bf Non\-Recoverable} =  -3, 
\par
{\bf Bad\-Flags} =  -4, 
{\bf Memory} =  -5, 
{\bf No\-Name} =  -6, 
{\bf Unsupported\-Family} =  -7, 
\par
{\bf Unsupported\-Service} =  -8, 
{\bf Unsupported\-Socket\-Type} =  -9, 
{\bf Unknown\-Error} =  -10, 
{\bf System\-Error} =  -11, 
\par
{\bf Canceled} =  -100
 \}
\item 
enum {\bf Status\-Codes} \{ \par
{\bf Idle} =  0, 
{\bf Queued} =  1, 
{\bf In\-Progress} =  5, 
{\bf Post\-Processing} =  6, 
\par
{\bf Success} =  10, 
{\bf Failed} =  -101
 \}
\end{CompactItemize}
\subsection*{Signals}
\begin{CompactItemize}
\item 
void {\bf finished} ({\bf KResolver\-Results} results)
\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf KResolver} ({\bf QObject} $\ast$=0L, const char $\ast$=0L)
\item 
{\bf KResolver} (const {\bf QString} \&nodename, const {\bf QString} \&servicename=QString::null, {\bf QObject} $\ast$=0L, const char $\ast$=0L)
\item 
virtual {\bf $\sim$KResolver} ()
\item 
int {\bf status} () const 
\item 
int {\bf error} () const 
\item 
int {\bf system\-Error} () const 
\item 
{\bf QString} {\bf error\-String} () const 
\item 
bool {\bf is\-Running} () const 
\item 
{\bf QString} {\bf node\-Name} () const 
\item 
{\bf QString} {\bf service\-Name} () const 
\item 
void {\bf set\-Node\-Name} (const {\bf QString} \&nodename)
\item 
void {\bf set\-Service\-Name} (const {\bf QString} \&service)
\item 
void {\bf set\-Address} (const {\bf QString} \&node, const {\bf QString} \&service)
\item 
int {\bf flags} () const 
\item 
int {\bf set\-Flags} (int flags)
\item 
void {\bf set\-Family} (int families)
\item 
void {\bf set\-Socket\-Type} (int type)
\item 
void {\bf set\-Protocol} (int protonum, const char $\ast${\bf name}=0L)
\item 
bool {\bf start} ()
\item 
bool {\bf wait} (int msec=0)
\item 
void {\bf cancel} (bool emit\-Signal=true)
\item 
{\bf KResolver\-Results} {\bf results} () const 
\item 
virtual bool {\bf event} ({\bf QEvent} $\ast$)
\end{CompactItemize}
\subsection*{Static Public Member Functions}
\begin{CompactItemize}
\item 
static {\bf QString} {\bf error\-String} (int errorcode, int syserror=0)
\item 
static {\bf KResolver\-Results} {\bf resolve} (const {\bf QString} \&host, const {\bf QString} \&service, int flags=0, int families=KResolver::Internet\-Family)
\item 
static bool {\bf resolve\-Async} ({\bf QObject} $\ast$user\-Obj, const char $\ast$user\-Slot, const {\bf QString} \&host, const {\bf QString} \&service, int flags=0, int families=KResolver::Internet\-Family)
\item 
static {\bf QCString} {\bf domain\-To\-Ascii} (const {\bf QString} \&unicode\-Domain)
\item 
static {\bf QString} {\bf domain\-To\-Unicode} (const {\bf QCString} \&ascii\-Domain)
\item 
static {\bf QString} {\bf domain\-To\-Unicode} (const {\bf QString} \&ascii\-Domain)
\item 
static {\bf QString} {\bf normalize\-Domain} (const {\bf QString} \&domain)
\item 
static {\bf QStr\-List} {\bf protocol\-Name} (int protonum)
\item 
static {\bf QStr\-List} {\bf protocol\-Name} (const char $\ast$protoname)
\item 
static int {\bf protocol\-Number} (const char $\ast$protoname)
\item 
static int {\bf service\-Port} (const char $\ast$servname, const char $\ast$protoname)
\item 
static {\bf QStr\-List} {\bf service\-Name} (const char $\ast$servname, const char $\ast$protoname)
\item 
static {\bf QStr\-List} {\bf service\-Name} (int port, const char $\ast$protoname)
\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
void {\bf set\-Error} (int errorcode, int systemerror=0)
\item 
virtual void {\bf virtual\_\-hook} (int id, void $\ast$data)\label{classKNetwork_1_1KResolver_b1}

\end{CompactItemize}
\subsection*{Friends}
\begin{CompactItemize}
\item 
class {\bf KResolver\-Results}\label{classKNetwork_1_1KResolver_n0}

\item 
class {\bf ::KNetwork::Internal::KResolver\-Manager}\label{classKNetwork_1_1KResolver_n1}

\end{CompactItemize}


\subsection{Detailed Description}
Name and service resolution class. 

This class provides support for doing name-to-binary resolution for nodenames and service ports. You should use this class if you need specific resolution techniques when creating a socket or if you want to inspect the results before calling the socket functions.

You can either create an object and set the options you want in it or you can simply call the static member functions, which will create standard Resolver objects and dispatch the resolution for you. Normally, the static functions will be used, except in cases where specific options must be set.

A Resolver object defaults to the following: \begin{itemize}
\item address family: any address family \item socket type: streaming socket \item protocol: implementation-defined. Generally, TCP \item host and service: unset\end{itemize}
\begin{Desc}
\item[Author:]Thiago Macieira $<${\tt thiago.macieira@kdemail.net}$>$ \end{Desc}




Definition at line 295 of file kresolver.h.

\subsection{Member Enumeration Documentation}
\index{KNetwork::KResolver@{KNetwork::KResolver}!SocketFamilies@{SocketFamilies}}
\index{SocketFamilies@{SocketFamilies}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KNetwork::KResolver::Socket\-Families}}\label{classKNetwork_1_1KResolver_w33}


Address family selection types. 

These values can be OR-ed together to form a composite family selection.

\begin{itemize}
\item Unknown\-Family: a family that is unknown to the current implementation \item Known\-Family: a family that is known to the implementation (the exact opposite of Unknown\-Family) \item Any\-Families: any address family is acceptable \item Internet\-Family: an address for connecting to the Internet \item Inet\-Family: alias for Internet\-Family \item IPv6Family: an IPv6 address only \item IPv4Family: an IPv4 address only \item Unix\-Family: an address for the local Unix namespace (i.e., Unix sockets) \item Local\-Family: alias for Unix\-Family \end{itemize}


Definition at line 317 of file kresolver.h.\index{KNetwork::KResolver@{KNetwork::KResolver}!Flags@{Flags}}
\index{Flags@{Flags}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KNetwork::KResolver::Flags}}\label{classKNetwork_1_1KResolver_w34}


Flags for the resolution. 

These flags are used for setting the resolution behaviour for this object: \begin{itemize}
\item Passive: resolve to a passive socket (i.e., one that can be used for binding to a local interface) \item Canon\-Name: request that the canonical name for the given nodename be found and recorded \item No\-Resolve: request that no external resolution be performed. The given nodename and servicename will be resolved locally only. \item No\-Srv: don't try to use SRV-based name-resolution. \item Multiport: the port/service argument is a list of port numbers and ranges. (future extension)\end{itemize}
\begin{Desc}
\item[Note:]SRV-based lookup and Multiport are not implemented yet. \end{Desc}


Definition at line 350 of file kresolver.h.\index{KNetwork::KResolver@{KNetwork::KResolver}!ErrorCodes@{ErrorCodes}}
\index{ErrorCodes@{ErrorCodes}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KNetwork::KResolver::Error\-Codes}}\label{classKNetwork_1_1KResolver_w35}


Error codes. 

These are the possible error values that objects of this class may return. See {\bf error\-String()}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a6})} for getting a string representation for these errors.

\begin{itemize}
\item Addr\-Family: Address family for the given nodename is not supported. \item Try\-Again: Temporary failure in name resolution. You should try again. \item Non\-Recoverable: Non-recoverable failure in name resolution. \item Bad\-Flags: Invalid flags were given. \item Memory: Memory allocation failure. \item No\-Name: The specified name or service doesn't exist. \item Unsupported\-Family: The requested socket family is not supported. \item Unsupported\-Service: The requested service is not supported for this socket type (i.e., a datagram service in a streaming socket). \item Unsupported\-Socket\-Type: The requested socket type is not supported. \item Unknown\-Error: An unknown, unexpected error occurred. \item System\-Error: A system error occurred. See {\bf system\-Error}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a5})}. \item Canceled: This request was cancelled by the user. \end{itemize}


Definition at line 380 of file kresolver.h.\index{KNetwork::KResolver@{KNetwork::KResolver}!StatusCodes@{StatusCodes}}
\index{StatusCodes@{StatusCodes}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KNetwork::KResolver::Status\-Codes}}\label{classKNetwork_1_1KResolver_w36}


Status codes. 

These are the possible status for a Resolver object. A value greater than zero indicates normal behaviour, while negative values either indicate failure or error.

\begin{itemize}
\item Idle: resolution has not yet been started. \item Queued: resolution is queued but not yet in progress. \item In\-Progress: resolution is in progress. \item Post\-Processing: resolution is in progress. \item Success: resolution is done; you can retrieve the results. \item Canceled: request cancelled by the user. \item Failed: resolution is done, but failed.\end{itemize}
Note: the status Canceled and the error code Canceled are the same.

Note 2: the status Queued and In\-Progress might not be distinguishable. Some implementations might not differentiate one from the other. 

Definition at line 418 of file kresolver.h.

\subsection{Constructor \& Destructor Documentation}
\index{KNetwork::KResolver@{KNetwork::KResolver}!KResolver@{KResolver}}
\index{KResolver@{KResolver}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KResolver::KResolver ({\bf QObject} $\ast$ = {\tt 0L}, const char $\ast$ = {\tt 0L})}\label{classKNetwork_1_1KResolver_a0}


Default constructor. 

Creates an empty Resolver object. You should set the wanted names and flags using the member functions before starting the name resolution. 

Definition at line 290 of file kresolver.cpp.

Referenced by resolve\-Async().\index{KNetwork::KResolver@{KNetwork::KResolver}!KResolver@{KResolver}}
\index{KResolver@{KResolver}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KResolver::KResolver (const {\bf QString} \& {\em nodename}, const {\bf QString} \& {\em servicename} = {\tt QString::null}, {\bf QObject} $\ast$ = {\tt 0L}, const char $\ast$ = {\tt 0L})}\label{classKNetwork_1_1KResolver_a1}


Constructor with host and service names. 

Creates a Resolver object with the given host and service names. Flags are initialised to 0 and any address family will be accepted.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em nodename}]The host name we want resolved. \item[{\em servicename}]The service name associated, like \char`\"{}http\char`\"{}. \end{description}
\end{Desc}


Definition at line 296 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!~KResolver@{$\sim$KResolver}}
\index{~KResolver@{$\sim$KResolver}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}KResolver::$\sim${\bf KResolver} ()\hspace{0.3cm}{\tt  [virtual]}}\label{classKNetwork_1_1KResolver_a2}


Destructor. 

When this object is deleted, it'll destroy all associated resources. If the resolution is still in progress, it will be cancelled and the signal will {\bf not} be emitted. 

Definition at line 303 of file kresolver.cpp.

References cancel().

\subsection{Member Function Documentation}
\index{KNetwork::KResolver@{KNetwork::KResolver}!status@{status}}
\index{status@{status}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KResolver::status () const}\label{classKNetwork_1_1KResolver_a3}


Retrieve the current status of this object. 

\begin{Desc}
\item[See also:]{\bf Status\-Codes}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_w36})} for the possible {\bf status}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a3})} codes. \end{Desc}


Definition at line 310 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!error@{error}}
\index{error@{error}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KResolver::error () const}\label{classKNetwork_1_1KResolver_a4}


Retrieve the error code in this object. 

This function will return No\-Error if we are not in an error condition. See {\bf status}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a3})} and {\bf Status\-Codes}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_w36})} to find out what the current status is.

\begin{Desc}
\item[See also:]{\bf error\-String}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a6})} for getting a textual representation of this {\bf error}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a4})} \end{Desc}


Definition at line 316 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!systemError@{systemError}}
\index{systemError@{systemError}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KResolver::system\-Error () const}\label{classKNetwork_1_1KResolver_a5}


Retrieve the associated system error code in this object. 

Many resolution operations may generate an extra error code as given by the C errno variable. That value is stored in the object and can be retrieved by this function. 

Definition at line 322 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!errorString@{errorString}}
\index{errorString@{errorString}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KNetwork::KResolver::error\-String () const\hspace{0.3cm}{\tt  [inline]}}\label{classKNetwork_1_1KResolver_a6}


Returns the textual representation of the error in this object. 



Definition at line 491 of file kresolver.h.\index{KNetwork::KResolver@{KNetwork::KResolver}!isRunning@{isRunning}}
\index{isRunning@{isRunning}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KResolver::is\-Running () const}\label{classKNetwork_1_1KResolver_a7}


Returns true if this object is currently running. 



Definition at line 328 of file kresolver.cpp.

Referenced by results(), set\-Family(), set\-Flags(), set\-Node\-Name(), set\-Protocol(), set\-Service\-Name(), set\-Socket\-Type(), start(), and wait().\index{KNetwork::KResolver@{KNetwork::KResolver}!nodeName@{nodeName}}
\index{nodeName@{nodeName}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KResolver::node\-Name () const}\label{classKNetwork_1_1KResolver_a8}


The nodename to which the resolution was/is to be performed. 



Definition at line 334 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!serviceName@{serviceName}}
\index{serviceName@{serviceName}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KResolver::service\-Name () const}\label{classKNetwork_1_1KResolver_a9}


The service name to which the resolution was/is to be performed. 



Definition at line 340 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!setNodeName@{setNodeName}}
\index{setNodeName@{setNodeName}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KResolver::set\-Node\-Name (const {\bf QString} \& {\em nodename})}\label{classKNetwork_1_1KResolver_a10}


Sets the nodename for the resolution. 

Set the nodename to QString::null to unset it. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em nodename}]The nodename to be resolved. \end{description}
\end{Desc}


Definition at line 346 of file kresolver.cpp.

References is\-Running().

Referenced by KNetwork::KStream\-Socket::bind(), KNetwork::KStream\-Socket::connect(), KNetwork::KStream\-Socket::KStream\-Socket(), and set\-Address().\index{KNetwork::KResolver@{KNetwork::KResolver}!setServiceName@{setServiceName}}
\index{setServiceName@{setServiceName}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KResolver::set\-Service\-Name (const {\bf QString} \& {\em service})}\label{classKNetwork_1_1KResolver_a11}


Sets the service name to be resolved. 

Set it to QString::null to unset it. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em service}]The service to be resolved. \end{description}
\end{Desc}


Definition at line 358 of file kresolver.cpp.

References is\-Running().

Referenced by KNetwork::KStream\-Socket::bind(), KNetwork::KStream\-Socket::connect(), KNetwork::KStream\-Socket::KStream\-Socket(), and set\-Address().\index{KNetwork::KResolver@{KNetwork::KResolver}!setAddress@{setAddress}}
\index{setAddress@{setAddress}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KResolver::set\-Address (const {\bf QString} \& {\em node}, const {\bf QString} \& {\em service})}\label{classKNetwork_1_1KResolver_a12}


Sets both the host and the service names. 

Setting either value to QString::null will unset them. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em node}]The nodename \item[{\em service}]The service name \end{description}
\end{Desc}


Definition at line 370 of file kresolver.cpp.

References set\-Node\-Name(), and set\-Service\-Name().

Referenced by KNetwork::KDatagram\-Socket::bind(), and KNetwork::KDatagram\-Socket::connect().\index{KNetwork::KResolver@{KNetwork::KResolver}!flags@{flags}}
\index{flags@{flags}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KResolver::flags () const}\label{classKNetwork_1_1KResolver_a13}


Retrieves the flags set for the resolution. 

\begin{Desc}
\item[See also:]{\bf Flags}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_w34})} for an explanation on what {\bf flags}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a13})} are possible \end{Desc}


Definition at line 377 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!setFlags@{setFlags}}
\index{setFlags@{setFlags}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KResolver::set\-Flags (int {\em flags})}\label{classKNetwork_1_1KResolver_a14}


Sets the flags. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em flags}]the new flags \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the old flags \end{Desc}
\begin{Desc}
\item[See also:]{\bf Flags}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_w34})} for an explanation on the {\bf flags}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a13})} \end{Desc}


Definition at line 383 of file kresolver.cpp.

References is\-Running().

Referenced by KNetwork::KDatagram\-Socket::KDatagram\-Socket(), resolve(), and resolve\-Async().\index{KNetwork::KResolver@{KNetwork::KResolver}!setFamily@{setFamily}}
\index{setFamily@{setFamily}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KResolver::set\-Family (int {\em families})}\label{classKNetwork_1_1KResolver_a15}


Sets the allowed socket families. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em families}]the families that we want/accept \end{description}
\end{Desc}
\begin{Desc}
\item[See also:]{\bf Socket\-Families}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_w33})} for possible values \end{Desc}


Definition at line 395 of file kresolver.cpp.

References is\-Running().

Referenced by KNetwork::KDatagram\-Socket::KDatagram\-Socket(), KNetwork::KStream\-Socket::KStream\-Socket(), resolve(), and resolve\-Async().\index{KNetwork::KResolver@{KNetwork::KResolver}!setSocketType@{setSocketType}}
\index{setSocketType@{setSocketType}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KResolver::set\-Socket\-Type (int {\em type})}\label{classKNetwork_1_1KResolver_a16}


Sets the socket type we want. 

The values for the {\tt type} parameter are the SOCK\_\-$\ast$ constants, defined in $<$sys/socket.h$>$. The most common values are: \begin{itemize}
\item SOCK\_\-STREAM streaming socket (= reliable, sequenced, connection-based) \item SOCK\_\-DGRAM datagram socket (= unreliable, connectionless) \item SOCK\_\-RAW raw socket, with direct access to the container protocol (such as IP)\end{itemize}
These three are the only values to which it is guaranteed that resolution will work. Some systems may define other constants (such as SOCK\_\-RDM for reliable datagrams), but support is implementation-defined.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em type}]the wanted socket type (SOCK\_\-$\ast$ constants). Set 0 to use the default. \end{description}
\end{Desc}


Definition at line 405 of file kresolver.cpp.

References is\-Running().

Referenced by KNetwork::KDatagram\-Socket::KDatagram\-Socket().\index{KNetwork::KResolver@{KNetwork::KResolver}!setProtocol@{setProtocol}}
\index{setProtocol@{setProtocol}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KResolver::set\-Protocol (int {\em protonum}, const char $\ast$ {\em name} = {\tt 0L})}\label{classKNetwork_1_1KResolver_a17}


Sets the protocol we want. 

Protocols are dependant on the selected address family, so you should know what you are doing if you use this function. Besides, protocols generally are either stream-based or datagram-based, so the value of the socket type is also important. The resolution will fail if these values don't match.

When using an Internet socket, the values for the protocol are the IPPROTO\_\-$\ast$ constants, defined in $<$netinet/in.h$>$.

You may choose to set the protocol either by its number or by its name, or by both. If you set: \begin{itemize}
\item the number and the name: both values will be stored internally; you may set the name to an empty value, if wanted \item the number only (name = NULL): the name will be searched in the protocols database \item the name only (number = 0): the number will be searched in the database \item neither name nor number: reset to default behaviour\end{itemize}
\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em protonum}]the protocol number we want \item[{\em name}]the protocol name \end{description}
\end{Desc}


Definition at line 415 of file kresolver.cpp.

References is\-Running().\index{KNetwork::KResolver@{KNetwork::KResolver}!start@{start}}
\index{start@{start}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KResolver::start ()}\label{classKNetwork_1_1KResolver_a18}


Starts the name resolution asynchronously. 

This function will queue this object for resolution and will return immediately. The status upon exit will either be Queued or In\-Progress or Failed.

This function does nothing if the object is already queued. But if it had already succeeded or failed, this function will re-start it.

Note: if both the nodename and the servicename are unset, this function will not queue, but will set a success state and emit the signal. Also note that in this case and maybe others, the signal {\bf finished}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_l0})} might be emitted before this function returns.

\begin{Desc}
\item[Returns:]true if this request was successfully queued for asynchronous resolution \end{Desc}


Definition at line 436 of file kresolver.cpp.

References is\-Running().

Referenced by KNetwork::KStream\-Socket::connect(), resolve(), and resolve\-Async().\index{KNetwork::KResolver@{KNetwork::KResolver}!wait@{wait}}
\index{wait@{wait}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KResolver::wait (int {\em msec} = {\tt 0})}\label{classKNetwork_1_1KResolver_a19}


Waits for a request to finish resolving. 

This function will wait on a running request for its termination. The status upon exit will either be Success or Failed or Canceled.

This function may be called from any thread, even one that is not the GUI thread or the one that started the resolution process. But note this function is not thread-safe nor reentrant: i.e., only one thread can be waiting on one given object.

Also note that this function ensures that the {\bf finished}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_l0})} signal is emitted before it returns. That means that, as a side-effect, whenever {\bf wait()}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a19})} is called, the signal is emitted on the thread calling {\bf wait()}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a19})}.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em msec}]the time to wait, in milliseconds or 0 to wait forever \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]true if the resolution has finished processing, even when it failed or was canceled. False means the wait timed out and the resolution is still running. \end{Desc}


Definition at line 455 of file kresolver.cpp.

References QTime::elapsed(), is\-Running(), and QTime::start().

Referenced by KNetwork::KClient\-Socket\-Base::lookup(), and resolve().\index{KNetwork::KResolver@{KNetwork::KResolver}!cancel@{cancel}}
\index{cancel@{cancel}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KResolver::cancel (bool {\em emit\-Signal} = {\tt true})}\label{classKNetwork_1_1KResolver_a20}


Cancels a running request. 

This function will cancel a running request. If the request is not currently running or queued, this function does nothing.

Note: if you tell the signal to be emitted, be aware that it might or might not be emitted before this function returns.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em emit\-Signal}]whether to emit the {\bf finished}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_l0})} signal or not \end{description}
\end{Desc}


Definition at line 506 of file kresolver.cpp.

Referenced by KNetwork::KDatagram\-Socket::bind(), and $\sim$KResolver().\index{KNetwork::KResolver@{KNetwork::KResolver}!results@{results}}
\index{results@{results}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KResolver\-Results} KResolver::results () const}\label{classKNetwork_1_1KResolver_a21}


Retrieves the results of this resolution. 

Use this function to retrieve the results of the resolution. If no data was resolved (yet) or if we failed, this function will return an empty object.

\begin{Desc}
\item[Returns:]the resolved data \end{Desc}
\begin{Desc}
\item[See also:]{\bf status}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a3})} for information on finding out if the resolution was successful \end{Desc}


Definition at line 514 of file kresolver.cpp.

References is\-Running(), KNetwork::KResolver\-Results::set\-Address(), and KNetwork::KResolver\-Results::set\-Error().

Referenced by resolve().\index{KNetwork::KResolver@{KNetwork::KResolver}!event@{event}}
\index{event@{event}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KResolver::event ({\bf QEvent} $\ast$)\hspace{0.3cm}{\tt  [virtual]}}\label{classKNetwork_1_1KResolver_a22}


Handles events. 

Reimplemented from {\bf QObject}.

This function handles the events generated by the manager indicating that this object has finished processing.

Do not post events to this object. 

Reimplemented from {\bf QObject}.

Definition at line 526 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!finished@{finished}}
\index{finished@{finished}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KNetwork::KResolver::finished ({\bf KResolver\-Results} {\em results})\hspace{0.3cm}{\tt  [signal]}}\label{classKNetwork_1_1KResolver_l0}


This signal is emitted whenever the resolution is finished, one way or another (success or failure). 

The {\tt results} parameter will contain the resolved data.

Note: if you are doing multiple resolutions, you can use the {\bf QObject::sender()} function to distinguish one Resolver object from another.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em results}]the resolved data; might be empty if the resolution failed \end{description}
\end{Desc}
\begin{Desc}
\item[See also:]{\bf results}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a21})} for information on what the {\bf results}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a21})} are\end{Desc}
\begin{Desc}
\item[Note:]This signal is {\bf always} delivered in the GUI event thread, even for resolutions that were started in secondary threads. \end{Desc}


Referenced by resolve\-Async().\index{KNetwork::KResolver@{KNetwork::KResolver}!errorString@{errorString}}
\index{errorString@{errorString}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KResolver::error\-String (int {\em errorcode}, int {\em syserror} = {\tt 0})\hspace{0.3cm}{\tt  [static]}}\label{classKNetwork_1_1KResolver_e0}


Returns the string representation of this error code. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em errorcode}]the error code. See {\bf Error\-Codes}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_w35})}. \item[{\em syserror}]the system error code associated. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the string representation. This is already i18n'ed. \end{Desc}


Definition at line 550 of file kresolver.cpp.

References QString::arg(), I18N\_\-NOOP, and I18N\_\-NOOP2.\index{KNetwork::KResolver@{KNetwork::KResolver}!resolve@{resolve}}
\index{resolve@{resolve}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf KResolver\-Results} KResolver::resolve (const {\bf QString} \& {\em host}, const {\bf QString} \& {\em service}, int {\em flags} = {\tt 0}, int {\em families} = {\tt KResolver::InternetFamily})\hspace{0.3cm}{\tt  [static]}}\label{classKNetwork_1_1KResolver_e1}


Resolve the nodename and service name synchronously. 

This static function is provided as convenience for simplifying name resolution. It resolves the given host and service names synchronously and returns the results it found. It is equivalent to the following code:



\footnotesize\begin{verbatim}   KResolver qres(host, service);
   qres.setFlags(flags);
   qres.setFamily(families)
   qres.start();
   qres.wait();
   return qres.results();
\end{verbatim}
\normalsize


\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em host}]the nodename to resolve \item[{\em service}]the service to resolve \item[{\em flags}]flags to be used \item[{\em families}]the families to be searched \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]a {\bf KResolver\-Results}{\rm (p.\,\pageref{classKNetwork_1_1KResolverResults})} object containing the results \end{Desc}
\begin{Desc}
\item[See also:]{\bf KResolver\-Results}{\rm (p.\,\pageref{classKNetwork_1_1KResolverResults})} for information on how to obtain the {\bf error}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a4})} code \end{Desc}


Definition at line 585 of file kresolver.cpp.

References results(), set\-Family(), set\-Flags(), start(), and wait().\index{KNetwork::KResolver@{KNetwork::KResolver}!resolveAsync@{resolveAsync}}
\index{resolveAsync@{resolveAsync}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KResolver::resolve\-Async ({\bf QObject} $\ast$ {\em user\-Obj}, const char $\ast$ {\em user\-Slot}, const {\bf QString} \& {\em host}, const {\bf QString} \& {\em service}, int {\em flags} = {\tt 0}, int {\em families} = {\tt KResolver::InternetFamily})\hspace{0.3cm}{\tt  [static]}}\label{classKNetwork_1_1KResolver_e2}


Start an asynchronous name resolution. 

This function is provided as a convenience to simplify the resolution process. It creates an internal {\bf KResolver}{\rm (p.\,\pageref{classKNetwork_1_1KResolver})} object, connects the {\bf finished}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_l0})} signal to the given slot and starts the resolution asynchronously. It is more or less equivalent to the following code:

{\bf Note:} this function may trigger the signal before it returns, so your code must be prepared for this situation.



\footnotesize\begin{verbatim}   KResolver* qres = new KResolver(host, service);
   QObject::connect(qres, SIGNAL(finished(KResolverResults)),
              userObj, userSlot);
   qres->setFlags(flags);
   qres->setFamily(families);
   return qres->start();
\end{verbatim}
\normalsize


You should use it like this in your code: 

\footnotesize\begin{verbatim}   KResolver::resolveAsync(myObj, SLOT(mySlot(KResolverResults)), host, service);
\end{verbatim}
\normalsize


\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em user\-Obj}]the object whose slot {\tt user\-Slot} we will connect \item[{\em user\-Slot}]the slot to which we'll connect \item[{\em host}]the nodename to resolve \item[{\em service}]the service to resolve \item[{\em flags}]flags to be used \item[{\em families}]families to be searcheed \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]true if the queueing was successful, false if not \end{Desc}
\begin{Desc}
\item[See also:]{\bf KResolver\-Results}{\rm (p.\,\pageref{classKNetwork_1_1KResolverResults})} for information on how to obtain the {\bf error}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_a4})} code \end{Desc}


Definition at line 596 of file kresolver.cpp.

References QObject::connect(), d, finished(), KResolver(), set\-Family(), set\-Flags(), and start().\index{KNetwork::KResolver@{KNetwork::KResolver}!domainToAscii@{domainToAscii}}
\index{domainToAscii@{domainToAscii}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QCString} KResolver::domain\-To\-Ascii (const {\bf QString} \& {\em unicode\-Domain})\hspace{0.3cm}{\tt  [static]}}\label{classKNetwork_1_1KResolver_e3}


Returns the domain name in an ASCII Compatible Encoding form, suitable for DNS lookups. 

This is the base for International Domain Name support over the Internet.

Note this function may fail, in which case it'll return a null {\bf QCString}. Reasons for failure include use of unknown code points (Unicode characters).

Note that the encoding is illegible and, thus, should not be presented to the user, except if requested.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em unicode\-Domain}]the domain name to be encoded \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the ACE-encoded suitable for DNS queries if successful, a null {\bf QCString} if failure. \end{Desc}


Definition at line 890 of file kresolver.cpp.

References QCString::is\-Empty(), QCString::is\-Null(), and QString\-List::join().

Referenced by normalize\-Domain().\index{KNetwork::KResolver@{KNetwork::KResolver}!domainToUnicode@{domainToUnicode}}
\index{domainToUnicode@{domainToUnicode}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KResolver::domain\-To\-Unicode (const {\bf QCString} \& {\em ascii\-Domain})\hspace{0.3cm}{\tt  [static]}}\label{classKNetwork_1_1KResolver_e4}


Does the inverse of {\bf domain\-To\-Ascii}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_e3})} and return an Unicode domain name from the given ACE-encoded domain. 

This function may fail if the given domain cannot be successfully converted back to Unicode. Reasons for failure include a malformed domain name or good ones whose reencoding back to ACE don't match the form given here (e.g., ACE-encoding of an already ASCII-compatible domain).

It is, however, guaranteed that domains returned by {\bf domain\-To\-Ascii}{\rm (p.\,\pageref{classKNetwork_1_1KResolver_e3})} will work.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em ascii\-Domain}]the ACE-encoded domain name to be decoded \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the Unicode representation of the given domain name if successful, the original string if not \end{Desc}
\begin{Desc}
\item[Note:]ACE = ASCII-Compatible Encoding, i.e., 7-bit \end{Desc}


Definition at line 928 of file kresolver.cpp.

Referenced by normalize\-Domain().\index{KNetwork::KResolver@{KNetwork::KResolver}!domainToUnicode@{domainToUnicode}}
\index{domainToUnicode@{domainToUnicode}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KResolver::domain\-To\-Unicode (const {\bf QString} \& {\em ascii\-Domain})\hspace{0.3cm}{\tt  [static]}}\label{classKNetwork_1_1KResolver_e5}


The same as above, but taking a {\bf QString} argument. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em ascii\-Domain}]the ACE-encoded domain name to be decoded \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the Unicode representation of the given domain name if successful, QString::null if not. \end{Desc}


Definition at line 934 of file kresolver.cpp.

References QString::is\-Empty(), and QString::lower().\index{KNetwork::KResolver@{KNetwork::KResolver}!normalizeDomain@{normalizeDomain}}
\index{normalizeDomain@{normalizeDomain}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KResolver::normalize\-Domain (const {\bf QString} \& {\em domain})\hspace{0.3cm}{\tt  [static]}}\label{classKNetwork_1_1KResolver_e6}


Normalise a domain name. 

In order to prevent simple mistakes in International Domain Names (IDN), it has been decided that certain code points (characters in Unicode) would be instead converted to others. This includes turning them all to lower case, as well certain other specific operations, as specified in the documents.

For instance, the German '\~{A}159' will be changed into 'ss', while the micro symbol '\^{A}$\mu$' will be changed to the Greek mu '\^{I}188'.

Two equivalent domains have the same normalised form. And the normalised form of a normalised domain is itself (i.e., if d is normalised, the following is true: d == normalize\-Domain(d) )

This operation is equivalent to encoding and the decoding a Unicode hostname.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em domain}]a domain to be normalised \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the normalised domain, or QString::null if the domain is invalid. \end{Desc}


Definition at line 974 of file kresolver.cpp.

References domain\-To\-Ascii(), and domain\-To\-Unicode().\index{KNetwork::KResolver@{KNetwork::KResolver}!protocolName@{protocolName}}
\index{protocolName@{protocolName}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QStr\-List} KResolver::protocol\-Name (int {\em protonum})\hspace{0.3cm}{\tt  [static]}}\label{classKNetwork_1_1KResolver_e7}


Resolves a protocol number to its names. 

Note: the returned {\bf QStr\-List} operates on deep-copies.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em protonum}]the protocol number to be looked for \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]all the protocol names in a list. The first is the \char`\"{}proper\char`\"{} name. \end{Desc}


Definition at line 608 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!protocolName@{protocolName}}
\index{protocolName@{protocolName}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QStr\-List} KResolver::protocol\-Name (const char $\ast$ {\em protoname})\hspace{0.3cm}{\tt  [static]}}\label{classKNetwork_1_1KResolver_e8}


Finds all aliases for a given protocol name. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em protoname}]the protocol name to be looked for \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]all the protocol names in a list. The first is the \char`\"{}proper\char`\"{} name. \end{Desc}


Definition at line 654 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!protocolNumber@{protocolNumber}}
\index{protocolNumber@{protocolNumber}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KResolver::protocol\-Number (const char $\ast$ {\em protoname})\hspace{0.3cm}{\tt  [static]}}\label{classKNetwork_1_1KResolver_e9}


Resolves a protocol name to its number. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em protoname}]the protocol name to be looked for \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the protocol number or -1 if we couldn't locate it \end{Desc}


Definition at line 700 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!servicePort@{servicePort}}
\index{servicePort@{servicePort}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KResolver::service\-Port (const char $\ast$ {\em servname}, const char $\ast$ {\em protoname})\hspace{0.3cm}{\tt  [static]}}\label{classKNetwork_1_1KResolver_e10}


Resolves a service name to its port number. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em servname}]the service name to be looked for \item[{\em protoname}]the protocol it is associated with \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]the port number in host byte-order or -1 in case of error \end{Desc}


Definition at line 742 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!serviceName@{serviceName}}
\index{serviceName@{serviceName}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QStr\-List} KResolver::service\-Name (const char $\ast$ {\em servname}, const char $\ast$ {\em protoname})\hspace{0.3cm}{\tt  [static]}}\label{classKNetwork_1_1KResolver_e11}


Finds all the aliases for a given service name. 

Note: the returned {\bf QStr\-List} operates on deep-copies.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em servname}]the service alias to be looked for \item[{\em protoname}]the protocol it is associated with \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]all the service names in a list. The first is the \char`\"{}proper\char`\"{} name. \end{Desc}


Definition at line 784 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!serviceName@{serviceName}}
\index{serviceName@{serviceName}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QStr\-List} KResolver::service\-Name (int {\em port}, const char $\ast$ {\em protoname})\hspace{0.3cm}{\tt  [static]}}\label{classKNetwork_1_1KResolver_e12}


Resolves a port number to its names. 

Note: the returned {\bf QStr\-List} operates on deep copies.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em port}]the port number, in host byte-order \item[{\em protoname}]the protocol it is associated with \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]all the service names in a list. The first is the \char`\"{}proper\char`\"{} name. \end{Desc}


Definition at line 830 of file kresolver.cpp.\index{KNetwork::KResolver@{KNetwork::KResolver}!setError@{setError}}
\index{setError@{setError}!KNetwork::KResolver@{KNetwork::KResolver}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KNetwork::KResolver::set\-Error (int {\em errorcode}, int {\em systemerror} = {\tt 0})\hspace{0.3cm}{\tt  [protected]}}\label{classKNetwork_1_1KResolver_b0}


Sets the error codes. 



The documentation for this class was generated from the following files:\begin{CompactItemize}
\item 
kresolver.h\item 
kresolver.cpp\end{CompactItemize}
