home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / jsage / znode3 / util / ccf.lbr / CCF.DZC / CCF.DOC
Encoding:
Text File  |  1993-06-09  |  6.3 KB  |  159 lines
  1.             CCF.COM     Version 1.0
  2.             ^^^^^^^
  3.  
  4.     CCF.COM is a general purpose utility which may be used to copy files
  5. from directory to directory, combine files, expand files up to a given size
  6. using a fill character and reverse files (last byte in the source file becomes
  7. the first byte in the new file). It requires a Z80 or compatible CPU and CP/M
  8. version 2.2 or higher or compatible operating systems. It will make full use
  9. of the facilities provided on Z-systems such as named directories and terminal
  10. capabilities. If you are interested then read on...
  11.  
  12.  
  13. RATIONALE
  14. +++++++++
  15.  
  16.     I build my own hardware as well as write software for it. From the
  17. hardware point of view it often makes sense to invert the address lines output
  18. by a CPU. This creates no problems when writing/reading RAM but means that
  19. pre-programmed memory (such as PROMs) must have the binary image of their
  20. software reversed before they can be programmed. So CCF.COM had to be written
  21. and at first it was intended simply as a file reversal utility but of course
  22. it grew. A full description of its capabilities may be obtained by running it
  23. typing "CCF //" at the system prompt.
  24.  
  25.  
  26. INSTALLATION
  27. ++++++++++++
  28.  
  29.       If you are running a Z-system then install CCF in the usual way
  30.     Z3INS or Z-RIP. If you have ZCPR33 or higher this is not strictly
  31.     necessary but is still good practice.
  32.       If you just run CP/M then no need to worry. You will lose the
  33.     flashy displays and the more advanced security and directory features
  34.     of a Z-system but the program will still be fully functional.
  35.  
  36.  
  37. RUNNING
  38. +++++++
  39.  
  40.       CCF will accept its command line either from the command tail input
  41. at the system prompt or, if no command tail is provided, it will request a
  42. command. This latter form is slightly more flexible in that it allows lower
  43. case letters to be input in the option list. All filenames will be capitalized.
  44.  
  45.  
  46. HELP
  47. ++++
  48.  
  49.     Type "CCF //" at the system command prompt or " //" if CCF is running
  50. and requesting a command.
  51.  
  52.  
  53. GOTCHAS
  54. +++++++
  55.  
  56.       None as far as I know. The program will manipulate files sizes up to
  57.     the structural limits. The program creates the destination file using
  58.     the filename you specify but with the temporary type ".$$$" and only
  59.     when the file has been successfully created will it be renamed with
  60.     the given filetype. This helps protect your files against inadvertant
  61.     loss but can, very ocassionally, result in a disk full error.
  62.       For example take the command "CCF TEST.DAT=TEST.DAT /R". This tells
  63.     CCF to take a file TEST.DAT and reverse it. But suppose TEST.DAT is
  64.     64k long and there is only 62k of disk space left. CCF will try to make
  65.     a file TEST.$$$ holding the reverse image of TEST.DAT but obviously it
  66.     will fail. The error is benign in that your source file will be left
  67.     intact (and TEST.$$$ will be deleted).
  68.  
  69.  
  70. EXAMPLES
  71. ++++++++
  72.  
  73.     None of the examples below specify directories with the file-names. In
  74. fact anywhere a filename is written a directory (e.g. "A13:" or "12B:") may
  75. be prefixed. Additionally for users of Z-systems named directories are
  76. supported (including enforced password checking for all directories except the
  77. default directory for 'Non Wheel' users).
  78.  
  79.  
  80.     1/   TEST.DAT=TEST.DAT
  81.        Trivial in that TEST.DAT is re-written to disk.
  82.  
  83.     2/   TEST.DAT=TEST.DAT,TEST.DAT
  84.        A new file TEST.DAT is created consisting of the file TEST.DAT
  85.        appended to itself.
  86.  
  87.     3/    NEWNAME.BIN=TEST.DAT,TEST.DAT
  88.        The difference from case 2/ should be obvious.
  89.  
  90.     4/    TEST.DAT=TEST.DAT /R
  91.        The file TEST.DAT is reversed. The /R option may be used freely
  92.        with any of these example commands except where the /S or /SC
  93.        option is exercised. They are incompatible.
  94.  
  95.     5/    TEST.DAT=TEST.DAT /F32
  96.        The file TEST.DAT is expanded in size to 32k (/F32 and /F32K are
  97.        equivalent) using the default fill character 0FFH. If a source
  98.        file is specified as well as a destination the fill size should
  99.        not be less than the (sum of) the source file size(s).
  100.  
  101.     6/    TEST.DAT=TEST.DAT /F32k /R
  102.        As with 5/ above but the destination file is written in reverse.
  103.        The /F & /R options may appear in any order but note that each
  104.        MUST be preceded by a slash "/".
  105.  
  106.     6/    NEWNAME.ROM=SOURCE1.BIN,SOURCE2.BIN,SOURCE3.BIN /R /F64,0
  107.        The point to notice here is the expanded form of the /F option.
  108.        The fill character may be specified in decimal, hexadecimal or
  109.        ASCII (e.g. /F64,43 & /F64,02BH & /F64,'+' & /F64,"+" all mean
  110.        the same). Note also that the use of the /R option with a
  111.        multiple source file list results in the first byte of SOURCE1.BIN
  112.        being the last byte in NEWNAME.ROM (the first byte would normally
  113.        be the fill character).
  114.  
  115.     7/    BIGTEXT.TXT=TEXT1.TXT,TEXT2.TXT,TEXT3.TXT /S
  116.        The /S option will strip any EOF characters (01AH) from text files
  117.        that may be combined. The default is to replace them with a space
  118.        " " but if a printable fill character is specified with the /F
  119.        option this will be used instead.
  120.  
  121.     8/    YOURBOOK.TXT=CHAPT1.TXT,CHAPT2.TXT,... /SC
  122.        Similar to 7/ but where file-sizes permit a carriage return and
  123.        line-feed is inserted between source-files. This will not work if
  124.        any of the source files is less than two bytes short of filling an
  125.        integer number of records. There are better tools for this sort of
  126.        work. I added the option simply because it was easy to do this way.
  127.  
  128.  
  129.     The command syntax is very easy going. You can specify any reasonable
  130. number of source files and most combinations of options. In general if what
  131. you want to do is sensible then CCF will let you do it. If in doubt then
  132. experiment first.
  133.  
  134.  
  135. PATCHES
  136. +++++++
  137.  
  138.     1/    If you like bells ringing all over the place then use
  139.        your favourite patching utility to change the byte at location
  140.        0000DH (0010DH in RAM) from 0FFH to 000H.
  141.  
  142.  
  143. WINDDOWN
  144. ++++++++
  145.  
  146.     Hope the program is of use. I am placing it in the public domain and so
  147. accept no responsibility for it or its effects on your system. That said it
  148. runs well for me. You can write to me at
  149.  
  150.               5 Baines Close,
  151.                 Bourton-on-the-Water,
  152.                   Glos. GL54 2PU.
  153.                 England.
  154.  
  155. and I will endeavour to answer (polite) letters!!
  156.  
  157.         Regards,
  158.              Bob Andersson.
  159. but means thapre-programmed memory (such as PROMs) mus