# KDiskFree - KwikDisk - Help

Michael
Kropfberger

    michael.kropfberger@gmx.net

17/03/1999
1.00.00

This handbook describes &kdf; version 1.0

KDE
disk free
kdf
df
mount
mounted
disk
disk space
free disk space
unmounted
unmount

## KwikDisk

KwikDisk docks itself into the Panel and when you click on it, it shows you all mountpoints, icons and the free disk space (if the device is mounted). When you select a mountpoint it tries to mount this as described in section (U)Mount Commands. You may also start a KDiskFree from the menu there.

## KdiskFree

KDiskFree provides you a graphical overview on your block devices (disks, partitions, floppy-drive...) and their usage. It reads the file /etc/fstab to get information about possibly mounted devices and then periodically calls the df-command to look at actually mounted devices. Unmounted devices are shown in lightgray.

You may invoke KDiskFree ("kcmdf") from your KControlCenter under Information/Block Devices or directly by typing "kdf". "kdf" is more light-weighted in the screen-size used, so if you want to always have a KDiskFree open (as I do) try "kdf" instead of "kcmdf".

KDiskFree was written 1998 by Michael Kropfberger and underlies the terms of GPL.

### Overview

There are following columns which are shown in KDiskfree:

Icon

  shows icon for the actual device/mountpoint combination

Device

  shows the filename of the listed device

Type

  shows the filesystem-type of the listed device (e.g. ext2, msdos, vfat, minix...)

Size

  shows the maximum size of the device

MountPoint

  shows you, where the device is mounted to

Free

  shows you, how many Bytes (rounded to Gigabytes, Megabytes, Kilobytes for convenience) are really available

Full &percnt;

  indicates the percentage of fullness; if this exceeds 95&percnt;, the whole device entry is printed out in red and a warning message pops up on the active desktop.

UsageBar

  shows you the space-usage in a graphical way (blue = full, white= available)

### Features

There are also many usable features included:

- left-, double-, mid- or right-click on the devicename of the device of your interest to mount/unmount it immediately. This invokes the given mountscript for the device/mountpoint or calls the default "mount" command (see (U)Mount Commands).

- left-, double-, mid- or right-click on the MountPoint of the device of your interest to open a FileManager (e.g. kfm) with the mountpoint as starting directory

- you may also disable some of the columns you don't want to see (look at General Settings for further information)

- click on the Headers of the TabList to sort the devices accordingly

### General Settings

If you click on the Settings-Button you enroll a more-featured settings-window. Primarily you may want to change the update-frequency of KDiskFree. Just use the scrollBar to select the appropriate frequency. If you want to DISABLE the auto-update-feature, you only have to select 0 as your update-frequency. To force an update, just press the Apply-Button.

There you can enable/disable the shown columns of your device-Overview. If you don't want to see the Filesystem-Type (which maybe is not of that interest to you, because it doesn't change every five seconds) you may just click on the Type-Header in your settings-window, so the checked-icon under Type changes to a crossed-out-icon. To enable it, just press the Type-Header again and the crossed-out-icon becomes a checked-icon. For convenience, you may also double-, mid- or right-click on the icons to get the same effect.

There is also a LineEdit to enter the preferred FileManager used when you click on the mountpoint of a device. The &percnt;m will be substituted with the actual mountpoint.

To reset all to the default values, just click on the Defaults-Button

### (U)Mount Commands

In this Tab you can edit mount commands for every device/mountpoint pair. This is eg. useful for zip-drives which need a root-called `insmod ppa` before mounting is possible. You could write a little script like this to do that:

    #!/bin/bash
    kdesu -c insmod ppa
    mount /zip

and store it in `/usr/local/bin/mount&lowbar;zip`. Now you can use this script when you click on the device `/zip`. Possible parameters are:

&percnt;d | Device Name
&percnt;m | Mount Point
&percnt;t | Filesystem Type
&percnt;o | Mount Options

If no mount command is given, a default `"mount &percnt;d"` is used instead. If you are root the default command is `"mount -t&percnt;t &percnt;d &percnt;m -o &percnt;o"`.

### Icons

If the user doesn't set a specific Icon in (U)Mount Commands settings dialog, a special magic is tried. So a device /dev/fd0 or mountpoint /floppy gets a floppy icon assigned. Also NFS mounts are recognized and a special icon is shown. Every device/mountpoint can be mounted (green button in the buttom right) and if it is only (u)mountable by root, the icon gets a red frame around it. If the user gives his own icon, there are a few important things to keep in mind: all filenames for icons have to look like this: `myicon&lowbar;mount.xpm` and `myicon&lowbar;unmount.xpm` because only `myicon` is stored and the rest is appended. The files should be in the mini-icon directory (this is `$KDEDIR/share/icons/mini` or `$HOME/.kde/share/icons/mini`).

### Comments ...

Comments to Michael Kropfberger michael.kropfberger@gmx.net. Last changed: 17. March 1999