Warning, /frameworks/kded/README.md is written in an unsupported language. File is not indexed.

0001 # KDED
0002 
0003 Central daemon of KDE work spaces
0004 
0005 ## Introduction
0006 
0007 KDED stands for KDE Daemon which isn't very descriptive.
0008 KDED runs in the background and performs a number of small tasks.
0009 Some of these tasks are built in, others are started on demand.
0010 
0011 ### Built in tasks
0012 
0013 * Checking for newly installed software and updating ksycoca when new
0014   software is detected. Updating of ksycoca is done by the program kbuildsycoca
0015   which gets started by kded. When kded is first started it always runs
0016   kbuildsycoca to ensure that ksycoca is up to date.
0017 
0018 * Checking for newly installed update files. Applications can install
0019   \*.upd update files. These \*.upd files are used to update configuration files
0020   of users, primarily when new versions of applications are installed with
0021   (slightly) different configuration file formats. Updating of configuration
0022   files is done by kconf\_update. kded starts kconf\_update when it detects a
0023   new update file. When kded is first started it always runs kconf\_update to
0024   ensure that it has not missed any update files. kconf\_update keeps track
0025   of which update files have been processed already in the config-file
0026   kconf\_updaterc. It only performs a certain update once.
0027 
0028 ### Configuration of built in tasks.
0029 
0030 The built in tasks have some configuration options that can be changed by
0031 editing the kdedrc configuration file. Changes need to be made with a text
0032 editor, there is no GUI available. All options are listed under the [General]
0033 group:
0034 
0035 **HostnamePollInterval**: This can be used to adjust the time interval at which
0036 the hostname is checked for changes. The time is specified in milliseconds
0037 and has a default of 5000 (5 seconds).
0038 
0039 **CheckSycoca**: This option can be used to disable checking for new software.
0040 ksycoca will still be built when kded starts up and when applications
0041 explicitly request a rebuild of the ksycoca database. The user can
0042 also manually rebuild ksycoca by running the kbuildsycoca program.
0043 The default value of this option is "true". Checking can be disabled by
0044 setting this option to "false".
0045 
0046 **CheckUpdates**: This option can be used to disable checking for update files.
0047 kconf\_update will still be run when kded starts up.
0048 The default value of this option is "true". Checking can be disabled by
0049 setting this option to "false".
0050 
0051 **CheckHostname**: This option can be used to disable checking for hostname
0052 changes. The default value of this option is "true". Checking can be
0053 disabled by setting this option to "false".
0054 
0055 Example kdedrc file with default values:
0056 
0057     [General]
0058     HostnamePollInterval=5000
0059     CheckSycoca=true
0060     CheckUpdates=true
0061     CheckHostname=true
0062     CheckFileStamps=true
0063     DelayedCheck=false
0064 
0065 If FAM or DNOTIFY is not available, the filesystem will be polled at regular interval for any changes. Under the [DirWatch] group in the kdeglobals file
0066 the following options are available to adjust the polling frequency:
0067 
0068 **PollInterval**: This can be used to adjust the time interval at which the local
0069 filesystem is checked for new software or update files. The time is specified
0070 in milliseconds and has a default of 500 (0.5 seconds).
0071 
0072 **NFSPollInterval**: This can be used to adjust the time interval at which remote
0073 filesystems, such as NFS or Samba, are ebing checked for new software or
0074 update files. The time is specified in milliseconds and has a default of 5000
0075 (5 seconds).
0076 
0077 The above options are not used when FAM is used to watch for changes in the
0078 filesystem, or when DNOTIFY is used. Specifying larger intervals may reduce
0079 the CPU load and/or network traffic. Shorter intervals are not recommended.
0080 
0081 Please note that in previous versions of KDE these options where listed in
0082 the kderc file.
0083 
0084 Example kdeglobals fragment:
0085 
0086     [DirWatch]
0087     PollInterval=500
0088     NFSPollInterval=5000
0089 
0090 ### KDED modules
0091 
0092 Some things can be greatly simplified if they can be coordinated from a
0093 central place. KDED has support for modules that will be demand-loaded
0094 whenever an application attempts to make DBus call to the module.
0095 This can be useful for central administration tasks.
0096 
0097 See docs/HOWTO.