Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
runargs(8)			   runtools			    runargs(8)

NAME
       runargs - run a program with arguments read from	an argument file

SYNOPSIS
       runargs [-hV] [-i] argfile program [ args ...  ]

DESCRIPTION
       runargs runs program with arguments read	from argfile.

       An  argfile  is	a  plain text file with	zero or	more lines.  Each line
       read is setup as	an individual argument to program in the same order as
       it  is read.  Any leading and/or	trailing whitespace is trimmed.	 Empty
       lines and lines beginning with the `#' character	are ignored.

       If argfile is given as a	`-' character, arguments will  be  taken  from
       stdin.

       Normally	any arguments specified	in args	are setup to precede the argu-
       ments taken from	argfile.  The -i option	may be used to invert this or-
       der.

       If  program does	not contain a ``/'' slash character, runargs will per-
       form a shell-like search	for the	executable using the PATH variable  in
       the current environment.

OPTIONS
       -h     Help.  Print a brief usage message to stderr and exit.

       -i     Insert.	Normally  runargs  sets	 up program with any arguments
	      given in args before those given in argfile.  The	-i option  may
	      be  used	to  invert  this order,	and insert the arguments taken
	      from argfile before any specified	in args.

       -V     Version.	Print the version number to stderr and exit.

EXIT STATUS
       runargs exits with one of the following values:

       0      program was invoked and completed	successfully.  In  this	 case,
	      the exit code is returned	by the program,	rather than by runargs
	      itself.

       100    runargs failed because of	a usage	error, such as an invalid com-
	      mand-line	 option	 or  argument.	In this	case, runargs prints a
	      brief error message and usage help to stderr on exit.

       111    runargs failed due to some system	or resource  error.   In  this
	      case,  runargs  prints  a	 brief diagnostic message to stderr on
	      exit.

       1-127  program was invoked and failed with its own non-zero  exit  sta-
	      tus.

CAVEATS
       In  most	 cases,	 the  arguments	specified in argfile will not normally
       want to follow the shell-protecting quoting conventions as might	other-
       wise be used when running program in a shell environment.

AUTHOR
       Wayne Marshall, http://b0llix.net/perp/

SEE ALSO
       runtools_intro(8),  runargv0(8),	runchoom(8), rundetach(8), rundeux(8),
       runenv(8),   runfile(8),	   runlimit(8),	   runlock(8),	  runpause(8),
       runsession(8), runtool(8), runtrap(8), runuid(8)

runtools-2.07			 January 2013			    runargs(8)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXIT STATUS | CAVEATS | AUTHOR | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=runargs&sektion=8&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help