namespace KIO

Public Types

• class AuthInfo
• class NetRC
• struct ChmodInfo
• class ChmodJob
• struct Task
• class Connection
• enum Error { ERR_CANNOT_OPEN_FOR_READING = 1, ERR_CANNOT_OPEN_FOR_WRITING = 2, ERR_CANNOT_LAUNCH_PROCESS = 3, ERR_INTERNAL = 4, ERR_MALFORMED_URL = 5, ERR_UNSUPPORTED_PROTOCOL = 6, ERR_NO_SOURCE_PROTOCOL = 7, ERR_UNSUPPORTED_ACTION = 8, ERR_IS_DIRECTORY = 9, ERR_IS_FILE = 10, ERR_DOES_NOT_EXIST = 11, ERR_FILE_ALREADY_EXIST = 12, ERR_DIR_ALREADY_EXIST = 13, ERR_UNKNOWN_HOST = 14, ERR_ACCESS_DENIED = 15, ERR_WRITE_ACCESS_DENIED = 16, ERR_CANNOT_ENTER_DIRECTORY = 17, ERR_PROTOCOL_IS_NOT_A_FILESYSTEM = 18, ERR_CYCLIC_LINK = 19, ERR_USER_CANCELED = 20, ERR_CYCLIC_COPY = 21, ERR_COULD_NOT_CREATE_SOCKET = 22, ERR_COULD_NOT_CONNECT = 23, ERR_CONNECTION_BROKEN = 24, ERR_NOT_FILTER_PROTOCOL = 25, ERR_COULD_NOT_MOUNT = 26, ERR_COULD_NOT_UNMOUNT = 27, ERR_COULD_NOT_READ = 28, ERR_COULD_NOT_WRITE = 29, ERR_COULD_NOT_BIND = 30, ERR_COULD_NOT_LISTEN = 31, ERR_COULD_NOT_ACCEPT = 32, ERR_COULD_NOT_LOGIN = 33, ERR_COULD_NOT_STAT = 34, ERR_COULD_NOT_CLOSEDIR = 35, ERR_COULD_NOT_MKDIR = 37, ERR_COULD_NOT_RMDIR = 38, ERR_CANNOT_RESUME = 39, ERR_CANNOT_RENAME = 40, ERR_CANNOT_CHMOD = 41, ERR_CANNOT_DELETE = 42, ERR_SLAVE_DIED = 43, ERR_OUT_OF_MEMORY = 44, ERR_UNKNOWN_PROXY_HOST = 45, ERR_COULD_NOT_AUTHENTICATE = 46, ERR_ABORTED = 47, ERR_INTERNAL_SERVER = 48, ERR_SERVER_TIMEOUT = 49, ERR_SERVICE_NOT_AVAILABLE = 50, ERR_UNKNOWN = 51, ERR_UNKNOWN_INTERRUPT = 53, ERR_CANNOT_DELETE_ORIGINAL = 54, ERR_CANNOT_DELETE_PARTIAL = 55, ERR_CANNOT_RENAME_ORIGINAL = 56, ERR_CANNOT_RENAME_PARTIAL = 57, ERR_NEED_PASSWD = 58, ERR_CANNOT_SYMLINK = 59, ERR_NO_CONTENT = 60, ERR_DISK_FULL = 61, ERR_IDENTICAL_FILES = 62 }
• enum UDSAtomTypes { UDS_STRING = 1, UDS_LONG = 2, UDS_TIME = 4 | UDS_LONG, UDS_SIZE = 8 | UDS_LONG, UDS_USER = 16 | UDS_STRING, UDS_GROUP = 32 | UDS_STRING, UDS_NAME = 64 | UDS_STRING, UDS_ACCESS = 128 | UDS_LONG, UDS_MODIFICATION_TIME = 256 | UDS_TIME, UDS_ACCESS_TIME = 512 | UDS_TIME, UDS_CREATION_TIME = 1024 | UDS_TIME, UDS_FILE_TYPE = 2048 | UDS_LONG, UDS_LINK_DEST = 4096 | UDS_STRING, UDS_URL = 8192 | UDS_STRING, UDS_MIME_TYPE = 16384 | UDS_STRING, UDS_GUESSED_MIME_TYPE = 16392 | UDS_STRING }
• enum CacheControl { CC_CacheOnly, CC_Cache, CC_Verify, CC_Reload }
• class UDSAtom
• typedef QValueList UDSEntry
• typedef QValueList UDSEntryList
• typedef QValueListIterator UDSEntryListIterator
• typedef QValueListConstIterator UDSEntryListConstIterator
• class MetaData
• class CacheInfo
• class Slave
• class SlaveInterface
• class Job
• class SimpleJob
• class StatJob
• class TransferJob
• class MimetypeJob
• class FileCopyJob
• class ListJob
• struct CopyInfo
• class CopyJob
• class DeleteJob
• class NetAccess
• class PasswordDialog
• class PreviewJob
• enum Progress { DEFAULT = 1, STATUSBAR = 2, LIST = 3 }
• enum RenameDlg_Mode { M_OVERWRITE = 1, M_OVERWRITE_ITSELF = 2, M_SKIP = 4, M_SINGLE = 8, M_MULTI = 16, M_RESUME = 32, M_NORENAME = 64 }
• enum RenameDlg_Result { R_RESUME = 6, R_RESUME_ALL = 7, R_OVERWRITE = 4, R_OVERWRITE_ALL = 5, R_SKIP = 2, R_AUTO_SKIP = 3, R_RENAME = 1, R_CANCEL = 0 }
• class RenameDlg
• class SlaveConfig
• class SessionData
• class Scheduler
• enum SkipDlg_Result { S_SKIP = 1, S_AUTO_SKIP = 2, S_CANCEL = 0 }
• class SkipDlg
• class SlaveBase
• enum Command { CMD_HOST = '0', CMD_CONNECT = '1', CMD_DISCONNECT = '2', CMD_SLAVE_STATUS = '3', CMD_SLAVE_CONNECT = '4', CMD_NONE = 'A', CMD_TESTDIR = 'B', CMD_GET = 'C', CMD_PUT = 'D', CMD_STAT = 'E', CMD_MIMETYPE = 'F', CMD_LISTDIR = 'G', CMD_MKDIR = 'H', CMD_RENAME = 'I', CMD_COPY = 'J', CMD_DEL = 'K', CMD_CHMOD = 'L', CMD_SPECIAL = 'M', CMD_USERPASS = 'N', CMD_REPARSECONFIGURATION = 'O', CMD_META_DATA = 'P', CMD_SYMLINK = 'Q', CMD_SUBURL = 'R', CMD_MESSAGEBOXANSWER = 'S', CMD_RESUMEANSWER = 'T', CMD_CONFIG = 'U' }
• enum Info { INF_TOTAL_SIZE = 10, INF_PROCESSED_SIZE = 11, INF_SPEED, INF_REDIRECTION = 20, INF_MIME_TYPE, INF_ERROR_PAGE, INF_WARNING, INF_GETTING_FILE, INF_NEED_PASSWD, INF_INFOMESSAGE, INF_META_DATA, INF_NETWORK_STATUS, INF_MESSAGEBOX }
• enum Message { MSG_DATA = 100, MSG_DATA_REQ, MSG_ERROR, MSG_CONNECTED, MSG_FINISHED, MSG_STAT_ENTRY, MSG_LIST_ENTRIES, MSG_RENAMED, MSG_RESUME, MSG_SLAVE_STATUS, MSG_SLAVE_ACK, MSG_NET_REQUEST, MSG_NET_DROP, MSG_NEED_SUBURL_DATA, MSG_CANRESUME, MSG_AUTH_KEY, MSG_DEL_AUTH_KEY }
• class TCPSlaveBase

Public Methods

• QDataStream&  operator<< (QDataStream& s, const AuthInfo& a)
• QDataStream&  operator>> (QDataStream& s, AuthInfo& a)
• ChmodJob *  chmod ( const KFileItemList& lstItems, int permissions, int mask, QString newOwner, QString newGroup, bool recursive, bool showProgressInfo = true )
• QString  convertSize ( unsigned long size )
• QString  convertSize64 ( long long size )
• QString  convertSizeFromKB ( unsigned long kbSize )
• QTime  calculateRemaining ( unsigned long totalSize, unsigned long processedSize, unsigned long speed )
• QString  itemsSummaryString (uint items, uint files, uint dirs, unsigned long size, bool showSize)
• QString  itemsSummaryString64 (uint items, uint files, uint dirs, long long size, bool showSize)
• QString  encodeFileName ( const QString & str )
• QString  decodeFileName ( const QString & str )
• KIO::CacheControl  parseCacheControl (const QString &cacheControl)
• QString  getCacheControlString (KIO::CacheControl cacheControl)
• QString  findDeviceMountPoint ( const QString& device )
• QString  findPathMountPoint ( const QString & filename )
• bool  probably_slow_mounted (const QString& filename)
• SimpleJob *  mkdir ( const KURL& url, int permissions = -1 )
• SimpleJob *  rmdir ( const KURL& url )
• SimpleJob *  chmod ( const KURL& url, int permissions )
• SimpleJob *  rename ( const KURL& src, const KURL & dest, bool overwrite )
• SimpleJob *  symlink ( const QString & target, const KURL& dest, bool overwrite, bool showProgressInfo = true )
• SimpleJob *  special ( const KURL& url, const QByteArray & data, bool showProgressInfo = true )
• SimpleJob * mount ( bool ro, const char *fstype, const QString& dev, const QString& point, bool showProgressInfo = true )
• SimpleJob * unmount ( const QString & point, bool showProgressInfo = true )
• SimpleJob * http_update_cache ( const KURL& url, bool no_cache, time_t expireDate)
• CacheInfo*  getCacheInfo (const KURL& url)
• StatJob *  stat ( const KURL& url, bool showProgressInfo = true )
• StatJob *  stat ( const KURL& url, bool sideIsSource, short int details, bool showProgressInfo = true )
• TransferJob * get ( const KURL& url, bool reload=false, bool showProgressInfo = true )
• TransferJob * put ( const KURL& url, int permissions, bool overwrite, bool resume, bool showProgressInfo = true )
• TransferJob * http_post ( const KURL& url, const QByteArray &postData, bool showProgressInfo = true )
• MimetypeJob *  mimetype ( const KURL& url, bool showProgressInfo = true )
• FileCopyJob * file_copy ( const KURL& src, const KURL& dest, int permissions=-1, bool overwrite=false, bool resume=false, bool showProgressInfo = true)
• FileCopyJob * file_move ( const KURL& src, const KURL& dest, int permissions=-1, bool overwrite=false, bool resume=false, bool showProgressInfo = true)
• SimpleJob * file_delete ( const KURL& src, bool showProgressInfo = true)
• ListJob * listDir ( const KURL& url, bool showProgressInfo = true )
• ListJob * listRecursive ( const KURL& url, bool showProgressInfo = true )
• CopyJob * copy ( const KURL& src, const KURL& dest, bool showProgressInfo = true )
• CopyJob * copyAs ( const KURL& src, const KURL& dest, bool showProgressInfo = true )
• CopyJob * copy ( const KURL::List& src, const KURL& dest, bool showProgressInfo = true )
• CopyJob * move ( const KURL& src, const KURL& dest, bool showProgressInfo = true )
• CopyJob * moveAs ( const KURL& src, const KURL& dest, bool showProgressInfo = true )
• CopyJob * move ( const KURL::List& src, const KURL& dest, bool showProgressInfo = true )
• CopyJob * link ( const KURL& src, const KURL& destDir, bool showProgressInfo = true )
• CopyJob * link ( const KURL::List& src, const KURL& destDir, bool showProgressInfo = true )
• CopyJob * linkAs ( const KURL& src, const KURL& dest, bool showProgressInfo = true )
• DeleteJob * del ( const KURL& src, bool shred = false, bool showProgressInfo = true )
• DeleteJob * del ( const KURL::List& src, bool shred = false, bool showProgressInfo = true )
• Job * pasteClipboard ( const KURL& _dest_url, bool move = false )
• void  pasteData ( const KURL& _dest_url, const QByteArray& _data )
• bool  isClipboardEmpty ()
• PreviewJob * filePreview ( const KFileItemList &items, int width, int height = 0, int iconSize = 0, int iconAlpha = 70, bool scale = true, bool save = true, const QStringList *enabledPlugins = 0 )
• PreviewJob * filePreview ( const KURL::List &items, int width, int height = 0, int iconSize = 0, int iconAlpha = 70, bool scale = true, bool save = true, const QStringList *enabledPlugins = 0 )
• RenameDlg_Result  open_RenameDlg ( const QString & caption, const QString& src, const QString & dest, RenameDlg_Mode mode, QString& newDestPath, unsigned long sizeSrc = (unsigned long) -1, unsigned long sizeDest = (unsigned long) -1, time_t ctimeSrc = (time_t) -1, time_t ctimeDest = (time_t) -1, time_t mtimeSrc = (time_t) -1, time_t mtimeDest = (time_t) -1 )
• SkipDlg_Result  open_SkipDlg ( bool _multi, const QString& _error_text = QString::null )

Public Members

• Forward SlaveList
• Forward SlaveBasePrivate
• Forward SlaveConfigPrivate
• Forward SlaveInterfacePrivate

Detailed Description

This variable controls whether the dialog should be deleted or only cleaned when the KIO::Job is finished ( or canceled ).

If your dialog is embedded widget and not a separate window, you should set this variable to true in the constructor of your custom dialog.

If true - Dialog will only call method slotClean. If false - Dialog will be deleted.

Flag to indicate the persistence of the given password.

This is a two-way flag when set before calling openPassDlg makes the "keep Password" check box will visible to the user. In return the flag will indicate the state of the check box. By default if the flag is checked the password will be cached for the entire life of the current KDE session otherwise the cached password is deleted right after the application using it has been closed.

This class provides an interface for parsing

This job changes permissions on a list of files or directories, optionally in a recursive manner.

Change permissions/ownership on several files or directories, optionally recursively. This version of chmod uses a KFileItemList so that it directly knows what to do with the items. TODO: a version that takes a KURL::List, and a general job that stats each url and returns a KFileItemList.

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

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

Parameters:

lstItems	The file items representing several files or directories.
permissions	the permissions we want to set
mask	the bits we are allowed to change For instance, if mask is 0077, we don't change the "user" bits, only "group" and "others".
newOwner	If non-empty, the new owner for the files
newGroup	If non-empty, the new group for the files
recursive	whether to open directories recursively

Returns: The job handling the operation.

This class provides a simple means for IPC between two applications via a pipe. It handles a queue of commands to be sent, and has a internal signal called after a command has been sent, to send the next one (FIFO).

Convert size from bytes to the string representation.

Parameters:

size	size in bytes

Returns: converted size as a string - e.g. 123.4 kB , 12.0 MB

Convert size from bytes to the string representation.

### KDE 3.0: remove 64 suffix (for now it's needed to not break SC)

Parameters:

size	size in bytes

Returns: converted size as a string - e.g. 123.4 kB , 12.0 MB

Convert size from kilo-bytes to the string representation. Don't use convertSize( size * 1024 ), this easily goes off the 32-bit limit.

### KDE 3.0 : add support for long long

Parameters:

size	size in kilo-bytes

Returns: converted size as a string - e.g. 123.4 kB , 12.0 MB

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

Parameters:

totalSize	total size in bytes
processedSize	processed size in bytes
speed	speed in bytes pre second

Returns: calculated remaining time

Helper for showing information about a set of files and directories items = files + dirs + number of symlinks :)

Parameters:

size	the sum of the size of the _files_
showSize	whether to show the size in the result

Helper for showing information about a set of files and directories items = files + dirs + number of symlinks :)

### KDE 3.0: remove 64 suffix (for now it's needed to not break SC)

Parameters:

size	the sum of the size of the _files_
showSize	whether to show the size in the result

Encode (from the text displayed to the real filename) This translates % into %% and / into %2f Used by KIO::link, for instance.

Decode (from the filename to the text displayed) This translates %2[fF] into / and %% into %

Error codes that can be emitted by KIO.

Constants used to specify the type of a KUDSAtom.

Returns the mount point where device is mounted right now. This means, it has to be mounted, not just defined in fstab.

Returns the mount point on which resides filename. For instance if /home is a separate partition, findPathMountPoint("/home/user/blah") will return /home

checks if the path belongs to a file system that is probably slow. It checks for NFS or for paths belonging to automounted paths not yet mounted

Universal Directory Service

Any file or URL can be represented by the UDSEntry type below A UDSEntry is a list of atoms Each atom contains a specific bit of information for the file

The following UDS constants represent the different possible values for m_uds in the UDS atom structure below

Each atom contains a specific bit of information for the file

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

Creates a single directory.

Parameters:

url	The URL of the directory to create.
permissions	The permissions to set after creating the directory.

Returns: A pointer to the job handling the operation.

Remove a single directory.

The directory is assumed to be empty.

Parameters:

url	The URL of the directory to remove.

Returns: A pointer to the job handling the operation.

Change permissions on a file or directory. See the other chmod below for changing many files or directories.

Parameters:

url	The URL of file or directory.
permissions	The permissions to set.

Returns: The job handling the operation.

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.

Parameters:

src	The original URL
dest	The final URL
overwrite	whether to automatically overwrite if the dest exists

Returns: The job handling the operation.

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 KIO::link for that.

Parameters:

target	The string that will become the "target" of the link (can be relative)
dest	The symlink to create.
overwrite	whether to automatically overwrite if the dest exists

Returns: The job handling the operation.

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

Examples are : HTTP POST, mount and unmount (kio_file)

Parameters:

url	The URL isn't passed to the slave, but is used to know which slave to send it to :-)
data	Packed data. The meaning is completely dependent on the slave, but usually starts with an int for the command number.

Mount filesystem.

Special job for kio_file.

Parameters:

ro	Mount read-only if true.
fstype	File system type (e.g. "ext2", can be 0L).
dev	Device (e.g. /dev/sda0).
point	Mount point, can be null.

Unmount filesystem.

Special job for kio_file.

Parameters:

mount

Point to unmount.

HTTP cache update

Parameters:

url	Url to update, protocol must be "http".
no_cache	If true, cache entry for url is deleted.
expireDate	Local machine time indicating when the entry is supposed to expire.

Parameters:

url	Url to be checked.

Find all details for one file or directory.

Find all details for one file or directory. This version of the call includes two additional booleans, sideIsSource and details.

Parameters:

sideIsSource	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).
details	selects the level of details we want. By default this is 2 (all details wanted, including modification time, size, etc.), setDetails(1) is used when deleting: we don't need all the information if it takes too much time, no need to follow symlinks etc. setDetails(0) is used for very simple probing: we'll only get the answer "it's a file or a directory, or it doesn't exist". This is used by KRun.

Get (a.k.a. read).

The slave emits the data through data().

Put (a.k.a. write)

Parameters:

url	Where to write data.
permissions	May be -1. In this case no special permission mode is set.
overwrite	If true, any existing file will be overwritten.
resume

HTTP POST (for form data).

Example: job = KIO::http_post( url, postData, false ); job->addMetaData("content-type", contentType ); job->addMetaData("referrer", referrerURL);

postData is the data that you want to send and contentType is the format of that data.

You MUST specify content-type!

Often contentType is "application/x-www-form-urlencoded" and the postData is then an ASCII string (without null-termination!) with characters like space, linefeed and percent escaped like %20, %0A and %25.

Parameters:

url	Where to write data.
postData	Encoded data to post.

Find mimetype for one file or directory.

Copy a single file.

Uses either SlaveBase::copy() if the slave supports that or get() and put() otherwise.

Parameters:

src	Where to get the file.
dest	Where to put the file.
permissions	May be -1. In this case no special permission mode is set.
overwrite	If true, any existing file will be overwritten.
resume

Move a single file.

Use either SlaveBase::rename() if the slave supports that, or copy() and del() otherwise, or eventually get() & put() & del()

Parameters:

src	Where to get the file.
dest	Where to put the file.
permissions	May be -1. In this case no special permission mode is set.
overwrite	If true, any existing file will be overwritten.
resume

Delete a single file.

Parameters:

src	File to delete.

List the contents of url, which is assumed to be a directory.

"." and ".." are returned, filter them out if you don't want them.

The same as the previous method, but recurses subdirectories.

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

Copy a file or directory src into the destination @dest, which can be a file (including the final filename) or a directory (into which src will be copied).

This emulates the cp command completely.

Copy a file or directory src into the destination @dest, which is the destination name in any case, even for a directory.

As opposed to copy, this doesn't emulate 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.

Copy a list of file/dirs src into a destination directory dest.

See also: copy

See also: copyAs

See also: copy

Create a link.

Parameters:

src	The existing file or directory, 'target' of the link.
destDir	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.

See also: link

See also: link, and, copyAs

Delete a file or directory.

Parameters:

src	file to delete
shred	If true, delete in a way that makes recovery impossible (only supported for local files currently)

There are two classes that specifies the protocol between application (job) and kioslave. SlaveInterface is the class to use on the application end, SlaveBase is the one to use on the slave end.

A call to foo() results in a call to slotFoo() on the other end.

The base class for all jobs. For all jobs created in an application, the code looks like

   KIO::Job * job = KIO::someoperation( some parameters );
   connect( job, SIGNAL( result( KIO::Job * ) ),
            this, SLOT( slotResult( KIO::Job * ) ) );

(other connects, specific to the job)

And slotResult is usually at least:

  if ( job->error() )
      job->showErrorDialog( this or 0L  );

A simple job (one url and one command). This is the base class for all jobs that are scheduled. Other jobs are high-level jobs (CopyJob, DeleteJob, FileCopyJob...) that manage subjobs but aren't scheduled directly.

The transfer job pumps data into and/or out of a Slave. Data is sent to the slave on request of the slave (dataReq). If data coming from the slave can not be handled, the reading of data from the slave should be suspended.

The FileCopyJob copies data from one place to another.

Net Transparency, formerly provided by kfmlib, but now done with KIO::Jobs.

This class isn't meant to be used as a class but only as a simple namespace for static functions, though an instance of the class is built for internal purposes. Whereas a kiojob is asynchronous, meaning that the developer has to connect slots for it, KIO::NetAccess provides synchronous downloads and uploads, as well as temporary file creation and removal.

Port to kio done by David Faure, faure@kde.org

A dialog for requesting a login and a password from the end user.

KIO-Slave authors are encouraged to use SlaveBase::openPassDlg instead of directly instantiating this dialog.

Generate or retrieve a preview image for the given URL.

Parameters:

items	files to get previews for
width	the maximum width to use
height	the maximum height to use, if this is 0, the same value as width is used.
iconSize	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.
iconAlpha	transparency to use for the icon overlay
scale	if the image is to be scaled to the requested size or returned in its original size
save	if the image should be cached for later use
enabledPlugins	if non-zero, this points to a list containing the names of the plugins that may be used. see PreviewJob::availablePlugins.

Same as above, but takes a URL list instead of KFileItemList

Construct a modal, parent-less "rename" dialog, and return a result code, as well as the new dest. Much easier to use than the class RenameDlg directly.

The following parameters bring optionnal information about src and dest

Parameters:

caption	the caption for the dialog box
src	the file/dir we're trying to copy, as it's part of the text message
dest	the destination file/dir, i.e. the one that already exists
mode	parameters for the dialog (which buttons to show...),
newDest	the new destination path, valid if R_RENAME was returned.
sizeSrc	size of source file
sizeDest	size of destination file
ctimeSrc	creation time of source file
ctimeDest	creation time of destination file
mtimeSrc	modification time of source file
mtimeDest	modification time of destination file

See also: RenameDlg_Mode

SlaveConfig

This class manages the configuration for io-slaves based on protocol and host. The Scheduler makes use of this class to configure the slave whenever it has to connect to a new host.

You only need to use this class if you want to override specific configuration items of an io-slave when the io-slave is used by your application.

Normally io-slaves are being configured by "kio_rc" configuration files. Groups defined in such files are treated as host or domain specification. Configuration items defined in a group are only applied when the slave is connecting with a host that matches with the host and/or domain specified by the group.

This class hanldes static io-slave config information. Static config information are options that rarely change and even when they do they require user intervention. These kinds of options are mostly modifiable by the end user from the control panel and as such do not change as much as per session options, those that can be modified programtically. Some examples of static config information are things such as locale settings, location of caching directories, and state of the cookiejar.

Note that this class is only concerned with KDE configurations that are needed by the io-slaves.

The KIO::Scheduler manages io-slaves for the application. It also queues jobs and assigns the job to a slave when one becomes available.

There are 3 possible ways for a job to get a slave:

1) Direct. This is the default. When you create a job the KIO::Scheduler will be notified and will find either an existing slave that is idle or it will create a new slave for the job.

Example: TransferJob *job = KIO::get(KURL("http://www.kde.org"));

2) Scheduled If you create a lot of jobs, you might want not want to have a slave for each job. If you schedule a job, a maximum number of slaves will be created. When more jobs arrive, they will be queued. When a slave is finished with a job, it will be assigned a job from the queue.

Example: TransferJob *job = KIO::get(KURL("http://www.kde.org")); KIO::Scheduler::scheduleJob(job);

3) Connection Oriented For some operations it is important that multiple jobs use the same connection. This can only be ensured if all these jobs use the same slave.

You can ask the scheduler to open a slave for connection oriented operations. You can then use the scheduler to assign jobs to this slave. The jobs will be queued and the slave will handle these jobs one after the other.

Example: Slave *slave = KIO::Scheduler::getConnectedSlave( KURL("pop3://bastian:password@mail.kde.org")); TransferJob *job1 = KIO::get( KURL("pop3://bastian:password@mail.kde.org/msg1")); KIO::Scheduler::assignJobToSlave(slave, job1); TransferJob *job2 = KIO::get( KURL("pop3://bastian:password@mail.kde.org/msg2")); KIO::Scheduler::assignJobToSlave(slave, job2); TransferJob *job3 = KIO::get( KURL("pop3://bastian:password@mail.kde.org/msg3")); KIO::Scheduler::assignJobToSlave(slave, job3);

... Wait for jobs to finish...

KIO::Scheduler::disconnectSlave(slave);

There are two classes that specifies the protocol between application (job) and kioslave. SlaveInterface is the class to use on the application end, SlaveBase is the one to use on the slave end.

Slave implementations should simply inherit SlaveBase

A call to foo() results in a call to slotFoo() on the other end.

Commands that can be invoked by a job.

Identifiers for KIO informational messages.

Identifiers for KIO data messages.

There are two classes that specifies the protocol between application (job) and kioslave. SlaveInterface is the class to use on the application end, SlaveBase is the one to use on the slave end.

Slave implementations should simply inherit SlaveBase

A call to foo() results in a call to slotFoo() on the other end.