=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/file/Attic/README,v retrieving revision 1.2 retrieving revision 1.3 diff -u -r1.2 -r1.3 --- src/usr.bin/file/Attic/README 1996/06/26 05:32:53 1.2 +++ src/usr.bin/file/Attic/README 2006/07/18 15:08:27 1.3 @@ -1,16 +1,20 @@ -@(#) $OpenBSD: README,v 1.2 1996/06/26 05:32:53 deraadt Exp $ +@(#) $OpenBSD: README,v 1.3 2006/07/18 15:08:27 ian Exp $ ** README for file(1) Command ** -This is Release 3.x of Ian Darwin's (copyright but distributable) -file(1) command. Release 3.x is scheduled for inclusion in the -4.4 BSD (Berkeley Software Distribution) of UNIX-like -software, and is the standard "file" command for Linux, 386bsd, -and other systems. (See "patchlevel.h" for the exact release number). +This is Release 4.x of Ian Darwin's (copyright but distributable) +file(1) command. This version is the standard "file" command for Linux, +*BSD, 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. 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 in hundreds of lines of source code changes, including his own @@ -35,7 +39,7 @@ for easier(?) maintenance. I will act as a clearinghouse for magic numbers assigned to all sorts of data files that 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. README - read this second (you are currently reading this file). @@ -45,7 +49,7 @@ the man page layouts), type "make" to compile, "make try" to try it out against your old version. 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 magic file. apprentice.c - parses /etc/magic to learn magic @@ -58,22 +62,36 @@ file.c - main program file.h - header file 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/Makefile - ADJUST THIS FOR YOUR CONFIGURATION names.h - header file for ascmagic.c softmagic.c - 2nd set of tests, based on /etc/magic -strtok.c, getopt.c - in case you them (courtesy of Henry Spencer). -strtol.c, strchr.c - in case you need them - public domain. -tst - simple test suite, built from tst/Makefile +readelf.[ch] - Stand-alone elf parsing code. +compress.c - on-the-fly decompression. +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! -Parts of this software were developed at SoftQuad Inc., 56 Aberfoyle -Cres, # 810, Toronto, Ontario CANADA M8X 2W4. Phone: 416-239-4801 or -800-387-2777. Email: mail@sq.com. Call for information on SGML editing -and browsing, Unix text processing, and customised products on Unix, -DOS and Mac. +Parts of this software were developed at the University of Toronto Computing Services +and at SoftQuad Inc., developers of SGML/HTML/XML publishing software, in Toronto, Canada. +SoftQuad was swallowed up by Corel in 2002 and does not exist any longer. + +Kees Zeelenberg reports that an MS-Windows (Win32) port of file(1) +is available from http://gnuwin32.sourceforge.net/