home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d3xx / d334 / whatis.lha / WhatIs / Whatis.doc.pp / Whatis.doc
Encoding:
Text File  |  1990-03-21  |  12.2 KB  |  348 lines
  1. ==============================================================================
  2.  
  3.         WhatIs This File ?              V1.2a
  4.         © J.Tyberghein                  Fri Feb  2 21:59:58 1990
  5.  
  6. ==============================================================================
  7.  
  8.  
  9.  
  10. Preface
  11. -------
  12.   This utility gives you all useful information it can obtain from the file.
  13.   WHATIS recognizes IFF files, object files and executables (hunks),
  14.   Aztec object files, crunched data files (with the PowerPacker), archives
  15.   like ZOO, ARC and ArcFiles (my own archiver), UUEncoded files, .info files,
  16.   Lattice PGTB files and Warp files (disk warper). In addition it will
  17.   print all system information for this file.
  18.   If you specify a device or directory instead of a file, you get more
  19.   system information.
  20.   If WHATIS doesn't recognize your file, it will check if the file could
  21.   be ASCII.
  22.  
  23.   This program (WHATIS V1.2a) is shareware.
  24.   If you like and/or use this utility I would appreciate it very much
  25.   if you'd send me a contribution of $10 US ($15 if you want to get a new
  26.   update (when one is available)).
  27.   Please send money by international money order, EuroCheck (in Belgian
  28.   Francs (BF) !) or cash, because it's very difficult for me to cash in
  29.   other checks.
  30.   If you want an update please state your current version.
  31.   If you want to use this program for commercial purposes please write
  32.   for permission !
  33.  
  34.   If you have any suggestions or remarks you can write to (Bug reports are
  35.   welcome too)
  36.  
  37.                             Jorrit  Tyberghein
  38.                              Hepmansbossen 31
  39.                            3990 Meerhout BELGIUM
  40.  
  41.  
  42. WARNING
  43. -------
  44.   If you want to use this utility you must have Arp 1.3 or later.
  45.   WHATIS is reexecutable so you can use it with ARes, Resident, ...
  46.   WHATIS is not reentrable, so you will get a warning from ARes or Resident
  47.   if you try to use this program twice at the same time.
  48.   There are still some unsupported hunks in object files. These occure in
  49.   some new Lattice object files. As soon as I have information about these
  50.   new hunks, these shortcomings will be removed.
  51.  
  52.  
  53. Changes
  54. -------
  55.   New in 1.2:
  56.     Support for ATAK,RLSE,VHDR,SHDR,CAMG,CRNG and FONS chunks (for IFF files)
  57.     ASCII and DIAG options
  58.     Lattice hunk support is better (but not best)
  59.   New in 1.2a:
  60.     Support for ANHD and CCRT chunks (IFF)
  61.     Show preferences information
  62.     More information in hunks (BSS and chip)
  63.     More information in INS1 chunk (IFF)
  64.     Protection bits now show in right order
  65.     New IDENT option
  66.     Speed optimization
  67.  
  68.  
  69. Supported files and features for the current version
  70. ----------------------------------------------------
  71.   Lattice ProGram TraceBack format (display all available information)
  72.   Warp file format (diplay file version number)
  73.   UUEncoded files (display name and size)
  74.   Zoo (simply state version)
  75.   Arc (no further information)
  76.   ArcFiles version 1.2 (QuickHelp Archiver) (list files in archive)
  77.   .info files (display gadget structure, DiskObject type and coordinates)
  78.   Aztec object files (no further information)
  79.   Aztec library files (list all functions in library)
  80.   Preferences file (display the complete contents of the file)
  81.   Hunks (Object files and executables) (list all hunks and display
  82.     information for each hunk)
  83.   IFF
  84.     Supported IFF formats:
  85.       ILBM  Interleaved BitMap
  86.       FTXT  Formatted text
  87.       PICS  QuickDraw picture
  88.       SMUS  Simple Musical Score
  89.       ANIM  Cel Animation Form
  90.       8SVX  8-bit Sampled Voice
  91.       ACBM  Amiga Contiguous BitMap
  92.       AIFF  Apple Audio Samples
  93.       ANBM  Animated BitMap Form
  94.       BANK  MIDI system-exclusive data dump
  95.       HEAD  Idea processor Form
  96.       MIDI  MIDI Form
  97.       PGTB  ProGram TraceBack diagnostic dump image (not really IFF)
  98.       SYTH  SoundQuest Master Librarian format for MIDI
  99.       WORD  Word processing form used by ProWrite
  100.       PDEF  Deluxe Print page definition
  101.       RGB4  4 bit RGB pixel information
  102.       SHAK  Used by Shakespeare (private)
  103.       VDEO  Used by Deluxe Video
  104.       SAMP  Sound Sample Form
  105.       TDDD  Used by Turbo Silver (ray tracing)
  106.       SC3D  Used by Sculpt-3D
  107.       TEXT  Plain unformatted ASCII text
  108.       FNTR  Raster font
  109.       FNTV  Vector font
  110.       GSCR  General-use musical score
  111.       USCR  Uhuru Sound Software musical score
  112.       UVOX  Uhuru Sound Software Macintosh voice
  113.       other IFF formats will simply appear on the screen without further
  114.       information (except for the listing of the chunks in the IFF file)
  115.     Supported IFF chunks:
  116.       LIST
  117.       CAT
  118.       CMAP  (ILBM) ColorMap
  119.       CRNG  (ILBM) ColorRange cycling chunk (used by DeluxePaint)
  120.       CCRT  (ILBM) Cycling chunk (use by Graphicraft)
  121.       GRAB  (ILBM) For sprites or brushes
  122.       CAMG  (ILBM) ViewModes for Amiga computers
  123.       BMHD  (ILBM) BitMapHeader
  124.       DEST  (ILBM) Destination chunk
  125.       ANHD  (ANIM) Animation Header
  126.       FONS  (FTXT) FontSpecifier
  127.       VHDR  (8SVX) Voice8Header
  128.       ATAK  (8SVX) Used to modulate sound
  129.       RLSE  (8SVX) Used to modulate sound
  130.       SHDR  (SMUS) SScoreHeader
  131.       INS1  (SMUS) Musical instrument
  132.       NAME  (SMUS) Name of the score
  133.       (c)   (SMUS) Copyright message
  134.       AUTH  (SMUS) Author of score
  135.       ANNO  (SMUS) Text annotations of score
  136.       other chunks will simply appear on the screen without further
  137.       information
  138.  
  139.  
  140. Syntax
  141. ------
  142.  
  143.   +----------------------------------------------------------------------+
  144.   | Commandline template:                                                |
  145.   |   File/a,S=SHORT/s,M=MEDIUM/s,F=FULL/s,D=DIAG/s,I=IDENT/s,A=ASCII/k: |
  146.   |----------------------------------------------------------------------|
  147.   | Usage:                                                               |
  148.   |   WhatIs <File> [SHORT | MEDIUM | FULL | DIAG | IDENT | ASCII <len>] |
  149.   +----------------------------------------------------------------------+
  150.  
  151.     File   : You want info about a File or a device
  152.     SHORT  : Standard file info
  153.     MEDIUM : SHORT and identification info (default)
  154.     FULL   : MEDIUM and diagnostic info
  155.     DIAG   : Show only diagnostic info
  156.              Diagnostic usage is divided into resource usage and
  157.              byte count usage. Resource usage shows the libraries, devices,
  158.              resources and fonts the program uses. This feature is only
  159.              meaningfull if the file is an executable, an object file or
  160.              a source file. There is no resource usage if identification is
  161.              enabled and the file is not an executable or object file.
  162.              Byte count usage shows the number of ascii characters (carriage
  163.              return, tab and form feed included), the number of non ascii
  164.              characters (between 127 and 255), the number of control codes
  165.              (between 0 and 31) and the number of lines.
  166.     IDENT  : Show only identification info
  167.              If you enable this option, WHATIS will try to recognize your
  168.              file. If it succeeds WHATIS will give you as much information
  169.              as possible. Otherwise WHATIS will tell you how likely it is
  170.              that this file is ascii.
  171.              If <File> is a device you will get some more information about
  172.              this device.
  173.     ASCII  : Dump ascii in file
  174.     Len    : Minimum linelength for ASCII dump
  175.  
  176.  
  177. examples
  178. --------
  179.  
  180.   WhatIs KingTut            (KingTut is a graphic image)
  181.     you will get the following output (or something equivalent):
  182.  
  183.     |  FileInfoBlock:
  184.     |     File         : KingTut
  185.     |     DirEntryType : -3
  186.     |     Protect      : rwed
  187.     |     Size         : 25728       NumBlocks : 51
  188.     |     Last changed : 15-Oct-89 10:54:52 (Sunday)
  189.     |     Comment      :
  190.     |
  191.     |  IFF file
  192.     |    FORM  ILBM   (25720 data bytes)
  193.     |      Interleaved BitMap
  194.     |      BMHD
  195.     |        width   :   320     height  :   200
  196.     |        x       :     0     y       :     0
  197.     |        nPlanes :     5     Masking :     0
  198.     |        xAspect :    10     yAspect :    11
  199.     |        PageWid :   320     PageHei :   200
  200.     |        Compression       : 1
  201.     |        transparent color : 0
  202.     |      CMAP  (96 bytes)
  203.     |      DPPS
  204.     |      CRNG
  205.     |        Rate :     0     Flags : RNG_ACTIVE
  206.     |        Low  :    20     High  :    31
  207.     |      CRNG
  208.     |        Rate :  2730     Flags : RNG_ACTIVE
  209.     |        Low  :     3     High  :     7
  210.     |      CRNG
  211.     |        Rate :  2730     Flags : RNG_ACTIVE
  212.     |        Low  :     0     High  :     0
  213.     |      CRNG
  214.     |        Rate :  2730     Flags : RNG_ACTIVE
  215.     |        Low  :     0     High  :     0
  216.     |      BODY
  217.  
  218.   WhatIs file.c s
  219.     you get only the basic information
  220.  
  221.     |  FileInfoBlock:
  222.     |     File         : file.c
  223.     |     DirEntryType : -3
  224.     |     Protect      : rwed
  225.     |     Size         : 146       NumBlocks : 1
  226.     |     Last changed : 17-Dec-89 20:37:04 (Sunday)
  227.     |     Comment      : This is an example file
  228.  
  229.   WhatIs ram:
  230.  
  231.     |  FileInfoBlock:
  232.     |     Directory    : RAM DISK
  233.     |     DirEntryType : 2
  234.     |     Protect      : rwed
  235.     |     Size         : 0       NumBlocks : 1
  236.     |     Last changed : 18-Dec-89 17:29:22 (Monday)
  237.     |     Comment      :
  238.     |
  239.     |  InfoData:
  240.     |     UnitNumber    : -1
  241.     |     NumSoftErrors : 0
  242.     |     NumBlocks     : 3       NumBlocksUsed : 3
  243.     |     BytesPerBlock : 488
  244.     |     Disk is validated
  245.     |     Dos disk
  246.     |     Disk in use
  247.     |
  248.     |  DeviceList:
  249.     |     Volume
  250.     |     Creation date : 01-Jan-78 00:00:61 (Sunday)
  251.     |     DiskType      : 444F5300
  252.  
  253.   WhatIs c:WhatIs f
  254.     Give full information
  255.  
  256.     |  FileInfoBlock:
  257.     |     File         : WhatIs
  258.     |     DirEntryType : -3
  259.     |     Protect      : rwed
  260.     |     Size         : 14940       NumBlocks : 30
  261.     |     Last changed : 17-Dec-89 17:07:02 (Sunday)
  262.     |     Comment      : © J.Tyberghein
  263.     |
  264.     |  Executable file
  265.     |     Hunk   0 : header
  266.     |                   Resident libraries:
  267.     |                   Table size : 2
  268.     |                   First Hunk : 0
  269.     |                   Last Hunk  : 1
  270.     |                code    (14568 bytes)
  271.     |                reloc32 (1 entries)
  272.     |                end
  273.     |     Hunk   1 : data    (160 bytes)  (0 bss)
  274.     |                reloc32 (2 entries)
  275.     |                end
  276.     |
  277.     |  Diagnostic research...
  278.     |     Resource usage:
  279.     |        arp.library
  280.     |        dos.library
  281.     |     Byte count:
  282.     |        8705 normal characters (58 %)
  283.     |        2691 non ascii characters (18 %)
  284.     |        3455 control codes ( <32 ) (23 %)
  285.     |        164 lines
  286.  
  287.   WhatIs disk.info ident
  288.  
  289.     |  .info file  version 1
  290.     |     icon gadget:
  291.     |        LeftEdge 406, TopEdge 23
  292.     |        Width 141, Height 74
  293.     |        Flags GADGHIMAGE, Activation RELVERIFY GADGIMMEDIATE
  294.     |        GadgetType BOOLGADGET
  295.     |     DiskObject type WBDISK
  296.     |     Current X 406   Current Y 23
  297.  
  298.   WhatIs II.smus
  299.  
  300.     |  FileInfoBlock:
  301.     |     File         : II.smus
  302.     |     DirEntryType : -3
  303.     |     Protect      : rwed
  304.     |     Size         : 1456       NumBlocks : 3
  305.     |     Last changed : 03-Nov-89 15:05:22 (Friday)
  306.     |     Comment      :
  307.     |
  308.     |  IFF file
  309.     |    FORM  SMUS   (1448 data bytes)
  310.     |      Simple Musical Score
  311.     |      SHDR
  312.     |        Tempo  : 16047
  313.     |        Volume :   127     ctTrack :   4
  314.     |      NAME  Sphere
  315.     |      SNX1
  316.     |      INS1  (  0) NAME sphere
  317.     |      INS1  (  1) NAME human
  318.     |      INS1  (  2) NAME SynthiI
  319.     |      INS1  (  3) NAME explosion
  320.     |      INS1  (  4) NAME no
  321.     |      INS1  (  5) NAME EffectII
  322.     |      INS1  (  6) NAME synthiII
  323.     |      INS1  (  7) NAME BassdrumI
  324.     |      INS1  (  8) NAME SphereI
  325.     |      TRAK
  326.     |      TRAK
  327.     |      TRAK
  328.     |      TRAK
  329.  
  330.   Whatis c:avail a 8
  331.       Show all ascii lines with length greater than 8 and the offsets
  332.       in the file.
  333.  
  334.     |  Ascii listing:
  335.     |  00000064: PONudos.library
  336.     |  00000074: you need arp.library
  337.     |  000001E6: NuUsage: Avail [CHIP|FAST] [TOTAL] [FLUSH]
  338.     |  00000211: CHIP/s,FAST/s,TOTAL/s,FLUSH/s
  339.     |  0000022F: Avail: %s
  340.     |  0000023A: Type  Available    In-Use   Maximum   Largest
  341.     |  00000268: %s %9ld %9ld %9ld %9ld
  342.  
  343. ==============================================================================
  344.  
  345.                          End of WHATIS 1.2a document
  346.  
  347. ==============================================================================
  348.