home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / filez18.zip / FILEZ.DOC < prev    next >
Text File  |  1994-04-01  |  17KB  |  568 lines
  1.  
  2.  
  3. ********************************************************************************
  4. 17:53:03  04/01/94                                                     Page 1   
  5.                      T O O L Z   D O C U M E N T A T I O N                      
  6.                                    F I L E Z                                    
  7. ********************************************************************************
  8.  
  9.  
  10. o MODULE NAME
  11.  
  12.    FILEZ
  13.  
  14. o LIBRARY NAME
  15.  
  16.    TOOLZ
  17.  
  18. o TYPE
  19.  
  20.    PROGRAM
  21.  
  22. o QUICK DESCRIPTION
  23.  
  24.    Binary file examination and modification.
  25.  
  26. o ARGUMENT DESCRIPTION
  27.  
  28.    filez <filename> [opt]
  29.       Options:
  30.       /m    monochrome
  31.       /v    video direct (MSDOS only)
  32.  
  33. o NARRATIVE DESCRIPTION
  34.  
  35.  
  36.    This utility can modify any unsigned char of a file, copy
  37.    portions of the file to other files, dump the file (in print
  38.    image) in entirety or one record at a time.  Examination (in
  39.    REVIEW mode) and editing (in EDIT mode) is done in either hex or
  40.    ASCII. There are two modes, REVIEW and EDIT, under which files
  41.    are manipulated.  The name of the file to be edited must be
  42.    supplied on the command line.
  43.  
  44.    The /m (monochrome) startup option specifies that color should
  45.    not be used in displays (assuming that color is supported).  The
  46.    MSDOS version also allows direct display video writes with the
  47.    /v option, which will produce faster display updates but
  48.    disallow Windows compatibility.
  49.  
  50.       COMMANDS IN REVIEW MODE
  51.  
  52.       Non-selection bar commands:
  53.  
  54.          DOWN  Next record
  55.                Also:  Down-Arrow, +
  56.  
  57.          UP    Previous record
  58.                Also:  Up-Arrow, -
  59.  
  60.  
  61. ********************************************************************************
  62.               T O O L Z   M o d u l e   D o c u m e n t a t i o n               
  63. ********************************************************************************
  64.  
  65.  
  66. ********************************************************************************
  67. 17:53:03  04/01/94                                                     Page 2   
  68.                      T O O L Z   D O C U M E N T A T I O N                      
  69.                                    F I L E Z                                    
  70. ********************************************************************************
  71.  
  72.  
  73.  
  74.          ?     Display review mode help
  75.                Also:  F1
  76.  
  77.          Ctrl-W   Repaint the screen
  78.  
  79.          Ctrl-E   Enter edit mode
  80.  
  81.          Ctrl-N   Search for next
  82.  
  83.          HOME  Set to first record (Beginning) of file
  84.  
  85.          END   Set to last record (end) of file
  86.  
  87.          ESC   Exit the filez program
  88.  
  89.       Selection bar commands:
  90.  
  91.       File
  92.  
  93.          Exit
  94.  
  95.             Exit the filez program
  96.  
  97.          Help
  98.  
  99.             Display the review mode help screen
  100.  
  101.          ASCII table
  102.  
  103.             Display the on-line ASCII table
  104.  
  105.       Set
  106.  
  107.          Address
  108.  
  109.             Find the record for the specified address offset
  110.  
  111.          Record
  112.  
  113.             Set the current record number
  114.  
  115.          End of file
  116.  
  117.             Set to last record (end) of file
  118.  
  119.          Beginning of file
  120.  
  121.             Set to first record (Beginning) of file
  122.  
  123.  
  124. ********************************************************************************
  125.               T O O L Z   M o d u l e   D o c u m e n t a t i o n               
  126. ********************************************************************************
  127.  
  128.  
  129. ********************************************************************************
  130. 17:53:03  04/01/94                                                     Page 3   
  131.                      T O O L Z   D O C U M E N T A T I O N                      
  132.                                    F I L E Z                                    
  133. ********************************************************************************
  134.  
  135.  
  136.  
  137.          Next record
  138.  
  139.             Display next record
  140.  
  141.          Previous record
  142.  
  143.             Display previous record
  144.  
  145.          Search case
  146.  
  147.             Toggle Ignore Search Case (string mode search)
  148.  
  149.          New file
  150.  
  151.             Specify a new file to edit without exiting filez
  152.  
  153.          Record size
  154.  
  155.             Set Record size (maximum 256)
  156.  
  157.          Copyfile name
  158.  
  159.             Specify copyfile name
  160.  
  161.          8-bit characters
  162.  
  163.             Toggle display of 8-bit characters
  164.  
  165.          Record size to Section size
  166.  
  167.             Set record size to size of section block
  168.  
  169.       Search
  170.  
  171.          String
  172.  
  173.             Search for a string from the current record
  174.  
  175.          Pattern
  176.  
  177.             Search for a pattern of unsigned chars from the current record
  178.  
  179.          Next
  180.  
  181.             Search for the next occurance
  182.  
  183.       Translate
  184.  
  185.  
  186.  
  187. ********************************************************************************
  188.               T O O L Z   M o d u l e   D o c u m e n t a t i o n               
  189. ********************************************************************************
  190.  
  191.  
  192. ********************************************************************************
  193. 17:53:03  04/01/94                                                     Page 4   
  194.                      T O O L Z   D O C U M E N T A T I O N                      
  195.                                    F I L E Z                                    
  196. ********************************************************************************
  197.  
  198.  
  199.          String
  200.  
  201.             Translate one string to another
  202.  
  203.          Pattern
  204.  
  205.             Translate one pattern to another
  206.  
  207.          Next
  208.  
  209.             Translate the next occurance
  210.  
  211.       Operate
  212.  
  213.          Copy
  214.  
  215.             Move a marked section of the file to copyfile
  216.             (must be 'O'pened first)
  217.  
  218.          Cut
  219.  
  220.             Delete the currently marked section from the file
  221.  
  222.          Pad copyfile
  223.  
  224.             Pad the copyfile with a specified character
  225.  
  226.          Extend
  227.  
  228.             Extend the file with a specified character
  229.  
  230.          Edit record
  231.  
  232.             Enter the EDIT mode at the current record
  233.  
  234.          Insert file
  235.  
  236.             Insert copyfile into current file at section beginning
  237.  
  238.          Update
  239.  
  240.             Write the current record to the file
  241.  
  242.       Print
  243.  
  244.          Record
  245.  
  246.             Dump the current record to print image
  247.  
  248.  
  249.  
  250. ********************************************************************************
  251.               T O O L Z   M o d u l e   D o c u m e n t a t i o n               
  252. ********************************************************************************
  253.  
  254.  
  255. ********************************************************************************
  256. 17:53:03  04/01/94                                                     Page 5   
  257.                      T O O L Z   D O C U M E N T A T I O N                      
  258.                                    F I L E Z                                    
  259. ********************************************************************************
  260.  
  261.  
  262.          Whole file
  263.  
  264.             Dump the file to a print image file
  265.  
  266.  
  267.       COMMANDS IN EDIT MODE
  268.  
  269.          UP          Move cursor up one line (keyboard up arrow)
  270.                      Also:  Ctrl-E, Ctrl-I
  271.  
  272.          DOWN        Move cursor down one line (keyboard down arrow)
  273.                      Also:  Ctrl-X, Ctrl-K
  274.  
  275.          LEFT        Move cursor left one character (keyboard left arrow)
  276.                      Also:  Ctrl-S, Ctrl-J
  277.                      (Unix note:  do not use Ctrl-S if software
  278.                      handshaking is enabled)
  279.  
  280.          RIGHT       Move cursor right one character (keyboard right arrow)
  281.                      Ctrl-D, Ctrl-L
  282.  
  283.          Ctrl-B      Mark beginning of section at cursor
  284.  
  285.          Ctrl-P      Mark end of section
  286.  
  287.          ENTER       Toggle hex/ASCII mode
  288.  
  289.          ESC         Exit editing mode
  290.  
  291.          F1          Display edit mode help
  292.                      Also:  Ctrl-H
  293.  
  294.          Ctrl-W      Repaint the screen
  295.  
  296.          Ctrl-F      Jump to byte offset
  297.  
  298.    The REVIEW mode is entered by default when FILEZ is started.
  299.    Commands for this mode are accepted at the filez> prompt.  Error
  300.    messages are always displayed on the bottom line of the screen.
  301.    Either a '?' or F1 key may be pressed to see the help screen for
  302.    the REVIEW mode.  (Note that the F1 key is terminal-dependent in
  303.    the Unix version).
  304.  
  305.    For some commands, more than one key may be effective.  This may
  306.    be useful on some terminals that do not have function keys or
  307.    have function keys improperly described in terminfo (Unix only).
  308.  
  309.    A search pattern may be specified in hex or ASCII (not
  310.    simultaneously), and the search for the pattern will commence
  311.  
  312.  
  313. ********************************************************************************
  314.               T O O L Z   M o d u l e   D o c u m e n t a t i o n               
  315. ********************************************************************************
  316.  
  317.  
  318. ********************************************************************************
  319. 17:53:03  04/01/94                                                     Page 6   
  320.                      T O O L Z   D O C U M E N T A T I O N                      
  321.                                    F I L E Z                                    
  322. ********************************************************************************
  323.  
  324.  
  325.    from the beginning of the currently displayed record.  While a
  326.    search is  in progress, it may be aborted by pressing any key in
  327.    the MSDOS version, or by pressing Ctrl-\ in the UNIX version.
  328.  
  329.    If Print->Record is specified, a dump in print image of the
  330.    current record is sent to a file that can be printed upon exit
  331.    from FILEZ. If Print->Whole file is specified, all records are
  332.    dumped to the print image file.
  333.  
  334.    In the EDIT mode, the cursor may be positioned in the hex or
  335.    ASCII region and the unsigned chars to be modified may be
  336.    specified in hex  or ASCII, respectively.  In order to move
  337.    portions of the file to a copyfile, the copyfile name must first
  338.    be specified and opened.  Be sure to mark the beginning and end
  339.    of the section to be moved. The copyfile is closed automatically
  340.    upon exit from filez, or when a new copyfile is specified. Data
  341.    file can be composed using this feature, and the Operate->Pad
  342.    feature appends any character you specify to the end of the copy
  343.    file.  Copyfiles are always opened in the append mode so that
  344.    copyfiles from previous FILEZ sessions can be appended to.
  345.  
  346.    Hex editing is the default upon entering edit mode.  The ENTER
  347.    key toggles between hex and Ascii editing.  The unsigned char
  348.    under edit will be displayed with the foreground and background
  349.    reveresed.  If editing in hex, the corresponding unsigned char
  350.    under edit in the Ascii display will be emphasized.
  351.  
  352.    The record size is 256 by default, but this value may be changed
  353.    to any value between 1 and 256 using the Set->Record size
  354.    command from  the review mode.
  355.  
  356.    A configuration file is optional and can be used to modify
  357.    screen colors.  The configuration file must be named FILEZ.CFG
  358.    and may be located anywhere in the search path.  It is a text
  359.    file containing one or more of the following records:
  360.  
  361.       WINDOW,DISPLAY,<foreground>,<background>
  362.       WINDOW,ADDRESS,<foreground>,<background>
  363.       WINDOW,HEX,<foreground>,<background>
  364.       WINDOW,ASCII,<foreground>,<background>
  365.       WINDOW,HELP,<foreground>,<background>
  366.       WINDOW,STATUS,<foreground>,<background>
  367.       WINDOW,SELECT,<foreground>,<background>
  368.       WINDOW,ERROR,<foreground>,<background>
  369.       WINDOW,TABLE,<foreground>,<background>
  370.       WINDOW,PROMPT,<foreground>,<background>
  371.       WINDOW,MENU,<foreground>,<background>
  372.  
  373.    Valid foreground and background colors are:
  374.  
  375.  
  376. ********************************************************************************
  377.               T O O L Z   M o d u l e   D o c u m e n t a t i o n               
  378. ********************************************************************************
  379.  
  380.  
  381. ********************************************************************************
  382. 17:53:03  04/01/94                                                     Page 7   
  383.                      T O O L Z   D O C U M E N T A T I O N                      
  384.                                    F I L E Z                                    
  385. ********************************************************************************
  386.  
  387.  
  388.  
  389.       BLACK
  390.       RED
  391.       GREEN
  392.       YELLOW
  393.       BLUE
  394.       MAGENTA
  395.       CYAN
  396.       WHITE
  397.  
  398.    Other options are:
  399.  
  400.       OPTION,BITS,8
  401.  
  402.    Empty lines and lines beginning with the '#' character are
  403.    ignored.  The screen color specification are ignored in monochrome
  404.    mode.
  405.  
  406. o COMMENTS
  407.  
  408.    This program is based on EFILE, published by Software Toolz
  409.    (d.b.a. Future Communications) in 1984 and 1986.
  410.  
  411. o RETURNS
  412.  
  413.    Nothing
  414.  
  415. o APPLICATIONS
  416.  
  417.    FILE
  418.  
  419. o PLATFORMS
  420.  
  421.    MSDOS-S
  422.    UNIX
  423.  
  424. o AUTHOR
  425.  
  426.    Todd Merriman
  427.  
  428. o REVISIONS
  429.  
  430.    11/29/91
  431.    Rewrite and implement under Curses.
  432.    12/16/91
  433.    Binary search pattern would fail when searching with a unsigned char with
  434.    bit 7 set.
  435.    12/23/91
  436.    Added pattern translate
  437.  
  438.  
  439. ********************************************************************************
  440.               T O O L Z   M o d u l e   D o c u m e n t a t i o n               
  441. ********************************************************************************
  442.  
  443.  
  444. ********************************************************************************
  445. 17:53:03  04/01/94                                                     Page 8   
  446.                      T O O L Z   D O C U M E N T A T I O N                      
  447.                                    F I L E Z                                    
  448. ********************************************************************************
  449.  
  450.  
  451.    1/12/92
  452.    Added Cntrl-W repaint command
  453.    1/13/92
  454.    Add ASCII table view
  455.    2/21/92
  456.    Add 8-bit character display to MSDOS version
  457.    2/25/92
  458.    Revise from 1.6 to 1.7.  Add pull-down menus to replace character
  459.    commands.
  460.    07/26/92
  461.    Added 'n' to search for next
  462.    01/07/93
  463.    Main menu, 'N' is now Cntrl-N, and 'E' is now Cntrl-E.
  464.    Printable characters in menus are now used for searching the menu.
  465.    01/21/93
  466.    Added set record size to section size.  Changed "mark section
  467.    end" from Ctrl-Z to Ctrl-P.  Also display block numbers as 1-based
  468.    to prevent user confusion.
  469.    3/3/94
  470.    Add Ctrl-F in edit mode to jump an offset in the record.
  471.  
  472. o FIXES
  473.  
  474.    12/26/91
  475.    Corrected documentation concerning the names of windows to be
  476.    specified in the Configuration File.
  477.    1/13/92
  478.    Found problem disallowing color modifications for the the configuration
  479.    file for the HELP window.
  480.    2/15/92
  481.    Inadvertant ESC pressed twice sequentially exited program without
  482.    saving edits.
  483.    4/3/92
  484.    LEFT or RIGHT keys in menus now select adjacent menus.
  485.    7/5/92
  486.    Block number was always zero in the dumpfile (printfile).
  487.    01/12/93
  488.    If the input file cannot be opened read/write, it is opened
  489.    read-only and the user is notified.
  490.  
  491. o NOTICE
  492.  
  493.    FILEZ is Copyright 1991 Software Toolz, Inc. - Atlanta, Georgia
  494.  
  495.    All rights reserved worldwide.  You are granted a limted license to
  496.    use this program, copy it, and distribute it provided that:  (1) no
  497.    fee may be charged for such copying and distribution, and (2) this
  498.    program may only be distributed in its original unmodified state.
  499.    This program may not be distributed with other programs for which a
  500.  
  501.  
  502. ********************************************************************************
  503.               T O O L Z   M o d u l e   D o c u m e n t a t i o n               
  504. ********************************************************************************
  505.  
  506.  
  507. ********************************************************************************
  508. 17:53:03  04/01/94                                                     Page 9   
  509.                      T O O L Z   D O C U M E N T A T I O N                      
  510.                                    F I L E Z                                    
  511. ********************************************************************************
  512.  
  513.  
  514.    fee is charged except by permission of Software Toolz, Inc.
  515.  
  516.    Software Toolz, Inc.
  517.    8030 Pooles Mill Dr.
  518.    Ball Ground, GA 30107
  519.    (404) 889-8264
  520.    Internet:  software@toolz.atl.ga.us
  521.  
  522. o SOURCE VERSION
  523.  
  524.    @(#) filez.c 1.70 94/03/03 14:18:39
  525.  
  526. o INTRODUCTION DATE
  527.  
  528.    07/29/91
  529.  
  530. o LAST FILE UPDATE
  531.  
  532.    04/01/94 17:51:49 -- filez.c
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565. ********************************************************************************
  566.               T O O L Z   M o d u l e   D o c u m e n t a t i o n               
  567. ********************************************************************************
  568.