sctp: Implement RFC6951: UDP Encapsulation of SCTP
Subsystems (5)
Xin Long
maintainerv4 cover sctp: Implement RFC6951: UDP Encapsulation of SCTP
Description From the RFC:
The Main Reasons:
o To allow SCTP traffic to pass through legacy NATs, which do not provide native SCTP support as specified in [BEHAVE] and [NATSUPP].
o To allow SCTP to be implemented on hosts that do not provide direct access to the IP layer. In particular, applications can use their own SCTP implementation if the operating system does not provide one.
Implementation Notes:
UDP-encapsulated SCTP is normally communicated between SCTP stacks using the IANA-assigned UDP port number 9899 (sctp-tunneling) on both ends. There are circumstances where other ports may be used on either end, and it might be required to use ports other than the registered port.
Each SCTP stack uses a single local UDP encapsulation port number as the destination port for all its incoming SCTP packets, this greatly simplifies implementation design.
An SCTP implementation supporting UDP encapsulation MUST maintain a remote UDP encapsulation port number per destination address for each SCTP association. Again, because the remote stack may be using ports other than the well-known port, each port may be different from each stack. However, because of remapping of ports by NATs, the remote ports associated with different remote IP addresses may not be identical, even if they are associated with the same stack.
Because the well-known port might not be used, implementations need to allow other port numbers to be specified as a local or remote UDP encapsulation port number through APIs.
Patches:
This patchset is using the udp4/6 tunnel APIs to implement the UDP Encapsulation of SCTP with not much change in SCTP protocol stack and with all current SCTP features keeped in Linux Kernel.
1 - 4: Fix some UDP issues that may be triggered by SCTP over UDP. 5 - 7: Process incoming UDP encapsulated packets and ICMP packets. 8 -10: Remote encap port's update by sysctl, sockopt and packets. 11-14: Process outgoing pakects with UDP encapsulated and its GSO. 15-16: Add the part from draft-tuexen-tsvwg-sctp-udp-encaps-cons-03.
17: Enable this feature.
Tests:
- lksctp-tools/src/func_tests with UDP Encapsulation enabled/disabled:
Both make v4test and v6test passed.
- sctp-tests with UDP Encapsulation enabled/disabled:
repeatability/procdumps/sctpdiag/gsomtuchange/extoverflow/ sctphashtable passed. Others failed as expected due to those "iptables -p sctp" rules.
- netperf on lo/netns/virtio_net, with gso enabled/disabled and with ip_checksum enabled/disabled, with UDP Encapsulation enabled/disabled:
No clear performance dropped.
v1->v2:
- Fix some incorrect code in the patches 5,6,8,10,11,13,14,17, suggested by Marcelo.
- Append two patches 15-16 to add the Additional Considerations for UDP Encapsulation of SCTP from draft-tuexen-tsvwg-sctp-udp-encaps-cons-03.v2->v3:
- remove the cleanup code in patch 2, suggested by Willem.
- remove the patch 3 and fix the checksum in the new patch 3 after talking with Paolo, Marcelo and Guillaume.
- add 'select NET_UDP_TUNNEL' in patch 4 to solve a compiling error.
- fix __be16 type cast warning in patch 8.
- fix the wrong endian orders when setting values in 14,16.v3->v4:
- add entries in ip-sysctl.rst in patch 7,16, as Marcelo Suggested.
- not create udp socks when udp_port is set to 0 in patch 16, as Marcelo noticed.
Xin Long (16):
udp: check udp sock encap_type in __udp_lib_err
udp6: move the mss check after udp gso tunnel processing
udp: support sctp over udp in skb_udp_tunnel_segment
sctp: create udp4 sock and add its encap_rcv
sctp: create udp6 sock and set its encap_rcv
sctp: add encap_err_lookup for udp encap socks
sctp: add encap_port for netns sock asoc and transport
sctp: add SCTP_REMOTE_UDP_ENCAPS_PORT sockopt
sctp: allow changing transport encap_port by peer packets
sctp: add udphdr to overhead when udp_port is set
sctp: call sk_setup_caps in sctp_packet_transmit instead
sctp: support for sending packet over udp4 sock
sctp: support for sending packet over udp6 sock
sctp: add the error cause for new encapsulation port restart
sctp: handle the init chunk matching an existing asoc
sctp: enable udp tunneling socks
Documentation/networking/ip-sysctl.rst | 15 ++++ include/linux/sctp.h | 20 +++++ include/net/netns/sctp.h | 8 ++ include/net/sctp/constants.h | 2 + include/net/sctp/sctp.h | 9 +- include/net/sctp/sm.h | 4 + include/net/sctp/structs.h | 14 ++-- include/uapi/linux/sctp.h | 7 ++ net/ipv4/udp.c | 2 +- net/ipv4/udp_offload.c | 3 + net/ipv6/udp.c | 2 +- net/ipv6/udp_offload.c | 8 +- net/sctp/Kconfig | 1 + net/sctp/associola.c | 4 + net/sctp/ipv6.c | 44 +++++++--- net/sctp/offload.c | 6 +- net/sctp/output.c | 22 +++-- net/sctp/protocol.c | 148 ++++++++++++++++++++++++++++++--- net/sctp/sm_make_chunk.c | 21 +++++ net/sctp/sm_statefuns.c | 52 ++++++++++++ net/sctp/socket.c | 116 ++++++++++++++++++++++++++ net/sctp/sysctl.c | 62 ++++++++++++++ 22 files changed, 520 insertions(+), 50 deletions(-)
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 1/16 udp: check udp sock encap_type in __udp_lib_err
There is a chance that __udp4/6_lib_lookup() returns a udp encap sock in __udp_lib_err(), like the udp encap listening sock may use the same port as remote encap port, in which case it should go to __udp4/6_lib_err_encap() for more validation before processing the icmp packet.
This patch is to check encap_type in __udp_lib_err() for the further validation for a encap sock.
--- net/ipv4/udp.c | 2 +- net/ipv6/udp.c | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-)
net/ipv4/udp.c +1 -1
@@ -702,7 +702,7 @@ int __udp4_lib_err(struct sk_buff *skb, u32 info, struct udp_table *udptable) sk =__udp4_lib_lookup (net, iph->daddr, uh->dest, iph->saddr, uh->source, skb->dev->ifindex,inet_sdif (skb), udptable,NULL ); -if (!sk) { +if (!sk ||udp_sk (sk)->encap_type) {/* No socket for error: try tunnels before discarding */ sk =ERR_PTR (-ENOENT );if (static_branch_unlikely (&udp_encap_needed_key)) {
net/ipv6/udp.c +1 -1
@@ -560,7 +560,7 @@ int __udp6_lib_err(struct sk_buff *skb, struct inet6_skb_parm *opt, sk =__udp6_lib_lookup (net, daddr, uh->dest, saddr, uh->source,inet6_iif (skb),inet6_sdif (skb), udptable,NULL ); -if (!sk) { +if (!sk ||udp_sk (sk)->encap_type) {/* No socket for error: try tunnels before discarding */ sk =ERR_PTR (-ENOENT );if (static_branch_unlikely (&udpv6_encap_needed_key)) {
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 2/16 udp6: move the mss check after udp gso tunnel processing
For some protocol's gso, like SCTP, it's using GSO_BY_FRAGS for gso_size. When using UDP to encapsulate its packet, it will return error in udp6_ufo_fragment() as skb->len < gso_size, and it will never go to the gso tunnel processing.
So we should move this check after udp gso tunnel processing, the same as udp4_ufo_fragment() does.
v1->v2:
- no change.v2->v3:
- not do any cleanup.
--- net/ipv6/udp_offload.c | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-)
net/ipv6/udp_offload.c +4 -4
@@ -28,10 +28,6 @@ static struct sk_buff *udp6_ufo_fragment(struct sk_buff *skb,int tnl_hlen;int err; - mss =skb_shinfo (skb)->gso_size; -if (unlikely (skb->len <= mss)) - goto out; -if (skb->encapsulation &&skb_shinfo (skb)->gso_type & (SKB_GSO_UDP_TUNNEL |SKB_GSO_UDP_TUNNEL_CSUM )) segs =skb_udp_tunnel_segment (skb, features, true);
@@ -48,6 +44,10 @@ static struct sk_buff *udp6_ufo_fragment(struct sk_buff *skb,if (skb_shinfo (skb)->gso_type &SKB_GSO_UDP_L4 )return __udp_gso_segment (skb, features); + mss =skb_shinfo (skb)->gso_size; +if (unlikely (skb->len <= mss)) + goto out; +/* Do software UFO. Complete and fill in the UDP checksum as HW cannot * do checksum of UDP packets sent as multiple IP fragments. */
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 3/16 udp: support sctp over udp in skb_udp_tunnel_segment
For the gso of sctp over udp packets, sctp_gso_segment() will be called in skb_udp_tunnel_segment(), we need to set transport_header to sctp header.
As all the current HWs can't handle both crc checksum and udp checksum at the same time, the crc checksum has to be done in sctp_gso_segment() by removing the NETIF_F_SCTP_CRC flag from the features.
Meanwhile, if the HW can't do udp checksum, csum and csum_start has to be set correctly, and udp checksum will be done in __skb_udp_tunnel_segment() by calling gso_make_checksum().
Thanks to Paolo, Marcelo and Guillaume for helping with this one.
v1->v2:
- no change.v2->v3:
- remove the he NETIF_F_SCTP_CRC flag from the features.
- set csum and csum_start in sctp_gso_make_checksum().
--- net/ipv4/udp_offload.c | 3 +++ net/sctp/offload.c | 6 +++++- 2 files changed, 8 insertions(+), 1 deletion(-)
net/ipv4/udp_offload.c +3 -0
@@ -49,6 +49,7 @@ static struct sk_buff *__skb_udp_tunnel_segment(struct sk_buff *skb,__skb_pull (skb, tnl_hlen);skb_reset_mac_header (skb);skb_set_network_header (skb,skb_inner_network_offset (skb)); +skb_set_transport_header (skb,skb_inner_transport_offset (skb)); skb->mac_len =skb_inner_network_offset (skb); skb->protocol = new_protocol;
@@ -67,6 +68,8 @@ static struct sk_buff *__skb_udp_tunnel_segment(struct sk_buff *skb, (NETIF_F_HW_CSUM | NETIF_F_IP_CSUM)))); features &= skb->dev->hw_enc_features; +/* CRC checksum can't be handled by HW when it's a UDP tunneling packet. */ + features &= ~NETIF_F_SCTP_CRC ;/* The only checksum offload we care about from here on out is the * outer one so strip the existing checksum feature flags and
net/sctp/offload.c +5 -1
@@ -27,7 +27,11 @@ static __le32 sctp_gso_make_checksum(struct sk_buff *skb) { skb->ip_summed =CHECKSUM_NONE ; skb->csum_not_inet =0 ; -gso_reset_checksum (skb, ~0 ); +/* csum and csum_start in GSO CB may be needed to do the UDP +* checksum when it's a UDP tunneling packet. +*/ +SKB_GSO_CB (skb)->csum = (__force __wsum )~0 ; +SKB_GSO_CB (skb)->csum_start =skb_headroom (skb) + skb->len;return sctp_compute_cksum (skb,skb_transport_offset (skb)); }
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 4/16 sctp: create udp4 sock and add its encap_rcv
This patch is to add the functions to create/release udp4 sock, and set the sock's encap_rcv to process the incoming udp encap sctp packets. In sctp_udp_rcv(), as we can see, all we need to do is fix the transport header for sctp_rcv(), then it would implement the part of rfc6951#section-5.4:
"When an encapsulated packet is received, the UDP header is removed.
Then, the generic lookup is performed, as done by an SCTP stack whenever a packet is received, to find the association for the received SCTP packet"
Note that these functions will be called in the last patch of this patchset when enabling this feature.
v1->v2:
- Add pr_err() when fails to create udp v4 sock.v2->v3:
- Add 'select NET_UDP_TUNNEL' in sctp Kconfig.
--- include/net/netns/sctp.h | 5 +++++ include/net/sctp/constants.h | 2 ++ include/net/sctp/sctp.h | 2 ++ net/sctp/Kconfig | 1 + net/sctp/protocol.c | 43 +++++++++++++++++++++++++++++++++++++++++++ 5 files changed, 53 insertions(+)
include/net/netns/sctp.h +5 -0
@@ -22,6 +22,11 @@ struct netns_sctp {*/ struct sock *ctl_sock; +/* UDP tunneling listening sock. */ +struct sock *udp4_sock; +/* UDP tunneling listening port. */ +int udp_port; +/* This is the global local address list. * We actively maintain this complete list of addresses on * the system by catching address add/delete events.
include/net/sctp/constants.h +2 -0
@@ -286,6 +286,8 @@ enum { SCTP_MAX_GABS = 16 };* functions simpler to write. */ +#define SCTP_DEFAULT_UDP_PORT 9899/* default UDP tunneling port */ +/* These are the values for pf exposure, UNUSED is to keep compatible with old * applications by default. */
include/net/sctp/sctp.h +2 -0
@@ -84,6 +84,8 @@ int sctp_copy_local_addr_list(struct net *net, struct sctp_bind_addr *addr,struct sctp_pf *sctp_get_pf_specific (sa_family_t family);int sctp_register_pf (struct sctp_pf *,sa_family_t );void sctp_addr_wq_mgmt (struct net *,struct sctp_sockaddr_entry *,int ); +int sctp_udp_sock_start (struct net *net); +void sctp_udp_sock_stop (struct net *net);/* * sctp/socket.c
net/sctp/Kconfig +1 -0
@@ -11,6 +11,7 @@ menuconfig IP_SCTP select CRYPTO_HMAC select CRYPTO_SHA1 select LIBCRC32C + select NET_UDP_TUNNEL help Stream Control Transmission Protocol
net/sctp/protocol.c +43 -0
61 lines not on this page · raw message
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 5/16 sctp: create udp6 sock and set its encap_rcv
This patch is to add the udp6 sock part in sctp_udp_sock_start/stop(). udp_conf.use_udp6_rx_checksums is set to true, as:
"The SCTP checksum MUST be computed for IPv4 and IPv6, and the UDP
checksum SHOULD be computed for IPv4 and IPv6"
says in rfc6951#section-5.3.
v1->v2:
- Add pr_err() when fails to create udp v6 sock.
- Add #if IS_ENABLED(CONFIG_IPV6) not to create v6 sock when ipv6 is disabled.
--- include/net/netns/sctp.h | 1 + net/sctp/protocol.c | 26 ++++++++++++++++++++++++++ 2 files changed, 27 insertions(+)
include/net/netns/sctp.h +1 -0
@@ -24,6 +24,7 @@ struct netns_sctp {/* UDP tunneling listening sock. */ struct sock *udp4_sock; +struct sock *udp6_sock;/* UDP tunneling listening port. */ int udp_port;
net/sctp/protocol.c +26 -0
@@ -869,6 +869,28 @@ int sctp_udp_sock_start(struct net *net)setup_udp_tunnel_sock (net, sock, &tuncfg); net->sctp.udp4_sock = sock->sk; +#if IS_ENABLED (CONFIG_IPV6 ) +memset (&udp_conf,0 ,sizeof (udp_conf)); + + udp_conf.family =AF_INET6 ; + udp_conf.local_ip6 = in6addr_any; + udp_conf.local_udp_port =htons (net->sctp.udp_port); + udp_conf.use_udp6_rx_checksums = true; + udp_conf.ipv6_v6only = true; + err =udp_sock_create (net, &udp_conf, &sock); +if (err) { +pr_err ("Failed to create the SCTP UDP tunneling v6 sock\n" ); +udp_tunnel_sock_release (net->sctp.udp4_sock->sk_socket); + net->sctp.udp4_sock =NULL ; +return err; + } + + tuncfg.encap_type =1 ; + tuncfg.encap_rcv = sctp_udp_rcv; +setup_udp_tunnel_sock (net, sock, &tuncfg); + net->sctp.udp6_sock = sock->sk; +#endif +return 0 ; }
@@ -878,6 +900,10 @@ void sctp_udp_sock_stop(struct net *net)udp_tunnel_sock_release (net->sctp.udp4_sock->sk_socket); net->sctp.udp4_sock =NULL ; } +if (net->sctp.udp6_sock) { +udp_tunnel_sock_release (net->sctp.udp6_sock->sk_socket); + net->sctp.udp6_sock =NULL ; + } }/* Register address family specific functions. */
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 6/16 sctp: add encap_err_lookup for udp encap socks
As it says in rfc6951#section-5.5:
"When receiving ICMP or ICMPv6 response packets, there might not be
enough bytes in the payload to identify the SCTP association that the SCTP packet triggering the ICMP or ICMPv6 packet belongs to. If a received ICMP or ICMPv6 packet cannot be related to a specific SCTP association or the verification tag cannot be verified, it MUST be discarded silently. In particular, this means that the SCTP stack MUST NOT rely on receiving ICMP or ICMPv6 messages. Implementation constraints could prevent processing received ICMP or ICMPv6 messages."
ICMP or ICMPv6 packets need to be handled, and this is implemented by udp encap sock .encap_err_lookup function.
The .encap_err_lookup function is called in __udp(6)_lib_err_encap() to confirm this path does need to be updated. For sctp, what we can do here is check if the corresponding asoc and transport exist.
Note that icmp packet process for sctp over udp is done by udp sock .encap_err_lookup(), and it means for now we can't do as much as sctp_v4/6_err() does. Also we can't do the two mappings mentioned in rfc6951#section-5.5.
--- net/sctp/protocol.c | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+)
net/sctp/protocol.c +19 -0
@@ -848,6 +848,23 @@ static int sctp_udp_rcv(struct sock *sk, struct sk_buff *skb)return 0 ; } +static int sctp_udp_err_lookup (struct sock *sk,struct sk_buff *skb) +{ +struct sctp_association *asoc; +struct sctp_transport *t; +int family; + + skb->transport_header +=sizeof (struct udphdr ); + family = (ip_hdr (skb)->version =4 ) ?AF_INET :AF_INET6 ; + sk =sctp_err_lookup (dev_net (skb->dev), family, skb,sctp_hdr (skb), + &asoc, &t); +if (!sk) +return -ENOENT ; + +sctp_err_finish (sk, t); +return 0 ; +} +int sctp_udp_sock_start (struct net *net) {struct udp_tunnel_sock_cfg tuncfg = {NULL };
@@ -866,6 +883,7 @@ int sctp_udp_sock_start(struct net *net) tuncfg.encap_type =1 ; tuncfg.encap_rcv = sctp_udp_rcv; + tuncfg.encap_err_lookup = sctp_udp_err_lookup;setup_udp_tunnel_sock (net, sock, &tuncfg); net->sctp.udp4_sock = sock->sk;
@@ -887,6 +905,7 @@ int sctp_udp_sock_start(struct net *net) tuncfg.encap_type =1 ; tuncfg.encap_rcv = sctp_udp_rcv; + tuncfg.encap_err_lookup = sctp_udp_err_lookup;setup_udp_tunnel_sock (net, sock, &tuncfg); net->sctp.udp6_sock = sock->sk;#endif
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 7/16 sctp: add encap_port for netns sock asoc and transport
encap_port is added as per netns/sock/assoc/transport, and the latter one's encap_port inherits the former one's by default. The transport's encap_port value would mostly decide if one packet should go out with udp encapsulated or not.
This patch also allows users to set netns' encap_port by sysctl.
v1->v2:
- Change to define encap_port as __be16 for sctp_sock, asoc and transport.v2->v3:
- No change.v3->v4:
- Add 'encap_port' entry in ip-sysctl.rst.
--- Documentation/networking/ip-sysctl.rst | 9 +++++++++ include/net/netns/sctp.h | 2 ++ include/net/sctp/structs.h | 6 ++++++ net/sctp/associola.c | 4 ++++ net/sctp/protocol.c | 3 +++ net/sctp/socket.c | 1 + net/sctp/sysctl.c | 10 ++++++++++ 7 files changed, 35 insertions(+)
Documentation/networking/ip-sysctl.rst +9 -0
@@ -2640,6 +2640,15 @@ addr_scope_policy - INTEGER Default: 1 +encap_port - INTEGER + The default remote UDP encapsalution port. + When UDP tunneling is enabled, this global value is used to set + the dest port for the udp header of outgoing packets by default. + Users can also change the value for each sock/asoc/transport by + using setsockopt. + + Default: 0 + ``/proc/sys/net/core/*`` ============
include/net/netns/sctp.h +2 -0
@@ -27,6 +27,8 @@ struct netns_sctp {struct sock *udp6_sock;/* UDP tunneling listening port. */ int udp_port; +/* UDP tunneling remote encap port. */ +int encap_port;/* This is the global local address list. * We actively maintain this complete list of addresses on
include/net/sctp/structs.h +6 -0
@@ -178,6 +178,8 @@ struct sctp_sock {*/ __u32 hbinterval; +__be16 encap_port; +/* This is the max_retrans value for new associations. */ __u16 pathmaxrxt;
@@ -877,6 +879,8 @@ struct sctp_transport {*/ unsigned long last_time_ecne_reduced; +__be16 encap_port; +/* This is the max_retrans value for the transport and will * be initialized from the assocs value. This can be changed * using the SCTP_SET_PEER_ADDR_PARAMS socket option.
@@ -1790,6 +1794,8 @@ struct sctp_association {*/ unsigned long hbinterval; +__be16 encap_port; +/* This is the max_retrans value for new transports in the * association. */
net/sctp/associola.c +4 -0
@@ -99,6 +99,8 @@ static struct sctp_association *sctp_association_init(*/ asoc->hbinterval =msecs_to_jiffies (sp->hbinterval); + asoc->encap_port = sp->encap_port; +/* Initialize path max retrans value. */ asoc->pathmaxrxt = sp->pathmaxrxt;
@@ -624,6 +626,8 @@ struct sctp_transport *sctp_assoc_add_peer(struct sctp_association *asoc,*/ peer->hbinterval = asoc->hbinterval; + peer->encap_port = asoc->encap_port; +/* Set the path max_retrans. */ peer->pathmaxrxt = asoc->pathmaxrxt;
net/sctp/protocol.c +3 -0
@@ -1359,6 +1359,9 @@ static int __net_init sctp_defaults_init(struct net *net)/* Set UDP tunneling listening port to default value */ net->sctp.udp_port =SCTP_DEFAULT_UDP_PORT ; +/* Set remote encap port to 0 by default */ + net->sctp.encap_port =0 ; +/* Set SCOPE policy to enabled */ net->sctp.scope_policy =SCTP_SCOPE_POLICY_ENABLE ;
net/sctp/socket.c +1 -0
@@ -4876,6 +4876,7 @@ static int sctp_init_sock(struct sock *sk)* be modified via SCTP_PEER_ADDR_PARAMS */ sp->hbinterval = net->sctp.hb_interval; + sp->encap_port =htons (net->sctp.encap_port); sp->pathmaxrxt = net->sctp.max_retrans_path; sp->pf_retrans = net->sctp.pf_retrans; sp->ps_retrans = net->sctp.ps_retrans;
net/sctp/sysctl.c +1 -0
@@ -36,6 +36,7 @@ static int rto_alpha_max = 1000;static int rto_beta_max =1000 ;static int pf_expose_max =SCTP_PF_EXPOSE_MAX ;static int ps_retrans_max =SCTP_PS_RETRANS_MAX ; +static int udp_port_max =65535 ;static unsigned long max_autoclose_min =0 ; static unsigned long max_autoclose_max @@ -291,6 +292,15 @@ static struct ctl_table sctp_net_table[] = {
.proc_handler = proc_dointvec,
},
{
+ .procname = "encap_port",
+ .data = &init_net.sctp.encap_port,
+ .maxlen = sizeof(int),
+ .mode = 0644,
+ .proc_handler = proc_dointvec,
+ .extra1 = SYSCTL_ZERO,
+ .extra2 = &udp_port_max,
+ },
+ {
.procname = "addr_scope_policy",
.data = &init_net.sctp.scope_policy,
.maxlen = sizeof(int),
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 8/16 sctp: add SCTP_REMOTE_UDP_ENCAPS_PORT sockopt
This patch is to implement:
rfc6951#section-6.1: Get or Set the Remote UDP Encapsulation Port Number
with the param of the struct:
struct sctp_udpencaps {
sctp_assoc_t sue_assoc_id;
struct sockaddr_storage sue_address;
uint16_t sue_port;
};the encap_port of sock, assoc or transport can be changed by users, which also means it allows the different transports of the same asoc to have different encap_port value.
v1->v2:
- no change.v2->v3:
- fix the endian warning when setting values between encap_port and sue_port.
--- include/uapi/linux/sctp.h | 7 +++ net/sctp/socket.c | 114 ++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 121 insertions(+)
include/uapi/linux/sctp.h +7 -0
@@ -140,6 +140,7 @@ typedef __s32 sctp_assoc_t;#define SCTP_ECN_SUPPORTED 130#define SCTP_EXPOSE_POTENTIALLY_FAILED_STATE 131#define SCTP_EXPOSE_PF_STATE SCTP_EXPOSE_POTENTIALLY_FAILED_STATE +#define SCTP_REMOTE_UDP_ENCAPS_PORT 132/* PR-SCTP policies */ #define SCTP_PR_SCTP_NONE 0x0000
@@ -1197,6 +1198,12 @@ struct sctp_event {uint8_t se_on; }; +struct sctp_udpencaps { +sctp_assoc_t sue_assoc_id; +struct sockaddr_storage sue_address; +uint16_t sue_port; +}; +/* SCTP Stream schedulers */ enum sctp_sched_type {SCTP_SS_FCFS ,
net/sctp/socket.c +114 -0
138 lines not on this page · raw message
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 9/16 sctp: allow changing transport encap_port by peer packets
As rfc6951#section-5.4 says:
"After finding the SCTP association (which
includes checking the verification tag), the UDP source port MUST be stored as the encapsulation port for the destination address the SCTP packet is received from (see Section 5.1).
When a non-encapsulated SCTP packet is received by the SCTP stack, the encapsulation of outgoing packets belonging to the same association and the corresponding destination address MUST be disabled."
transport encap_port should be updated by a validated incoming packet's udp src port.
We save the udp src port in sctp_input_cb->encap_port, and then update the transport in two places:
1. right after vtag is verified, which is required by RFC, and this allows the existent transports to be updated by the chunks that can only be processed on an asoc.
2. right before processing the 'init' where the transports are added, and this allows building a sctp over udp connection by client with the server not knowing the remote encap port.
3. when processing ootb_pkt and creating the temporary transport for the reply pkt.
Note that sctp_input_cb->header is removed, as it's not used any more in sctp.
v1->v2:
- Change encap_port as __be16 for sctp_input_cb.
--- include/net/sctp/sm.h | 1 + include/net/sctp/structs.h | 7 +------ net/sctp/ipv6.c | 1 + net/sctp/protocol.c | 11 ++++++++++- net/sctp/sm_make_chunk.c | 1 + net/sctp/sm_statefuns.c | 2 ++ 6 files changed, 16 insertions(+), 7 deletions(-)
include/net/sctp/sm.h +1 -0
@@ -380,6 +380,7 @@ sctp_vtag_verify(const struct sctp_chunk *chunk,if (ntohl (chunk->sctp_hdr->vtag) = asoc->c.my_vtag)return 1 ; + chunk->transport->encap_port =SCTP_INPUT_CB (chunk->skb)->encap_port;return 0 ; }
include/net/sctp/structs.h +1 -6
@@ -1120,14 +1120,9 @@ static inline void sctp_outq_cork(struct sctp_outq *q)* sctp_input_cb is currently used on rx and sock rx queue */ struct sctp_input_cb { -union { -struct inet_skb_parm h4; -#if IS_ENABLED (CONFIG_IPV6 ) -struct inet6_skb_parm h6; -#endif - } header;struct sctp_chunk *chunk;struct sctp_af *af; +__be16 encap_port; };#define SCTP_INPUT_CB (__skb) ((struct sctp_input_cb *)&((__skb)->cb[0]))
net/sctp/ipv6.c +1 -0
@@ -1053,6 +1053,7 @@ static struct inet_protosw sctpv6_stream_protosw = {static int sctp6_rcv (struct sk_buff *skb) { +memset (skb->cb,0 ,sizeof (skb->cb));return sctp_rcv (skb) ?-1 :0 ; }
net/sctp/protocol.c +10 -1
@@ -843,6 +843,9 @@ static int sctp_ctl_sock_init(struct net *net)static int sctp_udp_rcv (struct sock *sk,struct sk_buff *skb) { +memset (skb->cb,0 ,sizeof (skb->cb)); +SCTP_INPUT_CB (skb)->encap_port =udp_hdr (skb)->source; +skb_set_transport_header (skb,sizeof (struct udphdr ));sctp_rcv (skb);return 0 ;
@@ -1139,9 +1142,15 @@ static struct inet_protosw sctp_stream_protosw = { .flags = SCTP_PROTOSW_FLAG }; +static int sctp4_rcv (struct sk_buff *skb) +{ +memset (skb->cb,0 ,sizeof (skb->cb)); +return sctp_rcv (skb); +} +/* Register with IP layer. */ static const struct net_protocol sctp_protocol = { - .handler = sctp_rcv, + .handler = sctp4_rcv, .err_handler = sctp_v4_err, .no_policy =1 , .netns_ok =1 ,
net/sctp/sm_make_chunk.c +1 -0
@@ -2321,6 +2321,7 @@ int sctp_process_init(struct sctp_association *asoc, struct sctp_chunk *chunk,* added as the primary transport. The source address seems to * be a better choice than any of the embedded addresses. */ + asoc->encap_port =SCTP_INPUT_CB (chunk->skb)->encap_port;if (!sctp_assoc_add_peer (asoc, peer_addr, gfp,SCTP_ACTIVE )) goto nomem;
net/sctp/sm_statefuns.c +2 -0
@@ -6268,6 +6268,8 @@ static struct sctp_packet *sctp_ootb_pkt_new(if (!transport) goto nomem; + transport->encap_port =SCTP_INPUT_CB (chunk->skb)->encap_port; +/* Cache a route for the transport with the chunk's destination as * the source address. */
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 10/16 sctp: add udphdr to overhead when udp_port is set
sctp_mtu_payload() is for calculating the frag size before making chunks from a msg. So we should only add udphdr size to overhead when udp socks are listening, as only then sctp can handle the incoming sctp over udp packets and outgoing sctp over udp packets will be possible.
Note that we can't do this according to transport->encap_port, as different transports may be set to different values, while the chunks were made before choosing the transport, we could not be able to meet all rfc6951#section-5.6 recommends.
v1->v2:
- Add udp_port for sctp_sock to avoid a potential race issue, it will be used in xmit path in the next patch.
--- include/net/sctp/sctp.h | 7 +++++-- include/net/sctp/structs.h | 1 + net/sctp/socket.c | 1 + 3 files changed, 7 insertions(+), 2 deletions(-)
include/net/sctp/sctp.h +5 -2
@@ -578,10 +578,13 @@ static inline __u32 sctp_mtu_payload(const struct sctp_sock *sp, {__u32 overhead =sizeof (struct sctphdr ) + extra; -if (sp) +if (sp) { overhead += sp->pf->af->net_header_len; -else +if (sp->udp_port) + overhead +=sizeof (struct udphdr ); + }else { overhead +=sizeof (struct ipv6hdr ); + }if (WARN_ON_ONCE (mtu && mtu <= overhead)) mtu = overhead;
include/net/sctp/structs.h +1 -0
@@ -178,6 +178,7 @@ struct sctp_sock {*/ __u32 hbinterval; +__be16 udp_port;__be16 encap_port;/* This is the max_retrans value for new associations. */
net/sctp/socket.c +1 -0
@@ -4928,6 +4928,7 @@ static int sctp_init_sock(struct sock *sk)* be modified via SCTP_PEER_ADDR_PARAMS */ sp->hbinterval = net->sctp.hb_interval; + sp->udp_port =htons (net->sctp.udp_port); sp->encap_port =htons (net->sctp.encap_port); sp->pathmaxrxt = net->sctp.max_retrans_path; sp->pf_retrans = net->sctp.pf_retrans;
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 11/16 sctp: call sk_setup_caps in sctp_packet_transmit instead
sk_setup_caps() was originally called in Commit 90017accff61 ("sctp:
Add GSO support"), as:
"We have to refresh this in case we are xmiting to more than one
transport at a time"
This actually happens in the loop of sctp_outq_flush_transports(), and it shouldn't be tied to gso, so move it out of gso part and before sctp_packet_pack().
--- net/sctp/output.c | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-)
net/sctp/output.c +7 -6
@@ -508,12 +508,6 @@ static int sctp_packet_pack(struct sctp_packet *packet, sizeof(struct inet6_skb_parm)));skb_shinfo (head)->gso_segs = pkt_count;skb_shinfo (head)->gso_size =GSO_BY_FRAGS ; -rcu_read_lock (); -if (skb_dst (head) != tp->dst) { -dst_hold (tp->dst); -sk_setup_caps (sk, tp->dst); - } -rcu_read_unlock (); goto chksum; }
@@ -593,6 +587,13 @@ int sctp_packet_transmit(struct sctp_packet *packet, gfp_t gfp) }skb_dst_set (head, dst); +rcu_read_lock (); +if (__sk_dst_get (sk) != tp->dst) { +dst_hold (tp->dst); +sk_setup_caps (sk, tp->dst); + } +rcu_read_unlock (); +/* pack up chunks */ pkt_count =sctp_packet_pack (packet, head, gso, gfp);if (!pkt_count) {
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 12/16 sctp: support for sending packet over udp4 sock
This patch does what the rfc6951#section-5.3 says for ipv4:
"Within the UDP header, the source port MUST be the local UDP
encapsulation port number of the SCTP stack, and the destination port MUST be the remote UDP encapsulation port number maintained for the association and the destination address to which the packet is sent (see Section 5.1).
Because the SCTP packet is the UDP payload, the length of the UDP packet MUST be the length of the SCTP packet plus the size of the UDP header.
The SCTP checksum MUST be computed for IPv4 and IPv6, and the UDP checksum SHOULD be computed for IPv4 and IPv6."
Some places need to be adjusted in sctp_packet_transmit():
1. For non-gso packets, when transport's encap_port is set, sctp checksum has to be done in sctp_packet_pack(), as the outer udp will use ip_summed = CHECKSUM_PARTIAL to do the offload setting for checksum.
2. Delay calling dst_clone() and skb_dst_set() for non-udp packets until sctp_v4_xmit(), as for udp packets, skb_dst_set() is not needed before calling udp_tunnel_xmit_skb().
then in sctp_v4_xmit():
1. Go to udp_tunnel_xmit_skb() only when transport->encap_port and net->sctp.udp_port both are set, as these are one for dst port and another for src port.
2. For gso packet, SKB_GSO_UDP_TUNNEL_CSUM is set for gso_type, and with this udp checksum can be done in __skb_udp_tunnel_segment() for each segments after the sctp gso.
3. inner_mac_header and inner_transport_header are set, as these will be needed in __skb_udp_tunnel_segment() to find the right headers.
4. df and ttl are calculated, as these are the required params by
udp_tunnel_xmit_skb().
5. nocheck param has to be false, as "the UDP checksum SHOULD be computed for IPv4 and IPv6", says in rfc6951#section-5.3.
v1->v2:
- Use sp->udp_port instead in sctp_v4_xmit(), which is more safe.
--- net/sctp/output.c | 9 +++------ net/sctp/protocol.c | 41 ++++++++++++++++++++++++++++++----------- 2 files changed, 33 insertions(+), 17 deletions(-)
net/sctp/output.c +3 -6
@@ -514,8 +514,8 @@ static int sctp_packet_pack(struct sctp_packet *packet,if (sctp_checksum_disable)return 1 ; -if (!(skb_dst (head)->dev->features &NETIF_F_SCTP_CRC ) || -dst_xfrm (skb_dst (head)) || packet->ipfragok) { +if (!(tp->dst->dev->features &NETIF_F_SCTP_CRC ) || +dst_xfrm (tp->dst) || packet->ipfragok || tp->encap_port) {struct sctphdr *sh (struct sctphdr *)skb_transport_header (head);
@@ -542,7 +542,6 @@ int sctp_packet_transmit(struct sctp_packet *packet, gfp_t gfp)struct sctp_association *asoc = tp->asoc;struct sctp_chunk *chunk, *tmp;int pkt_count, gso =0 ; -struct dst_entry *dst;struct sk_buff *head;struct sctphdr *sh;struct sock *sk;
@@ -579,13 +578,11 @@ int sctp_packet_transmit(struct sctp_packet *packet, gfp_t gfp) sh->checksum =0 ;/* drop packet if no dst */ - dst =dst_clone (tp->dst); -if (!dst) { +if (!tp->dst) {IP_INC_STATS (sock_net (sk),IPSTATS_MIB_OUTNOROUTES );kfree_skb (head); goto out; } -skb_dst_set (head, dst);rcu_read_lock ();if (__sk_dst_get (sk) != tp->dst) {
net/sctp/protocol.c +30 -11
55 lines not on this page · raw message
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 13/16 sctp: support for sending packet over udp6 sock
This one basically does the similar things in sctp_v6_xmit as does for udp4 sock in the last patch, just note that:
1. label needs to be calculated, as it's the param of
udp_tunnel6_xmit_skb().
2. The 'nocheck' param of udp_tunnel6_xmit_skb() is false, as required by RFC.
v1->v2:
- Use sp->udp_port instead in sctp_v6_xmit(), which is more safe.
--- net/sctp/ipv6.c | 43 ++++++++++++++++++++++++++++++++----------- 1 file changed, 32 insertions(+), 11 deletions(-)
net/sctp/ipv6.c +32 -11
@@ -55,6 +55,7 @@#include <net/inet_common.h> #include <net/inet_ecn.h> #include <net/sctp/sctp.h> +#include <net/udp_tunnel.h> #include <linux/uaccess.h>
@@ -191,33 +192,53 @@ static int sctp_v6_err(struct sk_buff *skb, struct inet6_skb_parm *opt,return ret; } -static int sctp_v6_xmit (struct sk_buff *skb,struct sctp_transport *transport) +static int sctp_v6_xmit (struct sk_buff *skb,struct sctp_transport *t) { +struct dst_entry *dst =dst_clone (t->dst); +struct flowi6 *fl6 = &t->fl.u.ip6;struct sock *sk = skb->sk;struct ipv6_pinfo *np =inet6_sk (sk); -struct flowi6 *fl6 = &transport->fl.u.ip6;__u8 tclass = np->tclass; -int res; +__be32 label;pr_debug ("%s: skb:%p, len:%d, src:%pI6 dst:%pI6\n" , __func__, skb, skb->len, &fl6->saddr, &fl6->daddr); -if (transport->dscp &SCTP_DSCP_SET_MASK ) - tclass = transport->dscp &SCTP_DSCP_VAL_MASK ; +if (t->dscp &SCTP_DSCP_SET_MASK ) + tclass = t->dscp &SCTP_DSCP_VAL_MASK ;if (INET_ECN_is_capable (tclass))IP6_ECN_flow_xmit (sk, fl6->flowlabel); -if (!(transport->param_flags &SPP_PMTUD_ENABLE )) +if (!(t->param_flags &SPP_PMTUD_ENABLE )) skb->ignore_df =1 ;SCTP_INC_STATS (sock_net (sk),SCTP_MIB_OUTSCTPPACKS ); -rcu_read_lock (); - res =ip6_xmit (sk, skb, fl6, sk->sk_mark,rcu_dereference (np->opt), - tclass, sk->sk_priority); -rcu_read_unlock (); -return res; +if (!t->encap_port || !sctp_sk (sk)->udp_port) { +int res; + +skb_dst_set (skb, dst); +rcu_read_lock (); + res =ip6_xmit (sk, skb, fl6, sk->sk_mark, +rcu_dereference (np->opt), + tclass, sk->sk_priority); +rcu_read_unlock (); +return res; + } + +if (skb_is_gso (skb)) +skb_shinfo (skb)->gso_type |=SKB_GSO_UDP_TUNNEL_CSUM ; + + skb->encapsulation =1 ; +skb_reset_inner_mac_header (skb); +skb_reset_inner_transport_header (skb); +skb_set_inner_ipproto (skb,IPPROTO_SCTP ); + label =ip6_make_flowlabel (sock_net (sk), skb, fl6->flowlabel, true, fl6); + +return udp_tunnel6_xmit_skb (dst, sk, skb,NULL , &fl6->saddr, + &fl6->daddr, tclass,ip6_dst_hoplimit (dst), + label,sctp_sk (sk)->udp_port, t->encap_port, false); }/* Returns the dst cache entry for the given source and destination ip
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 14/16 sctp: add the error cause for new encapsulation port restart
This patch is to add the function to make the abort chunk with the error cause for new encapsulation port restart, defined on Section 4.4 in draft-tuexen-tsvwg-sctp-udp-encaps-cons-03.
v1->v2:
- no change.v2->v3:
- no need to call htons() when setting nep.cur_port/new_port.
--- include/linux/sctp.h | 20 ++++++++++++++++++++ include/net/sctp/sm.h | 3 +++ net/sctp/sm_make_chunk.c | 20 ++++++++++++++++++++ 3 files changed, 43 insertions(+)
include/linux/sctp.h +20 -0
@@ -482,11 +482,13 @@ enum sctp_error {* 11 Restart of an association with new addresses * 12 User Initiated Abort * 13 Protocol Violation +* 14 Restart of an Association with New Encapsulation Port */ SCTP_ERROR_RESTART =cpu_to_be16 (0x0b ),SCTP_ERROR_USER_ABORT =cpu_to_be16 (0x0c ),SCTP_ERROR_PROTO_VIOLATION =cpu_to_be16 (0x0d ), + SCTP_ERROR_NEW_ENCAP_PORT = cpu_to_be16(0x0e),/* ADDIP Section 3.3 New Error Causes *
@@ -793,4 +795,22 @@ enum {SCTP_FLOWLABEL_VAL_MASK =0xfffff }; +/* UDP Encapsulation +* draft-tuexen-tsvwg-sctp-udp-encaps-cons-03.html#section-4-4 +* +* The error cause indicating an "Restart of an Association with +* New Encapsulation Port" +* +* 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 2 3 4 5 6 7 8 9 0 1 +* +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +* | Cause Code = 14 | Cause Length = 8 | +* +-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+-+ +* | Current Encapsulation Port | New Encapsulation Port | +* +-------------------------------+-------------------------------+ +*/ +struct sctp_new_encap_port_hdr { +__be16 cur_port; +__be16 new_port; +}; +#endif /* __LINUX_SCTP_H__ */
include/net/sctp/sm.h +3 -0
@@ -221,6 +221,9 @@ struct sctp_chunk *sctp_make_violation_paramlen(struct sctp_chunk *sctp_make_violation_max_retrans (const struct sctp_association *asoc,const struct sctp_chunk *chunk); +struct sctp_chunk *sctp_make_new_encap_port ( +const struct sctp_association *asoc, +const struct sctp_chunk *chunk);struct sctp_chunk *sctp_make_heartbeat (const struct sctp_association *asoc,const struct sctp_transport *transport); struct sctp_chunk *sctp_make_heartbeat_ack(const struct sctp_association *asoc,
net/sctp/sm_make_chunk.c +20 -0
@@ -1142,6 +1142,26 @@ struct sctp_chunk *sctp_make_violation_max_retrans(return retval; } +struct sctp_chunk *sctp_make_new_encap_port (const struct sctp_association *asoc, +const struct sctp_chunk *chunk) +{ +struct sctp_new_encap_port_hdr nep; +struct sctp_chunk *retval; + + retval =sctp_make_abort (asoc, chunk, +sizeof (struct sctp_errhdr ) +sizeof (nep)); +if (!retval) + goto nodata; + +sctp_init_cause (retval,SCTP_ERROR_NEW_ENCAP_PORT ,sizeof (nep)); + nep.cur_port =SCTP_INPUT_CB (chunk->skb)->encap_port; + nep.new_port = chunk->transport->encap_port; +sctp_addto_chunk (retval,sizeof (nep), &nep); + +nodata: +return retval; +} +/* Make a HEARTBEAT chunk. */ struct sctp_chunk *sctp_make_heartbeat (const struct sctp_association *asoc,const struct sctp_transport *transport)
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 15/16 sctp: handle the init chunk matching an existing asoc
This is from Section 4 of draft-tuexen-tsvwg-sctp-udp-encaps-cons-03, and it requires responding with an abort chunk with an error cause when the udp source port of the received init chunk doesn't match the encap port of the transport.
--- net/sctp/sm_statefuns.c | 50 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+)
net/sctp/sm_statefuns.c +50 -0
@@ -87,6 +87,13 @@ static enum sctp_disposition sctp_sf_tabort_8_4_8(const union sctp_subtype type, void *arg, struct sctp_cmd_seq *commands); +static enum sctp_disposition sctp_sf_new_encap_port ( +struct net *net, +const struct sctp_endpoint *ep, +const struct sctp_association *asoc, +const union sctp_subtype type, +void *arg, +struct sctp_cmd_seq *commands);static struct sctp_sackhdr *sctp_sm_pull_sack (struct sctp_chunk *chunk); static enum sctp_disposition sctp_stop_t1_and_abort(
@@ -1493,6 +1500,10 @@ static enum sctp_disposition sctp_sf_do_unexpected_init(if (!sctp_chunk_length_valid (chunk,sizeof (struct sctp_init_chunk )))return sctp_sf_violation_chunklen (net, ep, asoc, type, arg, commands); + +if (SCTP_INPUT_CB (chunk->skb)->encap_port != chunk->transport->encap_port) +return sctp_sf_new_encap_port (net, ep, asoc, type, arg, commands); +/* Grab the INIT header. */ chunk->subh.init_hdr = (struct sctp_inithdr *)chunk->skb->data;
@@ -3392,6 +3403,45 @@ static enum sctp_disposition sctp_sf_tabort_8_4_8(sctp_packet_append_chunk (packet, abort); +sctp_add_cmd_sf (commands,SCTP_CMD_SEND_PKT ,SCTP_PACKET (packet)); + +SCTP_INC_STATS (net,SCTP_MIB_OUTCTRLCHUNKS ); + +sctp_sf_pdiscard (net, ep, asoc, type, arg, commands); +return SCTP_DISPOSITION_CONSUME ; +} + +/* Handling of SCTP Packets Containing an INIT Chunk Matching an +* Existing Associations when the UDP encap port is incorrect. +* +* From Section 4 at draft-tuexen-tsvwg-sctp-udp-encaps-cons-03. +*/ +static enum sctp_disposition sctp_sf_new_encap_port ( +struct net *net, +const struct sctp_endpoint *ep, +const struct sctp_association *asoc, +const union sctp_subtype type, +void *arg, +struct sctp_cmd_seq *commands) +{ +struct sctp_packet *packet =NULL ; +struct sctp_chunk *chunk = arg; +struct sctp_chunk *abort; + + packet =sctp_ootb_pkt_new (net, asoc, chunk); +if (!packet) +return SCTP_DISPOSITION_NOMEM ; + + abort =sctp_make_new_encap_port (asoc, chunk); +if (!abort) { +sctp_ootb_pkt_free (packet); +return SCTP_DISPOSITION_NOMEM ; + } + + abort->skb->sk = ep->base.sk; + +sctp_packet_append_chunk (packet, abort); +sctp_add_cmd_sf (commands,SCTP_CMD_SEND_PKT ,SCTP_PACKET (packet));
Signature · 1 line
2.1.0
Xin Long
maintainerPATCH v4 16/16 sctp: enable udp tunneling socks
This patch is to enable udp tunneling socks by calling sctp_udp_sock_start() in sctp_ctrlsock_init(), and sctp_udp_sock_stop() in sctp_ctrlsock_exit().
Also add sysctl udp_port to allow changing the listening sock's port by users.
Wit this patch, the whole sctp over udp feature can be enabled and used.
v1->v2:
- Also update ctl_sock udp_port in proc_sctp_do_udp_port() where netns udp_port gets changed.v2->v3:
- Call htons() when setting sk udp_port from netns udp_port.v3->v4:
- Not call sctp_udp_sock_start() when new_value is 0.
- Add udp_port entry in ip-sysctl.rst.
--- Documentation/networking/ip-sysctl.rst | 6 ++++ net/sctp/protocol.c | 5 ++++ net/sctp/sysctl.c | 52 ++++++++++++++++++++++++++++++++++ 3 files changed, 63 insertions(+)
Documentation/networking/ip-sysctl.rst +6 -0
@@ -2640,6 +2640,12 @@ addr_scope_policy - INTEGER Default: 1 +udp_port - INTEGER + The listening port for the local UDP tunneling sock. + UDP encapsulation will be disabled when it's set to 0. + + Default: 9899 + encap_port - INTEGER The default remote UDP encapsalution port. When UDP tunneling is enabled, this global value is used to set
net/sctp/protocol.c +5 -0
@@ -1469,6 +1469,10 @@ static int __net_init sctp_ctrlsock_init(struct net *net)if (status)pr_err ("Failed to initialize the SCTP control sock\n" ); + status =sctp_udp_sock_start (net); +if (status) +pr_err ("Failed to initialize the SCTP UDP tunneling sock\n" ); +return status; }
@@ -1476,6 +1480,7 @@ static void __net_exit sctp_ctrlsock_exit(struct net *net) {/* Free the control endpoint. */ inet_ctl_sock_destroy (net->sctp.ctl_sock); +sctp_udp_sock_stop (net); }static struct pernet_operations sctp_ctrlsock_ops = {
net/sctp/sysctl.c +52 -0
70 lines not on this page · raw message
Signature · 1 line
2.1.0
Marcelo Ricardo Leitner
maintainerRe: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2643
Quoted 7 lines · Xin Long
Documentation/networking/ip-sysctl.rst +1
-0@@ -2640,6 +2640,12 @@ addr_scope_policy - INTEGER Default: 1 +udp_port - INTEGER
Need to be more verbose here, and also mention the RFC.
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2644
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ The listening port for the local UDP tunneling sock.
, shared by all applications in the same net namespace.
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2645
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ UDP encapsulation will be disabled when it's set to 0.
"Note, however, that setting just this is not enough to actually use it. ..."
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2651
Quoted 6 lines
Documentation/networking/ip-sysctl.rst +3
-0+ + Default: 9899 + encap_port - INTEGER The default remote UDP encapsalution port. When UDP tunneling is enabled, this global value is used to set
When is it enabled, which conditions are needed? Maybe it can be explained only in the one above.
Marcelo Ricardo Leitner
maintainerRe: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
Ah, please note that net-next is closed.
https://lore.kernel.org/netdev/20201015123116.743005ca%40kicinski-fedora-pc1c0hjn.dhcp.thefacebook.com/T/
Marcelo
Xin Long
maintainerRe: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
In reply to Marcelo Ricardo LeitnerQuoted 12 lines · Marcelo Ricardo Leitner
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2643
Quoted 7 lines · Xin Long
Documentation/networking/ip-sysctl.rst +1
-0@@ -2640,6 +2640,12 @@ addr_scope_policy - INTEGER Default: 1 +udp_port - INTEGERNeed to be more verbose here, and also mention the RFC.
Quoted 6 lines
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2644
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ The listening port for the local UDP tunneling sock., shared by all applications in the same net namespace.
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2645
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ UDP encapsulation will be disabled when it's set to 0."Note, however, that setting just this is not enough to actually use it. ..."
When it's a client, yes, but when it's a server, the encap_port can be got from the incoming packet.
Quoted 10 lines
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2651
Quoted 7 lines
Documentation/networking/ip-sysctl.rst +3
-0+ + Default: 9899 + encap_port - INTEGER The default remote UDP encapsalution port. When UDP tunneling is enabled, this global value is used to setWhen is it enabled, which conditions are needed? Maybe it can be explained only in the one above.
Thanks!
pls check if this one will be better:
udp_port - INTEGER
The listening port for the local UDP tunneling sock.
This UDP sock is used for processing the incoming UDP-encapsulated SCTP packets (from RFC6951), and shared by all applications in the same net namespace. This UDP sock will be closed when the value is set to 0.
The value will also be used to set the src port of the UDP header for the outgoing UDP-encapsulated SCTP packets. For the dest port, please refer to 'encap_port' below.
Default: 9899
encap_port - INTEGER
The default remote UDP encapsulation port.
This value is used to set the dest port of the UDP header for the outgoing UDP-encapsulated SCTP packets by default. Users can also change the value for each sock/asoc/transport by using setsockopt. For further information, please refer to RFC6951.
Note that when connecting to a remote server, the client should set this to the port that the UDP tunneling sock on the peer server is listening to and the local UDP tunneling sock on the client also must be started. On the server, it would get the encap_port from the incoming packet's source port.
Default: 0
Marcelo Ricardo Leitner
maintainerRe: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
Quoted 33 lines · Xin Long
Quoted 12 lines · Marcelo Ricardo Leitner
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2643
Quoted 7 lines · Xin Long
Documentation/networking/ip-sysctl.rst +1
-0@@ -2640,6 +2640,12 @@ addr_scope_policy - INTEGER Default: 1 +udp_port - INTEGERNeed to be more verbose here, and also mention the RFC.
Quoted 6 lines
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2644
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ The listening port for the local UDP tunneling sock., shared by all applications in the same net namespace.
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2645
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ UDP encapsulation will be disabled when it's set to 0."Note, however, that setting just this is not enough to actually use it. ..."
When it's a client, yes, but when it's a server, the
encap_portcan be got from the incoming packet.Quoted 10 lines
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2651
Quoted 7 lines
Documentation/networking/ip-sysctl.rst +3
-0+ + Default: 9899 + encap_port - INTEGER The default remote UDP encapsalution port. When UDP tunneling is enabled, this global value is used to setWhen is it enabled, which conditions are needed? Maybe it can be explained only in the one above.
Quoted 2 lines
Thanks!
pls check if this one will be better:
It is. Verbose enough now, thx.
(one other comment below)
Quoted 10 lines
udp_port- INTEGERThe listening port for the local UDP tunneling sock.
This UDP sock is used for processing the incoming UDP-encapsulated SCTP packets (from RFC6951), and shared by all applications in the same net namespace. This UDP sock will be closed when the value is set to 0.
Quoted 5 lines
The value will also be used to set the src port of the UDP header for the outgoing UDP-encapsulated SCTP packets. For the dest port, please refer to '
encap_port' below.Default: 9899
I'm now wondering if this is the right default. I mean, it is the standard port for it, yes, but at the same time, it means loading SCTP module will steal/use that UDP port on all net namespaces and can lead to conflicts with other apps. A more conservative approach here is to document the standard port, but set the default to 0 and require the user to set it in if it is expected to be used.
Did FreeBSD enable it by default too?
Re: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
Quoted 58 lines · Marcelo Ricardo Leitner
Quoted 33 lines · Xin Long
Quoted 12 lines · Marcelo Ricardo Leitner
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2643
Quoted 7 lines · Xin Long
Documentation/networking/ip-sysctl.rst +1
-0@@ -2640,6 +2640,12 @@ addr_scope_policy - INTEGER Default: 1 +udp_port - INTEGERNeed to be more verbose here, and also mention the RFC.
Quoted 6 lines
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2644
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ The listening port for the local UDP tunneling sock., shared by all applications in the same net namespace.
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2645
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ UDP encapsulation will be disabled when it's set to 0."Note, however, that setting just this is not enough to actually use it. ..."
When it's a client, yes, but when it's a server, the
encap_portcan be got from the incoming packet.Quoted 10 lines
Quoted 7 lines
Documentation/networking/ip-sysctl.rst +3
-0+ + Default: 9899 +
encap_port- INTEGER
The default remote UDP encapsalution port.
When UDP tunneling is enabled, this global value is used to setWhen is it enabled, which conditions are needed? Maybe it can be explained only in the one above.
Quoted 2 lines
Thanks!
pls check if this one will be better:It is. Verbose enough now, thx.
(one other comment below)Quoted 10 lines
udp_port- INTEGERThe listening port for the local UDP tunneling sock.
This UDP sock is used for processing the incoming UDP-encapsulated SCTP packets (from RFC6951), and shared by all applications in the same net namespace. This UDP sock will be closed when the value is set to 0.
Quoted 5 lines
The value will also be used to set the src port of the UDP header for the outgoing UDP-encapsulated SCTP packets. For the dest port, please refer to '
encap_port' below.Default: 9899
Quoted 8 lines
I'm now wondering if this is the right default. I mean, it is the standard port for it, yes, but at the same time, it means loading SCTP module will steal/use that UDP port on all net namespaces and can lead to conflicts with other apps. A more conservative approach here is to document the standard port, but set the default to 0 and require the user to set it in if it is expected to be used.
Did FreeBSD enable it by default too?
No. The default is 0, which means that the encapsulation is turned off. Setting this sysctl variable to a non-zero value enables the UDP tunneling with the given port.
Best regards
Michael
Marcelo Ricardo Leitner
maintainerRe: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
Quoted 65 lines · Michael Tuexen
Quoted 65 lines · Marcelo Ricardo Leitner
Quoted 33 lines · Xin Long
Quoted 12 lines · Marcelo Ricardo Leitner
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2643
Quoted 7 lines · Xin Long
Documentation/networking/ip-sysctl.rst +1
-0@@ -2640,6 +2640,12 @@ addr_scope_policy - INTEGER Default: 1 +udp_port - INTEGERNeed to be more verbose here, and also mention the RFC.
Quoted 6 lines
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2644
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ The listening port for the local UDP tunneling sock., shared by all applications in the same net namespace.
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2645
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ UDP encapsulation will be disabled when it's set to 0."Note, however, that setting just this is not enough to actually use it. ..."
When it's a client, yes, but when it's a server, the
encap_portcan be got from the incoming packet.Quoted 10 lines
Quoted 7 lines
Documentation/networking/ip-sysctl.rst +3
-0+ + Default: 9899 +
encap_port- INTEGER
The default remote UDP encapsalution port.
When UDP tunneling is enabled, this global value is used to setWhen is it enabled, which conditions are needed? Maybe it can be explained only in the one above.
Quoted 2 lines
Thanks!
pls check if this one will be better:It is. Verbose enough now, thx.
(one other comment below)Quoted 10 lines
udp_port- INTEGERThe listening port for the local UDP tunneling sock.
This UDP sock is used for processing the incoming UDP-encapsulated SCTP packets (from RFC6951), and shared by all applications in the same net namespace. This UDP sock will be closed when the value is set to 0.
Quoted 5 lines
The value will also be used to set the src port of the UDP header for the outgoing UDP-encapsulated SCTP packets. For the dest port, please refer to '
encap_port' below.Default: 9899
I'm now wondering if this is the right default. I mean, it is the standard port for it, yes, but at the same time, it means loading SCTP module will steal/use that UDP port on all net namespaces and can lead to conflicts with other apps. A more conservative approach here is to document the standard port, but set the default to 0 and require the user to set it in if it is expected to be used.
Quoted 4 lines
Quoted 1 line
Did FreeBSD enable it by default too?
No. The default is 0, which means that the encapsulation is turned off. Setting this sysctl variable to a non-zero value enables the UDP tunneling with the given port.
Thanks Michael.
Xin, then we should change this default value (and update the documentation above accordingly, to still have the standard port # readily available in there).
Cheers,
Marcelo
RE: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
From: Marcelo Ricardo Leitner
Quoted 1 line
Sent: 20 October 2020 22:24
...
Quoted 9 lines
Quoted 4 lines
Quoted 1 line
Did FreeBSD enable it by default too?
No. The default is 0, which means that the encapsulation is turned off. Setting this sysctl variable to a non-zero value enables the UDP tunneling with the given port.
Thanks Michael.
Xin, then we should change this default value (and update the documentation above accordingly, to still have the standard port # readily available in there).
Does that mean that you can't have some 'normal' connections and others that use UDP encapsulation?
Seems a pretty strong restriction.
(I'm waiting for one of our customers to ask for this...)
David
-
Registered Address Lakeside, Bramley Road, Mount Farm, Milton Keynes, MK1 1PT, UK Registration No: 1397386 (Wales)
'Marcelo Ricardo Leitner'
maintainerRe: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
Quoted 8 lines · David Laight
From: Marcelo Ricardo Leitner
Quoted 1 line
Sent: 20 October 2020 22:24
...
Quoted 5 lines
Quoted 4 lines
Quoted 1 line
Did FreeBSD enable it by default too?
No. The default is 0, which means that the encapsulation is turned off. Setting this sysctl variable to a non-zero value enables the UDP tunneling with the given port.
Quoted 8 lines
Quoted 4 lines
Thanks Michael.
Xin, then we should change this default value (and update the documentation above accordingly, to still have the standard port # readily available in there).Does that mean that you can't have some 'normal' connections and others that use UDP encapsulation?
Seems a pretty strong restriction.
That's not what was said. Just that the socket shouldn't be created by default.
Quoted 2 lines
(I'm waiting for one of our customers to ask for this...)
It can. The setting in question is for receiving encapsulated packets, and which doesn't exclude the standard one. It can still receive normal/non-encapsulated packets.
Xin Long
maintainerRe: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
In reply to Marcelo Ricardo LeitnerQuoted 68 lines · Marcelo Ricardo Leitner
Quoted 66 lines · Michael Tuexen
Quoted 66 lines · Marcelo Ricardo Leitner
Quoted 33 lines · Xin Long
Quoted 12 lines · Marcelo Ricardo Leitner
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2643
Quoted 7 lines · Xin Long
Documentation/networking/ip-sysctl.rst +1
-0@@ -2640,6 +2640,12 @@ addr_scope_policy - INTEGER Default: 1 +udp_port - INTEGERNeed to be more verbose here, and also mention the RFC.
Quoted 6 lines
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2644
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ The listening port for the local UDP tunneling sock., shared by all applications in the same net namespace.
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2645
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ UDP encapsulation will be disabled when it's set to 0."Note, however, that setting just this is not enough to actually use it. ..."
When it's a client, yes, but when it's a server, the
encap_portcan be got from the incoming packet.Quoted 10 lines
Quoted 7 lines
Documentation/networking/ip-sysctl.rst +3
-0+ + Default: 9899 +
encap_port- INTEGER
The default remote UDP encapsalution port.
When UDP tunneling is enabled, this global value is used to setWhen is it enabled, which conditions are needed? Maybe it can be explained only in the one above.
Quoted 2 lines
Thanks!
pls check if this one will be better:It is. Verbose enough now, thx.
(one other comment below)Quoted 10 lines
udp_port- INTEGERThe listening port for the local UDP tunneling sock.
This UDP sock is used for processing the incoming UDP-encapsulated SCTP packets (from RFC6951), and shared by all applications in the same net namespace. This UDP sock will be closed when the value is set to 0.
Quoted 5 lines
The value will also be used to set the src port of the UDP header for the outgoing UDP-encapsulated SCTP packets. For the dest port, please refer to '
encap_port' below.Default: 9899
I'm now wondering if this is the right default. I mean, it is the standard port for it, yes, but at the same time, it means loading SCTP module will steal/use that UDP port on all net namespaces and can lead to conflicts with other apps. A more conservative approach here is to document the standard port, but set the default to 0 and require the user to set it in if it is expected to be used.
Did FreeBSD enable it by default too?
Quoted 8 lines
Quoted 3 lines
No. The default is 0, which means that the encapsulation is turned off. Setting this sysctl variable to a non-zero value enables the UDP tunneling with the given port.
Thanks Michael.
Xin, then we should change this default value (and update the documentation above accordingly, to still have the standard port # readily available in there).
OK, I misunderstood the RFC.
I will remove the call to sctp_udp_sock_start/stop() from sctp_ctrlsock_init/exit(), and set the udp_port as 0 by default.
Thanks.
Re: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
Quoted 76 lines · Xin Long
Quoted 72 lines · Marcelo Ricardo Leitner
Quoted 69 lines · Michael Tuexen
Quoted 58 lines · Marcelo Ricardo Leitner
Quoted 33 lines · Xin Long
Quoted 12 lines · Marcelo Ricardo Leitner
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2643
Quoted 7 lines · Xin Long
Documentation/networking/ip-sysctl.rst +1
-0@@ -2640,6 +2640,12 @@ addr_scope_policy - INTEGER Default: 1 +udp_port - INTEGERNeed to be more verbose here, and also mention the RFC.
Quoted 6 lines
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2644
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ The listening port for the local UDP tunneling sock., shared by all applications in the same net namespace.
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2645
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ UDP encapsulation will be disabled when it's set to 0."Note, however, that setting just this is not enough to actually use it. ..."
When it's a client, yes, but when it's a server, the
encap_portcan be got from the incoming packet.Quoted 10 lines
Quoted 7 lines
Documentation/networking/ip-sysctl.rst +3
-0+ + Default: 9899 +
encap_port- INTEGER
The default remote UDP encapsalution port.
When UDP tunneling is enabled, this global value is used to setWhen is it enabled, which conditions are needed? Maybe it can be explained only in the one above.
Quoted 2 lines
Thanks!
pls check if this one will be better:It is. Verbose enough now, thx.
(one other comment below)Quoted 10 lines
udp_port- INTEGERThe listening port for the local UDP tunneling sock.
This UDP sock is used for processing the incoming UDP-encapsulated SCTP packets (from RFC6951), and shared by all applications in the same net namespace. This UDP sock will be closed when the value is set to 0.
Quoted 5 lines
The value will also be used to set the src port of the UDP header for the outgoing UDP-encapsulated SCTP packets. For the dest port, please refer to '
encap_port' below.Default: 9899
Quoted 8 lines
I'm now wondering if this is the right default. I mean, it is the standard port for it, yes, but at the same time, it means loading SCTP module will steal/use that UDP port on all net namespaces and can lead to conflicts with other apps. A more conservative approach here is to document the standard port, but set the default to 0 and require the user to set it in if it is expected to be used.
Did FreeBSD enable it by default too?
No. The default is 0, which means that the encapsulation is turned off. Setting this sysctl variable to a non-zero value enables the UDP tunneling with the given port.
Quoted 5 lines
Quoted 4 lines
Thanks Michael.
Xin, then we should change this default value (and update the documentation above accordingly, to still have the standard port # readily available in there).OK, I misunderstood the RFC.
Does that RFC mandate that the feature is on by default? Can you point me to that text?
Best regards
Michael
Quoted 5 lines
I will remove the call to sctp_udp_sock_start/stop() from sctp_ctrlsock_init/exit(), and set the
udp_portas 0 by default.Thanks.
Xin Long
maintainerRe: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
Quoted 77 lines · Michael Tuexen
Quoted 77 lines · Xin Long
Quoted 72 lines · Marcelo Ricardo Leitner
Quoted 69 lines · Michael Tuexen
Quoted 58 lines · Marcelo Ricardo Leitner
Quoted 33 lines · Xin Long
Quoted 12 lines · Marcelo Ricardo Leitner
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2643
Quoted 7 lines · Xin Long
Documentation/networking/ip-sysctl.rst +1
-0@@ -2640,6 +2640,12 @@ addr_scope_policy - INTEGER Default: 1 +udp_port - INTEGERNeed to be more verbose here, and also mention the RFC.
Quoted 6 lines
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2644
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ The listening port for the local UDP tunneling sock., shared by all applications in the same net namespace.
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2645
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ UDP encapsulation will be disabled when it's set to 0."Note, however, that setting just this is not enough to actually use it. ..."
When it's a client, yes, but when it's a server, the
encap_portcan be got from the incoming packet.Quoted 10 lines
Quoted 7 lines
Documentation/networking/ip-sysctl.rst +3
-0+ + Default: 9899 +
encap_port- INTEGER
The default remote UDP encapsalution port.
When UDP tunneling is enabled, this global value is used to setWhen is it enabled, which conditions are needed? Maybe it can be explained only in the one above.
Quoted 2 lines
Thanks!
pls check if this one will be better:It is. Verbose enough now, thx.
(one other comment below)Quoted 10 lines
udp_port- INTEGERThe listening port for the local UDP tunneling sock.
This UDP sock is used for processing the incoming UDP-encapsulated SCTP packets (from RFC6951), and shared by all applications in the same net namespace. This UDP sock will be closed when the value is set to 0.
Quoted 5 lines
The value will also be used to set the src port of the UDP header for the outgoing UDP-encapsulated SCTP packets. For the dest port, please refer to '
encap_port' below.Default: 9899
Quoted 8 lines
I'm now wondering if this is the right default. I mean, it is the standard port for it, yes, but at the same time, it means loading SCTP module will steal/use that UDP port on all net namespaces and can lead to conflicts with other apps. A more conservative approach here is to document the standard port, but set the default to 0 and require the user to set it in if it is expected to be used.
Did FreeBSD enable it by default too?
No. The default is 0, which means that the encapsulation is turned off. Setting this sysctl variable to a non-zero value enables the UDP tunneling with the given port.
Quoted 7 lines
Quoted 5 lines
Quoted 4 lines
Thanks Michael.
Xin, then we should change this default value (and update the documentation above accordingly, to still have the standard port # readily available in there).OK, I misunderstood the RFC.
Does that RFC mandate that the feature is on by default? Can you point me to that text?
Not really.
I was thinking that by leaving it to 9899 by default users don't need to know the port when want to use it, and yet I didn't want to add another sysctl member. :D
Quoted 9 lines
Best regards
MichaelQuoted 5 lines
I will remove the call to sctp_udp_sock_start/stop() from sctp_ctrlsock_init/exit(), and set the
udp_portas 0 by default.Thanks.
RE: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
From: Xin Long
Quoted 1 line
Sent: 22 October 2020 04:13
...
Quoted 3 lines
I was thinking that by leaving it to 9899 by default users don't need to know the port when want to use it, and yet I didn't want to add another sysctl member. :D
Could you make 1 mean 9899?
So:
0 => disabled
1 => default port
n => use port n
I doubt that disallowing port 1 is a problem!
David
-
Registered Address Lakeside, Bramley Road, Mount Farm, Milton Keynes, MK1 1PT, UK Registration No: 1397386 (Wales)
Xin Long
maintainerRe: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
Quoted 9 lines · David Laight
From: Xin Long
Quoted 1 line
Sent: 22 October 2020 04:13
...
Quoted 3 lines
I was thinking that by leaving it to 9899 by default users don't need to know the port when want to use it, and yet I didn't want to add another sysctl member. :D
Could you make 1 mean 9899?
still feel not good, since it's called 'udp_port'.
I will add a note in ip-sysctl.rst:
udp_port - INTEGER
The listening port for the local UDP tunneling sock. Normally it's using the IANA-assigned UDP port number 9899 (sctp-tunneling).
...
Thanks.
Quoted 11 lines
So:
0 => disabled
1 => default port
n => use port n
I doubt that disallowing port 1 is a problem!David
-
Registered Address Lakeside, Bramley Road, Mount Farm, Milton Keynes, MK1 1PT, UK Registration No: 1397386 (Wales)
Re: [PATCHv4 net-next 16/16] sctp: enable udp tunneling socks
In reply to Xin LongQuoted 83 lines · Xin Long
Quoted 81 lines · Michael Tuexen
Quoted 81 lines · Xin Long
Quoted 76 lines · Marcelo Ricardo Leitner
Quoted 65 lines · Michael Tuexen
Quoted 65 lines · Marcelo Ricardo Leitner
Quoted 33 lines · Xin Long
Quoted 12 lines · Marcelo Ricardo Leitner
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2643
Quoted 7 lines · Xin Long
Documentation/networking/ip-sysctl.rst +1
-0@@ -2640,6 +2640,12 @@ addr_scope_policy - INTEGER Default: 1 +udp_port - INTEGERNeed to be more verbose here, and also mention the RFC.
Quoted 6 lines
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2644
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ The listening port for the local UDP tunneling sock., shared by all applications in the same net namespace.
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2645
Quoted 1 line
Documentation/networking/ip-sysctl.rst +1
-0+ UDP encapsulation will be disabled when it's set to 0."Note, however, that setting just this is not enough to actually use it. ..."
When it's a client, yes, but when it's a server, the
encap_portcan be got from the incoming packet.Quoted 10 lines
Quoted 7 lines
Documentation/networking/ip-sysctl.rst +3
-0+ + Default: 9899 +
encap_port- INTEGER
The default remote UDP encapsalution port.
When UDP tunneling is enabled, this global value is used to setWhen is it enabled, which conditions are needed? Maybe it can be explained only in the one above.
Quoted 2 lines
Thanks!
pls check if this one will be better:It is. Verbose enough now, thx.
(one other comment below)Quoted 10 lines
udp_port- INTEGERThe listening port for the local UDP tunneling sock.
This UDP sock is used for processing the incoming UDP-encapsulated SCTP packets (from RFC6951), and shared by all applications in the same net namespace. This UDP sock will be closed when the value is set to 0.
Quoted 5 lines
The value will also be used to set the src port of the UDP header for the outgoing UDP-encapsulated SCTP packets. For the dest port, please refer to '
encap_port' below.Default: 9899
I'm now wondering if this is the right default. I mean, it is the standard port for it, yes, but at the same time, it means loading SCTP module will steal/use that UDP port on all net namespaces and can lead to conflicts with other apps. A more conservative approach here is to document the standard port, but set the default to 0 and require the user to set it in if it is expected to be used.
Quoted 4 lines
Quoted 1 line
Did FreeBSD enable it by default too?
No. The default is 0, which means that the encapsulation is turned off. Setting this sysctl variable to a non-zero value enables the UDP tunneling with the given port.
Thanks Michael.
Xin, then we should change this default value (and update the documentation above accordingly, to still have the standard port # readily available in there).
Quoted 8 lines
Quoted 3 lines
Quoted 1 line
OK, I misunderstood the RFC.
Does that RFC mandate that the feature is on by default? Can you point me to that text?
Not really.
I was thinking that by leaving it to 9899 by default users don't need to know the port when want to use it, and yet I didn't want to add another sysctl member. :D
OK. Thanks for letting me know.
Best regards
Michael
Quoted 10 lines
Quoted 10 lines
Best regards
MichaelQuoted 5 lines
I will remove the call to sctp_udp_sock_start/stop() from sctp_ctrlsock_init/exit(), and set the
udp_portas 0 by default.Thanks.
Marcelo Ricardo Leitner
maintainerRe: [PATCHv4 net-next 07/16] sctp: add encap_port for netns sock asoc and transport
In reply to Xin LongDocumentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2644
Quoted 8 lines · Xin Long
Documentation/networking/ip-sysctl.rst +2
-0@@ -2640,6 +2640,15 @@ addr_scope_policy - INTEGER Default: 1 +encap_port - INTEGER + The default remote UDP encapsalution port.
^^^ typo
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2646
Quoted 2 lines
Documentation/networking/ip-sysctl.rst +2
-0+ When UDP tunneling is enabled, this global value is used to set + the dest port for the udp header of outgoing packets by default.
^^^ uppercase as well
Documentation/networking/ip-sysctl.rst addr_scope_policy - INTEGER · line 2648
Quoted 2 lines
Documentation/networking/ip-sysctl.rst +2
-0+ Users can also change the value for each sock/asoc/transport by + using setsockopt.
Please also add something like:
For further information, please refer to RFC6951.
Quoted 3 lines
Documentation/networking/ip-sysctl.rst +3
-0+ + Default: 0 +