home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / disk / archive / nspark_1 / nspark-1.7.5 / man / spark5.txt < prev   
Text File  |  1994-12-13  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. SPARK(5)()        MISC. REFERENCE MANUAL PAGES         SPARK(5)()
  5.  
  6.  
  7.  
  8. NAME
  9.      spark - Archive file format for RISC OS version  of  the  PC
  10.      archiver Arc
  11.  
  12. CONVENTIONS
  13.      Strings are given in ASCII with  C-style  escapes.  No  ter-
  14.      minating   is present if not explicitily included.
  15.  
  16.      Words are 32 bit little-endian numbers.
  17.  
  18.      Half words are 16 bit little-endian numbers.
  19.  
  20.  
  21. FORMAT
  22.      An archive file consists of a sequence  of  archive  marker,
  23.      archive  header  and file data, ie. marker1, header1, data1,
  24.      marker2, header2, data2, etc.  The archive marker is a  sin-
  25.      gle  byte  of value 0x1a (26).  The archive finishes with an
  26.      archive marker followed by a zero byte.
  27.  
  28.      _H_e_a_d_e_r _v_e_r_s_i_o_n _n_u_m_b_e_r
  29.      This tells you how the file data  is  stored  and  how  many
  30.      bytes  there  are  in the header. The header version numbers
  31.      for the PC, are detailed below. An Archimedes header version
  32.      number is identical to the corresponding PC number except it
  33.      has bit 7 set.
  34.           1    Old style, no compression
  35.           2    New style, no compression
  36.           3    Compression of repeated characters only (RLE)
  37.           4    As 3 plus Huffman Squeezing
  38.           5    Lempel-Ziv packing of repeated strings (old style)
  39.           6    Lempel-Ziv packing of repeated strings (new style)
  40.           7    Lempel-Ziv Welch packing with improved hash function
  41.           8    Dynamic Lempel-Ziv packing with adaptive reset
  42.           9    PKARC style squashing
  43.           127  Un*x compression
  44.  
  45.      _F_i_l_e_n_a_m_e
  46.      14 bytes of name, zero terminated.
  47.  
  48.      _C_o_m_p_r_e_s_s_e_d _l_e_n_g_t_h
  49.      Compressed data length, one word.
  50.  
  51.      _D_a_t_e
  52.      One half-word, date.
  53.           year = (date >> 9) & 0x7f;
  54.           month = (date >> 5) & 0x0f;
  55.           day = date & 0x1f;
  56.  
  57.      _T_i_m_e
  58.      One half-word, time.
  59.           hour = (time >> 11) & 0x1f;
  60.  
  61.  
  62.  
  63. Sun Release 4.1           Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SPARK(5)()        MISC. REFERENCE MANUAL PAGES         SPARK(5)()
  71.  
  72.  
  73.  
  74.           minute = (time >> 5)  & 0x3f;
  75.           second = (time & 0x1f) * 2;
  76.  
  77.      The time and date fields are always filled in. If  the  file
  78.      has  a  load  and  exec address, these are the time and date
  79.      when the file was added to the archive otherwise,  they  are
  80.      derived from the Archimedes datestamp. In all extract opera-
  81.      tions on Archimedes format archives,  the  contents  of  the
  82.      load and exec fields take precedence.
  83.  
  84.      _C_R_C
  85.      One half-word, Cyclic Redundancy Check.
  86.  
  87.      _O_r_i_g_i_n_a_l _f_i_l_e _l_e_n_g_t_h
  88.      Original file length, one word, only present if header  type
  89.      greater than 1.
  90.  
  91.      _L_o_a_d _a_d_d_r_e_s_s
  92.      Load address of the file, one word, only present if bit-7 of
  93.      the header version number is set.
  94.  
  95.      _E_x_e_c _a_d_d_r_e_s_s
  96.      Exec address of the file, one word, only present if bit-7 of
  97.      the header version number is set.
  98.  
  99.      _A_t_t_r_i_b_u_t_e_s
  100.      Attributes of the file, one word, only present if  bit-7  of
  101.      the header version number is set.
  102.  
  103.      _C_o_m_p_r_e_s_s_e_d _d_a_t_a...
  104.      Directories are stored  as  non-compressed  archives  within
  105.      archives, ie. their load address & 0xffffff00=0xfffddc.
  106.  
  107.  
  108. COMPATIBILITY
  109.      PC and Archimedes formats may be mixed in  one  archive  for
  110.      use on the Archimedes.
  111.  
  112.  
  113. SEE ALSO
  114.      arcfs(5), nspark(1)
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sun Release 4.1           Last change:                          2
  130.  
  131.  
  132.  
  133.