Skip to content

Document PUN shutdown waiting and safe cleanup recovery - #1440

Draft
GlazerMann wants to merge 1 commit into
OSC:latestfrom
GlazerMann:document-pun-shutdown-and-cleanup
Draft

GlazerMann wants to merge 1 commit into
OSC:latestfrom
GlazerMann:document-pun-shutdown-and-cleanup

Conversation

@GlazerMann

Copy link
Copy Markdown

Describe the PUN lifecycle and cleanup behavior introduced by OSC/ondemand#5951.
The command reference now explains waiting for both PID and socket removal,
timeout/retry behavior, PID validation, conservative stale-state recovery,
disabled-user pending records, account-lookup risks and operator recovery.
--force ignores connection counts while retaining safety checks; a printed user
name is not proof that cleanup succeeded.

This documentation depends on OSC/ondemand#5951. Publish it with the release that
contains that implementation. The patch is based on develop at
c58ec11f7dd796f0a7be77ba7664aaa5a9355501, following this repository's README.

Validation: both changed pages build with Sphinx 9.1.1 using -n -W in a focused
project; patch application and whitespace checks pass. The full documentation
site/container build and spelling workflow still need repository CI. This PR
adds documentation and makes no claim of completing live nginx/Passenger tests.

AI tools assisted with drafting and validation; the submitter must review and
take responsibility for the contribution under the project's requirements.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant