home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Geek Gadgets 1
/
ADE-1.bin
/
ade-dist
/
findutils-4.1-bin.lha
/
man
/
cat1
/
xargs.1
< prev
Wrap
Text File
|
1996-10-12
|
6KB
|
133 lines
XARGS(1L) XARGS(1L)
NNAAMMEE
xargs - build and execute command lines from standard
input
SSYYNNOOPPSSIISS
xxaarrggss [-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] [--ver-
sion] [--help] [command [initial-arguments]]
DDEESSCCRRIIPPTTIIOONN
This manual page documents the GNU version of xxaarrggss.
xxaarrggss reads arguments from the standard input, delimited
by blanks (which can be protected with double or single
quotes or a backslash) or newlines, and executes the _c_o_m_-
_m_a_n_d (default is /bin/echo) one or more times with any
_i_n_i_t_i_a_l_-_a_r_g_u_m_e_n_t_s followed by arguments read from standard
input. Blank lines on the standard input are ignored.
xxaarrggss exits with the following status:
0 if it succeeds
123 if any invocation of the command exited with status 1-125
124 if the command exited with status 255
125 if the command is killed by a signal
126 if the command cannot be run
127 if the command is not found
1 if some other error occurred.
OOPPTTIIOONNSS
_-_-_n_u_l_l_, _-_0
Input filenames are terminated by a null character
instead of by whitespace, and the quotes and back-
slash are not special (every character is taken
literally). Disables the end of file string, which
is treated like any other argument. Useful when
arguments might contain white space, quote marks,
or backslashes. The GNU find -print0 option pro-
duces input suitable for this mode.
_-_-_e_o_f_[_=_e_o_f_-_s_t_r_]_, _-_e_[_e_o_f_-_s_t_r_]
Set the end of file string to _e_o_f_-_s_t_r. If the end
of file string occurs as a line of input, the rest
of the input is ignored. If _e_o_f_-_s_t_r is omitted,
there is no end of file string. If this option is
not given, the end of file string defaults to "_".
_-_-_h_e_l_p Print a summary of the options to xxaarrggss and exit.
_-_-_r_e_p_l_a_c_e_[_=_r_e_p_l_a_c_e_-_s_t_r_]_, _-_i_[_r_e_p_l_a_c_e_-_s_t_r_]
Replace occurences of _r_e_p_l_a_c_e_-_s_t_r in the initial
arguments with names read from standard input.
1
XARGS(1L) XARGS(1L)
Also, unquoted blanks do not terminate arguments.
If _r_e_p_l_a_c_e_-_s_t_r is omitted, it defaults to "{}"
(like for `find -exec'). Implies _-_x and _-_l _1.
_-_-_m_a_x_-_l_i_n_e_s_[_=_m_a_x_-_l_i_n_e_s_]_, _-_l_[_m_a_x_-_l_i_n_e_s_]
Use at most _m_a_x_-_l_i_n_e_s nonblank input lines per com-
mand line; _m_a_x_-_l_i_n_e_s defaults to 1 if omitted.
Trailing blanks cause an input line to be logically
continued on the next input line. Implies _-_x.
_-_-_m_a_x_-_a_r_g_s_=_m_a_x_-_a_r_g_s_, _-_n _m_a_x_-_a_r_g_s
Use at most _m_a_x_-_a_r_g_s arguments per command line.
Fewer than _m_a_x_-_a_r_g_s arguments will be used if the
size (see the -s option) is exceeded, unless the -x
option is given, in which case xxaarrggss will exit.
_-_-_i_n_t_e_r_a_c_t_i_v_e_, _-_p
Prompt the user about whether to run each command
line and read a line from the terminal. Only run
the command line if the response starts with `y' or
`Y'. Implies _-_t.
_-_-_n_o_-_r_u_n_-_i_f_-_e_m_p_t_y_, _-_r
If the standard input does not contain any non-
blanks, do not run the command. Normally, the com-
mand is run once even if there is no input.
_-_-_m_a_x_-_c_h_a_r_s_=_m_a_x_-_c_h_a_r_s_, _-_s _m_a_x_-_c_h_a_r_s
Use at most _m_a_x_-_c_h_a_r_s characters per command line,
including the command and initial arguments and the
terminating nulls at the ends of the argument
strings. The default is as large as possible, up
to 20k characters.
_-_-_v_e_r_b_o_s_e_, _-_t
Print the command line on the standard error output
before executing it.
_-_-_v_e_r_s_i_o_n
Print the version number of xxaarrggss and exit.
_-_-_e_x_i_t_, _-_x
Exit if the size (see the _-_s option) is exceeded.
_-_-_m_a_x_-_p_r_o_c_s_=_m_a_x_-_p_r_o_c_s_, _-_P _m_a_x_-_p_r_o_c_s
Run up to _m_a_x_-_p_r_o_c_s processes at a time; the
default is 1. If _m_a_x_-_p_r_o_c_s is 0, xxaarrggss will run as
many processes as possible at a time. Use the _-_n
option with _-_P; otherwise chances are that only one
exec will be done.
SSEEEE AALLSSOO
ffiinndd(1L), llooccaattee(1L), llooccaatteeddbb(5L), uuppddaatteeddbb(1) FFiinnddiinngg
FFiilleess (on-line in Info, or printed)
2