home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / CMDS / file.lzh / readme < prev    next >
Text File  |  1995-04-27  |  4KB  |  73 lines
  1. File - a file identification utility for OS-9
  2.  
  3. File is a utility designed to identify files by contents. It mainly relies
  4. on identifying "magic coockies" (identifiying sequences at known locations)
  5. in the file. If this method failes, it may still be able to identify the
  6. file by name or extention. File knows about OS-9 and OS-9000 modules and
  7. will identify such by examining the module header. It will therefore provide
  8. additional info on these files.
  9.  
  10. This utility was designed to emulate the functionality of the unix utility
  11. of the same name. I attempted to maintain command line functionality and
  12. magic file usability with the OS-9 version. This program has additional
  13. functionality that is found in some PD unix file utilities in that you can
  14. specify the byte-ordering as well as the size of numeric values. Thus, in
  15. addition to the standard short, you have beshort and leshort for big endian
  16. short and little endian short. The same is true of long
  17.  
  18. About the included files:
  19.  
  20. Found in this archive are the following files:
  21.  
  22. file.c            source for the basic utility
  23. file.h         header providing common definitions etc
  24. help.c         source for the help functions
  25. istar.c        source for recognizing tar files
  26. magic          the magic file for the utility - this should be put in /dd/sys
  27. makefile       a copy of makefile.cc
  28. makefile.cc    an OS-9 makefile for the 3.2 compiler
  29. makefile.ucc   an OS-9 makefile for Ultra C
  30. makefile.unix  a unix makefile
  31. readmagic.c    source for the magic file handling code
  32. readme         this file
  33. strextra.c     functions needed by the 3.2 compiler but not unix and Ultra C
  34. strtoul.c      source for strtoul.c function needed for unix
  35.  
  36. You will need to have some subdirectories to compile this code. For OS-9,
  37. the directory IDIR/OS9 is needed. For OS-9000, IDIR/OS9K is needed. For
  38. unix, you will need to define the environment variable MACHINE and then will
  39. need the directory RELS/$MACHINE.
  40.  
  41. As is, the code should compile easily on OS-9/OSK machines and OS-9000
  42. machines with either Ultra C or the 3.2 compiler. It should also compile
  43. on most unix systems. Previous versions were known to compile on the Coco
  44. running OS-9/6809 Level 2 and on the PC (compiler unknown). Some code changes
  45. made since then may or may not prevent compilation of this release on these
  46. machines. If it won't readily compile, modification to make it work should be
  47. minor.
  48.  
  49. A Word About Magic Files:
  50.  
  51. The included magic file covers most OS-9 and many other file types. If you
  52. find file types that it will not recognize, you may either create your own
  53. entry in the magic file (run "file -help" for info on this) entry, or you
  54. can send me a copy or two of this type and I will attempt it. Mostly, you
  55. just have to indentify some value near the front of the file that is unique
  56. to that file type, and present in all files of that type.
  57.  
  58. If you produce an entry for a usefull file type, please let me know so that
  59. I may include it in the next release.
  60.  
  61. Suggestions, comments, buggs and magic file additions can be sent to me by
  62. email at smcgee@microware.com.
  63.  
  64. The Final Word - Copyrights!
  65.  
  66. This program and all associated source code* is Copyright (c) 1995 by Scott
  67. McGee. This archive may be freely distributed in its original, unaltered
  68. form as long as no fee is charged for it beyond media costs. This Pogramis
  69. provided AS IS with ABSOLUTLY NO WARANTY!
  70.  
  71. *strtoul.c and strextra.c were provided by Mike Haaland for this program.
  72. Please contact him for the copyright status of these programs.
  73.