1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
|
.\" {PTM/LK/0.1/27-09-1998/"xargs - utwrz lini polecenia ze standardowego wejscia"}
.\" Tumaczenie: 27-09-1998 ukasz Kowalczyk (lukow@tempac.okwf.fuw.edu.pl)
.TH XARGS 1L \" -*- nroff -*-
.SH NAZWA
xargs \- wykonaj polecenie z argumentami pobranymi ze standardowego wejcia
.SH SKADNIA
.B xargs
[\-0prtx] [\-e[eof-str]] [\-i[replace-str]] [\-l[max-lines]]
[\-n max-args] [\-s max-chars] [\-P max-procs] [\-\-null] [\-\-eof[=eof-str]]
[\-\-replace[=replace-str]] [\-\-max-lines[=max-lines]] [\-\-interactive]
[\-\-max-chars=max-chars] [\-\-verbose] [\-\-exit] [\-\-max-procs=max-procs]
[\-\-max-args=max-args] [\-\-no-run-if-empty] [\-\-version] [\-\-help]
[polecenie [argumenty-pocztkowe]]
.SH OPIS
Ta strona opisuje wersj GNU programu
.BR xargs .
.B xargs
czyta ze standardowego wejcia list argumentw rozdzielonych spacjami lub
znakami nowej linii. Argumenty zawierajce spacje mog by ujte w cudzysowy.
Nastpnie wykonywane jest
.I polecenie
(domylnie /bin/echo) jeden lub wicej razy z
.IR argumentami-pocztkowymi ,
po ktrych nastpuj argumenty przeczytane ze standardowego wejcia. Puste
linie ze standardowego wejcia s ignorowane.
.P
.B xargs
zwraca nastpujce kody wyjcia:
.nf
0 gdy polecenie zakoczyo si sukcesem
123 jeeli ktrekolwiek wywoanie polecenia zakoczyo si z kodem wyjcia 1-125
124 jeeli polecenie zakoczyo si z kodem wyjcia 255
125 jeeli polecenie zostao zakoczone przez sygna
126 jeeli polecenie nie mogo by uruchomione
127 jeeli polecenie nie zostao znalezione
1 jeeli wystpi inny bd
.fi
.SS OPCJE
.TP
.I "\-\-null, \-0"
Nazwy plikw wejciowych s zakoczone znakiem o kodzie zero zamiast spacj,
a cudzysowy i odwrotne ukoniki nie maj specjalnego znaczenia (wszystkie znaki
s brane dosownie). acuch koca pliku jest traktowany jak kady inny.
Opcja jest uyteczna, gdy argumenty mog zawiera biae znaki, cudzysowy,
apostrofy lub odwrotne ukoniki. Ta opcja moe by uyta do pobrania argumentw
od programu GNU find uruchomionego z opcj \-print0.
.TP
.I "\-\-eof[=eof-str], \-e[eof-str]"
Nadaje acuchowi koca pliku warto \fIeof-str\fR. Jeeli
cig oznaczajcy koniec pliku pojawi si w jednej z linii wejciowych, reszta
danych jest ignorowana. Jeeli parametr \fIeof-str\fP nie zostanie podany,
aden cig nie jest interpretowany jako koniec pliku. Jeeli opcja w ogle
nie zostanie podana, znakiem koca danych pliku "_".
.TP
.I "\-\-help"
Podaje wszystkie opcje programu
.B xargs
i koczy dziaanie.
.TP
.I "\-\-replace[=replace-str], \-i[replace-str]"
Zastpuje wszystkie wystpienia \fIreplace-str\fP w
.I pocztkowych_argumentach
argumentami przeczytanym ze standardowego wejcia. Ponadto, niecytowane
odstpy nie separuj argumentw.
.\"Also, unquoted blanks do not terminate arguments.
Jeeli nie podano parametru \fIreplace-str\fP, jego domyln wartoci
staje si "{}" (jak dla opcji -exec programu find). Automatycznie wczane
s opcje \fI\-x\fP oraz \fI\-l 1\fP.
.TP
.I "\-\-max\-lines[=max\-lines], \-l[max\-lines]"
Uywa co najwyej \fImax-lines\fR niepustych linii danych wejciowych na
kady wiersz polece. Jeeli nie podano parametru \fImax-lines\fR, jest on
przyjmowany jako 1. Spacje na kocu linii powoduj, e jest do niej
doczana nastpna linia. Automatycznie wczana jest opcja \fI\-x\fR.
.TP
.I "\-\-max-args=max-args, \-n max-args"
Uywa co najwyej \fImax-args\fR argumentw na kady wiersz polece. Jeeli
przekroczona zostanie ilo znakw (patrz opcja \-s), uytych zostanie mniej
argumentw ni \fImax-args\fR, chyba e podana zostanie opcja \-x. W takim
wypadku dziaanie programu
.I xargs
zostanie zakoczone.
.TP
.I "\-\-interactive, \-p"
Prosi uytkownika o potwierdzenie przed uruchomieniem kadego wiersza polece
i przeczytaniem danych z terminala. Uruchamia wiersz polece tylko wtedy, gdy
odpowied zaczyna si od `y' lub `Y'. Automatycznie wcza opcj \fI\-t\fR.
.TP
.I "\-\-no-run-if-empty, \-r"
Jeeli w danych ze standardowego wejcia nie znajduj si znaki inne ni
spacje, polecenie nie jest uruchamiane. Normalnie polecenie jest uruchamiane
jednorazowo, nawet gdy nie odczytano adnych danych.
.TP
.I "\-\-max-chars=max-chars, \-s max-chars"
Uywa co najwyej \fImax-chars\fR znakw na kady wiersz polece, wcznie z
poleceniem, argumentami pocztkowymi i znakami \\0 (null) na kocu kadego
wiersza polece. Domylna warto jest tak dua, jak to moliwe, do 20k znakw.
.TP
.I "\-\-verbose, \-t"
Wiersz polece jest wypisywany na standardowe wyjcie bdw przed wykonaniem
polecenia.
.TP
.I "\-\-version"
Wypisuje numer wersji
.I xargs
i koczy dziaanie programu.
.TP
.I "\-\-exit, \-x"
Koczy dziaanie programu, jeeli przekroczona zostanie ilo znakw (patrz
opcja \fI\-s\fR).
.TP
.I "\-\-max-procs=max-procs, \-P max-procs"
Uruchamia co najwyej \fImax-procs\fR procesw za jednym razem; domyln
wartoci jest 1. Jeeli \fImax-procs\fR jest rwne 0,
.I xargs
uruchomi tyle procesw, ile bdzie to moliwe za jednym razem.
Uywaj opcji \fI\-n\fR razem z \fI\-P\fR; w przeciwnym razie jest moliwe,
e uruchomiony zostanie tylko jeden dodatkowy proces.
.SH "ZOBACZ TAKE"
\fBfind\fP(1L), \fBlocate\fP(1L), \fBlocatedb\fP(5L), \fBupdatedb\fP(1)
\fBZnajdowanie plikw\fP (w dokumentacji Info lub wydane w druku)
|
