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
122
123
124
125
126
|
.\" Italian manpages for GNU findutils-4.1.
.\" Copyright (C) 1997 Free Software Foundation, Inc.
.\" Giovanni Bortolozzo <borto@dei.unipd.it>, 1997.
.\"
.\" Traduzione di Giovanni Bortolozzo <borto@dei.unipd.it>
.\" Aprile 1997
.\"
.\"" for hilit19
.TH XARGS 1L
.SH NOME
xargs \- costruisce ed esegue righe di comando dallo standard input
.SH SINTASSI
.B xargs
[\-0prtx] [\-e[eof-str]] [\-i[replace-str]] [\-l[max-righe]]
[\-n max-argomenti] [\-s max-caratteri] [\-P max-processi]
[\-\-null] [\-\-eof[=eof-str]] [\-\-replace[=replace-str]]
[\-\-max-lines[=max-righe]] [\-\-interactive]
[\-\-max-chars=max-caratteri] [\-\-verbose] [\-\-exit]
[\-\-max-procs=max-processi] [\-\-max-args=max-argomenti]
[\-\-no-run-if-empty] [\-\-version] [\-\-help]
[comando [argomenti-iniziali]]
.SH DESCRIZIONE
Questa pagina di manuale documenta la versione GNU di
.BR xargs .
.B xargs
legge dallo standard input argomenti, delimitati da spazi bianchi
(possono essere protetti con virgolette doppie o singole o da
backslash ('\\')) o da caratteri di newline, ed esegue il
.I comando
(che di default è /bin/echo) una o più volte con ognuno degli
.I argomenti-iniziali
seguiti dagli argomenti letti dallo standard input. Sono ignorate le
righe vuote nello standard input.
.P
.B xargs
esce con i seguenti stati:
.nf
0 se ha successo
123 se una qualsiasi chiamata al comando esce con stato 1-125
124 se il comando esce con stato 255
125 se il comando è stato killato da un signal
126 se il comando non può essere eseguito
127 se non è stato trovato il comando
1 se succede qualche altro errore.
.fi
.SS OPZIONI
.TP
.I "\-\-null, \-0"
I nomi di file d'ingresso sono terminati da un carattere null invece
che da un spazio bianco, e le virgolette e i backslash non sono
considerati caratteri speciali (ogni carattere è preso alla
lettera). Disabilita la stringa "end of file", che viene trattata come
un qualsiasi altro argomento. È utile quando gli argomenti possono
contenere spazi bianchi, virgolette o backslash. L'opzione \-print0
della versione GNU di find produce ingressi adatti per questa
modalità.
.TP
.I "\-\-eof[=eof-str], \-e[eof-str]"
Imposta la stringa di fine file a \fIeof-str\fR. Se la stringa di
end of file è presente in una riga dell'ingresso, il resto
dell'ingresso è ignorato. Se \fIeof-str\fR è omessa, non c'è la
stringa di end of file. Se non è data questa opzione, la stringa end
of file di default è "_".
.TP
.I "\-\-help"
Mostra un breve sunto delle opzioni di
.B xargs
ed esce.
.TP
.I "\-\-replace[=stringa-replace], \-i[replace-str]"
Rimpiazza le occorrenze di \fIreplace-str\fP negli argomenti
iniziali con i nomi letti dallo standard input. Inoltre, spazi bianchi
non racchiusi tra virgolette non terminano gli argomenti. Se
\fIreplace-str\fP è omessa, il suo default è "{}" (come per `find
\-exec'). Implica le opzioni \fI\-x\fP e \fI\-l 1\fP.
.TP
.I "\-\-max-lines[=max-righe], -l[max-righe]"
Usa per ogni riga di comando al più \fImax-righe\fR righe di input
non vuote; se omesso il valore di default per \fImax-righe\fR è
1. Dei blank a fine riga fanno sì che la riga d'ingresso sia
logicamente continuata nella riga successiva. Implica \fI\-x\fR.
.TP
.I "\-\-max-args=max-argomenti, \-n max-argomenti"
Usa per ogni riga di comando al più \fImax-argomenti\fR
argomenti. Se la dimensione è superata (si veda l'opzione \-s) saranno
usati meno di \fImax-argomenti\fR argomenti, a meno che non sia
specificata l'opzione \-x, nel qual caso si avrà la terminazione di
\fBxargs\fR.
.TP
.I "\-\-interactive, \-p"
Per ognuna delle righe di comando chiede all'utente se la deve
lanciare e legge una riga dal terminale. Lancerà la riga di comando
solo se la risposta inizia con `y' o `Y'. Implica \fI\-t\fR.
.TP
.I "\-\-no-run-if-empty, \-r"
Se lo standard input non contiene nient'altro che caratteri blank, non
lancia il comando. Solitamente, la riga di comando è lanciata una
volta anche se non c'è l'input.
.TP
.I "\-\-max-chars=max-caratteri, \-s max-caratteri"
Usa per ogni riga di comando al più \fImax-caratteri\fR caratteri,
compreso il comando, gli argomenti iniziali e i terminatori null alla
file delle stringhe argomento. Il default è il più grande possibile,
fino a 20k di caratteri.
.TP
.I "\-\-verbose, \-t"
Mostra la riga di comando nello standard error prima di eseguirla.
.TP
.I "\-\-version"
Mostra il numero di versione di
.B xargs
ed esce.
.TP
.I "\-\-exit, \-x"
Esce se viene superata la dimensione (si veda l'opzione \fI\-s\fR).
.TP
.I "\-\-max-procs=max-processi, \-P max-processi"
Lancia fino a \fImax-processi\fR alla volta; il default è 1. Se
\fImax-processi\fR è 0, \fBxargs\fR lancerà tanti processi alla
volta quanto può. Si usi l'opzione \fI\-n\fR con \fI\-P\fR; altrimenti
c'è la possibilità che sia fatta solo un esecuzione.
.SH "VEDERE ANCHE"
\fBfind\fP(1L), \fBlocate\fP(1L), \fBlocatedb\fP(5L), \fBupdatedb\fP(1)
\fBFinding Files\fP (Info in linea, o stampato)
|