ar(1) Narzdzia programistyczne GNU ar(1)
ar - utwrz, modyfikuj i ekstrahuj z archiww.
ar [-]{dmpqrtx}[abcilosuvV] [nazwaczonka] archiwum pliki...
Wersja GNU narzdzia ar tworzy, modyfikuje i wyciga pliki z archiww.
archiwum jest pojedynczym plikiem, zawierajcym zbir innych plikw w
strukturze, ktra umoliwia wycignicie plikw oryginalnych (zwanych
czonkami archiwum).
Po ekstrakcji, mona odtworzy oryginalne zawartoci plikw, prawa, times-
tampy, wacicieli i grupy.
GNU ar potrafi obsugiwa archiwa, ktrych czonkowie maj nazwy dowolnej
dugoci; zalenie jednak od konfiguracji ar, mona ustawia limit dugoci
nazwy czonka (dla zachowania kompatybilnoci z innymi narzdziami). Jeli
limit istnieje, to jest czsto limitem 15 znakw (typowy dla formatw
zwizanych z a.out) lub 16 (typowe dla formatw zwizanych z coff).
ar jest uwaany za narzdzie binarne, poniewa jego archiwa s najczciej
uywane jako biblioteki (statyczne) zawierajce naczciej uywane funkcje.
Jeli podasz modyfikator 's', ar bdzie tworzy indeks do symboli zdefin-
iowanych w relokowalnych moduach obiektowych archiwum. Raz utworzony
indeks jest odnawiany w archiwum w sytuacji, gdy ar zmieni jego zawarto
(bezpieczne dla operacji 'q' odnawiania). Archiwum z takim indeksem
przyspiesza linkowanie biblioteki i umoliwia funkcjom z biblioteki
woanie siebie nawzajem bez wzgldu na pooenie w archiwum.
Aby wylistowa ten indeks, moesz uy `nm -s' lub `nm --print-armap'. Jeli
archiwum nie ma takiego indeksu, moesz go doda przy uyciu innej formy
ar, nazywajcej si ranlib.
ar wymaga co najmniej dwch argumentw, aby si uruchomi: jednego sowa
kluczowego okrelajcego operacj (opcjonalnie w towarzystwie innych liter
kluczowych, okrelajcych modyfikatory), i nazwy archiwum, na ktrym ma
dziaa.
Wikszo operacji moe take przyjmowa dalsze argumenty plikowe , podajce
konkretne pliki, na ktrych operowa.
GNU ar umoliwia ci mieszanie kodu operacji p i flag modyfikacji mod w
dowolnej kolejnoci w obrbie pierwszego argumentu linii komend.
Jeli sobie yczysz, moesz rozpocz argument linii komend kreseczk.
Litera kluczowa p okrela, jak operacj wykona; moe by dowoln z nastpuj-
cych, lecz tylko jedna naraz:
d Kasuj moduy z archiwum. Nazwy moduw, ktre chcesz skasowa podaj
jako pliki; Jeli nie podasz adnych plikw do kasowania, archiwum
pozostanie nietknite.
Jeli podasz modyfikator `v' , to ar wywietli kady skasowany
modu.
m Uyj tej operacji do przemieszczenia czonkw archiwum.
Kolejno czonkw w archiwum moe by istotna przy linkowaniu bib-
lioteki z programami, kiedy symbol jest zdefiniowany wicej ni w
jednym czonku.
Jeli nie uyto adnych modyfikatorw przy komendzie m, wszyscy
czonkowie, ktrych nazwiesz w argumencie pliki zostan prze-
niesieni na koniec archiwum; Moesz uy modyfikatorw `a', `b', lub
`i' aby przenie je do okrelonego miejsca.
p Wydrukuj okrelonych czonkw archiwum na standardowe wyjcie. Jeli
zosta podany modyfikator`v' , to przed skopiowaniem zawartoci
czonka na standardowe wyjcie, poka jego nazw.
Jeli nie podasz adnych argumentw pliki, wydrukowane zostan
wszystkie pliki archiwum.
q Docz szybko pliki do koca archiwum, bez sprawdzania podmienia-
nia.
Modyfikatory `a', `b', i `i' nie wpywaj na t operacj; nowi
czonkowie zawsze s dodwani na kocu archiwum.
Modyfikator `v' powoduje, e ar listuje kady plik, ktry doda.
Poniewa w tej operacji chodzi o szybko, indeks tablicy symboli
archiwum nie jest odnawiany, nawet jeli ju istnia; moesz uy `ar
s' lub ranlib aby wyjtkowo odnowi indeks tablicy symboli.
r Wstaw pliki do archiwum (z podmienianiem). Ta operacja rni si od
`q' tym, e wszyscy istniejcy czonkowie zostaj usuwani, jeli ich
nazwy odpowiadaj nazwom dodawanym.
Jeli ktry z plikw nazwanych w argumencie pliki nie istnieje, ar
wywietla komunikat o bdzie i zostawia nie rusza czonkw archiwum,
odpowiadajcych tej nazwie.
Domylnie, nowi czonkowie s dodawani na koniec pliku; moesz jed-
nak uy modyfikatorw `a', `b', lub `i' aby zada wstawienia wzgl-
dem jakiego istniejego czonka.
W tej operacji mona uy modyfikatora `v', ktry wywietla po jednej
linijce komentarza dla kadego wczonego pliku, uzupeniajc j jedn
z liter `a' lu `r', wskazujc tak, czy plik zosta dopisany na
kocu (nie skasowano adnego starego czonka) czy zosta pod-
mieniony.
t Wywietl tabelowy listing zawartoci archiwum, lub te z plikw,
wymienionych w argumencie pliki, ktre s obecne w archiwum. Nor-
malnie wywietlana jest tylko nazwa czonka; jeli chcesz zobczy
prawa, timestamp, waciciela, grup i rozmiar, powiniene uy mody-
fikatora `v' .
Jeli nie zostanie podany aden argument pliki, to wylistowane
zostan wszystkie pliki archiwum.
Jeli pod dan nazw w archiwum (powiedzmy `b.a' istnieje wicej ni
jeden plik (powiedzmy `fie'), to `ar t b.a fie' wylistuje tylko
pierwszy z nich; aby zobaczy wszystkie, musisz wyda komend kom-
pletnego listingu --w naszym wypadku, `ar t b.a'.
x Wycignij czonkw (nazwanych w parametrze pliki) z archiwum. Aby
zada, by ar listowa kad nazw podczas jej wycigania, moesz uy
modyfikatora `v'.
Jeli nie podasz adnego parametru pliki, wycignite zostan wszys-
tkie pliki archiwum.
Za liter kluczow p moe znajdowa si pewna liczba modyfikatorw (mod),
ktra wtedy okrela wariacje zachowania tej operacji:
a Dodaj nowe pliki za istniejcym czonkiem archiwum. Jeli uywasz
tego modyfikatora, to musisz przed podaniem archiwum jako argu-
ment poda nazw istniejcego czonka archiwum -- membername.
b Dodaj nowe pliki przed istniejcym czonkiem archiwum. Jeli uywasz
tego modyfikatora, to musisz przed podaniem archiwum poda nazw
istniejcego czonka jako argument membername. (tak samo jak
`i').
c Utwrz archiwum. Podane archiwum jest zawsze tworzone jeeli nie
istniao, a dasz odnowienia (update). Wypisywane jest jednak wt-
edy ostrzeenie, chyba e podasz z gry, e chcesz je utworzy, uywa-
jc tego modyfikatora.
f Skraca nazwy w archiwum. ar normalnie pozwala plikom mie dowoln
dugo. Powoduje to, e archiwa mog by niekompatybilne z natywnymi
programami ar niektrych innych systemw. Jeli jest to istotne,
mona wykorzysta modyfikator f, ktry umoliwia skracanie nazw
plikw podczas wstawiania ich do archiwum.
i Wstaw nowe pliki przed istniejcym czonkiem archiwum. Jeli uywasz
modyfikatora i, to przed podaniem archiwum musisz poda nazw ist-
niejcego czonka archiwum w argumencie membername. (tak samo
jak `b').
l Modyfikator ten jest przyjmowany, lecz nie jest wykorzystywany.
o Chro oryginalne daty czonkw, kiedy ich wycigasz. Jeli nie podasz
tego modyfikatora, pliki wycignite z archiwum bd naznaczone cza-
sem wycigania.
s Zapisz indeks plikw obiektowych do archiwum, lub odnw istniejcy,
nawet jeli w archiwum nic nie zmieniono. Tej flagi modyfikujcej
moesz uy w poczeniu z dowoln operacj, lub samodzielnie.
Uruchamianie `ar s' na archiwum jest rwnowane uruchomieniu na
nim `ranlib'.
u Normalnie, ar r... wstawia wszystkie wylistowane pliki do archi-
wum. Jeli chcesz wstawia tylko te z wymienionych plikw, ktre s
nowsze od istniejcych czonkw o tych samych nazwach, uyj tego
modyfikatora. Modyfikator `u' jest dozwolony tylko przy operacji
`r' (podmienienia). W praktyce kombinacja `qu' nie jest doz-
wolona, poniewa sprawdzanie timestampw spowodowaoby spowolnienie
wszystkich ulepsze operacji `q'.
v Ten modyfikator da wersji operacji, ktra wypisuje komunikaty in-
formacyjne . Wiele operacji wywietla dodatkowe informacje. Np.
informacje takie, jak przetwarzane pliki.
V Ten modyfikator pokazuje wersj programu ar.
Wpis `binutils' w info; The GNU Binary Utilities, Roland H. Pesch (Oc-
tober 1991). nm(1), ranlib(1).
(Autor nie yczy sobie tumaczenia tej noty bez zatwierdzenia FSF)
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 permis-
sion notice identical to this one.
Permission is granted to copy and distribute translations of this manu-
al into another language, under the above conditions for modified ver-
sions, except that this permission notice may be included in transla-
tions approved by the Free Software Foundation instead of in the origi-
nal English.
wsparcie cygnusa 5 November 1991 ar(1)