Re: open.3p: Query regarding section reference

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



[CC += linux-man@]

Hi Utkarsh,

On 3/12/21 7:29 AM, Utkarsh Singh wrote:
Hi Alex,

Some man-pages contain section reference such as(open.3p):
Section 2.14, File Descriptor Allocation

Are 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

--
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/



[Index of Archives]     [Kernel Documentation]     [Netdev]     [Linux Ethernet Bridging]     [Linux Wireless]     [Kernel Newbies]     [Security]     [Linux for Hams]     [Netfilter]     [Bugtraq]     [Yosemite News]     [MIPS Linux]     [ARM Linux]     [Linux RAID]     [Linux Admin]     [Samba]

  Powered by Linux