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

perphup.8 (2102B)

    

  1. .\" perphup.8
  2. .\" wcm, 2009.12.01 - 2013.01.09
  3. .\" ===
  4. .TH perphup 8 "January 2013" "perp-2.07" "persistent process supervision"
  5. .SH NAME
  6. perphup \- trigger a
  7. .BR perpd (8)
  8. rescan
  9. .SH SYNOPSIS
  10. .B perphup [\-hV] [\-q] [\-t] [
  11. .I basedir
  12. .B ]
  13. .SH DESCRIPTION
  14. .B perphup
  15. is used to trigger
  16. .BR perpd (8)
  17. to rescan its service installation directory.
  18. .B perphup
  19. may also be used to trigger the controlled shutdown of
  20. .BR perpd (8)
  21. and all of its services.
  22. .PP
  23. .B perphup
  24. looks for an instance of
  25. .BR perpd (8)
  26. running on the argument given by
  27. .IR basedir .
  28. Otherwise,
  29. .B perphup
  30. looks for a value in the environmental variable PERP_BASE.
  31. If neither of these are defined or are empty,
  32. .B perphup
  33. uses a compiled-in default, normally
  34. .IR /etc/perp .
  35. .PP
  36. When
  37. .B perphup
  38. finds the 
  39. .BR perpd (8)
  40. process, it sends it a SIGHUP signal.
  41. .SH OPTIONS
  42. .TP
  43. .B \-h
  44. Help.
  45. Print a brief usage message to stderr and exit.
  46. .TP
  47. .B \-q
  48. Quiet.
  49. Normally after successfully finding and triggering a
  50. .BR perpd (8)
  51. process,
  52. .B perphup
  53. prints a brief message to stderr.
  54. The
  55. .B \-q
  56. option may be used to suppress this message.
  57. .TP
  58. .B \-t
  59. Term.
  60. Normally
  61. .B perphup
  62. sends a SIGHUP signal to the
  63. .BR perpd (8)
  64. process to trigger a rescan.
  65. The
  66. .B \-t
  67. option is used to send a SIGTERM instead,
  68. and triggers the
  69. .BR perpd (8)
  70. shutdown sequence.
  71. .TP
  72. .B \-V
  73. Version.
  74. Print the version number to stderr and exit.
  75. .SH EXIT STATUS
  76. .B perphup
  77. exits with the following values:
  78. .TP
  79. 0
  80. Success.
  81. An active
  82. .BR perpd (8)
  83. process was found and triggered.
  84. .TP
  85. 100
  86. Usage error.
  87. For unknown options or other command-line errors.
  88. Prints a brief diagnostic message to stderr on exit.
  89. .TP
  90. 111
  91. System error.
  92. Unexpected failures during system calls, privilege and/or resource problems,
  93. or configuration problems in the
  94. .BR perpd (8)
  95. directory.
  96. Prints a brief diagnostic message to stderr on exit.
  97. .SH AUTHOR
  98. Wayne Marshall, http://b0llix.net/perp/
  99. .SH SEE ALSO
  100. .nh
  101. .BR perp_intro (8),
  102. .BR perpboot (8),
  103. .BR perpctl (8),
  104. .BR perpd (8),
  105. .BR perpetrate (5),
  106. .BR perpls (8),
  107. .BR perpok (8),
  108. .BR perpstat (8),
  109. .BR sissylog (8),
  110. .BR tinylog (8)
  111. .\" EOF perphup.8