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

runpause.8 (2613B)

    

  1. .\" runpause.8
  2. .\" wcm, 2009.12.11 - 2011.03.11
  3. .\" ===
  4. .TH runpause 8 "January 2013" "runtools-2.07" "runtools"
  5. .SH NAME
  6. runpause \- run a program after a specified delay
  7. .SH SYNOPSIS
  8. .B runpause [\-hV] [\-L
  9. .I label
  10. .B ]
  11. .I secs program
  12. .B [
  13. .I args ...
  14. .B ]
  15. .SH DESCRIPTION
  16. .B runpause
  17. sleeps for
  18. .I secs
  19. (or until interrupted by a signal),
  20. and then runs
  21. .I program
  22. with any arguments given in 
  23. .IR args .
  24. .PP
  25. If
  26. .I secs
  27. is 0,
  28. .B runpause
  29. will pause forever,
  30. or until interrupted by a signal.
  31. .PP
  32. If
  33. .I program
  34. does not contain a ``/'' slash character,
  35. .B runpause
  36. will perform a shell-like search for the executable using the
  37. .B PATH
  38. variable in the current environment.
  39. .SH OPTIONS
  40. .TP
  41. .B \-h
  42. Help.
  43. Print a brief usage message to stderr and exit.
  44. .TP
  45. .B \-L label
  46. Label.
  47. May be used to provide
  48. .I label
  49. as a distinctive command-line marker for an instance of
  50. .BR runpause ,
  51. such as for reference in
  52. .BR ps (1)
  53. listings.
  54. Otherwise, this option has no effect.
  55. .TP
  56. .B \-V
  57. Version.
  58. Print the version number to stderr and exit.
  59. .SH EXAMPLES
  60. The
  61. .B runpause
  62. utility may be used to hack a
  63. .BR perpetrate (5)
  64. service out of what would normally be a system initialization:
  65. .PP
  66. .RS
  67. .nf
  68. #!/bin/sh
  69. exec 2>&1
  71. if test ${1} = 'start' ; then
  72.   # startup network:
  73.   echo "starting network ..."
  74.   ifconfig ...
  75.   # maintain persistent state for this service:
  76.   exec runpause -L network 0 /bin/true
  77. fi
  79. if test ${1} = 'reset' ; then
  80.   # take down network and whatever depends on it:
  81.   echo "resetting network ..."
  82.   ...
  83. fi
  85. ### EOF
  86. .fi
  87. .RE
  88. .PP
  89. The author does not recommend this sort of thing
  90. and will never mention it again.
  91. .SH EXIT STATUS
  92. .B runpause
  93. exits with one of the following values:
  94. .TP
  95. 0
  96. .I program
  97. was invoked and completed successfully.
  98. In this case,
  99. the exit code is returned by the
  100. .IR program ,
  101. rather than by
  102. .B runpause
  103. itself.
  104. .TP
  105. 100
  106. .B runpause
  107. failed because of a usage error,
  108. such as an invalid command\-line option or argument.
  109. In this case,
  110. .B runpause
  111. prints a brief error message and usage help to stderr on exit.
  112. .TP
  113. 111
  114. .B runpause
  115. failed due to some system or resource error.
  116. In this case,
  117. .B runpause
  118. prints a brief diagnostic message to stderr on exit.
  119. .TP
  120. 1\-127
  121. .I program
  122. was invoked and failed with its own non-zero exit status.
  123. .SH AUTHOR
  124. Wayne Marshall, http://b0llix.net/perp/
  125. .SH SEE ALSO
  126. .nh
  127. .BR runtools_intro (8),
  128. .BR runargs (8),
  129. .BR runargv0 (8),
  130. .BR runchoom (8),
  131. .BR rundetach (8),
  132. .BR rundeux (8),
  133. .BR runenv (8),
  134. .BR runfile (8),
  135. .BR runlimit (8),
  136. .BR runlock (8),
  137. .BR runsession (8),
  138. .BR runtool (8),
  139. .BR runtrap (8),
  140. .BR runuid (8),
  141. .BR perpd (8),
  142. .BR perpetrate (5)
  143. .\" EOF