open.3p: Query regarding section reference
[CC += linux-man@]
Hi Utkarsh,
Quoted 7 lines · Utkarsh Singh
Hi Alex,
Some man-pages contain section reference such as(open.3p):
Section 2.14, File Descriptor AllocationAre these from POSIX.1 standards or some more exhaustive documentation?
Yes, those are from the POSIX.1 standard. If you have a look at the top of 'man 3posix open' (or 'man 3p open' for short), which reads from the file 'open.3p', you'll see:
[
OPEN(3POSIX) POSIX Programmer's Manual OPEN(3POSIX)
PROLOG
This manual page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ (con‐ sult the corresponding Linux manual page for details of Linux behavior), or the interface may not be implemented on Linux.
NAME
open, openat — open file
SYNOPSIS
#include <sys/stat.h>
#include <fcntl.h>
int open(const char *path, int oflag, ...);
int openat(int fd, const char *path, int oflag, ...);]
And at the bottom of the page:
[
COPYRIGHT
Portions of this text are reprinted and reproduced in elec‐ tronic form from IEEE Std 1003.1-2017, Standard for Infor‐ mation Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between this version and the orig‐ inal IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The
original Standard can be obtained online at
http://www.opengroup.org/unix/online.html .
Any typographical or formatting errors that appear in this page are most likely to have been introduced during the conversion of the source files to man page format. To re‐
port such errors, see https://www.kernel.org/doc/man-
pages/reporting_bugs.html .
IEEE/The Open Group 2017 OPEN(3POSIX)
]
As you can see, these .3p files are created with scripts, from the original POSIX HTML files.
We have them in this separate repository:
<https://git.kernel.org/pub/scm/docs/man-pages/man-pages-posix.git/about/>
Regards,
Alex
Signature · 3 lines
Alejandro Colomar Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/ http://www.alejandro-colomar.es/