diff options
author | Cronet Mainline Eng <cronet-mainline-eng+copybara@google.com> | 2023-03-20 09:24:50 -0800 |
---|---|---|
committer | Patrick Rohr <prohr@google.com> | 2023-03-20 10:25:51 -0700 |
commit | 14c9064f78517fd0e9366547030c0493aa075b47 (patch) | |
tree | 6e03046ec4055bb9881ff0341716266b5d53782b /net/socket/socket_options.h | |
parent | d1add53d6e90815f363c91d433735556ce79b0d2 (diff) | |
download | cronet-14c9064f78517fd0e9366547030c0493aa075b47.tar.gz |
Import Cronet version 108.0.5359.128
Project import generated by Copybara.
FolderOrigin-RevId: /tmp/copybara-origin/src
Test: none
Change-Id: I98ebcd5784650764c7cd70ab175dd4e1cc790dff
Diffstat (limited to 'net/socket/socket_options.h')
-rw-r--r-- | net/socket/socket_options.h | 62 |
1 files changed, 62 insertions, 0 deletions
diff --git a/net/socket/socket_options.h b/net/socket/socket_options.h new file mode 100644 index 000000000..7ace024d5 --- /dev/null +++ b/net/socket/socket_options.h @@ -0,0 +1,62 @@ +// Copyright 2017 The Chromium Authors +// Use of this source code is governed by a BSD-style license that can be +// found in the LICENSE file. + +#ifndef NET_SOCKET_SOCKET_OPTIONS_H_ +#define NET_SOCKET_SOCKET_OPTIONS_H_ + +#include <stdint.h> + +#include "net/base/net_export.h" +#include "net/socket/socket_descriptor.h" + +namespace net { + +// This function enables/disables buffering in the kernel. By default, on Linux, +// TCP sockets will wait up to 200ms for more data to complete a packet before +// transmitting. After calling this function, the kernel will not wait. See +// TCP_NODELAY in `man 7 tcp`. +// +// For Windows: +// +// The Nagle implementation on Windows is governed by RFC 896. The idea +// behind Nagle is to reduce small packets on the network. When Nagle is +// enabled, if a partial packet has been sent, the TCP stack will disallow +// further *partial* packets until an ACK has been received from the other +// side. Good applications should always strive to send as much data as +// possible and avoid partial-packet sends. However, in most real world +// applications, there are edge cases where this does not happen, and two +// partial packets may be sent back to back. For a browser, it is NEVER +// a benefit to delay for an RTT before the second packet is sent. +// +// As a practical example in Chromium today, consider the case of a small +// POST. I have verified this: +// Client writes 649 bytes of header (partial packet #1) +// Client writes 50 bytes of POST data (partial packet #2) +// In the above example, with Nagle, a RTT delay is inserted between these +// two sends due to nagle. RTTs can easily be 100ms or more. The best +// fix is to make sure that for POSTing data, we write as much data as +// possible and minimize partial packets. We will fix that. But disabling +// Nagle also ensure we don't run into this delay in other edge cases. +// See also: +// http://technet.microsoft.com/en-us/library/bb726981.aspx +// +// SetTCPNoDelay() sets the TCP_NODELAY option. Use |no_delay| to enable or +// disable it. On error returns a net error code, on success returns OK. +int SetTCPNoDelay(SocketDescriptor fd, bool no_delay); + +// SetReuseAddr() sets the SO_REUSEADDR socket option. Use |reuse| to enable or +// disable it. On error returns a net error code, on success returns OK. +int SetReuseAddr(SocketDescriptor fd, bool reuse); + +// SetSocketReceiveBufferSize() sets the SO_RCVBUF socket option. On error +// returns a net error code, on success returns OK. +int SetSocketReceiveBufferSize(SocketDescriptor fd, int32_t size); + +// SetSocketSendBufferSize() sets the SO_SNDBUF socket option. On error +// returns a net error code, on success returns OK. +int SetSocketSendBufferSize(SocketDescriptor fd, int32_t size); + +} // namespace net + +#endif // NET_SOCKET_SOCKET_OPTIONS_H_ |