Bug 218453

Summary: Update posixoptions to POSIX.1-2018
Product: Documentation Reporter: Enrique Garcia (cquike)
Component: man-pagesAssignee: documentation_man-pages (documentation_man-pages)
Status: NEW ---    
Severity: normal    
Priority: P3    
Hardware: All   
OS: Linux   
Kernel Version: Subsystem:
Regression: No Bisected commit-id:
Attachments: posixoptions upgrade to POSIX.1-2018

Description Enrique Garcia 2024-02-02 19:48:51 UTC
The posixoptions(7) man page shows information from POSIX.1-2001 which would be good to update to POSIX.1-2018 standard. From what I can see the following options are no longer optional and have been moved to the standard base [1]:

AIO - _POSIX_ASYNCHRONOUS_IO - _SC_ASYNCHRONOUS_IO
BAR - _POSIX_BARRIERS - _SC_BARRIERS
CS - _POSIX_CLOCK_SELECTION - _SC_CLOCK_SELECTION
MF - _POSIX_MAPPED_FILES - _SC_MAPPED_FILES
MPR - _POSIX_MEMORY_PROTECTION - _SC_MEMORY_PROTECTION
--- - _POSIX_READER_WRITER_LOCKS - _SC_READER_WRITER_LOCKS
RTS - _POSIX_REALTIME_SIGNALS - _SC_REALTIME_SIGNALS
SEM - _POSIX_SEMAPHORES - _SC_SEMAPHORES
SPI - _POSIX_SPIN_LOCKS - _SC_SPIN_LOCKS
TSF - _POSIX_THREAD_SAFE_FUNCTIONS - _SC_THREAD_SAFE_FUNCTIONS
THR - _POSIX_THREADS - _SC_THREADS
TMO - _POSIX_TIMEOUTS - _SC_TIMEOUTS
TMR - _POSIX_TIMERS - _SC_TIMERS

Also, below "XSI - _XOPEN_UNIX - _SC_XOPEN_UNIX", the following options can be removed:

_POSIX_MAPPED_FILES
_POSIX_MEMORY_PROTECTION
_POSIX_THREAD_SAFE_FUNCTIONS
_POSIX_THREADS
Legacy (_XOPEN_LEGACY)

[1] The Open Group Base Specifications Issue 7, 2018 edition https://pubs.opengroup.org/onlinepubs/9699919799/basedefs/V1_chap02.html
Comment 1 Enrique Garcia 2024-02-02 19:53:52 UTC
There are also two options that are mentioned as "not in final XG6", so I guess those ones could also be removed:

--- - _POSIX_FILE_LOCKING - _SC_FILE_LOCKING
--- - _POSIX_MULTI_PROCESS - _SC_MULTI_PROCESS
Comment 2 Enrique Garcia 2024-02-02 20:27:15 UTC
The following are options that were already always true under POSIX.1-2001 and hence can also be removed:

--- - POSIX_CHOWN_RESTRICTED
--- - _POSIX_JOB_CONTROL - _SC_JOB_CONTROL
--- - _POSIX_NO_TRUNC
--- - _POSIX_REGEXP - _SC_REGEXP
--- - _POSIX_SAVED_IDS - _SC_SAVED_IDS
--- - _POSIX_SHELL - _SC_SHELL
Comment 3 Enrique Garcia 2024-02-02 20:54:32 UTC
Created attachment 305816 [details]
posixoptions upgrade to POSIX.1-2018

posixoptions upgrade to POSIX.1-2018
Comment 4 Enrique Garcia 2024-02-02 20:55:07 UTC
I have created a patch that potentially implements the changes above.
Comment 5 Alejandro Colomar 2024-02-02 21:48:31 UTC
Hi Enrique,

On Fri, Feb 02, 2024 at 08:55:07PM +0000, bugzilla-daemon@kernel.org wrote:
> https://bugzilla.kernel.org/show_bug.cgi?id=218453
> 
> --- Comment #4 from Enrique Garcia (cquike@arcor.de) ---
> I have created a patch that potentially implements the changes above.

Would you mind sending the patch(es) to the mailing list?

Thanks,
Alex