golang/go

os: please clarify the purpose of Process.Release method

Open

#36.534 aperta il 13 gen 2020

Vedi su GitHub
 (2 commenti) (6 reazioni) (0 assegnatari)Go (19.008 fork)batch import
DocumentationNeedsFixhelp wanted

Metriche repository

Star
 (133.883 star)
Metriche merge PR
 (Nessuna PR mergiata in 30 g)

Descrizione

What version of Go are you using (go version)?

Does this issue reproduce with the latest release?

Yes indeed.

What operating system and processor architecture are you using (go env)?

linux on amd64

What did you do?

Run the code below:

What did you expect to see?

The documentation of Process.Release states:

Release releases any resources associated with the Process p, rendering it unusable in the future. Release only needs to be called if Wait is not.

It leaves a false impression that caller should invoke Release() if the caller does not intend to consume the process exit status - "... only needs to be called if Wait is not", even though doing so leaves a zombie process on the system.

Please clarify that Release() is not intended to replace Wait() at all in the function's description.

Guida contributor