          &dhemail;

&dhfirstname; &dhsurname;
2005
&dhusername;
&dhdate;
&dhucpackage;

&dhsection;

# &dhpackage;

tool to create KDE resources and symlinks to them

          &dhpackage;

          tmp|socket|cache

## DESCRIPTION

This manual page documents briefly the `&dhpackage;` command.

`&dhpackage;` is used to create KDE resources in temporary directories and symlinks to them in `KDEHOME`. The resource that needs to be created is given as an argument and can be anyone of:

- tmp: for the directory used for storing temporary files. This directory should be preferably on a local filesystem (available in KDE 2.x)

- socket: for the directory that holds temporary sockets. This directory needs to be on the local filesystem (available in KDE 2.x)

- cache: for the directory that stores cached information such as the HTTP cache and favicons (available since KDE 3.0)

`&dhpackage;` will create the first two resources in directories under `/tmp` (or `KDETMP` if defined in the environment) and will use `/var/tmp` (or `KDEVARTMP` if defined in the environment) for the cache resource (in order to survive system reboots). The temporary directories created for resources are usually of the form `RESOURCE-USERNAME`. The name might vary if those filenames already exist and do not belong to the user for which `&dhpackage;` is run, a temporary (unique) name will be used if possible to prevent temporary symlink attacks.

`&dhpackage;` is usually called by the `startkde` script.

## EXIT VALUES

`&dhpackage;` will return 0 if it can create the resource and symlink to it, or if the resource already exists and is properly symlinked it will return 1 if it cannot create the link or if the symlink is pointing to an incorrect location.

## SEE ALSO

You can find more information on the KDE's usage of temporary files in the Chapter Temporary and Other Files KDE Uses of the The KDE Administrators Guide.

## AUTHOR

This manual page was written by &dhusername; <&dhemail;> for the &debian; system (but may be used by others). Permission is granted to copy, distribute and/or modify this document under the terms of the &gnu; General Public License, Version 2 or any later version published by the Free Software Foundation.

On Debian systems, the complete text of the GNU General Public License can be found in /usr/share/common-licenses/GPL.