Bug 211365 - [patch] fix man page sigaction(2)
Summary: [patch] fix man page sigaction(2)
Status: Closed Not Accepted
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Sevan Janiyan
URL: https://reviews.freebsd.org/D12006
Keywords: patch
Depends on:
Blocks:
 
Reported: 2016-07-25 13:42 UTC by Konstantin Stroykovskiy
Modified: 2017-08-18 16:31 UTC (History)
1 user (show)

See Also:

Attachments
patch for /usr/src/lib/libc/sys/sigaction.2 (802 bytes, patch)
2016-07-25 13:42 UTC, Konstantin Stroykovskiy 		no flags Details | Diff
View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Konstantin Stroykovskiy 2016-07-25 13:42:43 UTC 
Created attachment 172970 [details]
patch for /usr/src/lib/libc/sys/sigaction.2

Man page for sigaction system call does not match the corresponding function definition in /usr/include/sys/signal.h
Comment 1 Sevan Janiyan freebsd_committer freebsd_triage 2017-08-18 16:31:39 UTC 
Comment from the review:

"Note the paragraph below starting with "The above declaration of struct sigaction is not literal.". The man page is inconsistent now.

Also, I don't think applications are supposed to use the __sigaction_u, __sa_handler and __sa_sigaction identifiers.

The definition in the man page could be clarified using a C11 anonymous union, but this cannot be used in the implementation, since we do not want to require using recent compilers and standards to compile application code."

Thank you for the patch & apologies for the long time to respond but it's best if the manual stays as-is.