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

rundetach.8 (1750B)


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