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.

INFORMACJE O TŁUMACZENIU

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

wsparcie cygnusa                                 5 November 1991                                           ar(1)