.TH XFM_DEV 5 "20 April, 2006" "xfm" XFM .\" Copyright (C) 2006, Bernhard R. Link .\" You may distribute under the terms of the GNU General Public .\" License as specified in the file COPYING that comes with xfm. .SH NAME /etc/X11/xfm/xfm_dev \- xfm device configuration .SH DESCRIPTION When starting \fBxfm\fP(1) - the X file and application manager - reads this file to determine mount and umount commands for specific directories. .SH 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. .SH FIELDS .SS 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 \fBGETFSENT\fP, which is described in a special paragraph below. .SS "mount command" The second field is the command to execute for mounting. It is given the shell as one argument after a \fB\-c\fP. .SS "unmount command" The third field is the command to execute for unmounting. It is given the shell as one argument after a \fB\-c\fP. .SS "icon" The fourth field is optional. It is only used to specify an icon for the \BXFM\-DEVICES\fP menu. No icon field is equivalent to an icon field containing \fBdev_disk.xpm\fP, which differs from an empty icon field. (See \fBxfm\fP(5)). .SH "automatic configuration via GETFSENT" If the first field of an entry is the special string \fBGETFSENT\fP, and the systen xfm was compiled on had a \fBfstab.h\fP file, the \fBgetfsent\fP(3) function is used to get mount point information. Every mount point which contains a mount option starting with \fBuser\fP. (like \fBuser\fP, or \fBusers\fP) for which no specification does yet exists is added to the list. .SS "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. .SS "icon field" The icon field can in this case be appended by an arbitrary number of rules of the form .br \fB,\fP\fIfstype\fP\fB=\fP\fIiconname\fP .br If the filesystem has type \fIfstype\fP, the icon \fIiconname\fP is used instead. .SH EXAMPLES .br \fB/media/cdrom:mount /media/cdrom:umount /media/cdrom:cdrom.xpm\fP .br \fB/floppy:mount /floppy:umount /floppy\fP .br \fBGETFSENT:mount:umount:dev_disk.xpm,iso9660=dev_cdrom.xpm,ext2=bla.xpm\fP .SH FILES .TP .IB $HOME /.xfm/xfm_dev Unless otherwise specified in the X resources, this is the first location xfm looks for this file. .TP .B /etc/X11/xfm/xfm_dev Unless otherwise specified in the X resources, this file is tried when the previous could not be read. .TP .B /etc/fstab This is the file \fBgetfsent\fP most likely gets its information from. .SH "SEE ALSO" .BR xfm (1), .BR mount (8), .BR getfsent (3).