GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
runfile(8) runtools runfile(8)

runfile - run a program as specified in an argvfile

runfile [-hV] argvfile [ args ... ]

runfile runs a program according to the arguments taken from argvfile.

An argvfile is a plain text file with one or more non-empty lines. Each line read is taken as an individual element of an argument vector for a program. The first element of this argument vector is required and should name the executable that runfile will run. Any additional args given on the command line will be appended to the arguments taken from argvfile.

runfile trims any leading and/or trailing whitespace from each line read from argvfile. Empty lines and lines beginning with the `#' character are ignored.

If argvfile is given as a `-' character, the argvfile specification will be read from stdin.

The first element read from the argvfile will be taken as the executable that runfile will run (that is, argv[0]). If this element does not contain a ``/'' slash character, runfile will perform a shell-like search for the executable using the PATH variable in the current environment.

-h
Help. Print a brief usage message to stderr and exit.
-V
Version. Print the version number to stderr and exit.

runfile exits with one of the following values:
0
The program given in argvfile was invoked and completed successfully. In this case, the exit code is returned by the program, rather than by runfile itself.
100
runfile failed because of a usage error, such as an invalid command-line option or argument. In this case, runfile prints a brief error message and usage help to stderr on exit.
111
runfile failed due to some system or resource error. In this case, runfile prints a brief diagnostic message to stderr on exit.
1-127
The program given in argvfile was invoked and failed with its own non-zero exit status.

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

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

runtools_intro(8), runargs(8), runargv0(8), runchoom(8), rundetach(8), rundeux(8), runenv(8), runlimit(8), runlock(8), runpause(8), runsession(8), runtool(8), runtrap(8), runuid(8)
January 2013 runtools-2.07

Search for    or go to Top of page |  Section 8 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.