home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 15 / CD_ASCQ_15_070894.iso / vrac / volume11.zip / VOLUME.DOC < prev    next >
Text File  |  1994-04-24  |  6KB  |  190 lines
  1.  
  2.  
  3. ********************************************************************************
  4. 11:48:47  04/24/94                                                     Page 1   
  5.                      T O O L Z   D O C U M E N T A T I O N                      
  6.                                   V O L U M E                                   
  7. ********************************************************************************
  8.  
  9.  
  10. o MODULE NAME
  11.  
  12.    VOLUME
  13.  
  14. o LIBRARY NAME
  15.  
  16.    TOOLZ
  17.  
  18. o TYPE
  19.  
  20.    PROGRAM
  21.  
  22. o QUICK DESCRIPTION
  23.  
  24.    Store/retrieve a large file on several volumes
  25.  
  26. o ARGUMENT DESCRIPTION
  27.  
  28.    volume /i <volume name> ["/p=<command>[,del]"]
  29.    volume /o <volume name> <input file> ["/p=<command>[,del]"]
  30.  
  31. o NARRATIVE DESCRIPTION
  32.  
  33.    The VOLUME utility writes a file to an output device, and breaks the
  34.    file into multiple volumes if the file size exceeds the capacity of
  35.    the output device.  VOLUME also reads an volume from a device, and
  36.    the volume may be contained on multiple removable media.  The volume
  37.    name must be specified without an extension as VOLUME will append an
  38.    extension to indicate the volume number.
  39.  
  40.    VOLUME does not archive or compress files, but it will call your
  41.    favorite archiver or compress program for you.
  42.  
  43.    Output mode:
  44.  
  45.       If any files are contained on the removable media, they will not
  46.       be affected in any way.  VOLUME uses the DOS file system on the
  47.       media instead of raw data transfer, allowing the storage of
  48.       other files on the media.
  49.  
  50.       The first volume will contain the files, <name>.0 and <name>.1,
  51.       where <name> is the name you have chosen for the volume.  The
  52.       next volume will contain <name>.2, and so forth.  The last
  53.       volume will contain <name>.n and <name>, where n is the last
  54.       volume number and <name> is an empty file signifying that this
  55.       volume contains the last piece of the file.
  56.  
  57.       If a preprocessor command option (/p) is specified, then the
  58.       specified "command" will be executed (usually an archiver) before the
  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. 11:48:47  04/24/94                                                     Page 2   
  68.                      T O O L Z   D O C U M E N T A T I O N                      
  69.                                   V O L U M E                                   
  70. ********************************************************************************
  71.  
  72.  
  73.       volume creation is commenced.  If the ",del" option is added to the
  74.       postprocessor option, the input file will be deleted upon
  75.       successful completion of "command."  The /p option argument should be
  76.       quoted to preserve any spaces embedded in "command."
  77.  
  78.    Input mode:
  79.  
  80.       The volumes need to be read in the order they were created.
  81.  
  82.    If a postprocessor command option (/p) is specified, then the
  83.    specified "command" will be executed (usually a de-arhiver) after the
  84.    volumes are read.  If the ",del" option is added to the postprocessor
  85.    option, the input file (as restored to the current directory) will be
  86.    deleted upon successful completion of "command."  The /p option
  87.    argument should be quoted to preserve any spaces embedded in
  88.    "command."
  89.  
  90.  
  91. o RETURNS
  92.  
  93.    EXITWARN if volume is prematurely aborted, EXITNORMAL otherwise.
  94.  
  95. o APPLICATIONS
  96.  
  97.    UTILITY
  98.  
  99. o PLATFORMS
  100.  
  101.    MSDOS
  102.  
  103. o REVISIONS
  104.  
  105.    1/14/92
  106.    Add postprocess and preprocess options.
  107.  
  108. o FIXES
  109.  
  110.    5/23/91
  111.    Improve documentation
  112.    9/12/91
  113.    Restoration (/i) was previously attempted with original full path
  114.    of file.  Path is now removed.
  115.  
  116. o SOURCE LANGUAGE
  117.  
  118.    C
  119.  
  120. o EXAMPLE(S)
  121.  
  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. 11:48:47  04/24/94                                                     Page 3   
  131.                      T O O L Z   D O C U M E N T A T I O N                      
  132.                                   V O L U M E                                   
  133. ********************************************************************************
  134.  
  135.  
  136.    volume /o a:filearc files.zip
  137.    volume /i a:filearc
  138.    volume /o b:fred bruce.zip "/p=pkzip bruce.zip c:\source\*.c,del"
  139.    volume /i b:fred "/p=pkunzip bruce.zip,del"
  140.  
  141. o NOTICE
  142.  
  143.    Copyright 1991 Software Toolz, Inc. - Atlanta, Georgia
  144.  
  145.    All rights reserved worldwide.  You are granted a limited
  146.    license to use this program for evaluation purposes for an
  147.    evaluation period of sixty days.  You may copy the program and
  148.    distribute it provided that:  (1) no fee may be charged for such
  149.    copying and distribution, and (2) this program may only be
  150.    distributed in its original unmodified state.  This program may
  151.    not be distributed with other programs for which a fee is
  152.    charged except by permission of Software Toolz, Inc.
  153.  
  154.    This program is shareware.  If you think that it is worth it,
  155.    please send the registration fee to Software Toolz.
  156.  
  157. o SOURCE VERSION
  158.  
  159.    @(#) volume.c 1.18 93/03/09 23:04:55
  160.  
  161. o INTRODUCTION DATE
  162.  
  163.    05/14/91
  164.  
  165. o LAST FILE UPDATE
  166.  
  167.    04/24/94 11:47:19 -- volume.c
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  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.