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

runsession.8 (1694B)


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