


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


