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/.