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

perpstat.8 (2318B)


  1. .\" perpstat.8
  2. .\" wcm, 2009.11.25 - 2011.02.01
  3. .\" ===
  4. .TH perpstat 8 "January 2013" "perp-2.07" "persistent process supervision"
  5. .SH NAME
  6. perpstat \- display current status of
  7. .BR perpd (8)
  8. services
  9. .SH SYNOPSIS
  10. .B perpstat [\-hV] [\-b
  11. .I basedir
  12. .B ]
  13. .I sv
  14. .BI [ sv
  15. .B ...]
  16. .SH DESCRIPTION
  17. .B perpstat
  18. is used to report the current service status of each
  19. .I sv
  20. argument monitored by an active
  21. .BR perpd (8)
  22. supervisor.
  23. .PP
  24. Each argument
  25. .I sv
  26. should be a service definition directory running under the supervision of
  27. .BR perpd (8).
  28. .B perpstat
  29. will look for
  30. .I sv
  31. in the
  32. .I basedir
  33. directory specified with the
  34. .B \-b
  35. option,
  36. or as set in the
  37. .B PERP_BASE
  38. environmental variable,
  39. or in the current directory if neither of the previous is given.
  40. .PP
  41. For each argument
  42. .I sv
  43. found in the base directory,
  44. .B perpstat
  45. queries the
  46. .BR perpd (8)
  47. supervisor for its runtime status.
  48. It then prints information regarding the
  49. .BR perpd (8)
  50. supervisor itself,
  51. the main service,
  52. and its log service (if any),
  53. one line for each process.
  54. .SH OPTIONS
  55. .TP
  56. .B \-b basedir
  57. Base directory.
  58. Sets the base directory containing the service definitions named by the
  59. .I sv
  60. arguments.
  61. If not set,
  62. .B perpstat
  63. will use the value set in the variable PERP_BASE,
  64. or the current directory if neither of these are defined.
  65. On a normal system,
  66. the base directory will be
  67. .IR /etc/perp .
  68. .TP
  69. .B \-h
  70. Help.
  71. Print a brief usage message to stderr and exit.
  72. .TP
  73. .B \-V
  74. Version.
  75. Print the version number to stderr and exit.
  76. .SH EXIT STATUS
  77. .B perpstat
  78. exits with the following values:
  79. .TP
  80. 0
  81. Success.
  82. The
  83. .B perpstat
  84. command successfully processed and reported on each
  85. .I sv
  86. argument given.
  87. Note that this status is returned even if certain problems were found and reported
  88. for individual
  89. .I sv
  90. arguments.
  91. .TP
  92. 100
  93. Usage error.
  94. For unknown options or missing arguments.
  95. Returns 100 and prints a brief diagnostic message to stderr on exit.
  96. .TP
  97. 111
  98. System error.
  99. For system, permission, configuration, and/or resource failures.
  100. Returns 111 and prints a brief diagnostic message to stderr on exit.
  101. .SH AUTHOR
  102. Wayne Marshall, http://b0llix.net/perp/
  103. .SH SEE ALSO
  104. .nh
  105. .BR perp_intro (8),
  106. .BR perpboot (8),
  107. .BR perpctl (8),
  108. .BR perpd (8),
  109. .BR perpetrate (5),
  110. .BR perphup (8),
  111. .BR perpls (8),
  112. .BR perpok (8),
  113. .BR sissylog (8),
  114. .BR tinylog (8)
  115. .\" EOF perpstat.8