ar(1) | Narzędzia programistyczne GNU | ar(1) |
ar - utwórz, modyfikuj i ekstrahuj z archiwów.
ar [-]{dmpqrtx}[abcilosuvV] [nazwaczłonka] archiwum pliki...
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ć.
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:
Jeśli podasz modyfikator `v' , to ar wyświetli każdy skasowany moduł.
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.
Jeśli nie podasz żadnych argumentów pliki, wydrukowane zostaną wszystkie pliki archiwum.
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.
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.
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'.
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:
Wpis `binutils' w info; The GNU Binary Utilities, Roland H. Pesch (October 1991). nm(1), ranlib(1).
(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:
Prosimy o pomoc w aktualizacji stron man - więcej informacji można znaleźć pod adresem http://sourceforge.net/projects/manpages-pl/.
5 November 1991 | wsparcie cygnusa |