.\" -*- coding: UTF-8 -*- .\" -*- nroff -*- .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH XARGS 1 .SH NAZWA xargs \- wykonuje polecenie z argumentami pobranymi ze standardowego wejścia .SH SKŁADNIA \fBxargs\fP .nh [\fIopcje\fP] [\fIpolecenie\fP [\fIargumenty\-początkowe\fP]] .hy . .SH OPIS Ta strona opisuje wersję GNU programu \fBxargs\fP. \fBxargs\fP czyta ze standardowego wejścia listę elementów rozdzielonych spacjami (argumenty je zawierające mogą być ujęte w pojedyncze lub podwójne cudzysłowy albo spacje w argumentach mogą być poprzedzone przez odwrotne ukośniki) lub znakami nowego wiersza. Następnie wykonywane jest \fIpolecenie\fP (domyślnie \fIecho\fP) jeden lub więcej razy z \fIargumentami\-początkowymi\fP, po których następują argumenty przeczytane ze standardowego wejścia. Puste wiersze ze standardowego wejścia są ignorowane. .P Wiersz poleceń dla \fIpolecenia\fP jest budowany aż do momentu osiągnięcia systemowego limitu (chyba że podano opcje \fB\-n\fP i \fB\-L\fP). Podane \fIpolecenie\fP może być wywołane tak wiele razy, jak to potrzebne, aby użyć całą listę elementów wejściowych. Ogólniej, wystąpi znacznie mniej wywołań \fIpolecenia\fP niż było elementów na wejściu. Zwykle daje to znaczącą różnicę w wydajności. W przypadku niektórych poleceń, przydatne okaże się ich wykonanie równolegle; zob. opcja \fB\-P\fP. .P Ponieważ nazwy plików pod Uniksem mogą zawierać spacje i znaki nowego wiersza, to domyślne zachowanie jest często problematyczne: \fBxargs\fP niepoprawnie przetwarza pliki zawierające powyższe znaki. W takich sytuacjach lepiej jest używać opcji \fB\-0\fP, co zapobiega takim problemom. Podczas używania tej opcji należy się upewnić, że program, który przetwarza wejście dla \fBxargs\fP także używa znaku null jako separatora. Jeśli na przykład tym programem jest GNU \fBfind\fP, to odpowiednia opcja to \fB\-print0\fP. .P Jeśli uruchomione polecenia zakończy się z kodem 255, to \fBxargs\fP natychmiast przerwie swoje działanie bez czytania dalszego wejścia. Jeśli się to zdarzy, to na standardowym wyjściu błędów wypisywany jest komunikat błędu. . .SH OPCJE .TP \fB\-0\fP, \fB\-\-null\fP Nazwy plików wejściowych są zakończone znakiem null zamiast spacją, a cudzysłowy i odwrotne ukośniki nie mają specjalnego znaczenia (wszystkie znaki są brane dosłownie). Łańcuch końca pliku jest traktowany jak każdy inny. Opcja jest użyteczna, gdy argumenty mogą zawierać białe znaki, cudzysłowy, apostrofy lub odwrotne ukośniki. Ta opcja może być użyta do pobrania argumentów od programu GNU \fBfind\fP uruchomionego z opcją \fB\-print0\fP. .TP \fB\-a\fP \fIplik\fP, \fB\-\-arg\-file=\fP\fIplik\fP Czyta elementy z podanego \fIpliku\fP zamiast ze standardowego wejścia. Jeśli ta opcja jest używana, to standardowe wejście nie jest zmieniane podczas uruchamiania poleceń. W przeciwnym wypadku standardowe wejście jest przekierowywane z \fI/dev/null\fP. .TP \fB\-\-delimiter=\fP\fIogranicznik\fP, \fB\-d\fP \fIogranicznik\fP Elementy wejściowe są zakończone podanym znakiem. Podany \fIogranicznik\fP może być pojedynczym znakiem, cytowanym znakiem w stylu C, takim jak \fB\en\fP, albo ósemkowym lub szesnastkowym kodem ucieczki. Ósemkowe i szesnastkowe kody ucieczki są interpretowane tak, jak w przypadku polecenia \fBprintf\fP. Nie są obsługiwane znaki wielobajtowe. Przy przetwarzaniu wejścia, znaki cytatu i odwrotny ukośnik nie są znakami specjalnymi; każdy znak wejścia jest przyjmowany dosłownie. Opcja \fB\-d\fP wyłącza wszelkie łańcuchy końca pliku, które są traktowane jak każdy inny argument. Można użyć tej opcji, gdy wejście składa się z elementów oddzielonych znakiem nowego wiersza, aczkolwiek niemal zawsze, lepiej jest zaprojektować swój program, aby używał \fB\-\-null\fP tam, gdzie to możliwe. .TP \fB\-E\fP \fIłańcuch\-końca\-pliku\fP Nadaje łańcuchowi końca pliku wartość \fIłańcuch\-końca\-pliku\fP. Jeżeli ciąg oznaczający koniec pliku pojawi się w jednym z wierszy wejściowych, reszta danych jest ignorowana. Jeśli nie użyto opcji \fB\-E\fP, ani \fB\-e\fP, to łańcuch końca pliku nie jest używany. .TP \fB\-e\fP[\fIłańcuch\-końca\-pliku\fP], \fB\-\-eof\fP[\fB=\fP\fIłańcuch\-końca\-pliku\fP] Opcja jest synonimem opcji \fB\-E\fP. Należy zamiast niej używać opcji \fB\-E\fP, ponieważ jest zgodna z POSIX\-em, podczas gdy ta opcja \[em] nie jest. Jeśli pominięto \fIłańcuch\-końca\-pliku\fP, to łańcuch końca pliku nie jest używany. Jeśli nie podano ani opcji \fB\-E\fP, ani opcji \fB\-e\fP, to łańcuch końca pliku nie jest używany. .TP \fB\-I\fP \fIłańcuch\-do\-zastąpienia\fP Zastępuje wszystkie wystąpienia \fIłańcucha\-do\-zastąpienia\fP w \fIpoczątkowych\-argumentach\fP argumentami przeczytanym ze standardowego wejścia. Ponadto, niecytowane odstępy nie separują argumentów, zamiast nich separatorem jest znak nowego wiersza. Automatycznie włączane są opcje \fB\-x\fP oraz \fB\-L\fP \fI1\fP. .TP \fB\-i\fP[\fIłańcuch\-do\-zastąpienia\fP], \fB\-\-replace\fP[\fB=\fP\fIłańcuch\-do\-zastąpienia\fP] Opcja jest synonimem \fB\-I\fP \fIłańcuch\-do\-zastąpienia\fP, jeśli podano \fIłańcuch\-do\-zastąpienia\fP. Jeśli brak argumentu \fIłańcuch\-do\-zastąpienia\fP, to działa to jak \fB\-I\fP{}. Opcja \fB\-i\fP jest przestarzała, należy zamiast niej używać \fB\-I\fP. .TP \fB\-L\fP \fImaksymalna\-liczba\-wierszy\fP Używa co najwyżej \fImaksymalnej\-liczby\-wierszy\fP niepustych wierszy danych wejściowych na każdy wiersz poleceń. Spacje na końcu wiersza powodują, że jest do niego dołączany następny wiersz. Automatycznie włączana jest opcja \fB\-x\fP. .TP \fB\-l\fP[\fImaksymalna\-liczba\-wierszy\fP], \fB\-\-max\-lines\fP[\fB=\fP\fImaksymalna\-liczba\-wierszy\fP] Synonim opcji \fB\-L\fP. W przeciwieństwie do \fB\-L\fP argument \fImaksymalna\-liczba\-wierszy\fP jest opcjonalny; jeśli nie jest podany to jego wartością domyślną jest jeden. Opcja \fB\-l\fP jest przestarzała ponieważ standard POSIX wymienia \fB\-L\fP zamiast niej. .TP \fB\-n\fP \fImaksymalna\-liczba\-argumentów\fP, \fB\-\-max\-args=\fP\fImaksymalna\-liczba\-argumentów\fP Używa co najwyżej \fImaksymalnej\-liczby\-argumentów\fP na każdy wiersz poleceń. Może zostać użytych mniej argumentów niż \fImaksymalna\-liczba\-argumentów\fP, jeśli zostanie przekroczony ich rozmiar (patrz opcja \fB\-s\fP), chyba że podana jest opcja \fB\-x\fP, w którym to przypadku działanie programu \fBxargs\fP zostanie zakończone. .TP \fB\-P\fP \fImaksymalna\-liczba\-procesów\fP, \fB\-\-max\-procs=\fP\fImaksymalna\-liczba\-procesów\fP Uruchamia do \fImaksymalnej\-liczby\-procesów\fP jednocześnie; domyślnie 1. Jeśli \fImaksymalna\-liczba\-procesów\fP wynosi 0, to \fBxargs\fP uruchomi tak wiele procesów jednocześnie, jak to możliwe. Należy korzystać z opcji \fB\-n\fP lub z opcji \fB\-L\fP razem z \fB\-P\fP; w innym przypadku może się zdarzyć, że będzie uruchomione tylko pojedyncze wykonanie. W trakcie działania \fBxargs\fP, można wysłać jego procesowi sygnał SIGUSR1 aby zwiększyć liczbę równoległych poleceń do uruchomienia, lub SIGUSR2 \[em] aby ją zmniejszyć. Nie można zwiększyć liczby ponad wynikający z implementacji limit (ukazany za pomocą opcji \-\-show\-limits). Liczby nie można zmniejszyć poniżej 1. \fBxargs\fP nigdy nie przerywa swoich poleceń, przy żądaniu zmniejszenia liczby równoległych procesów, program jedynie poczeka, aż więcej niż jedno dotychczasowe polecenie się zakończy, zanim rozpocznie kolejne. \fBxargs\fP zawsze zaczeka na zakończenie wszystkich procesów potomnych, zanim sam się zakończy (lecz zob. USTERKI). Jeśli nie korzysta się z opcji \fB\-P\fP, to \fBxargs\fP nie obsłuży sygnałów SIGUSR1 i SIGUSR2 co oznacza, że zakończą one program (chyba że zostały zablokowane w procesie macierzystym przed uruchomieniem \fBxargs\fP). \fBProszę zauważyć\fP, że to do procesów wywołujących należy poprawne zarządzanie równoległym dostępem do zasobów dzielonych. Przykładowo, jeśli więcej niż jeden z nich spróbuje wypisać na standardowe wyjście, wyjście zostanie utworzone w nieokreślonej (i najprawdopodobniej przemieszanej) kolejności, chyba że procesy w jakiś sposób współpracują ze sobą, aby temu zapobiec. Jednym ze sposobów uniknięcia takich problemów jest korzystanie z jakiegoś typu blokad. Mówiąc ogólnie, blokady zapewnią poprawną kolejność wyjścia, kosztem wydajności. Jeśli koszt zmniejszenia wydajności jest nieakceptowalny, należy doprowadzić do tego, aby każdy proces tworzył wyjście do oddzielnego pliku (lub innego typu oddzielnego zasobu). .TP \fB\-o\fP, \fB\-\-open\-tty\fP Otwiera ponownie standardowe wejście jako \fI/dev/tty\fP w procesie potomnym, przed wykonaniem polecenia. Przydaje się to, gdy \fBxargs\fP ma uruchomić aplikację interaktywną. .TP \fB\-p\fP, \fB\-\-interactive\fP Prosi użytkownika o potwierdzenie przed uruchomieniem każdego wiersza poleceń i przeczytaniem danych z terminala. Uruchamia wiersz poleceń tylko wtedy, gdy odpowiedź zaczyna się od \[Bq]y\[rq] lub \[Bq]Y\[rq]. Automatycznie włącza opcję \fB\-t\fP. .TP \fB\-\-process\-slot\-var=\fP\fInazwa\fP Ustawia zmienną środowiskową \fInazwa\fP na unikalną wartość dla każdego procesu potomnego. Wartości są używane ponownie, po zakończeniu potomków. Może to posłużyć np. jako prymitywny sposób rozłożenia obciążenia. .TP \fB\-r\fP, \fB\-\-no\-run\-if\-empty\fP Jeżeli w danych ze standardowego wejścia nie znajdują się znaki inne niż spacje, polecenie nie jest uruchamiane. Normalnie polecenie jest uruchamiane jednorazowo, nawet gdy nie odczytano żadnych danych. Ta opcja jest rozszerzeniem GNU. .TP \fB\-s\fP \fImaksymalna\-liczba\-znaków\fP, \fB\-\-max\-chars=\fP\fImaksymalna\-liczba\-znaków\fP Używa co najwyżej \fImaksymalnej\-liczby\-znaków\fP w każdym wierszu poleceń, włączając w to polecenie, argumenty początkowe oraz znaki null kończące każdy z łańcuchów argumentów. Największa możliwa wartość zależy od systemu i jest wyliczana jako limit długości argumentów wywołania \fBexec\fP(2) pomniejszony o rozmiar środowiska, następnie pomniejszony o 2048 bajtów. Jeśli wartość ta jest większa niż 128\ KiB, to 128\ KiB jest używane jako wartość domyślna, w przeciwnym wypadku wartością domyślną jest wyliczona wartość maksymalna. 1\ KiB (kibibajt) to 1024 bajty. \fBxargs\fP automatycznie dostosowuje się do silniejszych ograniczeń. .TP \fB\-\-show\-limits\fP Wyświetla ograniczenia na długość wiersza poleceń, które są ustanawiane przez system operacyjny, przez \fBxargs\fP w przypadku rozmiaru wewnętrznego bufora lub przez opcję \fB\-s\fP. Aby \fBxargs\fP nie zrobił nic poza wyświetleniem ograniczeń, jego wejście powinno być przekierowane z \fI/dev/null\fP (i być może powinna być podana opcja \fB\-\-no\-run\-if\-empty\fP). .TP \fB\-t\fP, \fB\-\-verbose\fP Wiersz poleceń jest wypisywany na standardowe wyjście błędów przed wykonaniem polecenia. .TP \fB\-x\fP, \fB\-\-exit\fP Kończy działanie programu, jeżeli rozmiar zostanie przekroczony (patrz opcja \fB\-s\fP). .TP \fB\-\-\fP Rozdziela listę opcji. Następne argumenty, jeśli wystąpią, są traktowane tylko jako argumenty, nawet jeśli rozpoczynają się od \fI\-\fP. Na przykład \fBxargs \-\- \-\-help\fP uruchomi polecenie \fI\-\-help\fP (zlokalizowane w \fIPATH\fP), zamiast wypisać komunikatu pomocy, a \fBxargs \-\- \-\-moje\-polecenie\fP uruchomi polecenie \fI\-\-moje\-polecenie\fP, zamiast odrzucić go jako nierozpoznaną opcję. .TP \fB\-\-help\fP Podaje wszystkie opcje programu \fBxargs\fP i kończy działanie. .TP \fB\-\-version\fP Wypisuje numer wersji \fIxargs\fP i kończy działanie programu. .PP Opcje \fB\-\-max\-lines\fP (\fB\-L\fP, \fB\-l\fP), \fB\-\-replace\fP (\fB\-I\fP, \fB\-i\fP) i \fB\-\-max\-args\fP (\fB\-n\fP) wzajemnie się wykluczają. Jeśli poda się niektóre z nich w tym samym czasie, \fBxargs\fP zwykle użyje opcji podanej w wierszu polecenia jako ostatniej tj. zresetuje ona wartość sprzecznej opcji (podanej wcześniej) na jej wartość domyślną. Dodatkowo \fBxargs\fP wypisze ostrzeżenie na \fIstderr\fP. Wyjątkiem od tej reguły jest specjalna wartość \fImaksymalnej\-liczby\-argumentów\fP równa \fI1\fP (\[Bq]\fB\-n\fP\fI1\fP\[rq]); jest ona ignorowana po opcji \fB\-\-replace\fP i jej aliasach \fB\-I\fP oraz \fB\-i\fP, ponieważ nie prowadzi to do faktycznego konfliktu. . .SH PRZYKŁADY .nf \fBfind /tmp \-name core \-type f \-print | xargs /bin/rm \-f\fP .fi Wyszukuje a następnie usuwa pliki o nazwie \fBcore\fP w katalogu \fB/tmp\fP i jego podkatalogach. Proszę zauważyć, że będzie to działać niepoprawnie jeśli którakolwiek z nazw plików zawiera znaki nowego wiersza lub spacji. .P \fBfind /tmp \-name core \-type f \-print0 | xargs \-0 /bin/rm \-f\fP Wyszukuje a następnie usuwa pliki o nazwie \fBcore\fP w katalogu \fB/tmp\fP i jego podkatalogach. Nazwy plików są przetwarzane w taki sposób, że nazwy plików lub katalogów zawierające znaki spacji lub nowego wiersza są poprawnie obsługiwane. .P \fBfind /tmp \-depth \-name core \-type f \-delete\fP Wyszukuje a następnie usuwa pliki o nazwie \fBcore\fP w katalogu \fB/tmp\fP i jego podkatalogach. Robi to jednak w sposób bardziej efektywny niż w poprzednim przykładzie (ponieważ nie używa \fBfork\fP(2) i \fBexec\fP(2), żeby uruchomić \fBrm\fP i nie potrzebuje dodatkowego procesu \fBxargs\fP). .P .nf \fBcut \-d: \-f1 < /etc/passwd | sort | xargs echo\fP .fi Tworzy zwięzłą listę wszystkich użytkowników systemu. . .SH "STATUS ZAKOŃCZENIA" \fBxargs\fP zwraca następujące statusy zakończenia: .RS .IP 0 jeśli się powiedzie .IP 123 jeśli dowolne z wywołanych poleceń zakończy się ze statusem 1\(en125 .IP 124 jeśli polecenie zakończyło się ze statusem 255 .IP 125 lub polecenie zostało zabite sygnałem .IP 126 jeśli polecenie nie może być uruchomione .IP 127 jeśli nie znaleziono polecenia .IP 1 jeśli wystąpił jakiś inny błąd. .RE .P Kody zakończenia większe od 128 są używane przez powłokę do wskazania, że program został zabity przez sygnał. . .SH "ZGODNOŚĆ ZE STANDARDAMI" Według stanu na wersję 4.2.9 programu GNU xargs, domyślnie \fBxargs\fP nie używa logicznego znacznika końca pliku. Standard POSIX (IEEE Std 1003.1, edycja 2004) na to pozwala. .P Opcje \fB\-l\fP i \fB\-i\fP pojawiają się w wersji standardu POSIX z roku 1997, ale brak ich w wersji z roku 2004. Dlatego powinno się używać zamiast nich opcji \- odpowiednio \- \fB\-L\fP i \fB\-I\fP. .P Opcja \fB\-o\fP jest rozszerzeniem standardu POSIX, mającą na celu lepszą kompatybilność z BSD. .P Standard POSIX pozwala implementacjom na stosowanie limitu rozmiaru argumentów funkcji \fBexec\fP. Limit ten może wynosić tylko 4096 bajtów, włączając w to rozmiar środowiska. Przenośne skrypty nie mogą polegać na tym, że większa wartość jest obsługiwana. Jednakże nie znamy żadnej implementacji, w której to ograniczenie jest tak małe. Można użyć opcja \fB\-\-show\-limits\fP, aby wyświetlić ograniczenia mające zastosowanie do bieżącego systemu. W wersjach \fBxargs\fP do wersji 4.9.0 włącznie, SIGUSR1 i SIGUSR2 nie spowodują zakończenia \fBxargs\fP nawet, gdy nie korzysta się z opcji \fB\-P\fP. . .SH HISTORIA Polecenie \fBxargs\fP zostało wymyślone przez Herba Gellisa w Bell Labs. Więcej informacji w podręczniku Texinfo findutils, w rozdziale \fIFinding Files\fP. . .SH USTERKI Nie jest możliwe używanie \fBxargs\fP w sposób całkowicie bezpieczny, ponieważ zawsze istnieje luka czasowa pomiędzy utworzeniem listy plików wejściowych i użyciem tej listy przez polecenia, które \fBxargs\fP wykonuje. Jeśli inni użytkownicy mają dostęp do systemu, to mogą zmienić stan systemu plików podczas tej luki czasowej, tak żeby wymusić na poleceniach uruchomianych przez \fBxargs\fP wykonywanie akcji na plikach, które nie były zamierzone. Bardziej szczegółową dyskusję dotyczącą tego i podobnych problemów można znaleźć w rozdziale \[Bq]Security Considerations\[rq] dokumentacji texinfo pakietu findutils. Opcja \fB\-execdir\fP polecenia \fBfind\fP często może stanowić bardziej bezpieczną alternatywę. Podczas używania opcji \fB\-I\fP każdy przeczytany wiersz wejściowy jest wewnętrznie buforowany. Oznacza to, że istnieje górne ograniczenie długości wierszy wejściowych akceptowanych przez \fBxargs\fP z opcją \fB\-I\fP. Aby ominąć to ograniczenie można użyć opcji \fB\-s\fP do zwiększenia rozmiaru bufora używanego przez \fBxargs\fP oraz można także użyć dodatkowego wywołania \fBxargs\fP, by zapewnić, że bardzo długie wiersze się nie pojawią. Na przykład: .P \fBjakieśpolecenie | xargs \-s 50000 echo | xargs \-I '{}' \-s 100000 rm '{}'\fP .P Powyższe pierwsze wywołanie \fBxargs\fP nie ma ograniczenia na długość wiersza wejściowego, ponieważ nie używa opcji \fB\-i\fP. Drugie wywołanie \fBxargs\fP ma takie ograniczenia, ale zapewniliśmy, że nigdy nie wystąpi wiersz dłuższy niż obsługiwany. Nie jest to idealne rozwiązanie. Zamiast tego opcja \fB\-i\fP nie powinna wymuszać ograniczenia na długość wiersza \[em] dlatego też ten opis pojawia się w rozdziale USTERKI. Problem nie występuje jeśli wejście pochodzi z programu \fBfind\fP(1), ponieważ wypisuje on tylko jedną nazwę pliku w wierszu. .P W wersjach \fBxargs\fP do wersji 4.9.0 włącznie, \fBxargs \-P\fP zakończyłoby działanie, w chwili gdy niektóre z jego potomków wciąż by działały, jeśli jeden z nich zakończył się ze statusem 255. . .SH ZGŁASZANIE BŁĘDÓW Strona internetowa z pomocą GNU findutils: .br O błędach tłumaczenia programu prosimy poinformować przez .PP Wszelkie inne problemy prosimy zgłaszać za pomocą systemu śledzenia błędów GNU Savannah: .RS .RE Do ogólnej dyskusji na tematy związane z pakietem GNU findutils służy lista dyskusyjna \fIbug\-findutils\fP: .RS .RE . .SH PRAWA AUTORSKIE Copyright \(co 1990\(en2024 Free Software Foundation, Inc. Licencja GPLv3+: GNU GPL w wersji 3 lub późniejszej . .br Jest to wolne oprogramowanie: można je zmieniać i rozpowszechniać. Nie ma ŻADNEJ GWARANCJI, w granicach określonych przez prawo. . .SH "ZOBACZ TAKŻE" \fBfind\fP(1), \fBkill\fP(1), \fBlocate\fP(1), \fBupdatedb\fP(1), \fBfork\fP(2), \fBexecvp\fP(3), \fBlocatedb\fP(5), \fBsignal\fP(7) .PP Pełna dokumentacja: .br albo dostępna lokalnie przez: \fBinfo xargs\fP .PP .SH TŁUMACZENIE Tłumaczenie niniejszej strony podręcznika: Łukasz Kowalczyk , Robert Luberda i Michał Kułach . .PP Niniejsze tłumaczenie jest wolną dokumentacją. Bliższe informacje o warunkach licencji można uzyskać zapoznając się z .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License w wersji 3 .UE lub nowszej. Nie przyjmuje się ŻADNEJ ODPOWIEDZIALNOŚCI. .PP Błędy w tłumaczeniu strony podręcznika prosimy zgłaszać na adres listy dyskusyjnej .MT manpages-pl-list@lists.sourceforge.net .ME .