ar(1) Narzędzia programistyczne GNU ar(1)


NAZWA
ar - utwórz, modyfikuj i ekstrahuj z archiwów.


SKŁADNIA
ar [-]{dmpqrtx}[abcilosuvV] [nazwaczłonka] archiwum
pliki...


OPIS
Wersja GNU narzędzia ar tworzy, modyfikuje i wyciąga pliki
z archiwów. archiwum jest pojedynczym plikiem, zawier�
ającym zbiór innych plików w strukturze, która umożliwia
wyciągnięcie plików oryginalnych (zwanych członkami archi�
wum).

Po ekstrakcji, można odtworzyć oryginalne zawartości
plików, prawa, timestampy, właścicieli i grupy.

GNU ar potrafi obsługiwać archiwa, których członkowie mają
nazwy dowolnej długości; zależnie jednak od konfiguracji
ar, można ustawiać limit długości nazwy członka (dla za�
chowania kompatybilności z innymi narzędziami). Jeśli lim�
it istnieje, to jest często limitem 15 znaków (typowy dla
formatów związanych z a.out) lub 16 (typowe dla formatów
związanych z coff).

ar jest uważany za narzędzie binarne, ponieważ jego archi�
wa są najczęściej używane jako biblioteki (statyczne) zaw�
ierające naczęściej używane funkcje.

Jeśli podasz modyfikator 's', ar będzie tworzył indeks do
symboli zdefiniowanych w relokowalnych modułach obiek�
towych archiwum. Raz utworzony indeks jest odnawiany w
archiwum w sytuacji, gdy ar zmieni jego zawartość (bez�
pieczne dla operacji 'q' odnawiania). Archiwum z takim
indeksem przyspiesza linkowanie biblioteki i umożliwia
funkcjom z biblioteki wołanie siebie nawzajem bez względu
na położenie w archiwum.

Aby wylistować ten indeks, możesz użyć `nm -s' lub `nm
--print-armap'. Jeśli archiwum nie ma takiego indeksu,
możesz go dodać przy użyciu innej formy ar, nazywającej
się ranlib.

ar wymaga co najmniej dwóch argumentów, aby się uruchomić:
jednego słowa kluczowego określającego operację (opcjonal�
nie w towarzystwie innych liter kluczowych, określających
modyfikatory), i nazwy archiwum, na którym ma działać.

Większość operacji może także przyjmować dalsze argumenty
plikowe , podające konkretne pliki, na których operować.





wsparcie cygnusa 5 November 1991 1





ar(1) Narzędzia programistyczne GNU ar(1)


OPCJE
GNU ar umożliwia ci mieszanie kodu operacji p i flag mody�
fikacji mod w dowolnej kolejności w obrębie pierwszego ar�
gumentu linii komend.

Jeśli sobie życzysz, możesz rozpocząć argument linii
komend kreseczką.

Litera kluczowa p określa, jaką operację wykonać; może być
dowolną z następujących, lecz tylko jedna naraz:


d Kasuj moduły z archiwum. Nazwy modułów, które
chcesz skasować podaj jako pliki; Jeśli nie podasz
żadnych plików do kasowania, archiwum pozostanie
nietknięte.

Jeśli podasz modyfikator `v' , to ar wyświetli
każdy skasowany moduł.


m Użyj tej operacji do przemieszczenia członków
archiwum.

Kolejność członków w archiwum może być istotna przy
linkowaniu biblioteki z programami, kiedy symbol
jest zdefiniowany więcej niż w jednym członku.

Jeśli nie użyto żadnych modyfikatorów przy
komendzie m, wszyscy członkowie, których nazwiesz w
argumencie pliki zostaną przeniesieni na koniec
archiwum; Możesz użyć modyfikatorów `a', `b', lub
`i' aby przenieść je do określonego miejsca.


p Wydrukuj określonych członków archiwum na standard�
owe wyjście. Jeśli został podany modyfikator`v' ,
to przed skopiowaniem zawartości członka na stan�
dardowe wyjście, pokaż jego nazwę.

Jeśli nie podasz żadnych argumentów pliki,
wydrukowane zostaną wszystkie pliki archiwum.


q Dołącz szybko pliki do końca archiwum, bez
sprawdzania podmieniania.

Modyfikatory `a', `b', i `i' nie wpływają na tę op�
erację; nowi członkowie zawsze są dodwani na końcu
archiwum.

Modyfikator `v' powoduje, że ar listuje każdy plik,
który doda.




wsparcie cygnusa 5 November 1991 2





ar(1) Narzędzia programistyczne GNU ar(1)


Ponieważ w tej operacji chodzi o szybkość, indeks
tablicy symboli archiwum nie jest odnawiany, nawet
jeśli już istniał; możesz użyć `ar s' lub ranlib
aby wyjątkowo odnowić indeks tablicy symboli.


r Wstaw pliki do archiwum (z podmienianiem). Ta oper�
acja różni się od `q' tym, że wszyscy istniejący
członkowie zostają usuwani, jeśli ich nazwy
odpowiadają nazwom dodawanym.

Jeśli któryś z plików nazwanych w argumencie pliki
nie istnieje, ar wyświetla komunikat o błędzie i
zostawia nie rusza członków archiwum,
odpowiadających tej nazwie.

Domyślnie, nowi członkowie są dodawani na koniec
pliku; możesz jednak użyć modyfikatorów `a', `b',
lub `i' aby zażądać wstawienia względem jakiegoś
istniejąego członka.

W tej operacji można użyć modyfikatora `v', który
wyświetla po jednej linijce komentarza dla każdego
włączonego pliku, uzupełniając ją jedną z liter `a'
lu `r', wskazując tak, czy plik został dopisany na
końcu (nie skasowano żadnego starego członka) czy
został podmieniony.


t Wyświetl tabelowy listing zawartości archiwum, lub
te z plików, wymienionych w argumencie pliki, które
są obecne w archiwum. Normalnie wyświetlana jest
tylko nazwa członka; jeśli chcesz zobczyć prawa,
timestamp, właściciela, grupę i rozmiar, powinieneś
użyć modyfikatora `v' .

Jeśli nie zostanie podany żaden argument pliki, to
wylistowane zostaną wszystkie pliki archiwum.

Jeśli pod daną nazwą w archiwum (powiedzmy `b.a'
istnieje więcej 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 Wyciągnij członków (nazwanych w parametrze pliki) z
archiwum. Aby zażądać, by ar listował każdą nazwę
podczas jej wyciągania, możesz użyć modyfikatora
`v'.

Jeśli nie podasz żadnego parametru pliki,
wyciągnięte zostaną wszystkie pliki archiwum.




wsparcie cygnusa 5 November 1991 3





ar(1) Narzędzia programistyczne GNU ar(1)


Za literą kluczową p może znajdować się pewna liczba mody�
fikatorów (mod), która wtedy określa wariacje zachowania
tej operacji:


a Dodaj nowe pliki za istniejącym członkiem archiwum.
Jeśli używasz tego modyfikatora, to musisz przed
podaniem archiwum jako argument podać nazwę ist�
niejącego członka archiwum -- membername.


b Dodaj nowe pliki przed istniejącym członkiem archi�
wum. Jeśli używasz tego modyfikatora, to musisz
przed podaniem archiwum podać nazwę istniejącego
członka jako argument membername. (tak samo jak
`i').


c Utwórz archiwum. Podane archiwum jest zawsze twor�
zone jeżeli nie istniało, a żądasz odnowienia (up�
date). Wypisywane jest jednak wtedy ostrzeżenie,
chyba że podasz z góry, że chcesz je utworzyć,
używając tego modyfikatora.


f Skraca nazwy w archiwum. ar normalnie pozwala
plikom mieć dowolną długość. Powoduje to, że archi�
wa mogą być niekompatybilne z natywnymi programami
ar niektórych innych systemów. Jeśli jest to is�
totne, można wykorzystać modyfikator f, który
umożliwia skracanie nazw plików podczas wstawiania
ich do archiwum.


i Wstaw nowe pliki przed istniejącym członkiem archi�
wum. Jeśli używasz modyfikatora i, to przed po�
daniem archiwum musisz podać nazwę istniejącego
członka archiwum w argumencie membername. (tak
samo jak `b').


l Modyfikator ten jest przyjmowany, lecz nie jest
wykorzystywany.


o Chroń oryginalne daty członków, kiedy ich
wyciągasz. Jeśli nie podasz tego modyfikatora, pli�
ki wyciągnięte z archiwum będą naznaczone czasem
wyciągania.


s Zapisz indeks plików obiektowych do archiwum, lub
odnów istniejący, nawet jeśli w archiwum nic nie
zmieniono. Tej flagi modyfikującej możesz użyć w



wsparcie cygnusa 5 November 1991 4





ar(1) Narzędzia programistyczne GNU ar(1)


połączeniu z dowolną operacją, lub samodzielnie.
Uruchamianie `ar s' na archiwum jest równoważne
uruchomieniu na nim `ranlib'.


u Normalnie, ar r... wstawia wszystkie wylistowane
pliki do archiwum. Jeśli chcesz wstawiać tylko te z
wymienionych plików, które są nowsze od ist�
niejących członków o tych samych nazwach, użyj tego
modyfikatora. Modyfikator `u' jest dozwolony tylko
przy operacji `r' (podmienienia). W praktyce kom�
binacja `qu' nie jest dozwolona, ponieważ
sprawdzanie timestampów spowodowałoby spowolnienie
wszystkich ulepszeń operacji `q'.


v Ten modyfikator żąda wersji operacji, która wypisu�
je komunikaty informacyjne . Wiele operacji wyświ�
etla dodatkowe informacje. Np. informacje takie,
jak przetwarzane pliki.


V Ten modyfikator pokazuje wersję programu ar.




ZOBACZ TAKŻE
Wpis `binutils' w info; The GNU Binary Utilities, Roland
H. Pesch (October 1991). nm(1), ranlib(1).


KOPIOWANIE
(Autor nie życzy sobie tłumaczenia tej noty bez za�
twierdzenia 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 ver�
sions of this manual under the conditions for verbatim
copying, provided that the entire resulting derived work
is distributed under the terms of a permission notice
identical to this one.

Permission is granted to copy and distribute translations
of this manual into another language, under the above con�
ditions for modified versions, except that this permission
notice may be included in translations approved by the
Free Software Foundation instead of in the original En�
glish.



wsparcie cygnusa 5 November 1991 5