home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 4 / FreshFish_May-June1994.bin / bbs / gnu / binutils-1.8.x-bin.lha / man / cat1 / ar.0 next >
Encoding:
Text File  |  1993-12-07  |  9.9 KB  |  265 lines
  1.  
  2.  
  3.  
  4. AR(1)                                                       AR(1)
  5.  
  6.  
  7. NNAAMMEE
  8.        ar - create and maintain library archives
  9.  
  10. SSYYNNOOPPSSIISS
  11.        aarr --dd [[--TTvv]] aarrcchhiivvee ffiillee ......
  12.        aarr --mm [[--TTvv]] aarrcchhiivvee ffiillee ......
  13.        aarr --mm [[--aabbiiTTvv]] ppoossiittiioonn aarrcchhiivvee ffiillee ......
  14.        aarr --pp [[--TTvv]] aarrcchhiivvee [[ffiillee ......]]
  15.        aarr --qq [[--ccTTvv]] aarrcchhiivvee ffiillee ......
  16.        aarr --rr [[--ccuuTTvv]] aarrcchhiivvee ffiillee ......
  17.        aarr --rr [[--aabbcciiuuTTvv]] ppoossiittiioonn aarrcchhiivvee ffiillee ......
  18.        aarr --tt [[--TTvv]] aarrcchhiivvee [[ffiillee ......]]
  19.        aarr --xx [[--oouuTTvv]] aarrcchhiivvee [[ffiillee ......]]
  20.  
  21. DDEESSCCRRIIPPTTIIOONN
  22.        The  _a_r utility creates and maintains groups of files com-
  23.        bined into an archive.  Once an archive has been  created,
  24.        new   files  can  be  added  and  existing  files  can  be
  25.        extracted, deleted, or replaced.
  26.  
  27.        Files are named in the  archive  by  a  single  component,
  28.        i.e.,  if  a  file referenced by a path containing a slash
  29.        (``/'') is archived it will be named by the last component
  30.        of  that  path.  When matching paths listed on the command
  31.        line against file names stored in the  archive,  only  the
  32.        last component of the path will be compared.
  33.  
  34.        All  informational  and error messages use the path listed
  35.        on the command line, if any was specified,  otherwise  the
  36.        name  in  the  archive  is used.  If multiple files in the
  37.        archive have the same name, and paths are  listed  on  the
  38.        command line to ``select'' archive files for an operation,
  39.        only the ffiirrsstt file with a matching name will be selected.
  40.  
  41.        The  normal  use of _a_r is for the creation and maintenance
  42.        of libraries suitable for use with the loader (see  _l_d(1))
  43.        although  it  is  not  restricted  to  this  purpose.  The
  44.        options are as follows:
  45.  
  46.        -a     A positioning modifier used with the options -r and
  47.               -m.   The  files  are  entered  or  moved aafftteerr the
  48.               archive member _p_o_s_i_t_i_o_n, which must be specified.
  49.  
  50.        -b     A positioning modifier used with the options -r and
  51.               -m.   The  files  are  entered  or moved bbeeffoorree the
  52.               archive member _p_o_s_i_t_i_o_n, which must be specified.
  53.  
  54.        -c     Whenever an archive is  created,  an  informational
  55.               message  to  that  effect  is  written  to standard
  56.               error.  If the -c option is specified,  _a_r  creates
  57.               the archive silently.
  58.  
  59.        -d     Delete the specified archive files.
  60.  
  61.  
  62.  
  63.  
  64.                           March 21, 1991                        1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. AR(1)                                                       AR(1)
  71.  
  72.  
  73.        -i     Identical to the -b option.
  74.  
  75.        -m     Move   the   specified  archive  files  within  the
  76.               archive.  If one of the options -a, -b  or  -i  are
  77.               specified,  the files are moved before or after the
  78.               _p_o_s_i_t_i_o_n file in the archive.   If  none  of  those
  79.               options  are  specified, the files are moved to the
  80.               end of the archive.
  81.  
  82.        -o     Set the access and modification times of  extracted
  83.               files  to the modification time of the file when it
  84.               was entered into the archive.  This  will  fail  if
  85.               the  user is not the owner of the extracted file or
  86.               the super-user.
  87.  
  88.        -p     Write the contents of the specified  archive  files
  89.               to the standard output.  If no files are specified,
  90.               the contents of all the files in  the  archive  are
  91.               written in the order they appear in the archive.
  92.  
  93.        -q     (Quickly)   append   the  specified  files  to  the
  94.               archive.  If the  archive  does  not  exist  a  new
  95.               archive  file  is created.  Much faster than the -r
  96.               option, when creating  a  large  archive  piece-by-
  97.               piece,  as  no checking is done to see if the files
  98.               already exist in the archive.
  99.  
  100.        -r     Replace or add the specified files to the  archive.
  101.               If the archive does not exist a new archive file is
  102.               created.  Files that replace existing files do  not
  103.               change  the  order of the files within the archive.
  104.               New files are appended to the archive unless one of
  105.               the options -a, -b or -i is specified.
  106.  
  107.        -T     Select  and/or  name archive members using only the
  108.               first fifteen characters of the archive  member  or
  109.               command  line file name.  The historic archive for-
  110.               mat had sixteen bytes for the name, but  some  his-
  111.               toric  archiver  and  loader  implementations  were
  112.               unable to handle names that used the entire  space.
  113.               This  means  that file names that are not unique in
  114.               their first fifteen characters can subsequently  be
  115.               confused.   A  warning  message  is  printed to the
  116.               standard error output if any file names  are  trun-
  117.               cated.  (See _a_r(5) for more information.)
  118.  
  119.        -t     List the specified files in the order in which they
  120.               appear in the archive, each on a separate line.  If
  121.               no  files  are  specified, all files in the archive
  122.               are listed.
  123.  
  124.        -u     Update files.  When used with the -r option,  files
  125.               in  the  archive  will be replaced only if the disk
  126.               file has a newer modification time than the file in
  127.  
  128.  
  129.  
  130.                           March 21, 1991                        2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. AR(1)                                                       AR(1)
  137.  
  138.  
  139.               the  archive.   When used with the -x option, files
  140.               in the  archive  will  be  extracted  only  if  the
  141.               archive file has a newer modification time than the
  142.               file on disk.
  143.  
  144.        -v     Provide verbose output.  When used with the -d, -m,
  145.               -q  or -x options, _a_r gives a file-by-file descrip-
  146.               tion of the archive modification.  This description
  147.               consists  of  three,  white-space separated fields:
  148.               the option letter, a  dash  (``-'')  and  the  file
  149.               name.   When  used  with the -r option, _a_r displays
  150.               the description as above, but the initial letter is
  151.               an ``a'' if the file is added to the archive and an
  152.               ``r'' if the file replaces a file  already  in  the
  153.               archive.
  154.  
  155.               When  used  with  the  -p  option, the name of each
  156.               printed file is  written  to  the  standard  output
  157.               before the contents of the file, preceded by a sin-
  158.               gle newline character, and followed by two  newline
  159.               characters,   enclosed  in  less-than  (``<'')  and
  160.               greater-than (``>'') characters.
  161.  
  162.               When used with the -t option, _a_r displays  an  ``ls
  163.               -l'' style listing of information about the members
  164.               of the archive.  This listing  consists  of  eight,
  165.               white-space  separated fields: the file permissions
  166.               (see _s_t_r_m_o_d_e(3)), the decimal user and group  ID's,
  167.               separated  by a single slash (``/''), the file size
  168.               (in bytes), the  file  modification  time  (in  the
  169.               _d_a_t_e(1) format ``%b %e %H:%M %Y''), and the name of
  170.               the file.
  171.  
  172.        -x     Extract the  specified  archive  members  into  the
  173.               files  named  by the command line arguments.  If no
  174.               members are  specified,  all  the  members  of  the
  175.               archive are extracted into the current directory.
  176.  
  177.               If  the  file  does not exist, it is created; if it
  178.               does exist, the owner and group will be  unchanged.
  179.               The file access and modification times are the time
  180.               of the extraction (but see  the  -o  option).   The
  181.               file  permissions  will be set to those of the file
  182.               when it was entered into  the  archive;  this  will
  183.               fail  if the user is not the owner of the extracted
  184.               file or the super-user.
  185.  
  186.        The _a_r utility exits 0 on success,  and  >0  if  an  error
  187.        occurs.
  188.  
  189. EENNVVIIRROONNMMEENNTT
  190.        TMPDIR The  pathname of the directory to use when creating
  191.               temporary files.
  192.  
  193.  
  194.  
  195.  
  196.                           March 21, 1991                        3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. AR(1)                                                       AR(1)
  203.  
  204.  
  205. FFIILLEESS
  206.        /tmp          default temporary file directory
  207.  
  208.        ar.XXXXXX     temporary file names
  209.  
  210. CCOOMMPPAATTIIBBIILLIITTYY
  211.        By default, _a_r writes archives that  may  be  incompatible
  212.        with  historic  archives,  as  the format used for storing
  213.        archive members with names longer than fifteen  characters
  214.        has  changed.   This implementation of _a_r is backward com-
  215.        patible with previous versions of _a_r in that it  can  read
  216.        and write (using the -T option) historic archives.  The -T
  217.        option is provided for compatibility  only,  and  will  be
  218.        deleted  in a future release.  See _a_r(5) for more informa-
  219.        tion.
  220.  
  221. SSTTAANNDDAARRDDSS
  222.        The _a_r utility is expected to  offer  a  superset  of  the
  223.        POSIX 1003.2 functionality.
  224.  
  225. SSEEEE AALLSSOO
  226.        ld(1), ranlib(1), strmode(3), ar(5)
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                           March 21, 1991                        4
  263.  
  264.  
  265.