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

runargv0.8 (1697B)


  1. .\" runargv0.8
  2. .\" wcm, 2009.12.11 - 2012.03.05
  3. .\" ===
  4. .TH runargv0 8 "January 2013" "runtools-2.07" "runtools"
  5. .SH NAME
  6. runargv0 \- run a program with a different 0th argument
  7. .SH SYNOPSIS
  8. .B runargv0 [\-hV]
  9. .I realprog alias
  10. .B [
  11. .I args ...
  12. .B ]
  13. .SH DESCRIPTION
  14. .B runargv0
  15. runs
  16. .I realprog
  17. with the 0th argument set to
  18. .IR alias .
  19. Any options and/or arguments for
  20. .I realprog
  21. may be given in
  22. .IR args .
  23. .PP
  24. If
  25. .I realprog
  26. does not contain a ``/'' slash character,
  27. .B runargv0
  28. will perform a shell-like search for the executable using the
  29. .B PATH
  30. variable in the current environment.
  31. .SH OPTIONS
  32. .TP
  33. .B \-h
  34. Help.
  35. Print a brief usage message to stderr and exit.
  36. .TP
  37. .B \-V
  38. Version.
  39. Print the version number to stderr and exit.
  40. .SH EXIT STATUS
  41. .B runargv0
  42. exits with one of the following values:
  43. .TP
  44. 0
  45. .I realprog
  46. was invoked and completed successfully.
  47. In this case,
  48. the exit code is returned by the
  49. .IR program ,
  50. rather than by
  51. .B runargv0
  52. itself.
  53. .TP
  54. 100
  55. .B runargv0
  56. failed because of a usage error,
  57. such as an invalid command\-line option or argument.
  58. In this case,
  59. .B runargv0
  60. prints a brief error message and usage help to stderr on exit.
  61. .TP
  62. 111
  63. .B runargv0
  64. failed due to some system or resource error.
  65. In this case,
  66. .B runargv0
  67. prints a brief diagnostic message to stderr on exit.
  68. .TP
  69. 1\-127
  70. .I program
  71. was invoked and failed with its own non-zero exit status.
  72. .SH AUTHOR
  73. Wayne Marshall, http://b0llix.net/perp/
  74. .SH SEE ALSO
  75. .nh
  76. .BR runtools_intro (8),
  77. .BR runargs (8),
  78. .BR runchoom (8),
  79. .BR rundetach (8),
  80. .BR rundeux (8),
  81. .BR runenv (8),
  82. .BR runfile (8),
  83. .BR runlimit (8),
  84. .BR runlock (8),
  85. .BR runpause (8),
  86. .BR runsession (8),
  87. .BR runtool (8),
  88. .BR runtrap (8),
  89. .BR runuid (8)
  90. .\" EOF