xargs.1 (2158B)
- .Dd 2015-10-08
- .Dt XARGS 1
- .Os sbase
- .Sh NAME
- .Nm xargs
- .Nd construct argument lists and execute command
- .Sh SYNOPSIS
- .Nm
- .Op Fl rtx
- .Op Fl E Ar eofstr
- .Op Fl n Ar num
- .Op Fl s Ar num
- .Op Ar cmd Op Ar arg ...
- .Sh DESCRIPTION
- .Nm
- reads space, tab, newline and EOF delimited strings from stdin
- and executes the specified
- .Ar cmd
- with the strings as
- .Ar arguments .
- .Pp
- Any arguments specified on the command line are given to the command upon
- each invocation, followed by some number of the arguments read from
- stdin.
- The command is repeatedly executed one or more times until stdin is exhausted.
- .Pp
- Spaces, tabs and newlines may be embedded in arguments using single (`'')
- or double (`"') quotes or backslashes ('\\').
- Single quotes escape all non-single quote characters, excluding newlines, up
- to the matching single quote.
- Double quotes escape all non-double quote characters, excluding newlines, up
- to the matching double quote.
- Any single character, including newlines, may be escaped by a backslash.
- .Sh OPTIONS
- .Bl -tag -width Ds
- .It Fl n Ar num
- Use at most
- .Ar num
- arguments per command line.
- .It Fl r
- Do not run the command if there are no arguments.
- Normally the command is executed at least once even if there are no arguments.
- .It Fl E Ar eofstr
- Use
- .Ar eofstr
- as a logical EOF marker.
- .It Fl s Ar num
- Use at most
- .Ar num
- bytes per command line.
- .It Fl t
- Write the command line to stderr before executing it.
- .It Fl x
- Terminate if the command line exceeds the system limit or the number of bytes
- given with the
- .Op Fl s
- flag.
- .El
- .Sh EXIT STATUS
- .Nm
- exits with one of the following values:
- .Bl -tag -width Ds
- .It 0
- All invocations of
- .Ar cmd
- returned a zero exit status.
- .It 123
- One or more invocations of
- .Ar cmd
- returned a nonzero exit status.
- .It 124
- .Ar cmd
- exited with a 255 exit status.
- .It 125
- .Ar cmd
- was killed or stopped by a signal.
- .It 126
- .Ar cmd
- was found but could not be executed.
- .It 127
- .Ar cmd
- could not be found.
- .It 1
- Some other error occurred.
- .El
- .Sh STANDARDS
- The
- .Nm
- utility is compliant with the
- .St -p1003.1-2013
- specification except from the
- .Op Fl p
- flag.
- .Pp
- The
- .Op Fl r
- flag is an extension to that specification.