Commit Graph

4197 Commits

Author SHA1 Message Date
Michael Kerrisk 48afe71d57 Improvements after suggestions from Michael Haardt. 2005-12-09 14:23:53 +00:00
Michael Kerrisk 2adb3bd6da New page providing overview of pipes and FIFOs. 2005-12-08 18:52:42 +00:00
Michael Kerrisk 7b5c3d0a78 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
2005-12-08 16:36:30 +00:00
Michael Kerrisk 17d9609858 Added FIXMEs 2005-12-08 16:19:38 +00:00
Michael Kerrisk 2b185f9296 Added FIXME 2005-12-05 16:22:59 +00:00
Michael Kerrisk 7562c4e6f2 Added FIXME 2005-12-05 16:20:34 +00:00
Michael Kerrisk bf71d57c68 Added some FIXMEs 2005-12-05 16:16:07 +00:00
Michael Kerrisk 26905f6a55 Noted 200 millisecond celing imposed on TCP_CORK. 2005-12-05 13:38:18 +00:00
Michael Kerrisk 59e8f714bd Clarification: s%SOCK_PACKET%PF_INET/SOCK_PACKET% 2005-12-01 10:12:56 +00:00
Michael Kerrisk 1415e84202 Fix a typo: s/SOCK_RAW/SOCK_PACKET/ 2005-12-01 10:09:34 +00:00
Michael Kerrisk d994d57949 Added text noting that select()/poll() do no respect SO_RCVLOWAT. 2005-11-30 16:09:42 +00:00
Michael Kerrisk ae67047c0c s/tcp_socket/udp_socket/ in example
Fixes Debian bug 340927
2005-11-30 08:38:58 +00:00
Michael Kerrisk 0b321ee459 Added entries to SEE ALSO 2005-11-29 16:52:11 +00:00
Michael Kerrisk 67a99ba02c Added a few words to reflect the fact that several of the section
7 pages provide overviews of various topics.
2005-11-22 16:35:17 +00:00
Michael Kerrisk 4f62997d55 Added pthreads.7 to SEE ALSO. 2005-11-17 13:38:34 +00:00
Michael Kerrisk fb8959ea57 Added FIXME? 2005-11-15 15:00:12 +00:00
Michael Kerrisk bd12ab88af Formatting fixes 2005-11-03 12:47:27 +00:00
Michael Kerrisk 8478ee0279 Formatting fixes 2005-11-02 13:55:25 +00:00
Michael Kerrisk 197889d00b Formatting fixes 2005-11-02 10:53:26 +00:00
Michael Kerrisk 35fb7de5c5 Added comment 2005-10-31 09:48:53 +00:00
Michael Kerrisk 3dfe7e0ddd Reworked part of the discussion of exec() and capabilities.
Added sub-section "Effect of User ID Changes on Capabilities".
Reworked discussion of CAP_SYS_ADMIN and file-max.
2005-10-28 17:41:30 +00:00
Michael Kerrisk a749f870a8 s/XXX/FIXME/ 2005-10-26 11:27:52 +00:00
Michael Kerrisk 9bc4f5f8d9 Minor changes 2005-10-24 11:22:35 +00:00
Michael Kerrisk 1e32103455 Formatting fixes 2005-10-20 15:11:10 +00:00
Michael Kerrisk b5cc2ffbaa Formatting fixes 2005-10-19 14:48:35 +00:00
Michael Kerrisk 4a225b7a41 Formatting fixes 2005-10-19 14:16:57 +00:00
Michael Kerrisk 4009dcc539 formatting fix 2005-10-19 13:21:05 +00:00
Michael Kerrisk e1d6264d9f Manual fixes for parentheses formatting 2005-10-19 07:29:28 +00:00
Michael Kerrisk 63aa9df02f Automated unformatting of parentheses using unformat_parens.sh 2005-10-19 07:07:02 +00:00
Michael Kerrisk 5872bd2f1d Small changes to new page 2005-10-10 13:24:08 +00:00
Michael Kerrisk 1ae9f93747 Pseudo-terminals -- new page 2005-10-10 13:00:25 +00:00
Michael Kerrisk f8b8dd887d Update description of SO_RCVLOWAT and SO_SNDLOWAT.
(fix derived from Fedora man-pages-2.07-7).
2005-10-04 13:18:49 +00:00
Michael Kerrisk 70d015eeb6 Fix discussion of IPC_RECVTTL / IP_TTL 2005-09-19 12:18:24 +00:00
Michael Kerrisk b5188e9abb added fixme 2005-09-15 17:13:50 +00:00
Michael Kerrisk 479377fb38 Updated SEE ALSO to reflect splitting of sigaction.2 into
sigaction.2, sigsuspend.2, sigpending.2, sigprocmask.2
2005-09-15 09:20:05 +00:00
Michael Kerrisk 73b3a56860 Clarified details of use of SO_PEERCRED. 2005-08-16 17:17:16 +00:00
Michael Kerrisk 4528678725 Formatting fix 2005-08-16 15:14:36 +00:00
Michael Kerrisk 5eaee3d9f5 Added CAP_AUDIT_CONTROL and CAP_AUDIT_WRITE 2005-08-16 12:32:03 +00:00
Michael Kerrisk 97604d956d Added kerebl version number of UDP_CORK 2005-08-16 12:09:15 +00:00
Michael Kerrisk 74df8ba182 Added description of UDP_CORK 2005-08-16 12:08:07 +00:00
Michael Kerrisk d270596481 s/SOL_UDP/IPPROTO_UDP/
s/SOL_TCP/IPPROTO_TCP/
s/SOL_IP/IPPROTO_IP/
2005-08-16 11:47:35 +00:00
Michael Kerrisk 331da7c3a0 RFC references are now always writen as "RFC\ nnn" (not "RFC nnn" or
"RFCnnn").
2005-07-20 07:50:45 +00:00
Michael Kerrisk 3dbef8d0ef Clarify that port number is 16 bit; reformat long lines 2005-07-20 07:43:05 +00:00
Michael Kerrisk a5e0a0e427 Formatting fixes. 2005-07-19 15:36:19 +00:00
Michael Kerrisk e360c3a9cf s/pid/PID/ 2005-07-19 06:32:54 +00:00
Michael Kerrisk 1aa1268f29 s/super user/superuser/ 2005-07-18 17:13:06 +00:00
Michael Kerrisk c7400a2caf set-(group|user)-ID fixes 2005-07-18 16:09:29 +00:00
Michael Kerrisk 357cf3fe97 id --> ID 2005-07-18 16:02:32 +00:00
Michael Kerrisk fdc196f51f uid --> UID 2005-07-18 15:51:22 +00:00
Michael Kerrisk b14d4aa5b8 Classical BSD versions are now always named x.yBSD (formerly
there was a mix of x.yBSD and BSD x.y).
2005-07-18 15:05:56 +00:00
Michael Kerrisk 880f5b4bc3 Consistent use of "set-user-ID" and "set-group-ID". 2005-07-18 14:25:42 +00:00
Michael Kerrisk df8a3cac32 hyphen/dash fixes 2005-07-18 12:43:00 +00:00
Michael Kerrisk 601bab298f The first sentence under NOTES about SO_KEEPALIVE and SIGPIPE
makes no grammatical sense (and possibly also no technical sense).
It has been removed.
2005-07-14 15:30:58 +00:00
Michael Kerrisk 8c383102d0 hyphen/dash fixes 2005-07-07 08:27:03 +00:00
Michael Kerrisk 2bc2f4798f hyphen/dash fixes 2005-07-06 12:57:38 +00:00
Michael Kerrisk 4d9b698450 Hyphenation/dash fixes 2005-07-06 07:41:37 +00:00
Michael Kerrisk 61f4934a34 s/the the/the/ 2005-07-05 13:53:03 +00:00
Michael Kerrisk de7e5e1848 wording fix 2005-06-29 08:13:08 +00:00
Michael Kerrisk aa6dd0995f Change protocol for UDP example 2005-06-28 11:57:06 +00:00
Michael Kerrisk b956004699 Spelling/typo fixes 2005-06-24 14:44:16 +00:00
Michael Kerrisk 9fdfa163e5 Typos fixes from A Costa (16 May 05, Debian "manpages"). 2005-06-24 14:17:21 +00:00
Michael Kerrisk 702cbfa21a New link to uri.7 2005-06-23 15:29:00 +00:00
Michael Kerrisk ccca85bec2 Further tcp_stdurg and SIOCATMARK work; minor formatting fixes 2005-06-21 14:46:08 +00:00
Michael Kerrisk 3df839779c Minor formatting fixes 2005-06-21 14:45:03 +00:00
Michael Kerrisk c9d79ca817 Minor formatting change 2005-06-21 08:32:40 +00:00
Michael Kerrisk b5aed92e0d Minor changes 2005-06-21 08:30:41 +00:00
Michael Kerrisk 6f80235904 More tcp_stdurg and SIOCATMARK work 2005-06-20 14:45:09 +00:00
Michael Kerrisk 95d29ab2c8 More SIOCATMARK cahnges. 2005-06-16 10:23:59 +00:00
Michael Kerrisk 8729177b44 global edit s/ -1/ \\-1/g 2005-06-15 14:10:23 +00:00
Michael Kerrisk f59a3f1941 Global edit: s/nonzero/non-zero/ 2005-06-15 13:32:34 +00:00
Michael Kerrisk 7ecc26f664 Various wording and foratting fixes 2005-06-15 13:26:36 +00:00
Michael Kerrisk 5c45d5f543 Various wording and formatting fixes.
Incorporated some new /proc/sys/net/ipv4/tcp_* file descriptions
from the 2.6.12 source file Documentation/networking/ip-sysctl.txt.
2005-06-15 12:56:21 +00:00
Michael Kerrisk fd1835be9c Fixes in discussion of SIOCATMARK + general wording and formatting
clean-ups.
2005-06-14 15:24:55 +00:00
Michael Kerrisk fd064f40a4 Small wording fix. 2005-06-13 09:51:27 +00:00
Michael Kerrisk 23a6e651f3 Fix discussion of alternate signals stack 2005-06-08 13:27:21 +00:00
Michael Kerrisk 3616b7c0cf New pthreads.7 page 2005-06-07 12:35:32 +00:00
Michael Kerrisk 1b88e9c222 Minor fix 2005-06-07 06:51:12 +00:00
Michael Kerrisk 3418ef2fdc FIXME: CAP_AUDIT_CONTROL and CAP_AUDIT_WRITE are not yet documented 2005-05-30 16:43:37 +00:00
Michael Kerrisk 5bdccabd8e 1,$s/inherited/inheritable/g 2005-05-30 09:56:32 +00:00
Michael Kerrisk bf6c69c999 Vincent Fourmond / Joey (Martin) Schulze
Removed discussion of `[[:<:]]' and `[[:>:]]' since they do
not seem to be in the glibc implementation.
As per
http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=295666


>   The regex.7.gz mentions that [[:>:]] and [[:<:]] are available to designate word boundaries.
> However, neither grep nor sed, which are build on the standard libc regcomp do recognise this syntax.
> Moreover, the small program here
>
> #include <regex.h>
> #include <sys/types.h>
> #include <iostream>
>
> using namespace std;
>
> int main()
> {
>   regex_t RE;
>   int err_code = regcomp(&RE, "[[:<:]]",
>              REG_EXTENDED);
>   char Buffer[100];
>   if(err_code) {
>     regerror(err_code, &RE, Buffer, 100);
>     cerr << "Error : " << Buffer << endl;
>   }
> }
>
>
> produces the following error message:
>
> Error : Invalid character class name
2005-05-11 16:06:19 +00:00
Michael Kerrisk 2d93f55ce7 Added FIXME (capabilities are per-thread) 2005-05-03 14:27:04 +00:00
Michael Kerrisk 8ea6b1affa Added FIXME for UDP_CORK 2005-05-03 12:26:25 +00:00
Michael Kerrisk dde7d1a947 Typos/grammar fixes. 2005-04-25 07:08:00 +00:00
Michael Kerrisk 704a18f06d Fixed typos and spelling mistakes 2005-04-18 13:35:29 +00:00
Michael Kerrisk dd1b9170eb mention the .URL macro more verbosely, as per patch from
Martin Schulze <joey@infodrom.org>
Branden Robinson <branden@debian.org> 
Colin Watson <cjwatson@debian.org>
2005-04-04 12:59:48 +00:00
Michael Kerrisk e17d909d2b Typo fix: s/joey@infodeom.org/joey@infodrom.org/ 2005-03-31 14:12:28 +00:00
Michael Kerrisk a7001bac67 http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=210704
[[.TP  
 .B IP_TTL
 -Set or retrieve the current time to live field that is send in every
 packet
 -send from this socket.
 +Set or retrieve the current time to live field that is used in every
 packet
 +sent from this socket.
  
 .TP
 .B IP_HDRINCL
]]
2004-12-15 13:41:16 +00:00
Michael Kerrisk 1c1e15ed85 Martin Pool (and mtk) -- added O_NOATIME 2004-12-08 16:41:10 +00:00
Michael Kerrisk c0722da013 tweak RLIMIT_SIGPENDING details 2004-12-07 17:46:30 +00:00
Michael Kerrisk 1c1634c099 /proc/sys/kernel/rtsig-* were superceded by RLIMIT_SIGPENDING in kernel 2.6.8. 2004-12-03 15:11:50 +00:00
Michael Kerrisk bab7e1c781 formatting and a few wording fixes 2004-11-25 08:11:36 +00:00
Michael Kerrisk 01f3816758 added \n at EOF 2004-11-22 16:48:40 +00:00
Michael Kerrisk 925d4d6a89 Modified details of interaction of TCP_CORK and TCP_NODELAY 2004-11-11 16:22:41 +00:00
Michael Kerrisk 8dd9ef479f Updated details of interaction of TCP_CORK and TCP_NODELAY 2004-11-11 16:11:50 +00:00
Michael Kerrisk 6891999e31 Patches from Martin Schulze <joey@infodeom.org> 2004-11-03 15:32:55 +00:00
Michael Kerrisk 305a0578bf Global change of email address for MTK (now: mtk-manpages@gmx.net) 2004-11-03 14:43:40 +00:00
Michael Kerrisk fea681dafb Import of man-pages 1.70 2004-11-03 13:51:07 +00:00