home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / unix / volume25 / listserv5.31 / part01 / doc / farch.nr next >
Encoding:
Text File  |  1991-12-12  |  4.6 KB  |  199 lines
  1.  
  2.  
  3.  
  4. farch(1)                  USER COMMANDS                  farch(1)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      farch - archive files in /usr/server/archives
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      farch [-n] [-b] [-s size] [-a archive] [-d  dir]  [-t  file]
  13.      files
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _f_a_r_c_h is used  to  archive  files  in  /usr/server/archives.
  17.      Archives  reside under that directory as subdirectories; the
  18.      default is _l_i_s_t_s_e_r_v, and it  is  also  the  master  archive.
  19.      Archives are hierarchically structured, and each archive has
  20.      at least two files in its directory:
  21.  
  22.      INDEX
  23.           A list of all subarchives including itself; the  format
  24.           is  one  line  per archive with the archive's name fol-
  25.           lowed by the archive's full path.
  26.  
  27.      DIR  A list of files available from that archive; the format
  28.           is  one  line per file, followed by the number of parts
  29.           it may be split into, followed by the full path to  the
  30.           directory these parts can be found, followed by a short
  31.           descriptive message about the file (optional).
  32.  
  33.      The following command line options are recognized:
  34.  
  35.      -n   Do not split files when archiving them.
  36.  
  37.      -b   Input files  are  binary;  they  are  uuencoded  before
  38.           archived.
  39.  
  40.      -s size
  41.           Specify the maximum _s_i_z_e in kilobytes of  each  of  the
  42.           subparts (default is 64).
  43.  
  44.      -a archive
  45.           Specify the  _a_r_c_h_i_v_e  that  the  input  files  will  be
  46.           archived under (default is listserv).
  47.  
  48.      -d dir
  49.           Specify the _d_i_rectory that the output files are  to  be
  50.           placed  (default  is /usr/server/archives/listserv). If
  51.           the directory does not exist, it will be created.
  52.  
  53.      -t file
  54.           Input files are tarred into _f_i_l_e which is then archived
  55.           (-b flag is automatically turned on).
  56.  
  57. AAAARRRRCCCCHHHHIIIIVVVVIIIINNNNGGGG AAAA FFFFIIIILLLLEEEE
  58.      _f_a_r_c_h by default splits the input files if necessary (or the
  59.      tar  file, if any), into files of maximum size as specified.
  60.  
  61.  
  62.  
  63. Anastasios Kotsikonas                                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. farch(1)                  USER COMMANDS                  farch(1)
  71.  
  72.  
  73.  
  74.      Each part will contain as many complete lines from the  ori-
  75.      ginal  input  file as possible, without exceeding the speci-
  76.      fied size.  Binary  files  are  uuencoded  before  they  are
  77.      archived,  and  all archived files are compressed, if possi-
  78.      ble.
  79.  
  80. AAAADDDDDDDDIIIINNNNGGGG AAAA NNNNEEEEWWWW AAAARRRRCCCCHHHHIIIIVVVVEEEE
  81.      Step 1
  82.           Create a directory under /usr/server/archives with  the
  83.           new archive's name.
  84.  
  85.      Step 2
  86.           Edit    the     master     archive's     index     file
  87.           (/usr/server/archives/listserv/INDEX)  and  add the new
  88.           archive along with its path at the bottom of the  file.
  89.           The  first  line  of  every  INDEX  file  should be the
  90.           archive  that  owns  it.   Also  edit  every   ancestor
  91.           archive's INDEX file, if the new archive is not a child
  92.           of the default.
  93.  
  94.      Step 3
  95.           Create a new INDEX file in the new archive's  directory
  96.           and put an entry for itself.
  97.  
  98.      Step 4
  99.           Create an empty DIR file in the  new  archive's  direc-
  100.           tory.
  101.  
  102. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  103.      Archive src/data and src/data2 under listserv, using a  max-
  104.      imum  file  size of 1K; the output file(s) will be placed in
  105.      /tmp:
  106.  
  107.        % farch -s 1 -d /tmp src/data src/data2
  108.  
  109.      Archive /etc/hosts under archive unix:
  110.  
  111.        % farch -a unix -d /etc /etc/hosts
  112.  
  113.      Tar and archive all files in /usr/src:
  114.  
  115.        % farch -t source /usr/src/*.c
  116.      Descriptive messages about these files  are  added  manually
  117.      into the archive's DIR file.
  118.  
  119. RRRREEEESSSSTTTTRRRRIIIICCCCTTTTIIIIOOOONNNNSSSS
  120.      The input files must use only lower case characters  of  the
  121.      alphabet.
  122.  
  123. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  124.      server(1)
  125.  
  126.  
  127.  
  128.  
  129. Anastasios Kotsikonas                                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. farch(1)                  USER COMMANDS                  farch(1)
  137.  
  138.  
  139.  
  140. AAAAUUUUTTTTHHHHOOOORRRR
  141.      Anastasios C. Kotsikonas, Boston University.
  142.      Copyright (c) 1991, Anastasios Kotsikonas
  143.      Comments to tasos@cs.bu.edu
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  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. Anastasios Kotsikonas                                          3
  196.  
  197.  
  198.  
  199.