]> granicus.if.org Git - file/commitdiff
Sync with file.man describing the location and format of magic files.
authorChristos Zoulas <christos@zoulas.com>
Tue, 25 Oct 2016 20:33:30 +0000 (20:33 +0000)
committerChristos Zoulas <christos@zoulas.com>
Tue, 25 Oct 2016 20:33:30 +0000 (20:33 +0000)
doc/magic.man

index 040158179cd16d7d7eb8d1f52937390a0a3651d4..837973f368e2578ad84bdc8774564560f7c787ed 100644 (file)
@@ -1,4 +1,4 @@
-.\" $File: magic.man,v 1.87 2016/07/20 11:27:08 christos Exp $
+.\" $File: magic.man,v 1.88 2016/07/27 09:42:49 rrt Exp $
 .Dd July 20, 2016
 .Dt MAGIC __FSECTION__
 .Os
@@ -7,7 +7,7 @@
 .Nm magic
 .Nd file command's magic pattern file
 .Sh DESCRIPTION
-This manual page documents the format of the magic file as
+This manual page documents the format of magic files as
 used by the
 .Xr file __CSECTION__
 command, version __VERSION__.
@@ -17,13 +17,19 @@ command identifies the type of a file using,
 among other tests,
 a test for whether the file contains certain
 .Dq "magic patterns" .
-The file
-.Pa __MAGIC__
-specifies what patterns are to be tested for, what message or
+The database of these
+.Dq "magic patterns"
+is usually located in a binary file in
+.Pa __MAGIC__.mgc
+or a directory of source text magic pattern fragment files in
+.Pa __MAGIC__ .
+The database specifies what patterns are to be tested for, what message or
 MIME type to print if a particular pattern is found,
 and additional information to extract from the file.
 .Pp
-Each line of the file specifies a test to be performed.
+The format of the source fragment files that are used to build this database
+is as follows:
+Each line of a fragment file specifies a test to be performed.
 A test compares the data starting at a particular offset
 in the file with a byte value, a string or a numeric value.
 If the test succeeds, a message is printed.