\section{KIO Namespace Reference}
\label{namespaceKIO}\index{KIO@{KIO}}
A namespace for KIO globals.  


\subsection*{Classes}
\begin{CompactItemize}
\item 
class {\bf Auth\-Info}
\begin{CompactList}\small\item\em This class is intended to make it easier to prompt for, cache and retrieve authorization information. A two way messaging class for passing authentication information. \item\end{CompactList}\item 
class {\bf Net\-RC}
\begin{CompactList}\small\item\em A Singleton class that provides access to passwords stored in .netrc and kionetrc for automatic login purposes. An interface to kionetrc and the ftp .netrc files. \item\end{CompactList}\item 
class {\bf Chmod\-Job}
\begin{CompactList}\small\item\em This job changes permissions on a list of files or directories, optionally in a recursive manner. \item\end{CompactList}\item 
class {\bf Connection}
\begin{CompactList}\small\item\em This class provides a simple means for IPC between two applications via a pipe. \item\end{CompactList}\item 
class {\bf Dav\-Job}
\begin{CompactList}\small\item\em The transfer job pumps data into and/or out of a Slave. \item\end{CompactList}\item 
class {\bf Job}
\begin{CompactList}\small\item\em The base class for all jobs. \item\end{CompactList}\item 
class {\bf Simple\-Job}
\begin{CompactList}\small\item\em A simple job (one url and one command). \item\end{CompactList}\item 
class {\bf Transfer\-Job}
\begin{CompactList}\small\item\em The transfer job pumps data into and/or out of a Slave. \item\end{CompactList}\item 
class {\bf File\-Copy\-Job}
\begin{CompactList}\small\item\em The {\bf File\-Copy\-Job}{\rm (p.\,\pageref{classKIO_1_1FileCopyJob})} copies data from one place to another. \item\end{CompactList}\item 
class {\bf Delete\-Job}
\item 
class {\bf Meta\-Info\-Job}
\begin{CompactList}\small\item\em \begin{Desc}
\item[Since:]3.1 \end{Desc}
\item\end{CompactList}\item 
class {\bf Net\-Access}
\begin{CompactList}\small\item\em Net Transparency, formerly provided by kfmlib, but now done with {\bf KIO::Job}{\rm (p.\,\pageref{classKIO_1_1Job})}. Provides a synchronous interface to io jobs. \item\end{CompactList}\item 
class {\bf Password\-Dialog}
\begin{CompactList}\small\item\em A dialog for requesting a login and a password from the end user. \item\end{CompactList}\item 
class {\bf Preview\-Job}
\item 
class {\bf Progress\-Base}
\begin{CompactList}\small\item\em This class does all initialization stuff for progress, like connecting signals to slots. Base class for IO progress dialogs. \item\end{CompactList}\item 
class {\bf Rename\-Dlg}
\begin{CompactList}\small\item\em A dialog for the options to rename two files \begin{Desc}
\item[Since:]3.1. \end{Desc}
\item\end{CompactList}\item 
class {\bf Scheduler}
\begin{CompactList}\small\item\em The KIO::Scheduler manages io-slaves for the application. \item\end{CompactList}\item 
class {\bf Slave\-Base}
\begin{CompactList}\small\item\em There are two classes that specifies the protocol between application (job) and kioslave. \item\end{CompactList}\item 
class {\bf Slave\-Config}
\begin{CompactList}\small\item\em {\bf Slave\-Config}{\rm (p.\,\pageref{classKIO_1_1SlaveConfig})}. \item\end{CompactList}\item 
class {\bf Slave\-Interface}
\begin{CompactList}\small\item\em There are two classes that specifies the protocol between application (job) and kioslave. \item\end{CompactList}\item 
class {\bf Statusbar\-Progress}
\begin{CompactList}\small\item\em This is a special IO progress widget. IO progress widget for embedding in a statusbar. \item\end{CompactList}\item 
class {\bf TCPSlave\-Base}
\begin{CompactList}\small\item\em There are two classes that specifies the protocol between application (job) and kioslave. \item\end{CompactList}\end{CompactItemize}
\subsection*{Typedefs}
\begin{CompactItemize}
\item 
typedef signed long long int {\bf fileoffset\_\-t}\label{namespaceKIO_a0}

\item 
typedef unsigned long long int {\bf filesize\_\-t}\label{namespaceKIO_a1}

\item 
typedef {\bf QValue\-List}$<$ UDSAtom $>$ {\bf UDSEntry}
\begin{CompactList}\small\item\em An entry is the list of atoms containing all the informations for a file or URL. \item\end{CompactList}\item 
typedef {\bf QValue\-List}$<$ {\bf UDSEntry} $>$ {\bf UDSEntry\-List}\label{namespaceKIO_a3}

\item 
typedef {\bf QValue\-List\-Iterator}$<$ {\bf UDSEntry} $>$ {\bf UDSEntry\-List\-Iterator}\label{namespaceKIO_a4}

\item 
typedef {\bf QValue\-List\-Const\-Iterator}$<$ {\bf UDSEntry} $>$ {\bf UDSEntry\-List\-Const\-Iterator}\label{namespaceKIO_a5}

\end{CompactItemize}
\subsection*{Enumerations}
\begin{CompactItemize}
\item 
enum {\bf Error} \{ \par
{\bf ERR\_\-CANNOT\_\-OPEN\_\-FOR\_\-READING} =  1, 
{\bf ERR\_\-CANNOT\_\-OPEN\_\-FOR\_\-WRITING} =  2, 
{\bf ERR\_\-CANNOT\_\-LAUNCH\_\-PROCESS} =  3, 
{\bf ERR\_\-INTERNAL} =  4, 
\par
{\bf ERR\_\-MALFORMED\_\-URL} =  5, 
{\bf ERR\_\-UNSUPPORTED\_\-PROTOCOL} =  6, 
{\bf ERR\_\-NO\_\-SOURCE\_\-PROTOCOL} =  7, 
{\bf ERR\_\-UNSUPPORTED\_\-ACTION} =  8, 
\par
{\bf ERR\_\-IS\_\-DIRECTORY} =  9, 
{\bf ERR\_\-IS\_\-FILE} =  10, 
{\bf ERR\_\-DOES\_\-NOT\_\-EXIST} =  11, 
{\bf ERR\_\-FILE\_\-ALREADY\_\-EXIST} =  12, 
\par
{\bf ERR\_\-DIR\_\-ALREADY\_\-EXIST} =  13, 
{\bf ERR\_\-UNKNOWN\_\-HOST} =  14, 
{\bf ERR\_\-ACCESS\_\-DENIED} =  15, 
{\bf ERR\_\-WRITE\_\-ACCESS\_\-DENIED} =  16, 
\par
{\bf ERR\_\-CANNOT\_\-ENTER\_\-DIRECTORY} =  17, 
{\bf ERR\_\-PROTOCOL\_\-IS\_\-NOT\_\-A\_\-FILESYSTEM} =  18, 
{\bf ERR\_\-CYCLIC\_\-LINK} =  19, 
{\bf ERR\_\-USER\_\-CANCELED} =  20, 
\par
{\bf ERR\_\-CYCLIC\_\-COPY} =  21, 
{\bf ERR\_\-COULD\_\-NOT\_\-CREATE\_\-SOCKET} =  22, 
{\bf ERR\_\-COULD\_\-NOT\_\-CONNECT} =  23, 
{\bf ERR\_\-CONNECTION\_\-BROKEN} =  24, 
\par
{\bf ERR\_\-NOT\_\-FILTER\_\-PROTOCOL} =  25, 
{\bf ERR\_\-COULD\_\-NOT\_\-MOUNT} =  26, 
{\bf ERR\_\-COULD\_\-NOT\_\-UNMOUNT} =  27, 
{\bf ERR\_\-COULD\_\-NOT\_\-READ} =  28, 
\par
{\bf ERR\_\-COULD\_\-NOT\_\-WRITE} =  29, 
{\bf ERR\_\-COULD\_\-NOT\_\-BIND} =  30, 
{\bf ERR\_\-COULD\_\-NOT\_\-LISTEN} =  31, 
{\bf ERR\_\-COULD\_\-NOT\_\-ACCEPT} =  32, 
\par
{\bf ERR\_\-COULD\_\-NOT\_\-LOGIN} =  33, 
{\bf ERR\_\-COULD\_\-NOT\_\-STAT} =  34, 
{\bf ERR\_\-COULD\_\-NOT\_\-CLOSEDIR} =  35, 
{\bf ERR\_\-COULD\_\-NOT\_\-MKDIR} =  37, 
\par
{\bf ERR\_\-COULD\_\-NOT\_\-RMDIR} =  38, 
{\bf ERR\_\-CANNOT\_\-RESUME} =  39, 
{\bf ERR\_\-CANNOT\_\-RENAME} =  40, 
{\bf ERR\_\-CANNOT\_\-CHMOD} =  41, 
\par
{\bf ERR\_\-CANNOT\_\-DELETE} =  42, 
{\bf ERR\_\-SLAVE\_\-DIED} =  43, 
{\bf ERR\_\-OUT\_\-OF\_\-MEMORY} =  44, 
{\bf ERR\_\-UNKNOWN\_\-PROXY\_\-HOST} =  45, 
\par
{\bf ERR\_\-COULD\_\-NOT\_\-AUTHENTICATE} =  46, 
{\bf ERR\_\-ABORTED} =  47, 
{\bf ERR\_\-INTERNAL\_\-SERVER} =  48, 
{\bf ERR\_\-SERVER\_\-TIMEOUT} =  49, 
\par
{\bf ERR\_\-SERVICE\_\-NOT\_\-AVAILABLE} =  50, 
{\bf ERR\_\-UNKNOWN} =  51, 
{\bf ERR\_\-UNKNOWN\_\-INTERRUPT} =  53, 
{\bf ERR\_\-CANNOT\_\-DELETE\_\-ORIGINAL} =  54, 
\par
{\bf ERR\_\-CANNOT\_\-DELETE\_\-PARTIAL} =  55, 
{\bf ERR\_\-CANNOT\_\-RENAME\_\-ORIGINAL} =  56, 
{\bf ERR\_\-CANNOT\_\-RENAME\_\-PARTIAL} =  57, 
{\bf ERR\_\-NEED\_\-PASSWD} =  58, 
\par
{\bf ERR\_\-CANNOT\_\-SYMLINK} =  59, 
{\bf ERR\_\-NO\_\-CONTENT} =  60, 
{\bf ERR\_\-DISK\_\-FULL} =  61, 
{\bf ERR\_\-IDENTICAL\_\-FILES} =  62, 
\par
{\bf ERR\_\-SLAVE\_\-DEFINED} =  63, 
{\bf ERR\_\-UPGRADE\_\-REQUIRED} =  64, 
{\bf ERR\_\-POST\_\-DENIED} =  65
 \}
\begin{CompactList}\small\item\em Error codes that can be emitted by {\bf KIO}{\rm (p.\,\pageref{namespaceKIO})}. \item\end{CompactList}\item 
enum {\bf UDSAtom\-Types} \{ \par
{\bf UDS\_\-STRING} =  1, 
{\bf UDS\_\-LONG} =  2, 
{\bf UDS\_\-TIME} =  4 $|$ UDS\_\-LONG, 
{\bf UDS\_\-SIZE} =  8 $|$ UDS\_\-LONG, 
\par
{\bf UDS\_\-SIZE\_\-LARGE} =  32768 $|$ UDS\_\-LONG, 
{\bf UDS\_\-USER} =  16 $|$ UDS\_\-STRING, 
{\bf UDS\_\-GROUP} =  32 $|$ UDS\_\-STRING, 
{\bf UDS\_\-NAME} =  64 $|$ UDS\_\-STRING, 
\par
{\bf UDS\_\-ACCESS} =  128 $|$ UDS\_\-LONG, 
{\bf UDS\_\-MODIFICATION\_\-TIME} =  256 $|$ UDS\_\-TIME, 
{\bf UDS\_\-ACCESS\_\-TIME} =  512 $|$ UDS\_\-TIME, 
{\bf UDS\_\-CREATION\_\-TIME} =  1024 $|$ UDS\_\-TIME, 
\par
{\bf UDS\_\-FILE\_\-TYPE} =  2048 $|$ UDS\_\-LONG, 
{\bf UDS\_\-LINK\_\-DEST} =  4096 $|$ UDS\_\-STRING, 
{\bf UDS\_\-URL} =  8192 $|$ UDS\_\-STRING, 
{\bf UDS\_\-MIME\_\-TYPE} =  16384 $|$ UDS\_\-STRING, 
\par
{\bf UDS\_\-GUESSED\_\-MIME\_\-TYPE} =  16392 $|$ UDS\_\-STRING, 
{\bf UDS\_\-XML\_\-PROPERTIES} =  32768 $|$ UDS\_\-STRING
 \}
\begin{CompactList}\small\item\em Constants used to specify the type of a KUDSAtom. \item\end{CompactList}\item 
enum {\bf Cache\-Control} \{ \par
{\bf CC\_\-Cache\-Only}, 
{\bf CC\_\-Cache}, 
{\bf CC\_\-Verify}, 
{\bf CC\_\-Refresh}, 
\par
{\bf CC\_\-Reload}
 \}
\item 
enum {\bf Progress} \{ {\bf DEFAULT} =  1, 
{\bf STATUSBAR} =  2, 
{\bf LIST} =  3
 \}
\item 
enum {\bf Rename\-Dlg\_\-Mode} \{ \par
{\bf M\_\-OVERWRITE} =  1, 
{\bf M\_\-OVERWRITE\_\-ITSELF} =  2, 
{\bf M\_\-SKIP} =  4, 
{\bf M\_\-SINGLE} =  8, 
\par
{\bf M\_\-MULTI} =  16, 
{\bf M\_\-RESUME} =  32, 
{\bf M\_\-NORENAME} =  64
 \}
\item 
enum {\bf Rename\-Dlg\_\-Result} \{ \par
{\bf R\_\-RESUME} =  6, 
{\bf R\_\-RESUME\_\-ALL} =  7, 
{\bf R\_\-OVERWRITE} =  4, 
{\bf R\_\-OVERWRITE\_\-ALL} =  5, 
\par
{\bf R\_\-SKIP} =  2, 
{\bf R\_\-AUTO\_\-SKIP} =  3, 
{\bf R\_\-RENAME} =  1, 
{\bf R\_\-CANCEL} =  0
 \}
\item 
enum {\bf Skip\-Dlg\_\-Result} \{ {\bf S\_\-SKIP} =  1, 
{\bf S\_\-AUTO\_\-SKIP} =  2, 
{\bf S\_\-CANCEL} =  0
 \}
\item 
enum {\bf Command} \{ \par
{\bf CMD\_\-HOST} =  '0', 
{\bf CMD\_\-CONNECT} =  '1', 
{\bf CMD\_\-DISCONNECT} =  '2', 
{\bf CMD\_\-SLAVE\_\-STATUS} =  '3', 
\par
{\bf CMD\_\-SLAVE\_\-CONNECT} =  '4', 
{\bf CMD\_\-SLAVE\_\-HOLD} =  '5', 
{\bf CMD\_\-NONE} =  'A', 
{\bf CMD\_\-TESTDIR} =  'B', 
\par
{\bf CMD\_\-GET} =  'C', 
{\bf CMD\_\-PUT} =  'D', 
{\bf CMD\_\-STAT} =  'E', 
{\bf CMD\_\-MIMETYPE} =  'F', 
\par
{\bf CMD\_\-LISTDIR} =  'G', 
{\bf CMD\_\-MKDIR} =  'H', 
{\bf CMD\_\-RENAME} =  'I', 
{\bf CMD\_\-COPY} =  'J', 
\par
{\bf CMD\_\-DEL} =  'K', 
{\bf CMD\_\-CHMOD} =  'L', 
{\bf CMD\_\-SPECIAL} =  'M', 
{\bf CMD\_\-USERPASS} =  'N', 
\par
{\bf CMD\_\-REPARSECONFIGURATION} =  'O', 
{\bf CMD\_\-META\_\-DATA} =  'P', 
{\bf CMD\_\-SYMLINK} =  'Q', 
{\bf CMD\_\-SUBURL} =  'R', 
\par
{\bf CMD\_\-MESSAGEBOXANSWER} =  'S', 
{\bf CMD\_\-RESUMEANSWER} =  'T', 
{\bf CMD\_\-CONFIG} =  'U', 
{\bf CMD\_\-MULTI\_\-GET} =  'V'
 \}
\begin{CompactList}\small\item\em Commands that can be invoked by a job. \item\end{CompactList}\item 
enum {\bf Info} \{ \par
{\bf INF\_\-TOTAL\_\-SIZE} =  10, 
{\bf INF\_\-PROCESSED\_\-SIZE} =  11, 
{\bf INF\_\-SPEED}, 
{\bf INF\_\-REDIRECTION} =  20, 
\par
{\bf INF\_\-MIME\_\-TYPE} =  21, 
{\bf INF\_\-ERROR\_\-PAGE} =  22, 
{\bf INF\_\-WARNING} =  23, 
{\bf INF\_\-GETTING\_\-FILE}, 
\par
{\bf INF\_\-NEED\_\-PASSWD} =  25, 
{\bf INF\_\-INFOMESSAGE}, 
{\bf INF\_\-META\_\-DATA}, 
{\bf INF\_\-NETWORK\_\-STATUS}, 
\par
{\bf INF\_\-MESSAGEBOX}
 \}
\begin{CompactList}\small\item\em Identifiers for {\bf KIO}{\rm (p.\,\pageref{namespaceKIO})} informational messages. \item\end{CompactList}\item 
enum {\bf Message} \{ \par
{\bf MSG\_\-DATA} =  100, 
{\bf MSG\_\-DATA\_\-REQ}, 
{\bf MSG\_\-ERROR}, 
{\bf MSG\_\-CONNECTED}, 
\par
{\bf MSG\_\-FINISHED}, 
{\bf MSG\_\-STAT\_\-ENTRY}, 
{\bf MSG\_\-LIST\_\-ENTRIES}, 
{\bf MSG\_\-RENAMED}, 
\par
{\bf MSG\_\-RESUME}, 
{\bf MSG\_\-SLAVE\_\-STATUS}, 
{\bf MSG\_\-SLAVE\_\-ACK}, 
{\bf MSG\_\-NET\_\-REQUEST}, 
\par
{\bf MSG\_\-NET\_\-DROP}, 
{\bf MSG\_\-NEED\_\-SUBURL\_\-DATA}, 
{\bf MSG\_\-CANRESUME}, 
{\bf MSG\_\-AUTH\_\-KEY}, 
\par
{\bf MSG\_\-DEL\_\-AUTH\_\-KEY}
 \}
\begin{CompactList}\small\item\em Identifiers for {\bf KIO}{\rm (p.\,\pageref{namespaceKIO})} data messages. \item\end{CompactList}\end{CompactItemize}
\subsection*{Functions}
\begin{CompactItemize}
\item 
{\bf QData\-Stream} \& {\bf operator$<$$<$} ({\bf QData\-Stream} \&s, const  {\bf Auth\-Info} \&a)\label{namespaceKIO_a172}

\item 
{\bf QData\-Stream} \& {\bf operator$>$$>$} ({\bf QData\-Stream} \&s, {\bf Auth\-Info} \&a)\label{namespaceKIO_a173}

\item 
{\bf Chmod\-Job} $\ast$ {\bf chmod} (const  {\bf KFile\-Item\-List} \&lst\-Items, int permissions, int mask, {\bf QString} new\-Owner, {\bf QString} new\-Group, bool recursive, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Creates a job that changes permissions/ownership on several files or directories, optionally recursively. \item\end{CompactList}\item 
{\bf Dav\-Job} $\ast$ {\bf dav\-Prop\-Find} (const  {\bf KURL} \&url, const  {\bf QDom\-Document} \&properties, {\bf QString} depth, bool show\-Progress\-Info=true)\label{namespaceKIO_a175}

\item 
{\bf Dav\-Job} $\ast$ {\bf dav\-Prop\-Patch} (const  {\bf KURL} \&url, const  {\bf QDom\-Document} \&properties, bool show\-Progress\-Info=true)\label{namespaceKIO_a176}

\item 
{\bf Dav\-Job} $\ast$ {\bf dav\-Search} (const  {\bf KURL} \&url, const  {\bf QString} \&ns\-URI, const  {\bf QString} \&q\-Name, const  {\bf QString} \&query, bool show\-Progress\-Info=true)\label{namespaceKIO_a177}

\item 
{\bf QString} {\bf convert\-Size} (KIO::filesize\_\-t size)
\begin{CompactList}\small\item\em Converts {\tt size} from bytes to the string representation. \item\end{CompactList}\item 
{\bf QString} {\bf number} (KIO::filesize\_\-t size)
\begin{CompactList}\small\item\em Converts a size to a string representation Not unlike {\bf QString::number}(...). \item\end{CompactList}\item 
{\bf QString} {\bf convert\-Size\-From\-KB} (KIO::filesize\_\-t kb\-Size)
\begin{CompactList}\small\item\em Converts size from kilo-bytes to the string representation. \item\end{CompactList}\item 
{\bf QTime} {\bf calculate\-Remaining} (KIO::filesize\_\-t total\-Size, KIO::filesize\_\-t processed\-Size, KIO::filesize\_\-t speed)
\begin{CompactList}\small\item\em Calculates remaining time from total size, processed size and speed. \item\end{CompactList}\item 
{\bf QString} {\bf items\-Summary\-String} (uint items, uint files, uint dirs, KIO::filesize\_\-t size, bool show\-Size)
\begin{CompactList}\small\item\em Helper for showing information about a set of files and directories {\tt items} = {\tt files} + {\tt dirs} + number of symlinks :). \item\end{CompactList}\item 
{\bf QString} {\bf encode\-File\-Name} (const  {\bf QString} \&str)
\begin{CompactList}\small\item\em Encodes (from the text displayed to the real filename) This translates  into \% and / into 2f Used by {\bf KIO::link}{\rm (p.\,\pageref{namespaceKIO_a221})}, for instance. \item\end{CompactList}\item 
{\bf QString} {\bf decode\-File\-Name} (const  {\bf QString} \&str)
\begin{CompactList}\small\item\em Decodes (from the filename to the text displayed) This translates 2[f\-F] into / and \% into . \item\end{CompactList}\item 
{\bf QString} {\bf build\-Error\-String} (int error\-Code, const  {\bf QString} \&error\-Text)\label{namespaceKIO_a185}

\item 
{\bf QString} {\bf build\-HTMLError\-String} (int error\-Code, const  {\bf QString} \&error\-Text, const  {\bf KURL} $\ast$req\-Url=0L, int method=-1)\label{namespaceKIO_a186}

\item 
{\bf QByte\-Array} {\bf raw\-Error\-Detail} (int error\-Code, const  {\bf QString} \&error\-Text, const  {\bf KURL} $\ast$req\-Url=0L, int method=-1)\label{namespaceKIO_a187}

\item 
{\bf KIO::Cache\-Control} {\bf parse\-Cache\-Control} (const  {\bf QString} \&cache\-Control)\label{namespaceKIO_a188}

\item 
{\bf QString} {\bf get\-Cache\-Control\-String} ({\bf KIO::Cache\-Control} cache\-Control)\label{namespaceKIO_a189}

\item 
{\bf QString} {\bf find\-Device\-Mount\-Point} (const  {\bf QString} \&device)
\begin{CompactList}\small\item\em Returns the mount point where {\tt device} is mounted right now. \item\end{CompactList}\item 
{\bf QString} {\bf find\-Path\-Mount\-Point} (const  {\bf QString} \&filename)
\begin{CompactList}\small\item\em Returns the mount point on which resides {\tt filename}. \item\end{CompactList}\item 
bool {\bf probably\_\-slow\_\-mounted} (const  {\bf QString} \&filename)
\begin{CompactList}\small\item\em Checks if the path belongs to a filesystem that is probably slow. \item\end{CompactList}\item 
bool {\bf manually\_\-mounted} (const  {\bf QString} \&filename)
\begin{CompactList}\small\item\em Checks if the path belongs to a filesystem that is manually mounted. \item\end{CompactList}\item 
{\bf Simple\-Job} $\ast$ {\bf mkdir} (const  {\bf KURL} \&url, int permissions=-1)
\begin{CompactList}\small\item\em Creates a single directory. \item\end{CompactList}\item 
{\bf Simple\-Job} $\ast$ {\bf rmdir} (const  {\bf KURL} \&url)
\begin{CompactList}\small\item\em Removes a single directory. \item\end{CompactList}\item 
{\bf Simple\-Job} $\ast$ {\bf chmod} (const  {\bf KURL} \&url, int permissions)
\begin{CompactList}\small\item\em Changes permissions on a file or directory. \item\end{CompactList}\item 
{\bf Simple\-Job} $\ast$ {\bf rename} (const  {\bf KURL} \&src, const  {\bf KURL} \&dest, bool overwrite)
\begin{CompactList}\small\item\em Rename a file or directory. \item\end{CompactList}\item 
{\bf Simple\-Job} $\ast$ {\bf symlink} (const  {\bf QString} \&target, const  {\bf KURL} \&dest, bool overwrite, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Create or move a symlink. \item\end{CompactList}\item 
{\bf Simple\-Job} $\ast$ {\bf special} (const  {\bf KURL} \&url, const  {\bf QByte\-Array} \&data, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Execute any command that is specific to one slave (protocol). \item\end{CompactList}\item 
{\bf Simple\-Job} $\ast$ {\bf mount} (bool ro, const  char $\ast$fstype, const  {\bf QString} \&dev, const  {\bf QString} \&point, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Mount filesystem. \item\end{CompactList}\item 
{\bf Simple\-Job} $\ast$ {\bf unmount} (const  {\bf QString} \&point, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Unmount filesystem. \item\end{CompactList}\item 
{\bf Simple\-Job} $\ast$ {\bf http\_\-update\_\-cache} (const  {\bf KURL} \&url, bool no\_\-cache, time\_\-t expire\-Date)
\begin{CompactList}\small\item\em HTTP cache update. \item\end{CompactList}\item 
Stat\-Job $\ast$ {\bf stat} (const  {\bf KURL} \&url, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Find all details for one file or directory. \item\end{CompactList}\item 
Stat\-Job $\ast$ {\bf stat} (const  {\bf KURL} \&url, bool side\-Is\-Source, short int details, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Find all details for one file or directory. \item\end{CompactList}\item 
{\bf Transfer\-Job} $\ast$ {\bf get} (const  {\bf KURL} \&url, bool reload=false, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Get (a.k.a. \item\end{CompactList}\item 
{\bf Transfer\-Job} $\ast$ {\bf put} (const  {\bf KURL} \&url, int permissions, bool overwrite, bool resume, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Put (a.k.a. \item\end{CompactList}\item 
{\bf Transfer\-Job} $\ast$ {\bf http\_\-post} (const  {\bf KURL} \&url, const  {\bf QByte\-Array} \&post\-Data, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em HTTP POST (for form data). \item\end{CompactList}\item 
Multi\-Get\-Job $\ast$ {\bf multi\_\-get} (long id, const  {\bf KURL} \&url, const  Meta\-Data \&meta\-Data)\label{namespaceKIO_a208}

\item 
Mimetype\-Job $\ast$ {\bf mimetype} (const  {\bf KURL} \&url, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Find mimetype for one file or directory. \item\end{CompactList}\item 
{\bf File\-Copy\-Job} $\ast$ {\bf file\_\-copy} (const  {\bf KURL} \&src, const  {\bf KURL} \&dest, int permissions=-1, bool overwrite=false, bool resume=false, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Copy a single file. \item\end{CompactList}\item 
{\bf File\-Copy\-Job} $\ast$ {\bf file\_\-move} (const  {\bf KURL} \&src, const  {\bf KURL} \&dest, int permissions=-1, bool overwrite=false, bool resume=false, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Move a single file. \item\end{CompactList}\item 
{\bf Simple\-Job} $\ast$ {\bf file\_\-delete} (const  {\bf KURL} \&src, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Delete a single file. \item\end{CompactList}\item 
List\-Job $\ast$ {\bf list\-Dir} (const  {\bf KURL} \&url, bool show\-Progress\-Info=true, bool include\-Hidden=true)
\begin{CompactList}\small\item\em List the contents of {\tt url}, which is assumed to be a directory. \item\end{CompactList}\item 
List\-Job $\ast$ {\bf list\-Recursive} (const  {\bf KURL} \&url, bool show\-Progress\-Info=true, bool include\-Hidden=true)
\begin{CompactList}\small\item\em The same as the previous method, but recurses subdirectories. \item\end{CompactList}\item 
Copy\-Job $\ast$ {\bf copy} (const  {\bf KURL} \&src, const  {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Copy a file or directory {\tt src} into the destination , which can be a file (including the final filename) or a directory (into which {\tt src} will be copied). \item\end{CompactList}\item 
Copy\-Job $\ast$ {\bf copy\-As} (const  {\bf KURL} \&src, const  {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Copy a file or directory {\tt src} into the destination , which is the destination name in any case, even for a directory. \item\end{CompactList}\item 
Copy\-Job $\ast$ {\bf copy} (const  {\bf KURL::List} \&src, const  {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Copy a list of file/dirs {\tt src} into a destination directory {\tt dest}. \item\end{CompactList}\item 
Copy\-Job $\ast$ {\bf move} (const  {\bf KURL} \&src, const  {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\item 
Copy\-Job $\ast$ {\bf move\-As} (const  {\bf KURL} \&src, const  {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\item 
Copy\-Job $\ast$ {\bf move} (const  {\bf KURL::List} \&src, const  {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\item 
Copy\-Job $\ast$ {\bf link} (const  {\bf KURL} \&src, const  {\bf KURL} \&dest\-Dir, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Create a link. \item\end{CompactList}\item 
Copy\-Job $\ast$ {\bf link} (const  {\bf KURL::List} \&src, const  {\bf KURL} \&dest\-Dir, bool show\-Progress\-Info=true)
\item 
Copy\-Job $\ast$ {\bf link\-As} (const  {\bf KURL} \&src, const  {\bf KURL} \&dest, bool show\-Progress\-Info=true)
\item 
{\bf Delete\-Job} $\ast$ {\bf del} (const  {\bf KURL} \&src, bool shred=false, bool show\-Progress\-Info=true)
\begin{CompactList}\small\item\em Delete a file or directory. \item\end{CompactList}\item 
{\bf Delete\-Job} $\ast$ {\bf del} (const  {\bf KURL::List} \&src, bool shred=false, bool show\-Progress\-Info=true)\label{namespaceKIO_a225}

\item 
int {\bf match\-Constraint} (const  Parse\-Tree\-Base $\ast$\_\-tree, const  {\bf KService::Ptr} \&\_\-service, const  {\bf KService\-Type\-Profile::Offer\-List} \&\_\-list)
\item 
Preferences\-Return {\bf match\-Preferences} (const  Parse\-Tree\-Base $\ast$\_\-tree, const  {\bf KService::Ptr} \&\_\-service, const  {\bf KService\-Type\-Profile::Offer\-List} \&\_\-list)
\item 
{\bf Parse\-Tree\-Base::Ptr} {\bf parse\-Constraints} (const  {\bf QString} \&\_\-constr)\label{namespaceKIO_a228}

\item 
{\bf Parse\-Tree\-Base::Ptr} {\bf parse\-Preferences} (const  {\bf QString} \&\_\-prefs)\label{namespaceKIO_a229}

\item 
{\bf Meta\-Info\-Job} $\ast$ {\bf file\-Meta\-Info} (const  {\bf KFile\-Item\-List} \&items)
\begin{CompactList}\small\item\em Retrieves meta information for the given items. \item\end{CompactList}\item 
{\bf Meta\-Info\-Job} $\ast$ {\bf file\-Meta\-Info} (const  {\bf KURL::List} \&items)
\begin{CompactList}\small\item\em Same as above, but takes a URL list instead of KFile\-Item\-List. \item\end{CompactList}\item 
{\bf Job} $\ast$ {\bf paste\-Clipboard} (const  {\bf KURL} \&\_\-dest\_\-url, bool move=false)\label{namespaceKIO_a232}

\item 
void {\bf paste\-Data} (const  {\bf KURL} \&\_\-dest\_\-url, const  {\bf QByte\-Array} \&\_\-data)\label{namespaceKIO_a233}

\item 
bool {\bf is\-Clipboard\-Empty} ()\label{namespaceKIO_a234}

\item 
{\bf Preview\-Job} $\ast$ {\bf file\-Preview} (const  {\bf KFile\-Item\-List} \&items, int width, int height=0, int icon\-Size=0, int icon\-Alpha=70, bool scale=true, bool save=true, const  {\bf QString\-List} $\ast$enabled\-Plugins=0)
\begin{CompactList}\small\item\em Generates or retrieves a preview image for the given URL. \item\end{CompactList}\item 
{\bf Preview\-Job} $\ast$ {\bf file\-Preview} (const  {\bf KURL::List} \&items, int width, int height=0, int icon\-Size=0, int icon\-Alpha=70, bool scale=true, bool save=true, const  {\bf QString\-List} $\ast$enabled\-Plugins=0)
\begin{CompactList}\small\item\em Same as above, but takes a URL list instead of KFile\-Item\-List. \item\end{CompactList}\item 
Rename\-Dlg\_\-Result {\bf open\_\-Rename\-Dlg} (const  {\bf QString} \&caption, const  {\bf QString} \&src, const  {\bf QString} \&dest, Rename\-Dlg\_\-Mode mode, {\bf QString} \&new\-Dest\-Path, KIO::filesize\_\-t size\-Src=(KIO::filesize\_\-t)-1, KIO::filesize\_\-t size\-Dest=(KIO::filesize\_\-t)-1, time\_\-t ctime\-Src=(time\_\-t)-1, time\_\-t ctime\-Dest=(time\_\-t)-1, time\_\-t mtime\-Src=(time\_\-t)-1, time\_\-t mtime\-Dest=(time\_\-t)-1)\label{namespaceKIO_a0}

\item 
Skip\-Dlg\_\-Result {\bf open\_\-Skip\-Dlg} (bool \_\-multi, const  {\bf QString} \&\_\-error\_\-text=QString::null)\label{namespaceKIO_a238}

\item 
void {\bf read\-Config} ({\bf KConfig} $\ast$config, const  {\bf QString} \&group, Meta\-Data $\ast$meta\-Data)\label{namespaceKIO_a239}

\end{CompactItemize}
\subsection*{Variables}
\begin{CompactItemize}
\item 
{\bf KStatic\-Deleter}$<$ {\bf Slave\-Config} $>$ {\bf slaveconfigsd}\label{namespaceKIO_a113}

\end{CompactItemize}


\subsection{Detailed Description}
A namespace for KIO globals. 

\subsection{Typedef Documentation}
\index{KIO@{KIO}!UDSEntry@{UDSEntry}}
\index{UDSEntry@{UDSEntry}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}typedef {\bf QValue\-List}$<$UDSAtom$>$ {\bf KIO::UDSEntry}}\label{namespaceKIO_a2}


An entry is the list of atoms containing all the informations for a file or URL. 



Definition at line 324 of file global.h.

Referenced by KFile\-Item::entry(), KFile\-Item::KFile\-Item(), KIO::Slave\-Base::list\-Entry(), KFile\-Item::refresh(), KIO::Preview\-Job::slot\-Result(), KIO::Delete\-Job::slot\-Result(), KIO::Net\-Access::stat(), and KIO::Slave\-Base::stat\-Entry().

\subsection{Enumeration Type Documentation}
\index{KIO@{KIO}!Error@{Error}}
\index{Error@{Error}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KIO::Error}}\label{namespaceKIO_a240}


Error codes that can be emitted by KIO. 



Definition at line 97 of file global.h.\index{KIO@{KIO}!UDSAtomTypes@{UDSAtomTypes}}
\index{UDSAtomTypes@{UDSAtomTypes}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KIO::UDSAtom\-Types}}\label{namespaceKIO_a241}


Constants used to specify the type of a KUDSAtom. 

\begin{Desc}
\item[Enumeration values: ]\par
\begin{description}
\index{UDS_STRING@{UDS\_\-STRING}!KIO@{KIO}}\index{KIO@{KIO}!UDS_STRING@{UDS\_\-STRING}}\item[{\em 
UDS\_\-STRING\label{namespaceKIO_a241a69}
}]First let's define the item types. \index{UDS_SIZE@{UDS\_\-SIZE}!KIO@{KIO}}\index{KIO@{KIO}!UDS_SIZE@{UDS\_\-SIZE}}\item[{\em 
UDS\_\-SIZE\label{namespaceKIO_a241a72}
}]Size of the file. \index{UDS_USER@{UDS\_\-USER}!KIO@{KIO}}\index{KIO@{KIO}!UDS_USER@{UDS\_\-USER}}\item[{\em 
UDS\_\-USER\label{namespaceKIO_a241a74}
}]User ID of the file owner. \index{UDS_GROUP@{UDS\_\-GROUP}!KIO@{KIO}}\index{KIO@{KIO}!UDS_GROUP@{UDS\_\-GROUP}}\item[{\em 
UDS\_\-GROUP\label{namespaceKIO_a241a75}
}]Group ID of the file owner. \index{UDS_NAME@{UDS\_\-NAME}!KIO@{KIO}}\index{KIO@{KIO}!UDS_NAME@{UDS\_\-NAME}}\item[{\em 
UDS\_\-NAME\label{namespaceKIO_a241a76}
}]Filename. \index{UDS_ACCESS@{UDS\_\-ACCESS}!KIO@{KIO}}\index{KIO@{KIO}!UDS_ACCESS@{UDS\_\-ACCESS}}\item[{\em 
UDS\_\-ACCESS\label{namespaceKIO_a241a77}
}]Access permissions (part of the mode returned by stat). \index{UDS_MODIFICATION_TIME@{UDS\_\-MODIFICATION\_\-TIME}!KIO@{KIO}}\index{KIO@{KIO}!UDS_MODIFICATION_TIME@{UDS\_\-MODIFICATION\_\-TIME}}\item[{\em 
UDS\_\-MODIFICATION\_\-TIME\label{namespaceKIO_a241a78}
}]The last time the file was modified. \index{UDS_ACCESS_TIME@{UDS\_\-ACCESS\_\-TIME}!KIO@{KIO}}\index{KIO@{KIO}!UDS_ACCESS_TIME@{UDS\_\-ACCESS\_\-TIME}}\item[{\em 
UDS\_\-ACCESS\_\-TIME\label{namespaceKIO_a241a79}
}]The last time the file was opened. \index{UDS_CREATION_TIME@{UDS\_\-CREATION\_\-TIME}!KIO@{KIO}}\index{KIO@{KIO}!UDS_CREATION_TIME@{UDS\_\-CREATION\_\-TIME}}\item[{\em 
UDS\_\-CREATION\_\-TIME\label{namespaceKIO_a241a80}
}]The time the file was created. \index{UDS_FILE_TYPE@{UDS\_\-FILE\_\-TYPE}!KIO@{KIO}}\index{KIO@{KIO}!UDS_FILE_TYPE@{UDS\_\-FILE\_\-TYPE}}\item[{\em 
UDS\_\-FILE\_\-TYPE\label{namespaceKIO_a241a81}
}]File type, part of the mode returned by stat (for a link, this returns the file type of the pointed item) check UDS\_\-LINK\_\-DEST to know if this is a link. \index{UDS_LINK_DEST@{UDS\_\-LINK\_\-DEST}!KIO@{KIO}}\index{KIO@{KIO}!UDS_LINK_DEST@{UDS\_\-LINK\_\-DEST}}\item[{\em 
UDS\_\-LINK\_\-DEST\label{namespaceKIO_a241a82}
}]Name of the file where the link points to Allows to check for a symlink (don't use S\_\-ISLNK !). \index{UDS_URL@{UDS\_\-URL}!KIO@{KIO}}\index{KIO@{KIO}!UDS_URL@{UDS\_\-URL}}\item[{\em 
UDS\_\-URL\label{namespaceKIO_a241a83}
}]An alternative URL (If different from the caption). \index{UDS_MIME_TYPE@{UDS\_\-MIME\_\-TYPE}!KIO@{KIO}}\index{KIO@{KIO}!UDS_MIME_TYPE@{UDS\_\-MIME\_\-TYPE}}\item[{\em 
UDS\_\-MIME\_\-TYPE\label{namespaceKIO_a241a84}
}]A mime type; prevents guessing. \index{UDS_GUESSED_MIME_TYPE@{UDS\_\-GUESSED\_\-MIME\_\-TYPE}!KIO@{KIO}}\index{KIO@{KIO}!UDS_GUESSED_MIME_TYPE@{UDS\_\-GUESSED\_\-MIME\_\-TYPE}}\item[{\em 
UDS\_\-GUESSED\_\-MIME\_\-TYPE\label{namespaceKIO_a241a85}
}]A mime type to be used for displaying only. 

But when 'running' the file, the mimetype is re-determined \index{UDS_XML_PROPERTIES@{UDS\_\-XML\_\-PROPERTIES}!KIO@{KIO}}\index{KIO@{KIO}!UDS_XML_PROPERTIES@{UDS\_\-XML\_\-PROPERTIES}}\item[{\em 
UDS\_\-XML\_\-PROPERTIES\label{namespaceKIO_a241a86}
}]XML properties, e.g. 

for Web\-DAV \begin{Desc}
\item[Since:]3.1 \end{Desc}
\end{description}
\end{Desc}



Definition at line 207 of file global.h.\index{KIO@{KIO}!CacheControl@{CacheControl}}
\index{CacheControl@{CacheControl}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KIO::Cache\-Control}}\label{namespaceKIO_a242}


\begin{Desc}
\item[Enumeration values: ]\par
\begin{description}
\index{CC_CacheOnly@{CC\_\-CacheOnly}!KIO@{KIO}}\index{KIO@{KIO}!CC_CacheOnly@{CC\_\-CacheOnly}}\item[{\em 
CC\_\-Cache\-Only\label{namespaceKIO_a242a87}
}]Fail request if not in cache. \index{CC_Cache@{CC\_\-Cache}!KIO@{KIO}}\index{KIO@{KIO}!CC_Cache@{CC\_\-Cache}}\item[{\em 
CC\_\-Cache\label{namespaceKIO_a242a88}
}]Use cached entry if available. \index{CC_Verify@{CC\_\-Verify}!KIO@{KIO}}\index{KIO@{KIO}!CC_Verify@{CC\_\-Verify}}\item[{\em 
CC\_\-Verify\label{namespaceKIO_a242a89}
}]Validate cached entry with remote site if expired. \index{CC_Refresh@{CC\_\-Refresh}!KIO@{KIO}}\index{KIO@{KIO}!CC_Refresh@{CC\_\-Refresh}}\item[{\em 
CC\_\-Refresh\label{namespaceKIO_a242a90}
}]Always validate cached entry with remote site \begin{Desc}
\item[Since:]3.1. \end{Desc}
\index{CC_Reload@{CC\_\-Reload}!KIO@{KIO}}\index{KIO@{KIO}!CC_Reload@{CC\_\-Reload}}\item[{\em 
CC\_\-Reload\label{namespaceKIO_a242a91}
}]Always fetch from remote site. \end{description}
\end{Desc}



Definition at line 249 of file global.h.\index{KIO@{KIO}!Command@{Command}}
\index{Command@{Command}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KIO::Command}}\label{namespaceKIO_a247}


Commands that can be invoked by a job. 



Definition at line 43 of file slaveinterface.h.\index{KIO@{KIO}!Info@{Info}}
\index{Info@{Info}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KIO::Info}}\label{namespaceKIO_a248}


Identifiers for KIO informational messages. 



Definition at line 79 of file slaveinterface.h.\index{KIO@{KIO}!Message@{Message}}
\index{Message@{Message}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}enum {\bf KIO::Message}}\label{namespaceKIO_a249}


Identifiers for KIO data messages. 



Definition at line 99 of file slaveinterface.h.

\subsection{Function Documentation}
\index{KIO@{KIO}!chmod@{chmod}}
\index{chmod@{chmod}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Chmod\-Job} $\ast$ KIO::chmod (const {\bf KFile\-Item\-List} \& {\em lst\-Items}, int {\em permissions}, int {\em mask}, {\bf QString} {\em new\-Owner}, {\bf QString} {\em new\-Group}, bool {\em recursive}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a174}


Creates a job that changes permissions/ownership on several files or directories, optionally recursively. 

This version of chmod uses a KFile\-Item\-List so that it directly knows what to do with the items. TODO: a version that takes a {\bf KURL::List}, and a general job that stats each url and returns a KFile\-Item\-List.

Note that change of ownership is only supported for local files.

Inside directories, the \char`\"{}x\char`\"{} bits will only be changed for files that had at least one \char`\"{}x\char`\"{} bit before, and for directories. This emulates the behaviour of chmod +X.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em lst\-Items}]The file items representing several files or directories. \item[{\em permissions}]the permissions we want to set \item[{\em mask}]the bits we are allowed to change For instance, if mask is 0077, we don't change the \char`\"{}user\char`\"{} bits, only \char`\"{}group\char`\"{} and \char`\"{}others\char`\"{}. \item[{\em new\-Owner}]If non-empty, the new owner for the files \item[{\em new\-Group}]If non-empty, the new group for the files \item[{\em recursive}]whether to open directories recursively\end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]The job handling the operation. \end{Desc}


Definition at line 236 of file chmodjob.cpp.

References QFile::encode\-Name(), and QString::is\-Empty().

Referenced by KFile\-Permissions\-Props\-Plugin::apply\-Changes().\index{KIO@{KIO}!convertSize@{convertSize}}
\index{convertSize@{convertSize}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KIO::convert\-Size (KIO::filesize\_\-t {\em size})}\label{namespaceKIO_a178}


Converts {\tt size} from bytes to the string representation. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em size}]size in bytes \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]converted size as a string - e.g. 123.4 k\-B , 12.0 MB \end{Desc}


Definition at line 46 of file global.cpp.

References QString::arg(), and KGlobal::locale().

Referenced by convert\-Size\-From\-KB(), KFile\-Item::get\-Tool\-Tip\-Text(), and KFile\-Mime\-Type\-Info::Item\-Info::string().\index{KIO@{KIO}!number@{number}}
\index{number@{number}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KIO::number (KIO::filesize\_\-t {\em size})}\label{namespaceKIO_a179}


Converts a size to a string representation Not unlike {\bf QString::number}(...). 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em size}]size in bytes \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]converted size as a string - e.g. 123456789 \end{Desc}


Definition at line 85 of file global.cpp.

References QString::from\-Latin1().

Referenced by KIO::Slave\-Base::can\-Resume(), KBookmark\-Manager::find\-By\-Address(), KURLBar::read\-Item(), KFile\-View::sorting\-Key(), and KURLBar::write\-Item().\index{KIO@{KIO}!convertSizeFromKB@{convertSizeFromKB}}
\index{convertSizeFromKB@{convertSizeFromKB}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KIO::convert\-Size\-From\-KB (KIO::filesize\_\-t {\em kb\-Size})}\label{namespaceKIO_a180}


Converts size from kilo-bytes to the string representation. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em size}]size in kilo-bytes \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]converted size as a string - e.g. 123.4 k\-B , 12.0 MB \end{Desc}


Definition at line 80 of file global.cpp.

References convert\-Size().

Referenced by KFile\-Mime\-Type\-Info::Item\-Info::string().\index{KIO@{KIO}!calculateRemaining@{calculateRemaining}}
\index{calculateRemaining@{calculateRemaining}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QTime} KIO::calculate\-Remaining (KIO::filesize\_\-t {\em total\-Size}, KIO::filesize\_\-t {\em processed\-Size}, KIO::filesize\_\-t {\em speed})}\label{namespaceKIO_a181}


Calculates remaining time from total size, processed size and speed. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em total\-Size}]total size in bytes \item[{\em processed\-Size}]processed size in bytes \item[{\em speed}]speed in bytes pre second \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]calculated remaining time \end{Desc}


Definition at line 92 of file global.cpp.

References QTime::set\-HMS().\index{KIO@{KIO}!itemsSummaryString@{itemsSummaryString}}
\index{itemsSummaryString@{itemsSummaryString}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KIO::items\-Summary\-String (uint {\em items}, uint {\em files}, uint {\em dirs}, KIO::filesize\_\-t {\em size}, bool {\em show\-Size})}\label{namespaceKIO_a182}


Helper for showing information about a set of files and directories {\tt items} = {\tt files} + {\tt dirs} + number of symlinks :). 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em size}]the sum of the size of the \_\-files\_\- \item[{\em show\-Size}]whether to show the size in the result \end{description}
\end{Desc}


Definition at line 115 of file global.cpp.

References QString::arg().\index{KIO@{KIO}!encodeFileName@{encodeFileName}}
\index{encodeFileName@{encodeFileName}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KIO::encode\-File\-Name (const {\bf QString} \& {\em str})}\label{namespaceKIO_a183}


Encodes (from the text displayed to the real filename) This translates  into \% and / into 2f Used by {\bf KIO::link}{\rm (p.\,\pageref{namespaceKIO_a221})}, for instance. 



Definition at line 130 of file global.cpp.

References QString::find(), and QString::replace().

Referenced by KFile\-Props\-Plugin::apply\-Changes().\index{KIO@{KIO}!decodeFileName@{decodeFileName}}
\index{decodeFileName@{decodeFileName}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KIO::decode\-File\-Name (const {\bf QString} \& {\em str})}\label{namespaceKIO_a184}


Decodes (from the filename to the text displayed) This translates 2[f\-F] into / and \% into . 



Definition at line 145 of file global.cpp.

References QString::append(), QString::length(), and QString::lower().

Referenced by KFile\-Item::KFile\-Item(), KFile\-Props\-Plugin::KFile\-Props\-Plugin(), KProperties\-Dialog::KProperties\-Dialog(), and KFile\-Item::set\-URL().\index{KIO@{KIO}!findDeviceMountPoint@{findDeviceMountPoint}}
\index{findDeviceMountPoint@{findDeviceMountPoint}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KIO::find\-Device\-Mount\-Point (const {\bf QString} \& {\em device})}\label{namespaceKIO_a190}


Returns the mount point where {\tt device} is mounted right now. 

This means, it has to be mounted, not just defined in fstab. 

Definition at line 1270 of file global.cpp.

References QFile::encode\-Name(), and QCString::length().

Referenced by KDEDesktop\-Mime\-Type::builtin\-Services(), KDEDesktop\-Mime\-Type::execute\-Service(), and KDEDesktop\-Mime\-Type::icon().\index{KIO@{KIO}!findPathMountPoint@{findPathMountPoint}}
\index{findPathMountPoint@{findPathMountPoint}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf QString} KIO::find\-Path\-Mount\-Point (const {\bf QString} \& {\em filename})}\label{namespaceKIO_a191}


Returns the mount point on which resides {\tt filename}. 

For instance if /home is a separate partition, find\-Path\-Mount\-Point(\char`\"{}/home/user/blah\char`\"{}) will return /home 

Definition at line 1733 of file global.cpp.

Referenced by KDisk\-Free\-Sp::find\-Usage\-Info(), and KFile\-Props\-Plugin::KFile\-Props\-Plugin().\index{KIO@{KIO}!probably_slow_mounted@{probably\_\-slow\_\-mounted}}
\index{probably_slow_mounted@{probably\_\-slow\_\-mounted}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KIO::probably\_\-slow\_\-mounted (const {\bf QString} \& {\em filename})}\label{namespaceKIO_a192}


Checks if the path belongs to a filesystem that is probably slow. 

It checks for NFS or for paths belonging to automounted paths not yet mounted 

Definition at line 1746 of file global.cpp.\index{KIO@{KIO}!manually_mounted@{manually\_\-mounted}}
\index{manually_mounted@{manually\_\-mounted}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}bool KIO::manually\_\-mounted (const {\bf QString} \& {\em filename})}\label{namespaceKIO_a193}


Checks if the path belongs to a filesystem that is manually mounted. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em filename}]the file name to check \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]true if the filesystem is manually mounted \end{Desc}


Definition at line 1739 of file global.cpp.\index{KIO@{KIO}!mkdir@{mkdir}}
\index{mkdir@{mkdir}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::mkdir (const {\bf KURL} \& {\em url}, int {\em permissions} = -1)}\label{namespaceKIO_a194}


Creates a single directory. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]The URL of the directory to create. \item[{\em permissions}]The permissions to set after creating the directory. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]A pointer to the job handling the operation. \end{Desc}


Definition at line 569 of file job.cpp.\index{KIO@{KIO}!rmdir@{rmdir}}
\index{rmdir@{rmdir}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::rmdir (const {\bf KURL} \& {\em url})}\label{namespaceKIO_a195}


Removes a single directory. 

The directory is assumed to be empty.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]The URL of the directory to remove. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]A pointer to the job handling the operation. \end{Desc}


Definition at line 576 of file job.cpp.\index{KIO@{KIO}!chmod@{chmod}}
\index{chmod@{chmod}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::chmod (const {\bf KURL} \& {\em url}, int {\em permissions})}\label{namespaceKIO_a196}


Changes permissions on a file or directory. 

See the other {\bf chmod}{\rm (p.\,\pageref{namespaceKIO_a174})} below for changing many files or directories.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]The URL of file or directory. \item[{\em permissions}]The permissions to set. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]The job handling the operation. \end{Desc}


Definition at line 583 of file job.cpp.\index{KIO@{KIO}!rename@{rename}}
\index{rename@{rename}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::rename (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em overwrite})}\label{namespaceKIO_a197}


Rename a file or directory. 

Warning: this operation fails if a direct renaming is not possible (like with files or dirs on separate partitions) Use move or file\_\-move in this case.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]The original URL \item[{\em dest}]The final URL \item[{\em overwrite}]whether to automatically overwrite if the dest exists \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]The job handling the operation. \end{Desc}


Definition at line 590 of file job.cpp.\index{KIO@{KIO}!symlink@{symlink}}
\index{symlink@{symlink}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::symlink (const {\bf QString} \& {\em target}, const {\bf KURL} \& {\em dest}, bool {\em overwrite}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a198}


Create or move a symlink. 

This is the lowlevel operation, similar to file\_\-copy and file\_\-move. It doesn't do any check (other than those the slave does) and it doesn't show rename and skip dialogs - use {\bf KIO::link}{\rm (p.\,\pageref{namespaceKIO_a221})} for that. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em target}]The string that will become the \char`\"{}target\char`\"{} of the link (can be relative) \item[{\em dest}]The symlink to create. \item[{\em overwrite}]whether to automatically overwrite if the dest exists \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]The job handling the operation. \end{Desc}


Definition at line 597 of file job.cpp.

Referenced by KTar::open\-Archive().\index{KIO@{KIO}!special@{special}}
\index{special@{special}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::special (const {\bf KURL} \& {\em url}, const {\bf QByte\-Array} \& {\em data}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a199}


Execute any command that is specific to one slave (protocol). 

Examples are : HTTP POST, mount and unmount (kio\_\-file)

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]The URL isn't passed to the slave, but is used to know which slave to send it to :-) \item[{\em data}]Packed data. The meaning is completely dependent on the slave, but usually starts with an int for the command number. \end{description}
\end{Desc}


Definition at line 604 of file job.cpp.

Referenced by mount(), and unmount().\index{KIO@{KIO}!mount@{mount}}
\index{mount@{mount}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::mount (bool {\em ro}, const char $\ast$ {\em fstype}, const {\bf QString} \& {\em dev}, const {\bf QString} \& {\em point}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a200}


Mount filesystem. 

Special job for {\tt kio\_\-file}.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em ro}]Mount read-only if {\tt true}. \item[{\em fstype}]File system type (e.g. \char`\"{}ext2\char`\"{}, can be 0L). \item[{\em dev}]Device (e.g. /dev/sda0). \item[{\em point}]Mount point, can be {\tt null}. \end{description}
\end{Desc}


Definition at line 610 of file job.cpp.

References QString::from\-Latin1(), Observer::mounting(), Observer::self(), and special().

Referenced by KDEDesktop\-Mime\-Type::builtin\-Services(), and KAuto\-Mount::KAuto\-Mount().\index{KIO@{KIO}!unmount@{unmount}}
\index{unmount@{unmount}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::unmount (const {\bf QString} \& {\em point}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a201}


Unmount filesystem. 

Special job for {\tt kio\_\-file}.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em mount}]Point to unmount. \end{description}
\end{Desc}


Definition at line 620 of file job.cpp.

References Observer::self(), special(), and Observer::unmounting().

Referenced by KDEDesktop\-Mime\-Type::builtin\-Services(), and KAuto\-Unmount::KAuto\-Unmount().\index{KIO@{KIO}!http_update_cache@{http\_\-update\_\-cache}}
\index{http_update_cache@{http\_\-update\_\-cache}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::http\_\-update\_\-cache (const {\bf KURL} \& {\em url}, bool {\em no\_\-cache}, time\_\-t {\em expire\-Date})}\label{namespaceKIO_a202}


HTTP cache update. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]Url to update, protocol must be \char`\"{}http\char`\"{}. \item[{\em no\_\-cache}]If true, cache entry for {\tt url} is deleted. \item[{\em expire\-Date}]Local machine time indicating when the entry is supposed to expire. \end{description}
\end{Desc}


Definition at line 713 of file job.cpp.

References KURL::protocol().\index{KIO@{KIO}!stat@{stat}}
\index{stat@{stat}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Stat\-Job $\ast$ KIO::stat (const {\bf KURL} \& {\em url}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a203}


Find all details for one file or directory. 



Definition at line 695 of file job.cpp.

Referenced by KMime\-Type::find\-By\-URL(), and KProperties\-Dialog::KProperties\-Dialog().\index{KIO@{KIO}!stat@{stat}}
\index{stat@{stat}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Stat\-Job $\ast$ KIO::stat (const {\bf KURL} \& {\em url}, bool {\em side\-Is\-Source}, short int {\em details}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a204}


Find all details for one file or directory. 

This version of the call includes two additional booleans, {\tt side\-Is\-Source} and {\tt details}.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em side\-Is\-Source}]is true when stating a source file (we will do a get on it if the stat works) and false when stating a destination file (target of a copy).\item[{\em details}]selects the level of 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})}. \end{description}
\end{Desc}


Definition at line 701 of file job.cpp.

References KURL::pretty\-URL(), Observer::self(), and Observer::stating().\index{KIO@{KIO}!get@{get}}
\index{get@{get}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Transfer\-Job} $\ast$ KIO::get (const {\bf KURL} \& {\em url}, bool {\em reload} = false, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a205}


Get (a.k.a. 

read).

The slave emits the data through data(). 

Definition at line 972 of file job.cpp.

References KIO::Job::add\-Meta\-Data(), and KStd\-Accel::reload().\index{KIO@{KIO}!put@{put}}
\index{put@{put}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Transfer\-Job} $\ast$ KIO::put (const {\bf KURL} \& {\em url}, int {\em permissions}, bool {\em overwrite}, bool {\em resume}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a206}


Put (a.k.a. 

write)

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]Where to write data. \item[{\em permissions}]May be -1. In this case no special permission mode is set. \item[{\em overwrite}]If {\tt true}, any existing file will be overwritten. \item[{\em resume}]\end{description}
\end{Desc}


Definition at line 1107 of file job.cpp.\index{KIO@{KIO}!http_post@{http\_\-post}}
\index{http_post@{http\_\-post}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Transfer\-Job} $\ast$ KIO::http\_\-post (const {\bf KURL} \& {\em url}, const {\bf QByte\-Array} \& {\em post\-Data}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a207}


HTTP POST (for form data). 

Example: \small\begin{alltt}
    job = KIO::http\_post( url, postData, false );
    job-$>$addMetaData("content-type", contentType );
    job-$>$addMetaData("referrer", referrerURL);
 \end{alltt}\normalsize 


{\tt post\-Data} is the data that you want to send and {\tt content\-Type} is the complete HTTP header line that specifies the content's MIME type, for example \char`\"{}Content-Type: text/xml\char`\"{}.

You MUST specify content-type!

Often {\tt content\-Type} is \char`\"{}Content-Type: application/x-www-form-urlencoded\char`\"{} and the {\tt post\-Data} is then an ASCII string (without null-termination!) with characters like space, linefeed and percent escaped like 20, 0A and 25.

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em url}]Where to write data. \item[{\em post\-Data}]Encoded data to post. \item[{\em show\-Progress\-Info}]true to display \end{description}
\end{Desc}


Definition at line 994 of file job.cpp.

References QValue\-List$<$ int $>$::begin(), QValue\-List$<$ int $>$::contains(), QValue\-List$<$ int $>$::end(), KURL::port(), KURL::protocol(), KConfig\-Base::read\-Int\-List\-Entry(), and KURL::url().\index{KIO@{KIO}!mimetype@{mimetype}}
\index{mimetype@{mimetype}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Mimetype\-Job $\ast$ KIO::mimetype (const {\bf KURL} \& {\em url}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a209}


Find mimetype for one file or directory. 



Definition at line 1164 of file job.cpp.

References Observer::self(), and Observer::stating().

Referenced by KFilter\-Dev::device(), KFilter\-Dev::device\-For\-File(), KTar::KTar(), and KData\-Tool\-Info::query().\index{KIO@{KIO}!file_copy@{file\_\-copy}}
\index{file_copy@{file\_\-copy}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf File\-Copy\-Job} $\ast$ KIO::file\_\-copy (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, int {\em permissions} = -1, bool {\em overwrite} = false, bool {\em resume} = false, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a210}


Copy a single file. 

Uses either {\bf Slave\-Base::copy}{\rm (p.\,\pageref{classKIO_1_1SlaveBase_a44})}() if the slave supports that or {\bf get}{\rm (p.\,\pageref{namespaceKIO_a205})}() and {\bf put}{\rm (p.\,\pageref{namespaceKIO_a206})}() otherwise. \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]Where to get the file. \item[{\em dest}]Where to put the file. \item[{\em permissions}]May be -1. In this case no special permission mode is set. \item[{\em overwrite}]If {\tt true}, any existing file will be overwritten. \item[{\em resume}]\end{description}
\end{Desc}


Definition at line 1530 of file job.cpp.\index{KIO@{KIO}!file_move@{file\_\-move}}
\index{file_move@{file\_\-move}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf File\-Copy\-Job} $\ast$ KIO::file\_\-move (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, int {\em permissions} = -1, bool {\em overwrite} = false, bool {\em resume} = false, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a211}


Move a single file. 

Use either {\bf Slave\-Base::rename}{\rm (p.\,\pageref{classKIO_1_1SlaveBase_a41})}() if the slave supports that, or {\bf copy}{\rm (p.\,\pageref{namespaceKIO_a215})}() and {\bf del}{\rm (p.\,\pageref{namespaceKIO_a224})}() otherwise, or eventually {\bf get()}{\rm (p.\,\pageref{namespaceKIO_a205})} \& {\bf put()}{\rm (p.\,\pageref{namespaceKIO_a206})} \& {\bf del()}{\rm (p.\,\pageref{namespaceKIO_a224})} \begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]Where to get the file. \item[{\em dest}]Where to put the file. \item[{\em permissions}]May be -1. In this case no special permission mode is set. \item[{\em overwrite}]If {\tt true}, any existing file will be overwritten. \item[{\em resume}]\end{description}
\end{Desc}


Definition at line 1536 of file job.cpp.\index{KIO@{KIO}!file_delete@{file\_\-delete}}
\index{file_delete@{file\_\-delete}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Simple\-Job} $\ast$ KIO::file\_\-delete (const {\bf KURL} \& {\em src}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a212}


Delete a single file. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]File to delete. \end{description}
\end{Desc}


Definition at line 1542 of file job.cpp.\index{KIO@{KIO}!listDir@{listDir}}
\index{listDir@{listDir}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}List\-Job $\ast$ KIO::list\-Dir (const {\bf KURL} \& {\em url}, bool {\em show\-Progress\-Info} = true, bool {\em include\-Hidden} = true)}\label{namespaceKIO_a213}


List the contents of {\tt url}, which is assumed to be a directory. 

\char`\"{}.\char`\"{} and \char`\"{}..\char`\"{} are returned, filter them out if you don't want them.

pass include\-Hidden = false to cull out UNIX hidden files/dirs (whose names start with .) 

Definition at line 1691 of file job.cpp.\index{KIO@{KIO}!listRecursive@{listRecursive}}
\index{listRecursive@{listRecursive}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}List\-Job $\ast$ KIO::list\-Recursive (const {\bf KURL} \& {\em url}, bool {\em show\-Progress\-Info} = true, bool {\em include\-Hidden} = true)}\label{namespaceKIO_a214}


The same as the previous method, but recurses subdirectories. 

\char`\"{}.\char`\"{} and \char`\"{}..\char`\"{} are returned but only for the toplevel directory. Filter them out if you don't want them.

pass include\-Hidden = false to cull out UNIX hidden files/dirs (whose names start with .) 

Definition at line 1697 of file job.cpp.

Referenced by KIO::Delete\-Job::slot\-Result().\index{KIO@{KIO}!copy@{copy}}
\index{copy@{copy}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Copy\-Job $\ast$ KIO::copy (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a215}


Copy a file or directory {\tt src} into the destination , which can be a file (including the final filename) or a directory (into which {\tt src} will be copied). 

This emulates the {\tt cp} command completely. 

Definition at line 2917 of file job.cpp.

References QValue\-List$<$ KURL $>$::append().

Referenced by KFile\-Props\-Plugin::apply\-Changes().\index{KIO@{KIO}!copyAs@{copyAs}}
\index{copyAs@{copyAs}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Copy\-Job $\ast$ KIO::copy\-As (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a216}


Copy a file or directory {\tt src} into the destination , which is the destination name in any case, even for a directory. 

As opposed to {\bf copy}{\rm (p.\,\pageref{namespaceKIO_a215})}, this doesn't emulate {\tt cp}, but is the only way to copy a directory, giving it a new name and getting an error box if a directory already exists with the same name. 

Definition at line 2925 of file job.cpp.

References QValue\-List$<$ KURL $>$::append().\index{KIO@{KIO}!copy@{copy}}
\index{copy@{copy}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Copy\-Job $\ast$ KIO::copy (const {\bf KURL::List} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a217}


Copy a list of file/dirs {\tt src} into a destination directory {\tt dest}. 



Definition at line 2933 of file job.cpp.\index{KIO@{KIO}!move@{move}}
\index{move@{move}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Copy\-Job $\ast$ KIO::move (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a218}


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


Definition at line 2938 of file job.cpp.

References QValue\-List$<$ KURL $>$::append().

Referenced by KFile\-Props\-Plugin::apply\-Changes().\index{KIO@{KIO}!moveAs@{moveAs}}
\index{moveAs@{moveAs}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Copy\-Job $\ast$ KIO::move\-As (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a219}


\begin{Desc}
\item[See also:]{\bf copy\-As}{\rm (p.\,\pageref{namespaceKIO_a216})} \end{Desc}


Definition at line 2945 of file job.cpp.

References QValue\-List$<$ KURL $>$::append().\index{KIO@{KIO}!move@{move}}
\index{move@{move}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Copy\-Job $\ast$ KIO::move (const {\bf KURL::List} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a220}


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


Definition at line 2952 of file job.cpp.\index{KIO@{KIO}!link@{link}}
\index{link@{link}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Copy\-Job $\ast$ KIO::link (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest\-Dir}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a221}


Create a link. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]The existing file or directory, 'target' of the link. \item[{\em dest\-Dir}]Destination directory where the link will be created. If the protocols and hosts are the same, a Unix symlink will be created. Otherwise, a .desktop file of Type Link and pointing to the src URL will be created. \end{description}
\end{Desc}


Definition at line 2957 of file job.cpp.

References QValue\-List$<$ KURL $>$::append().\index{KIO@{KIO}!link@{link}}
\index{link@{link}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Copy\-Job $\ast$ KIO::link (const {\bf KURL::List} \& {\em src}, const {\bf KURL} \& {\em dest\-Dir}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a222}


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


Definition at line 2964 of file job.cpp.\index{KIO@{KIO}!linkAs@{linkAs}}
\index{linkAs@{linkAs}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Copy\-Job $\ast$ KIO::link\-As (const {\bf KURL} \& {\em src}, const {\bf KURL} \& {\em dest}, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a223}


\begin{Desc}
\item[See also:]{\bf link}{\rm (p.\,\pageref{namespaceKIO_a221})} and {\bf copy\-As}{\rm (p.\,\pageref{namespaceKIO_a216})} \end{Desc}


Definition at line 2969 of file job.cpp.

References QValue\-List$<$ KURL $>$::append().\index{KIO@{KIO}!del@{del}}
\index{del@{del}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Delete\-Job} $\ast$ KIO::del (const {\bf KURL} \& {\em src}, bool {\em shred} = false, bool {\em show\-Progress\-Info} = true)}\label{namespaceKIO_a224}


Delete a file or directory. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em src}]file to delete \item[{\em shred}]If {\tt true}, delete in a way that makes recovery impossible (only supported for local files currently) \end{description}
\end{Desc}


Definition at line 3390 of file job.cpp.

References QValue\-List$<$ KURL $>$::append().

Referenced by KDir\-Operator::del().\index{KIO@{KIO}!matchConstraint@{matchConstraint}}
\index{matchConstraint@{matchConstraint}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}int KIO::match\-Constraint (const Parse\-Tree\-Base $\ast$ {\em \_\-tree}, const {\bf KService::Ptr} \&, const {\bf KService\-Type\-Profile::Offer\-List} \&)}\label{namespaceKIO_a226}


\begin{Desc}
\item[Returns:]0 =$>$ Does not match 1 =$>$ Does match $<$0 =$>$ Error \end{Desc}


Definition at line 591 of file ktraderparsetree.cpp.

References match\-Constraint().

Referenced by match\-Constraint(), and KTrader::query().\index{KIO@{KIO}!matchPreferences@{matchPreferences}}
\index{matchPreferences@{matchPreferences}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}Preferences\-Return KIO::match\-Preferences (const Parse\-Tree\-Base $\ast$ {\em \_\-tree}, const {\bf KService::Ptr} \&, const {\bf KService\-Type\-Profile::Offer\-List} \&)}\label{namespaceKIO_a227}


\begin{Desc}
\item[Returns:]1 on success or $<$0 on Error \end{Desc}


Definition at line 612 of file ktraderparsetree.cpp.

References match\-Preferences().

Referenced by match\-Preferences(), and KTrader::query().\index{KIO@{KIO}!fileMetaInfo@{fileMetaInfo}}
\index{fileMetaInfo@{fileMetaInfo}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Meta\-Info\-Job} $\ast$ KIO::file\-Meta\-Info (const {\bf KFile\-Item\-List} \& {\em items})}\label{namespaceKIO_a230}


Retrieves meta information for the given items. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em items}]files to get metainfo for \item[{\em save}]if the data should be cached for later use \item[{\em enabled\-Plugins}]if non-zero, this points to a list containing the names of the plugins that may be used. see available\-Plugins. \end{description}
\end{Desc}


Definition at line 175 of file metainfojob.cpp.\index{KIO@{KIO}!fileMetaInfo@{fileMetaInfo}}
\index{fileMetaInfo@{fileMetaInfo}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Meta\-Info\-Job} $\ast$ KIO::file\-Meta\-Info (const {\bf KURL::List} \& {\em items})}\label{namespaceKIO_a231}


Same as above, but takes a URL list instead of KFile\-Item\-List. 



Definition at line 180 of file metainfojob.cpp.

References QPtr\-List::append(), QValue\-List$<$ KURL $>$::begin(), QValue\-List$<$ KURL $>$::Const\-Iterator(), and QValue\-List$<$ KURL $>$::end().\index{KIO@{KIO}!filePreview@{filePreview}}
\index{filePreview@{filePreview}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Preview\-Job} $\ast$ KIO::file\-Preview (const {\bf KFile\-Item\-List} \& {\em items}, int {\em width}, int {\em height} = 0, int {\em icon\-Size} = 0, int {\em icon\-Alpha} = 70, bool {\em scale} = true, bool {\em save} = true, const {\bf QString\-List} $\ast$ {\em enabled\-Plugins} = 0)}\label{namespaceKIO_a235}


Generates or retrieves a preview image for the given URL. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em items}]files to get previews for \item[{\em width}]the maximum width to use \item[{\em height}]the maximum height to use, if this is 0, the same value as width is used. \item[{\em icon\-Size}]the size of the mimetype icon to overlay over the preview or zero to not overlay an icon. This has no effect if the preview plugin that will be used doesn't use icon overlays. \item[{\em icon\-Alpha}]transparency to use for the icon overlay \item[{\em scale}]if the image is to be scaled to the requested size or returned in its original size \item[{\em save}]if the image should be cached for later use \item[{\em enabled\-Plugins}]if non-zero, this points to a list containing the names of the plugins that may be used. see available\-Plugins. \end{description}
\end{Desc}


Definition at line 494 of file previewjob.cpp.

References KStd\-Accel::save().

Referenced by KFile\-Icon\-View::show\-Previews().\index{KIO@{KIO}!filePreview@{filePreview}}
\index{filePreview@{filePreview}!KIO@{KIO}}
\subsubsection{\setlength{\rightskip}{0pt plus 5cm}{\bf Preview\-Job} $\ast$ KIO::file\-Preview (const {\bf KURL::List} \& {\em items}, int {\em width}, int {\em height} = 0, int {\em icon\-Size} = 0, int {\em icon\-Alpha} = 70, bool {\em scale} = true, bool {\em save} = true, const {\bf QString\-List} $\ast$ {\em enabled\-Plugins} = 0)}\label{namespaceKIO_a236}


Same as above, but takes a URL list instead of KFile\-Item\-List. 



Definition at line 502 of file previewjob.cpp.

References QPtr\-List::append(), QValue\-List$<$ KURL $>$::begin(), QValue\-List$<$ KURL $>$::Const\-Iterator(), QValue\-List$<$ KURL $>$::end(), and KStd\-Accel::save().