Attachment #27926 for bug #47170

View | Details | Raw Unified | Return to bug 47170
Collapse All | Expand All




.Sh DESCRIPTION
The
.Nm
command reads space, tab, newline and end-of-file delimited strings
from the standard input and executes
.Ar utility
with the strings as
arguments.
.Pp
Any arguments specified on the command line are given to
to the
.Ar utility
upon each invocation, followed by some number of the arguments read
from the standard input of
.Nm .
The utility
is repeatedly executed until standard input is exhausted.
.Pp
Spaces, tabs and newlines may be embedded in arguments using single

will be called with the available lines.
.It Fl n Ar number
Set the maximum number of arguments taken from standard input for each
invocation of
.Ar utility .
An invocation of
.Ar utility
will use less than

arguments will not fit in the specified (or default) command line length.
.El
.Pp
If
.Ar utility
is omitted,
.Xr echo 1
is used.
.Pp

.Pp
The
.Nm
command exits immediately (without processing any further input) if a
command line cannot be assembled,
.Ar utility
cannot be invoked, an invocation of
.Ar utility
is terminated by a signal,
or an invocation of
.Ar utility
exits with a value of 255.
.Sh DIAGNOSTICS
The
.Nm
command exits with a value of 0 if no error occurs.
If
.Ar utility
cannot be found,

.Sh STANDARDS
The
.Nm
command is expected to be
.St -p1003.2
compliant.
The

Return to bug 47170

Lines 62-80 Link Here

(-)/pr/work/xargs.1 (-16 / +20 lines)
62	.Sh DESCRIPTION	62	.Sh DESCRIPTION
63	The	63	The
64	.Nm	64	.Nm
65	utility reads space, tab, newline and end-of-file delimited arguments	65	command reads space, tab, newline and end-of-file delimited strings
66	from the standard input and executes the specified	66	from the standard input and executes
67	.Ar utility	67	.Ar utility
68	with them as	68	with the strings as
69	arguments.	69	arguments.
70	.Pp	70	.Pp
71	The utility and any arguments specified on the command line are given	71	Any arguments specified on the command line are given to
72	to the
73	.Ar utility	72	.Ar utility
74	upon each invocation, followed by some number of the arguments read	73	upon each invocation, followed by some number of the arguments read
75	from standard input.	74	from the standard input of
76	The	75	.Nm .
77	.Ar utility	76	The utility
78	is repeatedly executed until standard input is exhausted.	77	is repeatedly executed until standard input is exhausted.
79	.Pp	78	.Pp
80	Spaces, tabs and newlines may be embedded in arguments using single	79	Spaces, tabs and newlines may be embedded in arguments using single
Lines 175-181 Link Here
175	will be called with the available lines.	174	will be called with the available lines.
176	.It Fl n Ar number	175	.It Fl n Ar number
177	Set the maximum number of arguments taken from standard input for each	176	Set the maximum number of arguments taken from standard input for each
178	invocation of the utility.	177	invocation of
		178	.Ar utility .
179	An invocation of	179	An invocation of
180	.Ar utility	180	.Ar utility
181	will use less than	181	will use less than
Lines 229-237 Link Here
229	arguments will not fit in the specified (or default) command line length.	229	arguments will not fit in the specified (or default) command line length.
230	.El	230	.El
231	.Pp	231	.Pp
232	If no	232	If
233	.Ar utility	233	.Ar utility
234	is specified,	234	is omitted,
235	.Xr echo 1	235	.Xr echo 1
236	is used.	236	is used.
237	.Pp	237	.Pp
Lines 241-255 Link Here
241	.Pp	241	.Pp
242	The	242	The
243	.Nm	243	.Nm
244	utility exits immediately (without processing any further input) if a	244	command exits immediately (without processing any further input) if a
245	command line cannot be assembled,	245	command line cannot be assembled,
246	.Ar utility	246	.Ar utility
247	cannot be invoked, an invocation of the utility is terminated by a signal	247	cannot be invoked, an invocation of
248	or an invocation of the utility exits with a value of 255.	248	.Ar utility
		249	is terminated by a signal,
		250	or an invocation of
		251	.Ar utility
		252	exits with a value of 255.
249	.Sh DIAGNOSTICS	253	.Sh DIAGNOSTICS
250	The	254	The
251	.Nm	255	.Nm
252	utility exits with a value of 0 if no error occurs.	256	command exits with a value of 0 if no error occurs.
253	If	257	If
254	.Ar utility	258	.Ar utility
255	cannot be found,	259	cannot be found,
Lines 269-275 Link Here
269	.Sh STANDARDS	273	.Sh STANDARDS
270	The	274	The
271	.Nm	275	.Nm
272	utility is expected to be	276	command is expected to be
273	.St -p1003.2	277	.St -p1003.2
274	compliant.	278	compliant.
275	The	279	The