DESCRIPTION

When starting xfm(1) - the X file and application manager - reads this file to determine mount and umount commands for specific directories.

FORMAT

One entry per line. Lines starting with a hash (#) and empty lines are ignored. Each line consists out of three or four fields, separated by colons (:). Backslashes and colons within those fields have to be escaped using backslashes.

FIELDS

directory

The first field describes which directory this entry is about. If this this directory or and child directory of this is opened, while no other one is open, the mount command is executed. If the last file window showing this directory or a child thereof, the unmount command is executed.

This field can also be the special string GETFSENT, which is described in a special paragraph below.

mount command

The second field is the command to execute for mounting. It is given the shell as one argument after a -c.

unmount command

The third field is the command to execute for unmounting. It is given the shell as one argument after a -c.

icon

The fourth field is optional. It is only used to specify an icon for the BXFM-DEVICES menu. No icon field is equivalent to an icon field containing dev_disk.xpm, which differs from an empty icon field. (See xfm(5)).

automatic configuration via GETFSENT

If the first field of an entry is the special string GETFSENT, and the systen xfm was compiled on had a fstab.h file, the getfsent(3) function is used to get mount point information.

Every mount point which contains a mount option starting with user. (like user, or users) for which no specification does yet exists is added to the list.

mount and unmount command

These commands are expanded with a space and the directory in question and the result is handled a in the normal case. This needs some fixing with directories containing spaces.

icon field

The icon field can in this case be appended by an arbitrary number of rules of the form
,fstype=iconname
If the filesystem has type fstype, the icon iconname is used instead.

EXAMPLES

/media/cdrom:mount /media/cdrom:umount /media/cdrom:cdrom.xpm
/floppy:mount /floppy:umount /floppy
GETFSENT:mount:umount:dev_disk.xpm,iso9660=dev_cdrom.xpm,ext2=bla.xpm

FILES

$HOME/.xfm/xfm_dev

Unless otherwise specified in the X resources, this is the first location xfm looks for this file.

/etc/X11/xfm/xfm_dev

Unless otherwise specified in the X resources, this file is tried when the previous could not be read.

/etc/fstab

This is the file getfsent most likely gets its information from.