The following issue has been SUBMITTED. ====================================================================== https://www.austingroupbugs.net/view.php?id=1475 ====================================================================== Reported By: cmsmith Assigned To: ====================================================================== Project: Issue 8 drafts Issue ID: 1475 Category: System Interfaces Type: Clarification Requested Severity: Editorial Priority: normal Status: New Name: Curtis Smith Organization: User Reference: Section: socket(), shutdown() Page Number: 1898, 1953 Line Number: 61830-61837, 63555 Final Accepted Text: ====================================================================== Date Submitted: 2021-05-19 01:36 UTC Last Modified: 2021-05-19 01:36 UTC ====================================================================== Summary: socket() and shutdown() should refer to close() Description: The socket() function description does not mention that the file descriptor returned should eventually be closed with the close() function. The see-also section mentions several related functions such as shutdown() but omits close(), and a reader may wrongly conclude that the proper way to relinquish the resources obtained through socket() is to merely call shutdown() as the shutdown() description makes no mention of close() as well.
Desired Action: In the shutdown() Application Usage, line 61830, replace "None" with "The file descriptor remains open after shutdown() returns to the calling application." In the "See Also" sections for shutdown() and socket(), add a reference to the close() function. ====================================================================== Issue History Date Modified Username Field Change ====================================================================== 2021-05-19 01:36 cmsmith New Issue 2021-05-19 01:36 cmsmith Name => Curtis Smith 2021-05-19 01:36 cmsmith Section => socket(), shutdown() 2021-05-19 01:36 cmsmith Page Number => 1898, 1953 2021-05-19 01:36 cmsmith Line Number => 61830-61837, 63555 ======================================================================
