tcp.c File Reference

TCP host stack utilities. More...

Include dependency graph for tcp.c:

Go to the source code of this file.

Functions
static u32	tcp_connection_bind (u32 session_index, transport_endpoint_t *lcl)
u32	tcp_session_bind (u32 session_index, transport_endpoint_t *tep)
static void	tcp_connection_unbind (u32 listener_index)
u32	tcp_session_unbind (u32 listener_index)
transport_connection_t *	tcp_session_get_listener (u32 listener_index)
void	tcp_half_open_connection_del (tcp_connection_t *tc)
	Cleanup half-open connection. More...
int	tcp_half_open_connection_cleanup (tcp_connection_t *tc)
	Try to cleanup half-open connection. More...
tcp_connection_t *	tcp_half_open_connection_new (void)
void	tcp_connection_cleanup (tcp_connection_t *tc)
	Cleans up connection state. More...
void	tcp_connection_del (tcp_connection_t *tc)
	Connection removal. More...
tcp_connection_t *	tcp_connection_new (u8 thread_index)
void	tcp_connection_reset (tcp_connection_t *tc)
	Notify session that connection has been reset. More...
void	tcp_connection_close (tcp_connection_t *tc)
	Begin connection closing procedure. More...
void	tcp_session_close (u32 conn_index, u32 thread_index)
void	tcp_session_cleanup (u32 conn_index, u32 thread_index)
void	tcp_connection_timers_init (tcp_connection_t *tc)
	Initialize all connection timers as invalid. More...
void	tcp_connection_timers_reset (tcp_connection_t *tc)
	Stop all connection timers. More...
void	tcp_init_snd_vars (tcp_connection_t *tc)
	Initialize connection send variables. More...
void	tcp_connection_init_vars (tcp_connection_t *tc)
	Initialize tcp connection variables. More...
static int	tcp_alloc_custom_local_endpoint (tcp_main_t *tm, ip46_address_t *lcl_addr, u16 *lcl_port, u8 is_ip4)
int	tcp_connection_open (transport_endpoint_t *rmt)
int	tcp_session_open (transport_endpoint_t *tep)
u8 *	format_tcp_state (u8 *s, va_list *args)
u8 *	format_tcp_connection_flags (u8 *s, va_list *args)
u8 *	format_tcp_timers (u8 *s, va_list *args)
u8 *	format_tcp_congestion_status (u8 *s, va_list *args)
u8 *	format_tcp_vars (u8 *s, va_list *args)
u8 *	format_tcp_connection_id (u8 *s, va_list *args)
u8 *	format_tcp_connection (u8 *s, va_list *args)
u8 *	format_tcp_session (u8 *s, va_list *args)
u8 *	format_tcp_listener_session (u8 *s, va_list *args)
u8 *	format_tcp_half_open_session (u8 *s, va_list *args)
u8 *	format_tcp_sacks (u8 *s, va_list *args)
u8 *	format_tcp_rcv_sacks (u8 *s, va_list *args)
u8 *	format_tcp_sack_hole (u8 *s, va_list *args)
u8 *	format_tcp_scoreboard (u8 *s, va_list *args)
transport_connection_t *	tcp_session_get_transport (u32 conn_index, u32 thread_index)
transport_connection_t *	tcp_half_open_session_get_transport (u32 conn_index)
u16	tcp_session_send_mss (transport_connection_t *trans_conn)
	Compute maximum segment size for session layer. More...
static u32	tcp_round_snd_space (tcp_connection_t *tc, u32 snd_space)
u32	tcp_snd_space (tcp_connection_t *tc)
	Compute tx window session is allowed to fill. More...
u32	tcp_session_send_space (transport_connection_t *trans_conn)
i32	tcp_rcv_wnd_available (tcp_connection_t *tc)
u32	tcp_session_tx_fifo_offset (transport_connection_t *trans_conn)
void	tcp_update_time (f64 now, u8 thread_index)
void	tcp_timer_keep_handler (u32 conn_index)
void	tcp_timer_establish_handler (u32 conn_index)
void	tcp_timer_waitclose_handler (u32 conn_index)
static void	tcp_expired_timers_dispatch (u32 *expired_timers)
void	tcp_initialize_timer_wheels (tcp_main_t *tm)
clib_error_t *	tcp_main_enable (vlib_main_t *vm)
clib_error_t *	vnet_tcp_enable_disable (vlib_main_t *vm, u8 is_en)
void	tcp_punt_unknown (vlib_main_t *vm, u8 is_ip4, u8 is_add)
clib_error_t *	tcp_init (vlib_main_t *vm)
static clib_error_t *	tcp_config_fn (vlib_main_t *vm, unformat_input_t *input)
int	tcp_configure_v4_source_address_range (vlib_main_t *vm, ip4_address_t *start, ip4_address_t *end, u32 table_id)
	Configure an ipv4 source address range. More...
int	tcp_configure_v6_source_address_range (vlib_main_t *vm, ip6_address_t *start, ip6_address_t *end, u32 table_id)
	Configure an ipv6 source address range. More...
static clib_error_t *	tcp_src_address (vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd_arg)
static u8 *	tcp_scoreboard_dump_trace (u8 *s, sack_scoreboard_t *sb)
static clib_error_t *	tcp_show_scoreboard_trace_fn (vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd_arg)
u8 *	tcp_scoreboard_replay (u8 *s, tcp_connection_t *tc, u8 verbose)
static clib_error_t *	tcp_scoreboard_trace_fn (vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd_arg)
static clib_error_t *	show_tcp_punt_fn (vlib_main_t *vm, unformat_input_t *input, vlib_cli_command_t *cmd_arg)

Variables
tcp_main_t	tcp_main
const char *	tcp_dbg_evt_str []
const char *	tcp_fsm_states []
const char *	tcp_connection_flags_str []
const char *	tcp_conn_timers []
static const transport_proto_vft_t	tcp_proto
static timer_expiration_handler *	timer_expiration_handlers [TCP_N_TIMERS]
static vlib_cli_command_t	tcp_src_address_command
	(constructor) VLIB_CLI_COMMAND (tcp_src_address_command) More...
static vlib_cli_command_t	tcp_show_scoreboard_trace_command
	(constructor) VLIB_CLI_COMMAND (tcp_show_scoreboard_trace_command) More...
static vlib_cli_command_t	tcp_replay_scoreboard_command
	(constructor) VLIB_CLI_COMMAND (tcp_replay_scoreboard_command) More...
static vlib_cli_command_t	show_tcp_punt_command
	(constructor) VLIB_CLI_COMMAND (show_tcp_punt_command) More...

Detailed Description

TCP host stack utilities.

Definition in file tcp.c.

Function Documentation

u8* format_tcp_congestion_status	(	u8 *	s,
		va_list *	args
	)

Definition at line 664 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

u8* format_tcp_connection	(	u8 *	s,
		va_list *	args
	)

Definition at line 741 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

u8* format_tcp_connection_flags	(	u8 *	s,
		va_list *	args
	)

Definition at line 614 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

u8* format_tcp_connection_id	(	u8 *	s,
		va_list *	args
	)

Definition at line 717 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

u8* format_tcp_half_open_session	(	u8 *	s,
		va_list *	args
	)

Definition at line 784 of file tcp.c.

Here is the call graph for this function:

u8* format_tcp_listener_session	(	u8 *	s,
		va_list *	args
	)

Definition at line 776 of file tcp.c.

Here is the call graph for this function:

u8* format_tcp_rcv_sacks	(	u8 *	s,
		va_list *	args
	)

Definition at line 816 of file tcp.c.

Here is the call graph for this function:

u8* format_tcp_sack_hole	(	u8 *	s,
		va_list *	args
	)

Definition at line 840 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

u8* format_tcp_sacks	(	u8 *	s,
		va_list *	args
	)

Definition at line 792 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

u8* format_tcp_scoreboard	(	u8 *	s,
		va_list *	args
	)

Definition at line 852 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

u8* format_tcp_session	(	u8 *	s,
		va_list *	args
	)

Definition at line 760 of file tcp.c.

Here is the call graph for this function:

u8* format_tcp_state	(	u8 *	s,
		va_list *	args
	)

Definition at line 596 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

u8* format_tcp_timers	(	u8 *	s,
		va_list *	args
	)

Definition at line 639 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

u8* format_tcp_vars	(	u8 *	s,
		va_list *	args
	)

Definition at line 677 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static clib_error_t* show_tcp_punt_fn ( vlib_main_t *  vm, unformat_input_t *  input, vlib_cli_command_t *  cmd_arg  )

static

Definition at line 1785 of file tcp.c.

Here is the call graph for this function:

static int tcp_alloc_custom_local_endpoint ( tcp_main_t *  tm, ip46_address_t *  lcl_addr, u16 *  lcl_port, u8  is_ip4  )

static

Definition at line 501 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static clib_error_t* tcp_config_fn ( vlib_main_t *  vm, unformat_input_t *  input  )

static

Definition at line 1312 of file tcp.c.

Here is the call graph for this function:

int tcp_configure_v4_source_address_range	(	vlib_main_t *	vm,
		ip4_address_t *	start,
		ip4_address_t *	end,
		u32	table_id
	)

Configure an ipv4 source address range.

Parameters

vm	vlib_main_t pointer
start	first ipv4 address in the source address range
end	last ipv4 address in the source address range
table_id	VRF / table ID, 0 for the default FIB

Returns

0 if all OK, else an error indication from api_errno.h

Definition at line 1348 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

int tcp_configure_v6_source_address_range	(	vlib_main_t *	vm,
		ip6_address_t *	start,
		ip6_address_t *	end,
		u32	table_id
	)

Configure an ipv6 source address range.

Parameters

vm	vlib_main_t pointer
start	first ipv6 address in the source address range
end	last ipv6 address in the source address range
table_id	VRF / table ID, 0 for the default FIB

Returns

0 if all OK, else an error indication from api_errno.h

Definition at line 1440 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static u32 tcp_connection_bind ( u32  session_index, transport_endpoint_t *  lcl  )

static

Definition at line 32 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void tcp_connection_cleanup

(

tcp_connection_t *

tc

)

Cleans up connection state.

No notifications.

Definition at line 158 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void tcp_connection_close

(

tcp_connection_t *

tc

)

Begin connection closing procedure.

If at the end the connection is not in CLOSED state, it is not removed. Instead, we rely on on TCP to advance through state machine to either 1) LAST_ACK (passive close) whereby when the last ACK is received tcp_connection_del is called. This notifies session of the delete and calls cleanup. 2) TIME_WAIT (active close) whereby after 2MSL the 2MSL timer triggers and cleanup is called.

N.B. Half-close connections are not supported

Definition at line 270 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void tcp_connection_del

(

tcp_connection_t *

tc

)

Connection removal.

This should be called only once connection enters CLOSED state. Note that it notifies the session of the removal event, so if the goal is to just remove the connection, call tcp_connection_cleanup instead.

Definition at line 196 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void tcp_connection_init_vars

(

tcp_connection_t *

tc

)

Initialize tcp connection variables.

Should be called after having received a msg from the peer, i.e., a SYN or a SYNACK, such that connection options have already been exchanged.

Definition at line 488 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

tcp_connection_t* tcp_connection_new

(

u8

thread_index

)

Definition at line 204 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

int tcp_connection_open

(

transport_endpoint_t *

rmt

)

Definition at line 531 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void tcp_connection_reset

(

tcp_connection_t *

tc

)

Notify session that connection has been reset.

Switch state to closed and wait for session to call cleanup.

Definition at line 221 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void tcp_connection_timers_init

(

tcp_connection_t *

tc

)

Initialize all connection timers as invalid.

Definition at line 337 of file tcp.c.

Here is the caller graph for this function:

void tcp_connection_timers_reset

(

tcp_connection_t *

tc

)

Stop all connection timers.

Definition at line 354 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static void tcp_connection_unbind ( u32  listener_index )

static

Definition at line 72 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static void tcp_expired_timers_dispatch ( u32 *  expired_timers )

static

Definition at line 1132 of file tcp.c.

Here is the caller graph for this function:

int tcp_half_open_connection_cleanup

(

tcp_connection_t *

tc

)

Try to cleanup half-open connection.

If called from a thread that doesn't own tc, the call won't have any effect.

Parameters

tc	- connection to be cleaned up

Returns

non-zero if cleanup failed.

Definition at line 129 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void tcp_half_open_connection_del

(

tcp_connection_t *

tc

)

Cleanup half-open connection.

Definition at line 109 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

tcp_connection_t* tcp_half_open_connection_new

(

void

)

Definition at line 141 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

transport_connection_t* tcp_half_open_session_get_transport

(

u32

conn_index

)

Definition at line 885 of file tcp.c.

Here is the call graph for this function:

clib_error_t* tcp_init

(

vlib_main_t *

vm

)

Definition at line 1283 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void tcp_init_snd_vars

(

tcp_connection_t *

tc

)

Initialize connection send variables.

Definition at line 464 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void tcp_initialize_timer_wheels

(

tcp_main_t *

tm

)

Definition at line 1151 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

clib_error_t* tcp_main_enable

(

vlib_main_t *

vm

)

Definition at line 1165 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

void tcp_punt_unknown	(	vlib_main_t *	vm,
		u8	is_ip4,
		u8	is_add
	)

Definition at line 1273 of file tcp.c.

Here is the caller graph for this function:

i32 tcp_rcv_wnd_available

(

tcp_connection_t *

tc

)

Definition at line 996 of file tcp.c.

Here is the caller graph for this function:

static u32 tcp_round_snd_space ( tcp_connection_t *  tc, u32  snd_space  )

inlinestatic

Definition at line 912 of file tcp.c.

Here is the caller graph for this function:

static u8* tcp_scoreboard_dump_trace ( u8 *  s, sack_scoreboard_t *  sb  )

static

Definition at line 1601 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

u8* tcp_scoreboard_replay	(	u8 *	s,
		tcp_connection_t *	tc,
		u8	verbose
	)

Definition at line 1664 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static clib_error_t* tcp_scoreboard_trace_fn ( vlib_main_t *  vm, unformat_input_t *  input, vlib_cli_command_t *  cmd_arg  )

static

Definition at line 1742 of file tcp.c.

Here is the call graph for this function:

u32 tcp_session_bind	(	u32	session_index,
		transport_endpoint_t *	tep
	)

Definition at line 66 of file tcp.c.

Here is the call graph for this function:

void tcp_session_cleanup	(	u32	conn_index,
		u32	thread_index
	)

Definition at line 321 of file tcp.c.

Here is the call graph for this function:

void tcp_session_close	(	u32	conn_index,
		u32	thread_index
	)

Definition at line 313 of file tcp.c.

Here is the call graph for this function:

transport_connection_t* tcp_session_get_listener

(

u32

listener_index

)

Definition at line 96 of file tcp.c.

Here is the call graph for this function:

transport_connection_t* tcp_session_get_transport	(	u32	conn_index,
		u32	thread_index
	)

Definition at line 878 of file tcp.c.

Here is the call graph for this function:

int tcp_session_open

(

transport_endpoint_t *

tep

)

Definition at line 578 of file tcp.c.

Here is the call graph for this function:

u16 tcp_session_send_mss

(

transport_connection_t *

trans_conn

)

Compute maximum segment size for session layer.

Since the result needs to be the actual data length, it first computes the tcp options to be used in the next burst and subtracts their length from the connection's snd_mss.

Definition at line 899 of file tcp.c.

Here is the call graph for this function:

u32 tcp_session_send_space

(

transport_connection_t *

trans_conn

)

Definition at line 988 of file tcp.c.

Here is the call graph for this function:

u32 tcp_session_tx_fifo_offset

(

transport_connection_t *

trans_conn

)

Definition at line 1002 of file tcp.c.

u32 tcp_session_unbind

(

u32

listener_index

)

Definition at line 89 of file tcp.c.

Here is the call graph for this function:

static clib_error_t* tcp_show_scoreboard_trace_fn ( vlib_main_t *  vm, unformat_input_t *  input, vlib_cli_command_t *  cmd_arg  )

static

Definition at line 1626 of file tcp.c.

Here is the call graph for this function:

u32 tcp_snd_space

(

tcp_connection_t *

tc

)

Compute tx window session is allowed to fill.

Takes into account available send space, snd_mss and the congestion state of the connection. If possible, the value returned is a multiple of snd_mss.

Parameters

tc	tcp connection

Returns

number of bytes session is allowed to write

Definition at line 939 of file tcp.c.

Here is the call graph for this function:

Here is the caller graph for this function:

static clib_error_t* tcp_src_address ( vlib_main_t *  vm, unformat_input_t *  input, vlib_cli_command_t *  cmd_arg  )

static

Definition at line 1513 of file tcp.c.

Here is the call graph for this function:

void tcp_timer_establish_handler

(

u32

conn_index

)

Definition at line 1058 of file tcp.c.

Here is the call graph for this function:

void tcp_timer_keep_handler

(

u32

conn_index

)

Definition at line 1046 of file tcp.c.

Here is the call graph for this function:

void tcp_timer_waitclose_handler

(

u32

conn_index

)

Definition at line 1086 of file tcp.c.

Here is the call graph for this function:

void tcp_update_time	(	f64	now,
		u8	thread_index
	)

Definition at line 1013 of file tcp.c.

Here is the call graph for this function:

clib_error_t* vnet_tcp_enable_disable	(	vlib_main_t *	vm,
		u8	is_en
	)

Definition at line 1255 of file tcp.c.

Here is the call graph for this function:

Variable Documentation

vlib_cli_command_t show_tcp_punt_command

static

Initial value:

=
{
  .path = "show tcp punt",
  .short_help = "show tcp punt",
  .function = show_tcp_punt_fn,
}

(constructor) VLIB_CLI_COMMAND (show_tcp_punt_command)

Definition at line 1799 of file tcp.c.

const char* tcp_conn_timers[]

Initial value:

= {
#define _(sym, str) 
  foreach_tcp_timer

}

Definition at line 632 of file tcp.c.

const char* tcp_connection_flags_str[]

Initial value:

= {
#define _(sym, str) 
  foreach_tcp_connection_flag

}

Definition at line 607 of file tcp.c.

const char* tcp_dbg_evt_str[]

Initial value:

= {
#define _(sym, str) 
  foreach_tcp_dbg_evt

}

Definition at line 583 of file tcp.c.

const char* tcp_fsm_states[]

Initial value:

= {
#define _(sym, str) 
  foreach_tcp_fsm_state

}

Definition at line 589 of file tcp.c.

tcp_main_t tcp_main

Definition at line 29 of file tcp.c.

const transport_proto_vft_t tcp_proto

static

Initial value:

= {
  .enable = vnet_tcp_enable_disable,
  .bind = tcp_session_bind,
  .unbind = tcp_session_unbind,
  .push_header = tcp_push_header,
  .get_connection = tcp_session_get_transport,
  .get_listener = tcp_session_get_listener,
  .get_half_open = tcp_half_open_session_get_transport,
  .open = tcp_session_open,
  .close = tcp_session_close,
  .cleanup = tcp_session_cleanup,
  .send_mss = tcp_session_send_mss,
  .send_space = tcp_session_send_space,
  .update_time = tcp_update_time,
  .tx_fifo_offset = tcp_session_tx_fifo_offset,
  .format_connection = format_tcp_session,
  .format_listener = format_tcp_listener_session,
  .format_half_open = format_tcp_half_open_session,
  .tx_type = TRANSPORT_TX_PEEK,
  .service_type = TRANSPORT_SERVICE_VC,
}

Definition at line 1022 of file tcp.c.

vlib_cli_command_t tcp_replay_scoreboard_command

static

Initial value:

=
{
  .path = "tcp replay scoreboard",
  .short_help = "tcp replay scoreboard <connection>",
  .function = tcp_scoreboard_trace_fn,
}

(constructor) VLIB_CLI_COMMAND (tcp_replay_scoreboard_command)

Definition at line 1776 of file tcp.c.

vlib_cli_command_t tcp_show_scoreboard_trace_command

static

Initial value:

=
{
  .path = "show tcp scoreboard trace",
  .short_help = "show tcp scoreboard trace <connection>",
  .function = tcp_show_scoreboard_trace_fn,
}

(constructor) VLIB_CLI_COMMAND (tcp_show_scoreboard_trace_command)

Definition at line 1655 of file tcp.c.

vlib_cli_command_t tcp_src_address_command

static

Initial value:

=
{
  .path = "tcp src-address",
  .short_help = "tcp src-address <ip-addr> [- <ip-addr>] add src address range",
  .function = tcp_src_address,
}

(constructor) VLIB_CLI_COMMAND (tcp_src_address_command)

Definition at line 1592 of file tcp.c.

timer_expiration_handler* timer_expiration_handlers[TCP_N_TIMERS]

static

Initial value:

=
{
    tcp_timer_retransmit_handler,
    tcp_timer_delack_handler,
    tcp_timer_persist_handler,
    tcp_timer_keep_handler,
    tcp_timer_waitclose_handler,
    tcp_timer_retransmit_syn_handler,
    tcp_timer_establish_handler
}

Definition at line 1119 of file tcp.c.