NAZWA¶
ar - utwórz, modyfikuj i ekstrahuj z archiwów.
SKŁADNIA¶
ar [
-]
{dmpqrtx}[abcilosuvV]
[
nazwaczłonka ]
archiwum pliki...
OPIS¶
Uwaga! To tłumaczenie może być nieaktualne!
Wersja GNU narzędzia
ar tworzy, modyfikuje i wyciąga pliki z
archiwów.
archiwum jest pojedynczym plikiem, zawierającym
zbiór innych plików w strukturze, która umożliwia
wyciągnięcie plików oryginalnych (zwanych
członkami
archiwum).
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 zachowania kompatybilności z innymi
narzędziami). Jeśli limit 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
archiwa są najczęściej używane jako
biblioteki
(statyczne) zawierające naczęściej używane funkcje.
Jeśli podasz modyfikator '
s',
ar będzie tworzył
indeks do symboli zdefiniowanych w relokowalnych modułach 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
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ę (opcjonalnie 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ć.
OPCJE¶
GNU
ar umożliwia ci mieszanie kodu operacji
p i flag
modyfikacji
mod w dowolnej kolejności w obrębie pierwszego
argumentu 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 standardowe wyjście. Jeśli został podany
modyfikator`v' , to przed skopiowaniem zawartości członka
na standardowe 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ę operację; nowi członkowie zawsze
są dodwani na końcu archiwum.
Modyfikator `v' powoduje, że ar listuje każdy plik,
który doda.
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 operacja 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ę kompletnego 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.
Za literą kluczową
p może znajdować się pewna
liczba modyfikatoró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ę
istniejącego członka archiwum -- membername.
- b
- Dodaj nowe pliki przed istniejącym
członkiem archiwum. 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 tworzone jeżeli nie istniało, a żądasz
odnowienia (update). 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
archiwa mogą być niekompatybilne z natywnymi programami
ar niektórych innych systemów. Jeśli jest to
istotne, 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 archiwum. Jeśli używasz modyfikatora i, to
przed podaniem 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, pliki
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
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 istniejących
członków o tych samych nazwach, użyj tego modyfikatora.
Modyfikator `u' jest dozwolony tylko przy operacji `r'
(podmienienia). W praktyce kombinacja `qu' nie jest dozwolona,
ponieważ sprawdzanie timestampów spowodowałoby spowolnienie
wszystkich ulepszeń operacji `q'.
- v
- Ten modyfikator żąda wersji operacji, która
wypisuje komunikaty informacyjne . Wiele operacji wyświetla
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 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 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 conditions for modified versions, except
that this permission notice may be included in translations approved by the
Free Software Foundation instead of in the original English.
Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu
Tłumaczenia Manuali i
może nie być aktualne. W razie
zauważenia różnic między powyższym opisem a
rzeczywistym zachowaniem opisywanego programu lub funkcji, prosimy o
zapoznanie się z oryginalną (angielską) wersją strony
podręcznika za pomocą polecenia:
- man --locale=C 1 ar
Prosimy o pomoc w aktualizacji stron man - więcej informacji można
znaleźć pod adresem
http://sourceforge.net/projects/manpages-pl/.