mirror of git://git.suckless.org/sbase
51 lines
1.8 KiB
Groff
51 lines
1.8 KiB
Groff
.TH XARGS 1 sbase\-VERSION
|
|
.SH NAME
|
|
xargs \- constuct argument list(s) and execute command
|
|
.SH SYNOPSIS
|
|
.B xargs
|
|
.RB [\-n
|
|
.IR maxargs ]
|
|
.RB [ \-r ]
|
|
.RB [ \-E
|
|
.IR eofstr ]
|
|
.RI [ cmd
|
|
.IR [arg... ] ]
|
|
.SH DESCRIPTION
|
|
xargs reads space, tab, newline and EOF delimited strings from stdin
|
|
and executes the specified cmd with the strings as arguments.
|
|
|
|
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.
|
|
|
|
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
|
|
.TP
|
|
.B \-n maxargs
|
|
Use at most maxargs arguments per command line.
|
|
.TP
|
|
.BI \-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.
|
|
.TP
|
|
.B \-E eofstr
|
|
Use eofstr as a logical EOF marker.
|
|
.SH EXIT STATUS
|
|
xargs exits with one of the following values:
|
|
|
|
0 All invocations of command returned a zero exit
|
|
status.
|
|
123 One or more invocations of command returned a
|
|
nonzero exit status.
|
|
124 The command exited with a 255 exit status.
|
|
125 The command was killed or stopped by a signal.
|
|
126 The command was found but could not be executed.
|
|
127 The command could not be found.
|
|
1 Some other error occurred.
|