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 processing 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 number, 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)