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 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)