XFM_MAGIC(5)								XFM							      XFM_MAGIC(5)

NAME

       xfm_magic - xfm's magic file format

DESCRIPTION

       xfm(1) and xfmtype(1) read files in this format to determine the mime type of a file, which again is used to determine what command to open
       it with.

       The format of the configuration file is the same as the magic(5) with the following additions and differences:

       include: directive
	   If a line starts with include: the rest of the line is treated as filename of another magic file to be read and processed  before  pro-
	   cessing this file continues.

	   Included files can be include files again.  Thus a user specific file can
	   include: /etc/X11/xfm/xfm_magic
	   to get the system wide xfm defaults and this file again
	   include: /usr/share/file/magic.mime
	   to get the system wide system defaults.

       mode type field.
	   Similar  to	long  type,  but  offset is ignored.  The test is performed against the st_mode field of the stat structure obtained using
	   stat(2) system call. This allows testing for directories, fifos ... as well as for file permissions.

       lmode type field.
	   Similar to mode type, but using lstat(2) instead of stat(2). This allows testing for symbolic links.

       regexp type field.
	   The value field must be a proper regular expression. The bytes starting at offset are matched against it. If the match succeeds, then a
	   regsub(3)  is performed on message yielding the final message. If the type field is of the form regexp&nnn where nnn is a positive num-
	   ber, then that number controls the amount of data scanned for the matching, otherwise a compile defined value (currently 256) is used.

       long and short byte order.
	   xfmtype always reads longs and shorts using MSB-first order. This makes configuration files portable to  all  architectures,  but  some
	   entries in original magic(5) files might be wrong.

       Continuation lines.
	   If a line ends with a backslash character (), it is continued with the following line. The maximum length of a line is 1024 characters
	   (counting also characters in continuation lines).

FILES

       $HOME/.xfm/xfm_magic
	      Default location xfm(1) looks for a file of this format.	(Note that xfmtype(1) only reads files specified with -m  on  the  command
	      line.)

       /etc/X11/xfm/xfm_magic
	      System wide default file if there is no user specific one.

SEE ALSO

       xfm(1), xfmtype(1), file(1), magic(5), stat(2), lstat(2).

COPYRIGHT

       Copyright (c) 1995 CNM-US
       Copyright (c) 1995 Juan D. Martin

AUTHOR

       Juan D. Martin (juando@cnm.us.es)
       (but modified heavily by Bernhard R. Link)

xfm								  20 April, 2006						      XFM_MAGIC(5)