summaryrefslogtreecommitdiff
path: root/net/socket/socket_options.h
diff options
context:
space:
mode:
authorCronet Mainline Eng <cronet-mainline-eng+copybara@google.com>2023-03-20 09:24:50 -0800
committerPatrick Rohr <prohr@google.com>2023-03-20 10:25:51 -0700
commit14c9064f78517fd0e9366547030c0493aa075b47 (patch)
tree6e03046ec4055bb9881ff0341716266b5d53782b /net/socket/socket_options.h
parentd1add53d6e90815f363c91d433735556ce79b0d2 (diff)
downloadcronet-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.h62
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_