


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] [--no-run-if-
       empty] [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).  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').  Causes the command to be exe-
              cuted once per line of input.  Implies _-_x.




                                                                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 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.   The
              default is as large as possible.

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

       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


