logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

runfile.8 (2648B)


  1. .\" runfile.8
  2. .\" wcm, 2009.12.11 - 2009.12.15
  3. .\" ===
  4. .TH runfile 8 "January 2013" "runtools-2.07" "runtools"
  5. .SH NAME
  6. runfile \- run a program as specified in an argvfile
  7. .SH SYNOPSIS
  8. .B runfile [\-hV]
  9. .I argvfile
  10. .B [
  11. .I args ...
  12. .B ]
  13. .SH DESCRIPTION
  14. .B runfile
  15. runs a program according to the arguments taken from
  16. .IR argvfile .
  17. .PP
  18. An
  19. .I argvfile
  20. is a plain text file with one or more non-empty lines.
  21. Each line read is taken as an individual element of an argument vector
  22. for a program.
  23. The first element of this argument vector
  24. is required and should name the executable that
  25. .B runfile
  26. will run.
  27. Any additional
  28. .I args
  29. given on the command line will be appended to the arguments
  30. taken from
  31. .IR argvfile .
  32. .PP
  33. .B runfile
  34. trims any leading and/or trailing whitespace from each line read from
  35. .IR argvfile .
  36. Empty lines and lines beginning with the `#' character are ignored.
  37. .PP
  38. If
  39. .I argvfile
  40. is given as a
  41. .RB ` - '
  42. character,
  43. the
  44. .I argvfile
  45. specification will be read from stdin.
  46. .PP
  47. The first element read from the
  48. .I argvfile
  49. will be taken as the executable that
  50. .B runfile
  51. will run
  52. (that is, argv[0]).
  53. If this element does not contain a ``/'' slash character,
  54. .B runfile
  55. will perform a shell-like search for the executable using the
  56. .B PATH
  57. variable in the current environment.
  58. .SH OPTIONS
  59. .TP
  60. .B \-h
  61. Help.
  62. Print a brief usage message to stderr and exit.
  63. .TP
  64. .B \-V
  65. Version.
  66. Print the version number to stderr and exit.
  67. .SH EXIT STATUS
  68. .B runfile
  69. exits with one of the following values:
  70. .TP
  71. 0
  72. The program given in
  73. .I argvfile
  74. was invoked and completed successfully.
  75. In this case,
  76. the exit code is returned by the
  77. program,
  78. rather than by
  79. .B runfile
  80. itself.
  81. .TP
  82. 100
  83. .B runfile
  84. failed because of a usage error,
  85. such as an invalid command\-line option or argument.
  86. In this case,
  87. .B runfile
  88. prints a brief error message and usage help to stderr on exit.
  89. .TP
  90. 111
  91. .B runfile
  92. failed due to some system or resource error.
  93. In this case,
  94. .B runfile
  95. prints a brief diagnostic message to stderr on exit.
  96. .TP
  97. 1\-127
  98. The program given in
  99. .I argvfile
  100. was invoked and failed with its own non-zero exit status.
  101. .SH CAVEATS
  102. In most cases,
  103. the arguments specified in
  104. .I argvfile
  105. will not normally want to follow the shell\-protecting quoting conventions
  106. as might otherwise be used
  107. when running a program in a shell environment.
  108. .SH AUTHOR
  109. Wayne Marshall, http://b0llix.net/perp/
  110. .SH SEE ALSO
  111. .nh
  112. .BR runtools_intro (8),
  113. .BR runargs (8),
  114. .BR runargv0 (8),
  115. .BR runchoom (8),
  116. .BR rundetach (8),
  117. .BR rundeux (8),
  118. .BR runenv (8),
  119. .BR runlimit (8),
  120. .BR runlock (8),
  121. .BR runpause (8),
  122. .BR runsession (8),
  123. .BR runtool (8),
  124. .BR runtrap (8),
  125. .BR runuid (8)
  126. .\" EOF