Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
TCP(4)		       FreeBSD Kernel Interfaces Manual			TCP(4)

     tcp -- Internet Transmission Control Protocol

     #include <sys/types.h>
     #include <sys/socket.h>
     #include <netinet/in.h>

     socket(AF_INET, SOCK_STREAM, 0);

     The TCP protocol provides reliable, flow-controlled, two-way transmission
     of	data.  It is a byte-stream protocol used to support the	SOCK_STREAM
     abstraction.  TCP uses the	standard Internet address format and, in addi-
     tion, provides a per-host collection of ``port addresses''.  Thus,	each
     address is	composed of an Internet	address	specifying the host and	net-
     work, with	a specific TCP port on the host	identifying the	peer entity.

     Sockets utilizing the tcp protocol	are either ``active'' or ``passive''.
     Active sockets initiate connections to passive sockets.  By default TCP
     sockets are created active; to create a passive socket the	listen(2) sys-
     tem call must be used after binding the socket with the bind(2) system
     call.  Only passive sockets may use the accept(2) call to accept incoming
     connections.  Only	active sockets may use the connect(2) call to initiate
     connections.  TCP also supports a more datagram-like mode,	called Trans-
     action TCP, which is described in ttcp(4).

     Passive sockets may ``underspecify'' their	location to match incoming
     connection	requests from multiple networks.  This technique, termed
     ``wildcard	addressing'', allows a single server to	provide	service	to
     clients on	multiple networks.  To create a	socket which listens on	all
     networks, the Internet address INADDR_ANY must be bound.  The TCP port
     may still be specified at this time; if the port is not specified the
     system will assign	one.  Once a connection	has been established the
     socket's address is fixed by the peer entity's location.	The address
     assigned the socket is the	address	associated with	the network interface
     through which packets are being transmitted and received.	Normally this
     address corresponds to the	peer entity's network.

     TCP supports a number of socket options which can be set with
     setsockopt(2) and tested with getsockopt(2):

     TCP_NODELAY   Under most circumstances, TCP sends data when it is pre-
		   sented; when	outstanding data has not yet been acknowl-
		   edged, it gathers small amounts of output to	be sent	in a
		   single packet once an acknowledgement is received.  For a
		   small number	of clients, such as window systems that	send a
		   stream of mouse events which	receive	no replies, this pack-
		   etization may cause significant delays.  The	boolean	option
		   TCP_NODELAY defeats this algorithm.

     TCP_MAXSEG	   By default, a sender- and receiver-TCP will negotiate among
		   themselves to determine the maximum segment size to be used
		   for each connection.	 The TCP_MAXSEG	option allows the user
		   to determine	the result of this negotiation,	and to reduce
		   it if desired.

     TCP_NOOPT	   TCP usually sends a number of options in each packet, cor-
		   responding to various TCP extensions	which are provided in
		   this	implementation.	 The boolean option TCP_NOOPT is pro-
		   vided to disable TCP	option use on a	per-connection basis.

     TCP_NOPUSH	   By convention, the sender-TCP will set the ``push'' bit and
		   begin transmission immediately (if permitted) at the	end of
		   every user call to write(2) or writev(2).  The TCP_NOPUSH
		   option is provided to allow servers to easily make use of
		   Transaction TCP (see	ttcp(4)).  When	the option is set to a
		   non-zero value, TCP will delay sending any data at all
		   until either	the socket is closed, or the internal send
		   buffer is filled.

     The option	level for the setsockopt(2) call is the	protocol number	for
     TCP, available from getprotobyname(3), or IPPROTO_TCP.  All options are
     declared in <netinet/tcp.h>.

     Options at	the IP transport level may be used with	TCP; see ip(4).
     Incoming connection requests that are source-routed are noted, and	the
     reverse source route is used in responding.

     The tcp protocol implements a number of variables in the net.inet branch
     of	the sysctl(3) MIB.

     TCPCTL_DO_RFC1323	(tcp.rfc1323) Implement	the window scaling and time-
			stamp options of RFC 1323 (default true).

     TCPCTL_DO_RFC1644	(tcp.rfc1644) Implement	Transaction TCP, as described
			in RFC 1644.

     TCPCTL_MSSDFLT	(tcp.mssdflt) The default value	used for the maximum
			segment	size (``MSS'') when no advice to the contrary
			is received from MSS negotiation.

     TCPCTL_SENDSPACE	(tcp.sendspace)	Maximum	TCP send window.

     TCPCTL_RECVSPACE	(tcp.recvspace)	Maximum	TCP receive window.

     tcp.log_in_vain	Log any	connection attempts to ports where there is
			not a socket accepting connections.  The value of 1
			limits the logging to SYN (connection establishment)
			packets	only.  That of 2 results in any	TCP packets to
			closed ports being logged.  Any	value unlisted above
			disables the logging (default is 0, i.e., the logging
			is disabled).

			The number of packets allowed to be in-flight during
			the TCP	slow-start phase on a non-local	network.

			The number of packets allowed to be in-flight during
			the TCP	slow-start phase to local machines in the same

     tcp.msl		The Maximum Segment Lifetime for a packet.

     tcp.keepinit	Timeout	for new, non-established TCP connections.

     tcp.keepidle	Amount of time the connection should be	idle before
			keepalive probes (if enabled) are sent.

     tcp.keepintvl	The interval between keepalive probes sent to remote
			machines.  After TCPTV_KEEPCNT (default	8) probes are
			sent, with no response,	the connection is dropped.

			Assume that SO_KEEPALIVE is set	on all TCP connec-
			tions, the kernel will periodically send a packet to
			the remote host	to verify the connection is still up.

     tcp.icmp_may_rst	Certain	ICMP unreachable messages may abort connec-
			tions in SYN-SENT state.

     tcp.do_tcpdrain	Flush packets in the TCP reassembly queue if the sys-
			tem is low on mbufs.

     tcp.blackhole	If enabled, disable sending of RST when	a connection
			is attempted to	a port where there is not a socket
			accepting connections.	See blackhole(4).

     tcp.delayed_ack	Delay ACK to try and piggyback it onto a data packet.

     tcp.delacktime	Maximum	amount of time before a	delayed	ACK is sent.

     tcp.newreno	Enable TCP NewReno Fast	Recovery algorithm, as
			described in RFC 2582.

			Enable Path MTU	Discovery

     tcp.tcbhashsize	Size of	the TCP	control-block hashtable	(read-only).
			This may be tuned using	the kernel option TCBHASHSIZE
			or by setting net.inet.tcp.tcbhashsize in the

     tcp.pcbcount	Number of active process control blocks	(read-only).

     tcp.syncookies	Determines whether or not syn cookies should be	gener-
			ated for outbound syn-ack packets.  Syn	cookies	are a
			great help during syn flood attacks, and are enabled
			by default.

			The interval (in seconds) specifying how often the
			secret data used in RFC	1948 initial sequence number
			calculations should be reseeded.  By default, this
			variable is set	to zero, indicating that no reseeding
			will occur.  Reseeding should not be necessary,	and
			will break TIME_WAIT recycling for a few minutes.

     A socket operation	may fail with one of the following errors returned:

     [EISCONN]		when trying to establish a connection on a socket
			which already has one;

     [ENOBUFS]		when the system	runs out of memory for an internal
			data structure;

     [ETIMEDOUT]	when a connection was dropped due to excessive

     [ECONNRESET]	when the remote	peer forces the	connection to be

     [ECONNREFUSED]	when the remote	peer actively refuses connection
			establishment (usually because no process is listening
			to the port);

     [EADDRINUSE]	when an	attempt	is made	to create a socket with	a port
			which has already been allocated;

     [EADDRNOTAVAIL]	when an	attempt	is made	to create a socket with	a net-
			work address for which no network interface exists.

     [EAFNOSUPPORT]	when an	attempt	is made	to bind	or connect a socket to
			a multicast address.

     getsockopt(2), socket(2), sysctl(3), blackhole(4),	inet(4), intro(4),
     ip(4), ttcp(4)

     V.	Jacobson, R. Braden, and D. Borman, TCP	Extensions for High
     Performance, RFC 1323.

     R.	Braden,	T/TCP -	TCP Extensions for Transactions, RFC 1644.

     The tcp protocol appeared in 4.2BSD.  The RFC 1323	extensions for window
     scaling and timestamps were added in 4.4BSD.

FreeBSD	11.1		       February	14, 1995		  FreeBSD 11.1


Want to link to this manual page? Use this URL:

home | help