version 1.2, 1996/06/26 05:32:53 |
version 1.3, 2006/07/18 15:08:27 |
|
|
@(#) $OpenBSD$ |
@(#) $OpenBSD$ |
** README for file(1) Command ** |
** README for file(1) Command ** |
|
|
This is Release 3.x of Ian Darwin's (copyright but distributable) |
This is Release 4.x of Ian Darwin's (copyright but distributable) |
file(1) command. Release 3.x is scheduled for inclusion in the |
file(1) command. This version is the standard "file" command for Linux, |
4.4 BSD (Berkeley Software Distribution) of UNIX-like |
*BSD, and other systems. (See "patchlevel.h" for the exact release number). |
software, and is the standard "file" command for Linux, 386bsd, |
|
and other systems. (See "patchlevel.h" for the exact release number). |
|
|
|
|
The major feature of 4.x is the refactoring of the code into a library, |
|
and the re-write of the file command in terms of that library. The library |
|
itself, libmagic can be used by 3rd party programs that wish to identify |
|
file types without having to fork() and exec() file. The prime contributor |
|
for 4.0 was M\xe5ns Rullg\xe5rd. |
|
|
UNIX is a trademark of UNIX System Laboratories. |
UNIX is a trademark of UNIX System Laboratories. |
|
|
The prime contributor to Release 3.8 was Guy Harris, who put in megachanges |
The prime contributor to Release 3.8 was Guy Harris, who put in megachanges |
including byte-order independance. |
including byte-order independence. |
|
|
The prime contributor to Release 3.0 was Christos Zoulas, who put |
The prime contributor to Release 3.0 was Christos Zoulas, who put |
in hundreds of lines of source code changes, including his own |
in hundreds of lines of source code changes, including his own |
|
|
for easier(?) maintenance. I will act as a clearinghouse for |
for easier(?) maintenance. I will act as a clearinghouse for |
magic numbers assigned to all sorts of data files that |
magic numbers assigned to all sorts of data files that |
are in reasonable circulation. Send your magic numbers, |
are in reasonable circulation. Send your magic numbers, |
in magic(4) format please, to the maintainer, Christos Zoulas. |
in magic(5) format please, to the maintainer, Christos Zoulas. |
|
|
LEGAL.NOTICE - read this first. |
LEGAL.NOTICE - read this first. |
README - read this second (you are currently reading this file). |
README - read this second (you are currently reading this file). |
|
|
the man page layouts), type "make" to compile, |
the man page layouts), type "make" to compile, |
"make try" to try it out against your old version. |
"make try" to try it out against your old version. |
Expect some diffs, particularly since your original |
Expect some diffs, particularly since your original |
file(1) may not grok the imbedded-space ("\ ") in |
file(1) may not grok the embedded-space ("\ ") in |
the current magic file, or may even not use the |
the current magic file, or may even not use the |
magic file. |
magic file. |
apprentice.c - parses /etc/magic to learn magic |
apprentice.c - parses /etc/magic to learn magic |
|
|
file.c - main program |
file.c - main program |
file.h - header file |
file.h - header file |
fsmagic.c - first set of tests the program runs, based on filesystem info |
fsmagic.c - first set of tests the program runs, based on filesystem info |
is_tar.c - knows about tarchives (courtesy John Gilmore). |
is_tar.c, tar.h - knows about tarchives (courtesy John Gilmore). |
magdir - directory of /etc/magic pieces |
magdir - directory of /etc/magic pieces |
magdir/Makefile - ADJUST THIS FOR YOUR CONFIGURATION |
magdir/Makefile - ADJUST THIS FOR YOUR CONFIGURATION |
names.h - header file for ascmagic.c |
names.h - header file for ascmagic.c |
softmagic.c - 2nd set of tests, based on /etc/magic |
softmagic.c - 2nd set of tests, based on /etc/magic |
strtok.c, getopt.c - in case you them (courtesy of Henry Spencer). |
readelf.[ch] - Stand-alone elf parsing code. |
strtol.c, strchr.c - in case you need them - public domain. |
compress.c - on-the-fly decompression. |
tst - simple test suite, built from tst/Makefile |
print.c - print results, errors, warnings. |
|
|
|
If your gzip sometimes fails to decompress things complaining about a short |
|
file, apply this patch [which is going to be in the next version of gzip]: |
|
*** - Tue Oct 29 02:06:35 1996 |
|
--- util.c Sun Jul 21 21:51:38 1996 |
|
*** 106,111 **** |
|
--- 108,114 ---- |
|
|
|
if (insize == 0) { |
|
if (eof_ok) return EOF; |
|
+ flush_window(); |
|
read_error(); |
|
} |
|
bytes_in += (ulg)insize; |
|
|
E-mail: christos@deshaw.com, moraes@deshaw.com |
E-mail: christos@astron.com |
|
|
Phone: Do not even think of telephoning me about this program. Send cash first! |
Phone: Do not even think of telephoning me about this program. Send cash first! |
|
|
Parts of this software were developed at SoftQuad Inc., 56 Aberfoyle |
Parts of this software were developed at the University of Toronto Computing Services |
Cres, # 810, Toronto, Ontario CANADA M8X 2W4. Phone: 416-239-4801 or |
and at SoftQuad Inc., developers of SGML/HTML/XML publishing software, in Toronto, Canada. |
800-387-2777. Email: mail@sq.com. Call for information on SGML editing |
SoftQuad was swallowed up by Corel in 2002 and does not exist any longer. |
and browsing, Unix text processing, and customised products on Unix, |
|
DOS and Mac. |
Kees Zeelenberg reports that an MS-Windows (Win32) port of file(1) |
|
is available from http://gnuwin32.sourceforge.net/ |