Return to ar CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / MULTI

Annotation of coherent/a/usr/man/MULTI/ar, revision 1.1.1.1

1.1       root        1: 
                      2: 
                      3: ar                           Command                           ar
                      4: 
                      5: 
                      6: 
                      7: 
                      8: The librarian/archiver
                      9: 
                     10: aarr _o_p_t_i_o_n [_m_o_d_i_f_i_e_r][_p_o_s_i_t_i_o_n] _a_r_c_h_i_v_e [_m_e_m_b_e_r ...]
                     11: 
                     12: The  librarian  ar edits  and  examines  libraries.  It  combines
                     13: several files into a file called an archive or library.  Archives
                     14: reduce the size of directories and allow many files to be handled
                     15: as a single unit.  The principal use of archives is for libraries
                     16: of object  files.  The linker ld  understands the archive format,
                     17: and  can search  libraries of object  files to  resolve undefined
                     18: references in a program.
                     19: 
                     20: The mandatory  option argument consists  of one of  the following
                     21: command keys:
                     22: 
                     23: dd  Delete  each given member from archive.   The ranlib header is
                     24:    updated if present.
                     25: 
                     26: mm   Move each  given member  within archive.   If no  modifier is
                     27:    given,  move each  member to  the end.   The ranlib  header is
                     28:    modified if present.
                     29: 
                     30: pp  Print each member.  This  is useful only with archives of text
                     31:    files.
                     32: 
                     33: qq  Quick append: append each  member to the end of archive uncon-
                     34:    ditionally.  The ranlib header is not updated.
                     35: 
                     36: rr  Replace  each member of  archive.  If archive  does not exist,
                     37:    create it.  The optional modifier specifies how to perform the
                     38:    replacement,  as  described   below.   The  ranlib  header  is
                     39:    modified if present.
                     40: 
                     41: tt  Print  a table of  contents that lists  each member specified.
                     42:    If none  is given, list all in archive.   The modifier v tells
                     43:    ar to give you additional information.
                     44: 
                     45: xx  Extract each given member and place it into the current direc-
                     46:    tory.  If none  is specified, extract all members.  archive is
                     47:    not changed.
                     48: 
                     49: The modifier may be one of the following.  The modifiers aa, bb, ii,
                     50: and uu may be used only with the m and r options.
                     51: 
                     52: aa  If member does not exist  in archive, insert it after the mem-
                     53:    ber named by the given position.
                     54: 
                     55: bb  If member does not exist in archive, insert it before the mem-
                     56:    ber named by the given position.
                     57: 
                     58: cc  Suppress  the message normally printed when  ar creates an ar-
                     59:    chive.
                     60: 
                     61: 
                     62: 
                     63: 
                     64: COHERENT Lexicon                                           Page 1
                     65: 
                     66: 
                     67: 
                     68: 
                     69: ar                           Command                           ar
                     70: 
                     71: 
                     72: 
                     73: ii  If member does not exist in archive, insert it before the mem-
                     74:    ber named  by the given position.   This is the same  as the b
                     75:    modifier, described above.
                     76: 
                     77: kk  Preserve  the modify time of a file.   This modifier is useful
                     78:    only with the r, q, and x options.
                     79: 
                     80: ss  Modify an archive's ranlib header, or create it if it does not
                     81:    exist.  This is used only with the r, m, and d options.
                     82: 
                     83: uu  Update archive only if member is newer than the version in the
                     84:    archive.
                     85: 
                     86: vv  Generate verbose messages.
                     87: 
                     88: All archives  are written into  a specialized file  format.  Each
                     89: archive starts with  a ``magic number'' called ARMAG, which iden-
                     90: tifies the file as an archive.  The members of the archive follow
                     91: the magic  number; each is preceded by  an ar_hdr structure.  For
                     92: information  on  this  structure,  see  ar.h.  The  structure  is
                     93: followed the  data of the file, which occupy  the number of bytes
                     94: specified by the variable ar_size.
                     95: 
                     96: ***** See Also *****
                     97: 
                     98: ar.h, commands, ld, nm, ranlib
                     99: 
                    100: ***** Notes *****
                    101: 
                    102: It is  recommended that each object-file  library you create with
                    103: ar have a name that begins  with the string lib.  This will allow
                    104: you to call that library with the -l option to the cc command.
                    105: 
                    106: 
                    107: 
                    108: 
                    109: 
                    110: 
                    111: 
                    112: 
                    113: 
                    114: 
                    115: 
                    116: 
                    117: 
                    118: 
                    119: 
                    120: 
                    121: 
                    122: 
                    123: 
                    124: 
                    125: 
                    126: 
                    127: 
                    128: 
                    129: 
                    130: COHERENT Lexicon                                           Page 2
                    131: 
                    132: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.