


XARGS(1L)                                               XARGS(1L)


NNAAMMEE
       xargs  -  build  and  execute  command lines from standard
       input

SSYYNNOOPPSSIISS
       xxaarrggss [-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] [command
       [initial-arguments]]

DDEESSCCRRIIPPTTIIOONN
       This manual page  documents  the  GNU  version  of  xxaarrggss.
       xxaarrggss  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.

       xxaarrggss 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.

   OOPPTTIIOONNSS
       _-_-_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).   However,  any  end  of file string is
              still recognized.  Useful with the GNU find -print0
              option  when  filenames  might contain white space,
              quote marks, or backslashes.

       _-_-_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  "_".

       _-_-_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.   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.




                                                                1





XARGS(1L)                                               XARGS(1L)


       _-_-_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 xxaarrggss 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.   The
              default  is as large as possible, up to 20k charac-
              ters.

       _-_-_v_e_r_b_o_s_e_, _-_t
              Print the command line on the standard error output
              before executing it.

       _-_-_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, xxaarrggss 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.

       The  long-named options can be introduced with `+' as well
       as `--', for compatibility with previous releases.   Even-
       tually  support  for  `+'  will  be removed, because it is
       incompatible with the POSIX.2 standard.










                                                                2


