Ready for 2.17

Ready for 2.17

Ready for 2.17

Further refinement of SO_TIMESTAMP from Urs Thuermann.

Typo fix

Added comment noting that fork.2 refers to the example program on this
page.

Added xref to pipe.2 for another example of use of fork().

minor chgs

Added test on EXAMPLE PROGRAMS

Formatting fix

Added example program demonstrating use of fork() and waitpid().

Added pointer to example of fork() in wait.2.

Added example program.

Improvements after suggestions from Michael Haardt.

Added SEE ALSO for new pipe.7 page

New page providing overview of pipes and FIFOs.

Von: Urs Thuermann <urs@isnogud.escape.de>
An: "Michael Kerrisk" <mtk-manpages@gmx.net>
Betreff: Re: PATCH: man-pages-2.15, socket option SO_TIMESTAMP
Datum: 02 Dec 2005 08:00:11 +0100

Hello Michael,

> Okay -- let me know if your patch is still good to go after you've
> done your reading/testing.  Maybe I will try to do another
> man-page release tomorrow, if you you can confirm the details in 2.6.

I have compared 2.4 and 2.6 src again and wrote two small test
programs (one sending udp packets, one receiving the packets and
calling SIOCGSTAMP w/ and w/o SO_TIMESTAMP).  Both, 2.4 and 2.6 have
the same behavior, which may be considered a bug.

When a packet is received its timestamp is stored in the sock
structure in kernel for SIOCGSTAMP to be retreived if SO_TIMESTAMP is
not set, otherwise it is written into a cmsg structure to be returned
with the recvmsg syscall.

Therefore, SIOCGSTAMP doesn't get the correct timestamp, when
SO_TIMESTAMP is set.  Instead, SIOCGSTAMP returns an ENOENT error, if
there has never been a packet reception while SO_TIMESTAMP unset,
since the field in the sock structure in the kernel is initialized to
"no timestamp" (0 in 2.4, -1 in 2.6).  Otherwise, SIOCGSTAMP returns
the timestamp found in the sock structure which is from the last
packet when SO_TIMESTAMP was not set, i.e. it may not be the timestamp
of the last packet received.

I have updated the man page socket(7) accordingly.  Patch is below.

urs

Added FIXMEs

New documentation for the glibc specific fmemopen() and
open_memstream().

Rearranged EAI_* list alphabetically.

Formatting fix

Removed BROWSER, since it seems not in fact to be common.

Added GLIBC NOTES describing feature test macros required
to expose declaration of inet_aton().

Added FIXME

Added FIXME

Added some FIXMEs

Noted 200 millisecond celing imposed on TCP_CORK.

Delete line that should have been deleted when applying
2.08 fix for this page.

Start of 2.17

Start of 2.17

Prepare for 2.16

Prepare for 2.16

The -1 error return of shmat() should be cast "(void *)".

Added NOTES about INFTIM contant provided on some other implementations.

Formatting fix

Clarification: s%SOCK_PACKET%PF_INET/SOCK_PACKET%

Fix a typo: s/SOCK_RAW/SOCK_PACKET/

Added Debian instructions for finding package maintainer

Some text that should have been a comment was not .\"-ed.

Start of 2.16

start of 2.16

Prepare for 2.15

prepare for 2.15

Prepare for 2.15

Added text noting that select()/poll() do no respect SO_RCVLOWAT.

Add as new link to vm86.2

Doc describing how to help with with man page maintenance.

Various changes, notably more detail on FIXMEs

s/tcp_socket/udp_socket/ in example
Fixes Debian bug 340927

Minor changes

Links to sigset.3

New page describing Sysatem V signal API.

Added sigset(3) to SEE ALSO

Added entries to SEE ALSO

Fixed SEE ALSO

Some minor wording fixes; clarified System V origins of
X/Open flavour of this function.

Changed SEE ALSO to reflect movement of sig* pages between sections.

Moved to section 3.

Links to sigvec.3

New page describing BSD signal API.

These pages will be replaced by a new, better sigvec.3.

Noted that si_signo is unused on Linux.

[f]statvfs is now documented in Section 2.

Added example program

Wording improvements for 'flag' and 'width' descriptions.
Some wording changes to bring terminology closer to SUSv3.

Added GLIBC NOTES section describing padding and width specifiers.

Add further text clarifying that %+ specifier is not supported
in glibc2.

Remove description of non-existent %+ specifier.

Added a few words to reflect the fact that several of the section
7 pages provide overviews of various topics.

Added FIXME

Added BUGS noting wrapper function problem that existed
in glibc versions <= 2.2.1.

Added a GLIBC NOTES section describing sigisemptyset(),
sigandset(), and sigorset().

Added text describing the 2.6.[0-7] EPERM bug that occurred
when sending signals to a process group.

Fix typo

start of 2.15

start of 2.15

2.14

expand tabs

Prepare for 2.14

An almost total rewrite!

Clarified parts of the discussion of file leases,
noting effect of open(O_NONBLOCK), interruption
by signal handler, or termination by signal in lease breaker.
In response to Debian bug 339037.

Add EWOULDBLOCK error for file leases.

Added pthreads.7 to SEE ALSO.

Added LINUX NOTES describing nanosecond timestamps.

Formerly, the pge said that all systems declare memalign() in
<malloc.h>.  In fact, many declare it in <stdlib.h>.

Removed SEE ALSO ref to nonexistent scsi(4).

Formatting fix

Although the glibc implementation returns -1 on error (and some
other man pages (e.g., the BSDs) also document that value for
error returns), SUSv3 merely says "non-zero" (and this is what
manual pages on many implementations also say).

Formatting fix

Added FIXME?

Fixed to point out that that frexp() returns a number whose
*absolute* value is >= 0.5 and < 1.  Amended the example
program to demonstrate this.

2.14 prep

Added FIXME

Added FIXME

Added FIXMEs noting that /proc/PID/{loginuid,oom_adj,oom_score,seccomp}
need to be documented

Improved description of E2BIG error: it relates to the sum
of the bytes in both environment and argument list.

Updated discussion of /proc/sys/kernel/pid_max

Added comment

New page taken from BSD (FreeBSD 5.4)

Updated discussion about lack of prototype in glibc.