diff -up man-pages-3.45/man7/tcp.7.orig man-pages-3.45/man7/tcp.7 --- man-pages-3.45/man7/tcp.7.orig 2012-12-20 18:17:29.000000000 +0100 +++ man-pages-3.45/man7/tcp.7 2012-12-21 15:31:18.526858856 +0100 @@ -867,6 +867,58 @@ socket options are valid on TCP sockets. For more information see .BR ip (7). .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 If set, don't send out partial frames.