# The &kdf; Handbook

Jonathan
Singer

    jsinger@leeta.net

Michael
Kropfberger

    michael.kropfberger@gmx.net

Lauri
Watts
Reviewer
2000
Jonathan Singer
&FDLNotice;
2001-07-06
0.00.50

&kdf; displays available file devices, along with information about them.

KDE
kdf
kdeutils
disks
devices
mount
unmount

## Introduction

&kdf; displays the available file devices (hard drive partitions, floppy and &CD; drives, etc.) along with information on their capacity, free space, type and mount point. It also allows you to mount and unmount drives and view them in a file manager.

&kdf; is similar to the &kcontrol; DiskFree module (kcmdf), but takes up less screen space. It is useful if you want to keep a DiskFree window available at all times.

## Using &kdf;

### Starting &kdf;

Type ``kdf`` at a command prompt or select Disk Free from the System group in the KDE start menu. The standard &Qt; and KDE command options are available, and can be listed by entering ``kdf` `--help`` at the command prompt.

### The Main window

The main &kdf; window displays the available file devices.

Normally, the following pieces of information are included:

&kdf; Screen
&kdf; Screen

- an icon depicting the type of storage

- device name

- filesystem type

- total size

- mount point

- free disk space

- the percentage of space used as a number and as a graph.

In the picture above, four devices are shown: two ext2-formatted hard drive partitions, one mounted at the filesystem root (`/`) and one at `/old`, a mounted iso9660 &CD-ROM; and an unmounted floppy drive.

Left clicking on the header of a particular column sorts the devices according to that variable. A second left click sorts in the opposite order.

Clicking on a row pops up a menu. If that device is not currently mounted, the Mount device option is available. If the device is mounted, it can be unmounted by choosing Unmount device. Selecting Open filemanager opens a new window with a graphical view of the files on that device.

### The &kdf; menubar

#### The File Menu

File Update

  Immediately updates the display to reflect the current status

Ctrl Q File Quit

  Closes &kdf;

#### The Options menu and dialog

Options Configure KDiskFree

  Opens a configuration dialog.

  Configure &kdf; Screen
  Configure &kdf; Screen

  This dialog has two tabbed windows, General Settings and Mount Commands

  General Settings

    Click on the word visible or hidden to turn display of an data field on or off.

    Change Update frequency by moving the slider. The value in the box on the left is the interval (in seconds) between updates of the &kdf; display to reflect the current status.

    The FileManager setting controls the command executed when the Open filemanager pop-up menu item is selected.

    There are also two checkboxes. One controls if a filemanager window will be automatically opened when a device is mounted. The other causes an alert window to pop up if a disk gets critically full.

  Mount Commands

    Allows the user to specify the mount and unmount commands for a given device, as well as the icon used to represent it. More information on these commands can be found on the man page for mount (type ``man` `mount`` at the command prompt).

#### The Help menu

F1 Help Contents

  Opens this document

Shift F1 Help What's This?...

  Select this and click on items to learn more about them

Help Report Bug

  A convenient dialog for reporting bugs in &kdf;

Help About KDiskFree...

  Provides information about &kdf;

Help About KDE...

  Provides information about the KDE project.

## Credits and License

&kdf;

Program copyright 1998-2000 Michael Kropfberger mkropfbe@edu.uni-klu.ac.at

Documentation copyright 2000 Jonathan Singer jsinger@leeta.net

&underFDL; &underGPL;

## Installation

### How to obtain and install &kdf;

&kdf; is part of the KDE project http://www.kde.org, and should be compiled and installed as indicated in the package's main directory. New versions of &kdf; can be found in the kdeutils package on ftp://ftp.kde.org/pub/kde/, the main ftp site of the KDE project.

To build kdf:

    % ./configure
    % make
    % su
    % make install

&documentation.index;