home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / utilities / cli / nspark / man / nspark1_tx < prev    next >
Encoding:
Text File  |  1994-12-13  |  5.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4. NSPARK(1)                USER COMMANDS                  NSPARK(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      nspark - unpack Archimedes archives
  10.  
  11. SYNOPSIS
  12.      nspark [ options ] archive [ file ... ]
  13.  
  14. DESCRIPTION
  15.      The current version of nspark is 1.7.4
  16.  
  17.      Nspark can unpack the specified  Archimedes-format  archive,
  18.      list its contents or tests its integrity.
  19.  
  20.      Nspark's main features are:
  21.  
  22.      o Supports all archive methods used by !Spark 1 and  2.  The
  23.      old  version  didn't  support "Squashing" and used to handle
  24.      "Compressed" archives by using the UNIX uncompress  program.
  25.      The  new  version supports both these and has them built-in,
  26.      allowing easier porting to other OS's.
  27.  
  28.      o Supports ArcFS format archives.
  29.  
  30.      o Supports Cyclic Redundancy Checking (CRC).  The  integrity
  31.      of an archive can now be checked without having to unarchive
  32.      it.
  33.  
  34.      o Supports verbose option to allow archive file  details  to
  35.      be displayed (time/date or exec/load address, size, type).
  36.  
  37.      o Supports selective file unarchiving, so the whole  archive
  38.      needn't be unarchived if not all the files are wanted).
  39.  
  40.      o Supports user-prompting before overwriting a file,  allow-
  41.      ing the user to either (1) overwrite the file, (2) overwrite
  42.      all the files, (3) unarchive the file to a  different  name,
  43.      or (4) not to unarchive the file at all.
  44.  
  45.      o Supports file-stamping so the date and time of  the  file,
  46.      when  unarchived,  matches the date and time it was archived
  47.      (not 4.2BSD or SysV.2 as these systems  lack  vital  library
  48.      functions).
  49.  
  50.      I have not included support for  creating  !Spark  archives,
  51.      and  I  am  not  really sure if I need to as: (1) !Spark for
  52.      RISC OS is cheap (#5.99 from David Pilling), (2)  !SparkPlug
  53.      can  unpack archives created with zip (which is available in
  54.      source form for UNIX, VMS and MSDOS), and (3) it's a lot  of
  55.      work. Let me know what you think.
  56.  
  57.      _O_p_t_i_o_n_s:
  58.  
  59.      -x        Extract the given file, or all files if  none  are
  60.  
  61.  
  62.  
  63. USER COMMANDS             Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. NSPARK(1)                USER COMMANDS                  NSPARK(1)
  71.  
  72.  
  73.  
  74.                specified.
  75.  
  76.      -u        Equivalent to -x.
  77.  
  78.      -t        Test archive integrity  by  simulating  extraction
  79.                and checking the CRCs (Cyclic Redundancy Checks).
  80.  
  81.      -l        List archive contents.
  82.  
  83.      -q        Quiet.  Displays less  information  when  listing,
  84.                testing or extracting.
  85.  
  86.      -f        Force file overwrite if a file already exists with
  87.                the  same  name as the one being extracted. If not
  88.                using -f then you are prompted whether you want to
  89.                overwrite  the original, skip this file, give it a
  90.                different name, or overwrite this and  all  others
  91.                that already exist.
  92.  
  93.      -s        No filestamp. Does  not  set  the  timestamp  when
  94.                extracting files.
  95.  
  96.      -v        Verbose.   Gives  full  details  when  listing  or
  97.                extracting archives.
  98.  
  99.      -R        Retry if archive is corrupt.  If a bad  header  is
  100.                found  then  nspark  will search the archive until
  101.                another header if found, rather than giving up.
  102.  
  103.      -L<name>  Set name of log file to name.
  104.  
  105.      -T        Append file type to name, in the same way  as  Tar
  106.                or  NFS.   For  example Text files (filetype &FFF)
  107.                have ,fff appended when extracted.
  108.  
  109.      -C        Create lowercase filenames.   Useful  on  machines
  110.                where  the  case  of filenames is significant (eg.
  111.                UNIX), this option forces all extracted  filenames
  112.                to be lowercase.
  113.  
  114. BUGS
  115.      Filestamping is not supported under 4.2BSD or SysV2  (as  no
  116.      mktime(3)  or  timelocal(3) functions exist under these sys-
  117.      tems).  To correct this I could write my own or port the one
  118.      from 386BSD (save that for a rainy day).
  119.  
  120.      Doesn't support MSDOS yet.  Working on that.
  121.  
  122.      If compiled with GCC (v1.42) it core dumps  when  trying  to
  123.      test  (or unarchive ?) a corrupt archive file.  This doesn't
  124.      happen when compiled with the UNIX pcc.
  125.  
  126.  
  127.  
  128.  
  129. USER COMMANDS             Last change:                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. NSPARK(1)                USER COMMANDS                  NSPARK(1)
  137.  
  138.  
  139.  
  140. NOTES
  141.      Nspark is in the public domain.  It is currently being main-
  142.      tained by arb (arb@comp.lancs.ac.uk).
  143.  
  144. SEE ALSO
  145.      arcfs(5), spark(5).
  146.  
  147. AUTHOR
  148.      Andy   Duplain,   BT   Customer   Systems,   Brighton,   UK.
  149.      (duplain@btcs.bt.co.uk)
  150.  
  151. CONTRIBUTORS
  152.      Improvements from version 1.5, including ArcFS  support,  by
  153.      Andrew Brooks (arb@compl.ancs.ac.uk).
  154.  
  155.      Manual    pages    originally     supplied     by     Duncan
  156.      (m91dps@ecs.oxford.ac.uk).
  157.  
  158.      Suggestions    for     improvement     by     Tom     Tromey
  159.      (tromey@busco.lanl.gov).
  160.  
  161.      Windows NT support by Alun Jones (auj@aber.ac.uk).
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. USER COMMANDS             Last change:                          3
  196.  
  197.  
  198.  
  199.