table of contents
other languages
| XARGS(1) | General Commands Manual | XARGS(1) |
NAZWA¶
xargs - wykonaj polecenie z argumentami pobranymi ze standardowego wejściaSKŁADNIA¶
xargs [ -0prtx] [-E eof-str] [-e[eof-str]] [ --eof[=eof-str]] [ --null] [ -d delimiter] [--delimiter delimiter] [-I replace-str] [-i[replace-str]] [--replace[=replace-str]] [ -l[max-lines]] [-L max-lines] [--max-lines[=max-lines]] [ -n max-args] [ --max-args=max-args] [-s max-chars] [ --max-chars=max-chars] [-P max-procs] [ --max-procs=max-procs] [--interactive] [ --verbose] [--exit] [ --no-run-if-empty] [ --arg-file=file] [--show-limits] [ --version] [--help] [polecenie [początkowe-argumenty]]OPIS¶
Ta strona opisuje wersję GNU programu xargs. xargs 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 nowej linii. Następnie wykonywane jest polecenie (domyślnie /bin/echo) jeden lub więcej razy z argumentami-początkowymi, po których następują argumenty przeczytane ze standardowego wejścia. Puste linie ze standardowego wejścia są ignorowane. Ponieważ nazwy plików pod Uniksem mogą zawierać spacje i znaki nowej linii, to domyślne zachowanie jest często problematyczne: xargs niepoprawnie przetwarza pliki zawierające powyższe znaki. W takich sytuacjach lepiej jest używać opcji -0, co zapobiega takim problemom. Podczas używania tej opcji należy się upewnić, że program, który przetwarza wejście dla xargs także używa znaku null jako separatora. Jeśli na przykład tym programem jest GNU find, to odpowiednia opcja to -print0. Jeśli uruchomione polecenia zakończy się z kodem 255, to xargs 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.OPCJE¶
- --arg-file=file
- -a file
- Czyta elementy z podanego pliku file zamiast ze standardowego wejścia. Jeśli ta opcja jest używane, to standardowe wejście nie jest zmieniane podczas uruchamiania poleceń. W przeciwnym wypadku standardowe wejście jest przekierowywane z /dev/null.
- --null
- -0
- 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 find uruchomionego z opcją -print0.
- --delimiter=delim
- -d delim
- Elementy wejściowe są kończone podanym znakiem. Cudzysłowy i odwrotny ukośnik nie mają specjalnego znaczenia, każdy znak w wejściu jest brany literalnie. Łańcuch końca pliku jest traktowany jak każdy inny argument. Można użyć tej opcji, jeśli wejście składa się z elementów rozdzielonych znakami nowej linii, jednakże zawsze lepiej jest tak zaprojektować swój program, aby można było użyć opcji --null, tam gdzie tylko jest to możliwe. Podany separator może być pojedynczym znakiem, kodem cytującym w stylu C, jak na przykład \n, albo dziesiętnym lub szesnastkowym kodem cytującym. Kody cytujące dziesiętne i szesnastkowe są rozumiane tak, jak to robi polecenie printf. Znaki wielobajtowe nie są wspierane.
- -E eof-str
- Nadaje łańcuchowi końca pliku wartość eof-str. Jeżeli ciąg oznaczający koniec pliku pojawi się w jednej z linii wejściowych, reszta danych jest ignorowana. Jeśli nie użyto opcji -E, ani -e, to łańcuch końca pliku nie jest używany.
- --eof[=eof-str]
- -e[eof-str]
- Opcja jest synonimem opcji -E. Należy zamiast niej używać opcji -E, ponieważ jest zgodna z POSIX-em, podczas gdy ta opcja — nie jest. Jeśli pominięto eof-str, to łańcuch końca pliku nie jest używany. Jeśli nie podano ani opcji -E, ani opcji -e, to łańcuch końca pliku nie jest używany.
- --help
- Podaje wszystkie opcje programu xargs i kończy działanie.
- -I replace-str
- Zastępuje wszystkie wystąpienia replace-str w początkowych-argumentach argumentami przeczytanym ze standardowego wejścia. Ponadto, niecytowane odstępy nie separują argumentów, zamiast nich separatorem jest znak nowej linii. Automatycznie włączane są opcje -x oraz -L 1.
- --replace[=replace-str]
- -i[replace-str]
- Opcja jest synonimem -Ireplace-str, jeśli podano replace-str, lub synonimem -I{} w przeciwnym wypadku. Opcja jest przestarzała, należy zamiast niej używać -I.
- -L max-lines
- Używa co najwyżej max-lines niepustych linii danych wejściowych na każdy wiersz poleceń. Spacje na końcu linii powodują, że jest do niej dołączana następna linia. Automatycznie włączana jest opcja -x.
- --max-lines[=max-lines]
- -l[max-lines]
- Synonim opcji -L. W przeciwieństwie do -L argument max-lines jest opcjonalny; jeśli nie jest podany to jego wartością domyślną jest jeden. Opcja -l jest przestarzała ponieważ standard POSIX wymienia -L zamiast niej.
- --max-args=max-args
- -n max-args
- Używa co najwyżej max-args argumentów na każdy wiersz poleceń. Może zostać użytych mniej argumentów niż max-args, jeśli zostanie przekroczony ich rozmiar (patrz opcja -s), chyba że podana jest opcja -x, w którym to przypadku działanie programu xargs zostanie zakończone.
- --interactive
- -p
- 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 "y" lub "Y". Automatycznie włącza opcję -t.
- --no-run-if-empty
- -r
- 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.
- --max-chars=max-chars
- -s max-chars
- Używa co najwyżej max-chars znaków w każdej linii 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 exec(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.
- --verbose
- -t
- Wiersz poleceń jest wypisywany na standardowe wyjście błędów przed wykonaniem polecenia.
- --version
- Wypisuje numer wersji xargs i kończy działanie programu.
- --show-limits
- Wyświetla ograniczenia na długość linii wiersza poleceń, które są ustanawiane przez system operacyjny, przez xargs w przypadku rozmiaru wewnętrznego bufora lub przez opcję -s. Aby xargs nie zrobił nic poza wyświetleniem ograniczeń, jego wejście powinno być przekierowane z /dev/null (i być może powinna być podana opcja --no-run-if-empty).
- --exit
- -x
- Kończy działanie programu, jeżeli rozmiar zostanie przekroczony (patrz opcja -s).
- --max-procs=max-procs
- -P max-procs
- Uruchamia co najwyżej max-procs procesów za jednym razem; domyślną wartością jest 1. Jeżeli max-procs jest równe 0, xargs uruchomi tyle procesów, ile to będzie możliwe za jednym razem. Opcji -P należy używać razem z opcją -n; w przeciwnym razie jest możliwe, że uruchomiony zostanie tylko jeden dodatkowy proces.
PRZYKŁADY¶
find /tmp -name core -type f -print | xargs /bin/rm -fWyszukuje a następnie usuwa pliki o nazwie core w katalogu /tmp i jego podkatalogach. Proszę zauważyć, że będzie to działać niepoprawnie jeśli którakolwiek z nazw plików zawiera znaki nowej linii lub spacji. find /tmp -name core -type f -print0 | xargs -0 /bin/rm -f
Wyszukuje a następnie usuwa pliki o nazwie core w katalogu /tmp i jego podkatalogach. Nazwy plików są przetwarzane w taki sposób, że nazwy plików lub katalogów zawierające znaki spacji lub nowej linii są poprawnie obsługiwane. find /tmp -depth -name core -type f -delete
Wyszukuje a następnie usuwa pliki o nazwie core w katalogu /tmp i jego podkatalogach. Robi to jednak w sposób bardziej efektywny niż w poprzednim przykładzie (ponieważ nie używa fork(2) i exec(2), żeby uruchomić rm i nie potrzebuje dodatkowego procesu xargs).
cut -d: -f1 < /etc/passwd | sort | xargs echoTworzy zwięzła listę wszystkich użytkowników systemu.
xargs sh -c 'emacs "$@" < /dev/tty' emacsUruchamia minimalną liczbę kopii Emacsa, jeden po drugim, potrzebną do edycji plików wymienionych na standardowym wejściu programu xargs. Przykład ten robi to samo, co opcja -o z BSD, ale w sposób bardziej elastyczny i przenośny.
KOD ZAKOŃCZENIA¶
xargs zwraca następujące kody wyjścia:0, gdy polecenie zakończyło się sukcesem 123, jeżeli którekolwiek wywołanie polecenia zakończyło się z kodem wyjścia 1-125 124, jeżeli polecenie zakończyło się z kodem wyjścia 255 125, jeżeli polecenie zostało zakończone przez sygnał 126, jeżeli polecenie nie mogło być uruchomione 127, jeżeli polecenie nie zostało znalezione 1, jeżeli wystąpił inny błądKody zakończenia większe od 128 są używane przez powłokę do wskazania, że program został zabity przez sygnał.