Commit | Line | Data |
---|---|---|
15637ed4 | 1 | ** README for file(1) Command ** |
286a6f32 C |
2 | @(#) README,v 1.2 1993/06/10 00:38:01 jtc Exp |
3 | ||
4 | This is Release 3.x of Ian Darwin's (copyright but distributable) | |
5 | file(1) command. Release 3.x is scheduled for inclusion in the | |
6 | 4.4 BSD (Berkeley Software Distribution) of UNIX-like | |
7 | software, and is the standard "file" command for Linux, 386bsd, | |
8 | and other systems. (See "patchlevel.h" for the exact release number). | |
9 | ||
10 | UNIX is a trademark of UNIX System Laboratories. | |
11 | ||
12 | The prime contributor to Release 3.8 was Guy Harris, who put in megachanges | |
13 | including byte-order independance. | |
14 | ||
15 | The prime contributor to Release 3.0 was Christos Zoulas, who put | |
16 | in hundreds of lines of source code changes, including his own | |
17 | ANSIfication of the code (I liked my own ANSIfication better, but | |
18 | his (__P()) is the "Berkeley standard" way of doing it, and I wanted UCB | |
19 | to include the code...), his HP-like "indirection" (a feature of | |
20 | the HP file command, I think), and his mods that finally got the | |
21 | uncompress (-z) mode finished and working. | |
22 | ||
23 | This release has compiled in numerous environments; see PORTING | |
24 | for a list and problems. | |
25 | ||
26 | This fine freeware file(1) follows the USG (System V) model of the file | |
27 | command, rather than the Research (V7) version or the V7-derived 4.[23] | |
28 | Berkeley one. That is, the file /etc/magic contains much of the ritual | |
29 | information that is the source of this program's power. My version | |
30 | knows a little more magic (including tar archives) than System V; the | |
31 | /etc/magic parsing seems to be compatible with the (poorly documented) | |
32 | System V /etc/magic format (with one exception; see the man page). | |
15637ed4 RG |
33 | |
34 | In addition, the /etc/magic file is built from a subdirectory | |
286a6f32 | 35 | for easier(?) maintenance. I will act as a clearinghouse for |
15637ed4 RG |
36 | magic numbers assigned to all sorts of data files that |
37 | are in reasonable circulation. Send your magic numbers, | |
286a6f32 | 38 | in magic(4) format please, to the author, Ian Darwin. |
15637ed4 RG |
39 | |
40 | LEGAL.NOTICE - read this first. | |
41 | README - read this second (you are currently reading this file). | |
42 | PORTING - read this only if the program won't compile. | |
43 | Makefile - read this next, adapt it as needed (particularly | |
44 | the location of the old existing file command and | |
45 | the man page layouts), type "make" to compile, | |
46 | "make try" to try it out against your old version. | |
47 | Expect some diffs, particularly since your original | |
48 | file(1) may not grok the imbedded-space ("\ ") in | |
49 | the current magic file, or may even not use the | |
50 | magic file. | |
51 | apprentice.c - parses /etc/magic to learn magic | |
52 | ascmagic.c - third & last set of tests, based on hardwired assumptions. | |
53 | core - not included in distribution due to mailer limitations. | |
54 | debug.c - includes -c printout routine | |
55 | file.1 - man page for the command | |
56 | magic.4 - man page for the magic file, courtesy Guy Harris. | |
57 | Install as magic.4 on USG and magic.5 on V7 or Berkeley; cf Makefile. | |
58 | file.c - main program | |
59 | file.h - header file | |
60 | fsmagic.c - first set of tests the program runs, based on filesystem info | |
61 | is_tar.c - knows about tarchives (courtesy John Gilmore). | |
62 | magdir - directory of /etc/magic pieces | |
286a6f32 | 63 | magdir/Makefile - ADJUST THIS FOR YOUR CONFIGURATION |
15637ed4 RG |
64 | names.h - header file for ascmagic.c |
65 | softmagic.c - 2nd set of tests, based on /etc/magic | |
66 | strtok.c, getopt.c - in case you them (courtesy of Henry Spencer). | |
67 | strtol.c, strchr.c - in case you need them - public domain. | |
68 | tst - simple test suite, built from tst/Makefile | |
286a6f32 C |
69 | |
70 | Ian Darwin | |
71 | Darwin Open Systems | |
72 | R R 1 | |
73 | Palgrave, Ontario L0N 1P0 | |
74 | Canada | |
75 | ||
76 | E-mail: darwin@cs.toronto.edu | |
77 | ian@sq.com | |
78 | utzoo!ian | |
79 | ian@darwin.uucp | |
80 | uunet!sq!ian | |
81 | ||
82 | Phone: Do not even think of telephoning me about this program. Send cash first! | |
83 | ||
84 | Parts of this software were developed at SoftQuad Inc., 56 Aberfoyle | |
85 | Cres, # 810, Toronto, Ontario CANADA M8X 2W4. Phone: 416-239-4801 or | |
86 | 800-387-2777. Email: mail@sq.com. Call for information on SGML editing | |
87 | and browsing, Unix text processing, and customised products on Unix, | |
88 | DOS and Mac. |