ar(1) Vyvojove prostredky GNU ar(1)
JMENO
ar - tvori nove archivy (knihovny funkci .a - pozn. prekl.), meni
jejich obsah a rozbaluje je na jednotlive soubory
SYNTAXE
ar [-]{dmpqrtx}[abcilosuvV] [clen] archiv soubory...
POPIS
GNU program ar tvori nove archivy, meni jejich obsah a rozbaluje je na
jednotlive soubory. Archiv je jeden soubor, jez obsahuje vice jinych
souboru ve strukture, ktera umoznuje ziskat jednotlive puvodni soubory
(tem rikame clenove archivu).
Obsah puvodniho souboru, jeho pristupova prava, casove priznaky,
vlastnik a skupina je zaznamenana v archivu a muze byt opet nastavena
pri rozbalovani.
GNU ar umi spravovat cleny s libovolnou delkou jmena; ovsem s
prihlednutim na nastaveni ar ve vasem systemu, muze byt delka jmen
clenu omezena (kvuli prenositelnosti archivu na ostatni programove
nastroje). Pokud takove omezeni existuje, limit casto byva 15 znaku
(typicke pro a.out formaty) nebo 16 (typicke pro coff formaty).
ar je pocitan mezi binarni nastroje, protoze archivy jsou uzivany ze-
jmena jako knihovny obsahujici obecne potrebne podprogramy.
ar vytvori rejstrik symbolu definovanych v alokacni tabulce objektovych
modulu v archivu, pokud zadame prepinac 's'. Jakmile je takovy rej-
strik jednou vytvoren, bude aktualizovan vzdy, kdyz ar provede nejakou
zmenu v obsahu archivu (krome operace 'q'). Rejstrik v archivu zrychli
linkovani knihovny a dovoli podprogramum v knihovne, aby se navzajem
volaly bez ohledu na jejich umisteni v archivu.
Muzete pouzit 'nm -s' ci 'nm --print-armap' k vypsani tohoto rejstriku.
Pokud archiv neobsahuje rejstrik, je volana jina forma ar . Pomoci
ranlib lze pridat rejstrik k archivu.
ar potrebuje nejmene dva parametry: klicove pismeno urcujici operaci
(volitelne nasledovane dalsimi klicovymi pismeny urcujicimi modifikato-
ry), a archiv, na kterem ma operaci provest.
Vetsina operaci prijima i nasledujici soubory (argumenty, urcujici jed-
notlive soubory urcene k operaci).
VOLBY
GNU ar vam umoznuje zadat v prvnim parametru prikazove radky kod opera-
ce p a priznaky modifikatoru mod v libovolnem poradi.
Pokud chcete, muze prvni parametr prikazove radky zacinat pomlckou.
Klicove pismeno p urcuje, jaka operace se provede; muze to byt cokoliv
z nasledujicich moznosti, ale musite uvest prave jednu z nich:
d Smaze (delete) moduly z archivu. V parametru soubory zadejte mo-
duly urcene ke smazani; archiv zustane beze zmeny, pokud ne-
zadate zadne soubory.
Kdyz zadate modifikator 'v', ar bude vypisovat moduly, ktere
jsou smazavany.
m Tato operace se pouziva k premisteni (move) clenu archivu.
Poloha clenu v archivu muze mit vliv na to, jak budou linkovany
programy jez uzivaji tuto knihovnu, pokud je nejaky symbol defi-
novan ve vice nez jednom clenu.
Pokud nepouzijete zadne modifikatory s operaci m, kazdy clen
uvedeny v parametru soubory bude presunut na konec archivu;
muzete uvest modifikatory 'a', 'b', ci 'i', abyste je presunuli
na jine misto.
p Vypise (print) urcene cleny (jejich obsah - pozn. prekl.)
archivu na standardni vystup. Pokud uzijete modifikatoru 'v',
ukaze se jmeno modulu pred jeho vypsanim na standardni vystup.
Pokud neuvedete zadne soubory, budou vypsany vsechny z archivu.
q Rychle pridani (quick append); prida soubory na konec archivu,
bez kontroly prepisu.
Modifikatory 'a', 'b', a 'i' nemaji vliv na tuto operaci;
novejsi clenove jsou vzdy pridani na konec archivu.
Modifikator 'v' zpusobi, ze ar vypisuje seznam pridanych sou-
boru.
Protoze smysl teto operace tkvi v jeji rychlosti, rejstrik sym-
bolu archivu neni aktualizovan, i kdyz uz existuje; muzete
pouzit 'ar s' ci ranlib, aby byly nove udaje zaneseny do rej-
striku symbolu.
r Vlozi soubory do archivu (s prepsanim). Tato operace se lisi od
'q' v tom, ze kazdy clen archivu, jehoz jmeno souhlasi se jmenem
nove pridavaneho clena, bude smazan.
Pokud jeden ze souboru vyjmenovanych v parametrusoubory neexis-
tuje, ar vypise chybovou hlasku a necha existujici cleny archivu
s odpovidajicim jmenem v puvodnim stavu.
Novejsi clenove jsou pridani na konec archivu; muzete pouzit je-
den z modifikatoru 'a', 'b', ci 'i' jako zadost o ulozeni na
jine misto, urcene relativne vzhledem k nejakemu existujicimu
clenu archivu.
Modifikator 'v' u teto operace zpusobi, ze pro kazdy pridany
soubor bude na vystup vypsana jedna radka s jednim z pismen 'a'
nebo 'r', jez informuji, zda byl soubor pridan (appended) (zadny
stary clen nebyl vymazan) nebo prepsan (replaced).
t Zobrazi tabulku souboru, ktere obsahuje archiv, nebo ty soubory
ze seznamu soubory, ktere jsou v archivu. Bezne jsou zobrazeny
pouze jmena clenu; pokud chcete videt take pristupova prava,
cas, vlastnika, skupinu a velikost, muzete pouzit modifikator
'v'.
Pokud neuvedete zadne soubory, budou vypsany vsechny soubory
archivu.
Pokud je v archivu (rekneme 'b.a') vice souboru stejneho jmena
(rekneme 'fie'), , 'ar t b.a fie' vypise pouze prvni vyskyt;
chcete-li videt vsechny, musite pozadat o celkovy vypis--v nasem
pripade, 'ar t b.a'.
x Rozbaluje (extract) cleny (vyjmenovane v parametru soubory) z
archivu. U teto operace muzete uzit modifikator 'v', aby ar vy-
pisoval jmena vybalovanych souboru.
Pokud neuvedete zadne soubory, budou rozbaleny vsechny, ktere
archiv obsahuje.
Plno modifikatoru (mod) muze okamzite nasledovat klicove slovo p, aby
upresnily chovani operace:
a Pridej novy soubor za (after) existujiciho clena archivu. Pokud
pouzijete modifikator a, musi byt uvedeno jmeno existujiciho
clena jako parametr clen, pred urcenim archivu.
b Pridej novy soubor pred (before) existujiciho clena archivu.
Pokud pouzijete modifikator b, musi byt uvedeno jmeno exis-
tujiciho clena jako parametr clen, pred urcenim archivu.
(stejne jako 'i').
c Vytvor (create) archiv. Urceny archiv je vytvoren vzdy, kdyz ne-
existuje a vy ho chcete menit. Ale budete varovani, pokud pomoci
tohoto modifikatoru neupozornite, ze ocekavate jeho vytvoreni.
f Zkraceni jmen archivu. ar normalne prijima jmena libovolne
delky. Tak mohou vzniknout archivy, jez nejsou v nekterych sy-
stemech prenositelne na puvodni ar. Pokud je tohle vas pripad,
muzete pouzit modifikator f, aby jmena ukladanych souboru byla
patricne zkracena.
i Pridej novy soubor pred (before) existujiciho clena archivu.
Pokud pouzijete modifikator i, musi byt uvedeno jmeno exis-
tujiciho clena jako parametr clen, pred urcenim archivu.
(stejne jako 'b').
l Tento modifikator bude prijmut, ale nepouzit.
o Zachovej puvodni (original) datum clenu pri rozbalovani. Pokud
tento modifikator neuzijete, rozbalene soubory dostanou casove
razitko odpovidajici casu rozbaleni.
s Vytvor rejstrik archivu nebo aktualizuj existujici rejstrik, i
kdyz nebyly provedeny zadne zmeny archivu. Tento modifikator
muzete pouzit s libovolnou operaci, nebo samostatne (jako
klicove pismeno operace - pozn. prekl.). Spusteni 'ar s' na
archiv ma stejny ucinek, jako pouziti 'ranlib'.
u ar r ... vlozi do archivu vsechny vyjmenovane soubory. Chcete-li
vlozit pouze ty, ktere jsou novejsi nez existujici clenove
stejneho jmena, pouzijte tento modifikator. Modifikator 'u' je
povolen pouze pri operaci 'r' (replace). Konkretne, kombinace
'qu' neni povolena, protoze kontrola casovych razitek by zatra-
tila vyhodu rychlosti operace 'q'.
v Tento modifikator vyvola informativnejsi (verbose) verzi opera-
ce. Mnoho operaci zobrazuje dodatecne informace, jako treba
jmena zpracovavanych souboru, pokud pridate modifikator 'v'.
V Tento modifikator ukaze cislo verze ar.
Dalsi informace
'binutils' polozka v info; The GNU Binary Utilities, Roland H. Pesch
(Rijen 1991). nm(1), ranlib(1).
KOPIROVANI
Nasledujici informace musi byt zachovany v puvodni podobe
Copyright (c) 1991 Free Software Foundation, Inc.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
preserved on all copies.
Permission is granted to copy and distribute modified versions of this
manual under the conditions for verbatim copying, provided that the en-
tire resulting derived work is distributed under the terms of a per-
mission notice identical to this one.
Permission is granted to copy and distribute translations of this ma-
nual into another language, under the above conditions for modified
versions, except that this permission notice may be included in trans-
lations approved by the Free Software Foundation instead of in the ori-
ginal English.
cygnus 9. zari 1998 ar(1)
