\section{KIO::Stat\-Job Class Reference}
\label{classKIO_1_1StatJob}\index{KIO::StatJob@{KIO::StatJob}}
A {\bf KIO}{\rm (p.\,\pageref{namespaceKIO})} job that retrieves information about a file or directory.  


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

Inheritance diagram for KIO::Stat\-Job:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=60pt]{classKIO_1_1StatJob__inherit__graph}
\end{center}
\end{figure}
Collaboration diagram for KIO::Stat\-Job:\begin{figure}[H]
\begin{center}
\leavevmode
\includegraphics[width=305pt]{classKIO_1_1StatJob__coll__graph}
\end{center}
\end{figure}
\subsection*{Signals}
\begin{CompactItemize}
\item 
void {\bf redirection} ({\bf KIO::Job} $\ast$job, const {\bf KURL} \&url)
\item 
void {\bf permanent\-Redirection} ({\bf KIO::Job} $\ast$job, const {\bf KURL} \&from\-Url, const {\bf KURL} \&to\-Url)
\end{CompactItemize}
\subsection*{Public Member Functions}
\begin{CompactItemize}
\item 
{\bf Stat\-Job} (const {\bf KURL} \&url, int command, const {\bf QByte\-Array} \&packed\-Args, bool show\-Progress\-Info)
\item 
void {\bf set\-Side} (bool source)
\item 
void {\bf set\-Details} (short int details)
\item 
const {\bf UDSEntry} \& {\bf stat\-Result} () const 
\item 
virtual void {\bf start} (Slave $\ast$slave)\label{classKIO_1_1StatJob_a4}

\end{CompactItemize}
\subsection*{Protected Slots}
\begin{CompactItemize}
\item 
void {\bf slot\-Stat\-Entry} (const {\bf KIO::UDSEntry} \&entry)\label{classKIO_1_1StatJob_j0}

\item 
void {\bf slot\-Redirection} (const {\bf KURL} \&url)\label{classKIO_1_1StatJob_j1}

\item 
virtual void {\bf slot\-Finished} ()
\item 
virtual void {\bf slot\-Meta\-Data} (const {\bf KIO::Meta\-Data} \&\_\-meta\-Data)
\end{CompactItemize}
\subsection*{Protected Member Functions}
\begin{CompactItemize}
\item 
virtual void {\bf virtual\_\-hook} (int id, void $\ast$data)\label{classKIO_1_1StatJob_b0}

\end{CompactItemize}
\subsection*{Protected Attributes}
\begin{CompactItemize}
\item 
{\bf UDSEntry} {\bf m\_\-stat\-Result}\label{classKIO_1_1StatJob_p0}

\item 
{\bf KURL} {\bf m\_\-redirection\-URL}\label{classKIO_1_1StatJob_p1}

\item 
bool {\bf m\_\-b\-Source}\label{classKIO_1_1StatJob_p2}

\item 
short int {\bf m\_\-details}\label{classKIO_1_1StatJob_p3}

\end{CompactItemize}


\subsection{Detailed Description}
A {\bf KIO}{\rm (p.\,\pageref{namespaceKIO})} job that retrieves information about a file or directory. 

\begin{Desc}
\item[See also:]{\bf KIO::stat()}{\rm (p.\,\pageref{namespaceKIO_a215})} \end{Desc}




Definition at line 647 of file jobclasses.h.

\subsection{Constructor \& Destructor Documentation}
\index{KIO::StatJob@{KIO::Stat\-Job}!StatJob@{StatJob}}
\index{StatJob@{StatJob}!KIO::StatJob@{KIO::Stat\-Job}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Stat\-Job::Stat\-Job (const {\bf KURL} \& {\em url}, int {\em command}, const {\bf QByte\-Array} \& {\em packed\-Args}, bool {\em show\-Progress\-Info})}\label{classKIO_1_1StatJob_a0}


Do not use this constructor to create a {\bf Stat\-Job}{\rm (p.\,\pageref{classKIO_1_1StatJob})}, use {\bf KIO::stat()}{\rm (p.\,\pageref{namespaceKIO_a215})} instead. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]the url of the file or directory to check \item[{\em command}]the command to issue \item[{\em packed\-Args}]the arguments \item[{\em show\-Progress\-Info}]true to show progress information to the user\end{description}
\end{Desc}


Definition at line 756 of file job.cpp.

\subsection{Member Function Documentation}
\index{KIO::StatJob@{KIO::Stat\-Job}!setSide@{setSide}}
\index{setSide@{setSide}!KIO::StatJob@{KIO::Stat\-Job}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIO::Stat\-Job::set\-Side (bool {\em source})\hspace{0.3cm}{\tt  [inline]}}\label{classKIO_1_1StatJob_a1}


A {\bf stat()}{\rm (p.\,\pageref{namespaceKIO_a215})} can have two meanings. 

Either we want to read from this URL, or to check if we can write to it. First case is \char`\"{}source\char`\"{}, second is \char`\"{}dest\char`\"{}. It is necessary to know what the {\bf Stat\-Job}{\rm (p.\,\pageref{classKIO_1_1StatJob})} is for, to tune the kioslave's behavior (e.g. with FTP). \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em source}]true for \char`\"{}source\char`\"{} mode, false for \char`\"{}dest\char`\"{} mode \end{description}
\end{Desc}


Definition at line 668 of file jobclasses.h.

Referenced by KIO::stat().\index{KIO::StatJob@{KIO::Stat\-Job}!setDetails@{setDetails}}
\index{setDetails@{setDetails}!KIO::StatJob@{KIO::Stat\-Job}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIO::Stat\-Job::set\-Details (short int {\em details})\hspace{0.3cm}{\tt  [inline]}}\label{classKIO_1_1StatJob_a2}


Selects the level of {\tt details} we want. 

By default this is 2 (all details wanted, including modification time, size, etc.), set\-Details(1) is used when deleting: we don't need all the information if it takes too much time, no need to follow symlinks etc. set\-Details(0) is used for very simple probing: we'll only get the answer \char`\"{}it's a file or a directory, or it doesn't exist\char`\"{}. This is used by {\bf KRun}{\rm (p.\,\pageref{classKRun})}. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em details}]2 for all details, 1 for simple, 0 for very simple \end{description}
\end{Desc}


Definition at line 679 of file jobclasses.h.

Referenced by KIO::stat().\index{KIO::StatJob@{KIO::Stat\-Job}!statResult@{statResult}}
\index{statResult@{statResult}!KIO::StatJob@{KIO::Stat\-Job}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}const {\bf UDSEntry}\& KIO::Stat\-Job::stat\-Result () const\hspace{0.3cm}{\tt  [inline]}}\label{classKIO_1_1StatJob_a3}


Call this in the slot connected to result, and only after making sure no error happened. 

\begin{Desc}
\item[Returns:]the result of the stat \end{Desc}


Definition at line 686 of file jobclasses.h.\index{KIO::StatJob@{KIO::Stat\-Job}!redirection@{redirection}}
\index{redirection@{redirection}!KIO::StatJob@{KIO::Stat\-Job}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIO::Stat\-Job::redirection ({\bf KIO::Job} $\ast$ {\em job}, const {\bf KURL} \& {\em url})\hspace{0.3cm}{\tt  [signal]}}\label{classKIO_1_1StatJob_l0}


Signals a redirection. 

Use to update the URL shown to the user. The redirection itself is handled internally. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em job}]the job that is redirected \item[{\em url}]the new url \end{description}
\end{Desc}
\index{KIO::StatJob@{KIO::Stat\-Job}!permanentRedirection@{permanentRedirection}}
\index{permanentRedirection@{permanentRedirection}!KIO::StatJob@{KIO::Stat\-Job}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void KIO::Stat\-Job::permanent\-Redirection ({\bf KIO::Job} $\ast$ {\em job}, const {\bf KURL} \& {\em from\-Url}, const {\bf KURL} \& {\em to\-Url})\hspace{0.3cm}{\tt  [signal]}}\label{classKIO_1_1StatJob_l1}


Signals a permanent redirection. 

The redirection itself is handled internally. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em job}]the job that is redirected \item[{\em from\-Url}]the original URL \item[{\em to\-Url}]the new URL \end{description}
\end{Desc}
\begin{Desc}
\item[Since:]3.1 \end{Desc}


Referenced by slot\-Finished().\index{KIO::StatJob@{KIO::Stat\-Job}!slotFinished@{slotFinished}}
\index{slotFinished@{slotFinished}!KIO::StatJob@{KIO::Stat\-Job}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Stat\-Job::slot\-Finished ()\hspace{0.3cm}{\tt  [protected, virtual, slot]}}\label{classKIO_1_1StatJob_j2}


Called when the slave marks the job as finished. 



Reimplemented from {\bf KIO::Simple\-Job} {\rm (p.\,\pageref{classKIO_1_1SimpleJob_j0})}.

Definition at line 800 of file job.cpp.

References KIO::Scheduler::do\-Job(), KURL::is\-Empty(), KURL::is\-Valid(), permanent\-Redirection(), KIO::Job::query\-Meta\-Data(), and KIO::Simple\-Job::slot\-Finished().\index{KIO::StatJob@{KIO::Stat\-Job}!slotMetaData@{slotMetaData}}
\index{slotMetaData@{slotMetaData}!KIO::StatJob@{KIO::Stat\-Job}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}void Stat\-Job::slot\-Meta\-Data (const {\bf KIO::Meta\-Data} \& {\em \_\-meta\-Data})\hspace{0.3cm}{\tt  [protected, virtual, slot]}}\label{classKIO_1_1StatJob_j3}


{\bf Meta\-Data}{\rm (p.\,\pageref{classKIO_1_1MetaData})} from the slave is received. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em \_\-meta\-Data}]the meta data \end{description}
\end{Desc}
\begin{Desc}
\item[See also:]{\bf meta\-Data()}{\rm (p.\,\pageref{classKIO_1_1Job_a21})} \end{Desc}


Reimplemented from {\bf KIO::Simple\-Job} {\rm (p.\,\pageref{classKIO_1_1SimpleJob_j6})}.

Definition at line 822 of file job.cpp.

References KIO::Simple\-Job::slot\-Meta\-Data().

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