home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 11 Util / 11-Util.zip / file39a.zip / src / README < prev    next >
Text File  |  1993-04-05  |  4KB  |  89 lines

  1. ** README for file(1) Command **
  2. @(#) $Id: README,v 1.19 93/04/05 10:18:56 ian 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).
  33.  
  34. In addition, the /etc/magic file is built from a subdirectory
  35. for easier(?) maintenance.  I will act as a clearinghouse for
  36. magic numbers assigned to all sorts of data files that
  37. are in reasonable circulation. Send your magic numbers,
  38. in magic(4) format please, to the author, Ian Darwin.
  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
  63.     magdir/Makefile - ADJUST THIS FOR YOUR CONFIGURATION
  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
  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.
  89.