- added description of the TCP_CONGESTION on the tcp(7) man page

This commit is contained in:
Peter Schiffer 2012-10-25 19:46:44 +02:00
parent 964186ed89
commit d9fefcdf5c
2 changed files with 67 additions and 0 deletions

View File

@ -0,0 +1,63 @@
diff -ur man-pages-3.43.orig/man7/tcp.7 man-pages-3.43/man7/tcp.7
--- man-pages-3.43.orig/man7/tcp.7 2012-10-15 11:13:50.000000000 +0200
+++ man-pages-3.43/man7/tcp.7 2012-10-25 19:37:24.084706083 +0200
@@ -820,7 +820,58 @@
socket options are valid on TCP sockets.
For more information see
.BR ip (7).
-.\" FIXME Document TCP_CONGESTION (new in 2.6.13)
+.TP
+.BR TCP_CONGESTION " (since Linux 2.6.13)"
+Get or set the congestion-control algorithm for this socket.
+The
+.I optval
+argument is a pointer to a character-string buffer.
+
+For
+.BR getsockopt ()
+.I *optlen
+specifies the amount of space available in the buffer pointed to by
+.IR optval ,
+which should be at least 16 bytes (defined by the kernel-internal constant
+.BR TCP_CA_NAME_MAX ).
+On return, the buffer pointed to by
+.I optval
+is set to a null-terminated string containing the name of the
+congestion-control algorithm for this socket, and
+.I *optlen
+is set to the minimum of its original value and
+.BR TCP_CA_NAME_MAX .
+If the value passed in
+.I *optlen
+is too small, then the string returned in
+.I *optval
+is silently truncated, and no terminating null byte is added.
+If an empty string is returned, then the socket is using the default
+congestion-control algorithm, determined as described under
+.I tcp_congestion_control
+above.
+
+For
+.BR setsockopt ()
+.I optlen
+specifies the length of the congestion-control algorithm name
+contained in the buffer pointed to by
+.IR optval ;
+this length need not include any terminating null byte.
+The algorithm "reno" is always permitted;
+other algorithms may be available, depending on kernel configuration.
+Possible errors from
+.BR setsockopt ()
+include:
+algorithm not found/available
+.RB ( ENOENT );
+setting this algorithm requires the
+.B CAP_NET_ADMIN
+capability
+.RB ( EPERM );
+and failure getting kernel module
+.RB ( EBUSY ).
+.I
.TP
.BR TCP_CORK " (since Linux 2.2)"
.\" precisely: since 2.1.127

View File

@ -67,6 +67,8 @@ Patch56: man-pages-3.42-zdump.patch
Patch57: man-pages-3.42-connect.patch Patch57: man-pages-3.42-connect.patch
# resolves: #202092 # resolves: #202092
Patch58: man-pages-3.42-sysconf.patch Patch58: man-pages-3.42-sysconf.patch
# resolves: #771540
Patch59: man-pages-3.43-tcp-congestion.patch
Autoreq: false Autoreq: false
@ -107,6 +109,7 @@ Documentation Project (LDP).
%patch56 -p1 %patch56 -p1
%patch57 -p1 %patch57 -p1
%patch58 -p1 %patch58 -p1
%patch59 -p1
## Remove man pages we are not going to use ## ## Remove man pages we are not going to use ##
@ -171,6 +174,7 @@ cd ..
* Thu Oct 25 2012 Peter Schiffer <pschiffe@redhat.com> - 3.43-1 * Thu Oct 25 2012 Peter Schiffer <pschiffe@redhat.com> - 3.43-1
- resolves: #866874 - resolves: #866874
updated to 3.43 updated to 3.43
- added description of the TCP_CONGESTION on the tcp(7) man page
* Wed Sep 19 2012 Peter Schiffer <pschiffe@redhat.com> - 3.42-1 * Wed Sep 19 2012 Peter Schiffer <pschiffe@redhat.com> - 3.42-1
- resolves: #847941 - resolves: #847941